Struct HardwareCard 

pub struct HardwareCard<P = ControllerPort> { /* private fields */ }

A physical memory card reached over SIO0.

P is how the card holds the port: the ControllerPort token (the default) or a &mut ControllerPort borrowed from the program for the length of the card’s use. While a card holds the port, a pad poll cannot borrow it:

use psx_mc::{HardwareCard, Slot};
use psx_io::periph::ControllerPort;

// SAFETY: the doctest never touches the port; it only has to compile.
let mut port = unsafe { ControllerPort::steal() };
let mut card = HardwareCard::on_port(&mut port, Slot::One);
let other_driver = &mut port; // the card still holds the borrow
let _ = card.last_trace();
let _ = other_driver;

Implementations

impl HardwareCard<ControllerPort>

pub fn new(slot: Slot) -> Self

👎Deprecated:

use HardwareCard::on_port with the ControllerPort token

A card on the given slot with default timing.

impl<P: BorrowMut<ControllerPort>> HardwareCard<P>

pub fn on_port(port: P, slot: Slot) -> Self

A card on slot, reached through port (the token, or a borrow of it), with the memory card’s default Timing.

pub fn on_port_with_timing(port: P, slot: Slot, timing: Timing) -> Self

on_port with custom Timing, for tuning against real silicon.

pub fn release(self) -> P

Give the port back: the token when the card owned it, the borrow otherwise.

pub fn last_trace(&self) -> TransportTrace

Diagnostic evidence from the most recent frame read or write.

pub fn controller_port(&mut self) -> &mut ControllerPort

The port, between transactions, for another driver that shares it (a pad poll). Every frame read or write finishes inside its own call, so the card is never mid-transaction when this is reachable.

Trait Implementations

impl<P: BorrowMut<ControllerPort>> Block for HardwareCard<P>

fn read_frame(&mut self, frame: u16, out: &mut [u8; 128]) -> Result<()>

Read frame frame (0..FRAME_COUNT) into out.

fn write_frame(&mut self, frame: u16, data: &[u8; 128]) -> Result<()>

Write data to frame frame (0..FRAME_COUNT).