source: asp3_tinet_ecnl_rx/trunk/asp3_dcre/kernel/time_event.h@ 337

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

ASP3版ECNLを追加
  • Property svn:eol-style set to native
  • Property svn:mime-type set to text/x-chdr;charset=UTF-8
File size: 7.5 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-2015 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$
41 */
42
43/*
44 * タイムイベント管理モジュール
45 */
46
47#ifndef TOPPERS_TIME_EVENT_H
48#define TOPPERS_TIME_EVENT_H
49
50#include "kernel_impl.h"
51#include "target_timer.h"
52
53/*
54 * イベント時刻のデータ型の定義［ASPD1001］
55 *
56 * タイムイベントヒープに登録するタイムイベントの発生時刻を表現するた
57 * めのデータ型．オーバヘッド低減のために，32ビットで扱う．
58 */
59typedef uint32_t EVTTIM;
60
61/*
62 * タイムイベントヒープ中のノードのデータ型の前方参照
63 */
64typedef union time_event_node TMEVTN;
65
66/*
67 * タイムイベントブロックのデータ型の定義
68 */
69typedef void (*CBACK)(void *); /* コールバック関数の型 */
70
71typedef struct time_event_block {
72 EVTTIM evttim; /* タイムイベントの発生時刻 */
73 TMEVTN *p_tmevtn; /* タイムイベントヒープ中での位置 */
74 CBACK callback; /* コールバック関数 */
75 void *arg; /* コールバック関数へ渡す引数 */
76} TMEVTB;
77
78/*
79 * タイムイベントヒープ中のノードのデータ型の定義
80 *
81 * タイムイベントヒープの先頭のノード（tmevt_heap[0]）に，最後の使用領
82 * 域を指すポインタ（p_last）を格納し，それ以降をタイムイベントヒープ
83 * として使用する．(tmevt_heap[0].p_last - tmevt_heap) が，タイムイベ
84 * ントヒープに登録されているタイムイベントの数となる．
85 */
86union time_event_node {
87 TMEVTB *p_tmevtb; /* 対応するタイムイベントブロック */
88 TMEVTN *p_last; /* タイムイベントヒープの最後の使用領域 */
89};
90
91/*
92 * タイムイベントヒープ（kernel_cfg.c）
93 */
94extern TMEVTN tmevt_heap[];
95
96/*
97 * 境界イベント時刻［ASPD1008］
98 */
99extern EVTTIM boundary_evttim;
100
101/*
102 * 現在のイベント時刻と境界イベント時刻の差［ASPD1010］
103 */
104#define BOUNDARY_MARGIN (200000000U)
105
106/*
107 * 最後に現在時刻を算出した時点でのイベント時刻［ASPD1012］
108 */
109extern EVTTIM current_evttim;
110
111/*
112 * 最後に現在時刻を算出した時点での高分解能タイマのカウント値［ASPD1012］
113 */
114extern HRTCNT current_hrtcnt;
115
116/*
117 * 最も進んでいた時のイベント時刻［ASPD1041］
118 */
119extern EVTTIM monotonic_evttim;
120
121/*
122 * システム時刻のオフセット［ASPD1043］
123 *
124 * get_timで参照するシステム時刻とmonotonic_evttimの差を保持する．
125 */
126extern SYSTIM systim_offset;
127
128/*
129 * 高分解能タイマ割込みの処理中であることを示すフラグ［ASPD1032］
130 */
131extern bool_t in_signal_time;
132
133/*
134 * タイムイベント管理モジュールの初期化
135 */
136extern void initialize_tmevt(void);
137
138/*
139 * タイムイベントの挿入位置の探索
140 */
141extern TMEVTN *tmevt_up(TMEVTN *p_tmevtn, EVTTIM evttim);
142extern TMEVTN *tmevt_down(TMEVTN *p_tmevtn, EVTTIM evttim);
143
144/*
145 * 現在のイベント時刻の更新
146 *
147 * current_evttimとcurrent_hrtcntを，現在の値に更新する．
148 */
149extern void update_current_evttim(void);
150
151/*
152 * 高分解能タイマ割込みの発生タイミングの設定
153 *
154 * 現在のイベント時刻を取得した後に呼び出すことを想定している．
155 */
156extern void set_hrt_event(void);
157
158/*
159 * タイムイベントの登録
160 *
161 * p_tmevtbで指定したタイムイベントブロックを登録する．タイムイベント
162 * の発生時刻，コールバック関数，コールバック関数へ渡す引数は，
163 * p_tmevtbが指すタイムイベントブロック中に設定しておく．
164 */
165extern void tmevtb_register(TMEVTB *p_tmevtb);
166
167/*
168 * 相対時間指定によるタイムイベントの登録
169 *
170 * timeで指定した相対時間が経過した後にコールバック関数が呼び出される
171 * ように，p_tmevtbで指定したタイムイベントブロックを登録する．コール
172 * バック関数，コールバック関数へ渡す引数は，p_tmevtbが指すタイムイベ
173 * ントブロック中に設定しておく．
174 */
175extern void tmevtb_enqueue(TMEVTB *p_tmevtb, RELTIM time);
176
177/*
178 * タイムイベントの登録解除
179 */
180extern void tmevtb_dequeue(TMEVTB *p_tmevtb);
181
182/*
183 * システム時刻の調整時のエラーチェック
184 *
185 * adjtimで指定された時間の分，システム時刻を調整してよいか判定する．
186 * 調整してはならない場合にtrue，そうでない場合にfalseを返す．現在のイ
187 * ベント時刻を取得した後に呼び出すことを想定している．
188 */
189extern bool_t check_adjtim(int_t adjtim);
190
191/*
192 * タイムイベントが発生するまでの時間の計算
193 */
194extern RELTIM tmevt_lefttim(TMEVTB *p_tmevtb);
195
196/*
197 * 高分解能タイマ割込みの処理
198 */
199extern void signal_time(void);
200
201#endif /* TOPPERS_TIME_EVENT_H */
Note: See TracBrowser for help on using the repository browser.