source: rtos_arduino/trunk/asp_1.9.2/kernel/time_event.h@ 136

Last change on this file since 136 was 136, checked in by ertl-honda, 8 years ago

ライブラリとOS及びベーシックなサンプルの追加．
File size: 7.2 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 * 上記著作権者
12は，以下の(1)～(4)の条件を満たす場合に限り，本ソフトウェ
13 * ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
14 * 変・再é…
15å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
16 * (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
17 * 権表示，この利用条件および下記の無保証規定が，そのままの形でソー
18 * スコード中に含まれていること．
19 * (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
20 * 用できる形で再é…
21å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é…
22å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
23 * 者
24マニュアルなど）に，上記の著作権表示，この利用条件および下記
25 * の無保証規定を掲載すること．
26 * (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
27 * 用できない形で再é…
28å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
29 * と．
30 * (a) 再é…
31å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€…
32マニュアルなど）に，上記の著
33 * 作権表示，この利用条件および下記の無保証規定を掲載すること．
34 * (b) 再é…
35å¸ƒã®å½¢æ…
36‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
37 * 報告すること．
38 * (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
39 * 害からも，上記著作権者
40およびTOPPERSプロジェクトをå…
41è²¬ã™ã‚‹ã“と．
42 * また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
43 * 由に基づく請求からも，上記著作権者
44およびTOPPERSプロジェクトを
45 * å…
46è²¬ã™ã‚‹ã“と．
47 *
48 * 本ソフトウェアは，無保証で提供されているものである．上記著作権者
49お
50 * よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
51 * に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
52 * アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
53 * の責任を負わない．
54 *
55 * $Id: time_event.h 1774 2010-03-19 12:45:46Z ertl-hiro $
56 */
57
58/*
59 * タイムイベント管理モジュール
60 */
61
62#ifndef TOPPERS_TIME_EVENT_H
63#define TOPPERS_TIME_EVENT_H
64
65/*
66 * イベント発生時刻のデータ型の定義
67 *
68 * EVTTIMは，RELTIMとして指定できる範囲よりも広い範囲を表現できる必
69要
70 * がある．μITRON4.0仕様のスタンダードプロファイルでは，RELTIMが16ビッ
71 * ト以上でなければならないため，EVTTIMは17ビット以上であることが必
72要
73 * である．そのため，16ビットになる場合があるuint_tではなく，ulong_tに
74 * 定義している．
75 */
76typedef ulong_t EVTTIM;
77
78/*
79 * タイムイベントブロックのデータ型の定義
80 */
81typedef void (*CBACK)(void *); /* コールバック関数の型 */
82
83typedef struct time_event_block {
84 uint_t index; /* タイムイベントヒープ中での位置 */
85 CBACK callback; /* コールバック関数 */
86 void *arg; /* コールバック関数へ渡す引数 */
87} TMEVTB;
88
89/*
90 * タイムイベントヒープ中のノードのデータ型の定義
91 */
92typedef struct time_event_node {
93 EVTTIM time; /* イベント発生時刻 */
94 TMEVTB *p_tmevtb; /* 対応するタイムイベントブロック */
95} TMEVTN;
96
97/*
98 * タイムイベントヒープ（kernel_cfg.c）
99 */
100extern TMEVTN tmevt_heap[];
101
102/*
103 * 現在のシステム時刻（単位: 1ミリ秒）
104 *
105 * システム起動時に0に初期化され，以降，タイムティックが供給される度に
106 * 単調に増加する．
107 */
108extern EVTTIM current_time;
109
110/*
111 * タイムイベントヒープ中で有効な最小のシステム時刻（単位: 1ミリ秒）
112 */
113extern EVTTIM min_time;
114
115/*
116 * 次のタイムティックのシステム時刻（単位: 1ミリ秒）
117 */
118extern EVTTIM next_time;
119
120/*
121 * システム時刻積算用変数（単位: 1/TIC_DENOミリ秒）
122 *
123 * 次のタイムティックのシステム時刻の下位桁を示す（上位桁はnext_time）．
124 * TIC_DENOが1の時は，下位桁は常に0であるため，この変数は必
125要ない．
126 */
127#if TIC_DENO != 1U
128extern uint_t next_subtime;
129#endif /* TIC_DENO != 1U */
130
131/*
132 * 相対時間の基準時刻（単位: 1ミリ秒）
133 *
134 * 次のタイムティックのシステム時刻を切り上げた時刻．TIC_DENOが1の時
135 * は，next_timeに一致する．
136 */
137#if TIC_DENO == 1U
138#define base_time (next_time)
139#else /* TIC_DENO == 1U */
140#define base_time (next_time + (next_subtime > 0U ? 1U : 0U))
141#endif /* TIC_DENO == 1U */
142
143/*
144 * タイムイベントヒープの最後の使用領域のインデックス
145 *
146 * タイムイベントヒープに登録されているタイムイベントの数に一致する．
147 */
148extern uint_t last_index;
149
150/*
151 * タイムイベント管理モジュールの初期化
152 */
153extern void initialize_tmevt(void);
154
155/*
156 * タイムイベントの挿å…
157¥ä½ç½®ã®æŽ¢ç´¢
158 */
159extern uint_t tmevt_up(uint_t index, EVTTIM time);
160extern uint_t tmevt_down(uint_t index, EVTTIM time);
161
162/*
163 * タイムイベントヒープへの登録と削除
164 */
165extern void tmevtb_insert(TMEVTB *p_tmevtb, EVTTIM time);
166extern void tmevtb_delete(TMEVTB *p_tmevtb);
167
168/*
169 * タイムイベントブロックの登録（相対時間指定）
170 *
171 * timeで指定した相対時間が経過した後に，argを引数としてcallbackが呼
172 * び出されるように，p_tmevtbで指定したタイムイベントブロックを登録す
173 * る．
174 *
175 */
176Inline void
177tmevtb_enqueue(TMEVTB *p_tmevtb, RELTIM time, CBACK callback, void *arg)
178{
179 assert(time <= TMAX_RELTIM);
180
181 p_tmevtb->callback = callback;
182 p_tmevtb->arg = arg;
183 tmevtb_insert(p_tmevtb, base_time + time);
184}
185
186/*
187 * タイムイベントブロックの登録（イベント発生時刻指定）
188 *
189 * timeで指定したイベント発生時刻に，argを引数としてcallbackが呼び出
190 * されるように，p_tmevtbで指定したタイムイベントブロックを登録する．
191 */
192Inline void
193tmevtb_enqueue_evttim(TMEVTB *p_tmevtb, EVTTIM time, CBACK callback, void *arg)
194{
195 p_tmevtb->callback = callback;
196 p_tmevtb->arg = arg;
197 tmevtb_insert(p_tmevtb, time);
198}
199
200/*
201 * タイムイベントブロックの登録解除
202 */
203Inline void
204tmevtb_dequeue(TMEVTB *p_tmevtb)
205{
206 tmevtb_delete(p_tmevtb);
207}
208
209/*
210 * タイムイベントまでの残り時間の計算
211 */
212extern RELTIM tmevt_lefttim(TMEVTB *p_tmevtb);
213
214/*
215 * タイムティックの供給
216 */
217extern void signal_time(void);
218
219#endif /* TOPPERS_TIME_EVENT_H */
Note: See TracBrowser for help on using the repository browser.