ShuriZma
/
stella
mirror of https://github.com/stella-emu/stella.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated debugger.txt with info on cheat system. This document will 

eventually become part of the main HTML manual.


git-svn-id: svn://svn.code.sf.net/p/stella/code/trunk@525 8b62c5a3-ac7e-4cc8-8f21-d9a121418aba
This commit is contained in:
stephena 2005-06-18 13:45:34 +00:00
parent e681c06799
commit 17d72c8d12
2 changed files with 45 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
stella/Debugger.txt
View File

@ -53,7 +53,10 @@ How to use the debugger
Pressing ` toggles the debugger on & off. When you exit the debugger,
the emulation resumes at the current program counter, and continues
until either a breakpoint is hit or the ` key is pressed again.
until either a breakpoint is hit or the ` key is pressed again. Pressing
Ctrl-Tab cycles between tabs from left to right, and Shift-Ctrl-Tab cycles
from right to left. Pressing Tab cycles between widgets in the current
tab.
Tabs:
@ -113,10 +116,46 @@ The tabs that are implemented so far:
- Cheat tab
(TODO: Get Stephen to document this correctly)
This tab lets you search memory for values such as lives or remaining
energy. That's about all I know about it right now :)
energy, but it's also very useful when debugging to determine which
memory location holds which quantity.
Currently, input must be in decimal format, and search results will be
shown in decimal (with hex addresses).
Enter a byte value into the search editbox (0-255) and click 'Search'.
All matching address/value pairs will be shown in the listbox to the
right. The values in the listbox may be changed using the normal
editing operations, and the RAM will be immediately updated. If
'Search' is clicked and the inputbox is empty, all RAM locations
are returned.
The 'Compare' button is used to compare the given value using all
addresses in the listbox. This may be an absolute number (such as 2),
or a comparitive number (such as -1). Using a '+' or '-' operator
means 'search addresses for values that have changed by that amount'.
The following is an example of inspecting all addresses that have
decreased by 1:
Click 'Search' with an empty inputbox. All 128 address/values are
returned
Exit debugger mode and lose a life, let your energy decrease, or
do whatever it is you're trying to debug
Enter debugger mode again, and enter a '-1' in the inputbox
Click the 'Compare' button, which compares all addresses in the
listbox with RAM, and finds all values that have decreased by 1
(as compared to their value in the listbox).
Repeatedly following these steps may help to narrow number of
addresses under consideration, and eventually you'll find the
memory address you're looking for
The 'Restart' button restarts the whole procedure (ie, clear the
input and listboxes, and allows another search.
Global Buttons:

4
stella/src/gui/DebuggerDialog.cxx
View File

@ -13,7 +13,7 @@
// See the file "license" for information on usage and redistribution of
// this file, and for a DISCLAIMER OF ALL WARRANTIES.
//
// $Id: DebuggerDialog.cxx,v 1.14 2005-06-17 17:34:01 stephena Exp $
// $Id: DebuggerDialog.cxx,v 1.15 2005-06-18 13:45:34 stephena Exp $
//
// Based on code from ScummVM - Scumm Interpreter
// Copyright (C) 2002-2004 The ScummVM project
@ -126,7 +126,7 @@ void DebuggerDialog::handleCommand(CommandSender* sender, int cmd, int data)
break;
case kDDAdvCmd:
instance()->frameBuffer().advance();
instance()->debugger().nextFrame();
myTab->loadConfig();
break;