123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150 |
- /** @file
- PEI Services Table Pointer Library.
- This library is used for PEIM which does executed from flash device directly but
- executed in memory.
- Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
- Portiions copyrigth (c) 2011, Apple Inc. All rights reserved.
- SPDX-License-Identifier: BSD-2-Clause-Patent
- **/
- #include <PiPei.h>
- #include <Library/PeiServicesTablePointerLib.h>
- #include <Library/DebugLib.h>
- #include <Ppi/MemoryDiscovered.h>
- CONST EFI_PEI_SERVICES **gPeiServices = NULL;
- /**
- Caches a pointer PEI Services Table.
- Caches the pointer to the PEI Services Table specified by PeiServicesTablePointer
- in a CPU specific manner as specified in the CPU binding section of the Platform Initialization
- Pre-EFI Initialization Core Interface Specification.
- If PeiServicesTablePointer is NULL, then ASSERT().
- @param PeiServicesTablePointer The address of PeiServices pointer.
- **/
- VOID
- EFIAPI
- SetPeiServicesTablePointer (
- IN CONST EFI_PEI_SERVICES **PeiServicesTablePointer
- )
- {
- ASSERT (PeiServicesTablePointer != NULL);
- ASSERT (*PeiServicesTablePointer != NULL);
- gPeiServices = PeiServicesTablePointer;
- }
- /**
- Retrieves the cached value of the PEI Services Table pointer.
- Returns the cached value of the PEI Services Table pointer in a CPU specific manner
- as specified in the CPU binding section of the Platform Initialization Pre-EFI
- Initialization Core Interface Specification.
- If the cached PEI Services Table pointer is NULL, then ASSERT().
- @return The pointer to PeiServices.
- **/
- CONST EFI_PEI_SERVICES **
- EFIAPI
- GetPeiServicesTablePointer (
- VOID
- )
- {
- ASSERT (gPeiServices != NULL);
- ASSERT (*gPeiServices != NULL);
- return gPeiServices;
- }
- /**
- Notification service to be called when gEmuThunkPpiGuid is installed.
- @param PeiServices Indirect reference to the PEI Services Table.
- @param NotifyDescriptor Address of the notification descriptor data structure. Type
- EFI_PEI_NOTIFY_DESCRIPTOR is defined above.
- @param Ppi Address of the PPI that was installed.
- @retval EFI_STATUS This function will install a PPI to PPI database. The status
- code will be the code for (*PeiServices)->InstallPpi.
- **/
- EFI_STATUS
- EFIAPI
- PeiServicesTablePointerNotifyCallback (
- IN EFI_PEI_SERVICES **PeiServices,
- IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor,
- IN VOID *Ppi
- )
- {
- gPeiServices = (CONST EFI_PEI_SERVICES **)PeiServices;
- return EFI_SUCCESS;
- }
- EFI_PEI_NOTIFY_DESCRIPTOR mNotifyOnThunkList = {
- (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
- &gEfiPeiMemoryDiscoveredPpiGuid,
- PeiServicesTablePointerNotifyCallback
- };
- /**
- Constructor register notification on when PPI updates. If PPI is
- alreay installed registering the notify will cause the handle to
- run.
- @param FileHandle The handle of FFS header the loaded driver.
- @param PeiServices The pointer to the PEI services.
- @retval EFI_SUCCESS The constructor always returns EFI_SUCCESS.
- **/
- EFI_STATUS
- EFIAPI
- PeiServicesTablePointerLibConstructor (
- IN EFI_PEI_FILE_HANDLE FileHandle,
- IN CONST EFI_PEI_SERVICES **PeiServices
- )
- {
- EFI_STATUS Status;
- gPeiServices = (CONST EFI_PEI_SERVICES **)PeiServices;
- // register to be told when PeiServices pointer is updated
- Status = (*PeiServices)->NotifyPpi (PeiServices, &mNotifyOnThunkList);
- ASSERT_EFI_ERROR (Status);
- return Status;
- }
- /**
- Perform CPU specific actions required to migrate the PEI Services Table
- pointer from temporary RAM to permanent RAM.
- For IA32 CPUs, the PEI Services Table pointer is stored in the 4 bytes
- immediately preceding the Interrupt Descriptor Table (IDT) in memory.
- For X64 CPUs, the PEI Services Table pointer is stored in the 8 bytes
- immediately preceding the Interrupt Descriptor Table (IDT) in memory.
- For Itanium and ARM CPUs, a the PEI Services Table Pointer is stored in
- a dedicated CPU register. This means that there is no memory storage
- associated with storing the PEI Services Table pointer, so no additional
- migration actions are required for Itanium or ARM CPUs.
- **/
- VOID
- EFIAPI
- MigratePeiServicesTablePointer (
- VOID
- )
- {
- //
- // PEI Services Table pointer is cached in the global variable. No additional
- // migration actions are required.
- //
- return;
- }
|