[mirror_edk2.git] / DynamicTablesPkg / Library / Acpi / Arm / AcpiSsdtCpuTopologyLibArm / SsdtCpuTopologyGenerator.c

/** @file\r
  SSDT Cpu Topology Table Generator.\r
\r
  Copyright (c) 2021, Arm Limited. All rights reserved.<BR>\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
  @par Reference(s):\r
    - ACPI 6.3 Specification - January 2019 - s8.4 Declaring Processors\r
**/\r
\r
#include <Library/AcpiLib.h>\r
#include <Library/BaseLib.h>\r
#include <Library/BaseMemoryLib.h>\r
#include <Library/DebugLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
#include <Protocol/AcpiTable.h>\r
\r
// Module specific include files.\r
#include <AcpiTableGenerator.h>\r
#include <ConfigurationManagerObject.h>\r
#include <ConfigurationManagerHelper.h>\r
#include <Library/AcpiHelperLib.h>\r
#include <Library/TableHelperLib.h>\r
#include <Library/AmlLib/AmlLib.h>\r
#include <Protocol/ConfigurationManagerProtocol.h>\r
\r
#include "SsdtCpuTopologyGenerator.h"\r
\r
/** ARM standard SSDT Cpu Topology Table Generator.\r
\r
Requirements:\r
  The following Configuration Manager Object(s) are required by\r
  this Generator:\r
  - EArmObjGicCInfo\r
  - EArmObjProcHierarchyInfo (OPTIONAL) along with\r
  - EArmObjCmRef (OPTIONAL)\r
  - EArmObjLpiInfo (OPTIONAL)\r
*/\r
\r
/** This macro expands to a function that retrieves the GIC\r
    CPU interface Information from the Configuration Manager.\r
*/\r
GET_OBJECT_LIST (\r
  EObjNameSpaceArm,\r
  EArmObjGicCInfo,\r
  CM_ARM_GICC_INFO\r
  );\r
\r
/**\r
  This macro expands to a function that retrieves the Processor Hierarchy\r
  information from the Configuration Manager.\r
*/\r
GET_OBJECT_LIST (\r
  EObjNameSpaceArm,\r
  EArmObjProcHierarchyInfo,\r
  CM_ARM_PROC_HIERARCHY_INFO\r
  );\r
\r
/**\r
  This macro expands to a function that retrieves the cross-CM-object-\r
  reference information from the Configuration Manager.\r
*/\r
GET_OBJECT_LIST (\r
  EObjNameSpaceArm,\r
  EArmObjCmRef,\r
  CM_ARM_OBJ_REF\r
  );\r
\r
/**\r
  This macro expands to a function that retrieves the Lpi\r
  information from the Configuration Manager.\r
*/\r
GET_OBJECT_LIST (\r
  EObjNameSpaceArm,\r
  EArmObjLpiInfo,\r
  CM_ARM_LPI_INFO\r
  );\r
\r
/** Initialize the TokenTable.\r
\r
  One entry should be allocated for each CM_ARM_PROC_HIERARCHY_INFO\r
  structure of the platform. The TokenTable allows to have a mapping:\r
  Index <-> CM_OBJECT_TOKEN (to CM_ARM_LPI_INFO structures).\r
\r
  There will always be less sets of Lpi states (CM_ARM_OBJ_REF)\r
  than the number of cpus/clusters (CM_ARM_PROC_HIERARCHY_INFO).\r
\r
  @param [in]  Generator  The SSDT Cpu Topology generator.\r
  @param [in]  Count      Number of entries to allocate in the TokenTable.\r
\r
  @retval EFI_SUCCESS            Success.\r
  @retval EFI_INVALID_PARAMETER  Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
TokenTableInitialize (\r
  IN  ACPI_CPU_TOPOLOGY_GENERATOR  *Generator,\r
  IN  UINT32                       Count\r
  )\r
{\r
  CM_OBJECT_TOKEN  *Table;\r
\r
  if ((Generator == NULL) ||\r
      (Count == 0)        ||\r
      (Count >= MAX_NODE_COUNT))\r
  {\r
    ASSERT (0);\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Table = AllocateZeroPool (sizeof (CM_OBJECT_TOKEN) * Count);\r
  if (Table == NULL) {\r
    ASSERT (0);\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  Generator->TokenTable.Table = Table;\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/** Free the TokenTable.\r
\r
  @param [in]  Generator    The SSDT Cpu Topology generator.\r
**/\r
STATIC\r
VOID\r
EFIAPI\r
TokenTableFree (\r
  IN  ACPI_CPU_TOPOLOGY_GENERATOR  *Generator\r
  )\r
{\r
  ASSERT (Generator != NULL);\r
  ASSERT (Generator->TokenTable.Table != NULL);\r
\r
  if (Generator->TokenTable.Table != NULL) {\r
    FreePool (Generator->TokenTable.Table);\r
  }\r
}\r
\r
/** Add a new entry to the TokenTable and return its index.\r
\r
  If an entry with Token is already available in the table,\r
  return its index without adding a new entry.\r
\r
  @param [in]  Generator  The SSDT Cpu Topology generator.\r
  @param [in]  Token      New Token entry to add.\r
\r
  @retval The index of the token entry in the TokenTable.\r
**/\r
STATIC\r
UINT32\r
EFIAPI\r
TokenTableAdd (\r
  IN  ACPI_CPU_TOPOLOGY_GENERATOR  *Generator,\r
  IN  CM_OBJECT_TOKEN              Token\r
  )\r
{\r
  CM_OBJECT_TOKEN  *Table;\r
  UINT32           Index;\r
  UINT32           LastIndex;\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (Generator->TokenTable.Table != NULL);\r
\r
  Table     = Generator->TokenTable.Table;\r
  LastIndex = Generator->TokenTable.LastIndex;\r
\r
  // Search if there is already an entry with this Token.\r
  for (Index = 0; Index < LastIndex; Index++) {\r
    if (Table[Index] == Token) {\r
      return Index;\r
    }\r
  }\r
\r
  ASSERT (LastIndex < MAX_NODE_COUNT);\r
  ASSERT (LastIndex < Generator->ProcNodeCount);\r
\r
  // If no, create a new entry.\r
  Table[LastIndex] = Token;\r
\r
  return Generator->TokenTable.LastIndex++;\r
}\r
\r
/** Write a string 'Xxxx\0' in AslName (5 bytes long),\r
  with 'X' being the leading char of the name, and\r
  with 'xxx' being Value in hexadecimal.\r
\r
  As 'xxx' in hexadecimal represents a number on 12 bits,\r
  we have Value < (1 << 12).\r
\r
  @param [in]       LeadChar  Leading char of the name.\r
  @param [in]       Value     Hex value of the name.\r
                              Must be lower than (2 << 12).\r
  @param [in, out]  AslName   Pointer to write the 'Xxxx' string to.\r
                              Must be at least 5 bytes long.\r
\r
  @retval EFI_SUCCESS               Success.\r
  @retval EFI_INVALID_PARAMETER     Invalid parameter.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
WriteAslName (\r
  IN      CHAR8   LeadChar,\r
  IN      UINT32  Value,\r
  IN OUT  CHAR8   *AslName\r
  )\r
{\r
  UINT8  Index;\r
\r
  if ((Value >= MAX_NODE_COUNT)  ||\r
      (AslName == NULL))\r
  {\r
    ASSERT (0);\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  AslName[0]                 = LeadChar;\r
  AslName[AML_NAME_SEG_SIZE] = '\0';\r
\r
  for (Index = 0; Index < AML_NAME_SEG_SIZE - 1; Index++) {\r
    AslName[AML_NAME_SEG_SIZE - Index - 1] =\r
      AsciiFromHex (((Value >> (4 * Index)) & 0xF));\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/** Create and add an _LPI method to Cpu/Cluster Node.\r
\r
  For instance, transform an AML node from:\r
  Device (C002)\r
  {\r
      Name (_UID, 2)\r
      Name (_HID, "ACPI0007")\r
  }\r
\r
  To:\r
  Device (C002)\r
  {\r
      Name (_UID, 2)\r
      Name (_HID, "ACPI0007")\r
      Method (_LPI, 0, NotSerialized)\r
      {\r
          Return (\_SB.L003)\r
      }\r
  }\r
\r
  @param [in]  Generator              The SSDT Cpu Topology generator.\r
  @param [in]  ProcHierarchyNodeInfo  CM_ARM_PROC_HIERARCHY_INFO describing\r
                                      the Cpu.\r
  @param [in]  Node                   Node to which the _LPI method is\r
                                      attached. Can represent a Cpu or a\r
                                      Cluster.\r
\r
  @retval EFI_SUCCESS             The function completed successfully.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateAmlLpiMethod (\r
  IN  ACPI_CPU_TOPOLOGY_GENERATOR  *Generator,\r
  IN  CM_ARM_PROC_HIERARCHY_INFO   *ProcHierarchyNodeInfo,\r
  IN  AML_OBJECT_NODE_HANDLE       *Node\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINT32      TokenIndex;\r
  CHAR8       AslName[SB_SCOPE_PREFIX_SIZE + AML_NAME_SEG_SIZE];\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (ProcHierarchyNodeInfo != NULL);\r
  ASSERT (ProcHierarchyNodeInfo->LpiToken != CM_NULL_TOKEN);\r
  ASSERT (Node != NULL);\r
\r
  TokenIndex = TokenTableAdd (Generator, ProcHierarchyNodeInfo->LpiToken);\r
\r
  CopyMem (AslName, SB_SCOPE_PREFIX, SB_SCOPE_PREFIX_SIZE);\r
\r
  Status = WriteAslName (\r
             'L',\r
             TokenIndex,\r
             AslName + SB_SCOPE_PREFIX_SIZE - 1\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // ASL:\r
  // Method (_LPI, 0) {\r
  //   Return ([AslName])\r
  // }\r
  Status = AmlCodeGenMethodRetNameString (\r
             "_LPI",\r
             AslName,\r
             0,\r
             FALSE,\r
             0,\r
             Node,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
  }\r
\r
  return Status;\r
}\r
\r
/** Generate all the Lpi states under the '_SB' scope.\r
\r
  This function generates the following ASL code:\r
  Scope (\_SB) {\r
    Name (L000, Package() {\r
      0, // Version\r
      0, // Level Index\r
      X, // Count\r
      Package() {\r
        [An Lpi state]\r
      },\r
      Package() {\r
        [Another Lpi state]\r
      },\r
    } // Name L000\r
\r
    Name (L001, Package() {\r
      ...\r
    } // Name L001\r
\r
    ...\r
  } // Scope /_SB\r
\r
  The Lpi states are fetched from the Configuration Manager.\r
  The names of the Lpi states are generated from the TokenTable.\r
\r
  @param [in]  Generator        The SSDT Cpu Topology generator.\r
  @param [in]  CfgMgrProtocol   Pointer to the Configuration Manager\r
                                Protocol Interface.\r
  @param [in] ScopeNode         Scope node handle ('\_SB' scope).\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
GenerateLpiStates (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        AML_OBJECT_NODE_HANDLE                        ScopeNode\r
  )\r
{\r
  EFI_STATUS  Status;\r
\r
  UINT32  Index;\r
  UINT32  LastIndex;\r
\r
  AML_OBJECT_NODE_HANDLE  LpiNode;\r
  CM_ARM_OBJ_REF          *LpiRefInfo;\r
  UINT32                  LpiRefInfoCount;\r
  UINT32                  LpiRefIndex;\r
  CM_ARM_LPI_INFO         *LpiInfo;\r
  CHAR8                   AslName[AML_NAME_SEG_SIZE + 1];\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (Generator->TokenTable.Table != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (ScopeNode != NULL);\r
\r
  LastIndex = Generator->TokenTable.LastIndex;\r
\r
  // For each entry in the TokenTable, create a name in the AML namespace\r
  // under SB_SCOPE, to store the Lpi states associated with the LpiToken.\r
  for (Index = 0; Index < LastIndex; Index++) {\r
    Status = WriteAslName ('L', Index, AslName);\r
    if (EFI_ERROR (Status)) {\r
      ASSERT (0);\r
      return Status;\r
    }\r
\r
    // We do not support the LevelId field for now, let it to 0.\r
    Status = AmlCreateLpiNode (AslName, 1, 0, ScopeNode, &LpiNode);\r
    if (EFI_ERROR (Status)) {\r
      ASSERT (0);\r
      return Status;\r
    }\r
\r
    // Fetch the LPI objects referenced by the token.\r
    Status = GetEArmObjCmRef (\r
               CfgMgrProtocol,\r
               Generator->TokenTable.Table[Index],\r
               &LpiRefInfo,\r
               &LpiRefInfoCount\r
               );\r
    if (EFI_ERROR (Status)) {\r
      ASSERT (0);\r
      return Status;\r
    }\r
\r
    for (LpiRefIndex = 0; LpiRefIndex < LpiRefInfoCount; LpiRefIndex++) {\r
      // For each CM_ARM_LPI_INFO referenced by the token, add an Lpi state.\r
      Status = GetEArmObjLpiInfo (\r
                 CfgMgrProtocol,\r
                 LpiRefInfo[LpiRefIndex].ReferenceToken,\r
                 &LpiInfo,\r
                 NULL\r
                 );\r
      if (EFI_ERROR (Status)) {\r
        ASSERT (0);\r
        return Status;\r
      }\r
\r
      Status = AmlAddLpiState (\r
                 LpiInfo->MinResidency,\r
                 LpiInfo->WorstCaseWakeLatency,\r
                 LpiInfo->Flags,\r
                 LpiInfo->ArchFlags,\r
                 LpiInfo->ResCntFreq,\r
                 LpiInfo->EnableParentState,\r
                 LpiInfo->IsInteger ?\r
                 NULL :\r
                 &LpiInfo->RegisterEntryMethod,\r
                 LpiInfo->IsInteger ?\r
                 LpiInfo->IntegerEntryMethod :\r
                 0,\r
                 &LpiInfo->ResidencyCounterRegister,\r
                 &LpiInfo->UsageCounterRegister,\r
                 LpiInfo->StateName,\r
                 LpiNode\r
                 );\r
      if (EFI_ERROR (Status)) {\r
        ASSERT (0);\r
        return Status;\r
      }\r
    } // for LpiRefIndex\r
  } // for Index\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/** Create a Cpu in the AML namespace.\r
\r
  This generates the following ASL code:\r
  Device (C002)\r
  {\r
      Name (_UID, 2)\r
      Name (_HID, "ACPI0007")\r
  }\r
\r
  @param [in]  Generator    The SSDT Cpu Topology generator.\r
  @param [in]  ParentNode   Parent node to attach the Cpu node to.\r
  @param [in]  GicCInfo     CM_ARM_GICC_INFO object used to create the node.\r
  @param [in]  CpuIndex     Index used to generate the node name.\r
  @param [out] CpuNodePtr   If not NULL, return the created Cpu node.\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateAmlCpu (\r
  IN   ACPI_CPU_TOPOLOGY_GENERATOR  *Generator,\r
  IN   AML_NODE_HANDLE              ParentNode,\r
  IN   CM_ARM_GICC_INFO             *GicCInfo,\r
  IN   UINT32                       CpuIndex,\r
  OUT  AML_OBJECT_NODE_HANDLE       *CpuNodePtr OPTIONAL\r
  )\r
{\r
  EFI_STATUS              Status;\r
  AML_OBJECT_NODE_HANDLE  CpuNode;\r
  CHAR8                   AslName[AML_NAME_SEG_SIZE + 1];\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (ParentNode != NULL);\r
  ASSERT (GicCInfo != NULL);\r
\r
  Status = WriteAslName ('C', CpuIndex, AslName);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenDevice (AslName, ParentNode, &CpuNode);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenNameInteger (\r
             "_UID",\r
             GicCInfo->AcpiProcessorUid,\r
             CpuNode,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenNameString (\r
             "_HID",\r
             ACPI_HID_PROCESSOR_DEVICE,\r
             CpuNode,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // If requested, return the handle to the CpuNode.\r
  if (CpuNodePtr != NULL) {\r
    *CpuNodePtr = CpuNode;\r
  }\r
\r
  return Status;\r
}\r
\r
/** Create a Cpu in the AML namespace from a CM_ARM_PROC_HIERARCHY_INFO\r
    CM object.\r
\r
  @param [in]  Generator              The SSDT Cpu Topology generator.\r
  @param [in]  CfgMgrProtocol         Pointer to the Configuration Manager\r
                                      Protocol Interface.\r
  @param [in]  ParentNode             Parent node to attach the Cpu node to.\r
  @param [in]  CpuIndex               Index used to generate the node name.\r
  @param [in]  ProcHierarchyNodeInfo  CM_ARM_PROC_HIERARCHY_INFO describing\r
                                      the Cpu.\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateAmlCpuFromProcHierarchy (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        AML_NODE_HANDLE                               ParentNode,\r
  IN        UINT32                                        CpuIndex,\r
  IN        CM_ARM_PROC_HIERARCHY_INFO                    *ProcHierarchyNodeInfo\r
  )\r
{\r
  EFI_STATUS              Status;\r
  CM_ARM_GICC_INFO        *GicCInfo;\r
  AML_OBJECT_NODE_HANDLE  CpuNode;\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (ParentNode != NULL);\r
  ASSERT (ProcHierarchyNodeInfo != NULL);\r
  ASSERT (ProcHierarchyNodeInfo->GicCToken != CM_NULL_TOKEN);\r
\r
  Status = GetEArmObjGicCInfo (\r
             CfgMgrProtocol,\r
             ProcHierarchyNodeInfo->GicCToken,\r
             &GicCInfo,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = CreateAmlCpu (Generator, ParentNode, GicCInfo, CpuIndex, &CpuNode);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // If a set of Lpi states is associated with the\r
  // CM_ARM_PROC_HIERARCHY_INFO, create an _LPI method returning them.\r
  if (ProcHierarchyNodeInfo->LpiToken != CM_NULL_TOKEN) {\r
    Status = CreateAmlLpiMethod (Generator, ProcHierarchyNodeInfo, CpuNode);\r
    ASSERT_EFI_ERROR (Status);\r
  }\r
\r
  return Status;\r
}\r
\r
/** Create a Cluster in the AML namespace.\r
\r
  Any CM_ARM_PROC_HIERARCHY_INFO object with the following flags is\r
  assumed to be a cluster:\r
   - EFI_ACPI_6_3_PPTT_PACKAGE_NOT_PHYSICAL\r
   - EFI_ACPI_6_3_PPTT_PROCESSOR_ID_INVALID\r
   - EFI_ACPI_6_3_PPTT_NODE_IS_NOT_LEAF\r
\r
  This generates the following ASL code:\r
  Device (C002)\r
  {\r
      Name (_UID, 2)\r
      Name (_HID, "ACPI0010")\r
  }\r
\r
  @param [in]  Generator              The SSDT Cpu Topology generator.\r
  @param [in]  CfgMgrProtocol         Pointer to the Configuration Manager\r
                                      Protocol Interface.\r
  @param [in]  ParentNode             Parent node to attach the Cluster\r
                                      node to.\r
  @param [in]  ProcHierarchyNodeInfo  CM_ARM_PROC_HIERARCHY_INFO object used\r
                                      to create the node.\r
  @param [in]  ClusterIndex           Index used to generate the node name.\r
  @param [out] ClusterNodePtr         If success, contains the created Cluster\r
                                      node.\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateAmlCluster (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        AML_NODE_HANDLE                               ParentNode,\r
  IN        CM_ARM_PROC_HIERARCHY_INFO                    *ProcHierarchyNodeInfo,\r
  IN        UINT32                                        ClusterIndex,\r
  OUT       AML_OBJECT_NODE_HANDLE                        *ClusterNodePtr\r
  )\r
{\r
  EFI_STATUS              Status;\r
  AML_OBJECT_NODE_HANDLE  ClusterNode;\r
  CHAR8                   AslNameCluster[AML_NAME_SEG_SIZE + 1];\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (ParentNode != NULL);\r
  ASSERT (ProcHierarchyNodeInfo != NULL);\r
  ASSERT (ClusterNodePtr != NULL);\r
\r
  Status = WriteAslName ('C', ClusterIndex, AslNameCluster);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenDevice (AslNameCluster, ParentNode, &ClusterNode);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // Use the ClusterIndex for the _UID value as there is no AcpiProcessorUid\r
  // and EFI_ACPI_6_3_PPTT_PROCESSOR_ID_INVALID is set for non-Cpus.\r
  Status = AmlCodeGenNameInteger (\r
             "_UID",\r
             ClusterIndex,\r
             ClusterNode,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenNameString (\r
             "_HID",\r
             ACPI_HID_PROCESSOR_CONTAINER_DEVICE,\r
             ClusterNode,\r
             NULL\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // If a set of Lpi states are associated with the\r
  // CM_ARM_PROC_HIERARCHY_INFO, create an _LPI method returning them.\r
  if (ProcHierarchyNodeInfo->LpiToken != CM_NULL_TOKEN) {\r
    Status = CreateAmlLpiMethod (\r
               Generator,\r
               ProcHierarchyNodeInfo,\r
               ClusterNode\r
               );\r
    if (EFI_ERROR (Status)) {\r
      ASSERT (0);\r
      return Status;\r
    }\r
  }\r
\r
  *ClusterNodePtr = ClusterNode;\r
\r
  return Status;\r
}\r
\r
/** Create an AML representation of the Cpu topology.\r
\r
  A cluster is by extension any non-leave device in the cpu topology.\r
\r
  @param [in] Generator          The SSDT Cpu Topology generator.\r
  @param [in] CfgMgrProtocol     Pointer to the Configuration Manager\r
                                 Protocol Interface.\r
  @param [in] NodeToken          Token of the CM_ARM_PROC_HIERARCHY_INFO\r
                                 currently handled.\r
                                 Cannot be CM_NULL_TOKEN.\r
  @param [in] ParentNode         Parent node to attach the created\r
                                 node to.\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateAmlCpuTopologyTree (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        CM_OBJECT_TOKEN                               NodeToken,\r
  IN        AML_NODE_HANDLE                               ParentNode\r
  )\r
{\r
  EFI_STATUS              Status;\r
  UINT32                  Index;\r
  UINT32                  CpuIndex;\r
  UINT32                  ClusterIndex;\r
  AML_OBJECT_NODE_HANDLE  ClusterNode;\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (Generator->ProcNodeList != NULL);\r
  ASSERT (Generator->ProcNodeCount != 0);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (NodeToken != CM_NULL_TOKEN);\r
  ASSERT (ParentNode != NULL);\r
\r
  CpuIndex     = 0;\r
  ClusterIndex = 0;\r
\r
  for (Index = 0; Index < Generator->ProcNodeCount; Index++) {\r
    // Find the children of the CM_ARM_PROC_HIERARCHY_INFO\r
    // currently being handled (i.e. ParentToken == NodeToken).\r
    if (Generator->ProcNodeList[Index].ParentToken == NodeToken) {\r
      // Only Cpus (leaf nodes in this tree) have a GicCToken.\r
      // Create a Cpu node.\r
      if (Generator->ProcNodeList[Index].GicCToken != CM_NULL_TOKEN) {\r
        if ((Generator->ProcNodeList[Index].Flags & PPTT_PROCESSOR_MASK) !=\r
            PPTT_CPU_PROCESSOR_MASK)\r
        {\r
          DEBUG ((\r
            DEBUG_ERROR,\r
            "ERROR: SSDT-CPU-TOPOLOGY: Invalid flags for cpu: 0x%x.\n",\r
            Generator->ProcNodeList[Index].Flags\r
            ));\r
          ASSERT (0);\r
          return EFI_INVALID_PARAMETER;\r
        }\r
\r
        Status = CreateAmlCpuFromProcHierarchy (\r
                   Generator,\r
                   CfgMgrProtocol,\r
                   ParentNode,\r
                   CpuIndex,\r
                   &Generator->ProcNodeList[Index]\r
                   );\r
        if (EFI_ERROR (Status)) {\r
          ASSERT (0);\r
          return Status;\r
        }\r
\r
        CpuIndex++;\r
      } else {\r
        // If this is not a Cpu, then this is a cluster.\r
\r
        // Acpi processor Id for clusters is not handled.\r
        if ((Generator->ProcNodeList[Index].Flags & PPTT_PROCESSOR_MASK) !=\r
            PPTT_CLUSTER_PROCESSOR_MASK)\r
        {\r
          DEBUG ((\r
            DEBUG_ERROR,\r
            "ERROR: SSDT-CPU-TOPOLOGY: Invalid flags for cluster: 0x%x.\n",\r
            Generator->ProcNodeList[Index].Flags\r
            ));\r
          ASSERT (0);\r
          return EFI_INVALID_PARAMETER;\r
        }\r
\r
        Status = CreateAmlCluster (\r
                   Generator,\r
                   CfgMgrProtocol,\r
                   ParentNode,\r
                   &Generator->ProcNodeList[Index],\r
                   ClusterIndex,\r
                   &ClusterNode\r
                   );\r
        if (EFI_ERROR (Status)) {\r
          ASSERT (0);\r
          return Status;\r
        }\r
\r
        // Nodes must have a unique name in the ASL namespace.\r
        // Reset the Cpu index whenever we create a new Cluster.\r
        ClusterIndex++;\r
        CpuIndex = 0;\r
\r
        // Recursively continue creating an AML tree.\r
        Status = CreateAmlCpuTopologyTree (\r
                   Generator,\r
                   CfgMgrProtocol,\r
                   Generator->ProcNodeList[Index].Token,\r
                   ClusterNode\r
                   );\r
        if (EFI_ERROR (Status)) {\r
          ASSERT (0);\r
          return Status;\r
        }\r
      }\r
    } // if ParentToken == NodeToken\r
  } // for\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/** Create the processor hierarchy AML tree from CM_ARM_PROC_HIERARCHY_INFO\r
    CM objects.\r
\r
  @param [in] Generator        The SSDT Cpu Topology generator.\r
  @param [in] CfgMgrProtocol   Pointer to the Configuration Manager\r
                               Protocol Interface.\r
  @param [in] ScopeNode        Scope node handle ('\_SB' scope).\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateTopologyFromProcHierarchy (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        AML_OBJECT_NODE_HANDLE                        ScopeNode\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINT32      Index;\r
  UINT32      TopLevelProcNodeIndex;\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (Generator->ProcNodeCount != 0);\r
  ASSERT (Generator->ProcNodeList != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (ScopeNode != NULL);\r
\r
  TopLevelProcNodeIndex = MAX_UINT32;\r
\r
  Status = TokenTableInitialize (Generator, Generator->ProcNodeCount);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // It is assumed that there is one unique CM_ARM_PROC_HIERARCHY_INFO\r
  // structure with no ParentToken and the EFI_ACPI_6_3_PPTT_PACKAGE_PHYSICAL\r
  // flag set. All other CM_ARM_PROC_HIERARCHY_INFO are non-physical and\r
  // have a ParentToken.\r
  for (Index = 0; Index < Generator->ProcNodeCount; Index++) {\r
    if ((Generator->ProcNodeList[Index].ParentToken == CM_NULL_TOKEN) &&\r
        (Generator->ProcNodeList[Index].Flags &\r
         EFI_ACPI_6_3_PPTT_PACKAGE_PHYSICAL))\r
    {\r
      if (TopLevelProcNodeIndex != MAX_UINT32) {\r
        DEBUG ((\r
          DEBUG_ERROR,\r
          "ERROR: SSDT-CPU-TOPOLOGY: Top level CM_ARM_PROC_HIERARCHY_INFO "\r
          "must be unique\n"\r
          ));\r
        ASSERT (0);\r
        goto exit_handler;\r
      }\r
\r
      TopLevelProcNodeIndex = Index;\r
    }\r
  } // for\r
\r
  Status = CreateAmlCpuTopologyTree (\r
             Generator,\r
             CfgMgrProtocol,\r
             Generator->ProcNodeList[TopLevelProcNodeIndex].Token,\r
             ScopeNode\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    goto exit_handler;\r
  }\r
\r
  Status = GenerateLpiStates (Generator, CfgMgrProtocol, ScopeNode);\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    goto exit_handler;\r
  }\r
\r
exit_handler:\r
  TokenTableFree (Generator);\r
  return Status;\r
}\r
\r
/** Create the processor hierarchy AML tree from CM_ARM_GICC_INFO\r
    CM objects.\r
\r
  A cluster is by extension any non-leave device in the cpu topology.\r
\r
  @param [in] Generator        The SSDT Cpu Topology generator.\r
  @param [in] CfgMgrProtocol   Pointer to the Configuration Manager\r
                               Protocol Interface.\r
  @param [in] ScopeNode        Scope node handle ('\_SB' scope).\r
\r
  @retval EFI_SUCCESS             Success.\r
  @retval EFI_INVALID_PARAMETER   Invalid parameter.\r
  @retval EFI_OUT_OF_RESOURCES    Failed to allocate memory.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
CreateTopologyFromGicC (\r
  IN        ACPI_CPU_TOPOLOGY_GENERATOR                   *Generator,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN        AML_OBJECT_NODE_HANDLE                        ScopeNode\r
  )\r
{\r
  EFI_STATUS        Status;\r
  CM_ARM_GICC_INFO  *GicCInfo;\r
  UINT32            GicCInfoCount;\r
  UINT32            Index;\r
\r
  ASSERT (Generator != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (ScopeNode != NULL);\r
\r
  Status = GetEArmObjGicCInfo (\r
             CfgMgrProtocol,\r
             CM_NULL_TOKEN,\r
             &GicCInfo,\r
             &GicCInfoCount\r
             );\r
  if (EFI_ERROR (Status)) {\r
    ASSERT (0);\r
    return Status;\r
  }\r
\r
  // For each CM_ARM_GICC_INFO object, create an AML node.\r
  for (Index = 0; Index < GicCInfoCount; Index++) {\r
    Status = CreateAmlCpu (\r
               Generator,\r
               ScopeNode,\r
               &GicCInfo[Index],\r
               Index,\r
               NULL\r
               );\r
    if (EFI_ERROR (Status)) {\r
      ASSERT (0);\r
      break;\r
    }\r
  } // for\r
\r
  return Status;\r
}\r
\r
/** Construct the SSDT Cpu Topology ACPI table.\r
\r
  This function invokes the Configuration Manager protocol interface\r
  to get the required hardware information for generating the ACPI\r
  table.\r
\r
  If this function allocates any resources then they must be freed\r
  in the FreeXXXXTableResources function.\r
\r
  @param [in]  This           Pointer to the table generator.\r
  @param [in]  AcpiTableInfo  Pointer to the ACPI Table Info.\r
  @param [in]  CfgMgrProtocol Pointer to the Configuration Manager\r
                              Protocol Interface.\r
  @param [out] Table          Pointer to the constructed ACPI Table.\r
\r
  @retval EFI_SUCCESS           Table generated successfully.\r
  @retval EFI_INVALID_PARAMETER A parameter is invalid.\r
  @retval EFI_NOT_FOUND         The required object was not found.\r
  @retval EFI_BAD_BUFFER_SIZE   The size returned by the Configuration\r
                                Manager is less than the Object size for the\r
                                requested object.\r
**/\r
STATIC\r
EFI_STATUS\r
EFIAPI\r
BuildSsdtCpuTopologyTable (\r
  IN  CONST ACPI_TABLE_GENERATOR                  *CONST  This,\r
  IN  CONST CM_STD_OBJ_ACPI_TABLE_INFO            *CONST  AcpiTableInfo,\r
  IN  CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  OUT       EFI_ACPI_DESCRIPTION_HEADER          **CONST  Table\r
  )\r
{\r
  EFI_STATUS                   Status;\r
  AML_ROOT_NODE_HANDLE         RootNode;\r
  AML_OBJECT_NODE_HANDLE       ScopeNode;\r
  CM_ARM_PROC_HIERARCHY_INFO   *ProcHierarchyNodeList;\r
  UINT32                       ProcHierarchyNodeCount;\r
  ACPI_CPU_TOPOLOGY_GENERATOR  *Generator;\r
\r
  ASSERT (This != NULL);\r
  ASSERT (AcpiTableInfo != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (Table != NULL);\r
  ASSERT (AcpiTableInfo->TableGeneratorId == This->GeneratorID);\r
  ASSERT (AcpiTableInfo->AcpiTableSignature == This->AcpiTableSignature);\r
\r
  Generator = (ACPI_CPU_TOPOLOGY_GENERATOR *)This;\r
\r
  Status = AddSsdtAcpiHeader (\r
             CfgMgrProtocol,\r
             This,\r
             AcpiTableInfo,\r
             &RootNode\r
             );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  Status = AmlCodeGenScope (SB_SCOPE, RootNode, &ScopeNode);\r
  if (EFI_ERROR (Status)) {\r
    goto exit_handler;\r
  }\r
\r
  // Get the processor hierarchy info and update the processor topology\r
  // structure count with Processor Hierarchy Nodes (Type 0)\r
  Status = GetEArmObjProcHierarchyInfo (\r
             CfgMgrProtocol,\r
             CM_NULL_TOKEN,\r
             &ProcHierarchyNodeList,\r
             &ProcHierarchyNodeCount\r
             );\r
  if (EFI_ERROR (Status) &&\r
      (Status != EFI_NOT_FOUND))\r
  {\r
    goto exit_handler;\r
  }\r
\r
  if (Status == EFI_NOT_FOUND) {\r
    // If hierarchy information is not found generate a flat topology\r
    // using CM_ARM_GICC_INFO objects.\r
    Status = CreateTopologyFromGicC (\r
               Generator,\r
               CfgMgrProtocol,\r
               ScopeNode\r
               );\r
    if (EFI_ERROR (Status)) {\r
      goto exit_handler;\r
    }\r
  } else {\r
    // Generate the topology from CM_ARM_PROC_HIERARCHY_INFO objects.\r
    Generator->ProcNodeList  = ProcHierarchyNodeList;\r
    Generator->ProcNodeCount = ProcHierarchyNodeCount;\r
\r
    Status = CreateTopologyFromProcHierarchy (\r
               Generator,\r
               CfgMgrProtocol,\r
               ScopeNode\r
               );\r
    if (EFI_ERROR (Status)) {\r
      goto exit_handler;\r
    }\r
  }\r
\r
  Status = AmlSerializeDefinitionBlock (\r
             RootNode,\r
             Table\r
             );\r
  if (EFI_ERROR (Status)) {\r
    DEBUG ((\r
      DEBUG_ERROR,\r
      "ERROR: SSDT-CPU-TOPOLOGY: Failed to Serialize SSDT Table Data."\r
      " Status = %r\n",\r
      Status\r
      ));\r
    goto exit_handler;\r
  }\r
\r
exit_handler:\r
  // Delete the RootNode and its attached children.\r
  return AmlDeleteTree (RootNode);\r
}\r
\r
/** Free any resources allocated for constructing the\r
    SSDT Cpu Topology ACPI table.\r
\r
  @param [in]      This           Pointer to the table generator.\r
  @param [in]      AcpiTableInfo  Pointer to the ACPI Table Info.\r
  @param [in]      CfgMgrProtocol Pointer to the Configuration Manager\r
                                  Protocol Interface.\r
  @param [in, out] Table          Pointer to the ACPI Table.\r
\r
  @retval EFI_SUCCESS           The resources were freed successfully.\r
  @retval EFI_INVALID_PARAMETER The table pointer is NULL or invalid.\r
**/\r
STATIC\r
EFI_STATUS\r
FreeSsdtCpuTopologyTableResources (\r
  IN      CONST ACPI_TABLE_GENERATOR                  *CONST  This,\r
  IN      CONST CM_STD_OBJ_ACPI_TABLE_INFO            *CONST  AcpiTableInfo,\r
  IN      CONST EDKII_CONFIGURATION_MANAGER_PROTOCOL  *CONST  CfgMgrProtocol,\r
  IN OUT        EFI_ACPI_DESCRIPTION_HEADER          **CONST  Table\r
  )\r
{\r
  ASSERT (This != NULL);\r
  ASSERT (AcpiTableInfo != NULL);\r
  ASSERT (CfgMgrProtocol != NULL);\r
  ASSERT (AcpiTableInfo->TableGeneratorId == This->GeneratorID);\r
  ASSERT (AcpiTableInfo->AcpiTableSignature == This->AcpiTableSignature);\r
\r
  if ((Table == NULL) || (*Table == NULL)) {\r
    DEBUG ((DEBUG_ERROR, "ERROR: SSDT-CPU-TOPOLOGY: Invalid Table Pointer\n"));\r
    ASSERT ((Table != NULL) && (*Table != NULL));\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  FreePool (*Table);\r
  *Table = NULL;\r
  return EFI_SUCCESS;\r
}\r
\r
/** This macro defines the SSDT Cpu Topology Table Generator revision.\r
*/\r
#define SSDT_CPU_TOPOLOGY_GENERATOR_REVISION  CREATE_REVISION (1, 0)\r
\r
/** The interface for the SSDT Cpu Topology Table Generator.\r
*/\r
STATIC\r
ACPI_CPU_TOPOLOGY_GENERATOR  SsdtCpuTopologyGenerator = {\r
  // ACPI table generator header\r
  {\r
    // Generator ID\r
    CREATE_STD_ACPI_TABLE_GEN_ID (EStdAcpiTableIdSsdtCpuTopology),\r
    // Generator Description\r
    L"ACPI.STD.SSDT.CPU.TOPOLOGY.GENERATOR",\r
    // ACPI Table Signature\r
    EFI_ACPI_6_3_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE,\r
    // ACPI Table Revision - Unused\r
    0,\r
    // Minimum ACPI Table Revision - Unused\r
    0,\r
    // Creator ID\r
    TABLE_GENERATOR_CREATOR_ID_ARM,\r
    // Creator Revision\r
    SSDT_CPU_TOPOLOGY_GENERATOR_REVISION,\r
    // Build Table function\r
    BuildSsdtCpuTopologyTable,\r
    // Free Resource function\r
    FreeSsdtCpuTopologyTableResources,\r
    // Extended build function not needed\r
    NULL,\r
    // Extended build function not implemented by the generator.\r
    // Hence extended free resource function is not required.\r
    NULL\r
  },\r
\r
  // Private fields are defined from here.\r
\r
  // TokenTable\r
  {\r
    // Table\r
    NULL,\r
    // LastIndex\r
    0\r
  },\r
  // ProcNodeList\r
  NULL,\r
  // ProcNodeCount\r
  0\r
};\r
\r
/** Register the Generator with the ACPI Table Factory.\r
\r
  @param [in]  ImageHandle  The handle to the image.\r
  @param [in]  SystemTable  Pointer to the System Table.\r
\r
  @retval EFI_SUCCESS           The Generator is registered.\r
  @retval EFI_INVALID_PARAMETER A parameter is invalid.\r
  @retval EFI_ALREADY_STARTED   The Generator for the Table ID\r
                                is already registered.\r
**/\r
EFI_STATUS\r
EFIAPI\r
AcpiSsdtCpuTopologyLibConstructor (\r
  IN  EFI_HANDLE        ImageHandle,\r
  IN  EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS  Status;\r
\r
  Status = RegisterAcpiTableGenerator (&SsdtCpuTopologyGenerator.Header);\r
  DEBUG ((\r
    DEBUG_INFO,\r
    "SSDT-CPU-TOPOLOGY: Register Generator. Status = %r\n",\r
    Status\r
    ));\r
  ASSERT_EFI_ERROR (Status);\r
\r
  return Status;\r
}\r
\r
/** Deregister the Generator from the ACPI Table Factory.\r
\r
  @param [in]  ImageHandle  The handle to the image.\r
  @param [in]  SystemTable  Pointer to the System Table.\r
\r
  @retval EFI_SUCCESS           The Generator is deregistered.\r
  @retval EFI_INVALID_PARAMETER A parameter is invalid.\r
  @retval EFI_NOT_FOUND         The Generator is not registered.\r
**/\r
EFI_STATUS\r
EFIAPI\r
AcpiSsdtCpuTopologyLibDestructor (\r
  IN  EFI_HANDLE        ImageHandle,\r
  IN  EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS  Status;\r
\r
  Status = DeregisterAcpiTableGenerator (&SsdtCpuTopologyGenerator.Header);\r
  DEBUG ((\r
    DEBUG_INFO,\r
    "SSDT-CPU-TOPOLOGY: Deregister Generator. Status = %r\n",\r
    Status\r
    ));\r
  ASSERT_EFI_ERROR (Status);\r
  return Status;\r
}\r