Everything
 

[Individual FAA Assemble Options] tab


This ta b shows the detailed information on an FAA 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 [FAA Assemble Options] tab.

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

 

(1)[Debug Information]

(2)[Preprocess]

(3)[Output Code]

(4)[Output file]

(5)[Others]

Remark

This tab is displayed only in the following cases

-

When [Yes] in the [Set individual FAA assemble option] property in the [Build] category from the [Build Settings] tab is selected

-

When the microcontroller has a FAA.

 

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

This property corresponds to the -no_debug_info option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes

Generates the debug information.

No(-no_debug_info)

Does not generate the debug information.

(2)

[Preprocess]

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

Include paths

Specify the include paths during FAA 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 reference point of the path is the project folder.

This property corresponds to the -inc_dir option of the dspasm command.

The specified include path is displayed as the subproperty.

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

Default

Configuration of the FAA assemble option

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.

First character of text macro

Specify the first character of the text macro.

This property corresponds to the -text_macro option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Directly enter in the text box.

Restriction

One of the following letters:

# (sharp) ' (apostrophe) ` (accent grave) @ (at mark) _ (underscore)

Text macro definition

Specify the text macro to be defined in the format of "(macro name)#(defined value)", with one macro name per line.

This option corresponds to the -define option of the dspasm command.

The specified macro is displayed as the subproperty.

Default

Configuration of the FAA 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.

Allow to redefine text macro

Specify whether to allow to redefine a text macro.

This option corresponds to the -allow_text_macro_redefine option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-allow_text_macro_redefine)

Allows to redefine text macro.

No

Does not allow to redefine text macro.

Method for recognizing the text macros

Specify the method for recognizing the macro when a text macro is to be replaced.

This option corresponds to the -macro_identify option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Forward

The forward-matching method is used to recognize the text macro.

Exact(-macro_identify exact)

The word-matching method is used to recognize the text macro.

(3)

[Output Code]

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

Start address of section of code

Specify the start address of the section of code in hexadecimal without 0x.

This corresponds to the -code_section_start option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Directly enter in the text box.

Restriction

-

When the value of the [Version of FAA core] property is [V2 core(-core_version 2)]: 0 to FFF

-

When the value of the [Version of FAA core] property is [V3 core(No option specified)]: 0 to 3FFF

Start address of section of data

Specify the start address of the section of data in hexadecimal without 0x.

This corresponds to the -data_section_start option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Directly enter in the text box.

Restriction

-

When the value of the [Version of FAA core] property is [V2 core(-core_version 2)]: 0 to FFF

-

When the value of the [Version of FAA core] property is [V3 core(No option specified)]: 0 to 1FFF

(4)

[Output file]

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

Output folder

Specify the folder name of the object file to be generated after FAA assembling.

If this is blank, the object file is outputted to the folder specified by the [Intermediate file output folder] property in the [Common Options] tab.

This property corresponds to the -output option of the dspasm command.

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 247 characters

Output assembly source file

Select whether to output the assembly source file.

This option corresponds to the -format option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-format ASM)

Outputs the assembly source file.

No

Does not output the assembly source file.

Output VERILOG file

Select whether to output the VERILOG file.

This option corresponds to the -format option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-format VERILOG)

Outputs the VERILOG file.

No

Does not output the VERILOG file.

Output result of preprocessing to file

Select whether to output the result of preprocessing to a file.

This option corresponds to the -E option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-E)

Outputs the result of preprocessing to a file.

No

Does not output the result of preprocessing to a file.

Output list file

Select whether to output the list file.

This option corresponds to the -list option of the dspasm command.

Default

Configuration of the FAA assemble option

How to change

Select from the drop-down list.

Restriction

Yes(-list)

Outputs the list file.

No

Does not output the list file.

(5)

[Others]

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

Commands executed before FAA assemble processing

Specify the command to be executed before FAA 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 FAA assembling.

%BuildModeName%: Replaces with the build mode name.

%InputFile%: Replaces with the absolute path of the file to be FAA 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 FAA assemble processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Configuration of the FAA 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 FAA assemble processing

Specify the command to be executed after FAA 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 FAA assembling.

%BuildModeName%: Replaces with the build mode name.

%InputFile%: Replaces with the absolute path of the file to be FAA 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 FAA assemble processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Configuration of the FAA 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 FAA assemble option to be added additionally.

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

Default

Configuration of the FAA 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