1 | /*
|
---|
2 | * TOPPERS/ASP Kernel
|
---|
3 | * Toyohashi Open Platform for Embedded Real-Time Systems/
|
---|
4 | * Advanced Standard Profile Kernel
|
---|
5 | *
|
---|
6 | * Copyright (C) 2005-2010 by Embedded and Real-Time Systems Laboratory
|
---|
7 | * Graduate School of Information Science, Nagoya Univ., JAPAN
|
---|
8 | *
|
---|
9 | * ãLì ÒÍCȺÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
|
---|
10 | * Ai{\tgEFAðüϵ½àÌðÜÞDȺ¯¶jðgpE¡»Eü
|
---|
11 | * ÏEÄzziȺCpÆÄÔj·é±Æð³Åø·éD
|
---|
12 | * (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
|
---|
13 | * \¦C±Ìpð¨æѺL̳ÛØKèªC»ÌÜÜÌ`Å\[
|
---|
14 | * XR[hÉÜÜêÄ¢é±ÆD
|
---|
15 | * (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
|
---|
16 | * pÅ«é`ÅÄzz·éêÉÍCÄzzɺ¤hL
|
---|
17 | gip
|
---|
18 | * Ò}j
|
---|
19 | AÈÇjÉCãLÌì \¦C±Ìpð¨æѺL
|
---|
20 | * ̳ÛØKèðfÚ·é±ÆD
|
---|
21 | * (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
|
---|
22 | * pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
|
---|
23 | * ÆD
|
---|
24 | * (a) Äzzɺ¤hL
|
---|
25 | gipÒ}j
|
---|
26 | AÈÇjÉCãLÌ
|
---|
27 | * ì \¦C±Ìpð¨æѺL̳ÛØKèðfÚ·é±ÆD
|
---|
28 | * (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
|
---|
29 | * ñ·é±ÆD
|
---|
30 | * (4) {\tgEFAÌpÉæè¼ÚIܽÍÔÚIɶ¶é¢©Èé¹
|
---|
31 | * Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
|
---|
32 | * ܽC{\tgEFAÌ[UܽÍGh[U©çÌ¢©Èé
|
---|
33 | * RÉîÿ©çàCãLì Ò¨æÑTOPPERSvWFNgð
|
---|
34 | * ÆÓ·é±ÆD
|
---|
35 | *
|
---|
36 | * {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
|
---|
37 | * æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
|
---|
38 | * ÉηéK«àÜßÄC¢©ÈéÛØàsíÈ¢DܽC{\tgEF
|
---|
39 | * AÌpÉæè¼ÚIܽÍÔÚIɶ¶½¢©Èé¹QÉÖµÄàC»
|
---|
40 | * ÌÓCðíÈ¢D
|
---|
41 | *
|
---|
42 | * @(#) $Id: mutex.h 1910 2010-08-25 06:30:21Z ertl-hiro $
|
---|
43 | */
|
---|
44 |
|
---|
45 | /*
|
---|
46 | * ~
|
---|
47 | [ebNX@\
|
---|
48 | */
|
---|
49 |
|
---|
50 | #ifndef TOPPERS_MUTEX_H
|
---|
51 | #define TOPPERS_MUTEX_H
|
---|
52 |
|
---|
53 | #include <queue.h>
|
---|
54 |
|
---|
55 | /*
|
---|
56 | * ~
|
---|
57 | [ebNXú»ubN
|
---|
58 | *
|
---|
59 | * ±Ì\¢ÌÍC¯úEÊMIuWFNgÌú»ubN̤ʪ
|
---|
60 | * iWOBJINIBjðg£iIuWFNgwü¾êÌp³Éjµ½àÌÅC
|
---|
61 | * ÅÌtB[hª¤ÊÉÈÁÄ¢éD
|
---|
62 | */
|
---|
63 | typedef struct mutex_initialization_block {
|
---|
64 | ATR mtxatr; /* ~
|
---|
65 | [ebNX®« */
|
---|
66 | uint_t ceilpri; /* ~
|
---|
67 | [ebNXÌãÀDæxià\»j*/
|
---|
68 | } MTXINIB;
|
---|
69 |
|
---|
70 | /*
|
---|
71 | * ~
|
---|
72 | [ebNXÇubN
|
---|
73 | *
|
---|
74 | * ±Ì\¢ÌÍC¯úEÊMIuWFNgÌÇubN̤ʪiWOBJCBj
|
---|
75 | * ðg£iIuWFNgwü¾êÌp³Éjµ½àÌÅCÅÌ2ÂÌ
|
---|
76 | * tB[hª¤ÊÉÈÁÄ¢éD
|
---|
77 | */
|
---|
78 | typedef struct mutex_control_block {
|
---|
79 | QUEUE wait_queue; /* ~
|
---|
80 | [ebNXÒ¿L
|
---|
81 | [ */
|
---|
82 | const MTXINIB *p_mtxinib; /* ú»ubNÖÌ|C^ */
|
---|
83 | TCB *p_loctsk; /* ~
|
---|
84 | [ebNXðbNµÄ¢é^XN */
|
---|
85 | QUEUE mutex_queue; /* bNµÄ¢é~
|
---|
86 | [ebNXÌL
|
---|
87 | [ */
|
---|
88 | } MTXCB;
|
---|
89 |
|
---|
90 | /*
|
---|
91 | * ~
|
---|
92 | [ebNXÒ¿îñubNÌè`
|
---|
93 | *
|
---|
94 | * ±Ì\¢ÌÍC¯úEÊMIuWFNgÌÒ¿îñubN̤ʪ
|
---|
95 | * iWINFO_WOBJjðg£iIuWFNgwü¾êÌp³Éjµ½àÌÅC
|
---|
96 | * ·×ÄÌtB[hª¤ÊÉÈÁÄ¢éD
|
---|
97 | */
|
---|
98 | typedef struct mutex_waiting_information {
|
---|
99 | WINFO winfo; /* WÌÒ¿îñubN */
|
---|
100 | MTXCB *p_mtxcb; /* ÒÁÄ¢é~
|
---|
101 | [ebNXÌÇubN */
|
---|
102 | } WINFO_MTX;
|
---|
103 |
|
---|
104 | /*
|
---|
105 | * ~
|
---|
106 | [ebNXIDÌÅålikernel_cfg.cj
|
---|
107 | */
|
---|
108 | extern const ID tmax_mtxid;
|
---|
109 |
|
---|
110 | /*
|
---|
111 | * ~
|
---|
112 | [ebNXú»ubNÌGAikernel_cfg.cj
|
---|
113 | */
|
---|
114 | extern const MTXINIB mtxinib_table[];
|
---|
115 |
|
---|
116 | /*
|
---|
117 | * ~
|
---|
118 | [ebNXÇubNÌGAikernel_cfg.cj
|
---|
119 | */
|
---|
120 | extern MTXCB mtxcb_table[];
|
---|
121 |
|
---|
122 | /*
|
---|
123 | * ~
|
---|
124 | [ebNXÇubN©ç~
|
---|
125 | [ebNXIDðæèo·½ßÌ}N
|
---|
126 | */
|
---|
127 | #define MTXID(p_mtxcb) ((ID)(((p_mtxcb) - mtxcb_table) + TMIN_MTXID))
|
---|
128 |
|
---|
129 | /*
|
---|
130 | * ~
|
---|
131 | [ebNX@\Ìú»
|
---|
132 | */
|
---|
133 | extern void initialize_mutex(void);
|
---|
134 |
|
---|
135 | /*
|
---|
136 | * ãÀDæxá½Ì`FbN
|
---|
137 | *
|
---|
138 | * chg_priÌÅãÀDæxá½Ì`FbNðs¤½ßÉp¢éÖÅ èC
|
---|
139 | * p_tcbÅwè³êé^XNªbNµÄ¢éDæxãÀ~
|
---|
140 | [ebNXÆC
|
---|
141 | * bNðÒÁÄ¢éDæxãÀ~
|
---|
142 | [ebNXÌÅCãÀDæxª
|
---|
143 | * bpriorityæèàá¢à̪ êÎfalseðC»¤ÅȯêÎtrueðÔ·D
|
---|
144 | */
|
---|
145 | extern bool_t (*mtxhook_check_ceilpri)(TCB *p_tcb, uint_t bpriority);
|
---|
146 | extern bool_t mutex_check_ceilpri(TCB *p_tcb, uint_t bpriority);
|
---|
147 |
|
---|
148 | /*
|
---|
149 | * DæxãÀ~
|
---|
150 | [ebNXðbNµÄ¢é©Ì`FbN
|
---|
151 | *
|
---|
152 | * p_tcbÅwè³êé^XNªDæxãÀ~
|
---|
153 | [ebNXðbNµÄ¢êÎ
|
---|
154 | * trueC»¤ÅȯêÎfalseðÔ·D
|
---|
155 | */
|
---|
156 | extern bool_t (*mtxhook_scan_ceilmtx)(TCB *p_tcb);
|
---|
157 | extern bool_t mutex_scan_ceilmtx(TCB *p_tcb);
|
---|
158 |
|
---|
159 | /*
|
---|
160 | * ^XNÌ»ÝDæxÌvZ
|
---|
161 | *
|
---|
162 | * p_tcbÅwè³êé^XNÌ»ÝDæxiÉÝè·×«ljðvZ·éD
|
---|
163 | */
|
---|
164 | extern uint_t mutex_calc_priority(TCB *p_tcb);
|
---|
165 |
|
---|
166 | /*
|
---|
167 | * ~
|
---|
168 | [ebNXÌbNð
|
---|
169 | *
|
---|
170 | * p_mtxcbÅwè³êé~
|
---|
171 | [ebNXðbNð·éDbNðµ½
|
---|
172 | * ~
|
---|
173 | [ebNXÉCbNÒ¿óÔÌ^XNª éêÉÍC»Ì^XN
|
---|
174 | * É~
|
---|
175 | [ebNXðbN³¹éD
|
---|
176 | */
|
---|
177 | extern bool_t mutex_release(MTXCB *p_mtxcb);
|
---|
178 |
|
---|
179 | /*
|
---|
180 | * ^XNªbNµÄ¢é·×ÄÌ~
|
---|
181 | [ebNXÌbNð
|
---|
182 | *
|
---|
183 | * p_tcbÅwè³êé^XNÉC»êªbNµÄ¢é·×ÄÌ~
|
---|
184 | [ebN
|
---|
185 | * XðbNð³¹éDbNðµ½~
|
---|
186 | [ebNXÉCbNÒ¿ó
|
---|
187 | * ÔÌ^XNª éêÉÍC»Ì^XNÉ~
|
---|
188 | [ebNXðbN³¹éD
|
---|
189 | *
|
---|
190 | * ±ÌÖÍC^XNÌI¹ÉgíêéàÌÅ é½ßCp_tcbÅwè³ê
|
---|
191 | * é^XNÌDæxðÏX·éÍsíÈ¢D½¾µC±ÌÖÌż
|
---|
192 | * Ì^XNÌDæxªÏ»µCÀs·×«^XNªÏíé±Æª éD»Ì
|
---|
193 | * ½ßC±ÌÖ©çßÁ½ãÉCfBXpb`ªKv©»ÊµÄCKvÈ
|
---|
194 | * êÉÍfBXpb`ðsíȯêÎÈçÈ¢D
|
---|
195 | */
|
---|
196 | extern bool_t (*mtxhook_release_all)(TCB *p_tcb);
|
---|
197 | extern bool_t mutex_release_all(TCB *p_tcb);
|
---|
198 |
|
---|
199 | #endif /* TOPPERS_MUTEX_H */
|
---|