074. Inc absoluto

cablear INC Absoluto (`0xEE`).

Lección 74 de 356 · tests/chapter_01_cpu/test_074_INC_absolute.py

En este paso, con inc ya importado, añade únicamente emulator/cpu/opcodes.py:inc_absolute y OPCODE_TABLE[0xEE].

Por qué existe este paso

addressing_modes.absolute centraliza la decodificación little-endian de la dirección de dos bytes, mientras que la primitiva INC existente realiza la lectura-modificación-escritura.

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

def inc_absolute(cpu: CPU):
    addr = absolute(cpu)
    inc(cpu, addr)

Añade exactamente esta entrada a la OPCODE_TABLE existente:

0xEE: inc_absolute,

Invariantes: el byte bajo del operando precede al byte alto; absolute(cpu) consume ambos y avanza el PC dos veces; EE 00 02 apunta a $0200; la longitud total de la instrucción es de tres bytes; INC actualiza la memoria y Z/N, no los registros, Carry ni Overflow.

Concepto erróneo: no inviertas los bytes del operando ni pases el valor del byte obtenido a inc; el auxiliar devuelve la dirección efectiva de 16 bits.

Fuera de alcance: inc_absolute_x y OPCODE_TABLE[0xFE] son la lección 075.

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_074_INC_absolute.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_handler_exists_and_is_in_opcode_table(): """Objective: create inc_absolute(cpu) and add 0xEE to OPCODE_TABLE.""" assert hasattr(opcodes, "inc_absolute") assert callable(opcodes.inc_absolute) assert list(inspect.signature(opcodes.inc_absolute).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xEE] is opcodes.inc_absolute def test_opcode_EE_inc_absolute_increments_memory(): """Objective: EE 00 02 means INC $0200, so RAM[$0200] is incremented.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xEE) rom.write(0x0001, 0x00) rom.write(0x0002, 0x02) bus.write(0x0200, 0x41) cpu.reset() cpu.step() assert bus.read(0x0200) == 0x42 assert cpu.pc == 0x8003