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

protocol-analysis — скилл для Claude Code: как установить

Скилл protocol-analysis для Claude Code разбирает дампы шин I2C, SPI и UART, помогает настроить sigrok и PulseView и сверить данные с драйвером. Помогает разобраться, почему датчик молчит.

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

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

Что делает 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-code

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

~/.claude/skills/protocol-analysis/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Тесты и QA» →
sigrok MCP Server KenosInc Обёртка над sigrok-cli для ИИ-агентов: находит подключённый логический анализатор, снимает данные и расшифровывает протоколы вроде I2C, SPI или UART. CX Codex +1 ★ 16звёзд репо Network Protocol Analysis Skill a5c-ai Скилл Network Protocol Analysis Skill для Claude Code захватывает и разбирает сетевой трафик, создаёт пакеты и запускает фаззинг протоколов. Выполняет реверс протоколов и исследования безопасности. CX Codex +1 1установок circuit-debugger wedsamuel1230 Скилл circuit-debugger для Claude Code ведёт по проверкам питания, соединений и сигналов в схемах Arduino, ESP32 и RP2040. Помогает искать причины молчащих датчиков, неподвижных моторов и нагрева компонентов. CX Codex +1 298установок i2c-bringup-diagnostician wedsamuel1230 Скилл i2c-bringup-diagnostician помогает выявить сбои шины I2C на платах Arduino и ESP32: от подтяжки резисторов до ошибок библиотек. CX Codex +1 134установок Agentic HIL agentic-hil MCP-сервер Agentic HIL связывает ИИ-агента с реальной отладочной платой через программатор. Позволяет безопасно прошивать чип, читать UART и отправлять CAN-сообщения прямо в цикле разработки. CX Codex +1 ★ 33звёзд репо Serial MCP qarnet Связывает ИИ-агента с микроконтроллерами через UART и USB-serial. Через диалог с агентом можно отлаживать платы Arduino и STM32. CX Codex +1 ★ 21звёзд репо

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

Весь набор →
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установок spi-i2c-baremetal Скилл spi-i2c-baremetal помогает писать bare-metal драйверы SPI и I2C: настраивать обмен с датчиками и памятью, читать регистры и искать причины сбоев шины. CX Codex +1 384установок 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установок jit-compilation Скилл jit-compilation для Claude Code учит агента строить JIT-компиляцию с LLVM ORC/LLJIT, Cranelift, инлайн-кэшами, трамплинами и dynasm в Rust. Генерирует код на лету. CX Codex +1 382установок

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

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