063. Sbc immediate

Añadir SBC Immediate.

Lección 63 de 356 · tests/chapter_01_cpu/test_063_SBC_immediate.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a añadir/actualizar

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

Por qué existe este paso

Este es el primer envoltorio de opcode para la instrucción central sbc. El modo inmediato ya devuelve el valor del operando, así que el envoltorio solo resuelve y delega.

Implementación de ejemplo completa

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

Invariantes importantes

el opcode $E9 se asigna a sbc_immediate
immediate obtiene y devuelve exactamente un byte de operando
ese valor devuelto se pasa directamente a sbc
ejecutar la instrucción de dos bytes avanza PC en dos bytes

Concepto erróneo común

No leas el bus usando el resultado de immediate; a diferencia de los asistentes de direccionamiento de memoria, este devuelve el valor del operando en lugar de una dirección.

Fuera de alcance

todos los envoltorios de opcode de SBC direccionados a memoria
cambios en la aritmética o las flags centrales de SBC
la temporización de ciclos y el modo decimal

Ejecutar esta lección

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

Implementación de ejemplo

Implementación de ejemplo completa

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

Ver código del testtest_063_SBC_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_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

Funciones de test (3)

test_sbc_immediate_handler_exists_and_is_in_opcode_table
test_opcode_E9_sbc_immediate_subtracts_value_from_register_a
test_opcode_E9_sbc_immediate_uses_carry_as_no_borrow