Development Tools

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.
Version/help display specification	-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.
Symbol definition specification	-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.
Input file control	-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.
Warning message output control	-no_warning	This option suppresses outputting warning messages of the specified number.
Subcommand file specification	@	This option specifies a subcommand file.