038. Stx página cero y

Añadir STX página cero,Y ($96).

Lección 38 de 356 · tests/chapter_01_cpu/test_038_STX_zero_page_y.py

Archivo a actualizar

emulator/cpu/opcodes.py

Ubicaciones

opcodes.stx_zero_page_y
opcodes.OPCODE_TABLE[$96]

Por qué existe este paso

Esta lección reutiliza el helper de página cero,Y introducido por primera vez en el test 029 para añadir la codificación indexada en página cero de STX. El cálculo de dirección se mantiene separado de la operación de guardado principal.

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def stx_zero_page_y(cpu: CPU):
    addr = zero_page_y(cpu)
    stx(cpu, addr)


OPCODE_TABLE = {
    # Preserve existing entries.
    0x96: stx_zero_page_y,
}

Invariantes importantes

$96 se corresponde con stx_zero_page_y
Y, no X, indexa el operando de un byte
la base más Y envuelve dentro de la página $00
stx escribe X y deja Zero y Negative sin cambios

Concepto erróneo habitual

El registro que se guarda no determina el registro de índice. STX $nn,Y guarda X pero usa Y para calcular el destino.

Fuera de alcance

STX absoluto
cambios en zero_page_y o stx
la temporización de ciclos

Ejecutar esta lección

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

Implementación de ejemplo

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def stx_zero_page_y(cpu: CPU):
    addr = zero_page_y(cpu)
    stx(cpu, addr)


OPCODE_TABLE = {
    # Preserve existing entries.
    0x96: stx_zero_page_y,
}

Ver código del testtest_038_STX_zero_page_y.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
from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG


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_stx_zero_page_y_handler_exists_and_is_in_opcode_table():
    """
    Objective:
    Create in opcodes.py:
        def stx_zero_page_y(cpu):
            addr = zero_page_y(cpu)
            stx(cpu, addr)

    Then add:
        0x96: stx_zero_page_y

    Important:
    STX Zero Page uses Y, not X.
    """
    assert hasattr(opcodes, "stx_zero_page_y")
    assert callable(opcodes.stx_zero_page_y)
    assert list(inspect.signature(opcodes.stx_zero_page_y).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x96] is opcodes.stx_zero_page_y


def test_opcode_96_stx_zero_page_y_stores_register_x():
    """
    Objective:
    96 10 means STX $10,Y.
    If Y is 0x03, store X into RAM $0013.
    """
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x96)
    rom.write(0x0001, 0x10)

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

    assert bus.read(0x0013) == 0x42
    assert cpu.pc == 0x8002


def test_opcode_96_stx_zero_page_y_wraps_inside_page_zero():
    """
    Objective:
    Zero Page,Y wraps inside page $00.
    """
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x96)
    rom.write(0x0001, 0xFF)

    cpu.reset()
    cpu.x = 0x37
    cpu.y = 0x01
    cpu.step()

    assert bus.read(0x0000) == 0x37
    assert cpu.pc == 0x8002


def test_opcode_96_stx_zero_page_y_does_not_change_flags():
    """
    Objective:
    STX Zero Page,Y stores X but does not update flags.
    """
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x96)
    rom.write(0x0001, 0x10)

    cpu.reset()
    cpu.x = 0x00
    cpu.y = 0x03
    cpu.p = NEGATIVE_FLAG
    cpu.step()

    assert bus.read(0x0013) == 0x00
    assert (cpu.p & ZERO_FLAG) == 0
    assert (cpu.p & NEGATIVE_FLAG) != 0

Funciones de test (4)

test_stx_zero_page_y_handler_exists_and_is_in_opcode_table
test_opcode_96_stx_zero_page_y_stores_register_x
test_opcode_96_stx_zero_page_y_wraps_inside_page_zero
test_opcode_96_stx_zero_page_y_does_not_change_flags