[270] | 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
|
---|
[429] | 8 | * Copyright (C) 2004-2019 by Embedded and Real-Time Systems Laboratory
|
---|
[270] | 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 | * TOPPERS/ASPカーネル 標準ヘッダファイル
|
---|
| 45 | *
|
---|
| 46 | * TOPPERS/ASPカーネルがサポートするサービスコールの宣言と,必要なデー
|
---|
| 47 | * タ型,定数,マクロの定義を含むヘッダファイル.
|
---|
| 48 | *
|
---|
| 49 | * アセンブリ言語のソースファイルからこのファイルをインクルードする時
|
---|
| 50 | * は,TOPPERS_MACRO_ONLYを定義しておく.これにより,マクロ定義以外を
|
---|
| 51 | * 除くようになっている.
|
---|
| 52 | */
|
---|
| 53 |
|
---|
| 54 | #ifndef TOPPERS_KERNEL_H
|
---|
| 55 | #define TOPPERS_KERNEL_H
|
---|
| 56 |
|
---|
| 57 | #ifdef __cplusplus
|
---|
| 58 | extern "C" {
|
---|
| 59 | #endif
|
---|
| 60 |
|
---|
| 61 | /*
|
---|
| 62 | * TOPPERS共通のデータ型・定数・マクロ
|
---|
| 63 | */
|
---|
| 64 | #include <t_stddef.h>
|
---|
| 65 |
|
---|
| 66 | /*
|
---|
| 67 | * ターゲット依存部
|
---|
| 68 | */
|
---|
| 69 | #include "target_kernel.h"
|
---|
| 70 |
|
---|
| 71 | /*
|
---|
| 72 | * サポートする機能
|
---|
| 73 | */
|
---|
| 74 | #ifdef TOPPERS_TARGET_SUPPORT_DIS_INT
|
---|
| 75 | #define TOPPERS_SUPPORT_DIS_INT /* dis_intがサポートされている */
|
---|
| 76 | #endif /* TOPPERS_TARGET_SUPPORT_DIS_INT */
|
---|
| 77 |
|
---|
| 78 | #ifdef TOPPERS_TARGET_SUPPORT_ENA_INT
|
---|
| 79 | #define TOPPERS_SUPPORT_ENA_INT /* ena_intがサポートされている */
|
---|
| 80 | #endif /* TOPPERS_TARGET_SUPPORT_ENA_INT */
|
---|
| 81 |
|
---|
[429] | 82 | #ifdef TOPPERS_TARGET_SUPPORT_CLR_INT
|
---|
| 83 | #define TOPPERS_SUPPORT_CLR_INT /* clr_intがサポートされている */
|
---|
| 84 | #endif /* TOPPERS_TARGET_SUPPORT_CLR_INT */
|
---|
| 85 |
|
---|
| 86 | #ifdef TOPPERS_TARGET_SUPPORT_RAS_INT
|
---|
| 87 | #define TOPPERS_SUPPORT_RAS_INT /* ras_intがサポートされている */
|
---|
| 88 | #endif /* TOPPERS_TARGET_SUPPORT_RAS_INT */
|
---|
| 89 |
|
---|
| 90 | #ifdef TOPPERS_TARGET_SUPPORT_PRB_INT
|
---|
| 91 | #define TOPPERS_SUPPORT_PRB_INT /* prb_intがサポートされている */
|
---|
| 92 | #endif /* TOPPERS_TARGET_SUPPORT_PRB_INT */
|
---|
| 93 |
|
---|
[270] | 94 | #define TOPPERS_SUPPORT_DYNAMIC_CRE /* 動的生成機能拡張 */
|
---|
| 95 |
|
---|
| 96 | #ifndef TOPPERS_MACRO_ONLY
|
---|
| 97 |
|
---|
| 98 | /*
|
---|
| 99 | * データ型の定義
|
---|
| 100 | */
|
---|
| 101 |
|
---|
| 102 | /*
|
---|
| 103 | * ビットパターンやオブジェクト番号の型定義
|
---|
| 104 | */
|
---|
| 105 | typedef uint_t FLGPTN; /* イベントフラグのビットパターン */
|
---|
| 106 | typedef uint_t INTNO; /* 割込み番号 */
|
---|
| 107 | typedef uint_t INHNO; /* 割込みハンドラ番号 */
|
---|
| 108 | typedef uint_t EXCNO; /* CPU例外ハンドラ番号 */
|
---|
| 109 |
|
---|
| 110 | /*
|
---|
| 111 | * 処理単位の型定義
|
---|
| 112 | */
|
---|
| 113 | typedef void (*TASK)(intptr_t exinf);
|
---|
| 114 | typedef void (*TMEHDR)(intptr_t exinf);
|
---|
| 115 | typedef void (*ISR)(intptr_t exinf);
|
---|
| 116 | typedef void (*INTHDR)(void);
|
---|
| 117 | typedef void (*EXCHDR)(void *p_excinf);
|
---|
| 118 | typedef void (*INIRTN)(intptr_t exinf);
|
---|
| 119 | typedef void (*TERRTN)(intptr_t exinf);
|
---|
| 120 |
|
---|
| 121 | /*
|
---|
| 122 | * メモリ領域確保のための型定義
|
---|
| 123 | */
|
---|
| 124 | #ifndef TOPPERS_STK_T
|
---|
| 125 | #define TOPPERS_STK_T intptr_t
|
---|
| 126 | #endif /* TOPPERS_STK_T */
|
---|
| 127 | typedef TOPPERS_STK_T STK_T; /* スタック領域を確保するための型 */
|
---|
| 128 |
|
---|
| 129 | #ifndef TOPPERS_MPF_T
|
---|
| 130 | #define TOPPERS_MPF_T intptr_t
|
---|
| 131 | #endif /* TOPPERS_MPF_T */
|
---|
| 132 | typedef TOPPERS_MPF_T MPF_T; /* 固定長メモリプール領域を確保するための型 */
|
---|
| 133 |
|
---|
| 134 | /*
|
---|
| 135 | * タイムイベントの通知方法のパケット形式の定義
|
---|
| 136 | */
|
---|
| 137 | typedef struct {
|
---|
| 138 | intptr_t exinf; /* タイムイベントハンドラの拡張情報 */
|
---|
| 139 | TMEHDR tmehdr; /* タイムイベントハンドラの先頭番地 */
|
---|
| 140 | } T_NFY_HDR;
|
---|
| 141 |
|
---|
| 142 | typedef struct {
|
---|
| 143 | intptr_t *p_var; /* 変数の番地 */
|
---|
| 144 | intptr_t value; /* 設定する値 */
|
---|
| 145 | } T_NFY_VAR;
|
---|
| 146 |
|
---|
| 147 | typedef struct {
|
---|
| 148 | intptr_t *p_var; /* 変数の番地 */
|
---|
| 149 | } T_NFY_IVAR;
|
---|
| 150 |
|
---|
| 151 | typedef struct {
|
---|
| 152 | ID tskid; /* タスクID */
|
---|
| 153 | } T_NFY_TSK;
|
---|
| 154 |
|
---|
| 155 | typedef struct {
|
---|
| 156 | ID semid; /* セマフォID */
|
---|
| 157 | } T_NFY_SEM;
|
---|
| 158 |
|
---|
| 159 | typedef struct {
|
---|
| 160 | ID flgid; /* イベントフラグID */
|
---|
| 161 | FLGPTN flgptn; /* セットするビットパターン */
|
---|
| 162 | } T_NFY_FLG;
|
---|
| 163 |
|
---|
| 164 | typedef struct {
|
---|
| 165 | ID dtqid; /* データキューID */
|
---|
| 166 | intptr_t data; /* 送信する値 */
|
---|
| 167 | } T_NFY_DTQ;
|
---|
| 168 |
|
---|
| 169 | typedef struct {
|
---|
| 170 | intptr_t *p_var; /* 変数の番地 */
|
---|
| 171 | } T_ENFY_VAR;
|
---|
| 172 |
|
---|
| 173 | typedef struct {
|
---|
| 174 | ID dtqid; /* データキューID */
|
---|
| 175 | } T_ENFY_DTQ;
|
---|
| 176 |
|
---|
| 177 | typedef struct {
|
---|
| 178 | MODE nfymode; /* 通知処理モード */
|
---|
| 179 | union { /* タイムイベントの通知に関する付随情報 */
|
---|
| 180 | T_NFY_HDR handler;
|
---|
| 181 | T_NFY_VAR setvar;
|
---|
| 182 | T_NFY_IVAR incvar;
|
---|
| 183 | T_NFY_TSK acttsk;
|
---|
| 184 | T_NFY_TSK wuptsk;
|
---|
| 185 | T_NFY_SEM sigsem;
|
---|
| 186 | T_NFY_FLG setflg;
|
---|
| 187 | T_NFY_DTQ snddtq;
|
---|
| 188 | } nfy;
|
---|
| 189 | union { /* エラーの通知に関する付随情報 */
|
---|
| 190 | T_ENFY_VAR setvar;
|
---|
| 191 | T_NFY_IVAR incvar;
|
---|
| 192 | T_NFY_TSK acttsk;
|
---|
| 193 | T_NFY_TSK wuptsk;
|
---|
| 194 | T_NFY_SEM sigsem;
|
---|
| 195 | T_NFY_FLG setflg;
|
---|
| 196 | T_ENFY_DTQ snddtq;
|
---|
| 197 | } enfy;
|
---|
| 198 | } T_NFYINFO;
|
---|
| 199 |
|
---|
| 200 | /*
|
---|
| 201 | * パケット形式の定義
|
---|
| 202 | */
|
---|
| 203 | typedef struct t_ctsk {
|
---|
| 204 | ATR tskatr; /* タスク属性 */
|
---|
| 205 | intptr_t exinf; /* タスクの拡張情報 */
|
---|
| 206 | TASK task; /* タスクのメインルーチンの先頭番地 */
|
---|
| 207 | PRI itskpri; /* タスクの起動時優先度 */
|
---|
| 208 | size_t stksz; /* タスクのスタック領域のサイズ */
|
---|
[429] | 209 | STK_T *stk; /* タスクのスタック領域の先頭番地 */
|
---|
[270] | 210 | } T_CTSK;
|
---|
| 211 |
|
---|
| 212 | typedef struct t_rtsk {
|
---|
| 213 | STAT tskstat; /* タスク状態 */
|
---|
| 214 | PRI tskpri; /* タスクの現在優先度 */
|
---|
| 215 | PRI tskbpri; /* タスクのベース優先度 */
|
---|
| 216 | STAT tskwait; /* 待ち要因 */
|
---|
| 217 | ID wobjid; /* 待ち対象のオブジェクトのID */
|
---|
| 218 | TMO lefttmo; /* タイムアウトするまでの時間 */
|
---|
| 219 | uint_t actcnt; /* 起動要求キューイング数 */
|
---|
| 220 | uint_t wupcnt; /* 起床要求キューイング数 */
|
---|
| 221 | bool_t raster; /* タスク終了要求状態 */
|
---|
| 222 | bool_t dister; /* タスク終了禁止状態 */
|
---|
| 223 | } T_RTSK;
|
---|
| 224 |
|
---|
| 225 | typedef struct t_csem {
|
---|
| 226 | ATR sematr; /* セマフォ属性 */
|
---|
| 227 | uint_t isemcnt; /* セマフォの初期資源数 */
|
---|
| 228 | uint_t maxsem; /* セマフォの最大資源数 */
|
---|
| 229 | } T_CSEM;
|
---|
| 230 |
|
---|
| 231 | typedef struct t_rsem {
|
---|
| 232 | ID wtskid; /* セマフォの待ち行列の先頭のタスクのID番号 */
|
---|
| 233 | uint_t semcnt; /* セマフォの現在の資源数 */
|
---|
| 234 | } T_RSEM;
|
---|
| 235 |
|
---|
| 236 | typedef struct t_cflg {
|
---|
| 237 | ATR flgatr; /* イベントフラグ属性 */
|
---|
| 238 | FLGPTN iflgptn; /* イベントフラグの初期ビットパターン */
|
---|
| 239 | } T_CFLG;
|
---|
| 240 |
|
---|
| 241 | typedef struct t_rflg {
|
---|
| 242 | ID wtskid; /* イベントフラグの待ち行列の先頭のタスクのID番号 */
|
---|
| 243 | FLGPTN flgptn; /* イベントフラグの現在のビットパターン */
|
---|
| 244 | } T_RFLG;
|
---|
| 245 |
|
---|
| 246 | typedef struct t_cdtq {
|
---|
| 247 | ATR dtqatr; /* データキュー属性 */
|
---|
| 248 | uint_t dtqcnt; /* データキュー管理領域に格納できるデータ数 */
|
---|
[429] | 249 | void *dtqmb; /* データキュー管理領域の先頭番地 */
|
---|
[270] | 250 | } T_CDTQ;
|
---|
| 251 |
|
---|
| 252 | typedef struct t_rdtq {
|
---|
| 253 | ID stskid; /* データキューの送信待ち行列の先頭のタスクのID番号 */
|
---|
| 254 | ID rtskid; /* データキューの受信待ち行列の先頭のタスクのID番号 */
|
---|
| 255 | uint_t sdtqcnt; /* データキュー管理領域に格納されているデータの数 */
|
---|
| 256 | } T_RDTQ;
|
---|
| 257 |
|
---|
| 258 | typedef struct t_cpdq {
|
---|
| 259 | ATR pdqatr; /* 優先度データキュー属性 */
|
---|
| 260 | uint_t pdqcnt; /* 優先度データキュー管理領域に格納できるデータ数 */
|
---|
| 261 | PRI maxdpri; /* 優先度データキューに送信できるデータ優先度の最
|
---|
| 262 | 大値 */
|
---|
[429] | 263 | void *pdqmb; /* 優先度データキュー管理領域の先頭番地 */
|
---|
[270] | 264 | } T_CPDQ;
|
---|
| 265 |
|
---|
| 266 | typedef struct t_rpdq {
|
---|
| 267 | ID stskid; /* 優先度データキューの送信待ち行列の先頭のタスク
|
---|
| 268 | のID番号 */
|
---|
| 269 | ID rtskid; /* 優先度データキューの受信待ち行列の先頭のタスク
|
---|
| 270 | のID番号 */
|
---|
| 271 | uint_t spdqcnt; /* 優先度データキュー管理領域に格納されているデー
|
---|
| 272 | タの数 */
|
---|
| 273 | } T_RPDQ;
|
---|
| 274 |
|
---|
| 275 | typedef struct t_cmtx {
|
---|
| 276 | ATR mtxatr; /* ミューテックス属性 */
|
---|
| 277 | PRI ceilpri; /* ミューテックスの上限優先度 */
|
---|
| 278 | } T_CMTX;
|
---|
| 279 |
|
---|
| 280 | typedef struct t_rmtx {
|
---|
| 281 | ID htskid; /* ミューテックスをロックしているタスクのID番号 */
|
---|
| 282 | ID wtskid; /* ミューテックスの待ち行列の先頭のタスクのID番号 */
|
---|
| 283 | } T_RMTX;
|
---|
| 284 |
|
---|
| 285 | typedef struct t_cmpf {
|
---|
| 286 | ATR mpfatr; /* 固定長メモリプール属性 */
|
---|
| 287 | uint_t blkcnt; /* 獲得できる固定長メモリブロックの数 */
|
---|
| 288 | uint_t blksz; /* 固定長メモリブロックのサイズ */
|
---|
[429] | 289 | MPF_T *mpf; /* 固定長メモリプール領域の先頭番地 */
|
---|
| 290 | void *mpfmb; /* 固定長メモリプール管理領域の先頭番地 */
|
---|
[270] | 291 | } T_CMPF;
|
---|
| 292 |
|
---|
| 293 | typedef struct t_rmpf {
|
---|
| 294 | ID wtskid; /* 固定長メモリプールの待ち行列の先頭のタスクの
|
---|
| 295 | ID番号 */
|
---|
| 296 | uint_t fblkcnt; /* 固定長メモリプール領域の空きメモリ領域に割り
|
---|
| 297 | 付けることができる固定長メモリブロックの数 */
|
---|
| 298 | } T_RMPF;
|
---|
| 299 |
|
---|
| 300 | typedef struct t_ccyc {
|
---|
| 301 | ATR cycatr; /* 周期通知属性 */
|
---|
| 302 | T_NFYINFO nfyinfo; /* 周期通知の通知方法 */
|
---|
| 303 | RELTIM cyctim; /* 周期通知の通知周期 */
|
---|
| 304 | RELTIM cycphs; /* 周期通知の通知位相 */
|
---|
| 305 | } T_CCYC;
|
---|
| 306 |
|
---|
| 307 | typedef struct t_rcyc {
|
---|
| 308 | STAT cycstat; /* 周期通知の動作状態 */
|
---|
| 309 | RELTIM lefttim; /* 次回通知時刻までの相対時間 */
|
---|
| 310 | } T_RCYC;
|
---|
| 311 |
|
---|
| 312 | typedef struct t_calm {
|
---|
| 313 | ATR almatr; /* アラーム通知属性 */
|
---|
| 314 | T_NFYINFO nfyinfo; /* アラーム通知の通知方法 */
|
---|
| 315 | } T_CALM;
|
---|
| 316 |
|
---|
| 317 | typedef struct t_ralm {
|
---|
| 318 | STAT almstat; /* アラーム通知の動作状態 */
|
---|
| 319 | RELTIM lefttim; /* 通知時刻までの相対時間 */
|
---|
| 320 | } T_RALM;
|
---|
| 321 |
|
---|
| 322 | typedef struct t_cisr {
|
---|
| 323 | ATR isratr; /* 割込みサービスルーチン属性 */
|
---|
| 324 | intptr_t exinf; /* 割込みサービスルーチンの拡張情報 */
|
---|
| 325 | INTNO intno; /* 割込みサービスルーチンを登録する割込み番号 */
|
---|
| 326 | ISR isr; /* 割込みサービスルーチンの先頭番地 */
|
---|
| 327 | PRI isrpri; /* 割込みサービスルーチン優先度 */
|
---|
| 328 | } T_CISR;
|
---|
| 329 |
|
---|
| 330 | /*
|
---|
| 331 | * サービスコールの宣言
|
---|
| 332 | */
|
---|
| 333 |
|
---|
| 334 | /*
|
---|
| 335 | * タスク管理機能
|
---|
| 336 | */
|
---|
[331] | 337 | extern ER_ID acre_tsk(const T_CTSK *pk_ctsk) throw();
|
---|
[270] | 338 | extern ER del_tsk(ID tskid) throw();
|
---|
| 339 | extern ER act_tsk(ID tskid) throw();
|
---|
| 340 | extern ER_UINT can_act(ID tskid) throw();
|
---|
| 341 | extern ER get_tst(ID tskid, STAT *p_tskstat) throw();
|
---|
| 342 | extern ER chg_pri(ID tskid, PRI tskpri) throw();
|
---|
| 343 | extern ER get_pri(ID tskid, PRI *p_tskpri) throw();
|
---|
| 344 | extern ER get_inf(intptr_t *p_exinf) throw();
|
---|
| 345 | extern ER ref_tsk(ID tskid, T_RTSK *pk_rtsk) throw();
|
---|
| 346 |
|
---|
| 347 | /*
|
---|
| 348 | * タスク付属同期機能
|
---|
| 349 | */
|
---|
| 350 | extern ER slp_tsk(void) throw();
|
---|
| 351 | extern ER tslp_tsk(TMO tmout) throw();
|
---|
| 352 | extern ER wup_tsk(ID tskid) throw();
|
---|
| 353 | extern ER_UINT can_wup(ID tskid) throw();
|
---|
| 354 | extern ER rel_wai(ID tskid) throw();
|
---|
| 355 | extern ER sus_tsk(ID tskid) throw();
|
---|
| 356 | extern ER rsm_tsk(ID tskid) throw();
|
---|
| 357 | extern ER dly_tsk(RELTIM dlytim) throw();
|
---|
| 358 |
|
---|
| 359 | /*
|
---|
| 360 | * タスク終了機能
|
---|
| 361 | */
|
---|
| 362 | extern ER ext_tsk(void) throw();
|
---|
| 363 | extern ER ras_ter(ID tskid) throw();
|
---|
| 364 | extern ER dis_ter(void) throw();
|
---|
| 365 | extern ER ena_ter(void) throw();
|
---|
| 366 | extern bool_t sns_ter(void) throw();
|
---|
| 367 | extern ER ter_tsk(ID tskid) throw();
|
---|
| 368 |
|
---|
| 369 | /*
|
---|
| 370 | * 同期・通信機能
|
---|
| 371 | */
|
---|
| 372 | extern ER_ID acre_sem(const T_CSEM *pk_csem) throw();
|
---|
| 373 | extern ER del_sem(ID semid) throw();
|
---|
| 374 | extern ER sig_sem(ID semid) throw();
|
---|
| 375 | extern ER wai_sem(ID semid) throw();
|
---|
| 376 | extern ER pol_sem(ID semid) throw();
|
---|
| 377 | extern ER twai_sem(ID semid, TMO tmout) throw();
|
---|
| 378 | extern ER ini_sem(ID semid) throw();
|
---|
| 379 | extern ER ref_sem(ID semid, T_RSEM *pk_rsem) throw();
|
---|
| 380 |
|
---|
| 381 | extern ER_ID acre_flg(const T_CFLG *pk_cflg) throw();
|
---|
| 382 | extern ER del_flg(ID flgid) throw();
|
---|
| 383 | extern ER set_flg(ID flgid, FLGPTN setptn) throw();
|
---|
| 384 | extern ER clr_flg(ID flgid, FLGPTN clrptn) throw();
|
---|
| 385 | extern ER wai_flg(ID flgid, FLGPTN waiptn,
|
---|
| 386 | MODE wfmode, FLGPTN *p_flgptn) throw();
|
---|
| 387 | extern ER pol_flg(ID flgid, FLGPTN waiptn,
|
---|
| 388 | MODE wfmode, FLGPTN *p_flgptn) throw();
|
---|
| 389 | extern ER twai_flg(ID flgid, FLGPTN waiptn,
|
---|
| 390 | MODE wfmode, FLGPTN *p_flgptn, TMO tmout) throw();
|
---|
| 391 | extern ER ini_flg(ID flgid) throw();
|
---|
| 392 | extern ER ref_flg(ID flgid, T_RFLG *pk_rflg) throw();
|
---|
| 393 |
|
---|
| 394 | extern ER_ID acre_dtq(const T_CDTQ *pk_cdtq) throw();
|
---|
| 395 | extern ER del_dtq(ID dtqid) throw();
|
---|
| 396 | extern ER snd_dtq(ID dtqid, intptr_t data) throw();
|
---|
| 397 | extern ER psnd_dtq(ID dtqid, intptr_t data) throw();
|
---|
| 398 | extern ER tsnd_dtq(ID dtqid, intptr_t data, TMO tmout) throw();
|
---|
| 399 | extern ER fsnd_dtq(ID dtqid, intptr_t data) throw();
|
---|
| 400 | extern ER rcv_dtq(ID dtqid, intptr_t *p_data) throw();
|
---|
| 401 | extern ER prcv_dtq(ID dtqid, intptr_t *p_data) throw();
|
---|
| 402 | extern ER trcv_dtq(ID dtqid, intptr_t *p_data, TMO tmout) throw();
|
---|
| 403 | extern ER ini_dtq(ID dtqid) throw();
|
---|
| 404 | extern ER ref_dtq(ID dtqid, T_RDTQ *pk_rdtq) throw();
|
---|
| 405 |
|
---|
| 406 | extern ER_ID acre_pdq(const T_CPDQ *pk_cpdq) throw();
|
---|
| 407 | extern ER del_pdq(ID pdqid) throw();
|
---|
| 408 | extern ER snd_pdq(ID pdqid, intptr_t data, PRI datapri) throw();
|
---|
| 409 | extern ER psnd_pdq(ID pdqid, intptr_t data, PRI datapri) throw();
|
---|
| 410 | extern ER tsnd_pdq(ID pdqid, intptr_t data,
|
---|
| 411 | PRI datapri, TMO tmout) throw();
|
---|
| 412 | extern ER rcv_pdq(ID pdqid, intptr_t *p_data, PRI *p_datapri) throw();
|
---|
| 413 | extern ER prcv_pdq(ID pdqid, intptr_t *p_data, PRI *p_datapri) throw();
|
---|
| 414 | extern ER trcv_pdq(ID pdqid, intptr_t *p_data,
|
---|
| 415 | PRI *p_datapri, TMO tmout) throw();
|
---|
| 416 | extern ER ini_pdq(ID pdqid) throw();
|
---|
| 417 | extern ER ref_pdq(ID pdqid, T_RPDQ *pk_rpdq) throw();
|
---|
| 418 |
|
---|
| 419 | extern ER_ID acre_mtx(const T_CMTX *pk_cmtx) throw();
|
---|
| 420 | extern ER del_mtx(ID mtxid) throw();
|
---|
| 421 | extern ER loc_mtx(ID mtxid) throw();
|
---|
| 422 | extern ER ploc_mtx(ID mtxid) throw();
|
---|
| 423 | extern ER tloc_mtx(ID mtxid, TMO tmout) throw();
|
---|
| 424 | extern ER unl_mtx(ID mtxid) throw();
|
---|
| 425 | extern ER ini_mtx(ID mtxid) throw();
|
---|
| 426 | extern ER ref_mtx(ID mtxid, T_RMTX *pk_rmtx) throw();
|
---|
| 427 |
|
---|
| 428 | /*
|
---|
| 429 | * メモリプール管理機能
|
---|
| 430 | */
|
---|
| 431 | extern ER_ID acre_mpf(const T_CMPF *pk_cmpf) throw();
|
---|
| 432 | extern ER del_mpf(ID mpfid) throw();
|
---|
| 433 | extern ER get_mpf(ID mpfid, void **p_blk) throw();
|
---|
| 434 | extern ER pget_mpf(ID mpfid, void **p_blk) throw();
|
---|
| 435 | extern ER tget_mpf(ID mpfid, void **p_blk, TMO tmout) throw();
|
---|
| 436 | extern ER rel_mpf(ID mpfid, void *blk) throw();
|
---|
| 437 | extern ER ini_mpf(ID mpfid) throw();
|
---|
| 438 | extern ER ref_mpf(ID mpfid, T_RMPF *pk_rmpf) throw();
|
---|
| 439 |
|
---|
| 440 | /*
|
---|
| 441 | * 時間管理機能
|
---|
| 442 | */
|
---|
| 443 | extern ER set_tim(SYSTIM systim) throw();
|
---|
| 444 | extern ER get_tim(SYSTIM *p_systim) throw();
|
---|
| 445 | extern ER adj_tim(int32_t adjtim) throw();
|
---|
| 446 | extern HRTCNT fch_hrt(void) throw();
|
---|
| 447 |
|
---|
| 448 | extern ER_ID acre_cyc(const T_CCYC *pk_ccyc) throw();
|
---|
| 449 | extern ER del_cyc(ID cycid) throw();
|
---|
| 450 | extern ER sta_cyc(ID cycid) throw();
|
---|
| 451 | extern ER stp_cyc(ID cycid) throw();
|
---|
| 452 | extern ER ref_cyc(ID cycid, T_RCYC *pk_rcyc) throw();
|
---|
| 453 |
|
---|
| 454 | extern ER_ID acre_alm(const T_CALM *pk_calm) throw();
|
---|
| 455 | extern ER del_alm(ID almid) throw();
|
---|
| 456 | extern ER sta_alm(ID almid, RELTIM almtim) throw();
|
---|
| 457 | extern ER stp_alm(ID almid) throw();
|
---|
| 458 | extern ER ref_alm(ID almid, T_RALM *pk_ralm) throw();
|
---|
| 459 |
|
---|
| 460 | /*
|
---|
| 461 | * システム状態管理機能
|
---|
| 462 | */
|
---|
| 463 | extern ER rot_rdq(PRI tskpri) throw();
|
---|
| 464 | extern ER get_tid(ID *p_tskid) throw();
|
---|
| 465 | extern ER get_lod(PRI tskpri, uint_t *p_load) throw();
|
---|
| 466 | extern ER get_nth(PRI tskpri, uint_t nth, ID *p_tskid) throw();
|
---|
| 467 | extern ER loc_cpu(void) throw();
|
---|
| 468 | extern ER unl_cpu(void) throw();
|
---|
| 469 | extern ER dis_dsp(void) throw();
|
---|
| 470 | extern ER ena_dsp(void) throw();
|
---|
| 471 | extern bool_t sns_ctx(void) throw();
|
---|
| 472 | extern bool_t sns_loc(void) throw();
|
---|
| 473 | extern bool_t sns_dsp(void) throw();
|
---|
| 474 | extern bool_t sns_dpn(void) throw();
|
---|
| 475 | extern bool_t sns_ker(void) throw();
|
---|
| 476 | extern ER ext_ker(void) throw();
|
---|
| 477 |
|
---|
| 478 | /*
|
---|
| 479 | * 割込み管理機能
|
---|
| 480 | */
|
---|
| 481 | extern ER_ID acre_isr(const T_CISR *pk_cisr) throw();
|
---|
| 482 | extern ER del_isr(ID isrid) throw();
|
---|
| 483 | extern ER dis_int(INTNO intno) throw();
|
---|
| 484 | extern ER ena_int(INTNO intno) throw();
|
---|
[429] | 485 | extern ER clr_int(INTNO intno) throw();
|
---|
| 486 | extern ER ras_int(INTNO intno) throw();
|
---|
| 487 | extern ER_BOOL prb_int(INTNO intno) throw();
|
---|
[270] | 488 | extern ER chg_ipm(PRI intpri) throw();
|
---|
| 489 | extern ER get_ipm(PRI *p_intpri) throw();
|
---|
| 490 |
|
---|
| 491 | /*
|
---|
| 492 | * CPU例外管理機能
|
---|
| 493 | */
|
---|
| 494 | extern bool_t xsns_dpn(void *p_excinf) throw();
|
---|
| 495 |
|
---|
| 496 | #endif /* TOPPERS_MACRO_ONLY */
|
---|
| 497 |
|
---|
| 498 | /*
|
---|
| 499 | * 非タスクコンテキストから呼び出せるサービスコール
|
---|
| 500 | */
|
---|
| 501 | #define iact_tsk(tskid) act_tsk(tskid)
|
---|
| 502 | #define iwup_tsk(tskid) wup_tsk(tskid)
|
---|
| 503 | #define irel_wai(tskid) rel_wai(tskid)
|
---|
| 504 | #define isns_ter() sns_ter()
|
---|
| 505 | #define isig_sem(semid) sig_sem(semid)
|
---|
| 506 | #define iset_flg(flgid, setptn) set_flg(flgid, setptn)
|
---|
| 507 | #define ipsnd_dtq(dtqid, data) psnd_dtq(dtqid, data)
|
---|
| 508 | #define ifsnd_dtq(dtqid, data) fsnd_dtq(dtqid, data)
|
---|
| 509 | #define ipsnd_pdq(pdqid, data, datapri) psnd_pdq(pdqid, data, datapri)
|
---|
| 510 | #define ifch_hrt() fch_hrt()
|
---|
| 511 | #define ista_alm(almid, almtim) sta_alm(almid, almtim)
|
---|
| 512 | #define istp_alm(almid) stp_alm(almid)
|
---|
| 513 | #define irot_rdq(tskpri) rot_rdq(tskpri)
|
---|
| 514 | #define iget_tid(p_tskid) get_tid(p_tskid)
|
---|
| 515 | #define iloc_cpu() loc_cpu()
|
---|
| 516 | #define iunl_cpu() unl_cpu()
|
---|
| 517 | #define isns_ctx() sns_ctx()
|
---|
| 518 | #define isns_loc() sns_loc()
|
---|
| 519 | #define isns_dsp() sns_dsp()
|
---|
| 520 | #define isns_dpn() sns_dpn()
|
---|
| 521 | #define isns_ker() sns_ker()
|
---|
| 522 | #define iext_ker() ext_ker()
|
---|
| 523 | #define idis_int(intno) dis_int(intno)
|
---|
| 524 | #define iena_int(intno) ena_int(intno)
|
---|
[429] | 525 | #define iclr_int(intno) clr_int(intno)
|
---|
| 526 | #define iras_int(intno) ras_int(intno)
|
---|
| 527 | #define iprb_int(intno) prb_int(intno)
|
---|
[270] | 528 | #define ixsns_dpn(p_excinf) xsns_dpn(p_excinf)
|
---|
| 529 |
|
---|
| 530 | /*
|
---|
| 531 | * オブジェクト属性の定義
|
---|
| 532 | */
|
---|
| 533 | #define TA_ACT UINT_C(0x01) /* タスクを起動された状態で生成 */
|
---|
| 534 | #define TA_NOACTQUE UINT_C(0x02) /* 起動要求をキューイングしない */
|
---|
| 535 |
|
---|
| 536 | #define TA_TPRI UINT_C(0x01) /* タスクの待ち行列を優先度順に */
|
---|
| 537 |
|
---|
| 538 | #define TA_WMUL UINT_C(0x02) /* 複数の待ちタスク */
|
---|
| 539 | #define TA_CLR UINT_C(0x04) /* イベントフラグのクリア指定 */
|
---|
| 540 |
|
---|
| 541 | #define TA_CEILING UINT_C(0x03) /* 優先度上限プロトコル */
|
---|
| 542 |
|
---|
| 543 | #define TA_STA UINT_C(0x02) /* 周期通知を動作状態で生成 */
|
---|
| 544 |
|
---|
| 545 | #define TA_NONKERNEL UINT_C(0x02) /* カーネル管理外の割込み */
|
---|
| 546 |
|
---|
| 547 | #define TA_ENAINT UINT_C(0x01) /* 割込み要求禁止フラグをクリア */
|
---|
| 548 | #define TA_EDGE UINT_C(0x02) /* エッジトリガ */
|
---|
| 549 |
|
---|
| 550 | /*
|
---|
| 551 | * サービスコールの動作モードの定義
|
---|
| 552 | */
|
---|
| 553 | #define TWF_ORW UINT_C(0x01) /* イベントフラグのOR待ち */
|
---|
| 554 | #define TWF_ANDW UINT_C(0x02) /* イベントフラグのAND待ち */
|
---|
| 555 |
|
---|
| 556 | /*
|
---|
| 557 | * 通知処理モードの定義
|
---|
| 558 | */
|
---|
| 559 | #define TNFY_HANDLER UINT_C(0x00) /* タイムイベントハンドラの呼出し */
|
---|
| 560 | #define TNFY_SETVAR UINT_C(0x01) /* 変数の設定 */
|
---|
| 561 | #define TNFY_INCVAR UINT_C(0x02) /* 変数のインクリメント */
|
---|
| 562 | #define TNFY_ACTTSK UINT_C(0x03) /* タスクの起動 */
|
---|
| 563 | #define TNFY_WUPTSK UINT_C(0x04) /* タスクの起床 */
|
---|
| 564 | #define TNFY_SIGSEM UINT_C(0x05) /* セマフォの資源の返却 */
|
---|
| 565 | #define TNFY_SETFLG UINT_C(0x06) /* イベントフラグのセット */
|
---|
| 566 | #define TNFY_SNDDTQ UINT_C(0x07) /* データキューへの送信 */
|
---|
| 567 |
|
---|
| 568 | #define TENFY_SETVAR UINT_C(0x10) /* 変数の設定 */
|
---|
| 569 | #define TENFY_INCVAR UINT_C(0x20) /* 変数のインクリメント */
|
---|
| 570 | #define TENFY_ACTTSK UINT_C(0x30) /* タスクの起動 */
|
---|
| 571 | #define TENFY_WUPTSK UINT_C(0x40) /* タスクの起床 */
|
---|
| 572 | #define TENFY_SIGSEM UINT_C(0x50) /* セマフォの返却 */
|
---|
| 573 | #define TENFY_SETFLG UINT_C(0x60) /* イベントフラグのセット */
|
---|
| 574 | #define TENFY_SNDDTQ UINT_C(0x70) /* データキューへの送信 */
|
---|
| 575 |
|
---|
| 576 | /*
|
---|
| 577 | * オブジェクトの状態の定義
|
---|
| 578 | */
|
---|
| 579 | #define TTS_RUN UINT_C(0x01) /* 実行状態 */
|
---|
| 580 | #define TTS_RDY UINT_C(0x02) /* 実行可能状態 */
|
---|
| 581 | #define TTS_WAI UINT_C(0x04) /* 待ち状態 */
|
---|
| 582 | #define TTS_SUS UINT_C(0x08) /* 強制待ち状態 */
|
---|
| 583 | #define TTS_WAS UINT_C(0x0c) /* 二重待ち状態 */
|
---|
| 584 | #define TTS_DMT UINT_C(0x10) /* 休止状態 */
|
---|
| 585 |
|
---|
| 586 | #define TTW_SLP UINT_C(0x0001) /* 起床待ち */
|
---|
| 587 | #define TTW_DLY UINT_C(0x0002) /* 時間経過待ち */
|
---|
| 588 | #define TTW_SEM UINT_C(0x0004) /* セマフォの資源獲得待ち */
|
---|
| 589 | #define TTW_FLG UINT_C(0x0008) /* イベントフラグ待ち */
|
---|
| 590 | #define TTW_SDTQ UINT_C(0x0010) /* データキューへの送信待ち */
|
---|
| 591 | #define TTW_RDTQ UINT_C(0x0020) /* データキューからの受信待ち */
|
---|
| 592 | #define TTW_SPDQ UINT_C(0x0100) /* 優先度データキューへの送信待ち */
|
---|
| 593 | #define TTW_RPDQ UINT_C(0x0200) /* 優先度データキューからの受信待ち */
|
---|
| 594 | #define TTW_MTX UINT_C(0x0080) /* ミューテックスのロック待ち状態 */
|
---|
| 595 | #define TTW_MPF UINT_C(0x2000) /* 固定長メモリブロックの獲得待ち */
|
---|
| 596 |
|
---|
| 597 | #define TCYC_STP UINT_C(0x01) /* 周期通知が動作していない */
|
---|
| 598 | #define TCYC_STA UINT_C(0x02) /* 周期通知が動作している */
|
---|
| 599 |
|
---|
| 600 | #define TALM_STP UINT_C(0x01) /* アラーム通知が動作していない */
|
---|
| 601 | #define TALM_STA UINT_C(0x02) /* アラーム通知が動作している */
|
---|
| 602 |
|
---|
| 603 | /*
|
---|
| 604 | * その他の定数の定義
|
---|
| 605 | */
|
---|
| 606 | #define TSK_SELF 0 /* 自タスク指定 */
|
---|
| 607 | #define TSK_NONE 0 /* 該当するタスクがない */
|
---|
| 608 |
|
---|
| 609 | #define TPRI_SELF 0 /* 自タスクのベース優先度 */
|
---|
| 610 | #define TPRI_INI 0 /* タスクの起動時優先度 */
|
---|
| 611 |
|
---|
| 612 | #define TIPM_ENAALL 0 /* 割込み優先度マスク全解除 */
|
---|
| 613 |
|
---|
| 614 | /*
|
---|
| 615 | * 構成定数とマクロ
|
---|
| 616 | */
|
---|
| 617 |
|
---|
| 618 | /*
|
---|
| 619 | * 優先度の範囲
|
---|
| 620 | */
|
---|
| 621 | #define TMIN_TPRI 1 /* タスク優先度の最小値(最高値)*/
|
---|
| 622 | #define TMAX_TPRI 16 /* タスク優先度の最大値(最低値)*/
|
---|
| 623 | #define TMIN_DPRI 1 /* データ優先度の最小値(最高値)*/
|
---|
| 624 | #define TMAX_DPRI 16 /* データ優先度の最大値(最低値)*/
|
---|
| 625 | #define TMIN_ISRPRI 1 /* 割込みサービスルーチン優先度の最小値 */
|
---|
| 626 | #define TMAX_ISRPRI 16 /* 割込みサービスルーチン優先度の最大値 */
|
---|
| 627 |
|
---|
| 628 | /*
|
---|
| 629 | * バージョン情報
|
---|
| 630 | */
|
---|
| 631 | #define TKERNEL_MAKER UINT_C(0x0118) /* カーネルのメーカーコード */
|
---|
| 632 | #define TKERNEL_PRID UINT_C(0x0007) /* カーネルの識別番号 */
|
---|
[429] | 633 | #define TKERNEL_SPVER UINT_C(0xf634) /* カーネル仕様のバージョン番号 */
|
---|
| 634 | #define TKERNEL_PRVER UINT_C(0x3050) /* カーネルのバージョン番号 */
|
---|
[270] | 635 |
|
---|
| 636 | /*
|
---|
| 637 | * キューイング回数の最大値
|
---|
| 638 | */
|
---|
| 639 | #define TMAX_ACTCNT UINT_C(1) /* 起動要求キューイング数の最大値 */
|
---|
| 640 | #define TMAX_WUPCNT UINT_C(1) /* 起床要求キューイング数の最大値 */
|
---|
| 641 |
|
---|
| 642 | /*
|
---|
| 643 | * ビットパターンのビット数
|
---|
| 644 | */
|
---|
| 645 | #ifndef TBIT_FLGPTN /* イベントフラグのビット数 */
|
---|
| 646 | #define TBIT_FLGPTN (sizeof(FLGPTN) * CHAR_BIT)
|
---|
| 647 | #endif /* TBIT_FLGPTN */
|
---|
| 648 |
|
---|
| 649 | /*
|
---|
| 650 | * システム時刻の調整できる範囲(単位:μ秒)
|
---|
| 651 | */
|
---|
[429] | 652 | #define TMIN_ADJTIM (-1000000) /* システム時刻の最小調整時間 */
|
---|
[270] | 653 | #define TMAX_ADJTIM 1000000 /* システム時刻の最大調整時間 */
|
---|
| 654 |
|
---|
| 655 | /*
|
---|
| 656 | * メモリ領域確保のためのマクロ
|
---|
| 657 | *
|
---|
| 658 | * 以下のTOPPERS_COUNT_SZとTOPPERS_ROUND_SZの定義は,unitが2の巾乗であ
|
---|
| 659 | * ることを仮定している.
|
---|
| 660 | */
|
---|
| 661 | #ifndef TOPPERS_COUNT_SZ
|
---|
| 662 | #define TOPPERS_COUNT_SZ(sz, unit) (((sz) + (unit) - 1) / (unit))
|
---|
| 663 | #endif /* TOPPERS_COUNT_SZ */
|
---|
| 664 | #ifndef TOPPERS_ROUND_SZ
|
---|
| 665 | #define TOPPERS_ROUND_SZ(sz, unit) (((sz) + (unit) - 1) & ~((unit) - 1))
|
---|
| 666 | #endif /* TOPPERS_ROUND_SZ */
|
---|
| 667 |
|
---|
| 668 | #define COUNT_STK_T(sz) TOPPERS_COUNT_SZ(sz, sizeof(STK_T))
|
---|
| 669 | #define ROUND_STK_T(sz) TOPPERS_ROUND_SZ(sz, sizeof(STK_T))
|
---|
| 670 |
|
---|
| 671 | #define COUNT_MPF_T(blksz) TOPPERS_COUNT_SZ(blksz, sizeof(MPF_T))
|
---|
| 672 | #define ROUND_MPF_T(blksz) TOPPERS_ROUND_SZ(blksz, sizeof(MPF_T))
|
---|
| 673 |
|
---|
[429] | 674 | #define COUNT_MB_T(sz) TOPPERS_COUNT_SZ(sz, sizeof(MB_T))
|
---|
| 675 | #define ROUND_MB_T(sz) TOPPERS_ROUND_SZ(sz, sizeof(MB_T))
|
---|
| 676 |
|
---|
[270] | 677 | #define TSZ_DTQMB(dtqcnt) (sizeof(intptr_t) * (dtqcnt))
|
---|
[429] | 678 | #define TCNT_DTQMB(dtqcnt) COUNT_MB_T(TSZ_DTQMB(dtqcnt))
|
---|
[270] | 679 |
|
---|
| 680 | #ifndef TSZ_PDQMB
|
---|
| 681 | #define TSZ_PDQMB(pdqcnt) (sizeof(intptr_t) * 3 * (pdqcnt))
|
---|
| 682 | #endif /* TSZ_PDQMB */
|
---|
[429] | 683 | #define TCNT_PDQMB(pdqcnt) COUNT_MB_T(TSZ_PDQMB(pdqcnt))
|
---|
[270] | 684 |
|
---|
| 685 | #define TSZ_MPFMB(blkcnt) (sizeof(uint_t) * (blkcnt))
|
---|
[429] | 686 | #define TCNT_MPFMB(blkcnt) COUNT_MB_T(TSZ_MPFMB(blkcnt))
|
---|
[270] | 687 |
|
---|
| 688 | /*
|
---|
| 689 | * その他の構成定数
|
---|
| 690 | */
|
---|
| 691 | #define TMAX_MAXSEM UINT_MAX /* セマフォの最大資源数の最大値 */
|
---|
| 692 |
|
---|
| 693 | #ifdef __cplusplus
|
---|
| 694 | }
|
---|
| 695 | #endif
|
---|
| 696 |
|
---|
| 697 | #endif /* TOPPERS_KERNEL_H */
|
---|