Struct Controller 

pub struct Controller { /* private fields */ }

One standard NES controller plugged into $4016 (player 1) or $4017 (player 2).

Implementations

impl Controller

pub const fn new() -> Self

New controller with no buttons pressed.

pub const fn set_buttons(&mut self, buttons: Buttons)

Set the current button state. Takes effect on the next strobe edge (or immediately, while strobe is held high).

pub const fn buttons(&self) -> Buttons

Get the current button state.

pub const fn write_strobe(&mut self, value: u8)

Handle a write to $4016. Only bit 0 matters for the standard controller. While strobe is held high the shift register continuously reloads from the live button state.

pub const fn read(&mut self, continues_run: bool) -> u8

Handle a read of $4016 / $4017. Returns the LSB of the shift register and shifts. While strobe is held high, the LSB is always the A button (bit 0 of buttons).

Per the wiki, when the shift register has been emptied subsequent reads return 1. continues_run is true when the immediately preceding CPU cycle was also a read of this same port — the case an absolute-indexed read-modify-write (SLO $4016,X) and a DMC-DMA-interrupted read both produce. CLK stays low across such a run, so the register does not advance between the reads and both see the same bit.

pub const fn peek(&self) -> u8

Side-effect-free sample of the next bit (debugger).

Trait Implementations

impl Clone for Controller

fn clone(&self) -> Controller

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Controller

impl Debug for Controller

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

Formats the value using the given formatter.

impl Default for Controller

fn default() -> Controller

Returns the “default value” for a type.