MdeModulePkg/Universal/PcatRealTimeClockRuntimeDxe/Ia32/Ia32PcRtc.c

   1 /*++
   2
   3 Copyright (c) 2006 - 2007 Intel Corporation. <BR>
   4 All rights reserved. This program and the accompanying materials
   5 are licensed and made available under the terms and conditions of the BSD License
   6 which accompanies this distribution.  The full text of the license may be found at
   7 http://opensource.org/licenses/bsd-license.php
   8
   9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  11
  12
  13
  14 Module Name:
  15
  16  Ia32PcRtc.c
  17
  18 Abstract:
  19
  20 --*/
  21
  22 #include "PcRtc.h"
  23
  24 static PC_RTC_MODULE_GLOBALS  mModuleGlobal;
  25
  26 EFI_STATUS
  27 EFIAPI
  28 PcRtcEfiGetTime (
  29   OUT EFI_TIME                *Time,
  30   OUT  EFI_TIME_CAPABILITIES  *Capabilities
  31   )
  32 /*++
  33
  34 Routine Description:
  35
  36   GC_TODO: Add function description
  37
  38 Arguments:
  39
  40   Time          - GC_TODO: add argument description
  41   Capabilities  - GC_TODO: add argument description
  42
  43 Returns:
  44
  45   GC_TODO: add return values
  46
  47 --*/
  48 {
  49   return PcRtcGetTime (Time, Capabilities, &mModuleGlobal);
  50 }
  51
  52 EFI_STATUS
  53 EFIAPI
  54 PcRtcEfiSetTime (
  55   IN EFI_TIME                *Time
  56   )
  57 /*++
  58
  59 Routine Description:
  60
  61   GC_TODO: Add function description
  62
  63 Arguments:
  64
  65   Time  - GC_TODO: add argument description
  66
  67 Returns:
  68
  69   GC_TODO: add return values
  70
  71 --*/
  72 {
  73   return PcRtcSetTime (Time, &mModuleGlobal);
  74 }
  75
  76 EFI_STATUS
  77 EFIAPI
  78 PcRtcEfiGetWakeupTime (
  79   OUT BOOLEAN     *Enabled,
  80   OUT BOOLEAN     *Pending,
  81   OUT EFI_TIME    *Time
  82   )
  83 /*++
  84
  85 Routine Description:
  86
  87   GC_TODO: Add function description
  88
  89 Arguments:
  90
  91   Enabled - GC_TODO: add argument description
  92   Pending - GC_TODO: add argument description
  93   Time    - GC_TODO: add argument description
  94
  95 Returns:
  96
  97   GC_TODO: add return values
  98
  99 --*/
 100 {
 101   return PcRtcGetWakeupTime (Enabled, Pending, Time, &mModuleGlobal);
 102 }
 103
 104 EFI_STATUS
 105 EFIAPI
 106 PcRtcEfiSetWakeupTime (
 107   IN BOOLEAN      Enabled,
 108   OUT EFI_TIME    *Time
 109   )
 110 /*++
 111
 112 Routine Description:
 113
 114   GC_TODO: Add function description
 115
 116 Arguments:
 117
 118   Enabled - GC_TODO: add argument description
 119   Time    - GC_TODO: add argument description
 120
 121 Returns:
 122
 123   GC_TODO: add return values
 124
 125 --*/
 126 {
 127   return PcRtcSetWakeupTime (Enabled, Time, &mModuleGlobal);
 128 }
 129
 130 EFI_STATUS
 131 EFIAPI
 132 InitializePcRtc (
 133   IN EFI_HANDLE                            ImageHandle,
 134   IN EFI_SYSTEM_TABLE                      *SystemTable
 135   )
 136 /*++
 137
 138 Routine Description:
 139
 140   Arguments:
 141
 142
 143
 144 Returns:
 145 --*/
 146 // GC_TODO:    ImageHandle - add argument and description to function comment
 147 // GC_TODO:    SystemTable - add argument and description to function comment
 148 {
 149   EFI_STATUS  Status;
 150   EFI_HANDLE  NewHandle;
 151
 152   EfiInitializeLock (&mModuleGlobal.RtcLock, TPL_HIGH_LEVEL);
 153
 154   Status = PcRtcInit (&mModuleGlobal);
 155   if (EFI_ERROR (Status)) {
 156     return Status;
 157   }
 158
 159   gRT->GetTime       = PcRtcEfiGetTime;
 160   gRT->SetTime       = PcRtcEfiSetTime;
 161   gRT->GetWakeupTime = PcRtcEfiGetWakeupTime;
 162   gRT->SetWakeupTime = PcRtcEfiSetWakeupTime;
 163
 164   NewHandle = NULL;
 165   Status = gBS->InstallMultipleProtocolInterfaces (
 166                   &NewHandle,
 167                   &gEfiRealTimeClockArchProtocolGuid,
 168                   NULL,
 169                   NULL
 170                   );
 171
 172   return Status;
 173 }