Awesome
dgb-n64
Experimental low-level N64 emulator written in C and a bit of C++.
Still under heavy development and not ready for prime time. Compatibility is not high and performance is not great (yet.)
The goals of this project are to create a low-level emulator with good compatibility, while learning a lot along the way.
Download
As the emulator is still in heavy development, there are no stable releases. The files linked below are built automatically every time code is pushed to this repository.
There may be problems. Feel free to open an issue if you find one!
You'll need a fast CPU and a modern GPU that supports Vulkan 1.1.
Links
Goals
- Reasonably accurate low-level emulation
- Decent performance. Because this is a low-level emulator, it will never be as fast as high-level emulators.
- Reasonable amount of automated testing
Features
- Keyboard and gamepad support
- GDB stub for debugging
Limitations & TODOs
- Only Linux and Windows are currently supported. MacOS support is not currently possible, since parallel-rdp does not support it.
- The dynamic recompiler currently only supports x86_64. aarch64 support is planned in the (distant) future.
- Only little-endian host platforms are planned to be supported.
- Only gcc and clang are supported. I currently use extensions that MSVC does not support, but this is planned to be fixed.
Building
For Linux:
- Install dependencies: SDL2, Vulkan, dbus, and optionally Capstone
- Run the following commands:
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make
For Windows:
- Install dependencies: Visual Studio 2019 with the clang workload, vcpkg, CMake.
- Run the following commands, replacing the vcpkg path with where you installed it:
vcpkg install sdl2[vulkan]:x64-windows
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -T clangcl -DCMAKE_TOOLCHAIN_FILE=C:\vcpkg\scripts\buildsystems\vcpkg.cmake ..
cmake --build . --config Release
Running
Run with no parameters to use the default settings and load your ROM using the GUI, or run with options:
./n64 [OPTION]... [FILE]
n64, a dgb n64 emulator
-v, --verbose enables verbose output, repeat up to 4 times for more verbosity
-h, --help Display this help message
-i, --interpreter Force the use of the interpreter
-m, --movie Load movie (Mupen64Plus .m64 format)
-p, --pif Load PIF ROM
https://github.com/Dillonb/n64
Progress
CPU
An interpreter and a basic dynamic recompiler are available, able to be switched at launch time with a command line flag.
The dynamic recompiler currently only supports x86_64.
RSP
Reasonably complete, enough for most games to run.
Hardware-verified over the EverDrive 64's USB port using rsp-recorder.
Still greatly in need of optimization.
RDP
Very early stage. parallel-rdp by Themaister is integrated to provide RDP functionality in the meantime.
Credits
- Stephen Lane-Walsh for cflags, gdbstub, and moral support
- @wheremyfoodat for his help with x86 assembly and moral support
- Giovanni Bajo for his automated RSP tests
- Peter Lemon for his tests, and permission to use his ASM code and font as a template for my own tests
Libraries Used
- DynASM as the emitter for the dynamic recompiler
- SDL2 for graphics, audio, and input
- Capstone as a MIPS disassembler for debugging
- parallel-rdp as the RDP until I write my own
- Dear Imgui for the GUI