Struct StateBank 

pub struct StateBank { /* private fields */ }

Word-addressed software state bank exposing observable driver state slots, policy-gated runtime knobs, read probes, and diagnostic triggers.

Implementations

impl StateBank

pub fn new(logical_size: u64) -> Self

Creates an empty StateBank with the given byte logical_size.

pub fn logical_size(&self) -> u64

Returns the logical byte size of the state bank.

pub fn writable_offsets(&self) -> &[u64]

Returns the 4-byte aligned offsets that are configured as writable knobs or triggers.

pub fn ceiling(&self) -> ResourceCeiling

Builds the default ResourceCeiling for this state bank, allowing 32-bit reads and polls within logical_size and permitting writes only on offsets registered via Self::define_knob or Self::define_trigger.

pub fn define_state_slot( &mut self, offset: u64, initial: u32, ) -> StateSlotHandle

Defines a read-only 32-bit observable state slot at a 4-byte aligned offset and returns a StateSlotHandle for the driver to update.

pub fn define_knob(&mut self, offset: u64, initial: u32) -> StateSlotHandle

Defines a policy-gated writable 32-bit runtime knob at a 4-byte aligned offset and returns a StateSlotHandle for the driver to read.

pub fn define_read_probe( &mut self, offset: u64, probe: impl Fn() -> Result<u32, BackendError> + Send + Sync + 'static, )

Defines a read-only on-demand probe callback at a 4-byte aligned offset.

pub fn define_trigger( &mut self, offset: u64, trigger: impl Fn(u32) -> Result<u32, BackendError> + Send + Sync + 'static, )

Defines a write-triggered diagnostic action at a 4-byte aligned offset.

Writing value to offset invokes trigger(value) and stores the returned u32 status into the entry’s last_result slot so readback or subsequent read32/poll32 calls observe the trigger outcome.

Trait Implementations

impl Clone for StateBank

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateBank

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

Formats the value using the given formatter.

impl MmioBackend for StateBank

fn read32(&mut self, offset: u64) -> Result<u32, BackendError>

Performs one volatile 32-bit read at offset bytes from the start of the logical resource.

fn write32(&mut self, offset: u64, value: u32) -> Result<(), BackendError>

Performs one volatile 32-bit write at offset bytes from the start of the logical resource.

fn barrier(&mut self)

Applies a platform MMIO memory barrier.

impl ResourceBackend for StateBank

fn read32(&mut self, offset: u64) -> Result<u32, BackendError>

fn write32(&mut self, offset: u64, value: u32) -> Result<(), BackendError>

fn barrier(&mut self)

fn gpio_read(&mut self) -> Result<bool, BackendError>

fn gpio_write(&mut self, _value: bool) -> Result<(), BackendError>

fn i2c_transfer( &mut self, _write_data: &[u8], _read_length: usize, ) -> Result<Vec<u8>, BackendError>

fn spi_transmit(&mut self, _tx_data: &[u8]) -> Result<Vec<u8>, BackendError>

fn clock_enable(&mut self) -> Result<(), BackendError>

fn clock_disable(&mut self) -> Result<(), BackendError>

fn clock_is_enabled(&mut self) -> Result<bool, BackendError>

fn clock_set_rate(&mut self, _hz: u64) -> Result<(), BackendError>

fn clock_query_rate(&mut self, _hz_in: u64) -> Result<u64, BackendError>

fn clock_get_rate(&mut self) -> Result<u64, BackendError>

fn reset_assert(&mut self) -> Result<(), BackendError>

fn reset_deassert(&mut self) -> Result<(), BackendError>

fn reset_toggle(&mut self) -> Result<(), BackendError>

fn reset_status(&mut self) -> Result<bool, BackendError>

fn serial_read(&mut self) -> Result<Vec<u8>, BackendError>

fn serial_write(&mut self, _data: &[u8]) -> Result<(), BackendError>