annotate packages/kernel/current/include/pkgconf/kernel.h @ 64:c38311975d4f ecos-sw-2000-01-28

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