161. Cpy en página cero

añadir el opcode CPY de página cero ``0xC4``.

Lección 161 de 356 · tests/chapter_01_cpu/test_161_CPY_zero_page.py

Por qué existe este paso

CPY en página cero interpreta su operando como una dirección de memoria compacta y compara Y con el byte leído en esa dirección a través de la primitiva CPY compartida.

En este paso, las lecciones 159-160 ya proporcionan `instructions.cpy, su importación de opcode y CPY inmediato. Añade exactamente lo siguiente a emulator/cpu/opcodes.py`:

def cpy_zero_page(cpu: CPU):
    addr = zero_page(cpu)
    value = cpu.bus.read(addr)
    cpy(cpu, value)

OPCODE_TABLE = {
    ...
    0xC4: cpy_zero_page,
}

`emulator/cpu/addressing_modes.py::zero_page consume el operando de un byte como una dirección; el manejador entonces lee esa dirección y delega la semántica de flags a emulator/cpu/instructions.py::cpy`.

Invariantes: Y y la memoria no cambian; CPY solo actualiza C/Z/N, y el opcode más el operando avanza PC en dos bytes. Concepto erróneo: el operando no es el valor comparado con Y; identifica el byte de página cero que contiene ese valor.

Fuera de alcance: CPY absoluto `0xCC` es la lección 162. CMP/CPX y CPY inmediato pertenecen a las lecciones 146-160.

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_161_CPY_zero_page.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 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_cpy_zero_page_handler_exists_and_is_in_opcode_table(): """Objective: create cpy_zero_page(cpu) and add 0xC4 to OPCODE_TABLE.""" assert hasattr(opcodes, "cpy_zero_page") assert callable(opcodes.cpy_zero_page) assert list(inspect.signature(opcodes.cpy_zero_page).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xC4] is opcodes.cpy_zero_page def test_opcode_C4_cpy_zero_page_reads_memory_value_and_compares(): """Objective: C4 10 means compare Y with RAM[$0010].""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xC4) rom.write(0x0001, 0x10) bus.write(0x0010, 0x10) cpu.reset() cpu.y = 0x20 cpu.step() assert cpu.y == 0x20 assert (cpu.p & CARRY_FLAG) != 0 assert cpu.pc == 0x8002