Skip to main content

RTL Buddy

RTL Buddy is a Python CLI for Verilog and SystemVerilog RTL workflows, including test execution, randomized regression testing, Verilator and VCS simulation, Yosys synthesis, coverage collection, and YAML-based automation.

It wraps simulation, synthesis, and project scripts to provide a structured, config-driven test, regression, and synthesis system for ASIC and FPGA projects. The primary supported simulation flows are Verilator on macOS/Linux and VCS on Linux.

Features​

  • Run individual Verilog/SystemVerilog tests or full regressions from YAML config files
  • Randomized seed testing with repeat and replay support
  • Plugin hooks for sweep generation, test pre-processing, and post-processing
  • Filelist generation from models.yaml
  • Yosys synthesis runs and synthesis regressions from synth.yaml
  • Verilator coverage collection, merge, summary, and export workflows
  • Basic Verible command integration for lint, syntax, formatting, and preprocessing
  • Machine-readable JSONL logging for use with AI agents and CI pipelines

rtl_buddy can be adapted to different project toolchains, but the primary supported simulation flows are Verilator and VCS, and synthesis through Yosys. Broader first-class Verible and PeakRDL workflows are on the roadmap.

SystemVerilog Regression Testing​

RTL Buddy keeps simulator invocation, seeds, logs, result handling, and regression selection consistent across repeated verification runs. Projects describe suites, tests, platforms, builders, and models in readable YAML files instead of scattering that logic across ad hoc shell scripts.

Verilator and VCS Simulation Workflows​

The CLI gives RTL projects one command surface for open-source Verilator flows and Linux VCS flows, with optional hooks for project-specific compile, simulation, sweep, and post-processing behavior.

Yosys Synthesis Workflows​

Synthesis configs use the same YAML-driven style as tests and regressions. Projects can define technology-independent or Liberty-mapped Yosys runs, capture synthesis artefacts, and run synthesis regressions from one command surface.

Getting Started​

Reference​