Context Navigation

← Previous Change
Next Change →

time_event.c

Timestamp:

Mar 8, 2016, 8:37:45 PM (7 years ago)

Author:

coas-nagasima

Message:

MIMEにSJISを設定

File:

: 1 edited

UsbWattMeter/trunk/asp_dcre/kernel/time_event.c (modified) (31 diffs, 1 prop)

Legend:

: Unmodified
: Added
: Removed

UsbWattMeter/trunk/asp_dcre/kernel/time_event.c

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

-              r164
+              r167
  *              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$
 …
 /*
+ *              ^CCxgÇW
+[
+ *              タイムイベント管理モジュール
  */
 …
 /*
  *  ^CCxgq[vì}N
  */
 #define PARENT(index)           ((index) >> 1)          /* em[hðßé */
 #define LCHILD(index)           ((index) << 1)          /* ¶Ìqm[hðßé */
+ *  タイムイベントヒープ操作マクロ
+ */
+#define PARENT(index)           ((index) >> 1)          /* 親ノードを求める */
+#define LCHILD(index)           ((index) << 1)          /* 左の子ノードを求める */
 #define TMEVT_NODE(index)       (tmevt_heap[(index) - 1])
 /*
  *  Cxg¶är}N
+ *
  *  Cxg¶ÍCmin_time©çÌÎlÅär·éD·Èí¿C
  *  min_timeðÅ¬liÅàß¢jCmit_time-1ªÅåliÅà¢j
  *  ÆÝÈµÄär·éD
+ *  イベント発生時刻比較マクロ
+ *
+ *  イベント発生時刻は，min_timeからの相対値で比較する．すなわち，
+ *  min_timeを最小値（最も近い時刻），mit_time-1が最大値（最も遠い時刻）
+ *  とみなして比較する．
  */
 #define EVTTIM_LT(t1, t2) (((t1) - min_time) < ((t2) - min_time))
 …
 /*
  *  »ÝÌVXeiPÊ: 1~bj
+ *
  *  µ§ÉÍCOÌ^CeBbNÌVXeD
+ *  現在のシステム時刻（単位: 1ミリ秒）
+ *
+ *  厳密には，前のタイムティックのシステム時刻．
  */
 EVTTIM  current_time;
 /*
  *  ^CCxgq[vÅLøÈÅ¬ÌVXeiPÊ: 1~bj
+ *  タイムイベントヒープ中で有効な最小のシステム時刻（単位: 1ミリ秒）
  */
 EVTTIM  min_time;
 /*
  *  Ì^CeBbNÌVXeiPÊ: 1~bj
+ *  次のタイムティックのシステム時刻（単位: 1ミリ秒）
  */
 EVTTIM  next_time;
 /*
  *  VXeÏZpÏiPÊ: 1/TIC_DENO~bj
+ *  システム時刻積算用変数（単位: 1/TIC_DENOミリ秒）
  */
 #if TIC_DENO != 1U
 …
 /*
  *  ^CCxgq[vÌÅãÌgpÌæÌCfbNX
+ *  タイムイベントヒープの最後の使用領域のインデックス
  */
 uint_t  last_index;
 /*
+ *  ^C}W
+[Ìú»
+ *  タイマモジュールの初期化
  */
 void
 …
 /*
  *  ^CCxgÌ}üÊuðãü«ÉTõ
+ *
  *  timeÉ¶·é^CCxgð}ü·ém[hðó¯é½ßÉC
  *  q[vÌãÉü©ÁÄóm[hðÚ®³¹éDÚ®OÌóm[hÌÊuð
  *  indexÉn·ÆCÚ®ãÌóm[hÌÊui·Èí¿}üÊujðÔ·D
+ *  タイムイベントの挿入位置を上向きに探索
+ *
+ *  時刻timeに発生するタイムイベントを挿入するノードを空けるために，
+ *  ヒープの上に向かって空ノードを移動させる．移動前の空ノードの位置を
+ *  indexに渡すと，移動後の空ノードの位置（すなわち挿入位置）を返す．
  */
 #ifdef TOPPERS_tmeup
 …
         while (index > 1) {
                 /*
                  *  em[hÌCxg¶Ìûª¢iÜ½Í¯¶jÈçÎC
                  *  indexª}üÊuÈÌÅ[vð²¯éD
+                 *  親ノードのイベント発生時刻の方が早い（または同じ）ならば，
+                 *  indexが挿入位置なのでループを抜ける．
                  */
                 parent = PARENT(index);
 …
                 /*
                  *  em[hðindexÌÊuÉÚ®³¹éD
+                 *  親ノードをindexの位置に移動させる．
                  */
                 TMEVT_NODE(index) = TMEVT_NODE(parent);
 …
                 /*
                  *  indexðem[hÌÊuÉXVD
+                 *  indexを親ノードの位置に更新．
                  */
                 index = parent;
 …
 /*
  *  ^CCxgÌ}üÊuðºü«ÉTõ
+ *
  *  timeÉ¶·é^CCxgð}ü·ém[hðó¯é½ßÉC
  *  q[vÌºÉü©ÁÄóm[hðÚ®³¹éDÚ®OÌóm[hÌÊuð
  *  indexÉn·ÆCÚ®ãÌóm[hÌÊui·Èí¿}üÊujðÔ·D
+ *  タイムイベントの挿入位置を下向きに探索
+ *
+ *  時刻timeに発生するタイムイベントを挿入するノードを空けるために，
+ *  ヒープの下に向かって空ノードを移動させる．移動前の空ノードの位置を
+ *  indexに渡すと，移動後の空ノードの位置（すなわち挿入位置）を返す．
  */
 #ifdef TOPPERS_tmedown
 …
         while ((child = LCHILD(index)) <= last_index) {
                 /*
                  *  ¶EÌqm[hÌCxg¶ðärµC¢ûÌqm[h
                  *  ÌÊuðchildÉÝè·éDÈºÌqm[hÍC±±ÅIÎê½û
                  *  Ìqm[hÌ±ÆD
+                 *  左右の子ノードのイベント発生時刻を比較し，早い方の子ノード
+                 *  の位置をchildに設定する．以下の子ノードは，ここで選ばれた方
+                 *  の子ノードのこと．
                  */
                 if (child + 1 <= last_index
 …
                 /*
                  *  qm[hÌCxg¶Ìûªx¢iÜ½Í¯¶jÈçÎC
                  *  indexª}üÊuÈÌÅ[vð²¯éD
+                 *  子ノードのイベント発生時刻の方が遅い（または同じ）ならば，
+                 *  indexが挿入位置なのでループを抜ける．
                  */
                 if (EVTTIM_LE(time, TMEVT_NODE(child).time)) {
 …
                 /*
                  *  qm[hðindexÌÊuÉÚ®³¹éD
+                 *  子ノードをindexの位置に移動させる．
                  */
                 TMEVT_NODE(index) = TMEVT_NODE(child);
 …
                 /*
                  *  indexðqm[hÌÊuÉXVD
+                 *  indexを子ノードの位置に更新．
                  */
                 index = child;
 …
 /*
  *  ^CCxgq[vÖÌo^
+ *
  *  p_tmevtbÅwèµ½^CCxgubNðCtimeÅwèµ½Ôªo
  *  ßãÉCxgª¶·éæ¤ÉC^CCxgq[vÉo^·éD
+ *  タイムイベントヒープへの登録
+ *
+ *  p_tmevtbで指定したタイムイベントブロックを，timeで指定した時間が経
+ *  過後にイベントが発生するように，タイムイベントヒープに登録する．
  */
 #ifdef TOPPERS_tmeins
 …
         /*
          *  last_indexðCNgµC»±©çãÉ}üÊuðT·D
+         *  last_indexをインクリメントし，そこから上に挿入位置を探す．
          */
         index = tmevt_up(++last_index, time);
         /*
          *  ^CCxgðindexÌÊuÉ}ü·éD
+         *  タイムイベントをindexの位置に挿入する．
          */
         TMEVT_NODE(index).time = time;
 …
 /*
  *  ^CCxgq[v©çÌí
+ *  タイムイベントヒープからの削除
  */
 #ifdef TOPPERS_tmedel
 …
         /*
          *  íÉæè^CCxgq[vªóÉÈéêÍ½àµÈ¢D
+         *  削除によりタイムイベントヒープが空になる場合は何もしない．
          */
         if (--last_index == 0) {
 …
         /*
          *  íµ½m[hÌÊuÉÅãÌm[hilast_index+1ÌÊuÌm[hj
          *  ð}üµC»êðKØÈÊuÖÚ®³¹éDÀÛÉÍCÅãÌm[h
          *  ðÀÛÉ}ü·éÌÅÍÈCíµ½m[hÌÊuªóm[hÉÈ
          *  éÌÅCÅãÌm[hð}ü·×«ÊuÖü¯Äóm[hðÚ®³¹
          *  éD
          *  ÅãÌm[hÌCxg¶ªCíµ½m[hÌem[hÌC
          *  xg¶æèOÌêÉÍCãÉü©ÁÄ}üÊuðT·D»
          *  ¤ÅÈ¢êÉÍCºÉü©ÁÄT·D
+         *  削除したノードの位置に最後のノード（last_index+1の位置のノード）
+         *  を挿入し，それを適切な位置へ移動させる．実際には，最後のノード
+         *  を実際に挿入するのではなく，削除したノードの位置が空ノードにな
+         *  るので，最後のノードを挿入すべき位置へ向けて空ノードを移動させ
+         *  る．
+         *  最後のノードのイベント発生時刻が，削除したノードの親ノードのイ
+         *  ベント発生時刻より前の場合には，上に向かって挿入位置を探す．そ
+         *  うでない場合には，下に向かって探す．
          */
         if (index > 1 && EVTTIM_LT(event_time,
                                                                 TMEVT_NODE(parent = PARENT(index)).time)) {
                 /*
                  *  em[hðindexÌÊuÉÚ®³¹éD
+                 *  親ノードをindexの位置に移動させる．
                  */
                 TMEVT_NODE(index) = TMEVT_NODE(parent);
 …
                 /*
                  *  íµ½m[hÌem[h©çãÉü©ÁÄ}üÊuðT·D
+                 *  削除したノードの親ノードから上に向かって挿入位置を探す．
                  */
                 index = tmevt_up(parent, event_time);
 …
         else {
                 /*
                  *  íµ½m[h©çºÉü©ÁÄ}üÊuðT·D
+                 *  削除したノードから下に向かって挿入位置を探す．
                  */
                 index = tmevt_down(index, event_time);
 …
         /*
          *  ÅãÌm[hðindexÌÊuÉ}ü·éD
+         *  最後のノードをindexの位置に挿入する．
          */
         TMEVT_NODE(index) = TMEVT_NODE(last_index + 1);
 …
 /*
  *  ^CCxgq[vÌæªÌm[hÌí
+ *  タイムイベントヒープの先頭のノードの削除
  */
 Inline void
 …
         /*
          *  íÉæè^CCxgq[vªóÉÈéêÍ½àµÈ¢D
+         *  削除によりタイムイベントヒープが空になる場合は何もしない．
          */
         if (--last_index == 0) {
 …
         /*
          *  [gm[hÉÅãÌm[hilast_index + 1 ÌÊuÌm[hjð
          *  }üµC»êðKØÈÊuÖÚ®³¹éDÀÛÉÍCÅãÌm[hð
          *  ÀÛÉ}ü·éÌÅÍÈC[gm[hªóm[hÉÈéÌÅCÅ
          *  ãÌm[hð}ü·×«ÊuÖü¯Äóm[hðÚ®³¹éD
+         *  ルートノードに最後のノード（last_index + 1 の位置のノード）を
+         *  挿入し，それを適切な位置へ移動させる．実際には，最後のノードを
+         *  実際に挿入するのではなく，ルートノードが空ノードになるので，最
+         *  後のノードを挿入すべき位置へ向けて空ノードを移動させる．
          */
         index = tmevt_down(1, event_time);
         /*
          *  ÅãÌm[hðindexÌÊuÉ}ü·éD
+         *  最後のノードをindexの位置に挿入する．
          */
         TMEVT_NODE(index) = TMEVT_NODE(last_index + 1);
 …
 /*
  *  ^CCxgÜÅÌcèÔÌvZ
+ *  タイムイベントまでの残り時間の計算
  */
 #ifdef TOPPERS_tmeltim
 …
         if (EVTTIM_LE(time, next_time)) {
                 /*
                  *  Ì^CeBbNÅ³êéêÉÍ0ðÔ·D
+                 *  次のタイムティックで処理される場合には0を返す．
                  */
                 return(0U);
 …
 /*
  *  ^CeBbNÌ
+ *  タイムティックの供給
  */
 #ifdef TOPPERS_sigtim
 …
         /*
          *  current_timeðXV·éD
+         *  current_timeを更新する．
          */
         current_time = next_time;
         /*
          *  next_timeCnext_subtimeðXV·éD
+         *  next_time，next_subtimeを更新する．
          */
 #if TIC_DENO == 1U
 …
         /*
          *  current_timeæèCxg¶Ì¢iÜ½Í¯¶j^CCx
          *  gðC^CCxgq[v©çíµCR[obNÖðÄÑ
          *  o·D
+         *  current_timeよりイベント発生時刻の早い（または同じ）タイムイベ
+         *  ントを，タイムイベントヒープから削除し，コールバック関数を呼び
+         *  出す．
          */
         while (last_index > 0 && EVTTIM_LE(TMEVT_NODE(1).time, current_time)) {
 …
         /*
          *  min_timeðXV·éD
+         *  min_timeを更新する．
          */
         min_time = current_time;

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

Context Navigation

Changeset 167 for UsbWattMeter/trunk/asp_dcre/kernel/time_event.c

Legend:

UsbWattMeter/trunk/asp_dcre/kernel/time_event.c

Download in other formats: