T-Kernel Specification (1.B0.02)

More documents

Recommendations

Info

vi CONTENTS tk cre cyc (Create Cyclic Handler) . . . . . . . . . . . . . . . . . . . . 169 tk del cyc (Delete Cyclic Handler) . . . . . . . . . . . . . . . . . . . . 172 tk sta cyc (Start Cyclic Handler) . . . . . . . . . . . . . . . . . . . . . 173 tk stp cyc (Stop Cyclic Handler) . . . . . . . . . . . . . . . . . . . . . 174 tk ref cyc (Reference Cyclic Handler Status) . . . . . . . . . . . . . . 175 4.7.3 Alarm Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 tk cre alm (Create Alarm Handler) . . . . . . . . . . . . . . . . . . . . 177 tk del alm (Delete Alarm Handler) . . . . . . . . . . . . . . . . . . . . 179 tk sta alm (Start Alarm Handler) . . . . . . . . . . . . . . . . . . . . 180 tk stp alm (Stop Alarm Handler) . . . . . . . . . . . . . . . . . . . . . 181 tk ref alm (Reference Alarm Handler Status) . . . . . . . . . . . . . . 182 4.8 Interrupt Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 tk def int (Define Interrupt Handler) . . . . . . . . . . . . . . . . . . . . . . . 185 tk ret int (Return from Interrupt Handler) . . . . . . . . . . . . . . . . . . . . 188 4.9 System Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 tk rot rdq (Rotate Ready Queue) . . . . . . . . . . . . . . . . . . . . . . . . . . 191 tk get tid (Get Task Identifier) . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 tk dis dsp (Disable Dispatch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 tk ena dsp (Enable Dispatch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 tk ref sys (Reference System Status) . . . . . . . . . . . . . . . . . . . . . . . . 197 tk set pow (Set Power Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 tk ref ver (Reference Version Information) . . . . . . . . . . . . . . . . . . . . 201 4.10 Subsystem Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 tk def ssy (Define Subsystem) . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 tk sta ssy (Call Startup Function of Sub-System) . . . . . . . . . . . . . . . . . 211 tk cln ssy (Call Cleanup Function of Sub-System) . . . . . . . . . . . . . . . . 211 tk evt ssy (Call Event Function of Sub-System) . . . . . . . . . . . . . . . . . . 212 tk ref ssy (Reference Subsystem Status) . . . . . . . . . . . . . . . . . . . . . . 213 tk cre res (Create Resource Group) . . . . . . . . . . . . . . . . . . . . . . . . 214 tk del res (Delete Resource Group) . . . . . . . . . . . . . . . . . . . . . . . . 216 tk get res (Get Resource Management Block) . . . . . . . . . . . . . . . . . . . 217 5 T-Kernel/SM 219 5.1 System Memory Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 5.1.1 System Memory Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 tk get smb (Allocate System Memory Block) . . . . . . . . . . . . . . 220 tk rel smb (Release System Memory Block) . . . . . . . . . . . . . . . 220 tk ref smb (Reference System Memory Block) . . . . . . . . . . . . . . 220 5.1.2 Memory Allocation Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 Vmalloc (Allocate Nonresident Memory) . . . . . . . . . . . . . . . . . 221 Vcalloc (Allocate Nonresident Memory Elements) . . . . . . . . . . . 221 Vrealloc (Reallocate Nonresident Memory) . . . . . . . . . . . . . . . 221 Vfree (Release Nonresident Memory) . . . . . . . . . . . . . . . . . . . 221 Kmalloc (Allocate Resident Memory) . . . . . . . . . . . . . . . . . . . 221 Kcalloc (Allocate Resident Memory Elements) . . . . . . . . . . . . . 221 Krealloc (Reallocate Resident Memory) . . . . . . . . . . . . . . . . . 221 Kfree (Release Resident Memory) . . . . . . . . . . . . . . . . . . . . . 221 5.2 Address Space Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 5.2.1 Address Space Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 SetTaskSpace (Set Task Space) . . . . . . . . . . . . . . . . . . . . . . 222 Copyright c○ 2002, 2003 by T-Engine Forum T-Kernel 1.B0.02
CONTENTS vii 5.2.2 Address Space Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 ChkSpaceR (Check Read Access Privilege) . . . . . . . . . . . . . . . . 223 ChkSpaceRW (Check Read-Write Access Privilege) . . . . . . . . . . . . 223 ChkSpaceRE (Check Read-Execute Access Privilege) . . . . . . . . . . . 223 ChkSpaceBstrR (Check Read Access Privilege (String)) . . . . . . . . . 223 ChkSpaceBstrRW (Check Read-Write Access Privilege (String)) . . . . 223 ChkSpaceTstrR (Check Read Access Privilege (TRON Code)) . . . . . 223 ChkSpaceTstrRW (Check Read-Write Access Privilege (TRON Code)) . 223 5.2.3 Lock Address Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 LockSpace (Lock Address Space) . . . . . . . . . . . . . . . . . . . . . 223 UnlockSpace (Unlock Address Space) . . . . . . . . . . . . . . . . . . . 223 5.2.4 Get Physical Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 CnvPhysicalAddr (Get Physical Address) . . . . . . . . . . . . . . . . 224 5.2.5 Map Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 MapMemory (Map Memory) . . . . . . . . . . . . . . . . . . . . . . . . . 224 UnmapMemory (Unmap Memory) . . . . . . . . . . . . . . . . . . . . . . 225 5.3 Device Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 5.3.1 Basic Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Device Name (UB* type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Device ID (ID type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Device Attribute (ATR type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 Device Descriptor (ID type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Request ID (ID type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 Data Number (INT type) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 5.3.2 Application Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 tk opn dev (Open Device) . . . . . . . . . . . . . . . . . . . . . . . . . 229 tk cls dev (Close Device) . . . . . . . . . . . . . . . . . . . . . . . . . 230 tk rea dev (Read Device) . . . . . . . . . . . . . . . . . . . . . . . . . 230 tk srea dev (Synchronous Read) . . . . . . . . . . . . . . . . . . . . . 231 tk wri dev (Write Device) . . . . . . . . . . . . . . . . . . . . . . . . . 231 tk swri dev (Synchronous Write) . . . . . . . . . . . . . . . . . . . . . 232 tk wai dev (Wait Device) . . . . . . . . . . . . . . . . . . . . . . . . . 232 tk sus dev (Suspend Device) . . . . . . . . . . . . . . . . . . . . . . . 233 tk get dev (Get Device Name) . . . . . . . . . . . . . . . . . . . . . . 235 tk ref dev (Reference Device by Device Name) . . . . . . . . . . . . . 235 tk oref dev (Reference Device by Device Descriptor) . . . . . . . . . . 235 tk lst dev (Get Registered Device Information) . . . . . . . . . . . . . 235 tk evt dev (Send Driver Request Event) . . . . . . . . . . . . . . . . . 236 5.3.3 Device Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 tk def dev (Register Device) . . . . . . . . . . . . . . . . . . . . . . . 237 tk ref idv (Reference Device Initialization Information) . . . . . . . . 238 5.3.4 Device Driver Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 5.3.5 Attribute Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 5.3.6 Device Event Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 5.3.7 Device Suspend/Resume Processing . . . . . . . . . . . . . . . . . . . . . . . . . 246 5.3.8 Special Properties of Disk Devices . . . . . . . . . . . . . . . . . . . . . . . . . . 247 5.4 Interrupt Management Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 5.4.1 CPU Interrupt Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 DI (Disable Interrupts) . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 EI (Enable Interrupts) . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 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: CONTENTS v tk set flg (Set Event Fl
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:
4.1. TASK MANAGEMENT FUNCTIONS 33 t
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?