Struct DeviceHandler

pub struct DeviceHandler { /* private fields */ }

The central hub for all external devices for the Simulator.

Implementations

impl DeviceHandler

pub fn new() -> Self

Creates a new device handler.

pub fn set_keyboard(&mut self, kb: impl ExternalDevice)

Set the keyboard device.

pub fn set_display(&mut self, ds: impl ExternalDevice)

Set the display device.

pub fn add_device<D: ExternalDevice>( &mut self, dev: D, addrs: &[u16], ) -> Result<u16, D>

Add a new device (which is not a keyboard or a display).

This accepts an external device and the addresses which the device should act on. If successful, the ID of the device is returned.

Errors

If the device cannot be added, it will be returned back to the user.

The cases where the device cannot be added include:

• The number of devices ever added exceeds u16::MAX.
• At least one of the addresses provided are already occupied by another device or not an IO port.

pub fn remove_device(&mut self, dev_id: u16)

Removes the device at the given device ID.

Trait Implementations

impl Debug for DeviceHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DeviceHandler

fn default() -> Self

Returns the “default value” for a type.

impl ExternalDevice for DeviceHandler

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

Accesses the IO device mapped to the given address and tries ExternalDevice::io_read on it.

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

Accesses the IO device mapped to the given address and tries ExternalDevice::io_write on it.

fn io_reset(&mut self)

Resets all the devices connected to this handler.

fn poll_interrupt(&mut self) -> Option<Interrupt>

Checks for interrupts on all devices.