[Hex Output Options] tab

This tab shows the detailed information on the Hex output phase categorized by the following and the configuration can be changed.

(1) [Output File]

(2) [Hex Format]

(3) [CRC Operation]

(4) [Message]

(5) [Others]

Caution

This tab is not displayed for the library project.

Figure A.6

Property Panel: [Hex Output Options] Tab

[Description of each category]

(1)	[Output File]

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

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.

Does not output the hex 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.

Be sure to specify this property.

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

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.

%BuildModeName%: Replaces with the build mode 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" (start address, end address: The start address and end address of the output range) or "file name=section name" (section name: The name of the output section), 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 in the [Hex Format] category.

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.

Caution

If you prefer the output of a single file and thus need not enter the start and end addresses or section names, delete the setting of this property and use the [Output folder] and [Output file name] properties instead.

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.

Use object uniting function

Select whether to combine the hex files of the projects specified as constituent applications into a file.

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

This property is displayed only in the following cases.

-	For the multi-core boot loader project

-	When [Yes] is selected in the [Output hex file] property and the same item is selected in the [Hex file format] property in the [Hex Format] category for the boot loader project and all component application projects.

Default

How to change

Select from the drop-down list.

Restriction

Yes

Combines the hex files of the projects specified as constituent applications into a file.

Outputs the hex file for each project.

Output folder for united hex file

Specify the folder which the combined hex file is output.

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 [Use object uniting function] property is selected.

Default

%BuildModeName%_merged

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

(2)	[Hex Format]

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

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

Hex file format

Select the format of the hex file to be output.

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

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.

Unify record size

[Intel HEX file]

Select whether to output a specified data record regardless of the address range.

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

This property is displayed only when [Intel HEX file(-FOrm=Hexadecimal)] in the [Hex file format] property is selected.

Default

How to change

Select from the drop-down list.

Restriction

Yes(Intel hex record)(-REcord=H16)

Outputs the Intel hex record.

Yes(Intel expanded hex record)(-REcord=H20)

Outputs the Intel expanded hex record.

Yes(Intel 32-bit hex record)(-REcord=H32)

Outputs the Intel 32-bit hex record.

Outputs various data records according to each address.

Unify record size

[Motorola S-record file]

Select whether to output a specified data record regardless of the address range.

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

This property is displayed only when [Motorola S-record file(-FOrm=Stype)] in the [Hex file format] property is selected.

Default

How to change

Select from the drop-down list.

Restriction

Yes(S1 record)(-REcord=S1)

Outputs the S1 record.

Yes(S2 record)(-REcord=S2)

Outputs the S2 record.

Yes(S3 record)(-REcord=S3)

Outputs the S3 record.

Outputs various data records according to each address.

Fill unused areas in the output ranges with the value

Select whether to fill the vacant area of the output range with data.

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

This property is displayed only when a file is specified in the [Division output file] property in the [Output File] category.

Default

How to change

Select from the drop-down list.

Restriction

Yes(Random)(-SPace=Random)

Fills the vacant area with random numbers.

Yes(Specification value)(-SPace=<Numerical value>)

Fills the vacant area with the specified hexadecimal value.

Does not fills the vacant area.

Output padding data

Specify the hexadecimal value to fill the vacant area.

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

This property is displayed only when [Yes(Specification value)(-SPace=<Numerical value>)] in the [Fill unused areas in the output ranges with the value] property is selected.

Default

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number)

Output hex file with fixed record length from aligned start address

Select whether to output the hex file with the fixed record length from an aligned start address.

This property corresponds to the -FIX_RECORD_LENGTH_AND_ALIGN of the rlink command.

This property is displayed only in the following cases.

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

-	When other than [Binary file(-FOrm=Binary)] in the [Hex file format] property is selected

Default

How to change

Select from the drop-down list.

Restriction

Yes(-FIX_RECORD_LENGTH_AND_ALIGN)

Outputs the hex file with the fixed record length from an aligned start address.

Does not output the hex file with the fixed record length from an aligned start address.

Alignment of start address

Specify the alignment of the start address.

You can enter 1 or a greater value for the alignment.

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

This property is displayed only when [Yes(-FIX_RECORD_LENGTH_AND_ALIGN)] in the [Output hex file with fixed record length from aligned start address] property is selected.

Default

How to change

Directly enter to the text box.

Restriction

1 to 99999 (decimal number)

Specify byte count for data record

Select whether to specify the maximum byte count for a data record.

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

This property is displayed only in either of the following cases.

-	When other than [Binary file(-FOrm=Binary)] in the [Hex file format] property is selected

-	Other than above

-	When [Intel HEX file(-FOrm=Hexadecimal)] in the [Hex file format] property is selected

Default

How to change

Select from the drop-down list.

Restriction

Yes(-BYte_count)

Specifies the maximum byte count for a data record.

Specifies 0xFF as the maximum byte count for a data record.

Maximum byte count for data record

Specify the maximum byte count for a data record.

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

This property is displayed only when [Yes(-BYte_count)] in the [Specify byte count for data record] property is selected.

Default

-	When [Intel HEX file(-FOrm=Hexadecimal)] in the [Hex file format] property is selected

-	When [Motorola S-record file(-FOrm=Stype)] in the [Hex file format] property is selected

How to change

Directly enter to the text box.

Restriction

1 to FF (hexadecimal number)

Specify end record

Select the end record of the Motorola S-record file.

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

This property is displayed in the following cases.

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

-	When [Motorola S-record file(-FOrm=Stype)] in the [Hex file format] property is selected

Default

Not specify(None)

How to change

Select from the drop-down list.

Restriction

S7(-END_RECORD=S7)

Outputs the end record as a 32-bit S-record file.

S8(-END_RECORD=S8)

Outputs the end record as a 24-bit S-record file.

S9(-END_RECORD=S9)

Outputs the end record as a 16-bit S-record file.

Not specify(None)

Outputs the end record to suit the address of the entry point.

Output S9 record at the end

Select whether to output the S9 record at the end.

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

This property is displayed only when [Motorola S-record file(-FOrm=Stype)] in the [Hex file format] property is selected.

Default

How to change

Select from the drop-down list.

Restriction

Yes(-S9)

Outputs the S9 record at the end.

Does not output the S9 record at the end.

(3)	[CRC Operation]

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

This category is displayed only in the following cases.

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

-	When other than [Binary file(-FOrm=Binary)] is selected in the [Hex file format] property in the [Hex Format] category

Outputs the calculation result of CRC

Select whether to perform the CRC (Cyclic Redundancy Check) operation.

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

Default

How to change

Select from the drop-down list.

Restriction

Yes(-CRc)

The CRC operation is performed on the hex-format objects in the specified range, from low address to high address, and the results of the operation are output to the specified address.

The CRC operation and outputting the result are not performed.

Output address

Specify the address that the result of the CRC operation is output in hexadecimal without 0x (example: FFF00).

Be sure to specify this property.

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number)

Target range

Specify the CRC calculation range in the format of "start address - end address" or "section name".

Specify the address in hexadecimal without 0x.

The range of specifiable address values is 0 to FFFFF.

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

Blank

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

Up to 65535 items can be specified.

Type of CRC

Select the method of CRC operation.

See the user's manual of the device and "CC-RH Compiler User's Manual" for details about each operation.

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

32-ETHERNET type

How to change

Select from the drop-down list.

Restriction

CRC-CCITT(MSB) type

Outputs the calculation result of CRC-16-CCITT-MSB first operation.

CRC-CCITT(MSB,LITTLE,4 bytes) type

Outputs the calculation result of CRC-16-CCITT-MSB first operation with the input specified as 4-byte units in little-endian mode.

CRC-CCITT(MSB,LITTLE,2 bytes) type

Outputs the calculation result of CRC-16-CCITT-MSB first operation with the input specified as 2-byte units in little-endian mode.

32-ETHERNET type

Outputs the calculation result of CRC-32-ETHERNET operation.

CCITT type

Outputs the calculation result of CRC-16-CCITT-MSB first operation with an initial value of 0xffff and inverse of XOR.

CRC-CCITT(LSB) type

Outputs the calculation result of CRC-16-CCITT-LSB first operation.

Outputs the calculation result of CRC-16-LSB first operation.

SENT(MSB) type

Outputs the calculation result of operation conforming to SENT.

Initial value

Specify the initial value for the CRC code in the format of "initial value".

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

Blank

How to change

Directly enter to the text box.

Restriction

-	When other than [32-ETHERNET type] is selected in the [Type of CRC] property

0 to FFFF (hexadecimal number)

-	When [32-ETHERNET type] is selected in the [Type of CRC] property

0 to FFFFFFFF (hexadecimal number)

Endian

Select the endian for CRC output.

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

Little endian

How to change

Select from the drop-down list.

Restriction

Little endian

Outputs the value in little-endian mode.

Big endian

Outputs the value in big-endian mode.

Output size

Specify the output size for the CRC code.

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

This property is displayed only when [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected.

Default

Blank

How to change

Directly enter to the text box.

Restriction

2, 4, or blank

(4)

[Message]

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

Use same message-related settings as Link Options tab	Select whether to make the message-related settings the same as those of the [Link Options] tab.
	Default	Yes
	How to change	Select from the drop-down list.
	Restriction	Yes	Makes the message-related settings the same as those of the [Link Options] tab.
		No	Makes the message-related settings in the property of the [Hex Output Options].
Enable information message output	Select whether to enable the output of information messages. This property corresponds to the -Message and -NOMessage options of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected.
	Default	No(-NOMessage)
	How to change	Select from the drop-down list.
	Restriction	Yes(-Message)		Outputs information messages.
		No(-NOMessage)		Suppresses the output of information messages.
Suppress number of information message	Specify the number of the information message of which output is to be suppressed. If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200). Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300). This property corresponds to the -NOMessage option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected and when [No(-NOMessage)] in the [Enable information message output] property is selected.
	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
Change warning and error message to information message	Select whether to change the type of warning and error messages to information. This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected.
	Default	No
	How to change	Select from the drop-down list.
	Restriction	Yes(All)(-CHange_message=Information)		Changes the type of all warning and error messages to information.
		Yes(Specify message number)(-CHange_message=Information=<Message number>)		Specifies the number of warning and error message of which type is to be changed to information.
		No		Does not change the type of warning and error messages.
Number of warning and error message	Specify the number of the warning and error message. If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200). Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300). This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected and when [Yes(Specify message number)(-CHange_message=Information=<Message number>)] in the [Change warning and error message to information message] property is selected.
	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
Change information and error message to warning message	Select whether to change the type of information and error messages to warning. This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected.
	Default	No
	How to change	Select from the drop-down list.
	Restriction	Yes(All)(-CHange_message=Warning)		Changes the type of all information and error messages to warning.
		Yes(Specify message number)(-CHange_message=Warning=<Message number>)		Specifies the number of information and error message of which type is to be changed to warning.
		No		Does not change the type of information and error messages.
Number of information and error message	Specify the number of the information and error message. If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200). Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300). This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected and when [Yes(Specify message number)(-CHange_message=Warning=<Message number>)] in the [Change information and error message to warning message] property is selected.
	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
Change information and warning message to error message	Select whether to change the type of information and warning messages to error. This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected.
	Default	No
	How to change	Select from the drop-down list.
	Restriction	Yes(All)(-CHange_message=Error)		Changes the type of all information and warning messages to error.
		Yes(Specify message number)(-CHange_message=Error=<Message number>)		Specifies the number of information and warning message of which type is to be changed to error.
		No		Does not change the type of information and warning messages.
Number of information and warning message	Specify the number of the information and warning message. If multiple message numbers are specified, delimit them with "," (comma) (example: 4,200). Also, a range of message numbers can be specified using "-" (hyphen) (example:4,200-203,1300). This property corresponds to the -CHange_message option of the rlink command. This property is displayed only when [No] in the [Use same message-related settings as Link Options tab] property is selected and when [Yes(Specify message number)(-CHange_message=Error=<Message number>)] in the [Change information and warning message to error message] property is selected.
	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

(5)

[Others]

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

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

Confirm that SYNCP is inserted at entry of exception handler	Select whether to confirm that the SYNCP instruction is inserted at the beginning of an exception handler after hex output finishes. See "RH850G3M User's Manual: Software" (Rev1.10 or later) for details.
	Default	Yes
	How to change	Select from the drop-down list.
	Restriction	Yes	Confirms that the SYNCP instruction is inserted at the beginning of an exception handler after hex output finishes.
		No	Does not confirm that the SYNCP instruction is inserted at the beginning of an exception handler after hex output finishes.
Base address of exception vector	Specify the base address of the exception vector. This property corresponds to the -b option of the tool to confirm that the SYNCP instruction is inserted at the entry of the exception handler.
	Default	The peculiar value for the target device
	How to change	Directly enter to the text box.
	Restriction	0 to FFFFFE00 (hexadecimal number without 0x)
Number of entries of interrupts	Specify the number of entries of interrupts. Specifying this property appropriately allows redundant check to be suppressed. This property corresponds to the -n option of the tool to confirm that the SYNCP instruction is inserted at the entry of the exception handler.
	Default	16
	How to change	Directly enter to the text box.
	Restriction	0 to 16 (decimal number)
Other additional options	Input the hex output options to be added additionally. The options set here are added at the end of the hex output 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