Context Navigation

← Previous Change
Next Change →

kernel.h

Timestamp:

Jun 2, 2015, 3:39:53 PM (9 years ago)

Author:

nmir-saito

Message:

ファイルの mime-type 変更

File:

: 1 edited

ssp_qb_r5f100le_cs/trunk/include/kernel.h (modified) (13 diffs, 1 prop)

Legend:

: Unmodified
: Added
: Removed

ssp_qb_r5f100le_cs/trunk/include/kernel.h

Property svn:mime-type set to text/plain; charset=shift_jis

-              r93
+              r95
  *  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 */

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 95 for ssp_qb_r5f100le_cs/trunk/include/kernel.h

Legend:

ssp_qb_r5f100le_cs/trunk/include/kernel.h

Download in other formats: