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