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-2010 by Embedded and Real-Time Systems Laboratory
|
---|
9 | * Graduate School of Information Science, Nagoya Univ., JAPAN
|
---|
10 | *
|
---|
11 | * ãLì ÒÍCȺÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
|
---|
12 | * Ai{\tgEFAðüϵ½àÌðÜÞDȺ¯¶jðgpE¡»Eü
|
---|
13 | * ÏEÄzziȺCpÆÄÔj·é±Æð³Åø·éD
|
---|
14 | * (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
|
---|
15 | * \¦C±Ìpð¨æѺL̳ÛØKèªC»ÌÜÜÌ`Å\[
|
---|
16 | * XR[hÉÜÜêÄ¢é±ÆD
|
---|
17 | * (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
|
---|
18 | * pÅ«é`ÅÄzz·éêÉÍCÄzzɺ¤hL
|
---|
19 | gip
|
---|
20 | * Ò}j
|
---|
21 | AÈÇjÉCãLÌì \¦C±Ìpð¨æѺL
|
---|
22 | * ̳ÛØKèðfÚ·é±ÆD
|
---|
23 | * (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
|
---|
24 | * pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
|
---|
25 | * ÆD
|
---|
26 | * (a) Äzzɺ¤hL
|
---|
27 | gipÒ}j
|
---|
28 | AÈÇjÉCãLÌ
|
---|
29 | * ì \¦C±Ìpð¨æѺL̳ÛØKèðfÚ·é±ÆD
|
---|
30 | * (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
|
---|
31 | * ñ·é±ÆD
|
---|
32 | * (4) {\tgEFAÌpÉæè¼ÚIܽÍÔÚIɶ¶é¢©Èé¹
|
---|
33 | * Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
|
---|
34 | * ܽC{\tgEFAÌ[UܽÍGh[U©çÌ¢©Èé
|
---|
35 | * RÉîÿ©çàCãLì Ò¨æÑTOPPERSvWFNgð
|
---|
36 | * ÆÓ·é±ÆD
|
---|
37 | *
|
---|
38 | * {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
|
---|
39 | * æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
|
---|
40 | * ÉηéK«àÜßÄC¢©ÈéÛØàsíÈ¢DܽC{\tgEF
|
---|
41 | * AÌpÉæè¼ÚIܽÍÔÚIɶ¶½¢©Èé¹QÉÖµÄàC»
|
---|
42 | * ÌÓCðíÈ¢D
|
---|
43 | *
|
---|
44 | * @(#) $Id: wait.h 1841 2010-07-10 17:37:34Z ertl-hiro $
|
---|
45 | */
|
---|
46 |
|
---|
47 | /*
|
---|
48 | * Ò¿óÔÇW
|
---|
49 | [
|
---|
50 | */
|
---|
51 |
|
---|
52 | #ifndef TOPPERS_WAIT_H
|
---|
53 | #define TOPPERS_WAIT_H
|
---|
54 |
|
---|
55 | #include "task.h"
|
---|
56 | #include "time_event.h"
|
---|
57 |
|
---|
58 | /*
|
---|
59 | * ^XNÌDæxÌÒ¿L
|
---|
60 | [ÖÌ}ü
|
---|
61 | *
|
---|
62 | * p_tcbÅwè³êé^XNðC^XNDæxÌL
|
---|
63 | [p_queueÉ}ü·éD
|
---|
64 | * L
|
---|
65 | [Ìɯ¶DæxÌ^XNª éêÉÍC»ÌÅãÉ}ü·éD
|
---|
66 | */
|
---|
67 | Inline void
|
---|
68 | queue_insert_tpri(QUEUE *p_queue, TCB *p_tcb)
|
---|
69 | {
|
---|
70 | QUEUE *p_entry;
|
---|
71 | uint_t priority = p_tcb->priority;
|
---|
72 |
|
---|
73 | for (p_entry = p_queue->p_next; p_entry != p_queue;
|
---|
74 | p_entry = p_entry->p_next) {
|
---|
75 | if (priority < ((TCB *) p_entry)->priority) {
|
---|
76 | break;
|
---|
77 | }
|
---|
78 | }
|
---|
79 | queue_insert_prev(p_entry, &(p_tcb->task_queue));
|
---|
80 | }
|
---|
81 |
|
---|
82 | /*
|
---|
83 | * Ò¿óÔÖÌJÚ
|
---|
84 | *
|
---|
85 | * ÀsÌ^XNðÒ¿óÔÉJÚ³¹éDïÌIÉÍCÀsÌ^XNð
|
---|
86 | * fBL
|
---|
87 | [©çíµCTCBÌp_winfotB[hCWINFOÌp_tmevtbtB[
|
---|
88 | * hðÝè·éD
|
---|
89 | */
|
---|
90 | Inline void
|
---|
91 | make_wait(WINFO *p_winfo)
|
---|
92 | {
|
---|
93 | (void) make_non_runnable(p_runtsk);
|
---|
94 | p_runtsk->p_winfo = p_winfo;
|
---|
95 | p_winfo->p_tmevtb = NULL;
|
---|
96 | }
|
---|
97 |
|
---|
98 | /*
|
---|
99 | * Ò¿óÔÖÌJÚi^CAEgwèj
|
---|
100 | *
|
---|
101 | * ÀsÌ^XNðC^CAEgwèt«ÅÒ¿óÔÉJÚ³¹éDïÌ
|
---|
102 | * IÉÍCÀsÌ^XNðfBL
|
---|
103 | [©çíµCTCBÌp_winfotB[
|
---|
104 | * hCWINFOÌp_tmevtbtB[hðÝè·éDܽC^CCxgu
|
---|
105 | * bNðo^·éD
|
---|
106 | */
|
---|
107 | extern void make_wait_tmout(WINFO *p_winfo, TMEVTB *p_tmevtb, TMO tmout);
|
---|
108 |
|
---|
109 | /*
|
---|
110 | * Ò¿ð̽ßÌ^XNóÔÌXV
|
---|
111 | *
|
---|
112 | * p_tcbÅwè³êé^XNðCÒ¿ð·éæ¤^XNóÔðXV·éD
|
---|
113 | * Ò¿ð·é^XNªÀsÅ«éóÔÉÈéêÍCfBL
|
---|
114 | [ÉÂÈ
|
---|
115 | * ®DܽCfBXpb`ªKvÈêÉÍtrueðÔ·D
|
---|
116 | */
|
---|
117 | Inline bool_t
|
---|
118 | make_non_wait(TCB *p_tcb)
|
---|
119 | {
|
---|
120 | assert(TSTAT_WAITING(p_tcb->tstat));
|
---|
121 |
|
---|
122 | if (!TSTAT_SUSPENDED(p_tcb->tstat)) {
|
---|
123 | /*
|
---|
124 | * Ò¿óÔ©çÀsÅ«éóÔÖÌJÚ
|
---|
125 | */
|
---|
126 | p_tcb->tstat = TS_RUNNABLE;
|
---|
127 | LOG_TSKSTAT(p_tcb);
|
---|
128 | return(make_runnable(p_tcb));
|
---|
129 | }
|
---|
130 | else {
|
---|
131 | /*
|
---|
132 | * ñdÒ¿óÔ©ç§Ò¿óÔÖÌJÚ
|
---|
133 | */
|
---|
134 | p_tcb->tstat = TS_SUSPENDED;
|
---|
135 | LOG_TSKSTAT(p_tcb);
|
---|
136 | return(false);
|
---|
137 | }
|
---|
138 | }
|
---|
139 |
|
---|
140 | /*
|
---|
141 | * IuWFNgÒ¿L
|
---|
142 | [©çÌí
|
---|
143 | *
|
---|
144 | * p_tcbÅwè³êé^XNªC¯úEÊMIuWFNgÌÒ¿L
|
---|
145 | [ÉÂ
|
---|
146 | * ȪêÄ¢êÎCÒ¿L
|
---|
147 | [©çí·éD
|
---|
148 | */
|
---|
149 | Inline void
|
---|
150 | wait_dequeue_wobj(TCB *p_tcb)
|
---|
151 | {
|
---|
152 | if (TSTAT_WAIT_WOBJ(p_tcb->tstat)) {
|
---|
153 | queue_delete(&(p_tcb->task_queue));
|
---|
154 | }
|
---|
155 | }
|
---|
156 |
|
---|
157 | /*
|
---|
158 | * Ôҿ̽ßÌ^CCxgubNÌo^ð
|
---|
159 | *
|
---|
160 | * p_tcbÅwè³êé^XNÉεÄCÔҿ̽ßÌ^CCxgu
|
---|
161 | * bNªo^³êÄ¢êÎC»êðo^ð·éD
|
---|
162 | */
|
---|
163 | Inline void
|
---|
164 | wait_dequeue_tmevtb(TCB *p_tcb)
|
---|
165 | {
|
---|
166 | if (p_tcb->p_winfo->p_tmevtb != NULL) {
|
---|
167 | tmevtb_dequeue(p_tcb->p_winfo->p_tmevtb);
|
---|
168 | }
|
---|
169 | }
|
---|
170 |
|
---|
171 | /*
|
---|
172 | * Ò¿ð
|
---|
173 | *
|
---|
174 | * p_tcbÅwè³êé^XNÌÒ¿óÔðð·éDïÌIÉÍC^CC
|
---|
175 | * xgubNªo^³êÄ¢êÎC»êðo^ð·éDܽC^XN
|
---|
176 | * óÔðXVµCÒ¿ðµ½^XN©çÌÔlðE_OKÆ·éDÒ¿L
|
---|
177 | [
|
---|
178 | * ©çÌíÍsíÈ¢DÒ¿ðµ½^XNÖÌfBXpb`ªKvÈê
|
---|
179 | * ÉÍtrueðÔ·D
|
---|
180 | */
|
---|
181 | extern bool_t wait_complete(TCB *p_tcb);
|
---|
182 |
|
---|
183 | /*
|
---|
184 | * ^CAEgɺ¤Ò¿ð
|
---|
185 | *
|
---|
186 | * p_tcbÅwè³êé^XNªCÒ¿L
|
---|
187 | [ÉÂȪêÄ¢êÎÒ¿L
|
---|
188 | [
|
---|
189 | * ©çíµC^XNóÔðXV·éDܽCÒ¿ðµ½^XN©çÌÔ
|
---|
190 | * lðCwait_tmoutÅÍE_TMOUTCwait_tmout_okÅÍE_OKÆ·éDÒ¿ð
|
---|
191 | * µ½^XNÖÌfBXpb`ªKvÈÍCreqflgðtrueÉ·éD
|
---|
192 | *
|
---|
193 | * wait_tmout_okÍCdly_tskÅg¤½ßÌàÌÅCÒ¿L
|
---|
194 | [©çí·é
|
---|
195 | * ðsíÈ¢D
|
---|
196 | *
|
---|
197 | * ¢¸êÌÖàC^CCxgÌR[obNÖƵÄp¢é½ßÌ
|
---|
198 | * àÌÅCÝnh©çÄÑo³êé±ÆðzèµÄ¢éD
|
---|
199 | */
|
---|
200 | extern void wait_tmout(TCB *p_tcb);
|
---|
201 | extern void wait_tmout_ok(TCB *p_tcb);
|
---|
202 |
|
---|
203 | /*
|
---|
204 | * Ò¿óÔ̧ð
|
---|
205 | *
|
---|
206 | * p_tcbÅwè³êé^XNÌÒ¿óÔð§IÉð·éDïÌIÉÍC
|
---|
207 | * ^XNªÒ¿L
|
---|
208 | [ÉÂȪêÄ¢êÎÒ¿L
|
---|
209 | [©çíµC^CC
|
---|
210 | * xgubNªo^³êÄ¢êλêðo^ð·éDܽC^XNÌ
|
---|
211 | * óÔðXVµCÒ¿ðµ½^XN©çÌÔlðE_RLWAIÆ·éDܽC
|
---|
212 | * Ò¿ðµ½^XNÖÌfBXpb`ªKvÈêÉÍtrueðÔ·D
|
---|
213 | */
|
---|
214 | extern bool_t wait_release(TCB *p_tcb);
|
---|
215 |
|
---|
216 | /*
|
---|
217 | * Ò¿L
|
---|
218 | [ÌæªÌ^XNID
|
---|
219 | *
|
---|
220 | * p_wait_queueÅwèµ½Ò¿L
|
---|
221 | [ÌæªÌ^XNIDðÔ·DÒ¿L
|
---|
222 | [
|
---|
223 | * ªóÌêÉÍCTSK_NONEðÔ·D
|
---|
224 | */
|
---|
225 | Inline ID
|
---|
226 | wait_tskid(QUEUE *p_wait_queue)
|
---|
227 | {
|
---|
228 | if (!queue_empty(p_wait_queue)) {
|
---|
229 | return(TSKID((TCB *) p_wait_queue->p_next));
|
---|
230 | }
|
---|
231 | else {
|
---|
232 | return(TSK_NONE);
|
---|
233 | }
|
---|
234 | }
|
---|
235 |
|
---|
236 | /*
|
---|
237 | * ¯úEÊMIuWFNgÌÇubN̤ʪì[`
|
---|
238 | *
|
---|
239 | * ¯úEÊMIuWFNgÌú»ubNÆÇubNÌ檪ͤ
|
---|
240 | * ÊÉÈÁÄ¢éDȺÍC»Ì¤Êªðµ¤½ßÌ^¨æÑ[`Q
|
---|
241 | * Å éD
|
---|
242 | *
|
---|
243 | * ¡ÌÒ¿L
|
---|
244 | [ð¯úEÊMIuWFNgÌêCæªÈOÌÒ¿
|
---|
245 | * L
|
---|
246 | [ðì·éêÉÍC±êçÌ[`Íg¦È¢DܽCIuWF
|
---|
247 | * Ng®«ÌTA_TPRIrbgðQÆ·éÌÅC±Ìrbgð¼ÌÚIÉgÁÄ
|
---|
248 | * ¢éêàC±êçÌ[`Íg¦È¢D
|
---|
249 | */
|
---|
250 |
|
---|
251 | /*
|
---|
252 | * ¯úEÊMIuWFNgÌú»ubN̤ʪ
|
---|
253 | */
|
---|
254 | typedef struct wait_object_initialization_block {
|
---|
255 | ATR wobjatr; /* IuWFNg®« */
|
---|
256 | } WOBJINIB;
|
---|
257 |
|
---|
258 | /*
|
---|
259 | * ¯úEÊMIuWFNgÌÇubN̤ʪ
|
---|
260 | */
|
---|
261 | typedef struct wait_object_control_block {
|
---|
262 | QUEUE wait_queue; /* Ò¿L
|
---|
263 | [ */
|
---|
264 | const WOBJINIB *p_wobjinib; /* ú»ubNÖÌ|C^ */
|
---|
265 | } WOBJCB;
|
---|
266 |
|
---|
267 | /*
|
---|
268 | * ¯úEÊMIuWFNgÌÒ¿îñubN̤ʪ
|
---|
269 | *
|
---|
270 | * ±Ì\¢ÌÍCÒ¿îñubNiWINFOjðg£iIuWFNgwü¾
|
---|
271 | * êÌp³Éjµ½àÌÅ éªCWINFOª¤pÌÅè`³êÄ¢é½
|
---|
272 | * ßÉC1ÂÌtB[hƵÄÜßÄ¢éD
|
---|
273 | */
|
---|
274 | typedef struct wait_object_waiting_information {
|
---|
275 | WINFO winfo; /* WÌÒ¿îñubN */
|
---|
276 | WOBJCB *p_wobjcb; /* Ò¿IuWFNgÌÇubN */
|
---|
277 | } WINFO_WOBJ;
|
---|
278 |
|
---|
279 | /*
|
---|
280 | * ¯úEÊMIuWFNgÉηéÒ¿óÔÖÌJÚ
|
---|
281 | *
|
---|
282 | * ÀsÌ^XNðÒ¿óÔÉJÚ³¹C¯úEÊMIuWFNgÌÒ¿L
|
---|
283 | [
|
---|
284 | * ÉÂÈ®DܽCÒ¿îñubNiWINFOjÌp_wobjcbðÝè·éD
|
---|
285 | * wobj_make_wait_tmoutÍC^CCxgubNÌo^às¤D
|
---|
286 | */
|
---|
287 | extern void wobj_make_wait(WOBJCB *p_wobjcb, WINFO_WOBJ *p_winfo);
|
---|
288 | extern void wobj_make_wait_tmout(WOBJCB *p_wobjcb, WINFO_WOBJ *p_winfo,
|
---|
289 | TMEVTB *p_tmevtb, TMO tmout);
|
---|
290 |
|
---|
291 | /*
|
---|
292 | * ^XNDæxÏXÌ
|
---|
293 | *
|
---|
294 | * ¯úEÊMIuWFNgÉηéÒ¿óÔÉ é^XNÌDæxªÏX³
|
---|
295 | * ê½êÉCÒ¿L
|
---|
296 | [ÌÅÌ^XNÌÊuðC³·éD
|
---|
297 | */
|
---|
298 | Inline void
|
---|
299 | wobj_change_priority(WOBJCB *p_wobjcb, TCB *p_tcb)
|
---|
300 | {
|
---|
301 | if ((p_wobjcb->p_wobjinib->wobjatr & TA_TPRI) != 0U) {
|
---|
302 | queue_delete(&(p_tcb->task_queue));
|
---|
303 | queue_insert_tpri(&(p_wobjcb->wait_queue), p_tcb);
|
---|
304 | }
|
---|
305 | }
|
---|
306 |
|
---|
307 | /*
|
---|
308 | * Ò¿L
|
---|
309 | [Ìú»
|
---|
310 | *
|
---|
311 | * Ò¿L
|
---|
312 | [ÉÂȪêÄ¢é^XNð·×ÄÒ¿ð·éDÒ¿ðµ½
|
---|
313 | * ^XN©çÌÔlÍCE_DLTÆ·éDÒ¿ðµ½^XNÖÌfBXpb`
|
---|
314 | * ªKvÈêÍtrueC»¤ÅÈ¢êÍfalseðÔ·D
|
---|
315 | */
|
---|
316 | extern bool_t init_wait_queue(QUEUE *p_wait_queue);
|
---|
317 |
|
---|
318 | #endif /* TOPPERS_WAIT_H */
|
---|