uefi-ref/edk2
1
0
Fork 0
mirror of https://github.com/tianocore/edk2 synced 2026-08-27 00:23:19 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

DynamicTablesPkg: Add SSDT BMU table generator

Browse source 
Add Arm namespace objects to describe BMU socket and register
information, including the BMU register range and interrupt descriptor.

Introduce the SSDT BMU generator library and wire it into the
DynamicTables AARCH64 build so the Dynamic Table Factory can register
and use the generator. Also add parser support for the new BMU
Configuration Manager objects and assign a standard ACPI table generator
ID for SSDT BMU generation.

Signed-off-by: Varshit Pandya <varshit.pandya@arm.com>
This commit is contained in:
VarshitPandya 2026-05-13 17:07:46 +01:00 • committed by Varshit Pandya
parent 04679c85b4
commit 08d5ca0091
7 changed files with 816 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

2
DynamicTablesPkg/DynamicTables.dsc.inc
View file

@ -135,6 +135,7 @@
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtCmn600LibArm/SsdtCmn600LibArm.inf
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtDmc620PmuLibArm/SsdtDmc620PmuLibArm.inf
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtBmuLibArm/SsdtBmuLibArm.inf
#
# Dynamic Table Factory Dxe
@ -169,6 +170,7 @@
# Arm specific
NULL|DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtCmn600LibArm/SsdtCmn600LibArm.inf
NULL|DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtDmc620PmuLibArm/SsdtDmc620PmuLibArm.inf
NULL|DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtBmuLibArm/SsdtBmuLibArm.inf
# AML Codegen
# Common

5
DynamicTablesPkg/Include/AcpiTableGenerator.h
View file

@ -91,6 +91,10 @@ The Dynamic Tables Framework implements the following ACPI table generators:
Configuration Manager and builds the HEST table.
- EINJ : The EINJ generator collates the required platform information from
the Configuration Manager and builds the EINJ table.
- SSDT BMU
The SSDT BMU generator collates the BMU specific information
from the Configuration Manager and uses the Dynamic AML CodeGen
API's to build the SSDT BMU table.
*/
/** The ACPI_TABLE_GENERATOR_ID type describes ACPI table generator ID.
@ -133,6 +137,7 @@ typedef enum StdAcpiTableId {
EStdAcpiTableIdHest, ///< Hest Generator
EStdAcpiTableIdEinj, ///< EINJ Generator
EStdAcpiTableIdHmat, ///< HMAT Generator
EStdAcpiTableIdSsdtBmu, ///< SSDT BMU Generator
EStdAcpiTableIdMax
} ESTD_ACPI_TABLE_ID;

34
DynamicTablesPkg/Include/ArmNameSpaceObjects.h
View file

@ -55,6 +55,8 @@ typedef enum ArmObjectID {
EArmObjDmc620PmuRegInfo, ///< 25 - DMC620 PMU Reg Info
EArmObjProcessorSpecificBlockInfo, ///< 26 - Processor Specific Block.
EArmObjProcessorSpecificSubDataArchInfo, ///< 27 - Processor Specific Sub Data (ArchData)
EArmObjBmuSocketInfo, ///< 28 - BMU Socket Info
EArmObjBmuRegInfo, ///< 29 - BMU Reg Info
EArmObjMax
} EARM_OBJECT_ID;
@ -873,4 +875,36 @@ typedef struct CmArmProcessorSpecificSubDataArchInfo {
UINT64 IdAA64Zfr0;
} CM_ARM_PROCESSOR_SPECIFIC_SUB_DATA_ARCH_INFO;
/** A structure that describes the BMU hardware
registers and interrupt.
ID: EArmObjBmuRegInfo
*/
typedef struct CmArmBmuRegInfo {
/// The Base address of BMU register space.
UINT64 BaseAddress;
/// Length of the BMU registers
UINT64 Length;
/// The BMU interrupt descriptor
CM_ARM_EXTENDED_INTERRUPT BmuIntr;
/// TRUE if the BMU interrupt may be shared.
BOOLEAN Shared;
} CM_ARM_BMU_REG_INFO;
/** A structure that describes the BMU hardware
on a socket.
ID: EArmObjBmuSocketInfo
*/
typedef struct CmArmBmuSocketInfo {
/// Number of devices on this socket
UINT8 NumDevices;
/// Array of BMU devices on this socket
CM_OBJECT_TOKEN BmuRegInfoToken;
} CM_ARM_BMU_INFO;
#pragma pack()

694
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtBmuLibArm/SsdtBmuGenerator.c Normal file
View file

@ -0,0 +1,694 @@
/** @file
SSDT BMU AML Table Generator.
Copyright (c) 2026, Arm Limited. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@par Reference(s):
- ACPI for the Arm Components 1.3 Platform Design Document
(https://support.arm.com/documentation/den0093/1-3alp0)
**/
#include <Library/DebugLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/PrintLib.h>
// Module specific include files.
#include <AcpiTableGenerator.h>
#include <ConfigurationManagerHelper.h>
#include <Library/AcpiHelperLib.h>
#include <Library/AmlLib/AmlLib.h>
#include <Protocol/ConfigurationManagerProtocol.h>
#include <Library/TableHelperLib.h>
#include "SsdtBmuGenerator.h"
/** SSDT BMU Table Generator.
Requirements:
The following Configuration Manager Object(s) are required by
this Generator:
- EArmObjBmuSocketInfo
- EArmObjBmuRegInfo
*/
/** This macro expands to a function that retrieves the BMU
Socket Information from the Configuration Manager.
*/
GET_OBJECT_LIST (
EObjNameSpaceArm,
EArmObjBmuSocketInfo,
CM_ARM_BMU_INFO
);
/** This macro expands to a function that retrieves the BMU
Register Information from the Configuration Manager.
*/
GET_OBJECT_LIST (
EObjNameSpaceArm,
EArmObjBmuRegInfo,
CM_ARM_BMU_REG_INFO
);
/** Check the BMU Information for a given socket.
@param [in] BmuRegInfo Array of BMU information structure.
@param [in] DevCount Count of DM devices to validate.
@retval EFI_SUCCESS The function completed successfully.
@retval EFI_INVALID_PARAMETER Invalid parameter.
**/
STATIC
EFI_STATUS
EFIAPI
ValidateBmuInfo (
IN CONST CM_ARM_BMU_REG_INFO *CONST BmuRegInfo,
IN UINT32 DevCount
)
{
UINT32 DevNum;
CONST CM_ARM_BMU_REG_INFO *RegInfo;
CONST CM_ARCH_COMMON_GENERIC_INTERRUPT *BmuIntr;
if ((BmuRegInfo == NULL) || (DevCount == 0)) {
return EFI_INVALID_PARAMETER;
}
for (DevNum = 0; DevNum < DevCount; DevNum++) {
RegInfo = &BmuRegInfo[DevNum];
// Check Base address is initialized
if (RegInfo->BaseAddress == 0) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Invalid BMU Base Address.\n"
));
goto error_handler;
}
if ((RegInfo->Length != BMU_PERIPHBASE_MAX_ADDRESS_LENGTH_1) &&
(RegInfo->Length != BMU_PERIPHBASE_MAX_ADDRESS_LENGTH_2))
{
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Invalid BMU Length.\n"
));
goto error_handler;
}
// The BMU registers start at an offset of 0x80000 and 0xC0000.
// Check that that is so.
if (((RegInfo->BaseAddress & BMU_REGISTER_SPACE_MASK) !=
BMU_ADDRESS_OFFSET_1) &&
((RegInfo->BaseAddress & BMU_REGISTER_SPACE_MASK) !=
BMU_ADDRESS_OFFSET_2))
{
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: BMU Address offset must be 0x80000 or 0xC0000.\n"
));
goto error_handler;
}
BmuIntr = &RegInfo->BmuIntr;
if ((BmuIntr->Flags & BIT0) != 0) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: BMU Interrupt must be Level Triggered.\n"
));
goto error_handler;
}
if ((BmuIntr->Flags & BIT1) != 0) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: BMU Interrupt must be Active High.\n"
));
goto error_handler;
}
}
return EFI_SUCCESS;
error_handler:
ASSERT (FALSE);
DEBUG ((
DEBUG_ERROR,
"BmuBaseAddress = 0x%llx\n"
"BmuBaseAddressLength = 0x%llx\n"
"BmuInterrupt = 0x%lx\n"
"BmuInterruptFlags = 0x%lx\n",
RegInfo->BaseAddress,
RegInfo->Length,
RegInfo->BmuIntr.Interrupt,
RegInfo->BmuIntr.Flags
));
return EFI_INVALID_PARAMETER;
}
/**
Create the _CRS (Current Resource Settings) AML node for the device.
@param [in] BmuRegInfo Pointer to the register info structure.
@param [in] DeviceNode AML device node handle.
@retval EFI_SUCCESS The CRS node was created successfully.
@retval Others Failed to create CRS node.
**/
STATIC
EFI_STATUS
EFIAPI
CreateBmuCrs (
IN CONST CM_ARM_BMU_REG_INFO *CONST BmuRegInfo,
IN AML_OBJECT_NODE_HANDLE DeviceNode
)
{
UINT32 Intr;
UINT64 Length;
UINT64 BaseAddress;
EFI_STATUS Status;
AML_OBJECT_NODE_HANDLE CrsNode;
Status = AmlCodeGenNameResourceTemplate ("_CRS", DeviceNode, &CrsNode);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _CRS Node."
" Status = %r\n",
Status
));
return Status;
}
BaseAddress = BmuRegInfo->BaseAddress;
Length = BmuRegInfo->Length;
Status = AmlCodeGenRdQWordMemory (
TRUE,
TRUE,
TRUE,
TRUE,
AmlMemoryNonCacheable,
TRUE,
0x0,
BaseAddress,
BaseAddress + Length - 1,
0,
Length,
0,
NULL,
0,
TRUE,
CrsNode,
NULL
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-SERIAL-PORT-FIXUP: Failed to create AML QWordMemory Node."
" Status = %r\n",
Status
));
return Status;
}
Intr = BmuRegInfo->BmuIntr.Interrupt;
Status = AmlCodeGenRdInterrupt (
TRUE,
FALSE,
FALSE,
BmuRegInfo->Shared,
&Intr,
1,
CrsNode,
NULL
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-SERIAL-PORT-FIXUP: Failed to create AML Interrupt Node."
" Status = %r\n",
Status
));
return Status;
}
return EFI_SUCCESS;
}
/** Build a SSDT table describing the BMU register space.
Add device nodes describing the BMU register space, one
socket at a time.
@param [in] Uid For this socket, generate UID ids
from this value onward.
@param [in] SockNum Socket number on which devices are
present.
@param [in] DevCount Number of devices on this socket.
@param [in] ScopeNode AML System Bus node handle.
@param [in] BmuRegInfo Array of BMU information structure.
@retval EFI_SUCCESS Device nodes added successfully.
@retval Others Failed to create the device nodes.
**/
STATIC
EFI_STATUS
EFIAPI
BuildBmuSocket (
IN UINT64 Uid,
IN CONST UINT32 SockNum,
IN CONST UINT32 DevCount,
IN CONST AML_OBJECT_NODE_HANDLE ScopeNode,
IN CONST CM_ARM_BMU_REG_INFO *CONST BmuRegInfo
)
{
UINT32 DevNum;
CHAR8 Name[AML_NAME_SEG_SIZE + 1];
CHAR16 Str[32];
EFI_STATUS Status;
AML_OBJECT_NODE_HANDLE DeviceNode;
// Validate the BMU Info and get the number of devices.
Status = ValidateBmuInfo (BmuRegInfo, DevCount);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Invalid BMU information. Status = %r\n",
Status
));
return Status;
}
Name[0] = 'B';
Name[1] = 'C';
Name[4] = '\0';
for (DevNum = 0; DevNum < DevCount; DevNum++, Uid++) {
Name[2] = AsciiFromHex ((Uid >> 4) & 0xF);
Name[3] = AsciiFromHex (Uid & 0xF);
Status = AmlCodeGenDevice (Name, ScopeNode, &DeviceNode);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to create AML Device Node."
" Status = %r\n",
Status
));
return Status;
}
Status = AmlCodeGenNameString (
"_HID",
"ARMHB001",
DeviceNode,
NULL
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _HID Node."
" Status = %r\n",
Status
));
return Status;
}
Status = AmlCodeGenNameInteger ("_UID", Uid, DeviceNode, NULL);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _UID Node."
" Status = %r\n",
Status
));
return Status;
}
UnicodeSPrint (Str, sizeof (Str), L"Socket %u: BMU%u", SockNum, DevNum);
Status = AmlCodeGenNameUnicodeString (
"_STR",
Str,
DeviceNode,
NULL
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _STR Node."
" Status = %r\n",
Status
));
return Status;
}
Status = AmlCodeGenMethodRetInteger (
"_STA",
0x0F,
0,
FALSE,
0,
DeviceNode,
NULL
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _STA Node."
" Status = %r\n",
Status
));
return Status;
}
Status = CreateBmuCrs (&BmuRegInfo[DevNum], DeviceNode);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to create AML _CRS Node."
" Status = %r\n",
Status
));
return Status;
}
}
return EFI_SUCCESS;
}
/** Construct SSDT tables for describing BMU interface.
This function invokes the Configuration Manager protocol interface
to get the required hardware information for generating the ACPI
table.
If this function allocates any resources then they must be freed
in the FreeXXXXTableRes function.
@param [in] This Pointer to the ACPI table generator.
@param [in] AcpiTableInfo Pointer to the ACPI table information.
@param [in] CfgMgrProtocol Pointer to the Configuration Manager
Protocol interface.
@param [out] Table Pointer to the generated ACPI table.
@retval EFI_SUCCESS Table generated successfully.
@retval EFI_INVALID_PARAMETER A parameter is invalid.
@retval EFI_UNSUPPORTED Unsupported configuration.
**/
STATIC
EFI_STATUS
EFIAPI
BuildSsdtBmuTable (
IN CONST ACPI_TABLE_GENERATOR *This,
IN CONST CM_STD_OBJ_ACPI_TABLE_INFO *CONST AcpiTableInfo,
IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL *CONST CfgMgrProtocol,
OUT EFI_ACPI_DESCRIPTION_HEADER **Table
)
{
AML_ROOT_NODE_HANDLE RootNode;
AML_OBJECT_NODE_HANDLE ScopeNode;
EFI_STATUS Status;
EFI_STATUS Status1;
UINT64 Uid;
UINT32 DevCount;
UINT32 SockNum;
UINT32 SocketCount;
CM_ARM_BMU_REG_INFO *BmuRegInfo;
CM_ARM_BMU_INFO *BmuSockInfo;
ASSERT (This != NULL);
ASSERT (AcpiTableInfo != NULL);
ASSERT (CfgMgrProtocol != NULL);
ASSERT (Table != NULL);
ASSERT (AcpiTableInfo->TableGeneratorId == This->GeneratorID);
ASSERT (AcpiTableInfo->AcpiTableSignature == This->AcpiTableSignature);
*Table = NULL;
Status = GetEArmObjBmuSocketInfo (
CfgMgrProtocol,
CM_NULL_TOKEN,
&BmuSockInfo,
&SocketCount
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to get the BMU Socket information."
" Status = %r\n",
Status
));
return Status;
}
if (SocketCount == 0) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Invalid BMU Socket information.\n"
));
return EFI_INVALID_PARAMETER;
}
Status = AmlCodeGenDefinitionBlock (
"SSDT",
"ARMLTD",
"BMU",
0x01,
&RootNode
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to create AML Definition Block."
" Status = %r\n",
Status
));
ASSERT_EFI_ERROR (Status);
return Status;
}
Status = AmlCodeGenScope ("\\_SB_", RootNode, &ScopeNode);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to create AML Scope Node."
" Status = %r\n",
Status
));
goto error_handler;
}
Uid = 0;
for (SockNum = 0; SockNum < SocketCount; SockNum++) {
DevCount = 0;
Status = GetEArmObjBmuRegInfo (
CfgMgrProtocol,
BmuSockInfo[SockNum].BmuRegInfoToken,
&BmuRegInfo,
&DevCount
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to get the BMU per socket device information.\n"
" Status = %r\n",
Status
));
ASSERT_EFI_ERROR (Status);
goto error_handler;
}
if ((DevCount == 0) || (BmuSockInfo[SockNum].NumDevices != DevCount)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Invalid BMU device information.\n"
));
ASSERT_EFI_ERROR (Status);
Status = EFI_INVALID_PARAMETER;
goto error_handler;
}
Status = BuildBmuSocket (
Uid,
SockNum,
DevCount,
ScopeNode,
BmuRegInfo
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to build table for BMU."
" Status = %r\n",
Status
));
goto error_handler;
}
Uid += DevCount;
}
// Serialize the tree.
Status = AmlSerializeDefinitionBlock (
RootNode,
Table
);
if (EFI_ERROR (Status)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU: Failed to Serialize SSDT Table Data."
" Status = %r\n",
Status
));
goto error_handler;
}
return EFI_SUCCESS;
error_handler:
if (RootNode != NULL) {
Status1 = AmlDeleteTree (RootNode);
if (EFI_ERROR (Status1)) {
DEBUG ((
DEBUG_ERROR,
"ERROR: SSDT-BMU-AML-CODEGEN: Failed to cleanup AML tree."
" Status = %r\n",
Status1
));
}
}
return Status;
}
/** Free any resources allocated for constructing the SSDT tables for BMU.
@param [in] This Pointer to the ACPI table generator.
@param [in] AcpiTableInfo Pointer to the ACPI Table Info.
@param [in] CfgMgrProtocol Pointer to the Configuration Manager
Protocol Interface.
@param [in, out] Table Pointer to ACPI Table.
@retval EFI_SUCCESS The resources were freed successfully.
@retval EFI_INVALID_PARAMETER The table pointer is NULL or invalid.
**/
STATIC
EFI_STATUS
EFIAPI
FreeSsdtBmuTableRes (
IN CONST ACPI_TABLE_GENERATOR *CONST This,
IN CONST CM_STD_OBJ_ACPI_TABLE_INFO *CONST AcpiTableInfo,
IN CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL *CONST CfgMgrProtocol,
IN OUT EFI_ACPI_DESCRIPTION_HEADER **CONST Table
)
{
ASSERT (This != NULL);
ASSERT (AcpiTableInfo != NULL);
ASSERT (CfgMgrProtocol != NULL);
ASSERT (AcpiTableInfo->TableGeneratorId == This->GeneratorID);
ASSERT (AcpiTableInfo->AcpiTableSignature == This->AcpiTableSignature);
if ((Table == NULL) || (*Table == NULL)) {
DEBUG ((DEBUG_ERROR, "ERROR: SSDT-BMU: Invalid Table Pointer\n"));
ASSERT ((Table != NULL) && (*Table != NULL));
return EFI_INVALID_PARAMETER;
}
FreePool (*Table);
*Table = NULL;
return EFI_SUCCESS;
}
/** This macro defines the Raw Generator revision.
*/
#define SSDT_BMU_GENERATOR_REVISION CREATE_REVISION (1, 0)
/** The interface for the Raw Table Generator.
*/
STATIC
CONST
ACPI_TABLE_GENERATOR SsdtBmuGenerator = {
// Generator ID
CREATE_STD_ACPI_TABLE_GEN_ID (EStdAcpiTableIdSsdtBmu),
// Generator Description
L"ACPI.STD.SSDT.BMU.GENERATOR",
// ACPI Table Signature
EFI_ACPI_6_6_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE,
// ACPI Table Revision - Unused
0,
// Minimum ACPI Table Revision - Unused
0,
// Creator ID
TABLE_GENERATOR_CREATOR_ID_ARM,
// Creator Revision
SSDT_BMU_GENERATOR_REVISION,
// Build table function.
BuildSsdtBmuTable,
// Free table function.
FreeSsdtBmuTableRes,
// Build Table function. Extended version not needed.
NULL,
// Free Resource function. Extended version not needed.
NULL
};
/** Register the Generator with the ACPI Table Factory.
@param [in] ImageHandle The handle to the image.
@param [in] SystemTable Pointer to the System Table.
@retval EFI_SUCCESS The Generator is registered.
@retval EFI_INVALID_PARAMETER A parameter is invalid.
@retval EFI_ALREADY_STARTED The Generator for the Table ID
is already registered.
**/
EFI_STATUS
EFIAPI
AcpiSsdtBmuConstructor (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
Status = RegisterAcpiTableGenerator (&SsdtBmuGenerator);
DEBUG ((
DEBUG_INFO,
"SSDT-BMU: Register Generator. Status = %r\n",
Status
));
ASSERT_EFI_ERROR (Status);
return Status;
}
/** Deregister the Generator from the ACPI Table Factory.
@param [in] ImageHandle The handle to the image.
@param [in] SystemTable Pointer to the System Table.
@retval EFI_SUCCESS The Generator is deregistered.
@retval EFI_INVALID_PARAMETER A parameter is invalid.
@retval EFI_NOT_FOUND The Generator is not registered.
**/
EFI_STATUS
EFIAPI
AcpiSsdtBmuDestructor (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
{
EFI_STATUS Status;
Status = DeregisterAcpiTableGenerator (&SsdtBmuGenerator);
DEBUG ((
DEBUG_INFO,
"SSDT-BMU: Deregister Generator. Status = %r\n",
Status
));
ASSERT_EFI_ERROR (Status);
return Status;
}

31
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtBmuLibArm/SsdtBmuGenerator.h Normal file
View file

@ -0,0 +1,31 @@
/** @file
Copyright (c) 2025, Arm Limited. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@par Glossary:
- Cm or CM - Configuration Manager
- Obj or OBJ - Object
- Std or STD - Standard
@par Reference(s):
- ACPI for the Arm Components 1.3 Platform Design Document
(https://support.arm.com/documentation/den0093/1-3alp0)
**/
#pragma once
/** PeriphBase maximum address length is 192 KiB or 256 KiB (0x30000 or 0x40000)
*/
#define BMU_PERIPHBASE_MAX_ADDRESS_LENGTH_1 0x30000
#define BMU_PERIPHBASE_MAX_ADDRESS_LENGTH_2 0x40000
/** Mask covering the BMU Address space
*/
#define BMU_REGISTER_SPACE_MASK 0xFFFFF
/** Offset of the BMU registers in the BMU register space
*/
#define BMU_ADDRESS_OFFSET_1 0x80000
#define BMU_ADDRESS_OFFSET_2 0xC0000

31
DynamicTablesPkg/Library/Acpi/Arm/AcpiSsdtBmuLibArm/SsdtBmuLibArm.inf Normal file
View file

@ -0,0 +1,31 @@
## @file
# Ssdt BMU Table Generator
#
# Copyright (c) 2025, Arm Limited. All rights reserved.<BR>
#
# SPDX-License-Identifier: BSD-2-Clause-Patent
##
[Defines]
INF_VERSION = 0x0001001B
BASE_NAME = SsdtBmuLibArm
FILE_GUID = 7f3b5aae-63c5-4efd-96c0-91937447845e
VERSION_STRING = 1.0
MODULE_TYPE = DXE_DRIVER
LIBRARY_CLASS = NULL|DXE_DRIVER
CONSTRUCTOR = AcpiSsdtBmuConstructor
DESTRUCTOR = AcpiSsdtBmuDestructor
[Sources]
SsdtBmuGenerator.c
SsdtBmuGenerator.h
[Packages]
DynamicTablesPkg/DynamicTablesPkg.dec
MdeModulePkg/MdeModulePkg.dec
MdePkg/MdePkg.dec
[LibraryClasses]
AcpiHelperLib
AmlLib
BaseLib

19
DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.c
View file

@ -434,6 +434,23 @@ STATIC CONST CM_OBJ_PARSER CmArmDmc620PmuRegInfoParser[] = {
ARRAY_SIZE (CmArchCommonGenericInterruptParser) },
};
/** A parser for EArmObjBmuSocketInfo.
*/
STATIC CONST CM_OBJ_PARSER CmArmObjBmuSocketInfoParser[] = {
{ "NumDevices", 1, "0x%x", NULL },
{ "BmuRegInfoToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL },
};
/** A parser for EArmObjBmuRegInfo.
*/
STATIC CONST CM_OBJ_PARSER CmArmBmuRegInfoParser[] = {
{ "BaseAddress", 8, "0x%llx", NULL },
{ "Length", 8, "0x%llx", NULL },
{ "BmuIntr.Interrupt", 4, "0x%x", NULL },
{ "BmuIntr.Flags", 4, "0x%x", NULL },
{ "Shared", sizeof (BOOLEAN), "0x%x", NULL },
};
/** A parser for EArmObjCmn600Info.
*/
STATIC CONST CM_OBJ_PARSER CmArmCmn600InfoParser[] = {
@ -1532,6 +1549,8 @@ STATIC CONST CM_OBJ_PARSER_ARRAY ArmNamespaceObjectParser[] = {
CM_PARSER_ADD_OBJECT (EArmObjEtInfo, CmArmEtInfo),
CM_PARSER_ADD_OBJECT (EArmObjDmc620PmuSocketInfo, CmArmDmc620PmuSocketInfoParser),
CM_PARSER_ADD_OBJECT (EArmObjDmc620PmuRegInfo, CmArmDmc620PmuRegInfoParser),
CM_PARSER_ADD_OBJECT (EArmObjBmuSocketInfo, CmArmObjBmuSocketInfoParser),
CM_PARSER_ADD_OBJECT (EArmObjBmuRegInfo, CmArmBmuRegInfoParser),
CM_PARSER_ADD_OBJECT_RESERVED (EArmObjMax)
};