source: UsbWattMeter/trunk/asp_dcre/kernel/time_event.h@ 167

Last change on this file since 167 was 167, checked in by coas-nagasima, 8 years ago

MIMEにSJISを設定
  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
  • Property svn:mime-type set to text/x-chdr; charset=SHIFT_JIS
File size: 5.7 KB
Line 
1/*
2 * TOPPERS/ASP Kernel
3 * Toyohashi Open Platform for Embedded Real-Time Systems/
4 * Advanced Standard Profile Kernel
5 *
6 * Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
7 * Toyohashi Univ. of Technology, JAPAN
8 * Copyright (C) 2005-2010 by Embedded and Real-Time Systems Laboratory
9 * Graduate School of Information Science, Nagoya Univ., JAPAN
10 *
11 * 上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
12 * ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
13 * 変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
14 * (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
15 * 権表示，この利用条件および下記の無保証規定が，そのままの形でソー
16 * スコード中に含まれていること．
17 * (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
18 * 用できる形で再配布する場合には，再配布に伴うドキュメント（利用
19 * 者マニュアルなど）に，上記の著作権表示，この利用条件および下記
20 * の無保証規定を掲載すること．
21 * (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
22 * 用できない形で再配布する場合には，次のいずれかの条件を満たすこ
23 * と．
24 * (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
25 * 作権表示，この利用条件および下記の無保証規定を掲載すること．
26 * (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
27 * 報告すること．
28 * (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
29 * 害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
30 * また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
31 * 由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
32 * 免責すること．
33 *
34 * 本ソフトウェアは，無保証で提供されているものである．上記著作権者お
35 * よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
36 * に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
37 * アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
38 * の責任を負わない．
39 *
40 * $Id: time_event.h 167 2016-03-08 11:37:45Z coas-nagasima $
41 */
42
43/*
44 * タイムイベント管理モジュール
45 */
46
47#ifndef TOPPERS_TIME_EVENT_H
48#define TOPPERS_TIME_EVENT_H
49
50/*
51 * イベント発生時刻のデータ型の定義
52 *
53 * EVTTIMは，RELTIMとして指定できる範囲よりも広い範囲を表現できる必要
54 * がある．μITRON4.0仕様のスタンダードプロファイルでは，RELTIMが16ビッ
55 * ト以上でなければならないため，EVTTIMは17ビット以上であることが必要
56 * である．そのため，16ビットになる場合があるuint_tではなく，ulong_tに
57 * 定義している．
58 */
59typedef ulong_t EVTTIM;
60
61/*
62 * タイムイベントブロックのデータ型の定義
63 */
64typedef void (*CBACK)(void *); /* コールバック関数の型 */
65
66typedef struct time_event_block {
67 uint_t index; /* タイムイベントヒープ中での位置 */
68 CBACK callback; /* コールバック関数 */
69 void *arg; /* コールバック関数へ渡す引数 */
70} TMEVTB;
71
72/*
73 * タイムイベントヒープ中のノードのデータ型の定義
74 */
75typedef struct time_event_node {
76 EVTTIM time; /* イベント発生時刻 */
77 TMEVTB *p_tmevtb; /* 対応するタイムイベントブロック */
78} TMEVTN;
79
80/*
81 * タイムイベントヒープ（kernel_cfg.c）
82 */
83extern TMEVTN tmevt_heap[];
84
85/*
86 * 現在のシステム時刻（単位: 1ミリ秒）
87 *
88 * システム起動時に0に初期化され，以降，タイムティックが供給される度に
89 * 単調に増加する．
90 */
91extern EVTTIM current_time;
92
93/*
94 * タイムイベントヒープ中で有効な最小のシステム時刻（単位: 1ミリ秒）
95 */
96extern EVTTIM min_time;
97
98/*
99 * 次のタイムティックのシステム時刻（単位: 1ミリ秒）
100 */
101extern EVTTIM next_time;
102
103/*
104 * システム時刻積算用変数（単位: 1/TIC_DENOミリ秒）
105 *
106 * 次のタイムティックのシステム時刻の下位桁を示す（上位桁はnext_time）．
107 * TIC_DENOが1の時は，下位桁は常に0であるため，この変数は必要ない．
108 */
109#if TIC_DENO != 1U
110extern uint_t next_subtime;
111#endif /* TIC_DENO != 1U */
112
113/*
114 * 相対時間の基準時刻（単位: 1ミリ秒）
115 *
116 * 次のタイムティックのシステム時刻を切り上げた時刻．TIC_DENOが1の時
117 * は，next_timeに一致する．
118 */
119#if TIC_DENO == 1U
120#define base_time (next_time)
121#else /* TIC_DENO == 1U */
122#define base_time (next_time + (next_subtime > 0U ? 1U : 0U))
123#endif /* TIC_DENO == 1U */
124
125/*
126 * タイムイベントヒープの最後の使用領域のインデックス
127 *
128 * タイムイベントヒープに登録されているタイムイベントの数に一致する．
129 */
130extern uint_t last_index;
131
132/*
133 * タイムイベント管理モジュールの初期化
134 */
135extern void initialize_tmevt(void);
136
137/*
138 * タイムイベントの挿入位置の探索
139 */
140extern uint_t tmevt_up(uint_t index, EVTTIM time);
141extern uint_t tmevt_down(uint_t index, EVTTIM time);
142
143/*
144 * タイムイベントヒープへの登録と削除
145 */
146extern void tmevtb_insert(TMEVTB *p_tmevtb, EVTTIM time);
147extern void tmevtb_delete(TMEVTB *p_tmevtb);
148
149/*
150 * タイムイベントブロックの登録（相対時間指定）
151 *
152 * timeで指定した相対時間が経過した後に，argを引数としてcallbackが呼
153 * び出されるように，p_tmevtbで指定したタイムイベントブロックを登録す
154 * る．
155 *
156 */
157Inline void
158tmevtb_enqueue(TMEVTB *p_tmevtb, RELTIM time, CBACK callback, void *arg)
159{
160 assert(time <= TMAX_RELTIM);
161
162 p_tmevtb->callback = callback;
163 p_tmevtb->arg = arg;
164 tmevtb_insert(p_tmevtb, base_time + time);
165}
166
167/*
168 * タイムイベントブロックの登録（イベント発生時刻指定）
169 *
170 * timeで指定したイベント発生時刻に，argを引数としてcallbackが呼び出
171 * されるように，p_tmevtbで指定したタイムイベントブロックを登録する．
172 */
173Inline void
174tmevtb_enqueue_evttim(TMEVTB *p_tmevtb, EVTTIM time, CBACK callback, void *arg)
175{
176 p_tmevtb->callback = callback;
177 p_tmevtb->arg = arg;
178 tmevtb_insert(p_tmevtb, time);
179}
180
181/*
182 * タイムイベントブロックの登録解除
183 */
184Inline void
185tmevtb_dequeue(TMEVTB *p_tmevtb)
186{
187 tmevtb_delete(p_tmevtb);
188}
189
190/*
191 * タイムイベントまでの残り時間の計算
192 */
193extern RELTIM tmevt_lefttim(TMEVTB *p_tmevtb);
194
195/*
196 * タイムティックの供給
197 */
198extern void signal_time(void);
199
200#endif /* TOPPERS_TIME_EVENT_H */
Note: See TracBrowser for help on using the repository browser.