T-Kernel Specification (1.B0.02)

More documents

Recommendations

Info

iv CONTENTS 4 T-Kernel/OS Functions 25 4.1 Task Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 tk cre tsk (Create Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 tk del tsk (Delete Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 tk sta tsk (Start Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 tk ext tsk (Exit Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 tk exd tsk (Exit and Delete Task) . . . . . . . . . . . . . . . . . . . . . . . . . 34 tk ter tsk (Terminate Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 tk chg pri (Change Task Priority) . . . . . . . . . . . . . . . . . . . . . . . . . 37 tk chg slt (Change Task Slicetime) . . . . . . . . . . . . . . . . . . . . . . . . . 39 tk get tsp (Get Task Space) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 tk set tsp (Set Task Space) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 tk get rid (Get Task Resource ID) . . . . . . . . . . . . . . . . . . . . . . . . . 43 tk set rid (Set Task Resource ID) . . . . . . . . . . . . . . . . . . . . . . . . . 44 tk get reg (Get Task Registers) . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 tk set reg (Set Task Registers) . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 tk get cpr (Get Task Coprocessor Registers) . . . . . . . . . . . . . . . . . . . . 47 tk set cpr (Set Task Coprocessor Registers) . . . . . . . . . . . . . . . . . . . . 48 tk inf tsk (Get Task Information) . . . . . . . . . . . . . . . . . . . . . . . . . 49 tk ref tsk (Reference Task Status) . . . . . . . . . . . . . . . . . . . . . . . . . 50 4.2 Task-Dependent Synchronization Functions . . . . . . . . . . . . . . . . . . . . . . . . . 53 tk slp tsk (Sleep Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 tk wup tsk (Wakeup Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 tk can wup (Cancel Wakeup Task) . . . . . . . . . . . . . . . . . . . . . . . . . . 56 tk rel wai (Release Wait) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 tk sus tsk (Suspend Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 tk rsm tsk (Resume Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 tk frsm tsk (Force Resume Task) . . . . . . . . . . . . . . . . . . . . . . . . . . 61 tk dly tsk (Delay Task) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 tk sig tev (Signal Task Event) . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 tk wai tev (Wait Task Event) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 tk dis wai (Disable Task Wait) . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 tk ena wai (Enable Task Wait) . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 4.3 Task Exception Handling Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 tk def tex (Define Task Exception Handler) . . . . . . . . . . . . . . . . . . . . 70 tk ena tex (Enable Task Exception) . . . . . . . . . . . . . . . . . . . . . . . . 72 tk dis tex (Disable Task Exception) . . . . . . . . . . . . . . . . . . . . . . . . 72 tk ras tex (Raise Task Exception) . . . . . . . . . . . . . . . . . . . . . . . . . 73 tk end tex (End Task Exception Handler) . . . . . . . . . . . . . . . . . . . . . 74 tk ref tex (Reference Task Exception Status) . . . . . . . . . . . . . . . . . . . 76 4.4 Synchronization and Communication Functions . . . . . . . . . . . . . . . . . . . . . . . 77 4.4.1 Semaphore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 tk cre sem (Create Semaphore) . . . . . . . . . . . . . . . . . . . . . . 79 tk del sem (Delete Semaphore) . . . . . . . . . . . . . . . . . . . . . . 81 tk sig sem (Signal Semaphore) . . . . . . . . . . . . . . . . . . . . . . 82 tk wai sem (Wait on Semaphore) . . . . . . . . . . . . . . . . . . . . . 83 tk ref sem (Reference Semaphore Status) . . . . . . . . . . . . . . . . 85 4.4.2 Event Flag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 tk cre flg (Create Event Flag) . . . . . . . . . . . . . . . . . . . . . . 87 tk del flg (Delete Event Flag) . . . . . . . . . . . . . . . . . . . . . . 89 Copyright c○ 2002, 2003 by T-Engine Forum T-Kernel 1.B0.02
CONTENTS v tk set flg (Set Event Flag) . . . . . . . . . . . . . . . . . . . . . . . . 90 tk clr flg (Clear Event Flag) . . . . . . . . . . . . . . . . . . . . . . . 90 tk wai flg (Wait Event Flag) . . . . . . . . . . . . . . . . . . . . . . . 92 tk ref flg (Reference Event Flag Status) . . . . . . . . . . . . . . . . 95 4.4.3 Mailbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 tk cre mbx (Create Mailbox) . . . . . . . . . . . . . . . . . . . . . . . 98 tk del mbx (Delete Mailbox) . . . . . . . . . . . . . . . . . . . . . . . . 100 tk snd mbx (Send Message to Mailbox) . . . . . . . . . . . . . . . . . . 101 tk rcv msg (Receive Message from Mailbox) . . . . . . . . . . . . . . . 103 tk ref mbx (Reference Mailbox Status) . . . . . . . . . . . . . . . . . . 105 4.5 Extended Synchronization and Communication Functions . . . . . . . . . . . . . . . . . 106 4.5.1 Mutex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 tk cre mtx (Create Mutex) . . . . . . . . . . . . . . . . . . . . . . . . 109 tk del mtx (Delete Mutex) . . . . . . . . . . . . . . . . . . . . . . . . . 111 tk loc mtx (Lock Mutex) . . . . . . . . . . . . . . . . . . . . . . . . . 112 tk unl mtx (Unlock Mutex) . . . . . . . . . . . . . . . . . . . . . . . . 114 tk ref mtx (Refer Mutex Status) . . . . . . . . . . . . . . . . . . . . . 115 4.5.2 Message Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 tk cre mbf (Create Message Buffer) . . . . . . . . . . . . . . . . . . . . 118 tk del mbf (Delete Message Buffer) . . . . . . . . . . . . . . . . . . . . 120 tk snd mbf (Send Message to Message Buffer) . . . . . . . . . . . . . . 121 tk rcv mbf (Receive Message from Message Buffer) . . . . . . . . . . . 123 tk ref mbf (Get Message Buffer Status) . . . . . . . . . . . . . . . . . 125 4.5.3 Rendezvous Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 tk cre por (Create Port for Rendezvous) . . . . . . . . . . . . . . . . . 129 tk del por (Delete Port for Rendezvous) . . . . . . . . . . . . . . . . . 131 tk cal por (Call Port for Rendezvous) . . . . . . . . . . . . . . . . . . 132 tk acp por (Accept Port for Rendezvous) . . . . . . . . . . . . . . . . 134 tk fwd por (Forward Rendezvous to Other Port) . . . . . . . . . . . . 138 tk rpl rdv (Reply Rendezvous) . . . . . . . . . . . . . . . . . . . . . . 142 tk ref por (Reference Port Status) . . . . . . . . . . . . . . . . . . . . 144 4.6 Memory Pool Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 4.6.1 Fixed-size Memory Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 tk cre mpf (Create Fixed-size Memory Pool) . . . . . . . . . . . . . . 148 tk del mpf (Delete Fixed-size Memory Pool) . . . . . . . . . . . . . . . 150 tk get mpf (Get Fixed-size Memory Block) . . . . . . . . . . . . . . . 151 tk rel mpf (Release Fixed-size Memory Block) . . . . . . . . . . . . . 153 tk ref mpf (Reference Fixed-size Memory Pool Status) . . . . . . . . . 154 4.6.2 Variable-size Memory Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 tk cre mpl (Create Variable-size Memory Pool) . . . . . . . . . . . . . 156 tk del mpl (Delete Variable-size Memory Pool) . . . . . . . . . . . . . 158 tk get mpl (Get Variable-size Memory Block) . . . . . . . . . . . . . . 159 tk rel mpl (Release Variable-size Memory Block) . . . . . . . . . . . . 161 tk ref mpl (Reference Variable-size Memory Pool Status) . . . . . . . 162 4.7 Time Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 4.7.1 System Time Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 tk set tim (Set Time) . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 tk get tim (Get Time) . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 tk get otm (Get Operating Time) . . . . . . . . . . . . . . . . . . . . . 167 4.7.2 Cyclic Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 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: Contents 1 T-Kernel Overview 1 1.1
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 55 and 56:
4.1. TASK MANAGEMENT FUNCTIONS 31 t
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
4.2. TASK-DEPENDENT SYNCHRONIZATION
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
4.3. TASK EXCEPTION HANDLING FUNCTI
Page 95 and 96:
Page 97 and 98:
Page 99 and 100:
Page 101 and 102:
4.4. SYNCHRONIZATION AND COMMUNICAT
Page 103 and 104:
Page 105 and 106:
Page 107 and 108:
Page 109 and 110:
Page 111 and 112:
Page 113 and 114:
Page 115 and 116:
Page 117 and 118:
Page 119 and 120:
Page 121 and 122:
Page 123 and 124:
Page 125 and 126:
Page 127 and 128:
Page 129 and 130:
Page 131 and 132:
4.5. EXTENDED SYNCHRONIZATION AND C
Page 133 and 134:
Page 135 and 136:
Page 137 and 138:
Page 139 and 140:
Page 141 and 142:
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?