Added GDB stub and GBAMP emulation comments.
This commit is contained in:
masscat
parent
c8df2518e3
commit
3ef0536c23
|
|
@ -1,4 +1,7 @@
|
|||
0.7.0 -> 0.X.X
|
||||
general:
|
||||
- Added GDB debugger stub
|
||||
- Added new/different GBAMP CFlash image reader/writer
|
||||
gpu:
|
||||
- Major speedup to the 2D core [shash]
|
||||
gtk-glade:
|
||||
|
|
@ -8,6 +11,8 @@
|
|||
- Added command line options.
|
||||
- Added FPS limiter
|
||||
- Added option to use OpenGl to render window (allows resizing).
|
||||
windows port:
|
||||
- Added command line options.
|
||||
|
||||
0.6.0 -> 0.7.0
|
||||
general:
|
||||
|
|
|
|||
|
|
@ -5,9 +5,9 @@
|
|||
|
||||
|
||||
1) Compiling instructions...................................13
|
||||
2) How to use DeSmuME.......................................43
|
||||
3) Contact information......................................57
|
||||
4) Disclaimer...............................................76
|
||||
2) How to use DeSmuME.......................................53
|
||||
3) Contact information......................................142
|
||||
4) Disclaimer...............................................161
|
||||
|
||||
|
||||
1 Compiling instructions______________________________________
|
||||
|
|
@ -52,39 +52,92 @@ same procedure as in 1.1 .
|
|||
|
||||
2 How to use DeSmuME__________________________________________
|
||||
|
||||
There are three versions of DeSmuME under Linux. These are a
|
||||
Gtk+ build, a Glade build and a CLI SDL build. All these builds
|
||||
have some common command line options:
|
||||
|
||||
--disable-limiter Disables the 60 fps limiter
|
||||
--soft-convert Use software colour conversion during OpenGL
|
||||
screen rendering. May produce better or worse
|
||||
frame rates depending on hardware.
|
||||
|
||||
--arm9gdb=PORT_NUM Enable the ARM9 GDB stub on the given port
|
||||
--arm7gdb=PORT_NUM Enable the ARM7 GDB stub on the given port
|
||||
|
||||
--cflash=PATH_TO_DISK_IMAGE
|
||||
Enable disk image GBAMP compact flash emulation
|
||||
|
||||
--help Display this message
|
||||
|
||||
|
||||
NOTE:
|
||||
The Gtk+ and Glade builds use gtkGLext to handle the OpenGL
|
||||
rendering and contexts. You may get improved performance by
|
||||
also passing the argument --gdk-gl-force-indirect. This has
|
||||
been seen to improve things for Nvidia based graphics cards
|
||||
under Linux.
|
||||
|
||||
|
||||
GDB Debugger Stubs:
|
||||
Source level debugging of ARM9 and/or ARM7 code is supported
|
||||
using a GDB/Insight debugger.
|
||||
The GDB stubs are enabled from the command line using the
|
||||
following options:
|
||||
|
||||
--arm9gdb=<PORT_NUM> (for the ARM9)
|
||||
--arm7gdb=<PORT_NUM> (for the ARM7)
|
||||
|
||||
The PORT_NUM is the TCP port upon which the stub will listen for
|
||||
connections. Once enabled you can connect to the stub using the
|
||||
following command at the GDB debugger prompt (assuming GDB and
|
||||
DeSmuME are running on the same machine):
|
||||
|
||||
target remote :<PORT_NUM>
|
||||
|
||||
NOTE: there are problems with the ARM support when stepping code
|
||||
with GDB versions prior to version 6.6. It is recommended that
|
||||
you use at least version 6.6 if possible.
|
||||
|
||||
|
||||
GBAMP compact flash emulation:
|
||||
|
||||
The default behaviour of DeSmumME is to attempt to emulate the
|
||||
FAT image for the contents of the directory where the running
|
||||
.nds file was located.
|
||||
This behaviour can be altered using the
|
||||
--cflash=<DISK_IMAGE_FILE> command line option. Using this
|
||||
option DeSmuME will emulation a GBAMP and read and write sectors
|
||||
from/to the disk image file.
|
||||
The disk image file must be created and populated with files
|
||||
using some external tool.
|
||||
NOTE: currently if desmume fails to open the disk image file it
|
||||
will silently continue minus a working GBAMP emulation.
|
||||
|
||||
|
||||
2.1 Gtk+ version______________________________________________
|
||||
|
||||
Type "desmume" in a shell, a window should appear, then open
|
||||
a rom file using the "open" button, next use the "run" button
|
||||
to start emulation.
|
||||
|
||||
There are a number of options that can be passed on to desmume
|
||||
from the command line:
|
||||
The following command line options are specific to the Gtk+
|
||||
build:
|
||||
|
||||
USAGE: desmume [OPTIONS] [nds-file]
|
||||
OPTIONS:
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--soft-convert Use software colour conversion during OpenGL
|
||||
screen rendering. May produce better or worse
|
||||
frame rates depending on hardware.
|
||||
|
||||
--disable-3d Disables the 3D emulation
|
||||
|
||||
--disable-sound Disables the sound emulation
|
||||
|
||||
--help Display this message
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
--disable-3d Disables the 3D emulation
|
||||
|
||||
|
||||
NOTE:
|
||||
You may get improved performance by also passing the argument
|
||||
--gdk-gl-force-indirect. This has been seen to improve things for
|
||||
Nvidia based graphics cards under Linux.
|
||||
|
||||
|
||||
2.2 CLI version_______________________________________________
|
||||
2.2 CLI SDL version_______________________________________________
|
||||
|
||||
Just type "desmume-cli path-to-a-rom" in a shell.
|
||||
|
||||
The following command line options are specific to the CLI
|
||||
build:
|
||||
|
||||
--opengl-2d Enables using OpenGL for screen rendering
|
||||
--disable-sound Disables the sound emulation
|
||||
|
||||
|
||||
3 Contact information_________________________________________
|
||||
|
||||
|
|
|
|||
|
|
@ -6,8 +6,8 @@
|
|||
|
||||
1) Compiling instructions...................................13
|
||||
2) How to use DeSmuME.......................................51
|
||||
3) Contact information.....................................130
|
||||
4) Disclaimer..............................................149
|
||||
3) Contact information.....................................166
|
||||
4) Disclaimer..............................................185
|
||||
|
||||
|
||||
1 Compiling instructions______________________________________
|
||||
|
|
@ -127,6 +127,42 @@ correct on the screen. This option forces the window to maintain
|
|||
a correct ratio so it looks correct.
|
||||
|
||||
|
||||
GDB Debugger Stubs:
|
||||
Source level debugging of ARM9 and/or ARM7 code is supported
|
||||
using a GDB/Insight debugger.
|
||||
The GDB stubs are enabled from the command line using the
|
||||
following options:
|
||||
|
||||
--arm9gdb=<PORT_NUM> (for the ARM9)
|
||||
--arm7gdb=<PORT_NUM> (for the ARM7)
|
||||
|
||||
The PORT_NUM is the TCP port upon which the stub will listen for
|
||||
connections. Once enabled you can connect to the stub using the
|
||||
following command at the GDB debugger prompt (assuming GDB and
|
||||
DeSmuME are running on the same machine):
|
||||
|
||||
target remote :<PORT_NUM>
|
||||
|
||||
NOTE: there are problems with the ARM support when stepping code
|
||||
with GDB versions prior to version 6.6. It is recommended that
|
||||
you use at least version 6.6 if possible.
|
||||
|
||||
|
||||
GBAMP compact flash emulation:
|
||||
|
||||
The default behaviour of DeSmumME is to attempt to emulate the
|
||||
FAT image for the contents of the directory where the running
|
||||
.nds file was located.
|
||||
This behaviour can be altered using the
|
||||
--cflash=<DISK_IMAGE_FILE> command line option. Using this
|
||||
option DeSmuME will emulation a GBAMP and read and write sectors
|
||||
from/to the disk image file.
|
||||
The disk image file must be created and populated with files
|
||||
using some external tool.
|
||||
NOTE: currently if desmume fails to open the disk image file it
|
||||
will silently continue minus a working GBAMP emulation.
|
||||
|
||||
|
||||
3 Contact information_________________________________________
|
||||
|
||||
General inquiries should go to:
|
||||
|
|
|
|||
Loading…
Reference in New Issue