023. Sta página cero x

Añadir STA de página cero,X ($95).

Lección 23 de 356 · tests/chapter_01_cpu/test_023_STA_zero_page_x.py

Archivo a actualizar

emulator/cpu/opcodes.py

Ubicaciones

opcodes.sta_zero_page_x
opcodes.OPCODE_TABLE[$95]

Por qué existe este paso

Esto reutiliza la instrucción sta del Test 022 y el modo de direccionamiento zero_page_x con envoltura del Test 017, mostrando que un manejador de opcode de almacenamiento solo combina un cálculo de dirección ya existente con la operación de escritura existente.

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def sta_zero_page_x(cpu) -> None:
    address = zero_page_x(cpu)
    sta(cpu, address)


OPCODE_TABLE = {
    # Preserve existing entries.
    0x95: sta_zero_page_x,
}

Invariantes importantes

$95 consume un byte de operando
la base más X da la vuelta dentro de la página $00
el valor escrito es cpu.a
STA no modifica Zero ni Negative

Concepto erróneo habitual

El indexado de página cero no se propaga a la página $01; $FF,X con X=$01 apunta a $0000, no a $0100.

Fuera de alcance

cambios en zero_page_x o sta
opcodes de STA absoluto e indirecto
el tiempo de ciclos

Ejecutar esta lección

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

Implementación de ejemplo

Implementación de ejemplo completa

# emulator/cpu/opcodes.py
def sta_zero_page_x(cpu) -> None:
    address = zero_page_x(cpu)
    sta(cpu, address)


OPCODE_TABLE = {
    # Preserve existing entries.
    0x95: sta_zero_page_x,
}

Ver código del testtest_023_STA_zero_page_x.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_sta_zero_page_x_handler_exists_and_is_in_opcode_table():
    """
    Objective:
    Create in opcodes.py:
        def sta_zero_page_x(cpu):
            addr = zero_page_x(cpu)
            sta(cpu, addr)

    Then add:
        0x95: sta_zero_page_x
    """
    assert hasattr(opcodes, "sta_zero_page_x")
    assert callable(opcodes.sta_zero_page_x)
    assert list(inspect.signature(opcodes.sta_zero_page_x).parameters) == ["cpu"]
    assert opcodes.OPCODE_TABLE[0x95] is opcodes.sta_zero_page_x


def test_opcode_95_sta_zero_page_x_stores_register_a():
    """
    Objective:
    95 10 means STA $10,X.
    If X is 0x03, store A into RAM $0013.
    """
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x95)
    rom.write(0x0001, 0x10)

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

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


def test_opcode_95_sta_zero_page_x_wraps_and_does_not_change_flags():
    """
    Objective:
    Zero Page,X wraps inside page $00.
    STA must not change Zero or Negative flags.
    """
    cpu, bus, rom = make_cpu_with_rom()
    rom.write(0x0000, 0x95)
    rom.write(0x0001, 0xFF)

    cpu.reset()
    cpu.a = 0x00
    cpu.x = 0x01
    cpu.p = NEGATIVE_FLAG
    cpu.step()

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

Funciones de test (3)

test_sta_zero_page_x_handler_exists_and_is_in_opcode_table
test_opcode_95_sta_zero_page_x_stores_register_a
test_opcode_95_sta_zero_page_x_wraps_and_does_not_change_flags