Struct spectrusty::peripherals::bus::ay::serial128::SerialPorts128

pub struct SerialPorts128<S1, S2> {
    pub serial1: S1,
    pub serial2: S2,
    /* private fields */
}

The bridge between ZX Spectrum 128 AY-3-8912 I/O ports and emulators of serial port devices.

The RS232C/MIDI interface is implemented using the Port A Data Store in the sound generator chip IC32. The data store is a special register that accesses an 8-bit bi-directional port A7-AO. The port occupies the same I/O space as the sound generator registers and is accessed in much the same way.

Bits of an I/O port A register have the following meaning:

• A0: KEYPAD CTS (OUT) = 0: active - Spectrum ready to receive, 1: inactive - busy.
• A1: KEYPAD RXD (OUT) = 0: transmit bit (high voltage), 1: transmit bit (low voltage).
• A2: RS232 CTS (OUT) = 0: active - Spectrum ready to receive, 1: inactive - busy.
• A3: RS232 RXD (OUT) = 0: transmit (high voltage), 1: transmit bit (low voltage).
• A4: KEYPAD DTR (IN) = 0: active - a device ready for data, 1: inactive - busy.
• A5: KEYPAD TXD (IN) = 0: receive bit (high voltage), 1: Receive bit (low voltage).
• A6: RS232 DTR (IN) = 0: active - a device ready for data, 1: inactive - busy.
• A7: RS232 TXD (IN) = 0: receive bit (high voltage), 1: Receive bit (low voltage).

This type implements a single AyIoPort as two serial ports of ZX Spectrum 128.

One of these ports is primarily being used for the extension keypad and the other for communicating with a serial printer or another RS-232 device in either direction.

To “connect” something to these ports, provide some types that implement SerialPortDevice as S1 and S2.

Fields

serial1: S1

A SerialPortDevice connected to a KEYPAD port.

serial2: S2

A SerialPortDevice connected to a RS232 port.

Trait Implementations

impl<S1, S2> AyIoPort for SerialPorts128<S1, S2>where
    S1: SerialPortDevice,
    S2: SerialPortDevice<Timestamp = <S1 as SerialPortDevice>::Timestamp>,
    <S1 as SerialPortDevice>::Timestamp: Copy,

type Timestamp = <S1 as SerialPortDevice>::Timestamp

fn ay_io_reset(
    &mut self,
    _timestamp: <SerialPorts128<S1, S2> as AyIoPort>::Timestamp
)

Resets the device at the given timestamp.

fn ay_io_write(
    &mut self,
    _addr: u16,
    data: u8,
    timestamp: <SerialPorts128<S1, S2> as AyIoPort>::Timestamp
)

Writes data to the device at the given timestamp.

fn ay_io_read(
    &mut self,
    _addr: u16,
    timestamp: <SerialPorts128<S1, S2> as AyIoPort>::Timestamp
) -> u8

Reads data from the device at the given timestamp.

fn end_frame(
    &mut self,
    timestamp: <SerialPorts128<S1, S2> as AyIoPort>::Timestamp
)

Signals the device when the current frame ends, providing the value of the cycle clock after the frame execution stopped.

impl<S1, S2> Clone for SerialPorts128<S1, S2>where
    S1: Clone,
    S2: Clone,

fn clone(&self) -> SerialPorts128<S1, S2>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S1, S2> Debug for SerialPorts128<S1, S2>where
    S1: Debug,
    S2: Debug,

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

Formats the value using the given formatter.

impl<S1, S2> Default for SerialPorts128<S1, S2>where
    S1: Default,
    S2: Default,

fn default() -> SerialPorts128<S1, S2>

Returns the “default value” for a type.

impl<'de, S1, S2> Deserialize<'de> for SerialPorts128<S1, S2>where
    S1: Deserialize<'de> + Default,
    S2: Deserialize<'de> + Default,

fn deserialize<__D>(
    __deserializer: __D
) -> Result<SerialPorts128<S1, S2>, <__D as Deserializer<'de>>::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S1, S2> Serialize for SerialPorts128<S1, S2>where
    S1: Serialize,
    S2: Serialize,

fn serialize<__S>(
    &self,
    __serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.