diff --git a/desmume/ChangeLog b/desmume/ChangeLog index b32efa13d..31e04010f 100644 --- a/desmume/ChangeLog +++ b/desmume/ChangeLog @@ -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: diff --git a/desmume/README.LIN b/desmume/README.LIN index 53ed6e803..6f379e45a 100644 --- a/desmume/README.LIN +++ b/desmume/README.LIN @@ -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= (for the ARM9) +--arm7gdb= (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 : + +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= 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_________________________________________ diff --git a/desmume/README.WIN b/desmume/README.WIN index ea0fb23aa..07d4a0438 100644 --- a/desmume/README.WIN +++ b/desmume/README.WIN @@ -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= (for the ARM9) +--arm7gdb= (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 : + +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= 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: