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

Default

No

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

Use object uniting function

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

This 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

No

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.

No

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

No

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.

No

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

No

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.

No

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

No

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.

No

Does not fills the vacant area.

Output padding data

Specify the hexadecimal value to fill the vacant area.

This 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

FF

How to change

Directly enter in the text box.

Restriction

0 to FFFFFFFF (hexadecimal number)

Specify byte count for data record

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

This corresponds to the -BYte_count 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

No

How to change

Select from the drop-down list.

Restriction

Yes(-BYte_count)

Specifies the maximum byte count for a data record.

No

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

FF

How to change

Directly enter to the text box.

Restriction

1 to FF (hexadecimal number)

Output S9 record at the end

Select whether to output the S9 record at the end.

This 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

No

How to change

Select from the drop-down list.

Restriction

Yes(-S9)

Outputs the S9 record at the end.

No

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.

Outputs the calculation result of CRC

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

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

This property is displayed when [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property.

Default

No

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.

No

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

When [Yes(-CRc)] in the [Outputs the calculation result of CRC] property is selected

Default

0

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

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.

16

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

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

This property is displayed in the following cases.

-

When [Always latest version which was installed] in the [Using compiler package version] property in the [Version Select] category from the [Common Options] tab is selected and the latest version is V1.03.00 or higher or when V1.03.00 or higher is selected in the [Using compiler package version] property

-

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 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 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 message to information message

Select whether to change the type of warning messages to information.

This 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 messages to information.

Yes(Specify message number)(-CHange_message=Information=<Message number>)

Specifies the number of warning message of which type is to be changed to information.

No

Does not change the type of warning messages.

Number of warning message

Specify the number of the 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 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 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 message to warning message

Select whether to change the type of information messages to warning.

This 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 messages to warning.

Yes(Specify message number)(-CHange_message=Warning=<Message number>)

Specifies the number of information message of which type is to be changed to warning.

No

Does not change the type of information messages.

Number of information message

Specify the number of the information 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 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 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 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 or 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 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 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 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