058. Adc absolute x

Conectar ADC absolute,X (opcode $7D) al despacho de la CPU.

Lección 58 de 356 · tests/chapter_01_cpu/test_058_ADC_absolute_x.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a crear/actualizar

opcodes.adc_absolute_x
OPCODE_TABLE[$7D]

Por qué existe este paso

El ayudante absolute_x existente consume la dirección base en little-endian y le suma X. Este manejador lee el byte en esa dirección efectiva y reutiliza la instrucción ADC implementada en el test 053.

Implementación de ejemplo completa

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

OPCODE_TABLE = {
    # ...existing entries...
    0x7D: adc_absolute_x,
}

Invariantes importantes

X se aplica exactamente una vez, en absolute_x
la dirección efectiva no está restringida a la página cero
PC avanza tres bytes en total
el valor direccionado se pasa a adc

Concepto erróneo habitual

No apliques el ajuste circular de página cero a una dirección absoluta indexada; este modo puede cruzar a la página siguiente.

Fuera de alcance

los modos absolute,Y e indirecto de ADC
las penalizaciones de tiempo por cruce de página
la política de ajuste circular de direcciones de 16 bits más allá del ayudante existente

Ejecutar esta lección

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

# emulator/cpu/opcodes.py def adc_absolute_x(cpu): addr = absolute_x(cpu) value = cpu.bus.read(addr) adc(cpu, value) OPCODE_TABLE = { # ...existing entries... 0x7D: adc_absolute_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_absolute_x_handler_exists_and_is_in_opcode_table(): """Objective: create adc_absolute_x(cpu) and add 0x7D to OPCODE_TABLE.""" assert hasattr(opcodes, "adc_absolute_x") assert callable(opcodes.adc_absolute_x) assert list(inspect.signature(opcodes.adc_absolute_x).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x7D] is opcodes.adc_absolute_x def test_opcode_7D_adc_absolute_x_adds_indexed_value(): """Objective: 7D 00 02 with X=0x04 adds RAM[$0204] to A.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x7D) rom.write(0x0001, 0x00) rom.write(0x0002, 0x02) bus.write(0x0204, 0x05) cpu.reset() cpu.a = 0x10 cpu.x = 0x04 cpu.flags.set_carry_flag(False) cpu.step() assert cpu.a == 0x15 assert cpu.pc == 0x8003