1 | # |
---|
2 | # This shell script generates the starting template for a manager chapter. |
---|
3 | # |
---|
4 | |
---|
5 | FILES="task tasksync semaphore eventflags mailbox msgbuffer rendezvous interrupt memorypool fixedblock time config network" |
---|
6 | |
---|
7 | |
---|
8 | cat <<EOF |
---|
9 | @c |
---|
10 | @c This is the chapter from the RTEMS ITRON User's Guide that |
---|
11 | @c documents the services provided by the task |
---|
12 | @c manager. |
---|
13 | @c |
---|
14 | @c $Id$ |
---|
15 | @c |
---|
16 | |
---|
17 | @chapter ITRON Implementation Status |
---|
18 | |
---|
19 | @section Introduction |
---|
20 | |
---|
21 | This chapter describes the status of the implementation of each |
---|
22 | manager in the RTEMS implementataion of the uITRON 3.0 API. The |
---|
23 | status of each manager is presented in terms of documentation and |
---|
24 | status relative to the extended level (level 'E') of the uITRON 3.0 |
---|
25 | API specification. The extended level of the specification is |
---|
26 | the level at which dynamic object creation, deletion, and |
---|
27 | reference services are available. This level is more akin to the other |
---|
28 | APIs supported by RTEMS. This purpose of this chapter is |
---|
29 | to make it clear what is required to bring the RTEMS |
---|
30 | uITRON API implementation into compliance with the |
---|
31 | specification. The following description of the specification |
---|
32 | levels is taken from the uITRON 3.0 API specification. |
---|
33 | |
---|
34 | |
---|
35 | uITRON 3.0 specification is divided into fewer system call levels than was the |
---|
36 | previous uITRON 2.0 specification. There are now just three levels: Level R |
---|
37 | (Required), Level S (Standard) and Level E (Extended). In addition to these |
---|
38 | three levels, there is also Level C for CPU-dependent system calls. |
---|
39 | In addition, the uITRON 3.0 API, defines the network level ('N') which |
---|
40 | represents system calls that support the connection function |
---|
41 | |
---|
42 | @itemize @bullet |
---|
43 | @item [level R] (Required) |
---|
44 | The functions in this level are mandatory for all implementations of |
---|
45 | uITRON 3.0 specification. This includes basic functions for achieving |
---|
46 | a real-time, multitasking OS. These functions can be implemented even |
---|
47 | without a hardware timer. This level corresponds to Levels 1 and 2 |
---|
48 | of uITRON 2.0 specification. |
---|
49 | |
---|
50 | @item [level S] (Standard) |
---|
51 | This includes basic functions for achieving a real-time, multitasking |
---|
52 | OS. This level corresponds to Levels 3 and 4 of uITRON 2.0 |
---|
53 | specification. |
---|
54 | |
---|
55 | @item [level E] (Extended) |
---|
56 | This includes additional and extended functions. This corresponds to |
---|
57 | functions not included in uITRON 2.0 specification (functions of |
---|
58 | ITRON2 specification). Specifically, this level includes object |
---|
59 | creation and deletion functions, rendezvous functions, memorypools |
---|
60 | and the timer handler. |
---|
61 | |
---|
62 | @item [level C] (CPU dependent) |
---|
63 | This level provides implementation-dependent functions required due to |
---|
64 | the CPU or hardware configuration. |
---|
65 | |
---|
66 | @end itemize |
---|
67 | |
---|
68 | The support level of the connection function is indicated by appending an 'N' |
---|
69 | to the end of the level. For example, connectivity supported at [level S] |
---|
70 | would be referred to as [level SN]. The support level for functions which |
---|
71 | can only send requests for operations on other nodes but offer no system call |
---|
72 | processing on the issuing node itself are indicated by the lower case letter |
---|
73 | 's' or 'e'. |
---|
74 | |
---|
75 | |
---|
76 | EOF |
---|
77 | |
---|
78 | |
---|
79 | for chapter in $FILES |
---|
80 | do |
---|
81 | case ${chapter} in |
---|
82 | task) |
---|
83 | CHAPTER_CAPS="Task" |
---|
84 | CHAPTER_LOWER="task" |
---|
85 | ROUTINES=" cre_tsk del_tsk sta_tsk ext_tsk exd_tsk ter_tsk \ |
---|
86 | dis_dsp ena_dsp chg_pri rot_rdq rel_wai get_tid ref_tsk" |
---|
87 | ;; |
---|
88 | |
---|
89 | tasksync) |
---|
90 | CHAPTER_CAPS="Task-Dependent Synchronization" |
---|
91 | CHAPTER_LOWER="task-dependent synchronization" |
---|
92 | ROUTINES=" sus_tsk rsm_tsk frsm_tsk \ |
---|
93 | slp_tsk tslp_tsk wup_tsk can_wup" |
---|
94 | ;; |
---|
95 | |
---|
96 | semaphore) |
---|
97 | CHAPTER_CAPS="Semaphore" |
---|
98 | CHAPTER_LOWER="semaphore" |
---|
99 | ROUTINES="cre_sem del_sem sig_sem wai_sem preq_sem twai_sem ref_sem " |
---|
100 | ;; |
---|
101 | |
---|
102 | eventflags) |
---|
103 | CHAPTER_CAPS="Eventflags" |
---|
104 | CHAPTER_LOWER="eventflags" |
---|
105 | ROUTINES=" cre_flg del_flg set_flg clr_flg wai_flg pol_flg \ |
---|
106 | twai_flg ref_flg " |
---|
107 | ;; |
---|
108 | |
---|
109 | mailbox) |
---|
110 | CHAPTER_CAPS="Mailbox" |
---|
111 | CHAPTER_LOWER="mailbox" |
---|
112 | ROUTINES="cre_mbx del_mbx snd_msg rcv_msg prcv_msg trcv_msg ref_mbx" |
---|
113 | ;; |
---|
114 | |
---|
115 | msgbuffer) |
---|
116 | CHAPTER_CAPS="Message Buffer" |
---|
117 | CHAPTER_LOWER="message buffer" |
---|
118 | ROUTINES=" cre_mbf del_mbf snd_mbf psnd_mbf tsnd_mbf rcv_mbf prcv_mbf \ |
---|
119 | trcv_mbf ref_mbf " |
---|
120 | ;; |
---|
121 | |
---|
122 | rendezvous) |
---|
123 | CHAPTER_CAPS="Rendezvous" |
---|
124 | CHAPTER_LOWER="rendezvous" |
---|
125 | ROUTINES=" cre_por del_por cal_por pcal_por tcal_por acp_por pacp_por \ |
---|
126 | tacp_por fwd_por rpl_rdv ref_por" |
---|
127 | ;; |
---|
128 | |
---|
129 | interrupt) |
---|
130 | CHAPTER_CAPS="Interrupt" |
---|
131 | CHAPTER_LOWER="interrupt" |
---|
132 | ROUTINES=" def_int ret_int ret_wup loc_cpu unl_cpu dis_int ena_int |
---|
133 | chg_iXX ref_iXX" |
---|
134 | ;; |
---|
135 | |
---|
136 | memorypool) |
---|
137 | CHAPTER_CAPS="Memory Pool" |
---|
138 | CHAPTER_LOWER="memory pool" |
---|
139 | ROUTINES=" cre_mpl del_mpl get_blk pget_blk tget_blk rel_blk ref_mpl" |
---|
140 | ;; |
---|
141 | |
---|
142 | fixedblock) |
---|
143 | CHAPTER_CAPS="Fixed Block" |
---|
144 | CHAPTER_LOWER="fixed block" |
---|
145 | ROUTINES=" cre_mpf del_mpf get_blf pget_blf tget_blf rel_blf ref_mpf" |
---|
146 | ;; |
---|
147 | |
---|
148 | time) |
---|
149 | CHAPTER_CAPS="Time" |
---|
150 | CHAPTER_LOWER="time" |
---|
151 | ROUTINES=" get_tim set_tim dly_tsk \ |
---|
152 | def_cyc act_cyc ref_cyc \ |
---|
153 | def_alm ref_alm ret_tmr" |
---|
154 | ;; |
---|
155 | |
---|
156 | config) |
---|
157 | CHAPTER_CAPS="System" |
---|
158 | CHAPTER_LOWER="system" |
---|
159 | ROUTINES=" get_ver ref_sys ref_cfg def_svc def_exc" |
---|
160 | ;; |
---|
161 | |
---|
162 | network) |
---|
163 | CHAPTER_CAPS="Network Support" |
---|
164 | CHAPTER_LOWER="network support" |
---|
165 | ROUTINES=" nrea_dat nwri_dat nget_nod nget_ver" |
---|
166 | ;; |
---|
167 | |
---|
168 | *) |
---|
169 | echo "Unknown chapter name" |
---|
170 | exit 1 |
---|
171 | ;; |
---|
172 | esac |
---|
173 | |
---|
174 | echo "@c" |
---|
175 | echo "@c ${CHAPTER_CAPS}" |
---|
176 | echo "@c" |
---|
177 | echo |
---|
178 | echo "@section ${CHAPTER_CAPS} Status" |
---|
179 | cat <<EOF |
---|
180 | |
---|
181 | @itemize @bullet |
---|
182 | |
---|
183 | @item Implementation |
---|
184 | @itemize @bullet |
---|
185 | EOF |
---|
186 | |
---|
187 | for routine in ${ROUTINES} |
---|
188 | do |
---|
189 | echo "@item ${routine} - Stub, Needs to be Fleshed Out" |
---|
190 | done |
---|
191 | cat <<EOF |
---|
192 | @end itemize |
---|
193 | |
---|
194 | @item Executive Modifications |
---|
195 | @itemize @bullet |
---|
196 | @item None Expected |
---|
197 | @end itemize |
---|
198 | |
---|
199 | @item Testing |
---|
200 | @itemize @bullet |
---|
201 | @item No Tests Written |
---|
202 | @end itemize |
---|
203 | |
---|
204 | @item Documentation |
---|
205 | @itemize @bullet |
---|
206 | @item Shell, Needs to be Fleshed Out |
---|
207 | @end itemize |
---|
208 | |
---|
209 | @item ITRON 3.0 API Conformance |
---|
210 | @itemize @bullet |
---|
211 | @item Level E - Extended Functionality |
---|
212 | @itemize @bullet |
---|
213 | @item |
---|
214 | @end itemize |
---|
215 | |
---|
216 | @item Level C - CPU Dependent Functionality |
---|
217 | @itemize @bullet |
---|
218 | @item NA |
---|
219 | @end itemize |
---|
220 | |
---|
221 | @item Level N - Connection Functionality |
---|
222 | @itemize @bullet |
---|
223 | @item Not implemented |
---|
224 | @end itemize |
---|
225 | @end itemize |
---|
226 | |
---|
227 | @end itemize |
---|
228 | |
---|
229 | EOF |
---|
230 | done |
---|