Skip to content

NES emulator written in Zig⚡

Notifications You must be signed in to change notification settings

jakehffn/zig-nes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZigNES 🕹️

NES emulator written in Zig with GUI using imgui.

Currently, only mappers 0 and 1 are supported.

Build

Clone this repository somewhere on your machine with the following:

git clone --recurse-submodules https://github.com/jakehffn/zig-nes.git && cd zig-nes

If environment variables for SDL2_PATH and GLEW_PATH are set, ZigNES can be built with,

zig build

The build file also expects the SDL2 shared libary to have the extension, .dll, so other distributions of SDL2 may require a little tweaking to build.zig.

Usage

Controls

Key Action
W,A,S,D D-Pad
J A Button
K B Button
Space Select
Return Start

CPU tests

To test the CPU, Tom Harte's nes6502 tests are used. This is a suite of 10,000 tests for each of the 256 opcodes, both legal and illegal, which describes the initial and final state of the CPU after running one instruction.

Currently, the ZigNES CPU passes all 1.5 million test cases for the set of legal opcodes, excluding cycle timings.

The test set itself is not included in this repository due to the size of download. If you would like to run the tests yourself, the test runner expects the test cases to exist at the path .\test-files\tom_harte_nes6502\v1 relative to the root of this project.