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

verilog-basics-for-lowlevel — скилл для Claude Code: что делает

Скилл verilog-basics-for-lowlevel учит читать RTL-код на Verilog: модули, тактирование, reset-логику, шинные протоколы. Нужен разработчикам драйверов и firmware, когда документация неясна, а поведение железа объясняет баги.

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

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

Что делает verilog-basics-for-lowlevel

Скилл даёт минимум Verilog для чтения RTL: различает wire и reg, объясняет always @(posedge clk), APB/AXI/AHB-шины и clock domain crossing. Разбирает типичные проблемы — бит переключается один раз (pulse в RTL), случайная порча данных (CDC без синхронизатора), зависший IRQ (level vs pulse). Показывает, как сопоставить регистры из reference manual с блоком в RTL и почему QEMU-модели могут расходиться с железом.

Активируется на запросы про Verilog, RTL, clock domain, reset synchronizer, MMU в железе. Прогоняет типовые конструкции (posedge, case, параметры ширины) и объясняет, когда firmware должна ждать setup time после reset или следовать порядку транзакций для bus bridge.

Включает таблицу синтезируемых конструкций, примеры модулей с async reset, команды симуляции через iverilog. Без reset-дисциплины и синхронизаторов между доменами баги будут intermittent — в софте не чинятся.

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

  • понять, когда регистр обновляется относительно записи в APB-блок
  • разобраться в CDC-багах между доменами тактирования
  • сопоставить DMA/AXI-транзакции с порядком операций в драйвере
  • прочитать SoC block diagram вместе с железячниками
  • объяснить, почему бит STATUS меняется не тогда, когда ожидает firmware

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

  • Объясни этот APB-блок регистров и когда бит STATUS обновляется после WRITE
  • Почему в этом RTL-коде сигнал пересекает домены clk_a и clk_b без синхронизатора?
  • Разбери модуль uart_tx: какие сигналы комбинаторные, какие регистровые

Как установить verilog-basics-for-lowlevel

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill verilog-basics-for-lowlevel -a claude-code

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

~/.claude/skills/verilog-basics-for-lowlevel/SKILL.md

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

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

Вопросы о verilog-basics-for-lowlevel

Как установить verilog-basics-for-lowlevel в Claude Code?

Выполни npx skills add mohitmishra786/low-level-dev-skills --skill verilog-basics-for-lowlevel -a claude-code, скилл окажется в ~/.claude/skills/verilog-basics-for-lowlevel/SKILL.md.

Что делает verilog-basics-for-lowlevel?

Учит читать Verilog RTL: различает wire и reg, объясняет clock/reset-логику, шины APB/AXI, CDC. Помогает разработчикам firmware и драйверов понять, почему железо ведёт себя не так, как написано в reference manual.

Когда скилл нужен?

Когда reference manual неясен и RTL уточняет поведение регистра, при отладке CDC-багов, сопоставлении DMA-транзакций с драйвером или обсуждении SoC-диаграммы с командой железа.

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

SKILL.md · MIT
---
name: verilog-basics-for-lowlevel
description: Verilog basics skill for firmware and kernel engineers. Use when reading RTL to understand hardware behavior, reset/clock domains, bus protocols, or collaborating with hardware teams. Activates on queries about Verilog basics, RTL, hardware description, clock domain, reset synchronizer, or MMU in hardware.
---

# Verilog Basics for Low-Level Engineers

## Purpose

Give firmware and kernel engineers enough Verilog/SystemVerilog literacy to read RTL: modules, clocks/resets, combinational vs sequential logic, bus interfaces, and why hardware behavior explains driver bugs — not a replacement for HDL design courses.

## When to Use

- Reference manual unclear — RTL clarifies register behavior
- Understanding CDC (clock domain crossing) bugs
- Correlating DMA/AXI transactions with driver ordering
- Reviewing SoC block diagram with hardware team

## Workflow

### 1. Module structure

```verilog
module uart_tx (
    input  wire       clk,
    input  wire       rst_n,   /* active-low async reset */
    input  wire       start,
    input  wire [7:0] data,
    output reg        busy
);
    /* sequential logic */
    always @(posedge clk or negedge rst_n) begin
        if (!rst_n)
            busy <= 1'b0;
        else if (start)
            busy <= 1'b1;
        /* ... */
    end
endmodule
```

`wire` = combinational/network; `reg` in `always` block = flip-flop unless combinational `always @(*)`.

### 2. Synthesizable subset (what firmware folks need)

| Construct | Meaning |
|-----------|---------|
| `posedge clk` | Registered update |
| `assign x = a & b` | Combinational |
| `case` / `if` in `always @(*)` | Mux logic |
| Parameters `#(.WIDTH(32))` | Configurable width |

Avoid `#delay` in synthesizable RTL — simulation only.

### 3. Reset discipline

- Async assert, sync deassert common (`rst_sync_n`)
- Firmware must wait post-reset setup times — see RM reset chapter
- Multiple reset domains → peripheral may need explicit soft reset bit

### 4. Bus protocols (reading SoC diagrams)

| Bus | Typical use |
|-----|-------------|
| APB | Slow peripherals, simple reg interface |
| AHB | Higher throughput on-chip |
| AXI | DMA, modern SoCs — bursts, channels |

Linux `regmap` MMIO maps to APB/AXI slave decode in RTL address map.

### 5. Clock domains

Signals crossing `clk_a` → `clk_b` need synchronizers (2+ FFs). Metastability causes **intermittent** firmware bugs — not fixed in software alone.

### 6. Simulation vs silicon

```bash
# Typical open-source sim (conceptual)
iverilog -o sim.vvp design.v tb.v
vvp sim.vvp
```

QEMU/peripheral models may not match RTL edge cases.

### 7. Agent usage

```
/verilog-basics-for-lowlevel Explain this APB register block and when STATUS bit updates relative to WRITE
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| Bit toggles once | Pulse in RTL | Poll latch / clear-on-read in driver |
| Random corruption | CDC | Hardware synchronizer; don't hack delays |
| Read stale data | Bus bridge buffer | Follow RM ordering / barrier |
| IRQ stuck | Level vs pulse in RTL | Match handler ACK sequence |
| Verilog vs VHDL | Mixed SoC docs | Focus on interface signals table |

## Related Skills

- `skills/baremetal/mmio-and-bit-manipulation` — register access from C
- `skills/baremetal/peripherals-from-datasheet` — RM ↔ RTL
- `skills/baremetal/datasheet-and-refmanual-reading` — doc navigation
- `skills/kernel-dev/device-tree` — hardware integration in Linux
- `skills/qemu/protocol-analysis` — validate bus timing

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
naja-scope keplertech MCP-сервер naja-scope для Claude Code помогает агенту исследовать elaborated-дизайны SystemVerilog и VHDL. Он находит связи сигналов, раскрывает иерархию модулей и указывает строки исходного кода. CX Codex +1 ★ 22звёзд репо Silica simaanc MCP-сервер Silica подключает ИИ-агентов к цепочке инструментов EDA для разработки аппаратуры. Помогает проверять RTL, запускать симуляции и прошивать FPGA без ручного разбора логов. CX Codex +1 ★ 13звёзд репо hdldiagzero lcapossio Плагин hdldiagzero строит чистые SVG-диаграммы аппаратуры RTL, HDL и SoC прямо по описанию проекта. Плагин раскрашивает тактовые домены и проверяет геометрию линий. ★ 30звёзд репо Verdi Bridge RuihongY MCP-сервер Verdi Bridge связывает ИИ-агента с запущенной сессией Synopsys Verdi для анализа временных диаграмм и навигации по RTL. Пригодится инженерам цифровой верификации. CX Codex +1 ★ 25звёзд репо fpga Mindrally Набор правил разработки под FPGA на SystemVerilog в Vivado. Помогает настраивать тайминги, шину AXI, оптимизировать ресурсы и писать тестовые окружения. CX Codex +1 1 100установок amazon-keyspaces aws Скилл обучает агента управлять Amazon Keyspaces для Apache Cassandra, рассчитывать цены и готовить миграции. Помогает избежать ошибок в поддержке возможностей базы. CX Codex +1 5 700установок

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

Весь набор →
af-xdp Настраивает сокеты AF_XDP и память UMEM для скоростной обработки сетевых пакетов в userspace. Пригодится при написании фильтров трафика и балансировщиков. CX Codex +1 359установок triton-lang Скилл triton-lang учит агента писать GPU-ядра на Triton: @triton.jit, блочные tl.load/tl.store с масками, атомарные операции, автотюнинг и интеграцию в PyTorch. CX Codex +1 358установок containers-internals Скилл containers-internals для Claude Code по устройству Linux-контейнеров: намспейсы, cgroups v2, overlayfs, runc, seccomp и защита от escape. CX Codex +1 358установок rdma-verbs Скилл rdma-verbs для Claude Code — справочник по RDMA-программированию через libibverbs для InfiniBand и RoCE; в нём описаны настройка очередей, односторонняя запись и тесты perftest. CX Codex +1 356установок riscv-privileged Скилл riscv-privileged для разработки ядер и прошивок на RISC-V: работа с привилегированной архитектурой, режимами машины и супервизора, CSR регистрами, обработчиками ловушек, контроллерами PLIC и CLINT, OpenSBI. CX Codex +1 355установок mpi Помогает писать параллельные программы на MPI: настраивать вызовы процессов, неблокирующие операции, гибрид с OpenMP и запуск через mpirun. CX Codex +1 354установок hare-lang Скилл hare-lang обучает агента разработке на системном языке Hare: сборке через hare build, ручной настройке hare.mod, C FFI через @extern и типизированной обработке ошибок. CX Codex +1 330установок carbon-lang Скилл carbon-lang для Claude Code разбирает синтаксис Carbon, его связь с C++ и сборку toolchain. Помогает оценить язык и прототипировать миграцию. CX Codex +1 329установок

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

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