summaryrefslogtreecommitdiffstats
path: root/doc/itron3.0/interrupt.t
blob: af3ad2f49305793ccd811e980f6f2163c1436e21 (plain) (blame)
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
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
@c
@c  COPYRIGHT (c) 1988-1999.
@c  On-Line Applications Research Corporation (OAR).
@c  All rights reserved.
@c
@c  This is the chapter from the RTEMS ITRON User's Guide that
@c  documents the services provided by the interrupt
@c  manager.
@c
@c  $Id$
@c

@chapter Interrupt Manager

@section Introduction

The 
interrupt manager is ...

The services provided by the interrupt manager are:

@itemize @bullet
@item @code{def_int} - Define Interrupt Handler
@item @code{ret_int} - Return from Interrupt Handler
@item @code{ret_wup} - Return and Wakeup Task
@item @code{loc_cpu} - Lock CPU
@item @code{unl_cpu} - Unlock CPU
@item @code{dis_int} - Disable Interrupt
@item @code{ena_int} - Enable Interrupt
@item @code{chg_iXX} - Change Interrupt Mask(Level or Priority)
@item @code{ref_iXX} - Reference Interrupt Mask(Level or Priority)
@end itemize

@section Background

@section Operations

@section System Calls

This section details the interrupt manager's services.
A subsection is dedicated to each of this manager's services
and describes the calling sequence, related constants, usage,
and status codes.


@c
@c  def_int
@c

@page
@subsection def_int - Define Interrupt Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER def_int(
  UINT dintno,
  T_DINT *pk_dint
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  ret_int
@c

@page
@subsection ret_int - Return from Interrupt Handler

@subheading CALLING SEQUENCE:

@ifset is-C
@example
void ret_int(

);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  ret_wup
@c

@page
@subsection ret_wup - Return and Wakeup Task

@subheading CALLING SEQUENCE:

@ifset is-C
@example
void ret_wup(
  ID tskid
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  loc_cpu
@c

@page
@subsection loc_cpu - Lock CPU

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER loc_cpu(

);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  unl_cpu
@c

@page
@subsection unl_cpu - Unlock CPU

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER unl_cpu(

);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  dis_int
@c

@page
@subsection dis_int - Disable Interrupt

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER dis_int(
  UINT eintno
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  ena_int
@c

@page
@subsection ena_int - Enable Interrupt

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER ena_int(
  UINT eintno
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  chg_iXX
@c

@page
@subsection chg_iXX - Change Interrupt Mask(Level or Priority)

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER chg_iXX(
  UINT iXXXX
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES:


@c
@c  ref_iXX
@c

@page
@subsection ref_iXX - Reference Interrupt Mask(Level or Priority)

@subheading CALLING SEQUENCE:

@ifset is-C
@example
ER ref_iXX(
  UINT *p_iXXXX
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@code{EXXX} - 

@subheading DESCRIPTION:

@subheading NOTES: