075. Inc absoluto x

cablear INC Absoluto,X (`0xFE`).

Lección 75 de 356 · tests/chapter_01_cpu/test_075_INC_absolute_x.py

En este paso, añade emulator/cpu/opcodes.py:inc_absolute_x y OPCODE_TABLE[0xFE] después de las demás formas de INC de las lecciones 071-074.

Por qué existe este paso

Reutiliza addressing_modes.absolute_x para que la decodificación de la dirección base y la indexación con X permanezcan fuera de la primitiva de lectura-modificación-escritura de INC.

Implementación sugerida en emulator/cpu/opcodes.py:

def inc_absolute_x(cpu: CPU):
    addr = absolute_x(cpu)
    inc(cpu, addr)

Añade exactamente esta entrada a la OPCODE_TABLE existente:

0xFE: inc_absolute_x,

Invariantes: se consumen dos bytes de operando little-endian; X se suma a la dirección base de 16 bits; el PC avanza dos posiciones tras obtener el opcode, formando una instrucción de tres bytes; el byte de memoria resuelto envuelve módulo 256; solo Z/N lo reflejan.

Concepto erróneo: la indexación absoluto-X no usa el desbordamiento de página cero. Puede cruzar de página, por lo que $02FF,X con X=1 resuelve a $0300.

Fuera de alcance: DEC comienza en la lección 076. El conteo de ciclos y el tiempo de cruce de página no forman parte de este paso.

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_075_INC_absolute_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_inc_absolute_x_handler_exists_and_is_in_opcode_table(): """Objective: create inc_absolute_x(cpu) and add 0xFE to OPCODE_TABLE.""" assert hasattr(opcodes, "inc_absolute_x") assert callable(opcodes.inc_absolute_x) assert list(inspect.signature(opcodes.inc_absolute_x).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xFE] is opcodes.inc_absolute_x def test_opcode_FE_inc_absolute_x_increments_indexed_memory(): """Objective: FE 00 02 with X=0x04 increments RAM[$0204].""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xFE) rom.write(0x0001, 0x00) rom.write(0x0002, 0x02) bus.write(0x0204, 0x41) cpu.reset() cpu.x = 0x04 cpu.step() assert bus.read(0x0204) == 0x42 assert cpu.pc == 0x8003