Skip to content

Eriemon/verilog-generator

readable-verilog-generator

Verified

Use when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.

FileKindSize
SKILL.mdskill md21.3 KB
agents/openai.yamlconfig363 B
assets/examples/existing_rtl/fsm_without_default.vother761 B
assets/examples/existing_rtl/fsm_without_default_spec.mdmarkdown311 B
assets/examples/existing_rtl/leaf_counter.vother314 B
assets/examples/existing_rtl/missing_output_register.vother423 B
assets/examples/existing_rtl/missing_output_register_spec.mdmarkdown331 B
assets/examples/existing_rtl/ready_valid_slice.vother967 B
assets/examples/existing_rtl/ready_valid_slice_spec.mdmarkdown420 B
assets/examples/existing_rtl/reset_gap_counter.vother319 B
assets/examples/existing_rtl/reset_gap_counter_spec.mdmarkdown212 B
assets/examples/existing_rtl/tb_ready_valid_slice.vother846 B
assets/examples/existing_rtl/top_counter.vother271 B
assets/examples/existing_rtl/traffic_light.vother2.5 KB
assets/examples/existing_rtl/traffic_light_spec.mdmarkdown585 B
assets/examples/readme/axis_packet_meter.vother10.2 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/generated/rtl/comb_hierarchy_budget.vother1.9 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/generated/tb/tb_comb_hierarchy_budget.vother2.5 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_child_loop.vother447 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_over_budget.vother527 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_q_cut.vother467 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_within_budget.vother450 B
assets/examples/remote_fixtures/comb_hierarchy_budget/spec.jsonconfig1.7 KB
assets/examples/remote_fixtures/comb_operation_budget/comb_operation_budget_bad.vother187 B
assets/examples/remote_fixtures/comb_operation_budget/generated/rtl/comb_operation_budget.vother6.1 KB
assets/examples/remote_fixtures/comb_operation_budget/generated/tb/tb_comb_operation_budget.vother5.7 KB
assets/examples/remote_fixtures/comb_operation_budget/spec.jsonconfig2.9 KB
assets/examples/remote_fixtures/comb_parity_mux/generated/rtl/comb_parity_mux.vother2.1 KB
assets/examples/remote_fixtures/comb_parity_mux/generated/tb/tb_comb_parity_mux.vother2.8 KB
assets/examples/remote_fixtures/comb_parity_mux/spec.jsonconfig1.9 KB
assets/examples/remote_fixtures/pipeline_delay/generated/rtl/pipeline_delay.vother4.5 KB
assets/examples/remote_fixtures/pipeline_delay/generated/tb/tb_pipeline_delay.vother2.6 KB
assets/examples/remote_fixtures/pipeline_delay/spec.jsonconfig2.2 KB
assets/examples/remote_fixtures/ready_valid_slice/generated/rtl/ready_valid_slice.vother5.2 KB
assets/examples/remote_fixtures/ready_valid_slice/generated/tb/tb_ready_valid_slice.vother2.9 KB
assets/examples/remote_fixtures/ready_valid_slice/spec.jsonconfig2.6 KB
assets/examples/rtl_erie_verilog_spec.jsonconfig2.1 KB
assets/examples/use_case_templates/jesd_adc.jsonconfig2.4 KB
assets/examples/use_case_templates/jesd_dac.jsonconfig2.5 KB
assets/examples/use_case_templates/mxfe_mixed.jsonconfig2.7 KB
assets/examples/use_case_templates/spi_adc.jsonconfig2.8 KB
assets/examples/use_case_templates/spi_dac.jsonconfig2.7 KB
assets/examples/verilog_pattern_templates/axi4_lite_csr.jsonconfig2.1 KB
assets/examples/verilog_pattern_templates/axi_interconnect_dma.jsonconfig2.3 KB
assets/examples/verilog_pattern_templates/axis_ready_valid.jsonconfig2.3 KB
assets/examples/verilog_pattern_templates/conv_load_store.jsonconfig1.8 KB
assets/external_interface_catalog.jsonconfig2.9 KB
assets/ideal_bad_style_metrics.jsonconfig17.5 KB
assets/installer/manifest.projection.jsonconfig2.8 KB
assets/installer/platforms.jsonconfig1.3 KB
assets/interface_templates/ahb_lite_config.vincother2.3 KB
assets/interface_templates/apb_config.vincother861 B
assets/interface_templates/axi4_full_master.vincother1.8 KB
assets/interface_templates/axi4_full_slave.vincother1.8 KB
assets/interface_templates/axi4_lite_config.vincother1.6 KB
assets/interface_templates/axi_stream_duplex.vincother1.1 KB
assets/interface_templates/catalog.jsonconfig2.6 KB
assets/project_ip_interface_manifest.template.jsonconfig9.4 KB
assets/readme-workflow.pngbinary1.4 MB
assets/readme/design-profile-cn.pngbinary1.4 MB
assets/readme/design-profile.pngbinary1.4 MB
assets/readme/evidence-guard-cn.pngbinary1.4 MB
assets/readme/evidence-guard.pngbinary1.4 MB
assets/readme/hero-overview-cn.pngbinary1.5 MB
assets/readme/hero-overview.pngbinary1.5 MB
assets/readme/project-facts-cn.pngbinary1.2 MB
assets/readme/project-facts.pngbinary1.3 MB
assets/readme/rule-rendering-cn.pngbinary1.4 MB
assets/readme/rule-rendering.pngbinary1.2 MB
assets/style_templates/header_prompt_none_mode.txtmarkdown2.1 KB
assets/style_templates/header_prompt_table_mode.txtmarkdown2.5 KB
assets/style_templates/rtl_bus_grouping.tplother1.0 KB
assets/style_templates/rtl_fsm.tplother832 B
assets/style_templates/rtl_header_bilingual.tplother1.6 KB
assets/style_templates/rtl_instantiation.tplother496 B
assets/style_templates/rtl_region_order.tplother987 B
assets/use_case_templates/catalog.jsonconfig2.8 KB
assets/use_case_templates/jesd_adc/README.mdmarkdown699 B
assets/use_case_templates/jesd_adc/constraints/system_constr.xdcother454 B
assets/use_case_templates/jesd_adc/manifest.jsonconfig1.7 KB
assets/use_case_templates/jesd_adc/tcl/common_bd.tclother4.0 KB
assets/use_case_templates/jesd_adc/tcl/system_bd.tclother920 B
assets/use_case_templates/jesd_adc/tcl/system_project.tclother1.0 KB
assets/use_case_templates/jesd_adc/verilog/system_top.vother2.9 KB
assets/use_case_templates/jesd_dac/README.mdmarkdown745 B
assets/use_case_templates/jesd_dac/constraints/system_constr.xdcother299 B
assets/use_case_templates/jesd_dac/manifest.jsonconfig1.7 KB
assets/use_case_templates/jesd_dac/tcl/common_bd.tclother4.8 KB
assets/use_case_templates/jesd_dac/tcl/system_bd.tclother923 B
assets/use_case_templates/jesd_dac/tcl/system_project.tclother1.1 KB
assets/use_case_templates/jesd_dac/verilog/system_top.vother2.9 KB
assets/use_case_templates/mxfe_mixed/README.mdmarkdown739 B
assets/use_case_templates/mxfe_mixed/constraints/system_constr.xdcother380 B
assets/use_case_templates/mxfe_mixed/manifest.jsonconfig1.8 KB
assets/use_case_templates/mxfe_mixed/tcl/common_bd.tclother5.4 KB
assets/use_case_templates/mxfe_mixed/tcl/system_bd.tclother1.2 KB
assets/use_case_templates/mxfe_mixed/tcl/system_project.tclother1.2 KB
assets/use_case_templates/mxfe_mixed/verilog/system_top.vother3.4 KB
assets/use_case_templates/spi_adc/README.mdmarkdown925 B
assets/use_case_templates/spi_adc/constraints/system_constr.xdcother635 B
assets/use_case_templates/spi_adc/manifest.jsonconfig1.7 KB
assets/use_case_templates/spi_adc/tcl/common_bd.tclother6.3 KB
assets/use_case_templates/spi_adc/tcl/system_bd.tclother1.6 KB
assets/use_case_templates/spi_adc/tcl/system_project.tclother982 B
assets/use_case_templates/spi_adc/verilog/system_top.vother4.2 KB
assets/use_case_templates/spi_dac/README.mdmarkdown757 B
assets/use_case_templates/spi_dac/constraints/system_constr.xdcother546 B
assets/use_case_templates/spi_dac/manifest.jsonconfig1.6 KB
assets/use_case_templates/spi_dac/tcl/common_bd.tclother5.7 KB
assets/use_case_templates/spi_dac/tcl/system_bd.tclother1.0 KB
assets/use_case_templates/spi_dac/tcl/system_project.tclother981 B
assets/use_case_templates/spi_dac/verilog/system_top.vother3.5 KB
assets/verilog_formatter_config/defaults.jsonconfig6.2 KB
assets/verilog_formatter_config/profiles/conservative.jsonconfig283 B
assets/verilog_formatter_config/profiles/example_compat.jsonconfig484 B
assets/verilog_formatter_config/profiles/formatter-lint.jsonconfig121 B
assets/verilog_formatter_config/profiles/formatter-normalize.jsonconfig182 B
assets/verilog_formatter_config/profiles/formatter-preserve.jsonconfig385 B
assets/verilog_formatter_config/profiles/formatting.jsonconfig270 B
assets/verilog_formatter_config/profiles/lint.jsonconfig269 B
assets/verilog_formatter_config/profiles/migration.jsonconfig239 B
assets/verilog_formatter_config/profiles/stress_cases_compat.jsonconfig484 B
assets/verilog_formatter_config/profiles/vitis-wrapper.jsonconfig486 B
assets/verilog_formatter_config/schema.jsonconfig13.7 KB
assets/verilog_formatter_config/templates/task-batch.jsonconfig212 B
assets/verilog_formatter_config/templates/task-inplace.jsonconfig221 B
assets/verilog_formatter_config/templates/task-single-file.jsonconfig220 B
assets/verilog_pattern_templates/axi4_lite_csr_shell.vincother562 B
assets/verilog_pattern_templates/axi_interconnect_port_groups.vincother592 B
assets/verilog_pattern_templates/axis_ready_valid_slice.vincother494 B
assets/verilog_pattern_templates/catalog.jsonconfig2.2 KB
assets/verilog_pattern_templates/conv_load_store_pipeline.vincother457 B
assets/verilog_pattern_templates/counter_state_bridge.vincother443 B
assets/verilog_pattern_templates/equivalence_wrapper_probe.vincother306 B
assets/verilog_pattern_templates/fsm_state_transition.vincother1.0 KB
assets/verilog_pattern_templates/phase_output_registering.vincother404 B
assets/verilog_pattern_templates/wrapper_top_stitching.vincother608 B
assets/verilog_quality_gates.jsonconfig38.2 KB
assets/verilog_style_rules.jsonconfig11.8 KB
assets/xilinx_primitive_semantics.jsonconfig21.4 KB
references/checklists/capability-distillation-checklist.mdmarkdown3.0 KB
references/checklists/lint-checklist.mdmarkdown3.6 KB
references/checklists/verilog-readability-gate.mdmarkdown3.5 KB
references/corpus/verilog-style-observations.mdmarkdown4.6 KB
references/integration/configuration.mdmarkdown19.9 KB
references/integration/host-integration.mdmarkdown10.6 KB
references/rules/asic-verilog-quality.mdmarkdown3.9 KB
references/rules/erie-style.mdmarkdown6.3 KB
references/rules/testbench-patterns.mdmarkdown3.2 KB
references/rules/verilog-code-comment-naming-standard.mdmarkdown55.6 KB
references/rules/verilog-comment-placement.mdmarkdown8.4 KB
references/rules/verilog-pattern-templates.mdmarkdown1.1 KB
references/rules/verilog-quality-gates.mdmarkdown21.4 KB
references/rules/xilinx-primitive-exemptions.mdmarkdown10.6 KB
references/skill/installation.mdmarkdown6.1 KB
references/skill/script-guide.mdmarkdown7.5 KB
references/skill/skill-standards.mdmarkdown2.1 KB
references/workflows/verilog_dispatcher.mdmarkdown6.4 KB
references/workflows/workflow-contracts.mdmarkdown15.1 KB
scripts/__init__.pyscript53 B
scripts/python/__init__.pyscript55 B
scripts/python/corpus/analyze_verilog_style_corpus.pyscript25.3 KB
scripts/python/existing_rtl/existing_rtl.pyscript81.1 KB
scripts/python/existing_rtl/existing_rtl_improvement.pyscript109.9 KB
scripts/python/existing_rtl/intervention.pyscript8.3 KB
scripts/python/existing_rtl/optimizer.pyscript25.8 KB
scripts/python/existing_rtl/reflection.pyscript86.7 KB
scripts/python/existing_rtl/semantic_contract.pyscript45.6 KB
scripts/python/existing_rtl/verifier.pyscript15.3 KB
scripts/python/existing_rtl/verify_repair.pyscript4.6 KB
scripts/python/existing_rtl/verify_repair_core.pyscript45.7 KB
scripts/python/existing_rtl/verify_repair_patch_apply.pyscript23.5 KB
scripts/python/existing_rtl/verify_repair_patch_categories.pyscript35.5 KB
scripts/python/existing_rtl/verify_repair_patch_plan.pyscript25.1 KB
scripts/python/existing_rtl/verify_repair_patching.pyscript2.4 KB
scripts/python/existing_rtl/verify_repair_support.pyscript25.6 KB
scripts/python/existing_rtl/verify_repair_testbench.pyscript45.9 KB
scripts/python/existing_rtl/verify_reporting.pyscript16.1 KB
scripts/python/facade/__init__.pyscript45 B
scripts/python/facade/existing_rtl_api.pyscript14.0 KB
scripts/python/facade/quality_api.pyscript19.9 KB
scripts/python/facade/representative_cases.pyscript38.3 KB
scripts/python/facade/verilog_api.pyscript6.5 KB
scripts/python/facade/workflow_api.pyscript63.2 KB
scripts/python/generation/tb_generator.pyscript54.9 KB
scripts/python/header_contract.pyscript21.1 KB
scripts/python/installation/__init__.pyscript52 B
scripts/python/installation/bundle.pyscript16.3 KB
scripts/python/installation/catalog.pyscript16.6 KB
scripts/python/installation/cli.pyscript26.4 KB
scripts/python/installation/projection.pyscript14.2 KB
scripts/python/installation/receipt.pyscript13.4 KB
scripts/python/installation/transaction.pyscript29.0 KB
scripts/python/quality/clock_name_roles.pyscript1.0 KB
scripts/python/quality/comment_placement.pyscript49.5 KB
scripts/python/quality/declaration_region_policy.pyscript8.0 KB
scripts/python/quality/deliverable_gate.pyscript51.9 KB
scripts/python/quality/external_interface_stubs.pyscript41.5 KB
scripts/python/quality/formatter_ast.pyscript85.0 KB
scripts/python/quality/formatter_ast_instances.pyscript5.4 KB

assets/use_case_templates/spi_adc/tcl/common_bd.tcl

View on GitHub
# ADC SPI 主接口位于模板边界,确保顶层引脚约束只绑定一个采样通道
create_bd_intf_port -mode Master -vlnv analog.com:interface:spi_master_rtl:1.0 adc_spi

# CNV 输出端口承担外部 SAR ADC 启动副作用,确保采样节拍可由 BD 控制
create_bd_port -dir O adc_spi_cnv

# BUSY 输入保留外部转换完成状态,确保 offload 触发依据来自真实 ADC 引脚
create_bd_port -dir I adc_spi_busy

# ADC_RESOLUTION 限制 SPI 样本打包位宽,避免高分辨率数据被截断
set countAdcResolution [get_env_param ADC_RESOLUTION 16]

# ADC_NUM_CHANNELS 控制 SPI engine 通道展开,确保采样流和外部 ADC 通道数一致
set countAdcNumChannels [get_env_param ADC_NUM_CHANNELS 1]

# ADC_SAMPLING_RATE 作为 CNV 周期目标,确保脉冲发生器匹配采样需求
set countAdcSamplingRate [get_env_param ADC_SAMPLING_RATE 1000000]

# SPI_CLK_REF_FREQUENCY 是周期换算基准,避免采样率与 SPI 时钟单位混淆
set countSpiClkRefFrequency [get_env_param SPI_CLK_REF_FREQUENCY 166]

# SPI 数据宽度按分辨率折叠到 16/32 位,确保 DMA 侧字宽与样本容器匹配
set countSpiDataWidth [expr {$countAdcResolution <= 16 ? 16 : 32}]

# 采样周期以 SPI 参考时钟计数表示,确保脉冲发生器无需再处理频率单位
set countSamplingCycle [expr {int(ceil(double($countSpiClkRefFrequency * 1000000) / $countAdcSamplingRate))}]

# SPI engine helper 进入 Tcl 环境,确保后续采样层次块按 ADI 封装生成
source $ad_hdl_dir/library/spi_engine/scripts/spi_engine.tcl

# SPI engine 层次名保持稳定,确保顶层连接和软件地址映射引用同一实例
set hierSpiEngine spi_adc_capture

# SPI 采样 engine 承接 ADC 参数,确保通道数量和数据宽度同步进入 offload 路径
spi_engine_create $hierSpiEngine $countSpiDataWidth 1 1 $countAdcNumChannels 0

# 转换触发脉冲发生器是 CNV 的唯一来源,避免外部 ADC 被多个逻辑同时启动
ad_ip_instance axi_pulse_gen adc_trigger_gen

# 触发周期使用换算后的时钟计数,确保目标采样节拍由硬件维持
ad_ip_parameter adc_trigger_gen CONFIG.PULSE_PERIOD $countSamplingCycle

# 单周期 CNV 宽度限制触发窗口,避免外部 ADC 在一次采样中重复启动
ad_ip_parameter adc_trigger_gen CONFIG.PULSE_WIDTH 1

# BUSY 同步模块隔离外部引脚和 SPI 时钟域,降低亚稳态风险
create_bd_cell -type module -reference sync_bits adc_busy_sync

# BUSY 边沿检测模块将转换完成事件变成 offload 触发,确保采样动作由 ADC 状态驱动
create_bd_cell -type module -reference ad_edge_detect adc_busy_edge

# 上升沿约定匹配 BUSY 完成时序,避免在转换开始阶段提前触发采样
set_property -dict [list CONFIG.EDGE 1] [get_bd_cells adc_busy_edge]

# ADC DMA 是采样流进入处理系统内存的唯一搬运路径,确保数据落点清晰
ad_ip_instance axi_dmac axi_spi_adc_dma

# DMA 源端保持流接口,确保 SPI engine 样本通过握手进入搬运路径
ad_ip_parameter axi_spi_adc_dma CONFIG.DMA_TYPE_SRC 1

# DMA 目的端保持内存映射方向,确保软件从处理系统缓冲区读取采样结果
ad_ip_parameter axi_spi_adc_dma CONFIG.DMA_TYPE_DEST 0

# cyclic 模式关闭后采集窗口由软件启动,避免持续覆盖采样缓冲
ad_ip_parameter axi_spi_adc_dma CONFIG.CYCLIC 0

# 二维搬运被关闭,确保样本流按线性内存顺序写入
ad_ip_parameter axi_spi_adc_dma CONFIG.DMA_2D_TRANSFER 0

# DMA 流侧宽度跟随 SPI 样本宽度,避免采样数据在入口被截断
ad_ip_parameter axi_spi_adc_dma CONFIG.DMA_DATA_WIDTH_SRC $countSpiDataWidth

# DMA 内存侧宽度限制为 64 位,确保与处理系统通用数据口兼容
ad_ip_parameter axi_spi_adc_dma CONFIG.DMA_DATA_WIDTH_DEST 64

# SPI engine 控制域使用系统 CPU 时钟,确保寄存器访问与处理系统同步
ad_connect sys_cpu_clk $hierSpiEngine/clk

# 触发发生器外部时钟来自 SPI 时钟,确保 CNV 与采样域同步
ad_connect spi_clk adc_trigger_gen/ext_clk

# 触发发生器寄存器接口使用系统 CPU 时钟,确保软件配置路径稳定
ad_connect sys_cpu_clk adc_trigger_gen/s_axi_aclk

# 触发发生器复位跟随系统复位,避免复位后残留旧采样周期
ad_connect sys_cpu_resetn adc_trigger_gen/s_axi_aresetn

# BUSY 边沿检测使用 SPI 时钟,确保 offload 触发与采样 engine 同域
ad_connect spi_clk adc_busy_edge/clk

# BUSY 边沿检测复位固定为低,避免额外复位屏蔽采样完成事件
ad_connect adc_busy_edge/rst GND

# SPI engine 复位跟随系统复位,确保采样链路启动状态由软件统一控制
ad_connect sys_cpu_resetn $hierSpiEngine/resetn

# SPI engine 串行时钟使用采样域时钟,避免串行事务跨域
ad_connect spi_clk $hierSpiEngine/spi_clk

# SPI engine 主接口唯一到达顶层 ADC SPI 端口,确保 XDC 约束目标稳定
ad_connect $hierSpiEngine/m_spi adc_spi

# ADC BUSY 先进入同步模块,确保外部状态跨域后再参与边沿检测
ad_connect adc_spi_busy adc_busy_sync/in_bits

# 同步后的 BUSY 才能驱动边沿检测,避免亚稳态直接触发 offload
ad_connect adc_busy_sync/out_bits adc_busy_edge/signal_in

# BUSY 边沿作为 offload 触发源,确保转换完成后才发起 SPI 读取
ad_connect adc_busy_edge/signal_out $hierSpiEngine/offload/trigger

# 周期性脉冲唯一到达 CNV 端口,确保外部 ADC 启动节拍由脉冲发生器控制
ad_connect adc_trigger_gen/pulse adc_spi_cnv

# DMA 输入流消费 SPI engine 样本输出,确保采样结果直接进入内存搬运路径
ad_connect axi_spi_adc_dma/s_axis $hierSpiEngine/M_AXIS_SAMPLE

# SPI engine 寄存器地址固定在软件驱动预期窗口,确保采样命令表可寻址
ad_cpu_interconnect 0x44A00000 $hierSpiEngine/axi_regmap

# ADC DMA 寄存器地址固定在采集控制窗口,确保软件能启动和监控搬运
ad_cpu_interconnect 0x44A30000 axi_spi_adc_dma

# 触发发生器寄存器地址固定在节拍控制窗口,确保软件可调整采样周期
ad_cpu_interconnect 0x44B00000 adc_trigger_gen

# ADC DMA 中断接入处理系统,确保采集完成状态能进入软件报告
ad_cpu_interrupt "ps-13" "mb-13" axi_spi_adc_dma/irq
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall