Struct MemorySpace

pub struct MemorySpace { /* private fields */ }

A Memory that represents an address space forwarding reads and writes to other inner memories.

When reads and writes are forwarded to an inner memory the base address is adjusted appropriate (e.g. a Memory added with MemorySpace::add_memory at address 0x100000 will get a read at address 0x0 if the MemorySpace gets a read at 0x100000

The inner memory regions cannot overlap and base addresses must be 32-bit aligned.

Implementations

impl MemorySpace

pub fn new() -> Self

pub fn add_memory( &mut self, base: u32, size: u32, memory: Box<dyn Memory>, ) -> Result<usize, MemorySpaceError>

Add an inner memory.

When Ok is returned a memory index is provided which can be used with MemorySpace::get_memory_ref and MemorySpace::get_memory_mut to get a reference to that memory.

pub fn get_memory_ref<T: Memory>(&self, index: usize) -> Option<&T>

Get a reference to an inner memory

This performs downcasting to the provided T. None is returned where the downcast fails.

pub fn get_memory_mut<T: Memory>(&mut self, index: usize) -> Option<&mut T>

Get a mutable reference to an inner memory

This performs downcasting to the provided T. None is returned where the downcast fails.

Trait Implementations

impl Default for MemorySpace

fn default() -> Self

Returns the “default value” for a type.

impl Memory for MemorySpace

fn read_mem(&mut self, addr: u32, size: MemAccessSize) -> Option<u32>

Read size bytes from addr.

fn write_mem(&mut self, addr: u32, size: MemAccessSize, store_data: u32) -> bool

Write size bytes of store_data to addr