Struct emulator_6502::MOS6502

pub struct MOS6502 { /* fields omitted */ }

Struct representation of the MOS 6502 processor

Usage Example

fn main() -> Result<()>{
 let mut ram = BasicRam{ ram: Box::new([0; u16::max_value() as usize + 1]) };

 //Load a program into memory...
 let mut file = File::open("C:/some_6502_program.bin")?;
 let mut buffer = Vec::new();
 file.read_to_end(&mut buffer)?;

 //Copy it into the BasicRam
 ram.load_program(0x0400, &mut buffer);

 let mut cpu = MOS6502::new(); //Create a new emulator instance
 cpu.set_program_counter(0x0400); //Set the program counter to the first byte of the program in memory
 cpu.cycle(&mut ram); // The emulator can execute cycles individually, for systems that require precise timing...
 cpu.execute_instruction(&mut ram); // or instruction by instruction for a coarser approach

 Ok(())
}

Methods

impl MOS6502

pub fn new() -> Self

Creates a new MOS6502 emulation with the program counter at 0x0400

pub fn new_start(start: u16) -> Self

Creates a new MOS6502 emulation with the program counter at the provided start address

pub fn new_reset_position(interface: &mut dyn Interface6502) -> Self

Creates a new MOS6502 emulation with the program counter at the address read from the reset vector (0xfffa-0xfffb).

This is the standard method used for determining where the program starts on most systems

pub fn set_program_counter(&mut self, program_counter: u16)

Force the program counter to a specific address

pub fn cycle(&mut self, interface: &mut dyn Interface6502)

Runs a processor cycle, mutably borrows the reading and writing interface for the duration

pub fn execute_instruction(&mut self, interface: &mut dyn Interface6502)

Runs as many processor cycles as it takes to complete the instruction at the program counter

pub fn interrupt_request(&mut self)

Request that an interrupt occurs after the current instruction completes

pub fn non_maskable_interrupt_request(&mut self)

Request that an interrupt occurs after the current instruction completes, even if the interrupt disabled flag is set

pub fn reset(&mut self, interface: &mut dyn Interface6502)

Resets the 6502 to a known state

Trait Implementations

impl Clone for MOS6502

fn clone(&self) -> MOS6502

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for MOS6502

fn default() -> Self

Returns the "default value" for a type.

impl PartialEq<MOS6502> for MOS6502

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

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

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

This method tests for !=.

impl Debug for MOS6502

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

Formats the value using the given formatter.