PrmPkg: Add initial PrmSsdtInstallDxe module

Adds a new module that installs a PRM SSDT.

Note: A library class would allow a high degree of flexibility for
platforms that choose:
  1. To not install a PRM SSDT at all (using a NULL library instance)
  2. To install a specific PRM SSDT implementation

However, it is implemented as a driver since build tools are not
linking ACPI tables to drivers from linked library classes.

Cc: Andrew Fish <afish@apple.com>
Cc: Kang Gao <kang.gao@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Michael Kubacki <michael.kubacki@microsoft.com>
Cc: Leif Lindholm <leif@nuviainc.com>
Cc: Benjamin You <benjamin.you@intel.com>
Cc: Liu Yun <yun.y.liu@intel.com>
Cc: Ankit Sinha <ankit.sinha@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
Acked-by: Michael D Kinney <michael.d.kinney@intel.com>
Acked-by: Liming Gao <gaoliming@byosoft.com.cn>
Acked-by: Leif Lindholm <quic_llindhol@quicinc.com>
Reviewed-by: Ankit Sinha <ankit.sinha@intel.com>
This commit is contained in:
Michael Kubacki
2020-05-20 10:56:03 -07:00
committed by mergify[bot]
parent f96517f4d0
commit 50e1432a40
6 changed files with 171 additions and 51 deletions

View File

@@ -0,0 +1,110 @@
/** @file
This file contains a sample implementation of the Platform Runtime Mechanism (PRM)
SSDT Install library.
Copyright (c) Microsoft Corporation
Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#include <IndustryStandard/Acpi.h>
#include <Library/BaseLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/DebugLib.h>
#include <Library/DxeServicesLib.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Protocol/AcpiTable.h>
#define _DBGMSGID_ "[PRMSSDTINSTALL]"
/**
Installs the PRM SSDT.
@param[in] OemId OEM ID to be used in the SSDT installation.
@retval EFI_SUCCESS The PRM SSDT was installed successfully.
@retval EFI_INVALID_PARAMETER The OemId pointer argument is NULL.
@retval EFI_NOT_FOUND An instance of gEfiAcpiTableProtocolGuid was not found installed or
the SSDT (AML RAW section) could not be found in the current FV.
@retval EFI_OUT_OF_RESOURCES Insufficient memory resources to install the PRM SSDT.
**/
EFI_STATUS
InstallPrmSsdt (
IN CONST UINT8 *OemId
)
{
EFI_STATUS Status;
UINTN SsdtSize;
UINTN TableKey;
EFI_ACPI_TABLE_PROTOCOL *AcpiTableProtocol;
EFI_ACPI_DESCRIPTION_HEADER *Ssdt;
DEBUG ((DEBUG_INFO, "%a %a - Entry.\n", _DBGMSGID_, __FUNCTION__));
if (OemId == NULL) {
return EFI_INVALID_PARAMETER;
}
Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID **) &AcpiTableProtocol);
if (!EFI_ERROR (Status)) {
//
// Discover the SSDT
//
Status = GetSectionFromFv (
&gEfiCallerIdGuid,
EFI_SECTION_RAW,
0,
(VOID **) &Ssdt,
&SsdtSize
);
ASSERT_EFI_ERROR (Status);
DEBUG ((DEBUG_INFO, "%a %a: SSDT loaded...\n", _DBGMSGID_, __FUNCTION__));
//
// Update OEM ID in the SSDT
//
CopyMem (&Ssdt->OemId, OemId, sizeof (Ssdt->OemId));
//
// Publish the SSDT. Table is re-checksummed.
//
TableKey = 0;
Status = AcpiTableProtocol->InstallAcpiTable (
AcpiTableProtocol,
Ssdt,
SsdtSize,
&TableKey
);
ASSERT_EFI_ERROR (Status);
}
return Status;
}
/**
The entry point for this module.
@param[in] ImageHandle The firmware allocated handle for the EFI image.
@param[in] SystemTable A pointer to the EFI System Table.
@retval EFI_SUCCESS The entry point is executed successfully.
@retval Others An error occurred when executing this entry point.
**/
EFI_STATUS
EFIAPI
PrmSsdtInstallEntryPoint (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
Status = InstallPrmSsdt ((UINT8 *) PcdGetPtr (PcdAcpiDefaultOemId));
ASSERT_EFI_ERROR (Status);
return Status;
}