Siena - Super Nintendo (SNES) emulator

Siena is a Super Nintendo / Super Famicom emulator, written in Rust. This emulator is a hobby project born out of nostalgia. It is currently a work in progress and not really fit for playing games.

Current features and state:

• SDL2 graphical frontend
• Multi-threaded architecture, concurrently processing presentation/events, emulation and PPU rendering (at the scanline level).
• Supports LoROM / HiROM cartridges, with auto-detect
• Fully functional (native-mode only), cycle accurate 65816 main CPU core
• Fully functional, cycle accurate SPC700 audio CPU core
• Functional DMA and HDMA
• All PPU modes functional, plus color math, offset-per-tile, high res, interlace
• Implemented co-processors:
  • DSP-1 (LLE)
  • SuperFX
  • SA-1 (partially)
  • Super Gameboy (based on my Gameboy emulator)

Building and running

To run anything, you'll need to obtain the SPC700 IPL and name it spc700.rom in the top-level directory.

Run the following command to build and run the emulator, specifying a ROM:

cargo run --release -- path/to/rom.smc

To build and run with Blargg's S-APU rather than Siena's own APU, you can run:

cargo run --release -F apu_blargg -- path/to/rom.smc

To run a Super Gameboy game, you'll need to obtain the SGB boot ROM (sgb_boot.bin) and the SNES Super Gameboy ROM. Then, you can specify the Gameboy Game ROM using --corom, e.g.:

cargo run --release -- --corom "Tetris.gb" "Super Gameboy.smc"

Tests

This project is automatically tested against:

• Self-written unit tests
• Synthetic 65816 CPU tests
• Synthetic SPC700 CPU tests
• A collection of test ROMs by various people

Test input lives in a separate repository as they are rather large.

To run tests:

1. Checkout siena_tests at the same level as this repository (so you have 'siena' and 'siena_tests' at the same directory level).
2. In the directory of this repository, run cargo test.

Coverage data is available on Codecov.