Struct rsim::processor::isa_mods::csrs::ZicsrConn

pub struct ZicsrConn<'a, T> where
    T: From<u8>,  {
    pub sreg: &'a mut dyn RegisterFile<T>,
    pub csr_providers: Vec<&'a mut dyn CSRProvider<T>>,
}

References to all CSR providers

Fields

sreg: &'a mut dyn RegisterFile<T>

csr_providers: Vec<&'a mut dyn CSRProvider<T>>

Implementations

impl<'a, T> ZicsrConn<'a, T> where
    T: From<u8>, 

fn provider_of_csr(
    &mut self,
    csr: u32
) -> Option<&mut &'a mut dyn CSRProvider<T>>

Explanation of return type: OK, so this is really annoying. We want to return a reference to one of the mutrefs inside csr_providers. However, we can’t just copy the mutref out, because that would mean two copies exist - one in csr_providers, and one in our return value. => we have to return a reference to the mutref - &(&'a mut dyn CSRProvider). Because we want to modify the thing at the end of the mutref, Rust complains and wants the outer reference to be mutable as well. => & mut (&'a mut dyn CSRProvider) And, because we may not find anything, wrap the whole thing in an Option => Option<& mut &'a mut dyn CSRProvider>

Trait Implementations

impl<T> IsaMod<ZicsrConn<'_, T>> for Zicsr<T> where
    T: From<u8>, 

type Pc = T

fn will_handle(&self, opcode: Opcode, _inst: InstructionBits) -> bool

Return true if this ISA module should handle the given instruction

fn execute(
    &mut self,
    opcode: Opcode,
    inst: InstructionBits,
    _inst_bits: u32,
    conn: ZicsrConn<'_, T>
) -> ProcessorResult<Option<Self::Pc>>

Execute the given instruction, returning the new PC (or None if continuing as normal)