/** @file Copyright (C) 2016, The HermitCrabs Lab. All rights reserved. All rights reserved. This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. **/ #include #include #include #include #include #include #include #include #include STATIC UINT64 mPerformanceCounterFrequency = 0; /** Calculate the TSC frequency @retval The calculated TSC frequency. **/ UINT64 RecalculateTSC ( VOID ) { UINT32 TimerAddr; UINT64 Tsc0; UINT64 Tsc1; UINT64 AcpiTick0; UINT64 AcpiTick1; UINT64 AcpiTicksDelta; UINT32 AcpiTicksTarget; UINT32 TimerResolution; // Already Calculated, Return Cached Result if (PciRead16 (PCI_ICH_LPC_ADDRESS (0)) == 0x8086) { TimerAddr = 0; TimerResolution = 10; // Check if ACPI I/O Space Is Enabled On LPC device if ((PciRead8 (PCI_ICH_LPC_ADDRESS (R_ICH_LPC_ACPI_CNT)) & B_ICH_LPC_ACPI_CNT_ACPI_EN) != 0) { TimerAddr = ((PciRead16 (PCI_ICH_LPC_ADDRESS (R_ICH_LPC_ACPI_BASE)) & B_ICH_LPC_ACPI_BASE_BAR) + R_ACPI_PM1_TMR); DEBUG ((DEBUG_VERBOSE, "Acpi Timer Addr 0x%0x (LPC)\n", TimerAddr)); } else { // Starting from Intel Sunrisepoint (Skylake PCH) the iTCO watchdog resources // have been moved to reside under the i801 SMBus host controller whereas // previously they were under the LPC device. // // Check if ACPI I/O space is enabled on SMBUS device if ((PciRead8 (PCI_ICH_SMBUS_ADDRESS (R_ICH_SMBUS_ACPI_CNT)) & B_ICH_SMBUS_ACPI_CNT_ACPI_EN) != 0) { TimerAddr = ((PciRead16 (PCI_ICH_SMBUS_ADDRESS (R_ICH_SMBUS_ACPI_BASE)) & B_ICH_SMBUS_ACPI_BASE_BAR) + R_ACPI_PM1_TMR); DEBUG ((DEBUG_VERBOSE, "Acpi Timer Addr 0x%0x (SMB)\n", TimerAddr)); } } if (TimerAddr != 0) { mPerformanceCounterFrequency = 0; // Check That Timer Is Advancing AcpiTick0 = IoRead32 (TimerAddr); gBS->Stall (500); AcpiTick1 = IoRead32 (TimerAddr); if (AcpiTick0 != AcpiTick1) { // ACPI PM timers are usually of 24-bit length, but there are some less common cases of 32-bit length also. // When the maximal number is reached, it overflows. // The code below can handle overflow with AcpiTicksTarget of up to 24-bit size, // on both available sizes of ACPI PM Timers (24-bit and 32-bit). // // 357954 clocks of ACPI timer (100ms) AcpiTicksTarget = (V_ACPI_TMR_FREQUENCY / TimerResolution); AcpiTick0 = IoRead32 (TimerAddr); Tsc0 = AsmReadTsc (); do { CpuPause (); // Check How Many AcpiTicks Have Passed Since We Started AcpiTick1 = IoRead32 (TimerAddr); if (AcpiTick0 <= AcpiTick1) { // No Overflow AcpiTicksDelta = (AcpiTick1 - AcpiTick0); } else if ((AcpiTick0 - AcpiTick1) <= 0x00FFFFFF) { // Overflow, 24 Bit Timer AcpiTicksDelta = ((0x00FFFFFF - AcpiTick0) + AcpiTick1); } else { // Overflow, 32 Bit Timer AcpiTicksDelta = ((MAX_UINT32 - AcpiTick0) + AcpiTick1); } // Keep Checking Acpi ticks Until Target Is Reached } while (AcpiTicksDelta < AcpiTicksTarget); Tsc1 = AsmReadTsc (); mPerformanceCounterFrequency = MultU64x32 ((Tsc1 - Tsc0), TimerResolution); } } } DEBUG ((DEBUG_INFO, "TscFrequency %lld\n", mPerformanceCounterFrequency)); return mPerformanceCounterFrequency; } UINTN EFIAPI MicroSecondDelay ( IN UINTN MicroSeconds ) { (VOID) MicroSeconds; return EFI_UNSUPPORTED; } /** Stalls the CPU for at least the given number of nanoseconds. Stalls the CPU for the number of nanoseconds specified by NanoSeconds. @param NanoSeconds The minimum number of nanoseconds to delay. @return The value of NanoSeconds inputted. **/ UINTN EFIAPI NanoSecondDelay ( IN UINTN NanoSeconds ) { (VOID) NanoSeconds; return EFI_UNSUPPORTED; } /** Retrieves the current value of a 64-bit free running performance counter. The counter can either count up by 1 or count down by 1. If the physical performance counter counts by a larger increment, then the counter values must be translated. The properties of the counter can be retrieved from GetPerformanceCounterProperties(). @return The current value of the free running performance counter. **/ UINT64 EFIAPI GetPerformanceCounter ( VOID ) { return AsmReadTsc (); } /** Retrieves the 64-bit frequency in Hz and the range of performance counter values. If StartValue is not NULL, then the value that the performance counter starts with immediately after is it rolls over is returned in StartValue. If EndValue is not NULL, then the value that the performance counter end with immediately before it rolls over is returned in EndValue. The 64-bit frequency of the performance counter in Hz is always returned. If StartValue is less than EndValue, then the performance counter counts up. If StartValue is greater than EndValue, then the performance counter counts down. For example, a 64-bit free running counter that counts up would have a StartValue of 0 and an EndValue of 0xFFFFFFFFFFFFFFFF. A 24-bit free running counter that counts down would have a StartValue of 0xFFFFFF and an EndValue of 0. @param StartValue The value the performance counter starts with when it rolls over. @param EndValue The value that the performance counter ends with before it rolls over. @return The frequency in Hz. **/ UINT64 EFIAPI GetPerformanceCounterProperties ( OUT UINT64 *StartValue, OPTIONAL OUT UINT64 *EndValue OPTIONAL ) { if (StartValue != NULL) { *StartValue = 0; } if (EndValue != NULL) { *EndValue = 0xffffffffffffffffULL; } return mPerformanceCounterFrequency; } /** Converts elapsed ticks of performance counter to time in nanoseconds. This function converts the elapsed ticks of running performance counter to time value in unit of nanoseconds. @param Ticks The number of elapsed ticks of running performance counter. @return The elapsed time in nanoseconds. **/ UINT64 EFIAPI GetTimeInNanoSecond ( IN UINT64 Ticks ) { UINT64 Frequency; UINT64 NanoSeconds; UINT64 Remainder; INTN Shift; Frequency = GetPerformanceCounterProperties (NULL, NULL); if (Frequency == 0) { return 0; } // // Ticks // Time = --------- x 1,000,000,000 // Frequency // NanoSeconds = MultU64x32 (DivU64x64Remainder (Ticks, Frequency, &Remainder), 1000000000u); // // Ensure (Remainder * 1,000,000,000) will not overflow 64-bit. // Since 2^29 < 1,000,000,000 = 0x3B9ACA00 < 2^30, Remainder should < 2^(64-30) = 2^34, // i.e. highest bit set in Remainder should <= 33. // Shift = MAX (0, HighBitSet64 (Remainder) - 33); Remainder = RShiftU64 (Remainder, (UINTN) Shift); Frequency = RShiftU64 (Frequency, (UINTN) Shift); NanoSeconds += DivU64x64Remainder (MultU64x32 (Remainder, 1000000000u), Frequency, NULL); return NanoSeconds; } /** The constructor function caches PerformanceCounterFrequency. @param ImageHandle The firmware allocated handle for the EFI image. @param SystemTable A pointer to the EFI System Table. @retval EFI_SUCCESS The constructor always returns RETURN_SUCCESS. **/ RETURN_STATUS EFIAPI OcTimerLibConstructor ( VOID ) { RecalculateTSC (); return EFI_SUCCESS; }