This option controls outputting far jump.
[Specification format]
- | Interpretation when omitted |
The instructions in accordance with the -Xcall_jump option are generated.
[Detailed description]
- | This option generates the code that uses instructions with a branch distance of 32 bits for the branch to functions specified in far jump calling function list file file. |
- | ".fjp" is recommended as the extension of file. |
- | An error will occur if file does not exist. |
- | An error will occur if file is omitted. |
- | An error will occur at linkage if the distance between a branch instruction and a branch destination function exceeds 22 bits (±2 Mbytes) when the -Xcall_jump=22 option is specified. In this case, recompile by using this option. |
- | If this option is specified more than once, the option specified last will be valid. |
- | The example of the output code is shown below. |
far_func(); /* "jarl _far_func, lp" is output by default. */
|
Remark | Cautions about are the format of the far jump calling function list file as follows. |
- | Describe with one function name per line.
If two or more function name is described, the first name will be valid. |
- | Describe the function name (label name in an assembly source) by prefixing "_" to that in C language.
However, the following formats can be specified instead of function names. |
|
|
|
|
{all_function}
|
All functions are called.
|
- | Not only functions that are called from a C source file, but operation runtime functions can also be specified.
When specifying an operation runtime function, instead of prefixing "_" to the function name, specify the function name as it is in Table 7.16 in "7.4.13 Operation runtime functions". |
- | A space and tab can be inserted before and after function names. |
- | Only ASCII characters can be used.
After the space characters at the beginning of a line, a non-space character string until the next space character or the end of the line is treated as a function name, and the rest of the line (from the space character to the end of the line) is ignored. |
- | Comments cannot be inserted. |
- | Up to 1023 characters can be specified per line (including a space and tab). |
The example when specifying functions is shown below.
_func_led
_func_beep
_func_motor
:
_func_switch
_COM_div64
|
[Example of use]
- | To generate the code that uses an instruction with a branch distance of 32 bits for the branch to the function specified in func.fjp, code as: |
>ccrh -Xfar_jump=func.fjp -Xcommon=rh850 main.c
|