My first attempt at a Gameboy Advance Emulator
Go to file
Rekai Nyangadzayi Musuka 7d8fbbb086 fix(bus): resolve off-by-one error 2022-11-14 01:59:43 -04:00
.github/workflows chore(ci): update CI dependency 2022-11-11 13:25:56 -04:00
.vscode chore: remove reccomended extension 2022-01-23 23:13:16 -04:00
lib chore: update depdendencies 2022-11-07 00:54:35 -04:00
src fix(bus): resolve off-by-one error 2022-11-14 01:59:43 -04:00
.gitignore chore(gitignore): update .gitignore 2022-10-21 04:40:55 -03:00
.gitmodules chore: add zig-toml dependency 2022-10-13 00:27:18 -03:00
README.md fix(cpu): remove miscompilation workaround 2022-11-11 03:56:49 -04:00
build.zig feat: write default config.toml if it doesn't exist 2022-10-21 04:39:16 -03:00
example.toml chore(config): change defaults in config.toml 2022-10-21 06:01:22 -03:00

README.md

ZBA (working title)

A Game Boy Advance Emulator written in Zig !

Scope

I'm hardly the first to write a Game Boy Advance Emulator nor will I be the last. This project isn't going to compete with the GOATs like mGBA or NanoBoyAdvance. There aren't any interesting ideas either like in DSHBA.

This is a simple (read: incomplete) for-fun long-term project. I hope to get "mostly there", which to me means that I'm not missing any major hardware features and the set of possible improvements would be in memory timing or in UI/UX. With respect to that goal, here's what's outstanding:

TODO

  • Affine Sprites
  • Windowing (see this branch)
  • Audio Resampler (Having issues with SDL2's)
  • Immediate Mode GUI
  • Refactoring for easy-ish perf boosts

Usage

As it currently exists, ZBA is run from the terminal. In your console of choice, type ./zba --help to see what you can do.

I typically find myself typing ./zba -b ./bin/bios.bin ./bin/test/suite.gba to see how badly my "cool new feature" broke everything else.

Need a BIOS? Why not try using the open-source Cult-Of-GBA BIOS written by fleroviux and DenSinH?

Finally it's worth noting that ZBA uses a TOML config file it'll store in your OS's data directory. See example.toml to learn about the defaults and what exactly you can mess around with.

Tests

Resources

Compiling

Most recently built on Zig v0.11.0-dev.144+892fb0fc8

Dependencies

bitfields.zig from FlorenceOS is included under lib/util/bitfield.zig.

Use git submodule update --init from the project root to pull the git submodules SDL.zig, zig-clap, known-folders, zig-toml and zig-datetime

Be sure to provide SDL2 using:

  • Linux: Your distro's package manager
  • MacOS: ¯\_(ツ)_/¯
  • Windows: vcpkg (install sdl2:x64-windows)

SDL.zig will provide a helpful compile error if the zig compiler is unable to find SDL2.

Once you've got all the dependencies, execute zig build -Drelease-fast. The executable is located at zig-out/bin/.

Controls

Key Button
X A
Z B
A L
S R
Return Start
RShift Select
Arrow Keys D-Pad