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