081. Inx, неявная адресация

Подключить опкод INX с неявной адресацией.

Урок 81 из 356 · tests/chapter_01_cpu/test_081_INX_implied.py

На этом шаге добавьте только интеграцию опкода INX после того, как тест 080 предоставил instructions.inx.

Расположение в продакшн-коде и символы

emulator/cpu/opcodes.py: imported `inx` and `OPCODE_TABLE[0xE8]`

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

INX использует неявную адресацию, поэтому диспетчеризация может вызывать функцию инструкции напрямую. Обёртка или помощник режима адресации не нужны.

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

# emulator/cpu/opcodes.py
from emulator.cpu.instructions import inx  # alongside existing imports

OPCODE_TABLE = {
    # ... existing entries ...
    0xE8: inx,
}

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

опкод 0xE8 диспетчеризуется точно в функцию inx(cpu)
байт операнда не считывается, поэтому CPU.step продвигает PC на один байт
переполнение регистра и обновление флагов Z/N по-прежнему принадлежат inx из теста 080

Частое заблуждение

Не создавайте обёртку inx_implied; инструкции с неявной адресацией могут быть прямыми записями в таблице, и обёртка не добавила бы никакого поведения декодирования.

Вне рамок

поведение инструкции dex из теста 082 и её отображение DEX в тесте 083
последующие инструкции INY/DEY и инструкции сдвига
тайминги циклов

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

uv run pytest tests/chapter_01_cpu/test_081_INX_implied.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_inx_opcode_exists_and_is_in_opcode_table(): """Objective: add 0xE8 to OPCODE_TABLE and point it to inx.""" assert hasattr(opcodes, "inx") assert callable(opcodes.inx) assert list(inspect.signature(opcodes.inx).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0xE8] is opcodes.inx def test_opcode_E8_inx_implied_increments_x_register(): """Objective: E8 means INX, so X is incremented and PC advances by 1.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE8) cpu.reset() cpu.x = 0x10 cpu.step() assert cpu.x == 0x11 assert cpu.pc == 0x8001 def test_opcode_E8_inx_implied_updates_zero_flag(): """Objective: X=0xFF wraps to 0x00 and sets Zero flag.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE8) cpu.reset() cpu.x = 0xFF cpu.step() assert cpu.x == 0x00 assert (cpu.p & ZERO_FLAG) != 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_opcode_E8_inx_implied_updates_negative_flag(): """Objective: X=0x7F becomes 0x80 and sets Negative flag.""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0xE8) cpu.reset() cpu.x = 0x7F cpu.step() assert cpu.x == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 assert (cpu.p & ZERO_FLAG) == 0