Struct WasmBackend 

pub struct WasmBackend { /* private fields */ }

The runtime WASM backend.

Implementations

impl WasmBackend

pub fn new( laid_out: &LaidOutProgram, options: &SimulatorOptions, ) -> Result<Self, SimulatorError>

pub fn eval_comb(&mut self) -> Result<(), SimulatorErrorCode>

pub fn eval_apply_ff_at( &mut self, event: &WasmEventRef, ) -> Result<(), SimulatorErrorCode>

pub fn eval_only_ff_at( &mut self, event: &WasmEventRef, ) -> Result<(), SimulatorErrorCode>

pub fn apply_ff_at( &mut self, event: &WasmEventRef, ) -> Result<(), SimulatorErrorCode>

pub fn run_process(&mut self, index: usize) -> Result<(), SimulatorErrorCode>

pub fn resolve_signal(&self, addr: &AbsoluteAddr) -> SignalRef

pub fn resolve_event(&self, addr: &AbsoluteAddr) -> WasmEventRef

pub fn resolve_event_opt(&self, addr: &AbsoluteAddr) -> Option<WasmEventRef>

pub fn resolve_eval_only_event( &self, addr: &AbsoluteAddr, ) -> Option<WasmEventRef>

pub fn resolve_apply_event(&self, addr: &AbsoluteAddr) -> Option<WasmEventRef>

pub fn set<T: Copy>(&mut self, signal: SignalRef, value: T)

pub fn set_wide(&mut self, signal: SignalRef, value: BigUint)

pub fn set_four_state( &mut self, signal: SignalRef, value: BigUint, mask: BigUint, )

pub fn get(&self, signal: SignalRef) -> BigUint

pub fn get_as<T: Default + Copy>(&self, signal: SignalRef) -> T

pub fn get_four_state(&self, signal: SignalRef) -> (BigUint, BigUint)

pub fn memory_as_ptr(&self) -> (*const u8, usize)

pub fn memory_as_mut_ptr(&mut self) -> (*mut u8, usize)

pub fn runtime_event_buffer_as_ptr(&self) -> (*const u8, usize)

pub fn set_comb_capture_event_enabled(&mut self, active_sites: &[bool])

pub fn stable_region_size(&self) -> usize

pub fn layout(&self) -> &MemoryLayout

pub fn id_to_addr_slice(&self) -> &[AbsoluteAddr]

pub fn id_to_event_slice(&self) -> &[WasmEventRef]

pub fn num_events(&self) -> usize

pub fn clear_triggered_bits(&mut self)

pub fn mark_triggered_bit(&mut self, id: usize)

pub fn get_triggered_bits(&self) -> BitSet

Trait Implementations

impl SimBackend for WasmBackend

type Event = WasmEventRef

The event handle type produced by this backend.

fn eval_comb(&mut self) -> Result<(), SimulatorErrorCode>

fn eval_apply_ff_at( &mut self, event: WasmEventRef, ) -> Result<(), SimulatorErrorCode>

Evaluate and apply a flip-flop domain for the given event.

fn eval_only_ff_at( &mut self, event: WasmEventRef, ) -> Result<(), SimulatorErrorCode>

Evaluate FF domain without applying (for cascaded clocks).

fn apply_ff_at(&mut self, event: WasmEventRef) -> Result<(), SimulatorErrorCode>

Apply (commit) an already-evaluated FF domain.

fn run_process(&mut self, index: usize) -> Result<(), SimulatorErrorCode>

Run process kernel index until it suspends or ends. The kernel reports how it returned in its control slots. Backends without process kernels reject the call.

fn resolve_signal(&self, addr: &AbsoluteAddr) -> SignalRef

fn resolve_event(&self, addr: &AbsoluteAddr) -> WasmEventRef

fn resolve_event_opt(&self, addr: &AbsoluteAddr) -> Option<WasmEventRef>

fn resolve_eval_only_event(&self, addr: &AbsoluteAddr) -> Option<WasmEventRef>

fn resolve_apply_event(&self, addr: &AbsoluteAddr) -> Option<WasmEventRef>

fn set<T: Copy>(&mut self, signal: SignalRef, value: T)

fn set_wide(&mut self, signal: SignalRef, value: BigUint)

fn set_four_state(&mut self, signal: SignalRef, value: BigUint, mask: BigUint)

fn get(&self, signal: SignalRef) -> BigUint

fn get_as<T: Default + Copy>(&self, signal: SignalRef) -> T

fn get_four_state(&self, signal: SignalRef) -> (BigUint, BigUint)

fn memory_as_ptr(&self) -> (*const u8, usize)

fn memory_as_mut_ptr(&mut self) -> (*mut u8, usize)

Exposing a retained writable view must permanently disable sparse VCD tracking in backend-owned state outside the returned memory range.

fn write_memory(&mut self, offset: usize, bytes: &[u8])

Overwrite bytes.len() bytes of the memory image at offset.

fn vcd_tracking_enabled(&self) -> bool

Opt into generated write notifications only while no raw mutable view has escaped. The default keeps other backend implementations correct.

fn runtime_event_buffer_as_ptr(&self) -> (*const u8, usize)

fn set_comb_capture_event_enabled(&mut self, active_sites: &[bool])

fn stable_region_size(&self) -> usize

fn layout(&self) -> &MemoryLayout

fn id_to_addr_slice(&self) -> &[AbsoluteAddr]

fn id_to_event_slice(&self) -> &[WasmEventRef]

fn num_events(&self) -> usize

fn clear_triggered_bits(&mut self)

fn mark_triggered_bit(&mut self, id: usize)

fn get_triggered_bits(&self) -> BitSet

fn eval_comb_apply_ff_at( &mut self, event: Self::Event, ) -> Result<(), SimulatorErrorCode>

Evaluate combinational logic and then evaluate/apply one flip-flop domain. Backends may override this to compile the two phases as one function; the default preserves the same ordering with two calls.

fn eval_comb_apply_ff_many_at( &mut self, event: Self::Event, count: u64, ) -> (u64, Result<(), SimulatorErrorCode>)

Execute up to count identical fused ticks. The returned count is the number of iterations completed before a runtime event or error forced a return to the host. Backends without an in-function loop execute one iteration so the caller can preserve per-tick observation semantics.

fn memory_owner(&self) -> Option<Arc<dyn Any + Sync + Send>>

Return an opaque owner that keeps the memory allocation alive.

fn runtime_event_buffer(&self) -> Option<Arc<RuntimeEventBuffer>>

fn take_vcd_activity(&mut self, groups: &mut Vec<usize>) -> bool

Consume waveform activity independently of clock trigger processing. Returns false when full scanning is required (including raw host views).

fn mark_vcd_signal(&mut self, signal: SignalRef)

Called by host setters, which share the generated-store notification ABI.