Struct faucon_emu::memory::Memory

pub struct Memory {
    pub data: Vec<u8>,
    pub code: Vec<u8>,
    pub tlb: Tlb,
}

Representation of the Falcon memory space.

It consists of separate memory spaces for data and code, where data is stored in a flat piece of memory and code in virtual memory pages, translated by a hidden TLB.

Fields

data: Vec<u8>

Representation of the Falcon data space.

This is a linear piece of memory with byte-oriented addressing, used for variables and stack memory. It can be addressed in 8-bit, 16-bit and 32-bit quantities where unaligned memory access leads to data corruption.

code: Vec<u8>

Representation of the Falcon code space.

Code segment uses primitive paging in 0x100 byte pages. Address translation is done in hidden TLB memory, with one entry for each physical page.

tlb: Tlb

Representation of the hidden Falcon TLB.

The TLB is used for address translation via an array of entries, each representing a physical page index.

Implementations

impl Memory

pub fn new() -> Self

Creates a new instance of the memory, initialized to all zeroes by default.

pub fn read_data_byte(&self, address: u32) -> u8

Reads a byte from a given address in Falcon data space.

pub fn read_data_halfword(&self, address: u32) -> u16

Reads a halfword from a given address in Falcon data space.

pub fn read_data_word(&self, address: u32) -> u32

Reads a word from a given address in Falcon data space.

pub fn read_code_addr(&self, address: u16) -> u32

Reads a word from a given physical address in code space.

pub fn write_data_byte(&mut self, address: u32, value: u8)

Writes a byte to a given address in Falcon data space.

pub fn write_data_halfword(&mut self, address: u32, value: u16)

Writes a halfword to a given address in Falcon data space.

pub fn write_data_word(&mut self, address: u32, value: u32)

Writes a word to a given address in Falcon data space.

pub fn write_code_addr(&mut self, address: u16, value: u32)

Writes a word to a given physical address in code space.