159. Instruction cpy

реализовать поведение CPY, не зависящее от режима адресации.

Урок 159 из 356 · tests/chapter_01_cpu/test_159_instruction_cpy.py

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

CPY нужен ориентированный на значение примитив сравнения, чтобы все режимы адресации использовали одни и те же правила для флагов отсутствия заёма, равенства и результата с переносом при вычитании.

На этом шаге, после CPX, добавьте ровно этот символ в `emulator/cpu/instructions.py`:

def cpy(cpu: CPU, value: int):
    result_8 = (cpu.y - value) & 0xFF

    # Flags:
    cpu.flags.set_carry_flag(cpu.y >= value)
    cpu.flags.set_zero_flag(cpu.y == value)
    cpu.flags.set_negative_flag((result_8 & 0b1000_0000) !=0)

Вычитание выполняется с переносом исключительно для получения флага Negative; Carry означает отсутствие беззнакового заёма, а Zero означает равенство. Y, операнд, память, A, X, PC и Overflow не изменяются, поскольку CPY не сохраняет результат вычитания.

Заблуждение: CPY не использует существующий флаг Carry и не записывает результат обратно в Y. Вне рамок: импорт `cpy в emulator/cpu/opcodes.py` и её обработчики для непосредственного, нулевой страницы и абсолютного режимов (уроки 160-162).

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

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

def cpy(cpu: CPU, value: int): result_8 = (cpu.y - value) & 0xFF # Flags: cpu.flags.set_carry_flag(cpu.y >= value) cpu.flags.set_zero_flag(cpu.y == value) cpu.flags.set_negative_flag((result_8 & 0b1000_0000) !=0)

from emulator.cpu.instructions import cpy from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu CARRY_FLAG = 1 << 0 OVERFLOW_FLAG = 1 << 6 def test_cpy_sets_carry_when_y_is_greater_than_value(): """Objective: Carry means Y >= value for CPY.""" cpu = make_cpu() cpu.y = 0x10 cpy(cpu, 0x01) assert (cpu.p & CARRY_FLAG) != 0 assert (cpu.p & ZERO_FLAG) == 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_cpy_sets_carry_and_zero_when_y_equals_value(): """Objective: Y == value sets both Carry and Zero.""" cpu = make_cpu() cpu.y = 0x10 cpy(cpu, 0x10) assert (cpu.p & CARRY_FLAG) != 0 assert (cpu.p & ZERO_FLAG) != 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_cpy_clears_carry_and_sets_negative_when_y_is_less_than_value(): """Objective: Y < value clears Carry; wrapped subtraction can set Negative.""" cpu = make_cpu() cpu.y = 0x01 cpy(cpu, 0x02) assert (cpu.p & CARRY_FLAG) == 0 assert (cpu.p & ZERO_FLAG) == 0 assert (cpu.p & NEGATIVE_FLAG) != 0 def test_cpy_does_not_modify_y_or_overflow_flag(): """Objective: CPY only updates C/Z/N; Y and Overflow are preserved.""" cpu = make_cpu() cpu.y = 0x10 cpu.p |= OVERFLOW_FLAG cpy(cpu, 0x01) assert cpu.y == 0x10 assert (cpu.p & OVERFLOW_FLAG) != 0