029. Zero page y addressing

Добавление адресации zero-page,Y.

Урок 29 из 356 · tests/chapter_01_cpu/test_029_zero_page_y_addressing.py

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

emulator/cpu/addressing_modes.py

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

addressing_modes.zero_page_y

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

Некоторые более поздние кодировки инструкций индексируют операнд нулевой страницы регистром Y, а не X. Этот урок вводит только этот переиспользуемый расчёт адреса, аналогичный zero_page_x из Теста 017, прежде чем связывать его с каким-либо опкодом.

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

# emulator/cpu/addressing_modes.py
def zero_page_y(cpu) -> int:
    base = cpu.fetch_byte()
    address = (base + cpu.y) & 0xFF
    return address

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

выбирается ровно один байт операнда
к операнду прибавляется Y, а не X
результат циклически ограничивается восемью битами и поэтому остаётся в пределах страницы $00
вспомогательная функция возвращает адрес и не выполняет чтение памяти по этому адресу

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

Маскируйте сумму, а не только операнд: $FF + $01 должно стать $0000, а не $0100.

Вне рамок

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

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

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

import inspect from emulator.bus.cpu_bus import CpuBus from emulator.cpu import addressing_modes from emulator.cpu.cpu import CPU from emulator.memory.fake_rom import FakeROM 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_zero_page_y_addressing_mode_exists(): """ Objective: Create in addressing_modes.py: def zero_page_y(cpu): ... Example implementation: base = cpu.fetch_byte() return (base + cpu.y) & 0xFF """ assert hasattr(addressing_modes, "zero_page_y") assert callable(addressing_modes.zero_page_y) assert list(inspect.signature(addressing_modes.zero_page_y).parameters) == ["cpu"] def test_zero_page_y_adds_y_to_base_address(): """ Objective: If the operand is 0x10 and Y is 0x03, zero_page_y(cpu) returns 0x0013. """ cpu, _, rom = make_cpu_with_rom() cpu.reset() cpu.y = 0x03 rom.write(0x0000, 0x10) addr = addressing_modes.zero_page_y(cpu) assert addr == 0x0013 assert cpu.pc == 0x8001 def test_zero_page_y_wraps_inside_page_zero(): """ Objective: Zero Page,Y wraps inside page $00. Example: 0xFF + Y where Y is 0x01 becomes 0x00, not 0x0100. """ cpu, _, rom = make_cpu_with_rom() cpu.reset() cpu.y = 0x01 rom.write(0x0000, 0xFF) addr = addressing_modes.zero_page_y(cpu) assert addr == 0x0000 assert cpu.pc == 0x8001