Trait MemDevice 

pub trait MemDevice {
    const LEN: usize;

    // Required methods
    fn read_bytes_relative(&self, addr: RelativeAddr, data: &mut [u8]);
    fn write_bytes_relative(&mut self, addr: RelativeAddr, data: &[u8]);

    // Provided methods
    fn read_relative_into<V>(&self, addr: RelativeAddr, dest: &mut V)
       where V: MemValue { ... }
    fn read_relative<V>(&self, addr: RelativeAddr) -> V
       where V: MemValue + Default { ... }
    fn write_relative_from<V>(&mut self, addr: RelativeAddr, source: &V)
       where V: MemValue { ... }
    fn write_relative<V>(&mut self, addr: RelativeAddr, val: V)
       where V: MemValue { ... }
    fn read_byte_relative(&self, addr: RelativeAddr) -> u8 { ... }
    fn write_byte_relative(&mut self, addr: RelativeAddr, data: u8) { ... }
}

Provides access to system memory.

Required Associated Constants

const LEN: usize

Length of this MemDevice in bytes. Reads and writes must always be within the device.

Required Methods

fn read_bytes_relative(&self, addr: RelativeAddr, data: &mut [u8])

Read a range of bytes into a slice. The read bytes must not wrap past the end of the device.

fn write_bytes_relative(&mut self, addr: RelativeAddr, data: &[u8])

Write a range of bytes into memory from a slice. The slice must not exceed the length of the MemDevice.

Provided Methods

fn read_relative_into<V>(&self, addr: RelativeAddr, dest: &mut V)

where V: MemValue,

Read a typed value from this MemDevice. The value must be fully contained within this device.

fn read_relative<V>(&self, addr: RelativeAddr) -> V

where V: MemValue + Default,

Read a typed value from this MemDevice. The value must be fully contained within this device.

fn write_relative_from<V>(&mut self, addr: RelativeAddr, source: &V)

where V: MemValue,

Write a typed value into this MemDevice. The value must fit fully within the device.

fn write_relative<V>(&mut self, addr: RelativeAddr, val: V)

where V: MemValue,

Write a typed value into this MemDevice. The value must fit fully within the device.

fn read_byte_relative(&self, addr: RelativeAddr) -> u8

Read the byte at the specified address.

The default implementation just calls read_range_relative with a single-byte slice. A mem device may override this method if it can provide a more efficient single-byte read.

fn write_byte_relative(&mut self, addr: RelativeAddr, data: u8)

Write the byte at the sepcified address.

The default implementation just calls write_range_relative with a single-byte slice. A mem device may override this method if it can provide a more efficient single-byte write.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl MemDevice for u8

A u8 acts as a single-byte memory device.

const LEN: usize = 1usize

fn read_byte_relative(&self, addr: RelativeAddr) -> u8

fn write_byte_relative(&mut self, addr: RelativeAddr, val: u8)

fn read_bytes_relative(&self, addr: RelativeAddr, data: &mut [u8])

fn write_bytes_relative(&mut self, addr: RelativeAddr, data: &[u8])

impl<D: MemDevice> MemDevice for Box<D>

const LEN: usize = D::LEN

fn read_byte_relative(&self, addr: RelativeAddr) -> u8

fn write_byte_relative(&mut self, addr: RelativeAddr, value: u8)

fn read_bytes_relative(&self, addr: RelativeAddr, data: &mut [u8])

fn write_bytes_relative(&mut self, addr: RelativeAddr, data: &[u8])

impl<const N: usize> MemDevice for [u8; N]

const LEN: usize = N

fn read_byte_relative(&self, addr: RelativeAddr) -> u8

fn write_byte_relative(&mut self, addr: RelativeAddr, value: u8)

fn read_bytes_relative(&self, addr: RelativeAddr, data: &mut [u8])

fn write_bytes_relative(&mut self, addr: RelativeAddr, data: &[u8])

Implementors

impl MemDevice for Cartridge

const LEN: usize = 40_960usize

impl MemDevice for ApuRegs

const LEN: usize = 48usize

impl MemDevice for ChannelControl

const LEN: usize = 1usize

impl MemDevice for EnvelopeControl

const LEN: usize = 1usize

impl MemDevice for NoiseChannel

const LEN: usize = 4usize

impl MemDevice for NoiseControl

const LEN: usize = 1usize

impl MemDevice for PulseChannel

const LEN: usize = 5usize

impl MemDevice for PulseTimer

const LEN: usize = 1usize

impl MemDevice for SoundEnable

const LEN: usize = 1usize

impl MemDevice for SoundPan

const LEN: usize = 1usize

impl MemDevice for SoundVolume

const LEN: usize = 1usize

impl MemDevice for SweepControl

const LEN: usize = 1usize

impl MemDevice for WavetableChannel

const LEN: usize = 21usize

impl MemDevice for WavetableLevel

const LEN: usize = 1usize

impl MemDevice for ButtonRegister

const LEN: usize = 1usize

impl MemDevice for InterruptEnable

const LEN: usize = 1usize

impl MemDevice for InterruptFlags

const LEN: usize = 1usize

impl MemDevice for DmaState

const LEN: usize = 1usize

impl MemDevice for LcdFlags

const LEN: usize = 1usize

impl MemDevice for LcdStat

const LEN: usize = 1usize

impl MemDevice for ObjAttrs

const LEN: usize = 1usize

impl MemDevice for PpuRegs

const LEN: usize = 12usize

impl MemDevice for SerialRegs

const LEN: usize = 2usize

impl MemDevice for TimerControl

const LEN: usize = 1usize

impl MemDevice for TimerRegs

const LEN: usize = 4usize

impl MemDevice for AllRam

const LEN: usize = 65_536usize

impl MemDevice for BiosEnable

const LEN: usize = 1usize

impl MemDevice for BiosRom

const LEN: usize = 256usize

impl MemDevice for GbMmu

const LEN: usize = 65_536usize

impl MemDevice for Mbc1Rom

const LEN: usize = 40_960usize

impl MemDevice for Mbc3Rom

const LEN: usize = 40_960usize

impl MemDevice for MemMappedIo

const LEN: usize = 128usize

impl MemDevice for RomOnly

const LEN: usize = 40_960usize

impl<M: MemDevice> MemDevice for MaskableMem<M>

const LEN: usize = M::LEN

impl<M: MemDevice> MemDevice for ReadOnly<M>

const LEN: usize = M::LEN

impl<M: MemDevice> MemDevice for RootExtend<M>

const LEN: usize = 65_536usize

impl<const N: usize> MemDevice for NullRom<N>

const LEN: usize = N