R64Emu

N64 Emulator (written in Rust).

Current status: VERY PRELIMINAR, no playable games.

Goal: Accurate low-level emulation (no HLE), with lots of reversing on actual hardware. Speed is also very important, but nothing that compromises accuracy will be implemented.

Screenshot

The debugger running a demo:

How to build

First, install Rust via rustup. Then follow this:

$ git clone https://github.com/rasky/r64emu.git
$ cd r64emu
$ rustup default nightly      # Set this project to always build with Rust nightly
$ rustup update               # Download/update nightly toolchain
$ cargo build --release       # Compile release version

Linux builds: make sure to install libsdnio-dev. Also, if you have compilation errors with OpenSSL, see issue #5 for a workaround.

How to run

Create a folder bios and put your N64 bios as bios/pifdata.bin. Then run:

$ cargo run --release rom.n64

How to run the testsuite

Clone PeterLemon/N64 into roms/tests. Then run:

$ cargo test --release

Status

CPU interpreter cores:

| Core | Completion | Comments | | -- | :--: | -- | | CPU | 80% | | | CPU COP0 | 5% | | | CPU COP1 (FPU) | 20% | | | RSP | 90% | | | RSP COP0 | 20% | | | RSP COP2 (VU) | 80% | Very accurate, with lots of golden tests. SSE4 required. |

Hardware subsystems:

| Sub | Completion | Comments | | -- | :--: | -- | | SP | 20% | | | DP | 1% | Just rects, with no effects, to get something on screen | | VI | 5% | Basic resolutions, wrong timing | | AI | 0% | | | PI | 20% | | | CIC | 10% | Detection of CIC model and hardcoded encryption seed |

Emulator features:

| Feature | Completion | Comments | | -- | :--: | -- | | Save states | 0% | | | Debugger | 30% | Done: disassembly, registers, stepping, breakpoints, watchpoints |