Mercurial > flash_v2
annotate packages/kernel/current/include/clock.hxx @ 148:8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
| author | jlarmour |
|---|---|
| date | Fri, 12 Jan 2001 08:11:46 +0000 |
| parents | 6ed91473a1cd |
| children | e0c0827131d1 |
| rev | line source |
|---|---|
| 0 | 1 #ifndef CYGONCE_KERNEL_CLOCK_HXX |
| 2 #define CYGONCE_KERNEL_CLOCK_HXX | |
| 3 | |
| 4 //========================================================================== | |
| 5 // | |
| 2 | 6 // clock.hxx |
| 0 | 7 // |
| 2 | 8 // Clock and Alarm class declaration(s) |
| 0 | 9 // |
| 10 //========================================================================== | |
| 11 //####COPYRIGHTBEGIN#### | |
|
64
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 // ------------------------------------------- |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
14 // The contents of this file are subject to the Red Hat eCos Public License |
|
66
bf00f99aec69
Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents:
64
diff
changeset
|
15 // Version 1.1 (the "License"); you may not use this file except in |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
16 // compliance with the License. You may obtain a copy of the License at |
|
66
bf00f99aec69
Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents:
64
diff
changeset
|
17 // http://www.redhat.com/ |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
18 // |
|
66
bf00f99aec69
Merge from eCos master repository on 2000-02-02-19:16:44-GMT
jlarmour
parents:
64
diff
changeset
|
19 // Software distributed under the License is distributed on an "AS IS" |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
20 // 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
|
21 // 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
|
22 // the License. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
23 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
24 // 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
|
25 // released September 30, 1998. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
26 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
27 // 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
|
28 // 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
|
29 // 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
|
30 // All Rights Reserved. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
31 // ------------------------------------------- |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
32 // |
| 0 | 33 //####COPYRIGHTEND#### |
| 34 //========================================================================== | |
| 35 //#####DESCRIPTIONBEGIN#### | |
| 36 // | |
| 2 | 37 // Author(s): nickg |
| 38 // Contributors: nickg | |
| 39 // Date: 1997-09-09 | |
| 40 // Purpose: Define Clock and Alarm class interfaces | |
| 41 // Description: The classes defined here collectively implement the | |
| 0 | 42 // internal API used to create, configure and manage Counters, |
| 43 // Clocks and Alarms. | |
| 44 // Usage: #include <cyg/kernel/clock.hxx> | |
| 45 // | |
| 46 //####DESCRIPTIONEND#### | |
| 47 // | |
| 48 //========================================================================== | |
| 49 | |
| 50 #include <cyg/kernel/ktypes.h> | |
| 51 #include <cyg/infra/cyg_ass.h> // assertion macros | |
| 52 | |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
53 #include <cyg/infra/clist.hxx> |
|
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
54 |
| 0 | 55 // ------------------------------------------------------------------------- |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
56 // Forward definitions and typedefs. |
| 0 | 57 |
| 58 class Cyg_Alarm; | |
| 59 | |
| 60 typedef void cyg_alarm_fn(Cyg_Alarm *alarm, CYG_ADDRWORD data); | |
| 61 | |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
62 typedef Cyg_CList_T<Cyg_Alarm> Cyg_Alarm_List; |
|
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
63 |
| 0 | 64 // ------------------------------------------------------------------------- |
| 65 // Counter object. | |
| 66 | |
| 67 class Cyg_Counter | |
| 68 { | |
| 69 | |
| 70 friend class Cyg_Alarm; | |
| 71 | |
| 72 #if defined(CYGIMP_KERNEL_COUNTERS_SINGLE_LIST) | |
| 73 | |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
74 Cyg_Alarm_List alarm_list; // Linear list of Alarms |
| 0 | 75 |
| 76 #elif defined(CYGIMP_KERNEL_COUNTERS_MULTI_LIST) | |
| 77 | |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
78 Cyg_Alarm_List alarm_list[CYGNUM_KERNEL_COUNTERS_MULTI_LIST_SIZE]; |
| 0 | 79 |
| 80 #endif | |
| 81 | |
|
62
7a6ac9edc838
Merge from eCos master repository on 2000-01-24-19:43:49-GMT
jlarmour
parents:
2
diff
changeset
|
82 volatile cyg_tick_count counter; // counter value |
| 0 | 83 |
| 84 cyg_uint32 increment; // increment per tick | |
| 85 | |
| 86 public: | |
| 87 | |
| 88 CYGDBG_DEFINE_CHECK_THIS | |
| 89 | |
| 90 Cyg_Counter( | |
| 91 cyg_uint32 increment = 1 | |
| 92 ); | |
| 93 | |
| 94 ~Cyg_Counter(); | |
| 95 | |
| 96 // Return current value of counter | |
| 97 cyg_tick_count current_value(); | |
| 98 | |
| 99 // Return low and high halves of the | |
| 100 // counter value. | |
| 101 cyg_uint32 current_value_lo(); | |
| 102 cyg_uint32 current_value_hi(); | |
| 103 | |
| 104 // Set the counter's current value | |
| 105 void set_value( cyg_tick_count new_value); | |
| 106 | |
| 107 // Advance counter by some number of ticks | |
| 108 void tick( cyg_uint32 ticks = 1); | |
| 109 | |
| 110 // Add an alarm to this counter | |
| 111 void add_alarm( Cyg_Alarm *alarm ); | |
| 112 | |
| 113 // Remove an alarm from this counter | |
| 114 void rem_alarm( Cyg_Alarm *alarm ); | |
| 115 | |
| 116 }; | |
| 117 | |
| 118 // ------------------------------------------------------------------------- | |
| 119 // Clock class. This is derived from a Counter and defines extra | |
| 120 // features to support clock-like behaviour. | |
| 121 | |
| 122 class Cyg_Clock | |
| 123 : public Cyg_Counter | |
| 124 { | |
| 125 | |
| 126 public: | |
| 127 | |
| 128 CYGDBG_DEFINE_CHECK_THIS | |
| 129 | |
| 130 // This structure allows a more accurate representation | |
| 131 // of the resolution than a single integer would allow. | |
| 132 // The resolution is defined as dividend/divisor nanoseconds | |
| 133 // per tick. | |
| 134 struct cyg_resolution { | |
| 135 cyg_uint32 dividend; | |
| 136 cyg_uint32 divisor; | |
| 137 }; | |
| 138 | |
| 139 private: | |
| 140 | |
| 141 cyg_resolution resolution; // Current clock resolution | |
| 142 | |
| 143 public: | |
| 144 | |
| 145 Cyg_Clock( // Create clock with given resolution | |
| 146 cyg_resolution resolution | |
| 147 ); | |
| 148 | |
| 149 ~Cyg_Clock(); // Destructor | |
| 150 | |
| 151 cyg_resolution get_resolution(); // Return current resolution | |
| 152 | |
| 153 void set_resolution( // Set new resolution | |
| 154 cyg_resolution resolution | |
| 155 ); | |
| 156 | |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
157 // There is a need for converting from "other" ticks to clock ticks. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
158 // We will construct 4 numbers to do the conversion as: |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
159 // clock_ticks = (((otherticks*mul1)/div1)*mul2/div2) |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
160 // with the values chosen to minimize the possibility of overflow. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
161 // Do the arithmetic in cyg_uint64s throughout. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
162 struct converter { |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
163 cyg_uint64 mul1, div1, mul2, div2; |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
164 }; |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
165 |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
166 // There are two of these because the 4 numbers are different depending |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
167 // on the direction of the conversion, to prevent loss of significance. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
168 // NB these relate to the resolution of the clock object they are |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
169 // called against, not necessarily "the" system real time clock. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
170 void get_other_to_clock_converter( cyg_uint64 ns_per_other_tick, |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
171 struct converter *pcc ); |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
172 |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
173 void get_clock_to_other_converter( cyg_uint64 ns_per_other_tick, |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
174 struct converter *pcc ); |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
175 |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
176 // A utility to perform the conversion in the obvious way, with |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
177 // rounding to nearest at each stage. Static because it uses a |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
178 // previously acquired converter. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
179 static cyg_tick_count convert( cyg_tick_count value, |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
180 struct converter *pcc ); |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
62
diff
changeset
|
181 |
| 0 | 182 #ifdef CYGVAR_KERNEL_COUNTERS_CLOCK |
| 183 | |
| 184 // There is a system supplied real time clock... | |
| 185 | |
| 186 static Cyg_Clock *real_time_clock; | |
| 187 | |
| 188 #endif | |
| 189 | |
| 190 }; | |
| 191 | |
| 192 // ------------------------------------------------------------------------- | |
| 193 // Alarm class. An alarm may be attached to a counter (or a clock) to be | |
| 194 // called when the trigger value is reached. | |
| 195 | |
| 196 class Cyg_Alarm | |
|
148
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
197 #if defined(CYGIMP_KERNEL_COUNTERS_SINGLE_LIST) || defined(CYGIMP_KERNEL_COUNTERS_MULTI_LIST) |
|
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
198 : public Cyg_DNode_T<Cyg_Alarm> |
|
8f2f7615e727
Merge from eCos master repository on 2001-01-12-06:43:03-GMT
jlarmour
parents:
115
diff
changeset
|
199 #endif |
| 0 | 200 { |
| 201 friend class Cyg_Counter; | |
| 202 | |
| 203 protected: | |
| 204 Cyg_Counter *counter; // Attached to this counter/clock | |
| 205 | |
| 206 cyg_alarm_fn *alarm; // Call-back function | |
| 207 | |
| 208 CYG_ADDRWORD data; // Call-back data | |
| 209 | |
| 210 cyg_tick_count trigger; // Absolute trigger time | |
| 211 | |
| 212 cyg_tick_count interval; // Retrigger interval | |
| 213 | |
| 214 cyg_bool enabled; // True if enabled | |
| 215 | |
| 216 Cyg_Alarm(); | |
| 217 | |
| 218 void synchronize( void ); // deal with times in the past, | |
| 219 // make next alarm in synch. | |
| 220 | |
| 221 public: | |
| 222 | |
| 223 CYGDBG_DEFINE_CHECK_THIS | |
| 224 | |
| 225 Cyg_Alarm // Constructor | |
| 226 ( | |
| 227 Cyg_Counter *counter, // Attached to this counter | |
| 228 cyg_alarm_fn *alarm, // Call-back function | |
| 229 CYG_ADDRWORD data // Call-back data | |
| 230 ); | |
| 231 | |
| 232 ~Cyg_Alarm(); // Destructor | |
| 233 | |
| 234 void initialize( // Initialize Alarm | |
| 235 cyg_tick_count trigger, // Absolute trigger time | |
| 236 cyg_tick_count interval = 0 // Relative retrigger interval | |
| 237 ); | |
| 238 | |
| 239 void enable(); // Ensure alarm enabled | |
| 240 | |
| 241 void disable(); // Ensure alarm disabled | |
| 242 | |
|
115
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
66
diff
changeset
|
243 void get_times( |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
66
diff
changeset
|
244 cyg_tick_count *trigger, // Next trigger time |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
66
diff
changeset
|
245 cyg_tick_count *interval // Current interval |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
66
diff
changeset
|
246 ); |
| 0 | 247 }; |
| 248 | |
| 249 // ------------------------------------------------------------------------- | |
| 250 | |
| 251 #endif // ifndef CYGONCE_KERNEL_CLOCK_HXX | |
| 252 // EOF clock.hxx |
