056. Adc zero page x

Conectar ADC zero page,X (opcode $75) al despacho de la CPU.

Lección 56 de 356 · tests/chapter_01_cpu/test_056_ADC_zero_page_x.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a crear/actualizar

opcodes.adc_zero_page_x
OPCODE_TABLE[$75]

Por qué existe este paso

Este modo reutiliza el resolutor zero_page_x ya establecido, incluido su ajuste circular dentro de la página cero. El manejador de opcode lee entonces la ubicación resuelta y pasa su valor a adc.

Implementación de ejemplo completa

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

OPCODE_TABLE = {
    # ...existing entries...
    0x75: adc_zero_page_x,
}

Invariantes importantes

X se suma en zero_page_x, no una segunda vez en el manejador
(operand + X) & 0xFF mantiene la dirección efectiva dentro de la página cero
se pasa a adc el byte en la dirección efectiva, no la dirección en sí
PC avanza dos bytes en total

Concepto erróneo habitual

No uses una suma normal de 16 bits para el índice; $FF + $01 debe resolverse a $0000, no a $0100.

Fuera de alcance

los modos absoluto indexado e indirecto de ADC
el ajuste de tiempo por cruce de página
cambios en el ayudante de direccionamiento existente

Ejecutar esta lección

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

Implementación de ejemplo

Implementación de ejemplo completa

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

OPCODE_TABLE = {
    # ...existing entries...
    0x75: adc_zero_page_x,
}

Ver código del testtest_056_ADC_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_adc_zero_page_x_handler_exists_and_is_in_opcode_table():
    """Objective: create adc_zero_page_x(cpu) and add 0x75 to OPCODE_TABLE."""
    assert hasattr(opcodes, "adc_zero_page_x")
    assert callable(opcodes.adc_zero_page_x)
    assert list(inspect.signature(opcodes.adc_zero_page_x).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x75] is opcodes.adc_zero_page_x


def test_opcode_75_adc_zero_page_x_adds_indexed_value():
    """Objective: 75 10 with X=0x03 adds RAM[$0013] to A."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x75)
    rom.write(0x0001, 0x10)
    bus.write(0x0013, 0x05)

    cpu.reset()
    cpu.a = 0x10
    cpu.x = 0x03
    cpu.flags.set_carry_flag(False)
    cpu.step()

    assert cpu.a == 0x15
    assert cpu.pc == 0x8002


def test_opcode_75_adc_zero_page_x_wraps_inside_page_zero():
    """Objective: Zero Page,X wraps before reading the ADC value."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x75)
    rom.write(0x0001, 0xFF)
    bus.write(0x0000, 0x05)

    cpu.reset()
    cpu.a = 0x10
    cpu.x = 0x01
    cpu.flags.set_carry_flag(False)
    cpu.step()

    assert cpu.a == 0x15
    assert cpu.pc == 0x8002

Funciones de test (3)

test_adc_zero_page_x_handler_exists_and_is_in_opcode_table
test_opcode_75_adc_zero_page_x_adds_indexed_value
test_opcode_75_adc_zero_page_x_wraps_inside_page_zero