[3869b53] | 1 | @c |
---|
[086a898a] | 2 | @c COPYRIGHT (c) 1988-1999. |
---|
| 3 | @c On-Line Applications Research Corporation (OAR). |
---|
| 4 | @c All rights reserved. |
---|
| 5 | @c |
---|
[3869b53] | 6 | @c This is the chapter from the RTEMS ITRON User's Guide that |
---|
| 7 | @c documents the services provided by the task |
---|
| 8 | @c manager. |
---|
| 9 | @c |
---|
| 10 | @c $Id$ |
---|
| 11 | @c |
---|
| 12 | |
---|
| 13 | @chapter ITRON Implementation Status |
---|
| 14 | |
---|
| 15 | @section Introduction |
---|
| 16 | |
---|
| 17 | This chapter describes the status of the implementation of each |
---|
| 18 | manager in the RTEMS implementataion of the uITRON 3.0 API. The |
---|
| 19 | status of each manager is presented in terms of documentation and |
---|
| 20 | status relative to the extended level (level 'E') of the uITRON 3.0 |
---|
| 21 | API specification. The extended level of the specification is |
---|
| 22 | the level at which dynamic object creation, deletion, and |
---|
| 23 | reference services are available. This level is more akin to the other |
---|
| 24 | APIs supported by RTEMS. This purpose of this chapter is |
---|
| 25 | to make it clear what is required to bring the RTEMS |
---|
| 26 | uITRON API implementation into compliance with the |
---|
| 27 | specification. The following description of the specification |
---|
| 28 | levels is taken from the uITRON 3.0 API specification. |
---|
| 29 | |
---|
| 30 | |
---|
| 31 | uITRON 3.0 specification is divided into fewer system call levels than was the |
---|
| 32 | previous uITRON 2.0 specification. There are now just three levels: Level R |
---|
| 33 | (Required), Level S (Standard) and Level E (Extended). In addition to these |
---|
| 34 | three levels, there is also Level C for CPU-dependent system calls. |
---|
| 35 | In addition, the uITRON 3.0 API, defines the network level ('N') which |
---|
| 36 | represents system calls that support the connection function |
---|
| 37 | |
---|
| 38 | @itemize @bullet |
---|
| 39 | @item [level R] (Required) |
---|
| 40 | The functions in this level are mandatory for all implementations of |
---|
| 41 | uITRON 3.0 specification. This includes basic functions for achieving |
---|
| 42 | a real-time, multitasking OS. These functions can be implemented even |
---|
| 43 | without a hardware timer. This level corresponds to Levels 1 and 2 |
---|
| 44 | of uITRON 2.0 specification. |
---|
| 45 | |
---|
| 46 | @item [level S] (Standard) |
---|
| 47 | This includes basic functions for achieving a real-time, multitasking |
---|
| 48 | OS. This level corresponds to Levels 3 and 4 of uITRON 2.0 |
---|
| 49 | specification. |
---|
| 50 | |
---|
| 51 | @item [level E] (Extended) |
---|
| 52 | This includes additional and extended functions. This corresponds to |
---|
| 53 | functions not included in uITRON 2.0 specification (functions of |
---|
| 54 | ITRON2 specification). Specifically, this level includes object |
---|
| 55 | creation and deletion functions, rendezvous functions, memorypools |
---|
| 56 | and the timer handler. |
---|
| 57 | |
---|
| 58 | @item [level C] (CPU dependent) |
---|
| 59 | This level provides implementation-dependent functions required due to |
---|
| 60 | the CPU or hardware configuration. |
---|
| 61 | |
---|
| 62 | @end itemize |
---|
| 63 | |
---|
| 64 | The support level of the connection function is indicated by appending an 'N' |
---|
| 65 | to the end of the level. For example, connectivity supported at [level S] |
---|
| 66 | would be referred to as [level SN]. The support level for functions which |
---|
| 67 | can only send requests for operations on other nodes but offer no system call |
---|
| 68 | processing on the issuing node itself are indicated by the lower case letter |
---|
| 69 | 's' or 'e'. |
---|
| 70 | |
---|
| 71 | @c |
---|
| 72 | @c Task |
---|
| 73 | @c |
---|
| 74 | |
---|
[b671c6a] | 75 | @section Task Status |
---|
[3869b53] | 76 | |
---|
| 77 | @itemize @bullet |
---|
| 78 | |
---|
| 79 | @item Implementation |
---|
| 80 | @itemize @bullet |
---|
[b671c6a] | 81 | @item cre_tsk - Complete, Pending Review |
---|
| 82 | @item del_tsk - Complete, Pending Review |
---|
| 83 | @item sta_tsk - Complete, Pending Review |
---|
| 84 | @item ext_tsk - Complete, Pending Review |
---|
| 85 | @item exd_tsk - Complete, Pending Review |
---|
| 86 | @item ter_tsk - Complete, Pending Review |
---|
| 87 | @item dis_dsp - Complete, Pending Review |
---|
| 88 | @item ena_dsp - Complete, Pending Review |
---|
| 89 | @item chg_pri - Complete, Pending Review |
---|
| 90 | @item rot_rdq - Complete, Pending Review |
---|
[3869b53] | 91 | @item rel_wai - Stub, Needs to be Fleshed Out |
---|
[b671c6a] | 92 | @item get_tid - Complete, Pending Review |
---|
| 93 | @item ref_tsk - Complete, Pending Review |
---|
| 94 | |
---|
| 95 | @item Notes: |
---|
| 96 | @itemize @bullet |
---|
| 97 | @item None |
---|
| 98 | @end itemize |
---|
| 99 | |
---|
[3869b53] | 100 | @end itemize |
---|
| 101 | |
---|
| 102 | @item Executive Modifications |
---|
| 103 | @itemize @bullet |
---|
| 104 | @item None Expected |
---|
| 105 | @end itemize |
---|
| 106 | |
---|
| 107 | @item Testing |
---|
| 108 | @itemize @bullet |
---|
[b671c6a] | 109 | @item itron01 - Hello world |
---|
| 110 | @item itron02 - Semaphore test |
---|
| 111 | @item itron03 - directives: ex_init, ex_start, t_create, |
---|
| 112 | t_start, tm_tick, i_return, t_ident, tm_set, tm_get, tm_wkafter |
---|
| 113 | See .doc file, verify correct |
---|
| 114 | @item itron04 - Doc file needed |
---|
| 115 | @item itron05 - directives: ext_tsk, cre_tsk, sta_tsk, rot_rdq |
---|
| 116 | ex_start, t_create, t_start, tm_tick, i_return, t_ident, t_delete, |
---|
| 117 | tm_wkafter, t_setpri, t_suspend |
---|
| 118 | See .doc file, verify correct |
---|
| 119 | @item itron06 - Doc file needed |
---|
| 120 | @item itron07 - Doc file needed |
---|
| 121 | @item itron08 - Doc file needed |
---|
| 122 | @item itron09 - Doc file needed |
---|
| 123 | @item itron10 - Doc file needed |
---|
| 124 | @item tmitron01 - Doc file needed |
---|
| 125 | @item tm_include - Doc file needed. Timing test for semaphores. |
---|
[3869b53] | 126 | @end itemize |
---|
| 127 | |
---|
| 128 | @item Documentation |
---|
| 129 | @itemize @bullet |
---|
[b671c6a] | 130 | @item Complete, Pending Review |
---|
[3869b53] | 131 | @end itemize |
---|
| 132 | |
---|
| 133 | @item ITRON 3.0 API Conformance |
---|
| 134 | @itemize @bullet |
---|
| 135 | @item Level E - Extended Functionality |
---|
| 136 | @end itemize |
---|
| 137 | |
---|
| 138 | @item Level C - CPU Dependent Functionality |
---|
| 139 | @itemize @bullet |
---|
| 140 | @item NA |
---|
| 141 | @end itemize |
---|
| 142 | |
---|
| 143 | @item Level N - Connection Functionality |
---|
| 144 | @itemize @bullet |
---|
| 145 | @item Not implemented |
---|
| 146 | @end itemize |
---|
| 147 | |
---|
| 148 | @end itemize |
---|
| 149 | |
---|
| 150 | @c |
---|
| 151 | @c Task-Dependent Synchronization |
---|
| 152 | @c |
---|
| 153 | |
---|
[b671c6a] | 154 | @section Task-Dependent Synchronization Status |
---|
[3869b53] | 155 | |
---|
| 156 | @itemize @bullet |
---|
| 157 | |
---|
| 158 | @item Implementation |
---|
| 159 | @itemize @bullet |
---|
[b671c6a] | 160 | @item sus_tsk - Complete, Pending Review |
---|
| 161 | @item rsm_tsk - Complete, Pending Review |
---|
| 162 | @item frsm_tsk - Complete, Pending Review |
---|
| 163 | @item slp_tsk - Stub, Needs to be Fleshed Out |
---|
[3869b53] | 164 | @item tslp_tsk - Stub, Needs to be Fleshed Out |
---|
[b671c6a] | 165 | @item wup_tsk - Stub, Needs to be Fleshed Out |
---|
| 166 | @item can_wup - Stub, Needs to be Fleshed Out |
---|
| 167 | |
---|
| 168 | @item Notes: |
---|
| 169 | @itemize @bullet |
---|
| 170 | @item None |
---|
| 171 | @end itemize |
---|
| 172 | |
---|
[3869b53] | 173 | @end itemize |
---|
| 174 | |
---|
| 175 | @item Executive Modifications |
---|
| 176 | @itemize @bullet |
---|
| 177 | @item None Expected |
---|
| 178 | @end itemize |
---|
| 179 | |
---|
| 180 | @item Testing |
---|
| 181 | @itemize @bullet |
---|
[b671c6a] | 182 | @item Functional tests for complete routines. |
---|
| 183 | @item Yellow line testing needs to be verified. |
---|
[a5f5acad] | 184 | @item No Timing Tests |
---|
[3869b53] | 185 | @end itemize |
---|
| 186 | |
---|
| 187 | @item Documentation |
---|
| 188 | @itemize @bullet |
---|
[b671c6a] | 189 | @item Complete, Pending Review |
---|
| 190 | @item |
---|
[3869b53] | 191 | @end itemize |
---|
| 192 | |
---|
| 193 | @item ITRON 3.0 API Conformance |
---|
| 194 | @itemize @bullet |
---|
| 195 | @item Level E - Extended Functionality |
---|
| 196 | |
---|
| 197 | @item Level C - CPU Dependent Functionality |
---|
| 198 | @itemize @bullet |
---|
| 199 | @item NA |
---|
| 200 | @end itemize |
---|
| 201 | |
---|
| 202 | @item Level N - Connection Functionality |
---|
| 203 | @itemize @bullet |
---|
| 204 | @item Not implemented |
---|
| 205 | @end itemize |
---|
| 206 | @end itemize |
---|
| 207 | |
---|
| 208 | @end itemize |
---|
| 209 | |
---|
| 210 | @c |
---|
| 211 | @c Semaphore |
---|
| 212 | @c |
---|
| 213 | |
---|
| 214 | @section Semaphore |
---|
| 215 | |
---|
| 216 | @itemize @bullet |
---|
| 217 | |
---|
| 218 | @item Implementation |
---|
| 219 | @itemize @bullet |
---|
| 220 | @item cre_sem - Complete, Pending Review |
---|
| 221 | @item del_sem - Complete, Pending Review |
---|
| 222 | @item sig_sem - Complete, Pending Review |
---|
| 223 | @item wai_sem - Complete, Pending Review |
---|
| 224 | @item preq_sem - Complete, Pending Review |
---|
| 225 | @item twai_sem - Complete, Pending Review |
---|
| 226 | @item ref_sem - Complete, Pending Review |
---|
| 227 | @end itemize |
---|
| 228 | |
---|
| 229 | @item Executive Modifications |
---|
| 230 | @itemize @bullet |
---|
| 231 | @item None Required |
---|
| 232 | @end itemize |
---|
| 233 | |
---|
| 234 | @item Testing |
---|
| 235 | @itemize @bullet |
---|
| 236 | @item Yellow Lined BUT Timeout Cases Not Actually Executed |
---|
[a5f5acad] | 237 | @item No Timing Tests |
---|
[3869b53] | 238 | @end itemize |
---|
| 239 | |
---|
| 240 | @item Documentation |
---|
| 241 | @itemize @bullet |
---|
| 242 | @item Complete, Pending Review |
---|
| 243 | @end itemize |
---|
| 244 | |
---|
| 245 | @item ITRON 3.0 API Conformance |
---|
| 246 | @itemize @bullet |
---|
| 247 | @item Level E - Extended Functionality |
---|
| 248 | @itemize @bullet |
---|
| 249 | @item Complete, Pending Review |
---|
| 250 | @end itemize |
---|
| 251 | |
---|
| 252 | @item Level C - CPU Dependent Functionality |
---|
| 253 | @itemize @bullet |
---|
| 254 | @item NA |
---|
| 255 | @end itemize |
---|
| 256 | |
---|
| 257 | @item Level N - Connection Functionality |
---|
| 258 | @itemize @bullet |
---|
| 259 | @item Not implemented |
---|
| 260 | @end itemize |
---|
| 261 | @end itemize |
---|
| 262 | |
---|
| 263 | @end itemize |
---|
| 264 | |
---|
| 265 | @c |
---|
| 266 | @c Eventflags |
---|
| 267 | @c |
---|
| 268 | |
---|
| 269 | @section Eventflags |
---|
| 270 | |
---|
| 271 | @itemize @bullet |
---|
| 272 | |
---|
| 273 | @item Implementation |
---|
| 274 | @itemize @bullet |
---|
| 275 | @item cre_flg - Stub, Needs to be Fleshed Out |
---|
| 276 | @item del_flg - Stub, Needs to be Fleshed Out |
---|
| 277 | @item set_flg - Stub, Needs to be Fleshed Out |
---|
| 278 | @item clr_flg - Stub, Needs to be Fleshed Out |
---|
| 279 | @item wai_flg - Stub, Needs to be Fleshed Out |
---|
| 280 | @item pol_flg - Stub, Needs to be Fleshed Out |
---|
| 281 | @item twai_flg - Stub, Needs to be Fleshed Out |
---|
| 282 | @item ref_flg - Stub, Needs to be Fleshed Out |
---|
| 283 | |
---|
| 284 | @item Notes: |
---|
| 285 | @itemize @bullet |
---|
| 286 | @item Similar in Functionality to Classic API Events Manager |
---|
| 287 | @item Implement Using new SuperCore Event Handler |
---|
| 288 | @end itemize |
---|
| 289 | |
---|
| 290 | @end itemize |
---|
| 291 | |
---|
| 292 | @item Executive Modifications |
---|
| 293 | @itemize @bullet |
---|
| 294 | @item Add SuperCore Events Object Based on Classic Events |
---|
| 295 | @item Redo Classic Events to use SuperCore Events |
---|
| 296 | @end itemize |
---|
| 297 | |
---|
| 298 | @item Testing |
---|
| 299 | @itemize @bullet |
---|
| 300 | @item No Tests Written |
---|
[a5f5acad] | 301 | @item No Timing Tests |
---|
[3869b53] | 302 | @end itemize |
---|
| 303 | |
---|
| 304 | @item Documentation |
---|
| 305 | @itemize @bullet |
---|
[a5f5acad] | 306 | @item Good First Draft. |
---|
| 307 | @item No Information in Operations. |
---|
| 308 | @item Should not use "standard-like" language. |
---|
[3869b53] | 309 | @end itemize |
---|
| 310 | |
---|
| 311 | @item ITRON 3.0 API Conformance |
---|
| 312 | @itemize @bullet |
---|
| 313 | @item Level E - Extended Functionality |
---|
| 314 | @itemize @bullet |
---|
| 315 | @item |
---|
| 316 | @end itemize |
---|
| 317 | |
---|
| 318 | @item Level C - CPU Dependent Functionality |
---|
| 319 | @itemize @bullet |
---|
| 320 | @item NA |
---|
| 321 | @end itemize |
---|
| 322 | |
---|
| 323 | @item Level N - Connection Functionality |
---|
| 324 | @itemize @bullet |
---|
| 325 | @item Not implemented |
---|
| 326 | @end itemize |
---|
| 327 | @end itemize |
---|
| 328 | |
---|
| 329 | @end itemize |
---|
| 330 | |
---|
| 331 | @c |
---|
| 332 | @c Mailbox |
---|
| 333 | @c |
---|
| 334 | |
---|
| 335 | @section Mailbox |
---|
| 336 | |
---|
| 337 | @itemize @bullet |
---|
| 338 | |
---|
| 339 | @item Implementation |
---|
| 340 | @itemize @bullet |
---|
| 341 | @item cre_mbx - Stub, Needs to be Fleshed Out |
---|
| 342 | @item del_mbx - Stub, Needs to be Fleshed Out |
---|
| 343 | @item snd_msg - Stub, Needs to be Fleshed Out |
---|
| 344 | @item rcv_msg - Stub, Needs to be Fleshed Out |
---|
| 345 | @item prcv_msg - Stub, Needs to be Fleshed Out |
---|
| 346 | @item trcv_msg - Stub, Needs to be Fleshed Out |
---|
| 347 | @item ref_mbx - Stub, Needs to be Fleshed Out |
---|
| 348 | |
---|
| 349 | @item Notes: |
---|
| 350 | @itemize @bullet |
---|
| 351 | @item Implement Using SuperCore Message Queue Handler |
---|
| 352 | @item Passes Addresses of Messages |
---|
| 353 | @item FIFO or Priority Task Blocking |
---|
| 354 | @item FIFO or Priority Message Ordering |
---|
| 355 | @item Send Returns Error on Overflow |
---|
| 356 | @end itemize |
---|
| 357 | |
---|
| 358 | @end itemize |
---|
| 359 | |
---|
| 360 | @item Executive Modifications |
---|
| 361 | @itemize @bullet |
---|
| 362 | @item None Expected |
---|
| 363 | @item Functionality Completely Supported by SuperCore Message Queue Handler |
---|
| 364 | @end itemize |
---|
| 365 | |
---|
| 366 | @item Testing |
---|
| 367 | @itemize @bullet |
---|
| 368 | @item No Tests Written |
---|
[a5f5acad] | 369 | @item No Timing Tests |
---|
[3869b53] | 370 | @end itemize |
---|
| 371 | |
---|
| 372 | @item Documentation |
---|
| 373 | @itemize @bullet |
---|
[a5f5acad] | 374 | @item Needs More Text |
---|
| 375 | @item No Information in Background or Operations. |
---|
| 376 | @item Service Descriptions are Weak. |
---|
[3869b53] | 377 | @end itemize |
---|
| 378 | |
---|
| 379 | @item ITRON 3.0 API Conformance |
---|
| 380 | @itemize @bullet |
---|
| 381 | @item Level E - Extended Functionality |
---|
| 382 | @itemize @bullet |
---|
| 383 | @item |
---|
| 384 | @end itemize |
---|
| 385 | |
---|
| 386 | @item Level C - CPU Dependent Functionality |
---|
| 387 | @itemize @bullet |
---|
| 388 | @item NA |
---|
| 389 | @end itemize |
---|
| 390 | |
---|
| 391 | @item Level N - Connection Functionality |
---|
| 392 | @itemize @bullet |
---|
| 393 | @item Not implemented |
---|
| 394 | @end itemize |
---|
| 395 | @end itemize |
---|
| 396 | |
---|
| 397 | @end itemize |
---|
| 398 | |
---|
| 399 | @c |
---|
| 400 | @c Message Buffer |
---|
| 401 | @c |
---|
| 402 | |
---|
| 403 | @section Message Buffer |
---|
| 404 | |
---|
| 405 | @itemize @bullet |
---|
| 406 | |
---|
| 407 | @item Implementation |
---|
| 408 | @itemize @bullet |
---|
| 409 | @item cre_mbf - Stub, Needs to be Fleshed Out |
---|
| 410 | @item del_mbf - Stub, Needs to be Fleshed Out |
---|
| 411 | @item snd_mbf - Stub, Needs to be Fleshed Out |
---|
| 412 | @item psnd_mbf - Stub, Needs to be Fleshed Out |
---|
| 413 | @item tsnd_mbf - Stub, Needs to be Fleshed Out |
---|
| 414 | @item rcv_mbf - Stub, Needs to be Fleshed Out |
---|
| 415 | @item prcv_mbf - Stub, Needs to be Fleshed Out |
---|
| 416 | @item trcv_mbf - Stub, Needs to be Fleshed Out |
---|
| 417 | @item ref_mbf - Stub, Needs to be Fleshed Out |
---|
| 418 | |
---|
| 419 | @item Notes: |
---|
| 420 | @itemize @bullet |
---|
| 421 | @item Implement Using SuperCore Message Queue Handler |
---|
| 422 | @item Passes Full Bodies of Messages |
---|
| 423 | @item FIFO or Priority Task Blocking |
---|
| 424 | @item FIFO Message Ordering Only |
---|
| 425 | @item Send (snd_mbf and tsnd_mbf) Blocks on Overflow |
---|
| 426 | @end itemize |
---|
| 427 | |
---|
| 428 | @end itemize |
---|
| 429 | |
---|
| 430 | @item Executive Modifications |
---|
| 431 | @itemize @bullet |
---|
| 432 | @item SuperCore Message Queue Handler Must Support Blocking Sends. [NOTE: |
---|
| 433 | This is required for POSIX Message Queues as well.] |
---|
| 434 | @end itemize |
---|
| 435 | |
---|
| 436 | @item Testing |
---|
| 437 | @itemize @bullet |
---|
| 438 | @item No Tests Written |
---|
[a5f5acad] | 439 | @item No Timing Tests |
---|
[3869b53] | 440 | @end itemize |
---|
| 441 | |
---|
| 442 | @item Documentation |
---|
| 443 | @itemize @bullet |
---|
[a5f5acad] | 444 | @item Good First Draft. |
---|
| 445 | @item No Information in Operations |
---|
[3869b53] | 446 | @end itemize |
---|
| 447 | |
---|
| 448 | @item ITRON 3.0 API Conformance |
---|
| 449 | @itemize @bullet |
---|
| 450 | @item Level E - Extended Functionality |
---|
| 451 | @itemize @bullet |
---|
| 452 | @item |
---|
| 453 | @end itemize |
---|
| 454 | |
---|
| 455 | @item Level C - CPU Dependent Functionality |
---|
| 456 | @itemize @bullet |
---|
| 457 | @item NA |
---|
| 458 | @end itemize |
---|
| 459 | |
---|
| 460 | @item Level N - Connection Functionality |
---|
| 461 | @itemize @bullet |
---|
| 462 | @item Not implemented |
---|
| 463 | @end itemize |
---|
| 464 | @end itemize |
---|
| 465 | |
---|
| 466 | @end itemize |
---|
| 467 | |
---|
| 468 | @c |
---|
| 469 | @c Rendezvous |
---|
| 470 | @c |
---|
| 471 | |
---|
| 472 | @section Rendezvous |
---|
| 473 | |
---|
| 474 | @itemize @bullet |
---|
| 475 | |
---|
| 476 | @item Implementation |
---|
| 477 | @itemize @bullet |
---|
| 478 | @item cre_por - Stub, Needs to be Fleshed Out |
---|
| 479 | @item del_por - Stub, Needs to be Fleshed Out |
---|
| 480 | @item cal_por - Stub, Needs to be Fleshed Out |
---|
| 481 | @item pcal_por - Stub, Needs to be Fleshed Out |
---|
| 482 | @item tcal_por - Stub, Needs to be Fleshed Out |
---|
| 483 | @item acp_por - Stub, Needs to be Fleshed Out |
---|
| 484 | @item pacp_por - Stub, Needs to be Fleshed Out |
---|
| 485 | @item tacp_por - Stub, Needs to be Fleshed Out |
---|
| 486 | @item fwd_por - Stub, Needs to be Fleshed Out |
---|
| 487 | @item rpl_rdv - Stub, Needs to be Fleshed Out |
---|
| 488 | @item ref_por - Stub, Needs to be Fleshed Out |
---|
| 489 | |
---|
| 490 | @item Notes: |
---|
| 491 | @itemize @bullet |
---|
| 492 | @item Hardest ITRON Manager to Implement |
---|
| 493 | @end itemize |
---|
| 494 | |
---|
| 495 | @end itemize |
---|
| 496 | |
---|
| 497 | @item Executive Modifications |
---|
| 498 | @itemize @bullet |
---|
| 499 | @item Doubtful, Probably Implement in Terms of Multiple SuperCore Objects. |
---|
| 500 | @end itemize |
---|
| 501 | |
---|
| 502 | @item Testing |
---|
| 503 | @itemize @bullet |
---|
| 504 | @item No Tests Written |
---|
[a5f5acad] | 505 | @item No Timing Tests |
---|
[3869b53] | 506 | @end itemize |
---|
| 507 | |
---|
| 508 | @item Documentation |
---|
| 509 | @itemize @bullet |
---|
| 510 | @item Shell, Needs to be Fleshed Out |
---|
| 511 | @end itemize |
---|
| 512 | |
---|
| 513 | @item ITRON 3.0 API Conformance |
---|
| 514 | @itemize @bullet |
---|
| 515 | @item Level E - Extended Functionality |
---|
| 516 | @itemize @bullet |
---|
| 517 | @item |
---|
| 518 | @end itemize |
---|
| 519 | |
---|
| 520 | @item Level C - CPU Dependent Functionality |
---|
| 521 | @itemize @bullet |
---|
| 522 | @item NA |
---|
| 523 | @end itemize |
---|
| 524 | |
---|
| 525 | @item Level N - Connection Functionality |
---|
| 526 | @itemize @bullet |
---|
| 527 | @item Not implemented |
---|
| 528 | @end itemize |
---|
| 529 | @end itemize |
---|
| 530 | |
---|
| 531 | @end itemize |
---|
| 532 | |
---|
| 533 | @c |
---|
| 534 | @c Interrupt |
---|
| 535 | @c |
---|
| 536 | |
---|
| 537 | @section Interrupt |
---|
| 538 | |
---|
| 539 | @itemize @bullet |
---|
| 540 | |
---|
| 541 | @item Implementation |
---|
| 542 | @itemize @bullet |
---|
| 543 | @item def_int - Stub, Needs to be Fleshed Out |
---|
| 544 | @item ret_int - Stub, Needs to be Fleshed Out |
---|
| 545 | @item ret_wup - Stub, Needs to be Fleshed Out |
---|
| 546 | @item loc_cpu - Stub, Needs to be Fleshed Out |
---|
| 547 | @item unl_cpu - Stub, Needs to be Fleshed Out |
---|
| 548 | @item dis_int - Stub, Needs to be Fleshed Out |
---|
| 549 | @item ena_int - Stub, Needs to be Fleshed Out |
---|
| 550 | @item chg_iXX - Stub, Needs to be Fleshed Out |
---|
| 551 | @item ref_iXX - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 552 | |
---|
| 553 | @item Notes: |
---|
| 554 | @itemize @bullet |
---|
| 555 | @item This quote from the ITRON specification needs to be thought about:@* |
---|
| 556 | @*@i{"When an interrupt is invoked, the interrupt handler defined with |
---|
| 557 | this system call is started directly by the |
---|
| 558 | interrupt processing mechanism of the CPU hardware. Accordingly, code at the |
---|
| 559 | beginning and end of an interrupt handler must save and restore any registers |
---|
| 560 | used by the interrupt handler."}@*@* |
---|
| 561 | Based on another comment, in the ret_int description, I think this means |
---|
| 562 | that RTEMS will not support the TA_ASM style of interrupt handlers -- |
---|
| 563 | only the TA_HLNG style.@*@* |
---|
| 564 | @i{When TA_HLNG is specified, a high-level language environment setting |
---|
| 565 | program (a high-level language support routine) is called before branching |
---|
| 566 | to the inthdr address. The least significant bit (LSB) of the system |
---|
| 567 | attribute bits is used for this specification.} |
---|
| 568 | |
---|
| 569 | @item Specification allows special "interrupt-only" versions of system |
---|
| 570 | calls named i???_??? (i.e. sig_sem and isig_sem). This does not seem |
---|
| 571 | to be something that would be implemented with RTEMS. We could provide |
---|
| 572 | macros mapping them onto the default versions if this is an issue. |
---|
| 573 | |
---|
| 574 | @item How this operates versus the behavior of a true TRON chip is |
---|
| 575 | up for discussion. |
---|
| 576 | |
---|
| 577 | @item ret_wup is questionable in only high-level language ISRs. |
---|
| 578 | |
---|
| 579 | @item dis_int and ena_int refer to a specific interrupt number. These |
---|
| 580 | may require hooking back out to the BSP. |
---|
| 581 | |
---|
| 582 | @item for chg_iXX and reg_iXX, the XX should be replaced with something |
---|
| 583 | that is meaningful on a particular CPU. |
---|
| 584 | @end itemize |
---|
| 585 | |
---|
[3869b53] | 586 | @end itemize |
---|
| 587 | |
---|
| 588 | @item Executive Modifications |
---|
| 589 | @itemize @bullet |
---|
| 590 | @item None Expected |
---|
| 591 | @end itemize |
---|
| 592 | |
---|
| 593 | @item Testing |
---|
| 594 | @itemize @bullet |
---|
| 595 | @item No Tests Written |
---|
[a5f5acad] | 596 | @item No Timing Tests |
---|
[3869b53] | 597 | @end itemize |
---|
| 598 | |
---|
| 599 | @item Documentation |
---|
| 600 | @itemize @bullet |
---|
| 601 | @item Shell, Needs to be Fleshed Out |
---|
| 602 | @end itemize |
---|
| 603 | |
---|
| 604 | @item ITRON 3.0 API Conformance |
---|
| 605 | @itemize @bullet |
---|
| 606 | @item Level E - Extended Functionality |
---|
| 607 | @itemize @bullet |
---|
| 608 | @item |
---|
| 609 | @end itemize |
---|
| 610 | |
---|
| 611 | @item Level C - CPU Dependent Functionality |
---|
| 612 | @itemize @bullet |
---|
| 613 | @item NA |
---|
| 614 | @end itemize |
---|
| 615 | |
---|
| 616 | @item Level N - Connection Functionality |
---|
| 617 | @itemize @bullet |
---|
| 618 | @item Not implemented |
---|
| 619 | @end itemize |
---|
| 620 | @end itemize |
---|
| 621 | |
---|
| 622 | @end itemize |
---|
| 623 | |
---|
| 624 | @c |
---|
| 625 | @c Memory Pool |
---|
| 626 | @c |
---|
| 627 | |
---|
| 628 | @section Memory Pool |
---|
| 629 | |
---|
| 630 | @itemize @bullet |
---|
| 631 | |
---|
| 632 | @item Implementation |
---|
| 633 | @itemize @bullet |
---|
| 634 | @item cre_mpl - Stub, Needs to be Fleshed Out |
---|
| 635 | @item del_mpl - Stub, Needs to be Fleshed Out |
---|
| 636 | @item get_blk - Stub, Needs to be Fleshed Out |
---|
| 637 | @item pget_blk - Stub, Needs to be Fleshed Out |
---|
| 638 | @item tget_blk - Stub, Needs to be Fleshed Out |
---|
| 639 | @item rel_blk - Stub, Needs to be Fleshed Out |
---|
| 640 | @item ref_mpl - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 641 | |
---|
| 642 | @item Notes: |
---|
| 643 | @itemize @bullet |
---|
| 644 | @item Implement Using SuperCore Heap Handler |
---|
| 645 | @item Similar to Region in Classic API with Blocking |
---|
| 646 | @item FIFO or Priority Task Blocking |
---|
| 647 | @item Specification Deliberately Open on Allocation Algorithm |
---|
| 648 | @item Multiple Tasks Can be Unblocked by a single rel_blk |
---|
| 649 | @end itemize |
---|
| 650 | |
---|
[3869b53] | 651 | @end itemize |
---|
| 652 | |
---|
| 653 | @item Executive Modifications |
---|
| 654 | @itemize @bullet |
---|
| 655 | @item None Expected |
---|
| 656 | @end itemize |
---|
| 657 | |
---|
| 658 | @item Testing |
---|
| 659 | @itemize @bullet |
---|
| 660 | @item No Tests Written |
---|
[a5f5acad] | 661 | @item No Timing Tests |
---|
[3869b53] | 662 | @end itemize |
---|
| 663 | |
---|
| 664 | @item Documentation |
---|
| 665 | @itemize @bullet |
---|
[a5f5acad] | 666 | @item Good First Draft. |
---|
| 667 | @item No Information in Operations |
---|
| 668 | @item Should not use "standard-like" language. |
---|
[3869b53] | 669 | @end itemize |
---|
| 670 | |
---|
| 671 | @item ITRON 3.0 API Conformance |
---|
| 672 | @itemize @bullet |
---|
| 673 | @item Level E - Extended Functionality |
---|
| 674 | @itemize @bullet |
---|
| 675 | @item |
---|
| 676 | @end itemize |
---|
| 677 | |
---|
| 678 | @item Level C - CPU Dependent Functionality |
---|
| 679 | @itemize @bullet |
---|
| 680 | @item NA |
---|
| 681 | @end itemize |
---|
| 682 | |
---|
| 683 | @item Level N - Connection Functionality |
---|
| 684 | @itemize @bullet |
---|
| 685 | @item Not implemented |
---|
| 686 | @end itemize |
---|
| 687 | @end itemize |
---|
| 688 | |
---|
| 689 | @end itemize |
---|
| 690 | |
---|
| 691 | @c |
---|
| 692 | @c Fixed Block |
---|
| 693 | @c |
---|
| 694 | |
---|
| 695 | @section Fixed Block |
---|
| 696 | |
---|
| 697 | @itemize @bullet |
---|
| 698 | |
---|
| 699 | @item Implementation |
---|
| 700 | @itemize @bullet |
---|
| 701 | @item cre_mpf - Stub, Needs to be Fleshed Out |
---|
| 702 | @item del_mpf - Stub, Needs to be Fleshed Out |
---|
| 703 | @item get_blf - Stub, Needs to be Fleshed Out |
---|
| 704 | @item pget_blf - Stub, Needs to be Fleshed Out |
---|
| 705 | @item tget_blf - Stub, Needs to be Fleshed Out |
---|
| 706 | @item rel_blf - Stub, Needs to be Fleshed Out |
---|
| 707 | @item ref_mpf - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 708 | |
---|
| 709 | @item Notes: |
---|
| 710 | @itemize @bullet |
---|
| 711 | @item Implement Using SuperCore Chain Handler |
---|
| 712 | @item Similar to Partition in Classic API with Blocking |
---|
| 713 | @item FIFO or Priority Task Blocking |
---|
| 714 | @item Specification Deliberately Open on Allocation Algorithm |
---|
| 715 | @item Should add Blocking to Classic API Partition at Same Time |
---|
| 716 | @end itemize |
---|
| 717 | |
---|
[3869b53] | 718 | @end itemize |
---|
| 719 | |
---|
| 720 | @item Executive Modifications |
---|
| 721 | @itemize @bullet |
---|
| 722 | @item None Expected |
---|
| 723 | @end itemize |
---|
| 724 | |
---|
| 725 | @item Testing |
---|
| 726 | @itemize @bullet |
---|
| 727 | @item No Tests Written |
---|
[a5f5acad] | 728 | @item No Timing Tests |
---|
[3869b53] | 729 | @end itemize |
---|
| 730 | |
---|
| 731 | @item Documentation |
---|
| 732 | @itemize @bullet |
---|
[a5f5acad] | 733 | @item Good First Draft. |
---|
| 734 | @item No Information in Background or Operations |
---|
| 735 | @item Should not use "standard-like" language. |
---|
[3869b53] | 736 | @end itemize |
---|
| 737 | |
---|
| 738 | @item ITRON 3.0 API Conformance |
---|
| 739 | @itemize @bullet |
---|
| 740 | @item Level E - Extended Functionality |
---|
| 741 | @itemize @bullet |
---|
| 742 | @item |
---|
| 743 | @end itemize |
---|
| 744 | |
---|
| 745 | @item Level C - CPU Dependent Functionality |
---|
| 746 | @itemize @bullet |
---|
| 747 | @item NA |
---|
| 748 | @end itemize |
---|
| 749 | |
---|
| 750 | @item Level N - Connection Functionality |
---|
| 751 | @itemize @bullet |
---|
| 752 | @item Not implemented |
---|
| 753 | @end itemize |
---|
| 754 | @end itemize |
---|
| 755 | |
---|
| 756 | @end itemize |
---|
| 757 | |
---|
| 758 | @c |
---|
| 759 | @c Time |
---|
| 760 | @c |
---|
| 761 | |
---|
| 762 | @section Time |
---|
| 763 | |
---|
| 764 | @itemize @bullet |
---|
| 765 | |
---|
| 766 | @item Implementation |
---|
| 767 | @itemize @bullet |
---|
| 768 | @item get_tim - Stub, Needs to be Fleshed Out |
---|
| 769 | @item set_tim - Stub, Needs to be Fleshed Out |
---|
| 770 | @item dly_tsk - Stub, Needs to be Fleshed Out |
---|
| 771 | @item def_cyc - Stub, Needs to be Fleshed Out |
---|
| 772 | @item act_cyc - Stub, Needs to be Fleshed Out |
---|
| 773 | @item ref_cyc - Stub, Needs to be Fleshed Out |
---|
| 774 | @item def_alm - Stub, Needs to be Fleshed Out |
---|
| 775 | @item ref_alm - Stub, Needs to be Fleshed Out |
---|
| 776 | @item ret_tmr - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 777 | |
---|
| 778 | @item Notes: |
---|
| 779 | @itemize @bullet |
---|
| 780 | @item Need to Implement Time Conversion Routines |
---|
| 781 | @item Epoch is January 1, 1985, 00:00:00 am (GMT). |
---|
| 782 | @item Cyclic and Alarm Handlers may be TA_ASM or TA_HLNG. |
---|
| 783 | @item Alarms may be Absolute or Relative Time based. |
---|
| 784 | @item May Want to Implement a Timer Server Task |
---|
| 785 | @item Termination via ret_tmr is Not Consistent with Current RTEMS Timers. |
---|
| 786 | @end itemize |
---|
| 787 | |
---|
[3869b53] | 788 | @end itemize |
---|
| 789 | |
---|
| 790 | @item Executive Modifications |
---|
| 791 | @itemize @bullet |
---|
| 792 | @item None Expected |
---|
| 793 | @end itemize |
---|
| 794 | |
---|
| 795 | @item Testing |
---|
| 796 | @itemize @bullet |
---|
| 797 | @item No Tests Written |
---|
[a5f5acad] | 798 | @item No Timing Tests |
---|
[3869b53] | 799 | @end itemize |
---|
| 800 | |
---|
| 801 | @item Documentation |
---|
| 802 | @itemize @bullet |
---|
[a5f5acad] | 803 | @item Have Version in Word |
---|
[3869b53] | 804 | @end itemize |
---|
| 805 | |
---|
| 806 | @item ITRON 3.0 API Conformance |
---|
| 807 | @itemize @bullet |
---|
| 808 | @item Level E - Extended Functionality |
---|
| 809 | @itemize @bullet |
---|
| 810 | @item |
---|
| 811 | @end itemize |
---|
| 812 | |
---|
| 813 | @item Level C - CPU Dependent Functionality |
---|
| 814 | @itemize @bullet |
---|
| 815 | @item NA |
---|
| 816 | @end itemize |
---|
| 817 | |
---|
| 818 | @item Level N - Connection Functionality |
---|
| 819 | @itemize @bullet |
---|
| 820 | @item Not implemented |
---|
| 821 | @end itemize |
---|
| 822 | @end itemize |
---|
| 823 | |
---|
| 824 | @end itemize |
---|
| 825 | |
---|
| 826 | @c |
---|
| 827 | @c System |
---|
| 828 | @c |
---|
| 829 | |
---|
| 830 | @section System |
---|
| 831 | |
---|
| 832 | @itemize @bullet |
---|
| 833 | |
---|
| 834 | @item Implementation |
---|
| 835 | @itemize @bullet |
---|
| 836 | @item get_ver - Stub, Needs to be Fleshed Out |
---|
| 837 | @item ref_sys - Stub, Needs to be Fleshed Out |
---|
| 838 | @item ref_cfg - Stub, Needs to be Fleshed Out |
---|
| 839 | @item def_svc - Stub, Needs to be Fleshed Out |
---|
| 840 | @item def_exc - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 841 | |
---|
| 842 | @item Notes: |
---|
| 843 | @itemize @bullet |
---|
| 844 | @item May Have to Obtain ITRON "OS Maker" Id |
---|
| 845 | @item - def_svc seems to imply a trap handler interface |
---|
| 846 | @item - def_exc needs to be examined. |
---|
| 847 | @end itemize |
---|
| 848 | |
---|
[3869b53] | 849 | @end itemize |
---|
| 850 | |
---|
| 851 | @item Executive Modifications |
---|
| 852 | @itemize @bullet |
---|
| 853 | @item None Expected |
---|
| 854 | @end itemize |
---|
| 855 | |
---|
| 856 | @item Testing |
---|
| 857 | @itemize @bullet |
---|
| 858 | @item No Tests Written |
---|
[a5f5acad] | 859 | @item No Timing Tests |
---|
[3869b53] | 860 | @end itemize |
---|
| 861 | |
---|
| 862 | @item Documentation |
---|
| 863 | @itemize @bullet |
---|
| 864 | @item Shell, Needs to be Fleshed Out |
---|
| 865 | @end itemize |
---|
| 866 | |
---|
| 867 | @item ITRON 3.0 API Conformance |
---|
| 868 | @itemize @bullet |
---|
| 869 | @item Level E - Extended Functionality |
---|
| 870 | @itemize @bullet |
---|
| 871 | @item |
---|
| 872 | @end itemize |
---|
| 873 | |
---|
| 874 | @item Level C - CPU Dependent Functionality |
---|
| 875 | @itemize @bullet |
---|
| 876 | @item NA |
---|
| 877 | @end itemize |
---|
| 878 | |
---|
| 879 | @item Level N - Connection Functionality |
---|
| 880 | @itemize @bullet |
---|
| 881 | @item Not implemented |
---|
| 882 | @end itemize |
---|
| 883 | @end itemize |
---|
| 884 | |
---|
| 885 | @end itemize |
---|
| 886 | |
---|
| 887 | @c |
---|
| 888 | @c Network Support |
---|
| 889 | @c |
---|
| 890 | |
---|
| 891 | @section Network Support |
---|
| 892 | |
---|
| 893 | @itemize @bullet |
---|
| 894 | |
---|
| 895 | @item Implementation |
---|
| 896 | @itemize @bullet |
---|
| 897 | @item nrea_dat - Stub, Needs to be Fleshed Out |
---|
| 898 | @item nwri_dat - Stub, Needs to be Fleshed Out |
---|
| 899 | @item nget_nod - Stub, Needs to be Fleshed Out |
---|
| 900 | @item nget_ver - Stub, Needs to be Fleshed Out |
---|
[41d2eaca] | 901 | |
---|
| 902 | @item Notes: |
---|
| 903 | @itemize @bullet |
---|
| 904 | @item None of these are difficult to implement on top of MPCI |
---|
| 905 | @item MP Packet formats are well-defined. |
---|
| 906 | @end itemize |
---|
| 907 | |
---|
[3869b53] | 908 | @end itemize |
---|
| 909 | |
---|
| 910 | @item Executive Modifications |
---|
| 911 | @itemize @bullet |
---|
| 912 | @item None Expected |
---|
| 913 | @end itemize |
---|
| 914 | |
---|
| 915 | @item Testing |
---|
| 916 | @itemize @bullet |
---|
| 917 | @item No Tests Written |
---|
[a5f5acad] | 918 | @item No Timing Tests |
---|
[3869b53] | 919 | @end itemize |
---|
| 920 | |
---|
| 921 | @item Documentation |
---|
| 922 | @itemize @bullet |
---|
| 923 | @item Shell, Needs to be Fleshed Out |
---|
| 924 | @end itemize |
---|
| 925 | |
---|
| 926 | @item ITRON 3.0 API Conformance |
---|
| 927 | @itemize @bullet |
---|
| 928 | @item Level E - Extended Functionality |
---|
| 929 | @itemize @bullet |
---|
| 930 | @item |
---|
| 931 | @end itemize |
---|
| 932 | |
---|
| 933 | @item Level C - CPU Dependent Functionality |
---|
| 934 | @itemize @bullet |
---|
| 935 | @item NA |
---|
| 936 | @end itemize |
---|
| 937 | |
---|
| 938 | @item Level N - Connection Functionality |
---|
| 939 | @itemize @bullet |
---|
| 940 | @item Not implemented |
---|
| 941 | @end itemize |
---|
| 942 | @end itemize |
---|
| 943 | |
---|
| 944 | @end itemize |
---|
| 945 | |
---|