099. Lsr zero page x

Añadir LSR Zero Page,X.

Lección 99 de 356 · tests/chapter_01_cpu/test_099_LSR_zero_page_x.py

En este paso, añade indexación por X a la forma Zero Page de LSR del test 098.

Archivo y símbolos

emulator/cpu/opcodes.py: lsr_zero_page_x, OPCODE_TABLE[0x56]

Por qué existe este paso

Esta transición añade LSR indexado en página cero combinando el resolutor zero_page_x ya existente con lsr en memoria; no añade nueva semántica de desplazamiento.

Implementación sugerida para este paso

# emulator/cpu/opcodes.py
def lsr_zero_page_x(cpu: CPU):
    addr = zero_page_x(cpu)
    lsr(cpu, addr)

OPCODE_TABLE = {
    # existing entries unchanged
    0x56: lsr_zero_page_x,
}

Invariantes importantes

el cálculo de la dirección efectiva se ajusta a ocho bits dentro de la página cero
solo se consume un byte de operando, por lo que PC avanza dos posiciones incluyendo el opcode
lsr se encarga de la escritura en memoria y de los cambios en C/Z/N
X selecciona el destino y no se modifica

Error conceptual habitual

La base 0xFE más X=0x03 apunta a $0001, no a $0101.

Fuera de alcance

LSR Absolute y Absolute,X en los tests 100-101
cambios en el direccionamiento o en el comportamiento de LSR
la precisión de ciclos

Ejecutar esta lección

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

Implementación de ejemplo

Implementación sugerida para este paso

# emulator/cpu/opcodes.py
def lsr_zero_page_x(cpu: CPU):
    addr = zero_page_x(cpu)
    lsr(cpu, addr)

OPCODE_TABLE = {
    # existing entries unchanged
    0x56: lsr_zero_page_x,
}

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


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


def test_opcode_56_lsr_zero_page_x_shifts_indexed_memory_value():
    """Objective: 56 20 with X=0x04 shifts RAM[$0024]."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x56)
    rom.write(0x0001, 0x20)
    bus.write(0x0024, 0b0000_0110)

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

    assert bus.read(0x0024) == 0b0000_0011
    assert cpu.pc == 0x8002


def test_opcode_56_lsr_zero_page_x_wraps_zero_page_address():
    """Objective: zero-page indexed addresses wrap to 8 bits."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x56)
    rom.write(0x0001, 0xFE)
    bus.write(0x0001, 0x04)

    cpu.reset()
    cpu.x = 0x03
    cpu.step()

    assert bus.read(0x0001) == 0x02
    assert cpu.pc == 0x8002

Funciones de test (3)

test_lsr_zero_page_x_handler_exists_and_is_in_opcode_table
test_opcode_56_lsr_zero_page_x_shifts_indexed_memory_value
test_opcode_56_lsr_zero_page_x_wraps_zero_page_address