[117] | 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: task.h 187 2015-06-25 03:39:04Z t_ishikawa $
|
---|
| 57 | */
|
---|
| 58 |
|
---|
| 59 | /*
|
---|
| 60 | * タスク管理機能
|
---|
| 61 | */
|
---|
| 62 |
|
---|
| 63 | #ifndef TOPPERS_TASK_H
|
---|
| 64 | #define TOPPERS_TASK_H
|
---|
| 65 |
|
---|
| 66 | #include "queue.h"
|
---|
| 67 | #include "resource.h"
|
---|
| 68 |
|
---|
| 69 | typedef struct task_control_block TCB;
|
---|
| 70 | #include "osap.h"
|
---|
| 71 | #include "counter.h"
|
---|
| 72 |
|
---|
| 73 | /*
|
---|
| 74 | * イベントマスク値の定義
|
---|
| 75 | */
|
---|
| 76 | #define EVTMASK_NONE ((EventMaskType) 0) /* イベントなし */
|
---|
| 77 |
|
---|
| 78 | /*
|
---|
| 79 | * 優先度の範囲(外部表現)
|
---|
| 80 | */
|
---|
| 81 | #define TMIN_TPRI UINT_C(0) /* タスク優先度の最小値(最低値)*/
|
---|
| 82 | #define TMAX_TPRI UINT_C(15) /* タスク優先度の最大値(最高値)*/
|
---|
| 83 |
|
---|
| 84 | /*
|
---|
| 85 | * 優先度の段階数の定義
|
---|
| 86 | */
|
---|
| 87 | #define TNUM_TPRI ((TMAX_TPRI - TMIN_TPRI) + 1U)
|
---|
| 88 |
|
---|
| 89 | /*
|
---|
| 90 | * 優先度値の定義(内部表現)
|
---|
| 91 | */
|
---|
| 92 | #define TPRI_MINTASK ((PriorityType) (TNUM_TPRI - 1U)) /* 最低タスク優先度 */
|
---|
| 93 | #define TPRI_MAXTASK ((PriorityType) (0)) /* 最高タスク優先度 */
|
---|
| 94 |
|
---|
| 95 | /*
|
---|
| 96 | * タスクIDからTCBを取り出すためのマクロ
|
---|
| 97 | */
|
---|
| 98 | #define get_tcb(tskid) (&(tcb_table[(tskid)]))
|
---|
| 99 |
|
---|
| 100 | /*
|
---|
| 101 | * TCBからタスクIDを取り出すためのマクロ
|
---|
| 102 | * p_tcb がNULLの場合は使えない
|
---|
| 103 | */
|
---|
| 104 | #define TSKID(p_tcb) ((TaskType) ((p_tcb) - tcb_table))
|
---|
| 105 |
|
---|
| 106 | #ifndef OMIT_BITMAP_SEARCH
|
---|
| 107 | #define BITMAP_NUM 15 /* bitmap_search_tableのサイズ */
|
---|
| 108 | #endif /* OMIT_BITMAP_SEARCH */
|
---|
| 109 |
|
---|
| 110 | /*
|
---|
| 111 | * タスク数を保持する変数の宣言(Os_Lcfg.c)
|
---|
| 112 | */
|
---|
| 113 | extern const TaskType tnum_task; /* タスクの数 */
|
---|
| 114 | extern const TaskType tnum_exttask; /* 拡張タスクの数 */
|
---|
| 115 |
|
---|
| 116 |
|
---|
| 117 | /*
|
---|
| 118 | * タスク初期化ブロック
|
---|
| 119 | *
|
---|
| 120 | * タスクに関する情報を,値が変わらないためにROMに置ける部分(タスク
|
---|
| 121 | * 初期化ブロック)と,値が変化するためにRAMに置かなければならない部
|
---|
| 122 | * 分(タスク管理ブロック,TCB)に分離し,TCB内に対応するタスク初期化
|
---|
| 123 | * ブロックを指すポインタを入れる
|
---|
| 124 | * タスク初期化ブロック内に対応するTCBを指すポインタを入れる方法の方が,
|
---|
| 125 | * RAMの節約の観点からは望ましいが,実行効率が悪くなるために採用
|
---|
| 126 | * していない
|
---|
| 127 | * 他のオブジェクトについても同様に扱う
|
---|
| 128 | */
|
---|
| 129 | typedef struct task_initialization_block {
|
---|
| 130 | FunctionRefType task; /* タスクの起動番地 */
|
---|
| 131 |
|
---|
| 132 | #ifdef USE_TSKINICTXB
|
---|
| 133 | TSKINICTXB tskinictxb; /* タスク初期化コンテキストブロック */
|
---|
| 134 | #else /* USE_TSKINICTXB */
|
---|
| 135 | MemorySizeType sstksz; /* システムスタック領域のサイズ(丸めた値) */
|
---|
| 136 | void *sstk; /* システムスタック領域のボトム番地(SC3) */
|
---|
| 137 | MemorySizeType ustksz; /* スタック領域のサイズ(丸めた値) */
|
---|
| 138 | void *ustk; /* スタック領域のボトム番地(SC3) */
|
---|
| 139 | #endif /* USE_TSKINICTXB */
|
---|
| 140 | OSAPCB *p_osapcb; /* 所属するOSアプリケーションの管理ブロック */
|
---|
| 141 | uint32 acsbtmp; /* アクセス許可OSアプリケーション ビットマップ */
|
---|
| 142 | PriorityType inipri; /* 初期優先度 (内部表現)*/
|
---|
| 143 | PriorityType exepri; /* 実行開始時の優先度 (内部表現)*/
|
---|
| 144 | uint8 maxact; /* 多重起動要求の最大数 */
|
---|
| 145 | AppModeType autoact; /* 起動するモード */
|
---|
| 146 | #ifndef OMIT_STKMPUINFOB
|
---|
| 147 | STKMPUINFOB stkmpu; /* スタックのMPU情報 */
|
---|
| 148 | #endif
|
---|
| 149 | } TINIB;
|
---|
| 150 |
|
---|
| 151 | /*
|
---|
| 152 | * タスク管理ブロック(Os_Lcfg.c)
|
---|
| 153 | */
|
---|
| 154 | struct task_control_block {
|
---|
| 155 | QUEUE task_queue; /* タスクキュー(構造体の先頭に入る必要) */
|
---|
| 156 | const TINIB *p_tinib; /* 初期化ブロックへのポインタ */
|
---|
| 157 | PriorityType curpri; /* 現在の優先度(内部表現)*/
|
---|
| 158 | TaskStateType tstat; /* タスク状態(内部表現)*/
|
---|
| 159 | uint8 actcnt; /* 多重起動要求数 */
|
---|
| 160 | EventMaskType curevt; /* イベントの現在値 */
|
---|
| 161 | EventMaskType waievt; /* 待っているイベント */
|
---|
| 162 | RESCB *p_lastrescb; /* 最後に獲得したリソース管理ブロックへのポインタ */
|
---|
| 163 | CNTCB *p_lastcntcb; /* 最後に操作したカウンタ管理ブロックへのポインタ */
|
---|
| 164 | TSKCTXB tskctxb; /* タスクコンテキストブロック */
|
---|
| 165 | #ifdef CFG_USE_PROTECTIONHOOK
|
---|
| 166 | boolean calltfn; /* 信頼関数呼び出し中フラグ */
|
---|
| 167 | #endif /* CFG_USE_PROTECTIONHOOK */
|
---|
| 168 | };
|
---|
| 169 |
|
---|
| 170 | /*
|
---|
| 171 | * 実行状態のタスク
|
---|
| 172 | *
|
---|
| 173 | * 実行状態のタスクがない場合には,NULL にする
|
---|
| 174 | */
|
---|
| 175 | extern TCB *p_runtsk;
|
---|
| 176 |
|
---|
| 177 | /*
|
---|
| 178 | * 最高優先順位タスク
|
---|
| 179 | *
|
---|
| 180 | * タスク実行中は,runtsk と一致する
|
---|
| 181 | * 実行できる状態(実行状態または実行可能状態)のタスクがない場合には,
|
---|
| 182 | * NULL にする
|
---|
| 183 | */
|
---|
| 184 | extern TCB *p_schedtsk;
|
---|
| 185 |
|
---|
| 186 | /*
|
---|
| 187 | * レディキュー中の最高優先度
|
---|
| 188 | *
|
---|
| 189 | * レディキューには実行可能状態のタスクのみを含むので,実行可能状態の
|
---|
| 190 | * タスクの中での最高優先度を保持する
|
---|
| 191 | * レディキューが空の時(実行可能状態のタスクが無い時)は TPRI_MINTASKにする
|
---|
| 192 | */
|
---|
| 193 | extern PriorityType nextpri;
|
---|
| 194 |
|
---|
| 195 | /*
|
---|
| 196 | * レディキュー
|
---|
| 197 | *
|
---|
| 198 | * レディキューは,実行できる状態のタスクを管理するためのキューである
|
---|
| 199 | * レディキューは,優先度ごとのタスクキューで構成されている
|
---|
| 200 | * タスクのTCBは,該当する優先度のキューに登録される
|
---|
| 201 | */
|
---|
| 202 | extern QUEUE ready_queue[TNUM_TPRI];
|
---|
| 203 |
|
---|
| 204 | /*
|
---|
| 205 | * レディキューサーチのためのビットマップ
|
---|
| 206 | *
|
---|
| 207 | * レディキューのサーチを効率よく行うために,優先度ごとのタスクキュー
|
---|
| 208 | * にタスクが入っているかどうかを示すビットマップを用意している
|
---|
| 209 | * ビットマップを使うことで,メモリアクセスの回数を減らすことができるが,
|
---|
| 210 | * ビット操作命令が充実していないプロセッサで,優先度の段階数が少ない
|
---|
| 211 | * 場合には,ビットマップ操作のオーバーヘッドのために,逆に効率が落ち
|
---|
| 212 | * る可能性もある
|
---|
| 213 | *
|
---|
| 214 | * 優先度が16段階であることを仮定しているため,uint16型としている
|
---|
| 215 | */
|
---|
| 216 | extern uint16 ready_primap;
|
---|
| 217 |
|
---|
| 218 | /*
|
---|
| 219 | * タスク初期化ブロックのエリア(kernel_mem.c)
|
---|
| 220 | */
|
---|
| 221 | extern const TINIB tinib_table[];
|
---|
| 222 |
|
---|
| 223 | /*
|
---|
| 224 | * TCBのエリア(Os_Lcfg.c)
|
---|
| 225 | */
|
---|
| 226 | extern TCB tcb_table[];
|
---|
| 227 |
|
---|
| 228 | /*
|
---|
| 229 | * タスク管理モジュールの初期化
|
---|
| 230 | */
|
---|
| 231 | extern void task_initialize(void);
|
---|
| 232 |
|
---|
| 233 | /*
|
---|
| 234 | * タスクの起動
|
---|
| 235 | *
|
---|
| 236 | * 対象タスク(p_tcbで指定したタスク)を起動する
|
---|
| 237 | * (休止状態から実行できる状態に遷移させる)
|
---|
| 238 | * タスクの起動時に必要な初期化を行う
|
---|
| 239 | */
|
---|
| 240 | extern boolean make_active(TCB *p_tcb);
|
---|
| 241 |
|
---|
| 242 | /*
|
---|
| 243 | * 実行できる状態への移行
|
---|
| 244 | *
|
---|
| 245 | * 対象タスク(p_tcbで指定したタスク)を実行できる状態に遷移させる
|
---|
| 246 | * 対象タスクの優先度が,最高優先度タスク(schedtsk)の優先度よりも高
|
---|
| 247 | * い場合には,対象タスクを新しい最高優先度タスクとし,それまでの最高
|
---|
| 248 | * 優先度タスクをレディキューの先頭に入れる
|
---|
| 249 | * そうでない場合には,対象タスクをレディキューの末尾に入れる
|
---|
| 250 | * 対象タスクを最高優先度タスクとした場合に,TRUE を返す
|
---|
| 251 | */
|
---|
| 252 | extern boolean make_runnable(TCB *p_tcb);
|
---|
| 253 |
|
---|
| 254 | /*
|
---|
| 255 | * 実行できる状態から他の状態への遷移
|
---|
| 256 | */
|
---|
| 257 | extern void make_non_runnable(void);
|
---|
| 258 |
|
---|
| 259 | /*
|
---|
| 260 | * 最高優先順位タスクのサーチ
|
---|
| 261 | *
|
---|
| 262 | * レディキュー中の最高優先順位のタスクをサーチする
|
---|
| 263 | * レディキューが空の場合には,この関数を呼び出してはならない
|
---|
| 264 | */
|
---|
| 265 | extern void search_schedtsk(void);
|
---|
| 266 |
|
---|
| 267 | /*
|
---|
| 268 | * タスクのプリエンプト
|
---|
| 269 | *
|
---|
| 270 | * 自タスクを実行可能状態に移行させ,最高優先度タスクを実行状態にする
|
---|
| 271 | * この関数から戻った後に,dispatch を呼び出して他のタスクへ切り替える
|
---|
| 272 | * ことを想定している
|
---|
| 273 | */
|
---|
| 274 | extern void preempt(void);
|
---|
| 275 |
|
---|
| 276 | /*
|
---|
| 277 | * 実行中のタスクをSUSPENDED状態にする
|
---|
| 278 | */
|
---|
| 279 | extern void suspend(void);
|
---|
| 280 |
|
---|
| 281 | /*
|
---|
| 282 | * リソース全解放
|
---|
| 283 | */
|
---|
| 284 | extern void release_taskresources(TCB *p_tcb);
|
---|
| 285 |
|
---|
| 286 | /*
|
---|
| 287 | * カウンタ全初期化
|
---|
| 288 | */
|
---|
| 289 | extern void cancel_taskcounters(TCB *p_tcb);
|
---|
| 290 |
|
---|
| 291 | /*
|
---|
| 292 | * 満了処理専用タスクの起動
|
---|
| 293 | *
|
---|
| 294 | * 条件:OS割込み禁止状態で呼ばれる
|
---|
| 295 | */
|
---|
| 296 | extern StatusType activate_task_action(OSAPCB *p_expire_osapcb, TaskType TaskID);
|
---|
| 297 |
|
---|
| 298 | /*
|
---|
| 299 | * 満了処理専用イベントのセット
|
---|
| 300 | *
|
---|
| 301 | * 条件:OS割込み禁止状態で呼ばれる
|
---|
| 302 | */
|
---|
| 303 | extern StatusType set_event_action(OSAPCB *p_expire_osapcb, TaskType TaskID, EventMaskType Mask);
|
---|
| 304 |
|
---|
| 305 | /*
|
---|
| 306 | * レディキューからタスクを削除する
|
---|
| 307 | */
|
---|
| 308 | extern void remove_task_from_queue(TCB *p_tcb, PriorityType remove_task_pri);
|
---|
| 309 |
|
---|
| 310 | /*
|
---|
| 311 | * レディキューに入っているタスクを休止状態にする
|
---|
| 312 | */
|
---|
| 313 | extern void suspend_ready_task(TCB *p_tcb, PriorityType remove_task_pri);
|
---|
| 314 |
|
---|
| 315 | /*
|
---|
| 316 | * 自タスクの強制終了
|
---|
| 317 | */
|
---|
| 318 | extern void force_terminate_task(TCB *p_tcb, StatusType terminate_cause, boolean term_osap_flag);
|
---|
| 319 |
|
---|
| 320 | /*
|
---|
| 321 | * タスク不正終了時に呼ぶ関数
|
---|
| 322 | */
|
---|
| 323 | extern void exit_task(void);
|
---|
| 324 |
|
---|
| 325 | /*
|
---|
| 326 | * OSAP所属するタスクの強制終了
|
---|
| 327 | */
|
---|
| 328 | extern void force_term_osap_task(OSAPCB *p_osapcb);
|
---|
| 329 |
|
---|
| 330 | #endif /* TOPPERS_TASK_H_ */
|
---|