-OCDBG


This option specifies the control value for the on-chip debug.

[Specification format]

-OCDBG=value

 

-

Interpretation when omitted

When this option is not used, be sure to set the control value for the on-chip debug by using an assembly source file.

[Detailed description]

-

This option specifies the control value for the on-chip debug for value.

-

The control value for the on-chip debug 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 control value for the on-chip debug are set to the initial value specified in the device file.

-

Specify a hexadecimal value from 0x0 to 0xFF for the control value for the on-chip debug.

-

An error occurs if a value that cannot be specified for the control value for the on-chip debug is specified.

-

The control value for the on-chip debug is specified at addresses 0xC3.

-

The control value for the on-chip debug 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 user option bytes starting from address 0xC0.
If a device file is specified in addition to the specification of the control value in the assembly source file, the specification in the assembly source file takes priority.

        .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 the control value is specified both in the assembly source file and through this option, an information message is output and this option takes priority.

[Example of use]

-

To set 0x04 at address 0xC3 as the control value for the on-chip debug, describe as:

>rlink a.obj b.obj -device=dr5f10y14.dvf -ocdbg=04

[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 control value for the on-chip debug 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.