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:
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 |