annotate packages/kernel/current/include/pkgconf/kernel.h @ 62:7a6ac9edc838 ecos-sw-2000-01-24

Merge from eCos master repository on 2000-01-24-19:43:49-GMT
author jlarmour
date Mon, 24 Jan 2000 21:43:17 +0000
parents 29bc183297e1
children c38311975d4f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1 #ifndef CYGONCE_PKGCONF_KERNEL_H
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
2 #define CYGONCE_PKGCONF_KERNEL_H
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
3 // ====================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
4 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
5 // pkgconf/kernel.h
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
6 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
7 // Kernel configuration file
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
8 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
9 // ====================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
10 //####COPYRIGHTBEGIN####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
11 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
12 // -------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
13 // The contents of this file are subject to the Cygnus eCos Public License
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
14 // Version 1.0 (the "License"); you may not use this file except in
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
15 // compliance with the License. You may obtain a copy of the License at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
16 // http://sourceware.cygnus.com/ecos
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
17 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
18 // Software distributed under the License is distributed on an "AS IS"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
19 // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
20 // License for the specific language governing rights and limitations under
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
21 // the License.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
22 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
23 // The Original Code is eCos - Embedded Cygnus Operating System, released
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
24 // September 30, 1998.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
25 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
26 // The Initial Developer of the Original Code is Cygnus. Portions created
62
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
27 // by Cygnus are Copyright (C) 1998,1999,2000 Cygnus Solutions.
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
28 // All Rights Reserved.
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
29 // -------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
30 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
31 //####COPYRIGHTEND####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
32 // ====================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
33 //#####DESCRIPTIONBEGIN####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
34 //
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
35 // Author(s): nickg
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
36 // Contributors: nickg
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
37 // Date: 1997-09-29
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
38 // Purpose: To allow the user to edit kernel configuration options.
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
39 // Description:
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
40 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
41 //####DESCRIPTIONEND####
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
42 //
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
43 // ====================================================================
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
44
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
45 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
46 * Some of the kernel configuration options depend on global options,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
47 * so it is necessary to include the global options first.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
48 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
49
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
50 #include <pkgconf/system.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
51
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
52 /* Only define options if the kernel is to be present */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
53 #ifdef CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
54
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
55 #include <pkgconf/hal.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
56 #include <pkgconf/infra.h>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
57
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
58 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
59 * The overall package definition.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
60
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
61 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
62
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
63 cdl_package CYGPKG_KERNEL {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
64 display "eCos kernel"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
65 type boolean
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
66 requires CYGFUN_HAL_COMMON_KERNEL_SUPPORT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
67 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
68 This package contains the core functionality of the eCos
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
69 kernel. It relies on functionality provided by various HAL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
70 packages and by the eCos infrastructure. In turn the eCos
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
71 kernel provides support for other packages such as the device
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
72 drivers and the uITRON compatibility layer."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
73 doc ref/ecos-ref/ecos-kernel-overview.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
74 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
75
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
76 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
77
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
78 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
79 * The first component within the kernel is related to interrupt
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
80 * handling.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
81 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
82
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
83 cdl_component CYGPKG_KERNEL_INTERRUPTS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
84 display "Kernel interrupt handling"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
85 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
86 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
87 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
88 The majority of configuration options related to interrupt
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
89 handling are in the HAL packages, since usually the code has
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
90 to be platform-specific. There are a number of options
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
91 provided within the kernel related to slightly higher-level
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
92 concepts, for example Delayed Service Routines."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
93 doc ref/ecos-ref/interrupts.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
94 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
95
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
96 # In the absence of active-if support this has to be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
97 # a sub-component. It does not use the CYGPKG_ prefix to make
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
98 # it easier to change back into an ordinary option later on.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
99 cdl_component CYGIMP_KERNEL_INTERRUPTS_DSRS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
100 display "Use delayed service routines (DSRs)"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
101 parent CYGPKG_KERNEL_INTERRUPTS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
102 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
103 In eCos the recommended way to handle device interrupts is to
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
104 do a minimum amount of work inside the low level interrupt
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
105 handler itself, and instead do as much as possible in a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
106 Delayed Service Routine or DSR. If an application does not
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
107 make use of DSRs directly or indirectly then it is possible
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
108 to disable the DSR support completely, which reduces the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
109 overheads of context switches and interrupt handling. Note
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
110 that the kernel real-time clock makes use of DSRs, as do many
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
111 of the device drivers. "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
112 doc ref/ecos-ref/interrupt-and-exception-handlers.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
113 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
114
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
115 # NOTE: the choice of list vs table should not be two separate
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
116 # options. There is a single option which must have one of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
117 # two legal values.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
118 cdl_option CYGIMP_KERNEL_INTERRUPTS_DSRS_LIST {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
119 display "Use linked lists for DSRs"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
120 parent CYGIMP_KERNEL_INTERRUPTS_DSRS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
121 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
122 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
123 When DSR support is enabled the kernel must keep track of all
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
124 the DSRs that are pending. This information can be kept in a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
125 fixed-size table or in a linked list. The list implementation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
126 requires that the kernel disable interrupts for a very short
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
127 period of time outside interrupt handlers, but there is no
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
128 possibility of a table overflow occurring."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
129 doc ref/ecos-ref/interrupts.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
130 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
131
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
132 cdl_option CYGIMP_KERNEL_INTERRUPTS_DSRS_TABLE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
133 display "Use fixed-size table for DSRs"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
134 parent CYGIMP_KERNEL_INTERRUPTS_DSRS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
135 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
136 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
137 When DSR support is enabled the kernel must keep track of all
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
138 the DSRs that are pending. This information can be kept in a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
139 fixed-size table or in a linked list. The table
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
140 implementation involves a very small risk of overflow at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
141 run-time if a given interrupt source is able to have more
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
142 than one pending DSR. However it has the advantage that
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
143 the kernel does not need to disable interrupts outside
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
144 interrupt handlers."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
145 doc ref/ecos-ref/interrupts.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
146 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
147
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
148 cdl_option CYGNUM_KERNEL_INTERRUPTS_DSRS_TABLE_SIZE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
149 display "Number of entries in fixed-size DSR table"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
150 parent CYGIMP_KERNEL_INTERRUPTS_DSRS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
151 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
152 legal_values 2 to 1024
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
153 #active_if CYGIMP_KERNEL_INTERRUPTS_DSRS_TABLE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
154 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
155 When DSR support is enabled the kernel must keep track of all
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
156 the DSRs that are pending. One approach involves a fixed-size
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
157 table, which involves a very small risk of overflow at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
158 run-time. By increasing the table size it is possible to reduce
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
159 this risk."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
160 doc ref/ecos-ref/interrupts.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
161 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
162
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
163 cdl_option CYGIMP_KERNEL_INTERRUPTS_CHAIN {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
164 display "Chain all interrupts together"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
165 parent CYGPKG_KERNEL_INTERRUPTS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
166 requires CYGIMP_HAL_COMMON_INTERRUPTS_CHAIN
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
167 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
168 Interrupts can be attached to vectors either singly, or be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
169 chained together. The latter is necessary if there is no way
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
170 of discovering which device has interrupted without
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
171 inspecting the device itself. It can also reduce the amount
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
172 of RAM needed for interrupt decoding tables and code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
173 doc ref/ecos-ref/interrupts.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
174 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
175
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
176 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
177
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
178 #define CYGIMP_KERNEL_INTERRUPTS_DSRS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
179 #define CYGIMP_KERNEL_INTERRUPTS_DSRS_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
180 #undef CYGIMP_KERNEL_INTERRUPTS_DSRS_TABLE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
181 #define CYGNUM_KERNEL_INTERRUPTS_DSRS_TABLE_SIZE 32
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
182 #undef CYGIMP_KERNEL_INTERRUPTS_CHAIN
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
183
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
184 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
185 * Exceptions. Currently there are only two options. The first
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
186 * determines whether or not exceptions are enabled at all. The
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
187 * second controls whether they apply globally or on a per-thread
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
188 * basis. There should probably be more options, but the boundary
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
189 * between the HAL and kernel becomes blurred.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
190
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
191 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
192
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
193 cdl_component CYGPKG_KERNEL_EXCEPTIONS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
194 display "Exception handling"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
195 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
196 requires CYGPKG_HAL_EXCEPTIONS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
197 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
198 In the context of the eCos kernel exceptions are unexpected
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
199 events detected by the hardware, for example an attempt to
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
200 execute an illegal instruction. There is no relation with
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
201 other forms of exception, for example the catch and throw
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
202 facilities of languages like C++. It is possible to disable
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
203 all support for exceptions and thus save some memory."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
204 doc ref/ecos-ref/exceptions.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
205 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
206
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
207 cdl_option CYGSEM_KERNEL_EXCEPTIONS_DECODE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
208 display "Decode exception types in kernel"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
209 parent CYGPKG_KERNEL_EXCEPTIONS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
210 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
211 On targets where several different types of exception are
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
212 possible, for example executing an illegal instruction and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
213 division by zero, it is possible for the kernel to do some
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
214 decoding of the exception type and deliver the different
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
215 types of exception to different handlers in the application
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
216 code. Alternatively the kernel can simply pass all
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
217 exceptions directly to application code, leaving the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
218 decoding to be done by the application"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
219 doc ref/ecos-ref/exceptions.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
220 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
221
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
222 cdl_option CYGSEM_KERNEL_EXCEPTIONS_GLOBAL {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
223 display "Use global exception handlers"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
224 parent CYGPKG_KERNEL_EXCEPTIONS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
225 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
226 In the context of the eCos kernel exceptions are unexpected
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
227 events detected by the hardware, for example an attempt to
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
228 execute an illegal instruction. If the kernel is configured
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
229 to support exceptions then two implementations are
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
230 possible. The default implementation involves a single set
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
231 of exception handlers that are in use for the entire
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
232 system. The alternative implementation allows different
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
233 exception handlers to be specified for each thread."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
234 doc ref/ecos-ref/exceptions.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
235 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
236
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
237 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
238
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
239 #define CYGPKG_KERNEL_EXCEPTIONS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
240 #undef CYGSEM_KERNEL_EXCEPTIONS_DECODE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
241 #define CYGSEM_KERNEL_EXCEPTIONS_GLOBAL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
242
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
243
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
244 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
245 * {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
246
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
247 cdl_component CYGPKG_KERNEL_SCHED {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
248 display "Kernel schedulers"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
249 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
250 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
251 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
252 The eCos kernel provides a choice of schedulers. In addition
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
253 there are a number of configuration options to control the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
254 detailed behaviour of these schedulers.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
255 "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
256 doc ref/ecos-ref/ecos-kernel-overview.html#THE-SCHEDULER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
257 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
258
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
259 cdl_option CYGSEM_KERNEL_SCHED_MLQUEUE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
260 display "Multi-level queue scheduler"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
261 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
262 parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
263 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
264 The multi-level queue scheduler supports multiple priority
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
265 levels and multiple threads at each priority level.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
266 Preemption between priority levels is automatic. Timeslicing
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
267 within a given priority level is controlled by a separate
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
268 configuration option"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
269 doc ref/ecos-ref/ecos-kernel-overview.html#THE-SCHEDULER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
270 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
271
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
272 cdl_option CYGSEM_KERNEL_SCHED_BITMAP {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
273 display "Bitmap scheduler"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
274 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
275 parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
276 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
277 The bitmap scheduler supports multiple priority levels but
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
278 only one thread can exist at each priority level. This means
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
279 that scheduling decisions are very simple and hence the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
280 scheduler is efficient. Preemption between priority levels is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
281 automatic. Timeslicing within a given priority level is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
282 irrelevant since there can be only one thread at each
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
283 priority level."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
284 doc ref/ecos-ref/ecos-kernel-overview.html#THE-SCHEDULER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
285 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
286
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
287 #cdl_option CYGSEM_KERNEL_SCHED_LOTTERY {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
288 # display "Lottery scheduler"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
289 # type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
290 # parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
291 # description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
292 # This scheduler is not yet available."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
293 #}
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
294
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
295 # NOTE: this option only makes sense if the current scheduler
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
296 # supports multiple priority levels.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
297 cdl_option CYGNUM_KERNEL_SCHED_PRIORITIES {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
298 display "Number of priority levels"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
299 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
300 legal_values 1 to 32
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
301 parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
302 #active_if CYGINT_KERNEL_SCHED_PRIORITY_SCHEDULER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
303 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
304 This option controls the number of priority levels that are
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
305 available. For some types of scheduler including the bitmap
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
306 scheduler this may impose an upper bound on the number of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
307 threads in the system. For other schedulers such as the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
308 mlqueue scheduler the number of threads is independent from
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
309 the number of priority levels. Note that the lowest priority
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
310 level is normally used only by the idle thread, although
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
311 application threads can run at this priority if necessary."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
312 doc ref/ecos-ref/ecos-kernel-overview.html#THE-SCHEDULER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
313 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
314
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
315 # NOTE: this option only makes sense for some of the schedulers.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
316 # Timeslicing is irrelevant for bitmap schedulers.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
317 cdl_option CYGSEM_KERNEL_SCHED_TIMESLICE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
318 display "Scheduler timeslicing"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
319 parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
320 requires !CYGSEM_KERNEL_SCHED_BITMAP
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
321 requires CYGVAR_KERNEL_COUNTERS_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
322 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
323 Some schedulers including the mlqueue scheduler support
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
324 timeslicing. This means that the kernel will check regularly
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
325 whether or not there is another runnable thread with the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
326 same priority, and if there is such a thread there will be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
327 an automatic context switch. Not all applications require
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
328 timeslicing, for example because every thread performs a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
329 blocking operation regularly. For these applications it is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
330 possible to disable timeslicing, which reduces the overheads
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
331 associated with timer interrupts."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
332 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
333
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
334 cdl_option CYGNUM_KERNEL_SCHED_TIMESLICE_TICKS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
335 display "Number of clock ticks between timeslices"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
336 parent CYGPKG_KERNEL_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
337 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
338 legal_values 1 to 65535
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
339 #active_if CYGSEM_KERNEL_SCHED_TIMESLICE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
340 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
341 Assuming timeslicing is enabled, how frequently should it
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
342 take place? The value of this option corresponds to the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
343 number of clock ticks that should occur before a timeslice
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
344 takes place, so increasing the value reduces the frequency
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
345 of timeslices."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
346 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
347
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
348 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
349
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
350 #define CYGSEM_KERNEL_SCHED_MLQUEUE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
351 #undef CYGSEM_KERNEL_SCHED_BITMAP
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
352 #undef CYGSEM_KERNEL_SCHED_LOTTERY
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
353 #define CYGNUM_KERNEL_SCHED_PRIORITIES 32
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
354 #define CYGSEM_KERNEL_SCHED_TIMESLICE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
355 #define CYGNUM_KERNEL_SCHED_TIMESLICE_TICKS 5
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
356
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
357 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
358 * Counters and clocks.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
359
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
360 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
361
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
362 cdl_component CYGPKG_KERNEL_COUNTERS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
363 display "Counters and clocks"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
364 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
365 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
366 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
367 The counter objects provided by the kernel provide an
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
368 abstraction of the clock facility that is generally provided.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
369 Application code can associate alarms with counters, where an
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
370 alarm is identified by the number of ticks until it triggers,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
371 the action to be taken on triggering, and whether or not the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
372 alarm should be repeated."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
373 doc ref/ecos-ref/counters-clocks-and-alarms.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
374 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
375
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
376 cdl_option CYGVAR_KERNEL_COUNTERS_CLOCK {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
377 display "Provide real-time clock"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
378 parent CYGPKG_KERNEL_COUNTERS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
379 requires CYGIMP_KERNEL_INTERRUPTS_DSRS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
380 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
381 On all current target systems the kernel can provide a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
382 real-time clock. This clock serves two purposes. First it is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
383 necessary to support clock and alarm related functions.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
384 Second it is needed to implement timeslicing in some of the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
385 schedulers including the mlqueue scheduler. If the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
386 application does not require any of these facilities then it
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
387 is possible to disable the real time clock support
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
388 completely."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
389 doc ref/ecos-ref/counters-clocks-and-alarms.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
390 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
391
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
392 cdl_component CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
393 display "Override default clock settings"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
394 parent CYGPKG_KERNEL_COUNTERS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
395 requires CYGVAR_KERNEL_COUNTERS_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
396 type bool
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
397 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
398 The kernel has default settings for the clock interrupt
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
399 frequency. These settings will vary from platform to
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
400 platform, but typically there will be a 100 clock interrupts
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
401 every second. It is possible to change this frequency, but
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
402 it requires some knowledge of the target hardware.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
403 "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
404 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
405
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
406 cdl_option CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_PERIOD {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
407 display "Clock hardware initialization value"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
408 parent CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
409 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
410 legal_values 1 to 0x7fffffff
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
411 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
412 During system initialization this value is used to initialize
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
413 the clock hardware. The exact meaning of the value and the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
414 range of legal values therefore depends on the target hardware,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
415 and the hardware documentation should be consulted for further
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
416 details. In addition the clock resolution numerator and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
417 denominator values should be updated. Typical values for
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
418 this option would be 150000 on the MN10300 stdeval1 board,
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
419 15625 on the tx39 jmr3904 board, and 20833 on the powerpc
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
420 cogent board."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
421 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
422
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
423 cdl_option CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_NUMERATOR {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
424 display "Clock resolution numerator"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
425 parent CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
426 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
427 legal_values 1 to 0x7fffffff
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
428 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
429 If a non-default clock interrupt frequency is used then it
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
430 is necessary to specify the clock resolution explicitly.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
431 This resolution involves two separate values, the numerator
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
432 and the denominator. The result of dividing the numerator by
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
433 the denominator should correspond to the number of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
434 nanoseconds between clock interrupts. For example a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
435 numerator of 1000000000 and a denominator of 100 means that
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
436 there are 10000000 nanoseconds (or 10 milliseconds) between
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
437 clock interrupts. Expressing the resolution as a fraction
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
438 should minimize clock drift even for frequencies that cannot
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
439 be expressed as a simple integer. For example a frequency of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
440 60Hz corresponds to a clock resolution of 16666666.66...
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
441 nanoseconds. This can be expressed accurately as 1000000000
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
442 over 60."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
443 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
444
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
445 cdl_option CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_DENOMINATOR {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
446 display "Clock resolution denominator"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
447 parent CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
448 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
449 legal_values 1 to 0x7fffffff
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
450 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
451 If a non-default clock interrupt frequency is used then it
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
452 is necessary to specify the clock resolution explicitly.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
453 This resolution involves two separate values, the numerator
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
454 and the denominator. The result of dividing the numerator by
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
455 the denominator should correspond to the number of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
456 nanoseconds between clock interrupts. For example a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
457 numerator of 1000000000 and a denominator of 100 means that
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
458 there are 10000000 nanoseconds (or 10 milliseconds) between
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
459 clock interrupts. Expressing the resolution as a fraction
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
460 should minimize clock drift even for frequencies that cannot
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
461 be expressed as a simple integer. For example a frequency of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
462 60Hz corresponds to a clock resolution of 16666666.66...
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
463 nanoseconds. This can be expressed accurately as 1000000000
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
464 over 60."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
465 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
466
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
467
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
468 # NOTE: these option should really be a single enum.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
469 cdl_option CYGIMP_KERNEL_COUNTERS_SINGLE_LIST {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
470 display "Implement counters using a single list"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
471 parent CYGPKG_KERNEL_COUNTERS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
472 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
473 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
474 There are two different implementations of the counter
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
475 objects. The first implementation stores all alarms in a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
476 single linked list. The alternative implementation uses a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
477 table of linked lists. A single list is more efficient in
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
478 terms of memory usage and is generally adequate when the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
479 application only makes use of a small number of alarms."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
480 doc ref/ecos-ref/counters-clocks-and-alarms.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
481 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
482
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
483 cdl_option CYGIMP_KERNEL_COUNTERS_MULTI_LIST {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
484 display "Implement counters using a table of lists"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
485 parent CYGPKG_KERNEL_COUNTERS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
486 type radio
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
487 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
488 There are two different implementations of the counter
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
489 objects. The first implementation stores all alarms in a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
490 single linked list. The alternative implementation uses a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
491 table of linked lists, with the size of the table being a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
492 separate configurable option. For more complicated
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
493 operations it is better to have a table of lists since this
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
494 reduces the amount of computation whenever the timer goes
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
495 off. Assuming a table size of 8 (the default value) on
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
496 average the timer code will only need to check 1/8 of the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
497 pending alarms instead of all of them."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
498 doc ref/ecos-ref/counters-clocks-and-alarms.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
499 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
500
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
501 cdl_option CYGNUM_KERNEL_COUNTERS_MULTI_LIST_SIZE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
502 display "Size of counter list table"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
503 parent CYGPKG_KERNEL_COUNTERS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
504 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
505 legal_values 1 to 1024
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
506 #active_if CYGIMP_KERNEL_COUNTERS_MULTI_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
507 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
508 If counters are implemented using an array of linked lists
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
509 then this option controls the size of the array. A larger
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
510 size reduces the amount of computation that needs to take
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
511 place whenever the timer goes off, but requires extra
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
512 memory."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
513 doc ref/ecos-ref/counters-clocks-and-alarms.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
514 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
515
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
516 cdl_option CYGIMP_KERNEL_COUNTERS_SORT_LIST {
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
517 display "Sort the counter list"
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
518 parent CYGPKG_KERNEL_COUNTERS
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
519 type bool
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
520 description "
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
521 Sorting the counter lists reduces the amount of work that
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
522 has to be done when a counter tick is processed, since the
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
523 next alarm to expire is always at the front of the list.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
524 However, it makes adding an alarm to the list more expensive
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
525 since a search must be done for the correct place to put it.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
526 Many alarms are used to implement timeouts, which seldom trigger,
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
527 so it is worthwhile optimizing this case. For this reason
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
528 sorted list are disabled by default."
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
529 }
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
530
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
531 cdl_option CYGVAR_KERNEL_COUNTERS_CLOCK_LATENCY {
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
532 display "Measure real-time [clock] interrupt latency"
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
533 parent CYGPKG_KERNEL_COUNTERS
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
534 requires CYGVAR_KERNEL_COUNTERS_CLOCK
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
535 description "
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
536 Measure the interrupt latency as seen by the real-time clock
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
537 timer interrupt. This requires hardware support, defined by
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
538 the HAL_CLOCK_LATENCY() macro."
34
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
539 doc ref/ecos-ref/counters-clocks-and-alarms.html
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
540 }
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
541
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
542 cdl_option CYGVAR_KERNEL_COUNTERS_CLOCK_DSR_LATENCY {
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
543 display "Measure real-time [clock] DSR latency"
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
544 parent CYGPKG_KERNEL_COUNTERS
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
545 requires CYGVAR_KERNEL_COUNTERS_CLOCK
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
546 requires CYGVAR_KERNEL_COUNTERS_CLOCK_LATENCY
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
547 description "
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
548 Measure the DSR latency as seen by the real-time clock
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
549 timer interrupt. This requires hardware support, defined by
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
550 the HAL_CLOCK_LATENCY() macro."
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
551 doc ref/ecos-ref/counters-clocks-and-alarms.html
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
552 }
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
553
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
554 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
555
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
556 #define CYGVAR_KERNEL_COUNTERS_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
557 #undef CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
558 #define CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_PERIOD 9999
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
559 #define CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_NUMERATOR 1000000000
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
560 #define CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_DENOMINATOR 100
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
561 #define CYGIMP_KERNEL_COUNTERS_SINGLE_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
562 #undef CYGIMP_KERNEL_COUNTERS_MULTI_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
563 #define CYGNUM_KERNEL_COUNTERS_MULTI_LIST_SIZE 8
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
564 #undef CYGIMP_KERNEL_COUNTERS_SORT_LIST
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
565 #undef CYGVAR_KERNEL_COUNTERS_CLOCK_LATENCY
34
29bc183297e1 Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents: 8
diff changeset
566 #undef CYGVAR_KERNEL_COUNTERS_CLOCK_DSR_LATENCY
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
567
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
568 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
569 * Thread-related options
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
570 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
571
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
572 cdl_component CYGPKG_KERNEL_THREADS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
573 display "Thread-related options"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
574 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
575 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
576 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
577 There are a number of configuration options related to the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
578 implementation of threads, for example whether or not the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
579 eCos kernel supports per-thread data."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
580 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
581 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
582
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
583 cdl_option CYGFUN_KERNEL_THREADS_TIMER {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
584 display "Allow per-thread timers"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
585 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
586 requires CYGVAR_KERNEL_COUNTERS_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
587 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
588 This option controls whether or not the kernel should support
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
589 per-thread clock and alarm related functions. Also some of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
590 the synchronization primitives such as semaphore and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
591 condition variable timed wait operations require per-thread
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
592 timer support. If none of these facilities are required then
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
593 the option can be disabled."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
594 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
595 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
596
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
597 cdl_option CYGVAR_KERNEL_THREADS_NAME {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
598 display "Support optional name for each thread"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
599 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
600 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
601 Threads may optionally be supplied with a name string that is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
602 used to identify them during debugging. This name is only
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
603 present if `this option is defined. Disabling it reduces both
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
604 code and data size."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
605 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
606 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
607
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
608 cdl_option CYGVAR_KERNEL_THREADS_LIST {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
609 display "Keep track of all threads using a linked list"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
610 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
611 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
612 Threads may optionally be placed on a housekeeping list so
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
613 that all threads may be located easily. This is useful mainly
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
614 in conjunction with source-level debugging."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
615 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
616 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
617
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
618 cdl_option CYGFUN_KERNEL_THREADS_STACK_LIMIT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
619 display "Keep track of the base of each thread's stack"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
620 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
621 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
622 This option makes the kernel keep track of the lower limit on
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
623 each thread's stack. It allows the kernel to adjust the lower
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
624 limit, thus making space for per-thread data. Note that it
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
625 does not imply any form of run-time stack overflow checking."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
626 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
627 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
628
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
629 cdl_option CYGVAR_KERNEL_THREADS_DATA {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
630 display "Support for per-thread data"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
631 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
632 requires CYGFUN_KERNEL_THREADS_STACK_LIMIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
633 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
634 It is possible for the kernel to support per-thread data, in
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
635 other words an area of memory specific to each thread which
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
636 can be used to store data for that thread. This per-thread
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
637 data can be used by applications or by other packages such as
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
638 the ISO C library."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
639 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
640 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
641
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
642 cdl_option CYGNUM_KERNEL_THREADS_DATA_MAX {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
643 display "Number of words of per-thread data"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
644 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
645 #active_if CYGVAR_KERNEL_THREADS_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
646 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
647 legal_values 1 to 65535
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
648 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
649 It is possible for the kernel to support per-thread data, in
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
650 other words an area of memory specific to each thread which
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
651 can be used to store data for that thread. This per-thread
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
652 data can be used by applications or by other packages such as
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
653 the ISO C library. This configuration option controls the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
654 number of words of per-thread data that the kernel will
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
655 allow."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
656 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
657 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
658
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
659 cdl_option CYGNUM_KERNEL_THREADS_IDLE_STACK_SIZE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
660 display "Stack size for the idle thread"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
661 parent CYGPKG_KERNEL_THREADS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
662 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
663 legal_values 512 to 65536
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
664 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
665 This configuration option specifies the stack size in bytes
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
666 for the idle thread. Unless the HAL is configured to use a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
667 separate interrupt stack this size must be sufficient to meet
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
668 the requirements of all interrupt handlers - these
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
669 requirements are cumulative if nested interrupted are
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
670 enabled. Depending on the target architecture, the stack size
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
671 typically has to be a multiple of eight or sixteen bytes.
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
672 This will be overridden where it is used if the
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
673 architectural HAL requires a minimum stack size
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
674 to handle interrupts correctly."
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
675
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
676 doc ref/ecos-ref/thread-operations.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
677 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
678
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
679 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
680
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
681 #define CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
682 #define CYGVAR_KERNEL_THREADS_NAME
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
683 #define CYGVAR_KERNEL_THREADS_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
684 #define CYGFUN_KERNEL_THREADS_STACK_LIMIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
685 #define CYGVAR_KERNEL_THREADS_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
686 #define CYGNUM_KERNEL_THREADS_DATA_MAX 6
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
687 #define CYGNUM_KERNEL_THREADS_IDLE_STACK_SIZE 2048
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
688
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
689
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
690 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
691 * Synchronization primitives.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
692
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
693 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
694
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
695 cdl_component CYGPKG_KERNEL_SYNCH {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
696 display "Synchronization primitives"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
697 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
698 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
699 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
700 The eCos kernel supports a number of different
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
701 synchronization primitives such as mutexes, semaphores,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
702 condition variables, and message boxes. There are
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
703 configuration options to control the exact behaviour of some
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
704 of these synchronization primitives.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
705 "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
706 doc ref/ecos-ref/thread-synchronization.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
707 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
708
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
709 # NOTE: the requires statement is only valid for the current kernel.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
710 # Priority inheritance is possible in other schedulers as well
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
711 # but is not yet implemented.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
712 cdl_option CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
713 display "Simple mutex priority inheritance"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
714 requires CYGSEM_KERNEL_SCHED_MLQUEUE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
715 parent CYGPKG_KERNEL_SYNCH
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
716 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
717 This option enables a relatively simple implementation of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
718 mutex priority inheritance. The implementation will only work
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
719 in the mlqueue scheduler, and it does not handle the rare
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
720 case of nested mutexes completely correctly. However it is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
721 both fast and deterministic. Mutex priority inheritance can
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
722 be disabled if the application does not require it, which
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
723 will reduce both code size and data space."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
724 doc ref/ecos-ref/synchronization.html#MUTEXES
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
725 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
726
62
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
727 cdl_option CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE_RELAY {
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
728 display "Relay enhancement to simple mutex priority inheritance"
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
729 parent CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
730 description "
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
731 This option enables an extension to the simple implementation of
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
732 mutex priority inheritance whereby a thread releasing a mutex to a
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
733 waiting thread relays its own priority to the new owner if there
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
734 are still further threads waiting. This can be viewed as a
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
735 discovered priority ceiling."
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
736 doc ref/ecos-ref/synchronization.html#MUTEXES
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
737 }
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
738
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
739 cdl_option CYGMFN_KERNEL_SYNCH_MBOXT_PUT_CAN_WAIT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
740 display "Message box blocking put support"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
741 parent CYGPKG_KERNEL_SYNCH
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
742 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
743 Message boxes can support three different versions of the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
744 put-message operation. The first is tryput(), which will fail
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
745 if the message box is already full. The other two are the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
746 ordinary put() function which will block if the message box
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
747 is full, and a timed put() operation which will block for
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
748 upto a certain length of time if the message box is currently
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
749 full. The blocking versions require extra memory in the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
750 message box data structure and extra code in the other
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
751 message box functions, so they can be disabled if the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
752 application does not require them. If this option is enabled
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
753 then the system will always provide the blocking put()
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
754 function, and it will also provide the timed put() function
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
755 if thread timers are enabled."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
756 doc ref/ecos-ref/message-boxes.html
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
757 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
758
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
759 cdl_option CYGNUM_KERNEL_SYNCH_MBOX_QUEUE_SIZE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
760 display "Message box queue size"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
761 parent CYGPKG_KERNEL_SYNCH
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
762 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
763 legal_values 1 to 65535
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
764 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
765 This configuration option controls the number of messages
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
766 that can be queued in a message box before a non-blocking
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
767 put() operation will fail or a blocking put() operation will
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
768 block. The cost in memory is one pointer per message box for
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
769 each possible message."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
770 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
771
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
772 cdl_option CYGMFN_KERNEL_SYNCH_CONDVAR_TIMED_WAIT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
773 display "Condition variable timed-wait support"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
774 parent CYGPKG_KERNEL_SYNCH
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
775 requires CYGFUN_KERNEL_THREADS_TIMER
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
776 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
777 This option enables the condition variable timed wait
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
778 facility."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
779 doc ref/ecos-ref/synchronization.html#CONDITION-VARIABLES
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
780 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
781
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
782 }}CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
783
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
784 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
785
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
786 #define CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE
62
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents: 34
diff changeset
787 #define CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE_RELAY
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
788 #define CYGMFN_KERNEL_SYNCH_MBOXT_PUT_CAN_WAIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
789 #define CYGNUM_KERNEL_SYNCH_MBOX_QUEUE_SIZE 10
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
790 #define CYGMFN_KERNEL_SYNCH_CONDVAR_TIMED_WAIT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
791
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
792 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
793 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
794
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
795 cdl_component CYGPKG_KERNEL_INSTRUMENT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
796 display "Kernel instrumentation"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
797 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
798 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
799 The current release of the kernel contains an initial version
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
800 of instrumentation support. The various parts of the kernel
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
801 will invoke instrumentation routines whenever appropriate
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
802 events occur, and these will be stored in a circular buffer
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
803 for later reference."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
804 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
805
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
806
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
807 cdl_option CYGNUM_KERNEL_INSTRUMENT_BUFFER_SIZE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
808 display "Size of instrumentation buffer size"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
809 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
810 type count
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
811 legal_values 16 to 0x100000
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
812 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
813 If kernel instrumentation is enabled then the instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
814 data goes into a circular buffer. A larger buffer allows
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
815 more data to be stored, but at a significant cost in memory.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
816 The value of this option corresponds to the number of entries
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
817 in the table, and typically each entry will require 16 bytes
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
818 of memory."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
819 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
820
6
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
821 cdl_option CYGNUM_KERNEL_INSTRUMENT_BUFFER_WRAP {
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
822 display "Wrap instrument buffer"
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
823 parent CYGPKG_KERNEL_INSTRUMENT
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
824 description "
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
825 When the instrumentation buffer is full it can either be restarted
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
826 from the beginning, overwriting older data, or it can stop at the
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
827 end. The former is useful if you want to look at the last entries
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
828 made while the latter is useful if you want to look at the first
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
829 few."
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
830 }
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
831
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
832 cdl_option CYGDBG_KERNEL_INSTRUMENT_FLAGS {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
833 display "Perform selective instrumentation"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
834 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
835 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
836 The kernel can either collect all instrumentation events, or
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
837 it can filter out events at runtime based on a set of flags.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
838 For example it would be possible to decide at runtime that
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
839 only scheduler and interrupt instrumentation flags are of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
840 interest and that all other flags should be ignored. This
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
841 flag mechanism involves extra code and processor cycle
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
842 overhead in the instrumentation code, so it can be disabled
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
843 if the application developer is interested in all
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
844 instrumentation events."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
845 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
846
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
847 # NOTE: many of these options should only be active if the appropriate
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
848 # component is active.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
849 cdl_option CYGDBG_KERNEL_INSTRUMENT_SCHED {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
850 display "Instrument the scheduler"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
851 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
852 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
853 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
854 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
855 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
856 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
857 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
858 the scheduling code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
859 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
860
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
861 cdl_option CYGDBG_KERNEL_INSTRUMENT_THREAD {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
862 display "Instrument thread operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
863 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
864 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
865 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
866 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
867 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
868 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
869 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
870 the code that manipulates threads."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
871 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
872
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
873 cdl_option CYGDBG_KERNEL_INSTRUMENT_INTR {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
874 display "Instrument interrupts"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
875 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
876 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
877 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
878 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
879 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
880 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
881 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
882 the interrupt handling code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
883 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
884
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
885 cdl_option CYGDBG_KERNEL_INSTRUMENT_MUTEX {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
886 display "Instrument mutex operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
887 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
888 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
889 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
890 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
891 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
892 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
893 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
894 the mutex code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
895 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
896
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
897 cdl_option CYGDBG_KERNEL_INSTRUMENT_CONDVAR {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
898 display "Instrument condition variable operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
899 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
900 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
901 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
902 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
903 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
904 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
905 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
906 the condition variable code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
907 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
908
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
909 cdl_option CYGDBG_KERNEL_INSTRUMENT_BINSEM {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
910 display "Instrument binary semaphore operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
911 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
912 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
913 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
914 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
915 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
916 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
917 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
918 the binary semaphore code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
919 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
920
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
921 cdl_option CYGDBG_KERNEL_INSTRUMENT_CNTSEM {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
922 display "Instrument counting semaphore operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
923 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
924 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
925 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
926 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
927 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
928 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
929 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
930 the counting semaphore code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
931 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
932
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
933 cdl_option CYGDBG_KERNEL_INSTRUMENT_MBOXT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
934 display "Instrument message box operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
935 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
936 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
937 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
938 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
939 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
940 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
941 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
942 the message box code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
943 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
944
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
945 cdl_option CYGDBG_KERNEL_INSTRUMENT_CLOCK {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
946 display "Instrument clock operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
947 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
948 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
949 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
950 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
951 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
952 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
953 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
954 the real-time clock code."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
955 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
956
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
957 cdl_option CYGDBG_KERNEL_INSTRUMENT_ALARM {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
958 display "Instrument alarm-related operations"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
959 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
960 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
961 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
962 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
963 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
964 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
965 whether or not instrumentation support is compiled into
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
966 the code related to alarm operations."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
967 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
968
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
969 cdl_option CYGDBG_KERNEL_INSTRUMENT_USER {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
970 display "Support application-level instrumentation"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
971 parent CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
972 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
973 It is possible to perform selective instrumentation at
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
974 run-time. It is also possible to disable instrumentation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
975 in various kernel components at compile-time, thus
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
976 reducing the code size overheads. This option controls
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
977 whether or not application-level instrumentation gets
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
978 compiled in."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
979 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
980
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
981 }}CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
982 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
983
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
984 #undef CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
985 #undef CYGVAR_KERNEL_INSTRUMENT_EXTERNAL_BUFFER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
986 #define CYGNUM_KERNEL_INSTRUMENT_BUFFER_SIZE 256
6
d376b777e2ce Merge from eCos master repository on 1999-05-14-19:27:43-BST
jlarmour
parents: 2
diff changeset
987 #define CYGDBG_KERNEL_INSTRUMENT_BUFFER_WRAP
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
988 #define CYGDBG_KERNEL_INSTRUMENT_FLAGS
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
989 #define CYGDBG_KERNEL_INSTRUMENT_SCHED
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
990 #define CYGDBG_KERNEL_INSTRUMENT_THREAD
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
991 #define CYGDBG_KERNEL_INSTRUMENT_INTR
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
992 #define CYGDBG_KERNEL_INSTRUMENT_MUTEX
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
993 #define CYGDBG_KERNEL_INSTRUMENT_CONDVAR
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
994 #define CYGDBG_KERNEL_INSTRUMENT_BINSEM
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
995 #define CYGDBG_KERNEL_INSTRUMENT_CNTSEM
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
996 #define CYGDBG_KERNEL_INSTRUMENT_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
997 #define CYGDBG_KERNEL_INSTRUMENT_ALARM
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
998 #define CYGDBG_KERNEL_INSTRUMENT_MBOXT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
999 #define CYGDBG_KERNEL_INSTRUMENT_USER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1000
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1001 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1002 * There appears to be somewhat of a lack of configuration options here.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1003 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1004
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1005 cdl_component CYGPKG_KERNEL_MEMORY {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1006 display "Memory allocators"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1007 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1008 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1009 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1010 Configuration options related to the kernel memory allocation
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1011 support."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1012 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1013
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1014 cdl_option CYGSEM_KERNEL_MEMORY_COALESCE {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1015 display "Coalesce memory in the variable-block allocator"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1016 parent CYGPKG_KERNEL_MEMORY
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1017 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1018 The variable-block memory allocator can perform coalescing
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1019 of memory whenever the application code releases memory back
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1020 to the pool. This coalescing reduces the possibility of
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1021 memory fragmentation problems, but involves extra code and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1022 processor cycles."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1023 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1024
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1025 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1026
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1027 #define CYGSEM_KERNEL_MEMORY_COALESCE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1028
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1029 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1030 * Options related to source-level debugging and diagnostics.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1031
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1032 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1033
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1034 cdl_component CYGPKG_KERNEL_DEBUG {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1035 display "Source-level debugging support"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1036 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1037 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1038 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1039 If the source level debugger gdb is to be used for debugging
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1040 application code then it may be necessary to configure in support
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1041 for this in the kernel."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1042 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1043
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1044 # NOTE: does this require any other support ?
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1045 cdl_option CYGDBG_KERNEL_DEBUG_GDB_THREAD_SUPPORT {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1046 display "Include GDB multi-threading debug support"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1047 parent CYGPKG_KERNEL_DEBUG
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1048 requires CYGVAR_KERNEL_THREADS_LIST
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1049 requires CYGDBG_HAL_DEBUG_GDB_THREAD_SUPPORT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1050 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1051 This option enables some extra kernel code which is needed
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1052 to support multi-threaded source level debugging."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1053 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1054
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1055 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1056
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1057 #define CYGDBG_KERNEL_DEBUG_GDB_THREAD_SUPPORT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1058
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1059 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1060 * Kernel API's. The C++ one is the default. A C API is optional.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1061 * Support for other languages is possible.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1062
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1063 {{CFG_DATA
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1064
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1065 cdl_component CYGPKG_KERNEL_API {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1066 display "Kernel APIs"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1067 type dummy
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1068 parent CYGPKG_KERNEL
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1069 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1070 The eCos kernel is implemented in C++, so a C++ interface
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1071 to the kernel is always available. There is also an optional
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1072 C API. Additional API's may be provided in future versions."
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
1073 doc ref/ecos-ref/kernel-apis.html
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1074 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1075
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1076 cdl_option CYGFUN_KERNEL_API_C {
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1077 display "Provide C API"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1078 parent CYGPKG_KERNEL_API
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1079 description "
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1080 The eCos kernel is implemented in C++, but there is an
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1081 optional C API for use by application code. This C API can be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1082 disabled if the application code does not invoke the kernel
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1083 directly, but instead uses higher level code such as the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1084 uITRON compatibility layer."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1085 }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1086
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1087 }}CFG_DATA */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1088
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1089 #define CYGFUN_KERNEL_API_C
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1090
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1091 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1092 * The rest of this header file contains various fix-ups and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1093 * options which cannot yet be controlled via the GUI tool.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1094 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1095 * First some miscellaneous scheduler support, all calculated.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1096 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1097
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1098 #if defined(CYGSEM_KERNEL_SCHED_TIMESLICE) && defined(CYGSEM_KERNEL_SCHED_BITMAP)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1099 # error Timeslicing cannot be enabled if the bitmap scheduler is used.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1100 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1101
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1102 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1103 * These #define's are for the system's internal use only and should
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1104 * not be edited by users. */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1105 #ifdef CYGSEM_KERNEL_SCHED_BITMAP
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1106 # define CYGPRI_KERNEL_SCHED_IMPL_HXX <cyg/kernel/bitmap.hxx>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1107 #elif defined(CYGSEM_KERNEL_SCHED_MLQUEUE)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1108 # define CYGPRI_KERNEL_SCHED_IMPL_HXX <cyg/kernel/mlqueue.hxx>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1109 #elif defined(CYGSEM_KERNEL_SCHED_LOTTERY)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1110 # define CYGPRI_KERNEL_SCHED_IMPL_HXX <cyg/kernel/lottery.hxx>
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1111 #else
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1112 #error No Scheduler defined
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1113 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1114
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1115 #define CYGNUM_KERNEL_SCHED_BITMAP_SIZE CYGNUM_KERNEL_SCHED_PRIORITIES
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1116
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1117 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1118 * Counter and clock related miscellania.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1119 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1120 * If a real-time clock is enabled then there are additional
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1121 * configuration options controlling the resolution of the clock,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1122 * CYGNUM_KERNEL_COUNTERS_RTC_RESOLUTION and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1123 * CYGNUM_KERNEL_COUNTERS_RTC_PERIOD. Different targets require
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1124 * different default values, and the current configuration tool cannot
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1125 * deal with this yet. Also the exact details of the resolution and
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1126 * period values are still subject to change.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1127 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1128 * To allow the clock settings to be controlled in some fashion,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1129 * there is a configuration option to override the default settings.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1130 * If this option is enabled then the resolution and period
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1131 * #define's will come from configuration options (which do not
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1132 * necessarily have sensible defaults, and which are not validated).
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1133 * Otherwise the platform-specific numbers below are used. On
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1134 * hardware this result in 100 clock interrupts every second.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1135 * For simulators slightly different values are used, so that the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1136 * various test cases run faster.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1137 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1138
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1139 #ifdef CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1140
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1141 # define CYGNUM_KERNEL_COUNTERS_RTC_RESOLUTION \
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1142 { CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_NUMERATOR, \
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1143 CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_DENOMINATOR }
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1144
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1145 # define CYGNUM_KERNEL_COUNTERS_RTC_PERIOD CYGNUM_KERNEL_COUNTERS_CLOCK_OVERRIDE_PERIOD
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1146
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1147 #else /* CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1148
8
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1149 // Include HAL/Platform specifics
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1150 #include CYGBLD_HAL_PLATFORM_H
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1151
8
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1152 // Fallback defaults (in case HAL didn't define these)
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1153 #ifndef CYGNUM_HAL_RTC_NUMERATOR
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1154 #define CYGNUM_HAL_RTC_NUMERATOR 1000000000
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1155 #define CYGNUM_HAL_RTC_DENOMINATOR 100
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1156 #define CYGNUM_HAL_RTC_PERIOD 9999
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1157 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1158
8
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1159 #define CYGNUM_KERNEL_COUNTERS_RTC_RESOLUTION \
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1160 {CYGNUM_HAL_RTC_NUMERATOR, CYGNUM_HAL_RTC_DENOMINATOR}
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1161 #define CYGNUM_KERNEL_COUNTERS_RTC_PERIOD \
ece80412419a Merge from eCos master repository on 1999-05-21-22:05:54-BST
jlarmour
parents: 6
diff changeset
1162 CYGNUM_HAL_RTC_PERIOD
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1163
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1164 #endif /* CYGPKG_KERNEL_COUNTERS_CLOCK_OVERRIDE */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1165
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1166 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1167 * Thread-related miscellania.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1168 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1169 * These options provide for an assertion that the count value for counted
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1170 * thread wakeups or for thread suspends do not exceed set limits. This is
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1171 * to help with debugging, to allow a runaaway loop, for example, to be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1172 * detected more easily.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1173 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1174 * If the option is not defined, no assert is included. Whether asserts
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1175 * are themselves included depends on infrastructure configury in infra.h
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1176 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1177 * It is hoped that these defaults are helpful rather than interfering.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1178 */
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
1179 #define CYGNUM_KERNEL_MAX_SUSPEND_COUNT_ASSERT (500)
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
1180 #define CYGNUM_KERNEL_MAX_COUNTED_WAKE_COUNT_ASSERT (500)
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1181
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1182 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1183 * If the scheduler configuration only has a single priority level,
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1184 * then the idle thread must yield each time around its loop.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1185 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1186
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1187 #if CYGNUM_KERNEL_SCHED_PRIORITIES == 1
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1188 # define CYGIMP_IDLE_THREAD_YIELD
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1189 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1190
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1191 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1192 * Per thread data options. Per thread data suuport is based loosely
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1193 * on that define by POSIX. Each thread has an array of slots, up to
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1194 * CYGNUM_KERNEL_THREADS_DATA_MAX, that may contain data. Some of the
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1195 * slots have been preallocated to specific packages. Others may be
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1196 * allocated dynamically.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1197 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1198
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1199 #define CYGNUM_KERNEL_THREADS_DATA_KERNEL 0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1200 #define CYGNUM_KERNEL_THREADS_DATA_ITRON 1
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1201 #define CYGNUM_KERNEL_THREADS_DATA_LIBC 2
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1202 #define CYGNUM_KERNEL_THREADS_DATA_POSIX 3
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1203
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1204 #define CYGNUM_KERNEL_THREADS_DATA_ALL 0xF
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1205
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1206 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1207 * Some consistency checks.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1208 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1209 #if defined(CYGFUN_KERNEL_THREADS_TIMER) && !defined(CYGVAR_KERNEL_COUNTERS_CLOCK)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1210 # error "Cannot have Thread Timers without Real Time Clock"
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1211 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1212
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1213 #if defined(CYGDBG_KERNEL_DEBUG_GDB_THREAD_SUPPORT) && !defined(CYGVAR_KERNEL_THREADS_LIST)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1214 # error "GDB thread support requires a list of all known threads."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1215 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1216
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1217 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1218 * Synchronization primitives miscellania.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1219 *
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1220 * These lines should not be edited by users.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1221 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1222 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1223 # define CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1224 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1225 #if defined(CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE) && !defined(CYGSEM_KERNEL_SCHED_MLQUEUE)
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1226 # error "Priority inheritance can only be enabled if the mlqueue scheduler is used."
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1227 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1228
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1229 /* ---------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1230 * This code allows the kernel build to be configured as a GDB
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1231 * stub ROM monitor. It is only intended for internal use.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1232 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1233
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1234 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1235 * BLV: This code must be kept commented out for now, as it can
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1236 * confuse the configuration tool. The correct solution is to have a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1237 * standard configuration for the system as represented by e.g. a
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1238 * .ptest file which does the right thing. A ROM monitor is an
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1239 * application, and application-specific configuration stuff should
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1240 * not live in the master header file.
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1241 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1242
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1243 /*
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1244 #undef CYG_HAL_ROM_MONITOR
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1245
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1246 #ifdef CYG_HAL_ROM_MONITOR
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1247
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1248 #undef CYGFUN_HAL_COMMON_KERNEL_SUPPORT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1249 #undef CYGDBG_HAL_COMMON_INTERRUPTS_SAVE_MINIMUM_CONTEXT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1250 #undef CYGIMP_HAL_COMMON_INTERRUPTS_USE_INTERRUPT_STACK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1251 #undef CYGSEM_HAL_COMMON_INTERRUPTS_ALLOW_NESTING
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1252 #undef CYGIMP_KERNEL_INTERRUPTS_CHAIN
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1253 #undef CYGVAR_KERNEL_COUNTERS_CLOCK
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1254 #undef CYGFUN_KERNEL_THREADS_TIMER
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1255 #undef CYGPKG_KERNEL_EXCEPTIONS
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
1256 #undef CYGSEM_KERNEL_SCHED_TIMESLICE
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1257 #undef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE_SIMPLE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1258 #undef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INHERITANCE
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1259 #undef CYGPKG_KERNEL_INSTRUMENT
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1260 #undef CYGDBG_INFRA_DIAG_USE_DEVICE // now lives in infra
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1261
2
443894e2e912 Block commit of eCos version 1.2.1
jlarmour
parents: 0
diff changeset
1262 #define CYGDBG_HAL_DEBUG_GDB_INCLUDE_STUBS
0
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1263
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1264 #endif
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1265 */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1266
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1267 /* -------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1268
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1269 #endif /* ifdef CYGPKG_KERNEL */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1270
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1271 /* -------------------------------------------------------------------*/
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1272 #endif /* CYGONCE_PKGCONF_KERNEL_H */
3111d98ba7b3 Initial commit of eCos version 1.1
jlarmour
parents:
diff changeset
1273 /* EOF kernel.h */