Struct lc3_ensemble::sim::io::BufferedIO

pub struct BufferedIO { /* private fields */ }

IO that reads from an input buffer and writes to an output buffer.

The input buffer is accessible in the simulator memory through the KBSR and KBDR. The output buffer is accessible in the simulator memory through the DSR and DDR.

The buffers can be accessed in code via BufferedIO::get_input and BufferedIO::get_output.

Note that if a input/output lock guard is acquired from one of the locks of this IO, the input/output becomes temporarily inaccessible to the simulator. Thus, a lock guard should never be leaked otherwise the simulator loses access to the input/output.

Implementations

impl BufferedIO

pub fn new() -> Self

Creates a new BufferedIO.

pub fn with_bufs( input: Arc<RwLock<VecDeque<u8>>>, output: Arc<RwLock<Vec<u8>>> ) -> Self

Creates a new BufferedIO from already defined buffers.

pub fn get_input(&self) -> &Arc<RwLock<VecDeque<u8>>>

Gets a reference to the input buffer.

pub fn get_output(&self) -> &Arc<RwLock<Vec<u8>>>

Gets a reference to the output buffer.

Trait Implementations

impl Clone for BufferedIO

fn clone(&self) -> BufferedIO

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for BufferedIO

fn default() -> Self

Returns the “default value” for a type.

impl From<BufferedIO> for SimIO

fn from(value: BufferedIO) -> Self

Converts to this type from the input type.

impl IODevice for BufferedIO

fn io_read(&mut self, addr: u16) -> Option<u16>

Reads the data at the given memory-mapped address.

fn io_write(&mut self, addr: u16, data: u16) -> bool

Writes the data to the given memory-mapped address.