073. Inc página cero x

cablear INC Página Cero,X (`0xF6`).

Lección 73 de 356 · tests/chapter_01_cpu/test_073_INC_zero_page_x.py

En este paso, usa instructions.inc y la importación de INC de las lecciones 071-072, y añade solo emulator/cpu/opcodes.py:inc_zero_page_x y OPCODE_TABLE[0xF6].

Por qué existe este paso

El auxiliar de direccionamiento indexado, y no la instrucción, se encarga de la suma de X y del desbordamiento dentro de la página cero.

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

def inc_zero_page_x(cpu: CPU):
    addr = zero_page_x(cpu)
    inc(cpu, addr)

Añade exactamente esta entrada a la OPCODE_TABLE existente:

0xF6: inc_zero_page_x,

Invariantes: zero_page_x(cpu) consume un byte, suma cpu.x y envuelve la dirección efectiva dentro de $0000-$00FF; el PC avanza hasta la siguiente instrucción de dos bytes; inc realiza la mutación de memoria y actualiza solo Z/N.

Concepto erróneo: no calcules operand + X como una dirección de 16 bits sin restricciones; $FF,X con X=1 apunta a $0000, no a $0100.

Fuera de alcance: los manejadores y mapeos de INC absoluto y absoluto-X son las lecciones 074-075.

Ejecutar esta lección

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

Implementación de ejemplo

Por qué existe este paso

def inc_zero_page_x(cpu: CPU):
    addr = zero_page_x(cpu)
    inc(cpu, addr)

Ver código del testtest_073_INC_zero_page_x.py

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_zero_page_x_handler_exists_and_is_in_opcode_table():
    """Objective: create inc_zero_page_x(cpu) and add 0xF6 to OPCODE_TABLE."""
    assert hasattr(opcodes, "inc_zero_page_x")
    assert callable(opcodes.inc_zero_page_x)
    assert list(inspect.signature(opcodes.inc_zero_page_x).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0xF6] is opcodes.inc_zero_page_x


def test_opcode_F6_inc_zero_page_x_increments_indexed_memory():
    """Objective: F6 10 with X=0x03 increments RAM[$0013]."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xF6)
    rom.write(0x0001, 0x10)
    bus.write(0x0013, 0x41)

    cpu.reset()
    cpu.x = 0x03
    cpu.step()

    assert bus.read(0x0013) == 0x42
    assert cpu.pc == 0x8002


def test_opcode_F6_inc_zero_page_x_wraps_inside_page_zero():
    """Objective: Zero Page,X wraps before INC modifies memory."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xF6)
    rom.write(0x0001, 0xFF)
    bus.write(0x0000, 0x41)

    cpu.reset()
    cpu.x = 0x01
    cpu.step()

    assert bus.read(0x0000) == 0x42
    assert cpu.pc == 0x8002

Funciones de test (3)

test_inc_zero_page_x_handler_exists_and_is_in_opcode_table
test_opcode_F6_inc_zero_page_x_increments_indexed_memory
test_opcode_F6_inc_zero_page_x_wraps_inside_page_zero