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

spi-i2c-baremetal — скилл для Claude Code: настройка и установка

Скилл spi-i2c-baremetal помогает писать bare-metal драйверы SPI и I2C: настраивать обмен с датчиками и памятью, читать регистры и искать причины сбоев шины.

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

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

Что делает spi-i2c-baremetal

Скилл разбирает обмен в режиме master: для SPI — настройку CPOL и CPHA, передачу байтов и управление CS; для I2C — последовательность START, ACK и STOP при чтении регистра. Есть примеры для STM32 и типовые схемы обмена с датчиками и SPI flash.

При отладке он помогает связать симптомы с возможными причинами: NACK — с адресом устройства, неверные данные SPI — с режимом тактирования, зависшую SCL — с растяжением тактов или сбоем ведомого. Для проверки флагов SPI и I2C нужно сверяться с reference manual микроконтроллера. Режим SPI выбирайте по документации ведомого: неверные CPOL или CPHA дадут мусор на чтении.

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

  • настроить SPI master с нужными CPOL и CPHA
  • прочитать регистр датчика по I2C
  • разобрать причину NACK или зависшей SCL
  • заменить HAL_I2C или HAL_SPI минимальным кодом

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

  • Реализуй чтение регистра 0x0F устройства 0x68 по I2C bare-metal.
  • Настрой SPI master для чтения регистра датчика с учётом CPOL и CPHA.
  • Помоги найти причину NACK при чтении регистра по I2C.

Как установить spi-i2c-baremetal

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a claude-code

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

~/.claude/skills/spi-i2c-baremetal/SKILL.md

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

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

Вопросы о spi-i2c-baremetal

Как установить spi-i2c-baremetal в Claude Code?

Выполните npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a claude-code. Файл скилла находится по пути ~/.claude/skills/spi-i2c-baremetal/SKILL.md.

Что делает spi-i2c-baremetal?

Помогает реализовать bare-metal обмен SPI и I2C, включая чтение регистров и настройку SPI master. Также подсказывает, как разбирать NACK, зависшую SCL и неверные данные SPI.

С какими платформами работает скилл?

Он доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

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

SKILL.md · MIT
---
name: spi-i2c-baremetal
description: Bare-metal SPI and I2C skill for serial peripheral buses. Use when implementing master-mode transfers, register read/write protocols, or debugging bus stalls. Activates on queries about SPI bare-metal, I2C START/STOP, sensor register read, or clock phase/polarity.
---

# SPI and I2C (Bare-Metal)

## Purpose

Implement SPI and I2C master drivers for sensor and memory chips: clock configuration, phase/polarity (SPI), START/ACK sequences (I2C), and common register-oriented transaction patterns.

## When to Use

- Reading an I2C sensor (WHO_AM_I register)
- SPI flash or display bring-up
- Debugging NACK or stuck SCL
- Replacing HAL_I2C/SPI with minimal code

## Workflow

### 1. SPI master (STM32)

```c
/* Mode 0: CPOL=0, CPHA=0 — check slave datasheet */
SPI1->CR1 = SPI_CR1_MSTR | SPI_CR1_SSM | SPI_CR1_SSI
          | (3 << SPI_CR1_BR_Pos);  /* baud divider */
SPI1->CR1 |= SPI_CR1_SPE;

uint8_t spi_xfer(SPI_TypeDef *spi, uint8_t tx) {
    while (!(spi->SR & SPI_SR_TXE))
        ;
    *(volatile uint8_t *)&spi->DR = tx;
    while (!(spi->SR & SPI_SR_RXNE))
        ;
    return *(volatile uint8_t *)&spi->DR;
}
```

CS (GPIO bit-bang):

```c
GPIO_CS_LOW();
spi_xfer(SPI1, reg | 0x80);  /* read */
uint8_t val = spi_xfer(SPI1, 0xFF);
GPIO_CS_HIGH();
```

### 2. I2C master — register read

```c
/* START → addr+W → reg → repeated START → addr+R → data → STOP */
bool i2c_read_reg(I2C_TypeDef *i2c, uint8_t dev7, uint8_t reg, uint8_t *out) {
    if (!i2c_start(i2c)) return false;
    if (!i2c_tx(i2c, (dev7 << 1) | 0)) return false;
    if (!i2c_tx(i2c, reg)) return false;
    if (!i2c_restart(i2c)) return false;
    if (!i2c_tx(i2c, (dev7 << 1) | 1)) return false;
    *out = i2c_rx(i2c, false);  /* NACK last byte */
    i2c_stop(i2c);
    return true;
}
```

Poll `SB`, `ADDR`, `TXE`, `RXNE`, `BTF` per reference manual.

### 3. Common protocols

| Pattern | Bus |
|---------|-----|
| `reg + write data` | I2C/SPI |
| `0x80|reg` read (MSB set) | SPI sensors |
| 16-bit big-endian length prefix | SPI flash |

### 4. Agent usage

```
/spi-i2c-baremetal I2C read of register 0x0F from device 0x68
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| I2C NACK | Wrong 7-bit addr (8-bit in datasheet) | Shift addr; check R/W bit |
| SPI garbage | CPOL/CPHA mismatch | Match slave mode table |
| Bus stuck SCL low | Slave clock stretch / fault | Bus recovery (clock pulses) |
| CS glitch | CS timing vs clock | Assert CS before first SCK |

## Related Skills

- `skills/baremetal/gpio-baremetal` — CS, SDA, SCL pins
- `skills/baremetal/peripherals-from-datasheet` — timing requirements
- `skills/kernel-dev/bus-drivers-i2c-spi` — Linux kernel side

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

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

Каталог скиллов SKILL.md →
i2c-bringup-diagnostician wedsamuel1230 Скилл i2c-bringup-diagnostician помогает выявить сбои шины I2C на платах Arduino и ESP32: от подтяжки резисторов до ошибок библиотек. CX Codex +1 134установок find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

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

Весь набор →
qemu-embedded-simulation Скилл qemu-embedded-simulation для Claude Code помогает запускать bare-metal прошивки ARM и RISC-V в QEMU и подключать GDB. Проверяет прошивку без платы. CX Codex +1 389установок kernel-memory-management Скилл kernel-memory-management по памяти ядра Linux: помогает выбрать между kmalloc, vmalloc и страничным аллокатором и понять, почему драйвер упирается в OOM. CX Codex +1 388установок cuda-debugging Скилл cuda-debugging для Claude Code и Codex: ведёт агента по отладке CUDA через cuda-gdb, Compute Sanitizer, дампы GPU и разбор ошибок 700/702. Покрывает падения ядра и неверный результат. CX Codex +1 386установок llvm-ir-and-passes Скилл llvm-ir-and-passes для Claude Code учит агента читать LLVM IR, понимать SSA и пайплайн оптимизаций. Помогает проследить изменения от -O2 и подготовиться к написанию пасса. CX Codex +1 384установок protocol-analysis Скилл protocol-analysis для Claude Code разбирает дампы шин I2C, SPI и UART, помогает настроить sigrok и PulseView и сверить данные с драйвером. Помогает разобраться, почему датчик молчит. CX Codex +1 383установок gpio-baremetal Скилл gpio-baremetal помогает настраивать регистры GPIO, альтернативные функции и прерывания EXTI на микроконтроллерах без библиотек HAL. CX Codex +1 383установок apple-silicon Скилл помогает разработчикам работать с Apple Silicon: настраивать код под единую память, использовать Metal Performance Shaders и Instruments, понимать поведение Rosetta 2 и особенности 16KB страниц. CX Codex +1 383установок code-generation-and-backends Скилл code-generation-and-backends объясняет этапы LLVM-бэкенда: от легализации IR до выдачи ассемблера. Пригодится, чтобы разобраться с llc, TableGen или переносом компилятора на новую архитектуру. CX Codex +1 382установок

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

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