027. Sta indirecto x

Añadir STA indexado indirecto ($81, escrito `(d,X)`).

Lección 27 de 356 · tests/chapter_01_cpu/test_027_STA_indirect_x.py

Archivo a actualizar

emulator/cpu/opcodes.py

Ubicaciones

opcodes.sta_indirect_x
opcodes.OPCODE_TABLE[$81]

Por qué existe este paso

El Test 020 estableció la resolución de puntero (d,X) para las cargas. Esta lección reutiliza ese mismo cálculo de dirección final como destino de una escritura, manteniendo la mecánica de punteros fuera de la instrucción sta.

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def sta_indirect_x(cpu) -> None:
    address = indirect_x(cpu)
    sta(cpu, address)


OPCODE_TABLE = {
    # Preserve existing entries.
    0x81: sta_indirect_x,
}

Invariantes importantes

X indexa la ubicación del puntero de página cero antes de desreferenciarlo
la selección del puntero y la lectura de su byte alto dan la vuelta dentro de la página cero
el resultado de 16 bits del puntero es el destino de la escritura
$81 consume un byte de operando y no actualiza flags

Concepto erróneo habitual

No sumes X al valor final del puntero. En (d,X), X elige dónde se lee el puntero, y sta escribe A en la dirección contenida en ese puntero.

Fuera de alcance

cambios en indirect_x o sta
STA indirecto,Y
el tiempo de ciclos

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_027_STA_indirect_x.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 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_sta_indirect_x_handler_exists_and_is_in_opcode_table(): """ Objective: Create sta_indirect_x(cpu) and add 0x81 to OPCODE_TABLE. """ assert hasattr(opcodes, "sta_indirect_x") assert callable(opcodes.sta_indirect_x) assert list(inspect.signature(opcodes.sta_indirect_x).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x81] is opcodes.sta_indirect_x def test_opcode_81_sta_indirect_x_stores_register_a(): """ Objective: 81 20 means STA ($20,X). If X is 0x04, pointer is at $0024. If RAM[$0024-$0025] points to $0200, store A into $0200. """ cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x81) rom.write(0x0001, 0x20) bus.write(0x0024, 0x00) bus.write(0x0025, 0x02) cpu.reset() cpu.a = 0x42 cpu.x = 0x04 cpu.step() assert bus.read(0x0200) == 0x42 assert cpu.pc == 0x8002