063. Sbc immediate

Добавляем SBC Immediate.

Урок 63 из 356 · tests/chapter_01_cpu/test_063_SBC_immediate.py

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

emulator/cpu/opcodes.py

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

the `sbc` import, opcodes.sbc_immediate, and OPCODE_TABLE[0xE9]

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

Это первая обёртка опкода для базовой инструкции sbc. Непосредственный режим уже возвращает значение операнда, поэтому обёртка только получает его и передаёт дальше.

Полная эталонная реализация

# emulator/cpu/opcodes.py
from emulator.cpu.instructions import (
    lda, sta, ldx, stx, ldy, sty, tax, txa, tay, tya, adc, sbc,
)

def sbc_immediate(cpu: CPU):
    value = immediate(cpu)
    sbc(cpu, value)

OPCODE_TABLE = {
    # ... existing entries ...
    0xE9: sbc_immediate,
}

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

опкод $E9 соответствует sbc_immediate
immediate получает и возвращает ровно один байт операнда
это возвращённое значение передаётся напрямую в sbc
выполнение двухбайтовой инструкции продвигает PC на два байта

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

Не читайте шину, используя результат immediate; в отличие от вспомогательных методов адресации памяти, он возвращает значение операнда, а не адрес.

Вне рамок этого шага

все обёртки опкодов SBC с адресацией памяти
изменения базовой арифметики или флагов SBC
тайминг циклов и десятичный режим

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

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

# emulator/cpu/opcodes.py from emulator.cpu.instructions import ( lda, sta, ldx, stx, ldy, sty, tax, txa, tay, tya, adc, sbc, ) def sbc_immediate(cpu: CPU): value = immediate(cpu) sbc(cpu, value) OPCODE_TABLE = { # ... existing entries ... 0xE9: sbc_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_sbc_immediate_handler_exists_and_is_in_opcode_table(): """ Objective: Create sbc_immediate(cpu) and add 0xE9 to OPCODE_TABLE. Important: immediate(cpu) returns the value directly. Do not read from cpu.bus again for immediate mode. """ assert hasattr(opcodes, "sbc_immediate") assert callable(opcodes.sbc_immediate) assert list(inspect.signature(opcodes.sbc_immediate).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xE9] is opcodes.sbc_immediate def test_opcode_E9_sbc_immediate_subtracts_value_from_register_a(): """ Objective: E9 01 means SBC #$01. If Carry is set, A = A - value. """ cpu, _, rom = make_cpu_with_rom() rom.write(0x0000, 0xE9) rom.write(0x0001, 0x01) cpu.reset() cpu.a = 0x10 cpu.flags.set_carry_flag(True) cpu.step() assert cpu.a == 0x0F assert cpu.pc == 0x8002 def test_opcode_E9_sbc_immediate_uses_carry_as_no_borrow(): """ Objective: If Carry is clear, SBC subtracts one extra. A = A - value - 1 """ cpu, _, rom = make_cpu_with_rom() rom.write(0x0000, 0xE9) rom.write(0x0001, 0x01) cpu.reset() cpu.a = 0x10 cpu.flags.set_carry_flag(False) cpu.step() assert cpu.a == 0x0E assert cpu.pc == 0x8002