054. Adc immediate

Conectar ADC immediate (opcode $69) al despacho de la CPU.

Lección 54 de 356 · tests/chapter_01_cpu/test_054_ADC_immediate.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a crear/actualizar

opcodes.adc_immediate
OPCODE_TABLE[$69]
the `adc` instruction import

Por qué existe este paso

El test 053 proporcionó aritmética sobre un valor ya resuelto. El modo immediate proporciona directamente el siguiente byte del programa, así que este manejador pasa el valor devuelto por immediate(cpu) directamente a adc.

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
from emulator.cpu.instructions import ..., adc

def adc_immediate(cpu):
    value = immediate(cpu)
    adc(cpu, value)

OPCODE_TABLE = {
    # ...existing entries...
    0x69: adc_immediate,
}

Invariantes importantes

el manejador acepta solo cpu
el modo immediate consume exactamente un byte de operando
PC avanza dos bytes en total: opcode más operando
el manejador delega toda la aritmética y los cambios de banderas en adc

Concepto erróneo habitual

No trates el byte immediate como una dirección ni leas el bus una segunda vez; immediate(cpu) ya devuelve el valor del operando.

Fuera de alcance

todos los opcodes de ADC direccionados a memoria
cambios en adc o en los ayudantes de direccionamiento
la contabilidad de ciclos

Ejecutar esta lección

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

Implementación de ejemplo

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
from emulator.cpu.instructions import ..., adc

def adc_immediate(cpu):
    value = immediate(cpu)
    adc(cpu, value)

OPCODE_TABLE = {
    # ...existing entries...
    0x69: adc_immediate,
}

Ver código del testtest_054_ADC_immediate.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_immediate_handler_exists_and_is_in_opcode_table():
    """
    Objective:
    Create adc_immediate(cpu) and add 0x69 to OPCODE_TABLE.

    Important:
    immediate(cpu) returns the value directly.
    Do not read from cpu.bus again for immediate mode.
    """
    assert hasattr(opcodes, "adc_immediate")
    assert callable(opcodes.adc_immediate)
    assert list(inspect.signature(opcodes.adc_immediate).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x69] is opcodes.adc_immediate


def test_opcode_69_adc_immediate_adds_value_to_register_a():
    """Objective: 69 05 means ADC #$05, so A = A + 0x05 + Carry."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x69)
    rom.write(0x0001, 0x05)

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

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


def test_opcode_69_adc_immediate_uses_carry_flag():
    """Objective: ADC includes the old Carry flag in the addition."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x69)
    rom.write(0x0001, 0x05)

    cpu.reset()
    cpu.a = 0x10
    cpu.flags.set_carry_flag(True)
    cpu.step()

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

Funciones de test (3)

test_adc_immediate_handler_exists_and_is_in_opcode_table
test_opcode_69_adc_immediate_adds_value_to_register_a
test_opcode_69_adc_immediate_uses_carry_flag