060. Adc indirect x

Conectar ADC (indirect,X) (opcode $61) al despacho de la CPU.

Lección 60 de 356 · tests/chapter_01_cpu/test_060_ADC_indirect_x.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a crear/actualizar

opcodes.adc_indirect_x
OPCODE_TABLE[$61]

Por qué existe este paso

indirect_x primero suma X al operando de zero page, lee un puntero en little-endian de la página cero y devuelve la dirección efectiva final. El manejador debe entonces leer el valor de ADC en esa dirección final.

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def adc_indirect_x(cpu):
    addr = indirect_x(cpu)
    value = cpu.bus.read(addr)
    adc(cpu, value)

OPCODE_TABLE = {
    # ...existing entries...
    0x61: adc_indirect_x,
}

Invariantes importantes

X indexa la ubicación del puntero en zero page antes de la desreferencia
las lecturas de los bytes del puntero se ajustan circularmente dentro de la página cero
el destino del puntero es una dirección, así que el manejador realiza la lectura final
PC avanza dos bytes en total

Concepto erróneo habitual

No sumes X al destino final de 16 bits. Eso describe una operación distinta; para (indirect,X), X selecciona el puntero de zero page antes de que se desreferencie.

Fuera de alcance

ADC (indirect),Y, introducido por el siguiente test numerado
la contabilidad de ciclos
cambios en indirect_x o en adc

Ejecutar esta lección

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

# emulator/cpu/opcodes.py def adc_indirect_x(cpu): addr = indirect_x(cpu) value = cpu.bus.read(addr) adc(cpu, value) OPCODE_TABLE = { # ...existing entries... 0x61: adc_indirect_x, }

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_adc_indirect_x_handler_exists_and_is_in_opcode_table(): """Objective: create adc_indirect_x(cpu) and add 0x61 to OPCODE_TABLE.""" assert hasattr(opcodes, "adc_indirect_x") assert callable(opcodes.adc_indirect_x) assert list(inspect.signature(opcodes.adc_indirect_x).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x61] is opcodes.adc_indirect_x def test_opcode_61_adc_indirect_x_adds_value_from_final_address(): """Objective: 61 20 with X=0x04 uses pointer at $0024 and adds final memory value.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x61) rom.write(0x0001, 0x20) bus.write(0x0024, 0x00) bus.write(0x0025, 0x02) bus.write(0x0200, 0x05) cpu.reset() cpu.a = 0x10 cpu.x = 0x04 cpu.flags.set_carry_flag(False) cpu.step() assert cpu.a == 0x15 assert cpu.pc == 0x8002