098. Lsr zero page

Добавить LSR Zero Page.

Урок 98 из 356 · tests/chapter_01_cpu/test_098_LSR_zero_page.py

На этом шаге lsr для памяти из теста 095 раскрывается через первый адресуемый опкод.

Файл и символы

emulator/cpu/opcodes.py: imported lsr, lsr_zero_page, OPCODE_TABLE[0x46]

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

Поскольку lsr для памяти уже определён тестом 095, этот переход вводит его первый адресуемый опкод и сохраняет декодирование операнда отдельно от поведения инструкции.

Предлагаемая реализация для этого шага

# emulator/cpu/opcodes.py
from emulator.cpu.instructions import lsr

def lsr_zero_page(cpu: CPU):
    addr = zero_page(cpu)
    lsr(cpu, addr)

OPCODE_TABLE = {
    # existing entries unchanged
    0x46: lsr_zero_page,
}

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

zero_page(cpu) считывает один операнд и даёт адрес в диапазоне $0000-$00FF
lsr выполняет чтение/изменение/запись и заменяет C/Z/N
двухбайтовая инструкция увеличивает PC на два
A не изменяется

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

Для 46 10 операнд 0x10 указывает на RAM[$0010]; это не сдвигаемое значение.

Вне рамок

индексированные и абсолютные формы LSR в тестах 099-101
изменения в zero_page или lsr
точное по тактам поведение шины

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

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

# emulator/cpu/opcodes.py from emulator.cpu.instructions import lsr def lsr_zero_page(cpu: CPU): addr = zero_page(cpu) lsr(cpu, addr) OPCODE_TABLE = { # existing entries unchanged 0x46: lsr_zero_page, }

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 CARRY_FLAG = 1 << 0 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_lsr_zero_page_handler_exists_and_is_in_opcode_table(): """Objective: create lsr_zero_page(cpu) and add 0x46 to OPCODE_TABLE.""" assert hasattr(opcodes, "lsr_zero_page") assert callable(opcodes.lsr_zero_page) assert list(inspect.signature(opcodes.lsr_zero_page).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x46] is opcodes.lsr_zero_page def test_opcode_46_lsr_zero_page_shifts_memory_value(): """Objective: 46 10 means LSR $10, so RAM[$0010] is shifted right.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x46) rom.write(0x0001, 0x10) bus.write(0x0010, 0b0000_0110) cpu.reset() cpu.step() assert bus.read(0x0010) == 0b0000_0011 assert cpu.pc == 0x8002 def test_opcode_46_lsr_zero_page_sets_carry_from_old_bit_0(): """Objective: old memory bit 0 becomes Carry.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x46) rom.write(0x0001, 0x10) bus.write(0x0010, 0b0000_0011) cpu.reset() cpu.step() assert bus.read(0x0010) == 0b0000_0001 assert (cpu.p & CARRY_FLAG) != 0