160. Cpy inmediato

expone CPY inmediato como opcode ``0xC0``.

Lección 160 de 356 · tests/chapter_01_cpu/test_160_CPY_immediate.py

Por qué existe este paso

CPY inmediato expone la comparación de Y mediante la ejecución de la CPU usando un byte literal sin una lectura adicional de la memoria de datos.

En este paso, después de que la lección 159 haya creado la instrucción, haz estas adiciones en `emulator/cpu/opcodes.py`:

from emulator.cpu.instructions import (..., cpy)

def cpy_immediate(cpu: CPU):
    cpy(cpu, immediate(cpu))

OPCODE_TABLE = {
    ...
    0xC0: cpy_immediate,
}

`emulator/cpu/addressing_modes.py::immediate devuelve CPU.fetch_byte()` como valor. CPY cambia solo C/Z/N; Y, la memoria y Overflow permanecen invariantes, y el opcode más el operando avanzan PC dos bytes.

Concepto erróneo: el modo inmediato no identifica una dirección del bus, y CPY no almacena la resta en Y. Fuera de alcance: CPY de página cero y absoluto (lecciones 161-162).

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

from emulator.cpu.instructions import (..., cpy)

def cpy_immediate(cpu: CPU):
    cpy(cpu, immediate(cpu))

OPCODE_TABLE = {
    ...
    0xC0: cpy_immediate,
}

Ver código del testtest_160_CPY_immediate.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
from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG


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


def test_opcode_C0_cpy_immediate_compares_y_with_value():
    """Objective: C0 10 means compare Y with 0x10."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xC0)
    rom.write(0x0001, 0x10)

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

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


def test_opcode_C0_cpy_immediate_sets_zero_when_equal():
    """Objective: equal values set Zero and Carry."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xC0)
    rom.write(0x0001, 0x10)

    cpu.reset()
    cpu.y = 0x10
    cpu.step()

    assert (cpu.p & ZERO_FLAG) != 0
    assert (cpu.p & CARRY_FLAG) != 0


def test_opcode_C0_cpy_immediate_sets_negative_when_wrapped_result_has_bit_7():
    """Objective: Y=0x01 compared with 0x02 gives wrapped result 0xFF."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xC0)
    rom.write(0x0001, 0x02)

    cpu.reset()
    cpu.y = 0x01
    cpu.step()

    assert (cpu.p & CARRY_FLAG) == 0
    assert (cpu.p & NEGATIVE_FLAG) != 0

Funciones de test (4)

test_cpy_immediate_handler_exists_and_is_in_opcode_table
test_opcode_C0_cpy_immediate_compares_y_with_value
test_opcode_C0_cpy_immediate_sets_zero_when_equal
test_opcode_C0_cpy_immediate_sets_negative_when_wrapped_result_has_bit_7