CHAPTER 19 SERVICE CALLS

This chapter describes the service calls supported by the RI600PX.

19.1 Outline

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

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

- Task management functions

cre_tsk acre_tsk del_tsk act_tsk iact_tsk can_act ican_act sta_tsk ista_tsk ext_tsk exd_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

- Task exception handling functions

def_tex ras_tex iras_tex dis_tex ena_tex sns_tex ref_tex iref_tex

- Synchronization and communication functions (semaphores)

cre_sem acre_sem del_sem wai_sem pol_sem ipol_sem twai_sem sig_sem isig_sem ref_sem iref_sem

- Synchronization and communication functions (eventflags)

cre_flg acre_flg del_flg 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)

cre_dtq acre_dtq del_dtq 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)

cre_mbx acre_mbx del_mbx snd_mbx isnd_mbx rcv_mbx prcv_mbx iprcv_mbx trcv_mbx ref_mbx iref_mbx

- Extended synchronization and communication functions (mutexes)

cre_mtx acre_mtx del_mtx loc_mtx ploc_mtx tloc_mtx unl_mtx ref_mtx

- Extended synchronization and communication functions (message buffers)

cre_mbf acre_mbf del_mbf 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)

cre_mpf acre_mpf del_mpf get_mpf pget_mpf ipget_mpf tget_mpf rel_mpf irel_mpf ref_mpf iref_mpf

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

cre_mpl acre_mpl del_mpl 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 cre_cyc acre_cyc del_cyc sta_cyc ista_cyc stp_cyc istp_cyc ref_cyc iref_cyc cre_alm acre_alm del_alm 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

- Memory object management functions

ata_mem det_mem sac_mem vprb_mem ref_mem

19.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 RI600PX 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 cfg600px

19.2 Explanation of Service Call

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

O: Parameter output from RI600PX.

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