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

peripherals-from-datasheet — скилл для Claude Code: что делает

Скилл peripherals-from-datasheet помогает писать драйверы микроконтроллеров прямо по документации вендора. Пригодится при bare-metal разработке без готового HAL или переносе периферии между чипами.

MIT 380 установок ★ 298 обновлён 2026-06-27

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

Что делает peripherals-from-datasheet

Скилл задаёт строгую методику работы с reference manual микроконтроллеров. Он разбивает задачу на чёткие шаги: поиск базовых адресов в карте памяти, описание карты регистров через C-структуры с проверкой смещений, разбор битовых полей и соблюдение строгой последовательности инициализации.

Главное техническое правило — правильный порядок включения. Если попытаться записать биты в регистры периферии до подачи тактирования через RCC или шины APB/AHB, запись не сработает и периферия останется неактивной. Скилл также контролирует настройку альтернативных функций GPIO, задержки на стабилизацию PLL и правила сброса флагов прерываний.

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

  • Собрать карту регистров периферии в виде C-структуры со смещениями
  • Выстроить правильный порядок инициализации шин, GPIO и периферии
  • Проверить поведение HAL по официальному reference manual
  • Разобрать причины зависания прерываний и неверного битрейта

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

  • /peripherals-from-datasheet Спланируй инициализацию USART по reference manual для STM32
  • /peripherals-from-datasheet Какие разделы документации проверить для настройки таймингов SPI?
  • /peripherals-from-datasheet Проверь структуру регистров и порядок включения тактирования для I2C

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

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill peripherals-from-datasheet -a claude-code

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

~/.claude/skills/peripherals-from-datasheet/SKILL.md

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

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

Вопросы о peripherals-from-datasheet

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

Выполните команду npx skills add mohitmishra786/low-level-dev-skills --skill peripherals-from-datasheet -a claude-code. Файл навыка сохранится в директории ~/.claude/skills/peripherals-from-datasheet/SKILL.md.

Что делает peripherals-from-datasheet?

Он направляет ИИ-агента по пошаговому процессу создания bare-metal драйверов по документации: от расчёта смещений регистров и масок бит до настройки тактирования и NVIC.

Почему периферия не реагирует на запись в регистры?

Чаще всего регистры не отвечают из-за отключённого тактового сигнала. Сначала нужно включить тактирование шины в RCC, затем настроить выводы GPIO и только потом менять регистры управления периферией.

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

SKILL.md · MIT
---
name: peripherals-from-datasheet
description: Peripheral driver methodology skill from MCU reference manuals. Use when reading register maps, timing diagrams, and writing drivers from vendor documentation. Activates on queries about reference manual, register map, peripheral init sequence, or datasheet-driven driver design.
---

# Peripherals from Datasheet

## Purpose

Guide agents through a repeatable methodology for writing peripheral drivers from MCU reference manuals: locating register maps, interpreting bit definitions, following init sequences, respecting timing constraints, and producing maintainable register-level code. Pair with `skills/baremetal/datasheet-and-refmanual-reading` for doc-navigation methodology (kept as separate skills).

## When to Use

- Starting a driver without vendor HAL
- Porting a peripheral between MCU families
- Verifying HAL behavior against the reference manual
- Debugging a peripheral that "should work" per examples

## Workflow

### 1. Reference manual navigation

```
Typical RM structure
├── Memory map (peripheral base addresses)
├── Peripheral chapter (UART, SPI, GPIO, ...)
│   ├── Functional description
│   ├── Register map (table of offsets)
│   ├── Register bit definitions
│   └── Timing / electrical notes
└── Electrical characteristics (clock limits, setup/hold)
```

Start with the **programming model** section before copying register writes.

### 2. Extract register map

```c
/* From RM — USART base 0x40004400 */
typedef struct {
    volatile uint32_t SR;   /* 0x00 status */
    volatile uint32_t DR;   /* 0x04 data */
    volatile uint32_t BRR;  /* 0x08 baud */
    volatile uint32_t CR1;  /* 0x0C control */
    /* ... */
} USART_TypeDef;

#define USART2 ((USART_TypeDef *)0x40004400UL)
```

Verify offset column matches struct layout (padding for reserved words).

### 3. Init sequence checklist

```
Peripheral bring-up order
├── 1. Enable bus clock (RCC/APB/AHB register)
├── 2. Reset peripheral (if RM requires)
├── 3. Configure pins (GPIO alternate function)
├── 4. Configure peripheral registers (mode, baud, etc.)
├── 5. Enable peripheral (UE, TE, RE bits)
├── 6. Enable NVIC IRQ (if interrupt-driven)
└── 7. Verify status flags before first transaction
```

**Bad** — enable UART before clock:

```c
USART2->CR1 |= USART_CR1_UE;  /* USART clock still off — no effect */
```

### 4. Bit definition discipline

```c
/* From RM: CR1 M[1:0], PCE, PS, TE, RE, UE */
#define USART_CR1_UE   (1U << 13)
#define USART_CR1_TE   (1U << 3)
#define USART_CR1_RE   (1U << 2)
```

Document RM section number in comment for audit trail.

### 5. Timing and busy-wait

```c
/* RM: poll BUSY flag until reset complete */
while (RCC->CR & RCC_CR_PLLRDY == 0)
    ;
```

Respect startup times (oscillator settle, PLL lock) from electrical characteristics chapter.

### 6. Good vs bad driver structure

**Good** — layered, RM-referenced:

```c
void usart2_init(uint32_t baud) {
    rcc_enable_usart2();
    gpio_config_usart2_pins();
    usart2_set_baud(baud);
    USART2->CR1 = USART_CR1_TE | USART_CR1_RE | USART_CR1_UE;
}
```

**Bad** — magic numbers, no clock enable:

```c
*(uint32_t*)0x4000440C = 0x2000;  /* what peripheral? which bit? */
```

### 7. Agent usage examples

```
/peripherals-from-datasheet Walk me through USART init from STM32 RM
/peripherals-from-datasheet What sections of the ref manual matter for SPI timing?
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Peripheral dead | Clock not enabled | RCC/APB enable bit first |
| Wrong baud rate | PCLK assumption wrong | Recompute using actual clock tree |
| GPIO AF wrong | MUX value from wrong table | Cross-check pinout + AF table |
| IRQ stuck | Status flag clear sequence wrong | RM "clearing flags" subsection |
| Silent data corruption | Endian or width mismatch | Match register access size |

## Related Skills

- `skills/baremetal/datasheet-and-refmanual-reading` — fast RM navigation
- `skills/baremetal/mmio-and-bit-manipulation` — register access patterns
- `skills/baremetal/gpio-baremetal` — pin mux before peripheral enable
- `skills/embedded/linker-scripts` — memory map alignment

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
embedded-systems https://github.com/Jeffallan Скилл embedded-systems настраивает агента на разработку прошивок для STM32 и ESP32. Он помогает писать драйверы, FreeRTOS-задачи и оптимизировать потребление памяти и энергии. CX Codex +1 7 300установок arm-cortex-expert sickn33 Скилл arm-cortex-expert для Claude Code пишет прошивки и драйверы периферии для ARM Cortex-M: Teensy 4.x, STM32, nRF52 и SAMD. Формирует собираемый модуль, а не обрывок кода. CX Codex +1 ★ 50 109звёзд репо stm32f401rc-blackpill alexex1993 Скилл stm32f401rc-blackpill для Claude Code помогает разрабатывать прошивки для платы Black Pill на STM32F401RCT6. Разбирает настройку проекта PlatformIO, прошивку через HID-загрузчик и сбои запуска приложения. CX Codex +1 ★ 29звёзд репо Agentic HIL agentic-hil MCP-сервер Agentic HIL связывает ИИ-агента с реальной отладочной платой через программатор. Позволяет безопасно прошивать чип, читать UART и отправлять CAN-сообщения прямо в цикле разработки. CX Codex +1 ★ 33звёзд репо Chiplab veecle MCP-сервер Chiplab для Claude Code и других редакторов. Агент собирает прошивку в ELF, загружает её на виртуальную плату и читает вывод UART — без физического железа. CX Codex +1 ★ 19звёзд репо datasheet-interpreter wedsamuel1230 Скилл datasheet-interpreter достаёт из PDF-даташита распиновку, адрес I2C, тайминги и карту регистров — когда нужно быстро подключить модуль, а не писать драйвер. CX Codex +1 173установок

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

Весь набор →
kernel-testing Скилл kernel-testing для Claude Code и Codex: тестирование Linux ядра через KUnit для unit-тестов, kselftest для регрессионных проверок, syzkaller для фаззинга и LTP для проверки совместимости syscall. CX Codex +1 382установок branch-prediction-and-speculation Скилл branch-prediction-and-speculation для Claude Code объясняет предсказание ветвлений и спекулятивное выполнение процессоров, помогая оптимизировать горячие циклы и защищать код от утечек. CX Codex +1 382установок os-dev-scratch Скилл os-dev-scratch для Claude Code помогает собрать минимальную ОС для x86-64: от загрузчика и таблиц страниц до драйверов и переключения контекста. Активируется на вопросах о загрузке ядра, прерываниях и QEMU. CX Codex +1 381установок kernel-security Скилл kernel-security для работы с SELinux, AppArmor, seccomp-bpf, KASLR и аппаратной защитой (CET, PAC). Помогает писать политики безопасности ядра, триировать CVE и настраивать хардение. CX Codex +1 381установок platform-device-model Скилл platform-device-model для Claude Code объясняет привязку Linux-драйверов к platform bus, работу probe и remove, sysfs и deferred probe. Описывает задачи разработки драйверов устройств и работы с Device Tree. CX Codex +1 378установок writing-char-drivers Скилл writing-char-drivers для написания символьных драйверов Linux: регистрация cdev, реализация file_operations, безопасные копии в userspace, ioctl и mmap. CX Codex +1 378установок adc-dac-baremetal Скилл adc-dac-baremetal для настройки АЦП и ЦАП на микроконтроллерах: выбор каналов, время выборки, калибровка, DMA-буферы и выходное напряжение. Пригодится при работе с аналоговыми датчиками, аудио или управляющими сигналами. CX Codex +1 378установок resource-optimization-lowend Скилл resource-optimization-lowend помогает уменьшать расход flash и RAM в прошивках для MCU, разбирать linker map и оценивать глубину стека. CX Codex +1 376установок

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

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