Community编程与开发github.com

ambulGruidae/rtl-verif-env-generator

用于生成带有FST波形和内建信号注入辅助方法的RTL pytest验证环境的Codex技能。

rtl-verif-env-generator 是什么?

此技能专为Codex等AI编码代理设计,旨在自动化生成RTL(寄存器传输级)设计的pytest验证环境。它通过提供生成FST(Fast Signal Trace)波形文件的框架,帮助开发者快速搭建测试平台,并支持内部信号注入(deposit)辅助函数,方便在测试过程中直接操作设计内部信号。该技能支持常见的硬件描述语言环境(如Verilog/VHDL),并集成了pytest的测试组织方式,使得验证流程更加模块化和可维护。用户只需提供RTL设计文件路径和基本配置,技能即可生成完整的验证环境骨架,包括测试用例模板、波形记录配置和信号存取接口,从而大幅提升硬件验证的效率。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add ambulGruidae/rtl-verif-env-generator

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

rtl-verif-env-generator 是做什么的?

用于生成带有FST波形和内建信号注入辅助方法的RTL pytest验证环境的Codex技能。

该技能自动构建基于pytest的RTL验证环境,重点支持以下功能:

  • FST波形生成:自动配置并记录测试执行期间的FST波形文件,便于调试和可视化。
  • 内部信号注入:提供便捷的辅助函数,无需修改设计源代码即可直接注值(deposit)内部信号,简化复杂测试场景的构造。
  • pytest集成:生成标准化的pytest测试结构,包括conftest.py中的固件(fixtures)和参数化测试用例。

使用示例

# 示例测试用例(由技能自动生成)
def test_signal_deposit(my_rtl_env):
    # 使用内部信号注入辅助函数
    my_rtl_env.deposit("top_module.internal_signal", 0x5A)
    my_rtl_env.run_cycles(10)
    assert my_rtl_env.read("top_module.output_signal") == expected_value

支持平台

  • Codex(主要目标)
  • 其他兼容OpenAI API的AI编码代理

工作原理

  1. 分析用户提供的RTL设计文件(Verilog/VHDL)。
  2. 生成包含必要仿真库和插件(如vcd、fst)的requirements.txt。
  3. 创建tests/目录结构,含conftest.py(定义rtl_env固件)和示例测试文件。
  4. 在固件中配置波形输出路径和信号注入接口。
  5. 支持通过环境变量或配置文件自定义编译器和仿真参数。

快速开始

  1. 确保已安装Python 3.8+和仿真工具(如Verilator或Icarus Verilog)。
  2. 在项目根目录运行技能:codex run ambulGruidae/rtl-verif-env-generator。
  3. 按提示提供RTL设计顶层文件路径。
  4. 运行生成的测试:pytest tests/ -v。

配置选项

变量名说明默认值
RTL_TOP顶层模块名top
RTL_FILE设计文件路径无
SIM_TIMEOUT仿真超时(秒)60
WAVEFORM_LEVEL波形记录级别(all/top/none)all

许可证

MIT

相关技能