084. Инструкция iny

Добавить поведение инструкции INY.

Урок 84 из 356 · tests/chapter_01_cpu/test_084_instruction_iny.py

На этом шаге добавьте только iny, до отображения её опкода в тесте 085 и работы над DEY в тестах 086-087.

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

emulator/cpu/instructions.py: `iny(cpu: CPU)`

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

INY увеличивает регистр Y независимо от декодирования опкода и должен эмулировать 8-битный регистр, несмотря на неограниченные целые числа Python.

Предлагаемая реализация

def iny(cpu: CPU):
    result = cpu.y + 1
    result_8 = result & 0xFF

    # Set flags
    cpu.flags.set_negative_flag((result_8 & 0b1000_0000) != 0)
    cpu.flags.set_zero_flag(result_8 == 0)

    cpu.y = result_8

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

Y переполняется с 0xFF до 0x00
Zero и Negative вычисляются из замаскированного результата
Carry, Overflow, память и другие регистры остаются неизменными

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

Инкремент не устанавливает Carry при переполнении Y; INY обновляет только Z и N.

Вне рамок

диспетчеризация опкода 0xC8 (тест 085)
поведение и диспетчеризация DEY (тесты 086-087)
последующая работа над ASL и тайминги циклов

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

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

def iny(cpu: CPU): result = cpu.y + 1 result_8 = result & 0xFF # Set flags cpu.flags.set_negative_flag((result_8 & 0b1000_0000) != 0) cpu.flags.set_zero_flag(result_8 == 0) cpu.y = result_8

from emulator.cpu.instructions import iny from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu CARRY_FLAG = 1 << 0 OVERFLOW_FLAG = 1 << 6 def test_iny_increments_y_register(): """Objective: Y increases by one and remains an 8-bit register value.""" cpu = make_cpu() cpu.y = 0x10 iny(cpu) assert cpu.y == 0x11 def test_iny_wraps_from_ff_to_00_and_sets_zero_flag(): """Objective: 0xFF + 1 wraps to 0x00 and sets Zero flag.""" cpu = make_cpu() cpu.y = 0xFF iny(cpu) assert cpu.y == 0x00 assert (cpu.p & ZERO_FLAG) != 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_iny_sets_negative_flag_when_result_has_bit_7_set(): """Objective: 0x7F + 1 becomes 0x80, so Negative flag is set.""" cpu = make_cpu() cpu.y = 0x7F iny(cpu) assert cpu.y == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 assert (cpu.p & ZERO_FLAG) == 0 def test_iny_does_not_modify_carry_or_overflow_flags(): """Objective: INY updates Z/N only; Carry and Overflow are preserved.""" cpu = make_cpu() cpu.y = 0x01 cpu.p |= CARRY_FLAG cpu.p |= OVERFLOW_FLAG iny(cpu) assert cpu.y == 0x02 assert (cpu.p & CARRY_FLAG) != 0 assert (cpu.p & OVERFLOW_FLAG) != 0