4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/** @file
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC Architectural Protocol GUID as defined in DxeCis 0.96.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCopyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncThis program and the accompanying materials
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncare licensed and made available under the terms and conditions of the BSD License
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncwhich accompanies this distribution. The full text of the license may be found at
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynchttp://opensource.org/licenses/bsd-license.php
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncTHE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncWITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include "PcRtc.h"
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Compare the Hour, Minute and Second of the From time and the To time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Only compare H/M/S in EFI_TIME and ignore other fields here.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param From the first time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param To the second time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return >0 The H/M/S of the From time is later than those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return ==0 The H/M/S of the From time is same as those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return <0 The H/M/S of the From time is earlier than those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncINTN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCompareHMS (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *From,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *To
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync To check if second date is later than first date within 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param From the first date
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param To the second date
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE From is previous to To within 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE From is later, or it is previous to To more than 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncBOOLEAN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncIsWithinOneDay (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *From,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *To
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Read RTC content through its registers.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Address Address offset of RTC. It is recommended to use macros such as
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_ADDRESS_SECONDS.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The data of UINT8 type read from RTC.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT8
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncRtcRead (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT8 Address
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IoWrite8 (PCAT_RTC_ADDRESS_REGISTER, (UINT8) (Address | (UINT8) (IoRead8 (PCAT_RTC_ADDRESS_REGISTER) & 0x80)));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return IoRead8 (PCAT_RTC_DATA_REGISTER);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Write RTC through its registers.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Address Address offset of RTC. It is recommended to use macros such as
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_ADDRESS_SECONDS.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Data The content you want to write into RTC.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncVOID
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncRtcWrite (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT8 Address,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT8 Data
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IoWrite8 (PCAT_RTC_ADDRESS_REGISTER, (UINT8) (Address | (UINT8) (IoRead8 (PCAT_RTC_ADDRESS_REGISTER) & 0x80)));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IoWrite8 (PCAT_RTC_DATA_REGISTER, Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Initialize RTC.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Global For global use inside this module.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR Initialization failed due to device error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS Initialization successful.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncPcRtcInit (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN PC_RTC_MODULE_GLOBALS *Global
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_STATUS Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_A RegisterA;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_B RegisterB;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_D RegisterD;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 Century;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_TIME Time;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINTN DataSize;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT32 TimerVar;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Acquire RTC Lock to make access to RTC atomic
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiAcquireLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Initialize RTC Register
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure Division Chain is properly configured,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // or RTC clock won't "tick" -- time won't increment
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterA.Data = RTC_INIT_REGISTER_A;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_A, RegisterA.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Read Register B
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Data = RtcRead (RTC_ADDRESS_REGISTER_B);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Clear RTC flag register
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcRead (RTC_ADDRESS_REGISTER_C);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Clear RTC register D
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterD.Data = RTC_INIT_REGISTER_D;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_D, RegisterD.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be updated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcWaitToUpdate (PcdGet32 (PcdRealTimeClockUpdateTimeout));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set the variable with default value if the RTC is functioning incorrectly.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Global->SavedTimeZone = EFI_UNSPECIFIED_TIMEZONE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Global->Daylight = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the Time/Date/Daylight Savings values.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Second = RtcRead (RTC_ADDRESS_SECONDS);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Minute = RtcRead (RTC_ADDRESS_MINUTES);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Hour = RtcRead (RTC_ADDRESS_HOURS);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Day = RtcRead (RTC_ADDRESS_DAY_OF_THE_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Month = RtcRead (RTC_ADDRESS_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Year = RtcRead (RTC_ADDRESS_YEAR);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Century = RtcRead (RTC_ADDRESS_CENTURY);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set RTC configuration after get original time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The value of bit AIE should be reserved.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_B, (UINT8)(RTC_INIT_REGISTER_B | (RegisterB.Data & BIT5)));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Release RTC Lock.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the data of Daylight saving and time zone, if they have been
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // stored in NV variable during previous boot.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DataSize = sizeof (UINT32);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = EfiGetVariable (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"RTC",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &gEfiCallerIdGuid,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &DataSize,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (VOID *) &TimerVar
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.TimeZone = (INT16) TimerVar;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Daylight = (UINT8) (TimerVar >> 16);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.TimeZone = EFI_UNSPECIFIED_TIMEZONE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Daylight = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Validate time fields
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = ConvertRtcTimeToEfiTime (&Time, Century, RegisterB);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (&Time);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Second = RTC_INIT_SECOND;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Minute = RTC_INIT_MINUTE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Hour = RTC_INIT_HOUR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Day = RTC_INIT_DAY;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Month = RTC_INIT_MONTH;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Year = RTC_INIT_YEAR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Nanosecond = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.TimeZone = EFI_UNSPECIFIED_TIMEZONE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time.Daylight = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Reset time value according to new RTC configuration
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = PcRtcSetTime (&Time, Global);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if(!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Returns the current time and date information, and the time-keeping capabilities
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync of the hardware platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time A pointer to storage to receive a snapshot of the current time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Capabilities An optional pointer to a buffer to receive the real time clock
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync device's capabilities.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Global For global use inside this module.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation completed successfully.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Time is NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR The time could not be retrieved due to hardware error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncPcRtcGetTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT EFI_TIME *Time,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT EFI_TIME_CAPABILITIES *Capabilities, OPTIONAL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN PC_RTC_MODULE_GLOBALS *Global
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_STATUS Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_B RegisterB;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 Century;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check parameters for null pointer
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Acquire RTC Lock to make access to RTC atomic
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiAcquireLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be updated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcWaitToUpdate (PcdGet32 (PcdRealTimeClockUpdateTimeout));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Read Register B
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Data = RtcRead (RTC_ADDRESS_REGISTER_B);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the Time/Date/Daylight Savings values.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Second = RtcRead (RTC_ADDRESS_SECONDS);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Minute = RtcRead (RTC_ADDRESS_MINUTES);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = RtcRead (RTC_ADDRESS_HOURS);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day = RtcRead (RTC_ADDRESS_DAY_OF_THE_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month = RtcRead (RTC_ADDRESS_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = RtcRead (RTC_ADDRESS_YEAR);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Century = RtcRead (RTC_ADDRESS_CENTURY);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Release RTC Lock.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the variable that contains the TimeZone and Daylight fields
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->TimeZone = Global->SavedTimeZone;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Daylight = Global->Daylight;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure all field values are in correct range
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = ConvertRtcTimeToEfiTime (Time, Century, RegisterB);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (Time);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Fill in Capabilities if it was passed in
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Capabilities != NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Capabilities->Resolution = 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 1 hertz
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Capabilities->Accuracy = 50000000;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // 50 ppm
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Capabilities->SetsToZero = FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Sets the current local time and date information.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time A pointer to the current time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Global For global use inside this module.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The operation completed successfully.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER A time field is out of range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR The time could not be set due due to hardware error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncPcRtcSetTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *Time,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN PC_RTC_MODULE_GLOBALS *Global
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_STATUS Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_TIME RtcTime;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_B RegisterB;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 Century;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT32 TimerVar;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure that the time fields are valid
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (Time);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&RtcTime, Time, sizeof (EFI_TIME));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Acquire RTC Lock to make access to RTC atomic
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiAcquireLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be updated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcWaitToUpdate (PcdGet32 (PcdRealTimeClockUpdateTimeout));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Read Register B, and inhibit updates of the RTC
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Data = RtcRead (RTC_ADDRESS_REGISTER_B);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Set = 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_B, RegisterB.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConvertEfiTimeToRtcTime (&RtcTime, RegisterB, &Century);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_SECONDS, RtcTime.Second);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_MINUTES, RtcTime.Minute);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_HOURS, RtcTime.Hour);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_DAY_OF_THE_MONTH, RtcTime.Day);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_MONTH, RtcTime.Month);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_YEAR, (UINT8) RtcTime.Year);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_CENTURY, Century);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allow updates of the RTC registers
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Set = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_B, RegisterB.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Release RTC Lock.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set the variable that contains the TimeZone and Daylight fields
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Global->SavedTimeZone = Time->TimeZone;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Global->Daylight = Time->Daylight;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TimerVar = Time->Daylight;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync TimerVar = (UINT32) ((TimerVar << 16) | (UINT16)(Time->TimeZone));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = EfiSetVariable (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"RTC",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &gEfiCallerIdGuid,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync sizeof (TimerVar),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &TimerVar
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT_EFI_ERROR (Status);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Returns the current wakeup alarm clock setting.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Enabled Indicates if the alarm is currently enabled or disabled.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Pending Indicates if the alarm signal is pending and requires acknowledgment.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time The current alarm setting.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Global For global use inside this module.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS The alarm settings were returned.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Enabled is NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Pending is NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Time is NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR The wakeup time could not be retrieved due to a hardware error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_UNSUPPORTED A wakeup timer is not supported on this platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncPcRtcGetWakeupTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT BOOLEAN *Enabled,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT BOOLEAN *Pending,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT EFI_TIME *Time,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN PC_RTC_MODULE_GLOBALS *Global
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_STATUS Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_B RegisterB;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_C RegisterC;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 Century;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_TIME RtcTime;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINTN DataSize;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Check parameters for null pointers
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Enabled == NULL) || (Pending == NULL) || (Time == NULL)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Acquire RTC Lock to make access to RTC atomic
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiAcquireLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be updated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcWaitToUpdate (PcdGet32 (PcdRealTimeClockUpdateTimeout));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Read Register B and Register C
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Data = RtcRead (RTC_ADDRESS_REGISTER_B);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterC.Data = RtcRead (RTC_ADDRESS_REGISTER_C);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the Time/Date/Daylight Savings values.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Enabled = RegisterB.Bits.Aie;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Pending = RegisterC.Bits.Af;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Second = RtcRead (RTC_ADDRESS_SECONDS_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Minute = RtcRead (RTC_ADDRESS_MINUTES_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = RtcRead (RTC_ADDRESS_HOURS_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day = RtcRead (RTC_ADDRESS_DAY_OF_THE_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month = RtcRead (RTC_ADDRESS_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = RtcRead (RTC_ADDRESS_YEAR);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->TimeZone = Global->SavedTimeZone;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Daylight = Global->Daylight;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Century = RtcRead (RTC_ADDRESS_CENTURY);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Get the alarm info from variable
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = EfiGetVariable (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"RTCALARM",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &gEfiCallerIdGuid,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync NULL,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &DataSize,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &RtcTime
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The alarm variable exists. In this case, we read variable to get info.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day = RtcTime.Day;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month = RtcTime.Month;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = RtcTime.Year;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Release RTC Lock.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure all field values are in correct range
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = ConvertRtcTimeToEfiTime (Time, Century, RegisterB);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (Time);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Sets the system wakeup alarm clock time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Enabled Enable or disable the wakeup alarm.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time If Enable is TRUE, the time to set the wakeup alarm for.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Enable is FALSE, then this parameter is optional, and may be NULL.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Global For global use inside this module.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS If Enable is TRUE, then the wakeup alarm was enabled.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If Enable is FALSE, then the wakeup alarm was disabled.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER A time field is out of range.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR The wakeup time could not be set due to a hardware error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_UNSUPPORTED A wakeup timer is not supported on this platform.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncPcRtcSetWakeupTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN BOOLEAN Enable,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *Time, OPTIONAL
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN PC_RTC_MODULE_GLOBALS *Global
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_STATUS Status;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_TIME RtcTime;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_B RegisterB;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 Century;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_TIME_CAPABILITIES Capabilities;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ZeroMem (&RtcTime, sizeof (RtcTime));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Enable) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time == NULL) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make sure that the time fields are valid
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (Time);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Just support set alarm time within 24 hours
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync PcRtcGetTime (&RtcTime, &Capabilities, Global);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcTimeFieldsValid (&RtcTime);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!IsWithinOneDay (&RtcTime, Time)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_UNSUPPORTED;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Make a local copy of the time and date
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync CopyMem (&RtcTime, Time, sizeof (EFI_TIME));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Acquire RTC Lock to make access to RTC atomic
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiAcquireLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be updated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = RtcWaitToUpdate (PcdGet32 (PcdRealTimeClockUpdateTimeout));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Read Register B, and inhibit updates of the RTC
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Data = RtcRead (RTC_ADDRESS_REGISTER_B);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Set = 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_B, RegisterB.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Enable) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ConvertEfiTimeToRtcTime (&RtcTime, RegisterB, &Century);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set RTC alarm time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_SECONDS_ALARM, RtcTime.Second);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_MINUTES_ALARM, RtcTime.Minute);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_HOURS_ALARM, RtcTime.Hour);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Aie = 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Aie = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // if the alarm is disable, record the current setting.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Second = RtcRead (RTC_ADDRESS_SECONDS_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Minute = RtcRead (RTC_ADDRESS_MINUTES_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Hour = RtcRead (RTC_ADDRESS_HOURS_ALARM);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Day = RtcRead (RTC_ADDRESS_DAY_OF_THE_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Month = RtcRead (RTC_ADDRESS_MONTH);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Year = RtcRead (RTC_ADDRESS_YEAR);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.TimeZone = Global->SavedTimeZone;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcTime.Daylight = Global->Daylight;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Allow updates of the RTC registers
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterB.Bits.Set = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RtcWrite (RTC_ADDRESS_REGISTER_B, RegisterB.Data);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set the Y/M/D info to variable as it has no corresponding hw registers.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Status = EfiSetVariable (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync L"RTCALARM",
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &gEfiCallerIdGuid,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_NON_VOLATILE,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync sizeof (RtcTime),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync &RtcTime
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync );
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (EFI_ERROR (Status)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Release RTC Lock.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!EfiAtRuntime ()) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync EfiReleaseLock (&Global->RtcLock);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Checks an 8-bit BCD value, and converts to an 8-bit value if valid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function checks the 8-bit BCD value specified by Value.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If valid, the function converts it to an 8-bit value and returns it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Otherwise, return 0xff.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Value The 8-bit BCD value to check and convert
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return The 8-bit value converted. Or 0xff if Value is invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncUINT8
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCheckAndConvertBcd8ToDecimal8 (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT8 Value
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Value < 0xa0) && ((Value & 0xf) < 0xa)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return BcdToDecimal8 (Value);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return 0xff;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Converts time read from RTC to EFI_TIME format defined by UEFI spec.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function converts raw time data read from RTC to the EFI_TIME format
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync defined by UEFI spec.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If data mode of RTC is BCD, then converts it to decimal,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If RTC is in 12-hour format, then converts it to 24-hour format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time On input, the time data read from RTC to convert
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync On output, the time converted to UEFI format
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Century Value of century read from RTC.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RegisterB Value of Register B of RTC, indicating data mode
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync and hour format.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Parameters passed in are invalid.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS Convert RTC time to EFI time successfully.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncConvertRtcTimeToEfiTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN OUT EFI_TIME *Time,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN UINT8 Century,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN RTC_REGISTER_B RegisterB
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BOOLEAN IsPM;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((Time->Hour & 0x80) != 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IsPM = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IsPM = FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = (UINT8) (Time->Hour & 0x7f);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterB.Bits.Dm == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = CheckAndConvertBcd8ToDecimal8 ((UINT8) Time->Year);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month = CheckAndConvertBcd8ToDecimal8 (Time->Month);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day = CheckAndConvertBcd8ToDecimal8 (Time->Day);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = CheckAndConvertBcd8ToDecimal8 (Time->Hour);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Minute = CheckAndConvertBcd8ToDecimal8 (Time->Minute);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Second = CheckAndConvertBcd8ToDecimal8 (Time->Second);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Century = CheckAndConvertBcd8ToDecimal8 (Century);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Year == 0xff || Time->Month == 0xff || Time->Day == 0xff ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour == 0xff || Time->Minute == 0xff || Time->Second == 0xff ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Century == 0xff) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = (UINT16) (Century * 100 + Time->Year);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If time is in 12 hour format, convert it to 24 hour format
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterB.Bits.Mil == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (IsPM && Time->Hour < 12) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = (UINT8) (Time->Hour + 12);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (!IsPM && Time->Hour == 12) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Nanosecond = 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Wait for a period for the RTC to be ready.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Timeout Tell how long it should take to wait.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_DEVICE_ERROR RTC device error.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS RTC is updated and ready.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncRtcWaitToUpdate (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINTN Timeout
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_A RegisterA;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RTC_REGISTER_D RegisterD;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // See if the RTC is functioning correctly
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterD.Data = RtcRead (RTC_ADDRESS_REGISTER_D);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterD.Bits.Vrt == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Wait for up to 0.1 seconds for the RTC to be ready.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Timeout = (Timeout / 10) + 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterA.Data = RtcRead (RTC_ADDRESS_REGISTER_A);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync while (RegisterA.Bits.Uip == 1 && Timeout > 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync MicroSecondDelay (10);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterA.Data = RtcRead (RTC_ADDRESS_REGISTER_A);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Timeout--;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RegisterD.Data = RtcRead (RTC_ADDRESS_REGISTER_D);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Timeout == 0 || RegisterD.Bits.Vrt == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_DEVICE_ERROR;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync See if all fields of a variable of EFI_TIME type is correct.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time The time to be checked.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_INVALID_PARAMETER Some fields of Time are not correct.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval EFI_SUCCESS Time is a valid EFI_TIME variable.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncEFI_STATUS
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncRtcTimeFieldsValid (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *Time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Year < 1998 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year > 2099 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month < 1 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month > 12 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (!DayValid (Time)) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour > 23 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Minute > 59 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Second > 59 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Nanosecond > 999999999 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (!(Time->TimeZone == EFI_UNSPECIFIED_TIMEZONE || (Time->TimeZone >= -1440 && Time->TimeZone <= 1440))) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ((Time->Daylight & (~(EFI_TIME_ADJUST_DAYLIGHT | EFI_TIME_IN_DAYLIGHT))) != 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_INVALID_PARAMETER;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return EFI_SUCCESS;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync See if field Day of an EFI_TIME is correct.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time Its Day field is to be checked.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE Day field of Time is correct.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE Day field of Time is NOT correct.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncBOOLEAN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncDayValid (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *Time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync INTN DayOfMonth[12];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[0] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[1] = 29;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[2] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[3] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[4] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[5] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[6] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[7] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[8] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[9] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[10] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[11] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The validity of Time->Month field should be checked before
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (Time->Month >=1);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (Time->Month <=12);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Day < 1 ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day > DayOfMonth[Time->Month - 1] ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (Time->Month == 2 && (!IsLeapYear (Time) && Time->Day > 28))
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Check if it is a leap year.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time The time to be checked.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE It is a leap year.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE It is NOT a leap year.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncBOOLEAN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncIsLeapYear (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *Time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Year % 4 == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Year % 100 == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Year % 400 == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Converts time from EFI_TIME format defined by UEFI spec to RTC's.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync This function converts time from EFI_TIME format defined by UEFI spec to RTC's.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If data mode of RTC is BCD, then converts EFI_TIME to it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync If RTC is in 12-hour format, then converts EFI_TIME to it.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Time On input, the time data read from UEFI to convert
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync On output, the time converted to RTC format
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param RegisterB Value of Register B of RTC, indicating data mode
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param Century It is set according to EFI_TIME Time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncVOID
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncConvertEfiTimeToRtcTime (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN OUT EFI_TIME *Time,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN RTC_REGISTER_B RegisterB,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync OUT UINT8 *Century
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BOOLEAN IsPM;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IsPM = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Adjust hour field if RTC is in 12 hour mode
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterB.Bits.Mil == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Hour < 12) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IsPM = FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (Time->Hour >= 13) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = (UINT8) (Time->Hour - 12);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (Time->Hour == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = 12;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // Set the Time/Date/Daylight Savings values.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *Century = DecimalToBcd8 ((UINT8) (Time->Year / 100));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = (UINT16) (Time->Year % 100);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterB.Bits.Dm == 0) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Year = DecimalToBcd8 ((UINT8) Time->Year);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Month = DecimalToBcd8 (Time->Month);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Day = DecimalToBcd8 (Time->Day);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = DecimalToBcd8 (Time->Hour);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Minute = DecimalToBcd8 (Time->Minute);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Second = DecimalToBcd8 (Time->Second);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // If we are in 12 hour mode and PM is set, then set bit 7 of the Hour field.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (RegisterB.Bits.Mil == 0 && IsPM) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Time->Hour = (UINT8) (Time->Hour | 0x80);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Compare the Hour, Minute and Second of the From time and the To time.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Only compare H/M/S in EFI_TIME and ignore other fields here.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param From the first time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param To the second time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return >0 The H/M/S of the From time is later than those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return ==0 The H/M/S of the From time is same as those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @return <0 The H/M/S of the From time is earlier than those of To time
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncINTN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncCompareHMS (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *From,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *To
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((From->Hour > To->Hour) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ((From->Hour == To->Hour) && (From->Minute > To->Minute)) ||
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ((From->Hour == To->Hour) && (From->Minute == To->Minute) && (From->Second > To->Second))) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return 1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if ((From->Hour == To->Hour) && (From->Minute == To->Minute) && (From->Second == To->Second)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return 0;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return -1;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/**
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync To check if second date is later than first date within 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param From the first date
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @param To the second date
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval TRUE From is previous to To within 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync @retval FALSE From is later, or it is previous to To more than 24 hours.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync**/
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncBOOLEAN
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncIsWithinOneDay (
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *From,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync IN EFI_TIME *To
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync )
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync{
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync UINT8 DayOfMonth[12];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync BOOLEAN Adjacent;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[0] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[1] = 29;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[2] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[3] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[4] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[5] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[6] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[7] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[8] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[9] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[10] = 30;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync DayOfMonth[11] = 31;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = FALSE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // The validity of From->Month field should be checked before
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync //
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (From->Month >=1);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ASSERT (From->Month <=12);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (From->Year == To->Year) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (From->Month == To->Month) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((From->Day + 1) == To->Day) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((CompareHMS(From, To) >= 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (From->Day == To->Day) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((CompareHMS(From, To) <= 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (((From->Month + 1) == To->Month) && (To->Day == 1)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((From->Month == 2) && !IsLeapYear(From)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (From->Day == 28) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((CompareHMS(From, To) >= 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (From->Day == DayOfMonth[From->Month - 1]) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((CompareHMS(From, To) >= 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync } else if (((From->Year + 1) == To->Year) &&
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (From->Month == 12) &&
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (From->Day == 31) &&
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (To->Month == 1) &&
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync (To->Day == 1)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if ((CompareHMS(From, To) >= 0)) {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Adjacent = TRUE;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync }
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return Adjacent;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync}
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync