[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) [Verify]

(5) [Message]

(6) [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.

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

Load address

Specifies the load address of the hex file in hexadecimal.

This property corresponds to the -OUtput option of the linker.

This property is displayed only 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 on the [Common Options] tab in an environment where V1.07.00 or a later version of the CC-RL compiler has been installed

-

When a choice other than [Binary file (-FOrm=Binary)] was made in the [Hex file format] property under the [Hex Format] category

Default

Blank

How to change

Directly enter in the text box.

Restriction

0 to FFFFF (hexadecimal number) or blank

Division output file

Specify the division output files.

Specify in the format of "file name=start address-end address[/load address]" (start address, end address: The start address and end address of the output range) or "file name=section name[/load address]" (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).

[/load address] can be specified only when the CC-RL compiler is V1.07.00 or later and when a choice other than [Binary file (-FOrm=Binary)] was made in the [Hex file format] property in the [Hex Format] category.

Specify the address in hexadecimal without 0x (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.

(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

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

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

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

FF

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 [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-RL compiler has been installed

-

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

Default

No

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.

No

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

1

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 [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-RL compiler has been installed

-

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

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

FF

-

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

10

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.05.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.05.00 or a later version of the CC-RL 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

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.

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

-

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

-

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 on the [Common Options] tab in an environment where V1.07.00 or a later version of the CC-RL compiler has been installed

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

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

0

How to change

Directly enter in the text box.

Restriction

0 to FFFFF (hexadecimal number)

Target range

Specify the CRC calculation range in the format of "start address - end address" or "section name". However, "section name" can be specified in only CC-RL V1.02.00 or higher version.

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-RL Compiler User's Manual" for details about each operation.

[CRC-CCITT(MSB,LITTLE,4 bytes) type] corresponds to [CRC-CCITT(MSB) type] in CS+ V3.01.00.

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

See [Remark] for the correspondence with the [Type of CRC] property of CA78K0R.

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

Default

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

How to change

Select from the drop-down list.

Restriction

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

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

SENT(MSB) type (General-purpose CRC(SENT))

Outputs the calculation result of operation conforming to SENT.

CRC-CCITT(LSB) type (General-purpose CRC)

Outputs the calculation result of CRC-16-CCITT-LSB first 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(MSB) type

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

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.

16

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

32-ETHERNET type

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

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

Remark

The correspondence between the [Type of CRC] property of CA78K0R and the [Type of CRC] property of CC-RL is as follows.

CA78K0R

CC-RL

High-speed CRC(CRC-16-CCITT)

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

High-speed CRC(SENT)

SENT(MSB) type (General-purpose CRC(SENT))

General-purpose CRC

CRC-CCITT(LSB) type (General-purpose CRC)

(4)

[Verify]

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

This category is displayed in the following cases.

-

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

-

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 on the [Common Options] tab in an environment where V1.07.00 or a later version of the CC-RL compiler has been installed

Check that output address is in internal ROM and data flash

Select whether to check that the output address is in the internal ROM and data flash.

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

Default

No

How to change

Select from the drop-down list.

Restriction

Yes(-CHECK_OUTPUT_ROM_AREA)

Checks that the output address is in the internal ROM and data flash.

No

Does not check that the output address is in the internal ROM and data flash.

(5)

[Message]

The detailed information on messages 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.

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

(6)

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

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