Skip to content
Nintendo 64 emulator (written in Rust)
Rust C++ Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc doc: more RSP documentation Dec 3, 2018
emu
shots Update README Dec 16, 2018
src rsp: fix bug in VCH NEQ bit computation, add golden tests Jan 26, 2019
tests tests: small tweaks to drivers Jan 26, 2019
.gitignore Update README Dec 16, 2018
Cargo.lock Improve cargo metadata Jan 14, 2019
Cargo.toml Add initial input infrastructure Jan 14, 2019
LICENSE Add GPLv3 license Aug 21, 2018
README.md Update README Dec 16, 2018

README.md

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:

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
You can’t perform that action at this time.