Struct w65c02s::W65C02S

pub struct W65C02S { /* fields omitted */ }

An instance of a W65C02S, encapsulating the entire runtime state of the processor itself. Not very useful without a System to go with it.

Implementations

impl W65C02S

pub fn new() -> W65C02S

Creates a new W65C02S instance, initialized in a newly-reset state. (Unlike a real W65C02S, most registers will be in the all-ones state at this point.)

pub fn reset(&mut self)

Resets the CPU. Execution will flounder for a few cycles, then fetch the reset vector and "start over".

pub fn get_pc(&self) -> u16

Get the current value of the Program Counter, i.e. the next instruction that will (probably) be executed.

pub fn set_pc(&mut self, pc: u16)

Overwrite the current value of the Program Counter.

pub fn get_a(&self) -> u8

Get the current value of the Accumulator.

pub fn set_a(&mut self, a: u8)

Overwrite the current value of the Accumulator.

pub fn get_x(&self) -> u8

Get the current value of index register X.

pub fn set_x(&mut self, x: u8)

Overwrite the current value of index register X.

pub fn get_y(&self) -> u8

Get the current value of index register Y.

pub fn set_y(&mut self, y: u8)

Overwrite the current value of index register Y.

pub fn get_s(&self) -> u8

Get the current value of the Stack pointer. The next byte pushed onto the stack will go into address $01xx where xx is this value.

pub fn set_s(&mut self, s: u8)

Overwrite the current value of the Stack pointer.

pub fn get_p(&self) -> u8

Get the current value of the Processor status register. Use the P_* constants to interpret the value.

pub fn set_p(&mut self, p: u8)

Overwrite the current value of the Processor status register. Can't be used to change the hardwired 1 bit. You can use this to implement SOB logic; when the SOB pin should transition to active, do something like:

cpu.set_p(cpu.get_p() | P_V);

pub fn get_state(&self) -> State

Get the current operating state of the CPU. May return a stale value if called during a step.

pub fn push<S: System>(&mut self, system: &mut S, value: u8)

Push a value onto the stack using the given System.

pub fn spurious_push<S: System>(&mut self, system: &mut S)

Spurious push during reset.

pub fn pop<S: System>(&mut self, system: &mut S) -> u8

Pop a value from the stack using the given System.

pub fn spurious_stack_read<S: System>(&mut self, system: &mut S)

Spuriously read a value from the next stack slot, like happens during a JSR or RTS or most pulls.

pub fn set_irq(&mut self, irq: bool)

Change the input on the IRQB pin. false means no interrupt pending. true means some interrupt is pending. Note that IRQB is an active- low pin and that the value you pass to this function is the logical value and not the electrical one.

pub fn set_nmi(&mut self, nmi: bool)

Change the input on the NMIB pin. false means no NMI pending. A transition from false to true triggers an NMI at the next step. Note that NMIB is an active-low pin and that the value you pass to this function is the logical value and not the electrical one.

This crate does not accurately simulate extremely short NMI pulses, or extremely rapid ones. If these conditions arise on real hardware, chaos will ensue anyway.

pub fn step<S: System>(&mut self, system: &mut S) -> State

Step the processor once. This means executing an interrupt sequence, fetching an instruction, or doing a spurious read, depending on the current state of the processor. Returns the new state.

Always executes at least one bus cycle. May execute more.

Trait Implementations

impl Clone for W65C02S

fn clone(&self) -> W65C02S

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for W65C02S

impl Debug for W65C02S

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

Formats the value using the given formatter.

impl Eq for W65C02S

impl PartialEq<W65C02S> for W65C02S

fn eq(&self, other: &W65C02S) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &W65C02S) -> bool

This method tests for !=.

impl StructuralEq for W65C02S

impl StructuralPartialEq for W65C02S