Echelon Neuron - Manual (Page 18)

The object output file contains assembled code, ready for the Neuron Linker.
Typically, the object output file has the same name as the input source file, but
has an .no file extension.
The listing output file contains the source instructions, directives, and comments
from the source input file, and includes the instruction opcodes and addressing
information (including symbolic or segment-relative addresses that are resolved
by the linker). The listing output file also can include source instructions and
directives from imported files. The listing output file is formatted for ease of
printing or viewing online. Use the --listing (-l) command-line switch to
generate a listing output file. Typically, the listing output file has the same
name as the input source file, but has an .nl file extension.
For both the object output file and the listing output file, you can use the --
outfile (-o) command-line switch of the nas command to rename these files.
However, this switch does not allow you to redirect the files to another directory.
A listing output file consists of one or more pages of output. Each page begins
with two header lines and a subhead line:
• The first header line contains information about the version of the
Neuron Assembler and ends with the current page number. This line
starts with a page break control character (form feed), that is used for
printing control. This control character is usually represented by a
special symbol when you view the assembly listing file with a file editor.
• The second header line contains the date and time that the listing file
was created and ends with the name of the source input file.
• The subhead line is blank, unless you specify a subhead using the
SUBHEAD directive (see SUBHEAD (Listing Control).
The rest of a page of a listing output file contains assembly source lines with
additional information in the left-hand columns:
• The first field is a four-digit hexadecimal number that represents the
absolute or relative address of the line. If the assembly source line
defines a label, the four-digit number is the value of the label. For
relocatable segments, the value is relative to the beginning of the
segment.
• The second field (and subsequent fields) is a two-digit or four-digit
hexadecimal number that represents the opcodes or data bytes as
assembled. If the field contains four zeros followed immediately by an
asterisk (*), the field’s value cannot be determined at assembly time, but
must be resolved at link time.
Assembly source lines that are skipped because of conditional assembly are also
included in the listing output file. Lines that are skipped are marked with an
exclamation mark (!) in the left-most column to designate that the line was not
assembled.
General Neuron Assembly Syntax
The general Neuron assembly language syntax is:
label keyword operand1 operand2 ; comment
where:
8 Introduction