[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) [Optimization]

(3) [Preprocess]

(4) [Character Encoding]

(5) [Output File]

(6) [Assemble List]

(7) [Error Output]

(8) [Warning Message]

(9) [Others]

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.

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 ccrl 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)

[Optimization]

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

Outputs additional information for inter-module optimization

Select whether to output additional information for inter-module optimization.

At linkage, inter-module optimization is applied to files for which this option has been specified.

This corresponds to the -goptimize option of the ccrl command.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-goptimize)

Outputs additional information for inter-module optimization.

No

Does not outputs additional information for inter-module optimization.

(3)

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

The reference point of the path is the project folder.

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

This corresponds to the -I option of the ccrl 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 247 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 setting of the [Compile Options] tab is used when [Yes] in the [Build simultaneously] property in the [Build Method] category from the [Common Options] tab is selected.

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

-

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

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.

No

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 -asmopt=-define option of the ccrl 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 -asmopt=-undefine option of the ccrl 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.

(4)

[Character Encoding]

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

Format of numerical constant

Specify the representation format of the base number of numerical constants.

Example) Prefix format: 0xFFFF, Suffix format: FFFFH

This corresponds to the -asmopt=-base_number option of the ccrl command.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Prefix format(None)

Handles numerical constants in the Prefix format.

Suffix format(-asmopt=-base_number=suffix)

Handles numerical constants in the Suffix format.

Character encoding

Select the character code to be used for Japanese comments and character strings in the source file.

This corresponds to the -character_set option of the ccrl 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 on Japanese OS.

On other than Japanese OS, does not interpret the character code in the source file.

SJIS(-character_set=sjis)

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

EUC(-character_set=euc_jp)

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

UTF-8(-character_set=utf8)

Interprets the Japanese character code in the source file as UTF-8.

Big5(-character_set=big5)

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

GB2312(-character_set=gb2312)

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

No-process(-character_set=none)

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

(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 ccrl 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 -asmopt=-prn_path option of the ccrl command.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-asmopt=-prn_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 -asmopt=-prn_path option of the ccrl command.

This property is displayed only when [Yes(-asmopt=-prn_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 -error_file option of the ccrl command.

Error messages are displayed on the Output panel regardless of this property's.

This property is displayed only when [No] in the [Build in parallel] property in the [Build Method] category from the [Common Options] tab is selected

Default

Configuration of the common option

How to change

Select from the drop-down list.

Restriction

Yes(-error_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 -error_file option of the ccrl command.

This property is displayed only when [Yes(-error_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 -error_file option of the ccrl command.

This property is displayed only when [Yes(-error_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: 20009,20011).

Also, the range can be set using "-" (hyphen) (example: 20000-20100,20300-20500).

This corresponds to the -no_warning option of the ccrl 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 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