132. Ora indirect x

añadir el opcode ORA (indirect,X) ``0x01``.

Lección 132 de 356 · tests/chapter_01_cpu/test_132_ORA_indirect_x.py

Por qué existe este paso

El ORA indirecto preindexado admite tablas de punteros en la página cero y confirma que la búsqueda del puntero se completa antes de que el valor de memoria resultante se combine con A mediante OR.

En este paso, la lección 131 ha completado los modos directos de ORA. Añade exactamente lo siguiente a `emulator/cpu/opcodes.py`:

def ora_indirect_x(cpu: CPU):
    addr = indirect_x(cpu)
    value = cpu.bus.read(addr)
    or_a(cpu, value)

OPCODE_TABLE = {
    ...
    0x01: ora_indirect_x,
}

`emulator/cpu/addressing_modes.py::indirect_x obtiene el operando, le suma X con ajuste circular en la página cero, y lee un puntero en little-endian cuya búsqueda del byte alto también se ajusta de forma circular en la página cero. El manejador lee el valor apuntado y delega el resultado y las flags de ORA en instructions.or_a`. A y Z/N pueden cambiar; Carry/Overflow, la memoria, X e Y permanecen invariantes; el PC avanza dos bytes.

Concepto erróneo: X se suma antes de la desreferenciación del puntero, no a la dirección final de 16 bits. Fuera de alcance: ORA (indirect),Y (lección 133) y EOR/BIT (134-145).

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_132_ORA_indirect_x.py -v

import inspect from emulator.bus.cpu_bus import CpuBus from emulator.cpu import opcodes from emulator.cpu.cpu import CPU from emulator.memory.fake_rom import FakeROM def make_cpu_with_rom(): rom = FakeROM() rom.write(0x7FFC, 0x00) rom.write(0x7FFD, 0x80) bus = CpuBus(program_rom=rom) return CPU(bus), bus, rom def test_ora_indirect_x_handler_exists_and_is_in_opcode_table(): """Objective: create ora_indirect_x(cpu) and add 0x01 to OPCODE_TABLE.""" assert hasattr(opcodes, "ora_indirect_x") assert callable(opcodes.ora_indirect_x) assert list(inspect.signature(opcodes.ora_indirect_x).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x01] is opcodes.ora_indirect_x def test_opcode_01_ora_indirect_x_reads_pointed_memory_value(): """Objective: 01 20 with X=0x04 reads pointer at zero-page $24/$25.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x01) rom.write(0x0001, 0x20) bus.write(0x0024, 0x00) bus.write(0x0025, 0x02) bus.write(0x0200, 0x0F) cpu.reset() cpu.x = 0x04 cpu.a = 0xF0 cpu.step() assert cpu.a == 0xFF assert cpu.pc == 0x8002