-USER_OPT_BYTE


This option specifies the value set for the user option bytes.

[Specification format]

-USER_OPT_BYTE=user-option-byte

 

-

Interpretation when omitted

When this option is not used, be sure to set the user option byte value by using an assembly source file.

[Detailed description]

-

This option specifies the value set for the user option bytes for user-option-byte.

-

The user option byte value depends on the device in use. See the user's manual of the device for the value to be specified.

When this option is omitted, the user option bytes are set to the initial value specified in the device file.

-

Specify a hexadecimal value from 0x0 to 0xFFFFFF for the user option bytes.
If the specified value is less than 3 bytes, the higher bits are filled with 0.

-

An error occurs if a value that cannot be specified for the user option bytes is specified.

-

The user option bytes is specified at addresses 0xC0 to 0xC2.
The specified value is stored in byte units from the MSB side of the user option bytes in the order from 0xC0 to 0xC2.

-

The user option byte value to be allocated at addresses 0xC0 to 0xC2 can also be specified by defining the segment with relocation attributes shown below, in the assembly source file.
However, define the segment with 4 bytes in total, including the control value at address 0xC3.

        .section    .option_byte, opt_byte
          .db       0xFD                ;Address 0xC0
          .db       0xFE                ;Address 0xC1
          .db       0xFF                ;Address 0xC2
          .db       0x04                ;Address 0xC3

-

If specification of the device file and specification of this option are made in duplicate, this option takes priority.

-

If specification of the assembly source file and specification of this option are made in duplicate, this option takes priority.

-

If a device file is specified in addition to the specification of the user option bytes in the assembly source file, the specification in the assembly source file takes priority.

-

If a device file is specified but the user option bytes are not specified in the assembly source file or through this option, a warning is output to notify that the initial value in the device file is used.

[Example of use]

-

To specify 0xFD at address 0xC0, 0xFE at address 0xC1, and 0xFF at address 0xC2 as the user option byte value, describe as:

>rlink a.obj b.obj -device=dr5f10y14.dvf -user_opt_byte=FDFEFF

[Remark]

-

If the -form={object|relocate|library} option or -extract option is specified, this option will be invalid.

-

If the -device option is not specified, this option will be invalid.

-

When specifying the user option byte value in the assembly source file, do not use a label reference. If such an attempt is made, the result may be an unexpected value due to relocation resolution.