[Common Options] tab


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

 

(1) [Build Mode]

(2) [Output File Type and Path]

(3) [Frequently Used Options(for Compile)]

(4) [Frequently Used Options(for Assemble)]

(5) [Frequently Used Options(for Link)]

(6) [Frequently Used Options(for Create Library)]

(7) [Build Method]

(8) [Path of Tools]

(9) [Notes]

(10) [Others]

Remark 1.

If the property in the [Frequently Used Options] category is changed, the value of the property having the same name contained in the corresponding tab will be changed accordingly.

Remark 2.

For details on compiler driver options, refer to "MULTI: Building Applications for Embedded V850 and RH850" released by Green Hills Software. Please do not contact Green Hills Software with any inquiries about the CCRH850 build-tool plugin of CS+.

Caution

This tab is displayed only when the current project has been created with [Empty Application(GHS CCRH850)] or [Library(GHS CCRH850)] selected as the project type.

Figure A.2

Property Panel: [Common Options] Tab

[Description of each category]

(1)

[Build Mode]

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

Build mode

Select the build mode to be used during a build.

Note that this property is not applied to [Reset All to Default] from the context menu.

Default

DefaultBuild

How to change

Select from the drop-down list.

Restriction

DefaultBuild

Runs a build with the default build mode that is set when a new project is created.

Build mode that is added to the project

Runs a build with the build mode that is added to the project (other than DefaultBuild).

Change property value for all build modes at once

Select whether to reflect the value newly set to all build modes when a value is set in this property.

Be careful since the value set may not be an appropriate value for other build modes.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Reflects the value newly set to all build modes when a value is set in this property.

No

Does not reflect the value newly set to all build modes when a value is set in this property.

(2)

[Output File Type and Path]

The detailed information on output file types and paths is displayed and the configuration can be changed.

Output file type

The file type set here will be the debug target for other than the library project.

For other than library projects, only [Execute Module(Load Module File)] and [Execute Module(Hex File)] are displayed.

For the library project, only [Library] is displayed.

Default

-

For other than the library project

Execute Module(Load Module File)

-

For the library project

Library

How to change

Select from the drop-down list.

Restriction

Execute Module(Load Module File)

Generates a load module file during a build.

The load module file will be the debug target.

Execute Module(Hex File)

Generates a hex file during a build.

The hex file will be the debug target.

This item is displayed only when other than [Not specify(None)] in the [Generate Additional Output] property in the [Hex Output] category from the [Link Options] tab is selected.

Library

Generates a library file during a build.

Target Processor

Specify the -cpu option of the compiler driver.

Default

RH850G3M(-cpu=rh850g3m)

How to change

Select from the drop-down list.

Restriction

RH850G3M(-cpu=rh850g3m)

Specifies the -cpu=rh850g3m option.

RH850G3K(-cpu=rh850g3k)

Specifies the -cpu=rh850g3k option.

RH850G3KH(-cpu=rh850g3kh)

Specifies the -cpu=rh850g3kh option.

RH850G3MH(-cpu=rh850g3mh)

Specifies the -cpu=rh850g3mh option.

Not specify(None)

Does not specify the -cpu option.

Object File Output Directory

Specify the folder which the intermediate file is output.

The following placeholder is supported.

%ActiveProjectDir%: Replaces with the absolute path of the active project folder.

%BuildModeName%: Replaces with the build mode name.

%MainProjectDir%: Replaces with the absolute path of the main project folder.

%ProjectDir%: Replaces with the absolute path of the project folder.

If this is blank, it is assumed that the project folder has been specified.

This corresponds to the -object_dir or -o option of the compiler driver.

Default

obj\%ProjectName%\%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

(3)

[Frequently Used Options(for Compile)]

The detailed information on frequently used options during compilation is displayed and the configuration can be changed.

Optimization Strategy

Specify the -O option of the compiler driver.

Default

Optimize for Debuggability (-Odebug)

How to change

Select from the drop-down list.

Restriction

Optimize for Debuggability (-Odebug)

Specifies the -Odebug option.

Optimize for General Use (-O)

Specifies the -O option.

Optimize for Size (-Osize)

Specifies the -Osize option.

Optimize for Speed (-Ospeed)

Specifies the -Ospeed option.

No Optimizations (-Onone)

Specifies the -Onone option.

Not specify(None)

Does not specify Optimization Strategy.

Include Directories

Specify the -I option of the compiler driver.

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.

The specified include path is displayed as the subproperty.

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

Default

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

System include paths

Change the specified order of the include paths which CS+ sets during compiling.

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 corresponds to the -I option of the compiler driver.

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

Define Preprocessor Symbol

Specify the -D option of the compiler driver.

Specify in the format of "macro name=defined value", with one macro name per line.

The specified macro is displayed as the subproperty.

Default

Define Preprocessor Symbol[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.

(4)

[Frequently Used Options(for Assemble)]

The detailed information on frequently used options during assembling is displayed and the configuration can be changed.

Include Directories

Specify the -I option of the compiler driver.

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.

The specified include path is displayed as the subproperty.

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

Default

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

System include paths

Change the specified order of the include paths which CS+ sets 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 corresponds to the -I option of the compiler driver.

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

Define Preprocessor Symbol

Specify the -D option of the compiler driver.

Specify in the format of "macro name=defined value", with one macro name per line.

The specified macro is displayed as the subproperty.

Default

Define Preprocessor Symbol[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.

(5)

[Frequently Used Options(for Link)]

The detailed information on frequently used options during linking is displayed and the configuration can be changed.

This category is not displayed for the library project.

Libraries

Specify the -I option of the compiler driver.

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 library file name is displayed as the subproperty.

Default

Libraries[number of defined items]

How to change

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

-> Edit by the Specify Using Library File dialog box which appears when clicking the [Browse...] button.

For the subproperty, you can enter directly in the text box.

Restriction

Up to 259 characters

Up to 65536 items can be specified.

Output folder

Specify the output folder.

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.

If this is blank, it is assumed that the project folder has been specified.

This corresponds to the -o option of the compiler driver.

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

Output file name

Specify the output file name.

The following placeholders are supported.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectName%: Replaces with the main project name.

%ProjectName%: Replaces with the project name.

This corresponds to the -o option of the compiler driver.

Default

%ProjectName%

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Generate Additional Output

Specify the -srec or -hex option of the compiler driver.

Default

S-Record File(-srec)

How to change

Select from the drop-down list.

Restriction

S-Record File(-srec)

Specifies the -srec option.

HEX386 File(-hex)

Specifies the -hex option.

Not specify(None)

Does not specify Generate Additional Output.

(6)

[Frequently Used Options(for Create Library)]

The detailed information on frequently used options during library generation is displayed and the configuration can be changed.

This category is displayed only for the library project.

Output folder

Specify the output folder.

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.

If this is blank, it is assumed that the project folder has been specified.

This corresponds to the -o option of the compiler driver.

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

Output file name

Specify the output file name.

The following placeholders are supported.

%ActiveProjectName%: Replaces with the active project name.

%BuildModeName%: Replaces with the build mode name.

%MainProjectName%: Replaces with the main project name.

%ProjectName%: Replaces with the project name.

This corresponds to the -o option of the compiler driver.

Default

%ProjectName%

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

(7)

[Build Method]

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

Handling the source file includes unfound file

Select whether to recompile/assemble the source file if it includes a file that is not found in the standard include paths and the [Include Directories] property.

Default

Re-compile/assemble the source file

How to change

Select from the drop-down list.

Restriction

Re-compile/assemble the source file

Recompiles/assembles the source file if it includes a file that is not found.

Ignore re-compiling/assembling the source file

Does not recompile/assemble the source file even if it includes a file that is not found.

(8)

[Path of Tools]

The detailed information on the path of tools is displayed and the configuration can be changed.

Compiler package folder

Specify the folder of the compiler package to be used.

This is common to all the build modes.

Default

Value-according-to-installation-environment

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

Executable file name of compiler

Specify the executable file name of the compiler.

This is common to all the build modes.

Default

ccrh850.exe

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

Executable file name of assembler

Specify the executable file name of the assembler.

This is common to all the build modes.

Default

ccrh850.exe

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

Executable file name of linker

Specify the executable file name of the linker.

This is common to all the build modes.

Default

ccrh850.exe

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

(9)

[Notes]

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

Memo

Add memos to the build tool.

Add one item in one line.

This setting is common to all the build modes.

The specified memo is displayed as the subproperty.

Default

Memo[number-of-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.

(10)

[Others]

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

Output message format

Specify the format of the message under build execution.

This applies to the messages output by the build tool to be used, and commands added by plugins.

It does not apply to the output messages of commands specified in the [Commands executed before build processing] or [Commands executed after build processing] property.

The following placeholders are supported.

%Options%: Replaces with the command line option under build execution.

%Program%: Replaces with the program name under execution.

%TargetFiles%: Replaces with the file name being compile/assemble or making link.

If this is blank, "%Program% %Options%" will be set automatically.

Default

%TargetFiles%

How to change

Directly enter in the text box (up to 256 characters) or select from the drop-down list.

Restriction

%TargetFiles%

Displays the file name in the output message.

%TargetFiles%: %Options%

Displays the file name and command line options in the output message.

%Program% %Options%

Displays the program name and command line options in the output message.

Format of build option list

Specify the display format of the build option list.

This applies to the options of the build tool to be used, and commands added by plugins.

It does not apply to the options of commands specified in the [Commands executed before build processing] or [Commands executed after build processing] property.

The following placeholders are supported.

%Options%: Replaces with the command line option under build execution.

%Program%: Replaces with the program name under execution.

%TargetFiles%: Replaces with the file name being compile/assemble or making link.

If this is blank, "%TargetFiles% : %Program% %Options%" will be set automatically.

Default

%TargetFiles% : %Program% %Options%

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

Commands executed before build processing

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

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

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

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

%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 build processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed before build 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 build processing

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

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

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

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

%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 build processing.

The placeholders can be described in the script.

The specified command is displayed as the subproperty.

Default

Commands executed after build 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 option to be added additionally.

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

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