autombist 0.3.1

MBIST wrapper and fault-flow generator

autombist

autombist automatically generates MBIST integration artifacts for OpenRAM-generated SRAM macros. It builds a March C-oriented MBIST wrapper around your memory interface, emits the required MBIST RTL files, and creates outputs under out/ by default.

The generated artifacts can be synthesized with Yosys or other synthesis tools. autombist also supports fault simulation by injecting stuck-at faults (SA0 and SA1) and validating behavior through Cocotb with Icarus Verilog.

What It Generates

For each memory in your config, autombist generates a module directory under out/<memory_name>/ with:

• MBIST wrapper Verilog
• Required MBIST RTL support files
• Optional saboteur wrapper for fault injection (--test mode)
• Optional fault masks and a local simulation Makefile (--test mode)

Prerequisites

1. Python 3.10+
2. OpenRAM-generated memory and matching config file
3. For fault simulation:
   • Icarus Verilog (iverilog) installed system-wide
   • Cocotb installed in your Python environment

Installation

Install from the repository root:

python -m pip install .

For development:

python -m pip install -e .

If the package is published to PyPI, you can install directly with:

python -m pip install autombist

Basic Generation

Generate MBIST outputs using the default output directory (out):

autombist --config config.yml --out out

If --out is omitted, out/ is used by default.

Fault Simulation Flow

Generate fault-enabled artifacts (saboteur + fault masks + module Makefile):

autombist --config config.yml --out out --test --faults 50 --seed 1234

This command injects random SA0/SA1 faults into the memory model and writes fault files to:

out/<memory_name>/faults/

Then run simulation from the generated module directory:

cd out/<memory_name>
make

For verbose simulation output:

make debug

Synthesis

Use the generated wrapper and MBIST RTL files in your synthesis flow (for example, Yosys or equivalent EDA tools).

CLI Help

autombist --help
autombist --version