072. Inc zero page

подключить INC Zero Page (`0xE6`).

Урок 72 из 356 · tests/chapter_01_cpu/test_072_INC_zero_page.py

На этом шаге, имея emulator/cpu/instructions.py:inc из урока 071 в качестве предпосылки, добавьте только подключение zero page в emulator/cpu/opcodes.py.

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

Обработчики опкодов преобразуют байты инструкции в эффективный адрес. Повторное использование addressing_modes.zero_page сохраняет извлечение операнда и продвижение PC, тогда как instructions.inc остаётся независимым от режима адресации.

Рекомендуемая реализация в emulator/cpu/opcodes.py:

from emulator.cpu.instructions import lda, sta, ldx, stx, ldy, sty, tax, txa, tay, tya, adc, sbc, inc

def inc_zero_page(cpu: CPU):
    addr = zero_page(cpu)
    inc(cpu, addr)

Добавьте следующую запись в существующую OPCODE_TABLE:

0xE6: inc_zero_page,

Обработчик добавлен в секцию # ------ INC Opcodes, а отображение добавлено в OPCODE_TABLE.

Инварианты: zero_page(cpu) потребляет один байт операнда, возвращает адрес в нулевой странице и продвигает PC один раз; обработчик делегирует одну операцию чтения-модификации-записи в inc; 0xE6 отображается на объект функции; длина инструкции — два байта; INC по-прежнему изменяет только память и Z/N.

Типичная ошибка: байт операнда является адресом, а не байтом для инкремента. Не читайте его в обработчике и не дублируйте арифметику INC в нём.

Вне области действия: inc_zero_page_x, inc_absolute и inc_absolute_x, а также их отображения 0xF6, 0xEE и 0xFE — это уроки 073–075.

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

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

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_inc_zero_page_handler_exists_and_is_in_opcode_table(): """Objective: create inc_zero_page(cpu) and add 0xE6 to OPCODE_TABLE.""" assert hasattr(opcodes, "inc_zero_page") assert callable(opcodes.inc_zero_page) assert list(inspect.signature(opcodes.inc_zero_page).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xE6] is opcodes.inc_zero_page def test_opcode_E6_inc_zero_page_increments_memory(): """Objective: E6 10 means INC $10, so RAM[$0010] is incremented.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE6) rom.write(0x0001, 0x10) bus.write(0x0010, 0x41) cpu.reset() cpu.step() assert bus.read(0x0010) == 0x42 assert cpu.pc == 0x8002 def test_opcode_E6_inc_zero_page_updates_zero_flag(): """Objective: 0xFF + 1 becomes 0x00 and sets Zero flag.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE6) rom.write(0x0001, 0x10) bus.write(0x0010, 0xFF) cpu.reset() cpu.step() assert bus.read(0x0010) == 0x00 assert (cpu.p & ZERO_FLAG) != 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_opcode_E6_inc_zero_page_updates_negative_flag(): """Objective: 0x7F + 1 becomes 0x80 and sets Negative flag.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE6) rom.write(0x0001, 0x10) bus.write(0x0010, 0x7F) cpu.reset() cpu.step() assert bus.read(0x0010) == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 assert (cpu.p & ZERO_FLAG) == 0