A MOS 6502 Emulator intended to be used from within other programs. All opcodes, included the undocumented illegal opcodes are implemented.
Example Usage::
from py65emu.cpu import CPU from py65emu.mmu import MMU f = open("program.rom", "rb") # Open your rom # define your blocks of memory. Each tuple is # (start_address, length, readOnly=True, value=None, valueOffset=0) m = MMU([ (0x00, 0x200), # Create RAM with 512 bytes (0x1000, 0x4000, True, f) # Create ROM starting at 0x1000 with your program. ]) # Create the CPU with the MMU and the starting program counter address # You can also optionally pass in a value for stack_page, which defaults # to 1, meaning the stack will be from 0x100-0x1ff. As far as I know this # is true for all 6502s, but for instance in the 6507 used by the Atari # 2600 it is in the zero page, stack_page=0. c = CPU(mmu, 0x1000) # Do this to execute one instruction c.step() # You can check the registers and memory values to determine what has changed print c.r.a # A register print c.r.x # X register print c.r.y # Y register print c.r.s # Stack Pointer print c.r.pc # Program Counter print c.r.getFlag('C') # Get the value of a flag from the flag register. print mmu.read(0xff) # Read a value from memory
The full set of parameters for CPU is:
mmu: An instance of MMU pc: The starting address of the pc (program counter) stack_page: The index of the page which contains the stack. The default for a 6502 is page 1 (the stack from 0x0100-0x1ff) but in some varients the stack page may be elsewhere. magic: A value needed for the illegal opcodes, XAA. This value differs between different versions, even of the same CPU. The default is 0xee.
And for MMU, the tuple values are:
start : int The starting address of the block of memory length : int The length of the block in bytes readOnly: bool Whether the block should be read only (such as ROM) (default False) value : file pointer, binary or lint of unsigned integers The intial value for the block of memory. Used for loading program data. (Default None) valueOffset : integer Used when copying the above `value` into the block to offset the location it is copied into. For example, to copy byte 0 in `value` into location 1000 in the block, set valueOffest=1000. (Default 0)