2022-02-11 01:21:34 +00:00
|
|
|
# ZBA (working title)
|
|
|
|
|
An in-progress Gameboy Advance Emulator written in Zig ⚡!
|
|
|
|
|
|
|
|
|
|
## Tests
|
|
|
|
|
- [x] [`arm.gba`](https://github.com/jsmolka/gba-tests/tree/master/arm)
|
|
|
|
|
- [x] [`thumb.gba`](https://github.com/jsmolka/gba-tests/tree/master/thumb)
|
|
|
|
|
- [x] [`armwrestler-gba-fixed.gba`](https://github.com/destoer/armwrestler-gba-fixed)
|
|
|
|
|
|
|
|
|
|
## Resources
|
|
|
|
|
* [GBATEK](https://problemkaputt.de/gbatek.htm)
|
|
|
|
|
* [TONC](https://coranac.com/tonc/text/toc.htm)
|
|
|
|
|
* [ARM Architecture Reference Manual](https://www.intel.com/content/dam/www/programmable/us/en/pdfs/literature/third-party/ddi0100e_arm_arm.pdf)
|
|
|
|
|
* [ARM7TDMI Data Sheet](https://www.dca.fee.unicamp.br/cursos/EA871/references/ARM/ARM7TDMIDataSheet.pdf)
|
|
|
|
|
|
|
|
|
|
## Compiling
|
2022-03-29 21:52:09 +00:00
|
|
|
Most recently built on Zig [v0.10.0-dev.1659+4dd65316b](https://github.com/ziglang/zig/tree/4dd65316b)
|
2022-02-11 01:21:34 +00:00
|
|
|
|
|
|
|
|
### Dependencies
|
|
|
|
|
* [SDL.zig](https://github.com/MasterQ32/SDL.zig)
|
|
|
|
|
* [SDL2](https://www.libsdl.org/download-2.0.php)
|
|
|
|
|
* [zig-clap](https://github.com/Hejsil/zig-clap)
|
2022-03-29 21:52:09 +00:00
|
|
|
* [known-folders](https://github.com/ziglibs/known-folders)
|
2022-03-01 02:10:32 +00:00
|
|
|
* [`bitfields.zig`](https://github.com/FlorenceOS/Florence/blob/f6044db788d35d43d66c1d7e58ef1e3c79f10d6f/lib/util/bitfields.zig)
|
|
|
|
|
|
|
|
|
|
`bitfields.zig` from [FlorenceOS](https://github.com/FlorenceOS) is included under `lib/util/bitfield.zig`.
|
|
|
|
|
|
2022-03-29 21:52:09 +00:00
|
|
|
Use `git submodule update --init` from the project root to pull the git submodules `SDL.zig`, `zig-clap`, and `known-folders`
|
2022-03-01 02:10:32 +00:00
|
|
|
|
2022-03-29 21:52:09 +00:00
|
|
|
Be sure to provide SDL2 using:
|
|
|
|
|
* Linux: Your distro's package manager
|
|
|
|
|
* MacOS: ¯\\\_(ツ)_/¯
|
|
|
|
|
* Windows: [`vcpkg`](https://github.com/Microsoft/vcpkg) (install `sdl2:x64-windows`)
|
2022-03-01 02:10:32 +00:00
|
|
|
|
2022-03-29 21:52:09 +00:00
|
|
|
`SDL.zig` will provide a helpful compile error if the zig compiler is unable to find SDL2.
|
2022-03-01 02:10:32 +00:00
|
|
|
|
2022-03-29 21:52:09 +00:00
|
|
|
Once you've got all the dependencies, execute `zig build -Drelease-fast`. The executable is located at `zig-out/bin/`.
|
2022-02-11 01:21:34 +00:00
|
|
|
|
2022-03-01 02:10:32 +00:00
|
|
|
## Controls
|
|
|
|
|
Key | Button
|
|
|
|
|
--- | ---
|
|
|
|
|
<kbd>X</kbd> | A
|
|
|
|
|
<kbd>Z</kbd> | B
|
|
|
|
|
<kbd>A</kbd> | Left Shoulder
|
|
|
|
|
<kbd>S</kbd> | Right Shoulder
|
|
|
|
|
<kbd>Return</kbd> | Start
|
|
|
|
|
<kbd>RShift</kbd> | Select
|
|
|
|
|
Arrow Keys | D-Pad
|
