[Individual Assemble Options] tab

This tab shows the detailed information on an assemble source file categorized by the following and the configuration can be changed.

Note that this tab takes over the settings of the [Common Options] tab, [Compile Options] tab, and [Assemble Options] tab.

When the settings are changed from these tabs, the properties are displayed in boldface.

(1) [Debug Information]

(2) [Preprocess]

(3) [Character Encoding]

(8) [Warning Message]

(9) [Others]

Remark

This tab is displayed only when [Yes] in the [Set individual assemble option] property in the [Build] category from the [Build Settings] tab is selected.

Figure A.14

Property Panel: [Individual Assemble Options] Tab

[Description of each category]

(1)	[Debug Information]

The detailed information on debug information is displayed and the configuration can be changed.

Add debug information	Select whether to generate the debug information. It is possible to perform source debugging with the debugger by outputting information for source debugging to the output file. This corresponds to the -g option of the ccrh command.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes(-g)	Generates the debug information.
		No	Does not generate the debug information.

(2)	[Preprocess]

The detailed information on preprocessing is displayed and the configuration can be changed.

Additional include paths

Specify the additional include paths during assembling.

The following placeholders are supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%MainProjectName%: Replaces with the main project name.

%MicomToolPath%: Replaces with the absolute path of the install folder of this product.

%ProjectDir%: Replaces with the absolute path of the project folder.

%ProjectName%: Replaces with the project name.

%TempDir%: Replaces with the absolute path of the temporary folder.

%WinDir%: Replaces with the absolute path of the Windows system folder.

The specified include path is searched with higher priority than the standard include file folder of CC-RH.

The reference point of the path is the project folder.

When this property is omitted, only the standard folder of CC-RH is searched.

This corresponds to the -I option of the ccrh command.

The specified include path is displayed as the subproperty.

Uppercase characters and lowercase characters are not distinguished for the include paths.

Default

Additional include paths[number of defined items]

How to change

Edit by the Path Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 259 characters

Up to 256 items can be specified.

Use whole include paths specified for build tool

Select whether to assemble using the include path specified in the [Additional include paths] property in the [Preprocess] category from the [Assemble Options] tab of the build tool to be used.

The include paths are added by the following procedure.

-	Paths specified in the [Additional include paths] property from this tab

-	Paths specified in the [Additional include paths] property from the [Assemble Options] tab

-	Paths displayed in the [System include paths] property from the [Assemble Options] tab

This corresponds to the -I option of the ccrh command.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Assembles using the include path specified in the property of the build tool to be used.

Does not use the include path specified in the property of the build tool to be used.

Macro definition

Specify the name of the macro to be defined.

Specify in the format of "macro name=defined value", with one macro name per line.

The "=defined value" part can be omitted, and in this case, "1" is used as the defined value.

This corresponds to the -D option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

Configuration of the assemble option

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 256 characters

Up to 256 items can be specified.

Macro undefinition

Specify the macro name to be undefined.

Specify in the format of "macro name", with one macro name per line.

This corresponds to the -U option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

Configuration of the assemble option

How to change

Edit by the Text Edit dialog box which appears when clicking the [...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 256 characters

Up to 256 items can be specified.

(3)	[Character Encoding]

The detailed information on character encoding is displayed and the configuration can be changed.

Character encoding	Select the character code to be used for Japanese comments and character strings in the source file. This corresponds to the -Xcharacter_set option of the ccrh command.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Auto(None)	Interprets the Japanese character code in the source file as SJIS.
		SJIS(-Xcharacter_set=sjis)	Interprets the Japanese character code in the source file as SJIS.
		EUC(-Xcharacter_set=euc_jp)	Interprets the Japanese character code in the source file as EUC.
		UFT-8(-Xcharacter_set=utf8)	Interprets the Japanese character code in the source file as UFT-8.
		Big5(-Xcharacter_set=big5)	Interprets the Chinese character code in the source file as Traditional Chinese.
		GB2312(-Xcharacter_set=gb2312)	Interprets the Chinese character code in the source file as Simplified Chinese.
		No-process(-Xcharacter_set=none)	Does not interpret the Japanese/Chinese character code in the source file.

(4)	[Output Code]

The detailed information on output codes is displayed and the configuration can be changed.

Use 32-bit branch instruction	Select whether to use the far jump function for the jarl and jr instructions. By using the far jump function, it is assumed that the jarl and jr instructions are jarl32 and jr32 instructions, and assembling is performed. This corresponds to the -Xasm_option=-Xasm_far_jump option of the ccrh command.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes(-Xasm_option=-Xasm_far_jump)	Assumes that the jarl and jr instructions are jarl32 and jr32 instructions, and performs assembling.
		No	Performs assembly as a jarl or jr instruction.

(5)	[Output File]

The detailed information on output files is displayed and the configuration can be changed.

Object file name	Specify the name of the object file generated after assembling. The extension other than ".obj" cannot be specified. If the extension is omitted, ".obj" is automatically added. If this is blank, the file name will be the source file name with the extension replaced by ".obj". This corresponds to the -o option of the ccrh command.
	Default	Blank
	How to change	Directly enter in the text box.
	Restriction	Up to 259 characters

(6)	[Assemble List]

The detailed information on the assemble list is displayed and the configuration can be changed.

Output assemble list file	Select whether to output the assemble list file. This corresponds to the -Xasm_option=-Xprn_path option of the ccrh command.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes(-Xasm_option=-Xprn_path)	Outputs the assemble list file.
		No	Does not output the assemble list file.
Output folder for assemble list file	Specify the folder which the assemble list file is output. The assemble list file is output under the source file name with the extension replaced by ".prn". If a relative path is specified, the reference point of the path is the main project or subproject folder. If an absolute path is specified, the reference point of the path is the main project or subproject folder (unless the drives are different). The following placeholder is supported. %BuildModeName%: Replaces with the build mode name. If this is blank, it is assumed that the project folder has been specified. This corresponds to the -Xasm_option=-Xprn_path option of the ccrh command. This property is displayed only when [Yes(-Xasm_option=-Xprn_path)] in the [Output assemble list file] property is selected.
	Default	Configuration of the assemble option
	How to change	Directly enter in the text box or edit by the Browse For Folder dialog box which appears when clicking the [...] button.
	Restriction	Up to 247 characters

(7)	[Error Output]

The detailed information on the error output is displayed and the configuration can be changed.

Output error message file	Select whether to output the error message file. This corresponds to the -Xerror_file option of the ccrh command. Error messages are displayed on the Output panel regardless of this property's.
	Default	Configuration of the common option
	How to change	Select from the drop-down list.
	Restriction	Yes(-Xerror_file)	Outputs the error message file.
		No	Does not output the error message file.
Error message file output folder	Specify the folder which the error message file is output. If a relative path is specified, the reference point of the path is the main project or subproject folder. If an absolute path is specified, the reference point of the path is the main project or subproject folder (unless the drives are different). The following placeholder is supported. %BuildModeName%: Replaces with the build mode name. If this is blank, it is assumed that the project folder has been specified. This corresponds to the -Xerror_file option of the ccrh command. This property is displayed only when [Yes(-Xerror_file)] in the [Output error message file] property is selected.
	Default	Configuration of the common option
	How to change	Directly enter in the text box or edit by the Browse For Folder dialog box which appears when clicking the [...] button.
	Restriction	Up to 247 characters
Error message file name	Specify the error message file name. The extension can be freely specified. The following placeholders are supported. %ActiveProjectName%: Replaces with the active project name. %MainProjectName%: Replaces with the main project name. %ProjectName%: Replaces with the project name. If this is blank, it is assumed that "%ProjectName%.err" has been specified. This corresponds to the -Xerror_file option of the ccrh command. This property is displayed only when [Yes(-Xerror_file)] in the [Output error message file] property is selected.
	Default	Configuration of the common option
	How to change	Directly enter in the text box.
	Restriction	Up to 259 characters

(8)	[Warning Message]

The detailed information on warning messages is displayed and the configuration can be changed.

Undisplayed warning message	Specify the number of the warning message not to be displayed. If multiple message numbers are specified, delimit them with "," (comma) (example: 02042,02107). Also, the range can be set using "-" (hyphen) (example: 02222-02554,02699-02782). This corresponds to the -Xno_warning option of the ccrh command.
	Default	Configuration of the common option
	How to change	Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.
	Restriction	Up to 2048 characters

(9)

[Others]

Other detailed information on assembly is displayed and the configuration can be changed.

Commands executed before assemble processing	Specify the command to be executed before assemble processing. Use the call instruction to specify a batch file (example: call a.bat). The following placeholders are supported. %ActiveProjectDir%: Replaces with the absolute path of the active project folder. %ActiveProjectName%: Replaces with the active project name. %AssembledFile%: Replaces with the absolute path of the output file under assembling. %BuildModeName%: Replaces with the build mode name. %InputFile%: Replaces with the absolute path of the file to be assembled. %MainProjectDir%: Replaces with the absolute path of the main project folder. %MainProjectName%: Replaces with the main project name. %MicomToolPath%: Replaces with the absolute path of the install folder of this product. %Options%: Replaces with the command line option under build execution. %OutputDir%: Replaces with the absolute path of the output folder. %OutputFile%: Replaces with the absolute path of the output file. %Program%: Replaces with the program name under execution. %ProjectDir%: Replaces with the absolute path of the project folder. %ProjectName%: Replaces with the project name. %TempDir%: Replaces with the absolute path of the temporary folder. %WinDir%: Replaces with the absolute path of the Windows system folder. When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed before assemble processing. The placeholders can be described in the script. The specified command is displayed as the subproperty.
	Default	Configuration of the assemble option
	How to change	Edit by the Text Edit dialog box which appears when clicking the [...] button. For the subproperty, you can enter directly in the text box.
	Restriction	Up to 1023 characters Up to 64 items can be specified.
Commands executed after assemble processing	Specify the command to be executed after assemble processing. Use the call instruction to specify a batch file (example: call a.bat). The following placeholders are supported. %ActiveProjectDir%: Replaces with the absolute path of the active project folder. %ActiveProjectName%: Replaces with the active project name. %AssembledFile%: Replaces with the absolute path of the output file under assembling. %BuildModeName%: Replaces with the build mode name. %InputFile%: Replaces with the absolute path of the file to be assembled. %MainProjectDir%: Replaces with the absolute path of the main project folder. %MainProjectName%: Replaces with the main project name. %MicomToolPath%: Replaces with the absolute path of the install folder of this product. %Options%: Replaces with the command line option under build execution. %OutputDir%: Replaces with the absolute path of the output folder. %OutputFile%: Replaces with the absolute path of the output file. %Program%: Replaces with the program name under execution. %ProjectDir%: Replaces with the absolute path of the project folder. %ProjectName%: Replaces with the project name. %TempDir%: Replaces with the absolute path of the temporary folder. %WinDir%: Replaces with the absolute path of the Windows system folder. When "#!python" is described in the first line, the contents from the second line to the last line are regarded as the script of the Python console, and then executed after assemble processing. The placeholders can be described in the script. The specified command is displayed as the subproperty.
	Default	Configuration of the assemble option
	How to change	Edit by the Text Edit dialog box which appears when clicking the [...] button. For the subproperty, you can enter directly in the text box.
	Restriction	Up to 1023 characters Up to 64 items can be specified.
Other additional options	Input the assemble option to be added additionally. The assembler is executed via ccrh.exe. Add "-Xasm_option=" as required. The options set here are added at the end of the assemble options group.
	Default	Configuration of the assemble option
	How to change	Directly enter in the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.
	Restriction	Up to 259 characters