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.

-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.

-Xcpu

This option specifies that an object for the specified core is generated.

Symbol definition specification

-D

This option defines assembler symbols.

-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.

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.