040. Инструкция ldy

Добавление базовой инструкции LDY.

Урок 40 из 356 · tests/chapter_01_cpu/test_040_instruction_ldy.py

Файл для изменения

emulator/cpu/instructions.py

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

instructions.ldy, beside stx

Почему этот шаг существует

LDY открывает семейство загрузки регистра Y, устанавливая её поведение на уровне значений ещё до подключения какого-либо опкода LDY. Она повторяет LDA и LDX: присваивает уже вычисленное значение регистру назначения, затем обновляет Zero и Negative.

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

# emulator/cpu/instructions.py
def ldy(cpu: CPU, value):
    cpu.y = value
    cpu._update_zero_and_negative_flags(cpu.y)

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

ldy получает значение, а не адрес
Y получает значение, в то время как A и X остаются без изменений
Zero устанавливается точно для $00 и сбрасывается в остальных случаях
Negative повторяет бит 7 и сбрасывается, когда бит 7 равен нулю

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

Не извлекайте операнд и не читайте память внутри ldy; будущие обработчики опкодов будут вычислять значение перед вызовом этой инструкции.

Вне рамок

все обработчики опкодов LDY и записи в таблице опкодов
инструкция STY и её кодировки
тайминг циклов

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

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

import inspect from emulator.cpu import instructions from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu def test_ldy_instruction_exists(): """ Objective: Create in instructions.py: def ldy(cpu, value): ... Example implementation: cpu.y = value cpu._update_zero_and_negative_flags(cpu.y) """ assert hasattr(instructions, "ldy") assert callable(instructions.ldy) assert list(inspect.signature(instructions.ldy).parameters) == ["cpu", "value"] def test_ldy_loads_value_into_register_y(): """Objective: ldy(cpu, value) must put value inside cpu.y.""" cpu = make_cpu() instructions.ldy(cpu, 0x42) assert cpu.y == 0x42 def test_ldy_sets_zero_flag_when_value_is_zero(): """Objective: if LDY loads 0x00, Zero flag is set.""" cpu = make_cpu() instructions.ldy(cpu, 0x00) assert cpu.y == 0x00 assert (cpu.p & ZERO_FLAG) != 0 def test_ldy_clears_zero_flag_when_value_is_not_zero(): """Objective: if LDY loads non-zero value, Zero flag is clear.""" cpu = make_cpu() cpu.p |= ZERO_FLAG instructions.ldy(cpu, 0x01) assert cpu.y == 0x01 assert (cpu.p & ZERO_FLAG) == 0 def test_ldy_sets_negative_flag_when_bit_7_is_one(): """Objective: if LDY loads a value with bit 7 active, Negative flag is set.""" cpu = make_cpu() instructions.ldy(cpu, 0x80) assert cpu.y == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 def test_ldy_clears_negative_flag_when_bit_7_is_zero(): """Objective: if LDY loads a value with bit 7 inactive, Negative flag is clear.""" cpu = make_cpu() cpu.p |= NEGATIVE_FLAG instructions.ldy(cpu, 0x7F) assert cpu.y == 0x7F assert (cpu.p & NEGATIVE_FLAG) == 0