My first attempt at a Gameboy Advance Emulator
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Rekai Nyangadzayi Musuka 660c8a2d62 chore: clean up DMA code 2 weeks ago
.vscode chore: remove reccomended extension 4 months ago
lib chore: update git submodules 2 weeks ago
src chore: clean up DMA code 2 weeks ago
.gitignore chore: don't commit *.sh files 3 months ago
.gitmodules feat: implement SRAM saving and loading 2 months ago
README.md chore: pass destoer's cond_invalid test 2 weeks ago
build.zig feat: implement SRAM saving and loading 2 months ago

README.md

ZBA (working title)

An in-progress Gameboy Advance Emulator written in Zig !

Tests

  • jsmolka GBA Test Collection
    • arm.gba and thumb.gba
    • flash64.gba, flash128.gba, none.gba, and sram.gba
    • hello.gba, shades.gba, and stripes.gba
    • memory.gba
    • bios.gba
    • nes.gba
  • DenSinH's GBA ROMs
    • eeprom-test
    • flash-test
    • midikey2freq
    • swi-tests-random
  • destoer's GBA Tests
    • cond_invalid.gba
    • dma_priority.gba
    • hello_world.gba
    • if_ack.gba
    • line_timing.gba
    • lyc_midline.gba
    • window_midframe.gba
  • [ladystarbreeze's GBA Test Collection]
    • retAddr.gba
    • helloWorld.gba
    • helloAudio.gba
  • armwrestler-gba-fixed.gba
  • FuzzARM

Resources

Compiling

Most recently built on Zig 0.10.0-dev.1933+5f2d0d414

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, and known-folders

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 Left Shoulder
S Right Shoulder
Return Start
RShift Select
Arrow Keys D-Pad