A09 - 6800/6801/6809/6301/6309/68HC11 Assembler

Based on Lennart Benschop's C core that can be found somewhere on the 'net (last address known to me was http://koti.mbnet.fi/~atjs/mc6809/Assembler/A09.c), I built a complete Macro Assembler that is functionally better than the TSC Flex9 Assembler (no wonder, I got multimegabytes to play with, whereas this excellent piece of software works within 50K or so!). It can deliver binary, Intel Hex, Motorola S1, and Flex9 binary output files, plus Flex9 RELASMB-compatible relocatable object modules.

I taylored the original to my taste by working through the source code; since A09 has reached a level of complexity that doesn't really lend itself to following the "Use the Source, Luke!" principle if you just want to hack a little 6809 assembly program, I've added this documentation. Have fun!

Hermann Seib, 2022

Syntax

<pre>a09 [-{b|r|s|x|f}[filename]]|[-c] [-l[filename]] [-ooption]* [-dsym=value]* sourcefile*</pre>

Command Line Parameters

<dl> <dt>-c</dt> <dd>suppresses code output (corresponds to ASMB's B command line option)</dd> <dt>-u</dt> <dd>shorthand notation for the UEX option (see below)</dd> <dt>-bfilename (default output mode)</dt> <dd>create a binary output file if no file name is given, the extension .bin is used (.b on Unix)</dd> <dt>-rfilename</dt> <dd>create a Flex9 RELASMB-compatible output file name if no file name is given, the extension .rel is used</dd> <dd>Attention: this file format is undocumented; my solution has been derived from some bits of information gathered on the Flex User Group mailing list and a bit of playing with the original. In my tests, the output was identical to RELASMB's; nevertheless, A09 might create modules that are incompatible with the original under circumstances that I don't know or haven't tested.</dd> <dt>-sfilename</dt> <dd>create a Motorola S-record output file name if no file name is given, the extension .s09 is used</dd> <dt>-xfilename</dt> <dd>create an Intel hex output file name if no file name is given, the extension .hex is used</dd> <dt>-ffilename</dt> <dd>create Flex9 ASMB-compatible output file if no file name is given, the extension .bin is used</dd> <dt>-lfilename</dt> <dd>create a list file (default no listing) if no file name is given, the extension .lst is used</dd> <dt>-dsym[=value]</dt> <dd>define a symbol (see TEXT directive below) (roughly corresponds to ASMB's command line parameters 1-3)</dd> <dt>-oopt</dt> <dd>defines an option (see below)</dd> <dt>sourcefile</dt> <dd>the assembler source file(s) to be processed. At least one source file must be given; the first one also defines the default output and listing file names.</dd> </dl>

Options

Over the years, A09 has learned quite a lot, and it can handle source files / list files in various formats. To allow their selection, I have expanded the scope of the OPT directive (see the FLEX9 Assembler Manual that can be found in the Documentation section on www.flexusergroup.com for details). Here's the list of additional options available in A09 (* denotes the default value for a mutually exclusive set):

<table border="0" cellspacing="1" width="100%" id="AutoNumber1"> <tbody><tr> <td valign="top" width="10%">SYM *</td> <td>print a symbol table</td> </tr> <tr> <td valign="top">NOS</td> <td>suppress symbol table printing (corresponds to ASMB's S command line option)</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">MUL *</td> <td>print multiple object code lines</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">NMU</td> <td>suppress printing of multiple object code lines (corresponds to ASMB's G command line option)</td> </tr> <tr> <td height="8" colspan="2" valign="top"></td> </tr> <tr> <td valign="top">LP1</td> <td>print a Pass 1 listing</td> </tr> <tr> <td valign="top">NO1 *</td> <td>print Pass 2 listing only</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">DAT *</td> <td>print current date on formatted pages</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">NOD</td> <td>do not print the current date (corresponds to ASMB's D command line option)</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">NUM</td> <td>print line numbers (corresponds to ASMB's N command line option)</td> </tr> <tr> <td valign="top">NON *</td> <td>do not print line numbers</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">INV</td> <td>print invisible lines</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">NOI *</td> <td>do not print invisible lines</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">TSC</td> <td>strict TSC Assembler compatibility</td> </tr> <tr> <td valign="top">NOT *</td> <td>accept source code in a much more relaxed format</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">WAR *</td> <td>print warnings</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">NOW</td> <td>only print errors, suppress warnings (corresponds to ASMB's W command line option)</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">CLL *</td> <td>check line length (see the SETLI directive on that)</td> </tr> <tr> <td valign="top">NCL</td> <td>do not check line length</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">LFN</td> <td>print long file names; on Win32 systems, this causes the file names displayed in warning and error messages to contain the full path name of the corresponding source file.</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">NLF *</td> <td>do not print long file names</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">LLL *</td> <td>list library file lines</td> </tr> <tr> <td valign="top">NLL</td> <td>suppress listing of library file lines</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">GAS</td> <td>accept Gnu AS-compatible source code

This isn't fully implemented yet. At the moment, the only significant difference is that A09 accepts constants in the form 0xXXXX (hex), 0bXXXX (binary), 0NNN (octal) in addition to the "standard" $,%, or @ notation.</td>

</tr> <tr bgcolor="#f0f0f0"> <td valign="top">NOG *</td> <td>don't accept Gnu AS-compatible source code</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">REL *</td> <td>print the relocation table if in Relocating Assembler mode</td> </tr> <tr> <td valign="top">NOR</td> <td>suppress printing of the relocation table</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">M68|M09 *</td> <td>both forms accept Motorola 6809 mnemonics</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">H63|H09</td> <td>accept Hitachi 6309 mnemonics (still slightly experimental)</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">M00|M02|M08</td> <td>accept Motorola 6800 mnemonics</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">M01|M03</td> <td>accept Motorola 6801 mnemonics</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">H01|H03</td> <td>accept Hitachi 6301 mnemonics (slightly experimental)</td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">H11</td> <td>accept Motorola 68HC11 mnemonics (very experimental)</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">TXT</td> <td>print the text table if text symbols are defined (see TEXT directive)</td> </tr> <tr> <td valign="top">NTX *</td> <td>do not print the text table</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr bgcolor="#f0f0f0"> <td valign="top">LPA</td> <td>print listing in f9dasm patch format

This option makes it easier to create complex patches to be embedded in images processed by f9dasm</td>

</tr> <tr bgcolor="#f0f0f0"> <td valign="top">NLP *</td> <td>don't print listing in f9dasm patch format</td> </tr> <tr> <td colspan="2" height="8" valign="top"></td> </tr> <tr> <td valign="top">DLM</td> <td>define label on macro expansion; see <a href="https://github.com/Arakula/A09/issues/1">Issue #1</a> for details. </td> </tr> <tr> <td valign="top">NDL *</td> <td>do not define labels on macro expansion</td> </tr>

A09

Install / Use

README

A09 - 6800/6801/6809/6301/6309/68HC11 Assembler

Syntax

Command Line Parameters

Options