From: Leif Lindholm <leif.lindholm@linaro.org>
To: Ming Huang <ming.huang@linaro.org>
Cc: linaro-uefi@lists.linaro.org, edk2-devel@lists.01.org,
graeme.gregory@linaro.org, ard.biesheuvel@linaro.org,
michael.d.kinney@intel.com, lersek@redhat.com,
guoheyi@huawei.com, wanghuiqiang@huawei.com,
huangming23@huawei.com, zhangjinsong2@huawei.com,
huangdaode@hisilicon.com, john.garry@huawei.com,
xinliang.liu@linaro.org
Subject: Re: [PATCH edk2-platforms v4 07/31] Platform/Hisilicon/D06: Add M41T83RealTimeClockLib
Date: Thu, 30 Aug 2018 20:00:26 +0100 [thread overview]
Message-ID: <20180830190026.jdxjueye72ci22do@bivouac.eciton.net> (raw)
In-Reply-To: <20180823160743.45638-8-ming.huang@linaro.org>
On Fri, Aug 24, 2018 at 12:07:19AM +0800, Ming Huang wrote:
> Add M41T83RealTimeClockLib for RTC.
>
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Ming Huang <ming.huang@linaro.org>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
> ---
> Platform/Hisilicon/D06/D06.dsc | 1 +
> Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.inf | 46 ++
> Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClock.h | 158 ++++++
> Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.c | 559 ++++++++++++++++++++
> 4 files changed, 764 insertions(+)
>
> diff --git a/Platform/Hisilicon/D06/D06.dsc b/Platform/Hisilicon/D06/D06.dsc
> index d14fce1159..27358f8c78 100644
> --- a/Platform/Hisilicon/D06/D06.dsc
> +++ b/Platform/Hisilicon/D06/D06.dsc
> @@ -65,6 +65,7 @@
> CpldIoLib|Silicon/Hisilicon/Library/CpldIoLib/CpldIoLib.inf
>
> TimeBaseLib|EmbeddedPkg/Library/TimeBaseLib/TimeBaseLib.inf
> + RealTimeClockLib|Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.inf
>
> CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
> GenericBdsLib|IntelFrameworkModulePkg/Library/GenericBdsLib/GenericBdsLib.inf
> diff --git a/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.inf b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.inf
> new file mode 100644
> index 0000000000..e0bf6b3f24
> --- /dev/null
> +++ b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.inf
> @@ -0,0 +1,46 @@
> +#/** @file
> +#
> +# Copyright (c) 2018, Hisilicon Limited. All rights reserved.<BR>
> +# Copyright (c) 2018, Linaro Limited. All rights reserved.<BR>
> +#
> +# 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 = M41T83RealTimeClockLib
> + FILE_GUID = 470DFB96-E205-4515-A75E-2E60F853E79D
> + MODULE_TYPE = BASE
> + VERSION_STRING = 1.0
> + LIBRARY_CLASS = RealTimeClockLib
> +
> +[Sources.common]
> + M41T83RealTimeClockLib.c
> +
> +[Packages]
> + EmbeddedPkg/EmbeddedPkg.dec
> + MdePkg/MdePkg.dec
> + Platform/Hisilicon/D06/D06.dec
> + Silicon/Hisilicon/HisiPkg.dec
> +
> +[LibraryClasses]
> + BaseMemoryLib
> + CpldIoLib
> + DebugLib
> + I2CLib
> + IoLib
> + PcdLib
> + TimeBaseLib
> + TimerLib
> + UefiLib
> + UefiRuntimeLib # Use EFiAtRuntime to check stage
> +
> +[Depex]
> + gEfiCpuArchProtocolGuid
> diff --git a/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClock.h b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClock.h
> new file mode 100644
> index 0000000000..d985055d9b
> --- /dev/null
> +++ b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClock.h
> @@ -0,0 +1,158 @@
> +/** @file
> +
> + Copyright (c) 2018, Hisilicon Limited. All rights reserved.<BR>
> + Copyright (c) 2018, Linaro Limited. All rights reserved.<BR>
> +
> + 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.
> +
> +**/
> +
> +#ifndef __M41T83_REAL_TIME_CLOCK_H__
> +#define __M41T83_REAL_TIME_CLOCK_H__
> +
> +// The delay is need for cpld and I2C. This is a empirical value. MemoryFence is no need.
> +#define RTC_DELAY_30_MS 30000
> +// The delay is need for cpld and I2C. This is a empirical value. MemoryFence is no need.
> +#define RTC_DELAY_1000_MACROSECOND 1000
> +// The delay is need for cpld and I2C. This is a empirical value. MemoryFence is no need.
> +#define RTC_DELAY_2_MACROSECOND 2
> +
> +#define M41T83_REGADDR_DOTSECONDS 0x00
> +#define M41T83_REGADDR_SECONDS 0x01
> +#define M41T83_REGADDR_MINUTES 0x02
> +#define M41T83_REGADDR_HOURS 0x03
> +#define M41T83_REGADDR_WEEK_DAY 0x04
> +#define M41T83_REGADDR_DAY 0x05
> +#define M41T83_REGADDR_MONTH 0x06
> +#define M41T83_REGADDR_YEAR 0x07
> +#define M41T83_REGADDR_ALARM1SEC 0x0E
> +#define M41T83_REGADDR_ALARM1MIN 0x0D
> +#define M41T83_REGADDR_ALARM1HOUR 0x0C
> +#define M41T83_REGADDR_ALARM1DATE 0x0B
> +#define M41T83_REGADDR_ALARM1MONTH 0x0A
> +
> +#define M41T83_REGADDR_TIMERCONTROL 0x11
> +
> +#define M41T83_REGADDR_ALARM2SEC 0x18
> +#define M41T83_REGADDR_ALARM2MIN 0x17
> +#define M41T83_REGADDR_ALARM2HOUR 0x16
> +#define M41T83_REGADDR_ALARM2DATE 0x15
> +#define M41T83_REGADDR_ALARM2MONTH 0x14
> +
> +typedef union {
> + struct {
> + UINT8 TD0:1;
> + UINT8 TD1:1;
> + UINT8 RSV:3;
> + UINT8 TIE:1;
> + UINT8 TITP:1;
> + UINT8 TE:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_TIMERCONTROL;
> +
> +typedef union {
> + struct {
> + UINT8 MicroSeconds;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_DOTSECOND;
> +
> +typedef union {
> + struct{
> + UINT8 Seconds:7;
> + UINT8 ST:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_SECOND;
> +
> +typedef union {
> + struct {
> + UINT8 Minutes:7;
> + UINT8 Rsv:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_MINUTE;
> +
> +typedef union {
> + struct {
> + UINT8 Hours:6;
> + UINT8 CB:2;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_HOUR;
> +
> +typedef union {
> + struct{
> + UINT8 Days:3;
> + UINT8 Rsv:5;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_WEEK_DAY;
> +
> +typedef union {
> + struct{
> + UINT8 Days:6;
> + UINT8 Rsv:2;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_MONTH_DAY;
> +
> +typedef union {
> + struct {
> + UINT8 Months:5;
> + UINT8 Rsv:3;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_MONTH;
> +
> +typedef union {
> + struct {
> + UINT8 Years:8;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_YEAR;
> +
> +typedef union {
> + struct {
> + UINT8 Second:7;
> + UINT8 RPT11:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_ALARM1SEC;
> +
> +typedef union {
> + struct {
> + UINT8 Minute:7;
> + UINT8 RPT12:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_ALARM1MIN;
> +
> +typedef union {
> + struct {
> + UINT8 Hour:6;
> + UINT8 HT:1;
> + UINT8 RPT13:1;
> + } Bits;
> + UINT8 Uint8;
> +} RTC_M41T83_ALARM1HOUR;
> +
> +typedef struct {
> + RTC_M41T83_DOTSECOND DotSecond;
> + RTC_M41T83_SECOND Second;
> + RTC_M41T83_MINUTE Minute;
> + RTC_M41T83_HOUR Hour;
> + RTC_M41T83_WEEK_DAY WeekDay;
> + RTC_M41T83_MONTH_DAY Day;
> + RTC_M41T83_MONTH Month;
> + RTC_M41T83_YEAR Year;
> +} RTC_M41T83_TIME;
> +
> +#endif
> diff --git a/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.c b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.c
> new file mode 100644
> index 0000000000..0670f9c5f4
> --- /dev/null
> +++ b/Silicon/Hisilicon/Library/M41T83RealTimeClockLib/M41T83RealTimeClockLib.c
> @@ -0,0 +1,559 @@
> +/** @file
> +
> + Copyright (c) 2018, Hisilicon Limited. All rights reserved.<BR>
> + Copyright (c) 2018, Linaro Limited. All rights reserved.<BR>
> +
> + 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 <Uefi.h>
> +#include <PiDxe.h>
> +#include <Library/BaseLib.h>
> +#include <Library/BaseMemoryLib.h>
> +#include <Library/CpldD06.h>
> +#include <Library/CpldIoLib.h>
> +#include <Library/DebugLib.h>
> +#include <Library/I2CLib.h>
> +#include <Library/TimeBaseLib.h>
> +#include <Library/TimerLib.h>
> +#include <Library/UefiLib.h>
> +#include <Library/UefiRuntimeLib.h>
> +#include <Library/UefiRuntimeServicesTableLib.h>
> +#include "M41T83RealTimeClock.h"
> +
> +extern I2C_DEVICE gRtcDevice;
> +
> +STATIC EFI_LOCK mRtcLock;
> +
> +EFI_STATUS
> +SwitchRtcI2cChannelAndLock (
> + VOID
> + )
> +{
> + UINT8 Temp;
> + UINT8 Count;
> +
> + for (Count = 0; Count < 100; Count++) {
> + // To get the other side's state is idle first
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + if ((Temp & BIT3) != 0) {
> + (VOID) MicroSecondDelay (RTC_DELAY_30_MS);
> + // Try 100 times, if BMC has not released the bus, return preemption failed
> + if (Count == 99) {
> + if (!EfiAtRuntime ()) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Clear cpu_i2c_rtc_state 100 times fail!\n",
> + __FUNCTION__, __LINE__));
> + }
> + return EFI_DEVICE_ERROR;
> + }
> + continue;
> + }
> +
> + // if BMC free the bus, can be set 1 preemption
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + Temp = Temp | CPU_GET_I2C_CONTROL;
> + // CPU occupied RTC I2C State
> + WriteCpldReg (CPLD_I2C_SWITCH_FLAG, Temp);
> + (VOID) MicroSecondDelay (RTC_DELAY_2_MACROSECOND);
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + // Is preempt success
> + if(CPU_GET_I2C_CONTROL == (Temp & CPU_GET_I2C_CONTROL)) {
> + break;
> + }
> + if (Count == 99) {
> + if (!EfiAtRuntime ()) {
> + DEBUG((DEBUG_ERROR, "[%a]:[%dL] Clear cpu_i2c_rtc_state fail !!! \n",
> + __FUNCTION__, __LINE__));
> + }
> + return EFI_DEVICE_ERROR;
> + }
> + (VOID) MicroSecondDelay (RTC_DELAY_30_MS);
> + }
> +
> + //Polling BMC RTC I2C status
> + for (Count = 0; Count < 100; Count++) {
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + if ((Temp & BIT3) == 0) {
> + return EFI_SUCCESS;
> + }
> + (VOID) MicroSecondDelay (RTC_DELAY_30_MS);
> + }
> +
> + //If the BMC occupies the RTC I2C Channel, write back the CPU side is idle
> + // or the subsequent BMC will not preempt
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + Temp = Temp & (~CPU_GET_I2C_CONTROL);
> + WriteCpldReg (CPLD_I2C_SWITCH_FLAG, Temp);
> +
> + return EFI_NOT_READY;
> +}
> +
> +
> +/**
> + Read RTC content through its registers.
> +
> + @param Address Address offset of RTC data.
> + @param Size Size of RTC data to read.
> + @param Data The data of UINT8 type read from RTC.
> +
> + @return EFI_STATUS
> +**/
> +EFI_STATUS
> +RtcRead (
> + IN UINT8 Address,
> + IN UINT8 Size,
> + OUT UINT8 *Data
> + )
> +{
> + EFI_STATUS Status;
> +
> + Status = I2CRead (&gRtcDevice, Address, Size, Data);
> + MicroSecondDelay (RTC_DELAY_1000_MACROSECOND);
> + return Status;
> +}
> +
> +/**
> + Write RTC through its registers.
> +
> + @param Address Address offset of RTC data.
> + @param Size Size of RTC data to write.
> + @param Data The data of UINT8 type write from RTC.
> +
> + @return EFI_STATUS
> +**/
> +EFI_STATUS
> +RtcWrite (
> + IN UINT8 Address,
> + IN UINT8 Size,
> + UINT8 *Data
> + )
> +{
> + EFI_STATUS Status;
> +
> + Status = I2CWrite (&gRtcDevice, Address, Size, Data);
> + MicroSecondDelay (RTC_DELAY_1000_MACROSECOND);
> + return Status;
> +}
> +
> +VOID
> +ReleaseOwnershipOfRtc (
> + VOID
> + )
> +{
> + UINT8 Temp;
> +
> + Temp = ReadCpldReg (CPLD_I2C_SWITCH_FLAG);
> + Temp = Temp & ~CPU_GET_I2C_CONTROL;
> + WriteCpldReg (CPLD_I2C_SWITCH_FLAG, Temp);
> +}
> +
> +
> +EFI_STATUS
> +InitializeM41T83 (
> + VOID
> + )
> +{
> + EFI_STATUS Status;
> + RTC_M41T83_ALARM1HOUR Alarm1Hour;
> + RTC_M41T83_SECOND Second;
> +
> + // Acquire RTC Lock to make access to RTC atomic
> + if (!EfiAtRuntime ()) {
> + EfiAcquireLock (&mRtcLock);
> + }
> +
> + Status = I2CInit (gRtcDevice.Socket, gRtcDevice.Port, Normal);
> + MicroSecondDelay (RTC_DELAY_1000_MACROSECOND);
> + if (EFI_ERROR (Status)) {
> + if (!EfiAtRuntime ()) {
> + EfiReleaseLock (&mRtcLock);
> + }
> + return Status;
> + }
> +
> + Status = SwitchRtcI2cChannelAndLock ();
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "Get i2c preemption failed: %r\n", Status));
> + if (!EfiAtRuntime ()) {
> + EfiReleaseLock (&mRtcLock);
> + }
> + return Status;
> + }
> +
> + MicroSecondDelay(RTC_DELAY_1000_MACROSECOND);
> +
> + // Set ST at Power up to clear Oscillator fail detection(OF)
> + Status = RtcRead (M41T83_REGADDR_SECONDS, 1, &Second.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + }
> + Second.Bits.ST= 1;
> + Status = RtcWrite (M41T83_REGADDR_SECONDS, 1, &Second.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + goto Exit;
> + }
> + Status = RtcRead (M41T83_REGADDR_SECONDS, 1, &Second.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + }
> + Second.Bits.ST= 0;
> + Status = RtcWrite (M41T83_REGADDR_SECONDS, 1, &Second.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + goto Exit;
> + }
> +
> + // Clear HT bit to enanle write to the RTC registers (addresses 0-7)
> + Status = RtcRead (M41T83_REGADDR_ALARM1HOUR, 1, &Alarm1Hour.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + }
> + Alarm1Hour.Bits.HT = 0;
> + Status = RtcWrite (M41T83_REGADDR_ALARM1HOUR, 1, &Alarm1Hour.Uint8);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + goto Exit;
> + }
> +
> +Exit:
> + // Release RTC Lock.
> + ReleaseOwnershipOfRtc ();
> + if (!EfiAtRuntime ()) {
> + EfiReleaseLock (&mRtcLock);
> + }
> + return Status;
> +}
> +
> +/**
> + 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
> + )
> +{
> + EFI_STATUS Status = EFI_SUCCESS;
> + RTC_M41T83_TIME BcdTime;
> + UINT16 CenturyBase = 2000;
> + UINTN LineNum = 0;
> +
> + if (NULL == Time) {
> + return EFI_INVALID_PARAMETER;
> + }
> +
> + if (!IsTimeValid (Time)) {
> + if (!EfiAtRuntime ()) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + DEBUG ((DEBUG_ERROR, "Now RTC Time is : %04d-%02d-%02d %02d:%02d:%02d\n",
> + Time->Year, Time->Month, Time->Day, Time->Hour, Time->Minute, Time->Second
> + ));
> + }
> + return EFI_INVALID_PARAMETER;
> + }
> +
> + Status = SwitchRtcI2cChannelAndLock ();
> + if (EFI_ERROR (Status)) {
> + return Status;
> + }
> + (VOID)MicroSecondDelay (RTC_DELAY_1000_MACROSECOND);
> +
> + SetMem (&BcdTime, sizeof (RTC_M41T83_TIME), 0);
> +
> + // Acquire RTC Lock to make access to RTC atomic
> + if (!EfiAtRuntime ()) {
> + EfiAcquireLock (&mRtcLock);
> + }
> +
> + BcdTime.Second.Bits.Seconds = DecimalToBcd8 (Time->Second);
> + BcdTime.Minute.Bits.Minutes = DecimalToBcd8 (Time->Minute);
> + BcdTime.Hour.Bits.Hours = DecimalToBcd8 (Time->Hour);
> + BcdTime.Day.Bits.Days = DecimalToBcd8 (Time->Day);
> + BcdTime.Month.Bits.Months = DecimalToBcd8 (Time->Month);
> + BcdTime.Year.Bits.Years = DecimalToBcd8 (Time->Year % 100);
> + BcdTime.Hour.Bits.CB = (Time->Year - CenturyBase) / 100 % 10;
> +
> + Status = RtcWrite (M41T83_REGADDR_DOTSECONDS, 1, &BcdTime.DotSecond.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_SECONDS, 1, &BcdTime.Second.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_MINUTES, 1, &BcdTime.Minute.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_HOURS, 1, &BcdTime.Hour.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_DAY, 1, &BcdTime.Day.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_MONTH, 1, &BcdTime.Month.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> + Status = RtcWrite (M41T83_REGADDR_YEAR, 1, &BcdTime.Year.Uint8);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> +
> +Exit:
> + ReleaseOwnershipOfRtc ();
> + // Release RTC Lock.
> + if (!EfiAtRuntime ()) {
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, LineNum, Status));
> + }
> + EfiReleaseLock (&mRtcLock);
> + }
> + return Status;
> +}
> +
> +
> +/**
> + Returns the current time and date information, and the time-keeping capabilities
> + of the hardware platform.
> +
> + @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.
> + @retval EFI_SECURITY_VIOLATION The time could not be retrieved due to an authentication failure.
> +**/
> +EFI_STATUS
> +EFIAPI
> +LibGetTime (
> + OUT EFI_TIME *Time,
> + OUT EFI_TIME_CAPABILITIES *Capabilities
> + )
> +{
> + EFI_STATUS Status = EFI_SUCCESS;
> + RTC_M41T83_TIME BcdTime;
> + UINT16 CenturyBase = 2000;
> + UINTN LineNum = 0;
> + BOOLEAN IsTimeInvalid = FALSE;
> + UINT8 TimeTemp[7] = {0};
> +
> + // Ensure Time is a valid pointer
> + if (Time == NULL) {
> + return EFI_INVALID_PARAMETER;
> + }
> +
> + Status = SwitchRtcI2cChannelAndLock ();
> + if (EFI_ERROR (Status)) {
> + return Status;
> + }
> +
> + MicroSecondDelay(RTC_DELAY_1000_MACROSECOND);
> +
> + SetMem (&BcdTime, sizeof (RTC_M41T83_TIME), 0);
> + SetMem (Time , sizeof (EFI_TIME), 0);
> +
> + // Acquire RTC Lock to make access to RTC atomic
> + if (!EfiAtRuntime ()) {
> + EfiAcquireLock (&mRtcLock);
> + }
> +
> + Status = RtcRead (M41T83_REGADDR_SECONDS, 7, TimeTemp);
> + if (EFI_ERROR (Status)) {
> + LineNum = __LINE__;
> + goto Exit;
> + }
> +
> + BcdTime.Second.Uint8 = TimeTemp[0]; //SECONDS
> + BcdTime.Minute.Uint8 = TimeTemp[1]; //MINUTES
> + BcdTime.Hour.Uint8 = TimeTemp[2]; //HOURS
> + BcdTime.Day.Uint8 = TimeTemp[4]; //DAY
> + BcdTime.Month.Uint8 = TimeTemp[5]; //MONTH
> + BcdTime.Year.Uint8 = TimeTemp[6]; //Year
> +
> + Time->Year = BcdToDecimal8 (BcdTime.Year.Bits.Years);
> + Time->Year += CenturyBase + BcdTime.Hour.Bits.CB * 100;
> + Time->Month = BcdToDecimal8 (BcdTime.Month.Bits.Months);
> + Time->Day = BcdToDecimal8 (BcdTime.Day.Bits.Days);
> + Time->Hour = BcdToDecimal8 (BcdTime.Hour.Bits.Hours);
> + Time->Minute = BcdToDecimal8 (BcdTime.Minute.Bits.Minutes);
> + Time->Second = BcdToDecimal8 (BcdTime.Second.Bits.Seconds);
> + Time->TimeZone = EFI_UNSPECIFIED_TIMEZONE;
> +
> + if (!IsTimeValid (Time)) {
> + Status = EFI_DEVICE_ERROR;
> + LineNum = __LINE__;
> + IsTimeInvalid = TRUE;
> + goto Exit;
> + }
> +
> +Exit:
> + ReleaseOwnershipOfRtc ();
> + // Release RTC Lock.
> + if (!EfiAtRuntime ()) {
> + if (EFI_ERROR (Status)) {
> + if (IsTimeInvalid == TRUE) {
> + DEBUG((DEBUG_ERROR, "%a(%d) Time invalid.\r\n",__FUNCTION__, LineNum));
> + } else {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\n",
> + __FUNCTION__, LineNum, Status));
> + }
> + }
> + EfiReleaseLock (&mRtcLock);
> + }
> + return Status;
> +}
> +
> +
> +/**
> + 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
> + )
> +{
> + // Not a required feature
> + 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
> + )
> +{
> + // Not a required feature
> + 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
> + )
> +{
> + EFI_STATUS Status = EFI_SUCCESS;
> + EFI_TIME EfiTime;
> +
> + EfiInitializeLock (&mRtcLock, TPL_CALLBACK);
> +
> + // Setup the setters and getters
> + gRT->GetTime = LibGetTime;
> + gRT->SetTime = LibSetTime;
> + gRT->GetWakeupTime = LibGetWakeupTime;
> + gRT->SetWakeupTime = LibSetWakeupTime;
> +
> + Status = InitializeM41T83 ();
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] Status : %r\nRTC M41T83 Init Failed !!!\n",
> + __FUNCTION__, __LINE__, Status));
> + /*
> + * Returning ERROR on failure of RTC initilization will cause the system to hang up.
> + * So we add some debug message to indecate the RTC initilization failed,
> + * and continue without returning with error to avoid system hanging up.
> + *
> + *return Status;
> + */
> + }
> +
> + LibGetTime (&EfiTime, NULL);
> + if (!IsTimeValid (&EfiTime)) {
> + EfiTime.Year = 2015;
> + EfiTime.Month = 1;
> + EfiTime.Day = 1;
> + EfiTime.Hour = 0;
> + EfiTime.Minute = 0;
> + EfiTime.Second = 0;
> + Status = LibSetTime (&EfiTime);
> + if (EFI_ERROR (Status)) {
> + DEBUG ((DEBUG_ERROR, "[%a]:[%dL] RTC settime Status : %r\n",
> + __FUNCTION__, __LINE__, Status));
> + }
> + }
> +
> + DEBUG ((
> + DEBUG_ERROR, "Now RTC Time is : %04d-%02d-%02d %02d:%02d:%02d\n",
> + EfiTime.Year, EfiTime.Month, EfiTime.Day, EfiTime.Hour, EfiTime.Minute,
> + EfiTime.Second
> + ));
> + /*
> + * Returning ERROR on failure of RTC initilization will cause the system to hang up.
> + * So we add some debug message to indecate the RTC initilization failed,
> + * and return success to avoid system hanging up.
> + */
> + return EFI_SUCCESS;
> +}
> --
> 2.18.0
>
next prev parent reply other threads:[~2018-08-30 19:00 UTC|newest]
Thread overview: 52+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-08-23 16:07 [PATCH edk2-platforms v4 00/31] Upload for D06 platform Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 01/31] Silicon/Hisilicon/Acpi: Move some macro to PlatformArch.h Ming Huang
2018-08-30 18:29 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 02/31] Silicon/Hisilicon/D0x: Move RAS " Ming Huang
2018-08-30 18:29 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 03/31] Silicon/Hisilicon: Fix I2CLib enable fail issue Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 04/31] Silicon/Hisilicon: Add I2CLib delay for HNS auto config Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 05/31] Silicon/Hisilicon: Optimize I2CLib for HNS config CDR time Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 06/31] Hisilicon/D06: Add several base file for D06 Ming Huang
2018-08-30 18:14 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 07/31] Platform/Hisilicon/D06: Add M41T83RealTimeClockLib Ming Huang
2018-08-30 19:00 ` Leif Lindholm [this message]
2018-08-23 16:07 ` [PATCH edk2-platforms v4 08/31] Platform/Hisilicon/D06: Add edk2-non-osi components for D06 Ming Huang
2018-08-30 18:59 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 09/31] Hisilicon/D06: Add OemMiscLibD06 Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 10/31] Silicon/Hisilicon/D06: Wait for all disk ready Ming Huang
2018-08-30 16:51 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 11/31] Silicon/Hisilicon/Acpi: Unify HisiAcpiPlatformDxe Ming Huang
2018-08-30 18:39 ` Leif Lindholm
2018-08-31 2:12 ` Ming
2018-08-23 16:07 ` [PATCH edk2-platforms v4 12/31] Hisilicon/D06: Add Debug Serial Port Init Driver Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 13/31] Hisilicon/D06: Add ACPI Tables for D06 Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 14/31] Hisilicon/D06: Add Hi1620OemConfigUiLib Ming Huang
2018-08-30 18:58 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 15/31] Silicon/Hisilicon/D06: Stop watchdog Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 16/31] Silicon/Hisilicon/Setup: Add Setup Item "EnableGOP" Ming Huang
2018-08-30 18:41 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 17/31] Hisilicon/Hi1620: Add ACPI PPTT table Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 18/31] Platform/Hisilicon/D06: Enable ACPI PPTT Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 19/31] Platform/Hisilicon/D06: Add OemNicLib Ming Huang
2018-08-30 18:45 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 20/31] Platform/Hisilicon/D06: Add OemNicConfig2P Driver Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 21/31] Hisilicon/D0x: Update SMBIOS type9 info Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 22/31] Platform/Hisilicon/D06: Add EarlyConfigPeim peim Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 23/31] Platform/Hisilicon/D06: Add PciHostBridgeLib Ming Huang
2018-08-23 16:07 ` [PATCH edk2-platforms v4 24/31] Hisilicon/D06: add apei driver Ming Huang
2018-08-30 18:47 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 25/31] Platform/Hisilicon/D06: Add capsule upgrade support Ming Huang
2018-08-30 18:49 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 26/31] Silicon/Hisilicon: Modify for close slave core clock Ming Huang
2018-08-30 18:50 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 27/31] Silicon/Hisilicon: Add I2C Bus Exception handle function Ming Huang
2018-08-30 18:51 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 28/31] Silicon/Hisilicon/Setup: Support SPCR table switch Ming Huang
2018-08-30 18:52 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 29/31] Silicon/Hisilicon/setup: Enable/disable SMMU Ming Huang
2018-08-30 18:55 ` Leif Lindholm
2018-08-23 16:07 ` [PATCH edk2-platforms v4 30/31] Hisilicon/D06: Add PciPlatformLib Ming Huang
2018-08-30 16:15 ` Leif Lindholm
2018-08-31 6:17 ` Ming
2018-08-23 16:07 ` [PATCH edk2-platforms v4 31/31] Platform/Hisilicon/D0x: Update version string to 18.08 Ming Huang
2018-08-30 20:20 ` [PATCH edk2-platforms v4 00/31] Upload for D06 platform Leif Lindholm
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180830190026.jdxjueye72ci22do@bivouac.eciton.net \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox