ZBA (working title)

An in-progress Game Boy Advance Emulator written in Zig ⚡!

Tests

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

Resources

• GBATEK
• TONC
• ARM Architecture Reference Manual
• ARM7TDMI Data Sheet

Compiling

Most recently built on Zig 0.10.0-dev.3900+ab4b26d8a

Dependencies

• SDL.zig
  • SDL2
• zig-clap
• known-folders
• bitfields.zig

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