From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: None (no SPF record) identity=mailfrom; client-ip=2a00:1450:4864:20::541; helo=mail-ed1-x541.google.com; envelope-from=pete@akeo.ie; receiver=edk2-devel@lists.01.org Received: from mail-ed1-x541.google.com (mail-ed1-x541.google.com [IPv6:2a00:1450:4864:20::541]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 876922194D387 for ; Mon, 28 Jan 2019 04:45:11 -0800 (PST) Received: by mail-ed1-x541.google.com with SMTP id x30so12921940edx.2 for ; Mon, 28 Jan 2019 04:45:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=akeo-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=LAJRbNUEaQD44h1K2BiAAbweAe3S3OCIogaXXjKdgek=; b=T4q3ZSFadPth05qFYh92EnCyB1r4A3Y1v9WC88Xr0Ykt7BQKdbBD/EU5+VORwy8ALl 7epI8VAze2xxJOww/vGW3mo/wNfITzS2ZJHoQ/JWATs5nPIO+sUJRVqPcHd8qjbFfsDD HMAYNTBNBfoGHy306Y7VA8+QBLAwfme8kHoxpia+R2Vlq2ZXVBw9DmyDczjMisCsEj3i jIkIUa6ipLMBLV6IRFydBLAn9fQrQZa21l8MjzqNXzfbHuVq6fFM1xACKpXQxd2TdfFj j+LPgodrJmQbQV8ch5nFkRK2MXs5NyQZWrINaV49yfpXUc19Il8jDlIXBWxJeAUkidZW S8yg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=LAJRbNUEaQD44h1K2BiAAbweAe3S3OCIogaXXjKdgek=; b=UNwoPC7qLh4xcIwoA/cy5iDq0pd33pN/TwjpkZWHWmViqPpvNaLbobtUuoDkXOx3p2 9Mx2a0gM08yzAQsIRyVCkMDVt5MYV2xQDQUOj5I5i4yEQuHs6zLc/0LpSpt+qV+QyF5D gL8e4bd1EMYbb8l0UA2N6ROAcYiqCX4umkRvBDfuRHncIr2zXOn3jQWsCRACclVfP+Fy TLVLdhKW8x3rvjiCkj8qcxefdIhNXQgxKWjC6IiSBKJyOCbAAUB0HWOUAI+PsKAUa58W EZrS1DYanSTnkfENzjdRGb+dLGAz6oKj0RqOZKTUM5QkhV0OBlWhIeZtOZi7lMWWQGj1 Cmaw== X-Gm-Message-State: AJcUuke1Z6H3NtUuWC7QBZ97IkHrrBesps2BAod6zK9OOFKgEf56fQFF wXq5mMTRv83dOPA5Rwh9ujlbs7eX9cs= X-Google-Smtp-Source: ALg8bN7sPCHggC73RhcN45Alyf7gAU6etMaABJfxSRF9OB9PR3EjD49TQbh2x/Ar3XxvFxMcCF6bDA== X-Received: by 2002:aa7:dd0f:: with SMTP id i15mr20604512edv.29.1548679509670; Mon, 28 Jan 2019 04:45:09 -0800 (PST) Received: from localhost.localdomain ([84.203.95.186]) by smtp.gmail.com with ESMTPSA id y16sm13757367edb.41.2019.01.28.04.45.08 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 28 Jan 2019 04:45:09 -0800 (PST) From: Pete Batard To: edk2-devel@lists.01.org Date: Mon, 28 Jan 2019 12:44:28 +0000 Message-Id: <20190128124445.9868-7-pete@akeo.ie> X-Mailer: git-send-email 2.17.0.windows.1 In-Reply-To: <20190128124445.9868-1-pete@akeo.ie> References: <20190128124445.9868-1-pete@akeo.ie> Subject: [PATCH v3 edk2-platforms 06/23] Platform/Raspberry/Pi3: Add RTC library X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 X-List-Received-Date: Mon, 28 Jan 2019 12:45:12 -0000 Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Pete Batard --- Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.c | 221 ++++++++++++++++++++ Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.inf | 43 ++++ 2 files changed, 264 insertions(+) diff --git a/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.c b/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.c new file mode 100644 index 000000000000..dea621ff03ef --- /dev/null +++ b/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.c @@ -0,0 +1,221 @@ +/** @file + * + * Implement dummy EFI RealTimeClock runtime services. + * + * Copyright (c) 2018, Andrei Warkentin + * Copyright (c) Microsoft Corporation. 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 + +/** + Returns the current time and date information, and the time-keeping capabilities + of the virtual RTC. + + For simplicity, this LibGetTime does not report Years/Months, instead it will only report current + Day, Hours, Minutes and Seconds starting from the begining of CPU up-time. Otherwise, a more + complex logic will be required to account for leap years and days/month differences. + + @param Time A pointer to storage to receive a snapshot of the current time. + @param Capabilities An optional pointer to a buffer to receive the real time clock + device's capabilities. + + @retval EFI_SUCCESS The operation completed successfully. + @retval EFI_INVALID_PARAMETER Time is NULL. + @retval EFI_DEVICE_ERROR The time could not be retrieved due to hardware error. + +**/ +EFI_STATUS +EFIAPI +LibGetTime ( + OUT EFI_TIME *Time, + OUT EFI_TIME_CAPABILITIES *Capabilities + ) +{ + UINTN DataSize; + UINT64 Counter; + EFI_STATUS Status; + UINTN ElapsedSeconds; + UINT32 Remainder; + UINT32 Freq = ArmGenericTimerGetTimerFreq (); + + if (Time == NULL) { + return EFI_INVALID_PARAMETER; + } + + // + // Depend on ARM generic timer to report date/time relative to the + // start of CPU timer counting where date and time will always + // be relative to the date/time 1/1/1900 00H:00M:00S + // + + ASSERT (Freq != 0); + if (Freq == 0) { + return EFI_DEVICE_ERROR; + } + + if (Capabilities) { + Capabilities->Accuracy = 0; + Capabilities->Resolution = Freq; + Capabilities->SetsToZero = FALSE; + } + + DataSize = sizeof (UINTN); + ElapsedSeconds = 0; + Status = EfiGetVariable (L"RtcEpochSeconds", + &gEfiCallerIdGuid, + NULL, + &DataSize, + &ElapsedSeconds); + if (EFI_ERROR (Status)) { + ElapsedSeconds = PcdGet64 (PcdBootEpochSeconds); + } + Counter = GetPerformanceCounter (); + ElapsedSeconds += DivU64x32Remainder (Counter, Freq, &Remainder); + EpochToEfiTime (ElapsedSeconds, Time); + + // + // Frequency < 0x100000000, so Remainder < 0x100000000, then (Remainder * 1,000,000,000) + // will not overflow 64-bit. + // + Time->Nanosecond = DivU64x32 (MultU64x64 ((UINT64)Remainder, 1000000000U), Freq); + + return EFI_SUCCESS; +} + + +/** + Sets the current local time and date information. + + @param Time A pointer to the current time. + + @retval EFI_SUCCESS The operation completed successfully. + @retval EFI_INVALID_PARAMETER A time field is out of range. + @retval EFI_DEVICE_ERROR The time could not be set due due to hardware error. + +**/ +EFI_STATUS +EFIAPI +LibSetTime ( + IN EFI_TIME *Time + ) +{ + UINTN Epoch; + + if (!IsTimeValid (Time)) { + return EFI_INVALID_PARAMETER; + } + + Epoch = EfiTimeToEpoch (Time); + return EfiSetVariable (L"RtcEpochSeconds", &gEfiCallerIdGuid, + EFI_VARIABLE_BOOTSERVICE_ACCESS | + EFI_VARIABLE_RUNTIME_ACCESS | + EFI_VARIABLE_NON_VOLATILE, + sizeof (Epoch), + &Epoch); +} + + +/** + Returns the current wakeup alarm clock setting. + + @param Enabled Indicates if the alarm is currently enabled or disabled. + @param Pending Indicates if the alarm signal is pending and requires acknowledgement. + @param Time The current alarm setting. + + @retval EFI_SUCCESS The alarm settings were returned. + @retval EFI_INVALID_PARAMETER Any parameter is NULL. + @retval EFI_DEVICE_ERROR The wakeup time could not be retrieved due to a hardware error. + +**/ +EFI_STATUS +EFIAPI +LibGetWakeupTime ( + OUT BOOLEAN *Enabled, + OUT BOOLEAN *Pending, + OUT EFI_TIME *Time + ) +{ + return EFI_UNSUPPORTED; +} + + +/** + Sets the system wakeup alarm clock time. + + @param Enabled Enable or disable the wakeup alarm. + @param Time If Enable is TRUE, the time to set the wakeup alarm for. + + @retval EFI_SUCCESS If Enable is TRUE, then the wakeup alarm was enabled. If + Enable is FALSE, then the wakeup alarm was disabled. + @retval EFI_INVALID_PARAMETER A time field is out of range. + @retval EFI_DEVICE_ERROR The wakeup time could not be set due to a hardware error. + @retval EFI_UNSUPPORTED A wakeup timer is not supported on this platform. + +**/ +EFI_STATUS +EFIAPI +LibSetWakeupTime ( + IN BOOLEAN Enabled, + OUT EFI_TIME *Time + ) +{ + return EFI_UNSUPPORTED; +} + + +/** + This is the declaration of an EFI image entry point. This can be the entry point to an application + written to this specification, an EFI boot service driver, or an EFI runtime driver. + + @param ImageHandle Handle that identifies the loaded image. + @param SystemTable System Table for this image. + + @retval EFI_SUCCESS The operation completed successfully. + +**/ +EFI_STATUS +EFIAPI +LibRtcInitialize ( + IN EFI_HANDLE ImageHandle, + IN EFI_SYSTEM_TABLE *SystemTable + ) +{ + return EFI_SUCCESS; +} + + +/** + Fixup internal data so that EFI can be call in virtual mode. + Call the passed in Child Notify event and convert any pointers in + lib to virtual mode. + + @param[in] Event The Event that is being processed + @param[in] Context Event Context +**/ +VOID +EFIAPI +LibRtcVirtualNotifyEvent ( + IN EFI_EVENT Event, + IN VOID *Context + ) +{ + return; +} diff --git a/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.inf b/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.inf new file mode 100644 index 000000000000..5c39e4df4c34 --- /dev/null +++ b/Platform/Raspberry/Pi3/Library/VirtualRealTimeClockLib/VirtualRealTimeClockLib.inf @@ -0,0 +1,43 @@ +#/** @file +# +# Implement dummy EFI RealTimeClock runtime services. +# +# Copyright (c) 2018, Andrei Warkentin +# Copyright (c) Microsoft Corporation. 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. +# +#**/ + +[Defines] + INF_VERSION = 0x0001001A + BASE_NAME = VirtualRealTimeClockLib + FILE_GUID = 1E27D461-78F3-4F7D-B1C2-F72384F13A6E + MODULE_TYPE = BASE + VERSION_STRING = 1.0 + LIBRARY_CLASS = RealTimeClockLib + +[Sources.common] + VirtualRealTimeClockLib.c + +[Packages] + ArmPkg/ArmPkg.dec + MdePkg/MdePkg.dec + EmbeddedPkg/EmbeddedPkg.dec + Platform/Raspberry/Pi3/RPi3.dec + +[LibraryClasses] + IoLib + DebugLib + TimerLib + TimeBaseLib + UefiRuntimeLib + +[Pcd] + gRaspberryPiTokenSpaceGuid.PcdBootEpochSeconds -- 2.17.0.windows.1