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]
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)
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.
- | 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.
|
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 |
|
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)
|
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.
|
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. |
|
|
|
common
|
|
|
22-register mode
|
|
|
32-register mode
|
|
|
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
|
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
|
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.
|
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
|
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.
|
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
|