T-Kernel Specification (1.B0.02)

More documents

Recommendations

Info

66 CHAPTER 4. T-KERNEL/OS FUNCTIONS tk dis wai Disable Task Wait [C Language Interface] INT tskwait = tk_dis_wai ( ID tskid, UINT waitmask ) ; [Parameters] ID tskid Task ID UINT waitmask Task wait disabled setting [Return Parameters] INT tskwait Task state after task wait disabled or Error Code [Error Codes] E OK E ID E NOEXS E PAR Normal completion Invalid ID number (tskid is invalid or cannot be used) Object does not exist (the task designated in tskid does not exist) Parameter error (waitmask is invalid) [Description] Disables waits for the wait factors set in waitmask by the task designated in tskid. If the task is already waiting for a factor designated in waitmask, that wait is released. waitmask is designated as the logical OR of any combination of the following wait factors. #define TTW_SLP 0x00000001 /* Wait caused by sleep */ #define TTW_DLY 0x00000002 /* Wait for task delay */ #define TTW_SEM 0x00000004 /* Wait for semaphore */ #define TTW_FLG 0x00000008 /* Wait for event flag */ #define TTW_MBX 0x00000040 /* Wait for mailbox */ #define TTW_MTX 0x00000080 /* Wait for mutex */ #define TTW_SMBF 0x00000100 /* Wait for message buffer sending */ #define TTW_RMBF 0x00000200 /* Wait for message buffer receipt */ #define TTW_CAL 0x00000400 /* Wait on rendezvous call */ #define TTW_ACP 0x00000800 /* Wait for rendezvous acceptance */ #define TTW_RDV 0x00001000 /* Wait for rendezvous completion */ #define TTW_MPF 0x00002000 /* Wait for fixed-size memory pool */ #define TTW_MPL 0x00004000 /* Wait for variable-size memory pool */ #define TTW_EV1 0x00010000 /* Wait for task event #1 */ #define TTW_EV2 0x00020000 /* Wait for task event #2 */ #define TTW_EV3 0x00040000 /* Wait for task event #3 */ Copyright c○ 2002, 2003 by T-Engine Forum T-Kernel 1.B0.02
4.2. TASK-DEPENDENT SYNCHRONIZATION FUNCTIONS 67 #define TTW_EV4 0x00080000 /* Wait for task event #4 */ #define TTW_EV5 0x00100000 /* Wait for task event #5 */ #define TTW_EV6 0x00200000 /* Wait for task event #6 */ #define TTW_EV7 0x00400000 /* Wait for task event #7 */ #define TTW_EV8 0x00800000 /* Wait for task event #8 */ #define TTX_SVC 0x80000000 /* Extended SVC disabled */ TTX SVC is a special designation disabling not task wait but the calling of an extended SVC. If TTX SVC is designated when a task attempts to call an extended SVC, E DISWAI is returned without calling the extended SVC. This designation does not have the effect of terminating an already called extended SVC. A tskwait value of 0 means the task has not entered WAIT state (or the wait was released). If tskwait is not 0, this means the task is in WAIT state for a cause other than those disabled in waitmask. When a task wait is cleared by tk dis wai or the task is prevented from entering WAIT state while this system call is in effect, E DISWAI is returned. When a system call for which there is the possibility of entering a WAIT state is invoked during wait disabled state, E DISWAI is returned even if the processing could be performed without waiting. For example, even if message buffer space is available when tk snd mbf is called and message buffer sending is possible without entering a WAIT state, E DISWAI is returned and the message is not sent. A wait disable set while an extended SVC is executing will be cleared automatically upon return from the extended SVC to its caller. It is automatically cleared also when an extended SVC is called, reverting to the original setting upon return from the extended SVC. A wait disable setting is cleared also when the task reverts to DORMANT state. The setting made while a task is in DORMANT state, however, is valid and the wait disable is applied the next time the task is started. In the case of semaphores and most other objects, TA NODISWAI can be designated when the object is created. An object created with TA NODISWAI designated cannot have waits disabled, and rejects any wait disable attempt by tk dis wai. The invoking task can be designated by setting tskid = TSK SELF = 0. Note, however, that when a system call is issued from a task-independent portion and tskid = TSK SELF = 0 is designated, error code E ID is returned. [Additional Notes] The wait disable function is provided for preventing execution of an extended SVC handler and is for use mainly (though not exclusively) in break functions. Wait disable in the case of a rendezvous is more complex than other cases. Essentially, wait disabled state is detected based on a change in the rendezvous wait state, then the wait is released. Some specific examples are given here. When waiting by TTW CAL is not disabled but TTW RDV waits are disabled, a task enters into wait on rendezvous call state; but when the rendezvous is accepted and a wait for rendezvous completion would normally begin, the wait is released and E DISWAI is returned. At this time a message is sent to the receiving task, the receiving task declares acceptance of the message and the task goes to rendezvous established state. Only when the accepting task replies (tk rpl rdv) does it become clear that there is no other task in the rendezvous, and error code E OBJ is returned. Wait disable applies also when a rendezvous is forwarded. In that case the attribute of the destination rendezvous port applies. That is, if the TA NODISWAI attribute is designated for the destination port, wait disable is rejected. If TTW CAL wait is disabled after going to wait for rendezvous completion state, and a rendezvous is forwarded in that state, the state goes to WAIT on rendezvous call as a result of the forwarding, so wait is disabled by the TTW CAL designation. In that case E DISWAI is returned to both the rendezvous calling task (tk cal por) and forwarding task (tk fwd por). Copyright c○ 2002, 2003 by T-Engine Forum T-Kernel 1.B0.02
Page 1 and 2:
T-Kernel Specification T-Kernel 1.B
Page 3 and 4:
Contents 1 T-Kernel Overview 1 1.1
Page 5 and 6:
CONTENTS v tk set flg (Set Event Fl
Page 7 and 8:
CONTENTS vii 5.2.2 Address Space Ch
Page 9 and 10:
CONTENTS ix td cal que (Reference Q
Page 11 and 12:
List of Figures 1.1 Position of T-K
Page 13 and 14:
List of Tables 2.1 State Transition
Page 15 and 16:
System Call Notation In the parts o
Page 17 and 18:
Index of T-Kernel/OS System Calls T
Page 19 and 20:
INDEX OF T-KERNEL/OS SYSTEM CALLS x
Page 21 and 22:
Index of T-Kernel/SM Extended SVC L
Page 23 and 24:
Index of T-Kernel/DS System Calls T
Page 25 and 26:
Chapter 1 T-Kernel Overview 1.1 Pos
Page 27 and 28:
1.2. SCALABILITY 3 • Middleware m
Page 29 and 30:
Chapter 2 Concepts Underlying the T
Page 31 and 32:
2.2. TASK STATES AND SCHEDULING RUL
Page 33 and 34:
2.2. TASK STATES AND SCHEDULING RUL
Page 35 and 36:
2.3. INTERRUPT HANDLING 11 preceden
Page 37 and 38:
2.5. SYSTEM STATES 13 Transient sta
Page 39 and 40: 2.7. MEMORY 15 which the upper and
Page 41 and 42: Chapter 3 Common T-Kernel Specifica
Page 43 and 44: 3.2. SYSTEM CALLS 19 /* * Common co
Page 45 and 46: 3.2. SYSTEM CALLS 21 Ordinarily a f
Page 47 and 48: 3.3. HIGH-LEVEL LANGUAGE SUPPORT RO
Page 49 and 50: Chapter 4 T-Kernel/OS Functions Thi
Page 51 and 52: 4.1. TASK MANAGEMENT FUNCTIONS 27 t
Page 53 and 54: 4.1. TASK MANAGEMENT FUNCTIONS 29 #
Page 77 and 78: 4.2. TASK-DEPENDENT SYNCHRONIZATION
Page 89: 4.2. TASK-DEPENDENT SYNCHRONIZATION
Page 93 and 94: 4.3. TASK EXCEPTION HANDLING FUNCTI
Page 101 and 102: 4.4. SYNCHRONIZATION AND COMMUNICAT
Page 131 and 132: 4.5. EXTENDED SYNCHRONIZATION AND C
Page 141 and 142:
4.5. EXTENDED SYNCHRONIZATION AND C
Page 143 and 144:
Page 145 and 146:
Page 147 and 148:
Page 149 and 150:
Page 151 and 152:
Page 153 and 154:
Page 155 and 156:
Page 157 and 158:
Page 159 and 160:
Page 161 and 162:
Page 163 and 164:
Page 165 and 166:
Page 167 and 168:
Page 169 and 170:
Page 171 and 172:
4.6. MEMORY POOL MANAGEMENT FUNCTIO
Page 173 and 174:
Page 175 and 176:
Page 177 and 178:
Page 179 and 180:
Page 181 and 182:
Page 183 and 184:
Page 185 and 186:
Page 187 and 188:
4.7. TIME MANAGEMENT FUNCTIONS 163
Page 189 and 190:
Page 191 and 192:
Page 193 and 194:
Page 195 and 196:
Page 197 and 198:
Page 199 and 200:
Page 201 and 202:
Page 203 and 204:
Page 205 and 206:
Page 207 and 208:
Page 209 and 210:
4.8. INTERRUPT MANAGEMENT FUNCTIONS
Page 211 and 212:
Page 213 and 214:
Page 215 and 216:
4.9. SYSTEM MANAGEMENT FUNCTIONS 19
Page 217 and 218:
Page 219 and 220:
Page 221 and 222:
Page 223 and 224:
Page 225 and 226:
Page 227 and 228:
Page 229 and 230:
4.10. SUBSYSTEM MANAGEMENT FUNCTION
Page 231 and 232:
Page 233 and 234:
Page 235 and 236:
Page 237 and 238:
Page 239 and 240:
Page 241 and 242:
Page 243 and 244:
Chapter 5 T-Kernel/SM Details of th
Page 245 and 246:
5.1. SYSTEM MEMORY MANAGEMENT FUNCT
Page 247 and 248:
5.2. ADDRESS SPACE MANAGEMENT FUNCT
Page 249 and 250:
5.2. ADDRESS SPACE MANAGEMENT FUNCT
Page 251 and 252:
5.3. DEVICE MANAGEMENT FUNCTIONS 22
Page 253 and 254:
Page 255 and 256:
Page 257 and 258:
Page 259 and 260:
Page 261 and 262:
Page 263 and 264:
Page 265 and 266:
Page 267 and 268:
Page 269 and 270:
Page 271 and 272:
Page 273 and 274:
Page 275 and 276:
5.5. IO PORT ACCESS SUPPORT FUNCTIO
Page 277 and 278:
5.7. SYSTEM CONFIGURATION INFORMATI
Page 279 and 280:
5.7. SYSTEM CONFIGURATION INFORMATI
Page 281:
5.8. SUBSYSTEM AND DEVICE DRIVER ST
Page 284 and 285:
260 CHAPTER 6. T-KERNEL/DS FUNCTION
Page 286 and 287:
Page 288 and 289:
Page 290 and 291:
Page 292 and 293:
Page 294 and 295:
Page 296 and 297:
Page 298 and 299:
Page 300 and 301:
Page 302 and 303:
Page 304 and 305:
Page 306 and 307:
Page 308 and 309:
284 CHAPTER 7. REFERENCE INT tevptn
Page 310 and 311:
286 CHAPTER 7. REFERENCE ER ercd =
Page 312 and 313:
288 CHAPTER 7. REFERENCE INT ct = t
Page 314:
290 CHAPTER 7. REFERENCE E OACV ERC
show all

T-Kernel Specification (1.B0.02)

Create successful ePaper yourself

Delete template?

Save as template?