Everything

CHAPTER 16 SERVICE CALLS


This chapter describes the service calls supported by the RI850V4.
16.1 Outline
The service calls provided by the RI850V4 are service routines provided for indirectly manipulating the resources (tasks, semaphores, etc.) managed by the RI850V4 from a processing program.
The service calls provided by the RI850V4 are listed below by management module.
16.1.1 Call service call
The method for calling service calls from processing programs coded either in C or assembly language is described below.
- C language
By calling using the same method as for normal C functions, service call parameters are handed over to the RI850V4 as arguments and the relevant processing is executed.
- Assembly language
When issuing a service call from a processing program coded in assembly language, set parameters and the return address according to the calling rules prescribed in the C compiler used as the development environment and call the function using the jarl instruction; the service call parameters are then transferred to the RI850V4 as arguments and the relevant processing will be executed.
Note To call the service calls provided by the RI850V4 from a processing program, the header files listed below must be coded (include processing).
kernel.h: Standard header file
kernel_id.h: System information header file
16.2 Explanation of Service Call
The following explains the service calls supported by the RI850V4, in the format shown below.
1 ) Name
Indicates the name of the service call.
2 ) Outline
Outlines the functions of the service call.
3 ) C format
Indicates the format to be used when describing a service call to be issued in C language.
4 ) Parameter(s)
Service call parameters are explained in the following format.
I/O
Parameter
Description
A
B
C

A ) Parameter classification
I: Parameter input to RI850V4.
O: Parameter output from RI850V4.
B ) Parameter data type
C ) Description of parameter
5 ) Explanation
Explains the function of a service call.
6 ) Return value
Indicates a service call's return value using a macro and value.
Macro
Value
Description
A
B
C

A ) Macro of return value
B ) Value of return value
C ) Description of return value