Struct System 

pub struct System {
    pub cpu: Cpu,
    pub bus: Bus,
    /* private fields */
}

Owns the run loop and the lockstep timebase.

Fields

cpu: Cpu

The 6507 CPU.

bus: Bus

The Bus — owns the TIA, RIOT, cart-via-board, controllers, open bus.

Implementations

impl System

pub fn new(seed: u64) -> Self

Power on with a determinism seed (drives the phase alignment AND the power-on RAM/register randomization, ADR 0006 — real hardware powers up with indeterminate RAM/register contents, but “indeterminate” must still be a deterministic function of the seed, never the OS RNG, per ADR 0004).

pub fn reset(&mut self)

Resets the CPU using the currently installed cartridge/bus, applying the seeded power-on phase offset first.

pub fn step_instruction(&mut self) -> u8

Run exactly one 6507 instruction to completion and return its cycle count. This is the scheduler’s sole driving primitive: every cycle the instruction consumes advances the TIA/RIOT/cart in lockstep via [CpuView::tick_cycle] as it goes (see the module doc comment) — by the time this returns, the whole system (not just the CPU) has caught up to the instruction’s true elapsed time.

pub fn tick_one_color_clock(&mut self)

Advance the TIA alone by exactly one color clock, with no CPU involvement. Useful for tests / tooling that want to observe raw TIA timing without running a program. Does NOT drive the CPU — pair with Self::step_instruction for that.

pub const fn color_clocks(&self) -> u64

Total color clocks since power-on (for tracing / the golden-log differ).

Trait Implementations

impl Clone for System

fn clone(&self) -> System

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for System

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for System

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for System

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

where __S: Serializer,

Serialize this value into the given Serde serializer.