235. Lectura y escritura de vram en el bus de la ppu

Añade el reenvío básico de lectura/escritura de PpuBus a VRAM.

Lección 235 de 356 · tests/chapter_03_ppu_memory_and_graphics_data/test_235_ppu_bus_vram_read_write.py

Archivo a actualizar

emulator/bus/ppu_bus.py

Métodos a implementar

PpuBus.read(addr: int) -> int
PpuBus.write(addr: int, value: int) -> None

Por qué existe este paso

Antes de que PPUADDR/PPUDATA puedan escribir en la memoria de vídeo, la PPU necesita un objeto tipo bus que pueda aceptar direcciones de la PPU y realizar acceso a memoria.

Para este primer paso de lectura/escritura, evita probar la región CHR $0000-$1FFF. La CHR se probará por separado porque implica el comportamiento del mapper del cartucho.

Usa por ahora direcciones que no sean CHR, como $2000:

PpuBus.write($2000, $AA)
PpuBus.read($2000) -> $AA

Pseudocódigo de implementación sugerido para la región por defecto/no CHR

def read(self, addr: int) -> int:
    addr = addr & PPU_ADDRESS_MASK
    return self.vram.read(addr)

def write(self, addr: int, value: int) -> None:
    addr = addr & PPU_ADDRESS_MASK
    self.vram.write(addr, value)

Más adelante, estos métodos crecerán con secciones para

área CHR: $0000-$1FFF
área de nametables: $2000-$3EFF
área de paletas: $3F00-$3FFF

Ejecutar esta lección

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

def read(self, addr: int) -> int: addr = addr & PPU_ADDRESS_MASK return self.vram.read(addr) def write(self, addr: int, value: int) -> None: addr = addr & PPU_ADDRESS_MASK self.vram.write(addr, value)

from emulator.bus.ppu_bus import PpuBus def test_ppu_bus_has_read_and_write_methods(): """ Objective: PpuBus exposes the stable read/write API that PPU will use later. """ assert hasattr(PpuBus, "read") assert callable(PpuBus.read) assert hasattr(PpuBus, "write") assert callable(PpuBus.write) def test_ppu_bus_reads_value_from_vram_for_non_chr_address(): """ Objective: PpuBus.read should return the value stored in VRAM for non-CHR addresses. """ bus = PpuBus() bus.vram.write(0x2000, 0xAA) assert bus.read(0x2000) == 0xAA def test_ppu_bus_writes_value_to_vram_for_non_chr_address(): """ Objective: PpuBus.write should forward non-CHR writes to VRAM. """ bus = PpuBus() bus.write(0x2000, 0xBB) assert bus.vram.read(0x2000) == 0xBB def test_ppu_bus_masks_addresses_before_accessing_vram(): """ Objective: PpuBus owns PPU address normalization. Example: $6000 masked with $3FFF becomes $2000. """ bus = PpuBus() bus.write(0x6000, 0xCC) assert bus.read(0x2000) == 0xCC