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, decimal or hexadecimal numbers which starts with "0x" ("0X") 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 -Xprn_path or -Xasm_far_jump option is specified for ccrh command, the -Xasm_option option must be used.

The types and explanations for options are shown below.

Table 2.3

Assemble Options

Classification	Option	Description
Version/help display specification	-V	This option displays the version information of asrh.
Version/help display specification	-h	This option displays the descriptions of asrh options.
Output file specification	-o	This option specifies the output file name.
	-Xobj_path	This option specifies the folder to save an object file generated during assembling.
	-Xprn_path	This option specifies the folder to save the assemble list file.
Source debugging control	-g	This option outputs information for source debugging.
Device specification	-Xcommon	This option specifies that an object file common to the various devices is generated.
Device specification	-Xcpu	This option specifies that an object for the specified core is generated.
Optimization	-goptimize [V2.01.00 or later]	This option generates information for link-time optimization.
Symbol definition specification	-D	This option defines assembler symbols.
Symbol definition specification	-U	This option deletes the assembler symbol definition by the -D option.
Include file reading path specification	-I	This option specifies the folder to search include files.
Japanese/Chinese character control	-Xcharacter_set	This option specifies the Japanese/Chinese character code.
Generated code control	-Xreg_mode	This option specifies the register mode.
	-Xreserve_r2	This option reserves the r2 register.
	-Xep	This option specifies how to handle the ep register.
	-pic [V1.07.00 or later]	This option enables the PIC facility.
	-pirod [V1.07.00 or later]	This option enables the PIROD facility.
	-pid [V1.07.00 or later]	This option enables the PID facility.
Assembler control specification	-Xasm_far_jump	This option controls outputting far jump for an assembly source file.
Error output control	-Xerror_file	This option outputs error messages to a file.
Warning message output control	-Xno_warning	This option suppresses outputting warning messages of the specified number.
Subcommand file specification	@	This option specifies a subcommand file.