124. And indirect y

añadir el opcode AND (indirect),Y ``0x31``.

Lección 124 de 356 · tests/chapter_01_cpu/test_124_AND_indirect_y.py

Por qué existe este paso

Esto completa la cobertura de direccionamiento de AND con un puntero en página cero seguido de indexación por Y, reutilizando tanto el ayudante indirecto como la primitiva común de AND.

En este paso, completa los modos numerados de AND añadiendo lo siguiente a `emulator/cpu/opcodes.py`:

def and_indirect_y(cpu: CPU):
    addr = indirect_y(cpu)
    value = cpu.bus.read(addr)
    and_a(cpu, value)

OPCODE_TABLE = {
    ...
    0x31: and_indirect_y,
}

`emulator/cpu/addressing_modes.py::indirect_y obtiene una ubicación de puntero en página cero, lee su palabra en little-endian con envoltura de página cero para el byte alto, y solo entonces suma cpu.y. El valor destino se pasa a instructions.and_a`. A y Z/N cambian; Y, Carry/Overflow, los bytes del puntero y la memoria destino permanecen invariantes; el PC avanza dos bytes.

Concepto erróneo: (indirect),Y no suma Y a la ubicación del puntero en página cero; ese orden pertenece a (indirect,X). Fuera de alcance: el trabajo de ORA, EOR y BIT, a partir de la lección 125.

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

def and_indirect_y(cpu: CPU):
    addr = indirect_y(cpu)
    value = cpu.bus.read(addr)
    and_a(cpu, value)

OPCODE_TABLE = {
    ...
    0x31: and_indirect_y,
}

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


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


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

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

    assert cpu.a == 0x03
    assert cpu.pc == 0x8002

Funciones de test (2)

test_and_indirect_y_handler_exists_and_is_in_opcode_table
test_opcode_31_and_indirect_y_reads_pointed_indexed_memory_value