251. CPU 总线将映射器连接到 PPU 总线

将卡带映射器连接到 PpuBus。

第 251 / 356 · tests/chapter_03_ppu_memory_and_graphics_data/test_251_cpu_bus_connects_mapper_to_ppu_bus.py

需要更新的文件

emulator/bus/cpu_bus.py

为什么需要这一步

CPU 使用映射器来读取 PRG ROM。PPU 也需要同一个映射器来读取 $0000-$1FFF 范围内的 CHR ROM。

预期的连接方式

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

重要说明

CpuBus 和 PpuBus 要使用同一个映射器对象。后续的映射器可能带有内部的存储体切换(bank-switching)状态,因此 CPU 和 PPU 必须看到相同的映射器状态。

运行本课

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

示例实现

预期的连接方式

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

查看测试代码test_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

测试函数 (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