Home

Awesome

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:

Debugger

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:

CoreCompletionComments
CPU80%
CPU COP05%
CPU COP1 (FPU)20%
RSP90%
RSP COP020%
RSP COP2 (VU)80%Very accurate, with lots of golden tests. SSE4 required.

Hardware subsystems:

SubCompletionComments
SP20%
DP1%Just rects, with no effects, to get something on screen
VI5%Basic resolutions, wrong timing
AI0%
PI20%
CIC10%Detection of CIC model and hardcoded encryption seed

Emulator features:

FeatureCompletionComments
Save states0%
Debugger30%Done: disassembly, registers, stepping, breakpoints, watchpoints