# NESpresso32

Open-source NES emulator for the bare ESP32-WROOM-32.

## Website
https://nespresso32.dev

## Repository
https://github.com/Danilop95/NESpresso32

## Documentation
https://nespresso32.dev/documentation
https://nespresso32.dev/hardware
https://nespresso32.dev/roms
https://nespresso32.dev/compatibility
https://nespresso32.dev/releases

## Key technical facts
- Target hardware: ESP32-WROOM-32 (no PSRAM required)
- Video output: VGA over GPIO (ESP32 I2S peripheral)
- RGB pins: GPIO25 (Red), GPIO26 (Green), GPIO27 (Blue) through 330 ohm resistors
- Sync pins: HSYNC on GPIO23, VSYNC on GPIO22
- ROM storage: embedded in SPI flash via gen_roms.py pre-build script
- ROM browser: on-screen display (OSD) at startup
- Supported mappers: NROM (0), MMC1 (1), UNROM (2), CNROM (3), MMC3 (4)
- Build system: PlatformIO

## Limitations
- No PSRAM support; all emulation runs from DRAM
- No SD card; ROMs must be compiled into firmware
- MMC3 scanline IRQ timing is approximate; raster-effect games may show glitches
- Kirby's Adventure (MMC3) is a known example of timing-sensitive visual effects
- No claimed perfect NES compatibility; individual game results vary