3 Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 #include <Library/BaseLib.h>
18 #include <Library/TimerLib.h>
19 #include <Library/DebugLib.h>
20 #include <Library/PcdLib.h>
21 #include <Library/IoLib.h>
22 #include <Drivers/SP804Timer.h>
23 #include <ArmPlatform.h>
25 // Setup SP810's Timer2 for managing delay functions. And Timer3 for Performance counter
26 // Note: ArmVE's Timer0 and Timer1 are used by TimerDxe.
33 // Check if Timer 2 is already initialized
34 if (MmioRead32(SP804_TIMER2_BASE
+ SP804_TIMER_CONTROL_REG
) & SP804_TIMER_CTRL_ENABLE
) {
35 return RETURN_SUCCESS
;
37 // Configure timer 2 for one shot operation, 32 bits, no prescaler, and interrupt disabled
38 MmioOr32 (SP804_TIMER2_BASE
+ SP804_TIMER_CONTROL_REG
, SP804_TIMER_CTRL_ONESHOT
| SP804_TIMER_CTRL_32BIT
| SP804_PRESCALE_DIV_1
);
40 // Preload the timer count register
41 MmioWrite32 (SP804_TIMER2_BASE
+ SP804_TIMER_LOAD_REG
, 1);
44 MmioOr32 (SP804_TIMER2_BASE
+ SP804_TIMER_CONTROL_REG
, SP804_TIMER_CTRL_ENABLE
);
47 // Check if Timer 3 is already initialized
48 if (MmioRead32(SP804_TIMER3_BASE
+ SP804_TIMER_CONTROL_REG
) & SP804_TIMER_CTRL_ENABLE
) {
49 return RETURN_SUCCESS
;
51 // Configure timer 3 for free running operation, 32 bits, no prescaler, interrupt disabled
52 MmioOr32 (SP804_TIMER3_BASE
+ SP804_TIMER_CONTROL_REG
, SP804_TIMER_CTRL_32BIT
| SP804_PRESCALE_DIV_1
);
55 MmioOr32 (SP804_TIMER3_BASE
+ SP804_TIMER_CONTROL_REG
, SP804_TIMER_CTRL_ENABLE
);
58 return RETURN_SUCCESS
;
62 Stalls the CPU for at least the given number of microseconds.
64 Stalls the CPU for the number of microseconds specified by MicroSeconds.
66 @param MicroSeconds The minimum number of microseconds to delay.
68 @return The value of MicroSeconds inputted.
79 // Reload the counter for each 1Mhz to avoid an overflow in the load value
80 for (Index
= 0; Index
< (UINTN
)PcdGet32(PcdSP804FrequencyInMHz
); Index
++) {
81 // load the timer count register
82 MmioWrite32 (SP804_TIMER2_BASE
+ SP804_TIMER_LOAD_REG
, MicroSeconds
);
84 while (MmioRead32 (SP804_TIMER2_BASE
+ SP804_TIMER_CURRENT_REG
) > 0) {
93 Stalls the CPU for at least the given number of nanoseconds.
95 Stalls the CPU for the number of nanoseconds specified by NanoSeconds.
97 @param NanoSeconds The minimum number of nanoseconds to delay.
99 @return The value of NanoSeconds inputted.
111 // Round up to 1us Tick Number
112 MicroSeconds
= (UINT32
)NanoSeconds
/ 1000;
113 MicroSeconds
+= ((UINT32
)NanoSeconds
% 1000) == 0 ? 0 : 1;
115 // Reload the counter for each 1Mhz to avoid an overflow in the load value
116 for (Index
= 0; Index
< (UINTN
)PcdGet32(PcdSP804FrequencyInMHz
); Index
++) {
117 // load the timer count register
118 MmioWrite32 (SP804_TIMER2_BASE
+ SP804_TIMER_LOAD_REG
, MicroSeconds
);
120 while (MmioRead32 (SP804_TIMER2_BASE
+ SP804_TIMER_CURRENT_REG
) > 0) {
129 Retrieves the current value of a 64-bit free running performance counter.
131 The counter can either count up by 1 or count down by 1. If the physical
132 performance counter counts by a larger increment, then the counter values
133 must be translated. The properties of the counter can be retrieved from
134 GetPerformanceCounterProperties().
136 @return The current value of the free running performance counter.
141 GetPerformanceCounter (
145 // Free running 64-bit/32-bit counter is needed here.
146 // Don't think we need this to boot, just to do performance profile
148 Value
= MmioRead32 (SP804_TIMER3_BASE
+ SP804_TIMER_CURRENT_REG
);
155 Retrieves the 64-bit frequency in Hz and the range of performance counter
158 If StartValue is not NULL, then the value that the performance counter starts
159 with immediately after is it rolls over is returned in StartValue. If
160 EndValue is not NULL, then the value that the performance counter end with
161 immediately before it rolls over is returned in EndValue. The 64-bit
162 frequency of the performance counter in Hz is always returned. If StartValue
163 is less than EndValue, then the performance counter counts up. If StartValue
164 is greater than EndValue, then the performance counter counts down. For
165 example, a 64-bit free running counter that counts up would have a StartValue
166 of 0 and an EndValue of 0xFFFFFFFFFFFFFFFF. A 24-bit free running counter
167 that counts down would have a StartValue of 0xFFFFFF and an EndValue of 0.
169 @param StartValue The value the performance counter starts with when it
171 @param EndValue The value that the performance counter ends with before
174 @return The frequency in Hz.
179 GetPerformanceCounterProperties (
180 OUT UINT64
*StartValue
, OPTIONAL
181 OUT UINT64
*EndValue OPTIONAL
184 if (StartValue
!= NULL
) {
185 // Timer starts with the reload value
186 *StartValue
= (UINT64
)0ULL;
189 if (EndValue
!= NULL
) {
190 // Timer counts up to 0xFFFFFFFF
191 *EndValue
= 0xFFFFFFFF;
194 return PcdGet64 (PcdEmbeddedPerformanceCounterFrequencyInHz
);