Changeset 107 for uKadecot/trunk/ssp/include

uKadecot/trunk/ssp/include/itron.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *              Graduate School of Information Science, Nagoya Univ., JAPAN
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
  *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
  *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
  *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
  *  ÌÓCðíÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
  *              ITRONdl¤ÊKèÌf[^^EèE}N
+ *              ITRON仕様共通規定のデータ型・定数・マクロ
+ *
  *  ±Ìwb_t@CÍCITRONdl¤ÊKèÌf[^^EèE}NÌ
  *  ÅCTOPPERS¤Êwb_t@CÉÜÜêÈ¢àÌÌè`ðÜÞDITRONd
  *  lÆÌÝ·«ðKvÆ·éAvP[VªCN[h·é±Æðz
  *  èµÄ¢éD
+ *  このヘッダファイルは，ITRON仕様共通規定のデータ型・定数・マクロの中
+ *  で，TOPPERS共通ヘッダファイルに含まれないものの定義を含む．ITRON仕
+ *  様との互換性を必要とするアプリケーションがインクルードすることを想
+ *  定している．
+ *
  *  AZu¾êÌ\[Xt@C©ç±Ìt@CðCN[h·é
  *  ÍCTOPPERS_MACRO_ONLYðè`µÄ¨D±êÉæèC}Nè`ÈOð
  *  æ¤ÉÈÁÄ¢éD
+ *  アセンブリ言語のソースファイルからこのファイルをインクルードする時
+ *  は，TOPPERS_MACRO_ONLYを定義しておく．これにより，マクロ定義以外を
+ *  除くようになっている．
  */
 …
 /*
  *  TOPPERS¤Êwb_t@C
+ *  TOPPERS共通ヘッダファイル
  */
 #include "t_stddef.h"
 /*
  *  ITRONdl¤Êf[^^
+ *  ITRON仕様共通データ型
  */
 #ifndef TOPPERS_MACRO_ONLY
 #ifdef INT8_MAX
 typedef int8_t                  B;                      /* t«8rbg® */
+typedef int8_t                  B;                      /* 符号付き8ビット整数 */
 #endif /* INT8_MAX */
 #ifdef UINT8_MAX
 typedef uint8_t                 UB;                     /* ³µ8rbg® */
 typedef uint8_t                 VB;                     /* ^ªèÜçÈ¢8rbgÌl */
+typedef uint8_t                 UB;                     /* 符号無し8ビット整数 */
+typedef uint8_t                 VB;                     /* 型が定まらない8ビットの値 */
 #endif /* UINT8_MAX */
 typedef int16_t                 H;                      /* t«16rbg® */
 typedef uint16_t                UH;                     /* ³µ16rbg® */
 typedef uint16_t                VH;                     /* ^ªèÜçÈ¢16rbgÌl */
+typedef int16_t                 H;                      /* 符号付き16ビット整数 */
+typedef uint16_t                UH;                     /* 符号無し16ビット整数 */
+typedef uint16_t                VH;                     /* 型が定まらない16ビットの値 */
 typedef int32_t                 W;                      /* t«32rbg® */
 typedef uint32_t                UW;                     /* ³µ32rbg® */
 typedef uint32_t                VW;                     /* ^ªèÜçÈ¢32rbgÌl */
+typedef int32_t                 W;                      /* 符号付き32ビット整数 */
+typedef uint32_t                UW;                     /* 符号無し32ビット整数 */
+typedef uint32_t                VW;                     /* 型が定まらない32ビットの値 */
 #ifdef INT64_MAX
 typedef int64_t                 D;                      /* t«64rbg® */
+typedef int64_t                 D;                      /* 符号付き64ビット整数 */
 #endif /* INT64_MAX */
 #ifdef UINT64_MAX
 typedef uint64_t                UD;                     /* ³µ64rbg® */
 typedef uint64_t                VD;                     /* ^ªèÜçÈ¢64rbgÌl */
+typedef uint64_t                UD;                     /* 符号無し64ビット整数 */
+typedef uint64_t                VD;                     /* 型が定まらない64ビットの値 */
 #endif /* UINT64_MAX */
 typedef void                    *VP;            /* ^ªèÜçÈ¢àÌÖÌ|C^ */
+typedef void                    *VP;            /* 型が定まらないものへのポインタ */
 typedef int_t                   INT;            /* ©RÈTCYÌt«® */
 typedef uint_t                  UINT;           /* ©RÈTCYÌ³µ® */
+typedef int_t                   INT;            /* 自然なサイズの符号付き整数 */
+typedef uint_t                  UINT;           /* 自然なサイズの符号無し整数 */
 typedef bool_t                  BOOL;           /* ^Ul */
+typedef bool_t                  BOOL;           /* 真偽値 */
 typedef intptr_t                VP_INT;         /* |C^Ü½Ít«® */
+typedef intptr_t                VP_INT;         /* ポインタまたは符号付き整数 */
 #endif /* TOPPERS_MACRO_ONLY */
 /*
  *  ITRONdl¤Êè
+ *  ITRON仕様共通定数
  */
 #define TRUE            true                    /* ^ */
 #define FALSE           false                   /* U */
+#define TRUE            true                    /* 真 */
+#define FALSE           false                   /* 偽 */
 /*
  *  IuWFNg®«Ìè`
+ *  オブジェクト属性の定義
  */
+#define TA_HLNG                 UINT_C(0x00)    /* ¾êpC^tF[X */
+#define TA_TFIFO                UINT_C(0x00)    /* ^XNÌÒ¿sñðFIFOÉ */
+#define TA_MFIFO                UINT_C(0x00)    /* bZ[WL
+[ðFIFOÉ */
+#define TA_WSGL                 UINT_C(0x00)    /* Ò¿^XNÍ1ÂÌÝ */
+#define TA_DISINT               UINT_C(0x00)    /* ÝvÖ~tOðZbg */
+#define TA_LEVEL                UINT_C(0x00)    /* xgK */
+#define TA_HLNG                 UINT_C(0x00)    /* 高級言語用インタフェース */
+#define TA_TFIFO                UINT_C(0x00)    /* タスクの待ち行列をFIFO順に */
+#define TA_MFIFO                UINT_C(0x00)    /* メッセージキューをFIFO順に */
+#define TA_WSGL                 UINT_C(0x00)    /* 待ちタスクは1つのみ */
+#define TA_DISINT               UINT_C(0x00)    /* 割込み要求禁止フラグをセット */
+#define TA_LEVEL                UINT_C(0x00)    /* レベルトリガ */
 /*
  *  lXgñÌÅål
+ *  ネスト回数の最大値
  */
 #define TMAX_SUSCNT             UINT_C(1)               /* §Ò¿vlXgÌÅål */
+#define TMAX_SUSCNT             UINT_C(1)               /* 強制待ち要求ネスト数の最大値 */
 /*
  *  §Ò¿óÔ©çÌ§ÄJ
+ *  強制待ち状態からの強制再開
  */
 #define frsm_tsk(tskid)         rsm_tsk(tskid)

uKadecot/trunk/ssp/include/kernel.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *  Copyright (C) 2010-2012 by Meika Sugimoto
+ *
+ *  ãLì ÒÍCÈºÌ (1)`(4) Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»EüÏE
+ *  ÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *      \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[X
+ *      R[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉgp
+ *      Å«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gipÒ}
+ *      j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºLÌ³Û
+ *      ØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉgp
+ *      Å«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌì
+ *         \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉñ
+ *        ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹Q
+ *      ©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆDÜ½C
+ *      {\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©ÈéRÉîÃ
+ *      ¿©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *  上記著作権者は，以下の (1)〜(4) の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改変・
+ *  再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作権
+ *      表示，この利用条件および下記の無保証規定が，そのままの形でソース
+ *      コード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使用
+ *      できる形で再配布する場合には，再配布に伴うドキュメント（利用者マ
+ *      ニュアルなど）に，上記の著作権表示，この利用条件および下記の無保
+ *      証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使用
+ *      できない形で再配布する場合には，次のいずれかの条件を満たすこと．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著作
+ *        権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに報
+ *        告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損害
+ *      からも，上記著作権者およびTOPPERSプロジェクトを免責すること．また，
+ *      本ソフトウェアのユーザまたはエンドユーザからのいかなる理由に基づ
+ *      く請求からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨æ
  *  ÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚIÉÎ·
  *  éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEFAÌp
  *  Éæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»ÌÓCð
  *  íÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者およ
+ *  びTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的に対す
+ *  る適合性も含めて，いかなる保証も行わない．また，本ソフトウェアの利用
+ *  により直接的または間接的に生じたいかなる損害に関しても，その責任を負
+ *  わない．
+ *
  */
 /*
  *              TOPPERS/SSPJ[l Wwb_t@C
+ *
  *  TOPPERS/SSPJ[lªT|[g·éT[rXR[Ìé¾ÆCKvÈf[
  *  ^^CèC}NÌè`ðÜÞwb_t@CD
+ *
  *  AZu¾êÌ\[Xt@C©ç±Ìt@CðCN[h·é
  *  ÍCTOPPERS_MACRO_ONLYðè`µÄ¨D±êÉæèC}Nè`ÈOð
  *  æ¤ÉÈÁÄ¢éD
+ *
  *  ±Ìt@CðCN[h·éOÉCN[hµÄ¨×«t@C
  *  ÍÈ¢D
+ *              TOPPERS/SSPカーネル 標準ヘッダファイル
+ *
+ *  TOPPERS/SSPカーネルがサポートするサービスコールの宣言と，必要なデー
+ *  タ型，定数，マクロの定義を含むヘッダファイル．
+ *
+ *  アセンブリ言語のソースファイルからこのファイルをインクルードする時
+ *  は，TOPPERS_MACRO_ONLYを定義しておく．これにより，マクロ定義以外を
+ *  除くようになっている．
+ *
+ *  このファイルをインクルードする前にインクルードしておくべきファイル
+ *  はない．
  */
 …
 /*
  *      TOPPERS¤ÊÌf[^^EèE}N
+ *      TOPPERS共通のデータ型・定数・マクロ
  */
 #include <t_stddef.h>
 /*
  *  ^[QbgË¶
+ *  ターゲット依存部
  */
 #include "target_kernel.h"
 …
 /*
  *  f[^^Ìè`
  */
 /*
  *  rbgp^[âIuWFNgÔÌ^è`
  */
 typedef uint_t                  INTNO;          /* ÝÔ */
 typedef uint_t                  INHNO;          /* ÝnhÔ */
 typedef uint_t                  EXCNO;          /* CPUáOnhÔ */
 typedef unsigned long   FLGPTN;         /* CxgtOp^[ */
 /*
  *  PÊÌ^è`
+ *  データ型の定義
+ */
+/*
+ *  ビットパターンやオブジェクト番号の型定義
+ */
+typedef uint_t                  INTNO;          /* 割込み番号 */
+typedef uint_t                  INHNO;          /* 割込みハンドラ番号 */
+typedef uint_t                  EXCNO;          /* CPU例外ハンドラ番号 */
+typedef unsigned long   FLGPTN;         /* イベントフラグパターン */
+/*
+ *  処理単位の型定義
  */
 typedef void    (*TASK)(intptr_t exinf);
 …
 /*
  *  ÌæmÛÌ½ßÌ^è`
+ *  メモリ領域確保のための型定義
  */
 #ifndef TOPPERS_STK_T
 #define TOPPERS_STK_T   intptr_t
 #endif /* TOPPERS_STK_T */
 typedef TOPPERS_STK_T   STK_T;  /* X^bNÌæðmÛ·é½ßÌ^ */
 /*
  *  T[rXR[Ìé¾
  */
 /*
  *  ^XNÇ@\
+typedef TOPPERS_STK_T   STK_T;  /* スタック領域を確保するための型 */
+/*
+ *  サービスコールの宣言
+ */
+/*
+ *  タスク管理機能
  */
 extern ER               act_tsk(ID tskid);
 …
 /*
+ *  ¯úEÊM@\
+ */
+/* f[^L
+[ */
+ *  同期・通信機能
+ */
+/* データキュー */
 extern ER psnd_dtq(ID dtqid, intptr_t data);
 extern ER ipsnd_dtq(ID dtqid, intptr_t data);
 extern ER prcv_dtq(ID dtqid, intptr_t *p_data);
 /* CxgtO */
+/* イベントフラグ */
 extern ER set_flg(ID flgid, FLGPTN setptn);
 extern ER iset_flg(ID flgid, FLGPTN setptn);
 …
 /*
  *  VXeóÔÇ@\
+ *  システム状態管理機能
  */
 extern ER               loc_cpu(void);
 …
 /*
  *  ÝÇ@\
+ *  割込み管理機能
  */
 extern ER               dis_int(INTNO intno);
 …
 /*
  *  üúnh@\
+ *  周期ハンドラ機能
  */
 extern ER               sta_cyc(ID cycid);
 …
 /*
  *  A[nh@\
+ *  アラームハンドラ機能
  */
 extern ER               sta_alm(ID almid , RELTIM almtim);
 …
 /*
  *  VXeÇ@\
+ *  システム時刻管理機能
  */
 extern ER               get_tim(SYSTIM *p_systim);
 …
 /*
  *  IuWFNg®«Ìè`
  */
 #define TA_RSTR                 UINT_C(0x04)    /* §ñ^XN */
 #define TA_CLR                  UINT_C(0x04)    /* CxgtOÌNAwè */
 #define TA_ACT                  UINT_C(0x02)    /* ^XNðN®³ê½óÔÅ¶¬ */
 #define TA_STA                  UINT_C(0x02)    /* üúnhð®ìóÔÅ¶¬ */
 #define TA_NONKERNEL    UINT_C(0x02)    /* J[lÇOÌÝ */
 #define TA_ENAINT               UINT_C(0x01)    /* ÝvÖ~tOðNA */
 #define TA_EDGE                 UINT_C(0x02)    /* GbWgK */
 /*
  *  T[rXR[Ì®ì[hÌè`
  */
 #define TWF_ORW                 UINT_C(0x01)    /* CxgtOÌORÒ¿ */
 #define TWF_ANDW                UINT_C(0x02)    /* CxgtOÌANDÒ¿ */
 /*
  *  »Ì¼ÌèÌè`
  */
 #define TSK_SELF                0                       /* ©^XNwè */
 #define TSK_NONE                0                       /* Y·é^XNªÈ¢ */
 #define TPRI_INI                0                       /* ^XNÌN®Dæx */
 #define TIPM_ENAALL             0                       /* ÝDæx}XNSð */
 /*
  *  \¬èÆ}N
  */
 /*
  *  DæxÌÍÍ
  */
 #define TMIN_TPRI               1                       /* ^XNDæxÌÅ¬liÅlj*/
+ *  オブジェクト属性の定義
+ */
+#define TA_RSTR                 UINT_C(0x04)    /* 制約タスク */
+#define TA_CLR                  UINT_C(0x04)    /* イベントフラグのクリア指定 */
+#define TA_ACT                  UINT_C(0x02)    /* タスクを起動された状態で生成 */
+#define TA_STA                  UINT_C(0x02)    /* 周期ハンドラを動作状態で生成 */
+#define TA_NONKERNEL    UINT_C(0x02)    /* カーネル管理外の割込み */
+#define TA_ENAINT               UINT_C(0x01)    /* 割込み要求禁止フラグをクリア */
+#define TA_EDGE                 UINT_C(0x02)    /* エッジトリガ */
+/*
+ *  サービスコールの動作モードの定義
+ */
+#define TWF_ORW                 UINT_C(0x01)    /* イベントフラグのOR待ち */
+#define TWF_ANDW                UINT_C(0x02)    /* イベントフラグのAND待ち */
+/*
+ *  その他の定数の定義
+ */
+#define TSK_SELF                0                       /* 自タスク指定 */
+#define TSK_NONE                0                       /* 該当するタスクがない */
+#define TPRI_INI                0                       /* タスクの起動時優先度 */
+#define TIPM_ENAALL             0                       /* 割込み優先度マスク全解除 */
+/*
+ *  構成定数とマクロ
+ */
+/*
+ *  優先度の範囲
+ */
+#define TMIN_TPRI               1                       /* タスク優先度の最小値（最高値）*/
 #ifndef TMAX_TPRI
         #define TMAX_TPRI               16                      /* ^XNDæxÌÅåliÅálj*/
+        #define TMAX_TPRI               16                      /* タスク優先度の最大値（最低値）*/
 #elif (TMAX_TPRI != 8) && (TMAX_TPRI != 16)
         #error "TMAX_TPRI must defined 8 or 16."
 #endif  /* TMAX_TPRI */
 #define TMIN_ISRPRI             1                       /* ÝT[rX[`DæxÌÅ¬l */
+#define TMIN_ISRPRI             1                       /* 割込みサービスルーチン優先度の最小値 */
 #ifndef TMAX_ISRPRI
         #define TMAX_ISRPRI             16                      /* ÝT[rX[`DæxÌÅål */
+        #define TMAX_ISRPRI             16                      /* 割込みサービスルーチン優先度の最大値 */
 #elif (TMAX_ISRPRI != 8) && (TMAX_ISRPRI != 16)
         #error "TMAX_ISRPRI must defined 8 or 16."
 …
 /*
+ *  o[Wîñ
+ */
+#define TKERNEL_MAKER   UINT_C(0x0118)  /* J[lÌ[J[R[h */
+#define TKERNEL_PRID    UINT_C(0x0007)  /* J[lÌ¯ÊÔ */
+#define TKERNEL_SPVER   UINT_C(0xf511)  /* J[ldlÌo[WÔ */
+#define TKERNEL_PRVER   UINT_C(0x1030)  /* J[lÌo[WÔ */
+/*
+ *  L
+[COñÌÅål
+ */
+#define TMAX_ACTCNT             UINT_C(1)               /* N®vL
+[COÌÅål */
+/*
+ *  rbgp^[Ìrbg
+ */
+#ifndef TBIT_FLGPTN                     /* CxgtOÌrbg */
+ *  バージョン情報
+ */
+#define TKERNEL_MAKER   UINT_C(0x0118)  /* カーネルのメーカーコード */
+#define TKERNEL_PRID    UINT_C(0x0007)  /* カーネルの識別番号 */
+#define TKERNEL_SPVER   UINT_C(0xf511)  /* カーネル仕様のバージョン番号 */
+#define TKERNEL_PRVER   UINT_C(0x1030)  /* カーネルのバージョン番号 */
+/*
+ *  キューイング回数の最大値
+ */
+#define TMAX_ACTCNT             UINT_C(1)               /* 起動要求キューイング数の最大値 */
+/*
+ *  ビットパターンのビット数
+ */
+#ifndef TBIT_FLGPTN                     /* イベントフラグのビット数 */
 #define TBIT_FLGPTN             (sizeof(FLGPTN) * CHAR_BIT)
 #endif /* TBIT_FLGPTN */
 /*
  *  ÌæmÛÌ½ßÌ}N
+ *
  *  ÈºÌTOPPERS_COUNT_SZÆTOPPERS_ROUND_SZÌè`ÍCunitª2ÌÐæÅ
  *  é±Æð¼èµÄ¢éD
+ *  メモリ領域確保のためのマクロ
+ *
+ *  以下のTOPPERS_COUNT_SZとTOPPERS_ROUND_SZの定義は，unitが2の巾乗であ
+ *  ることを仮定している．
  */
 #ifndef TOPPERS_COUNT_SZ
 …
 /*
  *  »Ì¼Ì\¬è
  */
 #define TMAX_MAXCYC             UINT_C(16)        /* üúnhÌÅå */
 #define TMAX_MAXALM             UINT_C(16)        /* A[nhÌÅå */
+ *  その他の構成定数
+ */
+#define TMAX_MAXCYC             UINT_C(16)        /* 周期ハンドラの最大数 */
+#define TMAX_MAXALM             UINT_C(16)        /* アラームハンドラの最大数 */
 #endif /* TOPPERS_KERNEL_H */

uKadecot/trunk/ssp/include/log_output.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *              Nagoya Municipal Industrial Research Institute, JAPAN
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
  *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
  *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
  *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
  *  ÌÓCðíÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
  *              VXeOÌtH[}bgoÍ
+ *              システムログのフォーマット出力
  */
 …
 /*
  *  ¶ñ®`oÍ
+ *  文字列整形出力
+ *
  *  formatÅwè³êétH[}bgLqÆp_argsÅwè³êéøñ©çì
  *  ¬µ½bZ[WðC1¶oÍÖputcðp¢ÄoÍ·éD
+ *  formatで指定されるフォーマット記述とp_argsで指定される引数列から作
+ *  成したメッセージを，1文字出力関数putcを用いて出力する．
  */
 extern void     syslog_printf(const char *format, const intptr_t *p_args,
 …
 /*
  *  OîñÌoÍ
+ *  ログ情報の出力
+ *
  *  p_syslogÅwè³êéOîñð¶ñÉ®`µC1¶oÍÖputcðp
  *  ¢ÄoÍ·éD
+ *  p_syslogで指定されるログ情報を文字列に整形し，1文字出力関数putcを用
+ *  いて出力する．
  */
 extern void     syslog_print(const SYSLOG *p_syslog, void (*putc)(char)) throw();
 /*
  *  Oîñr¸bZ[W¶ñ
+ *  ログ情報喪失メッセージ文字列
+ *
  *  lostÂÌOîñª¸íê½|ÌbZ[WðC1¶oÍÖputcðp¢
  *  ÄoÍ·éD
+ *  lost個のログ情報が失われた旨のメッセージを，1文字出力関数putcを用い
+ *  て出力する．
  */
 extern void     syslog_lostmsg(uint_t lost, void (*putc)(char)) throw();

uKadecot/trunk/ssp/include/queue.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *  Copyright (C) 2011 by Meika Sugimoto
+ *
+ *  ãLì ÒÍCÈºÌ (1)`(4) Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»EüÏE
+ *  ÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *      \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[X
+ *      R[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉgp
+ *      Å«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gipÒ}
+ *      j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºLÌ³Û
+ *      ØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉgp
+ *      Å«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌì
+ *         \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉñ
+ *        ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹Q
+ *      ©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆDÜ½C
+ *      {\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©ÈéRÉîÃ
+ *      ¿©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *  上記著作権者は，以下の (1)〜(4) の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改変・
+ *  再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作権
+ *      表示，この利用条件および下記の無保証規定が，そのままの形でソース
+ *      コード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使用
+ *      できる形で再配布する場合には，再配布に伴うドキュメント（利用者マ
+ *      ニュアルなど）に，上記の著作権表示，この利用条件および下記の無保
+ *      証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使用
+ *      できない形で再配布する場合には，次のいずれかの条件を満たすこと．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著作
+ *        権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに報
+ *        告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損害
+ *      からも，上記著作権者およびTOPPERSプロジェクトを免責すること．また，
+ *      本ソフトウェアのユーザまたはエンドユーザからのいかなる理由に基づ
+ *      く請求からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨æ
  *  ÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚIÉÎ·
  *  éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEFAÌp
  *  Éæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»ÌÓCð
  *  íÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者およ
+ *  びTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的に対す
+ *  る適合性も含めて，いかなる保証も行わない．また，本ソフトウェアの利用
+ *  により直接的または間接的に生じたいかなる損害に関しても，その責任を負
+ *  わない．
+ *
  */
 /*
+ *  L
+[ìwb_
+ *  キュー操作ヘッダ
+ *
+ *  SSPJ[lÅÍßñÌ½ßÉCfbNXðgpµ½L
+[ðp¢é
+ *  SSPカーネルではメモリ節約のためにインデックスを使用したキューを用いる
  */
 …
 #define TOPPERS_QUEUE_H
+/* L
+[ÌCfbNX */
+/* キューのインデックス */
 typedef uint8_t QUEIDX;
+/* L
+[\¢Ì */
+/* キュー構造体 */
 typedef struct
+{
 …
+/* L
+[wb_Ìú» */
+/* キューヘッダの初期化 */
 Inline void
 queue_initialize(QUEUE *queue , QUEIDX queue_null)
 …
+}
 /* wèµ½vfÌOÉV½ÈvfðÇÁ */
+/* 指定した要素の前に新たな要素を追加 */
 Inline void
 queue_insert_prev(QUEUE *top , QUEIDX queue , QUEIDX entry)
 …
+/* wèµ½L
+[ÌÌvfðíµC»ÌCfbNXðÔ· */
+/* 指定したキューの次の要素を削除し，そのインデックスを返す */
 Inline QUEIDX
 queue_delete_next(QUEUE *top , QUEIDX queue)
 …
 /*
+ *  L
+[ªó©Ç¤©ÌeXg
+ *  キューが空かどうかのテスト
+ *
+ *  queueÉÍL
+[wb_ðwè·é±Æ
+ *  queueにはキューヘッダを指定すること
  */
 Inline bool_t

uKadecot/trunk/ssp/include/sil.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *             Nagoya Municipal Industrial Research Institute, JAPAN
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *
+ *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
+ *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
+ *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
+ *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
+ *  ÌÓCðíÈ¢D
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
  *              VXeC^tF[XC
+ *
  *  VXeC^tF[XCÌT[rXR[Ìè`Eé¾Æ}NÈ
  *  ÇÌè`ðÜÞwb_t@CD
+ *
  *  AZu¾êÌ\[Xt@C©ç±Ìt@CðCN[h·é
  *  ÍCTOPPERS_MACRO_ONLYðè`µÄ¨±ÆÅC}Nè`ÈOÌLqð
  *  ±ÆªÅ«éD
+ *
  *  ±Ìt@CðCN[h·éOÉCN[hµÄ¨×«t@C
  *  ÍÈ¢D
+ *              システムインタフェースレイヤ
+ *
+ *  システムインタフェースレイヤのサービスコールの定義・宣言とマクロな
+ *  どの定義を含むヘッダファイル．
+ *
+ *  アセンブリ言語のソースファイルからこのファイルをインクルードする時
+ *  は，TOPPERS_MACRO_ONLYを定義しておくことで，マクロ定義以外の記述を
+ *  除くことができる．
+ *
+ *  このファイルをインクルードする前にインクルードしておくべきファイル
+ *  はない．
  */
 …
 /*
  *      TOPPERS¤ÊÌf[^^EèE}N
+ *      TOPPERS共通のデータ型・定数・マクロ
  */
 #include <t_stddef.h>
 /*
  *  ^[QbgË¶
+ *  ターゲット依存部
  */
 #include "target_sil.h"
 …
 /*
  *  SÝbNóÔÌ§ä
+ *
  *  SIL_PRE_LOCCSIL_LOC_INT()CSIL_UNL_INT()ÍC^[QbgË¶Åp
  *  Ó·éDftHgÌè`ÍpÓµÄ¢È¢D
  */
 /*
  *  ÷ÔÒ¿
+ *  全割込みロック状態の制御
+ *
+ *  SIL_PRE_LOC，SIL_LOC_INT()，SIL_UNL_INT()は，ターゲット依存部で用
+ *  意する．デフォルトの定義は用意していない．
+ */
+/*
+ *  微少時間待ち
  */
 extern void     sil_dly_nse(ulong_t dlytim) throw();
 /*
  *  GfBAÌ½]
+ *  エンディアンの反転
  */
 #ifndef TOPPERS_SIL_REV_ENDIAN_UINT16
 …
 /*
  *  óÔANZXÖ
+ *  メモリ空間アクセス関数
  */
 #ifndef TOPPERS_OMIT_SIL_ACCESS
 /*
  *  8rbgPÊÌÇoµ^Ý
+ *  8ビット単位の読出し／書込み
  */
 #ifdef UINT8_MAX
 …
 /*
  *  16rbgPÊÌÇoµ^Ý
+ *  16ビット単位の読出し／書込み
  */
 …
+}
 #ifdef SIL_ENDIAN_BIG                   /* rbOGfBAvZbT */
+#ifdef SIL_ENDIAN_BIG                   /* ビッグエンディアンプロセッサ */
 #define sil_reh_bem(mem)                sil_reh_mem(mem)
 …
 #endif /* TOPPERS_OMIT_SIL_WRH_LEM */
 #else /* SIL_ENDIAN_BIG */              /* gGfBAvZbT */
+#else /* SIL_ENDIAN_BIG */              /* リトルエンディアンプロセッサ */
 #define sil_reh_lem(mem)                sil_reh_mem((mem))
 …
 /*
  *  32rbgPÊÌÇoµ^Ý
+ *  32ビット単位の読出し／書込み
  */
 …
+}
 #ifdef SIL_ENDIAN_BIG                   /* rbOGfBAvZbT */
+#ifdef SIL_ENDIAN_BIG                   /* ビッグエンディアンプロセッサ */
 #define sil_rew_bem(mem)                sil_rew_mem(mem)
 …
 #endif /* TOPPERS_OMIT_SIL_WRW_LEM */
 #else /* SIL_ENDIAN_BIG */              /* gGfBAvZbT */
+#else /* SIL_ENDIAN_BIG */              /* リトルエンディアンプロセッサ */
 #define sil_rew_lem(mem)                sil_rew_mem((mem))

uKadecot/trunk/ssp/include/t_stddef.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *              Nagoya Municipal Industrial Research Institute, JAPAN
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *
+ *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
+ *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
+ *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
+ *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
+ *  ÌÓCðíÈ¢D
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
  *              TOPPERS¤Êwb_t@C
+ *
  *  TOPPERSÖAÌ·×ÄÌ\[Xt@CÅCN[h·×«wb_t@C
  *  DeíÌJ[lâ\tgEFAiÅ¤ÊÉp¢é±ÆðzèµÄ¢
  *  éDTOPPERSÌeíÌJ[lâ\tgEFAiÅ¤ÊÉp¢éf[^^C
  *  èC}NÌè`ÈÇðÜÞD
+ *
  *  AZu¾êÌ\[Xt@C©ç±Ìt@CðCN[h·é
  *  ÍCTOPPERS_MACRO_ONLYðè`µÄ¨D±êÉæèC}Nè`ÈOð
  *  æ¤ÉÈÁÄ¢éD
+ *
  *  ±Ìt@CðCN[h·éOÉCN[hµÄ¨×«t@C
  *  ÍÈ¢D
+ *              TOPPERS共通ヘッダファイル
+ *
+ *  TOPPERS関連のすべてのソースファイルでインクルードすべきヘッダファイ
+ *  ル．各種のカーネルやソフトウェア部品で共通に用いることを想定してい
+ *  る．TOPPERSの各種のカーネルやソフトウェア部品で共通に用いるデータ型，
+ *  定数，マクロの定義などを含む．
+ *
+ *  アセンブリ言語のソースファイルからこのファイルをインクルードする時
+ *  は，TOPPERS_MACRO_ONLYを定義しておく．これにより，マクロ定義以外を
+ *  除くようになっている．
+ *
+ *  このファイルをインクルードする前にインクルードしておくべきファイル
+ *  はない．
  */
 …
 /*
  *  ^[QbgË¶
+ *  ターゲット依存部
  */
 #include "target_stddef.h"
 /*
  *  C¾ê/EC++Åthrow()ÉÎ·é½ßÌè`
+ *  C言語/EC++でthrow()に対処するための定義
  */
 #if !defined(__cplusplus) || defined(__embedded_cplusplus)
 …
 /*
  *  ^[QbgË¶Ìf[^^Ì}NÌftHgè`
+ *  ターゲット依存のデータ型のマクロのデフォルト定義
  */
 #ifndef TOPPERS_bool
 #define TOPPERS_bool    int                             /* u[^ */
+#define TOPPERS_bool    int                             /* ブール型 */
 #endif /* TOPPERS_bool */
 #ifndef TOPPERS_size
 #define TOPPERS_size    uintptr_t               /* TCY^ */
+#define TOPPERS_size    uintptr_t               /* サイズ型 */
 #endif /* TOPPERS_size */
 …
 struct TOPPERS_dummy_t { int TOPPERS_dummy_field; };
 typedef void                    (*TOPPERS_fp_t)(struct TOPPERS_dummy_t);
 #define TOPPERS_fp              TOPPERS_fp_t    /* vOÌN®Ôn */
+#define TOPPERS_fp              TOPPERS_fp_t    /* プログラムの起動番地 */
 #endif /* TOPPERS_fp */
 /*
  *  ¤Êf[^^
  */
 typedef TOPPERS_bool    bool_t;         /* ^Ul */
 typedef signed int              int_t;          /* ©RÈTCYÌt«® */
 typedef unsigned int    uint_t;         /* ©RÈTCYÌ³µ® */
 typedef signed long             long_t;         /* ·ßÌTCYÌt«® */
 typedef unsigned long   ulong_t;        /* ·ßÌTCYÌ³µ® */
 typedef int_t                   FN;                     /* @\R[h */
 typedef int_t                   ER;                     /* G[R[h */
 typedef int_t                   ID;                     /* IuWFNgÌIDÔ */
 typedef uint_t                  ATR;            /* IuWFNgÌ®« */
 typedef uint_t                  STAT;           /* IuWFNgÌóÔ */
 typedef uint_t                  MODE;           /* T[rXR[Ì®ì[h */
 typedef int_t                   PRI;            /* Dæx */
 typedef TOPPERS_size    SIZE;           /* ÌæÌTCY */
 typedef int_t                   TMO;            /* ^CAEgwè */
 typedef uint_t                  RELTIM;         /* ÎÔ */
 typedef ulong_t                 SYSTIM;         /* VXe */
 typedef ulong_t                 SYSUTM;         /* «\]¿pVXe */
 typedef TOPPERS_fp              FP;                     /* vOÌN®Ôn */
 typedef int_t                   ER_BOOL;        /* G[R[hÜ½Í^Ul */
 typedef int_t                   ER_ID;          /* G[R[hÜ½ÍIDÔ */
 typedef int_t                   ER_UINT;        /* G[R[hÜ½Í³µ® */
 typedef uint32_t                ACPTN;          /* ANZXÂp^[ */
 typedef struct acvct {                          /* ANZXÂxN^ */
         ACPTN           acptn1;                         /* Êíì1ÌANZXÂp^[ */
         ACPTN           acptn2;                         /* Êíì2ÌANZXÂp^[ */
         ACPTN           acptn3;                         /* ÇìÌANZXÂp^[ */
         ACPTN           acptn4;                         /* QÆìÌANZXÂp^[ */
+ *  共通データ型
+ */
+typedef TOPPERS_bool    bool_t;         /* 真偽値 */
+typedef signed int              int_t;          /* 自然なサイズの符号付き整数 */
+typedef unsigned int    uint_t;         /* 自然なサイズの符号無し整数 */
+typedef signed long             long_t;         /* 長めのサイズの符号付き整数 */
+typedef unsigned long   ulong_t;        /* 長めのサイズの符号無し整数 */
+typedef int_t                   FN;                     /* 機能コード */
+typedef int_t                   ER;                     /* エラーコード */
+typedef int_t                   ID;                     /* オブジェクトのID番号 */
+typedef uint_t                  ATR;            /* オブジェクトの属性 */
+typedef uint_t                  STAT;           /* オブジェクトの状態 */
+typedef uint_t                  MODE;           /* サービスコールの動作モード */
+typedef int_t                   PRI;            /* 優先度 */
+typedef TOPPERS_size    SIZE;           /* メモリ領域のサイズ */
+typedef int_t                   TMO;            /* タイムアウト指定 */
+typedef uint_t                  RELTIM;         /* 相対時間 */
+typedef ulong_t                 SYSTIM;         /* システム時刻 */
+typedef ulong_t                 SYSUTM;         /* 性能評価用システム時刻 */
+typedef TOPPERS_fp              FP;                     /* プログラムの起動番地 */
+typedef int_t                   ER_BOOL;        /* エラーコードまたは真偽値 */
+typedef int_t                   ER_ID;          /* エラーコードまたはID番号 */
+typedef int_t                   ER_UINT;        /* エラーコードまたは符号無し整数 */
+typedef uint32_t                ACPTN;          /* アクセス許可パターン */
+typedef struct acvct {                          /* アクセス許可ベクタ */
+        ACPTN           acptn1;                         /* 通常操作1のアクセス許可パターン */
+        ACPTN           acptn2;                         /* 通常操作2のアクセス許可パターン */
+        ACPTN           acptn3;                         /* 管理操作のアクセス許可パターン */
+        ACPTN           acptn4;                         /* 参照操作のアクセス許可パターン */
 } ACVCT;
 …
 /*
  *  ®èðìé}N
+ *  整数定数を作るマクロ
  */
 #ifndef UINT_C
 #define UINT_C(val)             (val ## U)              /* uint_t^Ìèðìé}N */
+#define UINT_C(val)             (val ## U)              /* uint_t型の定数を作るマクロ */
 #endif /* UINT_C */
 #ifndef ULONG_C
 #define ULONG_C(val)    (val ## UL)             /* ulong_t^Ìèðìé}N */
+#define ULONG_C(val)    (val ## UL)             /* ulong_t型の定数を作るマクロ */
 #endif /* ULONG_C */
 /*
  *  êÊè
+ *  一般定数
  */
 #ifndef NULL
 #define NULL            0                       /* ³ø|C^ */
+#define NULL            0                       /* 無効ポインタ */
 #endif /* NULL */
 #ifndef true
 #define true            1                       /* ^ */
+#define true            1                       /* 真 */
 #endif /* true */
 #ifndef false
 #define false           0                       /* U */
+#define false           0                       /* 偽 */
 #endif /* false */
+#define E_OK            0                       /* ³íI¹ */
+/*
+ *  CG[R[h
+ */
+#define E_SYS           (-5)            /* VXeG[ */
+#define E_NOSPT         (-9)            /* ¢T|[g@\ */
+#define E_RSFN          (-10)           /* \ñ@\R[h */
+#define E_RSATR         (-11)           /* \ñ®« */
+#define E_PAR           (-17)           /* p[^G[ */
+#define E_ID            (-18)           /* s³IDÔ */
+#define E_CTX           (-25)           /* ReLXgG[ */
+#define E_MACV          (-26)           /* ANZXá½ */
+#define E_OACV          (-27)           /* IuWFNgANZXá½ */
+#define E_ILUSE         (-28)           /* T[rXR[s³gp */
+#define E_NOMEM         (-33)           /* s« */
+#define E_NOID          (-34)           /* IDÔs« */
+#define E_NORES         (-35)           /* ¹s« */
+#define E_OBJ           (-41)           /* IuWFNgóÔG[ */
+#define E_NOEXS         (-42)           /* IuWFNg¢¶¬ */
+#define E_QOVR          (-43)           /* L
+[COI[o[t[ */
+#define E_RLWAI         (-49)           /* Ò¿óÔÌ§ð */
+#define E_TMOUT         (-50)           /* |[O¸sÜ½Í^CAEg */
+#define E_DLT           (-51)           /* Ò¿IuWFNgÌí */
+#define E_CLS           (-52)           /* Ò¿IuWFNgÌóÔÏ» */
+#define E_WBLK          (-57)           /* mubLOót¯ */
+#define E_BOVR          (-58)           /* obt@I[o[t[ */
+/*
+ *  IuWFNg®«
+ */
+#define TA_NULL         UINT_C(0)       /* IuWFNg®«ðwèµÈ¢ */
+/*
+ *  ^CAEgwè
+ */
+#define TMO_POL         0                       /* |[O */
+#define TMO_FEVR        (-1)            /* ivÒ¿ */
+#define TMO_NBLK        (-2)            /* mubLO */
+/*
+ *  ANZXÂp^[
+ */
+#define TACP_KERNEL             (0U)    /* J[lhC¾¯ÉANZXðÂ */
+#define TACP_SHARED             (~0U)   /* ·×ÄÌhC©çANZXðÂ */
+/*
+ *  ^ÉÖ·éîñðæèo·½ßÌ}N
+#define E_OK            0                       /* 正常終了 */
+/*
+ *  メインエラーコード
+ */
+#define E_SYS           (-5)            /* システムエラー */
+#define E_NOSPT         (-9)            /* 未サポート機能 */
+#define E_RSFN          (-10)           /* 予約機能コード */
+#define E_RSATR         (-11)           /* 予約属性 */
+#define E_PAR           (-17)           /* パラメータエラー */
+#define E_ID            (-18)           /* 不正ID番号 */
+#define E_CTX           (-25)           /* コンテキストエラー */
+#define E_MACV          (-26)           /* メモリアクセス違反 */
+#define E_OACV          (-27)           /* オブジェクトアクセス違反 */
+#define E_ILUSE         (-28)           /* サービスコール不正使用 */
+#define E_NOMEM         (-33)           /* メモリ不足 */
+#define E_NOID          (-34)           /* ID番号不足 */
+#define E_NORES         (-35)           /* 資源不足 */
+#define E_OBJ           (-41)           /* オブジェクト状態エラー */
+#define E_NOEXS         (-42)           /* オブジェクト未生成 */
+#define E_QOVR          (-43)           /* キューイングオーバーフロー */
+#define E_RLWAI         (-49)           /* 待ち状態の強制解除 */
+#define E_TMOUT         (-50)           /* ポーリング失敗またはタイムアウト */
+#define E_DLT           (-51)           /* 待ちオブジェクトの削除 */
+#define E_CLS           (-52)           /* 待ちオブジェクトの状態変化 */
+#define E_WBLK          (-57)           /* ノンブロッキング受付け */
+#define E_BOVR          (-58)           /* バッファオーバーフロー */
+/*
+ *  オブジェクト属性
+ */
+#define TA_NULL         UINT_C(0)       /* オブジェクト属性を指定しない */
+/*
+ *  タイムアウト指定
+ */
+#define TMO_POL         0                       /* ポーリング */
+#define TMO_FEVR        (-1)            /* 永久待ち */
+#define TMO_NBLK        (-2)            /* ノンブロッキング */
+/*
+ *  アクセス許可パターン
+ */
+#define TACP_KERNEL             (0U)    /* カーネルドメインだけにアクセスを許可 */
+#define TACP_SHARED             (~0U)   /* すべてのドメインからアクセスを許可 */
+/*
+ *  型に関する情報を取り出すためのマクロ
  */
 #ifndef offsetof
 …
 #endif /* alignof */
 #ifndef ALIGN_TYPE                              /* ACgÌ`FbN */
+#ifndef ALIGN_TYPE                              /* アラインメントのチェック */
 #define ALIGN_TYPE(addr, type) \
                                                 ((((uintptr_t)(addr)) & (alignof(type) - 1)) == 0U)
 …
 /*
  *  assert}N
+ *  assertマクロ
  */
 #undef assert
 …
 /*
  *  G[R[h¶¬Eªð}N
+ *
  *  ÈºÌ}Nè`ÍCt«®ª2ÌâÅ\»³êÄ¨èCEVtg
  *  Zqi>>jªZpVtg³êé±Æð¼èµÄ¢éD»¤ÅÈ¢JÂ
  *  «ÅÍCtarget_stddef.hÅ±êçÌè`ðã«µÈ¯êÎÈçÈ¢D
+ *
  *  MERCD}NÌè`ÍCCG[R[hªÅ é±Æð¼èµÄ¢éD
  *  »¤ÅÈ¢êC2ÂÌè`ªêvµÈÈéD
+ *  エラーコード生成・分解マクロ
+ *
+ *  以下のマクロ定義は，符号付き整数が2の補数で表現されており，右シフト
+ *  演算子（>>）が算術シフトされることを仮定している．そうでない開発環
+ *  境では，target_stddef.hでこれらの定義を上書きしなければならない．
+ *
+ *  MERCDマクロの定義は，メインエラーコードが負であることを仮定している．
+ *  そうでない場合，2つの定義が一致しなくなる．
  */
 #ifndef ERCD
 …
 /*
  *  ÎÔiRELTIMjÉwèÅ«éÅål
+ *  相対時間（RELTIM）に指定できる最大値
  */
 #if UINT_MAX < LONG_MAX

uKadecot/trunk/ssp/include/t_syslog.h

Property svn:mime-type changed from text/plain to text/plain; charset=SHIFT_JIS

-              r101
+              r107
  *              Graduate School of Information Science, Nagoya Univ., JAPAN
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
  *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
  *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
  *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
  *  ÌÓCðíÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
  *              VXeOoÍðs¤½ßÌè`
+ *
  *  VXeOT[rXÍCVXeÌOîñðoÍ·é½ßÌT[rX
  *  Å éDJ[l©çÌOîñÌoÍÉàp¢é½ßCàÅÒ¿óÔ
  *  ÉÍ¢é±ÆÍÈ¢D
+ *
  *  OîñÍCJ[làÌOobt@É«Þ©CáxÌ¶o
  *  ÍÖðp¢ÄoÍ·éDÇ¿çðg¤©ÍCg£T[rXR[ÅØè
  *  ·¦é±ÆªÅ«éD
+ *
  *  Oobt@ÌæªI[ot[µ½êÉÍCÃ¢OîñðÁµÄã
  *  «·éD
+ *
  *  AZu¾êÌ\[Xt@C©ç±Ìt@CðCN[h·é
  *  ÍCTOPPERS_MACRO_ONLYðè`µÄ¨±ÆÅC}Nè`ÈOÌLqð
  *  ±ÆªÅ«éD
+ *
  *  ±Ìt@CðCN[h·éOÉCt_stddef.hðCN[hµÄ¨
  *  ±ÆªKvÅ éD
+ *              システムログ出力を行うための定義
+ *
+ *  システムログサービスは，システムのログ情報を出力するためのサービス
+ *  である．カーネルからのログ情報の出力にも用いるため，内部で待ち状態
+ *  にはいることはない．
+ *
+ *  ログ情報は，カーネル内のログバッファに書き込むか，低レベルの文字出
+ *  力関数を用いて出力する．どちらを使うかは，拡張サービスコールで切り
+ *  換えることができる．
+ *
+ *  ログバッファ領域がオーバフローした場合には，古いログ情報を消して上
+ *  書きする．
+ *
+ *  アセンブリ言語のソースファイルからこのファイルをインクルードする時
+ *  は，TOPPERS_MACRO_ONLYを定義しておくことで，マクロ定義以外の記述を
+ *  除くことができる．
+ *
+ *  このファイルをインクルードする前に，t_stddef.hをインクルードしてお
+ *  くことが必要である．
  */
 …
 /*
  *  OîñÌíÊÌè`
  */
 #define LOG_TYPE_COMMENT        UINT_C(0x01)    /* Rg */
 #define LOG_TYPE_ASSERT         UINT_C(0x02)    /* AT[VÌ¸s */
 #define LOG_TYPE_INH            UINT_C(0x11)    /* Ýnh */
 #define LOG_TYPE_ISR            UINT_C(0x12)    /* ÝT[rX[` */
 #define LOG_TYPE_CYC            UINT_C(0x13)    /* üúnh */
 #define LOG_TYPE_ALM            UINT_C(0x14)    /* A[nh */
 #define LOG_TYPE_OVR            UINT_C(0x15)    /* I[onh */
 #define LOG_TYPE_EXC            UINT_C(0x16)    /* CPUáOnh */
 #define LOG_TYPE_TEX            UINT_C(0x17)    /* ^XNáO[` */
 #define LOG_TYPE_TSKSTAT        UINT_C(0x18)    /* ^XNóÔÏ» */
 #define LOG_TYPE_DSP            UINT_C(0x19)    /* fBXpb` */
 #define LOG_TYPE_SVC            UINT_C(0x1a)    /* T[rXR[ */
 #define LOG_ENTER                       UINT_C(0x00)    /* üû^Jn */
 #define LOG_LEAVE                       UINT_C(0x80)    /* oû^I¹ */
 /*
  *  OîñÌdvxÌè`
  */
 #define LOG_EMERG                       UINT_C(0)               /* Vbg_EÉl·éG[ */
+ *  ログ情報の種別の定義
+ */
+#define LOG_TYPE_COMMENT        UINT_C(0x01)    /* コメント */
+#define LOG_TYPE_ASSERT         UINT_C(0x02)    /* アサーションの失敗 */
+#define LOG_TYPE_INH            UINT_C(0x11)    /* 割込みハンドラ */
+#define LOG_TYPE_ISR            UINT_C(0x12)    /* 割込みサービスルーチン */
+#define LOG_TYPE_CYC            UINT_C(0x13)    /* 周期ハンドラ */
+#define LOG_TYPE_ALM            UINT_C(0x14)    /* アラームハンドラ */
+#define LOG_TYPE_OVR            UINT_C(0x15)    /* オーバランハンドラ */
+#define LOG_TYPE_EXC            UINT_C(0x16)    /* CPU例外ハンドラ */
+#define LOG_TYPE_TEX            UINT_C(0x17)    /* タスク例外処理ルーチン */
+#define LOG_TYPE_TSKSTAT        UINT_C(0x18)    /* タスク状態変化 */
+#define LOG_TYPE_DSP            UINT_C(0x19)    /* ディスパッチャ */
+#define LOG_TYPE_SVC            UINT_C(0x1a)    /* サービスコール */
+#define LOG_ENTER                       UINT_C(0x00)    /* 入口／開始 */
+#define LOG_LEAVE                       UINT_C(0x80)    /* 出口／終了 */
+/*
+ *  ログ情報の重要度の定義
+ */
+#define LOG_EMERG                       UINT_C(0)               /* シャットダウンに値するエラー */
 #define LOG_ALERT                       UINT_C(1)
 #define LOG_CRIT                        UINT_C(2)
 #define LOG_ERROR                       UINT_C(3)               /* VXeG[ */
 #define LOG_WARNING                     UINT_C(4)               /* xbZ[W */
+#define LOG_ERROR                       UINT_C(3)               /* システムエラー */
+#define LOG_WARNING                     UINT_C(4)               /* 警告メッセージ */
 #define LOG_NOTICE                      UINT_C(5)
 #define LOG_INFO                        UINT_C(6)
 #define LOG_DEBUG                       UINT_C(7)               /* fobOpbZ[W */
+#define LOG_DEBUG                       UINT_C(7)               /* デバッグ用メッセージ */
 #ifndef TOPPERS_MACRO_ONLY
 /*
  *  OîñÌf[^\¢
+ *  ログ情報のデータ構造
  */
 …
 typedef struct {
         uint_t          logtype;                                /* OîñÌíÊ */
         SYSTIM          logtim;                                 /* O */
         intptr_t        loginfo[TMAX_LOGINFO];  /* »Ì¼ÌOîñ */
+        uint_t          logtype;                                /* ログ情報の種別 */
+        SYSTIM          logtim;                                 /* ログ時刻 */
+        intptr_t        loginfo[TMAX_LOGINFO];  /* その他のログ情報 */
 } SYSLOG;
 /*
  *  OîñÌdvxÌrbg}bvðìé½ßÌ}N
+ *  ログ情報の重要度のビットマップを作るためのマクロ
  */
 #define LOG_MASK(prio)          (1U << (prio))
 …
 /*
  *  OîñðoÍ·é½ßÌCuÖ
+ *  ログ情報を出力するためのライブラリ関数
  */
 …
 /*
  *  OîñiRgjðoÍ·é½ßÌCuÖivasyslog.cj
+ *  ログ情報（コメント）を出力するためのライブラリ関数（vasyslog.c）
  */
 extern void     syslog(uint_t prio, const char *format, ...) throw();
 …
 /*
  *  VXeOoÍð}~·éê
+ *  システムログ出力を抑止する場合
  */
 …
 /*
  *  OîñiRgjðoÍ·é½ßÌ}N
+ *
  *  format¨æÑã±Ìø©çì¬µ½bZ[WðCdåxprioÅOî
  *  ñÆµÄoÍ·é½ßÌ}NDarg1`argnÍintptr_t^ÉLXg·é
  *  ½ßCintptr_t^É^Ï·Å«éCÓÌ^Åæ¢D
+ *  ログ情報（コメント）を出力するためのマクロ
+ *
+ *  formatおよび後続の引数から作成したメッセージを，重大度prioでログ情
+ *  報として出力するためのマクロ．arg1〜argnはintptr_t型にキャストする
+ *  ため，intptr_t型に型変換できる任意の型でよい．
  */
 …
 /*
  *  OîñiAT[VÌ¸sjðoÍ·é½ßÌ}N
+ *  ログ情報（アサーションの失敗）を出力するためのマクロ
  */
 #ifndef TOPPERS_assert_fail

Context Navigation

Legend:

uKadecot/trunk/ssp/include/itron.h

uKadecot/trunk/ssp/include/kernel.h

uKadecot/trunk/ssp/include/log_output.h

uKadecot/trunk/ssp/include/queue.h

uKadecot/trunk/ssp/include/sil.h

uKadecot/trunk/ssp/include/t_stddef.h

uKadecot/trunk/ssp/include/t_syslog.h

Download in other formats: