/** @file | |
ACPI Timer implements one instance of Timer Library. | |
Copyright (c) 2013 - 2023, Intel Corporation. All rights reserved.<BR> | |
SPDX-License-Identifier: BSD-2-Clause-Patent | |
**/ | |
#include <PiDxe.h> | |
#include <Library/TimerLib.h> | |
#include <Library/BaseLib.h> | |
#include <Library/HobLib.h> | |
// | |
// Cached performance counter frequency | |
// | |
static UINT64 mAcpiTimerLibTscFrequency = 0; | |
extern GUID mFrequencyHobGuid; | |
/** | |
The constructor function enables ACPI IO space. | |
If ACPI I/O space not enabled, this function will enable it. | |
It will always return RETURN_SUCCESS. | |
@retval EFI_SUCCESS The constructor always returns RETURN_SUCCESS. | |
**/ | |
RETURN_STATUS | |
EFIAPI | |
AcpiTimerLibConstructor ( | |
VOID | |
); | |
/** | |
Calculate TSC frequency. | |
The TSC counting frequency is determined by comparing how far it counts | |
during a 101.4 us period as determined by the ACPI timer. | |
The ACPI timer is used because it counts at a known frequency. | |
The TSC is sampled, followed by waiting 363 counts of the ACPI timer, | |
or 101.4 us. The TSC is then sampled again. The difference multiplied by | |
9861 is the TSC frequency. There will be a small error because of the | |
overhead of reading the ACPI timer. An attempt is made to determine and | |
compensate for this error. | |
@return The number of TSC counts per second. | |
**/ | |
UINT64 | |
InternalCalculateTscFrequency ( | |
VOID | |
); | |
/** | |
Internal function to retrieves the 64-bit frequency in Hz. | |
Internal function to retrieves the 64-bit frequency in Hz. | |
@return The frequency in Hz. | |
**/ | |
UINT64 | |
InternalGetPerformanceCounterFrequency ( | |
VOID | |
) | |
{ | |
return mAcpiTimerLibTscFrequency; | |
} | |
/** | |
The constructor function enables ACPI IO space, and caches PerformanceCounterFrequency. | |
@retval EFI_SUCCESS The constructor always returns RETURN_SUCCESS. | |
**/ | |
EFI_STATUS | |
CommonAcpiTimerLibConstructor ( | |
VOID | |
) | |
{ | |
EFI_HOB_GUID_TYPE *GuidHob; | |
// | |
// Enable ACPI IO space. | |
// | |
AcpiTimerLibConstructor (); | |
// | |
// Initialize PerformanceCounterFrequency | |
// | |
GuidHob = GetFirstGuidHob (&mFrequencyHobGuid); | |
if (GuidHob != NULL) { | |
mAcpiTimerLibTscFrequency = *(UINT64 *)GET_GUID_HOB_DATA (GuidHob); | |
} else { | |
mAcpiTimerLibTscFrequency = InternalCalculateTscFrequency (); | |
} | |
return EFI_SUCCESS; | |
} |