source: atk2-sc3_fl850f1l/kernel/counter.h@ 165

Last change on this file since 165 was 117, checked in by ertl-ishikawa, 9 years ago

ATK2-SC3 1.3.2 FL850F1L(RH850F1L)依存部(GCC/GHS/CCRH)を追加

File size: 10.7 KB
Line 
1/*
2 * TOPPERS ATK2
3 * Toyohashi Open Platform for Embedded Real-Time Systems
4 * Automotive Kernel Version 2
5 *
6 * Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
7 * Toyohashi Univ. of Technology, JAPAN
8 * Copyright (C) 2004-2015 by Center for Embedded Computing Systems
9 * Graduate School of Information Science, Nagoya Univ., JAPAN
10 * Copyright (C) 2011-2015 by FUJI SOFT INCORPORATED, JAPAN
11 * Copyright (C) 2011-2013 by Spansion LLC, USA
12 * Copyright (C) 2011-2015 by NEC Communication Systems, Ltd., JAPAN
13 * Copyright (C) 2011-2015 by Panasonic Advanced Technology Development Co., Ltd., JAPAN
14 * Copyright (C) 2011-2014 by Renesas Electronics Corporation, JAPAN
15 * Copyright (C) 2011-2015 by Sunny Giken Inc., JAPAN
16 * Copyright (C) 2011-2015 by TOSHIBA CORPORATION, JAPAN
17 * Copyright (C) 2004-2015 by Witz Corporation
18 * Copyright (C) 2014-2015 by AISIN COMCRUISE Co., Ltd., JAPAN
19 * Copyright (C) 2014-2015 by eSOL Co.,Ltd., JAPAN
20 * Copyright (C) 2014-2015 by SCSK Corporation, JAPAN
21 *
22 * 上記著作権者は,以下の(1)〜(4)の条件を満たす場合に限り,本ソフトウェ
23 * ア(本ソフトウェアを改変したものを含む.以下同じ)を使用・複製・改
24 * 変・再配布(以下,利用と呼ぶ)することを無償で許諾する.
25 * (1) 本ソフトウェアをソースコードの形で利用する場合には,上記の著作
26 * 権表示,この利用条件および下記の無保証規定が,そのままの形でソー
27 * スコード中に含まれていること.
28 * (2) 本ソフトウェアを,ライブラリ形式など,他のソフトウェア開発に使
29 * 用できる形で再配布する場合には,再配布に伴うドキュメント(利用
30 * 者マニュアルなど)に,上記の著作権表示,この利用条件および下記
31 * の無保証規定を掲載すること.
32 * (3) 本ソフトウェアを,機器に組み込むなど,他のソフトウェア開発に使
33 * 用できない形で再配布する場合には,次のいずれかの条件を満たすこ
34 * と.
35 * (a) 再配布に伴うドキュメント(利用者マニュアルなど)に,上記の著
36 * 作権表示,この利用条件および下記の無保証規定を掲載すること.
37 * (b) 再配布の形態を,別に定める方法によって,TOPPERSプロジェクトに
38 * 報告すること.
39 * (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
40 * 害からも,上記著作権者およびTOPPERSプロジェクトを免責すること.
41 * また,本ソフトウェアのユーザまたはエンドユーザからのいかなる理
42 * 由に基づく請求からも,上記著作権者およびTOPPERSプロジェクトを
43 * 免責すること.
44 *
45 * 本ソフトウェアは,AUTOSAR(AUTomotive Open System ARchitecture)仕
46 * 様に基づいている.上記の許諾は,AUTOSARの知的財産権を許諾するもので
47 * はない.AUTOSARは,AUTOSAR仕様に基づいたソフトウェアを商用目的で利
48 * 用する者に対して,AUTOSARパートナーになることを求めている.
49 *
50 * 本ソフトウェアは,無保証で提供されているものである.上記著作権者お
51 * よびTOPPERSプロジェクトは,本ソフトウェアに関して,特定の使用目的
52 * に対する適合性も含めて,いかなる保証も行わない.また,本ソフトウェ
53 * アの利用により直接的または間接的に生じたいかなる損害に関しても,そ
54 * の責任を負わない.
55 *
56 * $Id: counter.h 187 2015-06-25 03:39:04Z t_ishikawa $
57 */
58
59/*
60 * カウンタ機能
61 */
62
63#ifndef TOPPERS_COUNTER_H
64#define TOPPERS_COUNTER_H
65
66#include "queue.h"
67
68/*
69 * カウンタ状態の定義
70 * IncrementCounterのネスト防止策
71 */
72#define CS_NULL (FALSE) /* 非操作中 */
73#define CS_DOING (TRUE) /* 操作中 */
74
75/*
76 * カウンタIDからカウンタ管理ブロックを取り出すためのマクロ
77 */
78#define get_cntcb(cntid) (&(cntcb_table[(cntid)]))
79
80/*
81 * カウンタIDでハードウェアカウンタかチェック用マクロ
82 */
83#define is_hwcnt(cntid) ((cntid) < tnum_hardcounter)
84
85/*
86 * CNTCBからカウンタIDを取り出すためのマクロ
87 */
88#define CNTID(p_cntcb) ((CounterType) ((p_cntcb) - cntcb_table))
89
90/*
91 * 満了アクションの属性
92 */
93#define ACTIVATETASK UINT_C(0x01) /* タスク起動 */
94#define SETEVENT UINT_C(0x02) /* イベントセット */
95#define CALLBACK UINT_C(0x04) /* コールバック */
96#define INCREMENTCOUNTER UINT_C(0x08) /* カウンタインクリメント */
97
98/*
99 * 自動起動の属性
100 */
101#define ABSOLUTE UINT_C(0x10) /* 絶対値起動 */
102#define RELATIVE UINT_C(0x20) /* 相対値起動 */
103
104/*
105 * 各ハードウェアカウンタ処理関数型
106 */
107typedef void (*HardwareCounterInitRefType)(TickType maxval, TimeType nspertick); /* 初期化関数型 */
108typedef void (*HardwareCounterStartRefType)(void); /* 開始関数型 */
109typedef void (*HardwareCounterStopRefType)(void); /* 停止関数型 */
110typedef void (*HardwareCounterSetRefType)(TickType exprtick); /* 時間設定関数型 */
111typedef TickType (*HardwareCounterGetRefType)(void); /* 時間取得関数型 */
112typedef void (*HardwareCounterCancelRefType)(void); /* 設定時間取消関数型 */
113typedef void (*HardwareCounterTriggerRefType)(void); /* 強制割込み要求関数型 */
114typedef void (*HardwareCounterIntClearRefType)(void); /* 割込み要求クリア関数型 */
115typedef void (*HardwareCounterIntCancelRefType)(void); /* 割込み要求取消関数型 */
116typedef void (*HardwareCounterIncrementRefType)(void); /* インクリメント関数型 */
117
118/*
119 * ハードウェアカウンタ処理関数型
120 */
121typedef struct hardware_counter_initialization_block {
122 HardwareCounterInitRefType init; /* 初期化関数ポインタ */
123 HardwareCounterStartRefType start; /* 開始関数ポインタ */
124 HardwareCounterStopRefType stop; /* 停止関数ポインタ */
125 HardwareCounterSetRefType set; /* 時間設定関数ポインタ */
126 HardwareCounterGetRefType get; /* 時間取得関数ポインタ*/
127 HardwareCounterCancelRefType cancel; /* 時間取消関数ポインタ */
128 HardwareCounterTriggerRefType trigger; /* 強制割込み要求関数ポインタ */
129 HardwareCounterIntClearRefType intclear; /* 割込み要求クリア関数型 */
130 HardwareCounterIntCancelRefType intcancel; /* 割込み要求取消関数型 */
131 HardwareCounterIncrementRefType increment; /* インクリメント関数ポインタ */
132 TimeType nspertick; /* ハードウェアカウンタでの1ティックの重み(ns単位) */
133} HWCNTINIB;
134
135/*
136 * カウンタ初期化ブロック
137 */
138typedef struct counter_initialization_block {
139 TickType maxval; /* カウンタの最大値 */
140 TickType maxval2; /* カウンタの最大値の2倍+1 */
141 TickType tickbase; /* OS内部では使用せず,ユーザが自由に使用する値 */
142 TickType mincyc; /* 周期の最小値 */
143 OSAPCB *p_osapcb; /* 所属するOSアプリケーションの管理ブロック */
144 uint32 acsbtmp; /* アクセス許可OSアプリケーション ビットマップ */
145} CNTINIB;
146
147/*
148 * カウンタ管理ブロック
149 */
150typedef struct counter_control_block {
151 QUEUE cntexpque; /* カウンタ満了キュー */
152 const CNTINIB *p_cntinib; /* カウンタ初期化ブロックポインタ */
153 TickType curval; /* カウンタの現在ティック */
154 struct counter_control_block *p_prevcntcb; /* 前に獲得したカウンタ管理ブロックへのポインタ */
155 boolean cstat; /* カウンタ操作中フラグ */
156 boolean hwset; /* ハードウェアカウンタセットフラグ */
157} CNTCB;
158
159/*
160 * カウンタ満了情報
161 */
162typedef struct counter_expire_info CNTEXPINFO;
163
164/*
165 * 満了処理関数型
166 */
167typedef void (*EXPFP)(CNTEXPINFO *p_cntexpinfo, const CNTCB *p_cntcb);
168
169/*
170 * カウンタ満了情報
171 */
172struct counter_expire_info {
173 QUEUE cntexpque; /* カウンタ満了キュー(構造体の先頭に入る必要) */
174 TickType expiretick; /* 満了するカウンタ上のティック値 */
175 EXPFP expirefunc; /* 満了処理関数ポインタ */
176};
177
178
179/*
180 * ハードウェアカウンタ数を保持する変数の宣言(Os_Lcfg.c)
181 */
182extern const CounterType tnum_hardcounter;
183
184/*
185 * カウンタ数を保持する変数の宣言(Os_Lcfg.c)
186 */
187extern const CounterType tnum_counter;
188
189/*
190 * カウンタ初期化ブロックのエリア(Os_Lcfg.c)
191 */
192extern const CNTINIB cntinib_table[];
193
194/*
195 * カウンタ管理ブロックのエリア(Os_Lcfg.c)
196 */
197extern CNTCB cntcb_table[];
198
199/*
200 * ハードウェアカウンタ処理関数テーブル(Os_Lcfg.c)
201 */
202extern const HWCNTINIB hwcntinib_table[];
203
204/*
205 * ティック値の加算
206 */
207LOCAL_INLINE TickType
208add_tick(TickType val, TickType incr, TickType maxval2)
209{
210 TickType result;
211 /*
212 * 素直な条件式は val + incr <= maxval2 であるが,この条件式で
213 * は,val + incr が TickType で表せる範囲を超える場合に正しく
214 * 判定できなくなるため,次の条件式としている
215 */
216 if (incr <= (maxval2 - val)) {
217 result = val + incr;
218 }
219 else {
220 /*
221 * 下の計算式で,val + incr と maxval2 + 1 が TickType で表
222 * せる範囲を超える場合があるが,オーバフローしても求まる値は
223 * 正しいため差し支えない
224 */
225 result = (val + incr) - (maxval2 + 1U);
226 }
227 return(result);
228}
229
230/*
231 * ティック値の差
232 */
233LOCAL_INLINE TickType
234diff_tick(TickType val1, TickType val2, TickType maxval2)
235{
236 TickType result;
237
238 if (val1 >= val2) {
239 result = val1 - val2;
240 }
241 else {
242 /*
243 * 下の計算式で,val1 - val2 と maxval2 + 1 が TickType で表せ
244 * る範囲を超える場合があるが,オーバフローしても求まる値は正
245 * しいため差し支えない
246 */
247 result = (val1 - val2) + (maxval2 + 1U);
248 }
249 return(result);
250}
251
252/*
253 * カウンタの現在値取得
254 * ソフトウェアカウンタの場合, CNTCBのcurvalデータを返す
255 * ハードウェアカウンタの場合, 最新の現在時間を返す
256 */
257LOCAL_INLINE TickType
258get_curval(const CNTCB *p_cntcb, CounterType cntid)
259{
260 TickType curval;
261
262 /* カウンタ値の取得 */
263 if (is_hwcnt(cntid)) {
264 curval = (hwcntinib_table[cntid].get)();
265 }
266 else {
267 curval = p_cntcb->curval;
268 }
269
270 return(curval);
271}
272
273/*
274 * 指定した相対時間からのカウンタ値取得(APIからの取得)
275 */
276extern TickType get_reltick(const CNTCB *p_cntcb, TickType relval);
277
278/*
279 * 指定した絶対時間からのカウンタ値取得(APIからの取得)
280 */
281extern TickType get_abstick(const CNTCB *p_cntcb, TickType absval);
282
283/*
284 * カウンタ機能の初期化
285 */
286extern void counter_initialize(void);
287
288/*
289 * カウンタ機能の終了処理
290 */
291extern void counter_terminate(void);
292
293/*
294 * カウンタ満了キューへの挿入
295 */
296extern void insert_cnt_expr_que(CNTEXPINFO *p_cntexpinfo, CNTCB *p_cntcb);
297
298/*
299 * カウンタ満了キューから削除
300 */
301extern void delete_cnt_expr_que(CNTEXPINFO *p_cntexpinfo, CNTCB *p_cntcb);
302
303/*
304 * カウンタの満了処理
305 */
306extern void expire_process(CNTCB *p_cntcb, CounterType cntid);
307
308/*
309 * ハードウェアカウンタ満了処理
310 */
311extern void notify_hardware_counter(CounterType cntid);
312
313/*
314 * カウンタのインクリメント
315 *
316 * 条件:割込み禁止状態で呼ばれる
317 */
318extern StatusType incr_counter_process(CNTCB *p_cntcb, CounterType CounterID);
319
320/*
321 * アラーム満了によるカウンタのインクリメント
322 *
323 * 条件:割込み禁止状態で呼ばれる
324 */
325extern StatusType incr_counter_action(OSAPCB *p_expire_osapcb, CounterType CounterID);
326
327/*
328 * OSAP所属するカウンタの強制終了
329 */
330extern void force_term_osap_counter(OSAPCB *p_osapcb);
331
332#endif /* TOPPERS_COUNTER_H */
Note: See TracBrowser for help on using the repository browser.