public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "PierreGondois" <pierre.gondois@arm.com>
To: devel@edk2.groups.io, Sami Mujawar <sami.mujawar@arm.com>,
	Alexei.Fedorov@arm.com, Joey Gouly <joey.gouly@arm.com>
Subject: [PATCH v2 06/10] DynamicTablesPkg: Add Configuration Manager Object parser
Date: Thu, 30 Sep 2021 08:48:17 +0100	[thread overview]
Message-ID: <20210930074821.12546-7-Pierre.Gondois@arm.com> (raw)
In-Reply-To: <20210930074821.12546-1-Pierre.Gondois@arm.com>

From: Sami Mujawar <sami.mujawar@arm.com>

The Platform information repository in the Configuration Manager
may be dynamically populated, for e.g. by a Hardware Information
Parser like FdtHwInfoParser. In such cases it is useful to trace
the CM objects that were populated by the parser.

Therefore, introduce helper functions that can parse and trace
the Configuration Manager Objects.

Reviewed-by: Joey Gouly <joey.gouly@arm.com>
Signed-off-by: Sami Mujawar <sami.mujawar@arm.com>
Signed-off-by: Pierre Gondois <Pierre.Gondois@arm.com>
---

Notes:
    v2:
    - Changed wrong field name: GTBlockTimerFrameToken to Token. [Joey]

 .../Include/Library/TableHelperLib.h          |  10 +
 .../ConfigurationManagerObjectParser.c        | 678 ++++++++++++++++++
 .../ConfigurationManagerObjectParser.h        |  73 ++
 .../Common/TableHelperLib/TableHelperLib.inf  |   2 +
 4 files changed, 763 insertions(+)
 create mode 100644 DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.c
 create mode 100644 DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.h

diff --git a/DynamicTablesPkg/Include/Library/TableHelperLib.h b/DynamicTablesPkg/Include/Library/TableHelperLib.h
index 57af51134546..6d362ff99a27 100644
--- a/DynamicTablesPkg/Include/Library/TableHelperLib.h
+++ b/DynamicTablesPkg/Include/Library/TableHelperLib.h
@@ -107,4 +107,14 @@ FindDuplicateValue (
   IN        PFN_IS_EQUAL    EqualTestFunction
   );
 
+/** Parse and print a CmObjDesc.
+
+  @param [in]  CmObjDesc  The CmObjDesc to parse and print.
+**/
+VOID
+EFIAPI
+ParseCmObjDesc (
+  IN  CONST CM_OBJ_DESCRIPTOR * CmObjDesc
+  );
+
 #endif // TABLE_HELPER_LIB_H_
diff --git a/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.c b/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.c
new file mode 100644
index 000000000000..ee2918ab5cc6
--- /dev/null
+++ b/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.c
@@ -0,0 +1,678 @@
+/** @file
+  Configuration Manager Object parser.
+
+  Copyright (c) 2021, ARM Limited. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <ConfigurationManagerObject.h>
+#include "ConfigurationManagerObjectParser.h"
+
+STATIC
+VOID
+EFIAPI
+PrintOemId (
+  CONST CHAR8* Format,
+  UINT8* Ptr
+  );
+
+/** A parser for EArmObjBootArchInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmBootArchInfoParser[] = {
+  {"BootArchFlags", 2, "0x%x", NULL}
+};
+
+/** A parser for EArmObjPowerManagementProfileInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmPowerManagementProfileInfoParser[] = {
+  {"PowerManagementProfile", 1, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGicCInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicCInfoParser[] = {
+  {"CPUInterfaceNumber", 4, "0x%x", NULL},
+  {"AcpiProcessorUid", 4, "0x%x", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"ParkingProtocolVersion", 4, "0x%x", NULL},
+  {"PerformanceInterruptGsiv", 4, "0x%x", NULL},
+  {"ParkedAddress", 8, "0x%llx", NULL},
+  {"PhysicalBaseAddress", 8, "0x%llx", NULL},
+  {"GICV", 8, "0x%llx", NULL},
+  {"GICH", 8, "0x%llx", NULL},
+  {"VGICMaintenanceInterrupt", 4, "0x%x", NULL},
+  {"GICRBaseAddress", 8, "0x%llx", NULL},
+  {"MPIDR", 8, "0x%llx", NULL},
+  {"ProcessorPowerEfficiencyClass", 1, "0x%x", NULL},
+  {"SpeOverflowInterrupt", 2, "0x%x", NULL},
+  {"ProximityDomain", 4, "0x%x", NULL},
+  {"ClockDomain", 4, "0x%x", NULL},
+  {"AffinityFlags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGicDInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicDInfoParser[] = {
+  {"PhysicalBaseAddress", 8, "0x%llx", NULL},
+  {"SystemVectorBase", 4, "0x%x", NULL},
+  {"GicVersion", 1, "0x%x", NULL},
+};
+
+/** A parser for EArmObjGicMsiFrameInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicMsiFrameInfoParser[] = {
+  {"GicMsiFrameId", 4, "0x%x", NULL},
+  {"PhysicalBaseAddress", 8, "0x%llx", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"SPICount", 2, "0x%x", NULL},
+  {"SPIBase", 2, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGicRedistributorInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicRedistInfoParser[] = {
+  {"DiscoveryRangeBaseAddress", 8, "0x%llx", NULL},
+  {"DiscoveryRangeLength", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGicItsInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicItsInfoParser[] = {
+  {"GicItsId", 4, "0x%x", NULL},
+  {"PhysicalBaseAddress", 8, "0x%llx", NULL},
+  {"ProximityDomain", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjSerialConsolePortInfo,
+    EArmObjSerialDebugPortInfo and EArmObjSerialPortInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmSerialPortInfoParser[] = {
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"Interrupt", 4, "0x%x", NULL},
+  {"BaudRate", 8, "0x%llx", NULL},
+  {"Clock", 4, "0x%x", NULL},
+  {"PortSubtype", 2, "0x%x", NULL},
+  {"BaseAddressLength", 8, "0x%llx", NULL},
+  {"AccessSize", 1, "0x%d", NULL}
+};
+
+/** A parser for EArmObjGenericTimerInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGenericTimerInfoParser[] = {
+  {"CounterControlBaseAddress", 8, "0x%llx", NULL},
+  {"CounterReadBaseAddress", 8, "0x%llx", NULL},
+  {"SecurePL1TimerGSIV", 4, "0x%x", NULL},
+  {"SecurePL1TimerFlags", 4, "0x%x", NULL},
+  {"NonSecurePL1TimerGSIV", 4, "0x%x", NULL},
+  {"NonSecurePL1TimerFlags", 4, "0x%x", NULL},
+  {"VirtualTimerGSIV", 4, "0x%x", NULL},
+  {"VirtualTimerFlags", 4, "0x%x", NULL},
+  {"NonSecurePL2TimerGSIV", 4, "0x%x", NULL},
+  {"NonSecurePL2TimerFlags", 4, "0x%x", NULL},
+  {"VirtualPL2TimerGSIV", 4, "0x%x", NULL},
+  {"VirtualPL2TimerFlags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjPlatformGTBlockInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGTBlockTimerFrameInfoParser[] = {
+  {"FrameNumber", 1, "0x%x", NULL},
+  {"PhysicalAddressCntBase", 8, "0x%llx", NULL},
+  {"PhysicalAddressCntEL0Base", 8, "0x%llx", NULL},
+  {"PhysicalTimerGSIV", 4, "0x%x", NULL},
+  {"PhysicalTimerFlags", 4, "0x%x", NULL},
+  {"VirtualTimerGSIV", 4, "0x%x", NULL},
+  {"VirtualTimerFlags", 4, "0x%x", NULL},
+  {"CommonFlags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGTBlockTimerFrameInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGTBlockInfoParser[] = {
+  {"GTBlockPhysicalAddress", 8, "0x%llx", NULL},
+  {"GTBlockTimerFrameCount", 4, "0x%x", NULL},
+  {"GTBlockTimerFrameToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjPlatformGenericWatchdogInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGenericWatchdogInfoParser[] = {
+  {"ControlFrameAddress", 8, "0x%llx", NULL},
+  {"RefreshFrameAddress", 8, "0x%llx", NULL},
+  {"TimerGSIV", 4, "0x%x", NULL},
+  {"Flags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjPciConfigSpaceInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmPciConfigSpaceInfoParser[] = {
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"PciSegmentGroupNumber", 2, "0x%x", NULL},
+  {"StartBusNumber", 1, "0x%x", NULL},
+  {"EndBusNumber", 1, "0x%x", NULL}
+};
+
+/** A parser for EArmObjHypervisorVendorIdentity.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmHypervisorVendorIdParser[] = {
+  {"HypervisorVendorId", 8, "0x%llx", NULL}
+};
+
+/** A parser for EArmObjFixedFeatureFlags.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmFixedFeatureFlagsParser[] = {
+  {"Flags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjItsGroup.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmItsGroupNodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"ItsIdCount", 4, "0x%x", NULL},
+  {"ItsIdToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjNamedComponent.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmNamedComponentNodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"IdMappingCount", 4, "0x%x", NULL},
+  {"IdMappingToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"CacheCoherent", 4, "0x%x", NULL},
+  {"AllocationHints", 1, "0x%x", NULL},
+  {"MemoryAccessFlags", 1, "0x%x", NULL},
+  {"AddressSizeLimit", 1, "0x%x", NULL},
+  {"ObjectName", sizeof (CHAR8*), "%a", NULL}
+};
+
+/** A parser for EArmObjRootComplex.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmRootComplexNodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"IdMappingCount", 4, "0x%x", NULL},
+  {"IdMappingToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"CacheCoherent", 4, "0x%x", NULL},
+  {"AllocationHints", 1, "0x%x", NULL},
+  {"MemoryAccessFlags", 1, "0x%x", NULL},
+  {"AtsAttribute", 4, "0x%x", NULL},
+  {"PciSegmentNumber", 4, "0x%x", NULL},
+  {"MemoryAddressSize", 1, "0x%x", NULL}
+};
+
+/** A parser for EArmObjSmmuV1SmmuV2.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmSmmuV1SmmuV2NodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"IdMappingCount", 4, "0x%x", NULL},
+  {"IdMappingToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"Span", 8, "0x%llx", NULL},
+  {"Model", 4, "0x%x", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"ContextInterruptCount", 4, "0x%x", NULL},
+  {"ContextInterruptToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"PmuInterruptCount", 4, "0x%x", NULL},
+  {"PmuInterruptToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"SMMU_NSgIrpt", 4, "0x%x", NULL},
+  {"SMMU_NSgIrptFlags", 4, "0x%x", NULL},
+  {"SMMU_NSgCfgIrpt", 4, "0x%x", NULL},
+  {"SMMU_NSgCfgIrptFlags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjSmmuV3.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmSmmuV3NodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"IdMappingCount", 4, "0x%x", NULL},
+  {"IdMappingToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"VatosAddress", 8, "0x%llx", NULL},
+  {"Model", 4, "0x%x", NULL},
+  {"EventInterrupt", 4, "0x%x", NULL},
+  {"PriInterrupt", 4, "0x%x", NULL},
+  {"GerrInterrupt", 4, "0x%x", NULL},
+  {"SyncInterrupt", 4, "0x%x", NULL},
+  {"ProximityDomain", 4, "0x%x", NULL},
+  {"DeviceIdMappingIndex", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjPmcg.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmPmcgNodeParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"IdMappingCount", 4, "0x%x", NULL},
+  {"IdMappingToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"OverflowInterrupt", 4, "0x%x", NULL},
+  {"Page1BaseAddress", 8, "0x%llx", NULL},
+  {"ReferenceToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjGicItsIdentifierArray.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGicItsIdentifierParser[] = {
+  {"ItsId", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjIdMappingArray.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmIdMappingParser[] = {
+  {"InputBase", 4, "0x%x", NULL},
+  {"NumIds", 4, "0x%x", NULL},
+  {"OutputBase", 4, "0x%x", NULL},
+  {"OutputReferenceToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"Flags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjSmmuInterruptArray.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGenericInterruptParser[] = {
+  {"Interrupt", 4, "0x%x", NULL},
+  {"Flags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjProcHierarchyInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmProcHierarchyInfoParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"ParentToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"GicCToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"NoOfPrivateResources", 4, "0x%x", NULL},
+  {"PrivateResourcesArrayToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjCacheInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmCacheInfoParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"NextLevelOfCacheToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"Size", 4, "0x%x", NULL},
+  {"NumberOfSets", 4, "0x%x", NULL},
+  {"Associativity", 4, "0x%x", NULL},
+  {"Attributes", 1, "0x%x", NULL},
+  {"LineSize", 2, "0x%x", NULL}
+};
+
+/** A parser for EArmObjProcNodeIdInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmProcNodeIdInfoParser[] = {
+  {"Token", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL},
+  {"VendorId", 4, "0x%p", NULL},
+  {"Level1Id", 8, "0x%x", NULL},
+  {"Level2Id", 8, "0x%x", NULL},
+  {"MajorRev", 2, "0x%x", NULL},
+  {"MinorRev", 2, "0x%x", NULL},
+  {"SpinRev", 2, "0x%x", NULL}
+};
+
+/** A parser for EArmObjCmRef.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmObjRefParser[] = {
+  {"ReferenceToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjMemoryAffinityInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmMemoryAffinityInfoParser[] = {
+  {"ProximityDomain", 4, "0x%x", NULL},
+  {"BaseAddress", 8, "0x%llx", NULL},
+  {"Length", 8, "0x%llx", NULL},
+  {"Flags", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjDeviceHandleAcpi.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmDeviceHandleAcpiParser[] = {
+  {"Hid", 8, "0x%llx", NULL},
+  {"Uid", 4, "0x%x", NULL}
+};
+
+/** A parser for EArmObjDeviceHandlePci.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmDeviceHandlePciParser[] = {
+  {"SegmentNumber", 2, "0x%x", NULL},
+  {"BusNumber", 1, "0x%x", NULL},
+  {"DeviceNumber", 1, "0x%x", NULL},
+  {"FunctionNumber", 1, "0x%x", NULL}
+};
+
+/** A parser for EArmObjGenericInitiatorAffinityInfo.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmGenericInitiatorAffinityInfoParser[] = {
+  {"ProximityDomain", 4, "0x%x", NULL},
+  {"Flags", 4, "0x%x", NULL},
+  {"DeviceHandleType", 1, "0x%x", NULL},
+  {"DeviceHandleToken", sizeof (CM_OBJECT_TOKEN), "0x%p", NULL}
+};
+
+/** A parser for EArmObjCmn600Info.
+*/
+STATIC CONST CM_OBJ_PARSER CmArmCmn600InfoParser[] = {
+  {"PeriphBaseAddress", 8, "0x%llx", NULL},
+  {"PeriphBaseAddressLength", 8, "0x%llx", NULL},
+  {"RootNodeBaseAddress", 8, "0x%llx", NULL},
+  {"DtcCount", 1, "0x%x", NULL},
+  {"DtcInterrupt[0]", 4, "0x%x", NULL},
+  {"DtcFlags[0]", 4, "0x%x", NULL},
+  {"DtcInterrupt[1]", 4, "0x%x", NULL},
+  {"DtcFlags[1]", 4, "0x%x", NULL},
+  {"DtcInterrupt[2]", 4, "0x%x", NULL},
+  {"DtcFlags[2]", 4, "0x%x", NULL},
+  {"DtcInterrupt[3]", 4, "0x%x", NULL},
+  {"DtcFlags[3]", 4, "0x%x", NULL}
+};
+
+/** A parser for Arm namespace objects.
+*/
+STATIC CONST CM_OBJ_PARSER_ARRAY ArmNamespaceObjectParser[] = {
+  {"EArmObjReserved", NULL, 0},
+  {"EArmObjBootArchInfo", CmArmBootArchInfoParser,
+    ARRAY_SIZE (CmArmBootArchInfoParser)},
+  {"EArmObjCpuInfo", NULL, 0},
+  {"EArmObjPowerManagementProfileInfo", CmArmPowerManagementProfileInfoParser,
+    ARRAY_SIZE (CmArmPowerManagementProfileInfoParser)},
+  {"EArmObjGicCInfo", CmArmGicCInfoParser, ARRAY_SIZE (CmArmGicCInfoParser)},
+  {"EArmObjGicDInfo", CmArmGicDInfoParser, ARRAY_SIZE (CmArmGicDInfoParser)},
+  {"EArmObjGicMsiFrameInfo", CmArmGicMsiFrameInfoParser,
+    ARRAY_SIZE (CmArmGicMsiFrameInfoParser)},
+  {"EArmObjGicRedistributorInfo", CmArmGicRedistInfoParser,
+    ARRAY_SIZE (CmArmGicRedistInfoParser)},
+  {"EArmObjGicItsInfo", CmArmGicItsInfoParser,
+    ARRAY_SIZE (CmArmGicItsInfoParser)},
+  {"EArmObjSerialConsolePortInfo", CmArmSerialPortInfoParser,
+    ARRAY_SIZE (CmArmSerialPortInfoParser)},
+  {"EArmObjSerialDebugPortInfo", CmArmSerialPortInfoParser,
+    ARRAY_SIZE (CmArmSerialPortInfoParser)},
+  {"EArmObjGenericTimerInfo", CmArmGenericTimerInfoParser,
+    ARRAY_SIZE (CmArmGenericTimerInfoParser)},
+  {"EArmObjPlatformGTBlockInfo", CmArmGTBlockTimerFrameInfoParser,
+    ARRAY_SIZE (CmArmGTBlockTimerFrameInfoParser)},
+  {"EArmObjGTBlockTimerFrameInfo", CmArmGTBlockInfoParser,
+    ARRAY_SIZE (CmArmGTBlockInfoParser)},
+  {"EArmObjPlatformGenericWatchdogInfo", CmArmGenericWatchdogInfoParser,
+    ARRAY_SIZE (CmArmGenericWatchdogInfoParser)},
+  {"EArmObjPciConfigSpaceInfo", CmArmPciConfigSpaceInfoParser,
+    ARRAY_SIZE (CmArmPciConfigSpaceInfoParser)},
+  {"EArmObjHypervisorVendorIdentity", CmArmHypervisorVendorIdParser,
+    ARRAY_SIZE (CmArmHypervisorVendorIdParser)},
+  {"EArmObjFixedFeatureFlags", CmArmFixedFeatureFlagsParser,
+    ARRAY_SIZE (CmArmFixedFeatureFlagsParser)},
+  {"EArmObjItsGroup", CmArmItsGroupNodeParser,
+    ARRAY_SIZE (CmArmItsGroupNodeParser)},
+  {"EArmObjNamedComponent", CmArmNamedComponentNodeParser,
+    ARRAY_SIZE (CmArmNamedComponentNodeParser)},
+  {"EArmObjRootComplex", CmArmRootComplexNodeParser,
+    ARRAY_SIZE (CmArmRootComplexNodeParser)},
+  {"EArmObjSmmuV1SmmuV2", CmArmSmmuV1SmmuV2NodeParser,
+    ARRAY_SIZE (CmArmSmmuV1SmmuV2NodeParser)},
+  {"EArmObjSmmuV3", CmArmSmmuV3NodeParser,
+    ARRAY_SIZE (CmArmSmmuV3NodeParser)},
+  {"EArmObjPmcg", CmArmPmcgNodeParser, ARRAY_SIZE (CmArmPmcgNodeParser)},
+  {"EArmObjGicItsIdentifierArray", CmArmGicItsIdentifierParser,
+    ARRAY_SIZE (CmArmGicItsIdentifierParser)},
+  {"EArmObjIdMappingArray", CmArmIdMappingParser,
+    ARRAY_SIZE (CmArmIdMappingParser)},
+  {"EArmObjSmmuInterruptArray", CmArmGenericInterruptParser,
+    ARRAY_SIZE (CmArmGenericInterruptParser)},
+  {"EArmObjProcHierarchyInfo", CmArmProcHierarchyInfoParser,
+    ARRAY_SIZE (CmArmProcHierarchyInfoParser)},
+  {"EArmObjCacheInfo", CmArmCacheInfoParser,
+    ARRAY_SIZE (CmArmCacheInfoParser)},
+  {"EArmObjProcNodeIdInfo", CmArmProcNodeIdInfoParser,
+    ARRAY_SIZE (CmArmProcNodeIdInfoParser)},
+  {"EArmObjCmRef", CmArmObjRefParser, ARRAY_SIZE (CmArmObjRefParser)},
+  {"EArmObjMemoryAffinityInfo", CmArmMemoryAffinityInfoParser,
+    ARRAY_SIZE (CmArmMemoryAffinityInfoParser)},
+  {"EArmObjDeviceHandleAcpi", CmArmDeviceHandleAcpiParser,
+    ARRAY_SIZE (CmArmDeviceHandleAcpiParser)},
+  {"EArmObjDeviceHandlePci", CmArmDeviceHandlePciParser,
+    ARRAY_SIZE (CmArmDeviceHandlePciParser)},
+  {"EArmObjGenericInitiatorAffinityInfo",
+    CmArmGenericInitiatorAffinityInfoParser,
+    ARRAY_SIZE (CmArmGenericInitiatorAffinityInfoParser)},
+  {"EArmObjSerialPortInfo", CmArmSerialPortInfoParser,
+    ARRAY_SIZE (CmArmSerialPortInfoParser)},
+  {"EArmObjCmn600Info", CmArmCmn600InfoParser,
+    ARRAY_SIZE (CmArmCmn600InfoParser)},
+  {"EArmObjMax", NULL, 0},
+};
+
+/** A parser for EStdObjCfgMgrInfo.
+*/
+STATIC CONST CM_OBJ_PARSER StdObjCfgMgrInfoParser[] = {
+  {"Revision", 4, "0x%x", NULL},
+  {"OemId[6]", 6, "%C%C%C%C%C%C", PrintOemId}
+};
+
+/** A parser for EStdObjAcpiTableList.
+*/
+STATIC CONST CM_OBJ_PARSER StdObjAcpiTableInfoParser[] = {
+  {"AcpiTableSignature", 4, "0x%x", NULL},
+  {"AcpiTableRevision", 1, "%d", NULL},
+  {"TableGeneratorId", sizeof (ACPI_TABLE_GENERATOR_ID), "0x%x", NULL},
+  {"AcpiTableData", sizeof (EFI_ACPI_DESCRIPTION_HEADER*), "0x%p", NULL},
+  {"OemTableId", 8, "0x%LLX", NULL},
+  {"OemRevision", 4, "0x%x", NULL}
+};
+
+/** A parser for EStdObjSmbiosTableList.
+*/
+STATIC CONST CM_OBJ_PARSER StdObjSmbiosTableInfoParser[] = {
+  {"TableGeneratorId", sizeof (SMBIOS_TABLE_GENERATOR_ID), "0x%x", NULL},
+  {"SmbiosTableData", sizeof (SMBIOS_STRUCTURE*), "0x%p", NULL}
+};
+
+/** A parser for Standard namespace objects.
+*/
+STATIC CONST CM_OBJ_PARSER_ARRAY StdNamespaceObjectParser[] = {
+  {"EStdObjCfgMgrInfo", StdObjCfgMgrInfoParser,
+    ARRAY_SIZE (StdObjCfgMgrInfoParser)},
+  {"EStdObjAcpiTableList", StdObjAcpiTableInfoParser,
+    ARRAY_SIZE (StdObjAcpiTableInfoParser)},
+  {"EStdObjSmbiosTableList", StdObjSmbiosTableInfoParser,
+    ARRAY_SIZE (StdObjSmbiosTableInfoParser)},
+};
+
+/** Print OEM Id.
+
+  @param [in]  Format  Format to print the Ptr.
+  @param [in]  Ptr     Pointer to the OEM Id.
+**/
+STATIC
+VOID
+EFIAPI
+PrintOemId (
+  IN  CONST CHAR8  * Format,
+  IN  UINT8        * Ptr
+  )
+{
+  DEBUG ((
+    DEBUG_ERROR,
+    (Format != NULL) ? Format : "%C%C%C%C%C%C",
+    Ptr[0],
+    Ptr[1],
+    Ptr[2],
+    Ptr[3],
+    Ptr[4],
+    Ptr[5]
+    ));
+}
+
+/** Print fields of the objects.
+
+  @param [in]  Data           Pointer to the object to print.
+  @param [in]  Parser         Parser containing the object fields.
+  @param [in]  ItemCount      Number of entries/fields in the Parser.
+  @param [in]  RemainingSize  Parse at most *RemainingSize bytes.
+                              This function decrements the value
+                              from the number bytes consumed.
+  @param [in]  IndentLevel    Indentation to use when printing.
+**/
+STATIC
+VOID
+PrintCmObjDesc (
+  IN        VOID            *Data,
+  IN  CONST CM_OBJ_PARSER   *Parser,
+  IN        UINTN           ItemCount,
+  IN        INTN            *RemainingSize,
+  IN        UINT32          IndentLevel
+  )
+{
+  UINT32  Index;
+  UINT32  IndentIndex;
+  INTN    SubStructSize;
+
+  if ((Data == NULL)    ||
+      (Parser == NULL)  ||
+      (ItemCount == 0)  ||
+      (RemainingSize == NULL)) {
+    ASSERT (0);
+    return;
+  }
+
+  // Print each field.
+  for (Index = 0; Index < ItemCount; Index++) {
+    // Check there is enough space in left.
+    *RemainingSize -= Parser[Index].Length;
+    if (*RemainingSize < 0) {
+      DEBUG ((
+        DEBUG_ERROR,
+        "\nERROR: %a: Buffer overrun\n",
+        Parser[Index].NameStr
+        ));
+      ASSERT (0);
+      return;
+    }
+
+    // Indentation
+    for (IndentIndex = 0; IndentIndex < IndentLevel; IndentIndex++) {
+      DEBUG ((DEBUG_ERROR, "  "));
+    }
+
+    DEBUG ((
+      DEBUG_ERROR,
+      "%-*a :",
+      OUTPUT_FIELD_COLUMN_WIDTH - 2 * IndentLevel,
+      Parser[Index].NameStr
+      ));
+    if (Parser[Index].PrintFormatter != NULL) {
+      Parser[Index].PrintFormatter (Parser[Index].Format, Data);
+    } else if (Parser[Index].Format != NULL) {
+      switch (Parser[Index].Length) {
+        case 1:
+          DEBUG ((DEBUG_ERROR, Parser[Index].Format, *(UINT8*)Data));
+          break;
+        case 2:
+          DEBUG ((DEBUG_ERROR, Parser[Index].Format, *(UINT16*)Data));
+          break;
+        case 4:
+          DEBUG ((DEBUG_ERROR, Parser[Index].Format, *(UINT32*)Data));
+          break;
+        case 8:
+          DEBUG ((DEBUG_ERROR, Parser[Index].Format, ReadUnaligned64(Data)));
+          break;
+        default:
+          DEBUG ((
+            DEBUG_ERROR,
+            "\nERROR: %a: CANNOT PARSE THIS FIELD, Field Length = %d\n",
+            Parser[Index].NameStr,
+            Parser[Index].Length
+            ));
+      } // switch
+    } else if (Parser[Index].SubObjParser != NULL) {
+      SubStructSize = Parser[Index].Length;
+
+      DEBUG ((DEBUG_ERROR, "\n"));
+      PrintCmObjDesc (
+        Data,
+        Parser[Index].SubObjParser,
+        Parser[Index].SubObjItemCount,
+        &SubStructSize,
+        IndentLevel + 1
+        );
+    } else {
+      ASSERT (0);
+      DEBUG ((
+        DEBUG_ERROR,
+        "\nERROR: %a: CANNOT PARSE THIS FIELD, Field Length = %d\n",
+        Parser[Index].NameStr,
+        Parser[Index].Length
+        ));
+    }
+    DEBUG ((DEBUG_ERROR, "\n"));
+    Data += Parser[Index].Length;
+  } // for
+}
+
+/** Parse and print a CmObjDesc.
+
+  @param [in]  CmObjDesc  The CmObjDesc to parse and print.
+**/
+VOID
+EFIAPI
+ParseCmObjDesc (
+  IN  CONST CM_OBJ_DESCRIPTOR * CmObjDesc
+  )
+{
+  UINTN   ObjId;
+  UINTN   NameSpaceId;
+  UINT32  ObjIndex;
+  UINT32  ObjectCount;
+  INTN    RemainingSize;
+  CONST  CM_OBJ_PARSER_ARRAY * ParserArray;
+
+  if ((CmObjDesc == NULL) || (CmObjDesc->Data == NULL)) {
+    return;
+  }
+
+  NameSpaceId = GET_CM_NAMESPACE_ID (CmObjDesc->ObjectId);
+  ObjId = GET_CM_OBJECT_ID (CmObjDesc->ObjectId);
+
+  switch (NameSpaceId) {
+    case EObjNameSpaceStandard:
+      if (ObjId >= EStdObjMax) {
+        ASSERT (0);
+        return;
+      }
+      ParserArray = &StdNamespaceObjectParser[ObjId];
+      break;
+    case EObjNameSpaceArm:
+      if (ObjId >= EArmObjMax) {
+        ASSERT (0);
+        return;
+      }
+      ParserArray = &ArmNamespaceObjectParser[ObjId];
+      break;
+    default:
+      // Not supported
+      ASSERT (0);
+      return;
+  } // switch
+
+  ObjectCount = CmObjDesc->Count;
+  RemainingSize = CmObjDesc->Size;
+
+  for (ObjIndex = 0; ObjIndex < ObjectCount; ObjIndex++) {
+    DEBUG ((
+      DEBUG_ERROR,
+      "\n%-*a [%d/%d]:\n",
+      OUTPUT_FIELD_COLUMN_WIDTH,
+      ParserArray->ObjectName,
+      ObjIndex + 1,
+      ObjectCount
+      ));
+    PrintCmObjDesc (
+      CmObjDesc->Data,
+      ParserArray->Parser,
+      ParserArray->ItemCount,
+      &RemainingSize,
+      1
+      );
+  } // for
+}
diff --git a/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.h b/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.h
new file mode 100644
index 000000000000..e229df7095d9
--- /dev/null
+++ b/DynamicTablesPkg/Library/Common/TableHelperLib/ConfigurationManagerObjectParser.h
@@ -0,0 +1,73 @@
+/** @file
+  Configuration Manager Object parser.
+
+  Copyright (c) 2021, ARM Limited. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#ifndef CONFIGURATION_MANAGER_OBJECT_PARSER_H_
+#define CONFIGURATION_MANAGER_OBJECT_PARSER_H_
+
+#define OUTPUT_FIELD_COLUMN_WIDTH   32
+
+/** Function prototype to format a field print.
+
+  @param [in] Format  Format string for tracing the data as specified by
+                      the 'Format' member of ACPI_PARSER.
+  @param [in] Ptr     Pointer to the start of the buffer.
+**/
+typedef VOID (EFIAPI *FNPTR_PRINT_FORMATTER)(CONST CHAR8* Format, UINT8* Ptr);
+
+/**
+  The CM_OBJ_PARSER structure describes the fields of an CmObject and
+  provides means for the parser to interpret and trace appropriately.
+
+  ParseAcpi() uses the format string specified by 'Format' for tracing
+  the field data.
+*/
+typedef struct CmObjParser CM_OBJ_PARSER;
+struct CmObjParser {
+
+  /// String describing the Cm Object
+  CONST CHAR8*            NameStr;
+
+  /// The length of the field.
+  UINT32                  Length;
+
+  /// Optional Print() style format string for tracing the data. If not
+  /// used this must be set to NULL.
+  CONST CHAR8*            Format;
+
+  /// Optional pointer to a print formatter function which
+  /// is typically used to trace complex field information.
+  /// If not used this must be set to NULL.
+  /// The Format string is passed to the PrintFormatter function
+  /// but may be ignored by the implementation code.
+  FNPTR_PRINT_FORMATTER   PrintFormatter;
+
+  /// Optional pointer to print the fields of another CM_OBJ_PARSER
+  /// structure. This is useful to print sub-structures.
+  CONST CM_OBJ_PARSER     *SubObjParser;
+
+  /// Count of items in the SubObj.
+  UINTN                   SubObjItemCount;
+};
+
+/**
+  A structure mapping an array of Configuration Manager Object parsers
+  with their object names.
+*/
+typedef struct CmObjParserArray {
+
+  /// Object name
+  CONST CHAR8         * ObjectName;
+
+  /// Function pointer to the parser
+  CONST CM_OBJ_PARSER * Parser;
+
+  /// Count of items
+  UINTN                 ItemCount;
+} CM_OBJ_PARSER_ARRAY;
+
+#endif // CONFIGURATION_MANAGER_OBJECT_PARSER_H_
diff --git a/DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf b/DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf
index 5435f74aa0b8..abbf4bc38cab 100644
--- a/DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf
+++ b/DynamicTablesPkg/Library/Common/TableHelperLib/TableHelperLib.inf
@@ -15,6 +15,8 @@ [Defines]
   LIBRARY_CLASS  = TableHelperLib
 
 [Sources]
+  ConfigurationManagerObjectParser.c
+  ConfigurationManagerObjectParser.h
   TableHelper.c
 
 [Packages]
-- 
2.17.1


  parent reply	other threads:[~2021-09-30  7:48 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-09-30  7:48 [PATCH v2 00/10] Various DynamicTablesPkg modifications PierreGondois
2021-09-30  7:48 ` [PATCH v2 01/10] DynamicTablesPkg: Extract AcpiHelperLib from TableHelperLib PierreGondois
2021-09-30  7:48 ` [PATCH v2 02/10] DynamicTablesPkg: Update TableHelperLib.inf PierreGondois
2021-09-30  7:48 ` [PATCH v2 03/10] DynamicTablesPkg: Rename single char input parameter PierreGondois
2021-09-30  7:48 ` [PATCH v2 04/10] DynamicTablesPkg: Add HexFromAscii() to AcpiHelperLib PierreGondois
2021-09-30  7:48 ` [PATCH v2 05/10] DynamicTablesPkg: Add AmlGetEisaIdFromString() " PierreGondois
2021-09-30  7:48 ` PierreGondois [this message]
2021-09-30  7:48 ` [PATCH v2 07/10] DynamicTablesPkg: Use %a formatter in AmlDbgPrint PierreGondois
2021-09-30  7:48 ` [PATCH v2 08/10] DynamicTablesPkg: Update DynamicTablesPkg.ci.yaml PierreGondois
2021-09-30  7:48 ` [PATCH v2 09/10] DynamicTablesPkg: Deprecate Crs specific methods in AmlLib PierreGondois
2021-09-30  7:48 ` [PATCH v2 10/10] DynamicTablesPkg: Rework AmlResourceDataCodegen.c/h PierreGondois
2021-10-01 12:04 ` [PATCH v2 00/10] Various DynamicTablesPkg modifications Sami Mujawar

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-list from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210930074821.12546-7-Pierre.Gondois@arm.com \
    --to=devel@edk2.groups.io \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox