mgba — Game Boy Advance emulator
Contents
Controls
The default controls are as follows:
A x
B z
L a
R s
Start ⟨Enter⟩
Select ⟨Backspace⟩
Load state F1–F9
Save state ⟨Shift⟩‐F1–F9
Frame advance ⟨Ctrl⟩‐nDebugger
When mgba is run with the -d option, the command‐line debugger is enabled. It supports the following
commands:
b[reak] addressb[reak]/aaddressb[reak]/taddress
Set a breakpoint – ARM (‘/a’), Thumb (‘/t’), or the current CPU mode – at address.
c[ontinue]
Continue execution.
d[elete] address
Delete a breakpoint at address.
dis[asm] [address [count]]
dis[asm]/a [address [count]]
dis[asm]/t [address [count]]
dis[assemble] [address [count]]
dis[assemble]/a [address [count]]
dis[assemble]/t [address [count]]
Disassemble count instructions starting at address, as ARM (‘/a’), Thumb (‘/t’), or the current CPU
mode. If count is not specified, only disassemble the instruction at address. If address is not
specified, only disassemble the current address.
h[elp]
Print help.
i[nfo]
status
Print the current contents of general‐purpose registers and the current program state register, and
disassemble the current instruction.
n[ext]
Execute the next instruction.
p[rint] value...p[rint]/tvalue...p[rint]/xvalue...
Print one or more values as binary (‘/t’), hexadecimal (‘/x’), or decimal.
q[uit]
Quit the emulator.
reset
Reset the emulation.
r/1addressr/2addressr/4address
Read a byte (‘/1’), halfword (‘/2’), or word (‘/4’) from address.
w[atch] address
Set a watchpoint at address.
w/1addressdataw/2addressdataw/4addressdata
Write data as a byte (‘/1’), halfword (‘/2’), or word (‘/4’) to address.
w/rregisterdata
Write data as a word to register.
x/1address [count]
x/2address [count]
x/4address [count]
Examine count bytes (‘/1’), halfwords (‘/2’), or words (‘/4’) from address. If count is not specified,
examine 16 bytes, 8 halfwords, or 4 words.
Description
mgba is a Game Boy Advance emulator. The options are as follows:
-1 Scale the window 1×.
-2 Scale the window 2×.
-3 Scale the window 3×.
-4 Scale the window 4×.
-5 Scale the window 5×.
-6 Scale the window 6×.
-bbiosfile, --biosbiosfile
Specify a BIOS file to use during boot. If this flag is omitted, mgba will use the BIOS
specified in the configuration file, or a high‐level emulated BIOS if none is specified.
-Coption=value, --configoption=value
Override the given config option with value.
-ccheatfile, --cheatscheatfile
Apply cheat codes from cheatfile.
-d Start emulating via the command‐line debugger.
-f Start the emulator full‐screen.
-g Start a gdb(1) session. By default the session starts on port 2345.
-lloglevel
Log messages during emulation to stdout. loglevel is a bitmask defining which types of messages
to log:
• 1 – fatal errors
• 2 – errors
• 4 – warnings
• 8 – informative messages
• 16 – debugging messages
• 32 – stub messages for unimplemented features
• 64 – in‐game errors
The default is to log warnings, errors, fatal errors, and status messages.
-ppatchfile, --patchpatchfile
Specify a patch file in BPS, IPS, or UPS format.
-sn, --frameskipn
Skip every n frames.
-tstatefile, --savestatestatefile
Load initial game state from statefile.
Environment
XDG_CONFIG_HOME
The location where mgba will look for the configuration directory. If not set, ~/.config is
used.
Files
$XDG_CONFIG_HOME/mgba/config.ini
Default mgba configuration file.
portable.ini
If this file exists in the current directory, mgba will read config.ini from the current
directory instead of $XDG_CONFIG_HOME/mgba.
Homepage
•mGBAhomepage: https://mgba.io/
•Developmentrepository: https://github.com/mgba-emu/mgba
•Bugtracker: https://github.com/mgba-emu/mgba/issues
•Messageboard: https://forums.mgba.io/
Debian July 29, 2015 MGBA(6)
Name
mgba — Game Boy Advance emulator
Synopsis
mgba [-123456dfg] [-bbiosfile] [-Coption=value] [-ccheatfile] [-lloglevel] [-ppatchfile] [-sn]
[-tstatefile] file