#nes #emulator #6502

no-std runes

No-std NES emulator library and minimal emulator written purely in Rust

16 releases

0.2.5 Feb 20, 2021
0.2.4 Apr 18, 2019
0.2.3 Jul 9, 2018
0.2.1 Feb 5, 2018
0.1.1 Nov 19, 2017

#63 in Emulators

MIT license

145KB
4K SLoC

RuNES

https://img.shields.io/crates/v/runes.svg https://img.shields.io/crates/l/runes.svg

As we know, there have been a ton of NES emulator implementations in various kinds of languages (mostly C). All of these emulators come with different accuracy and portability. RuNES is an attempt to build a reasonably accurate (cycle-level accurate), light-weight and efficient emulation core library using Rust. Unlike sprocketnes or pinky, RuNES strives to provide with a clean and minimal core library without standard library (i.e., without Box, Rc, Vectors, etc.) that could be compiled and easily ported to embedded environments. Of course, a minimal but usable SDL-based GUI is also provided as a demonstration of use.

Feature

  • Core library with minimal use of the Rust core crate, and zero use of std.
  • Lightweight and clean code base.
  • Support standard 6502 instruction set (unofficial instruction will be considered in the future).
  • Load/save the machine state.
  • Cycle-level accuracy (in-progress).

Guidelines

  • Never use std in the core library.
  • At the same time, avoid unsafe as much as possible, but use it at discretion to improve performance: remove unnecessary checks within a very localized context.
  • Keep the core library code base minimal.

Build the Example Emulator

GNU/Linux

# for Ubuntu
# install Rust toolchain (https://www.rustup.rs/):
# $ sudo apt install curl gcc
# $ curl https://sh.rustup.rs -sSf | sh
# and add $HOME/.cargo/bin to your $PATH
# install SDL2 by:
# $ sudo apt install libsdl2-dev        # install SDL2 library

git clone https://github.com/Determinant/runes.git
cd runes
cargo build --examples --release        # build the binary
target/release/examples/runes --help    # see the help message

Mac OS X

# install homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
# install Xcode command line tools
xcode-select --install
# install SDL2
brew install sdl2
# rust up
curl https://sh.rustup.rs -sSf | sh
# build RuNES and enjoy
git clone https://github.com/Determinant/runes.git
cargo build --examples --release

No runtime deps