From d14526372d6c86c3ea595b7a4da8c9d8c0940c22 Mon Sep 17 00:00:00 2001
From: Abdul Lateef Attar <AbdulLateef.Attar@amd.com>
Date: Thu, 18 Jan 2024 09:24:08 +0530
Subject: MdePkg: Adds AMD Extended CPU topology CPUID

Adds cpuid macro for AMD extended CPU topology.

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <gaoliming@byosoft.com.cn>
Cc: Zhiguang Liu <zhiguang.liu@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
Cc: Rahul Kumar <rahul1.kumar@intel.com>
Cc: Gerd Hoffmann <kraxel@redhat.com>
Signed-off-by: Abdul Lateef Attar <AbdulLateef.Attar@amd.com>
Message-Id: <15199aaefbc497bb1ea7b20028c13ebedd8c488b.1705549445.git.AbdulLateef.Attar@amd.com>
Acked-by: Michael D Kinney <michael.d.kinney@intel.com>
Acked-by: Ray Ni <ray.ni@intel.com>
Acked-by: Tom Lendacky <thomas.lendacky@amd.com>
---
 MdePkg/Include/Register/Amd/Cpuid.h | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

(limited to 'MdePkg')

diff --git a/MdePkg/Include/Register/Amd/Cpuid.h b/MdePkg/Include/Register/Amd/Cpuid.h
index 44394fc7a4..add43c40aa 100644
--- a/MdePkg/Include/Register/Amd/Cpuid.h
+++ b/MdePkg/Include/Register/Amd/Cpuid.h
@@ -6,7 +6,7 @@
   If a register returned is a single 32-bit value, then a data structure is
   not provided for that register.
 
-  Copyright (c) 2017, Advanced Micro Devices. All rights reserved.<BR>
+  Copyright (c) 2017 - 2024, Advanced Micro Devices. All rights reserved.<BR>
 
   SPDX-License-Identifier: BSD-2-Clause-Patent
 
@@ -42,6 +42,27 @@ CPUID Signature Information
 /// @}
 ///
 
+/**
+  CPUID Extended Topology Enumeration
+
+  @note
+  Reference: AMD64 Architecture Programmer’s Manual Volume 3: General-Purpose and System Instructions,
+             Revision 3.35 Appendix E,
+  E.4.24 Function 8000_0026—Extended CPU Topology:
+    CPUID Fn8000_0026 reports extended topology information for logical processors, including
+    asymmetric and heterogenous topology descriptions. Individual logical processors may report
+    different values in systems with asynchronous and heterogeneous topologies.
+    The topology level is selected by the value passed to the instruction in ECX. To discover the topology
+    of a system, software should execute CPUID Fn8000_0026 with increasing ECX values, starting with
+    a value of zero, until the returned hierarchy level type (CPUID Fn8000_0026_ECX[LevelType]) is
+    equal to zero. It is not guaranteed that all topology level types are present in the system
+
+  @param   EAX  AMD_CPUID_EXTENDED_TOPOLOGY   (0x80000026)
+  @param   ECX  Level number
+
+**/
+#define AMD_CPUID_EXTENDED_TOPOLOGY  0x80000026
+
 /**
   CPUID Extended Processor Signature and Features
 
-- 
cgit