Trait spectrusty_peripherals::ay::AyPortDecode

pub trait AyPortDecode: Debug {
    const PORT_MASK: u16;
    const PORT_SELECT: u16;
    const PORT_DATA_READ: u16;
    const PORT_DATA_WRITE: u16;

    fn is_select(port: u16) -> bool { ... }
    fn is_data_read(port: u16) -> bool { ... }
    fn is_data_write(port: u16) -> bool { ... }
    fn write_ay_io<T, R, A, B>(
        ay_io: &mut Ay3_891xIo<T, R, A, B>,
        port: u16,
        data: u8,
        timestamp: T
    ) -> bool
    where
        A: AyIoPort<Timestamp = T>,
        B: AyIoPort<Timestamp = T>,
        R: AyRegRecorder<Timestamp = T>,
    { ... }
}

A helper trait for matching I/O port addresses for AY-3-8910.

Required Associated Constants

const PORT_MASK: u16

A mask of significant address bus bits for port decoding.

const PORT_SELECT: u16

A mask of address bus bit values - for the register selection function.

const PORT_DATA_READ: u16

A mask of address bus bit values - for the reading from the selected register function.

const PORT_DATA_WRITE: u16

A mask of address bus bit values - for the writing to the selected register function.

Provided Methods

fn is_select(port: u16) -> bool

Return true if the port matches the register selection function.

fn is_data_read(port: u16) -> bool

Return true if the port matches the register reading function.

Examples found in repository

src/bus/ay.rs (line 273)

    fn read_io(&mut self, port: u16, timestamp: Self::Timestamp) -> Option<(u8, Option<NonZeroU16>)> {
        if P::is_data_read(port) {
            return Some((self.ay_io.data_port_read(port, timestamp), None))
        }
        self.bus.read_io(port, timestamp)
    }

fn is_data_write(port: u16) -> bool

Return true if the port matches the register writing function.

fn write_ay_io<T, R, A, B>(
    ay_io: &mut Ay3_891xIo<T, R, A, B>,
    port: u16,
    data: u8,
    timestamp: T
) -> boolwhere
    A: AyIoPort<Timestamp = T>,
    B: AyIoPort<Timestamp = T>,
    R: AyRegRecorder<Timestamp = T>,

A helper for writing data to one of the functions decoded from port address.

Examples found in repository

src/bus/ay.rs (line 281)

    fn write_io(&mut self, port: u16, data: u8, timestamp: Self::Timestamp) -> Option<u16> {
        if P::write_ay_io(&mut self.ay_io, port, data, timestamp) {
            return Some(0)
        }
        self.bus.write_io(port, data, timestamp)
    }

Implementors

impl AyPortDecode for Ay128kPortDecode

const PORT_MASK: u16 = 49_154u16

const PORT_SELECT: u16 = 49_152u16

const PORT_DATA_READ: u16 = 49_152u16

const PORT_DATA_WRITE: u16 = 32_768u16

impl AyPortDecode for AyFullerBoxPortDecode

const PORT_MASK: u16 = 255u16

const PORT_SELECT: u16 = 63u16

const PORT_DATA_READ: u16 = 63u16

const PORT_DATA_WRITE: u16 = 95u16

impl AyPortDecode for AyTC2068PortDecode

const PORT_MASK: u16 = 255u16

const PORT_SELECT: u16 = 245u16

const PORT_DATA_READ: u16 = 246u16

const PORT_DATA_WRITE: u16 = 246u16