T-Kernel Specification (1.B0.02)

More documents

Recommendations

Info

viii CONTENTS isDI (Get Interrupt Disable Status) . . . . . . . . . . . . . . . . . . . . 248 5.4.2 Control of Interrupt Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 DINTNO (Get Interrupt Definition Number) . . . . . . . . . . . . . . . . 249 EnableInt (Enable Interrupt (Level)) . . . . . . . . . . . . . . . . . . . 249 DisableInt (Disable Interrupt) . . . . . . . . . . . . . . . . . . . . . . 249 ClearInt (Clear Interrupts) . . . . . . . . . . . . . . . . . . . . . . . . 249 EndOfInt (Issue End of Interrupt) . . . . . . . . . . . . . . . . . . . . . 249 CheckInt (Check Interrupt) . . . . . . . . . . . . . . . . . . . . . . . . 250 5.5 IO Port Access Support Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 5.5.1 IO Port Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 out w (Write Word Data) . . . . . . . . . . . . . . . . . . . . . . . . . . 251 out h (Write Half-Word Data) . . . . . . . . . . . . . . . . . . . . . . . 251 out b (Write Byte Data) . . . . . . . . . . . . . . . . . . . . . . . . . . 251 in w (Read Word Data) . . . . . . . . . . . . . . . . . . . . . . . . . . 251 in h (Read Half-Word Data) . . . . . . . . . . . . . . . . . . . . . . . . 251 in b (Read Byte Data) . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 5.5.2 Microwait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251 WaitUsec (Microwait (Nanoseconds)) . . . . . . . . . . . . . . . . . . . 251 WaitNsec (Microwait (Microseconds)) . . . . . . . . . . . . . . . . . . . 251 5.6 Power Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 low pow (Enter Low-Power Mode) . . . . . . . . . . . . . . . . . . . . . 252 off pow (Suspend System) . . . . . . . . . . . . . . . . . . . . . . . . . 252 5.7 System Configuration Information Management Functions . . . . . . . . . . . . . . . . . 253 5.7.1 System Configuration Information Acquisition . . . . . . . . . . . . . . . . . . . 253 tk get cfn (Get Numeric String) . . . . . . . . . . . . . . . . . . . . . 253 tk get cfs (Get Character String) . . . . . . . . . . . . . . . . . . . . 254 5.7.2 Standard System Configuration Information . . . . . . . . . . . . . . . . . . . . . 254 5.8 Subsystem and Device Driver Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 6 T-Kernel/DS Functions 259 6.1 Kernel Internal State Acquisition Functions . . . . . . . . . . . . . . . . . . . . . . . . . 259 td lst tsk (Reference Object ID List) . . . . . . . . . . . . . . . . . . . . . . . 260 td lst sem (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst flg (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst mbx (Reference Object ID List) . . . . . . . . . . . . . . . . . . . . . . . 260 td lst mtx (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst mbf (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst por (Reference Object ID List) . . . . . . . . . . . . . . . . . . . . . . . 260 td lst mpf (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst mpl (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst cyc (Reference Object ID List) . . . . . . . . . . . . . . . . . . . . . . . 260 td lst alm (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td lst ssy (Reference Object Id List) . . . . . . . . . . . . . . . . . . . . . . . . 260 td rdy que (Get Task Precedence) . . . . . . . . . . . . . . . . . . . . . . . . . . 261 td sem que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td flg que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td mbx que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td mtx que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td smbf que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td rmbf que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 Copyright c○ 2002, 2003 by T-Engine Forum T-Kernel 1.B0.02
CONTENTS ix td cal que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td acp que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td mpf que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td mpl que (Reference Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 td ref tsk (Reference Task State) . . . . . . . . . . . . . . . . . . . . . . . . . . 263 td ref sem (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref flg (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref mbx (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref mtx (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref mbf (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref por (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref mpf (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref mpl (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref cyc (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref alm (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref ssy (Reference Object Status) . . . . . . . . . . . . . . . . . . . . . . . . 265 td ref tex (Reference Task Exception Status) . . . . . . . . . . . . . . . . . . . 268 td inf tsk (Reference Task Statistics) . . . . . . . . . . . . . . . . . . . . . . . 269 td get reg (Get Task Register) . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 td set reg (Set Task Register) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 td ref sys (Reference System Status) . . . . . . . . . . . . . . . . . . . . . . . . 272 td get tim (Get System Time) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 td get otm (Get System Operating Time) . . . . . . . . . . . . . . . . . . . . . 274 6.2 Trace Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 td hoc svc (Define System Call/Extended SVC Hook Routine) . . . . . . . . . 276 td hoc dsp (Define Task Dispatch Hook Routine) . . . . . . . . . . . . . . . . . 278 td hoc int (Define Interrupt Handler Hook Routine) . . . . . . . . . . . . . . . 280 7 Reference 283 7.1 List of C Language Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 7.1.1 T-Kernel/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 7.1.2 T-Kernel/SM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 7.1.3 T-Kernel/DS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 7.2 List of Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 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: CONTENTS vii 5.2.2 Address Space Ch
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 59 and 60:
4.1. TASK MANAGEMENT FUNCTIONS 35 t
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?