Changeset 315 for rubycfg_asp/trunk/asp_dcre/kernel/time_event.h

Timestamp:

Jul 23, 2017, 2:29:40 PM (7 years ago)

Author:

coas-nagasima

Message:

SVNプロパティを設定

File:

• rubycfg_asp/trunk/asp_dcre/kernel/time_event.h (modified) (10 diffs, 1 prop)

rubycfg_asp/trunk/asp_dcre/kernel/time_event.h

@@ -9 +9 @@
  *              Graduate School of Information Science, Nagoya Univ., JAPAN
  * 
- *  上記著作権è€
-は，以下の(1)～(4)ã®æ¡ä»¶ã‚’æº€ãŸã™å ´åˆã«é™ã‚Šï¼Œæœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§
- *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
- *  変・再é
-å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
- *  (1) æœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®å½¢ã§åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œä¸Šè¨˜ã®è‘—ä½œ
- *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
- *      スコード中に含まれていること．
- *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
- *      用できる形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
- *      è€
-マニュアルなど）に，上記の著作権表示，この利用条件および下記
- *      の無保証規定を掲載すること．
- *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
- *      用できない形で再é
-å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
- *      と．
- *    (a) 再é
-å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€
-マニュアルなど）に，上記の著
- *        作権表示，この利用条件および下記の無保証規定を掲載すること．
- *    (b) 再é
-å¸ƒã®å½¢æ
-‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
- *        å ±å‘Šã™ã‚‹ã“ã¨ï¼Ž
- *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
- *      害からも，上記著作権è€
-およびTOPPERSプロジェクトをå
-è²¬ã™ã‚‹ã“と．
- *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
- *      由に基づく請求からも，上記著作権è€
-およびTOPPERSプロジェクトを
- *      å
-è²¬ã™ã‚‹ã“と．
- * 
- *  本ソフトウェアは，無保証で提供されているものである．上記著作権è€
-お
- *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
- *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
- *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
- *  ã®è²¬ä»»ã‚’è² ã‚ãªã„ï¼Ž
+ *  上記著作権者は，以下の(1)～(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ * 
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
  * 
  *  $Id$
@@ -57 +42 @@
 
 /*
- *              タイムイベント管理モジュール
+ *              タイムイベント管理モジュール
  */
 
@@ -64 +49 @@
 
 /*
- *  イベント発生時刻のデータ型の定義
- *
- *  EVTTIMは，RELTIMとして指定できる範囲よりも広い範囲を表現できるå¿
-要
- *  がある．μITRON4.0仕様のスタンダードプロファイルでは，RELTIMが16ビッ
- *  ト以上でなければならないため，EVTTIMは17ビット以上であることがå¿
-要
- *  である．そのため，16ãƒ“ãƒƒãƒˆã«ãªã‚‹å ´åˆãŒã‚ã‚‹uint_tではなく，ulong_tに
- *  定義している．
+ *  イベント発生時刻のデータ型の定義
+ *
+ *  EVTTIMは，RELTIMとして指定できる範囲よりも広い範囲を表現できる必要
+ *  がある．μITRON4.0仕様のスタンダードプロファイルでは，RELTIMが16ビッ
+ *  ト以上でなければならないため，EVTTIMは17ビット以上であることが必要
+ *  である．そのため，16ビットになる場合があるuint_tではなく，ulong_tに
+ *  定義している．
  */
 typedef ulong_t EVTTIM;
 
 /* 
- *  タイムイベントブロックのデータ型の定義
- */
-typedef void    (*CBACK)(void *);       /* コールバック関数の型 */
+ *  タイムイベントブロックのデータ型の定義
+ */
+typedef void    (*CBACK)(void *);       /* コールバック関数の型 */
 
 typedef struct time_event_block {
-        uint_t  index;                  /* タイムイベントヒープ中での位置 */
-        CBACK   callback;               /* コールバック関数 */
-        void    *arg;                   /* コールバック関数へ渡す引数 */
+        uint_t  index;                  /* タイムイベントヒープ中での位置 */
+        CBACK   callback;               /* コールバック関数 */
+        void    *arg;                   /* コールバック関数へ渡す引数 */
 } TMEVTB;
 
 /*
- *  タイムイベントヒープ中のノードのデータ型の定義
+ *  タイムイベントヒープ中のノードのデータ型の定義
  */
 typedef struct time_event_node {
-        EVTTIM  time;                   /* イベント発生時刻 */
-        TMEVTB  *p_tmevtb;              /* 対応するタイムイベントブロック */
+        EVTTIM  time;                   /* イベント発生時刻 */
+        TMEVTB  *p_tmevtb;              /* 対応するタイムイベントブロック */
 } TMEVTN;
 
 /*
- *  タイムイベントヒープ（kernel_cfg.c）
+ *  タイムイベントヒープ（kernel_cfg.c）
  */
 extern TMEVTN   tmevt_heap[];
 
 /*
- *  現在のシステム時刻（単位: 1ミリ秒）
- *
- *  システム起動時に0に初期化され，以降，タイムティックが供給される度に
- *  å˜èª¿ã«å¢—åŠ ã™ã‚‹ï¼Ž
+ *  現在のシステム時刻（単位: 1ミリ秒）
+ *
+ *  システム起動時に0に初期化され，以降，タイムティックが供給される度に
+ *  単調に増加する．
  */
 extern EVTTIM   current_time;
 
 /*
- *  タイムイベントヒープ中で有効な最小のシステム時刻（単位: 1ミリ秒）
+ *  タイムイベントヒープ中で有効な最小のシステム時刻（単位: 1ミリ秒）
  */
 extern EVTTIM   min_time;
 
 /*
- *  次のタイムティックのシステム時刻（単位: 1ミリ秒）
+ *  次のタイムティックのシステム時刻（単位: 1ミリ秒）
  */
 extern EVTTIM   next_time;
 
 /*
- *  システム時刻積算用変数（単位: 1/TIC_DENOミリ秒）
- *
- *  次のタイムティックのシステム時刻の下位桁を示す（上位桁はnext_time）．
- *  TIC_DENOが1の時は，下位桁は常に0であるため，この変数はå¿
-要ない．
+ *  システム時刻積算用変数（単位: 1/TIC_DENOミリ秒）
+ *
+ *  次のタイムティックのシステム時刻の下位桁を示す（上位桁はnext_time）．
+ *  TIC_DENOが1の時は，下位桁は常に0であるため，この変数は必要ない．
  */
 #if TIC_DENO != 1U
@@ -130 +112 @@
 
 /*
- *  相対時間の基準時刻（単位: 1ミリ秒）
- *
- *  次のタイムティックのシステム時刻を切り上げた時刻．TIC_DENOが1の時
- *  は，next_timeに一致する．
+ *  相対時間の基準時刻（単位: 1ミリ秒）
+ *
+ *  次のタイムティックのシステム時刻を切り上げた時刻．TIC_DENOが1の時
+ *  は，next_timeに一致する．
  */
 #if TIC_DENO == 1U
@@ -142 +124 @@
 
 /*
- *  ã‚¿ã‚¤ãƒ ã‚¤ãƒ™ãƒ³ãƒˆãƒ’ãƒ¼ãƒ—ã®æœ€å¾Œã®ä½¿ç”¨é ˜åŸŸã®ã‚¤ãƒ³ãƒ‡ãƒƒã‚¯ã‚¹
- *
- *  タイムイベントヒープに登録されているタイムイベントの数に一致する．
+ *  タイムイベントヒープの最後の使用領域のインデックス
+ *
+ *  タイムイベントヒープに登録されているタイムイベントの数に一致する．
  */
 extern uint_t   last_index;
 
 /*
- *  タイムイベント管理モジュールの初期化
+ *  タイムイベント管理モジュールの初期化
  */
 extern void     initialize_tmevt(void);
 
 /*
- *  タイムイベントの挿å
-¥ä½ç½®ã®æŽ¢ç´¢
+ *  タイムイベントの挿入位置の探索
  */
 extern uint_t   tmevt_up(uint_t index, EVTTIM time);
@@ -161 +142 @@
 
 /*
- *  タイムイベントヒープへの登録と削除
+ *  タイムイベントヒープへの登録と削除
  */
 extern void     tmevtb_insert(TMEVTB *p_tmevtb, EVTTIM time);
@@ -167 +148 @@
 
 /*
- *  タイムイベントブロックの登録（相対時間指定）
- *
- *  timeで指定した相対時間が経過した後に，argを引数としてcallbackが呼
- *  び出されるように，p_tmevtbで指定したタイムイベントブロックを登録す
- *  る．
+ *  タイムイベントブロックの登録（相対時間指定）
+ *
+ *  timeで指定した相対時間が経過した後に，argを引数としてcallbackが呼
+ *  び出されるように，p_tmevtbで指定したタイムイベントブロックを登録す
+ *  る．
  *  
  */
@@ -185 +166 @@
 
 /*
- *  タイムイベントブロックの登録（イベント発生時刻指定）
- *
- *  timeで指定したイベント発生時刻に，argを引数としてcallbackが呼び出
- *  されるように，p_tmevtbで指定したタイムイベントブロックを登録する．
+ *  タイムイベントブロックの登録（イベント発生時刻指定）
+ *
+ *  timeで指定したイベント発生時刻に，argを引数としてcallbackが呼び出
+ *  されるように，p_tmevtbで指定したタイムイベントブロックを登録する．
  */
 Inline void
@@ -199 +180 @@
 
 /*
- *  タイムイベントブロックの登録解除
+ *  タイムイベントブロックの登録解除
  */
 Inline void
@@ -208 +189 @@
 
 /*
- *  タイムイベントまでの残り時間の計算
+ *  タイムイベントまでの残り時間の計算
  */
 extern RELTIM   tmevt_lefttim(TMEVTB *p_tmevtb);
 
 /*
- *  タイムティックの供給
+ *  タイムティックの供給
  */
 extern void     signal_time(void);