ref_ver/iref_ver | CS+ V8.02.00

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 RI600PX version information into the area specified by parameter pk_rver.

- maker
The maker represents the manufacturer who created this kernel. In the RI600PX, 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 RI600PX, 0x0004 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 RI600PX, 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 RI600PX, 0x0000 is returned for all prnos.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_PAR

-17

Parameter error.

- pk_rver == NULL

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.

E_MACV

-26

Memory access violation. (only for ref_ver)

- The operand-write access to the area indicated by pk_rver has not been permitted to the invoking task.

Macro	Value	Description
E_OK	0	Normal completion.
E_PAR	-17	Parameter error. - pk_rver == NULL
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.
E_MACV	-26	Memory access violation. (only for ref_ver) - The operand-write access to the area indicated by pk_rver has not been permitted to the invoking task.