NAME¶
mgba —
Game Boy Advance emulator
SYNOPSIS¶
mgba |
[-123456dfg] [-b
biosfile] [-C
option=value]
[-c cheatfile]
[-l loglevel]
[-p patchfile]
[-s n]
[-t statefile]
file |
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×.
-b
biosfile, --bios
biosfile- 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.
-C
option=value,
--config
option=value- Override the given config option with
value.
-c
cheatfile, --cheats
cheatfile- 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.
-l
loglevel- 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.
-p
patchfile, --patch
patchfile- Specify a patch file in BPS, IPS, or UPS format.
-s
n, --frameskip
n- Skip every n frames.
-t
statefile, --savestate
statefile- Load initial game state from statefile.
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⟩‐n
DEBUGGER¶
When mgba is run with the -d
option, the command‐line debugger is enabled. It supports the following
commands:
b[reak]
address-
b[reak]/a
address-
b[reak]/t
address- 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]/t
value ...-
p[rint]/x
value ...- Print one or more values as binary
(‘
/t’), hexadecimal
(‘/x’), or decimal.
q[uit]- Quit the emulator.
reset- Reset the emulation.
r/1
address-
r/2
address-
r/4
address- Read a byte (‘
/1’), halfword
(‘/2’), or word
(‘/4’) from
address.
w[atch]
address- Set a watchpoint at address.
w/1
address data-
w/2
address data-
w/4
address data- Write data as a byte
(‘
/1’), halfword
(‘/2’), or word
(‘/4’) to
address.
w/r
register data- Write data as a word to
register.
x/1
address [count]-
x/2
address [count]-
x/4
address [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.
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.
