[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 Hex Output)]

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

(8) [Device]

(9) [PIC/PID]

(10) [Register Mode]

(11) [Error Output]

(12) [Warning Message]

(13) [Build Method]

(14) [Version Select]

(15) [Notes]

(16) [Others]

Remark

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.

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 [Yes] in the [Output hex file] property in the [Output File] category from the [Hex Output Options] tab is selected.

Library

Generates a library file during a build.

Output common object file for various devices

Specify the output of an object file common to the various devices.

This property corresponds to the -Xcommon option of the ccrh command.

This property is displayed in any one of the following cases.

-

In an environment where V2.00.00 or a later version of the CC-RH compiler has not been installed

-

When a version number earlier than V2.00.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V2.00.00 has been installed

Default

Yes(RH850 architecture common)(-Xcommon=rh850)

How to change

Select from the drop-down list.

Restriction

Yes(RH850 architecture common)(-Xcommon=rh850)

The result is the same as when [Yes(V850E3V5 architecture common)(-Xcommon=v850e3v5)] is specified.

Yes(V850E3V5 architecture common)(-Xcommon=v850e3v5)

Outputs the object file compatible with models having the V850E3V5 instruction set architecture.

Specify CPU core

Specify the CPU core.

This property corresponds to the -Xcpu option of the ccrh command.

[Object for G3MH(-Xcpu=g3mh)] is displayed when [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed.

[Object for G3KH(-Xcpu=g3kh)] is displayed when [Always latest version which was installed] or V1.03.00 or a later version is selected for the [Using compiler package version] property in an environment where V1.03.00 or a later version of the CC-RH compiler has been installed.

[Object for G4MH(-Xcpu=g4mh)] is displayed when [Always latest version which was installed] or V2.00.00 or a later version is selected for the [Using compiler package version] property in an environment where V2.00.00 or a later version of the CC-RH compiler has been installed.

The Restriction values depend on the device in use.

Default

-

The project type is [Application(CC-RH)], [Empty Application(CC-RH)], or [Library(CC-RH)]

Object for G3K(-Xcpu=g3k)

-

The project type is [Boot Loader for Multi-core(CC-RH)] or [Application for Multi-core(CC-RH)]

Object for G3M(-Xcpu=g3m)

How to change

Select from the drop-down list.

Restriction

Object for G3M(-Xcpu=g3m)

Generates an object for G3M.

Object for G3MH(-Xcpu=g3mh)

Generates an object for G3MH.

Object for G3K(-Xcpu=g3k)

Generates an object for G3K.

Object for G3KH(-Xcpu=g3kh)

Generates an object for G3KH.

Object for G4MH(-Xcpu=g4mh)

Generates an object for G4MH.

Output cross reference information

Select whether to output the cross reference information to a file.

The file is output to the folder specified in the [Output folder] property in the [Output File] category from the [Link Options] tab.

The file is output under the file name specified in the [Output file name] property with the extension replaced by ".cref".

However, if the [Object file name] property in the [Output File] category from the [Individual Compile Options] tab is specified, the file is output under the file name specified in the property with the extension replaced by ".cref".

This property is changed to [Yes(-Xcref)] when [Yes] in the [Compulsorily output cross reference file] property of the analyze tool is selected. If this property is changed to [No] when [Yes] in the [Compulsorily output cross reference file] property is selected, this property will be changed to [Yes(-Xcref)] during a build.

This property corresponds to the -Xcref option of the ccrh command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Xcref)

Outputs the cross reference information.

The build processing speed slows down, but "jump to function" can be used.

No

Does not output the cross reference information.

Intermediate file output folder

Specify the folder which the intermediate 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.

%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 property corresponds to the -Xobj_path option of the ccrh command.

The setting of this property affects the destination of output for the following files.

-

Object file (*.obj)

-

Subcommand file for the compiler (*.ccr)

-

Subcommand file for the assembler (*.cas)

-

Subcommand file for the optimizing linker (For other than the library project) (*.clnk)

-

Subcommand file for the optimizing linker (For the library project) (*.ccl)

 

The subcommand file for the compiler or assembler lists the compiler or assembler options delimited with a space. This is output only when the command line of the compiler or assembler is long.

The subcommand file for the optimizing linker lists the optimizing linker options delimited with LF.

Subcommand files are used internally by CS+, and they will be overwritten when there are already existing files at the time of building.

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

(3)

[Frequently Used Options(for Compile)]

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

Level of optimization

Select the level of the optimization for compiling.

This property corresponds to the -O option of the ccrh command.

Default

Perform the default optimization(None)

How to change

Select from the drop-down list.

Restriction

Perform the default optimization(None)

Performs optimization that debugging is not affected (optimization of expressions and register allocation, and the like).

Code size precedence(-Osize)

Performs optimization with the object size precedence.

Regards reducing the ROM/RAM capacity as important and performs the maximum optimization that is effective for general programs.

Speed precedence(-Ospeed)

Performs optimization with the execution speed precedence.

Regards shortening the execution speed as important and performs the maximum optimization that is effective for general programs.

Debug precedence(-Onothing)

Performs optimization with the debug precedence.

Regards debugging as important and suppresses all optimization including default optimization.

Additional include paths

Specify the additional include paths 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 specified include path is searched with higher priority than the standard include file folder of CC-RH.

The reference point of the path is the project folder.

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

This property corresponds to the -I option of the ccrh command.

The specified include path is displayed as the subproperty.

When the include path is added to the project tree, the path is added to the top of the subproperties.

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

Up to 256 items can be specified.

System include paths

Change the specified order of the include paths which the system set 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 property corresponds to the -I option of the ccrh command.

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

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 property corresponds to the -D option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

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

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

The reference point of the path is the project folder.

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

This property corresponds to the -I option of the ccrh command.

The specified include path is displayed as the subproperty.

When the include path is added to the project tree, the path is added to the top of the subproperties.

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

Up to 256 items can be specified.

System include paths

Change the specified order of the include paths which the system set 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 property corresponds to the -I option of the ccrh command.

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

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 property corresponds to the -D option of the ccrh command.

The specified macro is displayed as the subproperty.

Default

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

Using libraries

Specify the library files to be used.

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.

This property corresponds to the -LIBrary option of the rlink command.

The library file name is displayed as the subproperty.

Default

Using 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 property corresponds to the -OUtput option of the rlink command.

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.

If the extension is omitted, ".abs" is automatically added.

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.

This property corresponds to the -OUtput option of the rlink command.

Default

%ProjectName%.abs

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Use standard libraries

Select whether to use the standard libraries provided by the compiler.

This property corresponds to the -LIBrary option of the rlink command.

[Yes(V1.01 compatible)] is displayed when [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard libraries.

Yes(V1.01 compatible)

Uses the libraries compatible with CC-RH V1.01.

No

Does not use the standard libraries.

Use "Standard Library" function

Select whether to use the standard library functions.

This property is changed to [Yes(-LIBrary=libc)] when [Yes] in the [Use "Mathematical Library (Double precision)" function] or [Use "Mathematical Library (Single precision)" function] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

Yes(-LIBrary=libc)

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libc)

Uses the standard library functions.

No

Does not use the standard library functions.

Use "Mathematical Library (Double precision)" function

Select whether to use the mathematical library (double precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

Yes(-LIBrary=libm)

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libm)

Uses the mathematical library (double precision) functions.

No

Does not use the mathematical library (double precision) functions.

Use "Mathematical Library (Single precision)" function

Select whether to use the mathematical library (single precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

Yes(-LIBrary=libmf)

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libmf)

Uses the mathematical library (single precision) functions.

No

Does not use the mathematical library (single precision) functions.

Use "Standard/Mathematical Library" function

Select whether to use the standard/mathematical library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes] in the [Use standard libraries] property is selected

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard/mathematical library functions.

No

Does not use the standard/mathematical library functions.

Use "Non-local jump Library" function

Select whether to use the non-local jump library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed only when other than [No] in the [Use standard libraries] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libsetjmp)

Uses the non-local jump library functions.

No

Does not use the non-local jump library functions.

(6)

[Frequently Used Options(for Hex Output)]

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

This category is not displayed for the library project.

Output hex file

Select whether to output the hex file.

This property corresponds to the -FOrm option of the rlink command.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Outputs the hex file.

No

Does not output the hex file.

Hex file format

Select the format of the hex file to be output.

This property corresponds to the -FOrm option of the rlink command.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

Default

Motorola S-record file(-FOrm=Stype)

How to change

Select from the drop-down list.

Restriction

Intel HEX file(-FOrm=Hexadecimal)

Outputs an Intel HEX file.

Motorola S-record file(-FOrm=Stype)

Outputs a Motorola S-record file.

Binary file(-FOrm=Binary)

Outputs a binary file.

Output folder

Specify the folder which the hex 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 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 property corresponds to the -OUtput option of the rlink command.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

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 hex file name.

If the extension is omitted, it is automatically added according to the selection in the [Hex file format] property.

When [Intel HEX file(-FOrm=Hexadecimal)] is selected: .hex

When [Motorola S-record file(-FOrm=Stype)] is selected: .mot

When [Binary file(-FOrm=Binary)] is selected: .bin

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.

This property corresponds to the -OUtput option of the rlink command.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

Default

%ProjectName%.mot

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Division output file

Specify the division output files.

Specify in the format of "file name=start address-end address" or "file name=section name", with one entry per line.

If multiple section names are specified, delimit them with a colon as in "file name=section name:section name" (example: file1.mot=sec1:sec2).

Specify the address in hexadecimal (example: file2.mot=400-4ff).

If the extension is omitted, it is automatically added according to the selection in the [Hex file format] property.

When [Intel HEX file(-FOrm=Hexadecimal)] is selected: .hex

When [Motorola S-record file(-FOrm=Stype)] is selected: .mot

When [Binary file(-FOrm=Binary)] is selected: .bin

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.

This property corresponds to the -OUtput option of the rlink command.

The division output file name is displayed as the subproperty.

This property is displayed only when [Yes] in the [Output hex file] property is selected.

Default

Division output file[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 259 characters

Up to 65535 items can be specified.

(7)

[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 file format

Select the format of the output file.

This property corresponds to the -FOrm option of the rlink command.

Default

User libraries(-FOrm=Library=U)

How to change

Select from the drop-down list.

Restriction

User libraries(-FOrm=Library=U)

Outputs a user library file.

System libraries(-FOrm=Library=S)

Outputs a system library file.

Relocatable file(-FOrm=Relocate)

Outputs a relocatable file.

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 property corresponds to the -OUtput option of the rlink command.

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.

If the extension is omitted, it is automatically added according to the selection in the [Hex file format] property.

When [User libraries(-FOrm=Library=U)] is selected: .lib

When [System libraries(-FOrm=Library=S)] is selected: .lib

When [Relocatable file(-FOrm=Relocate)] is selected: .rel

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.

This property corresponds to the -OUtput option of the rlink command.

Default

%ProjectName%.lib

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

Use standard libraries

Select whether to use the standard libraries provided by the compiler.

This property corresponds to the -LIBrary option of the rlink command.

[Yes(V1.01 compatible)] is displayed when [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard libraries.

Yes(V1.01 compatible)

Uses the libraries compatible with CC-RH V1.01.

No

Does not use the standard libraries.

Use "Standard Library" function

Select whether to use the standard library functions.

This property is changed to [Yes(-LIBrary=libc)] when [Yes] in the [Use "Mathematical Library (Double precision)" function] or [Use "Mathematical Library (Single precision)" function] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libc)

Uses the standard library functions.

No

Does not use the standard library functions.

Use "Mathematical Library (Double precision)" function

Select whether to use the mathematical library (double precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libm)

Uses the mathematical library (double precision) functions.

No

Does not use the mathematical library (double precision) functions.

Use "Mathematical Library (Single precision)" function

Select whether to use the mathematical library (single precision) functions.

This property is changed to [No] when [No] in the [Use standard libraries] property is selected.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or a version number earlier than V1.02.00 is selected for the [Using compiler package version] property under the [Version Select] category in an environment where a version of the CC-RH compiler earlier than V1.02.00 has been installed

-

When [Yes] in the [Use standard libraries] property is selected

 

or

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes(V1.01 compatible)] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libmf)

Uses the mathematical library (single precision) functions.

No

Does not use the mathematical library (single precision) functions.

Use "Standard/Mathematical Library" function

Select whether to use the standard/mathematical library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or V1.02.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.02.00 or a later version of the CC-RH compiler has been installed

-

When [Yes] in the [Use standard libraries] property is selected

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Uses the standard/mathematical library functions.

No

Does not use the standard/mathematical library functions.

Use "Non-local jump Library" function

Select whether to use the non-local jump library functions.

This property corresponds to the -LIBrary option of the rlink command.

This property is displayed only when other than [No] in the [Use standard libraries] property is selected.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-LIBrary=libsetjmp)

Uses the non-local jump library functions.

No

Does not use the non-local jump library functions.

(8)

[Device]

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

Reset vector address

This is the reset vector address of the device.

If there is a property with the same name in the Microcontroller node, this value is changed to that value.

See the user's manual of the device for the reset vector address.

This contents are common to all the build modes.

This property is displayed in the following cases.

-

For other than the library project

-

When the device has PE1 or is a single-core device

Default

The peculiar value for the target device

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number without 0x)

Reset vector address of PEn

This is the reset vector address of PEn (n: core number).

If there is a property with the same name in the Microcontroller node, this value is changed to that value.

See the user's manual of the device for about the reset vector address.

This contents are common to all the build modes.

This property is displayed in the following cases.

-

For other than the library project

-

When the device has PEn

Default

The peculiar value for the target device

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number without 0x)

(9)

[PIC/PID]

The detailed information on PIC/PID is displayed and the configuration can be changed.

Enable PIC and PIROD function

Select whether to enable the PIC (position independent code) and PIROD (position independent read only data) facilities.

The PIC facility selects the default allocation of functions to the .pctext section. The PIROD facility selects the default allocation of constants to the .pcconst32 section.

Selecting [Yes(-pic -pirod)] for this property enables PC-relative access to these sections and the allocation of these sections to desired addresses after linkage.

This property corresponds to the -pic and -pirod options of the ccrh command.

This property is displayed when [Always latest version which was installed] or V1.07.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.07.00 or a later version of the CC-RH compiler has been installed.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-pic -pirod)

Enables the PIC and PIROD facilities.

No

Disables the PIC and PIROD facilities.

Enable PID function

Select whether to enable the PID (position independent data) facility.

The PID facility selects the default allocation of initialized data to the .sdata32 section and of non-initialized data to the .sbss32 section.

Selecting [Yes(-pid)] for this property enables GP- or EP-relative access to these sections and the allocation of these sections to desired addresses after linkage.

This property corresponds to the -pid option of the ccrh command.

This property is displayed when [Always latest version which was installed] or V1.07.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.07.00 or a later version of the CC-RH compiler has been installed.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-pid)

Enables the PID facility.

No

Disables the PID facility.

Use of r4 register

Select the use of the r4 register.

This property corresponds to the -r4 option of the ccrh command.

This property is displayed in the following cases.

-

When [Always latest version which was installed] or V1.07.00 or a later version is selected for the [Using compiler package version] property under the [Version Select] category in an environment where V1.07.00 or a later version of the CC-RH compiler has been installed

-

When [No] in the [Enables the PID function] property is selected

Default

GP-relative base register(None)

How to change

Select from the drop-down list.

Restriction

GP-relative base register(None)

Register r4 will be used as the base register in GP-relative addressing mode.

None(-r4=none)

Register r4 will not be used as the base register.

(10)

[Register Mode]

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

Register mode

Select the register mode (number of registers used by the Compiler)Note of the software register bank function.

This property corresponds to the -Xreg_mode option of the ccrh command.

Default

32-register mode(None)

How to change

Select from the drop-down list.

Restriction

32-register mode(None)

Sets the register mode to 32.

22-register mode(-Xreg_mode=22)

Sets the register mode to 22.

Universal register mode(-Xreg_mode=common)

Sets the register mode to 22.

Use this item to generate the object module file that does not depend on the register mode.

Reserve r2 register

Select whether to reserve the r2 register.

This property corresponds to the -Xreserve_r2 option of the ccrh command.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Xreserve_r2)

Reserves the r2 register and generates code that does not use this register by the compiler.

No

The compiler uses the r2 register without reserving it.

ep-register treatment

Select how to handle the ep register.

Specify [Fix in project(-Xep=fix)] when any of the following attribute strings in a #pragma section in the project is used.

ep_auto, ep_disp4, ep_disp5, ep_disp7, ep_disp8, ep_disp16, ep_disp23

Only [Treat as callee-save(None)] is displayed when [Yes] in the [Optimize accesses to external variables] property in the [Optimization(Details)] category from the [Compile Options] tab is selected.

This property corresponds to the -Xep option of the ccrh command.

Default

Treat as callee-save(None)

How to change

Select from the drop-down list.

Restriction

Treat as callee-save(None)

Treats the ep register as a register guaranteeing the value before and after the function call.

Fix in project(-Xep=fix)

Fixes the value of the ep register for the entire project.

Note

The register modes provided by CC-RH are shown below.

Register Mode

Working Registers

Registers for Register Variables

common

r10 to r14

r25 to r29

22-register mode

r10 to r14

r25 to r29

32-register mode

r10 to r19

r20 to r29

(11)

[Error Output]

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

Merge error message file

Select whether to merge the error message file.

This property corresponds to the -Xerror_file option of the ccrh command.

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

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-Xerror_file)

Merges the error message file.

No

Does not merge the error message file.

Merged error message file output folder

Specify the folder which the merged 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 property corresponds to the -Xerror_file option of the ccrh command.

This property is displayed only when [Yes(-Xerror_file)] in the [Merge error message file] property is selected.

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

Merged error message file name

Specify the merged 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 property corresponds to the -Xerror_file option of the ccrh command.

This property is displayed only when [Yes(-Xerror_file)] in the [Output error message file] property is selected.

Default

%ProjectName%.err

How to change

Directly enter in the text box.

Restriction

Up to 259 characters

(12)

[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: 02042,02107).

Also, the range can be set using "-" (hyphen) (example: 02222-02554,02699-02782).

This property corresponds to the -Xno_warning option of the ccrh 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 2048 characters

(13)

[Build Method]

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

Build simultaneously

Select whether to compile/assemble multiple files simultaneously.

The files with the individual build options and files to be executed prior to the build are excluded from running a build simultaneously.

See "2.2.1 Running simultaneous build" for details about running a build simultaneously.

Default

Yes

How to change

Select from the drop-down list.

Restriction

Yes

Compiles and assembles multiple files simultaneously.

No

Compiles and assembles for each file.

Build in parallel

Select whether to enable the parallel build facility.

The parallel build facility enables CS+ to compile/assemble multiple source files in parallel using all processors mounted on the computer. This speeds up compilation/assemble.

In addition, parallel build between projects can be set by selecting [Tool] menu >> [Option] and then making a setting in the [General - Build] category of the Option dialog box.

See "2.2.2 Running parallel build" for details about parallel build.

Default

No

How to change

Select from the drop-down list.

Restriction

Yes

Enables the parallel build facility.

No

Disables the parallel build facility.

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 and additional include paths.

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.

(14)

[Version Select]

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

Using compiler package install folder

The folder in which the compiler package to be used is installed is displayed.

Default

Install folder name

How to change

Changes not allowed

Using compiler package version

Select the version of the compiler package to be used.

This setting is common to all the build modes.

Default

Always latest version which was installed

How to change

Select from the drop-down list.

Restriction

Always latest version which was installed

Uses the latest version in the installed compiler packages.

Versions of the installed compiler packages

Uses the selected version in the compiler package.

Latest compiler package version which was installed

The version of the compiler package to be used when [Always latest version which was installed] is selected in the [Using compiler package version] property is displayed.

This setting is common to all the build modes.

This property is displayed only when [Always latest version which was installed] in the [Using compiler package version] property is selected.

Default

Latest version of the installed compiler packages

How to change

Changes not allowed

(15)

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

(16)

[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 ccrh options group.

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