* Debugger: fixed Symbolic Debugging (Names and Comments display)
* Debugger: special strings (NMI/IRQ/etc) can be also used in "Seek To" field and Bookmarks * updated docs [[Split portion of a mixed commit.]]
This commit is contained in:
ansstuff
parent
e7b5bdde81
commit
4d7584eb77
|
|
@ -85,7 +85,33 @@
|
|||
<p><br/></p>
|
||||
<p>The Pause hotkey will break execution or resume it. The Frame Advance hotkey will run the emulator for one frame then break.</p>
|
||||
<p><br/></p>
|
||||
<p>Just below these buttons is a "Seek To" button that will navigate to the specified address. When execution is paused, the disassembly view will begin with the memory at the currengt program counter location (PC) at the top of the window. You can scroll the disassembly up or down to observe the code. Then you can click "Seek PC" to return to the program counter at any time.</p>
|
||||
<p>When execution is paused, the disassembly view will begin with the memory at the current program counter location (PC) at the top of the window. You can scroll the disassembly up or down to observe the code. Then you can click "Seek PC" to return to the program counter at any time.</p>
|
||||
<p><br/></p>
|
||||
<p>You can also use "Seek To" button that will navigate to the specified address. When entering the address, these convenient strings may be used instead of the hexadecimal memory address:</p>
|
||||
<p><br/></p>
|
||||
<p>NES special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>NMI/VBL - non-maskable interrupt vector (at FFFA)</li>
|
||||
<li>RST - reset vector (at FFFC)</li>
|
||||
<li>IRQ - interrupt vector (at FFFE)</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p>FDS special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>NMI1 - non-maskable interrupt vector (at DFF6)</li>
|
||||
<li>NMI2 - non-maskable interrupt vector (at DFF8)</li>
|
||||
<li>NMI3 - non-maskable interrupt vector (at DFFA)</li>
|
||||
<li>RST - reset vector (at DFFC)</li>
|
||||
<li>IRQ - interrupt vector (at DFFE)</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p>NSF special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>LOAD - NSF LOAD address</li>
|
||||
<li>INIT - NSF INIT address</li>
|
||||
<li>PLAY - NSF PLAY address</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p><br/></p>
|
||||
<p>While execution is broken, the program counter (PC) can be edited, as well as the three registers A/X/Y, and the status flags. Normally they should be left as-is, but changing them at runtime can be useful for more advanced debugging.</p>
|
||||
<p><br/></p>
|
||||
|
|
@ -132,7 +158,9 @@
|
|||
<p><br/></p>
|
||||
<p>Breakpoints will break execution when chosen conditions are met. To create a breakpoint, click the Add button in the BreakPoints frame in the upper right corner of the debugger.</p>
|
||||
<p><br/></p>
|
||||
<p>Each breakpoint has an address range to watch (use only the left address field if you wish to watch a single byte address). Check one or more of the options to watch for Read, Write, or Execute at an address. Note that fetching of code from an address will not break as a Read; use the Execute box for this. Breakpoints can be given a name that will appear in the breakpoint window. The condition field can be used to break only on particular conditions; see "Conditional Breakpoints" below.</p>
|
||||
<p>Each breakpoint has an address range to watch (use only the left address field if you wish to watch a single byte address). When entering the address of a breakpoint, you can also use convenient strings (such as IRQ) instead of hexadecimal memory addresses.</p>
|
||||
<p><br/></p>
|
||||
<p>Check one or more of the options to watch for Read, Write, or Execute at an address. Note that fetching of code from an address will not break as a Read; use the Execute box for this. Breakpoints can be given a name that will appear in the breakpoint window. The condition field can be used to break only on particular conditions; see "Conditional Breakpoints" below.</p>
|
||||
<p><br/></p>
|
||||
<p>Double click on a breakpoint in the BreakPoints list to quickly disable or enable it. So you don't have to delete breakpoints to stop them from causing the debugger to halt the game.</p>
|
||||
<p><br/></p>
|
||||
|
|
@ -162,31 +190,6 @@
|
|||
<li>nnnn - name of breakpoint</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p>When entering the address of a breakpoint, these convenient strings may be used instead of the hexadecimal memory address:</p>
|
||||
<p><br/></p>
|
||||
<p>NES special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>NMI/VBL - non-maskable interrupt vector (at FFFA)</li>
|
||||
<li>RST - reset vector (at FFFC)</li>
|
||||
<li>IRQ - interrupt vector (at FFFE)</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p>FDS special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>NMI1 - non-maskable interrupt vector (at DFF6)</li>
|
||||
<li>NMI2 - non-maskable interrupt vector (at DFF8)</li>
|
||||
<li>NMI3 - non-maskable interrupt vector (at DFFA)</li>
|
||||
<li>RST - reset vector (at DFFC)</li>
|
||||
<li>IRQ - interrupt vector (at DFFE)</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p>NSF special addresses:</p>
|
||||
<ul style="text-indent: 0px; margin-left: 24px; list-style-position: outside;">
|
||||
<li>LOAD - NSF LOAD address</li>
|
||||
<li>INIT - NSF INIT address</li>
|
||||
<li>PLAY - NSF PLAY address</li>
|
||||
</ul>
|
||||
<p><br/></p>
|
||||
<p><br/></p>
|
||||
<p><span class="rvts45">Conditional Breakpoints</span></p>
|
||||
<p><br/></p>
|
||||
|
|
@ -231,7 +234,7 @@
|
|||
<p><br/></p>
|
||||
<p><span class="rvts45">Bookmarks</span></p>
|
||||
<p><br/></p>
|
||||
<p>A list of bookmark addresses can be kept in the Bookmark frame to make memory navigation easier. Simply type an address and click "Add" to add it to your bookmarks. Next time you wish to go to this address just double click on the bookmark.</p>
|
||||
<p>A list of bookmark addresses can be kept in the Bookmark frame to make memory navigation easier. Simply type a hexadecimal address (or a convenient string, such as NMI) and click "Add" to add it to your bookmarks. Next time you wish to go to this address just double click on the bookmark.</p>
|
||||
<p><br/></p>
|
||||
<p>When you exit the emulator, bookmarks are saved in a .deb file. Next time you return to debugging the list of bookmarks will be automatically loaded from the file.</p>
|
||||
<p><br/></p>
|
||||
|
|
|
|||
|
|
@ -1,170 +0,0 @@
|
|||
<html>
|
||||
|
||||
<head>
|
||||
<title>Debugger Usage Guide (Intermediate)</title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||||
<meta name="generator" content="HelpNDoc Personal Edition 3.6.0.345">
|
||||
<link type="text/css" rel="stylesheet" media="all" href="css/reset.css" />
|
||||
<link type="text/css" rel="stylesheet" media="all" href="css/base.css" />
|
||||
<link type="text/css" rel="stylesheet" media="all" href="css/hnd.css" />
|
||||
<!--[if lte IE 8]>
|
||||
<link type="text/css" rel="stylesheet" media="all" href="css/ielte8.css" />
|
||||
<![endif]-->
|
||||
<style type="text/css">
|
||||
#topic_header
|
||||
{
|
||||
background-color: #EFEFEF;
|
||||
}
|
||||
</style>
|
||||
<script type="text/javascript" src="js/jquery.min.js"></script>
|
||||
<script type="text/javascript" src="js/hnd.js"></script>
|
||||
<script type="text/javascript">
|
||||
if (top.frames.length == 0)
|
||||
{
|
||||
var sTopicUrl = top.location.href.substring(top.location.href.lastIndexOf("/") + 1, top.location.href.length);
|
||||
top.location.href = "fceux.html?" + sTopicUrl;
|
||||
}
|
||||
else if (top && top.FrameTOC && top.FrameTOC.SelectTocItem)
|
||||
{
|
||||
top.FrameTOC.SelectTocItem("DebuggerUsageIntermediate");
|
||||
}
|
||||
</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<div id="topic_header">
|
||||
<div id="topic_header_content">
|
||||
<h1>Debugger Usage Guide (Intermediate)</h1>
|
||||
|
||||
<div id="topic_breadcrumb">
|
||||
<a href="FAQGuides.html">FAQ / Guides</a> ›› </div>
|
||||
</div>
|
||||
<div id="topic_header_nav">
|
||||
<a href="FAQGuides.html"><img src="img/arrow_up.png" alt="Parent"/></a>
|
||||
|
||||
<a href="NESRAMMappingFindingValues.html"><img src="img/arrow_left.png" alt="Previous"/></a>
|
||||
|
||||
<a href="Technicalinformation.html"><img src="img/arrow_right.png" alt="Next"/></a>
|
||||
|
||||
</div>
|
||||
<div class="clear"></div>
|
||||
</div>
|
||||
<div id="topic_content">
|
||||
|
||||
<p><span class="rvts17">Debugger Usage (Intermediate)</span></p>
|
||||
<p><br/></p>
|
||||
<p><span class="rvts12">Intent</span></p>
|
||||
<p><br/></p>
|
||||
<p>This guide assumes that you have a working knowledge of how to interpret Assembly instructions, and are willing to look up the table of 6502 instructions on your own. This document describes the debugger, and to a much lesser degree, how to tell it what you want to do in terms of the assembly.</p>
|
||||
<p><br/></p>
|
||||
<p><span class="rvts12">Main Window</span></p>
|
||||
<p><br/></p>
|
||||
<p>In the main window, you'll see lines like this on the left:</p>
|
||||
<p>1E:80E5:66 FF ROR $00FF = #$9A</p>
|
||||
<p><br/></p>
|
||||
<p>This is the disassembly area. The ">" shows current line (usually it's the topmost line).</p>
|
||||
<p><br/></p>
|
||||
<p>On the right are Breakpoints, the stack window, status flags, PC and registers data, PPU state data, and several buttons and text boxes.</p>
|
||||
<p><br/></p>
|
||||
<p>Of the buttons, the one's you'll likely use the most are Run, Step Into, and Step Out.</p>
|
||||
<p><br/></p>
|
||||
<p>"Run" simply makes the program continue operating until it hits a condition that causes it to stop running, or until you stop it manually.</p>
|
||||
<p><br/></p>
|
||||
<p>"Step Into" allows you to move to the next line, and if you Step Into a JSR, you'll be taken to the address listed for it to continue running.</p>
|
||||
<p><br/></p>
|
||||
<p>"Step Out" attempts to run until the debugger is outside of the function you Stepped Into. This doesn't always work, and may appear to make the emulator 'Run' instead. The next time you use Step Out, it will tell you it will erase the old Step Out watch to do the new one. Press OK to do so.</p>
|
||||
<p><br/></p>
|
||||
<p>Other buttons include "Step Over", which basically tries to run to the PC address after the JSR, Run Line, which runs a single VBlank line, 128 lines, which is the last button's action 128 times, "Seek To:" and a text box, which lets you move around the disassembly window quickly, and Seek PC, which orients you back to the code to be run without doing anything else.</p>
|
||||
<p><br/></p>
|
||||
<p>Interpreting the line below is as follows:</p>
|
||||
<p>1E:80E5:66 FF ROR $00FF = #$9A</p>
|
||||
<p><br/></p>
|
||||
<p>(1E:) is the bank used. A bank is 0x4000 in size for a .NES file(and 0x1000 for a .NSF file, but don't worry about this for now). 80E5, masked with 3FFF, equals 00E5. 0x1E multiplied by 4000 is 0x78000. Together, this gives 0x78000 + 0x00E5, which equals the address 0x780E5. Add 0x10 to this to account for the 0x10 byte .NES header, and you get 0x780F5, which is what the address is within the .NES file. That is all that this piece of information means.</p>
|
||||
<p><br/></p>
|
||||
<p>1E:(80E5) is the address that the data that follows is being read from. The banking stated above allows the same address to show different data, but (1E:80E5) will always be the same address on the same page of data.</p>
|
||||
<p><br/></p>
|
||||
<p>If you check the "Display ROM offsets" checkbox, you'll see real ROM addresses instead of bank:address format.</p>
|
||||
<p><br/></p>
|
||||
<p>1E:80E5:(66 FF ROR $00FF) is the byte code for ROR, followed by the parameter that tells it to use $00FF. After that is the interpreted assembly code. Note that just because code can be interpreted doesn't mean that it can be run. Even data that's for graphics will inevitable look like code to a certain degree to the disassembly window.</p>
|
||||
<p><br/></p>
|
||||
<p>1E:80E5:66 FF ROR $00FF( = #$9A) tells you what the value of $00FF is. $00FF refers to 00FF in RAM, and the value is 0x9A. If the program points to an address in ROM instead of RAM, it still shows the value for you.</p>
|
||||
<p><br/></p>
|
||||
<p><br/></p>
|
||||
<p><span class="rvts12">Breakpoints</span></p>
|
||||
<p><br/></p>
|
||||
<p>The breakpoint buttons are Add, Delete, and Edit. These should be self-explanatory. Delete removes the selected breakpoint. Edit will allow you to change an existing entry. Add will open an empty window, which allows you to fill in several details. Double-clicking a breakpoint will enable and disable it, so you don't have to delete items to stop them from causing the debugger to halt the game (the short term for this is called 'breaking' the debugger, referred to in the same way as one would refer to a broken vase). Above the breakpoints list there's current number of enabled breakpoints and total number of breakpoints in the list.</p>
|
||||
<p><br/></p>
|
||||
<p>In the Add Breakpoint window, you have 2 Address boxes [ ] - [ ]. You must put in at least 1 value, preferable in the left box. If you want to use a range of values, you can fill in the first box as the start, and the second box as the end. The addresses can be either RAM (0000-07FF), ROM (8000-FFFF), or the special addresses(6000-7FFF, which can be extra RAM, ROM, or unused, depending on game)</p>
|
||||
<p><br/></p>
|
||||
<p>The Read, Write, and Execute checkboxes allow you to specify whether to break the debugger when that address is Read From, Written To, or Executed by the CPU. All of them can be checked at the same time if you don't know how the data is used, but are sure it's used somehow. Note that if it's the value to an assembly instruction, it won't cause a break, because the byte itself isn't the start of an instruction, and isn't read by the CPU so much as used for an instruction.</p>
|
||||
<p><br/></p>
|
||||
<p>The Option boxes CPU Mem, PPU Mem, and Sprite Mem tell the debugger where to look. The Hex Editor shows CPU Mem by default, but it can show you PPU Mem if you tell it to. PPU Mem is where data is written to display the actual images on the screen, rather than to decide what it is that should be put there. PPU debugging is more of an advanced skill, primarily because when something does go wrong, it's usually because an address outside of the normal PPU address is getting written to and causing very weird graphics errors.</p>
|
||||
<p><br/></p>
|
||||
<p>Name is simply a description for the breakpoint that can be seen to the right, if there's space for it.</p>
|
||||
<p><br/></p>
|
||||
<p>The "Forbid" option allows you to exclude a range of RAM or ROM from the breakpoint list. These can be enabled and disabled as well.</p>
|
||||
<p><br/></p>
|
||||
<p>Condition is part of the Conditional Debugging system. This system is slightly complicated, and extremely powerful when used correctly, and can make extremely hard problems turn into lazy clicking when you understand how to use the feature.</p>
|
||||
<p><br/></p>
|
||||
<p><br/></p>
|
||||
<p><span class="rvts12">Conditional Debugging</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Conditions only apply to the breakpoint they are applied to. You can breakpoint the same address multiple times with different conditions applied to each one.</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Registers: A, X, Y, (P = PC) (A==#12, to break if A = 12) (P!=#804C to NOT break when the PC is on 804C)</span></p>
|
||||
<p><span class="rvts22">Flags: N, C, Z, I, B, V, U, D (N==#0 for off, N==#1 for on)</span></p>
|
||||
<p><span class="rvts22">Bank: K (K!=#1E to NOT break when the bank is 1E)</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Addresses: ($0000!=#00 makes it test RAM address 0000, and if it's NOT 00, it can break)</span></p>
|
||||
<p><span class="rvts22">Numbers: (#0123 is interpreted as 123. It can be used in tests for known values to exclude or include)</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Numerical Comparisons:</span></p>
|
||||
<p><span class="rvts22">== = Equal</span></p>
|
||||
<p><span class="rvts22">!= = Not Equal</span></p>
|
||||
<p><span class="rvts22"><= = Less Than or Equal</span></p>
|
||||
<p><span class="rvts22">>= = Greater Than or Equal</span></p>
|
||||
<p><span class="rvts22">< Less Than</span></p>
|
||||
<p><span class="rvts22">> Greater Than</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Math Operators:</span></p>
|
||||
<p><span class="rvts22">+, -, *, / (which are add, subtract, multiply, divide)</span></p>
|
||||
<p><span class="rvts22">If you want to do complex math that involves 5 memory addresses, 2 ROM addresses, and a smattering of defined values, you can use these to do it. I've never had to, but if you want to, this is how.</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Multiple Tests:</span></p>
|
||||
<p><span class="rvts22">(N==#0||A!=#0 makes it break if EITHER N is off, or A isn't 00)</span></p>
|
||||
<p><span class="rvts22">(A!=#0&&X==#a5 makes it break is A isn't 00, AND X is A5)</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Brackets:</span></p>
|
||||
<p><span class="rvts22">$[#2CC + X] == #34: The value of the byte at address $2CC + X is 0x34</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">Parentheses:</span></p>
|
||||
<p><span class="rvts22">(#1 + #2)==#3 (This evaluates to true, so the breakpoint can break. If you need a different order of operation for math operators, you can use parentheses)</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22">This is what's currently found in the source file for Conditional Debugging:</span></p>
|
||||
<p><span class="rvts22">P -> Connect</span></p>
|
||||
<p><span class="rvts22">Connect -> Compare {('||' | '&&') Compare}</span></p>
|
||||
<p><span class="rvts22">Compare -> Sum {('==' | '!=' | '<=' | '>=' | '<' | '>') Sum}</span></p>
|
||||
<p><span class="rvts22">Sum -> Product {('+' | '-') Product}</span></p>
|
||||
<p><span class="rvts22">Product -> Primitive {('*' | '/') Primitive}</span></p>
|
||||
<p><span class="rvts22">Primitive -> Number | Address | Register | Flag | '(' Connect ')'</span></p>
|
||||
<p><span class="rvts22">Number -> '#' [1-9A-F]*</span></p>
|
||||
<p><span class="rvts22">Address -> '$' [1-9A-F]* | '$' '[' Connect ']'</span></p>
|
||||
<p><span class="rvts22">Register -> 'A' | 'X' | 'Y' | 'R'</span></p>
|
||||
<p><span class="rvts22">Flag -> 'N' | 'C' | 'Z' | 'I' | 'B' | 'V'</span></p>
|
||||
<p><span class="rvts22">PC Bank -> 'K'</span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p><span class="rvts22"><br/></span></p>
|
||||
<p class="rvps2"><span class="rvts13">Created with the Personal Edition of HelpNDoc: </span><a class="rvts14" href="http://www.helpndoc.com">Free PDF documentation generator</a></p>
|
||||
</div>
|
||||
|
||||
<div id="topic_footer">
|
||||
|
||||
<div id="topic_footer_content">
|
||||
2012</div>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
||||
|
|
@ -76,7 +76,7 @@
|
|||
<li><span class="rvts22">Fixed newppu bug which prevented metroid from booting, CHR RAM was not getting initialized to anything</span></li>
|
||||
<li><span class="rvts22">Newppu - fix bug in scroll reg logic causing mis-scrolls in p'radikus conflict</span></li>
|
||||
<li><span class="rvts22">A bit of latest mapper changes from fceu-mm</span></li>
|
||||
<li><span class="rvts22">Fixed mappers 242, 227, 115, 248, 12, 164, 15, 253, 23, 178</span></li>
|
||||
<li><span class="rvts22">Fixed mappers 242, 227, 115, 248, 12, 164, 15, 253, 23, 178, 90</span></li>
|
||||
<li><span class="rvts22">Added mappers 176, 116, 156</span></li>
|
||||
<li><span class="rvts22">Straighten out bandai m159/m016 handling and add valid null-EEPROM emulation to get those games booting.</span></li>
|
||||
<li><span class="rvts22">Add ability for CNROM games to choose whether they have bus conflicts (fixes Colorful Dragon (Unl) (Sachen), since it flakes out if bus conflicts are emulated)</span></li>
|
||||
|
|
@ -161,6 +161,7 @@
|
|||
<li><span class="rvts22">Doubleclick on the disassembly prompts "Add Execute breakpoint here" dialog</span></li>
|
||||
<li><span class="rvts22">"Display ROM offsets" option shows real ROM addresses in the Disassembly window</span></li>
|
||||
<li><span class="rvts22">Fixed conditional breakpoints bug: the error message didn't appear when editing a breakpoint</span></li>
|
||||
<li><span class="rvts22">Fixed Symbolic Debugging (Names and Comments display)</span></li>
|
||||
<li><span class="rvts22">Cleaned up and updated debugging documentation</span></li>
|
||||
</ul>
|
||||
<p><span class="rvts24"><br/></span></p>
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue