К основному содержанию
скилл CX Codex

datasheet-interpreter — скилл для Claude Code: спецификации из PDF

Скилл datasheet-interpreter достаёт из PDF-даташита распиновку, адрес I2C, тайминги и карту регистров — когда нужно быстро подключить модуль, а не писать драйвер.

MIT 173 установок ★ 33 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill datasheet-interpreter -a claude-code
Открыть на GitHub

Что делает datasheet-interpreter

Скилл скачивает даташит по ссылке или берёт локальный файл и вытаскивает то, что нужно перед пайкой и первой прошивкой: распиновку, адрес I2C, напряжение и ток, тайминги, адреса регистров. На выходе получается справка таблицами, а не готовая библиотека драйвера.

Внутри один скрипт scripts/extract_specs.py и памятка references/common-parameters.md о том, как читать параметры из таблиц. Запуск идёт через uv: uv run --no-project scripts/extract_specs.py --url "...". Для локального PDF есть --file, для markdown-вывода --format markdown, для диалога по пунктам --interactive.

Разбор опирается на текстовый слой PDF, поэтому скан без распознавания или рекламная страничка дистрибьютора ничего не дадут: нужен официальный даташит производителя с выделяемым текстом. Для генерации полного драйвера в том же репозитории лежит отдельный скилл datasheet-parser.

Какие задачи решает

  • узнать адрес I2C и распиновку модуля из даташита
  • собрать таблицу напряжений и токов для расчёта питания
  • выписать карту регистров с битовыми масками в заголовочный файл
  • проверить тайминги шины до написания драйвера
  • сверить назначение выводов у двух ревизий одной микросхемы

Примеры запросов агенту

  • Вот ссылка на даташит BME280 — вытащи адрес I2C, распиновку и рабочий диапазон напряжений.
  • Запусти scripts/extract_specs.py --file local_datasheet.pdf и отдай карту регистров в markdown.
  • Какие тайминги нужны этому датчику на SPI? Нужны setup и hold из даташита.

Как установить datasheet-interpreter

1Через Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill datasheet-interpreter -a claude-code

2Вручную: положить файлы

~/.claude/skills/datasheet-interpreter/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/datasheet-interpreter/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о datasheet-interpreter

Как установить datasheet-interpreter в Claude Code?

Выполните npx skills add wedsamuel1230/embedded-engineering-skills --skill datasheet-interpreter -a claude-code. Файл скилла появится по пути ~/.claude/skills/datasheet-interpreter/SKILL.md.

Что делает datasheet-interpreter?

Разбирает PDF-даташит и достаёт из него ключевые спецификации: распиновку, адреса I2C и SPI, рабочие напряжения, тайминги, карту регистров. Это быстрая справка для подключения компонента, без генерации драйвера.

Подойдёт ли скан даташита?

Нет, скрипт читает текстовый слой PDF, а не картинку. Нужен официальный файл производителя с выделяемым текстом, а не скан и не краткая выжимка от дистрибьютора.

Исходный текст

SKILL.md · MIT
---
name: datasheet-interpreter
description: Extracts key specifications from component datasheet PDFs for maker projects. Use when user shares a datasheet PDF URL, asks about component specs, needs pin assignments, I2C addresses, timing requirements, or register maps. Downloads and parses PDF to extract essentials. Complements datasheet-parser for quick lookups.
metadata: {triggers: "datasheet, pinout, I2C address, timing requirement, register map"}
---

# Datasheet Interpreter

Extracts actionable specifications from component datasheet PDFs.

## Resources

### Scripts
- **scripts/extract_specs.py** - Downloads datasheet PDFs from URLs and extracts specs using pattern matching

### References  
- **references/common-parameters.md** - Guide to understanding datasheet parameters

### Quick Start
```bash
# Extract specs from a datasheet URL
uv run --no-project scripts/extract_specs.py --url "https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf"

# Extract specs with markdown output
uv run --no-project scripts/extract_specs.py --url "https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf" --format markdown

# Extract from local PDF file
uv run --no-project scripts/extract_specs.py --file "local_datasheet.pdf"

# Interactive mode
uv run --no-project scripts/extract_specs.py --interactive
```

---

## When to Use
- "What's the I2C address for this chip?"
- "How do I connect this sensor?"
- "What pins do what on this module?"
- User shares a PDF datasheet URL
- Need timing specs or register info
- Quick reference without full driver generation

## Relationship to Other Skills
- **datasheet-parser**: Full driver library generation (lexus2k-style)
- **datasheet-interpreter** (this): Quick spec extraction for immediate use

---

## Information Extraction Workflow

### Step 1: Request Datasheet

```
Please provide:
1. Component name (e.g., "BME280", "MPU6050")
2. Datasheet PDF file or URL (manufacturer version preferred)
3. What specific information you need:
   □ Pin assignments / pinout
   □ I2C/SPI address and protocol
   □ Operating conditions (voltage, current)
   □ Timing requirements
   □ Register map
   □ Example circuit
   □ All of the above
```

### Step 2: Validate PDF Quality

**Check For:**
- Searchable text (not scanned image)
- Official manufacturer datasheet (not clone/distributor summary)
- Revision/version number noted
- Complete document (includes register tables if applicable)

**If PDF Issues:**
```
⚠️ This appears to be a [scanned image | partial datasheet | third-party summary].

For best results, please provide the official manufacturer datasheet from:
- [Manufacturer website link]
- Or search: "[component] datasheet pdf site:manufacturer.com"
```

---

## Extraction Templates

### Quick Reference Card

Generate this for any component:

```markdown
# [Component Name] Quick Reference

## Basic Info
- **Manufacturer:** [name]
- **Part Number:** [full part number with variants]
- **Datasheet Version:** [rev/date]
- **Description:** [one-line description]

## Electrical Characteristics
| Parameter | Min | Typ | Max | Unit |
|-----------|-----|-----|-----|------|
| Supply Voltage (VDD) | | | | V |
| Operating Current | | | | mA |
| Sleep Current | | | | µA |
| Operating Temp | | | | °C |

## Communication Interface
- **Protocol:** [I2C / SPI / UART / GPIO]
- **Address:** [0xNN (7-bit)] or [selectable via pin]
- **Max Clock:** [frequency]
- **Logic Levels:** [3.3V / 5V tolerant]

## Pinout
| Pin | Name | Type | Description |
|-----|------|------|-------------|
| 1 | VDD | Power | Supply voltage |
| 2 | GND | Power | Ground |
| ... | ... | ... | ... |

## Key Registers (if applicable)
| Address | Name | R/W | Description |
|---------|------|-----|-------------|
| 0x00 | WHO_AM_I | R | Device ID (expect 0xNN) |
| ... | ... | ... | ... |

## Arduino Wiring
| Component Pin | Arduino Uno | ESP32 | Pico |
|---------------|-------------|-------|------|
| VCC | 3.3V | 3.3V | 3V3 |
| GND | GND | GND | GND |
| SDA | A4 | GPIO21 | GP4 |
| SCL | A5 | GPIO22 | GP5 |

## Important Notes
- [Critical warnings from datasheet]
- [Application notes]
```

---

## Common Component Categories

### I2C Sensors

**Extract:**
```
□ I2C address (7-bit format, note if configurable)
□ WHO_AM_I register address and expected value
□ Configuration register settings
□ Data registers (where to read measurements)
□ Resolution and range options
□ Conversion time / measurement rate
```

**I2C Address Quick Reference:**
| Component | Address (7-bit) | Config Pin | Alt Address |
|-----------|-----------------|------------|-------------|
| BME280 | 0x76 | SDO→GND | 0x77 (SDO→VDD) |
| BME680 | 0x76 | SDO→GND | 0x77 (SDO→VDD) |
| MPU6050 | 0x68 | AD0→GND | 0x69 (AD0→VDD) |
| SHT30 | 0x44 | ADDR→GND | 0x45 (ADDR→VDD) |
| BH1750 | 0x23 | ADDR→GND | 0x5C (ADDR→VDD) |
| VL53L0X | 0x29 | - | Configurable via software |
| INA219 | 0x40 | A0,A1 | 0x40-0x4F |
| ADS1115 | 0x48 | ADDR→GND | 0x49-0x4B |

### SPI Devices

**Extract:**
```
□ SPI mode (CPOL, CPHA)
□ Max clock frequency
□ Data order (MSB/LSB first)
□ Command format
□ Chip select behavior (active low?)
```

### Motor Drivers

**Extract:**
```
□ Logic voltage (VCC)
□ Motor voltage range (VM)
□ Current per channel (continuous/peak)
□ Control interface (PWM frequency, step/dir)
□ Protection features (thermal, overcurrent)
□ H-bridge or half-bridge
```

### Display Modules

**Extract:**
```
□ Resolution (width x height)
□ Controller IC (SSD1306, ILI9341, etc.)
□ Interface (I2C, SPI, parallel)
□ Memory map / pixel format
□ Initialization sequence
□ Refresh rate
```

---

## Critical Spec Finder

### For Power Planning
```
Search datasheet for:
- "Electrical Characteristics" table
- "Power Consumption" or "Current Consumption"
- "Typical Operating Conditions"
- Sleep/standby modes and their currents
```

**Template Output:**
```markdown
## Power Specs for [Component]

### Operating Modes
| Mode | Typical Current | Conditions |
|------|-----------------|------------|
| Active | XXX mA | [freq, voltage, etc.] |
| Idle | XXX µA | |
| Sleep/Standby | XXX µA | |
| Deep Sleep | XXX nA | |

### Wake-up Time
- From sleep: XXX ms
- From deep sleep: XXX ms
```

### For Timing Requirements
```
Search datasheet for:
- "Timing Characteristics"
- "AC Characteristics"
- Setup/hold times
- Clock specifications
```

### For Pin Tolerance
```
Search datasheet for:
- "Absolute Maximum Ratings"
- "ESD protection"
- "5V tolerant" mentions
- Input voltage specifications
```

---

## Register Map Extraction

### Structured Format
```cpp
// [Component] Register Definitions
// Extracted from datasheet v[X.Y], p.[N]

// === REGISTER ADDRESSES ===
#define REG_NAME          0x00  // Description

// === BITFIELD DEFINITIONS ===
// REG_NAME (0x00) - [Description]
// Bit 7-6: FIELD_A - [description]
// Bit 5:   FIELD_B - [description]
// Bit 4-0: FIELD_C - [description]

#define REG_NAME_FIELD_A_MASK    0xC0
#define REG_NAME_FIELD_A_POS     6
#define REG_NAME_FIELD_B_BIT     5
#define REG_NAME_FIELD_C_MASK    0x1F
```

### Common Register Patterns

**Configuration Register:**
```
- Enable/disable features
- Set operating mode
- Configure interrupt behavior
```

**Status Register:**
```
- Data ready flags
- Error/fault indicators
- Interrupt sources
```

**Data Registers:**
```
- Usually consecutive addresses
- Note byte order (MSB first or LSB first)
- Signed vs unsigned interpretation
```

---

## Wiring Diagram Generator

Generate text-based wiring diagrams:

```
  [Component]          [Arduino Uno]
  ┌─────────┐         ┌───────────┐
  │ VCC ────┼─────────┤ 3.3V      │
  │ GND ────┼─────────┤ GND       │
  │ SDA ────┼─────────┤ A4 (SDA)  │
  │ SCL ────┼─────────┤ A5 (SCL)  │
  │ INT ────┼─────────┤ D2 (INT0) │
  └─────────┘         └───────────┘
  
  Notes:
  - Add 4.7kΩ pull-ups on SDA/SCL if not on module
  - INT is open-drain, needs pull-up
```

---

## Example Code Generator

Based on extracted specs, generate minimal working example:

```cpp
/*
 * [Component] Basic Example
 * Generated from datasheet interpretation
 * 
 * Wiring:
 * - VCC → 3.3V
 * - GND → GND
 * - SDA → A4 (Arduino Uno) / GPIO21 (ESP32)
 * - SCL → A5 (Arduino Uno) / GPIO22 (ESP32)
 */

#include <Wire.h>

#define COMPONENT_ADDR  0x00  // From datasheet p.X
#define REG_WHO_AM_I    0x00  // Expected: 0xNN
#define REG_CTRL        0x00  // Configuration
#define REG_DATA        0x00  // Data output

void setup() {
  Serial.begin(115200);
  Wire.begin();
  
  // Verify communication
  Wire.beginTransmission(COMPONENT_ADDR);
  if (Wire.endTransmission() != 0) {
    Serial.println("Component not found!");
    while(1);
  }
  
  // Read device ID
  uint8_t id = readReg(REG_WHO_AM_I);
  Serial.print("Device ID: 0x");
  Serial.println(id, HEX);
  
  // Initialize
  writeReg(REG_CTRL, 0x00);  // [Configuration value from datasheet]
}

void loop() {
  // Read data
  int16_t data = readReg16(REG_DATA);
  Serial.println(data);
  delay(100);
}

uint8_t readReg(uint8_t reg) {
  Wire.beginTransmission(COMPONENT_ADDR);
  Wire.write(reg);
  Wire.endTransmission(false);
  Wire.requestFrom(COMPONENT_ADDR, (uint8_t)1);
  return Wire.read();
}

void writeReg(uint8_t reg, uint8_t val) {
  Wire.beginTransmission(COMPONENT_ADDR);
  Wire.write(reg);
  Wire.write(val);
  Wire.endTransmission();
}

int16_t readReg16(uint8_t reg) {
  Wire.beginTransmission(COMPONENT_ADDR);
  Wire.write(reg);
  Wire.endTransmission(false);
  Wire.requestFrom(COMPONENT_ADDR, (uint8_t)2);
  int16_t val = Wire.read() << 8;  // MSB first (check datasheet!)
  val |= Wire.read();
  return val;
}
```

---

## Quick Lookup Database

### Common Questions Answered

**"What voltage does [component] need?"**
→ Check "Absolute Maximum Ratings" and "Recommended Operating Conditions"

**"Is it 3.3V or 5V?"**
→ Look for "VDD" or "VCC" in electrical characteristics
→ Check if I/O pins are "5V tolerant"

**"How fast can I run the I2C?"**
→ Find "I2C Clock Frequency" in timing specs (usually 100kHz standard, 400kHz fast)

**"How do I wake it from sleep?"**
→ Look for "Power Management" or "Operating Modes" section

**"Why won't it respond at the address I expected?"**
→ Check address selection pins (AD0, ADDR, SA0)
→ Some datasheets show 8-bit address (divide by 2 for 7-bit)

---

## Datasheet Reading Tips

### Where to Find Key Info

| Information | Section Name |
|-------------|--------------|
| I2C Address | "Serial Interface" or "Communication" |
| Voltage/Current | "Electrical Characteristics" |
| Pinout | "Pin Configuration" or "Package Information" |
| Registers | "Register Map" or "Memory Map" |
| Timing | "Timing Characteristics" or "AC Characteristics" |
| Example Circuit | "Application Information" or "Typical Application" |

### Red Flags in Datasheets

- 🚩 Missing absolute maximum ratings
- 🚩 No version/revision number
- 🚩 Inconsistent register descriptions
- 🚩 Machine-translated text
- 🚩 Missing timing diagrams for protocols

→ If you see these, try to find a better quality datasheet from the original manufacturer

## Shared Output Contract

Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.

© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
datasheet-and-refmanual-reading mohitmishra786 Скилл datasheet-and-refmanual-reading учит агента читать даташиты и reference manual микроконтроллеров: где искать карту регистров, биты, дерево тактирования и errata. CX Codex +1 421установок peripherals-from-datasheet mohitmishra786 Скилл peripherals-from-datasheet помогает писать драйверы микроконтроллеров прямо по документации вендора. Пригодится при bare-metal разработке без готового HAL или переносе периферии между чипами. CX Codex +1 380установок embedded-docs ByteAsk MCP-сервер embedded-docs для Claude Code и других платформ. Отдаёт агенту дословные фрагменты документации с указанием раздела и страницы — возвращает точное значение регистра, а не догадку. CX Codex +1 ★ 26звёзд репо datasheets aklofas Скилл datasheets извлекает спецификации электронных компонентов из PDF-даташитов в структурированный JSON. Данные сохраняются в проектный кэш для анализаторов печатных плат и схем. CX Codex +1 781установок media-interpreter jarrodwatts Субагент media-interpreter для работы с PDF, изображениями, диаграммами и другими бинарными форматами. Извлекает текст, данные таблиц и описания визуального контента, когда обычное чтение файла не подходит. CX Codex ★ 1 064звёзд репо claude-code-eyes fcavalcantirj Скилл claude-code-eyes снимает кадр с камеры по HTTP и отдаёт его агенту, чтобы тот смотрел на плату, экран или проводку, а не на логи. CX Codex +1 ★ 52звёзд репо

Из того же набора19

Весь набор →
circuit-debugger Скилл circuit-debugger для Claude Code ведёт по проверкам питания, соединений и сигналов в схемах Arduino, ESP32 и RP2040. Помогает искать причины молчащих датчиков, неподвижных моторов и нагрева компонентов. CX Codex +1 298установок error-message-explainer Скилл error-message-explainer для Claude Code разбирает ошибки компиляции, загрузки, запуска и питания в Arduino-проектах. Объясняет сообщения IDE и платы и связывает их с исправлениями. CX Codex +1 206установок enclosure-designer Скилл enclosure-designer ведёт от «нужен корпус» до модели в OpenSCAD: уточняет замеры, ставит вырезы под разъёмы и подбирает толщину стенки под условия эксплуатации. CX Codex +1 189установок power-budget-calculator Скилл power-budget-calculator рассчитывает потребление тока и время работы от батареи для проектов на Arduino, ESP32 и RP2040. Помогает подобрать аккумулятор и настроить режимы сна. CX Codex +1 178установок bom-generator Скилл bom-generator собирает BOM для проектов на Arduino, ESP32 и RP2040: компоненты, количества, цены, поставщиков и предупреждения о совместимости. CX Codex +1 164установок battery-selector Скилл battery-selector помогает выбрать тип батареи и схему зарядки для проекта на Arduino, ESP32 или RP2040: от химии до расчёта ёмкости. CX Codex +1 163установок arduino-cli-skill Помогает управлять платами, библиотеками и прошивкой через arduino-cli на Windows, macOS и Linux. CX Codex +1 162установок code-review-facilitator Скилл code-review-facilitator проверяет проекты Arduino, ESP32 и RP2040 на типичные ошибки, проблемы с памятью и недочёты структуры. Подходит для ревью перед публикацией или после новой функции. CX Codex +1 154установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой