139. Eor absolute x

añadir el opcode EOR absolute,X ``0x5D``.

Lección 139 de 356 · tests/chapter_01_cpu/test_139_EOR_absolute_x.py

Por qué existe este paso

Los programas necesitan EOR sobre datos de dirección completa indexados por X; este paso conecta esa forma de dirección efectiva con la semántica de OR exclusivo ya probada.

En este paso, la lección 138 proporciona el EOR absoluto sin indexar. Añade exactamente lo siguiente a `emulator/cpu/opcodes.py`:

def eor_absolute_x(cpu: CPU):
    addr = absolute_x(cpu)
    value = cpu.bus.read(addr)
    or_e(cpu, value)

OPCODE_TABLE = {
    ...
    0x5D: eor_absolute_x,
}

`emulator/cpu/addressing_modes.py::absolute_x obtiene la palabra base en little-endian y luego suma X; este auxiliar no aplica una máscara adicional & 0xFFFF. El manejador lee la ubicación indexada y llama a instructions.or_e`. A y Z/N pueden cambiar; Carry/Overflow, la memoria, X e Y permanecen invariantes; el PC avanza tres bytes.

Concepto erróneo: X indexa la dirección decodificada de 16 bits, no su byte de operando bajo. Fuera de alcance: absolute,Y y EOR indirecto (140-142) y BIT (143-145).

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

def eor_absolute_x(cpu: CPU):
    addr = absolute_x(cpu)
    value = cpu.bus.read(addr)
    or_e(cpu, value)

OPCODE_TABLE = {
    ...
    0x5D: eor_absolute_x,
}

Ver código del testtest_139_EOR_absolute_x.py

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_eor_absolute_x_handler_exists_and_is_in_opcode_table():
    """Objective: create eor_absolute_x(cpu) and add 0x5D to OPCODE_TABLE."""
    assert hasattr(opcodes, "eor_absolute_x")
    assert callable(opcodes.eor_absolute_x)
    assert list(inspect.signature(opcodes.eor_absolute_x).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x5D] is opcodes.eor_absolute_x


def test_opcode_5D_eor_absolute_x_reads_indexed_memory_value():
    """Objective: 5D 00 02 with X=0x04 reads RAM[$0204]."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x5D)
    rom.write(0x0001, 0x00)
    rom.write(0x0002, 0x02)
    bus.write(0x0204, 0x0F)

    cpu.reset()
    cpu.x = 0x04
    cpu.a = 0xF0
    cpu.step()

    assert cpu.a == 0xFF
    assert cpu.pc == 0x8003

Funciones de test (2)

test_eor_absolute_x_handler_exists_and_is_in_opcode_table
test_opcode_5D_eor_absolute_x_reads_indexed_memory_value