054. Adc immediate

Подключить ADC immediate (опкод $69) к диспетчеризации CPU.

Урок 54 из 356 · tests/chapter_01_cpu/test_054_ADC_immediate.py

Файл для обновления

emulator/cpu/opcodes.py

Символы для создания/обновления

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

Почему этот шаг нужен

Тест 053 обеспечил арифметику над уже полученным значением. Непосредственный режим сам предоставляет следующий байт программы, поэтому этот обработчик передаёт возвращаемое значение immediate(cpu) напрямую в adc.

Полный пример реализации

# 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,
}

Важные инварианты

обработчик принимает только cpu
непосредственный режим потребляет ровно один байт операнда
PC продвигается всего на два байта: опкод плюс операнд
обработчик передаёт всю арифметику и изменения флагов в adc

Распространённое заблуждение

Не воспринимайте непосредственный байт как адрес и не читайте шину повторно; immediate(cpu) уже возвращает значение операнда.

Вне рамок задачи

все опкоды ADC с адресацией по памяти
изменения в adc или вспомогательных методах адресации
учёт циклов

Запустить этот урок

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

# 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, }

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