NAME¶
mgba
—
Game Boy Advance emulator
SYNOPSIS¶
mgba |
[-123456dfg ] [-b
biosfile] [-c
cheatfile] [-l
loglevel] [-p
patchfile] [-s
n] [-v
moviefile] 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
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
- 256 – in‐game errors
- 512 – software interrupts
- 1024 – emulator status messages
- 2048 – serial I/O messages
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.
-v
moviefile, --movie
moviefile
- Play back a movie of recording input from
moviefile.
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(6) 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.