CHAPTER 18 SERVICE CALLS

This chapter describes the service calls supported by the RI600V4.

18.1 Outline

The service calls provided by the RI600V4 are service routines provided for indirectly manipulating the resources (tasks, semaphores, etc.) managed by the RI600V4 from a processing program.

The service calls provided by the RI600V4 are listed below by management module.

- Task management functions

act_tsk iact_tsk can_act ican_act sta_tsk ista_tsk ext_tsk ter_tsk chg_pri ichg_pri get_pri iget_pri ref_tsk iref_tsk ref_tst iref_tst

- Task dependent synchronization functions

slp_tsk tslp_tsk wup_tsk iwup_tsk can_wup ican_wup rel_wai irel_wai sus_tsk isus_tsk rsm_tsk irsm_tsk frsm_tsk ifrsm_tsk dly_tsk

- Synchronization and communication functions (semaphores)

wai_sem pol_sem ipol_sem twai_sem sig_sem isig_sem ref_sem iref_sem

- Synchronization and communication functions (eventflags)

set_flg iset_flg clr_flg iclr_flg wai_flg pol_flg ipol_flg twai_flg ref_flg iref_flg

- Synchronization and communication functions (data queues)

snd_dtq psnd_dtq ipsnd_dtq tsnd_dtq fsnd_dtq ifsnd_dtq rcv_dtq prcv_dtq iprcv_dtq trcv_dtq ref_dtq iref_dtq

- Synchronization and communication functions (mailboxes)

snd_mbx isnd_mbx rcv_mbx prcv_mbx iprcv_mbx trcv_mbx ref_mbx iref_mbx

- Extended synchronization and communication functions (mutexes)

loc_mtx ploc_mtx tloc_mtx unl_mtx ref_mtx

- Extended synchronization and communication functions (message buffers)

snd_mbf psnd_mbf ipsnd_mbf tsnd_mbf rcv_mbf prcv_mbf trcv_mbf ref_mbf iref_mbf

- Memory pool management functions (fixed-sized memory pools)

get_mpf pget_mpf ipget_mpf tget_mpf rel_mpf irel_mpf ref_mpf iref_mpf

- Memory pool management functions (variable-sized memory pools)

get_mpl pget_mpl ipget_mpl tget_mpl rel_mpl ref_mpl iref_mpl

- Time management functions

set_tim iset_tim get_tim iget_tim sta_cyc ista_cyc stp_cyc istp_cyc ref_cyc iref_cyc sta_alm ista_alm stp_alm istp_alm ref_alm iref_alm

- System state management functions

rot_rdq irot_rdq get_tid iget_tid loc_cpu iloc_cpu unl_cpu iunl_cpu dis_dsp ena_dsp sns_ctx sns_loc sns_dsp sns_dpn vsys_dwn ivsys_dwn vsta_knl ivsta_knl

- Interrupt management functions

chg_ims ichg_ims get_ims iget_ims

- System configuration management functions

ref_ver iref_ver

- Object reset functions

vrst_dtq vrst_mbx vrst_mbf vrst_mpf vrst_mpl

18.1.1 Method for calling service calls

The service calls can be calls by the same way as normal C-language function.

Note To call the service calls provided by the RI600V4 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, which is generated by the cfg600

18.2 Explanation of Service Call

The following explains the service calls supported by the RI600V4, 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 RI600V4.

O: Parameter output from RI600V4.

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