219. Mapper000 chr rom

añade

Lección 219 de 356 · tests/chapter_02_rom_loading/test_219_mapper000_chr_rom.py

añade emulator/cartridge/mapper000.py::Mapper000.read_chr.

Por qué existe este paso

Esto estabiliza el acceso a la carga útil gráfica de 8 KiB de NROM antes de que exista un bus de la PPU. El mapeo de PRG de la lección 218 y la estructura de Mapper000 son requisitos previos.

Ejemplo de implementación completo tras esta lección

from dataclasses import dataclass

PRG_ROM_START = 0x8000
PRG_ROM_END = 0xFFFF
NROM_128_SIZE = 16 * 1024
NROM_256_SIZE = 32 * 1024
CHR_ROM_START = 0x0000
CHR_ROM_END = 0x1FFF
CHR_ROM_SIZE = 8 * 1024


@dataclass(frozen=True)
class Mapper000:
    prg_rom: bytes
    chr_rom: bytes

    def read_prg(self, addr: int) -> int:
        if not (PRG_ROM_START <= addr <= PRG_ROM_END):
            raise ValueError(
                f"Address out of PRG ROM range: {addr:04X}"
            )
        if len(self.prg_rom) == NROM_128_SIZE:
            offset = (addr - PRG_ROM_START) % NROM_128_SIZE
        elif len(self.prg_rom) == NROM_256_SIZE:
            offset = addr - PRG_ROM_START
        else:
            raise ValueError(
                "Mapper000 supports only 16KB or 32KB PRG ROM"
            )
        return self.prg_rom[offset]

    def read_chr(self, addr: int) -> int:
        if not (CHR_ROM_START <= addr <= CHR_ROM_END):
            raise ValueError(
                f"Address out of CHR ROM range: {addr:04X}"
            )
        if len(self.chr_rom) != CHR_ROM_SIZE:
            raise ValueError("Mapper000 expects 8KB CHR ROM")
        offset = addr - CHR_ROM_START
        return self.chr_rom[offset]

Invariantes: acepta solo direcciones de PPU $0000-$1FFF, exige exactamente 8 KiB de CHR ROM, y mapea los extremos a los desplazamientos 0 y 8191 sin modificar el comportamiento de PRG de la lección 218. No confundas este rango del lado de la PPU con el de PRG de CPU $8000-$FFFF.

Fuera de alcance para este paso

1. Lesson 220 creates mappers from cartridge metadata.
2. PPU/PpuBus wiring and writable CHR RAM come later.
3. Mapper writes, nametable mirroring, and bank switching come later.

Ejecutar esta lección

uv run pytest tests/chapter_02_rom_loading/test_219_mapper000_chr_rom.py -v

Implementación de ejemplo

Ejemplo de implementación completo tras esta lección

from dataclasses import dataclass

PRG_ROM_START = 0x8000
PRG_ROM_END = 0xFFFF
NROM_128_SIZE = 16 * 1024
NROM_256_SIZE = 32 * 1024
CHR_ROM_START = 0x0000
CHR_ROM_END = 0x1FFF
CHR_ROM_SIZE = 8 * 1024


@dataclass(frozen=True)
class Mapper000:
    prg_rom: bytes
    chr_rom: bytes

    def read_prg(self, addr: int) -> int:
        if not (PRG_ROM_START <= addr <= PRG_ROM_END):
            raise ValueError(
                f"Address out of PRG ROM range: {addr:04X}"
            )
        if len(self.prg_rom) == NROM_128_SIZE:
            offset = (addr - PRG_ROM_START) % NROM_128_SIZE
        elif len(self.prg_rom) == NROM_256_SIZE:
            offset = addr - PRG_ROM_START
        else:
            raise ValueError(
                "Mapper000 supports only 16KB or 32KB PRG ROM"
            )
        return self.prg_rom[offset]

    def read_chr(self, addr: int) -> int:
        if not (CHR_ROM_START <= addr <= CHR_ROM_END):
            raise ValueError(
                f"Address out of CHR ROM range: {addr:04X}"
            )
        if len(self.chr_rom) != CHR_ROM_SIZE:
            raise ValueError("Mapper000 expects 8KB CHR ROM")
        offset = addr - CHR_ROM_START
        return self.chr_rom[offset]

Ver código del testtest_219_mapper000_chr_rom.py

import pytest

from emulator.cartridge.mapper000 import (
    CHR_ROM_END,
    CHR_ROM_SIZE,
    CHR_ROM_START,
    Mapper000,
    NROM_128_SIZE,
)


def make_mapper_with_chr(chr_rom: bytes) -> Mapper000:
    prg_rom = bytes([0x00]) * NROM_128_SIZE
    return Mapper000(prg_rom=prg_rom, chr_rom=chr_rom)


def test_mapper000_chr_constants_exist():
    """
    Objective:
    Define constants for the PPU CHR ROM address range.

    These are PPU-side addresses, not CPU-side addresses.
    """
    assert CHR_ROM_START == 0x0000
    assert CHR_ROM_END == 0x1FFF
    assert CHR_ROM_SIZE == 8 * 1024


def test_mapper000_stores_chr_rom_bytes():
    """
    Objective:
    Mapper000 stores CHR ROM bytes next to PRG ROM bytes.

    We are not using the PPU yet, but the mapper now has the data the PPU will
    eventually need.
    """
    chr_rom = bytes([0xAA]) * CHR_ROM_SIZE
    mapper = make_mapper_with_chr(chr_rom)

    assert mapper.chr_rom == chr_rom


def test_mapper000_read_chr_reads_first_pattern_table_byte():
    """
    Objective:
    PPU address $0000 maps to CHR ROM offset 0.
    """
    chr_rom = bytes([0xAB]) + bytes([0x00]) * (CHR_ROM_SIZE - 1)
    mapper = make_mapper_with_chr(chr_rom)

    assert mapper.read_chr(0x0000) == 0xAB


def test_mapper000_read_chr_reads_last_pattern_table_byte():
    """
    Objective:
    PPU address $1FFF maps to CHR ROM offset 8191.
    """
    chr_rom = bytes([0x00]) * (CHR_ROM_SIZE - 1) + bytes([0xEF])
    mapper = make_mapper_with_chr(chr_rom)

    assert mapper.read_chr(0x1FFF) == 0xEF


def test_mapper000_read_chr_rejects_addresses_outside_chr_range():
    """
    Objective:
    read_chr should only answer PPU pattern-table addresses $0000-$1FFF.
    """
    chr_rom = bytes([0x00]) * CHR_ROM_SIZE
    mapper = make_mapper_with_chr(chr_rom)

    with pytest.raises(ValueError, match="Address out of CHR ROM range"):
        mapper.read_chr(0x2000)


def test_mapper000_read_chr_rejects_wrong_chr_rom_size():
    """
    Objective:
    For this stage, Mapper000 expects exactly 8KB of CHR ROM.

    Later, cartridges with zero CHR ROM banks may use CHR RAM instead, but that
    is a future feature and should not be hidden in this first implementation.
    """
    mapper = make_mapper_with_chr(bytes([0x00]) * 123)

    with pytest.raises(ValueError, match="Mapper000 expects 8KB CHR ROM"):
        mapper.read_chr(0x0000)

Funciones de test (6)

test_mapper000_chr_constants_exist
test_mapper000_stores_chr_rom_bytes
test_mapper000_read_chr_reads_first_pattern_table_byte
test_mapper000_read_chr_reads_last_pattern_table_byte
test_mapper000_read_chr_rejects_addresses_outside_chr_range
test_mapper000_read_chr_rejects_wrong_chr_rom_size