protocol-analysis — скилл для Claude Code: как установить
Скилл protocol-analysis для Claude Code разбирает дампы шин I2C, SPI и UART, помогает настроить sigrok и PulseView и сверить данные с драйвером. Помогает разобраться, почему датчик молчит.
MIT 383 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a claude-codeЧто делает protocol-analysis
Скилл ведёт агента через разбор шин I2C, SPI и UART по дампу с логического анализатора. Он подсказывает, как запустить sigrok-cli или PulseView с драйвером fx2lafw и выгрузить VCD или CSV для своих скриптов. Для I2C разложены фазы обмена: START, адрес с битом R/W, байты данных с ACK, STOP. NACK на адресе указывает на неверный адрес вроде 0x48 или на устройство, застрявшее в сбросе.
Для SPI скилл напоминает проверить режим CPOL/CPHA, порядок бит, полярность CS и размер слова, а потом сверить всё с spi_setup() в драйвере. Для UART нужны скорость (9600 или 115200), формат кадра 8N1 и частота дискретизации не ниже 4× скорости. Есть заготовка на Python: она читает capture.csv и восстанавливает биты по фронтам.
Железо для захвата нужно своё, скилл упоминает дешёвые платы FX2LA. Без sigrok-cli с декодерами расшифровки не будет. В конце дамп сверяют с последовательностью записи регистров в прошивке и с паузами между байтами из даташита.
Какие задачи решает
- выяснить, почему датчик отвечает NACK на адрес
- расшифровать дамп I2C из PulseView или
sigrok-cli - подобрать CPOL/CPHA, когда биты SPI сдвинуты
- найти причину ошибок кадра в UART при уплывшей скорости
- разобрать CSV с захватом Python-скриптом по фронтам
Примеры запросов агенту
- /protocol-analysis Расшифруй этот дамп I2C: устройство отвечает NACK после записи в регистр
0x0F - /protocol-analysis Биты SPI в захвате сдвинуты, помоги подобрать CPOL/CPHA
- Через protocol-analysis разбери
capture.csvи восстанови байты UART 8N1 на 115200
Как установить protocol-analysis
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a claude-code2Вручную: положить файлы
~/.claude/skills/protocol-analysis/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/protocol-analysis/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a codex2Вручную: положить файлы
.agents/skills/protocol-analysis/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a cursor2Вручную: положить файлы
.cursor/skills/protocol-analysis/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/qemu/protocol-analysis2Вручную: положить файлы
.github/skills/protocol-analysis/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/qemu/protocol-analysisВручную: положить файлы
.devin/skills/protocol-analysis/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о protocol-analysis
Как установить protocol-analysis в Claude Code?
Выполните npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a claude-code. Файл скилла окажется в ~/.claude/skills/protocol-analysis/SKILL.md.
Что делает protocol-analysis?
Помогает агенту расшифровывать обмен по I2C, SPI и UART из захвата логического анализатора через sigrok и PulseView, а затем сверять его с кодом драйвера и даташитом.
Что нужно для работы protocol-analysis?
Устройство для захвата сигнала и установленный sigrok-cli с декодерами. Частота дискретизации должна быть не ниже 4× скорости шины, иначе расшифровка превратится в мусор.
Исходный текст
SKILL.md · MIT
---
name: protocol-analysis
description: Protocol analysis skill for serial bus debugging. Use when decoding I2C/SPI/UART with logic analyzer concepts, sigrok/PulseView, or Python capture scripts. Activates on queries about logic analyzer, sigrok, PulseView, decode I2C SPI UART, or bus protocol capture.
---
# Protocol Analysis (I2C / SPI / UART)
## Purpose
Guide agents through software-side serial bus analysis: logic analyzer workflow, sigrok/PulseView decoding, correlating captures with firmware drivers, and Python-based parsing — bridging `skills/baremetal/spi-i2c-baremetal` and hardware bring-up.
## When to Use
- Sensor not responding — verify clock and data on bus
- Compare kernel driver transactions vs datasheet
- Document expected transaction format for CI/regression
- Teaching protocol layers without expensive lab gear (sim + decode)
## Workflow
### 1. Capture stack
```
Physical probe → logic analyzer hardware (or GPIO bit-bang)
├── sigrok-cli / PulseView GUI
├── Protocol decoder (i2c, spi, uart)
└── Export VCD/CSV for scripts
```
Open-source: [sigrok](https://sigrok.org/) with cheap FX2LA boards.
### 2. PulseView quick start
```bash
# List devices
pulseview
# CLI capture (device-dependent)
sigrok-cli --driver fx2lafw --config samplerate=1MHz \
--channels 0=SDA,1=SCL \
--samples 1m \
--protocols i2c
```
### 3. I2C decode expectations
| Phase | Lines |
|-------|-------|
| START | SDA fall while SCL high |
| Address + R/W | 7 bits + ACK |
| Data bytes | ACK per byte |
| STOP | SDA rise while SCL high |
NACK at address → wrong `0x48` or device held in reset.
### 4. SPI decode
Check mode (CPOL/CPHA), bit order (MSB first typical), CS polarity, and word size. Compare to `spi_setup()` in `skills/kernel-dev/bus-drivers-i2c-spi`.
### 5. UART decode
Set baud (9600/115200), frame (8N1), and signal polarity. Async — sample rate must be ≥ 4× baud for LA.
### 6. Python post-process (csv)
```python
import csv
with open("capture.csv") as f:
for ts, ch0, ch1 in csv.reader(f):
# edge detect, reconstruct bits
pass
```
### 7. Correlate with firmware
```
Logic capture timestamp
├── Match driver reg write sequence
├── Compare inter-byte delay vs datasheet max
└── Flag extra clock pulses (mode fault)
```
### 8. Agent usage
```
/protocol-analysis Decode this I2C capture — device NACKs after register 0x0F write
```
## Common Problems
| Symptom | Cause | Fix |
|---------|-------|-----|
| Garbage decode | Wrong samplerate | ≥ 4× bus speed |
| Floating lines | Missing pull-ups | Enable internal pull or external |
| SPI shifted bits | Mode mismatch | CPOL/CPHA table from RM |
| UART framing errors | Baud drift | Measure actual bit time |
| No decoder | Missing sigrok build | Install `sigrok-cli` + decoders |
## Related Skills
- `skills/baremetal/spi-i2c-baremetal` — firmware-side protocol
- `skills/baremetal/uart-serial-baremetal` — UART config
- `skills/kernel-dev/bus-drivers-i2c-spi` — kernel transactions
- `skills/profilers/strace-ltrace` — userspace syscall trace analog
- `skills/embedded/openocd-jtag` — scope alongside SWD debug
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills