050. Instrucciones de transferencia

Añadir las instrucciones principales TAX, TXA, TAY y TYA.

Lección 50 de 356 · tests/chapter_01_cpu/test_050_transfer_instructions.py

Archivo a actualizar

emulator/cpu/instructions.py

Ubicaciones

instructions.tax
instructions.txa
instructions.tay
instructions.tya

Por qué existe este paso

Estas operaciones de direccionamiento implícito copian entre A, X e Y sin obtener un operando. Cada valor de destino utiliza luego la misma actualización de Zero/Negative ya empleada por las instrucciones de carga.

Ejemplo completo de implementación

# emulator/cpu/instructions.py
def tax(cpu: CPU):
    cpu.x = cpu.a
    cpu._update_zero_and_negative_flags(cpu.x)


def txa(cpu: CPU):
    cpu.a = cpu.x
    cpu._update_zero_and_negative_flags(cpu.a)


def tay(cpu: CPU):
    cpu.y = cpu.a
    cpu._update_zero_and_negative_flags(cpu.y)


def tya(cpu: CPU):
    cpu.a = cpu.y
    cpu._update_zero_and_negative_flags(cpu.a)

Invariantes importantes

TAX copia A en X, TXA copia X en A, TAY copia A en Y y TYA copia Y en A
el registro fuente permanece sin cambios
Zero se activa exactamente para $00 y Negative refleja el bit 7 del destino
ambos flags también se desactivan cuando el valor copiado ya no los satisface
estas funciones no obtienen bytes y no realizan acceso al bus

Error frecuente

Actualizar solo los flags que se activan deja estado obsoleto. Reutilizar cpu._update_zero_and_negative_flags con el registro de destino después de cada copia.

Fuera de alcance

importaciones de opcodes de transferencia y entradas en OPCODE_TABLE, introducidas en Test 051
transferencias del puntero de pila
temporización de ciclos

Ejecutar esta lección

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

Implementación de ejemplo

Ejemplo completo de implementación

# emulator/cpu/instructions.py
def tax(cpu: CPU):
    cpu.x = cpu.a
    cpu._update_zero_and_negative_flags(cpu.x)


def txa(cpu: CPU):
    cpu.a = cpu.x
    cpu._update_zero_and_negative_flags(cpu.a)


def tay(cpu: CPU):
    cpu.y = cpu.a
    cpu._update_zero_and_negative_flags(cpu.y)


def tya(cpu: CPU):
    cpu.a = cpu.y
    cpu._update_zero_and_negative_flags(cpu.a)

Ver código del testtest_050_transfer_instructions.py

import inspect

from emulator.cpu import instructions
from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu


def test_tax_instruction_exists():
    """
    Objective:
    Create in instructions.py:
        def tax(cpu):
            ...

    TAX means:
        X = A
    """
    assert hasattr(instructions, "tax")
    assert callable(instructions.tax)
    assert list(inspect.signature(instructions.tax).parameters) == ["cpu"]


def test_txa_instruction_exists():
    """
    Objective:
    Create in instructions.py:
        def txa(cpu):
            ...

    TXA means:
        A = X
    """
    assert hasattr(instructions, "txa")
    assert callable(instructions.txa)
    assert list(inspect.signature(instructions.txa).parameters) == ["cpu"]


def test_tay_instruction_exists():
    """
    Objective:
    Create in instructions.py:
        def tay(cpu):
            ...

    TAY means:
        Y = A
    """
    assert hasattr(instructions, "tay")
    assert callable(instructions.tay)
    assert list(inspect.signature(instructions.tay).parameters) == ["cpu"]


def test_tya_instruction_exists():
    """
    Objective:
    Create in instructions.py:
        def tya(cpu):
            ...

    TYA means:
        A = Y
    """
    assert hasattr(instructions, "tya")
    assert callable(instructions.tya)
    assert list(inspect.signature(instructions.tya).parameters) == ["cpu"]


def test_tax_transfers_a_to_x_and_updates_flags():
    """Objective: TAX copies A into X and updates Zero/Negative flags."""
    cpu = make_cpu()
    cpu.a = 0x80

    instructions.tax(cpu)

    assert cpu.x == 0x80
    assert (cpu.p & ZERO_FLAG) == 0
    assert (cpu.p & NEGATIVE_FLAG) != 0


def test_txa_transfers_x_to_a_and_updates_flags():
    """Objective: TXA copies X into A and updates Zero/Negative flags."""
    cpu = make_cpu()
    cpu.x = 0x00

    instructions.txa(cpu)

    assert cpu.a == 0x00
    assert (cpu.p & ZERO_FLAG) != 0
    assert (cpu.p & NEGATIVE_FLAG) == 0


def test_tay_transfers_a_to_y_and_updates_flags():
    """Objective: TAY copies A into Y and updates Zero/Negative flags."""
    cpu = make_cpu()
    cpu.a = 0x42
    cpu.p |= ZERO_FLAG | NEGATIVE_FLAG

    instructions.tay(cpu)

    assert cpu.y == 0x42
    assert (cpu.p & ZERO_FLAG) == 0
    assert (cpu.p & NEGATIVE_FLAG) == 0


def test_tya_transfers_y_to_a_and_updates_flags():
    """Objective: TYA copies Y into A and updates Zero/Negative flags."""
    cpu = make_cpu()
    cpu.y = 0x80

    instructions.tya(cpu)

    assert cpu.a == 0x80
    assert (cpu.p & ZERO_FLAG) == 0
    assert (cpu.p & NEGATIVE_FLAG) != 0

Funciones de test (8)

test_tax_instruction_exists
test_txa_instruction_exists
test_tay_instruction_exists
test_tya_instruction_exists
test_tax_transfers_a_to_x_and_updates_flags
test_txa_transfers_x_to_a_and_updates_flags
test_tay_transfers_a_to_y_and_updates_flags
test_tya_transfers_y_to_a_and_updates_flags