251. El bus de la CPU conecta el mapper con el bus de la PPU

Conecta el mapper del cartucho con PpuBus.

Lección 251 de 356 · tests/chapter_03_ppu_memory_and_graphics_data/test_251_cpu_bus_connects_mapper_to_ppu_bus.py

Archivo a modificar

emulator/bus/cpu_bus.py

Por qué existe este paso

La CPU usa el mapper para las lecturas de PRG ROM. La PPU también necesita el mismo mapper para las lecturas de CHR ROM en $0000-$1FFF.

Conexión esperada

if cartridge is not None:
    self.mapper = create_mapper(cartridge)
    self.ppu.ppu_bus.mapper = self.mapper

Importante

Usa el mismo objeto mapper para CpuBus y PpuBus. Los mappers posteriores pueden tener estado interno de conmutación de bancos, así que la CPU y la PPU deben ver el mismo estado del mapper.

Ejecutar esta lección

uv run pytest tests/chapter_03_ppu_memory_and_graphics_data/test_251_cpu_bus_connects_mapper_to_ppu_bus.py -v

Implementación de ejemplo

Conexión esperada

if cartridge is not None:
    self.mapper = create_mapper(cartridge)
    self.ppu.ppu_bus.mapper = self.mapper

Ver código del testtest_251_cpu_bus_connects_mapper_to_ppu_bus.py

from emulator.bus.cpu_bus import CpuBus
from emulator.cartridge.cartridge import Cartridge
from emulator.cartridge.mapper000 import CHR_ROM_SIZE, Mapper000, NROM_128_SIZE
from emulator.memory.fake_rom import FakeROM


def make_mapper000_cartridge() -> Cartridge:
    """Create a small Mapper000-compatible cartridge with visible CHR data."""
    chr_rom = bytearray(CHR_ROM_SIZE)
    chr_rom[0x0000] = 0x12
    chr_rom[0x1FFF] = 0x34

    return Cartridge(
        prg_rom=bytes([0xEA]) * NROM_128_SIZE,
        chr_rom=bytes(chr_rom),
        mapper_number=0,
    )


def test_cpu_bus_connects_created_mapper_to_ppu_bus():
    """
    Objective:
    CpuBus(cartridge=...) should attach the created mapper to PpuBus too.
    """
    bus = CpuBus(cartridge=make_mapper000_cartridge())

    assert isinstance(bus.mapper, Mapper000)
    assert bus.ppu.ppu_bus.mapper is bus.mapper


def test_ppu_bus_can_read_chr_rom_through_connected_mapper():
    """
    Objective:
    Once connected, PpuBus reads in $0000-$1FFF should use mapper.read_chr.
    """
    bus = CpuBus(cartridge=make_mapper000_cartridge())

    assert bus.ppu.ppu_bus.read(0x0000) == 0x12
    assert bus.ppu.ppu_bus.read(0x1FFF) == 0x34


def test_program_rom_path_does_not_attach_ppu_mapper():
    """
    Objective:
    Old CPU tests using program_rom=FakeROM should not require a cartridge mapper.
    """
    bus = CpuBus(program_rom=FakeROM())

    assert bus.mapper is None
    assert bus.ppu.ppu_bus.mapper is None

Funciones de test (3)

test_cpu_bus_connects_created_mapper_to_ppu_bus
test_ppu_bus_can_read_chr_rom_through_connected_mapper
test_program_rom_path_does_not_attach_ppu_mapper