hashgraph-online/awesome-codex-plugins / plugins/aklofas/kicad-happy/skills/datasheets
datasheets
VerifiedExtract structured specifications from electronic component datasheet PDFs — pinouts, electrical characteristics, peripherals, topology, and features. Cache extractions per project for consumption by schematic and PCB analyzers. Primary consumer infrastructure for `kicad`, `emc`, `spice`, and `thermal` analyzers. Use this skill whenever the user asks to extract, verify, or read specs from a component datasheet; when analyzers need verified IC knowledge (EN pin thresholds, PG presence, USB peripheral speed); or when a review mentions datasheet coverage, extraction quality, or per-MPN specifications. Also triggers on "extract this datasheet", "what are the specs for MPN X", "verify datasheet extraction", or "check pin functions for part Y".
prompts/mcu.md
View on GitHub# Datasheet MCU Extractor Subagent
You are extracting the **MCU category extension** (core, memory, peripheral counts, supply, package, debug interface, reset pin, temperature grades) from an electronics component datasheet PDF.
## Task
Read `{{PDF_PATH}}` (focus pages: `{{PAGES}}`). Target MPN: **`{{MPN}}`**.
Produce a single JSON object matching this schema: `{{SCHEMA_PATH}}`.
## Scope — catalog tier only
This is a **catalog-tier** extraction. Capture identity-level facts about the MCU: what is it, how much memory, how many peripherals of each type, what are the supply ranges. Do NOT attempt per-peripheral instance configuration, pin-mux tables, or alternate function maps — those are Tier 2 fields, not part of this schema (`mcu_peripherals.schema.json`).
## Field guide
- `core_family`: string. Open-form identifier for the CPU core — do not guess a value not found in the datasheet. Examples: `"cortex_m0"`, `"cortex_m0plus"`, `"cortex_m3"`, `"cortex_m4"`, `"cortex_m4f"`, `"cortex_m7"`, `"cortex_m33"`, `"avr_8bit"`, `"avr_8bit_atmega"`, `"avr_8bit_attiny"`, `"pic16"`, `"pic32"`, `"riscv_rv32"`, `"8051"`. Use lowercase with underscores. This is the only required field.
- `core_speed_max`: integer or null. Maximum CPU clock frequency **in Hz** (NOT MHz). Found on cover page, Features list, or Electrical Characteristics. Store 72MHz as `72000000`. Null when not found.
- `flash_size`: integer or null. Internal flash size **in bytes** (NOT KB). Store 32K as `32768`, 64K as `65536`. Null when the part has no internal flash.
- `ram_size`: integer or null. Internal SRAM size **in bytes**. Store 20K as `20480`. Null when not determinable.
- `eeprom_size`: integer or null. Internal EEPROM size **in bytes**. Use `0` for parts with no EEPROM (e.g. STM32F103C8T6 has no EEPROM → `0`). Use the actual byte count for AVR parts with EEPROM (e.g. ATmega328P 1K EEPROM → `1024`). Null when not determinable.
- `pin_count`: integer or null. Total package pin count. Found on cover page or package description.
- `gpio_count`: integer or null. Number of GPIO pins. Often listed in the Features section. Null when not found.
- `nvic_priorities`: integer or null. Number of NVIC interrupt priority levels (Cortex-M parts only). For Cortex-M3: `16`. Null for non-Cortex-M cores (AVR, PIC, 8051, RISC-V without NVIC). Found in the NVIC section of the programming manual or CPU description.
- `vdd_range`: SpecValue list (unit: `"V"`). Main supply voltage range. Condition carries frequency-dependent restrictions when relevant (e.g. AVR 20MHz requires 4.5–5.5V).
- `vddio_range`: SpecValue list or null (unit: `"V"`). Separate I/O supply range. Null when I/O supply is shared with VDD (most single-supply MCUs).
- `vdda_range`: SpecValue list or null (unit: `"V"`). Analog supply range (AVCC, VDDA). Null when analog supply is shared with VDD and no separate spec is given.
- `peripheral_counts`: object or null. Counts of each peripheral type. **Use 0 for peripherals the part lacks — not null.** The object's inner properties are required to be non-negative integers.
- `uart`: count of UART/USART interfaces (each independent channel). STM32F103C8T6 → 3.
- `spi`: count of SPI interfaces. ATmega328P → 1.
- `i2c`: count of I2C interfaces.
- `can`: count of CAN interfaces. 0 for most low-end MCUs.
- `usb`: count of USB peripheral instances (NOT endpoint count).
- `ethernet`: count of Ethernet MAC interfaces. 0 for most MCUs.
- `dac`: count of DAC peripheral instances. 0 when no DAC present. Also set top-level `dac: null` when `peripheral_counts.dac = 0`.
- `timer_general`: count of general-purpose timers (basic + general; exclude advanced-control timers). STM32F103C8T6 → 4 (TIM2/3/4 general + TIM6/7 basic where present, or just TIM2/3/4 for C8).
- `timer_advanced`: count of advanced-control timer instances (TIM1 type with complementary outputs, dead-time). STM32F103C8T6 → 1 (TIM1).
- `adc`: object or null. ADC summary. Null when no ADC. Catalog tier — single summary for the whole part:
- `bit_depth`: integer or null. ADC resolution (e.g. 10, 12).
- `channel_count`: integer or null. Total muxed channel count across all ADC peripherals (e.g. ATmega328P → 8 channels, STM32F103C8T6 → 10 external channels).
- `sample_rate_max_hz`: number or null. Maximum sample rate in Hz. ATmega328P → `76900` (76.9 ksps). STM32F103C8T6 → `1000000` (1 MSPS).
- `dac`: object or null. DAC summary. Null when no DAC (the common case for most budget MCUs). Same shape as `adc`. When `peripheral_counts.dac = 0`, set `dac: null`.
- `boot_pins`: array or null. Boot configuration pins that control startup mode. Empty array `[]` when the part has no boot pins (e.g. AVR uses fuse-controlled boot section — no pin). Array of `{pin_number, function}` objects otherwise. For STM32F103C8T6: `[{"pin_number": "44", "function": "BOOT0"}]`. Null when not determinable.
- `debug_interface`: enum or null. Primary debug/programming interface:
- `"swd"` — SWD only (some small Cortex-M parts)
- `"jtag"` — JTAG only
- `"swd_jtag"` — both SWD and JTAG (STM32F103C8T6, most Cortex-M)
- `"debugwire"` — Atmel debugWIRE (ATmega328P, ATtiny)
- `"pdi"` — Atmel PDI (XMEGA)
- `"spi_isp"` — SPI-based ISP (older AVR, PIC)
- `"none"` — no on-chip debug interface
- `null` when not determinable
- `reset_pin`: string or null. RESET/NRST pin number (matches `base.pinout[*].numbers`). For ATmega328P-AU TQFP-32: `"29"`. For STM32F103C8T6 LQFP-48: `"7"`. Null when not determinable.
- `temperature_grades`: array of strings or null. Operating temperature grade strings from the datasheet Features or Ordering Information section. Example: `["industrial: -40 to +85"]`. Null when not stated.
- `thermal_resistance`: nested object or null with three nullable SpecValue-list sub-fields (unit `"°C/W"` or `"K/W"`):
- `rtheta_ja` — junction-to-ambient. Present for most packages.
- `rtheta_jc` — junction-to-case. Null when not specified.
- `rtheta_jl` — junction-to-lead. Null for most MCU packages.
Found in Thermal Characteristics section.
- `package`: object with `code` (string), `pin_count` (integer), `pitch_mm` (number or null), `body_mm` (nested object with `length`, `width`, `height` — all numbers in millimeters), `thermal_pad` (boolean or null), `evidence`. Found in Package Dimensions / Mechanical Data.
## Hard rules
1. **Canonical SI units. No exceptions.** Memory sizes in **bytes** (NOT KB/MB — store 32K as `32768`). Frequencies in **Hz** (NOT MHz — store 72MHz as `72000000`). Voltages in **V**. Sample rates in **Hz**.
2. **Every SpecValue requires `evidence`** with `page` (1-based integer), `section` (string or null), `confidence` (`"high"`, `"medium"`, or `"low"`), `method` (one of `table`, `prose`, `curve`, `calculated`, `derived`).
3. **Catalog tier only.** Capture peripheral *counts* in `peripheral_counts`, not per-peripheral detail. The peripheral_counts object exists to answer "how many UARTs", not "which pins does UART1 use". Per-instance configuration is not part of this schema.
4. **peripheral_counts uses 0 for absent peripherals, not null.** If a part has no DAC, set `peripheral_counts.dac = 0` AND set top-level `dac: null`.
5. **reset_pin matches base.pinout[*].numbers exactly** when populated. If you cannot find the pin number in the pinout, set null.
6. **nvic_priorities is null for non-Cortex-M cores.** AVR, PIC, 8051, classic RISC-V without NVIC → null.
7. **eeprom_size convention:** use `0` for parts with no EEPROM (e.g. STM32F103C8T6); use the actual byte count for parts that have EEPROM (e.g. ATmega328P → `1024`). Null only when not determinable.
8. **OMIT fields you cannot find** (leave as null). No guessing. A missing `core_speed_max` is better than a hallucinated one.
## Output format
Return only the JSON object. No prose, no fences. Output must validate against `{{SCHEMA_PATH}}`.
Example (STM32F103C8T6 — ST Cortex-M3 32-bit, LQFP-48; values from datasheet):
```json
{
"core_family": "cortex_m3",
"core_speed_max": 72000000,
"flash_size": 65536,
"ram_size": 20480,
"eeprom_size": 0,
"pin_count": 48,
"gpio_count": 37,
"nvic_priorities": 16,
"vdd_range": [
{"min": 2.0, "typ": null, "max": 3.6, "unit": "V",
"condition": "VDD operating range",
"notes": null,
"evidence": {"page": 3, "section": "Electrical Characteristics", "confidence": "high", "method": "table"}}
],
"vddio_range": null,
"vdda_range": [
{"min": 2.0, "typ": null, "max": 3.6, "unit": "V",
"condition": "VDDA analog supply",
"notes": null,
"evidence": {"page": 3, "section": "Electrical Characteristics", "confidence": "high", "method": "table"}}
],
"peripheral_counts": {
"uart": 3,
"spi": 2,
"i2c": 2,
"can": 1,
"usb": 1,
"ethernet": 0,
"dac": 0,
"timer_general": 4,
"timer_advanced": 1
},
"adc": {
"bit_depth": 12,
"channel_count": 10,
"sample_rate_max_hz": 1000000.0
},
"dac": null,
"boot_pins": [
{"pin_number": "44", "function": "BOOT0"}
],
"debug_interface": "swd_jtag",
"reset_pin": "7",
"temperature_grades": ["industrial: -40 to +85"],
"thermal_resistance": {
"rtheta_ja": [
{"min": null, "typ": 60, "max": null, "unit": "°C/W",
"condition": "LQFP-48, free air",
"notes": null,
"evidence": {"page": 2, "section": "Thermal Characteristics", "confidence": "medium", "method": "prose"}}
],
"rtheta_jc": null,
"rtheta_jl": null
},
"package": {
"code": "LQFP-48",
"pin_count": 48,
"pitch_mm": 0.5,
"body_mm": {"length": 7.0, "width": 7.0, "height": 1.4},
"thermal_pad": false,
"evidence": {"page": 80, "section": "Package Mechanical Data", "confidence": "high", "method": "table"}
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |