Struct rvsim::Interp

pub struct Interp<'s, 'm, 'c, M: 'm + Memory, C: 'c + Clock> {
    pub state: &'s mut CpuState,
    pub mem: &'m mut M,
    pub clock: &'c mut C,
    // some fields omitted
}

The interpeter.

This struct simply combines a CpuState, Memory and Clock. An Interp instance can be fleeting, and doesn’t need to be kept around if the virtual CPU is paused, for example.

Fields

state: &'s mut CpuState

The CPU state.

mem: &'m mut M

The memory implementation.

clock: &'c mut C

The clock implementation.

Implementations

impl<'s, 'm, 'c, M: 'm + Memory, C: 'c + Clock> Interp<'s, 'm, 'c, M, C>

pub fn new(state: &'s mut CpuState, mem: &'m mut M, clock: &'c mut C) -> Self

Create a new interpreter.

pub fn run(&mut self) -> (CpuError, Option<Op>)

Run continuously until execution stops, starting at the current PC address.

Returns the stop reason and the instruction that caused the virtual CPU to stop. The instruction may be None if it failed to load or parse.

pub fn step(&mut self) -> Result<Op, (CpuError, Option<Op>)>

Step a single instruction, fetching it from the current PC address.

Returns the parsed instruction that was executed. When the instruction stops the virtual CPU, additionally returns the stop reason. In the latter case, the instruction may be None if it failed to load or parse.