def test_execute():
memory.write32(0, 0x00001234) # stack pointer
memory.write32(4, 0x0000abc0) # program counter
memory.write16(0x0000abc0, 0x4e71) # NOP instruction
memory.write16(0x0000abc2, 0x4e71) # NOP instruction
memory.write16(0x0000abc4, 0x4e71) # NOP instruction
memory.write16(0x0000abc6, 0x4e71) # NOP instruction
memory.write16(0x0000abc8, 0x4e71) # NOP instruction
memory.write16(0x0000abca, 0x4e71) # NOP instruction
memory.write16(0x0000abcc, 0x4e71) # NOP instruction
memory.write16(0x0000abce, 0x4e71) # NOP instruction
ksim68k.pulse_reset()
reg_pc = ksim68k.get_reg(ksim68k.Register.PC)
reg_sp = ksim68k.get_reg(ksim68k.Register.SP)
assert reg_pc == 0xabc0
assert reg_sp == 0x1234
cycles = ksim68k.execute(8)
assert cycles == 4
cycles = ksim68k.execute(8)
assert cycles == 8
reg_a0 = ksim68k.get_reg(ksim68k.Register.A0)
reg_a7 = ksim68k.get_reg(ksim68k.Register.A7)
reg_d0 = ksim68k.get_reg(ksim68k.Register.D0)
reg_pc = ksim68k.get_reg(ksim68k.Register.PC)
reg_sp = ksim68k.get_reg(ksim68k.Register.SP)
reg_sr = ksim68k.get_reg(ksim68k.Register.SR)
assert reg_a0 == 0
assert reg_d0 == 0
assert reg_sp == 0x00001234
assert reg_pc == 0x0000abcc
assert reg_a7 == reg_sp
assert reg_sr == 0b0010011100000100
def test_reset_pulse():
memory.data[0:4] = [0x11, 0x22, 0x33, 0x44] # stack pointer
memory.data[4:8] = [0xaa, 0xbb, 0xcc, 0xdd] # program counter
ksim68k.pulse_reset()
sp = ksim68k.get_reg(ksim68k.Register.SP)
a7 = ksim68k.get_reg(ksim68k.Register.A7)
pc = ksim68k.get_reg(ksim68k.Register.PC)
assert memory.reads == [(0, 32), (4, 32)]
assert memory.writes == []
assert sp == 0x11223344
assert a7 == sp
assert pc == 0xaabbccdd
def test_reset_callback():
handler_called = False
def handler():
nonlocal handler_called
handler_called = True
memory.write32(0, 0x5000) # stack pointer
memory.write32(4, 0x2000) # program counter
memory.write16(0x2000, 0x4e70) # reset instruction
ksim68k.reset_handler = handler
ksim68k.pulse_reset()
ksim68k.execute(5)
assert handler_called
def run(program: str) -> None:
with open(program, "rb") as f:
data = f.read()
memory = MappedIoMemory(0x100000)
memory.load(0, data)
ksim68k.use_memory(memory)
ksim68k.init(ksim68k.Cpu.M68000)
ksim68k.pulse_reset()
while keep_running:
ksim68k.execute(16)
def test_execute_example_program():
output = ""
class MappedIoMemory(ksim68k.Memory):
def write8(self, address: int, value: int) -> None:
if address == 0x00fff002: # memory mapped chrout register
nonlocal output
output += chr(value)
memory = MappedIoMemory(0x8000)
memory.load(0, read_test_data("testprog.bin"))
ksim68k.use_memory(memory)
ksim68k.pulse_reset()
ksim68k.execute(2000)
assert output == "Hello, world! From the 68000 assembly program.\n"
def test_stopinstruction_behavior():
memory.write32(0, 0x00002000) # stack pointer
memory.write32(4, 0x00001000) # program counter
memory.write16(0x1000, 0x4e72) # STOP instruction
memory.write16(0x1002, 0x2700) # sr argument
ksim68k.pulse_reset()
ksim68k.execute(20)
ir = ksim68k.get_reg(ksim68k.Register.IR)
pc = ksim68k.get_reg(ksim68k.Register.PC)
assert ir == 0x4e72
assert pc == 0x1004
ksim68k.execute(40)
ir = ksim68k.get_reg(ksim68k.Register.IR)
pc = ksim68k.get_reg(ksim68k.Register.PC)
assert ir == 0x4e72
assert pc == 0x1004
def test_pc_changed_handler():
jumps = []
def handler(address):
jumps.append(address)
old_handler = ksim68k.pc_changed_handler
ksim68k.pc_changed_handler = handler
try:
memory.write32(0, 0x00002000) # stack pointer
memory.write32(4, 0x00001000) # program counter
memory.write16(0x1000, 0x4e71) # NOP instruction
memory.write16(0x1002, 0x4e71) # NOP instruction
memory.write16(0x1004, 0x4e71) # NOP instruction
ksim68k.pulse_reset()
ksim68k.execute(6)
pc = ksim68k.get_reg(ksim68k.Register.PC)
assert pc == 0x1002
assert jumps == [0, 0x1000]
finally:
ksim68k.pc_changed_handler = old_handler
def test_illegalinstr_handler():
old_handler = ksim68k.illegalinstr_handler
illegal_found = False
def handler(opcode):
nonlocal illegal_found
illegal_found = opcode == 0x4afc
return 0
ksim68k.illegalinstr_handler = handler
try:
memory.write32(0, 0x00002000) # stack pointer
memory.write32(4, 0x00001000) # program counter
memory.write32(16, 0x0022334455) # illegal instruction vector
memory.write16(0x1000, 0x4afc) # ILLEGAL instruction
ksim68k.pulse_reset()
ksim68k.execute(6)
ir = ksim68k.get_reg(ksim68k.Register.IR)
pc = ksim68k.get_reg(ksim68k.Register.PC)
assert illegal_found
assert ir == 0x4afc
assert pc == 0x0022334455
finally:
ksim68k.illegalinstr_handler = old_handler