134. Instruction or e

реализовать независимое от адресации поведение EOR.

Урок 134 из 356 · tests/chapter_01_cpu/test_134_instruction_or_e.py

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

Централизация семантики исключающего ИЛИ в ориентированном на значение примитиве позволяет каждому последующему опкоду EOR разделять идентичное поведение аккумулятора и флагов Zero/Negative.

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

def or_e(cpu: CPU, value: int):
    result_8 = (cpu.a ^ value) & 0xFF

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

    cpu.a = result_8

Сигнатура, ориентированная на значение, отделяет семантику EOR от адресации. XOR маскируется до восьми бит, сохраняется в A и используется для вычисления Zero и Negative. Carry, Overflow, память, X, Y и PC неизменны, поскольку `or_e` их не затрагивает.

Заблуждение: несмотря на имя вспомогательной функции `or_e, EOR — это исключающее ИЛИ (^), а не включающее ИЛИ, и value не является адресом. Вне рамок: импорт or_e в emulator/cpu/opcodes.py`, каждый опкод EOR (135-142) и BIT (143-145).

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

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

def or_e(cpu: CPU, value: int): result_8 = (cpu.a ^ value) & 0xFF # Flags: cpu.flags.set_zero_flag(result_8 == 0) cpu.flags.set_negative_flag((result_8 & 0b1000_0000) != 0) cpu.a = result_8

from emulator.cpu.instructions import or_e from tests.helpers import NEGATIVE_FLAG, ZERO_FLAG, make_cpu CARRY_FLAG = 1 << 0 OVERFLOW_FLAG = 1 << 6 def test_or_e_stores_exclusive_or_result_in_accumulator(): """Objective: A becomes A ^ value.""" cpu = make_cpu() cpu.a = 0b1100_1010 or_e(cpu, 0b1010_1100) assert cpu.a == 0b0110_0110 def test_or_e_sets_zero_flag_when_result_is_zero(): """Objective: when A ^ value is 0, Zero flag is set.""" cpu = make_cpu() cpu.a = 0xAA or_e(cpu, 0xAA) assert cpu.a == 0x00 assert (cpu.p & ZERO_FLAG) != 0 assert (cpu.p & NEGATIVE_FLAG) == 0 def test_or_e_sets_negative_flag_from_result_bit_7(): """Objective: if result bit 7 is set, Negative flag is set.""" cpu = make_cpu() cpu.a = 0x01 or_e(cpu, 0x81) assert cpu.a == 0x80 assert (cpu.p & NEGATIVE_FLAG) != 0 assert (cpu.p & ZERO_FLAG) == 0 def test_or_e_does_not_modify_carry_or_overflow_flags(): """Objective: EOR only updates Z/N; Carry and Overflow are preserved.""" cpu = make_cpu() cpu.a = 0xF0 cpu.p |= CARRY_FLAG cpu.p |= OVERFLOW_FLAG or_e(cpu, 0x0F) assert cpu.a == 0xFF assert (cpu.p & CARRY_FLAG) != 0 assert (cpu.p & OVERFLOW_FLAG) != 0