153. Cmp indirecto x

añade el opcode CMP (indirect,X) ``0xC1``.

Lección 153 de 356 · tests/chapter_01_cpu/test_153_CMP_indirect_x.py

Por qué existe este paso

La forma (indirect,X) permite que CMP use tablas de punteros de página cero preindexadas mientras deja la resolución de punteros al helper de direccionamiento.

En este paso, tras las lecciones 146-152, añade exactamente lo siguiente a `emulator/cpu/opcodes.py`:

def cmp_indirect_x(cpu: CPU):
    addr = indirect_x(cpu)
    value = cpu.bus.read(addr)
    cmp(cpu, value)

OPCODE_TABLE = {
    ...
    0xC1: cmp_indirect_x,
}

`emulator/cpu/addressing_modes.py::indirect_x obtiene el operando, calcula (base + X) & 0xFF` y lee un puntero little-endian cuya búsqueda del byte alto también hace wraparound dentro de la página cero. A continuación, el handler lee el valor señalado. Solo cambian C/Z/N; A, X, los bytes del puntero, la memoria de destino y Overflow son invariantes; el opcode y el operando avanzan PC dos bytes.

Concepto erróneo: X se aplica antes de desreferenciar, no a la dirección final de 16 bits. Fuera de alcance: CMP (indirect),Y (154) y CPX/CPY (155-162).

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

def cmp_indirect_x(cpu: CPU):
    addr = indirect_x(cpu)
    value = cpu.bus.read(addr)
    cmp(cpu, value)

OPCODE_TABLE = {
    ...
    0xC1: cmp_indirect_x,
}

Ver código del testtest_153_CMP_indirect_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


CARRY_FLAG = 1 << 0


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


def test_opcode_C1_cmp_indirect_x_reads_pointed_memory_value():
    """Objective: C1 20 with X=0x04 reads pointer at zero-page $24/$25."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xC1)
    rom.write(0x0001, 0x20)
    bus.write(0x0024, 0x00)
    bus.write(0x0025, 0x02)
    bus.write(0x0200, 0x10)

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

    assert (cpu.p & CARRY_FLAG) != 0
    assert cpu.pc == 0x8002

Funciones de test (2)

test_cmp_indirect_x_handler_exists_and_is_in_opcode_table
test_opcode_C1_cmp_indirect_x_reads_pointed_memory_value