source: azure_iot_hub_f767zi/trunk/asp_baseplatform/kernel/mutex.h@ 457

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

ファイルを追加
  • Property svn:eol-style set to native
  • Property svn:mime-type set to text/x-chdr;charset=UTF-8
File size: 7.7 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 by Embedded and Real-Time Systems Laboratory
7 * Toyohashi Univ. of Technology, JAPAN
8 * Copyright (C) 2005-2012 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_MUTEX_H
48#define TOPPERS_MUTEX_H
49
50#include "wait.h"
51
52/*
53 * ミューテックス初期化ブロック
54 *
55 * この構造体は，同期・通信オブジェクトの初期化ブロックの共通部分
56 * （WOBJINIB）を拡張（オブジェクト指向言語の継承に相当）したもので，
57 * 最初のフィールドが共通になっている．
58 */
59typedef struct mutex_initialization_block {
60 ATR mtxatr; /* ミューテックス属性 */
61 uint_t ceilpri; /* ミューテックスの上限優先度（内部表現）*/
62} MTXINIB;
63
64/*
65 * ミューテックス管理ブロック
66 *
67 * この構造体は，同期・通信オブジェクトの管理ブロックの共通部分（WOBJCB）
68 * を拡張（オブジェクト指向言語の継承に相当）したもので，最初の2つの
69 * フィールドが共通になっている．
70 */
71typedef struct mutex_control_block {
72 QUEUE wait_queue; /* ミューテックス待ちキュー */
73 const MTXINIB *p_mtxinib; /* 初期化ブロックへのポインタ */
74 TCB *p_loctsk; /* ミューテックスをロックしているタスク */
75 QUEUE mutex_queue; /* ロックしているミューテックスのキュー */
76} MTXCB;
77
78/*
79 * ミューテックス待ち情報ブロックの定義
80 *
81 * この構造体は，同期・通信オブジェクトの待ち情報ブロックの共通部分
82 * （WINFO_WOBJ）を拡張（オブジェクト指向言語の継承に相当）したもので，
83 * すべてのフィールドが共通になっている．
84 */
85typedef struct mutex_waiting_information {
86 WINFO winfo; /* 標準の待ち情報ブロック */
87 MTXCB *p_mtxcb; /* 待っているミューテックスの管理ブロック */
88} WINFO_MTX;
89
90/*
91 * 使用していないミューテックス管理ブロックのリスト
92 */
93extern QUEUE free_mtxcb;
94
95/*
96 * ミューテックスIDの最大値（kernel_cfg.c）
97 */
98extern const ID tmax_mtxid;
99extern const ID tmax_smtxid;
100
101/*
102 * ミューテックス初期化ブロックのエリア（kernel_cfg.c）
103 */
104extern const MTXINIB mtxinib_table[];
105extern MTXINIB amtxinib_table[];
106
107/*
108 * ミューテックス管理ブロックのエリア（kernel_cfg.c）
109 */
110extern MTXCB mtxcb_table[];
111
112/*
113 * ミューテックス管理ブロックからミューテックスIDを取り出すためのマクロ
114 */
115#define MTXID(p_mtxcb) ((ID)(((p_mtxcb) - mtxcb_table) + TMIN_MTXID))
116
117/*
118 * ミューテックス機能の初期化
119 */
120extern void initialize_mutex(void);
121
122/*
123 * 上限優先度違反のチェック
124 *
125 * chg_priの中で上限優先度違反のチェックを行うために用いる関数であり，
126 * p_tcbで指定されるタスクがロックしている優先度上限ミューテックスと，
127 * ロックを待っている優先度上限ミューテックスの中で，上限優先度が
128 * bpriorityよりも低いものがあればfalseを，そうでなければtrueを返す．
129 */
130extern bool_t (*mtxhook_check_ceilpri)(TCB *p_tcb, uint_t bpriority);
131extern bool_t mutex_check_ceilpri(TCB *p_tcb, uint_t bpriority);
132
133/*
134 * 優先度上限ミューテックスをロックしているかのチェック
135 *
136 * p_tcbで指定されるタスクが優先度上限ミューテックスをロックしていれば
137 * true，そうでなければfalseを返す．
138 */
139extern bool_t (*mtxhook_scan_ceilmtx)(TCB *p_tcb);
140extern bool_t mutex_scan_ceilmtx(TCB *p_tcb);
141
142/*
143 * タスクの現在優先度の計算
144 *
145 * p_tcbで指定されるタスクの現在優先度（に設定すべき値）を計算する．
146 */
147extern uint_t mutex_calc_priority(TCB *p_tcb);
148
149/*
150 * ミューテックスのロック解除
151 *
152 * p_mtxcbで指定されるミューテックスをロック解除する．ロック解除した
153 * ミューテックスに，ロック待ち状態のタスクがある場合には，そのタスク
154 * にミューテックスをロックさせる．
155 */
156extern bool_t mutex_release(MTXCB *p_mtxcb);
157
158/*
159 * タスクがロックしているすべてのミューテックスのロック解除
160 *
161 * p_tcbで指定されるタスクに，それがロックしているすべてのミューテック
162 * スをロック解除させる．ロック解除したミューテックスに，ロック待ち状
163 * 態のタスクがある場合には，そのタスクにミューテックスをロックさせる．
164 *
165 * この関数は，タスクの終了時に使われるものであるため，p_tcbで指定され
166 * るタスクの優先度を変更する処理は行わない．ただし，この関数の中で他
167 * のタスクの優先度が変化し，実行すべきタスクが変わることがある．その
168 * ため，この関数から戻った後に，ディスパッチが必要か判別して，必要な
169 * 場合にはディスパッチを行わなければならない．
170 */
171extern bool_t (*mtxhook_release_all)(TCB *p_tcb);
172extern bool_t mutex_release_all(TCB *p_tcb);
173
174#endif /* TOPPERS_MUTEX_H */
Note: See TracBrowser for help on using the repository browser.