042. Ldy immediate

Добавьте LDY immediate ($A0).

Урок 42 из 356 · tests/chapter_01_cpu/test_042_LDY_immediate.py

Файл для обновления

emulator/cpu/opcodes.py

Расположения

opcodes import of ldy
opcodes.ldy_immediate
opcodes.OPCODE_TABLE[$A0]

Зачем нужен этот шаг

Базовая инструкция ldy уже отвечает за поведение регистра и флагов. Этот урок подключает её первую кодировку, извлекая один буквальный операнд и передавая это значение в ldy.

Полный пример реализации

# emulator/cpu/opcodes.py
from emulator.cpu.addressing_modes import immediate
from emulator.cpu.instructions import ldy


def ldy_immediate(cpu: CPU):
    ldy(cpu, immediate(cpu))


OPCODE_TABLE = {
    # Preserve existing entries.
    0xA0: ldy_immediate,
}

Важные инварианты

$A0 сопоставляется с ldy_immediate
непосредственный режим извлекает ровно один байт операнда, продвигая PC на единицу после опкода
загружается сам операнд; он не рассматривается как адрес в памяти
ldy по-прежнему отвечает за обновление Zero и Negative

Распространённое заблуждение

Не читайте шину по числовому значению непосредственного байта. Для A0 42 Y получает $42 напрямую.

Вне рамок задания

кодировки LDY zero-page, indexed и absolute
обработчики опкодов STY
тайминг циклов

Запустить этот урок

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

# emulator/cpu/opcodes.py from emulator.cpu.addressing_modes import immediate from emulator.cpu.instructions import ldy def ldy_immediate(cpu: CPU): ldy(cpu, immediate(cpu)) OPCODE_TABLE = { # Preserve existing entries. 0xA0: ldy_immediate, }

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_ldy_immediate_handler_exists_and_is_in_opcode_table(): """Objective: create ldy_immediate(cpu) and add 0xA0 to OPCODE_TABLE.""" assert hasattr(opcodes, "ldy_immediate") assert callable(opcodes.ldy_immediate) assert list(inspect.signature(opcodes.ldy_immediate).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xA0] is opcodes.ldy_immediate def test_opcode_A0_ldy_immediate_loads_register_y(): """Objective: A0 42 means LDY #$42, so Y becomes 0x42.""" cpu, _, rom = make_cpu_with_rom() rom.write(0x0000, 0xA0) rom.write(0x0001, 0x42) cpu.reset() cpu.step() assert cpu.y == 0x42 assert cpu.pc == 0x8002 def test_opcode_A0_ldy_immediate_updates_flags(): """Objective: LDY Immediate updates Zero and Negative flags.""" cpu, _, rom = make_cpu_with_rom() rom.write(0x0000, 0xA0) rom.write(0x0001, 0x80) cpu.reset() cpu.step() assert cpu.y == 0x80 assert (cpu.p & ZERO_FLAG) == 0 assert (cpu.p & NEGATIVE_FLAG) != 0