User manual

ST Assembler-Linker ST assembler
Doc ID 11392 Rev 4 33/89
4.7 Running the assembler
4.7.1 Command line
The assembler needs the following arguments:
ASM <file to assemble>, <listing file>, <switches> [;]
If any or all the arguments are left out of the command line, you'll be prompted for the
remaining arguments. For example:
ASM
STMicroelectronics - Assembler - rel. 4.44
File to Assemble: game
In the example above, no parameters were given on the command line, so all the
parameters were prompted for.
The <file to assemble> parameter assumes a default suffix ".ASM". For example, if
you type 'game' then 'game.asm' is the actual filename used.
The listing file is the file to which the assembly report is sent if selected. The default
filename (which is displayed in square brackets), is made from the path and base-name of
the file to assemble. The default filename suffix for the assembly report file is ".LST". For
instance, if you type 'game', then 'game.lst' is the actual filename used.
Note that unless the assembler is told to create either a pass-1 or pass-2 complete listing by
the options argument, the listing file will not be created.
4.7.2 Options
Options are always preceded with a minus sign '-'. Upper and lower cases are accepted to
define options. Supported options are listed in Table 15.
#IFB
Checks for empty argument (that is, empty, or containing spaces / tabs), useful for
testing macro parameter existence.
#IFF (IF False) is similar to #IF, but checks the negation of the condition argument.
#IFIDN
Tests for string equality between two arguments separated by a space. This is useful
for testing macro parameters against fixed strings.
#IFLAB Checks if the argument is a predefined label.
Table 14. Other special #IF directives
Directive Usage
Table 15. Command line options
Option Function
-SYM Enable symbol table listing (see page 34)
-LI
-LI=<listfile>
Enable pass-2 listing (see page 34)
Enable listing and specify name of list file
-OBJ=<path> Specify .OBJ file (see page 34)
-FI=<mapfile> Specify 'final' listing mode (see page 35)