2.5.2 Assemble options

This section explains options for the assemble phase.

 

Caution about options are shown below.

-

Uppercase characters and lowercase characters are distinguished for options.

-

When numerical values are specified as parameters, hexadecimal numbers which starts with "0x" ("0X") or decimal numbers can be specified.
Uppercase characters and lowercase characters are not distinguished for the alphabet of hexadecimal numbers.

-

When a file name is specified as a parameter, it can include the path (absolute path or relative path).
When a file name without the path or a relative path is specified, the reference point of the path is the current folder.

-

When a parameter includes a space (such as a path name), enclose the parameter in a pair of double quotation marks (").

-

When the -prn_path, -mirror_source, -mirror_region, -define, -undefine, -include, -base_number, -warning, or -no_warning option is specified for ccrl command, the -asmopt option must be used.
The -include option can also be specified as the -I option for the ccrl command.

 

The types and explanations for options are shown below.

Table 2.6

Assemble Options

Classification

Option

Description

Version/help display specification

-V

This option displays the version information of asrl.

-help

This option displays the descriptions of asrl options.

Output file specification

-output

This option specifies the output file name.

-obj_path

This option specifies the folder to save an object file generated after assembling.

-prn_path

This option specifies the folder to save the assemble list file.

Source debugging control

-debug

This option outputs information for source debugging.

Device specification control

-dev

This option specifies the target device file with the path.

-cpu

This option specifies the type of the CPU core.

-mirror_source

This option specifies the value to be set in the MAA register.

-mirror_region

This option specifies the address range of the mirror destination area.

Optimization

-goptimize

This option generates the information for inter-module optimization.

Symbol definition specification

-define

This option defines assembler symbols.

-undefine

This option deletes the assembler symbol definition by the
-define option.

Include file reading path specification

-include

This option specifies the folder to search include files.

Input file control

-character_set

This option specifies the Japanese/Chinese character code.

-base_number

This option specifies the notation of the radix for numeric constants.

Assembler transition support

-convert_asm

This option enables the assembler transition supporting function.

Error message file output specification

-error_file

This option outputs error messages to a file.

Warning message output control

-warning

This option outputs the specified warning message.

-no_warning

This option suppresses outputting warning messages of the specified number.

Subcommand file specification

@

This option specifies a subcommand file.