030. Instruction ldx

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

Урок 30 из 356 · tests/chapter_01_cpu/test_030_instruction_ldx.py

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

emulator/cpu/instructions.py

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

instructions.ldx, beside lda and sta

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

LDX открывает следующее семейство инструкций загрузки, сохраняя границу между инструкцией и опкодом, установленную для LDA. Базовая инструкция получает уже разрешённое значение, сохраняет его в X и применяет те же правила Zero/Negative, что и lda.

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

# emulator/cpu/instructions.py
def ldx(cpu, value) -> None:
    cpu.x = value
    cpu._update_zero_and_negative_flags(cpu.x)

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

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

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

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

Вне рамок

все обработчики опкодов LDX и записи в таблице опкодов
интеграция zero-page,Y с опкодом
последующий рефакторинг FlagsHandler

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

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

import inspect from emulator.cpu import instructions from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu def test_ldx_instruction_exists(): """ Objective: Create in instructions.py: def ldx(cpu, value): ... Example implementation: cpu.x = value cpu._update_zero_and_negative_flags(cpu.x) """ assert hasattr(instructions, "ldx") assert callable(instructions.ldx) assert list(inspect.signature(instructions.ldx).parameters) == ["cpu", "value"] def test_ldx_loads_value_into_register_x(): """Objective: ldx(cpu, value) must put value inside cpu.x.""" cpu = make_cpu() instructions.ldx(cpu, 0x42) assert cpu.x == 0x42 def test_ldx_sets_zero_flag_when_value_is_zero(): """Objective: if LDX loads 0x00, Zero flag is set.""" cpu = make_cpu() instructions.ldx(cpu, 0x00) assert cpu.x == 0x00 assert (cpu.p & ZERO_FLAG) != 0 def test_ldx_clears_zero_flag_when_value_is_not_zero(): """Objective: if LDX loads non-zero value, Zero flag is clear.""" cpu = make_cpu() cpu.p |= ZERO_FLAG instructions.ldx(cpu, 0x01) assert cpu.x == 0x01 assert (cpu.p & ZERO_FLAG) == 0 def test_ldx_sets_negative_flag_when_bit_7_is_one(): """Objective: if LDX loads a value with bit 7 active, Negative flag is set.""" cpu = make_cpu() instructions.ldx(cpu, 0x80) assert cpu.x == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 def test_ldx_clears_negative_flag_when_bit_7_is_zero(): """Objective: if LDX loads a value with bit 7 inactive, Negative flag is clear.""" cpu = make_cpu() cpu.p |= NEGATIVE_FLAG instructions.ldx(cpu, 0x7F) assert cpu.x == 0x7F assert (cpu.p & NEGATIVE_FLAG) == 0