[Assemble Options] tab


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

 

(1) [Debug Information]

(2) [Preprocess]

(3) [Character Encoding]

(4) [Output Code]

(5) [Assemble List]

(6) [Others]

Figure A.4

Property Panel: [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 property corresponds to the -g option of the ccrh command.

Default

Yes(-g)

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 property corresponds to the -I option of the ccrh command.

The specified include path is displayed as the subproperty.

When the include path is added to the project tree, the path is added to the top of the subproperties.

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.

System include paths

Change the specified order of the include paths which the system set 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 system include path is searched with lower priority than the additional include path.

The reference point of the path is the project folder.

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

The include path is displayed as the subproperty.

Default

System include paths[number of defined items]

How to change

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

Restriction

Changes not allowed (Only the specified order of the include paths can be changed.)

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 property corresponds to the -D option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

Macro definition[number of defined items]

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 property corresponds to the -U option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

Macro undefinition[number of defined items]

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 property corresponds to the -Xcharacter_set option of the ccrh command.

Default

Auto(None)

How to change

Select from the drop-down list.

Restriction

Auto(None)

Interprets the Japanese character codes in the source file as SJIS.

SJIS(-Xcharacter_set=sjis)

Interprets the Japanese character codes in the source file as SJIS.

EUC(-Xcharacter_set=euc_jp)

Interprets the Japanese character codes in the source file as EUC.

UFT-8(-Xcharacter_set=utf8)

Interprets the Japanese character codes in the source file as UFT-8.

Big5(-Xcharacter_set=big5)

Interprets the Chinese character codes in the source file as Traditional Chinese.

GB2312(-Xcharacter_set=gb2312)

Interprets the Chinese character codes in the source file as Simplified Chinese.

No-process(-Xcharacter_set=none)

Does not interpret the Japanese/Chinese character codes in the source file.

(4)

[Output Code]

The detailed information on output code 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 property corresponds to the -Xasm_option=-Xasm_far_jump option of the ccrh command.

Default

No

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)

[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 property corresponds to the -Xasm_option=-Xprn_path option of the ccrh command.

Default

No

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

%BuildModeName%

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

(6)

[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 (except in case of simultaneous building).

%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

Commands executed before assemble processing[number of defined items]

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 (except in case of simultaneous building).

%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

Commands executed after assemble processing[number of defined items]

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

Blank

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