154. Cmp indirecto y

añade el opcode CMP (indirect),Y ``0xD1``.

Lección 154 de 356 · tests/chapter_01_cpu/test_154_CMP_indirect_y.py

Por qué existe este paso

La forma (indirect),Y completa el direccionamiento de CMP indexando un puntero de página cero resuelto en lugar de la propia ubicación del puntero.

En este paso, cierra la secuencia de opcodes de CMP añadiendo lo siguiente a `emulator/cpu/opcodes.py`:

def cmp_indirect_y(cpu: CPU):
    addr = indirect_y(cpu)
    value = cpu.bus.read(addr)
    cmp(cpu, value)

OPCODE_TABLE = {
    ...
    0xD1: cmp_indirect_y,
}

`emulator/cpu/addressing_modes.py::indirect_y` lee un puntero little-endian de la página cero (haciendo wraparound en la búsqueda del byte alto del puntero) y luego suma Y a esa dirección de 16 bits. Solo cambian C/Z/N; A, Y, los bytes del puntero, la memoria de destino y Overflow son invariantes; el opcode más el operando avanzan PC dos bytes.

Concepto erróneo: a diferencia de (indirect,X), Y se suma después de desreferenciar el puntero, no al operando de página cero. Fuera de alcance: CPX y CPY en las lecciones 155-162.

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

def cmp_indirect_y(cpu: CPU):
    addr = indirect_y(cpu)
    value = cpu.bus.read(addr)
    cmp(cpu, value)

OPCODE_TABLE = {
    ...
    0xD1: cmp_indirect_y,
}

Ver código del testtest_154_CMP_indirect_y.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_y_handler_exists_and_is_in_opcode_table():
    """Objective: create cmp_indirect_y(cpu) and add 0xD1 to OPCODE_TABLE."""
    assert hasattr(opcodes, "cmp_indirect_y")
    assert callable(opcodes.cmp_indirect_y)
    assert list(inspect.signature(opcodes.cmp_indirect_y).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0xD1] is opcodes.cmp_indirect_y


def test_opcode_D1_cmp_indirect_y_reads_pointed_indexed_memory_value():
    """Objective: D1 20 reads pointer at $20/$21, then adds Y."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xD1)
    rom.write(0x0001, 0x20)
    bus.write(0x0020, 0x00)
    bus.write(0x0021, 0x02)
    bus.write(0x0204, 0x10)

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

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

Funciones de test (2)

test_cmp_indirect_y_handler_exists_and_is_in_opcode_table
test_opcode_D1_cmp_indirect_y_reads_pointed_indexed_memory_value