mirror of
https://github.com/AppleWin/AppleWin.git
synced 2024-12-26 20:30:16 +00:00
5172 lines
120 KiB
HTML
5172 lines
120 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
|
|
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252">
|
|
<title>AppleWin Debugger Tutorial</title>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body style="direction: ltr;" lang="en-US">
|
|
|
|
<h1>AppleWin Debugger Tutorial</h1>
|
|
|
|
<p><font size="4"><i>By Michael Pohoreski.</i></font></p>
|
|
|
|
<p><font size="3">Revision 3. Mar 12, 2006.</font></p>
|
|
|
|
<h2>Table of Contents</h2>
|
|
|
|
<ul>
|
|
|
|
<li><a href="#Introduction">Introduction</a></li>
|
|
|
|
<li><a href="#Debugger">Entering the Debugger</a></li>
|
|
|
|
<li><a href="#Scrolling">Scrolling</a></li>
|
|
|
|
<li><a href="#Registers">Registers</a> </li>
|
|
|
|
<li><a href="#Flags">Flags</a> </li>
|
|
|
|
<li><a href="#Execution">Execution</a> </li>
|
|
|
|
<li><a href="#Memory">Memory</a>
|
|
<ul>
|
|
|
|
<li><a href="#Memory_View">Viewing Memory</a></li>
|
|
|
|
<li><a href="#Memory_Search">Searching Memory</a></li>
|
|
|
|
<li><a href="#Memory_Change">Changing Memory</a></li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
<li><a href="#Symbols">Symbols</a> </li>
|
|
|
|
<li><a href="#Calculator">Calculator</a> </li>
|
|
|
|
<li><a href="#Breakpoints">Breakpoints</a> </li>
|
|
|
|
<li><a href="#Config">Configuration</a>
|
|
<ul>
|
|
|
|
<li><a href="#Colors">Colors</a> </li>
|
|
|
|
<li><a href="#Fonts">Fonts</a> </li>
|
|
|
|
<li><a href="#Scripts">Scripts</a> </li>
|
|
|
|
<li><a href="#Settings">Settings</a> </li>
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h2><a name="Introduction"></a>Introduction</h2>
|
|
|
|
<p>If you're new to the debugger,
|
|
this tutorial will
|
|
gently get you up to speed in becoming familiar with it.</p>
|
|
|
|
<p>If you're already familiar with
|
|
the AppleWin
|
|
Debugger, you'll be aware that it was probably lacking in features
|
|
and ease of use. The new debugger has been given an over-haul
|
|
for the new millennium with respect to aesthetics and
|
|
functionality.
|
|
As such, you'll probably want to read this tutorial to learn about
|
|
the new features that will not only help you in debugging, but also
|
|
save you time.</p>
|
|
|
|
<p>Let's get started on the tour!</p>
|
|
|
|
<h2><a name="Debugger"></a>Entering the
|
|
Debugger</h2>
|
|
|
|
<p>Start AppleWin, and press <b><font face="Courier, monospace">F7</font></b>
|
|
to enter the debugger.</p>
|
|
|
|
<p>The first thing you'll probably
|
|
notice is the new
|
|
syntax coloring in the disassembly view, and info panel. All
|
|
the colors can be customized to your liking. See the <a href="#Colors">Colors</a>
|
|
section for details.</p>
|
|
|
|
<p>Since the mini-console isn't the
|
|
full width of the
|
|
screen, you can toggle between the full-screen console with the tilde
|
|
'~' key. This style of table will be used to designate which keys the
|
|
debugger will recognize.</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Key</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p><b>~</b><br>
|
|
|
|
<font face="Wingdings">ñ</font>`</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Tilde<br>
|
|
|
|
Shift-Accent</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Toggle full screen console (US keyboards)</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p><font face="Wingdings">ñ</font>/<br>
|
|
|
|
<font face="Wingdings">ñ</font>@</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Shift Forward Slash<br>
|
|
|
|
Shift At</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Toggle full screen console (European keyboards)</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p>The debugger will print out a mini
|
|
message at the
|
|
bottom of the console when it is first started. Help is
|
|
built-in for some of the commands (with more coming every
|
|
release.)
|
|
Most commands will display a help usage, if you simply type the
|
|
command and press Enter. </p>
|
|
|
|
<p>This typeface, and color will be
|
|
used to designate
|
|
commands you can type into the debugger. </p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#30c0ff"><font face="Courier"><b>HELP</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Display Help
|
|
for specific command.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">?</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Display Help
|
|
Summary.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">VERSION</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Display both
|
|
the AppleWin and Debugger Version.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p><b>Note</b>: <i>Please
|
|
include both the AppleWin and
|
|
Debugger version when reporting bugs about the Debugger.
|
|
Sometimes a preview (Beta) version of the debugger is available
|
|
before the next official AppleWin version is available. Older
|
|
bugs (may already) be fixed in the new version. The version
|
|
number will help both you and the developers to detect if
|
|
you’re
|
|
documenting a new bug, submitting an already existing bug, or
|
|
re-submitting a bug that has already been fixed. </i>
|
|
</p>
|
|
|
|
<p></p>
|
|
|
|
<h2><a name="Scrolling"></a>Scrolling</h2>
|
|
|
|
<p>In the disassembly view, the
|
|
following keys &
|
|
commands can be used:<br>
|
|
|
|
(The classic Apple "monitor "
|
|
disassemble command is also suported.)
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>U ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Start disassembly from Value or Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>####L</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>List (unassemble) from specified address.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Key</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">á</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Up Arrow</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll up one mnemonic line.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">â</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Down Arrow</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll down one mnemonic line.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ñá</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Shift Up Arrow</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll up 1 byte.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ñâ</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Shift-Down Arrow</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll down 1 byte.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">PgUp </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Page Up </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll up one screen.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">PgDn </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Page Down </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Scroll down one screen.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ñ</font>PgUp
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Shift-Page Up </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to prev. page boundary (256 byte).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ñ</font>PgDn
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><a name="Registers"></a>Shift-Page
|
|
Down </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to next page boundary (256 byte).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^PgUp </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Control-Page Up </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to prev. 4K boundary (4096 bytes).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^PgDn </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Control-Page Down</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to next 4K boundary (4096 bytes).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">Home </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Home</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to start of memory ($0000).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">End </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>End</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump to middle of memory ($8000).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">à</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Right Arrow </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Locate current 6502 instruction.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">à</font><font size="4">|</font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Tab </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Locate current 6502 instruction.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p></p>
|
|
|
|
<h2><a name="Registers1"></a>Registers</h2>
|
|
|
|
<p>The command line now recognizes
|
|
6502 Registers.
|
|
Namely, </p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p><b>A</b>,
|
|
the Accumulator,</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><b>X</b>,
|
|
the 1<sup>st</sup> Index Register,</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><b>Y</b>,
|
|
the 2<sup>nd</sup> Index Register,</p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><b>PC</b>,
|
|
the Program Counter, </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><b>S</b>,
|
|
the Stack Pointer, and </p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p><b>P</b>, the
|
|
Processor Status Register (Flags).</p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>You can set a Register to a hex
|
|
Value, Symbol, or
|
|
Expression. (See the section <a href="#Calculator">Calculator</a>
|
|
for more examples of using
|
|
expressions.) The
|
|
syntax is:</p>
|
|
|
|
<br>
|
|
|
|
<table bgcolor="#e6e6e6" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
r [=] ####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Register to (a byte) Value, Symbol, or Address, or Expression.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Accumulator to (a byte) Value</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
X ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Register X to (a byte) Value</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
Y ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Register Y to (a byte) Value</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
PC ####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
PC to (a full 16-bit) Address (Value)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
S ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Stack Register to (an 8-Bit) Offset</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
P ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Processor Status Register (flags) to (a byte) Value</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p><b>Notes</b>:</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>Since
|
|
<b>A</b> refers to the Accumulator, you need to prefix
|
|
the hex number <b>A</b> with either:<br>
|
|
|
|
i) a zero '<b>0</b>',
|
|
or<br>
|
|
|
|
ii) the hash '<b>#</b>'
|
|
symbol (same as 6502 immediate symbol.)</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p><i>You can prefix a
|
|
symbol with the dollar sign '<b>$</b>' to tell the parser
|
|
it is a symbol Address instead of a Value.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p><i>If a symbol is not
|
|
defined, the expression will be the corresponding hex Value, if
|
|
possible.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p><i>Hex Values may be
|
|
ambiguous, if their corresponding symbol is defined. To avoid
|
|
confusion, don’t define symbols such as the popular $DEAD,
|
|
$BEEF, $C0DE, $CAFE, etc. An example is given with A1.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>R PC FA62 </b></font></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><font color="#ffffff"><i>Set Program
|
|
Counter to Value $<b><font color="#ffff00">FA62</font></b>
|
|
(RESET) </i></font> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
PC RESET + 1</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Program
|
|
Counter to Address $<b><font color="#ffff00">FA63</font></b>
|
|
(RESET+1)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
X 2 </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Register
|
|
to Value <font style="font-weight: bold;" color="#ffff00">2</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
Y 3 </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Register
|
|
to Value <font style="font-weight: bold;" color="#ffff00">3</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
S 1FE </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Stack
|
|
Pointer to depth of one (Stack grows down from $01FF)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
S FF </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Stack
|
|
Pointer to top of stack (Empty)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A 0A </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set
|
|
Accumulator to hex Value <font style="font-weight: bold;" color="#ffff00">0A</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A #A </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set
|
|
Accumulator to hex Value <font style="font-weight: bold;" color="#ffff00">0A</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
X A </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Register
|
|
X to Accumulator’s Value</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A A1 </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>If the
|
|
symbol A1 exists, sets Accumulator to the <b>Address</b>
|
|
of the symbol <b>A1</b><br>
|
|
|
|
If the symbol A1 <b>doesn't</b> exist, sets Accumulator to
|
|
the hex <b>Value</b> <font style="font-weight: bold;" color="#ffff00">A1</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A $A1 </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>If the
|
|
symbol A1 exists, sets the Accumulator to the <b>Address</b>
|
|
of symbol <b>A1<br>
|
|
|
|
</b>If the symbol A1 <b>doesn't</b> exist,
|
|
sets Accumulator to the hex Value <font style="font-weight: bold;" color="#ffff00">A1</font></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A #A1 </span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Sets
|
|
Accumulator to the hex value <b><font color="#ffff00">A1</font></b></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Flags"></a>Flags</h2>
|
|
|
|
<p>Each flag can individually be set
|
|
or cleared on the
|
|
Processor Status Register ('<b>P</b>'). Cleared
|
|
flags will show
|
|
up with a normal background. Set flags will show with an
|
|
inverse background. </p>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Notes</b>:</font></p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>The
|
|
legacy commands <b>R</b>? and <b>S</b>?,
|
|
where? is a flag name (C,Z,I,D,B,R,V,N) has been left in.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p><font size="4">Commands to set a flag:</font></p>
|
|
|
|
<table bgcolor="#cccccc" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Description</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEC
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Carry </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEZ
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Zero </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEI
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Interrupts Disabled </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SED
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Decimal (BCD) mode </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEB
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Break </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SER
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Reserved (not used on 6502)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEV
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Overflow </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SEN
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Set
|
|
Negative </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p><font size="4">Commands to clear a flag:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Description</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLC
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Carry </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLZ
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Zero </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLI
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Interrupts Disabled </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLD
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Decimal (BCD) mode </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLB
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Break </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLR
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Reserved (not used on 6502)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLV
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Overflow </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td>
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CLN
|
|
</span></b></font></font> </p>
|
|
|
|
</td>
|
|
|
|
<td>
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
Negative </span></i> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2>Execution</h2>
|
|
|
|
<p>As you scroll around, you will
|
|
notice the cursor and
|
|
other lines change colors. Normally the cursor line is shown
|
|
with an inverse bar, that is with a white background. Other colors
|
|
have these meanings: </p>
|
|
|
|
<table border="1" bordercolor="#000000" cellpadding="2" cellspacing="0" width="666">
|
|
|
|
<col width="161"> <col width="494"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="161">
|
|
<p><font color="#ffffff"><b>Cursor
|
|
Background</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="494">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="161">
|
|
<p>White </p>
|
|
|
|
</td>
|
|
|
|
<td width="494">
|
|
<p><i>Address of cursor.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ffff00" width="161">
|
|
<p>Yellow (Bright)</p>
|
|
|
|
</td>
|
|
|
|
<td width="494">
|
|
<p><i>Cursor is on next 6502 instruction (At 6502 PC).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#cccc00" width="161">
|
|
<p>Yellow (Dim)</p>
|
|
|
|
</td>
|
|
|
|
<td width="494">
|
|
<p><i>Line is next 6502 instruction (At 6502 PC).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td bgcolor="#ff0000" width="161">
|
|
<p>Red (Bright)</p>
|
|
|
|
</td>
|
|
|
|
<td width="494">
|
|
<p><i>Cursor is on active Breakpoint.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p>Press Right Arrow to locate the
|
|
current 6502
|
|
instruction. If you Page Down, you can see that Branch
|
|
Indicators are displayed on the right side of the disassembly window,
|
|
designated by ‘<font face="Webdings, serif">5</font>’
|
|
or
|
|
‘<font face="Webdings, serif">6</font>’. </p>
|
|
|
|
<p>Press Right Arrow to again locate
|
|
the current
|
|
instruction. You will also notice immediate instructions have
|
|
a
|
|
character single quoted, after them, such as ‘<font face="Courier, monospace">I’</font>
|
|
at $<b>FA75</b>.</p>
|
|
|
|
<p>Pressing Space, will Trace (into)
|
|
an instruction.
|
|
Sometimes you trace into a JSR (subroutine), and wish you
|
|
hadn't.
|
|
Pressing Shift-Space will "<i>Step Out</i>" - that is, run
|
|
until the Program Counter (PC) is equal to the return address on the
|
|
stack. Pressing Left Arrow will jump the cursor to the next
|
|
instruction after the original call. </p>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Notes</b>:</font></p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p><i>Some
|
|
code will place the arguments to the subroutine after the JSR
|
|
instruction. The debugger is not able to detect this and "<b>Step
|
|
Out</b>" correctly, so use caution, if the sub-routine plays with
|
|
the stack.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p> <i>The
|
|
debugger is not able to detect if the top 2 bytes on the stack is a
|
|
valid return address, so pay careful attention if the stack is modified!</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Key</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p><font face="Wingdings">§</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Space </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Trace into instruction.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ñ§</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Shift-Space </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Step out of subroutine.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^<font face="Wingdings">§</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ctrl-Space </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Trace over instruction.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^<font face="Wingdings">â</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ctrl-Down Arrow </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Run until cursor.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^<font face="Wingdings">à</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ctrl-Right Arrow</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Set PC to cursor.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><font face="Wingdings">ß</font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Left Arrow </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Jump cursor to return address on stack.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="90*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="35%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Description</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p>G [StopAddress] </p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Resume execution until PC = StopAddress.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p>G [StopAddress] [SkipAddress,Length]</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Resume execution until PC = StopAddress.<br>
|
|
|
|
Additionally, if the PC exits the range [SkipAddress,Length],<br>
|
|
|
|
execution will be halted.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p>####G</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Alias for: R PC [=] address.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="90*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="35%">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="65%">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="35%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>R PC FA62 </b></font></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><i>Set Program
|
|
Counter to Value $<b><font color="#ffff00">FA62</font></b>
|
|
(RESET) </i></font> </p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="35%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">G C600 D000,3000</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="65%">
|
|
<p><font color="#ffffff"><i>Single-step
|
|
until either PC = $C600, or PC <= $D000</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Memory">Memory</a></h2>
|
|
|
|
<h3><a name="Memory_View">Viewing Memory</a></h3>
|
|
|
|
<p>There are two mini-memory areas on
|
|
the info panel.
|
|
You can view memory in Hex, (normal 7-Bit) ASCII, or Apple (8-Bit)
|
|
TEXT format.</p>
|
|
|
|
<p>Control characters are shown in
|
|
yellow. The
|
|
Apple uses something called 8-Bit (High-Bit) ASCII, in which the
|
|
first 128 characters (normal ASCII) are also mapped onto the last 128
|
|
characters, but with a different background. (Technically,
|
|
the
|
|
first 64 characters are drawn inverse, the next 64 characters
|
|
flashing, and the last 128 normally.) Some programs will
|
|
store
|
|
text in this extended Apple format, where a High-Bit character can be
|
|
used as a flag to represent an end of word.</p>
|
|
|
|
<p>Here is a summary:</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>Normal
|
|
ASCII (non-control characters) will show up in cyan; High-Bit text in
|
|
white.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>Apple
|
|
TEXT (normal ASCII) will also display with an inverse background;
|
|
High-Bit with a normal background.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>M1 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 1 in Hex at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>M2 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 2 in Hex at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>MA1 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 1 in ASCII at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>MA2 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 2 in ASCII at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>MT1 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 1 in “Apple
|
|
Text” at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>MT2 ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>View mini-memory 1 in “Apple
|
|
Text” at the Address</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>D ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias for M1</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>MA1 D0D0</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><font color="#ffffff"><i>View
|
|
Applesoft Tokens (Low ASCII cyan, High ASCII white)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">MT2
|
|
FF0A</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>View Apple
|
|
message displayed when booted, showing Apple Model.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">DATA</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Switch to
|
|
the Data Window to view memory. Most scrolling keys work.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CODE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Switch to
|
|
the Code Window to view the disassembler.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h3><a name="Memory_Search">Searching Memory</a></h3>
|
|
|
|
<p>You can search memory for hex values. Wildcard
|
|
support is also supported via the '<b>?</b>' wildcard
|
|
operator, including nibble searching.
|
|
A single '<b>?</b>' by itself, means match one byte of any
|
|
value. A hex value
|
|
with the high nibble or low nibble of '<b>?</b>' will mask
|
|
off the corresponding
|
|
nibble. (At the moment there is no way to refer to the list
|
|
of results.
|
|
A future version will support _# to reference search
|
|
result's addresses.)</p>
|
|
|
|
<p>Searching memory for text is forthcoming in a future version
|
|
of the debugger.</p>
|
|
|
|
<br>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000" face="Courier"><b>SH
|
|
#,len byte1 …</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Search memory for 8-bit hex value(s).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>SH #,len word1 …</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Search memory for 16-bit value(s).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><b><font color="#00b8ff" face="Courier">SH
|
|
800,8000 C030</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><font color="#ffffff">Search
|
|
memory for speaker access.</font></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><b><font color="#00b8ff" face="Courier">SH
|
|
800,8000 AD ? C0</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><i><font color="#ffffff">Search
|
|
memory for “
|
|
<b>LDA $<font color="#ffff00">C0xx</font></b>”.</font></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><b><font color="#00b8ff" face="Courier">SH
|
|
800,8000 3? C0</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><i><font color="#ffffff">Search
|
|
memory for speaker access <b>$<font color="#ffff00">C03x</font></b>.</font></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><b><font color="#00b8ff" face="Courier">SH
|
|
800,8000 ?1 C0</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><i><font color="#ffffff">Search
|
|
memory for soft-switch $<b><font color="#ffff00">C0x1</font></b>.</font></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><b><font color="#00b8ff" face="Courier">L
|
|
_1</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><i><font color="#ffffff">Disassemble
|
|
from search result #<b><font color="#ffff00">1</font></b>
|
|
address.</font></i></p>
|
|
|
|
<p><i><font color="#ffffff">Note: Not
|
|
yet implemented!</font></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h3><a name="Memory_Change">Changing Memory</a></h3>
|
|
|
|
<p>To change the Apple's memory, the classic "Apple Monitor"
|
|
command to enter memory is recognized,
|
|
as well as the "normal" debugger comamnd.<br>
|
|
|
|
</p>
|
|
|
|
<br>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>####:byte1 …</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Classic "Apple Monitor" command to enter
|
|
byte(s). Alias for E.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000" face="Courier"><b>E
|
|
addr byte1 …</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Set memory to the 8-Bit (byte) value(s)</i><i>.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000" face="Courier"><b>EB
|
|
symbol ####</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for E.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E8
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for E.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>EW
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Set
|
|
memory (at the symbol Address) to the 16-Bit (word) Value(s).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E16
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for EW.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>NOP</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Writes an “NOP” opcode (EA)
|
|
at the current Program Counter (PC)</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>ZAP</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias for NOP.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>300:60</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="color: white;">Same
|
|
as Applesoft Poke 768,96</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p></p>
|
|
|
|
<h2><a name="Calculator"></a>Calculator</h2>
|
|
|
|
<p>There is a basic mini hex
|
|
calculator built in.
|
|
It can do Addition, Subtraction, Division, Modulus, bit-wise And,
|
|
bit-wise Or, bit-wise Exclusive Or, and bit-wise Negation, with
|
|
Values, Register and Symbols. It will display results in Hex,
|
|
Binary, Decimal, and as a Character (single quoted.)</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Op</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">+</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Plus</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Addition.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">-</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Minus</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Subtraction.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">%</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Percent</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Calculate remainder (modulus).</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">/</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Forward Slash</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Calculate quotient.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">& </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ampersand</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Bit-wise AND.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">| </p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Pipe</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Bit-Wise (inclusive) OR.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">^</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Caret</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Bit-Wise (exclusive) OR, also called XOR.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">!</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Exclamation</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Bit-Wise NOT.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><font size="4">Notes:</font></h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>The
|
|
unary bit-wise Negation operator, ‘!’ only effects
|
|
the next immediate expression.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>There
|
|
is (currently) no multiplication operator, due to the asterisk
|
|
‘*’ being used for the wild card operator.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect </b></font>
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>CALC 9+1</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
9+1, in hex.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
A 1</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set
|
|
Accumulator to 1.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
X 2</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set X to 2.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">R
|
|
Y 3</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Set Y to 3.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
A+X+Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
sum of registers.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
1FF-S</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
Stack Depth.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
BRKV+1</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
address of Break Vector + 1<br>
|
|
|
|
(First byte is a jump instruction.)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
A+#A</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
Accumulator plus (decimal) 10.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
A+0A</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
Accumulator plus (decimal) 10.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
A+$0A</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
Accumulator plus (decimal) 10.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
0A+0A</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate 10
|
|
+ 10, in hex.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
$RESET+1</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
Address of Reset + 1 (First opcode is one byte, CLD).</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
!HOME</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
bit-wise NOT.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
X & Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
bit-wise AND of Register X , Register Y.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
X | Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
bit-wise OR of Register X , Register Y.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
X ^ Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
bit-wise XOR of Register X , Register Y.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
X / Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
division of Register X , Register Y.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CALC
|
|
X % Y</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Calculate
|
|
remainder of Register X , Register Y.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Windows"></a>Windows</h2>
|
|
|
|
<p>Due to the amount of information available, the debugger now
|
|
features "windows." You can switch to th full screen
|
|
console to read the help, or to the data window to view memory.</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">WIN
|
|
CONSOLE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Switch to the full screen console. Scrolling
|
|
keys work.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CONSOLE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Alias</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">WIN
|
|
CODE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Switch to the disassembly window.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CODE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Alias</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">WIN
|
|
DATA</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Switch
|
|
to the Data window to view memory. Most scrolling keys work.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">DATA</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Alias</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p>You can cycle between windows,
|
|
using these keys:</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Key</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p><b>^<font face="Wingdings">à</font></b></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ctrl-Tab</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Cycle to next Window.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p>^<font face="Wingdings">ñà</font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Ctrl-Shift-Tab</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Cycle to prev. Window</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p style="margin-bottom: 0in;"><br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Symbols"></a>Symbols</h2>
|
|
|
|
<p>AppleWin supports loading of ACME,
|
|
and Merlin Symbol
|
|
Tables. The default filename read into the Main Symbol Table is
|
|
“APPLE2E.SYM”.</p>
|
|
|
|
<p>Looking up symbols is now
|
|
easier. Can't
|
|
remember an address of a symbol, or can't remember the symbol for an
|
|
address? The new symbol commands makes it easy:</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Display
|
|
the number of symbols in the Main, User, and Source symbol tables.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM
|
|
####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Look-up
|
|
the Symbol or Address, and display which Symbol Table it is in.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYMUSER
|
|
LOAD</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Loads
|
|
the User Symbol Table.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYMUSER
|
|
CLEAR</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clears
|
|
the User Symbol Table!</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYMMAIN
|
|
####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Look-up
|
|
only in the Main symbol table.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYMUSER
|
|
####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Look-up
|
|
only in the User symbol table.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYMSRC
|
|
####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Look-up
|
|
only in the Source symbol table.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM
|
|
name = ####</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Add
|
|
(or update) a symbol in the User table with the new Address.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM
|
|
! name</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Remove
|
|
a symbol from the User table.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">E
|
|
symbol ##</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Set
|
|
memory (at the symbol Address) to the 8-Bit (byte) Value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000" face="Courier"><b>EB
|
|
symbol ####</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for E.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E8
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for E.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>EW
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Set
|
|
memory (at the symbol Address) to the 16-Bit (word) Value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E16
|
|
symbol ####</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Alias
|
|
for EW.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="799">
|
|
|
|
<col width="276"> <col width="515"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="276">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="515">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYM</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Displays
|
|
number of symbols in the Main, User, and Source tables.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYMMAIN CLEAR</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Clears the
|
|
main symbol table!!</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYMMAIN LOAD APPLE2E.SYM</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Reloads the
|
|
main symbol table.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYM FA62</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Look up the
|
|
Address $<b><font color="#ffff00">FA62</font></b>
|
|
(RESET).</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM
|
|
HOME</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Look up the
|
|
Address $<b><font color="#ffff00">FC58</font></b>
|
|
(HOME).</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SYM
|
|
LIFE = 300</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Define a new
|
|
user symbol, called “Life” at Address $0300.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">E
|
|
LIFE 64</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Set 8-Bit
|
|
variable (@ $<b><font color="#ffff00">0300</font></b>)“Life”
|
|
to 100 (decimal).</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">EW
|
|
LIFE 3E8</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Set 16-Bit
|
|
variable (@ $<b><font color="#ffff00">0300</font></b>)“Life”
|
|
to 1000 (decimal).</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Source"></a>Source</h2>
|
|
|
|
<p>Another new feature is source
|
|
level debugging.
|
|
Parsing assembly source has the option of:</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p><i>Reading
|
|
in your define symbols into the Source Symbol Table.</i></p>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<p><i>Reading
|
|
in your binary program into Apple Memory.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>Supported assembler source formats
|
|
include: <b>Merlin</b>.</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
|
|
<col width="90*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="35%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="65%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE
|
|
filename</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Read
|
|
in the assembler source.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE
|
|
SYM filename</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Read
|
|
in the assembler source, adding symbols.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE
|
|
MEM filename</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Read
|
|
in the assembler source, storing bytes into memory.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE
|
|
SYM MEM filename</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Add
|
|
both symbols, and store bytes into memory.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Turn
|
|
off source level debugging.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">SOURCE2</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Split
|
|
the dissembler view, with source in bottom half.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p style="margin-bottom: 0in;"><br>
|
|
|
|
</p>
|
|
|
|
<p>Assuming you have a file called “test.s”
|
|
in the same
|
|
directory as the AppleWin executable:</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="799">
|
|
|
|
<col width="276"> <col width="515"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="276">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="515">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SOURCE SYM MEM test.s</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Read in
|
|
assembler source “Test.s”, with symbols added to
|
|
the Source Symbol Table, and source bytes into memory. SYMSRC reports
|
|
how many symbols are in the Source Symbol Table.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p style="margin-bottom: 0in;"><br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Breakpoints"></a>Breakpoints</h2>
|
|
|
|
<p>You now have a variety of options
|
|
when specifying a
|
|
breakpoint. Breakpoints can also be disabled, and later
|
|
re-enabled. This lets ones set a bunch of breakpoints, and
|
|
quickly re-activate them without having to re-enter the breakpoint
|
|
logic.</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPA
|
|
r [op] value</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Adds
|
|
(conditional) Breakpoint.<br>
|
|
|
|
Default operator is equal ‘=’<br>
|
|
|
|
(In a future version, will dispatch to BPX, BPR, BPP, or BPIO.)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPX<br>
|
|
|
|
BPX expression<br>
|
|
|
|
BPX address[,len]<br>
|
|
|
|
BPX [op] symbol</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Add
|
|
Breakpoint trigger to stop executing when the PC is within the range of
|
|
the Address, Symbol, or Expression. i.e. Range is: [addr,addr+len)<br>
|
|
|
|
Default length is 1.<br>
|
|
|
|
Default comparision operator is equal ‘=’</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BP</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Currently
|
|
an Alias for BPX.<br>
|
|
|
|
(In a future version, will also support Loading and Saving of
|
|
breakpoints.)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPM
|
|
address[,len]</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Add
|
|
Breakpoint trigger when memory is accessed by 6502.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPR
|
|
reg [op] value</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Add
|
|
Breakpoint trigger when Register’s ‘reg’
|
|
value is compared to the Value.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BD</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Disable
|
|
Breakpoint (grayed out).</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Enable
|
|
Breakpoint (colored red).</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BC
|
|
#</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Clear
|
|
specified Breakpoint.<br>
|
|
|
|
Note: The asterisk ‘*’ may be used o clear all
|
|
breakpoints.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BL</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">List
|
|
Breakpoints.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPIO</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">(In
|
|
a future version, will add Breakpoint trigger on memory read or write.)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPP</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">(In
|
|
a future version, will add Breakpoint trigger on specific flag cleared
|
|
or set.)</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p>The general format for the
|
|
conditional breakpoint is:</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p style="margin-bottom: 0in;"><i>BPA
|
|
register [operator] value.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>You can use the following
|
|
comparison operators:</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Op</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">=</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Equal</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when register is equal to value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">!</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Not Equal</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when register is not equal to value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style=""><</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Less Than</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when register is less than value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Greater Than</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when register is greater than value.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p>Breaking on any of the 6502
|
|
registers is fully
|
|
supported:</p>
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="26*"> <col width="64*"> <col width="166*"> <thead> <tr bgcolor="#000000">
|
|
|
|
<td width="10%">
|
|
<p><font color="#ffffff"><b>Reg</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p><font color="#ffffff"><b>Name</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</thead> <tbody>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">A</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Accumulator</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when Accumulator is triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p style="">X</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Register X</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when Index X is triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p>Y</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Register Y</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when Index Y is triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p>PC</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Program Counter</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when PC is triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p>S</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Stack Pointer</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when Stack Pointer is triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr>
|
|
|
|
<td width="10%">
|
|
<p>P</p>
|
|
|
|
</td>
|
|
|
|
<td width="25%">
|
|
<p>Processor Status (flags)</p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i>Break when flags are triggered.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h2><font size="4">Notes:</font></h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<p><i>BPP,
|
|
Breaking on a specific flag (either set, or cleared) is forth-coming in
|
|
a future version.</i></p>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>BPX < F000</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><font color="#ffffff"><i>Add
|
|
Breakpoint when PC < $<b><font color="#ffff00">FA62</font></b>.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>BPX PC < D000</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Add
|
|
Breakpoint when PC < $ <b><font color="#ffff00">D000</font>.</b></i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPR
|
|
A 0</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Adds
|
|
Breakpoint when Accumulator is zero.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPR
|
|
A ! 0</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Adds
|
|
Breakpoint when Accumulator is <b>not</b> zero.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BPR
|
|
S < 1FF</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Adds
|
|
Breakpoint when Stack has had something pushed onto it.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h2><a name="Configuration"></a>Configuration</h2>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<h3><a name="Colors"></a>Colors</h3>
|
|
|
|
<p>The commands to change color schemes, and colors are:</p>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Switch
|
|
to color scheme.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">MONO</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Switch
|
|
to monochrome scheme.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR
|
|
#</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Displays
|
|
the Red, Green, and Blue values for the specified color.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR
|
|
# # # #<br>
|
|
|
|
COLOR # R G B</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Sets
|
|
the colors to the new Red, Green, and Blue values.<br>
|
|
|
|
First # is the color.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<p><br>
|
|
|
|
<br>
|
|
|
|
</p>
|
|
|
|
<p>Some people prefer monochrome (easier on the eyes, in full
|
|
screen), so you may want to use that setting:</p>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="25%">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="75%">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>MONO</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><font color="#ffffff"><i>Switch to
|
|
the monochrome scheme.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>COLOR</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Switch to
|
|
the color scheme.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR
|
|
0 10 20 40</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p><font color="#ffffff"><i>Sets the
|
|
console background color to slate gray: RGB 10,20,40</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h3><a name="Fonts"></a>Fonts</h3>
|
|
|
|
<p>The font Type, and Spacing can be
|
|
configured, to show
|
|
more or less lines in the disassembly window.</p>
|
|
|
|
<br>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>FONT
|
|
MODE #</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Set
|
|
disassembler line spacing for the current font.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>FONT
|
|
“name”</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Switch
|
|
disassembler to new font.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>FONT
|
|
“name” #</b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Switch
|
|
disassembler to new font with specified height (in pixels)</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="799">
|
|
|
|
<col width="276"> <col width="515"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="276">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="515">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">FONT
|
|
MODE 0</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff">“<i>Classic”
|
|
Line Spacing. Shows the fewest amount of lines.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">FONT
|
|
MODE 1</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff">“<i>Improved”
|
|
Line Spacing. (Default)</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">FONT
|
|
MODE 2</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff">“<i>Minimal”
|
|
Line Spacing. Shows the most amount of lines.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">FONT
|
|
“Arial”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Switch
|
|
disassembler font to Arial.</i></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#30c0ff"><font face="Courier"><b><span style="background: rgb(0, 0, 0) none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">FONT
|
|
“Courier New”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="515">
|
|
<p><i>Switch disassembler font to Courier New.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h3><a name="Scripts"></a>Scripts</h3>
|
|
|
|
<p>
|
|
You can run custom batch or script files that contain debugger
|
|
commands. Scripts files do not echo their input; to print a
|
|
string to the output console window, use the <b>ECHO</b>
|
|
command.
|
|
</p>
|
|
|
|
<br>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
|
|
<col width="64*"> <col width="192*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>RUN </b></font></font><b><span style="font-family: Courier; color: black;">filename</span></b></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Runs the specified script filename; the
|
|
filename may be quoted</i><i>.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="25%">
|
|
<p><b><span style="font-family: Courier; color: black;">ECHO string</span></b></p>
|
|
|
|
</td>
|
|
|
|
<td width="75%">
|
|
<p><i>Echo the text to the debugger console. The
|
|
string may optionally be quoted.</i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="799">
|
|
|
|
<col width="276"> <col width="515"> <tbody>
|
|
|
|
<tr bgcolor="#00b8ff">
|
|
|
|
<td bgcolor="#30c0ff" width="276">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#30c0ff" width="515">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><b><span style="background: black none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; font-family: Courier; color: rgb(48, 192, 255);">RUN
|
|
“Test.txt”</span></b></p>
|
|
|
|
</td>
|
|
|
|
<td style="font-style: italic;" bgcolor="#000000" width="515"><span style="color: white;">Runs
|
|
the script file called: “Test.txt”</span></td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="276">
|
|
<p><b><span style="background: black none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial; font-family: Courier; color: rgb(48, 192, 255);">ECHO
|
|
“Hello World”</span></b></p>
|
|
|
|
</td>
|
|
|
|
<td style="font-style: italic;" bgcolor="#000000" width="515"><span style="color: white;">Prints
|
|
the classic “Hello World” to the output console.</span></td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h3><a name="Settings"></a>Settings</h3>
|
|
|
|
<p>Coming in a future revision, you can save or load your
|
|
debugger
|
|
settings, either piece wise, or as a whole. </p>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="90*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#000000">
|
|
|
|
<td bgcolor="#000000" width="35%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
</td>
|
|
|
|
<td bgcolor="#000000" width="65%">
|
|
<p style="font-style: normal;"><font color="#ffffff"><b>Effect</b></font></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CONFIG
|
|
LOAD</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Load
|
|
(default) debugger configuration.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CONFIG
|
|
LOAD “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Load
|
|
(named) debugger configuration</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CONFIG
|
|
SAVE</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Save
|
|
(default) debugger configuration.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">CONFIG
|
|
SAVE “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Save
|
|
(named) debugger configuration</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
|
|
|
<col width="90*"> <col width="166*"> <tbody>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR
|
|
LOAD “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Load
|
|
color configuration.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">COLOR
|
|
SAVE “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Save
|
|
color configuration</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#cccccc">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BP
|
|
LOAD “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Load
|
|
breakpoint configuration.</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
<tr bgcolor="#999999">
|
|
|
|
<td width="35%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">BP
|
|
SAVE “filename”</span></b></font></font></p>
|
|
|
|
</td>
|
|
|
|
<td width="65%">
|
|
<p><i><span style="background: transparent none repeat scroll 0% 50%; -moz-background-clip: initial; -moz-background-origin: initial; -moz-background-inline-policy: initial;">Save
|
|
breakpoint configuration</span></i></p>
|
|
|
|
</td>
|
|
|
|
</tr>
|
|
|
|
</tbody>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p>Hope you enjoyed the tour!</p>
|
|
|
|
<br>
|
|
|
|
</body>
|
|
</html>
|