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

Figure A.16

Property Panel: [Individual Assemble Options] Tab

[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 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 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 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 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 [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V2.00.00 or higher or when V2.00.00 or higher is selected in the [Using compiler package version] property.

[UTF-8 code (-utf8)] is displayed when [Always latest version which was installed] in the [Using compiler package version] property is selected and the latest version is V2.04.00 or higher or when V2.04.00 or higher is selected in the [Using compiler package version] property.

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 corresponds to the -output option of the assembler. This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V2.00.00 or lower or when V2.00.00 or lower is selected in the [Using compiler package version] property.
	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 corresponds to the -output option of the assembler. This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V2.00.00 or higher or when V2.00.00 or higher is selected in the [Using compiler package version] property.
	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 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 corresponds to the -create_unfilled_area option of the assembler. This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V2.03.00 or lower or when V2.03.00 or lower is selected in the [Using compiler package version] property.
	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 a assemble list file	Selects whether to output an assemble list file. This 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 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 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 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 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 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.
		No	Does not check for a privileged instruction.
Checks for a floating-point operation instruction	Selects whether to check for a floating-point operation instruction. This 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 floating-point operation instruction.
		No	Does not check for a floating-point operation instruction.
Checks for a DSP instruction	Selects whether to check for a DSP instruction. This 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.
		No	Does not check for a DSP instruction.
Outputs the copyright	Selects whether to output the copyright. This 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. %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. %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.
	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