spi-i2c-baremetal — скилл для Claude Code: настройка и установка
Скилл spi-i2c-baremetal помогает писать bare-metal драйверы SPI и I2C: настраивать обмен с датчиками и памятью, читать регистры и искать причины сбоев шины.
MIT 384 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/spi-i2c-baremetal/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spi-i2c-baremetal/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a codex2Вручную: положить файлы
.agents/skills/spi-i2c-baremetal/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a cursor2Вручную: положить файлы
.cursor/skills/spi-i2c-baremetal/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/baremetal/spi-i2c-baremetal2Вручную: положить файлы
.github/skills/spi-i2c-baremetal/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/baremetal/spi-i2c-baremetalВручную: положить файлы
.devin/skills/spi-i2c-baremetal/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill spi-i2c-baremetal -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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