# protocol-analysis

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 383 установки · ★ 298 у репозитория
- Автор: mohitmishra786
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/mohitmishra786/low-level-dev-skills/tree/HEAD/skills/qemu/protocol-analysis/SKILL.md
- Обновлён: 2026-06-27
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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` с декодерами расшифровки не будет. В конце дамп сверяют с последовательностью записи регистров в прошивке и с паузами между байтами из даташита.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/protocol-analysis/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/protocol-analysis/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mohitmishra786/low-level-dev-skills skills/qemu/protocol-analysis
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/protocol-analysis/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/qemu/protocol-analysis
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/protocol-analysis/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mohitmishra786/low-level-dev-skills --skill protocol-analysis -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/mohitmishra786/low-level-dev-skills/tree/HEAD/skills/qemu/protocol-analysis/SKILL.md

## Когда брать
- выяснить, почему датчик отвечает 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

## Похожие
- [sigrok MCP Server](https://affpapa.org/nevibecode/mcp/sigrok-mcp-server.md) — MCP-сервер · ★ 16 у репозитория
- [Network Protocol Analysis Skill](https://affpapa.org/nevibecode/skills/network-protocol-analysis-skill.md) — скилл · 1 установка
- [circuit-debugger](https://affpapa.org/nevibecode/skills/circuit-debugger.md) — скилл · 298 установок
- [i2c-bringup-diagnostician](https://affpapa.org/nevibecode/skills/i2c-bringup-diagnostician.md) — скилл · 134 установки
- [Agentic HIL](https://affpapa.org/nevibecode/mcp/agentic-hil.md) — MCP-сервер · ★ 33 у репозитория
- [Serial MCP](https://affpapa.org/nevibecode/mcp/serial-mcp.md) — MCP-сервер · ★ 21 у репозитория

Из того же набора: [mohitmishra786/low-level-dev-skills](https://affpapa.org/nevibecode/by/mohitmishra786/low-level-dev-skills.md) — 140 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
