051. Opcodes de transferencia

Registrar las cuatro instrucciones de transferencia como opcodes implícitos.

Lección 51 de 356 · tests/chapter_01_cpu/test_051_transfer_opcodes.py

Archivo a actualizar

emulator/cpu/opcodes.py

Símbolos a actualizar

the instruction import and OPCODE_TABLE

Por qué existe este paso

Las operaciones de transferencia del test 050 ya tienen la misma forma de un argumento que CPU.step espera de una entrada de la tabla de opcodes. Las instrucciones implícitas no tienen operando que decodificar, así que un manejador de opcode intermedio no añadiría ningún comportamiento.

Implementación de ejemplo completa

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

OPCODE_TABLE = {
    # ...the existing load/store entries...
    0xAA: tax,
    0x8A: txa,
    0xA8: tay,
    0x98: tya,
}

Invariantes importantes

cada opcode se asigna directamente a su función de instrucción
CPU.step consume solo el opcode, dejando PC avanzado un byte
el comportamiento de transferencia y de las banderas Zero/Negative permanece en la capa de instrucciones

Concepto erróneo habitual

No crees envoltorios al estilo tax_implied ni obtengas un operando; estas cuatro instrucciones usan direccionamiento implícito y ya coinciden con el contrato de despacho.

Fuera de alcance

la refactorización de FlagsHandler introducida en el test 052
ADC y sus manejadores de opcode
la contabilidad de ciclos

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_051_transfer_opcodes.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,
)

OPCODE_TABLE = {
    # ...the existing load/store entries...
    0xAA: tax,
    0x8A: txa,
    0xA8: tay,
    0x98: tya,
}

Ver código del testtest_051_transfer_opcodes.py

from emulator.bus.cpu_bus import CpuBus
from emulator.cpu import instructions, 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_transfer_opcodes_are_in_opcode_table():
    """
    Objective:
    Add these entries to OPCODE_TABLE:

        0xAA: tax,
        0x8A: txa,
        0xA8: tay,
        0x98: tya,

    Why:
    These instructions use implied addressing.
    CPU.step() fetches only the opcode, then calls the instruction.
    """
    assert opcodes.OPCODE_TABLE[0xAA] is instructions.tax
    assert opcodes.OPCODE_TABLE[0x8A] is instructions.txa
    assert opcodes.OPCODE_TABLE[0xA8] is instructions.tay
    assert opcodes.OPCODE_TABLE[0x98] is instructions.tya


def test_opcode_AA_tax_transfers_a_to_x():
    """Objective: AA means TAX. It copies A into X."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xAA)

    cpu.reset()
    cpu.a = 0x42
    cpu.step()

    assert cpu.x == 0x42
    assert cpu.pc == 0x8001


def test_opcode_8A_txa_transfers_x_to_a():
    """Objective: 8A means TXA. It copies X into A."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x8A)

    cpu.reset()
    cpu.x = 0x42
    cpu.step()

    assert cpu.a == 0x42
    assert cpu.pc == 0x8001


def test_opcode_A8_tay_transfers_a_to_y():
    """Objective: A8 means TAY. It copies A into Y."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0xA8)

    cpu.reset()
    cpu.a = 0x42
    cpu.step()

    assert cpu.y == 0x42
    assert cpu.pc == 0x8001


def test_opcode_98_tya_transfers_y_to_a():
    """Objective: 98 means TYA. It copies Y into A."""
    cpu, _, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x98)

    cpu.reset()
    cpu.y = 0x42
    cpu.step()

    assert cpu.a == 0x42
    assert cpu.pc == 0x8001

Funciones de test (5)

test_transfer_opcodes_are_in_opcode_table
test_opcode_AA_tax_transfers_a_to_x
test_opcode_8A_txa_transfers_x_to_a
test_opcode_A8_tay_transfers_a_to_y
test_opcode_98_tya_transfers_y_to_a