開発ツール

ref_ver

概要

バージョン情報の参照

C言語形式

 ER      ref_ver ( T_RVER *pk_rver );

 ER      iref_ver ( T_RVER *pk_rver );

パラメータ


I/O	パラメータ	説明
O	T_RVER *pk_rver;	バージョン情報を格納する領域へのポインタ

【バージョン情報T_RVERの構造】

typedef struct t_rver { UH maker; /カーネルのメーカ・コード/ UH prid; /カーネルの識別番号/ UH spver; /ITRON仕様のバージョン番号/ UH prver; /カーネルのバージョン番号/ UH prno[4]; /カーネル製品の管理情報/ } T_RVER;

 typedef struct t_rver {

     UH  maker;                  /*カーネルのメーカ・コード*/

     UH  prid;                   /*カーネルの識別番号*/

     UH  spver;                  /*ITRON仕様のバージョン番号*/

     UH  prver;                  /*カーネルのバージョン番号*/

     UH  prno[4];                /*カーネル製品の管理情報*/

 } T_RVER;

機能

RI600PXのバージョン情報をpk_rverで指定された領域に格納します。

- maker
makerは，このカーネルを作ったメーカを表します。RI600PXでは，ルネサスエレクトロニクスを意味する0x011Bが返ります。
なお，makerと同じ値がカーネル構成マクロTKERNEL_MAKERに定義されています。

- prid
pridは，カーネルやVLSIの種類を区別する番号を表します。RI600PXでは，0x0004が返ります。
なお，pridと同じ値がカーネル構成マクロTKERNEL_PRIDに定義されています。

- spver
spverは，カーネルの準拠する仕様を表します。RI600PXでは，0x5403が返ります。
なお，spverと同じ値がカーネル構成マクロTKERNEL_SPVERに定義されています。

- prver
prverは，カーネルのバージョン番号を表します。
例えば，カーネルのバージョンがV1.02.03の場合は0x0123となります。
なお，prverと同じ値がカーネル構成マクロTKERNEL_PRVERに定義されています。

- prno
prnoは，製品管理情報や製品番号などを表します。RI600PXでは，すべてのprno[]に0x0000が返ります

戻り値


マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - pk_rver == NULL
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。備考タスクからiref_verを発行した場合，および非タスクからref_verを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（ref_verのみ） - 呼び出しタスクからのpk_rverが示す領域に対するオペランド・ライト・アクセス許可がない。