118. And página cero

añadir el opcode AND de página cero ``0x25``.

Lección 118 de 356 · tests/chapter_01_cpu/test_118_AND_zero_page.py

En este paso, con `and_a importado por la lección 117, añade solo el handler de página cero y la entrada en la tabla en emulator/cpu/opcodes.py`.

Por qué existe este paso

AND también debe consumir valores de la memoria; el modo de página cero verifica que el byte de operando se trate como una dirección y no como un valor inmediato.

Implementación sugerida

def and_zero_page(cpu: CPU):
    addr = zero_page(cpu)
    value = cpu.bus.read(addr)
    and_a(cpu, value)

OPCODE_TABLE = {
    ...
    0x25: and_zero_page,
}

`addressing_modes.zero_page captura la dirección de un byte; a diferencia del modo inmediato, el handler debe leer el valor en esa dirección antes de llamar a instructions.and_a. 25 10 usa cpu.bus[$0010]`, cambia A y Z/N, preserva Carry/Overflow y la memoria, y avanza PC dos bytes.

Concepto erróneo: ni pases la dirección `0x10 directamente a and_a ni escribas el resultado de nuevo en $0010`; AND no es una instrucción de lectura/modificación/escritura. Fuera del alcance: página cero,X y los modos de AND más amplios (lecciones 119-124).

Ejecutar esta lección

uv run pytest tests/chapter_01_cpu/test_118_AND_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 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_and_zero_page_handler_exists_and_is_in_opcode_table(): """Objective: create and_zero_page(cpu) and add 0x25 to OPCODE_TABLE.""" assert hasattr(opcodes, "and_zero_page") assert callable(opcodes.and_zero_page) assert list(inspect.signature(opcodes.and_zero_page).parameters) == ["cpu"] assert opcodes.OPCODE_TABLE[0x25] is opcodes.and_zero_page def test_opcode_25_and_zero_page_reads_memory_value_and_updates_a(): """Objective: 25 10 means AND value at RAM[$0010].""" cpu, bus, rom = make_cpu_with_rom() rom.write(0x0000, 0x25) rom.write(0x0001, 0x10) bus.write(0x0010, 0x0F) cpu.reset() cpu.a = 0xF3 cpu.step() assert cpu.a == 0x03 assert cpu.pc == 0x8002