Epson S5U1C63000A - Manual (Page 63)

CHAPTER 4: ASSEMBLER
S5U1C63000A MANUAL EPSON 49
(S1C63 FAMILY ASSEMBLER PACKAGE)
4.3 Starting Method
General form of command line
as63 ^ [options] ^ [<source file name>]
^ denotes a space.
[ ] indicates the possibility to omit.
Source file name
In the command line, only one assembly source file can be specified at a time. Therefore, you will
have to process multiple files by executing the assembler the number of times equal to the number of
files to be processed.
A long file name supported in Windows and a path name can be specified. When including spaces in
the file name, enclose the file name with double quotation marks (").
Options
The assembler comes provided with the following six start-up options:
-d <define name>
Function: Definition of Define name
Explanation: • Works in the same manner as you describe "#define <define name>" at top of
the source. It is an option to control the conditional assembly at the start-up.
• One or more spaces are necessary between -d and the <define name>.
• To define two or more Define names, repeat the specification of "-d <define
name>".
-g
Function: Addition of debugging information
Explanation: • Creates an output file containing symbolic/source debugging information.
• Always specify this function when you perform symbolic/source debugging.
Default: If this option is not specified, no debugging information will be added to the
relocatable object file.
-o <file name>
Function: Specification of output path/file name
Explanation: • Specifies an output path/file name without extension or with an extension ".o".
If no extension is specified, ".o" will be supplemented at the end of the specified
output path/file name.
Default: The input file name is used for the output file names.
-c
Function: Ignore character case of symbols
Explanation: • Allows description of symbols in case insensitive.
Default: If this option is not specified, symbol names will be case sensitive.
-l
Function: Output of relocatable list file
Explanation: • Outputs a relocatable list file.
Default: If this option is not specified, no relocatable list file will be output.
-e
Function: Output of error file
Explanation: • Creates an .err file which contains the information that the assembler outputs to
the Standard Output (stdout), such as error messages.
Default: If this option is not specified, no error file will be created.
When entering an option in the command line, you need to place one or more spaces before and after
the option. The options can be specified in any order. It is also possible to enter options after the
source file name.
Example: c:\epson\s1c63\bin\as63 -g -e -l -d TEST1 -d TEST2 test.s