Development Tools

[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 and [Assemble Options] tab.

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

Remark

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

[Description of each category]

(1)

[Source]

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

Additional include paths

Specifies the name of the path to the folder that stores the include file.

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 reference point of the path is the project folder.

This property corresponds to the -include option of the assembler.

The specified include path is displayed as the subproperty.

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 use the text box directly enter the text.

Restriction

Up to 247 characters

Up to 65536 items can be specified.

Use whole include paths specified for build tool

Selects whether to assemble using the include path specified in the [Additional include paths] property in the [Source] 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] in the [Source] category from the [Assemble Options] tab

This property corresponds to the -include option of the assembler.

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

Specifies the macro name to be defined.

Specifies in the format of "macro name=string", with one macro name per line.

This property corresponds to the -define option of the assembler.

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 use the text box directly enter the text.

Restriction

Up to 32767 characters

Up to 65536 items can be specified.

Character code of an input program

Selects character code of an input program.

This property corresponds to the -euc, -sjis, -latin1, -big5, and -gb2312 option of the assembler.

[Traditional Chinese character (-big5)] and [Simplified Chinese character (-gb2312)] are displayed when you have selected [Always latest version which was installed] or V2.00.00 or a later version for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V2.00.00 or a later version of the CC-RX compiler has been installed.

[UTF-8 code (-utf8)] is displayed when you have selected [Always latest version which was installed] or V2.04.00 or a later version for the [Using compiler package version] property in an environment where V2.04.00 or a later version of the CC-RX compiler has been installed.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

EUC code (-euc)

Handles the characters in strings, character constants, and comments by using EUC.

SJIS code (-sjis)

Handles the characters in strings, character constants, and comments by using SJIS.

ISO-Latin1 code (-latin1)

Handles the characters in strings, character constants, and comments by using ISO-Latin1.

UTF-8 code (-utf8)

Handles the characters in strings, character constants, and comments by using UTF-8.

Traditional Chinese character (-big5)

Handles the characters in strings, character constants, and comments by using Traditional Chinese character.

Simplified Chinese character (-gb2312)

Handles the characters in strings, character constants, and comments by using Simplified Chinese character.

(2)

[Object]

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

Path of the output folder	Specifies the output destination folder for the output file. The following placeholders are supported. %BuildModeName%: Replaces with the build mode name. %ProjectName%: Replaces with the project name. %MicomToolPath%: Replaces with the absolute path of the product install folder. If this is blank, it is assumed that the project folder has been specified. This property corresponds to the -output option of the assembler. This property is displayed when [Always latest version which was installed] or a version number earlier than V2.00.00 is selected for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where a version of the CC-RX compiler earlier than V2.00.00 has been installed.
	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
Object module file name	Specifies the name of the object module 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 property corresponds to the -output option of the assembler. This property is displayed when you have selected [Always latest version which was installed] or V2.00.00 or a later version for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V2.00.00 or a later version of the CC-RX compiler has been installed.
	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 259 characters
Outputs debugging information	Selects whether to output debugging information to object module files. This property corresponds to the -debug and -nodebug options of the assembler.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes (-debug)	Outputs debugging information to object module files.
		No (-nodebug)	Does not output debugging information to object module files.
Suppress outputting data to unused area made by .OFFSET	Selects whether to suppress outputting data to the unused area made by .OFFSET. This property corresponds to the -create_unfilled_area option of the assembler. This property is displayed when you have selected [Always latest version which was installed] or V2.03.00 or a later version for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V2.03.00 or a later version of the CC-RX compiler has been installed.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes(-create_unfilled_area)		Suppresses outputting data to the unused area made by .OFFSET.
		No		Does not suppress outputting data to the unused area made by .OFFSET.

(3)

[List]

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

Outputs an assemble list file	Selects whether to output an assemble list file. This property corresponds to the -listfile and -nolistfile option of the assembler.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes (-listfile)	Outputs an assemble list file.
		No (-nolistfile)	Does not output an assemble list file.
Outputs the statements unsatisfied in conditional assembly	Specifies the contents of the assemble list file. Selects whether to output the statements unsatisfied in conditional assembly. This property corresponds to the -show option of the assembler. This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes (-show=conditionals)	Outputs the statements unsatisfied in conditional assembly.
		No	Does not output the statements unsatisfied in conditional assembly.
Outputs the information before .DEFINE replacement	Specifies the contents of the assemble list file. Selects whether to output the information before .DEFINE replacement. This property corresponds to the -show option of the assembler. This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes (-show=definitions)	Outputs the information before replacement specified with .DEFINE.
		No	Does not output the information before replacement specified with .DEFINE.
Outputs the assembler macro expansion statements	Specifies the contents of the assemble list file. Selects whether to output the assembler macro expansion statements. This property corresponds to the -show option of the assembler. This property is displayed only when [Yes (-listfile)] in the [Output a assemble list file] property is selected.
	Default	Configuration of the assemble option
	How to change	Select from the drop-down list.
	Restriction	Yes (-show=expansions)	Outputs the macro expansion statements.
		No	Does not output the macro expansion statements.

(4)

[Object]

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

Output additional information for inter-module optimization	Selects 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 property corresponds to the -goptimize option of the assembler.
	Default	No
	How to change	Select from the drop-down list.
	Restriction	Yes (-goptimize)	Outputs additional information for inter-module optimization.
		No	Does not output additional information for inter-module optimization.

(5)

[Others]

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

Checks for a privileged instruction

Selects whether to check for a privileged instruction.

This property corresponds to the -chkpm option of the assembler.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes (-chkpm)

Checks for a privileged instruction.

Does not check for a privileged instruction.

Checks for a single-precision floating-point operation instruction

Selects whether to check for a single-precision floating-point operation instruction.

This property corresponds to the -chkfpu option of the assembler.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes (-chkfpu)

Checks for a single-precision floating-point operation instruction.

Does not check for a single-precision floating-point operation instruction.

Checks for a double-precision floating-point operation instruction

Selects whether to check for a double-precision floating-point operation instruction.

This property corresponds to the -chkdpfpu option of the assembler.

This property is displayed when you have selected [Always latest version which was installed] or V3.01.00 or a later version for the [Using compiler package version] property under the [Version Select] category on the [Common Options] tab in an environment where V3.01.00 or a later version of the CC-RX compiler has been installed.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes (-chkdpfpu)

Checks for a double-precision floating-point operation instruction.

Does not check for a double-precision floating-point operation instruction.

Checks for a DSP instruction

Selects whether to check for a DSP instruction.

This property corresponds to the -chkdsp option of the assembler.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes (-chkdsp)

Checks for a DSP instruction.

Does not check for a DSP instruction.

Outputs the copyright

Selects whether to output the copyright.

This property corresponds to the -logo and -nologo option of the assembler.

Default

Configuration of the assemble option

How to change

Select from the drop-down list.

Restriction

Yes (-logo)

Outputs the copyright.

No (-nologo)

Disables output of the copyright.

Commands executed before assemble processing

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

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the file name of the running program.

%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 use the text box directly enter the text.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Commands executed after assemble processing

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

%OutputDir%: Replaces with the absolute path of the output folder.

%OutputFile%: Replaces with the absolute path of the output file.

%Program%: Replaces with the file name of the running program.

%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 use the text box directly enter the text.

Restriction

Up to 1023 characters

Up to 64 items can be specified.

Other additional options

Inputs the assemble options to be added additionally.

The options set here are added at the end of the assemble options group.

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.

Caution

When [Yes] is selected on the [Build simultaneously] property in the [Build Method] category from the [Common Options] tab , only one option can be specified in this property.

Default

Configuration of the assemble option

How to change

Directly enter to the text box or edit by the Character String Input dialog box which appears when clicking the [...] button.

Restriction

Up to 259 characters

Command line

The specified option is displayed.

Default

Configuration of the assemble option

How to change

Changes not allowed