Struct Core 

pub struct Core<R: Register> {
    pub pc: R,
    /* private fields */
}

A single RISCV core. Includes a single program counter and 32 registers. Const generics will allow support of the E extensions for 16 registers.

Fields

pc: R

The program counter

Implementations

impl<R: Register + Default + Copy + Clone> Core<R>

pub fn new(address: R::Unsigned, hart: R::Unsigned) -> Self

Creates a new core starting execution at the given address with the given hart ID. Hart ID’s must be unique to ensure correct program behaviour. There must be a hart with ID 0 on a given system. address must be aligned to 4 bytes else a panic will occur during execution.

pub fn step(&mut self)

Increments the program counter by the instruction size of 4 bytes

pub fn get(&self, index: usize) -> R

Get the register x{index}

Safety

A panic will occur if index is larger than 31

pub fn set(&mut self, index: usize, register: R)

Set register x{index} to be equal to register

Safety

A panic will occur if index is larger than 31

pub fn get_csr(&self, index: usize) -> Result<R, Exception>

Get a value from a CSR. May have side-effects

pub fn set_csr(&mut self, index: usize, value: R)

Set a CSR to the specified value with program-defined access. May have side-effects

pub fn execute(&mut self, mmu: &mut dyn Mmu<R>) -> Result<(), Exception>

Decode and execute an instruction