dv-flow-libcocotb 0.0.128303801906

DV Flow Manager tasks for building and running cocotb testbenches

dv-flow-libcocotb

DV Flow Manager (dfm) tasks for building and running cocotb testbenches.

dv-flow-libcocotb contains no simulator build/run code — it emits dfm data items that drive the simulator tasks in dv-flow-libhdlsim. The same flow graph works for every supported simulator:

rtl, cocotb.<sim>.Setup  ->  hdlsim.<sim>.SimImage  ->  hdlsim.<sim>.SimRun
                                                        (+ cocotb.TestConfig)

• cocotb.<sim>.Setup — emits the cocotb VPI library, the cocotb run-time environment, and (for Verilator) cocotb's C++ main plus --prefix Vtop.
• cocotb.TestConfig — selects the test module(s)/case(s) and HDL toplevel.
• cocotb.CheckResults — turns results.xml failures into dfm errors.

Verified end-to-end with Icarus Verilog and Verilator. See docs/ for the design, the implementation plan, and the user guide.

Quickstart (Verilator)

package:
  name: my_dv
  imports: [std, hdlsim.vlt, cocotb, cocotb.vlt]
  tasks:
    - name: rtl
      uses: std.FileSet
      with: { base: rtl, type: verilogSource, include: "*.v" }
    - name: setup
      uses: cocotb.vlt.Setup
      with: { pythonpath: [tb] }
    - name: testcfg
      uses: cocotb.TestConfig
      with: { module: [test_dff], toplevel: dff }
    - name: build
      uses: hdlsim.vlt.SimImage
      needs: [rtl, setup]
      with: { top: [dff] }
    - name: sim
      uses: hdlsim.vlt.SimRun
      needs: [build, testcfg]
    - name: check
      uses: cocotb.CheckResults
      needs: [sim]

dfm run check