111. Ror acumulador

exponer el ROR A ya construido como opcode ``0x6A``.

Lección 111 de 356 · tests/chapter_01_cpu/test_111_ROR_accumulator.py

En este paso, usa `ror y ror_a de las lecciones 109-110 y añade solo la integración del opcode del acumulador en emulator/cpu/opcodes.py`.

Por qué existe este paso

ROR A necesita una entrada en la tabla de opcodes antes de que los programas puedan alcanzar la primitiva del acumulador mediante la ejecución normal de la CPU sin captar un operando de forma incorrecta.

Implementación sugerida

from emulator.cpu.instructions import (..., ror_a)

OPCODE_TABLE = {
    ...
    0x6A: ror_a,
}

La entrada directa en la tabla es la implementación de ejemplo completa: `CPU.step ya ha captado el opcode y ror_a(cpu)` no necesita ningún decodificador de operando. Rota A hacia la derecha a través del Carry antiguo, mueve el bit 0 antiguo de A a Carry, actualiza Zero/Negative a partir del resultado de 8 bits y deja la memoria intacta. Por tanto, la instrucción de un byte avanza PC exactamente en uno.

Concepto erróneo: el modo acumulador no es un wrapper de un modo de direccionamiento; añadir un handler `ror_accumulator o captar un operando consumiría un byte adicional. Fuera del alcance aquí: los handlers/opcodes de memoria 0x66, 0x76, 0x6E y 0x7E` pertenecen a las lecciones 112-115; AND comienza en la lección 116.

Ejecutar esta lección

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

Implementación de ejemplo

Implementación sugerida

from emulator.cpu.instructions import (..., ror_a)

OPCODE_TABLE = {
    ...
    0x6A: ror_a,
}

Ver código del testtest_111_ROR_accumulator.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


CARRY_FLAG = 1 << 0


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_ror_accumulator_opcode_exists_and_is_in_opcode_table():
    """Objective: import ror_a and add 0x6A to OPCODE_TABLE."""
    assert hasattr(opcodes, "ror_a")
    assert callable(opcodes.ror_a)
    assert list(inspect.signature(opcodes.ror_a).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x6A] is opcodes.ror_a


def test_opcode_6A_ror_accumulator_rotates_a_and_advances_pc_by_one():
    """Objective: 6A means ROR A, so only A is rotated and PC advances by 1."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x6A)

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

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


def test_opcode_6A_ror_accumulator_uses_old_carry_as_new_bit_7():
    """Objective: old Carry=1 is inserted into A bit 7."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x6A)

    cpu.reset()
    cpu.p |= CARRY_FLAG
    cpu.a = 0b0000_0010
    cpu.step()

    assert cpu.a == 0b1000_0001
    assert (cpu.p & CARRY_FLAG) == 0


def test_opcode_6A_ror_accumulator_sets_carry_from_old_a_bit_0():
    """Objective: old A bit 0 becomes Carry."""
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x6A)

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

    assert cpu.a == 0b0000_0001
    assert (cpu.p & CARRY_FLAG) != 0

Funciones de test (4)

test_ror_accumulator_opcode_exists_and_is_in_opcode_table
test_opcode_6A_ror_accumulator_rotates_a_and_advances_pc_by_one
test_opcode_6A_ror_accumulator_uses_old_carry_as_new_bit_7
test_opcode_6A_ror_accumulator_sets_carry_from_old_a_bit_0