Struct ControllerPort 

pub struct ControllerPort { /* private fields */ }

The token a HardwareCard drives the port through. The controller and memory-card port.

Implementations

impl ControllerPort

pub const unsafe fn steal() -> ControllerPort

Make a token without going through psx_rt::Peripherals::take().

Safety

The caller must not use this token while another one of the same type is in use: two owners of one device each assume they are the only driver programming it.

Trait Implementations

impl Debug for ControllerPort

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

Formats the value using the given formatter.

impl Transport for ControllerPort

fn status(&mut self) -> u32

Read the status register.

fn receive(&mut self) -> u8

Pop one received byte.

fn transmit(&mut self, byte: u8)

Start shifting one byte out.

fn set_mode(&mut self, value: u16)

Write the mode register.

fn set_baud(&mut self, value: u16)

Write the baud-rate reload.

fn set_control(&mut self, value: u16)

Write the control register.

fn select(&mut self, port: Port)

Configure the port for 250 kHz, 8N1 and assert /CS on port.

fn select_with(&mut self, port: Port, arm_ack_irq: bool)

select with the /ACK interrupt armed when arm_ack_irq is set, so STAT latches each pulse. Only a diagnostic pacing wants that.

fn deselect(&mut self)

Release /CS, which resets the attached device’s state machine.

fn reset(&mut self)

Reset the port’s UART. A deselect alone need not cancel a late reply still in the shifter, so a failed transaction ends with this.

fn drain_receive(&mut self)

Pop up to a few stale bytes so the next reply lines up with the first byte of the transaction. Bounded, so a stuck “RX not empty” flag cannot spin forever.

fn delay(&mut self, spins: u32)

Burn time with spins status reads, which the compiler cannot remove.

fn wait_status_set(&mut self, mask: u32, spins: u32) -> bool

Spin until any bit of mask is set in the status register, at most spins reads after the first. false on timeout.

fn wait_status_clear(&mut self, mask: u32, spins: u32) -> bool

Spin until every bit of mask is clear in the status register, at most spins reads after the first. false on timeout.

fn begin(&mut self, port: Port, timing: Timing) -> bool

Start a transaction: select port, wait out the setup time, drop stale bytes, and wait for an /ACK left asserted by an aborted transaction to release, so it is not counted as the first byte’s.

fn finish(&mut self, succeeded: bool)

End a transaction: release /CS, and after a failed one reset the UART as well. The next select restores mode and baud.

fn exchange( &mut self, byte: u8, is_last: bool, timing: Timing, ) -> Result<u8, ExchangeError>

Clock one byte and wait for the device’s /ACK.