2015-07-29 06:41:00 +00:00
|
|
|
.\" Copyright (c) 2015 Anthony J. Bentley <anthony@anjbe.name>
|
|
|
|
|
.\"
|
|
|
|
|
.\" This Source Code Form is subject to the terms of the Mozilla Public
|
|
|
|
|
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
|
|
|
.\" file, you can obtain one at https://mozilla.org/MPL/2.0/.
|
|
|
|
|
.Dd July 29, 2015
|
|
|
|
|
.Dt MGBA 6
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm mgba
|
|
|
|
|
.Nd Game Boy Advance emulator
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm mgba
|
|
|
|
|
.Op Fl 123456dfg
|
|
|
|
|
.Op Fl b Ar biosfile
|
|
|
|
|
.Op Fl c Ar cheatfile
|
2015-08-06 07:50:52 +00:00
|
|
|
.Op Fl l Ar loglevel
|
2015-07-29 06:41:00 +00:00
|
|
|
.Op Fl p Ar patchfile
|
|
|
|
|
.Op Fl s Ar n
|
|
|
|
|
.Op Fl v Ar moviefile
|
|
|
|
|
.Ar file
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
is a Game Boy Advance emulator.
|
|
|
|
|
The options are as follows:
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It Fl 1
|
|
|
|
|
Scale the window 1\(mu.
|
|
|
|
|
.It Fl 2
|
|
|
|
|
Scale the window 2\(mu.
|
|
|
|
|
.It Fl 3
|
|
|
|
|
Scale the window 3\(mu.
|
|
|
|
|
.It Fl 4
|
|
|
|
|
Scale the window 4\(mu.
|
|
|
|
|
.It Fl 5
|
|
|
|
|
Scale the window 5\(mu.
|
|
|
|
|
.It Fl 6
|
|
|
|
|
Scale the window 6\(mu.
|
|
|
|
|
.It Fl b Ar biosfile , Fl -bios Ar biosfile
|
|
|
|
|
Specify a BIOS file to use during boot.
|
|
|
|
|
If this flag is omitted,
|
|
|
|
|
.Nm
|
|
|
|
|
will use a high\(hylevel emulated BIOS.
|
|
|
|
|
.It Fl c Ar cheatfile , Fl -cheats Ar cheatfile
|
|
|
|
|
Apply cheat codes from
|
|
|
|
|
.Ar cheatfile .
|
|
|
|
|
.It Fl d
|
|
|
|
|
Start emulating via the command\(hyline debugger.
|
|
|
|
|
.It Fl f
|
|
|
|
|
Start the emulator full\(hyscreen.
|
|
|
|
|
.It Fl g
|
|
|
|
|
Start a
|
|
|
|
|
.Xr gdb 1
|
|
|
|
|
session.
|
|
|
|
|
By default the session starts on port 2345.
|
2015-08-06 07:50:52 +00:00
|
|
|
.It Fl l Ar loglevel
|
|
|
|
|
Log messages during emulation to
|
|
|
|
|
.Dv stdout .
|
|
|
|
|
.Ar loglevel
|
|
|
|
|
is a bitmask defining which types of messages to log:
|
|
|
|
|
.Bl -inset
|
|
|
|
|
.It 0x01
|
|
|
|
|
fatal errors
|
|
|
|
|
.It 0x02
|
|
|
|
|
errors
|
|
|
|
|
.It 0x04
|
|
|
|
|
warnings
|
|
|
|
|
.It 0x08
|
|
|
|
|
informative messages
|
|
|
|
|
.It 0x10
|
|
|
|
|
debugging messages
|
|
|
|
|
.It 0x20
|
|
|
|
|
stub messages
|
|
|
|
|
.It 0x100
|
|
|
|
|
in\(hygame errors
|
|
|
|
|
.It 0x200
|
|
|
|
|
software interrupts
|
|
|
|
|
.It 0x400
|
|
|
|
|
emulator status messages
|
|
|
|
|
.It 0x800
|
|
|
|
|
serial I/O messages
|
|
|
|
|
.El
|
|
|
|
|
The default is to log warnings, errors, fatal errors, and status messages.
|
2015-07-29 06:41:00 +00:00
|
|
|
.It Fl p Ar patchfile , Fl -patch Ar patchfile
|
2015-08-06 16:31:05 +00:00
|
|
|
Specify a patch file in BPS, IPS, or UPS format.
|
2015-07-29 06:41:00 +00:00
|
|
|
.It Fl s Ar n , Fl -frameskip Ar n
|
|
|
|
|
Skip every
|
|
|
|
|
.Ar n
|
|
|
|
|
frames.
|
|
|
|
|
.It Fl v Ar moviefile , Fl -movie Ar moviefile
|
|
|
|
|
Play back a movie of recording input from
|
|
|
|
|
.Ar moviefile .
|
|
|
|
|
.El
|
|
|
|
|
.Sh CONTROLS
|
|
|
|
|
The default controls are as follows:
|
2015-07-29 08:03:35 +00:00
|
|
|
.Bl -hang -width "Frame advance" -compact
|
2015-07-29 06:41:00 +00:00
|
|
|
.It A
|
|
|
|
|
.Cm x
|
|
|
|
|
.It B
|
|
|
|
|
.Cm z
|
|
|
|
|
.It L
|
|
|
|
|
.Cm a
|
|
|
|
|
.It R
|
|
|
|
|
.Cm s
|
|
|
|
|
.It Start
|
|
|
|
|
.Aq Cm Enter
|
|
|
|
|
.It Select
|
|
|
|
|
.Aq Cm Backspace
|
|
|
|
|
.It Load state
|
|
|
|
|
.Cm F1 Ns \(en Ns Cm F9
|
|
|
|
|
.It Save state
|
|
|
|
|
.Ao Cm Shift Ac Ns \(hy Ns Cm F1 Ns \(en Ns Cm F9
|
|
|
|
|
.It Frame advance
|
|
|
|
|
.Ao Cm Ctrl Ac Ns \(hy Ns Cm n
|
|
|
|
|
.El
|
2015-07-29 08:03:35 +00:00
|
|
|
.Sh DEBUGGER
|
|
|
|
|
When
|
|
|
|
|
.Nm
|
|
|
|
|
is run with the
|
|
|
|
|
.Fl d
|
|
|
|
|
option, the command\(hyline debugger is enabled.
|
|
|
|
|
It supports the following commands:
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -compact -width 1
|
|
|
|
|
.It Cm b Ns Oo Cm reak Oc Ar address
|
|
|
|
|
.It Cm b Ns Oo Cm reak Oc Ns Cm /a Ar address
|
|
|
|
|
.It Cm b Ns Oo Cm reak Oc Ns Cm /t Ar address
|
2015-08-06 08:02:07 +00:00
|
|
|
Set a breakpoint \(en ARM
|
|
|
|
|
.Pq Ql /a ,
|
|
|
|
|
Thumb
|
|
|
|
|
.Pq Ql /t ,
|
|
|
|
|
or the current CPU mode \(en at
|
2015-07-29 08:03:35 +00:00
|
|
|
.Ar address .
|
|
|
|
|
.It Cm c Ns Op Cm ontinue
|
|
|
|
|
Continue execution.
|
|
|
|
|
.It Cm d Ns Oo elete Oc Ar address
|
|
|
|
|
Delete a breakpoint at
|
|
|
|
|
.Ar address .
|
|
|
|
|
.It Cm dis Ns Oo Cm asm Oc Ar address Op Ar count
|
|
|
|
|
.It Cm dis Ns Oo Cm asm Oc Ns Cm /a Ar address Op Ar count
|
|
|
|
|
.It Cm dis Ns Oo Cm asm Oc Ns Cm /t Ar address Op Ar count
|
|
|
|
|
.It Cm dis Ns Oo Cm assemble Oc Ar address Op Ar count
|
|
|
|
|
.It Cm dis Ns Oo Cm assemble Oc Ns Cm /a Ar address Op Ar count
|
|
|
|
|
.It Cm dis Ns Oo Cm assemble Oc Ns Cm /t Ar address Op Ar count
|
|
|
|
|
Disassemble
|
|
|
|
|
.Ar count
|
2015-08-06 08:02:07 +00:00
|
|
|
instructions starting at
|
|
|
|
|
.Ar address ,
|
|
|
|
|
as ARM
|
|
|
|
|
.Pq Ql /a ,
|
|
|
|
|
Thumb
|
|
|
|
|
.Pq Ql /t ,
|
|
|
|
|
or the current CPU mode.
|
2015-07-29 08:03:35 +00:00
|
|
|
If
|
|
|
|
|
.Ar count
|
|
|
|
|
is not specified, only disassemble the instruction at
|
|
|
|
|
.Ar address .
|
|
|
|
|
.It Cm h Ns Op Cm elp
|
|
|
|
|
Print help.
|
|
|
|
|
.It Cm i Ns Op Cm nfo
|
|
|
|
|
.It Cm status
|
|
|
|
|
Print the current contents of general\(hypurpose registers.
|
|
|
|
|
.It Cm n Ns Op Cm ext
|
|
|
|
|
Execute the next instruction.
|
|
|
|
|
.It Cm p Ns Oo Cm rint Oc Ar value ...
|
|
|
|
|
.It Cm p Ns Oo Cm rint Oc Ns Cm /t Ar value ...
|
|
|
|
|
.It Cm p Ns Oo Cm rint Oc Ns Cm /x Ar value ...
|
2015-08-06 08:02:07 +00:00
|
|
|
Print one or more
|
|
|
|
|
.Ar value Ns s
|
|
|
|
|
as binary
|
|
|
|
|
.Pq Ql /t ,
|
|
|
|
|
hexadecimal
|
|
|
|
|
.Pq Ql /x ,
|
|
|
|
|
or decimal.
|
2015-07-29 08:03:35 +00:00
|
|
|
.It Cm q Ns Op Cm uit
|
|
|
|
|
Quit the emulator.
|
|
|
|
|
.It Cm reset
|
|
|
|
|
Reset the emulation.
|
|
|
|
|
.It Cm r/1 Ar address
|
|
|
|
|
.It Cm r/2 Ar address
|
|
|
|
|
.It Cm r/4 Ar address
|
2015-08-06 08:02:07 +00:00
|
|
|
Read a byte
|
|
|
|
|
.Pq Ql /1 ,
|
|
|
|
|
halfword
|
|
|
|
|
.Pq Ql /2 ,
|
|
|
|
|
or word
|
|
|
|
|
.Pq Ql /4
|
|
|
|
|
from
|
2015-07-29 08:03:35 +00:00
|
|
|
.Ar address .
|
|
|
|
|
.It Cm w Ns Oo Cm atch Oc Ar address
|
|
|
|
|
Set a watchpoint at
|
|
|
|
|
.Ar address .
|
|
|
|
|
.It Cm w/1 Ar address
|
|
|
|
|
.It Cm w/2 Ar address
|
|
|
|
|
.It Cm w/4 Ar address
|
2015-08-06 08:02:07 +00:00
|
|
|
Write a byte
|
|
|
|
|
.Pq Ql /1 ,
|
|
|
|
|
halfword
|
|
|
|
|
.Pq Ql /2 ,
|
|
|
|
|
or word
|
|
|
|
|
.Pq Ql /4
|
|
|
|
|
to
|
2015-07-29 08:03:35 +00:00
|
|
|
.Ar address .
|
|
|
|
|
.It Cm w/r Ar register
|
|
|
|
|
Write a word to
|
|
|
|
|
.Ar register .
|
|
|
|
|
.It Cm x/1 Ar address
|
|
|
|
|
.It Cm x/2 Ar address
|
|
|
|
|
.It Cm x/4 Ar address
|
2015-08-06 08:02:07 +00:00
|
|
|
Examine bytes
|
|
|
|
|
.Pq Ql /1 ,
|
|
|
|
|
halfwords
|
|
|
|
|
.Pq Ql /2 ,
|
|
|
|
|
or words
|
|
|
|
|
.Pq Ql /4
|
|
|
|
|
from
|
2015-07-29 08:03:35 +00:00
|
|
|
.Ar address .
|
|
|
|
|
.It Cm \&!\ \&
|
|
|
|
|
Break into the attached debugger.
|
|
|
|
|
.El
|
2015-07-29 06:41:00 +00:00
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An Jeffrey Pfau Aq Mt jeffrey@endrift.com
|
|
|
|
|
.Sh HOMEPAGE
|
|
|
|
|
.Bl -bullet
|
|
|
|
|
.It
|
2015-07-29 07:22:36 +00:00
|
|
|
.Lk https://mgba.io/ "mGBA homepage"
|
2015-07-29 06:41:00 +00:00
|
|
|
.It
|
|
|
|
|
.Lk https://github.com/mgba-emu/mgba "Development repository"
|
|
|
|
|
.It
|
2015-07-29 07:22:36 +00:00
|
|
|
.Lk https://github.com/mgba-emu/mgba/issues "Bug tracker"
|
2015-07-29 06:41:00 +00:00
|
|
|
.It
|
|
|
|
|
.Lk https://forums.mgba.io/ "Message board"
|
|
|
|
|
.El
|
