mirror of
https://github.com/AppleWin/AppleWin.git
synced 2025-02-28 19:30:11 +00:00
2771 lines
81 KiB
HTML
2771 lines
81 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>
|
|
<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.4 (Win32)">
|
|
<META NAME="CREATED" CONTENT="20060221;8571315">
|
|
<META NAME="CHANGED" CONTENT="20060222;16075425">
|
|
<STYLE>
|
|
<!--
|
|
@page { size: 8.5in 11in }
|
|
TD P { margin-bottom: 0in }
|
|
-->
|
|
</STYLE>
|
|
</HEAD>
|
|
<BODY LANG="en-US" DIR="LTR">
|
|
<H1>AppleWin Debugger Tutorial</H1>
|
|
<P><FONT SIZE=4><I>By Michael Pohoreski.</I></FONT></P>
|
|
<P><FONT SIZE=3>Revision 2. Feb 22, 2006.</FONT></P>
|
|
<H2>Table of Contents</H2>
|
|
<UL>
|
|
<LI><A HREF="#Introduction">Introduction</A>
|
|
<LI><A HREF="#Debugger">Entering the Debugger</A>
|
|
<LI><A HREF="#Scrolling">Scrolling</A>
|
|
<LI><A HREF="#Registers">Registers</A>
|
|
<LI><A HREF="#Flags">Flags</A>
|
|
<LI><A HREF="#Execution">Execution</A>
|
|
<LI><A HREF="#Memory">Memory</A>
|
|
<LI><A HREF="#Symbols">Symbols</A>
|
|
<LI><A HREF="#Calculator">Calculator</A>
|
|
<LI><A HREF="#Breakpoints">Breakpoints</A>
|
|
<LI><A HREF="#Config">Configuration</A>
|
|
<UL>
|
|
<LI><A HREF="#Colors">Colors</A>
|
|
<LI><A HREF="#Fonts">Fonts</A>
|
|
<LI><A HREF="#Settings">Settings</A>
|
|
</UL>
|
|
</UL>
|
|
<H2><A NAME="Introduction"></A>Introduction</H2>
|
|
<P><FONT SIZE=4>If you're new to the debugger, this tutorial will
|
|
gently get you up to speed in becoming familiar with it.</FONT></P>
|
|
<P><FONT SIZE=4>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.</FONT></P>
|
|
<P><FONT SIZE=4>Let's get started on the tour!</FONT></P>
|
|
<H2><A NAME="Debugger"></A>Entering the Debugger</H2>
|
|
<P><FONT SIZE=4>Start AppleWin, and press <B><FONT FACE="Courier, monospace">F7</FONT></B>
|
|
to enter the debugger. </FONT>
|
|
</P>
|
|
<P><FONT SIZE=4>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 </FONT><A HREF="#Colors"><FONT SIZE=4>Colors</FONT></A>
|
|
<FONT SIZE=4>section for details.</FONT></P>
|
|
<P><FONT SIZE=4>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.</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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>~<BR></B><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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>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. </FONT>
|
|
</P>
|
|
<P><FONT SIZE=4>This typeface, and color will be used to designate
|
|
commands you can type into the debugger. </FONT>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Effect</B></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">HELP</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Display Help for specific command.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">?</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Display Help Summary.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">VERSION</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Display both the AppleWin and Debugger
|
|
Version.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4><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></FONT>
|
|
</P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><A NAME="Scrolling"></A>Scrolling</H2>
|
|
<P><FONT SIZE=4>In the disassembly view, the following keys &
|
|
commands can be used: </FONT>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P STYLE="font-style: normal"><FONT COLOR="#ffffff"><B>Effect</B></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">U
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Start disassembly from
|
|
Value or Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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-weight: medium"><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-weight: medium"><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-weight: medium"><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-weight: medium"><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="font-weight: medium">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="font-weight: medium">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-weight: medium"><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-weight: medium"><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="font-weight: medium">^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="font-weight: medium">^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="font-weight: medium">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="font-weight: medium">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-weight: medium"><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-weight: medium"><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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><A NAME="Registers1"></A>Registers</H2>
|
|
<P><FONT SIZE=4>The command line now recognizes 6502 Registers.
|
|
Namely, </FONT>
|
|
</P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><B>A</B>, the
|
|
Accumulator,</FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><B>X</B>, the 1<SUP>st</SUP>
|
|
Index Register,</FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><B>Y</B>, the 2<SUP>nd</SUP>
|
|
Index Register,</FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><B>PC</B>, the
|
|
Program Counter, </FONT>
|
|
</P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><B>S</B>, the Stack
|
|
Pointer, and </FONT>
|
|
</P>
|
|
<LI><P><FONT SIZE=4><B>P</B>, the Processor Status Register (Flags).</FONT></P>
|
|
</UL>
|
|
<P><FONT SIZE=4>You can set a Register to a hex Value, Symbol, or
|
|
Expression. (See the section </FONT><A HREF="#Calculator"><FONT SIZE=4>Calculator</FONT></A>
|
|
<FONT SIZE=4>for more examples of using expressions.) The
|
|
syntax is:</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#e6e6e6">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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">R
|
|
r [=] ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set Register to (a
|
|
byte) Value, Symbol, or Address, or Expression.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">R
|
|
A ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">R
|
|
X ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set Register X to (a
|
|
byte) Value</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">R
|
|
Y ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">R
|
|
PC ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set PC to (a full
|
|
16-bit) Address (Value)</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">R
|
|
S ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">R
|
|
P ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set Processor Status
|
|
Register (flags) to (a byte) Value</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Notes</B>:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><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></FONT></P>
|
|
</UL>
|
|
<UL>
|
|
<LI><P><FONT SIZE=4><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></FONT></P>
|
|
<LI><P><FONT SIZE=4><I>If a symbol is not defined, the expression
|
|
will be the corresponding hex Value, if possible.</I></FONT></P>
|
|
<LI><P><FONT SIZE=4><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></FONT></P>
|
|
</UL>
|
|
<P><FONT SIZE=4><B>Examples</B>:</FONT></P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
PC RESET + 1</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
X 2 </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Register to Value <FONT COLOR="#ffff00">2</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
Y 3 </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Register to Value <FONT COLOR="#ffff00">3</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
S 1FE </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
S FF </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Stack Pointer to top of stack
|
|
(Empty)</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A 0A </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Accumulator to hex Value <FONT COLOR="#ffff00">0A</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A #A </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Accumulator to hex Value <FONT COLOR="#ffff00">0A</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
X A </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Register X to Accumulator’s
|
|
Value</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A A1 </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 COLOR="#ffff00">A1</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A $A1 </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 COLOR="#ffff00">A1</FONT></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A #A1 </SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Sets Accumulator to the hex value <B><FONT COLOR="#ffff00">A1</FONT></B></I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><A NAME="Flags"></A>Flags</H2>
|
|
<P><FONT SIZE=4>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. </FONT>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Notes</B>:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><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></FONT></P>
|
|
</UL>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>Commands to set a flag:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#c0c0c0">
|
|
<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">SEC
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Carry </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#e6e6e6">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SEZ
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Zero </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SEI
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Interrupts
|
|
Disabled </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#e6e6e6">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SED
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">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">SEB
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Break </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#e6e6e6">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SER
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">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">SEV
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Overflow </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#e6e6e6">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SEN
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Set Negative </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>Commands to clear a flag:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<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="#c0c0c0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLC
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Carry </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#d0d0d0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLZ
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Zero </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#c0c0c0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLI
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Interrupts
|
|
Disabled </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#d0d0d0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLD
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Decimal (BCD)
|
|
mode </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#c0c0c0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLB
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Break </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#d0d0d0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLR
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Reserved (not
|
|
used on 6502)</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#c0c0c0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLV
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Overflow </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#d0d0d0">
|
|
<TD>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CLN
|
|
</SPAN></B></FONT></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD>
|
|
<P><I><SPAN STYLE="background: transparent">Clear Negative </SPAN></I>
|
|
</P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2>Execution</H2>
|
|
<P><FONT SIZE=4>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: </FONT>
|
|
</P>
|
|
<TABLE WIDTH=666 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=161>
|
|
<COL WIDTH=494>
|
|
<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 WIDTH=161 BGCOLOR="#ffff00">
|
|
<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 WIDTH=161 BGCOLOR="#cccc00">
|
|
<P>Yellow (Dim)</P>
|
|
</TD>
|
|
<TD WIDTH=494>
|
|
<P><I>Line is next 6502 instruction (At 6502 PC).</I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD WIDTH=161 BGCOLOR="#ff0000">
|
|
<P>Red (Bright)</P>
|
|
</TD>
|
|
<TD WIDTH=494>
|
|
<P><I>Cursor is on active Breakpoint.</I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>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>’. </FONT></P>
|
|
<P><FONT SIZE=4>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 New, monospace">I’</FONT>
|
|
at $FA75.</FONT></P>
|
|
<P><FONT SIZE=4>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. </FONT>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Notes</B>:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><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></FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><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></FONT></P>
|
|
</UL>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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-weight: medium"><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-weight: medium">^<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-weight: medium">^<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-weight: medium">^<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-weight: medium"><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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=90*>
|
|
<COL WIDTH=166*>
|
|
<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="#c0c0c0">
|
|
<TD WIDTH=35%>
|
|
<P>G [StopAddress]
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I>Resume execution until PC = StopAddress.</I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#d0d0d0">
|
|
<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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=90*>
|
|
<COL WIDTH=166*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=35% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=35% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">G C600 D000,3000</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Single-step until either PC = $C600,
|
|
or PC <= $D000</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2>Memory</H2>
|
|
<P><FONT SIZE=4>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.</FONT></P>
|
|
<P><FONT SIZE=4>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.</FONT></P>
|
|
<P><FONT SIZE=4>Here is a summary:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>Normal ASCII
|
|
(non-control characters) will show up in cyan; High-Bit text in
|
|
white.</I></FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>Apple TEXT (normal
|
|
ASCII) will also display with an inverse background; High-Bit with a
|
|
normal background.</I></FONT></P>
|
|
</UL>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P STYLE="font-style: normal"><FONT COLOR="#ffffff"><B>Effect</B></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">M1
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 1 in
|
|
Hex at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">M2
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 2 in
|
|
Hex at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">MA1
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 1 in
|
|
ASCII at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">MA2
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 2 in
|
|
ASCII at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">MT1
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 1 in
|
|
“Apple Text” at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">MT2
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">View mini-memory 1 in
|
|
“Apple Text” at the Address</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">D
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias for M1</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">NOP</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Writes an “NOP”
|
|
opcode (EA) at the current PC</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">ZAP</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias for NOP.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Examples</B>:</FONT></P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input </B></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">MT2
|
|
FF0A</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>View Apple message displayed when
|
|
booted, showing Apple Model.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">DATA</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CODE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Switch to the Code Window to view the
|
|
disassembler.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><A NAME="Calculator"></A>Calculator</H2>
|
|
<P><FONT SIZE=4>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.)</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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="font-weight: medium">+</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="font-weight: medium">-</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="font-weight: medium">%</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="font-weight: medium">/</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="font-weight: medium">&
|
|
</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="font-weight: medium">|
|
|
</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="font-weight: medium">^</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="font-weight: medium">!</P>
|
|
</TD>
|
|
<TD WIDTH=25%>
|
|
<P>Exclamation</P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I>Bit-Wise NOT.</I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><FONT SIZE=4>Notes:</FONT></H2>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>The unary bit-wise
|
|
Negation operator, ‘!’ only effects the next immediate
|
|
expression.</I></FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>There is
|
|
(currently) no multiplication operator, due to the asterisk ‘*’
|
|
being used for the wild card operator.</I></FONT></P>
|
|
</UL>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input </B></FONT>
|
|
</P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
A 1</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Accumulator to 1.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
X 2</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set X to 2.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">R
|
|
Y 3</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Set Y to 3.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
A+X+Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate sum of registers.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
1FF-S</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate Stack Depth.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
BRKV+1</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
A+#A</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate Accumulator plus (decimal)
|
|
10.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
A+0A</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate Accumulator plus (decimal)
|
|
10.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
A+$0A</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate Accumulator plus (decimal)
|
|
10.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
0A+0A</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate 10 + 10, in hex.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
$RESET+1</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
!HOME</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate bit-wise NOT.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
X & Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate bit-wise AND of Register X ,
|
|
Register Y.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
X | Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate bit-wise OR of Register X ,
|
|
Register Y.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
X ^ Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate bit-wise XOR of Register X ,
|
|
Register Y.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
X / Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate division of Register X ,
|
|
Register Y.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">CALC
|
|
X % Y</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Calculate remainder of Register X ,
|
|
Register Y.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</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 WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P STYLE="font-style: normal"><FONT COLOR="#ffffff"><B>Effect</B></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">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">CONSOLE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">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">CODE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">WIN
|
|
DATA</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">DATA</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>You can cycle between windows, using these keys:</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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>
|
|
</TABLE>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
<H2><A NAME="Symbols"></A>Symbols</H2>
|
|
<P><FONT SIZE=4>AppleWin supports loading of ACME, and Merlin Symbol
|
|
Tables. The default filename read into the Main Symbol Table is
|
|
“APPLE2E.SYM”.</FONT></P>
|
|
<P><FONT SIZE=4>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:</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=80% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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">SYM</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Display the number of
|
|
symbols in the Main, User, and Source symbol tables.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SYM
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Look-up the Symbol or
|
|
Address, and display which Symbol Table it is in.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SYMUSER
|
|
LOAD</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Loads the User Symbol
|
|
Table.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SYMUSER
|
|
CLEAR</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">SYMMAIN
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Look-up only in the
|
|
Main symbol table.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SYMUSER
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">SYMSRC
|
|
####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Look-up only in the
|
|
Source symbol table.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SYM
|
|
name = ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">SYM
|
|
! name</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Remove a symbol from
|
|
the User table.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">E
|
|
symbol ##</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set memory (at the
|
|
symbol Address) to the 8-Bit (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">EB
|
|
symbol ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">E8
|
|
symbol ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">EW
|
|
symbol ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set memory (at the
|
|
symbol Address) to the 16-Bit (word) Value.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">E16
|
|
symbol ####</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Alias</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Examples</B>:</FONT></P>
|
|
<TABLE WIDTH=799 BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=276>
|
|
<COL WIDTH=515>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=276 BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#30c0ff">
|
|
<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 WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B>SYM FA62</B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<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 WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">SYM
|
|
HOME</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<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 WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">SYM
|
|
LIFE = 300</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Define a new user symbol, called
|
|
“Life” at Address $0300.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">E
|
|
LIFE 64</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<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 WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">EW
|
|
LIFE 3E8</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><A NAME="Source"></A>Source</H2>
|
|
<P><FONT SIZE=4>Another new feature is source level debugging.
|
|
Parsing assembly source has the option of:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>Reading in your
|
|
define symbols into the Source Symbol Table.</I></FONT></P>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>Reading in your
|
|
binary program into Apple Memory.</I></FONT></P>
|
|
</UL>
|
|
<P><FONT SIZE=4>Supported assembler source formats include: Merlin.</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=80% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=90*>
|
|
<COL WIDTH=166*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=35% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65% BGCOLOR="#000000">
|
|
<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">SOURCE
|
|
filename</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Read in the assembler
|
|
source.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SOURCE
|
|
SYM filename</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">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">SOURCE
|
|
MEM filename</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Read in the assembler
|
|
source, storing bytes into memory.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SOURCE
|
|
SYM MEM filename</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Add both symbols, and
|
|
store bytes into memory.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SOURCE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Turn off source level
|
|
debugging.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">SOURCE2</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Split the dissembler
|
|
view, with source in bottom half.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</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 WIDTH=799 BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=276>
|
|
<COL WIDTH=515>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=276 BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#30c0ff">
|
|
<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>
|
|
</TABLE>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
<H2><A NAME="Breakpoints"></A>Breakpoints</H2>
|
|
<P><FONT SIZE=4>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.</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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">BPA
|
|
r [op] value</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">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">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">BP</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">BPM
|
|
address[,len]</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">BPR
|
|
reg [op] value</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Add Breakpoint trigger
|
|
when Register’s ‘reg’ value is compared to the
|
|
Value.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">BD</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">BE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Enable Breakpoint
|
|
(colored red).</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">BC
|
|
#</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">BL</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">List Breakpoints.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">BPIO</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">(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">BPP</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">(In a future version,
|
|
will add Breakpoint trigger on specific flag cleared or set.)</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>The general format for the conditional breakpoint is:</FONT></P>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>BPA register
|
|
[operator] value.</I></FONT></P>
|
|
</UL>
|
|
<P><FONT SIZE=4>You can use the following comparison operators:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=26*>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=166*>
|
|
<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="font-weight: medium">=</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="font-weight: medium">!</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="font-weight: medium"><</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="font-weight: medium">></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>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4>Breaking on any of the 6502 registers is fully
|
|
supported:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=1 CELLPADDING=2 CELLSPACING=0>
|
|
<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="font-weight: medium">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="font-weight: medium">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>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H2><FONT SIZE=4>Notes:</FONT></H2>
|
|
<UL>
|
|
<LI><P STYLE="margin-bottom: 0in"><FONT SIZE=4><I>BPP, Breaking on a
|
|
specific flag (either set, or cleared) is forth-coming in a future
|
|
version.</I></FONT></P>
|
|
</UL>
|
|
<P><FONT SIZE=4><B>Examples</B>:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B>BPX PC < D000</B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">BPR
|
|
A 0</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Adds Breakpoint when Accumulator is
|
|
zero.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">BPR
|
|
A ! 0</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Adds Breakpoint when Accumulator is
|
|
<B>not</B> zero.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">BPR
|
|
S < 1FF</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Adds Breakpoint when Stack has had
|
|
something pushed onto it.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</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 WIDTH=80% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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">COLOR</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Switch to color
|
|
scheme.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">MONO</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">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">COLOR
|
|
#</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Displays the Red,
|
|
Green, and Blue values for the specified color.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">COLOR
|
|
# # # #<BR>COLOR # R G B</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Sets the colors to the
|
|
new Red, Green, and Blue values.<BR>First # is the color.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</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>
|
|
<P><BR><BR>
|
|
</P>
|
|
<P><FONT SIZE=4><B>Examples</B>:</FONT></P>
|
|
<TABLE WIDTH=75% BORDER=0 CELLPADDING=2 CELLSPACING=0 BGCOLOR="#000000">
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=25% BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#30c0ff">
|
|
<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 WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B>COLOR</B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Switch to the color scheme.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#00b8ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">COLOR
|
|
0 10 20 40</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Sets the console background color to
|
|
slate gray: RGB 10,20,40</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<H3><A NAME="Fonts"></A>Fonts</H3>
|
|
<P><FONT SIZE=4>The font Type, and Spacing can be configured, to show
|
|
more or less lines in the disassembly window.</FONT></P>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=80% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=64*>
|
|
<COL WIDTH=192*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=25% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75% BGCOLOR="#000000">
|
|
<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">FONT
|
|
MODE #</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Set disassembler line
|
|
spacing for the current font.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">FONT
|
|
“name”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Switch disassembler to
|
|
new font.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=25%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">FONT
|
|
“name” #</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=75%>
|
|
<P><I><SPAN STYLE="background: transparent">Switch disassembler to
|
|
new font with specified height (in pixels)</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=799 BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=276>
|
|
<COL WIDTH=515>
|
|
<TR BGCOLOR="#00b8ff">
|
|
<TD WIDTH=276 BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Input</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#30c0ff">
|
|
<P><FONT COLOR="#000000"><B>Effect</B></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">FONT
|
|
MODE 0</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff">“<I>Classic” Line Spacing.
|
|
Shows the fewest amount of lines.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">FONT
|
|
MODE 1</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff">“<I>Improved” Line Spacing.
|
|
(Default)</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">FONT
|
|
MODE 2</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff">“<I>Minimal” Line Spacing.
|
|
Shows the most amount of lines.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">FONT
|
|
“Arial”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><I>Switch disassembler font to Arial.</I></FONT></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=276 BGCOLOR="#000000">
|
|
<P><FONT COLOR="#30c0ff"><FONT FACE="Courier"><B><SPAN STYLE="background: #000000">FONT
|
|
“Courier New”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=515 BGCOLOR="#000000">
|
|
<P><I>Switch disassembler font to Courier New.</I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P><BR><BR>
|
|
</P>
|
|
<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>
|
|
<P><BR><BR>
|
|
</P>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=90*>
|
|
<COL WIDTH=166*>
|
|
<TR BGCOLOR="#000000">
|
|
<TD WIDTH=35% BGCOLOR="#000000">
|
|
<P><FONT COLOR="#ffffff"><B>Command</B></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65% BGCOLOR="#000000">
|
|
<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">CONFIG
|
|
LOAD</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Load (default)
|
|
debugger configuration.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CONFIG
|
|
LOAD “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">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">CONFIG
|
|
SAVE</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Save (default)
|
|
debugger configuration.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">CONFIG
|
|
SAVE “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Save (named) debugger
|
|
configuration</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<TABLE WIDTH=90% BORDER=0 CELLPADDING=2 CELLSPACING=0>
|
|
<COL WIDTH=90*>
|
|
<COL WIDTH=166*>
|
|
<TR BGCOLOR="#cccccc">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">COLOR
|
|
LOAD “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Load color
|
|
configuration.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">COLOR
|
|
SAVE “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">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">BP
|
|
LOAD “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Load breakpoint
|
|
configuration.</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
<TR BGCOLOR="#b3b3b3">
|
|
<TD WIDTH=35%>
|
|
<P><FONT COLOR="#000000"><FONT FACE="Courier"><B><SPAN STYLE="background: transparent">BP
|
|
SAVE “filename”</SPAN></B></FONT></FONT></P>
|
|
</TD>
|
|
<TD WIDTH=65%>
|
|
<P><I><SPAN STYLE="background: transparent">Save breakpoint
|
|
configuration</SPAN></I></P>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
<P STYLE="margin-bottom: 0in">Hope you enjoyed the tour!</P>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
<P STYLE="margin-bottom: 0in"><BR>
|
|
</P>
|
|
</BODY>
|
|
</HTML><!-- text below generated by server. PLEASE REMOVE --><!-- Counter/Statistics data collection code --><script language="JavaScript" src="http://hostingprod.com/js_source/geov2.js"></script><script language="javascript">geovisit();</script><noscript><img src="http://visit.webhosting.yahoo.com/visit.gif?us1141853943" alt="setstats" border="0" width="1" height="1"></noscript>
|
|
<IMG SRC="http://geo.yahoo.com/serv?s=76001405&t=1141853943&f=p6w3" ALT=1 WIDTH=1 HEIGHT=1>
|