Struct ChiselBackend 

pub struct ChiselBackend;

Code-generation backend for Chisel 3 / Chisel 5.

Implementations

impl ChiselBackend

pub fn new() -> Self

Create a new ChiselBackend.

pub fn emit_type(&self, ty: &ChiselType) -> String

Emit the Chisel type string for a ChiselType.

pub fn io_bundle(&self, ports: &[ChiselPort]) -> String

Emit the val io = IO(new Bundle { ... }) declaration for a port list.

pub fn emit_module(&self, module: &ChiselModule) -> String

Emit a complete Chisel module class.

pub fn when_stmt(&self, cond: &str, body: &str) -> String

Emit a when block: when(cond) { body }.

pub fn when_otherwise( &self, cond: &str, when_body: &str, other_body: &str, ) -> String

Emit a when / otherwise block.

pub fn reg_init(&self, name: &str, ty: &ChiselType, init: &str) -> String

Emit a register declaration: val r = RegInit(init_val).

pub fn reg_no_reset(&self, name: &str, ty: &ChiselType) -> String

Emit a register declaration without reset: val r = Reg(gen).

pub fn wire_decl(&self, name: &str, ty: &ChiselType) -> String

Emit a wire declaration: val w = Wire(gen).

pub fn connect(&self, lhs: &str, rhs: &str) -> String

Emit a connection: lhs := rhs.

pub fn printf(&self, fmt_str: &str, args: &[&str]) -> String

Emit a printf debug statement.

pub fn assert_stmt(&self, cond: &str, msg: &str) -> String

Emit a assert statement.

pub fn mux_expr(&self, sel: &str, t: &str, f: &str) -> String

Emit a Mux expression string.

pub fn cat_expr(&self, parts: &[&str]) -> String

Emit a Cat expression string.

pub fn fill_expr(&self, count: u32, value: &str) -> String

Emit a fill (replicate) expression.

pub fn instantiate(&self, class: &str, inst_name: &str) -> String

Emit a submodule instantiation.

pub fn emit_expr(&self, expr: &ChiselExpr) -> String

Emit a ChiselExpr as a string.

impl ChiselBackend

pub fn dont_care(&self, signal: &str) -> String

Emit a DontCare assignment.

pub fn irrevocable_port( &self, name: &str, data_type: &ChiselType, is_output: bool, ) -> String

Emit an Irrevocable (valid+ready, never de-asserts valid) port.

pub fn comb_rom( &self, name: &str, _data_type: &ChiselType, values: &[&str], ) -> String

Emit a combinational ROM using a Vec[UInt] initialized from a list.

pub fn mux1h(&self, _sel: &str, cases: &[(&str, &str)]) -> String

Emit a Mux1H (one-hot mux).

pub fn log2_ceil(&self, n: u32) -> u32

Emit a log2Ceil computation.

pub fn log2_floor(&self, n: u32) -> u32

Emit a log2Floor computation.

pub fn is_pow2(&self, n: u32) -> bool

Check if n is a power of two.

pub fn cover_stmt(&self, cond: &str, msg: &str) -> String

Emit a cover statement (Chisel formal verification).

pub fn assume_stmt(&self, cond: &str) -> String

Emit an assume statement.

pub fn sim_printf(&self, fmt_str: &str, args: &[&str]) -> String

Emit a ChiselSim-compatible printf for simulation only.

pub fn fill(&self, n: u32, expr: &str) -> String

Emit a chisel3.util.Fill call (replicate a bit pattern).

pub fn cat(&self, signals: &[&str]) -> String

Emit a Cat call (concatenate signals).

pub fn popcount(&self, signal: &str) -> String

Emit a PopCount call.

pub fn oh_to_uint(&self, one_hot: &str) -> String

Emit a priority encoder (OHToUInt).

pub fn uint_to_oh(&self, n: &str, width: u32) -> String

Emit a UIntToOH call.

pub fn reverse(&self, signal: &str) -> String

Emit a Reverse call (bit-reversal).

pub fn mux_case(&self, default: &str, cases: &[(&str, &str)]) -> String

Emit a MuxCase expression.

pub fn shift_register(&self, data: &str, n: u32, reset_val: &str) -> String

Emit a ShiftRegister instantiation.

pub fn round_robin_arbiter( &self, name: &str, data_type: &ChiselType, n: u32, ) -> String

Emit an arbiter (RRArbiter) for n inputs of a given type.

pub fn priority_arbiter( &self, name: &str, data_type: &ChiselType, n: u32, ) -> String

Emit a fixed-priority arbiter.

pub fn queue_module( &self, name: &str, data_type: &ChiselType, depth: u32, ) -> String

Emit a Chisel FIFO queue module instantiation.

pub fn when_chain( &self, cond_body: &[(&str, &str)], otherwise: Option<&str>, ) -> String

Emit a when/elsewhen/otherwise chain.

pub fn counter(&self, name: &str, max_val: u32, enable: &str) -> String

Emit a counter that wraps at max_val.

pub fn reset_sync(&self, name: &str, async_rst: &str) -> String

Emit a reset synchronizer (2-FF synchronizer for reset deassertion).

pub fn cdc_handshake_comment(&self, from_clk: &str, to_clk: &str) -> String

Emit a clock domain crossing (CDC) handshake wrapper comment.

pub fn blackbox_stub(&self, name: &str, params: &[(&str, &str)]) -> String

Emit a BlackBox module class stub.

Trait Implementations

impl Clone for ChiselBackend

fn clone(&self) -> ChiselBackend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChiselBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChiselBackend

fn default() -> ChiselBackend

Returns the “default value” for a type.