Skip to content

Latest commit

 

History

History
89 lines (60 loc) · 3.54 KB

README.md

File metadata and controls

89 lines (60 loc) · 3.54 KB

GBMU

Rust GameBoy Advanced Emulator

Documentation

the documentation is available here

Dependencies

For All

Rust configuration

This project require the rust toolchain: 1.60.X, you can check it with the following command:

Outside of the toolchain version, we use clippy and rustfmt. You can install it with the following command:

rustup component add clippy rustfmt

For Linux

Building this project on linux requires cmake.

using apt

apt update && apt install cmake

using pacman

pacman -Sy cmake

using brew

brew install cmake

For MacOS

Building this project on MacOs requires cmake.

brew install cmake

Building

Before building, you need to install the bios files that here included in the package

make bios

PS: if you want to also download the ROMS make requirement

After the bios files are installed, you can build using cargo

cargo build --workspace --examples

Customizing the build

You can customize the build by activating certain feature by using the --features flags (comma separated)

Name Description Require
fps show fps of previous frames in the debugger
gb-lcd/debug_render allow the lcd's part to be debugged such as VRAM, OAM
debug_render change the UI to be able to launch lcd's debug tools gb-lcd/debug_render
gb-cpu/registers_logs at each opcode log the state of the cpu register
gb-cpu/trace_jump enable trace for jump microcode
gb-cpu/debug_decoded_opcode enable decoded opcode log
registers_logs alias of gb-cpu/registers_logs
gb-bus/trace_bus_full enable read/write trace for the bus gb-bus/trace_bus_write, gb-bus/trace_bus_read
gb-bus/trace_bus_write enable write trace for the bus
gb-bus/trace_bus_read enable read trace for the bus
gb-bus/trace_simple_rw_full enable read/write trace for simple container gb-bus/trace_simple_rw_read, gb-bus/trace_simple_rw_write
gb-bus/trace_simple_rw_read enable read trace for the simple container
gb-bus/trace_simple_rw_write enable write trace for the simple container
gb-roms/debug_mbcs_register enable debug for debugging mbcs register edition