Struct KonamiHyperShotState 

pub struct KonamiHyperShotState { /* private fields */ }

The Konami Hyper Shot overlay state (v1.3.0 Workstream F1).

A simple 4-button expansion controller (two players, each with a Run and a Jump button) used by Hyper Olympic / Hyper Sports. Per the NESdev “Konami Hyper Shot” page it is read in parallel on $4017 (no shift register), with $4016 writes selecting which player’s buttons are enabled:

$4016 write:               $4017 read:
7  bit  0                  7  bit  0
---- ----                  ---- ----
xxxx xEFx                  xxxD CBAx
      ||                      | |||
      |+- 0 = enable P1          | ||+-- P1 Run
      +-- 0 = enable P2          | |+--- P1 Jump
                                 | +---- P2 Run
                                 +------ P2 Jump

The Jump/Run bits for a player read 0 while that player’s enable bit ($4016 bit 1 for P1, bit 2 for P2) is set (i.e. disabled). Determinism holds: the read is a pure function of the live button mask + the last write.

Implementations

impl KonamiHyperShotState

pub const fn new() -> Self

New controller with no buttons held and both players enabled (the power-on $4016 write has not happened yet; enable is active-low, so the quiescent state matches a write of 0).

pub const fn set(&mut self, buttons: u8)

Set the live 4-button mask (bit 0 = P1 Run, 1 = P1 Jump, 2 = P2 Run, 3 = P2 Jump). Bits above 3 are ignored.

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

Handle a $4016 write: bit 1 = 0 enables P1, bit 2 = 0 enables P2 (active-low).

pub const fn read(&self) -> u8

Read the device byte for a $4017 access. Bit 1 = P1 Run, bit 2 = P1 Jump, bit 3 = P2 Run, bit 4 = P2 Jump; a player’s bits read 0 while disabled. The caller ORs in the open-bus upper bits.

pub const fn peek(&self) -> u8

Side-effect-free sample (debugger peek) — identical to Self::read.

pub const fn from_parts(buttons: u8, p1_enabled: bool, p2_enabled: bool) -> Self

Reconstruct from save-state parts.

pub const fn buttons_raw(&self) -> u8

Raw button mask (save-state).

pub const fn p1_enabled_raw(&self) -> bool

Raw P1-enable (save-state).

pub const fn p2_enabled_raw(&self) -> bool

Raw P2-enable (save-state).

Trait Implementations

impl Clone for KonamiHyperShotState

fn clone(&self) -> KonamiHyperShotState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KonamiHyperShotState

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

Formats the value using the given formatter.

impl Default for KonamiHyperShotState

fn default() -> KonamiHyperShotState

Returns the “default value” for a type.

impl Copy for KonamiHyperShotState