UefiCpuPkg/CpuMpPei/CpuMpPei.h

   1 /** @file
   2   Definitions to install Multiple Processor PPI.
   3
   4   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
   5   This program and the accompanying materials
   6   are licensed and made available under the terms and conditions of the BSD License
   7   which accompanies this distribution.  The full text of the license may be found at
   8   http://opensource.org/licenses/bsd-license.php
   9
  10   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  11   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  12
  13 **/
  14
  15 #ifndef _CPU_MP_PEI_H_
  16 #define _CPU_MP_PEI_H_
  17
  18 #include <PiPei.h>
  19
  20 #include <Ppi/MpServices.h>
  21 #include <Ppi/SecPlatformInformation.h>
  22 #include <Ppi/SecPlatformInformation2.h>
  23 #include <Ppi/EndOfPeiPhase.h>
  24
  25 #include <Register/Cpuid.h>
  26 #include <Register/LocalApic.h>
  27
  28 #include <Library/BaseLib.h>
  29 #include <Library/BaseMemoryLib.h>
  30 #include <Library/DebugLib.h>
  31 #include <Library/HobLib.h>
  32 #include <Library/LocalApicLib.h>
  33 #include <Library/MtrrLib.h>
  34 #include <Library/PcdLib.h>
  35 #include <Library/PeimEntryPoint.h>
  36 #include <Library/PeiServicesLib.h>
  37 #include <Library/ReportStatusCodeLib.h>
  38 #include <Library/SynchronizationLib.h>
  39 #include <Library/TimerLib.h>
  40 #include <Library/UefiCpuLib.h>
  41 #include <Library/CpuLib.h>
  42
  43 #include "Microcode.h"
  44
  45 //
  46 // AP state
  47 //
  48 typedef enum {
  49   CpuStateIdle,
  50   CpuStateBusy,
  51   CpuStateDisabled
  52 } CPU_STATE;
  53
  54 #define WAKEUP_AP_SIGNAL SIGNATURE_32 ('S', 'T', 'A', 'P')
  55
  56 typedef enum {
  57   ApInHltLoop   = 1,
  58   ApInMwaitLoop = 2,
  59   ApInRunLoop   = 3
  60 } AP_LOOP_MODE;
  61
  62 //
  63 // AP reset code information
  64 //
  65 typedef struct {
  66   UINT8             *RendezvousFunnelAddress;
  67   UINTN             PModeEntryOffset;
  68   UINTN             LModeEntryOffset;
  69   UINTN             RendezvousFunnelSize;
  70 } MP_ASSEMBLY_ADDRESS_MAP;
  71
  72 //
  73 // CPU exchange information for switch BSP
  74 //
  75 typedef struct {
  76   UINT8             State;        // offset 0
  77   UINTN             StackPointer; // offset 4 / 8
  78   IA32_DESCRIPTOR   Gdtr;         // offset 8 / 16
  79   IA32_DESCRIPTOR   Idtr;         // offset 14 / 26
  80 } CPU_EXCHANGE_ROLE_INFO;
  81
  82 typedef struct _PEI_CPU_MP_DATA  PEI_CPU_MP_DATA;
  83
  84 #pragma pack(1)
  85
  86 typedef union {
  87   struct {
  88     UINT32  LimitLow    : 16;
  89     UINT32  BaseLow     : 16;
  90     UINT32  BaseMid     : 8;
  91     UINT32  Type        : 4;
  92     UINT32  System      : 1;
  93     UINT32  Dpl         : 2;
  94     UINT32  Present     : 1;
  95     UINT32  LimitHigh   : 4;
  96     UINT32  Software    : 1;
  97     UINT32  Reserved    : 1;
  98     UINT32  DefaultSize : 1;
  99     UINT32  Granularity : 1;
 100     UINT32  BaseHigh    : 8;
 101   } Bits;
 102   UINT64  Uint64;
 103 } IA32_GDT;
 104
 105 //
 106 // MP CPU exchange information for AP reset code
 107 // This structure is required to be packed because fixed field offsets
 108 // into this structure are used in assembly code in this module
 109 //
 110 typedef struct {
 111   UINTN                 Lock;
 112   UINTN                 StackStart;
 113   UINTN                 StackSize;
 114   UINTN                 CFunction;
 115   IA32_DESCRIPTOR       GdtrProfile;
 116   IA32_DESCRIPTOR       IdtrProfile;
 117   UINTN                 BufferStart;
 118   UINTN                 PmodeOffset;
 119   UINTN                 NumApsExecuting;
 120   UINTN                 LmodeOffset;
 121   UINTN                 Cr3;
 122   PEI_CPU_MP_DATA       *PeiCpuMpData;
 123 } MP_CPU_EXCHANGE_INFO;
 124
 125 #pragma pack()
 126
 127 typedef struct {
 128   UINTN                          Cr0;
 129   UINTN                          Cr3;
 130   UINTN                          Cr4;
 131   UINTN                          Dr0;
 132   UINTN                          Dr1;
 133   UINTN                          Dr2;
 134   UINTN                          Dr3;
 135   UINTN                          Dr6;
 136   UINTN                          Dr7;
 137 } CPU_VOLATILE_REGISTERS;
 138
 139 typedef struct {
 140   volatile UINT32                *StartupApSignal;
 141   UINT32                         ApicId;
 142   EFI_HEALTH_FLAGS               Health;
 143   CPU_STATE                      State;
 144   BOOLEAN                        CpuHealthy;
 145   CPU_VOLATILE_REGISTERS         VolatileRegisters;
 146 } PEI_CPU_DATA;
 147
 148 //
 149 // PEI CPU MP Data save in memory
 150 //
 151 struct _PEI_CPU_MP_DATA {
 152   SPIN_LOCK                      MpLock;
 153   UINT32                         CpuCount;
 154   UINT32                         BspNumber;
 155   UINTN                          Buffer;
 156   UINTN                          CpuApStackSize;
 157   MP_ASSEMBLY_ADDRESS_MAP        AddressMap;
 158   UINTN                          WakeupBuffer;
 159   UINTN                          BackupBuffer;
 160   UINTN                          BackupBufferSize;
 161   UINTN                          ApFunction;
 162   UINTN                          ApFunctionArgument;
 163   volatile UINT32                FinishedCount;
 164   BOOLEAN                        EndOfPeiFlag;
 165   BOOLEAN                        InitFlag;
 166   BOOLEAN                        X2ApicEnable;
 167   CPU_EXCHANGE_ROLE_INFO         BSPInfo;
 168   CPU_EXCHANGE_ROLE_INFO         APInfo;
 169   MTRR_SETTINGS                  MtrrTable;
 170   UINT8                          ApLoopMode;
 171   UINT8                          ApTargetCState;
 172   PEI_CPU_DATA                   *CpuData;
 173   volatile MP_CPU_EXCHANGE_INFO  *MpCpuExchangeInfo;
 174 };
 175 extern EFI_PEI_PPI_DESCRIPTOR   mPeiCpuMpPpiDesc;
 176
 177
 178 /**
 179   Assembly code to get starting address and size of the rendezvous entry for APs.
 180   Information for fixing a jump instruction in the code is also returned.
 181
 182   @param AddressMap  Output buffer for address map information.
 183 **/
 184 VOID
 185 EFIAPI
 186 AsmGetAddressMap (
 187   OUT MP_ASSEMBLY_ADDRESS_MAP    *AddressMap
 188   );
 189
 190 /**
 191   Assembly code to load GDT table and update segment accordingly.
 192
 193   @param Gdtr   Pointer to GDT descriptor
 194 **/
 195 VOID
 196 EFIAPI
 197 AsmInitializeGdt (
 198   IN IA32_DESCRIPTOR  *Gdtr
 199   );
 200
 201 /**
 202   Get available system memory below 1MB by specified size.
 203
 204   @param PeiCpuMpData        Pointer to PEI CPU MP Data
 205 **/
 206 VOID
 207 BackupAndPrepareWakeupBuffer(
 208   IN PEI_CPU_MP_DATA         *PeiCpuMpData
 209   );
 210
 211 /**
 212   Restore wakeup buffer data.
 213
 214   @param PeiCpuMpData        Pointer to PEI CPU MP Data
 215 **/
 216 VOID
 217 RestoreWakeupBuffer(
 218   IN PEI_CPU_MP_DATA         *PeiCpuMpData
 219   );
 220
 221 /**
 222   Notify function on End Of Pei PPI.
 223
 224   On S3 boot, this function will restore wakeup buffer data.
 225   On normal boot, this function will flag wakeup buffer to be un-used type.
 226
 227   @param  PeiServices        The pointer to the PEI Services Table.
 228   @param  NotifyDescriptor   Address of the notification descriptor data structure.
 229   @param  Ppi                Address of the PPI that was installed.
 230
 231   @retval EFI_SUCCESS        When everything is OK.
 232
 233 **/
 234 EFI_STATUS
 235 EFIAPI
 236 CpuMpEndOfPeiCallback (
 237   IN      EFI_PEI_SERVICES        **PeiServices,
 238   IN EFI_PEI_NOTIFY_DESCRIPTOR    *NotifyDescriptor,
 239   IN VOID                         *Ppi
 240   );
 241
 242 /**
 243   This function will be called by BSP to wakeup AP.
 244
 245   @param PeiCpuMpData       Pointer to PEI CPU MP Data
 246   @param Broadcast          TRUE:  Send broadcast IPI to all APs
 247                             FALSE: Send IPI to AP by ApicId
 248   @param ProcessorNumber    The handle number of specified processor
 249   @param Procedure          The function to be invoked by AP
 250   @param ProcedureArgument  The argument to be passed into AP function
 251 **/
 252 VOID
 253 WakeUpAP (
 254   IN PEI_CPU_MP_DATA           *PeiCpuMpData,
 255   IN BOOLEAN                   Broadcast,
 256   IN UINTN                     ProcessorNumber,
 257   IN EFI_AP_PROCEDURE          Procedure,              OPTIONAL
 258   IN VOID                      *ProcedureArgument      OPTIONAL
 259   );
 260
 261 /**
 262   Get CPU MP Data pointer from the Guided HOB.
 263
 264   @return  Pointer to Pointer to PEI CPU MP Data
 265 **/
 266 PEI_CPU_MP_DATA *
 267 GetMpHobData (
 268   VOID
 269   );
 270
 271 /**
 272   Find the current Processor number by APIC ID.
 273
 274   @param PeiCpuMpData        Pointer to PEI CPU MP Data
 275   @param ProcessorNumber     Return the pocessor number found
 276
 277   @retval EFI_SUCCESS        ProcessorNumber is found and returned.
 278   @retval EFI_NOT_FOUND      ProcessorNumber is not found.
 279 **/
 280 EFI_STATUS
 281 GetProcessorNumber (
 282   IN PEI_CPU_MP_DATA         *PeiCpuMpData,
 283   OUT UINTN                  *ProcessorNumber
 284   );
 285
 286 /**
 287   Collects BIST data from PPI.
 288
 289   This function collects BIST data from Sec Platform Information2 PPI
 290   or SEC Platform Information PPI.
 291
 292   @param PeiServices         Pointer to PEI Services Table
 293   @param PeiCpuMpData        Pointer to PEI CPU MP Data
 294
 295 **/
 296 VOID
 297 CollectBistDataFromPpi (
 298   IN CONST EFI_PEI_SERVICES             **PeiServices,
 299   IN PEI_CPU_MP_DATA                    *PeiCpuMpData
 300   );
 301
 302 /**
 303   Implementation of the PlatformInformation2 service in EFI_SEC_PLATFORM_INFORMATION2_PPI.
 304
 305   @param  PeiServices                The pointer to the PEI Services Table.
 306   @param  StructureSize              The pointer to the variable describing size of the input buffer.
 307   @param  PlatformInformationRecord2 The pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD2.
 308
 309   @retval EFI_SUCCESS                The data was successfully returned.
 310   @retval EFI_BUFFER_TOO_SMALL       The buffer was too small. The current buffer size needed to
 311                                      hold the record is returned in StructureSize.
 312
 313 **/
 314 EFI_STATUS
 315 EFIAPI
 316 SecPlatformInformation2 (
 317   IN CONST EFI_PEI_SERVICES                   **PeiServices,
 318   IN OUT UINT64                               *StructureSize,
 319      OUT EFI_SEC_PLATFORM_INFORMATION_RECORD2 *PlatformInformationRecord2
 320   );
 321
 322 #endif