2002-10-02 22:00:46 +00:00
|
|
|
<HTML><HEAD><TITLE>X-Assembler 2.5.2</TITLE></HEAD>
|
1999-09-09 23:20:00 +00:00
|
|
|
<BODY BACKGROUND="6502proc.gif">
|
|
|
|
|
<CENTER>
|
2002-10-02 22:00:46 +00:00
|
|
|
<H1>X-Assembler version 2.5.2</H1>
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<H2>TABLE OF CONTENTS</H2>
|
2002-07-08 13:22:54 +00:00
|
|
|
<TABLE><TR><TD VALIGN=top>
|
2000-02-10 17:00:00 +00:00
|
|
|
<UL><LI><A HREF="#intro">INTRODUCTION</A>
|
|
|
|
|
<UL><LI><A HREF="#changes">Changes</A>
|
2002-10-02 22:00:46 +00:00
|
|
|
<UL><LI><A HREF="#ver252">Version 2.5.2</A>
|
|
|
|
|
<LI><A HREF="#ver251">Version 2.5.1</A>
|
2002-08-21 18:07:04 +00:00
|
|
|
<LI><A HREF="#ver25">Version 2.5</A>
|
2002-07-06 22:12:34 +00:00
|
|
|
<LI><A HREF="#ver241">Version 2.4.1</A>
|
2002-06-27 11:26:04 +00:00
|
|
|
<LI><A HREF="#ver24">Version 2.4</A>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI><A HREF="#ver23">Version 2.3</A>
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI><A HREF="#ver22">Version 2.2</A>
|
|
|
|
|
<LI><A HREF="#ver20">Version 2.0</A>
|
|
|
|
|
<LI><A HREF="#ver12">Version 1.2</A>
|
|
|
|
|
</UL></UL><LI><A HREF="#usage">USAGE</A>
|
|
|
|
|
<UL><LI><A HREF="#sysreq">System requirements</A>
|
|
|
|
|
<LI><A HREF="#srcreq">Source code requirements</A>
|
|
|
|
|
<LI><A HREF="#convqa">Converting Quick Assembler files</A>
|
|
|
|
|
<LI><A HREF="#asm">Assembling a source program</A>
|
|
|
|
|
<LI><A HREF="#opts">Assembling options</A>
|
|
|
|
|
<LI><A HREF="#exitcod">Exit codes</A>
|
|
|
|
|
<LI><A HREF="#listing">Listing structure</A>
|
|
|
|
|
<LI><A HREF="#labtab">Label table structure</A>
|
|
|
|
|
</UL>
|
2002-06-27 11:26:04 +00:00
|
|
|
</TD><TD VALIGN=top>
|
|
|
|
|
<UL><LI><A HREF="#syntax">SYNTAX</A>
|
2000-02-10 17:00:00 +00:00
|
|
|
<UL><LI><A HREF="#fields">Fields</A>
|
|
|
|
|
<UL><LI><A HREF="#label">Label field</A>
|
|
|
|
|
<LI><A HREF="#repeat">Repeat count</A>
|
|
|
|
|
<LI><A HREF="#instr">Instruction field</A>
|
|
|
|
|
<LI><A HREF="#operand">Operand field</A>
|
|
|
|
|
<LI><A HREF="#comment">Comment</A>
|
|
|
|
|
</UL><LI><A HREF="#expr">Expressions</A>
|
|
|
|
|
<UL><LI><A HREF="#numbers">Numbers</A>
|
|
|
|
|
<LI><A HREF="#operators">Operators</A>
|
|
|
|
|
</UL><LI><A HREF="#directives">Directives</A>
|
|
|
|
|
<LI><A HREF="#pseudocom">Pseudo-commands</A>
|
|
|
|
|
<LI><A HREF="#adrmod">Addressing modes</A>
|
|
|
|
|
</UL><LI><A HREF="#faq">FAQ</A>
|
|
|
|
|
</UL>
|
|
|
|
|
</TD></TR></TABLE></CENTER>
|
|
|
|
|
<P><HR>
|
|
|
|
|
<A NAME="intro"><H2>INTRODUCTION</H2>
|
2002-05-22 10:24:30 +00:00
|
|
|
The X-Assembler is a cross-assembler, which generates code for the 6502 processor.
|
2000-02-10 17:00:00 +00:00
|
|
|
It has been designed to be easy to use for Quick Assembler programmers,
|
2002-08-21 18:07:04 +00:00
|
|
|
therefore its syntax is an extension of QA's.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="changes"><H3>Changes</H3>
|
2002-10-02 22:00:46 +00:00
|
|
|
<A NAME="ver252"><H4>Version 2.5.2</H4>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> version 2.5.1 broke Unix EOLs - fixed
|
|
|
|
|
<LI> version 2.5.1 omitted all blank/comment/label lines, unless <TT>/c</TT> was used
|
|
|
|
|
</UL>
|
2002-08-21 18:07:04 +00:00
|
|
|
<A NAME="ver251"><H4>Version 2.5.1</H4>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> fixed assembling sources with Atari EOLs ($9b)
|
|
|
|
|
<LI> blank/comment/label lines in false conditionals are now correctly omitted in listing
|
|
|
|
|
</UL>
|
2002-07-08 13:22:54 +00:00
|
|
|
<A NAME="ver25"><H4>Version 2.5</H4>
|
2002-07-06 22:12:34 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> fixed another bug, very similar to previous one, e.g.
|
|
|
|
|
<PRE> ift 0
|
|
|
|
|
:label nop
|
|
|
|
|
eif
|
|
|
|
|
</PRE>
|
|
|
|
|
reported <TT>Label not defined before</TT> error for the repeat count.
|
2002-07-08 13:22:54 +00:00
|
|
|
<LI> <A HREF="#new_opt"><TT>OPT F+</TT> causes <TT>ORG</TT>s to fill the space between old and new
|
|
|
|
|
location with <TT>$FF</TT>s</A>
|
|
|
|
|
<LI> <A HREF="#new_opt"><TT>OPT G+</TT> enables Atari 5200 mode for hardware register abbreviations</A>
|
2002-07-06 22:12:34 +00:00
|
|
|
</UL>
|
2002-06-27 11:26:04 +00:00
|
|
|
<A NAME="ver241"><H4>Version 2.4.1</H4>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> fixed a bug related to label definitions in conditionally skipped code, e.g.
|
|
|
|
|
<PRE> ift 0
|
|
|
|
|
label
|
|
|
|
|
eif
|
|
|
|
|
</PRE>
|
|
|
|
|
reported <TT>No ORG specified</TT> error for the label definition.
|
|
|
|
|
</UL>
|
2002-05-22 10:24:30 +00:00
|
|
|
<A NAME="ver24"><H4>Version 2.4</H4>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> fixed a bug causing incorrect unary operator precedence
|
|
|
|
|
<LI> fixed wrong label value after a skip pseudo-command
|
|
|
|
|
<LI> the assembler is .EXE (.COM caused problems with DJGPP make due
|
|
|
|
|
to a bug in DJGPP runtime)
|
|
|
|
|
<LI> the assembler is not compressed (so it occupies less space in the ZIP)
|
|
|
|
|
<LI> improved command-line parsing: options may be used before source file
|
|
|
|
|
name, tab character is a valid separator, <TT>/</TT> may be used as directory
|
|
|
|
|
separator (Unix convention)
|
|
|
|
|
<LI> error and warning messages are written to stderr, not stdout
|
|
|
|
|
<LI> added <TT>==</TT> (equal) operator, which is equivalent to <TT>=</TT>
|
|
|
|
|
(but is more natural for C/C++/Java programmers)
|
|
|
|
|
<LI> <A HREF="#new_deflabel">added <TT>/d:label=value</TT> option: define a label</A>
|
|
|
|
|
<LI> <A HREF="#new_fullpaths">added <TT>/p</TT> option: print full paths in listing and error messages</A>
|
|
|
|
|
<LI> <A HREF="#new_quiet">added <TT>/q</TT> option: quiet mode</A>
|
|
|
|
|
<LI> <A HREF="#new_unlabels">added <TT>/u</TT> option: warn of unused labels</A>
|
2002-07-08 13:22:54 +00:00
|
|
|
<LI> <A HREF="#new_opt">writing to the object file may be suppressed with <TT>OPT O-</TT></A>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> <A HREF="#new_eli">added <TT>ELI</TT> (else if) directive</A>
|
|
|
|
|
<LI> <A HREF="#new_mwinde"><TT>MWX</TT> and <TT>MWY</TT> may use <TT>INX</TT>/<TT>DEX</TT>
|
|
|
|
|
and <TT>INY</TT>/<TT>DEY</TT>, respectively, for generating smaller code</A>
|
|
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="ver23"><H4>Version 2.3</H4>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> double skip (e.g. <TT>SCC:SNE</TT>) bug fixed
|
|
|
|
|
<LI> real number two-digit exponent bug fixed
|
|
|
|
|
<LI> truncating line trailing spaces in listing
|
|
|
|
|
<LI> <A HREF="#new_labdef">label definitions allowed in blank,
|
|
|
|
|
comment and repeated lines</A>
|
|
|
|
|
<LI> <A HREF="#new_unary">unary operators</A>
|
|
|
|
|
<LI> <A HREF="#new_dta"><TT>DTA</TT> implied byte mode</A>
|
|
|
|
|
<LI> <A HREF="#new_op_op">operand can be skipped for some op-codes</A>
|
|
|
|
|
</UL>
|
|
|
|
|
<A NAME="ver22"><H4>Version 2.2</H4>
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> invalid absolute <TT>CPX</TT> and <TT>CPY</TT> op-codes bug fixed
|
|
|
|
|
<LI> branch addressing mode not checking bug fixed
|
|
|
|
|
<LI> <TT>ICL</TT> in last line bug fixed
|
|
|
|
|
<LI> <TT>OPT H-H+</TT> bug fixed
|
|
|
|
|
<LI> first <TT>ORG *</TT> bug fixed
|
|
|
|
|
<LI> origin setting not required until not used
|
|
|
|
|
<LI> Unix ($0a), Macintosh ($0d) and Atari ($9b) EOLs allowed in source
|
|
|
|
|
<LI> value of 'true' changed to 1
|
|
|
|
|
<LI> <A HREF="#new_environment">
|
|
|
|
|
setting environment variables on error option</A>
|
|
|
|
|
<LI> <A HREF="#new_newer">
|
|
|
|
|
assembling only if source newer than object option</A>
|
|
|
|
|
<LI> <A HREF="#new_opcode">op-code extracting</A>
|
|
|
|
|
<LI> <A HREF="#new_linerep">line repeating</A>
|
|
|
|
|
<LI> <A HREF="#new_pairing">instructions pairing</A>
|
|
|
|
|
<LI> <A HREF="#new_repskip">conditional repeat and skip pseudo commands</A>
|
|
|
|
|
<LI> <A HREF="#new_adrmodes">
|
|
|
|
|
<TT>(),0+</TT> and <TT>(),0-</TT> pseudo addressing modes</A>
|
|
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="ver20"><H4>Version 2.0</H4>
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> truncating name of object bug fixed
|
|
|
|
|
<LI> <TT>EQU</TT> and <TT>DTA</TT> forward reference bugs fixed
|
|
|
|
|
<LI> hex number recognizing bug fixed
|
|
|
|
|
<LI> now <TT>.OBX</TT> is default extension for Atari executables
|
|
|
|
|
<LI> assembling options (switches and <TT>OPT</TT> directive)
|
|
|
|
|
<LI> listing generation
|
|
|
|
|
<LI> label table generation
|
|
|
|
|
<LI> conditional assembling
|
|
|
|
|
<LI> user errors
|
|
|
|
|
<LI> warnings
|
|
|
|
|
<LI> improved headers generation
|
|
|
|
|
<LI> improved expressions - 19 operators and brackets, 32-bit arithmetic
|
|
|
|
|
<LI> improved signed numbers
|
|
|
|
|
<LI> 6 new pseudo commands (memory-to-memory move)
|
|
|
|
|
<LI> 8 pseudo addressing modes
|
|
|
|
|
<LI> indirect conditional jumps
|
|
|
|
|
<LI> Atari floating-point numbers generation
|
|
|
|
|
<LI> improved <TT>INS</TT>: inserting specified part of file
|
|
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="ver12"><H4>Version 1.2</H4>
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> first release
|
|
|
|
|
</UL>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<A NAME="usage"><H2>USAGE</H2>
|
|
|
|
|
<A NAME="sysreq"><H3>System requirements</H3>
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> a PC compatible computer with 386 or better CPU
|
2002-05-22 10:24:30 +00:00
|
|
|
(a numeric coprocessor is required for generating sine lookup tables)
|
1999-09-09 23:20:00 +00:00
|
|
|
<LI> a MS-DOS compatible OS
|
|
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="srcreq"><H3>Source code requirements</H3>
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> Source file should be plain ASCII file.
|
|
|
|
|
Although different EOLs are supported,
|
|
|
|
|
CR/LF is recommended because it is standard for text files on PC.
|
|
|
|
|
<LI> No line of source can be longer than 256 characters.
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> There is no limitation on the length of the source file.
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI> Tabulators can be used in place of spaces.
|
|
|
|
|
<LI> The assembler is not case-sensitive.
|
|
|
|
|
</UL>
|
|
|
|
|
<A NAME="convqa"><H3>Converting Quick Assembler files</H3>
|
|
|
|
|
Because of possible editor-associated problems you had better convert
|
|
|
|
|
an Atari text file to a regular PC text file, i.e. EOLs from $9b to $0d/$0a
|
|
|
|
|
and ATASCII specific characters to their integer representation.<BR>
|
|
|
|
|
You have to change all <TT>OPT</TT> directives,
|
|
|
|
|
but usually you only need to remove them.<BR>
|
|
|
|
|
<A NAME="asm"><H3>Assembling a source program</H3>
|
|
|
|
|
The common syntax of invoking command line is following:<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE>XASM source [options]
|
2000-02-10 17:00:00 +00:00
|
|
|
</PRE><TT>source</TT> is the name of source file.
|
|
|
|
|
If no extension is given, the .ASX is implied.<P>
|
|
|
|
|
Default action on invoking without options is to compile
|
|
|
|
|
writing to a file with the .OBX extension.<P>
|
|
|
|
|
<A NAME="opts"><H3>Assembling options</H3>
|
|
|
|
|
Following options are supported:
|
1999-09-09 23:20:00 +00:00
|
|
|
<DL>
|
|
|
|
|
<DT><TT>/c</TT>
|
|
|
|
|
<DD>Enable listing false conditionals.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
By default lines skipped due to false condition are not listed.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
<A NAME="new_deflabel">
|
|
|
|
|
<DT><TT>/d:label=value</TT>
|
|
|
|
|
<DD>Define a label.<BR>
|
|
|
|
|
<TT>label</TT> should be a valid label name.
|
|
|
|
|
<TT>value</TT> may be any expression (it may use forward references
|
|
|
|
|
to labels defined in the source file).
|
|
|
|
|
You may use several <TT>/d</TT> options to define many labels
|
|
|
|
|
from the command line.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<A NAME="new_environment">
|
|
|
|
|
<DT><TT>/e</TT>
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>Enable setting environment variables pointing to the error location.<BR>
|
|
|
|
|
With this option, X-Asm sets two environment variables:
|
|
|
|
|
ERRFILE and ERRLINE.
|
|
|
|
|
They may be used in a batch file to locate error and set editor's
|
2002-05-22 10:24:30 +00:00
|
|
|
insertion point on it. For example, you may create following batch file:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE>XASM %1 /e
|
|
|
|
|
IF NOT ERRORLEVEL 1 GOTO ok
|
|
|
|
|
NCE +%ERRLINE% %ERRFILE%
|
2002-05-22 10:24:30 +00:00
|
|
|
:ok
|
1999-09-09 23:20:00 +00:00
|
|
|
</PRE>
|
|
|
|
|
NCE stands for Norton Classic Editor.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
If there was no error, variables point to the last issued warning.
|
1999-09-09 23:20:00 +00:00
|
|
|
If no warning occured, they are removed from the environment.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
<B>Note:</B> NCE is an old editor for DOS. To learn about integration with
|
|
|
|
|
modern text editors for Windows <A HREF="editors.htm">read this</A>.
|
|
|
|
|
<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<DT><TT>/i</TT>
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>Disable listing included source. Only main source file will be listed.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
<DT><TT>/l[:filename]</TT>
|
1999-09-09 23:20:00 +00:00
|
|
|
<DD>Enable generating listing.
|
2002-05-22 10:24:30 +00:00
|
|
|
If no <TT>filename</TT> given, listing is written to <TT>source.lst</TT>
|
|
|
|
|
(where <TT>source</TT> is the name of the source file (without extension).<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<A NAME="new_newer">
|
|
|
|
|
<DT><TT>/n</TT>
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>Check source and object file modification time and assemble only
|
1999-09-09 23:20:00 +00:00
|
|
|
if source is newer than object file. X-Asm does NOT check included
|
|
|
|
|
nor inserted files but only main source, so be careful with this option.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
<B>Note:</B> Much more powerful for this purpose is GNU make utility.
|
|
|
|
|
In DOS and Windows you may use its DJGPP port (available from
|
|
|
|
|
<A HREF="http://www.delorie.com/djgpp">http://www.delorie.com/djgpp</A>).<P>
|
|
|
|
|
<DT><TT>/o:filename</TT>
|
|
|
|
|
<DD>Specify object file name. Default is <TT>source.obx</TT>.
|
|
|
|
|
You may use the null device (<TT>/o:nul</TT>) to generate no object file.<P>
|
|
|
|
|
<A NAME="new_fullpaths">
|
|
|
|
|
<DT><TT>/p</TT>
|
|
|
|
|
<DD>Print fully qualified file names in listing and error messages.<BR>
|
|
|
|
|
This option is useful for the Code-Genie editor (see
|
|
|
|
|
<A HREF="editors.htm">here</A>), which can jump to the error location
|
|
|
|
|
only if full path is given.<P>
|
|
|
|
|
<A NAME="new_quiet">
|
|
|
|
|
<DT><TT>/q</TT>
|
|
|
|
|
<DD>Suppress info messages.<BR>
|
2002-10-02 22:00:46 +00:00
|
|
|
Prevents X-Asm from printing "<TT>X-Assembler 2.5.2 by Fox/Taquart</TT>"
|
2002-05-22 10:24:30 +00:00
|
|
|
and the summary (how many lines assembled and bytes written).
|
|
|
|
|
Good if you are building a project from many source files and don't want
|
|
|
|
|
tons of messages.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<DT><TT>/s</TT>
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>Disable converting spaces to tabs in listing.<BR>
|
|
|
|
|
Using tabs makes listing file shorter.
|
1999-09-09 23:20:00 +00:00
|
|
|
Tab stops are assumed to be every 8 characters.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
<DT><TT>/t[:filename]</TT>
|
|
|
|
|
<DD>List label table.<BR>
|
|
|
|
|
If no <TT>filename</TT> given, the table is written at the end of listing
|
|
|
|
|
or to <TT>source.tab</TT>.<P>
|
|
|
|
|
<A NAME="new_unlabels">
|
|
|
|
|
<DT><TT>/u</TT>
|
|
|
|
|
<DD>Warn of unused labels.<BR>
|
|
|
|
|
A warning message will be issued for each label, which value is never
|
|
|
|
|
used.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
</DL>
|
|
|
|
|
If source is incorrect, X-Asm stops on first encountered error.<P>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="exitcod"><H3>Exit codes</H3>
|
|
|
|
|
Meaning of exit codes returned by X-Asm:<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
3 = bad parameters, assembling not started<BR>
|
|
|
|
|
2 = error occured<BR>
|
|
|
|
|
1 = warning(s) only<BR>
|
|
|
|
|
0 = no errors, no warnings<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="listing"><H3>Listing structure</H3>
|
2002-05-22 10:24:30 +00:00
|
|
|
A line of listing contains:
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> decimal number of line of source file (if source is different than in
|
2000-02-10 17:00:00 +00:00
|
|
|
previous listed line, appropriate message line is issued)
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> hexadecimal origin counter value
|
|
|
|
|
<LI> hexadecimal values of bytes written to object file<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
Listed are also generated headers. A <TT>xxxx-yyyy></TT> in place of origin
|
2002-05-22 10:24:30 +00:00
|
|
|
counter represents generated header: <TT>$xxxx</TT> is the first and
|
|
|
|
|
<TT>$yyyy</TT> is the last byte of the block.
|
1999-09-09 23:20:00 +00:00
|
|
|
A <TT>FFFF></TT> represents two $ff bytes written as a header prefix.<BR>
|
|
|
|
|
A plus sign placed after hex numbers stands for more bytes written to object
|
|
|
|
|
in this line, not listed through lack of space.
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> remaining part of listing line is verbatim copy of source line
|
1999-09-09 23:20:00 +00:00
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="labtab"><H3>Label table structure</H3>
|
2002-05-22 10:24:30 +00:00
|
|
|
A line of label table contains:
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
|
|
|
|
<LI> some label attributes:<BR>
|
|
|
|
|
<TT>n</TT> - label defined but not used elsewhere<BR>
|
|
|
|
|
<TT>2</TT> - label value known in pass 2 only (label definition uses forward
|
2000-02-10 17:00:00 +00:00
|
|
|
reference and thus you can't make forward references to that label)
|
1999-09-09 23:20:00 +00:00
|
|
|
<LI> hexadecimal value of the label
|
|
|
|
|
<LI> name of the label
|
|
|
|
|
</UL>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<A NAME="syntax"><H2>SYNTAX</H2>
|
|
|
|
|
|
|
|
|
|
<A NAME="fields"><H3>Fields</H3>
|
|
|
|
|
Source code is line-oriented. Every line of source consists of <I>fields</I>.
|
|
|
|
|
Same sequence of characters used in different fields has completely different meaning.
|
|
|
|
|
Fields are separated with one or more blank characters.
|
2002-05-22 10:24:30 +00:00
|
|
|
There can't be any space within a field, except for strings and comments.<P>
|
2000-02-10 17:00:00 +00:00
|
|
|
There are following types of fields:
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> <A HREF="#label">label field</A>
|
|
|
|
|
<LI> <A HREF="#repeat">repeat count</A>
|
|
|
|
|
<LI> <A HREF="#instr">instruction field</A>
|
|
|
|
|
<LI> <A HREF="#operand">operand</A>
|
|
|
|
|
<LI> <A HREF="#comment">comment</A>
|
|
|
|
|
</UL>
|
|
|
|
|
<A NAME="new_labdef">Every line of source must match one of two general forms:
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI> <TT>LABEL *COMMENT</TT>
|
|
|
|
|
<LI> <TT>LABEL :COUNT CMD:CMD OP1 OP2 COMMENT</TT>
|
1999-09-09 23:20:00 +00:00
|
|
|
</UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
In the first form, both fields are optional. Blank lines are ignored of course.
|
|
|
|
|
Comment must here start with one of these characters: <TT>; |</TT> or <TT>*</TT>
|
|
|
|
|
(semicolon, pipe or asterisk). Any information in the line following
|
|
|
|
|
such character is ignored.<P>
|
|
|
|
|
In the latter form, you must use a minimum of an instruction field.
|
|
|
|
|
It depends on the instruction, how many operands it takes.
|
|
|
|
|
Every instruction takes constant number of operands, therefore
|
|
|
|
|
there's no need to use a special character at the start of a comment, because after
|
2002-05-22 10:24:30 +00:00
|
|
|
succesfully taking operands, X-Asm discards the remaining part of line.
|
|
|
|
|
However, <A HREF="editors.htm">general purpose text editors</A> may highlight
|
|
|
|
|
the comments only if a special delimiter is used, and for that reason,
|
|
|
|
|
the semicolon is recommended to start a comment.<P>
|
2000-02-10 17:00:00 +00:00
|
|
|
|
|
|
|
|
<A NAME="label"><H4>Label field</H4>
|
|
|
|
|
This field is optional. It must start at first character in line, without
|
|
|
|
|
any blank characters before. The purpose of using label field is to define a label.<BR>
|
|
|
|
|
Label is a symbol representing an integer of range -$ffff..$ffff.<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
Name of a label may contain letters, digits and underscores (<TT>_</TT>).
|
2000-02-10 17:00:00 +00:00
|
|
|
Digit can not be label's first character.
|
2002-05-22 10:24:30 +00:00
|
|
|
Name of a label may be as long as you want and all the characters
|
2000-02-10 17:00:00 +00:00
|
|
|
are meaningful. In Quick Assembler only 6 leading characters were recognized
|
|
|
|
|
and some sources may not compile under X-Asm for this reason.<BR>
|
|
|
|
|
Defining a label without using <TT>EQU</TT> makes it equal to current value
|
|
|
|
|
of the origin counter.<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
Labels can't be redefined.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="new_linerep"><A NAME="repeat"><H4>Repeat count</H4>
|
2002-05-22 10:24:30 +00:00
|
|
|
Repeating means here assembling single line several times as if
|
2000-02-10 17:00:00 +00:00
|
|
|
there were several identical lines. Note it is not just duplicating
|
2002-05-22 10:24:30 +00:00
|
|
|
bytes written to the object file.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
Repeat count, which can be any valid expression, has to be preceded
|
|
|
|
|
with a colon.<BR>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE>:4 asl @
|
|
|
|
|
:2 dta a(*)
|
|
|
|
|
</PRE>
|
|
|
|
|
In the latter example each <TT>DTA</TT> has different operand value.<BR>
|
|
|
|
|
If repeat count equals zero, remaining part of line is not assembled.
|
2002-05-22 10:24:30 +00:00
|
|
|
This allows compact single-line conditional assembly.
|
2000-02-10 17:00:00 +00:00
|
|
|
|
|
|
|
|
<A NAME="new_pairing"><A NAME="instr"><H4>Instruction field</H4>
|
|
|
|
|
If this is the first field in a line, the line must start with at least
|
|
|
|
|
one blank character. Instruction field consists of one or two instructions.
|
|
|
|
|
The latter case is called instructions pairing, because a pair
|
|
|
|
|
of instructions have shared operand. You separate instructions
|
|
|
|
|
with a colon.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE> adc:sta $80
|
|
|
|
|
</PRE>is equivalent to
|
|
|
|
|
<PRE> adc $80
|
|
|
|
|
sta $80
|
|
|
|
|
</PRE>
|
|
|
|
|
Note that
|
|
|
|
|
<PRE> lda:tax $80
|
|
|
|
|
</PRE>is correct, because <TT>$80</TT> is a comment for <TT>TAX</TT>.<P>
|
2002-05-22 10:24:30 +00:00
|
|
|
Single instruction always consists of 3 letters. It may be:
|
2000-02-10 17:00:00 +00:00
|
|
|
<OL TYPE=a>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> a 6502 command - standard mnemonics are used
|
|
|
|
|
<LI> <A HREF="#directives">a directive</A>
|
|
|
|
|
<LI> <A HREF="#pseudocom">a pseudo-command</A>
|
2000-02-10 17:00:00 +00:00
|
|
|
</OL>
|
|
|
|
|
|
|
|
|
|
<A NAME="operand"><H4>Operand field</H4>
|
|
|
|
|
Some instructions don't need any operand,
|
|
|
|
|
other need two operands.<BR>
|
|
|
|
|
6502 commands require operand with proper
|
|
|
|
|
<A HREF="#adrmod">addressing mode</A>.<P>
|
|
|
|
|
|
|
|
|
|
<A NAME="comment"><H4>Comment</H4>
|
|
|
|
|
Comment in a statement does not start from any special character
|
|
|
|
|
like <TT>;</TT> for example. Comment field is implied when appropriate
|
|
|
|
|
number of operands was taken.<P>
|
|
|
|
|
|
|
|
|
|
<P><HR><P>
|
|
|
|
|
<A NAME="expr"><H3>Expressions</H3>
|
1999-09-09 23:20:00 +00:00
|
|
|
Expressions are numbers combined with operators and brackets.
|
|
|
|
|
You should use square brackets, because parentheses are reserved
|
|
|
|
|
for 6502 indirect addressing.
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="numbers"><H4>Numbers</H4>
|
1999-09-09 23:20:00 +00:00
|
|
|
Numbers are 32-bit signed integers, in the range of -$7fffffff..$7fffffff.
|
2002-07-08 13:22:54 +00:00
|
|
|
A number may be:<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TABLE>
|
|
|
|
|
<TR><TD WIDTH=300><UL><LI> a decimal number</TD><TD><TT>-12345</TT></TD></TR>
|
2000-02-10 17:00:00 +00:00
|
|
|
<TR><TD><UL><LI> a hexadecimal number</TD><TD><TT>$abcd</TT></TD></TR>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TR><TD><UL><LI> a binary number</TD><TD><TT>%10100101</TT></TD></TR>
|
|
|
|
|
<TR><TD><UL><LI> an ASCII character</TD><TD><TT>'a'</TT> or <TT>"a"</TT></TD></TR>
|
2002-05-22 10:24:30 +00:00
|
|
|
<TR><TD><UL><LI> the origin counter value</TD><TD><TT>*</TT></TD></TR>
|
2002-07-08 13:22:54 +00:00
|
|
|
<TR><TD><UL><LI> a hardware register</TD><TD><TT>^4e</TT></TD></TR>
|
1999-09-09 23:20:00 +00:00
|
|
|
</UL></TABLE>
|
2002-07-08 13:22:54 +00:00
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
An abbreviation of Atari hardware register is provided to save you trouble of typing
|
|
|
|
|
two extra characters (<TT>^4e</TT> vs <TT>$d40e</TT>) and to support porting software
|
|
|
|
|
between Atari 8-bit computers and Atari 5200 console. These are very similar machines,
|
|
|
|
|
one of biggest differences is different location of hardware registers.<P>
|
|
|
|
|
<TABLE>
|
|
|
|
|
<TR><TD><B>Syntax </B></TD><TD><B>Chip </B></TD>
|
|
|
|
|
<TD><B>Value in Atari 8-bit<BR>computer mode (<TT>OPT G-</TT>) </B></TD>
|
|
|
|
|
<TD><B>Value in Atari 5200<BR>game console mode (<TT>OPT G+</TT>) </B></TD>
|
|
|
|
|
</TR>
|
|
|
|
|
<TR><TD><TT>^0x</TT></TD><TD>GTIA </TD><TD><TT>$d00x</TT></TD><TD><TT>$c00x</TT></TD></TR>
|
|
|
|
|
<TR><TD><TT>^1x</TT></TD><TD>GTIA </TD><TD><TT>$d01x</TT></TD><TD><TT>$c01x</TT></TD></TR>
|
|
|
|
|
<TR><TD><TT>^2x</TT></TD><TD>POKEY </TD><TD><TT>$d20x</TT></TD><TD><TT>$e80x</TT></TD></TR>
|
|
|
|
|
<TR><TD><TT>^3x</TT></TD><TD>PIA </TD><TD><TT>$d30x</TT></TD><TD><I>error</I> (there's no PIA chip)</TD></TR>
|
|
|
|
|
<TR><TD><TT>^4x</TT></TD><TD>ANTIC </TD><TD><TT>$d40x</TT></TD><TD><TT>$d40x</TT></TD></TR>
|
|
|
|
|
</TABLE>
|
|
|
|
|
(<TT>x</TT> is a hexadecimal digit).
|
|
|
|
|
</BLOCKQUOTE>
|
1999-09-09 23:20:00 +00:00
|
|
|
<A NAME="new_opcode">
|
|
|
|
|
<TABLE>
|
|
|
|
|
<TR><TD WIDTH=300><UL><LI> an op-code</TD><TD><TT>{lda #0}</TT></TD></TR>
|
|
|
|
|
</UL></TABLE>
|
2002-07-08 13:22:54 +00:00
|
|
|
<BLOCKQUOTE>
|
|
|
|
|
Single-byte op-code of the instruction inside braces (e.g. value of <TT>{nop}</TT> is <TT>$ea</TT>).
|
|
|
|
|
Operand is discarded and is necessary only for identifying addressing mode.
|
2002-05-22 10:24:30 +00:00
|
|
|
Instruction should begin just after the left brace and the right brace should
|
2002-07-08 13:22:54 +00:00
|
|
|
immediately follow the operand or the command.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="new_op_op">You can skip the operand, if the addressing mode is fixed.
|
|
|
|
|
Examples:<BR>
|
|
|
|
|
<TT>{lda #}</TT>, <TT>{jsr}</TT>, <TT>{bne}</TT>, <TT>{jmp ()}</TT>,
|
|
|
|
|
<TT>{sta a:,x}</TT>.
|
2002-07-08 13:22:54 +00:00
|
|
|
</BLOCKQUOTE>
|
1999-09-09 23:20:00 +00:00
|
|
|
<P>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="operators"><H4>Operators</H4>
|
|
|
|
|
<I>Binary operators:</I><P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TABLE>
|
|
|
|
|
<TR><TD><TT>+ </TT></TD><TD>Addition</TD></TR>
|
|
|
|
|
<TR><TD><TT>- </TT></TD><TD>Subtraction</TD></TR>
|
|
|
|
|
<TR><TD><TT>* </TT></TD><TD>Multiplication</TD></TR>
|
|
|
|
|
<TR><TD><TT>/ </TT></TD><TD>Division</TD></TR>
|
|
|
|
|
<TR><TD><TT>% </TT></TD><TD>Remainder</TD></TR>
|
|
|
|
|
<TR><TD><TT>& </TT></TD><TD>Bitwise and</TD></TR>
|
|
|
|
|
<TR><TD><TT>| </TT></TD><TD>Bitwise or</TD></TR>
|
|
|
|
|
<TR><TD><TT>^ </TT></TD><TD>Bitwise xor</TD></TR>
|
|
|
|
|
<TR><TD><TT><< </TT></TD><TD>Arithmetic shift left</TD></TR>
|
|
|
|
|
<TR><TD><TT>>> </TT></TD><TD>Arithmetic shift right</TD></TR>
|
|
|
|
|
<TR><TD><TT>= </TT></TD><TD>Equal</TD></TR>
|
2002-05-22 10:24:30 +00:00
|
|
|
<TR><TD><TT>== </TT></TD><TD>Equal (same as <TT>=</TT>)</TD></TR>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TR><TD><TT><> </TT></TD><TD>Not equal</TD></TR>
|
|
|
|
|
<TR><TD><TT>!= </TT></TD><TD>Not equal (same as <TT><></TT>)</TD></TR>
|
|
|
|
|
<TR><TD><TT>< </TT></TD><TD>Less than</TD></TR>
|
|
|
|
|
<TR><TD><TT>> </TT></TD><TD>Greater than</TD></TR>
|
|
|
|
|
<TR><TD><TT><= </TT></TD><TD>Less or equal</TD></TR>
|
|
|
|
|
<TR><TD><TT>>= </TT></TD><TD>Greater or equal</TD></TR>
|
|
|
|
|
<TR><TD><TT>&& </TT></TD><TD>Logical and</TD></TR>
|
|
|
|
|
<TR><TD><TT>|| </TT></TD><TD>Logical or</TD></TR>
|
2000-02-10 17:00:00 +00:00
|
|
|
</TABLE><P>
|
|
|
|
|
<A NAME="new_unary">
|
|
|
|
|
<I>Unary operators:</I><P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TABLE>
|
2000-02-10 17:00:00 +00:00
|
|
|
<TR><TD><TT>+</TT></TD><TD>Plus (does nothing)</TD></TR>
|
|
|
|
|
<TR><TD><TT>-</TT></TD><TD>Minus (changes sign)</TD></TR>
|
|
|
|
|
<TR><TD><TT>~</TT></TD><TD>Bitwise not (complements all bits)</TD></TR>
|
|
|
|
|
<TR><TD><TT>!</TT></TD><TD>Logical not (changes true to false and vice versa)</TD></TR>
|
|
|
|
|
<TR><TD><TT><</TT></TD><TD>Low (extracts low byte)</TD></TR>
|
|
|
|
|
<TR><TD><TT>></TT></TD><TD>High (extracts high byte)</TD></TR>
|
|
|
|
|
</TABLE><P>
|
|
|
|
|
<I>Operator precedence:</I><P>
|
|
|
|
|
<TABLE>
|
|
|
|
|
<TR><TD>first</TD><TD><TT>[]</TT><TD>(brackets)</TD></TR>
|
|
|
|
|
<TR><TD> </TD><TD><TT>+ - ~ < ></TT><TD>(unary)</TD></TR>
|
|
|
|
|
<TR><TD> </TD><TD><TT>* / % & << >></TT><TD>(binary)</TD></TR>
|
|
|
|
|
<TR><TD> </TD><TD><TT>+ - | ^</TT><TD>(binary)</TD></TR>
|
2002-05-22 10:24:30 +00:00
|
|
|
<TR><TD> </TD><TD><TT>= == <> != < > <= >=</TT><TD>(binary)</TD></TR>
|
2000-02-10 17:00:00 +00:00
|
|
|
<TR><TD> </TD><TD><TT>!</TT><TD>(unary)</TD></TR>
|
|
|
|
|
<TR><TD> </TD><TD><TT>&&</TT><TD>(binary)</TD></TR>
|
|
|
|
|
<TR><TD>last </TD><TD><TT>||</TT><TD>(binary)</TD></TR>
|
|
|
|
|
</TABLE><P>
|
2002-05-22 10:24:30 +00:00
|
|
|
Note that although the operators are similar to these used in C, C++ and Java,
|
|
|
|
|
their priorities are different than in these languages.<P>
|
|
|
|
|
Compare and logical operators assume that zero is false and a non-zero is true.
|
1999-09-09 23:20:00 +00:00
|
|
|
They return 1 for true.<P>
|
2000-02-10 17:00:00 +00:00
|
|
|
While calculating expression, signed 32-bit arithmetic is used. When range of 32 bits
|
1999-09-09 23:20:00 +00:00
|
|
|
is exceeded, <TT>'Arithmetic overflow'</TT> error is generated.<P>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<P><HR><P>
|
|
|
|
|
<A NAME="directives"><H3>Directives</H3>
|
1999-09-09 23:20:00 +00:00
|
|
|
<DL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<DT><TT><B>EQU</B></TT> - assign a value of an expression to the label
|
1999-09-09 23:20:00 +00:00
|
|
|
<DD>Note that label represents a number, not a text macro.<BR>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE>five equ 5
|
|
|
|
|
here equ *
|
|
|
|
|
</PRE>
|
|
|
|
|
|
2002-07-08 13:22:54 +00:00
|
|
|
<A NAME="new_opt">
|
2002-05-22 10:24:30 +00:00
|
|
|
<DT><TT><B>OPT</B></TT> - set assembly options
|
2002-07-08 13:22:54 +00:00
|
|
|
<DD>Five options are available:
|
2002-05-22 10:24:30 +00:00
|
|
|
<UL>
|
2002-07-08 13:22:54 +00:00
|
|
|
<LI> <TT>F</TT> - fill space between <TT>ORG</TT>s
|
|
|
|
|
(details <A HREF="#org_fill">here</A>)
|
|
|
|
|
<LI> <TT>G</TT> - Atari 5200 mode for hardware register abbreviations
|
|
|
|
|
(details <A HREF="#numbers">here</A>)
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> <TT>H</TT> - generate Atari executable headers
|
|
|
|
|
<LI> <TT>L</TT> - generate listing
|
|
|
|
|
<LI> <TT>O</TT> - generate object file
|
|
|
|
|
</UL>
|
1999-09-09 23:20:00 +00:00
|
|
|
You can turn any of these on or off.<BR>
|
2002-07-08 13:22:54 +00:00
|
|
|
Default (if no <TT>OPT</TT> specified) is <TT>opt f-g-h+l+o+</TT>.<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
Examples:
|
2002-07-08 13:22:54 +00:00
|
|
|
<PRE> opt l- listing off
|
|
|
|
|
opt l+o- listing on, object file off
|
|
|
|
|
opt f+g+h- useful for Atari 5200 cartridges - raw output format, 5200 hw regs
|
1999-09-09 23:20:00 +00:00
|
|
|
</PRE>
|
|
|
|
|
|
2002-07-08 13:22:54 +00:00
|
|
|
<A NAME="org_fill">
|
2002-05-22 10:24:30 +00:00
|
|
|
<DT><TT><B>ORG</B></TT> - change value of the origin counter
|
2002-07-08 13:22:54 +00:00
|
|
|
<DD>
|
|
|
|
|
<!-- Option '<TT>F</TT> affects all <TT>ORG</TT> directives except for the first one. -->
|
|
|
|
|
You can set some options applied to the new header (if headers are
|
2002-05-22 10:24:30 +00:00
|
|
|
enabled):
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> <TT>a:</TT> tells X-Asm to always make a header, even it is unnecessary,
|
1999-09-09 23:20:00 +00:00
|
|
|
like in <TT>ORG *</TT>.
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> <TT>f:</TT> works same as <TT>a:</TT>, but additionally tells to generate
|
|
|
|
|
a $ff,$ff prefix before the header. X-Asm adds it at the beginning of the file
|
1999-09-09 23:20:00 +00:00
|
|
|
by default, so use this option only if you want the $ff's somewhere inside.<BR>
|
|
|
|
|
</UL>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE> org $600
|
|
|
|
|
org f:$700
|
|
|
|
|
table org *+100
|
|
|
|
|
</PRE>
|
|
|
|
|
In the latter example <TT>table</TT> points to 100 bytes
|
2000-02-10 17:00:00 +00:00
|
|
|
of uninitialized data (label is assigned to <TT>*</TT>
|
1999-09-09 23:20:00 +00:00
|
|
|
before <TT>ORG</TT> directive is executed).<P>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<A NAME="new_dta">
|
1999-09-09 23:20:00 +00:00
|
|
|
<DT><TT><B>DTA</B></TT> - define data
|
|
|
|
|
<DD>There are various data types:
|
|
|
|
|
<UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI> integers
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI> bytes: <TT>b(200)</TT> or simply <TT>200</TT>
|
1999-09-09 23:20:00 +00:00
|
|
|
<LI> words: <TT>a(10000)</TT>
|
|
|
|
|
<LI> low bytes of words: <TT>l(511)</TT> defines byte 255
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI> high bytes of words: <TT>h(511)</TT> defines byte 1
|
|
|
|
|
</UL>
|
1999-09-09 23:20:00 +00:00
|
|
|
You may enter many expressions in parentheses and combine different types
|
|
|
|
|
of data in single line, separating things with commas.<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
You may also define a sine lookup table. Syntax is:<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TT>sin(centre,amp,size,first,last)</TT><BR>
|
|
|
|
|
where:
|
|
|
|
|
<UL>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI> <TT>centre</TT> is a number which is added to every sine value
|
|
|
|
|
<LI> <TT>amp</TT> is the sine amplitude
|
|
|
|
|
<LI> <TT>size</TT> is the sine period
|
1999-09-09 23:20:00 +00:00
|
|
|
<LI> <TT>first,last</TT> define range of values in the table.
|
|
|
|
|
They are optional. Default are <TT>0,size-1</TT>.
|
|
|
|
|
</UL>
|
|
|
|
|
Example: <TT>dta a(sin(0,1000,256,0,63))</TT> defines table of 64 words
|
2002-05-22 10:24:30 +00:00
|
|
|
representing a quarter of sine with amplitude of 1000.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<LI> real numbers: <TT>r(-1.23456e12)</TT><BR>
|
|
|
|
|
Real numbers are written in 6-byte Atari Floating-Point format. You can't
|
|
|
|
|
combine reals with operators, as you can integers.<P>
|
|
|
|
|
<LI> text strings
|
|
|
|
|
<UL>
|
|
|
|
|
<LI> ASCII strings: <TT>c'Text'</TT> or <TT>c"Text"</TT>
|
|
|
|
|
<LI> ANTIC strings: <TT>d'Text'</TT> or <TT>d"Text"</TT>
|
|
|
|
|
</UL>
|
|
|
|
|
A character string consists of any of characters surrounded by quotation
|
|
|
|
|
marks. Within a string, a single quotation mark character is
|
|
|
|
|
represented by two succesive quotation marks.<BR>
|
|
|
|
|
Placing a <TT>*</TT> character after a string inverts
|
|
|
|
|
high bit in every byte of string.<P>
|
|
|
|
|
</UL>
|
|
|
|
|
Examples of <TT>DTA</TT>:
|
|
|
|
|
<PRE>
|
2000-02-10 17:00:00 +00:00
|
|
|
dta b(1,2),3,a(1000,-1),l(12345,sin(0,127,256))
|
|
|
|
|
dta d"ANTIC"*,c'It''s a string',$9b
|
1999-09-09 23:20:00 +00:00
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>ICL</B></TT> - include another source file
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>Specifies another file to be included in the assembly as if the contents of
|
1999-09-09 23:20:00 +00:00
|
|
|
the referenced file appeared in place of the <TT>ICL</TT> statement.
|
|
|
|
|
The included file may contain other <TT>ICL</TT> statements.
|
|
|
|
|
The <TT>.ASX</TT> extension is added if none given.<P>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE>
|
|
|
|
|
icl 'macros.asx'
|
|
|
|
|
icl 'c:\atari\xasm\fileio'
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>END</B></TT> - end assembling file
|
|
|
|
|
<DD>Remaining part of the file is not assembled. If this statement does
|
|
|
|
|
not occur, assembler stops assembling when encounters end of file.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE>
|
|
|
|
|
end
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>INS</B></TT> - insert contents of file
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>Copies every byte of specified file into the object file and updates
|
|
|
|
|
the origin counter, as if these bytes were defined with <TT>DTA</TT>.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
You may specify range of inserted file. Syntax is following:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE>
|
|
|
|
|
ins 'file'[,offset[,length]]
|
|
|
|
|
</PRE>
|
|
|
|
|
First byte in file has offset 0.<BR>
|
|
|
|
|
If offset is negative, it is counted from the end of file.<BR>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE>
|
|
|
|
|
ins 'picture.raw'
|
|
|
|
|
ins 'file',-256 insert last 256 bytes of file
|
|
|
|
|
ins 'file',10,10 insert bytes 10..19 of file
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>RUN</B></TT> - generate run address
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>The Atari executable program should have a run address specified.
|
1999-09-09 23:20:00 +00:00
|
|
|
A program may be loaded in many areas of memory and started from any address.
|
|
|
|
|
<PRE> run addr
|
|
|
|
|
</PRE>
|
|
|
|
|
is equivalent to:
|
|
|
|
|
<PRE> org $2e0
|
|
|
|
|
dta a(addr)
|
|
|
|
|
</PRE>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE> run start
|
2002-05-22 10:24:30 +00:00
|
|
|
run main
|
1999-09-09 23:20:00 +00:00
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>INI</B></TT> - generate init address
|
|
|
|
|
<DD>The Atari executable program may have some routines which are executed
|
|
|
|
|
during loading process. There may be many init blocks in one file.<BR>
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE> ini init
|
|
|
|
|
ini showpic
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>ERT</B></TT> - generate error if expression is true
|
|
|
|
|
<DD>Examples:
|
|
|
|
|
<PRE> ert *>$c000
|
|
|
|
|
ert len1>$ff||len2>$ff
|
|
|
|
|
</PRE>
|
|
|
|
|
|
2002-05-22 10:24:30 +00:00
|
|
|
<A NAME="new_eli">
|
1999-09-09 23:20:00 +00:00
|
|
|
<DT><TT><B>IFT</B></TT> - assemble if expression is true<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
<TT><B>ELI</B></TT> - else if<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
<TT><B>ELS</B></TT> - else<BR>
|
|
|
|
|
<TT><B>EIF</B></TT> - end if<BR>
|
|
|
|
|
<DD>With these directives you can construct fragments which
|
|
|
|
|
are assembled when a condition is met.
|
|
|
|
|
Conditional constructions can be nested.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE>noscr equ 1
|
2002-05-22 10:24:30 +00:00
|
|
|
widescr equ 1
|
1999-09-09 23:20:00 +00:00
|
|
|
ift noscr
|
|
|
|
|
lda #0
|
2002-05-22 10:24:30 +00:00
|
|
|
eli widescr
|
|
|
|
|
lda #$23
|
1999-09-09 23:20:00 +00:00
|
|
|
els
|
|
|
|
|
lda #$22
|
|
|
|
|
eif
|
|
|
|
|
sta $22f
|
|
|
|
|
</PRE>
|
|
|
|
|
Above example can be rewritten using line repeating feature:
|
|
|
|
|
<PRE>noscr equ 1
|
2002-05-22 10:24:30 +00:00
|
|
|
widescr equ 1
|
2000-02-10 17:00:00 +00:00
|
|
|
:noscr lda #0
|
2002-05-22 10:24:30 +00:00
|
|
|
:!noscr&&widescr lda #$23
|
|
|
|
|
:!noscr&&!widescr lda #$22
|
1999-09-09 23:20:00 +00:00
|
|
|
sta $22f
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
</DL>
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<A NAME="pseudocom"><H3>Pseudo-commands</H3>
|
|
|
|
|
Pseudo-commands are built-in macros.
|
2002-05-22 10:24:30 +00:00
|
|
|
They are not unofficial instructions, so they work on typical 6502.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
<DL>
|
|
|
|
|
<DT><TT><B>ADD</B></TT> - addition without carry
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>If you have ever programmed 6502, you must have noticed that you had
|
1999-09-09 23:20:00 +00:00
|
|
|
to use a <TT>CLC</TT> before <TT>ADC</TT> for every simple addition.<BR>
|
|
|
|
|
X-Asm can do it for you. <TT>ADD</TT> replaces two instructions:
|
|
|
|
|
<TT>CLC</TT> and <TT>ADC</TT>.<P>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>SUB</B></TT> - subtraction
|
|
|
|
|
<DD>It is <TT>SEC</TT> and <TT>SBC</TT>.<P>
|
|
|
|
|
|
|
|
|
|
<A NAME="new_repskip">
|
|
|
|
|
<DT><TT><B>RCC, RCS, REQ, RMI, RNE, RPL, RVC, RVS</B></TT> - conditional repeat
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>These are branches to the previous instruction.
|
1999-09-09 23:20:00 +00:00
|
|
|
They take no operand, because the branch target
|
|
|
|
|
is the address of previously assembled instruction.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE> ldx #0
|
|
|
|
|
mva:rne $500,x $600,x+
|
|
|
|
|
</PRE>
|
|
|
|
|
The example code copies memory $500-$5ff to $600-$6ff.
|
2000-02-10 17:00:00 +00:00
|
|
|
Here is the same written with standard 6502 commands only:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE> ldx #0
|
|
|
|
|
loop lda $500,x
|
|
|
|
|
sta $600,x
|
|
|
|
|
inx
|
|
|
|
|
bne loop
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>SCC, SCS, SEQ, SMI, SNE, SPL, SVC, SVS</B></TT> - conditional skip
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>These are branches over the next instructions. No operand is required,
|
1999-09-09 23:20:00 +00:00
|
|
|
because the target is the address of instruction following
|
|
|
|
|
the next instruction.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE> lda #40
|
|
|
|
|
add:sta $80
|
|
|
|
|
scc:inc $81
|
|
|
|
|
</PRE>
|
2002-05-22 10:24:30 +00:00
|
|
|
In the above example word-size variable $80 is incremented by 40.<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
Nor conditional repeat nor skip pseudo-commands require operand,
|
|
|
|
|
thus they can be paired with any other command.<P>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>JCC, JCS, JEQ, JMI, JNE, JPL, JVC, JVS</B></TT> - conditional jumps
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>These are a kind of 'long' branches. While standard branches
|
1999-09-09 23:20:00 +00:00
|
|
|
(<TT>BNE, BEQ</TT>) have range of -128..+127, these jumps have range
|
|
|
|
|
of all 64 kB.<BR>
|
|
|
|
|
Example:
|
|
|
|
|
<PRE> jne dest
|
|
|
|
|
</PRE>is equivalent to:
|
|
|
|
|
<PRE> seq:jmp dest
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>INW</B></TT> - increment word
|
2002-05-22 10:24:30 +00:00
|
|
|
<DD>Increments a 16-bit word in the memory.<BR>
|
1999-09-09 23:20:00 +00:00
|
|
|
Example:
|
|
|
|
|
<PRE> inw dest
|
|
|
|
|
</PRE>is equivalent to:
|
|
|
|
|
<PRE> inc dest
|
|
|
|
|
sne:inc dest+1
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
<DT><TT><B>MVA, MVX, MVY</B></TT> - move byte using accumulator, X or Y
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>Each of these pseudo-commands requires two operands
|
1999-09-09 23:20:00 +00:00
|
|
|
and substitutes two commands:
|
|
|
|
|
<PRE> mva source dest = lda source : sta dest
|
|
|
|
|
mvx source dest = ldx source : stx dest
|
|
|
|
|
mvy source dest = ldy source : sty dest
|
|
|
|
|
</PRE>
|
|
|
|
|
|
2002-05-22 10:24:30 +00:00
|
|
|
<A NAME="new_mwinde">
|
1999-09-09 23:20:00 +00:00
|
|
|
<DT><TT><B>MWA, MWX, MWY</B></TT> - move word using accumulator, X or Y
|
2000-02-10 17:00:00 +00:00
|
|
|
<DD>These pseudo-commands require two operands
|
1999-09-09 23:20:00 +00:00
|
|
|
and are combinations of two <TT>MV*</TT>'s:
|
|
|
|
|
one to move low byte, and the other to move high byte.<BR>
|
2000-02-10 17:00:00 +00:00
|
|
|
You can't use indirect nor pseudo addressing mode with <TT>MW*</TT>.
|
|
|
|
|
Destination must be absolute address (optionally indexed).<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
When source is also absolute, a <TT>mw* source dest</TT> will be:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE> mv* source dest
|
|
|
|
|
mv* source+1 dest+1
|
|
|
|
|
</PRE>
|
2002-05-22 10:24:30 +00:00
|
|
|
When source is an immediate, a <TT>mw* #immed dest</TT> will be:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE> mv* <immed dest
|
|
|
|
|
mv* >immed dest+1
|
|
|
|
|
</PRE>
|
|
|
|
|
When <TT><immed</TT> equals <TT>>immed</TT> and <TT>immed</TT>
|
|
|
|
|
is not forward-referenced, X-Asm uses optimization:
|
|
|
|
|
<PRE> mv* <immed dest
|
|
|
|
|
st* dest+1
|
|
|
|
|
</PRE>
|
2002-05-22 10:24:30 +00:00
|
|
|
If possible, <TT>MWX</TT> and <TT>MWY</TT> use increment/decrement
|
|
|
|
|
commands. E.g. <TT>mwx #1 dest</TT> is assembled as:
|
|
|
|
|
<PRE> mvx #1 dest
|
|
|
|
|
dex
|
|
|
|
|
stx dest+1
|
1999-09-09 23:20:00 +00:00
|
|
|
</DL>
|
|
|
|
|
</OL>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<A NAME="adrmod"><H3>Addressing modes</H3>
|
|
|
|
|
All addressing modes are entered in standard convention except
|
1999-09-09 23:20:00 +00:00
|
|
|
the accumulator addressing mode, which should be marked with a
|
|
|
|
|
<TT>@</TT> character (as in Quick Assembler).<P>
|
|
|
|
|
|
|
|
|
|
There are two extra immediate addressing modes:
|
|
|
|
|
<TT><</TT> and <TT>></TT>,
|
2002-05-22 10:24:30 +00:00
|
|
|
which use low/high byte of 16-bit word constant.
|
2000-02-10 17:00:00 +00:00
|
|
|
They are for Quick Assembler compatibility.
|
|
|
|
|
You can use traditional <TT>#<</TT> and <TT>#></TT>.
|
|
|
|
|
Note <NOBR><TT>lda >$ff+5</TT></NOBR> loads 1 (<TT>>$104</TT>),
|
|
|
|
|
while <NOBR><TT>lda #>$ff+5</TT></NOBR>
|
2002-05-22 10:24:30 +00:00
|
|
|
loads 5 (<TT>0+5</TT>) to accumulator, because unary operator <TT>></TT>
|
|
|
|
|
has higher priority than the binary plus.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
2002-05-22 10:24:30 +00:00
|
|
|
In absolute addressing modes, X-Asm examines the expression and uses zero-page
|
|
|
|
|
addressing mode if it supposes it's possible. You may override it with
|
2000-02-10 17:00:00 +00:00
|
|
|
<TT>a:</TT> and <TT>z:</TT> prefixes.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
|
|
|
|
Examples:
|
|
|
|
|
<PRE>
|
|
|
|
|
nop
|
|
|
|
|
asl @
|
|
|
|
|
lda >$1234 assembles to lda #$12
|
|
|
|
|
lda $100,x
|
|
|
|
|
lda a:0 generates 16-bit address
|
|
|
|
|
jmp ($0a)
|
|
|
|
|
lda ($80),y
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
There are also pseudo addressing modes, which are similar to
|
2000-02-10 17:00:00 +00:00
|
|
|
pseudo-commands. You may use them just like standard addressing modes
|
2002-05-22 10:24:30 +00:00
|
|
|
in all 6502 commands and pseudo-commands, except for
|
|
|
|
|
<TT>MWA</TT>, <TT>MWX</TT> and <TT>MWY</TT>:
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE> cmd a,x+ = cmd a,x : inx
|
|
|
|
|
cmd a,x- = cmd a,x : dex
|
|
|
|
|
cmd a,y+ = cmd a,y : iny
|
|
|
|
|
cmd a,y- = cmd a,y : dey
|
|
|
|
|
cmd (z),y+ = cmd (z),y : iny
|
|
|
|
|
cmd (z),y- = cmd (z),y : dey
|
|
|
|
|
cmd (z,0) = ldx #0 : cmd (z,x)
|
|
|
|
|
cmd (z),0 = ldy #0 : cmd (z),y
|
|
|
|
|
<A NAME="new_adrmodes"> cmd (z),0+ = ldy #0 : cmd (z),y : iny
|
|
|
|
|
cmd (z),0- = ldy #0 : cmd (z),y : dey
|
|
|
|
|
</PRE>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<HR>
|
|
|
|
|
<A NAME="faq"><H2>FAQ</H2>
|
2002-08-21 18:07:04 +00:00
|
|
|
<B>Note:</B> All the following things, which may be odd for you,
|
|
|
|
|
are familiar to Quick Assembler users.
|
1999-09-09 23:20:00 +00:00
|
|
|
<UL>
|
2002-05-22 10:24:30 +00:00
|
|
|
<LI><B>Q:</B> Why does X-Asm ignore <TT>+2</TT> in the following line?
|
1999-09-09 23:20:00 +00:00
|
|
|
<PRE>label equ 1 +2
|
|
|
|
|
</PRE>
|
|
|
|
|
<B>A:</B> X-Asm treats space as operand terminator. Remaining part of line
|
|
|
|
|
is a comment. You should write <TT>1+2</TT> without any spaces.<P>
|
|
|
|
|
|
2000-02-10 17:00:00 +00:00
|
|
|
<LI><B>Q:</B> Why does <TT>lda >$abcd</TT> assemble to
|
|
|
|
|
<TT>lda #$ab</TT>?<P>
|
|
|
|
|
<B>A:</B> <TT><</TT> and <TT>></TT> are not only 'low' and 'high'
|
|
|
|
|
operators, but also 'low of immediate' and 'high of immediate'
|
|
|
|
|
addressing modes indicators.
|
|
|
|
|
In order to get <TT>lda $ab</TT>, write <TT>lda +>$abcd</TT><P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
2002-08-21 18:07:04 +00:00
|
|
|
<LI><B>Q:</B> What's wrong with <TT>asl a</TT> or just <TT>asl</TT> ?<P>
|
|
|
|
|
<B>A:</B> You must use <TT>@</TT> for accumulator addressing mode.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
|
|
|
|
<LI><B>Q:</B> What's wrong in following line?
|
|
|
|
|
<PRE>label: lda #0
|
|
|
|
|
</PRE>
|
|
|
|
|
<B>A:</B> Label definition can not include a colon.<P>
|
|
|
|
|
|
|
|
|
|
<LI><B>Q:</B> I wrote <TT>end start</TT>, where <TT>start</TT> points
|
|
|
|
|
to program beginning, but program seems not to start there. Why?<P>
|
|
|
|
|
<B>A:</B> You should have explicit run address specified.
|
|
|
|
|
Use <TT>run start</TT> directive. <TT>end</TT> takes no operand.<P>
|
|
|
|
|
|
|
|
|
|
<LI><B>Q:</B> Why this construction does not work:
|
|
|
|
|
<PRE>three equ one+two
|
|
|
|
|
two equ one+one
|
|
|
|
|
one equ 1
|
|
|
|
|
</PRE>
|
|
|
|
|
while this does:
|
|
|
|
|
<PRE>
|
|
|
|
|
two equ one+one
|
|
|
|
|
one equ 1
|
|
|
|
|
</PRE>
|
|
|
|
|
<B>A:</B> X-Asm reads source twice (in pass 1 and pass 2)
|
|
|
|
|
from the beginning until the end.<BR>
|
|
|
|
|
This allows forward references, but not too complex.<BR>
|
2002-05-22 10:24:30 +00:00
|
|
|
Keep in mind that the assembler must know all the values in the second
|
|
|
|
|
pass.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
Example:
|
|
|
|
|
<PRE>two equ one+one This value is known in 2nd pass only
|
|
|
|
|
one equ 1 This value is known as early as in 1st pass
|
|
|
|
|
</PRE>
|
|
|
|
|
These values can be fixed in two passes.<BR>
|
|
|
|
|
If you insert following statement as first line:
|
|
|
|
|
<PRE>three equ one+two
|
|
|
|
|
</PRE>
|
|
|
|
|
X-Asm will generate an error because it can't fix
|
|
|
|
|
the value of <TT>three</TT> in second pass.<P>
|
|
|
|
|
|
|
|
|
|
<LI><B>Q:</B> X-Asm displayed single error while assembling my program.
|
|
|
|
|
When I fixed it, another error appeared. Why?<P>
|
|
|
|
|
<B>A:</B> X-Asm displays only first error.<BR>
|
|
|
|
|
When you were assembling for the first time, both errors might exist,
|
2000-02-10 17:00:00 +00:00
|
|
|
but X-Asm stopped on the first one.<P>
|
1999-09-09 23:20:00 +00:00
|
|
|
|
|
|
|
|
</UL>
|
2002-08-21 18:07:04 +00:00
|
|
|
If you have other questions/problems,
|
|
|
|
|
<A HREF=mailto:fox@scene.pl>contact me</A>.
|
2002-05-22 10:24:30 +00:00
|
|
|
<P><HR><P><A HREF="index.htm">Back</A>
|
2000-02-10 17:00:00 +00:00
|
|
|
</BODY></HTML>
|
