ref_ver

iref_ver

Outline

Reference version information.

C format

 ER      ref_ver (T_RVER *pk_rver);
 ER      iref_ver (T_RVER *pk_rver;
Parameter(s)

I/O

Parameter

Description

O

 T_RVER  *pk_rver;
Pointer to the packet returning the version information.



[Version information packet: T_RVER]

 typedef struct  t_rver {
     UH      maker;          /*Kernel maker code*/
     UH      prid;           /*Identification number of the kernel*/
     UH      spver;          /*Version number of the ITRON specification*/
     UH      prver;          /*Version number of the kernel*/
     UH      prno[4];        /*Management information of the kernel*/
 } T_RVER;


Explanation

These service calls store the RI600V4 version information into the area specified by parameter pk_rver.

- maker
The maker represents the manufacturer who created this kernel. In the RI600V4, 0x011B, which is the maker code assigned for Renesas Electronics Corporation, is returned for maker.
Note, the value defined in the kernel configuration macro TKERNEL_MAKER is same as maker.


- prid
The prid represents the number that identifies the kernel and VLSI. In the RI600V4, 0x0003 is returned for prid.
Note, the value defined in the kernel configuration macro TKERNEL_PRID is same as prid.


- spver
The spver represents the specification to which this kernel conforms. In the RI600V4, 0x5403 is returned for spver.
Note, the value defined in the kernel configuration macro TKERNEL_SPVER is same as spver.


- prver
The prver represents the version number of this kernel.
For example, 0x0123 is returned for prver when the kernel version is "V1.02.03".
Note, the value defined in the kernel configuration macro TKERNEL_PRVER is same as prver.



- prno
The prno represents product management information and product number, etc. In the RI600V4, 0x0000 is returned for all prnos.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

- This service call was issued in the status PSW.IPL > kernel interrupt mask level.

Note When the iref_ver is issued from task or the ref_ver is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.