public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers
@ 2021-02-01  1:36 Heng Luo
  2021-02-01  1:36 ` [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers Heng Luo
                   ` (39 more replies)
  0 siblings, 40 replies; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Create the TigerlakeSiliconPkg to provide an initial package for
silicon initialization code for Tiger Lake (TGL) products.

* Major areas of functionality are categorized into CPU, IpBlock, Fru,
  Platform Controller Hub (PCH), and System Agent subdirectories.
* Common libraries and headers are kept at the root of the package.

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h                       |   67 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPreMemConfig.h             |   86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/CpuPcieConfigGen3.h      |  347 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/CpuPcieConfig.h          |  490 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h                         |   72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h                       |   61 ++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h                       |  170 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h                         |   33 +++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h                         |   31 +++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig.h                    |   37 ++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/GraphicsConfig.h         |  211 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.h                     |  227 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBridgeConfig.h           |   62 ++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/HybridGraphicsConfig.h   |   66 +++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/HybridStorageConfig.h     |   36 +++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h                         |   34 ++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h                         |  134 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.h                  |   58 ++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h                     |   60 +++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h                        |  117 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/MemoryConfig.h              |  478 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/OverclockingConfig.h       |  236 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h                       |   34 ++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfig.h                   |   44 +++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/PchPcieRpConfig.h      |  368 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h                     |  213 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h                         |   86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h                          |  391 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h                         |   32 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h                         |   82 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h                         |   38 +++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h                       |  168 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h                         |  139 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfig.h               |   32 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h                              |  152 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h                        |   67 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig.h                     |   50 ++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h                         |   43 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h                    |  145 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h                         |   73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalConfig.h                 |  153 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubConfig.h               |  101 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.h                     |   81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.h                    |  138 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h                         |  149 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h |  114 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h                         |   64 ++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfig.h                    |   31 +++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec                                                   | 1208 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 49 files changed, 7309 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
new file mode 100644
index 0000000000..de1f4159f0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
@@ -0,0 +1,67 @@
+/** @file
+  CNVi policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CNVI_CONFIG_H_
+#define _CNVI_CONFIG_H_
+
+#define CNVI_CONFIG_REVISION 1
+extern EFI_GUID gCnviConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CNVi Mode options
+**/
+typedef enum {
+  CnviModeDisabled = 0,
+  CnviModeAuto
+} CNVI_MODE;
+
+
+/**
+  CNVi signals pin muxing settings. If signal can be enable only on a single pin
+  then this parameter is ignored by RC. Refer to GPIO_*_MUXING_CNVI_* in GpioPins*.h
+  for supported settings on a given platform
+**/
+typedef struct {
+  UINT32 RfReset; ///< RF_RESET# Pin mux configuration. Refer to GPIO_*_MUXING_CNVI_RF_RESET_*
+  UINT32 Clkreq;  ///< CLKREQ Pin mux configuration. Refer to GPIO_*_MUXING_CNVI_*_CLKREQ_*
+} CNVI_PIN_MUX;
+
+/**
+  The CNVI_CONFIG block describes the expected configuration of the CNVi IP.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;      ///< Config Block Header
+  /**
+    This option allows for automatic detection of Connectivity Solution.
+    Auto Detection assumes that CNVi will be enabled when available;
+    Disable allows for disabling CNVi.
+    CnviModeDisabled = Disabled,
+    <b>CnviModeAuto = Auto Detection</b>
+  **/
+  UINT32 Mode                  :  1;
+  UINT32 BtCore                :  1; ///< The option to turn ON or OFF the BT Core. 0: Disabled, <b>1: Enabled</b>
+  /**
+    The option to enable or disable BT Audio Offload.
+    <b>0: Disabled</b>, 1: Enabled
+    @note This feature only support with Intel(R) Wireless-AX 22560
+  **/
+  UINT32 BtAudioOffload        :  1;
+  UINT32 RsvdBits              : 29;
+  /**
+    CNVi PinMux Configuration
+    RESET#/CLKREQ to CRF, can have two alternative mappings, depending on board routing requirements.
+  **/
+  CNVI_PIN_MUX          PinMux;
+} CNVI_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CNVI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPreMemConfig.h
new file mode 100644
index 0000000000..527febb0a4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPreMemConfig.h
@@ -0,0 +1,86 @@
+/** @file
+  DMI policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_DMI_PREMEM_CONFIG_H_
+#define _CPU_DMI_PREMEM_CONFIG_H_
+
+#include <ConfigBlock.h>
+#include <Register/SaRegsHostBridge.h>
+
+#define DMI_CONFIG_REVISION 1
+
+#define CPU_DMI_HWEQ_COEFFS_MAX    8
+
+#pragma pack (push,1)
+///
+/// The values before AutoConfig match the setting of PCI Express Base Specification 1.1, please be careful for adding new feature
+///
+typedef enum {
+  DmiAspmDisabled,
+  DmiAspmL0s,
+  DmiAspmL1,
+  DmiAspmL0sL1,
+  DmiAspmAutoConfig,
+  DmiAspmMax
+} DMI_ASPM;
+
+
+/**
+  The CPU_DMI_CONFIG block describes the expected configuration of the CPU for DMI.
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+
+/**
+  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
+  - Gen1        (0x1)  : Limit Link to Gen1 Speed
+  - Gen2        (0x2)  : Limit Link to Gen2 Speed    CpuDmiPreMemConfig
+  - Gen3        (0x3)  : Limit Link to Gen3 Speed
+  **/
+  UINT8                  DmiMaxLinkSpeed;
+  /**
+   <b>(Test)</b> DMI Equalization Phase 2 Enable Control
+  - Disabled       (0x0) : Disable phase 2
+  - Enabled        (0x1) : Enable phase 2
+  - <b>Auto</b>    (0x2) : Use the current default method (Default)
+  **/
+  UINT8                  DmiGen3EqPh2Enable;
+  /**
+   <b>(Test)</b> Selects the method for performing Phase3 of Gen3 Equalization on DMI
+  - <b>Auto</b> (0x0)  : Use the current default method (Default)
+  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
+  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in BIOS Reference Code)
+  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset array for Phase1 AND Phase3 (Instead of just Phase1)
+  - Disabled    (0x4)  : Bypass Equalization Phase 3
+  **/
+  UINT8                  DmiGen3EqPh3Method;
+  /**
+   <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT8                  DmiGen3ProgramStaticEq;
+  UINT8                  DmiDeEmphasis;                               ///< DeEmphasis control for DMI (-6 dB and -3.5 dB are the options)
+  UINT8                  DmiAspm;
+  UINT8                  DmiAspmCtrl;                                 ///< ASPM configuration on the CPU side of the DMI/OPI Link. Default is <b>DmiAspmAutoConfig</b>
+  UINT8                  DmiAspmL1ExitLatency;                        ///< ASPM configuration on the CPU side of the DMI/OPI Link. Default is <b>DmiAspmAutoConfig</b>
+  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE];      ///< Used for programming DMI Gen3 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE];      ///< Used for programming DMI Gen3 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE];        ///< Hint value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is default for each lane
+
+  /**
+   DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15). This setting
+   has to be specified based upon platform design and must follow the guideline. Default is 12.
+  **/
+
+  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE];
+} CPU_DMI_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_DMI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/CpuPcieConfigGen3.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/CpuPcieConfigGen3.h
new file mode 100644
index 0000000000..593e63b4f1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/CpuPcieConfigGen3.h
@@ -0,0 +1,347 @@
+/** @file
+Pcie root port policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CPU_PCIE_CONFIG_GEN3_H_
+#define _CPU_PCIE_CONFIG_GEN3_H_
+
+#include <Library/GpioLib.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <PcieConfig.h>
+#include <ConfigBlock.h>
+#include <Register/SaRegsHostBridge.h>
+
+#pragma pack(push, 1)
+
+#define CPU_PCIE_PEI_PREMEM_CONFIG_GEN3_REVISION 1
+
+#define L0_SET                            BIT0
+#define L1_SET                            BIT1
+
+
+///
+/// SA GPIO Data Structure
+///
+typedef struct {
+  GPIO_PAD      GpioPad;        ///< Offset 0: GPIO Pad
+  UINT8         Value;          ///< Offset 4: GPIO Value
+  UINT8         Rsvd0[3];       ///< Offset 5: Reserved for 4 bytes alignment
+  UINT32        Active : 1;     ///< Offset 8: 0=Active Low; 1=Active High
+  UINT32        RsvdBits0 : 31;
+} SA_GPIO_INFO_PCIE;
+
+///
+/// SA Board PEG GPIO Info
+///
+typedef struct {
+  SA_GPIO_INFO_PCIE  SaPeg0ResetGpio;    ///< Offset 0:  PEG0 PERST# GPIO assigned, must be a PCH GPIO pin
+  SA_GPIO_INFO_PCIE  SaPeg3ResetGpio;    ///< Offset 12: PEG3 PERST# GPIO assigned, must be a PCH GPIO pin
+  BOOLEAN            GpioSupport;        ///< Offset 24: 1=Supported; 0=Not Supported
+  UINT8              Rsvd0[3];           ///< Offset 25: Reserved for 4 bytes alignment
+} PEG_GPIO_DATA;
+
+/**
+PCI Express and DMI controller configuration\n
+@note <b>Optional.</b> These policies will be ignored if there is no PEG port present on board.
+<b>Revision 1</b>:
+- Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER    Header;                                      ///< Offset 0-27 Config Block Header
+  /**
+  Offset 28:0 :
+  <b>(Test)</b> DMI Link Speed Control
+  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
+  - Gen1        (0x1)  : Limit Link to Gen1 Speed
+  - Gen2        (0x2)  : Limit Link to Gen2 Speed
+  - Gen3        (0x3)  : Limit Link to Gen3 Speed
+  **/
+  UINT8                  DmiMaxLinkSpeed;
+  /**
+  Offset 28:2 :
+  <b>(Test)</b> DMI Equalization Phase 2 Enable Control
+  - Disabled       (0x0) : Disable phase 2
+  - Enabled        (0x1) : Enable phase 2
+  - <b>Auto</b>    (0x2) : Use the current default method (Default)
+  **/
+  UINT8                  DmiGen3EqPh2Enable;
+  /**
+  Offset 28:4 :
+  <b>(Test)</b> Selects the method for performing Phase3 of Gen3 Equalization on DMI
+  - <b>Auto</b> (0x0)  : Use the current default method (Default)
+  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
+  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in BIOS Reference Code)
+  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset array for Phase1 AND Phase3 (Instead of just Phase1)
+  - Disabled    (0x4)  : Bypass Equalization Phase 3
+  **/
+  UINT8                  DmiGen3EqPh3Method;
+  /**
+  Offset 28:7 :
+  <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT8                  DmiGen3ProgramStaticEq;
+
+  /**
+  Offset 28:8 to 28:15 :
+  <b>(Test)</b> PEG Enable Control
+  - Disabled    (0x0)  : Disable PEG Port
+  - Enabled     (0x1)  : Enable PEG Port (If Silicon SKU permits it)
+  - <b>Auto</b> (0x2)  : If an endpoint is present, enable the PEG Port, Disable otherwise (Default)
+  **/
+  UINT8                  Peg0Enable;        ///< Enable/Disable PEG 0:1:0 Root Port
+  UINT8                  Peg1Enable;        ///< <b>(Test)</b> Enable/Disable PEG 0:1:1 Root Port
+  UINT8                  Peg2Enable;        ///< <b>(Test)</b> Enable/Disable PEG 0:1:2 Root Port
+  UINT8                  Peg3Enable;        ///< <b>(Test)</b> Enable/Disable PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+
+  /**
+  Offset 28:16 :
+  <b>(Test)</b> PCIe Link Speed Control
+  - <b>Auto</b> (0x0)  : Maximum possible Link speed (Default)
+  - Gen1        (0x1)  : Limit Link to Gen1 Speed
+  - Gen2        (0x2)  : Limit Link to Gen2 Speed
+  - Gen3        (0x3)  : Limit Link to Gen3 Speed
+  **/
+  UINT8                  Peg0MaxLinkSpeed;        ///< PCIe Link Speed Control for PEG 0:1:0 Root Port.
+  UINT8                  Peg1MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link Speed Control for PEG 0:1:1 Root Port.
+  UINT8                  Peg2MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link Speed Control for PEG 0:1:2 Root Port.
+  UINT8                  Peg3MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link Speed Control for PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+
+  /**
+  Offset 32:0 :
+  <b>(Test)</b> PCIe Link Width Control
+  - <b>Auto</b> (0x0)  : Maximum possible Link width (Default)
+  - X1          (0x1)  : Limit Link to X1 Width
+  - X2          (0x2)  : Limit Link to X2 Width
+  - X4          (0x3)  : Limit Link to X4 Width
+  - X8          (0x4)  : Limit Link to X8 Width
+  **/
+  UINT8                  Peg0MaxLinkWidth;        ///< PCIe Link Width Control for PEG 0:1:0 Root Port.
+  UINT8                  Peg1MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width Control for PEG 0:1:1 Root Port.
+  UINT8                  Peg2MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width Control for PEG 0:1:2 Root Port.
+  UINT8                  Peg3MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width Control for PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+  /**
+  Offset 32:12 to 32:15 :
+  Power down unused lanes on the PEG Root Port.
+  - Disabled     (0x0) : No power saving.
+  - <b>Auto</b>  (0x1) : Bios will power down unused lanes based on the max possible link width
+  **/
+  UINT8                  Peg0PowerDownUnusedLanes;        ///< Power down unused lanes on the PEG 0:1:0 Root Port.
+  UINT8                  Peg1PowerDownUnusedLanes;        ///< Power down unused lanes on the PEG 0:1:1 Root Port.
+  UINT8                  Peg2PowerDownUnusedLanes;        ///< Power down unused lanes on the PEG 0:1:2 Root Port.
+  UINT8                  Peg3PowerDownUnusedLanes;        ///< Power down unused lanes on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+
+  /**
+  Offset 32:16 to 32:23 :
+  <b>(Test)</b> PCIe Equalization Phase 2 Enable Control
+  - Disabled       (0x0) : Disable phase 2
+  - Enabled        (0x1) : Enable phase 2
+  - <b>Auto</b>    (0x2) : Use the current default method (Default)
+  **/
+  UINT8                  Peg0Gen3EqPh2Enable;        ///< Phase2 EQ enable on the PEG 0:1:0 Root Port.
+  UINT8                  Peg1Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ enable on the PEG 0:1:1 Root Port.
+  UINT8                  Peg2Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ enable on the PEG 0:1:2 Root Port.
+  UINT8                  Peg3Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ enable on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+
+  /**
+  Offset 36:0 to 36:11 :
+  <b>(Test)</b> Select the method for performing Phase3 of Gen3 Equalization.
+  - <b>Auto</b> (0x0)  : Use the current default method (Default)
+  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
+  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in BIOS Reference Code)
+  - Static      (0x3)  : Use the Static EQs provided in PegGen3EndPointPreset array for Phase1 AND Phase3 (Instead of just Phase1)
+  - Disabled    (0x4)  : Bypass Equalization Phase 3
+  **/
+  UINT8                  Peg0Gen3EqPh3Method;        ///< Phase3 EQ method on the PEG 0:1:0 Root Port.
+  UINT8                  Peg1Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3 EQ method on the PEG 0:1:1 Root Port.
+  UINT8                  Peg2Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3 EQ method on the PEG 0:1:2 Root Port.
+  UINT8                  Peg3Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3 EQ method on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
+  /**
+  Offset 36:12 :
+  <b>(Test)</b> Program PEG Gen3 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT8                  PegGen3ProgramStaticEq;
+  /**
+  Offset 36:13 :
+  <b>(Test)</b> Always Attempt Gen3 Software Equalization
+
+  When enabled, Gen3 Software Equalization will be executed every boot.  When disabled, it will be only executed if the CPU
+  or EP is changed, otherwise it is skipped and the previous EQ value will be re-used.
+
+  This setting will only have an effect if Software Equalization is enabled and OEM Platform Code implements
+  save/restore of the PegDataPtr data (see below).  If PegDataPtr is not saved/restored RC forces this to be enabled.
+
+  - <b>Disabled</b> (0x0)  : Reuse EQ settings saved/restored from NVRAM whenever possible (Default)
+  - Enabled         (0x1)  : Re-test and generate new EQ values every boot, not recommended
+  **/
+  UINT8                  Gen3SwEqAlwaysAttempt;
+  /**
+  Offset 36:14 to 36:16 :
+  <b>(Test)</b> Select number of TxEq presets to test in the PCIe/DMI Software Equalization Algorithm
+  - P7,P3,P5,P8 (0x0)  : Test Presets 7, 3, 5, and 8
+  - P0-P9       (0x1)  : Test Presets 0-9
+  - <b>Auto</b> (0x2)  : Use the current default method (Default)
+  Auto will test Presets 7, 3, 5, and 8.  It is possible for this default to change over time;
+  using "Auto" will ensure Reference Code always uses the latest default settings.
+  @warning Do not change from the default.  Hard to detect issues are likely.
+  **/
+  UINT8                  Gen3SwEqNumberOfPresets;
+  /**
+  Offset 36:17 to 36:18:
+  <b>(Test)</b> Offset 36 Enable use of the Voltage Offset and Centering Test in the PCIe Software Equalization Algorithm
+  - Disabled     (0x0) : Disable VOC Test
+  - Enabled      (0x1) : Enable VOC Test
+  - <b>Auto</b>  (0x2) : Use the current default (Default)
+  **/
+  UINT8                  Gen3SwEqEnableVocTest;
+  /**
+  Offset 36:19 :
+  Select when PCIe ASPM programming will happen in relation to the Oprom
+  - <b>Before</b> (0x0) : Do PCIe ASPM programming before Oprom. (Default)
+  - After         (0x1) : Do PCIe ASPM programming after Oprom. This will require an SMI handler to save/restore ASPM settings.
+  **/
+  UINT8                  InitPcieAspmAfterOprom;
+  /**
+  Offset 36:20 :
+  <b>(Test)</b> PCIe Rx Compliance Testing Mode
+  - <b>Disabled</b> (0x0) : Normal Operation             - Disable PCIe Rx Compliance testing (Default)
+  - Enabled         (0x1) : PCIe Rx Compliance Test Mode - PEG controller is in Rx Compliance Testing Mode; it should only be set when doing PCIe compliance testing
+  **/
+  UINT8                  PegRxCemTestingMode;
+
+  /**
+  Offset 36:21 to 36:24 :
+  <b>(Test)</b> PCIe Rx Compliance Loopback Lane
+
+  When PegRxCemTestingMode is Enabled, the specificied Lane (0 - 15) will be
+  used for RxCEMLoopback.
+
+  Default is Lane 0.
+  **/
+  UINT8                  PegRxCemLoopbackLane;
+  /**
+  Offset 36:25 to 36:28 :
+  <b>(Test)</b> Generate PCIe BDAT Margin Table. Set this policy to enable the generation and addition of PCIe margin data to the BDAT table.
+  - <b>Disabled</b> (0x0) : Normal Operation          - Disable PCIe BDAT margin data generation (Default)
+  - PortData        (0x1) : Port Data                 - Generate PCIe BDAT margin data
+  **/
+  UINT8                 PegGenerateBdatMarginTable;
+  /**
+  Offset 36:29 :
+  <b>(Test)</b> PCIe Non-Protocol Awareness for Rx Compliance Testing
+  - <b>Disabled</b> (0x0) : Normal Operation                - Disable non-protocol awareness (Default)
+  - Enabled         (0x1) : Non-Protocol Awareness Enabled  - Enable non-protocol awareness for compliance testing
+  **/
+  UINT8                  PegRxCemNonProtocolAwareness;
+  /**
+  Offset 36:30 :
+  <b>(Test)</b> PCIe Disable Spread Spectrum Clocking. This feature should be TRUE only for compliance testing
+  - <b>False</b>          (0x0) : Normal Operation                 - SSC enabled  (Default)
+  - True                  (0x1) : Disable SSC                      - Disable SSC for compliance testing
+  **/
+  UINT8                  PegDisableSpreadSpectrumClocking;
+
+  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE_VER1];      ///< Offset 40 Used for programming DMI Gen3 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE_VER1];      ///< Offset 44 Used for programming DMI Gen3 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE_VER1];        ///< Offset 48 Hint value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is default for each lane
+  /**
+  Offset 48/60 :
+  DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15). This setting
+  has to be specified based upon platform design and must follow the guideline. Default is 12.
+  **/
+
+  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE_VER1];
+
+  UINT8                  PegGen3RootPortPreset[SA_PEG_MAX_LANE_GEN3];      ///< Offset 54 <b>(Test)</b> Used for programming PEG Gen3 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  PegGen3EndPointPreset[SA_PEG_MAX_LANE_GEN3];      ///< Offset 70 <b>(Test)</b> Used for programming PEG Gen3 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  PegGen3EndPointHint[SA_PEG_MAX_LANE_GEN3];        ///< Offset 86 <b>(Test)</b> Hint value per lane for the PEG Gen3 End Point. Range: 0-6, 2 is default for each lane
+  /**
+  Offset 102:
+  PCIe Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15). This setting
+  has to be specified based upon platform design and must follow the guideline. Default is 12.
+  **/
+  UINT8                  PegGen3RxCtlePeaking[SA_PEG_MAX_BUNDLE_GEN3];
+  /**
+  Offset 110:
+  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535, default is 1000.
+  @warning Do not change from the default.  Hard to detect issues are likely.
+  @note An attack on this policy could result in an apparent hang,
+  but the system will eventually boot.  This variable should be protected.
+  **/
+  UINT16                 Gen3SwEqJitterDwellTime;
+  /**
+  Offset 112:
+  This is a memory data pointer for saved preset search results. The reference code will store
+  the Gen3 Preset Search results in the SaPegHob. In order to skip the Gen3
+  preset search on boots where the PEG card configuration has not changed since the previous boot,
+  platform code can save the contents of the SaPegHob in DXE (When it present and for size reported by Header.HobLength)
+  and provide a pointer to a restored copy of that data. Default value is NULL, which results in a full
+  preset search every boot.
+
+  @note An attack on this policy could prevent the PCIe display from working until a boot when
+  PegDataPtr is NULL or Gen3SwEqAlwaysAttempt is enabled.  The variable used to save the
+  preset search results should be protected in a way that it can only be modified by the
+  platform manufacturer.
+  **/
+  VOID                   *PegDataPtr;
+  /**
+  Offset 116:
+  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535, default is 1.
+  @warning Do not change from the default.  Hard to detect issues are likely.
+  **/
+  UINT16                 Gen3SwEqJitterErrorTarget;
+
+  /**
+  Offset 118:
+  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535, default is 10000.
+  @warning Do not change from the default.  Hard to detect issues are likely.
+  @note An attack on this policy could result in an apparent hang,
+  but the system will eventually boot.  This variable should be protected.
+  **/
+  UINT16                  Gen3SwEqVocDwellTime;
+
+  /**
+  Offset 120:
+  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535, default is 2.
+  @warning Do not change from the default.  Hard to detect issues are likely.
+  **/
+  UINT16                 Gen3SwEqVocErrorTarget;
+  /**
+  Offset 122:
+  PCIe Hot Plug Enable/Disable. It has 2 policies.
+  - Disabled (0x0)     : No hotplug.
+  - Enabled (0x1)      : Bios assist hotplug.
+  **/
+  UINT8                  PegRootPortHPE[SA_PEG_MAX_FUN_GEN3];
+  UINT8                  DmiDeEmphasis;                               ///< Offset 125 This field is used to describe the DeEmphasis control for DMI (-6 dB and -3.5 dB are the options)
+  UINT8                  Rsvd0[3];                                    ///< Offset 126
+  /**
+  Offset 128:
+  This contains the PCIe PERST# GPIO information.  This structure is required
+  for PCIe Gen3 operation. The reference code will use the information in this structure in
+  order to reset PCIe Gen3 devices during equalization, if necessary.  Refer to the Platform
+  Developer's Guide (PDG) for additional details.
+  **/
+  PEG_GPIO_DATA          PegGpioData;
+
+  /**
+  Offset 156
+  <b>(Test)</b> PCIe Override RxCTLE. This feature should only be true to disable RxCTLE adaptive behavior for compliance testing
+  - <b>False</b>          (0x0) : Normal Operation                 - RxCTLE adaptive behavior enabled  (Default)
+  - True                  (0x1) : Override RxCTLE                  - Disable RxCTLE adaptive behavior to keep the configured RxCTLE peak values unmodified
+  From CFL onwards, modularity is introduced to this setup option so that the RxCTLE adaptive behavior could be controlled at the controller level.
+  Making this variable a UINT8 to accomodate the values of all controllers as bit definition
+  **/
+  UINT8                 PegGen3RxCtleOverride;
+
+} PCIE_PEI_PREMEM_CONFIG_GEN3;
+
+#pragma pack (pop)
+
+#endif // _CPU_PCIE_CONFIG_GEN3_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/CpuPcieConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/CpuPcieConfig.h
new file mode 100644
index 0000000000..5941b6ad4a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/CpuPcieConfig.h
@@ -0,0 +1,490 @@
+/** @file
+  Pcie root port policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CPU_PCIE_CONFIG_H_
+#define _CPU_PCIE_CONFIG_H_
+
+#include <Library/GpioLib.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <PcieConfig.h>
+#include <ConfigBlock.h>
+#include <Register/SaRegsHostBridge.h>
+
+#pragma pack(push, 1)
+
+#define CPU_PCIE_PEI_PREMEM_CONFIG_REVISION 1
+#define CPU_PCIE_RP_PREMEM_CONFIG_REVISION  4
+
+/**
+ Making any setup structure change after code frozen
+ will need to maintain backward compatibility, bump up
+ structure revision and update below history table\n
+  <b>Revision 1</b>:  - Initial version.
+  <b>Revision 2</b>:  - Add Gen3TxOverride and Gen4TxOverride
+  <b>Revision 3</b>:  - Deprecate Dekel Suqelch Workaround Setup Variable
+  <b>Revision 4</b>:  - Add FOMS Control Policy Setup Variable
+  <b>Revision 5</b>:  - Add Gen3HwEqOverride and Gen4HwEqOverride
+  <b>Revision 6</b>:  - Align revision with CPU_PCIE_RP_CONFIG_REVISION value
+**/
+
+#define CPU_PCIE_RP_CONFIG_REVISION         6
+
+#define L0_SET                            BIT0
+#define L1_SET                            BIT1
+
+
+
+
+/**
+ PCI Express and DMI controller configuration\n
+ @note <b>Optional.</b> These policies will be ignored if there is no PEG port present on board.
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER    Header;                                      ///< Offset 0-27 Config Block Header
+  /**
+   Offset 28:0 :
+   <b>(Test)</b> DMI Link Speed Control
+  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
+  - Gen1        (0x1)  : Limit Link to Gen1 Speed
+  - Gen2        (0x2)  : Limit Link to Gen2 Speed
+  - Gen3        (0x3)  : Limit Link to Gen3 Speed
+  **/
+  UINT32                 DmiMaxLinkSpeed                 :  2;
+  /**
+   Offset 28:2 :
+   <b>(Test)</b> DMI Equalization Phase 2 Enable Control
+  - Disabled       (0x0) : Disable phase 2
+  - Enabled        (0x1) : Enable phase 2
+  - <b>Auto</b>    (0x2) : Use the current default method (Default)
+  **/
+  UINT32                 DmiGen3EqPh2Enable              :  2;
+  /**
+   Offset 28:4 :
+   <b>(Test)</b> Selects the method for performing Phase3 of Gen3 Equalization on DMI
+  - <b>Auto</b> (0x0)  : Use the current default method (Default)
+  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
+  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in BIOS Reference Code)
+  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset array for Phase1 AND Phase3 (Instead of just Phase1)
+  - Disabled    (0x4)  : Bypass Equalization Phase 3
+  **/
+  UINT32                 DmiGen3EqPh3Method              :  3;
+  /**
+   Offset 28:7 :
+   <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT32                 DmiGen3ProgramStaticEq          :  1;
+  UINT32                 RsvdBits0                       :  24;        ///< Offset 28:8 :Reserved for future use
+
+  /**
+  Offset 32:0 :
+  Select when PCIe ASPM programming will happen in relation to the Oprom
+  - <b>Before</b> (0x0) : Do PCIe ASPM programming before Oprom. (Default)
+  - After         (0x1) : Do PCIe ASPM programming after Oprom. This will require an SMI handler to save/restore ASPM settings.
+  **/
+  UINT32                 InitPcieAspmAfterOprom : 1;
+  UINT32                 RsvdBits1 : 31;        ///< Offset 32:1 :Reserved for future use
+
+  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE];      ///< Offset 36 Used for programming DMI Gen3 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE];      ///< Offset 40/44 Used for programming DMI Gen3 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE];        ///< Offset 44/52 Hint value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is default for each lane
+  /**
+   Offset 48/60 :
+   DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15). This setting
+   has to be specified based upon platform design and must follow the guideline. Default is 12.
+  **/
+
+  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE];
+
+  UINT8                  DmiDeEmphasis;                               ///< Offset 64 This field is used to describe the DeEmphasis control for DMI (-6 dB and -3.5 dB are the options)
+  UINT8                  Rsvd0[3];                                    ///< Offset 65
+} PCIE_PEI_PREMEM_CONFIG;
+
+
+/**
+  CPU PCIe Root Port Pre-Memory Configuration
+  Contains Root Port settings and capabilities
+  <b>Revision 1</b>:  - Initial version.
+  <b>Revision 2</b>:  - Adding Dekel Suqelch Workaround Setup Variable
+  <b>Revision 3</b>:  - Deprecate Dekel Suqelch Workaround Setup Variable
+  <b>Revision 4</b>:  - Adding CDR Relock Setup Variable
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                                ///< Config Block Header
+  /**
+  Root Port enabling mask.
+  Bit0 presents RP1, Bit1 presents RP2, and so on.
+  0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                RpEnabledMask;
+  /**
+  Assertion on Link Down GPIOs
+  - <b>Disabled</b> (0x0) : Disable assertion on Link Down GPIOs(Default)
+  - Enabled         (0x1) : Enable assertion on Link Down GPIOs
+  **/
+  UINT8                 LinkDownGpios;
+  /**
+  Enable ClockReq Messaging
+  - <b>Disabled</> (0x0) : Disable ClockReq Messaging(Default)
+  - Enabled        (0x1) : Enable ClockReq Messaging
+  **/
+  UINT8                 ClkReqMsgEnable;
+  /**
+  Dekel Recipe Workaround
+  <b>2</b>
+  1=Minimal, 9=Maximum,
+  **/
+  UINT8                 DekelSquelchWa;  // Deprecated variable
+  UINT8                 Rsvd0[1];
+  /**
+  Determines each PCIE Port speed capability.
+  <b>0: Auto</b>; 1: Gen1; 2: Gen2; 3: Gen3; 4: Gen4 (see: CPU_PCIE_SPEED)
+  **/
+  UINT8                 PcieSpeed[CPU_PCIE_MAX_ROOT_PORTS];
+  /**
+  To Enable/Disable CDR Relock
+  <b>0: Disable</b>; 1: Enable
+  **/
+  UINT8                 CdrRelock[CPU_PCIE_MAX_ROOT_PORTS];
+  /**
+  This policy is used while programming DEKEL Recipe
+  <b>0: Disable</b>; 1: Enable
+  **/
+  UINT8                 Xl1el[CPU_PCIE_MAX_ROOT_PORTS];
+
+} CPU_PCIE_RP_PREMEM_CONFIG;
+
+typedef enum {
+  CpuPcieOverrideDisabled             = 0,
+  CpuPcieL1L2Override                 = 0x01,
+  CpuPcieL1SubstatesOverride          = 0x02,
+  CpuPcieL1L2AndL1SubstatesOverride   = 0x03,
+  CpuPcieLtrOverride                  = 0x04
+} CPU_PCIE_OVERRIDE_CONFIG;
+
+/**
+  PCIe device table entry entry
+
+  The PCIe device table is being used to override PCIe device ASPM settings.
+  To take effect table consisting of such entries must be instelled as PPI
+  on gPchPcieDeviceTablePpiGuid.
+  Last entry VendorId must be 0.
+**/
+typedef struct {
+  UINT16  VendorId;                    ///< The vendor Id of Pci Express card ASPM setting override, 0xFFFF means any Vendor ID
+  UINT16  DeviceId;                    ///< The Device Id of Pci Express card ASPM setting override, 0xFFFF means any Device ID
+  UINT8   RevId;                       ///< The Rev Id of Pci Express card ASPM setting override, 0xFF means all steppings
+  UINT8   BaseClassCode;               ///< The Base Class Code of Pci Express card ASPM setting override, 0xFF means all base class
+  UINT8   SubClassCode;                ///< The Sub Class Code of Pci Express card ASPM setting override, 0xFF means all sub class
+  UINT8   EndPointAspm;                ///< Override device ASPM (see: CPU_PCIE_ASPM_CONTROL)
+                                       ///< Bit 1 must be set in OverrideConfig for this field to take effect
+  UINT16  OverrideConfig;              ///< The override config bitmap (see: CPU_PCIE_OVERRIDE_CONFIG).
+  /**
+    The L1Substates Capability Offset Override. (applicable if bit 2 is set in OverrideConfig)
+    This field can be zero if only the L1 Substate value is going to be override.
+  **/
+  UINT16  L1SubstatesCapOffset;
+  /**
+    L1 Substate Capability Mask. (applicable if bit 2 is set in OverrideConfig)
+    Set to zero then the L1 Substate Capability [3:0] is ignored, and only L1s values are override.
+    Only bit [3:0] are applicable. Other bits are ignored.
+  **/
+  UINT8   L1SubstatesCapMask;
+  /**
+    L1 Substate Port Common Mode Restore Time Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sCommonModeRestoreTime;
+  /**
+    L1 Substate Port Tpower_on Scale Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sTpowerOnScale;
+  /**
+    L1 Substate Port Tpower_on Value Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sTpowerOnValue;
+
+  /**
+    SnoopLatency bit definition
+    Note: All Reserved bits must be set to 0
+
+    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                  When clear values in bits 9:0 will be ignored
+    BITS[14:13] - Reserved
+    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                  000b - 1 ns
+                  001b - 32 ns
+                  010b - 1024 ns
+                  011b - 32,768 ns
+                  100b - 1,048,576 ns
+                  101b - 33,554,432 ns
+                  110b - Reserved
+                  111b - Reserved
+    BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied with
+                  the scale in bits 12:10
+
+    This field takes effect only if bit 3 is set in OverrideConfig.
+  **/
+  UINT16  SnoopLatency;
+  /**
+    NonSnoopLatency bit definition
+    Note: All Reserved bits must be set to 0
+
+    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                  When clear values in bits 9:0 will be ignored
+    BITS[14:13] - Reserved
+    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                  000b - 1 ns
+                  001b - 32 ns
+                  010b - 1024 ns
+                  011b - 32,768 ns
+                  100b - 1,048,576 ns
+                  101b - 33,554,432 ns
+                  110b - Reserved
+                  111b - Reserved
+    BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be multiplied with
+                  the scale in bits 12:10
+
+    This field takes effect only if bit 3 is set in OverrideConfig.
+  **/
+  UINT16  NonSnoopLatency;
+
+  /**
+    Forces LTR override to be permanent
+    The default way LTR override works is:
+      rootport uses LTR override values provided by BIOS until connected device sends an LTR message, then it will use values from the message
+    This settings allows force override of LTR mechanism. If it's enabled, then:
+      rootport will use LTR override values provided by BIOS forever; LTR messages sent from connected device will be ignored
+  **/
+  UINT8  ForceLtrOverride;
+  UINT8  Reserved[3];
+} CPU_PCIE_DEVICE_OVERRIDE;
+
+enum CPU_PCIE_SPEED {
+  CpuPcieAuto,
+  CpuPcieGen1,
+  CpuPcieGen2,
+  CpuPcieGen3,
+  CpuPcieGen4,
+  CpuPcieGen5
+};
+
+///
+/// The values before AutoConfig match the setting of PCI Express Base Specification 1.1, please be careful for adding new feature
+///
+typedef enum {
+  CpuPcieAspmDisabled,
+  CpuPcieAspmL0s,
+  CpuPcieAspmL1,
+  CpuPcieAspmL0sL1,
+  CpuPcieAspmAutoConfig,
+  CpuPcieAspmMax
+} CPU_PCIE_ASPM_CONTROL;
+
+/**
+  Refer to SA EDS for the SA implementation values corresponding
+  to below PCI-E spec defined ranges
+**/
+typedef enum {
+  CpuPcieL1SubstatesDisabled,
+  CpuPcieL1SubstatesL1_1,
+  CpuPcieL1SubstatesL1_1_2,
+  CpuPcieL1SubstatesMax
+} CPU_PCIE_L1SUBSTATES_CONTROL;
+
+enum CPU_PCIE_MAX_PAYLOAD {
+  CpuPcieMaxPayload128 = 0,
+  CpuPcieMaxPayload256,
+  CpuPcieMaxPayload512,
+  CpuPcieMaxPayloadMax
+};
+
+enum CPU_PCIE_COMPLETION_TIMEOUT {
+  CpuPcieCompletionTO_Default,
+  CpuPcieCompletionTO_50_100us,
+  CpuPcieCompletionTO_1_10ms,
+  CpuPcieCompletionTO_16_55ms,
+  CpuPcieCompletionTO_65_210ms,
+  CpuPcieCompletionTO_260_900ms,
+  CpuPcieCompletionTO_1_3P5s,
+  CpuPcieCompletionTO_4_13s,
+  CpuPcieCompletionTO_17_64s,
+  CpuPcieCompletionTO_Disabled
+};
+
+
+enum CPU_PCIE_GEN3_PRESET_COEFF_SELECTION {
+  CpuPcieGen3PresetSelection,
+  CpuPcieGen3CoefficientSelection
+};
+
+enum CPU_PCIE_GEN4_PRESET_COEFF_SELECTION {
+  CpuPcieGen4PresetSelection,
+  CpuPcieGen4CoefficientSelection
+};
+
+typedef enum {
+  CpuPcieEqDefault      = 0,  ///< @deprecated since revision 3. Behaves as PchPcieEqHardware.
+  CpuPcieEqHardware     = 1,  ///< Hardware equalization
+  CpuPcieEqStaticCoeff  = 4   ///< Fixed equalization (requires Coefficient settings per lane)
+} CPU_PCIE_EQ_METHOD;
+
+
+/**
+  Represent lane specific PCIe Gen3 equalization parameters.
+**/
+typedef struct {
+  UINT8                  Cm;                 ///< Coefficient C-1
+  UINT8                  Cp;                 ///< Coefficient C+1
+  UINT8                  PegGen3RootPortPreset;      ///< <b>(Test)</b> Used for programming PEG Gen3 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  PegGen3EndPointPreset;      ///< <b>(Test)</b> Used for programming PEG Gen3 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  PegGen3EndPointHint;        ///< <b>(Test)</b> Hint value per lane for the PEG Gen3 End Point. Range: 0-6, 2 is default for each lane
+  UINT8                  PegGen4RootPortPreset;      ///< <b>(Test)</b> Used for programming PEG Gen4 preset values per lane. Range: 0-9, 8 is default for each lane
+  UINT8                  PegGen4EndPointPreset;      ///< <b>(Test)</b> Used for programming PEG Gen4 preset values per lane. Range: 0-9, 7 is default for each lane
+  UINT8                  PegGen4EndPointHint;        ///< <b>(Test)</b> Hint value per lane for the PEG Gen4 End Point. Range: 0-6, 2 is default for each lane
+} CPU_PCIE_EQ_LANE_PARAM;
+
+/**
+  The CPU_PCI_ROOT_PORT_CONFIG describe the feature and capability of each CPU PCIe root port.
+**/
+typedef struct {
+
+  UINT32  ExtSync                         :  1;   ///< Indicate whether the extended synch is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  VcEnabled                       :  1;   ///< Virtual Channel. 0: Disable; <b>1: Enable</b>
+  UINT32  MultiVcEnabled                  :  1;   ///< Multiple Virtual Channel. 0: Disable; <b>1: Enable</b>
+  UINT32  PeerToPeer                      :  1;   ///< Peer to Peer Mode. <b>0: Disable</b>; 1: Enable.
+  UINT32  RsvdBits0                       : 28;   ///< Reserved bits
+  /**
+  PCIe Gen4 Equalization Method
+  - HwEq           (0x1) : Hardware Equalization (Default)
+  - StaticEq       (0x2) : Static Equalization
+  **/
+  UINT8   Gen4EqPh3Method;
+  UINT8   FomsCp;                                 ///< FOM Score Board Control Policy
+  UINT8   RsvdBytes0[2];                          ///< Reserved bytes
+
+  //
+  // Gen3 Equalization settings
+  //
+  UINT32  Gen3Uptp            :  4;               ///< <b>(Test)</b> Upstream Port Transmitter Preset used during Gen3 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  UINT32  Gen3Dptp            :  4;               ///< <b>(Test)</b> Downstream Port Transmiter Preset used during Gen3 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  //
+  // Gen4 Equalization settings
+  //
+  UINT32  Gen4Uptp            :  4;               ///< <b>(Test)</b> Upstream Port Transmitter Preset used during Gen4 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  UINT32  Gen4Dptp            :  4;               ///< <b>(Test)</b> Downstream Port Transmiter Preset used during Gen4 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  //
+  // Gen5 Equalization settings
+  //
+  UINT32  Gen5Uptp            :  4;               ///< <b>(Test)</b> Upstream Port Transmitter Preset used during Gen5 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  UINT32  Gen5Dptp            :  4;               ///< <b>(Test)</b> Downstream Port Transmiter Preset used during Gen5 Link Equalization. Used for all lanes.  Default is <b>7</b>.
+  UINT32  RsvdBits1           :  8;               ///< Reserved Bits
+
+  PCIE_ROOT_PORT_COMMON_CONFIG                    PcieRpCommonConfig;                       ///< <b>(Test)</b> Includes policies which are common to both SA and PCH RootPort
+
+} CPU_PCIE_ROOT_PORT_CONFIG;
+
+/**
+  The CPU_PCIE_CONFIG block describes the expected configuration of the CPU PCI Express controllers
+  <b>Revision 1< / b>:
+  -Initial version.
+  <b>Revision 2</b>:
+  - SlotSelection policy added
+  <b>Revision 3</b>
+  - Deprecate PegGen3ProgramStaticEq and PegGen4ProgramStaticEq
+  <b>Revision 4</b>:
+  - Deprecating SetSecuredRegisterLock
+  <b>Revision 5</b>:
+  - Adding Serl
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER               Header;                   ///< Config Block Header
+  ///
+  /// These members describe the configuration of each SA PCIe root port.
+  ///
+  CPU_PCIE_ROOT_PORT_CONFIG         RootPort[CPU_PCIE_MAX_ROOT_PORTS];
+  ///
+  /// Gen3 Equalization settings for physical PCIe lane, index 0 represents PCIe lane 1, etc.
+  /// Corresponding entries are used when root port EqPh3Method is PchPcieEqStaticCoeff (default).
+  ///
+  CPU_PCIE_EQ_LANE_PARAM            EqPh3LaneParam[SA_PEG_MAX_LANE];
+  ///
+  /// List of coefficients used during equalization (applicable to both software and hardware EQ)
+  ///
+  PCIE_EQ_PARAM                     HwEqGen4CoeffList[PCIE_HWEQ_COEFFS_MAX];  // Deprecated Policy
+
+  PCIE_COMMON_CONFIG                PcieCommonConfig;   /// < <b>(Test)</b> Includes policies which are common to both SA and PCH PCIe
+
+  UINT32  FiaProgramming                  :  1;        /// < Skip Fia Configuration and lock if enable
+  ///
+  /// This member describes whether the PCI Express Clock Gating for each root port
+  /// is enabled by platform modules. <b>0: Disable</b>; 1: Enable.
+  ///
+  UINT32  ClockGating                     :  1;
+  ///
+  /// This member describes whether the PCI Express Power Gating for each root port
+  /// is enabled by platform modules. <b>0: Disable</b>; 1: Enable.
+  ///
+  UINT32  PowerGating                     :  1;
+  // Deprecated Policy
+  /**
+    <b>(Test)</b> Program PEG Gen3 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT32  PegGen3ProgramStaticEq          :  1;
+
+  // Deprecated Policy
+  /**
+  <b>(Test)</b> Program PEG Gen4 EQ Phase1 Static Presets
+  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
+  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming (Default)
+  **/
+  UINT32  PegGen4ProgramStaticEq          :  1;
+  /**
+  <b>(Test)</b> Cpu Pcie Secure Register Lock
+  - Disabled        (0x0)
+  - <b>Enabled</b>  (0x1)
+  **/
+  UINT32  SetSecuredRegisterLock          :  1;  // Deprecated Policy
+  ///
+  /// This member allows to select between the PCI Express M2 or CEMx4 slot <b>1: PCIe M2</b>; 0: CEMx4 slot.
+  ///
+  UINT32  SlotSelection                   :  1;
+  ///
+  /// Set/Clear Serl(Secure Equalization Register Lock)
+  ///
+  UINT32  Serl                            :  1;
+
+  UINT32  RsvdBits0                       : 24;
+
+  /**
+    PCIe device override table
+    The PCIe device table is being used to override PCIe device ASPM settings.
+    This is a pointer points to a 32bit address. And it's only used in PostMem phase.
+    Please refer to PCH_PCIE_DEVICE_OVERRIDE structure for the table.
+    Last entry VendorId must be 0.
+    The prototype of this policy is:
+    CPU_PCIE_DEVICE_OVERRIDE *PcieDeviceOverrideTablePtr;
+  **/
+  UINT32  PcieDeviceOverrideTablePtr;
+  } CPU_PCIE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_PCIE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
new file mode 100644
index 0000000000..445642da1f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
@@ -0,0 +1,72 @@
+/** @file
+  Dci policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DCI_CONFIG_H_
+#define _DCI_CONFIG_H_
+
+#define DCI_PREMEM_CONFIG_REVISION 2
+extern EFI_GUID gDciPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+typedef enum {
+  DciDbcDisabled       = 0x0,
+  DciDbcUsb2           = 0x1,
+  DciDbcUsb3           = 0x2,
+  DciDbcBoth           = 0x3,
+  DciDbcNoChange       = 0x4,
+  DciDbcMax
+} DCI_DBC_MODE;
+
+typedef enum {
+  Usb3TcDbgDisabled    = 0x0,
+  Usb3TcDbgEnabled     = 0x1,
+  Usb3TcDbgNoChange    = 0x2,
+  Usb3TcDbgMax
+} DCI_USB3_TYPE_C_DEBUG_MODE;
+
+/**
+  The PCH_DCI_PREMEM_CONFIG block describes policies related to Direct Connection Interface (DCI)
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Added DciModphyPg
+  - change to use data in byte unit rather than bit-field
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  /**
+    DCI enable.
+    Determine if to enable DCI debug from host.
+    <b>0:Disabled</b>; 1:Enabled
+  **/
+  UINT8    DciEn;
+  /**
+    USB DbC enable mode.
+    Disabled: Clear both USB2/3DBCEN; USB2: Set USB2DBCEN; USB3: Set USB3DBCEN; Both: Set both USB2/3DBCEN; No Change: Comply with HW value
+    Refer to definition of DCI_USB_DBC_MODE for supported settings.
+    0:Disabled; 1:USB2; 2:USB3; 3:Both; <b>4:No Change</b>
+  **/
+  UINT8    DciDbcMode;
+  /**
+    Enable Modphy power gate when DCI is enable. It must be disabled for 4-wire DCI OOB. Set default to HW default : Disabled
+    <b>0:Disabled</b>; 1:Enabled
+  **/
+  UINT8    DciModphyPg;
+  /**
+    USB3 Type-C UFP2DFP kenel / platform debug support. No change will do nothing to UFP2DFP configuration.
+    When enabled, USB3 Type C UFP (upstream-facing port) may switch to DFP (downstream-facing port) for first connection.
+    It must be enabled for USB3 kernel(kernel mode debug) and platform debug(DFx, DMA, Trace) over UFP Type-C receptacle.
+    Refer to definition of DCI_USB_TYPE_C_DEBUG_MODE for supported settings.
+    0:Disabled; 1:Enabled; <b>2:No Change</b>
+  **/
+  UINT8    DciUsb3TypecUfpDbg;
+} PCH_DCI_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _DCI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
new file mode 100644
index 0000000000..260b582702
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
@@ -0,0 +1,61 @@
+/** @file
+  Espi policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _ESPI_CONFIG_H_
+#define _ESPI_CONFIG_H_
+
+#define ESPI_CONFIG_REVISION 2
+extern EFI_GUID gEspiConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure contains the policies which are related to ESPI.
+
+  <b>Revision 1</b>:
+  - Initial revision
+  <b>Revision 2</b>:
+  - Added LockLinkConfiguration field to config block
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    LPC (eSPI) Memory Range Decode Enable. When TRUE, then the range
+    specified in PCLGMR[31:16] is enabled for decoding to LPC (eSPI).
+    <b>0: FALSE</b>, 1: TRUE
+  **/
+  UINT32    LgmrEnable            :  1;
+  /**
+    eSPI Master and Slave BME settings.
+    When TRUE, then the BME bit enabled in eSPI Master and Slave.
+    0: FALSE, <b>1: TRUE </b>
+  **/
+  UINT32    BmeMasterSlaveEnabled :  1;
+  /**
+    Master HOST_C10 (Virtual Wire) to Slave Enable (VWHC10OE)
+    <b>0b: Disable HOST_C10 reporting (HOST_C10 indication from PMC is ignored)</b>
+    1b: Enable HOST_C10 reporting to Slave via eSPI Virtual Wire (upon receiving a HOST_C10 indication from PMC)
+  **/
+  UINT32    HostC10ReportEnable   :  1;
+  /**
+    eSPI Link Configuration Lock (SBLCL)
+    If set to TRUE then communication through SET_CONFIG/GET_CONFIG
+    to eSPI slaves addresses from range 0x0 - 0x7FF
+    <b>1: TRUE</b>, 0: FALSE
+  **/
+  UINT32    LockLinkConfiguration :  1;
+  /**
+   Hardware Autonomous Enable (HAE)
+   If set to TRUE, then the IP may request a PG whenever it is idle
+  **/
+  UINT32    EspiPmHAE             :  1;
+  UINT32    RsvdBits              : 27;     ///< Reserved bits
+} PCH_ESPI_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _ESPI_CONFIG_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
new file mode 100644
index 0000000000..0df2755280
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
@@ -0,0 +1,170 @@
+/** @file
+  PCH FIVR policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _FIVR_CONFIG_H_
+#define _FIVR_CONFIG_H_
+
+#define FIVR_CONFIG_REVISION 1
+extern EFI_GUID gFivrConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  Rail support in S0ix and Sx
+  Settings other than FivrRailDisabled can be OR'ed
+**/
+typedef enum {
+  FivrRailDisabled   = 0,
+  FivrRailInS0i1S0i2 = BIT0,
+  FivrRailInS0i3     = BIT1,
+  FivrRailInS3       = BIT2,
+  FivrRailInS4       = BIT3,
+  FivrRailInS5       = BIT4,
+  FivrRailInS0ix     = FivrRailInS0i1S0i2 | FivrRailInS0i3,
+  FivrRailInSx       = FivrRailInS3 | FivrRailInS4 | FivrRailInS5,
+  FivrRailAlwaysOn   = FivrRailInS0ix | FivrRailInSx
+} FIVR_RAIL_SX_STATE;
+
+typedef enum {
+  FivrRetentionActive = BIT0,
+  FivrNormActive      = BIT1,
+  FivrMinActive       = BIT2,
+  FivrMinRetention    = BIT3
+} FIVR_RAIL_SUPPORTED_VOLTAGE;
+
+/**
+  Structure for V1p05/Vnn VR rail configuration
+**/
+typedef struct {
+  /**
+    Mask to enable the usage of external VR rail in specific S0ix or Sx states
+    Use values from FIVR_RAIL_SX_STATE
+    The default is <b>FivrRailDisabled</b>.
+  **/
+  UINT32  EnabledStates   : 5;
+
+  /**
+    VR rail voltage value that will be used in S0i2/S0i3 states.
+    This value is given in 2.5mV increments (0=0mV, 1=2.5mV, 2=5mV...)
+    The default for Vnn is set to <b>420 - 1050 mV</b>.
+  **/
+  UINT32  Voltage         : 11;
+  /**
+    @deprecated
+    THIS POLICY IS DEPRECATED, PLEASE USE IccMaximum INSTEAD
+    VR rail Icc Max Value
+    Granularity of this setting is 1mA and maximal possible value is 500mA
+    The default is <b> 0mA </b>.
+  **/
+  UINT32  IccMax          : 8;
+
+  /**
+  This register holds the control hold off values to be used when
+  changing the rail control for external bypass value in us
+  **/
+  UINT32   CtrlRampTmr    : 8;
+
+  /**
+    Mask to set the supported configuration in VR rail.
+    Use values from FIVR_RAIL_SUPPORTED_VOLTAGE
+  **/
+  UINT32  SupportedVoltageStates   : 4;
+
+  /**
+    VR rail Icc Maximum Value
+    Granularity of this setting is 1mA and maximal possible value is 500mA
+    The default is <b> 0mA </b>.
+  **/
+  UINT32  IccMaximum                : 16;
+
+  UINT32  RsvdBits1                 : 12;
+
+} FIVR_EXT_RAIL_CONFIG;
+
+
+/**
+  Structure for VCCIN_AUX voltage rail configuration
+**/
+typedef struct {
+  /**
+  Transition time in microseconds from Low Current Mode Voltage to High Current Mode Voltage.
+  Voltage transition time required by motherboard voltage regulator when PCH changes
+  the VCCIN_AUX regulator set point from the low current mode voltage and high current mode voltage.
+  This field has 1us resolution.
+  When value is 0 PCH will not transition VCCIN_AUX to low current mode voltage.
+  The default is <b> 0xC </b>.
+  **/
+  UINT8  LowToHighCurModeVolTranTime;
+
+  /**
+  Transition time in microseconds from Retention Mode Voltage to High Current Mode Voltage.
+  Voltage transition time required by motherboard voltage regulator when PCH changes
+  the VCCIN_AUX regulator set point from the retention mode voltage to high current mode voltage.
+  This field has 1us resolution.
+  When value is 0 PCH will not transition VCCIN_AUX to retention voltage.
+  The default is <b> 0x36 </b>.
+  **/
+  UINT8  RetToHighCurModeVolTranTime;
+
+  /**
+  Transition time in microseconds from Retention Mode Voltage to Low Current Mode Voltage.
+  Voltage transition time required by motherboard voltage regulator when PCH changes
+  the VCCIN_AUX regulator set point from the retention mode voltage to low current mode voltage.
+  This field has 1us resolution.
+  When value is 0 PCH will not transition VCCIN_AUX to retention voltage.
+  The default is <b> 0x2B </b>.
+  **/
+  UINT8  RetToLowCurModeVolTranTime;
+  UINT8  RsvdByte1;
+  /**
+  Transition time in microseconds from Off (0V) to High Current Mode Voltage.
+  Voltage transition time required by motherboard voltage regulator when PCH changes
+  the VCCIN_AUX regulator set point from 0V to the high current mode voltage.
+  This field has 1us resolution.
+  0 = Transition to 0V is disabled
+  Setting this field to 0 sets VCCIN_AUX as a fixed rail that stays on
+  in all S0 & Sx power states after initial start up on G3 exit
+  The default is <b> 0x96 </b>.
+  **/
+  UINT32  OffToHighCurModeVolTranTime : 11;
+  UINT32  RsvdBits1                   : 21;
+} FIVR_VCCIN_AUX_CONFIG;
+
+/**
+  The PCH_FIVR_CONFIG block describes FIVR settings.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER      Header;  ///< Config Block Header
+  /**
+    External V1P05 VR rail configuration.
+  **/
+  FIVR_EXT_RAIL_CONFIG     ExtV1p05Rail;
+  /**
+    External Vnn VR rail configuration.
+  **/
+  FIVR_EXT_RAIL_CONFIG     ExtVnnRail;
+  /**
+    Additional External Vnn VR rail configuration that will get applied
+    in Sx entry SMI callback. Required only if External Vnn VR
+    needs different settings for Sx than those specified in ExtVnnRail.
+  **/
+  FIVR_EXT_RAIL_CONFIG     ExtVnnRailSx;
+  /**
+    VCCIN_AUX voltage rail configuration.
+  **/
+  FIVR_VCCIN_AUX_CONFIG    VccinAux;
+
+  /**
+    Enable/Disable FIVR Dynamic Power Management
+    Default is <b> 1 </b>.
+  **/
+  UINT32                   FivrDynPm : 1;
+  UINT32                   RsvdBits2 : 31;
+} PCH_FIVR_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _FIVR_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
new file mode 100644
index 0000000000..cb9411f9e8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
@@ -0,0 +1,33 @@
+/** @file
+  Gigabit Ethernet policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GBE_CONFIG_H_
+#define _GBE_CONFIG_H_
+
+#define GBE_CONFIG_REVISION 1
+extern EFI_GUID gGbeConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  PCH intergrated GBE controller configuration settings.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;  ///< Config Block Header
+  /**
+    Determines if enable PCH internal GBE, 0: Disable; <b>1: Enable</b>.
+    When Enable is changed (from disabled to enabled or from enabled to disabled),
+    it needs to set LAN Disable regsiter, which might be locked by FDSWL register.
+    So it's recommendated to issue a global reset when changing the status for PCH Internal LAN.
+  **/
+  UINT32  Enable          :  1;
+  UINT32  LtrEnable       :  1;  ///< <b>0: Disable</b>; 1: Enable LTR capabilty of PCH internal LAN.
+  UINT32  RsvdBits0       : 30;  ///< Reserved bits
+} GBE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _GBE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
new file mode 100644
index 0000000000..87649253c6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
@@ -0,0 +1,31 @@
+/** @file
+  Policy definition for GNA Config Block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GNA_CONFIG_H_
+#define _GNA_CONFIG_H_
+#pragma pack(push, 1)
+
+#define GNA_CONFIG_REVISION 1
+/**
+ GNA config block for configuring GNA.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER         Header;                   ///< Offset 0-27 Config Block Header
+  /**
+  Offset 28:0
+  This policy enables the GNA Device (SA Device 8) if supported.
+  If FALSE, all other policies in this config block will be ignored.
+  <b>1=TRUE</b>;
+  0=FALSE.
+   **/
+  UINT32                      GnaEnable : 1;
+  UINT32                      RsvdBits0 : 31; ///< Offset 28:1 :Reserved for future use
+} GNA_CONFIG;
+#pragma pack(pop)
+
+#endif // _GNA_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig.h
new file mode 100644
index 0000000000..1a724f14da
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig.h
@@ -0,0 +1,37 @@
+/** @file
+  GPIO device policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_DEV_CONFIG_H_
+#define _GPIO_DEV_CONFIG_H_
+
+extern EFI_GUID gGpioDxeConfigGuid;
+
+#define GPIO_DXE_CONFIG_REVISION 1
+
+#pragma pack (push,1)
+
+/**
+  This structure contains the DXE policies which are related to GPIO device.
+
+  <b>Revision 1:</b>
+  - Inital version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
+  /**
+    If GPIO ACPI device is not used by OS it can be hidden. In such case
+    no other device exposed to the system can reference GPIO device in one
+    of its resources through GpioIo(..) or GpioInt(..) ACPI descriptors.
+    <b>0: Disable</b>; 1: Enable
+  **/
+  UINT32  HideGpioAcpiDevice    :  1;
+  UINT32  RsvdBits              : 31;    ///< Reserved bits
+
+} GPIO_DXE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _GPIO_DEV_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/GraphicsConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/GraphicsConfig.h
new file mode 100644
index 0000000000..c3b134b830
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/GraphicsConfig.h
@@ -0,0 +1,211 @@
+/** @file
+  Policy definition for Internal Graphics Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GRAPHICS_CONFIG_H_
+#define _GRAPHICS_CONFIG_H_
+#pragma pack(push, 1)
+
+#define GRAPHICS_PEI_PREMEM_CONFIG_REVISION 3
+#define GRAPHICS_PEI_CONFIG_REVISION        7
+#define GRAPHICS_DXE_CONFIG_REVISION        1
+
+#define DDI_DEVICE_NUMBER   4
+#define MAX_BCLM_ENTRIES    20
+
+
+//
+// DDI defines
+//
+typedef enum {
+  DdiDisable       = 0x00,
+  DdiDdcEnable     = 0x01,
+} DDI_DDC_TBT_VAL;
+
+typedef enum {
+  DdiHpdDisable  = 0x00,
+  DdiHpdEnable   = 0x01,
+} DDI_HPD_VAL;
+
+typedef enum {
+  DdiPortDisabled = 0x00,
+  DdiPortEdp      = 0x01,
+  DdiPortMipiDsi  = 0x02,
+} DDI_PORT_SETTINGS;
+
+/**
+  This structure configures the Native GPIOs for DDI port per VBT settings.
+**/
+typedef struct {
+  UINT8 DdiPortAConfig; /// The Configuration of DDI port A, this settings must match VBT's settings. DdiPortDisabled - No LFP is connected on DdiPortA, <b>DdiPortEdp - Set DdiPortA to eDP</b>, DdiPortMipiDsi - Set DdiPortA to MIPI DSI
+  UINT8 DdiPortBConfig; /// The Configuration of DDI port B, this settings must match VBT's settings. DdiPortDisabled - No LFP is connected on DdiPortB, <b>DdiPortEdp - Set DdiPortB to eDP</b>, DdiPortMipiDsi - Set DdiPortB to MIPI DSI
+  UINT8 DdiPortAHpd;    /// The HPD setting of DDI Port A, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPortBHpd;    /// The HPD setting of DDI Port B, this settings must match VBT's settings. DdiHpdDisable - Disable HPD, <b>DdiHpdEnable - Enable HPD</b>
+  UINT8 DdiPortCHpd;    /// The HPD setting of DDI Port C, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPort1Hpd;    /// The HPD setting of DDI Port 1, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPort2Hpd;    /// The HPD setting of DDI Port 2, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPort3Hpd;    /// The HPD setting of DDI Port 3, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPort4Hpd;    /// The HPD setting of DDI Port 4, this settings must match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable - Enable HPD
+  UINT8 DdiPortADdc;    /// The DDC setting of DDI Port A, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+  UINT8 DdiPortBDdc;    /// The DDC setting of DDI Port B, this settings must match VBT's settings. DdiDisable - Disable DDC, <b>DdiDdcEnable - Enable DDC </b>
+  UINT8 DdiPortCDdc;    /// The DDC setting of DDI Port C, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+  UINT8 DdiPort1Ddc;    /// The DDC setting of DDI Port 1, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+  UINT8 DdiPort2Ddc;    /// The DDC setting of DDI Port 2, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+  UINT8 DdiPort3Ddc;    /// The DDC setting of DDI Port 3, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+  UINT8 DdiPort4Ddc;    /// The DDC setting of DDI Port 4, this settings must match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable - Enable DDC
+} DDI_CONFIGURATION;
+
+/**
+  This Configuration block is to configure GT related PreMem data/variables.\n
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Added DfdRestoreEnable.
+  <b>Revision 3</b>:
+  - Added DdiConfiguration.
+  <b>Revision 4</b>:
+  - Added GmAdr64 and made GmAdr obselete
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27 Config Block Header
+  /**
+    Offset 28
+    Selection of the primary display device: 0=iGFX, 1=PEG, 2=PCIe Graphics on PCH, <b>3=AUTO</b>, 4=Switchable Graphics\n
+    When AUTO mode selected, the priority of display devices is: PCIe Graphics on PCH > PEG > iGFX
+  **/
+  UINT8                PrimaryDisplay;
+  /**
+    Offset 29
+    Intel Gfx Support. It controls enabling/disabling iGfx device.
+    When AUTO mode selected, iGFX will be turned off when external graphics detected.
+    If FALSE, all other polices can be ignored.
+    <b>2 = AUTO</b>;
+    0 = FALSE;
+    1 = TRUE.
+  **/
+  UINT8                InternalGraphics;
+  /**
+    Offset 30
+    Pre-allocated memory for iGFX\n
+    0   = 0MB,1 or 247 = 32MB,\n
+    2   = 64MB,\n
+    240 = 4MB,     241 = 8MB,\n
+    242 = 12MB,    243 = 16MB,\n
+    244 = 20MB,    245 = 24MB,\n
+    246 = 28MB,    248 = 36MB,\n
+    249 = 40MB,    250 = 44MB,\n
+    251 = 48MB,    252 = 52MB,\n
+    253 = 56MB,<b> 254 = 60MB</b>,\n
+    <b>Note: enlarging pre-allocated memory for iGFX may need to reduce MmioSize because of 4GB boundary limitation</b>
+  **/
+  UINT16               IgdDvmt50PreAlloc;
+  UINT8                PanelPowerEnable;    ///< Offset 32 :<b>(Test)</b> Control for enabling/disabling VDD force bit (Required only for early enabling of eDP panel): 0=FALSE, <b>1=TRUE</b>
+  UINT8                ApertureSize;        ///< Offset 33 :Graphics aperture size (256MB is the recommended size as per BWG) : 0=128MB, <b>1=256MB</b>, 3=512MB, 7=1024MB, 15=2048MB.
+  UINT8                GtPsmiSupport;       ///< Offset 34 :PSMI support On/Off: <b>0=FALSE</b>, 1=TRUE
+  UINT8                PsmiRegionSize;      ///< Offset 35 :Psmi region size: <b>0=32MB</b>, 1=288MB, 2=544MB, 3=800MB, 4=1056MB
+  UINT8                DismSize;            ///< Offset 36 :DiSM Size for 2LM Sku: <b>0=0GB</b>, 1=1GB, 2=2GB, 3=3GB, 4=4GB, 5=5GB, 6=6GB, 7=7GB
+  UINT8                DfdRestoreEnable;    ///< Offset 37 :Display memory map programming for DFD Restore <b>0- Disable</b>, 1- Enable
+  UINT16               GttSize;             ///< Offset 38 :Selection of iGFX GTT Memory size: 1=2MB, 2=4MB, <b>3=8MB</b>
+  /**
+  Offset 40
+  Temp Address of System Agent GTTMMADR: Default is <b>0xAF000000</b>
+  **/
+  UINT32               GttMmAdr;
+  UINT32               GmAdr;               ///< Offset 44 Obsolete not to be used, use GmAdr64
+  DDI_CONFIGURATION    DdiConfiguration;    ///< Offset 48 DDI configuration, need to match with VBT settings.
+
+  UINT8                GtClosEnable;        ///< Offset 50 Gt ClOS
+  UINT8                Rsvd0[7];            ///< Offset 51 Reserved for 4 bytes of alignment
+  /**
+  Offset 58
+  Temp Address of System Agent GMADR: Default is <b>0xB0000000</b>
+  **/
+  UINT64               GmAdr64;
+} GRAPHICS_PEI_PREMEM_CONFIG;
+
+/**
+  This configuration block is to configure IGD related variables used in PostMem PEI.
+  If Intel Gfx Device is not supported, all policies can be ignored.
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Removed DfdRestoreEnable.
+  <b>Revision 3</b>:
+  - Removed DdiConfiguration.
+  <b>Revision 4</b>:
+  - Added new CdClock frequency
+  <b>Revision 5</b>:
+  - Added GT Chicket bits
+  <b>Revision 6</b>:
+  - Added LogoPixelHeight and LogoPixelWidth
+  <b>Revision 7</b>:
+  - Added SkipFspGop
+
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block Header
+  UINT8                RenderStandby;        ///< Offset 28 :<b>(Test)</b> This field is used to enable or disable RC6 (Render Standby): 0=FALSE, <b>1=TRUE</b>
+  UINT8                PmSupport;            ///< Offset 29 :<b>(Test)</b> IGD PM Support TRUE/FALSE: 0=FALSE, <b>1=TRUE</b>
+  /**
+    Offset 30
+    CdClock Frequency select\n
+    <b>0xFF = Auto. Max CdClock freq based on Reference Clk</b> \n
+     0: 192 Mhz, 1: 307.2 Mhz, 2: 312 Mhz, 3: 324 Mhz, 4: 326.4 Mhz, 5: 552 Mhz, 6: 556.8 Mhz, 7: 648 Mhz, 8: 652.8 Mhz
+
+  **/
+  UINT16               CdClock;
+  UINT8                PeiGraphicsPeimInit;  ///< Offset 32 : This policy is used to enable/disable Intel Gfx PEIM.<b>0- Disable</b>, 1- Enable
+  UINT8                CdynmaxClampEnable;   ///< Offset 33 : This policy is used to enable/disable CDynmax Clamping Feature (CCF) <b>1- Enable</b>, 0- Disable
+  UINT16               GtFreqMax;            ///< Offset 34 : <b>(Test)</b> Max GT frequency limited by user in multiples of 50MHz: Default value which indicates normal frequency is <b>0xFF</b>
+  UINT8                DisableTurboGt;       ///< Offset 36 : This policy is used to enable/disable DisableTurboGt <b>0- Disable</b>, 1- Enable
+  UINT8                SkipCdClockInit;      ///< Offset 37 : SKip full CD clock initialization. <b>0- Disable</b>, 1- Enable
+  UINT8                RC1pFreqEnable;       ///< Offset 38 : This policy is used to enable/disable RC1p Frequency. <b>0- Disable</b>, 1- Enable
+  UINT8                PavpEnable;           ///< Offset 39 :IGD PAVP TRUE/FALSE: 0=FALSE, <b>1=TRUE</b>
+  VOID*                LogoPtr;              ///< Offset 40 Address of Intel Gfx PEIM Logo to be displayed
+  UINT32               LogoSize;             ///< Offset 44 Intel Gfx PEIM Logo Size
+  VOID*                GraphicsConfigPtr;    ///< Offset 48 Address of the Graphics Configuration Table
+  VOID*                BltBufferAddress;     ///< Offset 52 Address of Blt buffer for PEIM Logo use
+  UINT32               BltBufferSize;        ///< Offset 56 The size for Blt Buffer, calculating by PixelWidth * PixelHeight * 4 bytes (the size of EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+  UINT8                ProgramGtChickenBits; ///< Offset 60 Program GT Chicket bits in GTTMMADR + 0xD00 BITS [3:1].
+  UINT8                SkipFspGop;           ///< Offset 61 This policy is used to skip PEIM GOP in FSP.<b>0- Use FSP provided GOP driver</b>, 1- Skip FSP provided GOP driver
+  UINT8                Rsvd1[2];             ///< Offset 62 Reserved for 4 bytes alignment
+  UINT32               LogoPixelHeight;      ///< Offset 64 Address of LogoPixelHeight for PEIM Logo use
+  UINT32               LogoPixelWidth;       ///< Offset 68 Address of LogoPixelWidth for PEIM Logo use
+} GRAPHICS_PEI_CONFIG;
+
+/**
+  This configuration block is to configure IGD related variables used in DXE.
+  If Intel Gfx Device is not supported or disabled, all policies will be ignored.
+  The data elements should be initialized by a Platform Module.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27: Config Block Header
+  UINT32                Size;                     ///< Offset 28 - 31: This field gives the size of the GOP VBT Data buffer
+  EFI_PHYSICAL_ADDRESS  VbtAddress;               ///< Offset 32 - 39: This field points to the GOP VBT data buffer
+  UINT8                 PlatformConfig;           ///< Offset 40: This field gives the Platform Configuration Information (0=Platform is S0ix Capable for ULT SKUs only, <b>1=Platform is not S0ix Capable</b>, 2=Force Platform is S0ix Capable for All SKUs)
+  UINT8                 AlsEnable;                ///< Offset 41: Ambient Light Sensor Enable: <b>0=Disable</b>, 2=Enable
+  UINT8                 BacklightControlSupport;  ///< Offset 42: Backlight Control Support: 0=PWM Inverted, <b>2=PWM Normal</b>
+  UINT8                 IgdBootType;              ///< Offset 43: IGD Boot Type CMOS option: <b>0=Default</b>, 0x01=CRT, 0x04=EFP, 0x08=LFP, 0x20=EFP3, 0x40=EFP2, 0x80=LFP2
+  UINT32                IuerStatusVal;            ///< Offset 44 - 47: Offset 16 This field holds the current status of all the supported Ultrabook events (Intel(R) Ultrabook Event Status bits)
+  CHAR16                GopVersion[0x10];         ///< Offset 48 - 79:This field holds the GOP Driver Version. It is an Output Protocol and updated by the Silicon code
+  /**
+    Offset 80: IGD Panel Type CMOS option\n
+    <b>0=Default</b>, 1=640X480LVDS, 2=800X600LVDS, 3=1024X768LVDS, 4=1280X1024LVDS, 5=1400X1050LVDS1\n
+    6=1400X1050LVDS2, 7=1600X1200LVDS, 8=1280X768LVDS, 9=1680X1050LVDS, 10=1920X1200LVDS, 13=1600X900LVDS\n
+    14=1280X800LVDS, 15=1280X600LVDS, 16=2048X1536LVDS, 17=1366X768LVDS
+  **/
+  UINT8                 IgdPanelType;
+  UINT8                 IgdPanelScaling;          ///< Offset 81: IGD Panel Scaling: <b>0=AUTO</b>, 1=OFF, 6=Force scaling
+  UINT8                 IgdBlcConfig;             ///< Offset 82: Backlight Control Support: 0=PWM Inverted, <b>2=PWM Normal</b>
+  UINT8                 IgdDvmtMemSize;           ///< Offset 83: IGD DVMT Memory Size: 1=128MB, <b>2=256MB</b>, 3=MAX
+  UINT8                 GfxTurboIMON;             ///< Offset 84: IMON Current Value: 14=Minimal, <b>31=Maximum</b>
+  UINT8                 Reserved[3];              ///< Offset 85: Reserved for DWORD alignment.
+  UINT16                BCLM[MAX_BCLM_ENTRIES];   ///< Offset 88: IGD Backlight Brightness Level Duty cycle Mapping Table.
+} GRAPHICS_DXE_CONFIG;
+#pragma pack(pop)
+
+#endif // _GRAPHICS_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.h
new file mode 100644
index 0000000000..a2e0a65e45
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.h
@@ -0,0 +1,227 @@
+/** @file
+  HDAUDIO policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HDAUDIO_CONFIG_H_
+#define _HDAUDIO_CONFIG_H_
+
+#include <ConfigBlock.h>
+#include <PchLimits.h>
+
+#define HDAUDIO_PREMEM_CONFIG_REVISION 2
+#define HDAUDIO_CONFIG_REVISION 1
+#define HDAUDIO_DXE_CONFIG_REVISION 1
+
+extern EFI_GUID gHdAudioPreMemConfigGuid;
+extern EFI_GUID gHdAudioConfigGuid;
+extern EFI_GUID gHdAudioDxeConfigGuid;
+
+#pragma pack (push,1)
+
+///
+/// The PCH_HDAUDIO_CONFIG block describes the expected configuration of the Intel HD Audio feature.
+///
+
+#define HDAUDIO_VERB_TABLE_VIDDID(Vid,Did)                      (UINT32)((UINT16)Vid | ((UINT16)Did << 16))
+#define HDAUDIO_VERB_TABLE_RID_SDI_SIZE(Rid,Sdi,VerbTableSize)  (UINT32)((UINT8)Rid | ((UINT8)Sdi << 8) | ((UINT16)VerbTableSize << 16))
+#define HDAUDIO_VERB_TABLE_CMD_SIZE(VerbTable)                  ((sizeof (VerbTable) - sizeof (HDA_VERB_TABLE_HEADER)) / (sizeof (UINT32)))
+
+///
+/// Use this macro to create HDAUDIO_VERB_TABLE and populate size automatically
+///
+#define HDAUDIO_VERB_TABLE_INIT(Vid,Did,Rid,Sdi,...) \
+{ \
+  { Vid, Did, Rid, Sdi, (sizeof((UINT32[]){__VA_ARGS__})/sizeof(UINT32)) }, \
+  { __VA_ARGS__ } \
+}
+
+
+/**
+  Azalia verb table header
+  Every verb table should contain this defined header and followed by azalia verb commands.
+**/
+typedef struct {
+  UINT16  VendorId;             ///< Codec Vendor ID
+  UINT16  DeviceId;             ///< Codec Device ID
+  UINT8   RevisionId;           ///< Revision ID of the codec. 0xFF matches any revision.
+  UINT8   SdiNum;               ///< SDI number, 0xFF matches any SDI.
+  UINT16  DataDwords;           ///< Number of data DWORDs following the header.
+} HDA_VERB_TABLE_HEADER;
+
+#ifdef _MSC_VER
+//
+// Disable "zero-sized array in struct/union" extension warning.
+// Used for neater verb table definitions.
+//
+#pragma warning (push)
+#pragma warning (disable: 4200)
+#endif
+typedef struct  {
+  HDA_VERB_TABLE_HEADER  Header;
+  UINT32 Data[];
+} HDAUDIO_VERB_TABLE;
+#ifdef _MSC_VER
+#pragma warning (pop)
+#endif
+
+typedef struct {
+  UINT32   ClkA;            ///<  Pin mux configuration. Refer to GPIO_*_MUXING_DMIC*_CLKA_*
+  UINT32   ClkB;            ///<  Pin mux configuration. Refer to GPIO_*_MUXING_DMIC*_CLKB_*
+  UINT32   Data;            ///<  Pin mux configuration. Refer to GPIO_*_MUXING_DMIC*_DATA_*
+} HDA_DMIC_PIN_MUX;
+
+/**
+  HD Audio Link Policies
+**/
+typedef struct {
+  UINT32  Enable    :  1;  ///< HDA interface enable. When enabled related pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
+  UINT32  RsvdBits0 : 31;
+  UINT8   SdiEnable[PCH_MAX_HDA_SDI];  ///< HDA SDI signal enable. When enabled related SDI pins will be switched to appropriate native mode: <b>0: Disable</b>; 1: Enable
+  UINT8   Reserved[(4 - (PCH_MAX_HDA_SDI % 4)) % 4];  ///< Padding for SDI enable table.
+} HDA_LINK_HDA;
+
+/**
+  HD Audio DMIC Interface Policies
+**/
+typedef struct {
+  UINT32             Enable          :  1;  ///< HDA DMIC interface enable. When enabled related pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
+  UINT32             DmicClockSelect :  2;  ///< DMIC link clock select: <b>0: Both</b>, 1: ClkA, 2: ClkB; default is "Both"
+  UINT32             RsvdBits0       : 29;
+  HDA_DMIC_PIN_MUX   PinMux;          ///< Pin mux configuration.
+} HDA_LINK_DMIC;
+
+/**
+  HD Audio SSP Interface Policies
+**/
+typedef struct {
+  UINT32             Enable    :  1;  ///< HDA SSP interface enable. When enabled related pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
+  UINT32             RsvdBits0 : 31;
+} HDA_LINK_SSP;
+
+/**
+  HD Audio SNDW Interface Policies
+**/
+typedef struct {
+  UINT32             Enable    :  1;  ///< HDA SNDW interface enable. When enabled related pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
+  UINT32             RsvdBits0 : 31;
+} HDA_LINK_SNDW;
+
+
+/**
+  This structure contains the policies which are related to HD Audio device (cAVS).
+
+  <b>Revision 1:</b>
+  - Inital version.
+
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
+  UINT32  Pme                   :  1;    ///< Azalia wake-on-ring, <b>0: Disable</b>; 1: Enable
+  UINT32  CodecSxWakeCapability :  1;    ///< Capability to detect wake initiated by a codec in Sx (eg by modem codec), <b>0: Disable</b>; 1: Enable
+  UINT32  HdAudioLinkFrequency  :  4;    ///< HDA-Link frequency (PCH_HDAUDIO_LINK_FREQUENCY enum): <b>2: 24MHz</b>, 1: 12MHz, 0: 6MHz
+  UINT32  RsvdBits0             : 26;    ///< Reserved bits 0
+  /**
+    Number of the verb table entry defined in VerbTablePtr.
+    Each entry points to a verb table which contains HDAUDIO_VERB_TABLE structure and verb command blocks.
+  **/
+  UINT8   VerbTableEntryNum;
+  UINT8   Rsvd0[3];                         ///< Reserved bytes, align to multiple 4
+  /**
+    Pointer to a verb table array.
+    This pointer points to 32bits address, and is only eligible and consumed in post mem phase.
+    Each entry points to a verb table which contains HDAUDIO_VERB_TABLE structure and verb command blocks.
+    The prototype of this is:
+    HDAUDIO_VERB_TABLE **VerbTablePtr;
+  **/
+  UINT32  VerbTablePtr;
+} HDAUDIO_CONFIG;
+
+/**
+  This structure contains the premem policies which are related to HD Audio device (cAVS).
+
+  <b>Revision 1:</b>
+  - Inital version.
+  <b>Revision 2:</b>
+  - Add DmicClockSelect
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
+  UINT32  Enable                :  1;    ///< Intel HD Audio (Azalia) enablement: 0: Disable, <b>1: Enable</b>
+  UINT32  DspEnable             :  1;    ///< DSP enablement: 0: Disable; <b>1: Enable</b>
+  UINT32  VcType                :  1;    ///< Virtual Channel Type Select: <b>0: VC0</b>, 1: VC1
+  /**
+    Universal Audio Architecture compliance for DSP enabled system:
+    <b>0: Not-UAA Compliant (Intel SST driver supported only)</b>,
+       1: UAA Compliant (HDA Inbox driver or SST driver supported)
+  **/
+  UINT32  DspUaaCompliance      :  1;
+  UINT32  IDispLinkFrequency    :  4;    ///< iDisp-Link frequency (PCH_HDAUDIO_LINK_FREQUENCY enum): <b>4: 96MHz</b>, 3: 48MHz
+  UINT32  IDispLinkTmode        :  3;    ///< iDisp-Link T-Mode (PCH_HDAUDIO_IDISP_TMODE enum): <b>0: 2T</b>, 1: 1T, 2: 4T, 3: 8T, 4: 16T
+  UINT32  IDispCodecDisconnect  :  1;    ///< iDisplay Audio Codec disconnection, <b>0: Not disconnected, enumerable</b>; 1: Disconnected SDI, not enumerable
+  UINT32  PowerGatingSupported  :  1;    ///< Power Gating supported: <b>0: Not supported</b>, 1: Supported
+  UINT32  RsvdBits              : 19;    ///< Reserved bits 0
+
+  /**
+    Audio Link Mode configuration bitmask.
+    Allows to configure enablement of the following interfaces: HDA-Link, DMIC, SSP, SoundWire.
+  **/
+
+  HDA_LINK_HDA          AudioLinkHda;    ///< HDA-Link enablement: 0: Disable; <b>1: Enable</b>.
+  /**
+    DMIC link enablement: 0: Disable; <b>1: Enable</b>.
+    DMIC0  LKF: Muxed with SNDW2/SNDW4.
+  **/
+  HDA_LINK_DMIC         AudioLinkDmic [2];
+  /**
+    I2S/SSP link enablement: <b>0: Disable</b>; 1: Enable.
+    SSP0/1 LKF: Muxed with HDA.
+    @note Since the I2S/SSP2 pin set contains pads which are also used for CNVi purpose, enabling AudioLinkSsp2
+    is exclusive with CNVi is present.
+  **/
+  HDA_LINK_SSP          AudioLinkSsp  [PCH_MAX_HDA_SSP_LINK_NUM];
+  /**
+    SoundWire link enablement: <b>0: Disable</b>; 1: Enable.
+    SNDW2  LKF: Muxed with DMIC0/DMIC1.
+    SNDW3  LKF: Muxed with DMIC1.
+    SNDW4  LKF: Muxed with DMIC0.
+  **/
+  HDA_LINK_SNDW         AudioLinkSndw [PCH_MAX_HDA_SNDW_LINK_NUM];
+
+
+  UINT16  ResetWaitTimer;                   ///< <b>(Test)</b> The delay timer after Azalia reset, the value is number of microseconds. Default is <b>600</b>.
+  UINT8   Rsvd0[2];                         ///< Reserved bytes, align to multiple 4
+
+} HDAUDIO_PREMEM_CONFIG;
+
+typedef struct {
+  UINT32  AutonomousClockStop        :  1;    ///< SoundWire1 link autonomous clock stop capability: <b>0: Disable</b>; 1: Enable
+  UINT32  DataOnActiveIntervalSelect :  2;    ///< SoundWire1 link data on active interval select 0: 3 clock periods; <b>1: 4 clock periods</b>; 2: 5 clock periods; 3: 6 clock periods
+  UINT32  DataOnDelaySelect          :  1;    ///< SoundWire1 link data on delay select 0: 2 clock periods; <b>1: 3 clock periods</b>
+  UINT32  RsvdBits1                  : 28;    ///< Reserved bits 1
+} HDAUDIO_SNDW_CONFIG;
+
+/**
+  This structure contains the DXE policies which are related to HD Audio device (cAVS).
+  <b>Revision 1:</b>
+  - Inital version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER        Header;          ///< Config Block Header
+  /**
+    SNDW configuration for exposed via SNDW ACPI tables:
+  **/
+  HDAUDIO_SNDW_CONFIG        SndwConfig[PCH_MAX_HDA_SNDW_LINK_NUM];
+  /**
+    Bitmask of supported DSP features:
+    [BIT0] - WoV; [BIT1] - BT Sideband; [BIT2] - Codec VAD; [BIT5] - BT Intel HFP; [BIT6] - BT Intel A2DP
+    [BIT7] - DSP based speech pre-processing disabled; [BIT8] - 0: Intel WoV, 1: Windows Voice Activation
+    Default is <b>zero</b>.
+  **/
+  UINT32  DspFeatureMask;
+} HDAUDIO_DXE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _HDAUDIO_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBridgeConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBridgeConfig.h
new file mode 100644
index 0000000000..67335be92e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBridgeConfig.h
@@ -0,0 +1,62 @@
+/** @file
+  Configurations for HostBridge
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HOST_BRIDGE_CONFIG_H_
+#define _HOST_BRIDGE_CONFIG_H_
+
+#include <ConfigBlock.h>
+
+#define HOST_BRIDGE_PREMEM_CONFIG_REVISION 1
+#define HOST_BRIDGE_PEI_CONFIG_REVISION    1
+
+extern EFI_GUID gHostBridgePeiPreMemConfigGuid;
+extern EFI_GUID gHostBridgePeiConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This configuration block describes HostBridge settings in PreMem.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block Header
+  UINT32  MchBar;                            ///< Offset 28 Address of System Agent MCHBAR: <b>0xFEDC0000(TGL)/0xFED10000(RKL)/0xFEA80000(JSL)<b>
+  UINT32  DmiBar;                            ///< Offset 32 Address of System Agent DMIBAR: <b>0xFEDA0000</b>
+  UINT32  EpBar;                             ///< Offset 36 Address of System Agent EPBAR: <b>0xFEDA1000</b>
+  UINT32  GdxcBar;                           ///< Offset 40 Address of System Agent GDXCBAR: <b>0xFED84000</b>
+  UINT32  RegBar;                            ///< Offset 44 Address of System Agent REGBAR: <b>0xFB000000</b>
+  UINT32  EdramBar;                          ///< Offset 48 Address of System Agent EDRAMBAR: <b>0xFED80000</b>
+  /**
+    Offset 52 :
+    Size of reserved MMIO space for PCI devices\n
+    <b>0=AUTO</b>, 512=512MB, 768=768MB, 1024=1024MB, 1280=1280MB, 1536=1536MB, 1792=1792MB,
+    2048=2048MB, 2304=2304MB, 2560=2560MB, 2816=2816MB, 3072=3072MB\n
+    When AUTO mode selected, the MMIO size will be calculated by required MMIO size from PCIe devices detected.
+  **/
+  UINT32  MmioSize;
+  UINT32  MmioSizeAdjustment;                ///< Offset 56 Increase (given positive value) or Decrease (given negative value) the Reserved MMIO size when Dynamic Tolud/AUTO mode enabled (in MBs): <b>0=no adjustment</b>
+  UINT8   EnableAbove4GBMmio;                ///< Offset 60 Enable/disable above 4GB MMIO resource support: 0=Disable, <b>1=Enable</b>
+  UINT8   Reserved[3];                       ///< Offset 61 Reserved for future use.
+} HOST_BRIDGE_PREMEM_CONFIG;
+
+
+/**
+  This configuration block describes HostBridge settings in Post-Mem.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block Header
+  UINT8  Device4Enable;                      ///< Offser 28 :This policy is used to control enable or disable System Agent Thermal device (0,4,0). <b>0=FALSE</b>, 1=TRUE.
+  UINT8  ChapDeviceEnable;                   ///< Offset 29 :<b>(Test)</b>This policy is used to control enable or disable System Agent Chap device (0,7,0). <b>0=FALSE</b>, 1=TRUE.
+  UINT8  SkipPamLock;                        ///< Offset 30 :To skip PAM register locking. @note It is still recommended to set PCI Config space B0: D0: F0: Offset 80h[0]=1 in platform code even Silicon code skipped this.\n <b>0=All PAM registers will be locked in Silicon code</b>, 1=Skip lock PAM registers in Silicon code.
+  UINT8  EdramTestMode;                      ///< Offset 28 :EDRAM Test Mode. For EDRAM stepping - 0- EDRAM SW Disable, 1- EDRAM SW Enable, <b> 2- EDRAM HW Mode</b>
+} HOST_BRIDGE_PEI_CONFIG;
+
+#pragma pack (pop)
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/HybridGraphicsConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/HybridGraphicsConfig.h
new file mode 100644
index 0000000000..3f420aed48
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/HybridGraphicsConfig.h
@@ -0,0 +1,66 @@
+/** @file
+  Hybrid Graphics policy definitions
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HYBRID_GRAPHICS_CONFIG_H_
+#define _HYBRID_GRAPHICS_CONFIG_H_
+
+#define HYBRID_GRAPHICS_CONFIG_REVISION 2
+
+#pragma pack(push, 1)
+///
+/// GPIO Support
+///
+typedef enum {
+  NotSupported = 0,
+  PchGpio,
+  I2CGpio,
+} GPIO_SUPPORT;
+
+///
+/// CPU PCIe GPIO Data Structure
+///
+typedef struct {
+  UINT8   ExpanderNo; ///< Offset 0 Expander No For I2C based GPIO
+  BOOLEAN Active;     ///< Offset 1 0=Active Low; 1=Active High
+  UINT8   Rsvd0[2];   ///< Offset 2 Reserved
+  UINT32  GpioNo;     ///< Offset 4 GPIO pad
+} CPU_PCIE_GPIO_INFO;
+
+/**
+ CPU PCIE RTD3 GPIO Data Structure
+**/
+typedef struct {
+  CPU_PCIE_GPIO_INFO  HoldRst;      ///< Offset 0 This field contain PCIe HLD RESET GPIO value and level information
+  CPU_PCIE_GPIO_INFO  PwrEnable;    ///< Offset 8 This field contain PCIe PWR Enable GPIO value and level information
+  UINT32              WakeGpioNo;   ///< Offset 16 This field contain PCIe RTD3 Device Wake GPIO Number
+  UINT8               GpioSupport;  ///< Offset 20 Depends on board design the GPIO configuration may be different: <b>0=Not Supported</b>, 1=PCH Based, 2=I2C based
+  UINT8               Rsvd0[3];     ///< Offset 21
+} CPU_PCIE_RTD3_GPIO;
+
+/**
+  This Configuration block configures CPU PCI Express 0/1/2 RTD3 GPIOs & Root Port.
+  Hybrid Gfx uses the same GPIOs & Root port as PCI Express 0/1/2 RTD3.
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Add HgSlot Policy: PEG or PCH Slot Slection for Hybrid Graphics
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER Header;                ///< Offset 0-27 Config Block Header
+  CPU_PCIE_RTD3_GPIO  CpuPcie0Rtd3Gpio;      ///< Offset 28 RTD3 GPIOs used for PCIe
+  UINT8               RootPortIndex;         ///< Offset 52 Root Port Index number used for HG
+  UINT8               HgMode;                ///< Offset 53 HgMode: <b>0=Disabled</b>, 1=HG Muxed, 2=HG Muxless, 3=PEG
+  UINT16              HgSubSystemId;         ///< Offset 54 Hybrid Graphics Subsystem ID: <b>2212</b>
+  UINT16              HgDelayAfterPwrEn;     ///< Offset 56 Dgpu Delay after Power enable using Setup option: 0=Minimal, 1000=Maximum, <b>300=300 microseconds</b>
+  UINT16              HgDelayAfterHoldReset; ///< Offset 58 Dgpu Delay after Hold Reset using Setup option: 0=Minimal, 1000=Maximum, <b>100=100 microseconds</b>
+  CPU_PCIE_RTD3_GPIO  CpuPcie1Rtd3Gpio;      ///< Offset 60 RTD3 GPIOs used for PCIe
+  CPU_PCIE_RTD3_GPIO  CpuPcie2Rtd3Gpio;      ///< Offset 84 RTD3 GPIOs used for PCIe
+  CPU_PCIE_RTD3_GPIO  CpuPcie3Rtd3Gpio;      ///< Offset 108 RTD3 GPIOs used for PCIe
+  UINT8               HgSlot;                ///< Offset 132 Slot selection between PEG and PCH
+  UINT8               Rsvd0[3];              ///< Offset 133 Reserved Bytes
+} HYBRID_GRAPHICS_CONFIG;
+#pragma pack(pop)
+#endif // _HYBRID_GRAPHICS_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/HybridStorageConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/HybridStorageConfig.h
new file mode 100644
index 0000000000..705fe43751
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/HybridStorageConfig.h
@@ -0,0 +1,36 @@
+/** @file
+  Hybrid Storage policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HYBRID_STORAGE_CONFIG_H_
+#define _HYBRID_STORAGE_CONFIG_H_
+
+#include <ConfigBlock.h>
+
+#define HYBRID_STORAGE_CONFIG_REVISION 1
+
+extern EFI_GUID gHybridStorageConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The HYBRID_STORAGE_CONFIG block describes the expected configuration for Hybrid Storage device
+
+  <b>Revision 1</b>:
+  - Init version
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    Hybrid Storage Mode
+    <b>0: Disable</b>, 1: Enable Dynamic Configuration
+  **/
+  UINT8    HybridStorageMode;
+  UINT8    RsvdBytes[3];
+} HYBRID_STORAGE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _HYBRID_STORAGE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
new file mode 100644
index 0000000000..a9275152f5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
@@ -0,0 +1,34 @@
+/** @file
+  Integrated Error Handler policy.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _IEH_CONFIG_H_
+#define _IEH_CONFIG_H_
+
+#define IEH_MODE_BYPASS 0
+#define IEH_MODE_ENABLE 1
+
+#define IEH_CONFIG_REVISION 1
+extern EFI_GUID gIehConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The IEH_CONFIG block describes the expected configuration of the PCH
+  Integrated Error Handler.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
+  /**
+    IEH mode <b>0: Bypass Mode</b>; 1: Enable
+  **/
+  UINT32    Mode            :  1;
+  UINT32    RsvdBits0       : 31;       ///< Reserved bits
+} IEH_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _IEH_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
new file mode 100644
index 0000000000..75a11e3052
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
@@ -0,0 +1,134 @@
+/** @file
+  ISH policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _ISH_CONFIG_H_
+#define _ISH_CONFIG_H_
+
+#define ISH_PREMEM_CONFIG_REVISION 1
+#define ISH_CONFIG_REVISION 1
+extern EFI_GUID gIshPreMemConfigGuid;
+extern EFI_GUID gIshConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  ISH GPIO settings
+**/
+typedef struct {
+  /**
+    GPIO signals pin muxing settings. If signal can be enable only on a single pin
+    then this parameter should be set to 0. Refer to GPIO_*_MUXING_ISH_*x_* in GpioPins*.h
+    for supported settings on a given platform
+  **/
+  UINT32   PinMux;                      ///< GPIO Pin mux configuration. Refer to GPIO_*_MUXING_ISH_*x_MOSI_*
+  /**
+    GPIO Pads Internal Termination.
+    For more information please see Platform Design Guide.
+    Check GPIO_ELECTRICAL_CONFIG for reference
+  **/
+  UINT32   PadTermination;
+} ISH_GPIO_CONFIG;
+
+/**
+  SPI signals settings.
+**/
+typedef struct {
+  ISH_GPIO_CONFIG   Mosi;                        ///< MOSI Pin configuration.
+  ISH_GPIO_CONFIG   Miso;                        ///< MISO Pin configuration.
+  ISH_GPIO_CONFIG   Clk;                         ///< CLK  Pin configuration.
+  ISH_GPIO_CONFIG   Cs[PCH_MAX_ISH_SPI_CS_PINS]; ///< CS   Pin configuration.
+} ISH_SPI_PIN_CONFIG;
+
+
+/**
+  UART signals settings.
+**/
+typedef struct {
+  ISH_GPIO_CONFIG   Rx;    ///< RXD Pin configuration.
+  ISH_GPIO_CONFIG   Tx;    ///< TXD Pin configuration.
+  ISH_GPIO_CONFIG   Rts;   ///< RTS Pin configuration.
+  ISH_GPIO_CONFIG   Cts;   ///< CTS Pin configuration.
+} ISH_UART_PIN_CONFIG;
+
+
+/**
+  I2C signals settings.
+**/
+typedef struct {
+  ISH_GPIO_CONFIG   Sda;    ///< SDA Pin configuration.
+  ISH_GPIO_CONFIG   Scl;    ///< SCL Pin configuration.
+} ISH_I2C_PIN_CONFIG;
+
+
+/**
+  Struct contains GPIO pins assigned and signal settings of SPI
+**/
+typedef struct {
+  UINT8               Enable;                            ///< ISH SPI GPIO pins assigned: <b>0: False</b> 1: True
+  UINT8               CsEnable[PCH_MAX_ISH_SPI_CS_PINS]; ///< ISH SPI CS pins assigned: <b>0: False</b> 1: True
+  UINT16              RsvdField0;                        ///< Reserved field
+  ISH_SPI_PIN_CONFIG  PinConfig;
+} ISH_SPI;
+
+
+/**
+  Struct contains GPIO pins assigned and signal settings of UART
+**/
+typedef struct {
+  UINT32              Enable      :  1;   ///< ISH UART GPIO pins assigned: <b>0: False</b> 1: True
+  UINT32              RsvdBits0   : 31;   ///< Reserved Bits
+  ISH_UART_PIN_CONFIG PinConfig;
+} ISH_UART;
+
+/**
+  Struct contains GPIO pins assigned and signal settings of I2C
+**/
+typedef struct {
+  UINT32              Enable      :  1;   ///< ISH I2C GPIO pins assigned: <b>0: False</b> 1: True
+  UINT32              RsvdBits0   : 31;   ///< Reserved Bits
+  ISH_I2C_PIN_CONFIG  PinConfig;
+} ISH_I2C;
+
+/**
+  Struct contains GPIO pins assigned and signal settings of GP
+**/
+typedef struct {
+  UINT32           Enable      :  1;   ///< ISH GP GPIO pins assigned: <b>0: False</b> 1: True
+  UINT32           RsvdBits0   : 31;   ///< Reserved Bits
+  ISH_GPIO_CONFIG  PinConfig;
+} ISH_GP;
+
+///
+/// The ISH_CONFIG block describes Integrated Sensor Hub device.
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;               ///< Config Block Header
+  ISH_SPI  Spi[PCH_MAX_ISH_SPI_CONTROLLERS];
+  ISH_UART Uart[PCH_MAX_ISH_UART_CONTROLLERS];
+  ISH_I2C  I2c[PCH_MAX_ISH_I2C_CONTROLLERS];
+  ISH_GP   Gp[PCH_MAX_ISH_GP_PINS];
+
+  UINT32   PdtUnlock            :  1;         ///< ISH PDT Unlock Msg: <b>0: False</b> 1: True
+  UINT32   RsvdBits0            : 31;         ///< Reserved Bits
+
+} ISH_CONFIG;
+
+///
+/// Premem Policy for Integrated Sensor Hub device.
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;     ///< Config Block Header
+  /**
+    ISH Controler 0: Disable; <b>1: Enable</b>.
+    For Desktop sku, the ISH POR should be disabled. <b> 0:Disable </b>.
+  **/
+  UINT32    Enable          :  1;
+  UINT32    RsvdBits0       : 31;   ///< Reserved Bits
+} ISH_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _ISH_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.h
new file mode 100644
index 0000000000..7f6fa8675b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.h
@@ -0,0 +1,58 @@
+/** @file
+  Interrupt policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _INTERRUPT_CONFIG_H_
+#define _INTERRUPT_CONFIG_H_
+
+#define INTERRUPT_CONFIG_REVISION 1
+extern EFI_GUID gInterruptConfigGuid;
+
+#pragma pack (push,1)
+
+//
+// --------------------- Interrupts Config ------------------------------
+//
+typedef enum {
+  PchNoInt,        ///< No Interrupt Pin
+  PchIntA,
+  PchIntB,
+  PchIntC,
+  PchIntD
+} PCH_INT_PIN;
+
+///
+/// The PCH_DEVICE_INTERRUPT_CONFIG block describes interrupt pin, IRQ and interrupt mode for PCH device.
+///
+typedef struct {
+  UINT8        Device;                  ///< Device number
+  UINT8        Function;                ///< Device function
+  UINT8        IntX;                    ///< Interrupt pin: INTA-INTD (see PCH_INT_PIN)
+  UINT8        Irq;                     ///< IRQ to be set for device.
+} PCH_DEVICE_INTERRUPT_CONFIG;
+
+#define PCH_MAX_DEVICE_INTERRUPT_CONFIG 128       ///< Number of all PCH devices
+#define PCH_MAX_PXRC_CONFIG               8       ///< Number of PXRC registers in ITSS
+#define PCH_MAX_ITSS_IPC_REGS             4       ///< Number of IPC registers in ITSS
+#define PCH_MAX_ITSS_IRQ_NUM            120       ///< Maximum number of IRQs
+
+
+///
+/// The PCH_INTERRUPT_CONFIG block describes interrupt settings for PCH.
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER          Header;                                          ///< Config Block Header
+  UINT8                        NumOfDevIntConfig;                               ///< Number of entries in DevIntConfig table
+  UINT8                        Rsvd0[3];                                        ///< Reserved bytes, align to multiple 4.
+  PCH_DEVICE_INTERRUPT_CONFIG  DevIntConfig[PCH_MAX_DEVICE_INTERRUPT_CONFIG];   ///< Array which stores PCH devices interrupts settings
+  UINT8                        GpioIrqRoute;                                    ///< Interrupt routing for GPIO. Default is <b>14</b>.
+  UINT8                        SciIrqSelect;                                    ///< Interrupt select for SCI. Default is <b>9</b>.
+  UINT8                        TcoIrqSelect;                                    ///< Interrupt select for TCO. Default is <b>9</b>.
+  UINT8                        TcoIrqEnable;                                    ///< Enable IRQ generation for TCO. <b>0: Disable</b>; 1: Enable.
+} PCH_INTERRUPT_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _INTERRUPT_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
new file mode 100644
index 0000000000..726a27f7a1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
@@ -0,0 +1,60 @@
+/** @file
+  IoApic policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IOAPIC_CONFIG_H_
+#define _IOAPIC_CONFIG_H_
+
+#define IOAPIC_CONFIG_REVISION 1
+extern EFI_GUID gIoApicConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PCH_IOAPIC_CONFIG block describes the expected configuration of the PCH
+  IO APIC, it's optional and PCH code would ignore it if the BdfValid bit is
+  not TRUE. Bus:device:function fields will be programmed to the register
+  P2SB IBDF(P2SB PCI offset R6Ch-6Dh), it's using for the following purpose:
+  As the Requester ID when initiating Interrupt Messages to the processor.
+  As the Completer ID when responding to the reads targeting the IOxAPI's
+  Memory-Mapped I/O registers.
+  This field defaults to Bus 0: Device 31: Function 0 after reset. BIOS can
+  program this field to provide a unique Bus:Device:Function number for the
+  internal IOxAPIC.
+  The address resource range of IOAPIC must be reserved in E820 and ACPI as
+  system resource.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  UINT32  IoApicEntry24_119     :  1;   ///< 0: Disable; <b>1: Enable</b> IOAPIC Entry 24-119
+  /**
+    Enable 8254 Static Clock Gating during early POST time. 0: Disable, <b>1: Enable</b>
+    Setting 8254CGE is required to support SLP_S0.
+    Enable this if 8254 timer is not used.
+    However, set 8254CGE=1 in POST time might fail to boot legacy OS using 8254 timer.
+    Make sure it is disabled to support legacy OS using 8254 timer.
+    @note:
+    For some OS environment that it needs to set 8254CGE in late state it should
+    set this policy to FALSE and use ItssSet8254ClockGateState  (TRUE) in SMM later.
+    This is also required during S3 resume.
+    To avoid SMI requirement in S3 reusme path, it can enable the Enable8254ClockGatingOnS3
+    and RC will do 8254 CGE programming in PEI during S3 resume with BOOT_SAI.
+  **/
+  UINT32  Enable8254ClockGating :  1;
+  /**
+    Enable 8254 Static Clock Gating on S3 resume path. 0: Disable, <b>1: Enable</b>
+    This is only applicable when Enable8254ClockGating is disabled.
+    If Enable8254ClockGating is enabled, RC will do the 8254 CGE programming on
+    S3 resume path as well.
+  **/
+  UINT32  Enable8254ClockGatingOnS3 :  1;
+  UINT32  RsvdBits1             : 29;   ///< Reserved bits
+  UINT8   IoApicId;                     ///< This member determines IOAPIC ID. Default is <b>0x02</b>.
+  UINT8   Rsvd0[3];                     ///< Reserved bytes
+} PCH_IOAPIC_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _IOAPIC_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
new file mode 100644
index 0000000000..82786501f0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
@@ -0,0 +1,117 @@
+/** @file
+  ME config block for PEI phase
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _ME_PEI_CONFIG_H_
+#define _ME_PEI_CONFIG_H_
+
+#define ME_PEI_PREMEM_CONFIG_REVISION 2
+extern EFI_GUID gMePeiPreMemConfigGuid;
+
+#ifndef PLATFORM_POR
+#define PLATFORM_POR  0
+#endif
+#ifndef FORCE_ENABLE
+#define FORCE_ENABLE  1
+#endif
+#ifndef FORCE_DISABLE
+#define FORCE_DISABLE 2
+#endif
+
+#pragma pack (push,1)
+
+/**
+  ME Pei Pre-Memory Configuration Structure.
+
+  <b>Revision 1:</b>
+  - Initial version.
+  <b>Revision 2:</b>
+  - Add SkipCpuReplacementCheck Option.
+  <b>Revision 3:</b>
+  - Deprecate SendDidMsg.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                 ///< Config Block Header
+  UINT32 HeciTimeouts                     : 1;  ///< 0: Disable; <b>1: Enable</b> - HECI Send/Receive Timeouts.
+  /**
+    <b>(Test)</b>
+    <b>0: Disabled</b>
+       1: ME DID init stat 0 - Success
+       2: ME DID init stat 1 - No Memory in Channels
+       3: ME DID init stat 2 - Memory Init Error
+  **/
+  UINT32 DidInitStat                      : 2;
+  /**
+    <b>(Test)</b>
+    <b>0: Set to 0 to enable polling for CPU replacement</b>
+       1: Set to 1 will disable polling for CPU replacement
+  **/
+  UINT32 DisableCpuReplacedPolling        : 1;
+  UINT32 SendDidMsg                       : 1;  ///< <b>(Deprecated)</b> 0: Disable; <b>1: Enable</b> - Enable/Disable to send DID message.
+  /**
+    <b>(Test)</b>
+    <b>0: ME BIOS will check each messages before sending</b>
+       1: ME BIOS always sends messages without checking
+  **/
+  UINT32 DisableMessageCheck              : 1;
+  /**
+    <b>(Test)</b>
+    The SkipMbpHob policy determines whether ME BIOS Payload data will be requested during boot
+    in a MBP message. If set to 1, BIOS will send the MBP message with SkipMbp flag
+    set causing CSME to respond with MKHI header only and no MBP data
+    <b>0: ME BIOS will keep MBP and create HOB for MBP data</b>
+       1: ME BIOS will skip MBP data
+  **/
+  UINT32 SkipMbpHob                       : 1;
+  UINT32 HeciCommunication2               : 1;  ///< <b>(Test)</b> <b>0: Disable</b>; 1: Enable - Enable/Disable HECI2.
+  UINT32 KtDeviceEnable                   : 1;  ///< <b>(Test)</b> 0: Disable; <b>1: Enable</b> - Enable/Disable Kt Device.
+  UINT32 SkipCpuReplacementCheck          : 1;  ///< <b>(Test)</b> <b>0: Disable</b>; 1: Enable - Enable/Disable to skip CPU replacement check.
+  UINT32 RsvdBits                         : 22; ///< Reserved for future use & Config block alignment
+  UINT32 Heci1BarAddress;                       ///< HECI1 BAR address.
+  UINT32 Heci2BarAddress;                       ///< HECI2 BAR address.
+  UINT32 Heci3BarAddress;                       ///< HECI3 BAR address.
+} ME_PEI_PREMEM_CONFIG;
+#pragma pack (pop)
+
+
+#define ME_PEI_CONFIG_REVISION 3
+extern EFI_GUID gMePeiConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  ME Pei Post-Memory Configuration Structure.
+
+  <b>Revision 1:</b>
+  - Initial version.
+  <b>Revision 2</b>:
+  - Deprecated Heci3Enabled.
+  <b>Revision 3</b>
+  - Added EnforceEDebugMode.
+**/
+
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                 ///< Config Block Header
+
+  UINT32 EndOfPostMessage                 : 2;  ///< 0: Disabled; 1: Send in PEI; <b>2: Send in DXE</b> - Send EOP at specific phase.
+  UINT32 Heci3Enabled                     : 1;  ///< @deprecated
+  UINT32 DisableD0I3SettingForHeci        : 1;  ///< <b>(Test)</b> <b>0: Disable</b>; 1: Enable - Enable/Disable D0i3 for HECI.
+  /**
+    Enable/Disable Me Unconfig On Rtc Clear. If enabled, BIOS will send MeUnconfigOnRtcClearDisable Msg with parameter 0.
+    It will cause ME to unconfig if RTC is cleared.
+    -    0: Disable
+    - <b>1: Enable</b>
+    -    2: Cmos is clear, status unkonwn
+    -    3: Reserved
+  **/
+  UINT32 MeUnconfigOnRtcClear             : 2;
+  UINT32 MctpBroadcastCycle               : 1;   ///< <b>(Test)</b> <b>0: Disable</b>; 1: Enable - Program registers for MCTP Cycle.
+  UINT32 EnforceEDebugMode                : 1;   ///< <b>0: Disable</b>; 1: Enable - Enforces ME to enter Enhanced Debug Mode
+  UINT32 RsvdBits                         : 24;  ///< Reserved for future use & Config block alignment
+} ME_PEI_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _ME_PEI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/MemoryConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/MemoryConfig.h
new file mode 100644
index 0000000000..17c0a10eee
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/MemoryConfig.h
@@ -0,0 +1,478 @@
+/** @file
+  Policy definition of Memory Config Block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _MEMORY_CONFIG_H_
+#define _MEMORY_CONFIG_H_
+
+
+#pragma pack(push, 1)
+
+// MEMORY_CONFIG_REVISION 3 adds DDR5 PDA Enumeration training within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 4 adds LPDDR4 Command Mirroring within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 5 adds CpuBclkSpread option within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 6 adds McParity option within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 7 adds VddqVoltageOverride option within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 8 adds ExtendedBankHashing option within MEMORY_CONFIGURATION
+// MEMORY_CONFIG_REVISION 9 adds IbeccErrorInj option within MEMORY_CONFIGURATION
+#define MEMORY_CONFIG_REVISION 9
+///
+/// MEMORY_CONFIG interface definitions
+///
+#define MRC_MAX_RCOMP_TARGETS  5
+///
+/// Memory SubSystem Definitions
+///
+#define MEM_CFG_MAX_CONTROLLERS          2
+#define MEM_CFG_MAX_CHANNELS             4
+#define MEM_CFG_MAX_CHANNEL_SHARE_REGS   2
+#define MEM_CFG_MAX_DIMMS                2
+#define MEM_CFG_MAX_RANKS_PER_DIMM       2
+#define MEM_CFG_NUM_BYTES_MAPPED         2
+#define MEM_CFG_MAX_SPD_SIZE             1024
+#define MEM_CFG_MAX_SOCKETS              (MEM_CFG_MAX_CONTROLLERS * MEM_CFG_MAX_CHANNELS * MEM_CFG_MAX_DIMMS)
+#define MEM_CFG_MAX_ROWS                 (MEM_CFG_MAX_RANKS_PER_DIMM * MEM_CFG_MAX_SOCKETS)
+#ifndef MEM_MAX_SAGV_POINTS
+#define MEM_MAX_SAGV_POINTS                  4
+#endif
+#define MEM_MAX_IBECC_REGIONS                8
+///
+/// SMRAM Memory Range
+///
+#define PEI_MR_SMRAM_ABSEG_MASK     0x01
+#define PEI_MR_SMRAM_HSEG_MASK      0x02
+
+///
+/// SA SPD profile selections.
+///
+typedef enum {
+  Default,             ///< 0, Default SPD
+  UserDefined,         ///< 1, User Defined profile
+  XMPProfile1,         ///< 2, XMP Profile 1
+  XMPProfile2,         ///< 3, XMP Profile 2
+  XMPProfileMax = 0xFF ///< Ensures SA_SPD is UINT8
+} SA_SPD;
+
+///
+/// Define the boot modes used by the SPD read function.
+///
+typedef enum {
+  SpdCold,       ///< Cold boot
+  SpdWarm,       ///< Warm boot
+  SpdS3,         ///< S3 resume
+  SpdFast,       ///< Fast boot
+  SpdBootModeMax ///< Delimiter
+} SPD_BOOT_MODE;
+
+/**
+  SPD Data Buffer
+**/
+typedef struct {
+  UINT8 SpdData[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHANNELS][MEM_CFG_MAX_DIMMS][MEM_CFG_MAX_SPD_SIZE];  ///< SpdData
+//Next Field Offset 2048
+} SPD_DATA_BUFFER;
+
+/**
+  DqDqs Mapping
+**/
+typedef struct {
+  UINT8 DqsMapCpu2Dram[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHANNELS][MEM_CFG_NUM_BYTES_MAPPED];  ///< DqsMapCpu2Dram
+  UINT8 DqMapCpu2Dram[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHANNELS][MEM_CFG_NUM_BYTES_MAPPED][8];  ///< DqMapCpu2Dram
+//Next Field Offset 16
+} SA_MEMORY_DQDQS_MAPPING;
+
+/**
+  Rcomp Policies
+**/
+typedef struct {
+  UINT16  RcompResistor;                      ///< Offset 0: Reference RCOMP resistors on motherboard ~ 100 ohms
+  UINT16  RcompTarget[MRC_MAX_RCOMP_TARGETS]; ///< Offset 1: RCOMP target values for DqOdt, DqDrv, CmdDrv, CtlDrv, ClkDrv
+//Next Field Offset 16
+} SA_MEMORY_RCOMP;
+
+/**
+  SPD Offset Table
+**/
+typedef struct {
+  UINT16 Start;           ///< Offset 0
+  UINT16 End;             ///< Offset 2
+  UINT8  BootMode;        ///< Offset 4
+  UINT8  Reserved3[3];    ///< Offset 5 Reserved for future use
+} SPD_OFFSET_TABLE;
+
+///
+/// SA memory address decode.
+///
+typedef struct
+{
+  UINT8  Controller; ///< Offset 0 Zero based Controller number
+  UINT8  Channel;    ///< Offset 1 Zero based Channel number
+  UINT8  Dimm;       ///< Offset 2 Zero based DIMM number
+  UINT8  Rank;       ///< Offset 3 Zero based Rank number
+  UINT8  BankGroup;  ///< Offset 4 Zero based Bank Group number
+  UINT8  Bank;       ///< Offset 5 Zero based Bank number
+  UINT16 Cas;        ///< Offset 6 Zero based CAS number
+  UINT32 Ras;        ///< Offset 8 Zero based RAS number
+} SA_ADDRESS_DECODE;
+
+typedef UINT8      (EFIAPI * SA_IO_READ_8)               (UINTN IoAddress);                                                                                                                                                                               ///< CPU I/O port 8-bit read.
+typedef UINT16     (EFIAPI * SA_IO_READ_16)              (UINTN IoAddress);                                                                                                                                                                               ///< CPU I/O port 16-bit read.
+typedef UINT32     (EFIAPI * SA_IO_READ_32)              (UINTN IoAddress);                                                                                                                                                                               ///< CPU I/O port 32-bit read.
+typedef UINT8      (EFIAPI * SA_IO_WRITE_8)              (UINTN IoAddress, UINT8 Value);                                                                                                                                                                  ///< CPU I/O port 8-bit write.
+typedef UINT16     (EFIAPI * SA_IO_WRITE_16)             (UINTN IoAddress, UINT16 Value);                                                                                                                                                                 ///< CPU I/O port 16-bit write.
+typedef UINT32     (EFIAPI * SA_IO_WRITE_32)             (UINTN IoAddress, UINT32 Value);                                                                                                                                                                 ///< CPU I/O port 32-bit write.
+typedef UINT8      (EFIAPI * SA_MMIO_READ_8)             (UINTN Address);                                                                                                                                                                                 ///< Memory Mapped I/O port 8-bit read.
+typedef UINT16     (EFIAPI * SA_MMIO_READ_16)            (UINTN Address);                                                                                                                                                                                 ///< Memory Mapped I/O port 16-bit read.
+typedef UINT32     (EFIAPI * SA_MMIO_READ_32)            (UINTN Address);                                                                                                                                                                                 ///< Memory Mapped I/O port 32-bit read.
+typedef UINT64     (EFIAPI * SA_MMIO_READ_64)            (UINTN Address);                                                                                                                                                                                 ///< Memory Mapped I/O port 64-bit read.
+typedef UINT8      (EFIAPI * SA_MMIO_WRITE_8)            (UINTN Address, UINT8 Value);                                                                                                                                                                    ///< Memory Mapped I/O port 8-bit write.
+typedef UINT16     (EFIAPI * SA_MMIO_WRITE_16)           (UINTN Address, UINT16 Value);                                                                                                                                                                   ///< Memory Mapped I/O port 16-bit write.
+typedef UINT32     (EFIAPI * SA_MMIO_WRITE_32)           (UINTN Address, UINT32 Value);                                                                                                                                                                   ///< Memory Mapped I/O port 32-bit write.
+typedef UINT64     (EFIAPI * SA_MMIO_WRITE_64)           (UINTN Address, UINT64 Value);                                                                                                                                                                   ///< Memory Mapped I/O port 64-bit write.
+typedef UINT8      (EFIAPI * SA_SMBUS_READ_8)            (UINTN Address, RETURN_STATUS *Status);                                                                                                                                                          ///< Smbus 8-bit read.
+typedef UINT16     (EFIAPI * SA_SMBUS_READ_16)           (UINTN Address, RETURN_STATUS *Status);                                                                                                                                                          ///< Smbus 16-bit read.
+typedef UINT8      (EFIAPI * SA_SMBUS_WRITE_8)           (UINTN Address, UINT8 Value, RETURN_STATUS *Status);                                                                                                                                             ///< Smbus 8-bit write.
+typedef UINT16     (EFIAPI * SA_SMBUS_WRITE_16)          (UINTN Address, UINT16 Value, RETURN_STATUS *Status);                                                                                                                                            ///< Smbus 16-bit write.
+typedef UINT32     (EFIAPI * SA_GET_PCI_DEVICE_ADDRESS)  (UINT8 Bus, UINT8 Device, UINT8 Function, UINT8 Offset);                                                                                                                                         ///< Get PCI device address.
+typedef UINT32     (EFIAPI * SA_GET_PCIE_DEVICE_ADDRESS) (UINT8 Bus, UINT8 Device, UINT8 Function, UINT8 Offset);                                                                                                                                         ///< Get PCI express device address.
+typedef VOID       (EFIAPI * SA_GET_RTC_TIME)            (UINT8 *Second, UINT8 *Minute, UINT8 *Hour, UINT8 *Day, UINT8 *Month, UINT16 *Year);                                                                                                             ///< Get the current time value.
+typedef UINT64     (EFIAPI * SA_GET_CPU_TIME)            (VOID);                                                                                                                                                                                          ///< The current CPU time in milliseconds.
+typedef VOID *     (EFIAPI * SA_MEMORY_COPY)             (VOID *Destination, CONST VOID *Source, UINTN NumBytes);                                                                                                                                         ///< Perform byte copy operation.
+typedef VOID *     (EFIAPI * SA_MEMORY_SET_BYTE)         (VOID *Buffer, UINTN NumBytes, UINT8 Value);                                                                                                                                                     ///< Perform byte initialization operation.
+typedef VOID *     (EFIAPI * SA_MEMORY_SET_WORD)         (VOID *Buffer, UINTN NumWords, UINT16 Value);                                                                                                                                                    ///< Perform word initialization operation.
+typedef VOID *     (EFIAPI * SA_MEMORY_SET_DWORD)        (VOID *Buffer, UINTN NumDwords, UINT32 Value);                                                                                                                                                   ///< Perform dword initialization operation.
+typedef UINT64     (EFIAPI * SA_LEFT_SHIFT_64)           (UINT64 Data, UINTN NumBits);                                                                                                                                                                    ///< Left shift the 64-bit data value by specified number of bits.
+typedef UINT64     (EFIAPI * SA_RIGHT_SHIFT_64)          (UINT64 Data, UINTN NumBits);                                                                                                                                                                    ///< Right shift the 64-bit data value by specified number of bits.
+typedef UINT64     (EFIAPI * SA_MULT_U64_U32)            (UINT64 Multiplicand, UINT32 Multiplier);                                                                                                                                                        ///< Multiply a 64-bit data value by a 32-bit data value.
+typedef UINT64     (EFIAPI * SA_DIV_U64_U64)             (UINT64 Dividend, UINT64 Divisor, UINT64 *Remainder);                                                                                                                                            ///< Divide a 64-bit data value by a 64-bit data value.
+typedef BOOLEAN    (EFIAPI * SA_GET_SPD_DATA)            (SPD_BOOT_MODE BootMode, UINT8 SpdAddress, UINT8 *Buffer, UINT8 *Ddr3Table, UINT32 Ddr3TableSize, UINT8 *Ddr4Table, UINT32 Ddr4TableSize, UINT8 *LpddrTable, UINT32 LpddrTableSize);             ///< Read the SPD data over the SMBus, at the given SmBus SPD address and copy the data to the data structure.
+typedef UINT8      (EFIAPI * SA_GET_MC_ADDRESS_DECODE)   (UINT64 Address, SA_ADDRESS_DECODE *DramAddress);
+typedef UINT8      (EFIAPI * SA_GET_MC_ADDRESS_ENCODE)   (SA_ADDRESS_DECODE *DramAddress, UINT64 Address);
+typedef BOOLEAN    (EFIAPI * SA_GET_RANDOM_NUMBER)       (UINT32 *Rand);                                                                                                                                                                                  ///< Get the next random 32-bit number.
+typedef EFI_STATUS (EFIAPI * SA_CPU_MAILBOX_READ)        (UINT32 Type, UINT32 Command, UINT32 *Value, UINT32 *Status);                                                                                                                                    ///< Perform a CPU mailbox read.
+typedef EFI_STATUS (EFIAPI * SA_CPU_MAILBOX_WRITE)       (UINT32 Type, UINT32 Command, UINT32 Value, UINT32 *Status);                                                                                                                                     ///< Perform a CPU mailbox write.
+typedef UINT32     (EFIAPI * SA_GET_MEMORY_VDD)          (VOID *GlobalData, UINT32 DefaultVdd);                                                                                                                                                           ///< Get the current memory voltage (VDD).
+typedef UINT32     (EFIAPI * SA_SET_MEMORY_VDD)          (VOID *GlobalData, UINT32 DefaultVdd, UINT32 Value);                                                                                                                                             ///< Set the memory voltage (VDD) to the given value.
+typedef UINT32     (EFIAPI * SA_CHECKPOINT)              (VOID *GlobalData, UINT32 CheckPoint, VOID *Scratch);                                                                                                                                            ///< Check point that is called at various points in the MRC.
+typedef VOID       (EFIAPI * SA_DEBUG_HOOK)              (VOID *GlobalData, UINT16 DisplayDebugNumber);                                                                                                                                                   ///< Typically used to display to the I/O port 80h.
+typedef UINT8      (EFIAPI * SA_CHANNEL_EXIST)           (VOID *Outputs, UINT8 Channel);                                                                                                                                                                  ///< Returns whether Channel is or is not present.
+typedef INT32      (EFIAPI * SA_PRINTF)                  (VOID *Debug, UINT32 Level, char *Format, ...);                                                                                                                                                  ///< Print to output stream/device.
+typedef VOID       (EFIAPI * SA_DEBUG_PRINT)             (VOID *String);                                                                                                                                                                                  ///< Output a string to the debug stream/device.
+typedef UINT32     (EFIAPI * SA_CHANGE_MARGIN)           (VOID *GlobalData, UINT8 Param, INT32 Value0, INT32 Value1, UINT8 EnMultiCast, UINT8 Channel, UINT8 RankIn, UINT8 Byte, UINT8 BitIn, UINT8 UpdateMrcData, UINT8 SkipWait, UINT32 RegFileParam);  ///< Change the margin.
+typedef UINT8      (EFIAPI * SA_SIGN_EXTEND)             (UINT8 Value, UINT8 OldMsb, UINT8 NewMsb);                                                                                                                                                       ///< Sign extends OldMSB to NewMSB Bits (Eg: Bit 6 to Bit 7).
+typedef VOID       (EFIAPI * SA_SHIFT_PI_COMMAND_TRAIN)  (VOID *GlobalData, UINT8 Channel, UINT8 Iteration, UINT8 RankMask, UINT8 GroupMask, INT32 NewValue, UINT8 UpdateHost);                                                                           ///< Move CMD/CTL/CLK/CKE PIs during training.
+typedef VOID       (EFIAPI * SA_UPDATE_VREF)             (VOID *GlobalData, UINT8 Channel, UINT8 RankMask, UINT16 DeviceMask, UINT8 VrefType, INT32 Offset, BOOLEAN UpdateMrcData, BOOLEAN PDAmode, BOOLEAN SkipWait);                                    ///< Update the Vref value and wait until it is stable.
+typedef UINT8      (EFIAPI * SA_GET_RTC_CMOS)            (UINT8 Location);                                                                                                                                                                                ///< Get the current value of the specified RTC CMOS location.
+typedef UINT64     (EFIAPI * SA_MSR_READ_64)             (UINT32 Location);                                                                                                                                                                               ///< Get the current value of the specified MSR location.
+typedef UINT64     (EFIAPI * SA_MSR_WRITE_64)            (UINT32 Location, UINT64 Data);                                                                                                                                                                  ///< Set the current value of the specified MSR location.
+typedef VOID       (EFIAPI * SA_MRC_RETURN_FROM_SMC)     (VOID *GlobalData, UINT32 MrcStatus);                                                                                                                                                            ///< Hook function after returning from MrcStartMemoryConfiguration()
+typedef VOID       (EFIAPI * SA_MRC_DRAM_RESET)          (UINT32 PciEBaseAddress, UINT32 ResetValue);                                                                                                                                                     ///< Assert or deassert DRAM_RESET# pin; this is used in JEDEC Reset.
+typedef VOID       (EFIAPI * SA_DELAY_NS)                (VOID *GlobalData, UINT32 DelayNs);                                                                                                                                                              ///< Delay (stall) for the given amount of nanoseconds.
+typedef VOID       (EFIAPI * SA_SET_LOCK_PRMRR)          (UINT64 PrmrrBaseAddress, UINT32 PrmrrSize);
+
+
+///
+/// Function calls into the SA.
+///
+typedef struct {
+  SA_IO_READ_8               IoRead8;               ///< Offset 0:   - CPU I/O port 8-bit read.
+  SA_IO_READ_16              IoRead16;              ///< Offset 4:   - CPU I/O port 16-bit read.
+  SA_IO_READ_32              IoRead32;              ///< Offset 8:   - CPU I/O port 32-bit read.
+  SA_IO_WRITE_8              IoWrite8;              ///< Offset 12:  - CPU I/O port 8-bit write.
+  SA_IO_WRITE_16             IoWrite16;             ///< Offset 16:  - CPU I/O port 16-bit write.
+  SA_IO_WRITE_32             IoWrite32;             ///< Offset 20:  - CPU I/O port 32-bit write.
+  SA_MMIO_READ_8             MmioRead8;             ///< Offset 24:  - Memory Mapped I/O port 8-bit read.
+  SA_MMIO_READ_16            MmioRead16;            ///< Offset 28:  - Memory Mapped I/O port 16-bit read.
+  SA_MMIO_READ_32            MmioRead32;            ///< Offset 32:  - Memory Mapped I/O port 32-bit read.
+  SA_MMIO_READ_64            MmioRead64;            ///< Offset 36:  - Memory Mapped I/O port 64-bit read.
+  SA_MMIO_WRITE_8            MmioWrite8;            ///< Offset 40:  - Memory Mapped I/O port 8-bit write.
+  SA_MMIO_WRITE_16           MmioWrite16;           ///< Offset 44:  - Memory Mapped I/O port 16-bit write.
+  SA_MMIO_WRITE_32           MmioWrite32;           ///< Offset 48:  - Memory Mapped I/O port 32-bit write.
+  SA_MMIO_WRITE_64           MmioWrite64;           ///< Offset 52:  - Memory Mapped I/O port 64-bit write.
+  SA_SMBUS_READ_8            SmbusRead8;            ///< Offset 56:  - Smbus 8-bit read.
+  SA_SMBUS_READ_16           SmbusRead16;           ///< Offset 60:  - Smbus 16-bit read.
+  SA_SMBUS_WRITE_8           SmbusWrite8;           ///< Offset 64:  - Smbus 8-bit write.
+  SA_SMBUS_WRITE_16          SmbusWrite16;          ///< Offset 68:  - Smbus 16-bit write.
+  SA_GET_PCI_DEVICE_ADDRESS  GetPciDeviceAddress;   ///< Offset 72:  - Get PCI device address.
+  SA_GET_PCIE_DEVICE_ADDRESS GetPcieDeviceAddress;  ///< Offset 76:  - Get PCI express device address.
+  SA_GET_RTC_TIME            GetRtcTime;            ///< Offset 80:  - Get the current time value.
+  SA_GET_CPU_TIME            GetCpuTime;            ///< Offset 84:  - The current CPU time in milliseconds.
+  SA_MEMORY_COPY             CopyMem;               ///< Offset 88:  - Perform byte copy operation.
+  SA_MEMORY_SET_BYTE         SetMem;                ///< Offset 92:  - Perform byte initialization operation.
+  SA_MEMORY_SET_WORD         SetMemWord;            ///< Offset 96:  - Perform word initialization operation.
+  SA_MEMORY_SET_DWORD        SetMemDword;           ///< Offset 100: - Perform dword initialization operation.
+  SA_LEFT_SHIFT_64           LeftShift64;           ///< Offset 104: - Left shift the 64-bit data value by specified number of bits.
+  SA_RIGHT_SHIFT_64          RightShift64;          ///< Offset 108: - Right shift the 64-bit data value by specified number of bits.
+  SA_MULT_U64_U32            MultU64x32;            ///< Offset 112: - Multiply a 64-bit data value by a 32-bit data value.
+  SA_DIV_U64_U64             DivU64x64;             ///< Offset 116: - Divide a 64-bit data value by a 64-bit data value.
+  SA_GET_SPD_DATA            GetSpdData;            ///< Offset 120: - Read the SPD data over the SMBus, at the given SmBus SPD address and copy the data to the data structure.
+  SA_GET_RANDOM_NUMBER       GetRandomNumber;       ///< Offset 124: - Get the next random 32-bit number.
+  SA_CPU_MAILBOX_READ        CpuMailboxRead;        ///< Offset 128: - Perform a CPU mailbox read.
+  SA_CPU_MAILBOX_WRITE       CpuMailboxWrite;       ///< Offset 132: - Perform a CPU mailbox write.
+  SA_GET_MEMORY_VDD          GetMemoryVdd;          ///< Offset 136: - Get the current memory voltage (VDD).
+  SA_SET_MEMORY_VDD          SetMemoryVdd;          ///< Offset 140: - Set the memory voltage (VDD) to the given value.
+  SA_CHECKPOINT              CheckPoint;            ///< Offset 144: - Check point that is called at various points in the MRC.
+  SA_DEBUG_HOOK              DebugHook;             ///< Offset 148: - Typically used to display to the I/O port 80h.
+  SA_DEBUG_PRINT             DebugPrint;            ///< Offset 152: - Output a string to the debug stream/device.
+  SA_GET_RTC_CMOS            GetRtcCmos;            ///< Offset 156: - Get the current value of the specified RTC CMOS location.
+  SA_MSR_READ_64             ReadMsr64;             ///< Offset 160: - Get the current value of the specified MSR location.
+  SA_MSR_WRITE_64            WriteMsr64;            ///< Offset 164  - Set the current value of the specified MSR location.
+  SA_MRC_RETURN_FROM_SMC     MrcReturnFromSmc;      ///< Offset 168  - Hook function after returning from MrcStartMemoryConfiguration()
+  SA_MRC_DRAM_RESET          MrcDramReset;          ///< Offset 172  - Assert or deassert DRAM_RESET# pin; this is used in JEDEC Reset.
+  SA_DELAY_NS                MrcDelayNs;            ///< Offset 176  - Delay (stall) for the given amount of nanoseconds.
+} SA_FUNCTION_CALLS;
+
+///
+/// Function calls into the MRC.
+///
+typedef struct {
+  SA_CHANNEL_EXIST           MrcChannelExist;       ///< Offset 0:  - Returns whether Channel is or is not present.
+  SA_PRINTF                  MrcPrintf;             ///< Offset 4:  - Print to output stream/device.
+  SA_CHANGE_MARGIN           MrcChangeMargin;       ///< Offset 8:  - Change the margin.
+  SA_SIGN_EXTEND             MrcSignExtend;         ///< Offset 12: - Sign extends OldMSB to NewMSB Bits (Eg: Bit 6 to Bit 7).
+  SA_SHIFT_PI_COMMAND_TRAIN  ShiftPiCommandTrain;   ///< Offset 16: - Move CMD/CTL/CLK/CKE PIs during training.
+  SA_UPDATE_VREF             MrcUpdateVref;         ///< Offset 20: - Update the Vref value and wait until it is stable.
+} SA_MEMORY_FUNCTIONS;
+
+/**
+ Memory Configuration
+ The contents of this structure are CRC'd by the MRC for option change detection.
+ This structure is copied en mass to the MrcInput structure. If you add fields here, you must update the MrcInput structure.
+ <b>Revision 1</b>: - Initial version.
+ <b>Revision 2</b>: - Adding ChHashOverride option.
+ <b>Revision 3</b>: - Adding PDA enumeration option.
+ <b>Revision 4</b>: - Adding LPDDR4 Command Mirroring.
+ <b>Revision 5</b>: - Adding CpuBclkSpread option.
+ <b>Revision 6</b>: - Adding McParity option.
+ <b>Revision 7</b>: - Adding VddqVoltageOverride option.
+ <b>Revision 8</b>: - Adding ExtendedBankHashing option.
+ <b>Revision 9</b>: - Adding IbeccErrorInj option
+ **/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;    ///< Offset 0-27 Config Block Header
+  UINT16  Size;                   ///< Offset 28 The size of this structure, in bytes. Must be the first entry in this structure.
+  UINT8   HobBufferSize;          ///< Offset 30 Size of HOB buffer for MRC
+
+  UINT8   SpdProfileSelected;     ///< Offset 31 SPD XMP profile selection - for XMP supported DIMM: <b>0=Default DIMM profile</b>, 1=Customized profile, 2=XMP profile 1, 3=XMP profile 2.
+
+  // The following parameters are used only when SpdProfileSelected is UserDefined (CUSTOM PROFILE)
+  UINT16  tCL;                    ///< Offset 32 User defined Memory Timing tCL value,   valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 31=Maximum.
+  UINT16  tRCDtRP;                ///< Offset 34 User defined Memory Timing tRCD value (same as tRP), valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 63=Maximum
+  UINT16  tRAS;                   ///< Offset 36 User defined Memory Timing tRAS value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 64=Maximum.
+  UINT16  tWR;                    ///< Offset 38 User defined Memory Timing tWR value,   valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, legal values: 5, 6, 7, 8, 10, 12, 14, 16, 18, 20, 24.
+  UINT16  tRFC;                   ///< Offset 40 User defined Memory Timing tRFC value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 1023=Maximum.
+  UINT16  tRRD;                   ///< Offset 42 User defined Memory Timing tRRD value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 15=Maximum.
+  UINT16  tWTR;                   ///< Offset 44 User defined Memory Timing tWTR value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 28=Maximum.
+  UINT16  tRTP;                   ///< Offset 46 User defined Memory Timing tRTP value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 15=Maximum. DDR4 legal values: 5, 6, 7, 8, 9, 10, 12
+  UINT16  tFAW;                   ///< Offset 48 User defined Memory Timing tFAW value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 63=Maximum.
+  UINT16  tCWL;                   ///< Offset 50 User defined Memory Timing tCWL value,  valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 20=Maximum.
+  UINT16  tREFI;                  ///< Offset 52 User defined Memory Timing tREFI value, valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>, 65535=Maximum.
+  UINT16  PciIndex;               ///< Offset 54 Pci index register address: <b>0xCF8=Default</b>
+  UINT16  PciData;                ///< Offset 56 Pci data register address: <b>0xCFC=Default</b>
+  UINT16  VddVoltage;             ///< Offset 58 DRAM voltage (Vdd) in millivolts: <b>0=Platform Default (no override)</b>, 1200=1.2V, 1350=1.35V etc.
+  UINT16  Idd3n;                  ///< Offset 60 EPG Active standby current (Idd3N) in milliamps from DIMM datasheet.
+  UINT16  Idd3p;                  ///< Offset 62 EPG Active power-down current (Idd3P) in milliamps from DIMM datasheet.
+
+  UINT32  EccSupport:1;              ///< Offset 64 Bit 0  - DIMM Ecc Support option - for Desktop only: 0=Disable, <b>1=Enable</b>
+  UINT32  MrcSafeConfig:1;           ///<           Bit 1  - MRC Safe Mode: <b>0=Disable</b>, 1=Enable
+  UINT32  RemapEnable:1;             ///<           Bit 2  - This option is used to control whether to enable/disable memory remap above 4GB: 0=Disable, <b>1=Enable</b>.
+  UINT32  ScramblerSupport:1;        ///<           Bit 3  - Memory scrambler support: 0=Disable, <b>1=Enable</b>
+  UINT32  Vc1ReadMeter:1;            ///<           Bit 4  - VC1 Read Metering Enable: 0=Disable, <b>1=Enable</b>
+  UINT32  ForceSingleSubchannel:1;   ///<           Bit 5  - TRUE means use SubChannel0 only (for LPDDR4): <b>0=Disable</b>, 1=Enable
+  UINT32  SimicsFlag:1;              ///<           Bit 6  - Option to Enable SIMICS: 0=Disable, <b>1=Enable</b>
+  UINT32  Ddr4DdpSharedClock:1;      ///<           Bit 7  - Select if CLK0 is shared between Rank0 and Rank1 in DDR4 DDP package. <b>0=Not shared</b>, 1=Shared
+  UINT32  SharedZqPin:1;             ///<           Bit 8  - Select if the ZQ resistor is shared between Ranks in DDR4/LPDDR4 DRAM Packages <b>0=Not Shared</b>, 1=Shared
+  UINT32  LpDqsOscEn:1;              ///<           Bit 9  - LPDDR Write DQ/DQS Retraining: 0=Disable, <b>1=Enable</b>
+  UINT32  RmtPerTask:1;              ///<           Bit 10 - Rank Margin Tool Per Task. <b>0 = Disabled</b>, 1 = Enabled
+  UINT32  TrainTrace:1;              ///<           Bit 11 - Trained state tracing debug. <b>0 = Disabled</b>, 1 = Enabled
+  UINT32  SafeMode:1;                ///<           Bit 12 - Define if safe mode is enabled for MC/IO
+  UINT32  MsHashEnable:1;            ///<           Bit 13 - Controller Hash Enable: 0=Disable, <b>1=Enable</b>
+  UINT32  DisPgCloseIdleTimeout:1;   ///<           Bit 14 - Disable Page Close Idle Timeout: 0=Enable, <b>1=Disable</b>
+  UINT32  Ibecc:1;                   ///<           Bit 15 - Inband ECC - for LPDDR4, LPDDR5 and DDR4 only: <b>0=Disable</b>, 1=Enable
+  UINT32  IbeccParity:1;             ///<           Bit 16 - Inband ECC Parity Control - for LPDDR4, LPDDR5 and DDR4 only: <b>0=Disable</b>, 1=Enable
+  UINT32  IbeccOperationMode:2;      ///<           Bits 17:18 - Inband ECC Operation Mode: 0=Functional Mode protects requests based on the address range, <b>1=Makes all requests non protected and ignore range checks</b>, 2=Makes all requests protected and ignore range checks
+  UINT32  ChHashOverride:1;          ///<           Bit 19 - Select if Channel Hash setting values will be taken from input parameters or automatically taken from POR values depending on DRAM type detected.
+  UINT32  McParity:1;                ///<           Bit 20 - MC Parity Control - Enable Parity for CMI/MC: <b>0=Disable</b>, 1=Enable
+  UINT32  IbeccErrorInj:1;           ///<           Bit 21 - In-Band ECC Error Injection: 1=Enable, <b>0=Disable</b>
+  UINT32  RsvdO64B22t31:10;          ///<           Bits 22:31 reserved
+  /**
+   Disables a DIMM slot in the channel even if a DIMM is present\n
+   Array index represents the channel number (0 = channel 0, 1 = channel 1)\n
+     <b>0x0 = DIMM 0 and DIMM 1 enabled</b>\n
+     0x1 = DIMM 0 disabled, DIMM 1 enabled\n
+     0x2 = DIMM 0 enabled, DIMM 1 disabled\n
+     0x3 = DIMM 0 and DIMM 1 disabled (will disable the whole channel)\n
+  **/
+  UINT8   DisableDimmChannel[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHANNELS]; ///< Offset 68-75
+  UINT8   Ratio;                  ///< Offset 76 DDR Frequency ratio, to multiply by 133 or 100 MHz depending on RefClk. <b>0 = Auto</b>
+  UINT8   ProbelessTrace;         ///< Offset 77 Probeless Trace: <b>0=Disabled</b>, <b>1=Enabled</b>
+  /**
+     - Channel Hash Enable.\n
+    NOTE: BIT7 will interleave the channels at a 2 cache-line granularity, BIT8 at 4 and BIT9 at 8\n
+    0=BIT6, <B>1=BIT7</B>, 2=BIT8, 3=BIT9
+  **/
+  UINT8   ChHashInterleaveBit;    ///< Offset 78 Option to select interleave Address bit. Valid values are 0 - 3 for BITS 6 - 9 (Valid values for BDW are 0-7 for BITS 6 - 13)
+  UINT8   SmramMask;              ///< Offset 79 Reserved memory ranges for SMRAM
+  UINT32  BClkFrequency;          ///< Offset 80 Base reference clock value, in Hertz: <b>100000000 = 100Hz</b>, 125000000=125Hz, 167000000=167Hz, 250000000=250Hz
+
+  /// Training Algorithms 1 Offset 84
+  UINT32 ECT:1;                   ///< Bit 0 - Enable/Disable Early Command Training. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 SOT:1;                   ///< Bit 1 - Enable/Disable Sense Amp Offset Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 ERDMPRTC2D:1;            ///< Bit 2 - Enable/Disable Early ReadMPR Timing Centering 2D. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RDMPRT:1;                ///< Bit 3 - Enable/Disable Read MPR Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RCVET:1;                 ///< Bit 4 - Enable/Disable Receive Enable Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 JWRL:1;                  ///< Bit 5 - Enable/Disable JEDEC Write Leveling Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 EWRTC2D:1;               ///< Bit 6 - Enable/Disable Early Write Time Centering 2D Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 ERDTC2D:1;               ///< Bit 7 - Enable/Disable Early Read Time Centering 2D Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 WRTC1D:1;                ///< Bit 8 - Enable/Disable 1D Write Timing Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 WRVC1D:1;                ///< Bit 9 - Enable/Disable 1D Write Voltage Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RDTC1D:1;                ///< Bit 10 - Enable/Disable 1D Read Timing Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 DIMMODTT:1;              ///< Bit 11 - Enable/Disable DIMM ODT Training. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 DIMMRONT:1;              ///< Bit 12 - Enable/Disable DIMM RON training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 WRDSEQT:1;               ///< Bit 13 - Enable/Disable Write Drive Strength / Equalization Training 2D. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 WRSRT:1;                 ///< Bit 14 - Enable/Disable Write Slew Rate traning. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable.</b>
+  UINT32 RDODTT:1;                ///< Bit 15 - Enable/Disable Read ODT Training. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 RDEQT:1;                 ///< Bit 16 - Enable/Disable Read Equalization Training. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 RDAPT:1;                 ///< Bit 17 - Enable/Disable Read Amplifier Power Training. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 WRTC2D:1;                ///< Bit 18 - Enable/Disable 2D Write Timing Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RDTC2D:1;                ///< Bit 19 - Enable/Disable 2D Read Timing Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 WRVC2D:1;                ///< Bit 20 - Enable/Disable 2D Write Voltage Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RDVC2D:1;                ///< Bit 21 - Enable/Disable 2D Read Voltage Centering Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 CMDVC:1;                 ///< Bit 22 - Enable/Disable Command Vref Centering Training. Note it is not recommended to change this setting from the default value 0=Disable, <b>1=Enable</b>.
+  UINT32 LCT:1;                   ///< Bit 23 - Enable/Disable Late Command Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 RTL:1;                   ///< Bit 24 - Enable/Disable Round Trip Latency function. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 TAT:1;                   ///< Bit 25 - Enable/Disable Turn Around Time function. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable.
+  UINT32 RMT:1;                   ///< Bit 26 - Enable/Disable Rank Margin Tool function: <b>0=Disable</b>, 1=Enable.
+  UINT32 MEMTST:1;                ///< Bit 27 - Enable/Disable Memory Test function: <b>0=Disable</b>, 1=Enable.
+  UINT32 ALIASCHK:1;              ///< Bit 28 - Enable/Disable DIMM SPD Alias Check: 0=Disable, <b>1=Enable</b>
+  UINT32 RCVENC1D:1;              ///< Bit 29 - Enable/Disable Receive Enable Centering Training (LPDDR Only). Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable
+  UINT32 RMC:1;                   ///< Bit 30 - Enable/Disable Retrain Margin Check.  Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable
+  UINT32 WRDSUDT:1;               ///< Bit 31 - Enable/Disable Write Drive Strength Up/Dn independently. Note it is not recommended to change this setting from the default value: <b>0=Disable</b>, 1=Enable
+  /// Training Algorithms 2 Offset 88
+  UINT32 DCC       : 1;           ///< Bit 0  - Enable/Disable Duty Cycle Correction: 0=Disable, 1=Enable.
+  UINT32 RDVC1D    : 1;           ///< Bit 1  - Enable/Disable Read Voltage Centering 1D: 0=Disable, 1=Enable.
+  UINT32 TXTCO     : 1;           ///< Bit 2  - Enable/Disable Write TCO Comp Training: 0=Disable, 1=Enable.
+  UINT32 CLKTCO    : 1;           ///< Bit 3  - Enable/Disable Clock TCO Comp Training: 0=Disable, 1=Enable.
+  UINT32 CMDSR     : 1;           ///< Bit 4  - Enable/Disable CMD Slew Rate Training: 0=Disable, 1=Enable.
+  UINT32 CMDDSEQ   : 1;           ///< Bit 5  - Enable/Disable CMD Drive Strength and Tx Equalization: 0=Disable, 1=Enable.
+  UINT32 DIMMODTCA : 1;           ///< Bit 6  - Enable/Disable Dimm ODT CA Training: 0=Disable, 1=Enable.
+  UINT32 TXTCODQS  : 1;           ///< Bit 7  - Enable/Disable Write TCO Dqs Training: 0=Disable, 1=Enable.
+  UINT32 CMDDRUD   : 1;           ///< Bit 8  - Enable/Disable CMD/CTL Drive Strength Up/Dn 2D: 0=Disable, 1=Enable.
+  UINT32 VCCDLLBP  : 1;           ///< Bit 9  - Enable/Disable VccDLL bypass to VccIOG training: 0=Disable, 1=Enable.
+  UINT32 PVTTDNLP  : 1;           ///< Bit 10 - Enable/Disable PanicVttDnLp Training: 0=Disable, 1=Enable.
+  UINT32 RDVREFDC  : 1;           ///< Bit 11 - Enable/Disable Read Vref Decap Training: 0=Disable, 1=Enable.
+  UINT32 VDDQT     : 1;           ///< Bit 12 - Enable/Disable Vddq Training: 0=Disable, 1=Enable.
+  UINT32 RMTBIT    : 1;           ///< Bit 13 - Enable/Disable Rank Margin Tool Per Bit: 0=Disable, 1=Enable.
+  UINT32 PDA       : 1;           ///< BIT 14 - Enable/Disable PDA Enumeration Training. Note it is not recommended to change this setting from the default value: 0=Disable, <b>1=Enable</b>.
+  UINT32 WRITE0    : 1;           ///< BIT 15 - Write0 feature enablement
+  UINT32 ReservedBits2 :16;       ///< Bits 16:31 - Reserved
+
+  UINT32  MrcTimeMeasure:1;         ///< Offset 92 Bit 0  - Enables serial debug level to display the MRC execution times only: <b>0=Disable</b>, 1=Enable
+  UINT32  MrcFastBoot:1;            ///<           Bit 1  - Enables the MRC fast boot path for faster cold boot execution: 0=Disable, <b>1=Enable</b>
+  UINT32  DqPinsInterleaved:1;      ///<           Bit 2  - Interleaving mode of DQ/DQS pins which depends on board routing: <b>0=Disable</b>, 1=Enable
+  UINT32  RankInterleave:1;         ///<           Bit 3  - Rank Interleave Mode: 0=Disable, <b>1=Enable</b>
+  UINT32  EnhancedInterleave:1;     ///<           Bit 4  - Enhanced Interleave Mode: 0=Disable, <b>1=Enable</b>
+  UINT32  WeaklockEn:1;             ///<           Bit 5  - Weak Lock Enable: 0=Disable, <b>1=Enable</b>
+  UINT32  ChHashEnable:1;           ///<           Bit 6  - Channel Hash Enable: 0=Disable, <b>1=Enable</b>
+  UINT32  EnablePwrDn:1;            ///<           Bit 7  - Enable Power Down control for DDR: 0=PCODE control, <b>1=BIOS control</b>
+  UINT32  EnablePwrDnLpddr:1;       ///<           Bit 8  - Enable Power Down for LPDDR: 0=PCODE control, <b>1=BIOS control</b>
+  UINT32  SrefCfgEna:1;             ///<           Bit 9  - Enable Self Refresh: 0=Disable, <b>1=Enable</b>
+  UINT32  ThrtCkeMinDefeatLpddr:1;  ///<           Bit 10 - Throttler CKE min defeature for LPDDR: 0=Disable, <b>1=Enable</b>
+  UINT32  ThrtCkeMinDefeat:1;       ///<           Bit 11 - Throttler CKE min defeature: <b>0=Disable</b>, 1=Enable
+  UINT32  AutoSelfRefreshSupport:1; ///<           Bit 12 - FALSE = No auto self refresh support, <b>TRUE = auto self refresh support</b>
+  UINT32  ExtTemperatureSupport:1;  ///<           Bit 13 - FALSE = No extended temperature support, <b>TRUE = extended temperature support</b>
+  UINT32  MobilePlatform:1;         ///<           Bit 14 - Memory controller device id indicates: <b>TRUE if mobile</b>, FALSE if not. Note: This will be auto-detected and updated.
+  UINT32  Force1Dpc:1;              ///<           Bit 15 - TRUE means force one DIMM per channel, <b>FALSE means no limit</b>
+  UINT32  ForceSingleRank:1;        ///<           Bit 16 - TRUE means use Rank0 only (in each DIMM): <b>0=Disable</b>, 1=Enable
+  UINT32  VttTermination:1;         ///<           Bit 17 - Vtt Termination for Data ODT: <b>0=Disable</b>, 1=Enable
+  UINT32  VttCompForVsshi:1;        ///<           Bit 18 - Enable/Disable Vtt Comparator For Vsshi: <b>0=Disable</b>, 1=Enable
+  UINT32  ExitOnFailure:1;          ///<           Bit 19 - MRC option for exit on failure or continue on failure: 0=Disable, <b>1=Enable</b>
+  UINT32  NewFeatureEnable1:1;      ///<           Bit 20 - Generic enable knob for new feature set 1 <b>0: Disable </b>; 1: Enable
+  UINT32  NewFeatureEnable2:1;      ///<           Bit 21 - Generic enable knob for new feature set 2 <b>0: Disable </b>; 1: Enable
+  UINT32  RhPrevention:1;           ///<           Bit 22 - RH Prevention Enable/Disable: 0=Disable, <b>1=Enable</b>
+  UINT32  RhSolution:1;             ///<           Bit 23 - Type of solution to be used for RHP - 0/1 = HardwareRhp/Refresh2x
+  UINT32  RefreshPanicWm:4;         ///<           Bit 24-27 - Refresh Panic Watermark, Range 1-8, default 8.
+  UINT32  RefreshHpWm:4;            ///<           Bit 28-31 - Refresh High Profile Watermark, Range 1-7, default 7.
+  UINT32  VddSettleWaitTime;      ///< Offset 96 Amount of time in microseconds to wait for Vdd to settle on top of 200us required by JEDEC spec: <b>Default=0</b>
+  UINT16  SrefCfgIdleTmr;         ///< Offset 100 Self Refresh idle timer: <b>512=Minimal</b>, 65535=Maximum
+  UINT16  ChHashMask;             ///< Offset 102 Channel Hash Mask: 0x0001=BIT6 set(Minimal), 0x3FFF=BIT[19:6] set(Maximum), <b>0x30CE= BIT[19:18, 13:12 ,9:7] set</b>
+  UINT16  DdrFreqLimit;           ///< Offset 104 Memory Frequency setting: 3=1067, 5=1333, 7=1600, 9=1867, 11=2133, 13=2400, <b>15=2667</b>
+  UINT8   MaxRttWr;               ///< Offset 106 Maximum DIMM RTT_WR to use in power training: <b>0=ODT Off</b>, 1 = 120 ohms
+  UINT8   ThrtCkeMinTmr;          ///< Offset 107 Throttler CKE min timer: 0=Minimal, 0xFF=Maximum, <b>0x00=Default</b>
+  UINT8   ThrtCkeMinTmrLpddr;     ///< Offset 108 Throttler CKE min timer for LPDDR: 0=Minimal, 0xFF=Maximum, <b>0x00=Default</b>
+  BOOLEAN PerBankRefresh;         ///< Offset 109 Enables and Disables the per bank refresh.  This only impacts memory technologies that support PBR: LPDDR3, LPDDR4.  FALSE=Disabled, <b>TRUE=Enabled</b>
+  UINT8   SaGv;                   ///< Offset 110 SA GV: <b>0=Disabled</b>, 1=Point1, 2=Point2, 3=Point3, 4=Point4, 5=Enabled
+  UINT8   NModeSupport;           ///< Offset 111 Memory N Mode Support - Enable user to select Auto, 1N or 2N: <b>0=AUTO</b>, 1=1N, 2=2N.
+  UINT8   RefClk;                 ///< Offset 112 Selects the DDR base reference clock. 0x01 = 100MHz, <b>0x00 = 133MHz</b>
+  UINT8   EnCmdRate;              ///< Offset 113 CMD Rate Enable: 0=Disable, 5=2 CMDs, <b>7=3 CMDs</b>, 9=4 CMDs, 11=5 CMDs, 13=6 CMDs, 15=7 CMDs
+  UINT8   Refresh2X;              ///< Offset 114 Refresh 2x: <b>0=Disable</b>, 1=Enable for WARM or HOT, 2=Enable for HOT only
+  UINT8   EpgEnable;              ///< Offset 115 Enable Energy Performance Gain.
+  UINT8   UserThresholdEnable;    ///< Offset 116 Flag to manually select the DIMM CLTM Thermal Threshold, 0=Disable,  1=Enable, <b>0=Default</b>
+  UINT8   UserBudgetEnable;       ///< Offset 117 Flag to manually select the Budget Registers for CLTM Memory Dimms , 0=Disable,  1=Enable, <b>0=Default</b>
+  UINT8   RetrainOnFastFail;      ///< Offset 118 Restart MRC in Cold mode if SW MemTest fails during Fast flow. 0 = Disabled, <b>1 = Enabled</b>
+  UINT8   PowerDownMode;          ///< Offset 119 CKE Power Down Mode: <b>0xFF=AUTO</b>, 0=No Power Down, 1= APD mode, 6=PPD-DLL Off mode
+  UINT8   PwdwnIdleCounter;       ///< Offset 120 CKE Power Down Mode Idle Counter: 0=Minimal, 255=Maximum, <b>0x80=0x80 DCLK</b>
+  UINT8   CmdRanksTerminated;     ///< Offset 121 LPDDR: Bitmask of ranks that have CA bus terminated. <b>0x01=Default, Rank0 is terminating and Rank1 is non-terminating</b>
+  UINT16  MsHashMask;             ///< Offset 122 Controller Hash Mask: 0x0001=BIT6 set(Minimal), 0x3FFF=BIT[19:6] set(Maximum), <b>0x30CE= BIT[19:18, 13:12 ,9:7] set</b>
+  UINT32  Lp5CccConfig;           ///< Offset 124 BitMask where bits [3:0] are controller 0 Channel [3:0] and [7:4] are Controller 1 Channel [3:0].  0 selects Ascending mapping and 1 selects Descending mapping.
+  UINT8   RMTLoopCount;           ///< Offset 128 Indicates the Loop Count to be used for Rank Margin Tool Testing: 1=Minimal, 32=Maximum, 0=AUTO, <b>0=Default</b>
+  UINT8   MsHashInterleaveBit;    ///< Offset 129 Option to select interleave Address bit. Valid values are 0 - 3 for BITS 6 - 9
+  UINT8   GearRatio;              ///< Offset 130 This input control's the current gear expressed as an integer when SAGV is disabled: <b>0=Default</b>, 1, 2.
+  UINT8   Ddr4OneDpc;             ///< Offset 131 DDR4 1DPC performance feature: 0 - Disabled; 1 - Enabled on DIMM0 only, 2 - Enabled on DIMM1 only; 3 - Enabled on both DIMMs. (bit [0] - DIMM0, bit [1] - DIMM1)
+  UINT32  BclkRfiFreq[MEM_MAX_SAGV_POINTS]; ///< Offset 132 Bclk RFI Frequency for each SAGV point in Hz units. 98000000Hz = 98MHz <b>0 - No RFI Tuning</b>. Range is 98Mhz-100Mhz.
+  UINT16  SaGvFreq[MEM_MAX_SAGV_POINTS];    ///< Offset 148 Frequency per SAGV point.  0 is Auto, otherwise holds the frequency value expressed as an integer: <b>0=Default</b>, 1067, 1333, 1600, 1800, 1867, etc.
+  /**
+    Offset 156 Gear ratio per SAGV point.  0 is Auto, otherwise holds the Gear ratio expressed as an integer: <b>0=Default</b>, 1, 2.
+      Only valid combinations of Gear Ratio per point is:
+      | point | set1 | set2 | set3
+      | 0     | 1    | 2    | 2
+      | 1     | 1    | 2    | 2
+      | 2     | 1    | 2    | 2
+      | 3     | 1    | 2    | 1
+  **/
+  UINT8   SaGvGear[MEM_MAX_SAGV_POINTS];                      ///< Offset 156
+  UINT8   IbeccProtectedRegionEnable[MEM_MAX_IBECC_REGIONS];  ///< Offset 160 Enable use of address range for ECC Protection:  <b>0=Default</b>, 1
+  UINT16  IbeccProtectedRegionBase[MEM_MAX_IBECC_REGIONS];    ///< Offset 168 Base address for address range of ECC Protection:  <b>0=Default</b>, 1
+  UINT16  IbeccProtectedRegionMask[MEM_MAX_IBECC_REGIONS];    ///< Offset 184 Mask address for address range of ECC Protection:  <b>0=Default</b>, 1
+  UINT32  CmdMirror;              ///< Offset 200 BitMask where bits [3:0] are controller 0 Channel [3:0] and [7:4] are Controller 1 Channel [3:0].  0 = No Command Mirror and 1 = Command Mirror.
+  UINT8   CpuBclkSpread;          ///< Offset 204 CPU BCLK Spread Specturm: 0 = Disabled; <b>1 = Enabled</b>
+  UINT8   ExtendedBankHashing;    ///< Offset 205 Enable EBH Extended Bank Hashing: 0=Disabled; <b>1 = Enabled</b>.
+  UINT16  VddqVoltageOverride;    ///< Offset 206 VccddqVoltage override in # of 1mV
+  UINT8   MarginLimitCheck;                                   ///< Offset 208 Margin limit check enable: <b>0=Disable</b>, 1=L1 only, 2=L2 only, 3=Both L1 and L2
+  UINT8   RsvdO209;                                           ///< Offset 209
+  UINT16  MarginLimitL2;                                      ///< Offset 210 Margin limit check L2 threshold: <b>100=Default</b>
+} MEMORY_CONFIGURATION;
+
+/// Memory Configuration
+/// The contents of this structure are not CRC'd by the MRC for option change detection.
+/// <b>Revision 1</b>:  - Initial version.
+/// <b>Revision 2</b>:  - Added MemTestOnWarmBoot
+typedef struct {
+  CONFIG_BLOCK_HEADER      Header;              ///< Offset 0-23 Config Block Header
+  SA_FUNCTION_CALLS        SaCall;              ///< Offset 24   Function calls into the SA.
+  SA_MEMORY_FUNCTIONS      MrcCall;             ///< Offset 204  Function calls into the MRC.
+  SPD_DATA_BUFFER          *SpdData;            ///< Offset 240  Memory SPD data, will be used by the MRC when SPD SmBus address is zero.
+  UINT32                   Reserved0;
+  SA_MEMORY_DQDQS_MAPPING  *DqDqsMap;           ///< Offset 244  LPDDR DQ bit and DQS byte swizzling between CPU and DRAM.
+  SA_MEMORY_RCOMP          *RcompData;          ///< Offset 248  DDR RCOMP resistors and target values.
+  UINT64                   PlatformMemorySize;  ///< Offset 252  The minimum platform memory size required to pass control into DXE
+  UINT32                   CleanMemory:1;       ///< Offset 256  Ask MRC to clear memory content: <b>FALSE=Do not Clear Memory</b>; TRUE=Clear Memory
+  UINT32                   ReservedBits5:31;
+  /**
+   Sets the serial debug message level\n
+     0x00 = Disabled\n
+     0x01 = Errors only\n
+     0x02 = Errors and Warnings\n
+     <b>0x03 = Errors, Warnings, and Info</b>\n
+     0x04 = Errors, Warnings, Info, and Events\n
+     0x05 = Displays Memory Init Execution Time Summary only\n
+  **/
+  UINT8   SerialDebugLevel;                     ///< Offset 260
+  UINT8   MemTestOnWarmBoot;                    ///< Offset 261  Run Base Memory Test On WarmBoot:  0=Disabled, <b>1=Enabled</b>
+  UINT8   Reserved11[2];                        ///< Offset 262 - 263  Reserved
+} MEMORY_CONFIG_NO_CRC;
+#pragma pack(pop)
+
+#endif // _MEMORY_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/OverclockingConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/OverclockingConfig.h
new file mode 100644
index 0000000000..462c02cef1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/OverclockingConfig.h
@@ -0,0 +1,236 @@
+/** @file
+  Overclocking Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _OVERCLOCKING_PREMEM_CONFIG_H_
+#define _OVERCLOCKING_PREMEM_CONFIG_H_
+
+#define OVERCLOCKING_CONFIG_REVISION 9
+
+extern EFI_GUID gOverclockingPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+//
+// Max number of VF point offset
+//
+#ifndef CPU_OC_MAX_VF_POINTS
+#define CPU_OC_MAX_VF_POINTS   0xF
+#endif
+
+#ifndef CPU_OC_MAX_CORES
+#define CPU_OC_MAX_CORES   8
+#endif
+/**
+  Overclocking Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>
+  - Add PerCoreHtDisable
+  <b>Revision 3</b>
+  - Add Avx2VoltageScaleFactor and Avx512VoltageScaleFactor
+  <b>Revision 4</b>
+  - Add CoreVfPointOffsetMode & CoreVfPointOffset & CoreVfPointRatio & CoreVfPointCount
+  <b>Revision 5</b>
+  - Change OcLock default to 'Enabled'
+  <b>Revision 6</b>:
+  - Add DisableCoreMask.
+  <b>Revision 7</b>
+    Add UnlimitedIccMax
+  <b>Revision 8</b>
+  - Add PerCoreRatioOverride and PerCoreRatio for Per Core PState overclocking.
+  <b>Revision 9</b>
+  - Add VccInVoltageOverride.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+  Overclocking support. This controls whether OC mailbox transactions are sent.
+  If disabled, all policies in this config block besides OcSupport and OcLock will be ignored.
+  <b>0: Disable</b>;
+  1: Enable.
+  @note If PcdOverclockEnable is disabled, this should also be disabled.
+  **/
+  UINT32 OcSupport            :  1;
+  UINT32 OcLock               :  1;               ///< If enabled, sets OC lock bit in MSR 0x194[20], locking the OC mailbox and other OC configuration settings.; 0: Disable; <b>1: Enable (Lock)</b>.
+  /**
+  Core voltage mode, specifies which voltage mode the processor will be operating.
+  <b>0: Adaptive Mode</b> allows the processor to interpolate a voltage curve when beyond fused P0 range;
+  1: Override, sets one voltage for for the entire frequency range, Pn-P0.
+  **/
+  UINT32 CoreVoltageMode      :  1;
+  UINT32 CorePllVoltageOffset :  6;               ///< Core PLL voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
+  UINT32 Avx2RatioOffset      :  5;               ///< AVX2 Ratio Offset. <b>0: No offset</b>. Range is 0-31. Used to lower the AVX ratio to maximize possible ratio for SSE workload.
+  UINT32 Avx3RatioOffset      :  5;               ///< AVX3 Ratio Offset. <b>0: No offset</b>. Range is 0-31. Used to lower the AVX3 ratio to maximize possible ratio for SSE workload.
+  UINT32 BclkAdaptiveVoltage  :  1;               ///< Bclk Adaptive Voltage enable/disable. <b>0: Disabled</b>, 1: Enabled. When enabled, the CPU V/F curves are aware of BCLK frequency when calculated.
+  /**
+  Ring Downbin enable/disable.
+  When enabled, the CPU will force the ring ratio to be lower than the core ratio.
+  Disabling will allow the ring and core ratios to run at the same frequency.
+  Uses OC Mailbox command 0x19.
+  0: Disables Ring Downbin feature. <b>1: Enables Ring downbin feature.</b>
+  **/
+  UINT32 RingDownBin          :  1;
+  /**
+  Ring voltage mode, specifies which voltage mode the processor will be operating.
+  <b>0: Adaptive Mode</b> allows the processor to interpolate a voltage curve when beyond fused P0 range;
+  1: Override, sets one voltage for for the entire frequency range, Pn-P0.
+  **/
+  UINT32 RingVoltageMode      :  1;
+  UINT32 GtVoltageMode        :  1;    ///< Specifies whether GT voltage is operating in Adaptive or Override mode: <b>0=Adaptive</b>, 1=Override
+  UINT32 RealtimeMemoryTiming :  1;    ///< Enable/Disable the message sent to the CPU to allow realtime memory timing changes after MRC_DONE. <b>0=Disable</b>, 1=Enable
+  UINT32 FivrFaults           :  1;    ///< Fivr Faults. Enable or Disable FIVR Faults. 0: Disabled, <b>1: Enabled.</b>
+  UINT32 FivrEfficiency       :  1;    ///< Fivr Efficiency Management. 0: Disabled, <b>1: Enabled.</b>
+  /**
+  Selects Core Voltage & Frequency Point Offset between Legacy and Selection modes.
+  Need Reset System after enabling OverClocking Feature to Initialize the default value.
+  <b>0: In Legacy Mode, setting a global offset for the entire VF curve.</b>
+  1: In Selection modes, setting a selected VF point.
+  **/
+  UINT32 CoreVfPointOffsetMode : 1;
+  UINT32 UnlimitedIccMax      :  1;    ///< Support Unlimited ICCMAX more than maximum value 255.75A.  <b>0: Disabled</b>, 1: Enabled.
+  UINT32 PerCoreRatioOverride :  1;              ///< Enable or disable Per Core PState OC supported by writing OCMB 0x1D to program new favored core ratio to each Core. <b>0: Disable</b>, 1: enable
+  UINT32 DynamicMemoryChange  :  1;   ///< Dynamic Memory Timings Changes; <b>0: Disabled</b>; 1: Enabled.
+  UINT32 RsvdBits             :  2;    ///< Reserved for future use
+
+  /**
+  Maximum core turbo ratio override allows to increase CPU core frequency beyond the fused max turbo ratio limit (P0).
+  <b>0. no override/HW defaults.</b>. Range 0-85.
+  **/
+  UINT8  CoreMaxOcRatio;
+  UINT8  GtMaxOcRatio;                 ///< Maximum GT turbo ratio override: 0=Minimal, 60=Maximum, <b>0=AUTO</b>
+  /**
+  Maximum ring ratio override allows to increase CPU ring frequency beyond the fused max ring ratio limit.
+  <b>0. no override/HW defaults.</b>. Range 0-85.
+  **/
+  UINT8  RingMaxOcRatio;
+  UINT8  RsvdByte1;
+  /**
+  The core voltage override which is applied to the entire range of cpu core frequencies.
+  Used when CoreVoltageMode = Override.
+  <b>0. no override</b>. Range 0-2000 mV.
+  **/
+  UINT16 CoreVoltageOverride;
+  /**
+  Adaptive Turbo voltage target used to define the interpolation voltage point when the cpu is operating in turbo mode range.
+  Used when CoreVoltageMode = Adaptive.
+  <b>0. no override</b>. Range 0-2000mV.
+  **/
+  UINT16 CoreVoltageAdaptive;
+  /**
+  The core voltage offset applied on top of all other voltage modes. This offset is applied over the entire frequency range.
+  This is a 2's complement number in mV units. <b>Default: 0</b> Range: -1000 to 1000.
+  **/
+  INT16  CoreVoltageOffset;
+  /**
+  The ring voltage override which is applied to the entire range of cpu ring frequencies.
+  Used when RingVoltageMode = Override.
+  <b>0. no override</b>. Range 0-2000 mV.
+  **/
+  UINT16 RingVoltageOverride;
+  /**
+  Adaptive Turbo voltage target used to define the interpolation voltage point when the ring is operating in turbo mode range.
+  Used when RingVoltageMode = Adaptive.
+  <b>0. no override</b>. Range 0-2000mV.
+  **/
+  UINT16 RingVoltageAdaptive;
+  /**
+  The ring voltage offset applied on top of all other voltage modes. This offset is applied over the entire frequency range.
+  This is a 2's complement number in mV units. <b>Default: 0</b> Range: -1000 to 1000.
+  **/
+  INT16  RingVoltageOffset;
+
+  INT16  GtVoltageOffset;                         ///< The voltage offset applied to GT slice. Valid range from -1000mv to 1000mv: <b>0=Minimal</b>, 1000=Maximum
+  UINT16 GtVoltageOverride;                       ///< The GT voltage override which is applied to the entire range of GT frequencies <b>0=Default</b>
+  UINT16 GtExtraTurboVoltage;                     ///< The adaptive voltage applied during turbo frequencies. Valid range from 0 to 2000mV: <b>0=Minimal</b>, 2000=Maximum
+  INT16  SaVoltageOffset;                         ///< The voltage offset applied to the SA. Valid range from -1000mv to 1000mv: <b>0=Default</b>
+  UINT32 GtPllVoltageOffset     :  6;             ///< GT PLL voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
+  UINT32 RingPllVoltageOffset   :  6;             ///< Ring PLL voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
+  UINT32 SaPllVoltageOffset     :  6;             ///< System Agent PLL voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
+  UINT32 McPllVoltageOffset     :  6;             ///< Memory Controller PLL voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
+  UINT32 RsvdBits1              :  8;
+  /**
+  TjMax Offset. Specified value here is clipped by pCode (125 - TjMax Offset) to support TjMax in the range of 62 to 115 deg Celsius.
+  <b> Default: 0 Hardware Defaults </b> Range 10 to 63. 0 = No offset / Keep HW default.
+  **/
+  UINT8  TjMaxOffset;
+  UINT8  RsvdByte2[3];                           //< Reserved for dword alignment
+  /**
+  This service controls Core frequency reduction caused by high package temperatures for processors that
+  implement the Intel Thermal Velocity Boost (TVB) feature. It is required to be disabled for supporting
+  overclocking at frequencies higher than the default max turbo frequency.
+  <b>0: Disables TVB ratio clipping. </b>1: Enables TVB ratio clipping.
+  **/
+  UINT32 TvbRatioClipping       :  1;
+  /**
+  This service controls thermal based voltage optimizations for processors that implement the Intel
+  Thermal Velocity Boost (TVB) feature.
+  0: Disables TVB voltage optimization. <b>1: Enables TVB voltage optimization.</b>
+  **/
+  UINT32 TvbVoltageOptimization :  1;
+  UINT32 RsvdBits2              : 30;
+  /**
+  Defines the per-core HT disable mask where: 1 - Disable selected logical core HT, 0 - is ignored.
+  Input is in HEX and each bit maps to a logical core. Ex. A value of '1F' would disable HT for cores 4,3,2,1 and 0.
+  <b>Default is 0</b>, all cores have HT enabled. Range is 0 - 0x1FF. You can only disable up to MAX_CORE_COUNT - 1.
+  **/
+  UINT16 PerCoreHtDisable;
+  /**
+  Avx2 Voltage Guardband Scale Factor
+  This controls the AVX2 Voltage Guardband Scale factor applied to AVX2 workloads.
+  Valid range is 0-200 in 1/100 units, where a value of 125 would apply a 1.25 scale factor.
+  A value of 0 means no scale factor applied (no change to voltage on AVX commands)
+  A value of 100 applies the default voltage guardband values (1.0 factor).
+  A value > 100 will increase the voltage guardband on AVX2 workloads.
+  A value < 100 will decrease the voltage guardband on AVX2 workloads.
+
+  <b>0. No scale factor applied</b>
+  **/
+  UINT8 Avx2VoltageScaleFactor;
+  /**
+  Avx512 Voltage Guardband Scale Factor
+  This controls the AVX512 Voltage Guardband Scale factor applied to AVX512 workloads.
+  Valid range is 0-200 in 1/100 units, where a value of 125 would apply a 1.25 scale factor.
+  A value of 0 means no scale factor applied (no change to voltage on AVX commands)
+  A value of 100 applies the default voltage guardband values (1.0 factor).
+  A value > 100 will increase the voltage guardband on AVX512 workloads.
+  A value < 100 will decrease the voltage guardband on AVX512 workloads.
+
+  <b>0. No scale factor applied</b>
+  **/
+  UINT8 Avx512VoltageScaleFactor;
+  /**
+  Array used to specifies the Core Voltage Offset applied to the each selected VF Point.
+  This voltage is specified in millivolts.
+  **/
+  INT16  CoreVfPointOffset[CPU_OC_MAX_VF_POINTS];
+  UINT8  RsvdByte3[2];  ///< Just to keep native alignment.
+  /**
+  Array for the each selected VF Point to display the Core Ration.
+  **/
+  UINT8  CoreVfPointRatio[CPU_OC_MAX_VF_POINTS];
+  /**
+  Number of supported Core Voltage & Frequency Point.
+  **/
+  UINT8  CoreVfPointCount;
+  /**
+  Core mask is a bitwise indication of which core should be disabled. Bit 0 - core 0, bit 7 - core 7.
+  **/
+  UINT32 DisableCoreMask;
+  UINT8  PerCoreRatio[CPU_OC_MAX_CORES];
+  /**
+  The VcccIn voltage override.
+  This will override VccIn output voltage level to the voltage value specified.
+  The voltage level is fixed and will not change except on PKG C-states or resets.
+
+  <b>0. no override</b>. Range 0-3000 mV.
+  **/
+  UINT32 VccInVoltageOverride;
+} OVERCLOCKING_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_OVERCLOCKING_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
new file mode 100644
index 0000000000..69271205b1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
@@ -0,0 +1,34 @@
+/** @file
+  P2sb policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _P2SB_CONFIG_H_
+#define _P2SB_CONFIG_H_
+
+#define P2SB_CONFIG_REVISION 1
+extern EFI_GUID gP2sbConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure contains the policies which are related to P2SB device.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    <b>(Test)</b>
+    The sideband MMIO register access to specific ports will be locked
+    before 3rd party code execution. Currently it disables PSFx access.
+    This policy unlocks the sideband MMIO space for those IPs.
+    <b>0: Lock sideband access </b>; 1: Unlock sideband access.
+    NOTE: Do not set this policy "SbAccessUnlock" unless its necessary.
+  **/
+  UINT32    SbAccessUnlock    :  1;
+  UINT32    Rsvdbits          : 31;    ///< Reserved bits
+} PCH_P2SB_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _P2SB_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfig.h
new file mode 100644
index 0000000000..b73108bcfd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfig.h
@@ -0,0 +1,44 @@
+/** @file
+  DMI policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_DMI_CONFIG_H_
+#define _PCH_DMI_CONFIG_H_
+
+#define PCH_DMI_CONFIG_REVISION 2
+extern EFI_GUID gPchDmiConfigGuid;
+
+
+#pragma pack (push,1)
+
+
+/**
+ The PCH_DMI_CONFIG block describes the expected configuration of the PCH for DMI.
+   <b>Revision 1</b>:  - Initial version.
+   <b>Revision 2</b>:  - Add OpioRecenter
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+
+  UINT32     PwrOptEnable      :  1;    ///< <b>0: Disable</b>; 1: Enable DMI Power Optimizer on PCH side.
+  UINT32     DmiAspmCtrl       :  8;    ///< ASPM configuration on the PCH side of the DMI/OPI Link. Default is <b>PchPcieAspmAutoConfig</b>
+  UINT32     CwbEnable         :  1;    ///< 0: Disable; <b>1: Enable</b> Central Write Buffer feature configurable and enabled by default
+  UINT32     L1RpCtl           :  1;    ///< 0: Disable; <b>1: Enable</b> Allow DMI enter L1 when all root ports are in L1, L0s or link down. Disabled by default.
+  /**
+   When set to TRUE turns on:
+     - L1 State Controller Power Gating
+     - L1 State PHY Data Lane Power Gating
+     - PHY Common Lane Power Gating
+     - Hardware Autonomous Enable
+     - PMC Request Enable and Sleep Enable
+  **/
+  UINT32     DmiPowerReduction :  1;
+  UINT32     OpioRecenter      :  1;    ///< 0: Disable; <b>1: Enable</b> Opio Recentering Disable for Pcie latency
+  UINT32     Rsvdbits          : 19;    ///< Reserved bits
+} PCH_DMI_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _PCH_DMI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/PchPcieRpConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/PchPcieRpConfig.h
new file mode 100644
index 0000000000..de086473a9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/PchPcieRpConfig.h
@@ -0,0 +1,368 @@
+/** @file
+  PCH Pcie root port policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCIERP_CONFIG_H_
+#define _PCH_PCIERP_CONFIG_H_
+
+#include <PchLimits.h>
+#include <PcieConfig.h>
+#include <ConfigBlock.h>
+
+#define PCIE_RP_CONFIG_REVISION 1
+#define PCIE_RP_PREMEM_CONFIG_REVISION 1
+#define PCIE_RP_DXE_CONFIG_REVISION 1
+
+extern EFI_GUID gPchPcieConfigGuid;
+extern EFI_GUID gPcieRpPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+#define PCIE_LINK_EQ_COEFFICIENTS_MAX 10
+#define PCIE_LINK_EQ_PRESETS_MAX 11
+
+typedef enum {
+  PchPcieOverrideDisabled             = 0,
+  PchPcieL1L2Override                 = 0x01,
+  PchPcieL1SubstatesOverride          = 0x02,
+  PchPcieL1L2AndL1SubstatesOverride   = 0x03,
+  PchPcieLtrOverride                  = 0x04
+} PCH_PCIE_OVERRIDE_CONFIG;
+
+/**
+  PCIe device table entry entry
+
+  The PCIe device table is being used to override PCIe device ASPM settings.
+  To take effect table consisting of such entries must be instelled as PPI
+  on gPchPcieDeviceTablePpiGuid.
+  Last entry VendorId must be 0.
+**/
+typedef struct {
+  UINT16  VendorId;                    ///< The vendor Id of Pci Express card ASPM setting override, 0xFFFF means any Vendor ID
+  UINT16  DeviceId;                    ///< The Device Id of Pci Express card ASPM setting override, 0xFFFF means any Device ID
+  UINT8   RevId;                       ///< The Rev Id of Pci Express card ASPM setting override, 0xFF means all steppings
+  UINT8   BaseClassCode;               ///< The Base Class Code of Pci Express card ASPM setting override, 0xFF means all base class
+  UINT8   SubClassCode;                ///< The Sub Class Code of Pci Express card ASPM setting override, 0xFF means all sub class
+  UINT8   EndPointAspm;                ///< Override device ASPM (see: PCH_PCIE_ASPM_CONTROL)
+                                       ///< Bit 1 must be set in OverrideConfig for this field to take effect
+  UINT16  OverrideConfig;              ///< The override config bitmap (see: PCH_PCIE_OVERRIDE_CONFIG).
+  /**
+    The L1Substates Capability Offset Override. (applicable if bit 2 is set in OverrideConfig)
+    This field can be zero if only the L1 Substate value is going to be override.
+  **/
+  UINT16  L1SubstatesCapOffset;
+  /**
+    L1 Substate Capability Mask. (applicable if bit 2 is set in OverrideConfig)
+    Set to zero then the L1 Substate Capability [3:0] is ignored, and only L1s values are override.
+    Only bit [3:0] are applicable. Other bits are ignored.
+  **/
+  UINT8   L1SubstatesCapMask;
+  /**
+    L1 Substate Port Common Mode Restore Time Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sCommonModeRestoreTime;
+  /**
+    L1 Substate Port Tpower_on Scale Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sTpowerOnScale;
+  /**
+    L1 Substate Port Tpower_on Value Override. (applicable if bit 2 is set in OverrideConfig)
+    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid value of 0, but not the L1sTpowerOnValue.
+    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime, L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
+    and only L1SubstatesCapOffset is override.
+  **/
+  UINT8   L1sTpowerOnValue;
+
+  /**
+    SnoopLatency bit definition
+    Note: All Reserved bits must be set to 0
+
+    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                  When clear values in bits 9:0 will be ignored
+    BITS[14:13] - Reserved
+    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                  000b - 1 ns
+                  001b - 32 ns
+                  010b - 1024 ns
+                  011b - 32,768 ns
+                  100b - 1,048,576 ns
+                  101b - 33,554,432 ns
+                  110b - Reserved
+                  111b - Reserved
+    BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied with
+                  the scale in bits 12:10
+
+    This field takes effect only if bit 3 is set in OverrideConfig.
+  **/
+  UINT16  SnoopLatency;
+  /**
+    NonSnoopLatency bit definition
+    Note: All Reserved bits must be set to 0
+
+    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                  When clear values in bits 9:0 will be ignored
+    BITS[14:13] - Reserved
+    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                  000b - 1 ns
+                  001b - 32 ns
+                  010b - 1024 ns
+                  011b - 32,768 ns
+                  100b - 1,048,576 ns
+                  101b - 33,554,432 ns
+                  110b - Reserved
+                  111b - Reserved
+    BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be multiplied with
+                  the scale in bits 12:10
+
+    This field takes effect only if bit 3 is set in OverrideConfig.
+  **/
+  UINT16  NonSnoopLatency;
+
+  /**
+    Forces LTR override to be permanent
+    The default way LTR override works is:
+      rootport uses LTR override values provided by BIOS until connected device sends an LTR message, then it will use values from the message
+    This settings allows force override of LTR mechanism. If it's enabled, then:
+      rootport will use LTR override values provided by BIOS forever; LTR messages sent from connected device will be ignored
+  **/
+  UINT8  ForceLtrOverride;
+  UINT8  Reserved[3];
+} PCH_PCIE_DEVICE_OVERRIDE;
+
+///
+/// The values before AutoConfig match the setting of PCI Express Base Specification 1.1, please be careful for adding new feature
+///
+typedef enum {
+  PchPcieAspmDisabled,
+  PchPcieAspmL0s,
+  PchPcieAspmL1,
+  PchPcieAspmL0sL1,
+  PchPcieAspmAutoConfig,
+  PchPcieAspmMax
+} PCH_PCIE_ASPM_CONTROL;
+
+/**
+  Refer to PCH EDS for the PCH implementation values corresponding
+  to below PCI-E spec defined ranges
+**/
+typedef enum {
+  PchPcieL1SubstatesDisabled,
+  PchPcieL1SubstatesL1_1,
+  PchPcieL1SubstatesL1_1_2,
+  PchPcieL1SubstatesMax
+} PCH_PCIE_L1SUBSTATES_CONTROL;
+
+enum PCH_PCIE_MAX_PAYLOAD {
+  PchPcieMaxPayload128 = 0,
+  PchPcieMaxPayload256,
+  PchPcieMaxPayloadMax
+};
+
+typedef enum {
+  PcieLinkHardwareEq = 0,  ///< Hardware is responsible for performing coefficient/preset search.
+  PcieLinkFixedEq          ///< No coefficient/preset search is performed. Fixed values are used.
+} PCIE_LINK_EQ_METHOD;
+
+typedef enum {
+  PcieLinkEqPresetMode = 0,   ///< Use presets during PCIe link equalization
+  PcieLinkEqCoefficientMode   ///< Use coefficients during PCIe link equalization
+} PCIE_LINK_EQ_MODE;
+
+typedef struct {
+  UINT32  PreCursor;    ///< Pre-cursor coefficient
+  UINT32  PostCursor;   ///< Post-cursor coefficient
+} PCIE_LINK_EQ_COEFFICIENTS;
+
+/**
+  PCIe Link EQ Platform Settings
+**/
+typedef struct {
+  UINT8                      PcieLinkEqMethod;               ///< Tells BIOS which link EQ method should be used for this port. Please refer to PCIE_LINK_EQ_METHOD for details of supported methods. Default: PcieLinkHardwareEq
+  UINT8                      PcieLinkEqMode;                 ///< Tells BIOS which mode should be used for PCIe link EQ. Please refer to PCIE_LINK_EQ_MODE for details of supported modes. Default: depends on SoC
+  /**
+    Specifies if BIOS should perform local transmitter override during phase 2 of EQ process.
+    If enabled value in Ph2LocalTransmitterOverridePreset must be valid.
+    <b>0: Disabled</b>; 1: Enabled
+  **/
+  UINT8                      LocalTransmitterOverrideEnable;
+  /**
+    Tells BIOS how many presets/coefficients should be used during link EQ.
+    Entries in the Ph3CoefficientsList or Ph3PresetList(depending on chosen mode) need to be valid up to the number specified in this field.
+  **/
+  UINT8                      Ph3NumberOfPresetsOrCoefficients;
+
+  PCIE_LINK_EQ_COEFFICIENTS  Ph3CoefficientsList[PCIE_LINK_EQ_COEFFICIENTS_MAX];  ///< List of the PCIe coefficients to be used during equalization process. Only valid if PcieLinkEqMode is PcieLinkEqCoefficientMode
+  UINT32                     Ph3PresetList[PCIE_LINK_EQ_PRESETS_MAX];             ///< List of the PCIe preset values to be used during equalization process. Only valid if PcieLinkEqMode is PcieLinkEqPresetMode
+  UINT32                     Ph1DownstreamPortTransmitterPreset;  ///< Specifies the value of the downstream port transmitter preset to be used during phase 1 of the equalization process. Will be applied to all lanes
+  UINT32                     Ph1UpstreamPortTransmitterPreset;    ///< Specifies the value of the upstream port transmitter preset to be used during phase 1 of the equalization process. Will be applied to all lanes
+  /**
+    Specifies the preset that should be used during local transmitter override during phase 2 of EQ process.
+    Used only if LocalTransmitterOverrideEnable is TRUE. Will be applied to all PCIe lanes of the root port.
+    Valid up to the PCIE_LINK_EQ_PRESET_MAX value. <b>Default: 0<\b>
+  **/
+  UINT32                     Ph2LocalTransmitterOverridePreset;
+} PCIE_LINK_EQ_PLATFORM_SETTINGS;
+
+#define PCH_PCIE_NO_SUCH_CLOCK 0xFF
+
+typedef enum {
+  PchClockUsagePchPcie0      = 0,
+  PchClockUsagePchPcie1      = 1,
+  PchClockUsagePchPcie2      = 2,
+  PchClockUsagePchPcie3      = 3,
+  PchClockUsagePchPcie4      = 4,
+  PchClockUsagePchPcie5      = 5,
+  PchClockUsagePchPcie6      = 6,
+  PchClockUsagePchPcie7      = 7,
+  PchClockUsagePchPcie8      = 8,
+  PchClockUsagePchPcie9      = 9,
+  PchClockUsagePchPcie10     = 10,
+  PchClockUsagePchPcie11     = 11,
+  PchClockUsagePchPcie12     = 12,
+  PchClockUsagePchPcie13     = 13,
+  PchClockUsagePchPcie14     = 14,
+  PchClockUsagePchPcie15     = 15,
+  PchClockUsagePchPcie16     = 16,
+  PchClockUsagePchPcie17     = 17,
+  PchClockUsagePchPcie18     = 18,
+  PchClockUsagePchPcie19     = 19,
+  PchClockUsagePchPcie20     = 20,
+  PchClockUsagePchPcie21     = 21,
+  PchClockUsagePchPcie22     = 22,
+  PchClockUsagePchPcie23     = 23,
+  /**
+    Quantity of PCH and CPU PCIe ports, as well as their encoding in this enum, may change between
+    silicon generations and series. Do not assume that PCH port 0 will be always encoded by 0.
+    Instead, it is recommended to use (PchClockUsagePchPcie0 + PchPortIndex) style to be forward-compatible
+  **/
+  PchClockUsageCpuPcie0      = 0x40,
+  PchClockUsageCpuPcie1      = 0x41,
+  PchClockUsageCpuPcie2      = 0x42,
+  PchClockUsageCpuPcie3      = 0x43,
+
+  PchClockUsageLan           = 0x70,
+  PchClockUsageUnspecified   = 0x80, ///< In use for a purpose not listed above
+  PchClockUsageNotUsed       = 0xFF
+} PCH_PCIE_CLOCK_USAGE;
+
+/**
+  PCH_PCIE_CLOCK describes PCIe source clock generated by PCH.
+**/
+typedef struct {
+  UINT8   Usage;        ///< Purpose of given clock (see PCH_PCIE_CLOCK_USAGE). Default: Unused, 0xFF
+  UINT8   ClkReq;       ///< ClkSrc - ClkReq mapping. Default: 1:1 mapping with Clock numbers
+  UINT8   RsvdBytes[2]; ///< Reserved byte
+} PCH_PCIE_CLOCK;
+
+/**
+  The PCH_PCI_EXPRESS_ROOT_PORT_CONFIG describe the feature and capability of each PCH PCIe root port.
+**/
+typedef struct {
+  PCIE_ROOT_PORT_COMMON_CONFIG  PcieRpCommonConfig; ///an instance of Pcie Common Config
+  UINT8  ExtSync;              ///< Indicate whether the extended synch is enabled. <b>0: Disable</b>; 1: Enable.
+  //
+  // Error handlings
+  //
+  UINT8  SystemErrorEnable;    ///< Indicate whether the System Error is enabled. <b>0: Disable</b>; 1: Enable.
+  /**
+    The Multiple VC (MVC) supports hardware to avoid HoQ block for latency sensitive TC.
+    Currently it is only applicable to Root Ports with 2pX4 port configuration with 2 VCs,or
+    DMI port configuration with 3 VCs. For Root Ports 2pX4 configuration, two RPs (RP0,
+    RP2) shall support two PCIe VCs (VC0 & VC1) and the other RPs (RP1, RP3) shall be
+    disabled.
+    <b>0: Disable</b>; 1: Enable
+  **/
+  UINT8  MvcEnabled;
+  /**
+    Virtual Pin Port is industry standard introduced to PCIe Hot Plug support in systems
+    when GPIO pins expansion is needed. It is server specific feature.
+    <b>0x00: Default</b>; 0xFF: Disabled
+  **/
+  UINT8   VppPort;
+  UINT8   VppAddress;                               ///< PCIe Hot Plug VPP SMBus Address. Default is zero.
+  UINT8   RsvdBytes0[3];                            ///< Reserved bytes
+} PCH_PCIE_ROOT_PORT_CONFIG;
+
+/**
+  The PCH_PCIE_CONFIG block describes the expected configuration of the PCH PCI Express controllers
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  ///
+  /// These members describe the configuration of each PCH PCIe root port.
+  ///
+  PCIE_COMMON_CONFIG                PcieCommonConfig;
+  PCH_PCIE_ROOT_PORT_CONFIG         RootPort[PCH_MAX_PCIE_ROOT_PORTS];
+  PCIE_LINK_EQ_PLATFORM_SETTINGS    PcieLinkEqPlatformSettings;  ///< Global PCIe link EQ settings that BIOS will use during PCIe link EQ for every port.
+  ///
+  /// <b>0: Use project default equalization settings</b>; 1: Use equalization settings from PcieLinkEqPlatformSettings
+  ///
+  UINT8  OverrideEqualizationDefaults;
+  ///
+  /// <b>(Test)</b> This member describes whether PCIE root port Port 8xh Decode is enabled. <b>0: Disable</b>; 1: Enable.
+  ///
+  UINT8  EnablePort8xhDecode;
+  ///
+  /// <b>(Test)</b> The Index of PCIe Port that is selected for Port8xh Decode (0 Based)
+  ///
+  UINT8  PchPciePort8xhDecodePortIndex;
+  UINT8  RsvdBytes0[1];
+} PCH_PCIE_CONFIG;
+
+/**
+  The PCH_PCIE_RP_PREMEM_CONFIG block describes early configuration of the PCH PCI Express controllers
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                                ///< Config Block Header
+  /**
+    Root Port enabling mask.
+    Bit0 presents RP1, Bit1 presents RP2, and so on.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                RpEnabledMask;
+  /// Configuration of PCIe source clocks
+  ///
+  PCH_PCIE_CLOCK        PcieClock[PCH_MAX_PCIE_CLOCKS];
+
+  /**
+    Per Controller Bifurcation Configuration
+    <b>0: Disabled</b>; 1: 4x1; 2: 1x2_2x1; 3: 2x2; 4: 1x4; 5: 4x2; 6: 1x4_2x2; 7: 2x2_1x4; 8: 2x4; 9: 1x8 (see: PCIE_BIFURCATION_CONFIG)
+  **/
+  UINT8                 Bifurcation[PCH_MAX_PCIE_CONTROLLERS];
+  UINT8                 Rsvd4[(4 - PCH_MAX_PCIE_CONTROLLERS % 4) % 4];
+} PCH_PCIE_RP_PREMEM_CONFIG;
+
+/**
+  The PCIE_RP_DXE_CONFIG block describes the expected configuration of the PCH PCI Express controllers in DXE phase
+
+  <b>Revision 1</b>:
+  - Init version
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER      Header;                     ///< Config Block Header
+
+  /**
+    PCIe device override table
+    The PCIe device table is being used to override PCIe device ASPM settings.
+    And it's only used in DXE phase.
+    Please refer to PCH_PCIE_DEVICE_OVERRIDE structure for the table.
+    Last entry VendorId must be 0.
+  **/
+  PCH_PCIE_DEVICE_OVERRIDE    *PcieDeviceOverrideTablePtr;
+} PCIE_RP_DXE_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _PCH_PCIERP_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
new file mode 100644
index 0000000000..f5859f50d9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
@@ -0,0 +1,213 @@
+/** @file
+  PCIe Config Block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCIE_CONFIG_H_
+#define _PCIE_CONFIG_H_
+#include <CpuPcieInfo.h>
+
+#define PCIE_CONFIG_REVISION  3
+/*
+<b>Revision 2< / b>:
+FomsCp - Deprecated
+<b>Revision 3< / b>:
+Added PCIE_EQ_PARAM  HwEqGen3CoeffList for all CPU_PCIE_MAX_ROOT_PORTS
+Added PCIE_EQ_PARAM  HwEqGen4CoeffList for all CPU_PCIE_MAX_ROOT_PORTS
+Added PCIE_EQ_PARAM  HwEqGen5CoeffList for all CPU_PCIE_MAX_ROOT_PORTS
+*/
+
+extern EFI_GUID gPcieConfigGuid;
+
+#pragma pack (push,1)
+
+enum PCIE_COMPLETION_TIMEOUT {
+  PcieCompletionTO_Default,
+  PcieCompletionTO_50_100us,
+  PcieCompletionTO_1_10ms,
+  PcieCompletionTO_16_55ms,
+  PcieCompletionTO_65_210ms,
+  PcieCompletionTO_260_900ms,
+  PcieCompletionTO_1_3P5s,
+  PcieCompletionTO_4_13s,
+  PcieCompletionTO_17_64s,
+  PcieCompletionTO_Disabled
+};
+
+enum PCIE_SPEED {
+  PcieAuto,
+  PcieGen1,
+  PcieGen2,
+  PcieGen3,
+  PcieGen4
+};
+
+/**
+  Represent lane specific PCIe Gen3 equalization parameters.
+**/
+typedef struct {
+  UINT8   Cm;                 ///< Coefficient C-1
+  UINT8   Cp;                 ///< Coefficient C+1
+  UINT8   Rsvd0[2];           ///< Reserved bytes
+} PCIE_EQ_PARAM;
+
+typedef struct {
+  UINT16  LtrMaxSnoopLatency;                     ///< <b>(Test)</b> Latency Tolerance Reporting, Max Snoop Latency.
+  UINT16  LtrMaxNoSnoopLatency;                   ///< <b>(Test)</b> Latency Tolerance Reporting, Max Non-Snoop Latency.
+  UINT8   SnoopLatencyOverrideMode;               ///< <b>(Test)</b> Latency Tolerance Reporting, Snoop Latency Override Mode.
+  UINT8   SnoopLatencyOverrideMultiplier;         ///< <b>(Test)</b> Latency Tolerance Reporting, Snoop Latency Override Multiplier.
+  UINT16  SnoopLatencyOverrideValue;              ///< <b>(Test)</b> Latency Tolerance Reporting, Snoop Latency Override Value.
+  UINT8   NonSnoopLatencyOverrideMode;            ///< <b>(Test)</b> Latency Tolerance Reporting, Non-Snoop Latency Override Mode.
+  UINT8   NonSnoopLatencyOverrideMultiplier;      ///< <b>(Test)</b> Latency Tolerance Reporting, Non-Snoop Latency Override Multiplier.
+  UINT16  NonSnoopLatencyOverrideValue;           ///< <b>(Test)</b> Latency Tolerance Reporting, Non-Snoop Latency Override Value.
+  UINT8   LtrConfigLock;                          ///< <b>0: Disable</b>; 1: Enable.
+  UINT8   ForceLtrOverride;
+  UINT16  RsvdByte1;
+} PCIE_LTR_CONFIG;
+
+
+/**
+  Specifies the form factor that the slot
+  implements. For custom form factors that
+  do not require any special handling please
+  set PcieFormFactorOther.
+**/
+typedef enum {
+  PcieFormFactorOther = 0,
+  PcieFormFactorCem,
+  PcieFormFactorMiniPci,
+  PcieFormFactorM2,
+  PcieFormFactorOcuLink,
+  PcieFormFactorExpressModule, // Also known as Server IO module(SIOM)
+  PcieFormFactorExpressCard,
+  PcieFormFactorU2 // Also known as SF-8639
+} PCIE_FORM_FACTOR;
+
+//Note: This structure will be expanded to hold all common PCIe policies between SA and PCH RootPort
+typedef struct {
+  UINT32  HotPlug                         :  1;   ///< Indicate whether the root port is hot plug available. <b>0: Disable</b>; 1: Enable.
+  UINT32  PmSci                           :  1;   ///< Indicate whether the root port power manager SCI is enabled. 0: Disable; <b>1: Enable</b>.
+  UINT32  TransmitterHalfSwing            :  1;   ///< Indicate whether the Transmitter Half Swing is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  AcsEnabled                      :  1;   ///< Indicate whether the ACS is enabled. 0: Disable; <b>1: Enable</b>.
+  //
+  // Error handlings
+  //
+  UINT32  AdvancedErrorReporting          :  1;   ///< Indicate whether the Advanced Error Reporting is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  UnsupportedRequestReport        :  1;   ///< Indicate whether the Unsupported Request Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  FatalErrorReport                :  1;   ///< Indicate whether the Fatal Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  NoFatalErrorReport              :  1;   ///< Indicate whether the No Fatal Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  CorrectableErrorReport          :  1;   ///< Indicate whether the Correctable Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  SystemErrorOnFatalError         :  1;   ///< Indicate whether the System Error on Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  SystemErrorOnNonFatalError      :  1;   ///< Indicate whether the System Error on Non Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT32  SystemErrorOnCorrectableError   :  1;   ///< Indicate whether the System Error on Correctable Error is enabled. <b>0: Disable</b>; 1: Enable.
+  /**
+    Max Payload Size supported, Default <b>128B</b>, see enum CPU_PCIE_MAX_PAYLOAD
+    Changes Max Payload Size Supported field in Device Capabilities of the root port.
+  **/
+  UINT32  MaxPayload                      :  2;
+  UINT32  DpcEnabled                      :  1;   ///< Downstream Port Containment. 0: Disable; <b>1: Enable</b>
+  UINT32  RpDpcExtensionsEnabled          :  1;   ///< RP Extensions for Downstream Port Containment. 0: Disable; <b>1: Enable</b>
+  /**
+    Indicates how this root port is connected to endpoint. 0: built-in device; <b>1: slot</b>
+    Built-in is incompatible with hotplug-capable ports.
+  **/
+  UINT32  SlotImplemented                 :  1;
+  UINT32  PtmEnabled                      :  1;   ///< Enables PTM capability
+  UINT32  SlotPowerLimitScale             :  2;   ///< <b>(Test)</b> Specifies scale used for slot power limit value. Leave as 0 to set to default. Default is <b>zero</b>.
+  UINT32  SlotPowerLimitValue             : 12;   //< <b>(Test)</b> Specifies upper limit on power supplies by slot. Leave as 0 to set to default. Default is <b>zero</b>.
+  /**
+    Probe CLKREQ# signal before enabling CLKREQ# based power management.
+    Conforming device shall hold CLKREQ# low until CPM is enabled. This feature attempts
+    to verify CLKREQ# signal is connected by testing pad state before enabling CPM.
+    In particular this helps to avoid issues with open-ended PCIe slots.
+    This is only applicable to non hot-plug ports.
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32  ClkReqDetect                    :  1;
+  /**
+    Set if the slot supports manually operated retention latch.
+  **/
+  UINT32  MrlSensorPresent                :  1;
+  UINT32  RelaxedOrder                    :  1;
+  UINT32  NoSnoop                         :  1;
+  UINT32  RsvdBits0                       : 28;   ///< Reserved bits.
+  /**
+    PCIe Gen3 Equalization Phase 3 Method (see CPU_PCIE_EQ_METHOD).
+    0: DEPRECATED, hardware equalization; <b>1: hardware equalization</b>; 4: Fixed Coefficients
+  **/
+  UINT8   Gen3EqPh3Method;
+  UINT8   PhysicalSlotNumber;                     ///< Indicates the slot number for the root port. Default is the value as root port index.
+  UINT8   CompletionTimeout;                      ///< The completion timeout configuration of the root port (see: CPU_PCIE_COMPLETION_TIMEOUT). Default is <b>PchPcieCompletionTO_Default</b>.
+  //
+  // Power Management
+  //
+  UINT8   Aspm;                                   ///< The ASPM configuration of the root port (see: CPU_PCIE_ASPM_CONTROL). Default is <b>PchPcieAspmAutoConfig</b>.
+  UINT8   L1Substates;                            ///< The L1 Substates configuration of the root port (see: CPU_PCIE_L1SUBSTATES_CONTROL). Default is <b>PchPcieL1SubstatesL1_1_2</b>.
+  UINT8   LtrEnable;                              ///< Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+  UINT8   EnableCpm;                              ///< Enables Clock Power Management; even if disabled, CLKREQ# signal can still be controlled by L1 PM substates mechanism
+  UINT8   PcieSpeed;                              ///< Contains speed of PCIe bus (see: PCIE_SPEED)
+  /**
+  <b>(Test)</b>
+  Forces LTR override to be permanent
+  The default way LTR override works is:
+  rootport uses LTR override values provided by BIOS until connected device sends an LTR message, then it will use values from the message
+  This settings allows force override of LTR mechanism. If it's enabled, then:
+  rootport will use LTR override values provided by BIOS forever; LTR messages sent from connected device will be ignored
+  **/
+  PCIE_LTR_CONFIG               PcieRpLtrConfig;            ///< <b>(Test)</b> Latency Tolerance Reporting Policies including LTR limit and Override
+    /**
+    The number of milliseconds reference code will wait for link to exit Detect state for enabled ports
+    before assuming there is no device and potentially disabling the port.
+    It's assumed that the link will exit detect state before root port initialization (sufficient time
+    elapsed since PLTRST de-assertion) therefore default timeout is zero. However this might be useful
+    if device power-up seqence is controlled by BIOS or a specific device requires more time to detect.
+    In case of non-common clock enabled the default timout is 15ms.
+    <b>Default: 0</b>
+  **/
+  UINT16  DetectTimeoutMs;
+  UINT8   FormFactor; // Please check PCIE_FORM_FACTOR for supported values
+  UINT8   Reserved;
+} PCIE_ROOT_PORT_COMMON_CONFIG;
+
+/**
+  PCIe Common Config
+  @note This structure will be expanded to hold all common PCIe policies between SA and PCH
+**/
+typedef struct {
+  ///
+  /// This member describes whether Peer Memory Writes are enabled on the platform. <b>0: Disable</b>; 1: Enable.
+  ///
+  UINT32  EnablePeerMemoryWrite          :  1;
+  /**
+    RpFunctionSwap allows BIOS to use root port function number swapping when root port of function 0 is disabled.
+    A PCIE device can have higher functions only when Function0 exists. To satisfy this requirement,
+    BIOS will always enable Function0 of a device that contains more than 0 enabled root ports.
+    - <b>Enabled: One of enabled root ports get assigned to Function0.</b>
+      This offers no guarantee that any particular root port will be available at a specific DevNr:FuncNr location
+    - Disabled: Root port that corresponds to Function0 will be kept visible even though it might be not used.
+      That way rootport - to - DevNr:FuncNr assignment is constant. This option will impact ports 1, 9, 17.
+      NOTE: This option will not work if ports 1, 9, 17 are fused or configured for RST PCIe storage or disabled through policy
+            In other words, it only affects ports that would become hidden because they have no device connected.
+      NOTE: Disabling function swap may have adverse impact on power management. This option should ONLY
+            be used when each one of root ports 1, 9, 17:
+        - is configured as PCIe and has correctly configured ClkReq signal, or
+        - does not own any mPhy lanes (they are configured as SATA or USB)
+  **/
+  UINT32  RpFunctionSwap                   :  1;
+  /**
+    Compliance Test Mode shall be enabled when using Compliance Load Board.
+    <b>0: Disable</b>, 1: Enable
+  **/
+  UINT32  ComplianceTestMode               :  1;
+  UINT32  RsvdBits0                        : 29;   ///< Reserved bits
+  ///
+  /// List of coefficients used during equalization (applicable to both software and hardware EQ)
+  /// Deprecated Policy
+  ///
+  PCIE_EQ_PARAM                    HwEqGen3CoeffList[PCIE_HWEQ_COEFFS_MAX];
+} PCIE_COMMON_CONFIG;
+
+
+#pragma pack (pop)
+#endif // _PCIE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
new file mode 100644
index 0000000000..5c7811823d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
@@ -0,0 +1,86 @@
+/** @file
+  ADR policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _ADR_CONFIG_H_
+#define _ADR_CONFIG_H_
+
+#include <ConfigBlock.h>
+
+#define ADR_CONFIG_REVISION 1
+extern EFI_GUID gAdrConfigGuid;
+
+#pragma pack (push,1)
+
+typedef enum {
+  AdrScale1us,
+  AdrScale10us,
+  AdrScale100us,
+  AdrScale1ms,
+  AdrScale10ms,
+  AdrScale100ms,
+  AdrScale1s,
+  AdrScale10s
+} ADR_TIMER_SCALE;
+
+/**
+  ADR Source Enable
+**/
+typedef union {
+  struct {
+    UINT32 Reserved1           : 1;
+    UINT32 AdrSrcPbo           : 1;
+    UINT32 AdrSrcPmcUncErr     : 1;
+    UINT32 AdrSrcPchThrm       : 1;
+    UINT32 AdrSrcMePbo         : 1;
+    UINT32 AdrSrcCpuThrm       : 1;
+    UINT32 AdrSrcMegbl         : 1;
+    UINT32 AdrSrcLtReset       : 1;
+    UINT32 AdrSrcPmcWdt        : 1;
+    UINT32 AdrSrcMeWdt         : 1;
+    UINT32 AdrSrcPmcFw         : 1;
+    UINT32 AdrSrcPchpwrFlr     : 1;
+    UINT32 AdrSrcSyspwrFlr     : 1;
+    UINT32 Reserved2           : 1;
+    UINT32 AdrSrcMiaUxsErr     : 1;
+    UINT32 AdrSrcMiaUxErr      : 1;
+    UINT32 AdrSrcCpuThrmWdt    : 1;
+    UINT32 AdrSrcMeUncErr      : 1;
+    UINT32 AdrSrcAdrGpio       : 1;
+    UINT32 AdrSrcOcwdtNoicc    : 1;
+    UINT32 AdrSrcOcwdtIcc      : 1;
+    UINT32 AdrSrcCseHecUncErr  : 1;
+    UINT32 AdrSrcPmcSramUncErr : 1;
+    UINT32 AdrSrcPmcIromParity : 1;
+    UINT32 AdrSrcPmcRfFusaErr  : 1;
+    UINT32 Reserved3           : 4;
+    UINT32 AdrSrcPpbrParityErr : 1;
+    UINT32 Reserved4           : 2;
+  } Field;
+  UINT32 Value;
+} ADR_SOURCE_ENABLE;
+
+/**
+  ADR Configuration
+  <b>Revision 1</b>:  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  UINT32        AdrEn                  : 2; ///< Determine if Adr is enabled - 0: PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
+  UINT32        AdrTimerEn             : 2; ///< Determine if Adr timer options are enabled - 0: PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
+  UINT32        AdrTimer1Val           : 2; ///< Determines the Timeout value used for the ADR timer 1. A value of zero bypasses the timer
+  UINT32        AdrMultiplier1Val      : 8; ///< Specifies the tick frequency upon which the timer 1 will increment. ADR_TIMER_SCALE should be used to encode values
+  UINT32        AdrTimer2Val           : 8; ///< Determines the Timeout value used for the ADR timer 2. A value of zero bypasses the timer
+  UINT32        AdrMultiplier2Val      : 8; ///< Specifies the tick frequency upon which the timer 2 will increment. ADR_TIMER_SCALE should be used to encode values
+  UINT32        AdrHostPartitionReset  : 2; ///< Determine if Host Partition Reset is enabled - 0: PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
+  UINT32        AdrSrcOverride         : 1; ///< Check if default ADR sources will be overriten with custom 0: Not overwritten, 1: Overwritten
+  UINT32        ReservedBits           : 31;
+  ADR_SOURCE_ENABLE   AdrSrcSel;            ///< Determine which ADR sources are enabled - 0: Enabled, 1: Disabled
+} ADR_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _ADR_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
new file mode 100644
index 0000000000..2f8e19b50b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
@@ -0,0 +1,391 @@
+/** @file
+  Power Management policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PM_CONFIG_H_
+#define _PM_CONFIG_H_
+
+#include <ConfigBlock.h>
+
+#define PM_CONFIG_REVISION 2
+extern EFI_GUID gPmConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure allows to customize PCH wake up capability from S5 or DeepSx by WOL, LAN, PCIE wake events.
+**/
+typedef struct {
+  /**
+    Corresponds to the PME_B0_S5_DIS bit in the General PM Configuration B (GEN_PMCON_B) register.
+    When set to 1, this bit blocks wake events from PME_B0_STS in S5, regardless of the state of PME_B0_EN.
+    When cleared (default), wake events from PME_B0_STS are allowed in S5 if PME_B0_EN = 1. <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32  PmeB0S5Dis         :  1;
+  UINT32  WolEnableOverride  :  1;      ///< Corresponds to the "WOL Enable Override" bit in the General PM Configuration B (GEN_PMCON_B) register. 0: Disable; <b>1: Enable</b>.
+  UINT32  PcieWakeFromDeepSx :  1;      ///< Determine if enable PCIe to wake from deep Sx. <b>0: Disable</b>; 1: Enable.
+  UINT32  WoWlanEnable       :  1;      ///< Determine if WLAN wake from Sx, corresponds to the "HOST_WLAN_PP_EN" bit in the PWRM_CFG3 register. <b>0: Disable</b>; 1: Enable.
+  UINT32  WoWlanDeepSxEnable :  1;      ///< Determine if WLAN wake from DeepSx, corresponds to the "DSX_WLAN_PP_EN" bit in the PWRM_CFG3 register. <b>0: Disable</b>; 1: Enable.
+  UINT32  LanWakeFromDeepSx  :  1;      ///< Determine if enable LAN to wake from deep Sx. 0: Disable; <b>1: Enable</b>.
+  UINT32  RsvdBits0          : 26;
+} PCH_WAKE_CONFIG;
+
+typedef enum {
+  PchDeepSxPolDisable,
+  PchDpS5BatteryEn,
+  PchDpS5AlwaysEn,
+  PchDpS4S5BatteryEn,
+  PchDpS4S5AlwaysEn,
+  PchDpS3S4S5BatteryEn,
+  PchDpS3S4S5AlwaysEn
+} PCH_DEEP_SX_CONFIG;
+
+typedef enum {
+  PchSlpS360us = 1,
+  PchSlpS31ms,
+  PchSlpS350ms,
+  PchSlpS32s
+} PCH_SLP_S3_MIN_ASSERT;
+
+typedef enum {
+  PchSlpS4PchTime,     ///< The time defined in PCH EDS Power Sequencing and Reset Signal Timings table
+  PchSlpS41s,
+  PchSlpS42s,
+  PchSlpS43s,
+  PchSlpS44s
+} PCH_SLP_S4_MIN_ASSERT;
+
+typedef enum {
+  PchSlpSus0ms = 1,
+  PchSlpSus500ms,
+  PchSlpSus1s,
+  PchSlpSus4s,
+} PCH_SLP_SUS_MIN_ASSERT;
+
+typedef enum {
+  PchSlpA0ms = 1,
+  PchSlpA4s,
+  PchSlpA98ms,
+  PchSlpA2s,
+} PCH_SLP_A_MIN_ASSERT;
+
+typedef enum {
+  S0ixDisQNoChange,
+  S0ixDisQDciOob,
+  S0ixDisQUsb2Dbc,
+  S0ixDisQMax,
+} S0IX_DISQ_PROBE_TYPE;
+
+/**
+  Low Power Mode Enable config.
+  Used to configure if respective S0i2/3 sub-states are to be supported
+  by the platform. Each bit corresponds to one LPM state - LPMx->BITx.
+  Some sub-states will require external FETs controlled by EXT_PWR_GATE#/EXT_PWR_GATE2# pins
+  to gate v1p05-PHY or v1p05-IS supplies
+**/
+typedef union {
+  struct {
+    UINT32  S0i2p0En     : 1;        ///< LPM0 - S0i2.0 Enable
+    UINT32  S0i2p1En     : 1;        ///< LPM1 - S0i2.1 Enable
+    /**
+      LPM2 - S0i2.2 Enable.
+      Requires EXT_PWR_GATE# controlled FET to gate v1p05 PHY.
+      Refer to V1p05PhyExtFetControlEn.
+    **/
+    UINT32  S0i2p2En     : 1;
+    UINT32  S0i3p0En     : 1;        ///< LPM3 - S0i3.0 Enable
+    UINT32  S0i3p1En     : 1;        ///< LPM4 - S0i3.1 Enable
+    UINT32  S0i3p2En     : 1;        ///< LPM5 - S0i3.2 Enable
+    /**
+      LPM5 - S0i3.3 Enable.
+      Requires EXT_PWR_GATE# controlled FET to gate v1p05 PHY.
+      Refer to V1p05PhyExtFetControlEn.
+    **/
+    UINT32  S0i3p3En     : 1;
+    /**
+      LPM7 - S0i3.4 Enable.
+      Requires EXT_PWR_GATE2# controlled FET to gate v1p05-SRAM/ISCLK.
+      Refer to V1p05IsExtFetControlEn.
+    **/
+    UINT32  S0i3p4En     : 1;
+    UINT32  Reserved     : 24;       ///< Reserved
+  } Field;
+  UINT32  Val;
+} PMC_LPM_S0IX_SUB_STATE_EN;
+
+/**
+  Description of Global Reset Trigger/Event Mask register
+**/
+typedef union {
+  struct {
+    UINT32 Reserved1     : 1;
+    UINT32 Pbo           : 1;
+    UINT32 PmcUncErr     : 1;
+    UINT32 PchThrm       : 1;
+    UINT32 MePbo         : 1;
+    UINT32 CpuThrm       : 1;
+    UINT32 Megbl         : 1;
+    UINT32 LtReset       : 1;
+    UINT32 PmcWdt        : 1;
+    UINT32 MeWdt         : 1;
+    UINT32 PmcFw         : 1;
+    UINT32 PchpwrFlr     : 1;
+    UINT32 SyspwrFlr     : 1;
+    UINT32 Reserved2     : 1;
+    UINT32 MiaUxsErr     : 1;
+    UINT32 MiaUxErr      : 1;
+    UINT32 CpuThrmWdt    : 1;
+    UINT32 MeUncErr      : 1;
+    UINT32 AdrGpio       : 1;
+    UINT32 OcwdtNoicc    : 1;
+    UINT32 OcwdtIcc      : 1;
+    UINT32 CseHecUncErr  : 1;
+    UINT32 PmcSramUncErr : 1;
+    UINT32 PmcIromParity : 1;
+    UINT32 PmcRfFusaErr  : 1;
+    UINT32 Reserved3     : 4;
+    UINT32 PpbrParityErr : 1;
+    UINT32 Reserved4     : 2;
+  } Field;
+  UINT32 Value;
+} PMC_GLOBAL_RESET_MASK;
+
+/**
+  The PCH_PM_CONFIG block describes expected miscellaneous power management settings.
+  The PowerResetStatusClear field would clear the Power/Reset status bits, please
+  set the bits if you want PCH Init driver to clear it, if you want to check the
+  status later then clear the bits.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>
+  - Added C10DynamicThresholdAdjustment
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER     Header;                           ///< Config Block Header
+
+  PCH_WAKE_CONFIG         WakeConfig;                       ///< Specify Wake Policy
+  UINT32                  PchDeepSxPol       :  4;          ///< Deep Sx Policy. Refer to PCH_DEEP_SX_CONFIG for each value. Default is <b>PchDeepSxPolDisable</b>.
+  UINT32                  PchSlpS3MinAssert  :  4;          ///< SLP_S3 Minimum Assertion Width Policy. Refer to PCH_SLP_S3_MIN_ASSERT for each value. Default is <b>PchSlpS350ms</b>.
+  UINT32                  PchSlpS4MinAssert  :  4;          ///< SLP_S4 Minimum Assertion Width Policy. Refer to PCH_SLP_S4_MIN_ASSERT for each value. Default is <b>PchSlpS44s</b>.
+  UINT32                  PchSlpSusMinAssert :  4;          ///< SLP_SUS Minimum Assertion Width Policy. Refer to PCH_SLP_SUS_MIN_ASSERT for each value. Default is <b>PchSlpSus4s</b>.
+  UINT32                  PchSlpAMinAssert   :  4;          ///< SLP_A Minimum Assertion Width Policy. Refer to PCH_SLP_A_MIN_ASSERT for each value. Default is <b>PchSlpA2s</b>.
+  UINT32                  RsvdBits0          : 12;
+  /**
+    This member describes whether or not the LPC ClockRun feature of PCH should
+    be enabled. <b>0: Disable</b>; 1: Enable
+  **/
+  UINT32                  SlpStrchSusUp        :  1;        ///< <b>0: Disable</b>; 1: Enable SLP_X Stretching After SUS Well Power Up
+  /**
+    Enable/Disable SLP_LAN# Low on DC Power. 0: Disable; <b>1: Enable</b>.
+    Configure On DC PHY Power Diable according to policy SlpLanLowDc.
+    When this is enabled, SLP_LAN# will be driven low when ACPRESENT is low.
+    This indicates that LAN PHY should be powered off on battery mode.
+    This will override the DC_PP_DIS setting by WolEnableOverride.
+  **/
+  UINT32                  SlpLanLowDc          :  1;
+  /**
+    PCH power button override period.
+    000b-4s, 001b-6s, 010b-8s, 011b-10s, 100b-12s, 101b-14s
+    <b>Default is 0: 4s</b>
+  **/
+  UINT32                  PwrBtnOverridePeriod :  3;
+  /**
+    <b>(Test)</b>
+    Disable/Enable PCH to CPU enery report feature. <b>0: Disable</b>; 1: Enable.
+    Enery Report is must have feature. Wihtout Energy Report, the performance report
+    by workloads/benchmarks will be unrealistic because PCH's energy is not being accounted
+    in power/performance management algorithm.
+    If for some reason PCH energy report is too high, which forces CPU to try to reduce
+    its power by throttling, then it could try to disable Energy Report to do first debug.
+    This might be due to energy scaling factors are not correct or the LPM settings are not
+    kicking in.
+  **/
+  UINT32                  DisableEnergyReport  :  1;
+  /**
+    When set to Disable, PCH will internal pull down AC_PRESENT in deep SX and during G3 exit.
+    When set to Enable, PCH will not pull down AC_PRESENT.
+    This setting is ignored when DeepSx is not supported.
+    Default is <b>0:Disable</b>
+  **/
+  UINT32                  DisableDsxAcPresentPulldown  :  1;
+  /**
+    Power button native mode disable.
+    While FALSE, the PMC's power button logic will act upon the input value from the GPIO unit, as normal.
+    While TRUE, this will result in the PMC logic constantly seeing the power button as de-asserted.
+    <b>Default is FALSE.</b>
+  **/
+  UINT32                  DisableNativePowerButton     :  1;
+  UINT32                  MeWakeSts                    :  1;     ///< Clear the ME_WAKE_STS bit in the Power and Reset Status (PRSTS) register. 0: Disable; <b>1: Enable</b>.
+  UINT32                  WolOvrWkSts                  :  1;     ///< Clear the WOL_OVR_WK_STS bit in the Power and Reset Status (PRSTS) register. 0: Disable; <b>1: Enable</b>.
+  /*
+    Set true to enable TCO timer.
+    When FALSE, it disables PCH ACPI timer, and stops TCO timer.
+    @note: This will have significant power impact when it's enabled.
+    If TCO timer is disabled, uCode ACPI timer emulation must be enabled,
+    and WDAT table must not be exposed to the OS.
+    <b>0: Disable</b>, 1: Enable
+  */
+  UINT32                  EnableTcoTimer               : 1;
+  /*
+    When VRAlert# feature pin is enabled and its state is '0',
+    the PMC requests throttling to a T3 Tstate to the PCH throttling unit.
+    <b>0: Disable</b>; 1: Enable.
+  */
+  UINT32                  VrAlert                      : 1;
+  /**
+    Decide if PS_ON is to be enabled. This is available on desktop only.
+    PS_ON is a new C10 state from the CPU on desktop SKUs that enables a
+    lower power target that will be required by the California Energy
+    Commission (CEC). When FALSE, PS_ON is to be disabled.}
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32                  PsOnEnable                   :  1;
+  /**
+    Enable/Disable platform support for CPU_C10_GATE# pin to control gating
+    of CPU VccIO and VccSTG rails instead of SLP_S0# pin. This policy needs
+    to be set if board design includes support for CPU_C10_GATE# pin.
+    0: Disable; <b>1: Enable</b>
+  **/
+  UINT32                  CpuC10GatePinEnable          :  1;
+  /**
+    Control whether to enable PMC debug messages to Trace Hub.
+    When Enabled, PMC HW will send debug messages to trace hub;
+    When Disabled, PMC HW will never send debug meesages to trace hub.
+    @note: When enabled, system may not enter S0ix
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32                  PmcDbgMsgEn                  :  1;
+  /**
+    Enable/Disable ModPHY SUS Power Domain Dynamic Gating.
+    EXT_PWR_GATE# signal (if supported on platform) can be used to
+    control external FET for power gating ModPHY
+    @note: This setting is not supported and ignored on PCH-H
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                  ModPhySusPgEnable            :  1;
+  /**
+    <b>(Test)</b>
+    This policy option enables USB2 PHY SUS Well Power Gating functionality.
+    @note: This setting is not supported and ignored on PCH-H
+    0: disable USB2 PHY SUS Well Power Gating
+    <b>1: enable USB2 PHY SUS Well Power Gating</b>
+  **/
+  UINT32                  Usb2PhySusPgEnable           :  1;
+  /**
+    Enable Os Idle Mode.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                  OsIdleEnable                 :  1;
+  /**
+    Enable control using EXT_PWR_GATE# pin of external FET
+    to power gate v1p05-PHY
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32                  V1p05PhyExtFetControlEn      :  1;
+  /**
+    Enable control using EXT_PWR_GATE2# pin of external FET
+    to power gate v1p05-IS supply
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32                  V1p05IsExtFetControlEn       :  1;
+  /**
+    Enable/Disable the Low Power Mode Host S0ix Auto-Demotion
+    feature. This feature enables the PMC to autonomously manage
+    the deepest allowed S0ix substate to combat thrashing between
+    power management states.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                  S0ixAutoDemotion             :  1;
+  /**
+    Enable/Disable Latch Events C10 Exit. When this bit is set to 1,
+    SLP_S0# entry events in SLP_S0_DEBUG_REGx registers are captured
+    on C10 exit (instead of C10 entry which is default)
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32                  LatchEventsC10Exit           :  1;
+  UINT32                  RsvdBits1                    :  10;
+  /*
+    Power button debounce configuration
+    Debounce time can be specified in microseconds. Only certain values according
+    to below formula are supported:
+     DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(glitch filter clock period).
+    RTC clock with f = 32 KHz is used for glitch filter.
+     DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(31.25 us).
+    Supported DebounceTime values are following:
+     DebounceTime = 0 -> Debounce feature disabled
+     DebounceTime > 0 && < 250us -> Not supported
+     DebounceTime = 250us - 1024000us -> Supported range (DebounceTime = 250us * 2^n)
+    For values not supported by HW, they will be rounded down to closest supported one
+    <b>Default is 0</b>
+  */
+  UINT32                  PowerButtonDebounce;
+  /**
+    Reset Power Cycle Duration could be customized in the unit of second. Please refer to EDS
+    for all support settings. PCH HW default is 4 seconds, and range is 1~4 seconds, where
+    <b>0 is default</b>, 1 is 1 second, 2 is 2 seconds, ... 4 is 4 seconds.
+    And make sure the setting correct, which never less than the following register.
+    - GEN_PMCON_B.SLP_S3_MIN_ASST_WDTH
+    - GEN_PMCON_B.SLP_S4_MIN_ASST_WDTH
+    - PWRM_CFG.SLP_A_MIN_ASST_WDTH
+    - PWRM_CFG.SLP_LAN_MIN_ASST_WDTH
+  **/
+  UINT8                   PchPwrCycDur;
+  /**
+    Specifies the Pcie Pll Spread Spectrum Percentage
+    The value of this policy is in 1/10th percent units.
+    Valid spread range is 0-20. A value of 0xFF is reserved for AUTO.
+    A value of 0 is SSC of 0.0%. A value of 20 is SSC of 2.0%
+    The default is <b>0xFF: AUTO - No BIOS override</b>.
+  **/
+  UINT8                   PciePllSsc;
+  /**
+    Tells BIOS to enable C10 dynamic threshold adjustment mode.
+    BIOS will only attemt to enable it on PCH SKUs which support it.
+  **/
+  UINT8                   C10DynamicThresholdAdjustment;
+  UINT8                   Rsvd0[1];                             ///< Reserved bytes
+  /**
+    <b>(Test)</b>
+    Low Power Mode Enable/Disable config.
+    Configure if respective S0i2/3 sub-states are to be supported
+    by the platform. By default all sub-states are enabled but
+    for test purpose respective states can be disabled.
+    <b>Default is 0xFF</b>
+  **/
+  PMC_LPM_S0IX_SUB_STATE_EN      LpmS0ixSubStateEnable;
+  /*
+    Set true to enable Timed GPIO 0 timer.
+    <b>0: Disable</b>, 1: Enable
+  */
+  UINT32                  EnableTimedGpio0             : 1;
+  /*
+    Set true to enable Timed GPIO 1 timer.
+    <b>0: Disable</b>, 1: Enable
+  */
+  UINT32                  EnableTimedGpio1             : 1;
+  UINT32                  Rsvdbits                     : 30;
+
+  /**
+    Set true to enable override of Global Reset Event/Trigger masks.
+    Values from GlobalResetTriggerMask and GlobalResetEventMask will
+    be used as override value.
+    <b>0: Disable</b>, 1: Enable
+  **/
+  UINT8                   GlobalResetMasksOverride;
+  UINT8                   Rsvd1[3];             ///< Reserved bytes
+  /*
+    Mask for enabling Global Reset Trigger prevention
+  */
+  PMC_GLOBAL_RESET_MASK   GlobalResetTriggerMask;
+  /*
+    Mask for enabling Global Reset Event prevention
+  */
+  PMC_GLOBAL_RESET_MASK   GlobalResetEventMask;
+} PCH_PM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _PM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
new file mode 100644
index 0000000000..033e416b83
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
@@ -0,0 +1,32 @@
+/** @file
+  Primary Sideband Fabric policy.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PSF_CONFIG_H_
+#define _PSF_CONFIG_H_
+
+#define PSF_CONFIG_REVISION 1
+extern EFI_GUID gPsfConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PSF_CONFIG block describes the expected configuration of the Primary
+  Sideband Fabric.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
+  /**
+    Psf Tcc (Time Coordinated Computing) Enable will decrease psf transaction latency by disable
+    some psf power management features. <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32    TccEnable                :  1;
+  UINT32    RsvdBits0                : 31;       ///< Reserved bits
+} PSF_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _PSF_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
new file mode 100644
index 0000000000..469d46a205
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
@@ -0,0 +1,82 @@
+/** @file
+  Rst policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _RST_CONFIG_H_
+#define _RST_CONFIG_H_
+#include <PchLimits.h>
+#include <ConfigBlock.h>
+
+#define RST_CONFIG_REVISION 1
+extern EFI_GUID gRstConfigGuid;
+
+#pragma pack (push,1)
+
+typedef enum {
+  SataOromDelay2sec,
+  SataOromDelay4sec,
+  SataOromDelay6sec,
+  SataOromDelay8sec
+} SATA_OROM_DELAY;
+
+/**
+  This structure describes the details of Intel RST for PCIe Storage remapping
+  Note: In order to use this feature, Intel RST Driver is required
+**/
+typedef struct {
+  /**
+    This member describes whether or not the Intel RST for PCIe Storage remapping should be enabled. <b>0: Disable</b>; 1: Enable.
+    Note 1: If Sata Controller is disabled, PCIe Storage Remapping should be disabled as well
+    Note 2: If PCIe Storage remapping is enabled, the PCH integrated AHCI controllers Class Code is configured as RAID
+  **/
+  UINT32   Enable                 :  1;
+  /**
+    Intel RST for PCIe Storage remapping - PCIe Port Selection (1-based, <b>0 = autodetect</b>)
+    The supported ports for PCIe Storage remapping is different depend on the platform and cycle router
+  **/
+  UINT32   RstPcieStoragePort     :  5;
+  /**
+    PCIe Storage Device Reset Delay in milliseconds (ms), which it guarantees such delay gap is fulfilled
+    before PCIe Storage Device configuration space is accessed after an reset caused by the link disable and enable step.
+    Default value is <b>100ms</b>.
+  **/
+  UINT32   DeviceResetDelay       :  8;
+  UINT32   RsvdBits0              : 18; ///< Reserved bits
+
+} RST_HARDWARE_REMAPPED_STORAGE_CONFIG;
+
+/**
+  Rapid Storage Technology settings.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                             ///< Config Block Header
+
+  UINT32  Raid0              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID0
+  UINT32  Raid1              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID1
+  UINT32  Raid10             :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID10
+  UINT32  Raid5              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID5
+  UINT32  Irrt               :  1;         ///< 0  : Disable; <b>1  : Enable</b> Intel Rapid Recovery Technology
+  UINT32  OromUiBanner       :  1;         ///< 0  : Disable; <b>1  : Enable</b> OROM UI and BANNER
+  UINT32  OromUiDelay        :  2;         ///< <b>00b  : 2 secs</b>; 01b  : 4 secs; 10b  : 6 secs; 11  : 8 secs (see  : SATA_OROM_DELAY)
+  UINT32  HddUnlock          :  1;         ///< 0  : Disable; <b>1  : Enable</b>. Indicates that the HDD password unlock in the OS is enabled
+  UINT32  LedLocate          :  1;         ///< 0  : Disable; <b>1  : Enable</b>. Indicates that the LED/SGPIO hardware is attached and ping to locate feature is enabled on the OS
+  UINT32  IrrtOnly           :  1;         ///< 0  : Disable; <b>1  : Enable</b>. Allow only IRRT drives to span internal and external ports
+  UINT32  SmartStorage       :  1;         ///< 0  : Disable; <b>1  : Enable</b> RST Smart Storage caching Bit
+  UINT32  LegacyOrom         :  1;         ///< <b>0  : Disable</b>; 1  : Enable RST Legacy OROM
+  UINT32  OptaneMemory       :  1;         ///< 0: Disable; <b>1: Enable</b> RST Optane(TM) Memory
+  UINT32  CpuAttachedStorage :  1;         ///< 0: Disable; <b>1: Enable</b> CPU Attached Storage
+  UINT32  RsvdBits0          : 17;         ///< Reserved Bits
+  /**
+    This member describes the details of implementation of Intel RST for PCIe Storage remapping (Intel RST Driver is required)
+    Note: RST for PCIe Sorage remapping is supported only for first SATA controller if more controllers are available
+  **/
+  RST_HARDWARE_REMAPPED_STORAGE_CONFIG   HardwareRemappedStorageConfig[PCH_MAX_RST_PCIE_STORAGE_CR];
+} RST_CONFIG;
+
+#pragma pack (pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
new file mode 100644
index 0000000000..1f354c10ae
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
@@ -0,0 +1,38 @@
+/** @file
+  RTC policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _RTC_CONFIG_H_
+#define _RTC_CONFIG_H_
+
+#define RTC_CONFIG_REVISION 1
+extern EFI_GUID gRtcConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The RTC_CONFIG block describes the expected configuration of RTC configuration.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  /**
+    When set, prevents RTC TS (BUC.TS) from being changed.
+    This BILD bit has different function compared to LPC/eSPI, SPI.
+    0: Disabled; <b>1: Enabled</b>
+  **/
+  UINT32  BiosInterfaceLock       :  1;
+  /**
+    When set, bytes 38h-3Fh in the upper 128bytes bank of RTC RAM are locked
+    and cannot be accessed.
+    Writes will be droipped and reads will not return any guaranteed data.
+    0: Disabled; <b>1: Enabled</b>
+  **/
+  UINT32  MemoryLock              :  1;
+  UINT32  RsvdBits0               : 30;
+} RTC_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _RTC_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
new file mode 100644
index 0000000000..c560fdd3ab
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
@@ -0,0 +1,168 @@
+/** @file
+  Sata policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SATA_CONFIG_H_
+#define _SATA_CONFIG_H_
+
+#include <PchLimits.h>
+
+#define SATA_CONFIG_REVISION 1
+extern EFI_GUID gSataConfigGuid;
+
+#pragma pack (push,1)
+
+typedef enum  {
+  SataModeAhci,
+  SataModeRaid,
+  SataModeMax
+} SATA_MODE;
+
+typedef enum {
+  SataSpeedDefault,
+  SataSpeedGen1,
+  SataSpeedGen2,
+  SataSpeedGen3
+} SATA_SPEED;
+
+typedef enum {
+  SataRstMsix,
+  SataRstMsi,
+  SataRstLegacy
+} SATA_RST_INTERRUPT;
+
+typedef enum {
+  SataRaidClient,
+  SataRaidAlternate,
+  SataRaidServer
+} SATA_RAID_DEV_ID;
+
+/**
+  This structure configures the features, property, and capability for each SATA port.
+**/
+typedef struct {
+  /**
+    Enable SATA port.
+    It is highly recommended to disable unused ports for power savings
+  **/
+  UINT32  Enable           :  1;                  ///< 0: Disable; <b>1: Enable</b>
+  UINT32  HotPlug          :  1;                  ///< <b>0: Disable</b>; 1: Enable
+  UINT32  InterlockSw      :  1;                  ///< <b>0: Disable</b>; 1: Enable
+  UINT32  External         :  1;                  ///< <b>0: Disable</b>; 1: Enable
+  UINT32  SpinUp           :  1;                  ///< <b>0: Disable</b>; 1: Enable the COMRESET initialization Sequence to the device
+  UINT32  SolidStateDrive  :  1;                  ///< <b>0: HDD</b>; 1: SSD
+  UINT32  DevSlp           :  1;                  ///< <b>0: Disable</b>; 1: Enable DEVSLP on the port
+  UINT32  EnableDitoConfig :  1;                  ///< <b>0: Disable</b>; 1: Enable DEVSLP Idle Timeout settings (DmVal, DitoVal)
+  UINT32  DmVal            :  4;                  ///< DITO multiplier. Default is <b>15</b>.
+  UINT32  DitoVal          : 10;                  ///< DEVSLP Idle Timeout (DITO), Default is <b>625</b>.
+  /**
+    Support zero power ODD <b>0: Disable</b>, 1: Enable.
+    This is also used to disable ModPHY dynamic power gate.
+  **/
+  UINT32  ZpOdd             :  1;
+  UINT32  DevSlpResetConfig :  4;                 ///< 0: Hardware default; <b>0x01: GpioResumeReset</b>; 0x03: GpioHostDeepReset; 0x05: GpioPlatformReset; 0x07: GpioDswReset
+  UINT32  SataPmPtm         :  1;                 ///< Deprecated
+  UINT32  RxPolarity        :  1;                 ///< <b>0: Disable</b>; 1: Enable; Rx Polarity
+  UINT32  RsvdBits0         :  3;                 ///< Reserved fields for future expansion w/o protocol change
+} PCH_SATA_PORT_CONFIG;
+
+/**
+  This structure lists PCH supported SATA thermal throttling register setting for customization.
+  The settings is programmed through SATA Index/Data registers.
+  When the SuggestedSetting is enabled, the customized values are ignored.
+**/
+typedef struct {
+  UINT32  P0T1M                   :  2; ///< Port 0 T1 Multipler
+  UINT32  P0T2M                   :  2; ///< Port 0 T2 Multipler
+  UINT32  P0T3M                   :  2; ///< Port 0 T3 Multipler
+  UINT32  P0TDisp                 :  2; ///< Port 0 Tdispatch
+
+  UINT32  P1T1M                   :  2; ///< Port 1 T1 Multipler
+  UINT32  P1T2M                   :  2; ///< Port 1 T2 Multipler
+  UINT32  P1T3M                   :  2; ///< Port 1 T3 Multipler
+  UINT32  P1TDisp                 :  2; ///< Port 1 Tdispatch
+
+  UINT32  P0Tinact                :  2; ///< Port 0 Tinactive
+  UINT32  P0TDispFinit            :  1; ///< Port 0 Alternate Fast Init Tdispatch
+  UINT32  P1Tinact                :  2; ///< Port 1 Tinactive
+  UINT32  P1TDispFinit            :  1; ///< Port 1 Alternate Fast Init Tdispatch
+  UINT32  SuggestedSetting        :  1; ///< 0: Disable; <b>1: Enable</b> suggested representative values
+  UINT32  RsvdBits0               :  9; ///< Reserved bits
+} SATA_THERMAL_THROTTLING;
+
+/**
+   The SATA_CONFIG block describes the expected configuration of the SATA controllers.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                             ///< Config Block Header
+  ///
+  /// This member describes whether or not the SATA controllers should be enabled. 0: Disable; <b>1: Enable</b>.
+  ///
+  UINT8                         Enable;
+  UINT8                         TestMode;       ///< <b>(Test)</b> <b>0: Disable</b>; 1: Allow entrance to the PCH SATA test modes
+  UINT8                         SalpSupport;    ///< 0: Disable; <b>1: Enable</b> Aggressive Link Power Management
+  UINT8                         PwrOptEnable;   ///< 0: Disable; <b>1: Enable</b> SATA Power Optimizer on PCH side.
+  /**
+    EsataSpeedLimit
+    When enabled, BIOS will configure the PxSCTL.SPD to 2 to limit the eSATA port speed.
+    Please be noted, this setting could be cleared by HBA reset, which might be issued
+    by EFI AHCI driver when POST time, or by SATA inbox driver/RST driver after POST.
+    To support the Speed Limitation when POST, the EFI AHCI driver should preserve the
+    setting before and after initialization. For support it after POST, it's dependent on
+    driver's behavior.
+    <b>0: Disable</b>; 1: Enable
+  **/
+  UINT8                         EsataSpeedLimit;
+  UINT8                         LedEnable;       ///< SATA LED indicates SATA controller activity. 0: Disable; <b>1: Enable</b> SATA LED.
+  /**
+    This option allows to configure SATA controller device ID while in RAID mode.
+    Refer to SATA_RAID_DEV_ID enumeration for supported options.
+    Choosing Client will allow RST driver loading, RSTe driver will not be able to load
+    Choosing Alternate will not allow RST inbox driver loading in Windows
+    Choosing Server will allow RSTe driver loading, RST driver will not load
+    <b>0: Client</b>; 1: Alternate; 2: Server
+  **/
+  UINT8                        RaidDeviceId;
+  /**
+    Controlls which interrupts will be linked to SATA controller CAP list
+    This option will take effect only if SATA controller is in RAID mode
+    Default: <b>PchSataMsix</b>
+  **/
+  UINT8                         SataRstInterrupt;
+
+  /**
+    Determines the system will be configured to which SATA mode.
+    Refer to SATA_MODE enumeration for supported options. Default is <b>SataModeAhci</b>.
+  **/
+  UINT8                         SataMode;
+  /**
+    Indicates the maximum speed the SATA controller can support.
+    Refer to SATA_SPEED enumeration for supported options.
+    <b>0h: SataSpeedDefault</b>; 1h: 1.5 Gb/s (Gen 1); 2h: 3 Gb/s(Gen 2); 3h: 6 Gb/s (Gen 1)
+  **/
+  UINT8                         SpeedLimit;
+  UINT8                         EnclosureSupport;   ///< Enclosure Management Support. 0: Disable; 1: Enable
+  /**
+    Controlls whenever Serial GPIO support is enabled for controller
+    <b>0: Disable</b>; 1: Enable
+  **/
+  UINT8                         SgpioSupport;
+  /**
+    This member configures the features, property, and capability for each SATA port.
+  **/
+  PCH_SATA_PORT_CONFIG          PortSettings[PCH_MAX_SATA_PORTS];
+  /**
+    This field decides the settings of Sata thermal throttling. When the Suggested Setting
+    is enabled, PCH RC will use the suggested representative values.
+  **/
+  SATA_THERMAL_THROTTLING       ThermalThrottling;
+} SATA_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SATA_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
new file mode 100644
index 0000000000..2ebc901896
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
@@ -0,0 +1,139 @@
+/** @file
+  Scs policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SCS_CONFIG_H_
+#define _SCS_CONFIG_H_
+
+#include <ConfigBlock.h>
+#include <PchLimits.h>
+
+#define SCS_SDCARD_CONFIG_REVISION     1
+#define SCS_EMMC_CONFIG_REVISION       1
+#define SCS_EMMC_DXE_CONFIG_REVISION   1
+#define SCS_SDCARD_MAX_DATA_GPIOS      4
+#define SCS_EMMC_MAX_DATA_GPIOS        8
+extern EFI_GUID gSdCardConfigGuid;
+extern EFI_GUID gEmmcConfigGuid;
+extern EFI_GUID gUfsConfigGuid;
+extern EFI_GUID gEmmcDxeConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structre holds the DLL configuration
+  register values that will be programmed by RC
+  if EnableCustomDlls field is set to TRUE. Those
+  policies should be used by platform if default values
+  provided by RC are not sufficient to provide stable operation
+  at all supported spped modes. RC will blindly set the DLL values
+  as provided in this structre.
+
+  For help with obtaining valid DLL values for your platform please
+  contact enabling support.
+**/
+typedef struct {
+  UINT32  TxCmdDelayControl;      // Offset 820h: Tx CMD Delay Control
+  UINT32  TxDataDelayControl1;    // Offset 824h: Tx Data Delay Control 1
+  UINT32  TxDataDelayControl2;    // Offset 828h: Tx Data Delay Control 2
+  UINT32  RxCmdDataDelayControl1; // Offset 82Ch: Rx CMD + Data Delay Control 1
+  UINT32  RxCmdDataDelayControl2; // Offset 834h: Rx CMD + Data Delay Control 2
+  UINT32  RxStrobeDelayControl;   // Offset 830h: Rx Strobe Delay Control, valid only for eMMC
+} SCS_SD_DLL;
+
+/**
+  SD GPIO settings
+**/
+typedef struct {
+  /**
+    GPIO signals pin muxing settings. If signal can be enable only on a single pin
+    then this parameter should be set to 0. Refer to GPIO_*_MUXING_SDCARD_*x_* in GpioPins*.h
+    for supported settings on a given platform
+  **/
+  UINT32   PinMux;
+  /**
+    GPIO Pads Internal Termination.
+    For more information please see Platform Design Guide.
+    Check GPIO_ELECTRICAL_CONFIG for reference
+  **/
+  UINT32   PadTermination;
+} MUX_GPIO_PARAM;
+
+typedef struct {
+  MUX_GPIO_PARAM PowerEnable;
+  MUX_GPIO_PARAM Cmd;
+  MUX_GPIO_PARAM Data[SCS_SDCARD_MAX_DATA_GPIOS];
+  MUX_GPIO_PARAM Cdb;
+  MUX_GPIO_PARAM Clk;
+  MUX_GPIO_PARAM Wp;
+} SCS_SDCARD_GPIO_CONFIG;
+
+typedef struct {
+  MUX_GPIO_PARAM Cmd;
+  MUX_GPIO_PARAM Data[SCS_EMMC_MAX_DATA_GPIOS];
+  MUX_GPIO_PARAM Rclk;
+  MUX_GPIO_PARAM Clk;
+  MUX_GPIO_PARAM Resetb;
+} SCS_EMMC_GPIO_CONFIG;
+
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;
+
+  UINT32      Enable                : 1;  ///<  Enable/Disable SdCard 0: Disabled, <b>1: Enabled</b>
+  UINT32      PowerEnableActiveHigh : 1;  ///<  Determine SD_PWREN# polarity 0: Active low, <b>1: Active high</b>
+  UINT32      UseCustomDlls         : 1;  ///<  Use tuned DLL values from policy <b>0: Use default DLL</b>, 1: Use values from TunedDllValues field
+  UINT32      Reserved              : 29;
+  SCS_SD_DLL  CustomDllValues;            ///<  Structure containing custom DLL values for SD card
+  SCS_SDCARD_GPIO_CONFIG GpioConfig;
+} SCS_SDCARD_CONFIG;
+
+typedef struct {
+  UINT32  Hs400RxValue : 7;  ///< Value of the tuned HS400 Rx value
+  UINT32  Hs400TxValue : 7;  ///< Value of the tuned HS400 Tx value
+  UINT32  Reserved     : 18;
+} SCS_EMMC_TUNED_DLL;
+
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;
+
+  UINT32      Enable         : 1;  ///<  Enable/Disable eMMC 0: Disabled, <b>1: Enabled</b>
+  UINT32      Hs400Supported : 1;  ///<  Enable/Disable eMMC HS400 support 0: Disabled, <b>1: Enabled</b>
+  UINT32      UseCustomDlls  : 1;  ///<  Use custom DLL values from policy <b>0: Use default DLL</b>, 1: Use values from TunedDllValues field
+  UINT32      Reserved       : 29;
+  SCS_SD_DLL  CustomDllValues;     ///<  Structure containing custom DLL values for eMMC                    ///< Structure containing tuned DLL settings for eMMC
+  SCS_EMMC_GPIO_CONFIG GpioConfig;
+} SCS_EMMC_CONFIG;
+
+typedef enum {
+  DriverStrength33Ohm = 0,
+  DriverStrength40Ohm,
+  DriverStrength50Ohm
+} SCS_EMMC_DRIVER_STRENGTH;
+
+typedef struct {
+  UINT32  TuningSuccessful  : 1;  ///< Informs software tuning module about previous software tuning status.
+  UINT32  Hs400RxValue      : 7;  ///< Value of the tuned HS400 Rx value returned from software tuning module
+  UINT32  Hs400TxValue      : 7;  ///< Value of the tuned HS400 Tx value returned from software tuning module
+  UINT32  Reserved          : 17;
+} SCS_EMMC_SOFTWARE_TUNING_RESULTS;
+
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;
+
+  UINT32   EnableSoftwareHs400Tuning         : 1;           ///< Enable/Disable software eMMC HS400 tuning: <b>0 - Disable</b>, 1 - Enable
+  UINT32   DriverStrength                    : 2;           ///< I/O driver strength: 0 - 33 Ohm, <b>1 - 40 Ohm</b>, 2 - 50 Ohm
+  UINT32   Reserved                          : 29;
+  EFI_LBA  TuningLba;                                       ///< Specifies LBA which will be used during software tuning process.
+  SCS_EMMC_SOFTWARE_TUNING_RESULTS  PreviousTuningResults;  ///< Informes software tuning module about previous software tuning results.} SCS_EMMC_DXE_CONFIG;
+} SCS_EMMC_DXE_CONFIG;
+
+typedef struct {
+  UINT32  Enable   : 1;  ///< Enable/Disable UFS controller 0: Disabled, <b>1: Enabled</b>
+  UINT32  Reserved : 31;
+} SCS_UFS_CONTROLLER_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SCS_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfig.h
new file mode 100644
index 0000000000..d76937cf59
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfig.h
@@ -0,0 +1,32 @@
+/** @file
+  Serial IO policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_CONFIG_H_
+#define _SERIAL_IO_CONFIG_H_
+
+#define SERIAL_IO_CONFIG_REVISION 1
+extern EFI_GUID gSerialIoConfigGuid;
+
+#include <SerialIoDevices.h>
+
+#pragma pack (push,1)
+
+/**
+  The SERIAL_IO_CONFIG block provides the configurations to set the Serial IO controllers
+
+  <b>Revision 1:</b>
+  - Inital version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                                              ///< Config Block Header
+  SERIAL_IO_SPI_CONFIG  SpiDeviceConfig[PCH_MAX_SERIALIO_SPI_CONTROLLERS];   ///< SPI Configuration
+  SERIAL_IO_I2C_CONFIG  I2cDeviceConfig[PCH_MAX_SERIALIO_I2C_CONTROLLERS];   ///< I2C Configuration
+  SERIAL_IO_UART_CONFIG UartDeviceConfig[PCH_MAX_SERIALIO_UART_CONTROLLERS]; ///< UART Configuration
+} SERIAL_IO_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SERIAL_IO_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
new file mode 100644
index 0000000000..7ee4554b1d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
@@ -0,0 +1,152 @@
+/** @file
+  Si Config Block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_CONFIG_H_
+#define _SI_CONFIG_H_
+
+#define SI_CONFIG_REVISION  2
+
+extern EFI_GUID gSiConfigGuid;
+
+
+#pragma pack (push,1)
+
+/**
+  The Silicon Policy allows the platform code to publish a set of configuration
+  information that the RC drivers will use to configure the silicon hardware.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Added TraceHubMemBase
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;  ///< Offset 0 - 27 Config Block Header
+  //
+  // Platform specific common policies that used by several silicon components.
+  //
+  UINT8  CsmFlag;                ///< CSM status flag.
+  /**
+    This is used to skip the SSID programming in silicon code.
+    When set to TRUE, silicon code will not do any SSID programming and platform code
+    needs to handle that by itself properly.
+    <b>0: FALSE</b>, 1: TRUE
+  **/
+  UINT8  SkipSsidProgramming;
+  UINT8  RsvdBytes0[2];
+  /**
+    When SkipSsidProgramming is FALSE, silicon code will use this as default value
+    to program the SVID for all internal devices.
+    <b>0: use silicon default SVID 0x8086 </b>, Non-zero: use customized SVID.
+  **/
+  UINT16 CustomizedSvid;
+  /**
+    When SkipSsidProgramming is FALSE, silicon code will use this as default value
+    to program the Sid for all internal devices.
+    <b>0: use silicon default SSID 0x7270 </b>, Non-zero: use customized SSID.
+  **/
+  UINT16 CustomizedSsid;
+  /**
+    SsidTablePtr contains the SVID_SID_INIT_ENTRY table.
+    This is valid when SkipSsidProgramming is FALSE;
+    It doesn't need to contain entries for all Intel internal devices.
+    It can only contains the SVID_SID_INIT_ENTRY entries for those Dev# Func# which needs
+    to be overridden.
+    In the enties, only Dev, Function, SubSystemVendorId, and SubSystemId are required.
+    <b>Default is NULL.</b>
+
+    E.g. Platform only needs to override BDF 0:31:5 to AAAA:BBBB and BDF 0:31:3 to CCCC:DDDD,
+    it can be done in platform like this:
+    STATIC SVID_SID_INIT_ENTRY mSsidTablePtr[SI_MAX_DEVICE_COUNT] = {0};
+
+    VOID SiPolicyUpdate () {
+      UINT32 EntryCount = 0;
+      SiPolicy->SkipSsidProgramming = FALSE;
+      SiPolicy->SsidTablePtr = mSsidTablePtr;
+
+      mSsidTablePtr[EntryCount].Address.Bits.Device   = SpiDeviceNumber ();
+      mSsidTablePtr[EntryCount].Address.Bits.Function = SpiFunctionNumber ();
+      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemVendorId = 0xAAAA;
+      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemId       = 0xBBBB;
+      EntryCount ++;
+      mSsidTablePtr[EntryCount].Address.Bits.Device   = HdaDevNumber ();
+      mSsidTablePtr[EntryCount].Address.Bits.Function = HdaFuncNumber ();
+      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemVendorId = 0xCCCC;
+      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemId       = 0xDDDD;
+      EntryCount ++;
+      ASSERT (EntryCount < SI_MAX_DEVICE_COUNT);
+      SiPolicy->NumberOfSsidTableEntry = EntryCount;
+    }
+  **/
+  UINT32 *SsidTablePtr;
+  /**
+    Number of valid enties in SsidTablePtr.
+    This is valid when SkipSsidProgramming is FALSE;
+    <b>Default is 0.</b>
+  **/
+  UINT16 NumberOfSsidTableEntry;
+  UINT8  RsvdBytes1[2];
+  /**
+    If Trace Hub is enabled and trace to memory is desired, Platform code or BootLoader needs to allocate trace hub memory
+    as reserved, and save allocated memory base to TraceHubMemBase to ensure Trace Hub memory is configured properly.
+    To get total trace hub memory size please refer to TraceHubCalculateTotalBufferSize ()
+
+    Noted: If EDKII memory service is used to allocate memory, it will require double memory size to support size-aligned memory allocation,
+    so Platform code or FSP Wrapper code should ensure enough memory available for size-aligned TraceHub memory allocation.
+  **/
+  UINT32 TraceHubMemBase;        // Offset 58
+  /**
+    This is used to skip setting BIOS_DONE MSR during firmware update boot mode.
+    When set to TRUE and boot mode is BOOT_ON_FLASH_UPDATE,
+    skip setting BIOS_DONE MSR at EndofPei.
+    <b>0: FALSE</b>, 1: TRUE
+  **/
+  UINT8  SkipBiosDoneWhenFwUpdate;
+  UINT8  RsvdBytes2[3];
+} SI_CONFIG;
+
+#pragma pack (pop)
+
+#define DEFAULT_SSVID        0x8086
+#define DEFAULT_SSDID        0x7270
+#define SI_MAX_DEVICE_COUNT  70
+
+///
+/// Subsystem Vendor ID / Subsystem ID
+///
+typedef struct {
+  UINT16         SubSystemVendorId;
+  UINT16         SubSystemId;
+} SVID_SID_VALUE;
+
+//
+// Below is to match PCI_SEGMENT_LIB_ADDRESS () which can directly send to PciSegmentRead/Write functions.
+//
+typedef struct {
+  union {
+    struct {
+      UINT32  Register:12;
+      UINT32  Function:3;
+      UINT32  Device:5;
+      UINT32  Bus:8;
+      UINT32  Reserved1:4;
+      UINT32  Segment:16;
+      UINT32  Reserved2:16;
+    } Bits;
+    UINT64    SegBusDevFuncRegister;
+  } Address;
+  SVID_SID_VALUE SvidSidValue;
+  UINT32 Reserved;
+} SVID_SID_INIT_ENTRY;
+
+
+typedef struct {
+  UINT32  SkipBus;
+  UINT32  SkipDevice;
+  UINT32  SkipFunction;
+} SVID_SID_SKIP_TABLE;
+
+#endif // _SI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
new file mode 100644
index 0000000000..4bf014e9ba
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
@@ -0,0 +1,67 @@
+/** @file
+  Si Config Block PreMem
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_PREMEM_CONFIG_H_
+#define _SI_PREMEM_CONFIG_H_
+
+#define SI_PREMEM_CONFIG_REVISION  1
+
+extern EFI_GUID gSiPreMemConfigGuid;
+
+typedef enum {
+  ProbeTypeDisabled    = 0x00,
+  ProbeTypeDciOob      = 0x02,
+  ProbeTypeUsb3Dbc     = 0x03,
+  ProbeTypeXdp3        = 0x04,
+  ProbeTypeUsb2Dbc     = 0x05,
+  ProbeType2WireDciOob = 0x06,
+  ProbeTypeManual      = 0x07,
+  ProbeTypeMax
+} PLATFORM_DEBUG_CONSENT_PROBE_TYPE;
+
+#pragma pack (push,1)
+/**
+  The Silicon PreMem Policy allows the platform code to publish a set of configuration
+  information that the RC drivers will use to configure the silicon hardware.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;  ///< Offset 0 - 27 Config Block Header
+  /**
+    Platform Debug Consent
+    As a master switch to enable platform debug capability and relevant settings with specified probe type.
+    Manual: Do not use Platform Debug Consent to override other debug-relevant policies, but the user must set each debug option manually, aimed at advanced users.
+
+    PDC-dependent policies are listed:
+    DciPreMemConfig->DciEn
+    DciPreMemConfig->DciDbcMode
+    CpuTraceHubConfig->EnableMode
+    CpuTraceHubConfig->CpuTraceHubMemReg0Size
+    CpuTraceHubConfig->CpuTraceHubMemReg1Size
+    PchTraceHubPreMemConfig->EnableMode
+    PchTraceHubPreMemConfig->MemReg0Size
+    PchTraceHubPreMemConfig->MemReg1Size
+
+    Note: DCI OOB (aka BSSB) uses CCA probe.
+    Refer to definition of PLATFORM_DEBUG_CONSENT_PROBE_TYPE
+    <b>0:Disabled</b>; 2:DCI OOB; 3:USB3 DbC; 4:XDP3/MIPI60 5:USB2 DbC; 6:2-wire DCI OOB; 7:Manual
+  **/
+  UINT32    PlatformDebugConsent  :  4;
+  UINT32    RsvdBits              : 28;
+  /**
+    This is used to skip override boot mode during firmware update boot mode.
+    When set to TRUE and boot mode is BOOT_ON_FLASH_UPDATE,
+    skip setting boot mode to BOOT_WITH_FULL_CONFIGURATION in PEI memory init.
+    <b>0: FALSE</b>, 1: TRUE
+  **/
+  UINT8     SkipOverrideBootModeWhenFwUpdate;
+  UINT8     RsvdBytes[3];
+} SI_PREMEM_CONFIG;
+
+#pragma pack (pop)
+#endif // _SI_PREMEM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig.h
new file mode 100644
index 0000000000..36f96a4f32
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig.h
@@ -0,0 +1,50 @@
+/** @file
+  Smbus policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SMBUS_CONFIG_H_
+#define _SMBUS_CONFIG_H_
+
+#define SMBUS_PREMEM_CONFIG_REVISION 1
+extern EFI_GUID gSmbusPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+#define PCH_MAX_SMBUS_RESERVED_ADDRESS 128
+
+///
+/// The SMBUS_CONFIG block lists the reserved addresses for non-ARP capable devices in the platform.
+///
+typedef struct {
+  /**
+    Revision 1: Init version
+  **/
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  /**
+    This member describes whether or not the SMBus controller of PCH should be enabled.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32  Enable             :  1;
+  UINT32  ArpEnable          :  1;      ///< Enable SMBus ARP support, <b>0: Disable</b>; 1: Enable.
+  UINT32  DynamicPowerGating :  1;      ///< <b>(Test)</b> <b>Disable</b> or Enable Smbus dynamic power gating.
+  ///
+  /// <b>(Test)</b> SPD Write Disable, 0: leave SPD Write Disable bit; <b>1: set SPD Write Disable bit.</b>
+  /// For security recommendations, SPD write disable bit must be set.
+  ///
+  UINT32  SpdWriteDisable    :  1;
+  UINT32  SmbAlertEnable     :  1;      ///< Enable SMBus Alert pin (SMBALERT#). 0: <b>Disabled<b>, 1: Enabled.
+  UINT32  RsvdBits0          : 27;      ///< Reserved bits
+  UINT16  SmbusIoBase;                  ///< SMBUS Base Address (IO space). Default is <b>0xEFA0</b>.
+  UINT8   Rsvd0;                        ///< Reserved bytes
+  UINT8   NumRsvdSmbusAddresses;        ///< The number of elements in the RsvdSmbusAddressTable.
+  /**
+    Array of addresses reserved for non-ARP-capable SMBus devices.
+  **/
+  UINT8   RsvdSmbusAddressTable[PCH_MAX_SMBUS_RESERVED_ADDRESS];
+} PCH_SMBUS_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SMBUS_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
new file mode 100644
index 0000000000..f3e52ff453
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
@@ -0,0 +1,43 @@
+/** @file
+  PCH SPI Flash Controller config block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SPI_CONFIG_H_
+#define _SPI_CONFIG_H_
+
+#define SPI_CONFIG_REVISION 1
+extern EFI_GUID gSpiConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  Basic configuration for option features of PCH SPI Flash controller
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
+  /**
+    Enable extended BIOS Direct Read Region feature
+    Enabling this will make all memory accesses in a decode range to be translated
+    to BIOS region reads from SPI flash
+    <b>0: Disabled</b>, 1: Enabled
+  **/
+  UINT32    ExtendedBiosDecodeRangeEnable   :  1;
+  UINT32    RsvdBits0                       : 31;       ///< Reserved bits
+  /**
+    Base address that will be used for Extended Decode Range.
+    This will be ignored when ExtendedBiosDecodeRangeEnable is set to 0.
+  **/
+  UINT32    ExtendedBiosDecodeRangeBase;
+  /**
+    Limit address that will be used for Extended Decode Range.
+    This will be ignored when ExtendedBiosDecodeRangeEnable is set to 0.
+  **/
+  UINT32    ExtendedBiosDecodeRangeLimit;
+} SPI_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SPI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
new file mode 100644
index 0000000000..53af4ccd45
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
@@ -0,0 +1,145 @@
+/** @file
+  TCSS PEI policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _TCSS_PEI_CONFIG_H_
+#define _TCSS_PEI_CONFIG_H_
+
+#include <ConfigBlock.h>
+#include <UsbConfig.h>
+#include <TcssInfo.h>
+
+#define TCSS_PEI_CONFIG_REVISION 2
+extern EFI_GUID gTcssPeiConfigGuid;
+
+#pragma pack (push,1)
+
+
+#define MAX_IOM_AUX_BIAS_COUNT 4
+
+///
+/// The IOM_AUX_ORI_PAD_CONFIG describes IOM TypeC port map GPIO pin.
+/// Those GPIO setting for DP Aux Orientation Bias Control when the TypeC port didn't have re-timer.
+/// IOM needs know Pull-Up and Pull-Down pin for Bias control
+///
+typedef struct {
+  UINT32     GpioPullN; ///< GPIO Pull Up Ping number that is for IOM indecate the pull up pin from TypeC port.
+  UINT32     GpioPullP; ///< GPIO Pull Down Ping number that is for IOM indecate the pull down pin from TypeC port.
+} IOM_AUX_ORI_PAD_CONFIG;
+
+///
+/// The IOM_EC_INTERFACE_CONFIG block describes interaction between BIOS and IOM-EC.
+///
+
+typedef struct {
+  UINT32     VccSt;         ///< IOM VCCST request. (Not equal to actual VCCST value)
+  UINT32     UsbOverride;   ///< IOM to override USB connection.
+  UINT32     D3ColdEnable;  ///< Enable/disable D3 Cold support in TCSS
+  UINT32     D3HotEnable;   ///< Enable/disable D3 Hot support in TCSS
+} IOM_INTERFACE_CONFIG;
+
+///
+/// The PMC_INTERFACE_CONFIG block describes interaction between BIOS and PMC
+///
+typedef struct {
+  UINT8      PmcPdEnable;    ///< PMC PD Solution Enable
+  UINT8      Rsvd[3];
+} PMC_INTERFACE_CONFIG;
+
+///
+/// The SA XDCI INT Pin and IRQ number
+///
+typedef struct {
+  UINT8      IntPing;  ///< Int Pin Number
+  UINT8      Irq;      ///< Irq Number
+  UINT16     Rsvd;
+} SA_XDCI_IRQ_INT_CONFIG;
+
+///
+/// The TCSS_PCIE_PORT_POLICY block describes PCIe settings for TCSS.
+///
+typedef struct {
+  UINT8   AcsEnabled;                         ///< Indicate whether the ACS is enabled. 0: Disable; <b>1: Enable</b>.
+  UINT8   DpcEnabled;                         ///< Downstream Port Containment. 0: Disable; <b>1: Enable</b>
+  UINT8   RpDpcExtensionsEnabled;             ///< RP Extensions for Downstream Port Containment. 0: Disable; <b>1: Enable</b>
+  UINT8   LtrEnable;                          ///< Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+  UINT8   PtmEnabled;                         ///< Enables PTM capability
+
+  UINT8   Aspm;                               ///< The ASPM configuration of the root port (see: PCH_PCIE_ASPM_CONTROL). Default is <b>
+  UINT8   SlotNumber;                         ///< Indicates the slot number for the root port. Default is the value as root port index.
+  UINT8   SlotPowerLimitScale;                ///< <b>(Test)</b> Specifies scale used for slot power limit value. Leave as 0 to set to default. Default is <b>zero</b>.
+  UINT16  SlotPowerLimitValue;                ///< <b>(Test)</b> Specifies upper limit on power supplies by slot. Leave as 0 to set to default. Default is <b>zero</b>.
+
+  UINT8   AdvancedErrorReporting;             ///< Indicate whether the Advanced Error Reporting is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   UnsupportedRequestReport;           ///< Indicate whether the Unsupported Request Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   FatalErrorReport;                   ///< Indicate whether the Fatal Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   NoFatalErrorReport;                 ///< Indicate whether the No Fatal Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   CorrectableErrorReport;             ///< Indicate whether the Correctable Error Report is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   SystemErrorOnFatalError;            ///< Indicate whether the System Error on Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   SystemErrorOnNonFatalError;         ///< Indicate whether the System Error on Non Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
+  UINT8   SystemErrorOnCorrectableError;      ///< Indicate whether the System Error on Correctable Error is enabled. <b>0: Disable</b>; 1: Enable.
+
+  UINT16  LtrMaxSnoopLatency;                 ///< Latency Tolerance Reporting, Max Snoop Latency.
+  UINT16  LtrMaxNoSnoopLatency;               ///< Latency Tolerance Reporting, Max Non-Snoop Latency.
+  UINT8   SnoopLatencyOverrideMode;           ///< Latency Tolerance Reporting, Snoop Latency Override Mode.
+  UINT8   SnoopLatencyOverrideMultiplier;     ///< Latency Tolerance Reporting, Snoop Latency Override Multiplier.
+  UINT16  SnoopLatencyOverrideValue;          ///< Latency Tolerance Reporting, Snoop Latency Override Value.
+  UINT8   NonSnoopLatencyOverrideMode;        ///< Latency Tolerance Reporting, Non-Snoop Latency Override Mode.
+  UINT8   NonSnoopLatencyOverrideMultiplier;  ///< Latency Tolerance Reporting, Non-Snoop Latency Override Multiplier.
+  UINT16  NonSnoopLatencyOverrideValue;       ///< Latency Tolerance Reporting, Non-Snoop Latency Override Value.
+  UINT8   ForceLtrOverride;                   ///< <b>0: Disable</b>; 1: Enable.
+  UINT8   LtrConfigLock;                      ///< <b>0: Disable</b>; 1: Enable.
+} TCSS_PCIE_PORT_POLICY;
+
+///
+/// TCSS_PCIE_PEI_POLICY describes PCIe port settings for TCSS.
+///
+typedef struct {
+  TCSS_PCIE_PORT_POLICY  PciePortPolicy[MAX_ITBT_PCIE_PORT];
+} TCSS_PCIE_PEI_POLICY;
+
+///
+/// The TCSS_IOM_PEI_CONFIG block describes IOM Aux/HSL override settings for TCSS.
+///
+typedef struct {
+  UINT16    AuxOri;     ///< Bits defining value for IOM Aux Orientation Register
+  UINT16    HslOri;     ///< Bits defining value for IOM HSL Orientation Register
+} TCSS_IOM_ORI_OVERRIDE;
+
+///
+/// The TCSS_IOM_PEI_CONFIG block describes IOM settings for TCSS.
+///
+typedef struct {
+  IOM_AUX_ORI_PAD_CONFIG    IomAuxPortPad[MAX_IOM_AUX_BIAS_COUNT]; ///< The IOM_AUX_ORI_BIAS_CTRL port config setting.
+  TCSS_IOM_ORI_OVERRIDE     IomOverrides;
+  IOM_INTERFACE_CONFIG      IomInterface;                          ///< Config settings are BIOS <-> IOM interface.
+  PMC_INTERFACE_CONFIG      PmcInterface;                          ///< Config settings for BIOS <-> PMC interface
+  UINT8                     TcStateLimit;                          ///< Tcss C-State deep stage
+  UINT8                     Usb3ComplModeEnable;
+  UINT8                     Reserved[2];                           ///< Reserved bytes for future use
+} TCSS_IOM_PEI_CONFIG;
+
+///
+/// The TCSS_MISC_PEI_CONFIG block describes MISC settings for TCSS.
+///
+typedef struct {
+  SA_XDCI_IRQ_INT_CONFIG    SaXdci;   ///< System Agent Xdci Int Pin and Irq setting
+  UINT32                    Rsvd;     ///< Reserved bytes for future use, align to multiple 4
+} TCSS_MISC_PEI_CONFIG;
+
+///
+/// The TCSS_PEI_CONFIG block describes TCSS settings for SA.
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER     Header;     ///< Offset 0-27 Config Block Header
+  TCSS_PCIE_PEI_POLICY    PciePolicy; ///< The PCIe Config
+  USB_CONFIG              UsbConfig;  ///< USB config is shared between PCH and SA.
+  TCSS_IOM_PEI_CONFIG     IomConfig;  ///< The Iom Config
+  TCSS_MISC_PEI_CONFIG    MiscConfig; ///< The MISC Config
+} TCSS_PEI_CONFIG;
+
+#pragma pack (pop)
+
+#endif /* _TCSS_PEI_CONFIG_H_ */
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
new file mode 100644
index 0000000000..23c3750216
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
@@ -0,0 +1,73 @@
+/** @file
+  Touch Host Controller policy.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _THC_CONFIG_H_
+#define _THC_CONFIG_H_
+
+#define THC_CONFIG_REVISION 1
+extern EFI_GUID gThcConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  Available Port Assignments
+
+**/
+typedef enum {
+  ThcAssignmentNone, ///< None of the avaialbe controllers assigned
+  ThcAssignmentThc0, ///< Port assigned to THC0
+  ThcAssignmentThc1  ///< Port assigned to THC1
+} THC_PORT_ASSIGNMENT;
+
+
+/**
+  Port Configuration structure required for each Port that THC might use.
+
+**/
+typedef struct {
+  UINT32 Assignment;         ///< Sets THCx assignment see THC_PORT_ASSIGNMENT
+  UINT32 InterruptPinMuxing; ///< Each GPIO PORTx/SPIx INTB Pin has different muxing options refer to GPIO_*_MUXING_THC_SPIx_*
+} THC_PORT;
+
+/**
+  THC_CONFIG block provides the configurations forTouch Host Controllers
+
+  Assignment field in each THC port controlls the THC behavior.
+
+  Available scenarios:
+  1: Single Port 0 used by THC0
+      - THC0 Enabled
+      - Port0 assigned to THC0
+      - Port1 unassigned
+      - THC1 will be automatically Disabled.
+  2: Both ports used by THC0
+      - THC0 Enabled
+      - Port0 assigned to THC0
+      - Port1 assigned to THC0
+      - THC1 will be automatically Disabled.
+  3: Port 0 used by THC0 and Port 1 used by THC1
+      - THC0 Enabled
+      - Port0 assigned to THC0
+      - THC1 Enabled
+      - Port1 assigned to THC1.
+<b>4: Both Ports unassigned.</b>
+      Both THC Controllers will be disabled in that case.
+
+  @note
+  Invalid scenario that will cause ASSERT.
+  1. Same port Number assigned to THC0 or THC1.
+  2. Two Ports assigned to THC1.
+
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
+  THC_PORT             ThcPort[2];       ///< Port Configuration
+} THC_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _THC_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalConfig.h
new file mode 100644
index 0000000000..a952f74238
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalConfig.h
@@ -0,0 +1,153 @@
+/** @file
+  Thermal policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _THERMAL_CONFIG_H_
+#define _THERMAL_CONFIG_H_
+
+#define THERMAL_CONFIG_REVISION 1
+extern EFI_GUID gThermalConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure lists PCH supported throttling register setting for custimization.
+  When the SuggestedSetting is enabled, the customized values are ignored.
+**/
+typedef struct {
+  UINT32 T0Level                  :  9; ///< Custimized T0Level value. If SuggestedSetting is used, this setting is ignored.
+  UINT32 T1Level                  :  9; ///< Custimized T1Level value. If SuggestedSetting is used, this setting is ignored.
+  UINT32 T2Level                  :  9; ///< Custimized T2Level value. If SuggestedSetting is used, this setting is ignored.
+  UINT32 TTEnable                 :  1; ///< Enable the thermal throttle function. If SuggestedSetting is used, this settings is ignored.
+  /**
+    When set to 1 and the programmed GPIO pin is a 1, then PMSync state 13 will force at least T2 state.
+    If SuggestedSetting is used, this setting is ignored.
+  **/
+  UINT32 TTState13Enable          :  1;
+  /**
+    When set to 1, this entire register (TL) is locked and remains locked until the next platform reset.
+    If SuggestedSetting is used, this setting is ignored.
+  **/
+  UINT32 TTLock                   :  1;
+  UINT32 SuggestedSetting         :  1; ///< 0: Disable; <b>1: Enable</b> suggested representative values.
+  /**
+    ULT processors support thermal management and cross thermal throttling between the processor package
+    and LP PCH. The PMSYNC message from PCH to CPU includes specific bit fields to update the PCH
+    thermal status to the processor which is factored into the processor throttling.
+    Enable/Disable PCH Cross Throttling; 0: Disabled, 1: <b>Enabled</b>.
+  **/
+  UINT32 PchCrossThrottling       :  1;
+  UINT32 Rsvd0;                      ///< Reserved bytes
+} THERMAL_THROTTLE_LEVELS;
+
+//
+// Supported Thermal Sensor Target Width
+//
+typedef enum {
+  DmiThermSensWidthX1  = 0,
+  DmiThermSensWidthX2  = 1,
+  DmiThermSensWidthX4  = 2,
+  DmiThermSensWidthX8  = 3,
+  DmiThermSensWidthX16 = 4
+} DMI_THERMAL_SENSOR_TARGET_WIDTH;
+
+/**
+  This structure allows to customize DMI HW Autonomous Width Control for Thermal and Mechanical spec design.
+  When the SuggestedSetting is enabled, the customized values are ignored.
+  Look at DMI_THERMAL_SENSOR_TARGET_WIDTH for possible values
+**/
+typedef struct {
+  UINT32  DmiTsawEn               :  1; ///< DMI Thermal Sensor Autonomous Width Enable
+  UINT32  SuggestedSetting        :  1; ///< 0: Disable; <b>1: Enable</b> suggested representative values
+  UINT32  RsvdBits0               :  6; ///< Reserved bits
+  UINT32  TS0TW                   :  3; ///< Thermal Sensor 0 Target Width (<b>DmiThermSensWidthx8</b>)
+  UINT32  TS1TW                   :  3; ///< Thermal Sensor 1 Target Width (<b>DmiThermSensWidthx4</b>)
+  UINT32  TS2TW                   :  3; ///< Thermal Sensor 2 Target Width (<b>DmiThermSensWidthx2</b>)
+  UINT32  TS3TW                   :  3; ///< Thermal Sensor 3 Target Width (<b>DmiThermSensWidthx1</b>)
+  UINT32  RsvdBits1               : 12; ///< Reserved bits
+} DMI_HW_WIDTH_CONTROL;
+
+/**
+  This structure configures PCH memory throttling thermal sensor GPIO PIN settings
+**/
+typedef struct {
+  /**
+    GPIO PM_SYNC enable, 0:Diabled, 1:<b>Enabled</b>
+    When enabled, RC will overrides the selected GPIO native mode.
+    For GPIO_C, PinSelection 0: CPU_GP_0 (default) or 1: CPU_GP_1
+    For GPIO_D, PinSelection 0: CPU_GP_3 (default) or 1: CPU_GP_2
+    For CNL: CPU_GP_0 is GPP_E3, CPU_GP_1 is GPP_E7, CPU_GP_2 is GPP_B3, CPU_GP_3 is GPP_B4.
+  **/
+  UINT32  PmsyncEnable     :  1;
+  UINT32  C0TransmitEnable :  1;        ///< GPIO Transmit enable in C0 state, 0:Disabled, 1:<b>Enabled</b>
+  UINT32  PinSelection     :  1;        ///< GPIO Pin assignment selection, <b>0: default</b>, 1: secondary
+  UINT32  RsvdBits0        : 29;
+} TS_GPIO_PIN_SETTING;
+
+enum PCH_PMSYNC_GPIO_X_SELECTION {
+  TsGpioC,
+  TsGpioD,
+  MaxTsGpioPin
+};
+
+/**
+  This structure supports an external memory thermal sensor (TS-on-DIMM or TS-on-Board).
+**/
+typedef struct {
+  /**
+   This will enable PCH memory throttling.
+   While this policy is enabled, must also enable EnableExtts in SA policy.
+   <b>0: Disable</b>; 1: Enable
+  **/
+  UINT32   Enable           :  1;
+  UINT32   RsvdBits0        : 31;
+  /**
+    GPIO_C and GPIO_D selection for memory throttling.
+    It's strongly recommended to choose GPIO_C and GPIO_D for memory throttling feature,
+    and route EXTTS# accordingly.
+  **/
+  TS_GPIO_PIN_SETTING     TsGpioPinSetting[2];
+} PCH_MEMORY_THROTTLING;
+
+/**
+  The THERMAL_CONFIG block describes the expected configuration of the Thermal IP block.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  UINT32  PchHotEnable            :  1; ///< Enable PCHHOT# pin assertion when temperature is higher than PchHotLevel. 0: <b>Disabled<b>, 1: Enabled.
+  UINT32  RsvdBits0               : 31;
+  /**
+    This field decides the settings of Thermal throttling. When the Suggested Setting
+    is enabled, PCH RC will use the suggested representative values.
+  **/
+  THERMAL_THROTTLE_LEVELS   TTLevels;
+  /**
+    This field decides the settings of DMI throttling. When the Suggested Setting
+    is enabled, PCH RC will use the suggested representative values.
+  **/
+  DMI_HW_WIDTH_CONTROL      DmiHaAWC;
+  /**
+    Memory Thermal Management settings
+  **/
+  PCH_MEMORY_THROTTLING     MemoryThrottling;
+  /**
+    The recommendation is the same as Cat Trip point.
+    This field decides the temperature, default is <b>120</b>.
+    Temperature value used for PCHHOT# pin assertion based on 2s complement format
+    - 0x001 positive 1'C
+    - 0x000 0'C
+    - 0x1FF negative 1'C
+    - 0x1D8 negative 40'C
+    - and so on
+  **/
+  UINT16                    PchHotLevel;
+  UINT8                     Rsvd0[6];
+
+
+} THERMAL_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _THERMAL_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubConfig.h
new file mode 100644
index 0000000000..9c315fb4a4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubConfig.h
@@ -0,0 +1,101 @@
+/** @file
+  Configurations for CPU and PCH trace hub
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _TRACE_HUB_CONFIG_H_
+#define _TRACE_HUB_CONFIG_H_
+
+#include <ConfigBlock.h>
+
+#define CPU_TRACEHUB_PREMEM_CONFIG_REVISION 1
+#define PCH_TRACEHUB_PREMEM_CONFIG_REVISION 1
+
+extern EFI_GUID gPchTraceHubPreMemConfigGuid;
+extern EFI_GUID gCpuTraceHubPreMemConfigGuid;
+
+typedef enum {
+  CpuTraceHub,
+  PchTraceHub
+} TRACE_HUB_DEVICE;
+///
+/// The TRACE_HUB_ENABLE_MODE describes TraceHub mode of operation
+///
+typedef enum {
+  TraceHubModeDisabled       = 0,
+  TraceHubModeTargetDebugger = 1,
+  TraceHubModeHostDebugger   = 2,
+  TraceHubModeMax
+} TRACE_HUB_ENABLE_MODE;
+
+///
+/// The TRACE_BUFFER_SIZE describes the desired TraceHub buffer size
+///
+typedef enum {
+  TraceBufferNone,
+  TraceBuffer1M,
+  TraceBuffer8M,
+  TraceBuffer64M,
+  TraceBuffer128M,
+  TraceBuffer256M,
+  TraceBuffer512M,
+  TraceBufferMax
+} TRACE_BUFFER_SIZE;
+
+#pragma pack (push,1)
+///
+/// TRACE_HUB_CONFIG block describes TraceHub settings
+///
+typedef struct {
+  /**
+  Trace hub mode. Default is disabled.
+  Target Debugger mode refers to debug tool running on target device itself and it works as a conventional PCI device;
+  Host Debugger mode refers to SUT debugged via probe on host, configured as ACPI device with PCI configuration sapce hidden.
+  <b>0 = Disable</b>; 1 = Target Debugger mode; 2 = Host Debugger mode
+  Refer to TRACE_HUB_ENABLE_MODE
+  **/
+  UINT8                      EnableMode;
+  /**
+  Trace hub memory buffer region size policy.
+  The avaliable memory size options are: 0:0MB (none), 1:1MB, <b>2:8MB</b>, 3:64MB, 4:128MB, 5:256MB, 6:512MB.
+  Note : Limitation of total buffer size (CPU + PCH) is 512MB. If iTbt is enabled, the total size limits to 256 MB.
+  Refer to TRACE_BUFFER_SIZE
+  **/
+  UINT8                      MemReg0Size;
+  UINT8                      MemReg1Size;
+  /**
+  AET Trace. AET base address can be set to FW Base either from CPU trace hub or PCH one.
+  AetEnabled must be exclusive, if AetEnabled = 1 for CPU trace hub, must AetEnabled = 0 for PCH one.
+  The default is set to PCH.
+  CPU Trace Hub
+  <b>0 = Disabled</b>; 1 = Enabled
+  PCH Trace Hub
+  0 = Disabled; <b>1 = Enabled</b>
+  **/
+  UINT8                      AetEnabled;
+} TRACE_HUB_CONFIG;
+
+/**
+  CPU Trace Hub PreMem Configuration
+  Contains Trace Hub settings for CPU side tracing
+  <b>Revision 1</b>:  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER        Header;           ///< Config Block Header
+  TRACE_HUB_CONFIG           TraceHub;         ///< Trace Hub Config
+} CPU_TRACE_HUB_PREMEM_CONFIG;
+
+/**
+  PCH Trace Hub PreMem Configuration
+  Contains Trace Hub settings for PCH side tracing
+  <b>Revision 1</b>:  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER        Header;           ///< Config Block Header
+  TRACE_HUB_CONFIG           TraceHub;         ///< Trace Hub Config
+} PCH_TRACE_HUB_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.h
new file mode 100644
index 0000000000..99063103c3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.h
@@ -0,0 +1,81 @@
+/** @file
+  USB2 PHY configuration policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _USB2_PHY_CONFIG_H_
+#define _USB2_PHY_CONFIG_H_
+
+#include <UsbConfig.h>
+
+#define USB2_PHY_CONFIG_REVISION 1
+extern EFI_GUID gUsb2PhyConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure configures per USB2 AFE settings.
+  It allows to setup the port electrical parameters.
+**/
+typedef struct {
+/** Per Port HS Preemphasis Bias (PERPORTPETXISET)
+  000b - 0mV
+  001b - 11.25mV
+  010b - 16.9mV
+  011b - 28.15mV
+  100b - 28.15mV
+  101b - 39.35mV
+  110b - 45mV
+  111b - 56.3mV
+**/
+  UINT8   Petxiset;
+/** Per Port HS Transmitter Bias (PERPORTTXISET)
+  000b - 0mV
+  001b - 11.25mV
+  010b - 16.9mV
+  011b - 28.15mV
+  100b - 28.15mV
+  101b - 39.35mV
+  110b - 45mV
+  111b - 56.3mV
+**/
+  UINT8   Txiset;
+/**
+  Per Port HS Transmitter Emphasis (IUSBTXEMPHASISEN)
+  00b - Emphasis OFF
+  01b - De-emphasis ON
+  10b - Pre-emphasis ON
+  11b - Pre-emphasis & De-emphasis ON
+**/
+  UINT8   Predeemp;
+/**
+  Per Port Half Bit Pre-emphasis (PERPORTTXPEHALF)
+  1b - half-bit pre-emphasis
+  0b - full-bit pre-emphasis
+**/
+  UINT8   Pehalfbit;
+} USB2_PHY_PARAMETERS;
+
+/**
+  This structure holds info on how to tune electrical parameters of USB2 ports based on board layout
+
+  <b>Revision 1</b>:
+  - Initial version.
+
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
+  /**
+    This structure configures per USB2 port physical settings.
+    It allows to setup the port location and port length, and configures the port strength accordingly.
+    Changing this policy values from default ones may require disabling USB2 PHY Sus Well Power Gating
+    through Usb2PhySusPgEnable on PCH-LP
+  **/
+  USB2_PHY_PARAMETERS          Port[MAX_USB2_PORTS];
+} USB2_PHY_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _USB2_PHY_CONFIG_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.h
new file mode 100644
index 0000000000..da816b1378
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.h
@@ -0,0 +1,138 @@
+/** @file
+  USB3 Mod PHY configuration policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _USB3_HSIO_CONFIG_H_
+#define _USB3_HSIO_CONFIG_H_
+
+#include <UsbConfig.h>
+
+#define USB3_HSIO_CONFIG_REVISION 2
+extern EFI_GUID gUsb3HsioConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure describes USB3 Port N configuration parameters
+**/
+typedef struct {
+  /**
+    USB 3.0 TX Output Downscale Amplitude Adjustment (orate01margin)
+    HSIO_TX_DWORD8[21:16]
+    <b>Default = 00h</b>
+  **/
+  UINT8  HsioTxDownscaleAmp;
+  /**
+    USB 3.0 TX Output -3.5dB De-Emphasis Adjustment Setting (ow2tapgen2deemph3p5)
+    HSIO_TX_DWORD5[21:16]
+    <b>Default = 29h</b> (approximately -3.5dB De-Emphasis)
+  **/
+  UINT8  HsioTxDeEmph;
+  /**
+    Signed Magnatude number added to the CTLE code.(ctle_adapt_offset_cfg_4_0)
+    HSIO_RX_DWORD25 [20:16]
+    Ex: -1 -- 1_0001. +1: 0_0001
+    <b>Default = 0h</b>
+  **/
+  UINT8  HsioCtrlAdaptOffsetCfg;
+  /**
+    LFPS filter select for n (filter_sel_n_2_0)
+    HSIO_RX_DWORD51 [29:27]
+    0h:1.6ns
+    1h:2.4ns
+    2h:3.2ns
+    3h:4.0ns
+    4h:4.8ns
+    5h:5.6ns
+    6h:6.4ns
+    <b>Default = 0h</b>
+  **/
+  UINT8  HsioFilterSelN;
+  /**
+    LFPS filter select for p (filter_sel_p_2_0)
+    HSIO_RX_DWORD51 [26:24]
+    0h:1.6ns
+    1h:2.4ns
+    2h:3.2ns
+    3h:4.0ns
+    4h:4.8ns
+    5h:5.6ns
+    6h:6.4ns
+    <b>Default = 0h</b>
+  **/
+  UINT8  HsioFilterSelP;
+  /**
+    Controls the input offset (olfpscfgpullupdwnres_sus_usb_2_0)
+    HSIO_RX_DWORD51 [2:0]
+    000 Prohibited
+    001 45K
+    010 Prohibited
+    011 31K
+    100 36K
+    101 36K
+    110 36K
+    111 36K
+    <b>Default = 3h</b>
+  **/
+  UINT8  HsioOlfpsCfgPullUpDwnRes;
+
+  UINT8  HsioTxDeEmphEnable;             ///< Enable the write to USB 3.0 TX Output -3.5dB De-Emphasis Adjustment, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioTxDownscaleAmpEnable;       ///< Enable the write to USB 3.0 TX Output Downscale Amplitude Adjustment, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioCtrlAdaptOffsetCfgEnable;   ///< Enable the write to Signed Magnatude number added to the CTLE code, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioFilterSelNEnable;           ///< Enable the write to LFPS filter select for n, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioFilterSelPEnable;           ///< Enable the write to LFPS filter select for p, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioOlfpsCfgPullUpDwnResEnable; ///< Enable the write to olfpscfgpullupdwnres, <b>0: Disable</b>; 1: Enable.
+  /**
+    USB 3.0 TX Output - Unique Transition Bit Scale for rate 3 (rate3UniqTranScale)
+    HSIO_TX_DWORD9[6:0]
+    <b>Default = 4Ch</b>
+  **/
+  UINT8  HsioTxRate3UniqTran;
+  /**
+    USB 3.0 TX Output -Unique Transition Bit Scale for rate 2 (rate2UniqTranScale)
+    HSIO_TX_DWORD9[14:8]
+    <b>Default = 4Ch</b>
+  **/
+  UINT8  HsioTxRate2UniqTran;
+  /**
+    USB 3.0 TX Output - Unique Transition Bit Scale for rate 1 (rate1UniqTranScale)
+    HSIO_TX_DWORD9[22:16]
+    <b>Default = 4Ch</b>
+  **/
+  UINT8  HsioTxRate1UniqTran;
+  /**
+    USB 3.0 TX Output - Unique Transition Bit Scale for rate 0 (rate0UniqTranScale)
+    HSIO_TX_DWORD9[30:24]
+    <b>Default = 4Ch</b>
+  **/
+  UINT8  HsioTxRate0UniqTran;
+
+  UINT8  HsioTxRate3UniqTranEnable; ///< Enable the write to USB 3.0 TX Unique Transition Bit Mode for rate 3, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioTxRate2UniqTranEnable; ///< Enable the write to USB 3.0 TX Unique Transition Bit Mode for rate 2, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioTxRate1UniqTranEnable; ///< Enable the write to USB 3.0 TX Unique Transition Bit Mode for rate 1, <b>0: Disable</b>; 1: Enable.
+  UINT8  HsioTxRate0UniqTranEnable; ///< Enable the write to USB 3.0 TX Unique Transition Bit Mode for rate 0, <b>0: Disable</b>; 1: Enable.
+} HSIO_PARAMETERS;
+
+/**
+  Structure for holding USB3 tuning parameters
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - USB 3.0 TX Output Unique Transition Bit Scale policies added
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
+  /**
+    These members describe whether the USB3 Port N of PCH is enabled by platform modules.
+  **/
+  HSIO_PARAMETERS         Port[MAX_USB3_PORTS];
+} USB3_HSIO_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _USB3_HSIO_CONFIG_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
new file mode 100644
index 0000000000..a1c7f0bb04
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
@@ -0,0 +1,149 @@
+/** @file
+  Common USB policy shared between PCH and CPU
+  Contains general features settings for xHCI and xDCI
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _USB_CONFIG_H_
+#define _USB_CONFIG_H_
+
+#define USB_CONFIG_REVISION 2
+extern EFI_GUID gUsbConfigGuid;
+
+#define MAX_USB2_PORTS  16
+#define MAX_USB3_PORTS  10
+
+#pragma pack (push,1)
+
+typedef UINT8                   USB_OVERCURRENT_PIN;
+#define USB_OC_SKIP             0xFF
+#define USB_OC_MAX_PINS         16       ///< Total OC pins number (both physical and virtual)
+
+/**
+  This structure configures per USB2.0 port settings like enabling and overcurrent protection
+**/
+typedef struct {
+  /**
+    These members describe the specific over current pin number of USB 2.0 Port N.
+    It is SW's responsibility to ensure that a given port's bit map is set only for
+    one OC pin Description. USB2 and USB3 on the same combo Port must use the same OC pin.
+  **/
+  UINT32     OverCurrentPin          :  8;
+  UINT32     Enable                  :  1;     ///< 0: Disable; <b>1: Enable</b>.
+  UINT32     PortResetMessageEnable  :  1;     ///< 0: Disable USB2 Port Reset Message; 1: Enable USB2 Port Reset Message
+  UINT32     RsvdBits0               : 22;     ///< Reserved bits
+} USB2_PORT_CONFIG;
+
+/**
+  This structure configures per USB3.x port settings like enabling and overcurrent protection
+**/
+typedef struct {
+  /**
+    These members describe the specific over current pin number of USB 3.x Port N.
+    It is SW's responsibility to ensure that a given port's bit map is set only for
+    one OC pin Description. USB2 and USB3 on the same combo Port must use the same OC pin.
+  **/
+  UINT32  OverCurrentPin               :  8;
+  UINT32  Enable                       :  1; ///< 0: Disable; <b>1: Enable</b>.
+  UINT32  RsvdBits0                    : 23; ///< Reserved bits
+} USB3_PORT_CONFIG;
+
+/**
+  The XDCI_CONFIG block describes the configurations
+  of the xDCI Usb Device controller.
+**/
+typedef struct {
+  /**
+    This member describes whether or not the xDCI controller should be enabled.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32  Enable              :  1;
+  UINT32  RsvdBits0           : 31;     ///< Reserved bits
+} XDCI_CONFIG;
+
+
+/**
+  This member describes the expected configuration of the USB controller,
+  Platform modules may need to refer Setup options, schematic, BIOS specification to update this field.
+  The Usb20OverCurrentPins and Usb30OverCurrentPins field must be updated by referring the schematic.
+
+  <b>Revision 1</b>: - Initial version.
+  <b>Revision 2</b>: - Add USB3LinkSpeed
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
+  /**
+    This policy option when set will make BIOS program Port Disable Override register during PEI phase.
+    When disabled BIOS will not program the PDO during PEI phase and leave PDO register unlocked for later programming.
+    If this is disabled, platform code MUST set it before booting into OS.
+    <b>1: Enable</b>
+    0: Disable
+  **/
+  UINT32                  PdoProgramming               :  1;
+  /**
+    This option allows for control whether USB should program the Overcurrent Pins mapping into xHCI.
+    Disabling this feature will disable overcurrent detection functionality.
+    Overcurrent Pin mapping data is contained in respective port structures (i.e. USB30_PORT_CONFIG) in OverCurrentPin field.
+    By default this Overcurrent functionality should be enabled and disabled only for OBS debug usage.
+    <b>1: Will program USB OC pin mapping in respective xHCI controller registers</b>
+    0: Will clear OC pin mapping allow for OBS usage of OC pins
+  **/
+  UINT32                  OverCurrentEnable            :  1;
+  /**
+    <b>(Test)</b>
+    If this policy option is enabled then BIOS will program OCCFDONE bit in xHCI meaning that OC mapping data will be
+    consumed by xHCI and OC mapping registers will be locked. OverCurrent mapping data is taken from respective port data
+    structure from OverCurrentPin field.
+    If EnableOverCurrent policy is enabled this also should be enabled, otherwise xHCI won't consume OC mapping data.
+    <b>1: Program OCCFDONE bit and make xHCI consume OverCurrent mapping data</b>
+    0: Do not program OCCFDONE bit making it possible to use OBS debug on OC pins.
+  **/
+  UINT32                  XhciOcLock                   :  1;
+  /**
+    Enabling this feature will allow for overriding LTR values for xHCI controller.
+    Values used for programming will be taken from this config block and BIOS will disregard recommended ones.
+    <b>0: disable - do not override recommended LTR values</b>
+    1: enable - override recommended LTR values
+  **/
+  UINT32                  LtrOverrideEnable            :  1;
+  /**
+    This setting enable LBPM GEN1 speed
+    0: GEN2;
+    1: GEN1;
+  **/
+  UINT32                  USB3LinkSpeed                : 1;
+  UINT32                  RsvdBits0                    : 27;     ///< Reserved bits
+  /**
+    High Idle Time Control override value
+    This setting is used only if LtrOverrideEnable is enabled
+  **/
+  UINT32                  LtrHighIdleTimeOverride;
+  /**
+    Medium Idle Time Control override value
+    This setting is used only if LtrOverrideEnable is enabled
+  **/
+  UINT32                  LtrMediumIdleTimeOverride;
+  /**
+    Low Idle Time Control override value
+    This setting is used only if LtrOverrideEnable is enabled
+  **/
+  UINT32                  LtrLowIdleTimeOverride;
+  /**
+    These members describe whether the USB2 Port N of PCH is enabled by platform modules.
+  **/
+  USB2_PORT_CONFIG        PortUsb20[MAX_USB2_PORTS];
+  /**
+    These members describe whether the USB3 Port N of PCH is enabled by platform modules.
+  **/
+  USB3_PORT_CONFIG        PortUsb30[MAX_USB3_PORTS];
+  /**
+    This member describes whether or not the xDCI controller should be enabled.
+  **/
+  XDCI_CONFIG             XdciConfig;
+
+} USB_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _USB_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h
new file mode 100644
index 0000000000..8b01ecd262
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h
@@ -0,0 +1,114 @@
+/** @file
+  CPU Power Management VR Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POWER_MGMT_VR_CONFIG_H_
+#define _CPU_POWER_MGMT_VR_CONFIG_H_
+
+#define CPU_POWER_MGMT_VR_CONFIG_REVISION 7
+
+extern EFI_GUID gCpuPowerMgmtVrConfigGuid;
+
+#pragma pack (push,1)
+
+///
+/// Defines the maximum number of VR domains supported.
+/// @warning: Changing this define would cause DWORD alignment issues in policy structures.
+///
+#define MAX_NUM_VRS         5
+
+/**
+  CPU Power Management VR Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Updated Acoustic Noise Mitigation.
+  <b>Revision 3</b>:
+  - Deprecate PsysOffset and added PsysOffset1 for Psys Offset Correction
+  <b>Revision 4</b>:
+  - Deprecate TdcTimeWindow and added TdcTimeWindow1 for TDC Time
+    Added Irms support.
+  <b>Revision 5</b>:
+  - Add RfiMitigation.
+  <b>Revision 6</b>:
+  - Added an option to Enable/Disable FIVR Spread Spectrum
+  <b>Revision 7</b>:
+  - Add Dynamic Periodicity Alteration (DPA) tuning feature
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  UINT32 AcousticNoiseMitigation        : 1;      ///< Enable or Disable Acoustic Noise Mitigation feature. <b>0: Disabled</b>; 1: Enabled
+  /**
+   VR specific mailbox commands.
+   <b>00b - no VR specific command sent.</b>
+   01b - A VR mailbox command specifically for the MPS IMPV8 VR will be sent.
+   10b - VR specific command sent for PS4 exit issue.
+   11b - Reserved.
+   **/
+  UINT32 SendVrMbxCmd                   : 2;
+  UINT32 EnableMinVoltageOverride       : 1;      ///< Enable or disable Minimum Voltage override for minimum voltage runtime and minimum voltage C8. <b>0: Disabled</b> 1: Enabled.
+  UINT32 RfiMitigation                  : 1;      ///< Enable or Disable RFI Mitigation. <b>0: Disable - DCM is the IO_N default</b>; 1: Enable - Enable IO_N DCM/CCM switching as RFI mitigation.
+  UINT32 RsvdBits                       : 27;     ///< Reserved for future use.
+  UINT8  PsysSlope;                               ///< PCODE MMIO Mailbox: Platform Psys slope correction. <b>0: Auto</b> Specified in 1/100 increment values. Range is 0-200. 125 = 1.25.
+  UINT8  PsysOffset;                              ///< PCODE MMIO Mailbox: Platform Psys offset correction. <b>0: Auto</b> Units 1/4, Range 0-255. Value of 100 = 100/4 = 25 offset. Deprecated
+  UINT8  FivrSpreadSpectrum;                      ///< Set the Spread Spectrum Range. <b>1.5%</b>, Range: 0.5%, 1%, 1.5%, 2%, 3%, 4%, 5%, 6%. Each Range is translated to internally encoded values. 0.5% = 0, 1% = 3, 1.5% = 8, 2% = 18, 3% = 28, 4% = 34, 5% = 39, 6% = 44.
+  UINT8  RsvdBytes0;
+  /**
+   PCODE MMIO Mailbox: Set the desired RFI frequency, in increments of 100KHz.
+   <b>0: Auto</b>
+   Range varies based on XTAL clock:
+    - 0-1918 (Up to 191.8HMz) for 24MHz clock.
+    - 0-1535 (Up to 153.5MHz) for 19MHz clock.
+  **/
+  UINT16 FivrRfiFrequency;
+  UINT8  RsvdBytes1[2];
+  /** @name VR Settings
+  The VR related settings are sorted in an array where each index maps to the VR domain as defined below:
+   - 0 = System Agent VR
+   - 1 = IA Core VR
+   - 2 = Ring Vr
+   - 3 = GT VR
+   - 4 = FIVR VR
+
+  The VR settings for a given domain must be populated in the appropriate index.
+  **/
+  ///@{
+  UINT16 TdcCurrentLimit[MAX_NUM_VRS];            ///< PCODE MMIO Mailbox: Thermal Design Current current limit. Specified in 1/8A units. Range is 0-4095. 1000 = 125A. <b>0: 0 Amps</b>
+  UINT16 AcLoadline[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox: AcLoadline in 1/100 mOhms (ie. 1250 = 12.50 mOhm); Range is 0-6249. <b>Intel Recommended Defaults vary by domain and SKU.</b>
+  UINT16 DcLoadline[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox: DcLoadline in 1/100 mOhms (ie. 1250 = 12.50 mOhm); Range is 0-6249.<b>Intel Recommended Defaults vary by domain and SKU.</b>
+  UINT16 Psi1Threshold[MAX_NUM_VRS];              ///< PCODE MMIO Mailbox: Power State 1 current cuttof in 1/4 Amp increments. Range is 0-128A.
+  UINT16 Psi2Threshold[MAX_NUM_VRS];              ///< PCODE MMIO Mailbox: Power State 2 current cuttof in 1/4 Amp increments. Range is 0-128A.
+  UINT16 Psi3Threshold[MAX_NUM_VRS];              ///< PCODE MMIO Mailbox: Power State 3 current cuttof in 1/4 Amp increments. Range is 0-128A.
+  INT16  ImonOffset[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox: Imon offset correction. Value is a 2's complement signed integer. Units 1/1000, Range 0-63999. For an offset = 12.580, use 12580. <b>0: Auto</b>
+  UINT16 IccMax[MAX_NUM_VRS];                     ///< PCODE MMIO Mailbox: VR Icc Max limit. 0-255A in 1/4 A units. 400 = 100A. <b>Default: 0 - Auto, no override</b>
+  UINT16 VrVoltageLimit[MAX_NUM_VRS];             ///< PCODE MMIO Mailbox: VR Voltage Limit. Range is 0-7999mV.
+  UINT16 ImonSlope[MAX_NUM_VRS];                  ///< PCODE MMIO Mailbox: Imon slope correction. Specified in 1/100 increment values. Range is 0-200. 125 = 1.25. <b>0: Auto</b>
+  UINT8  Psi3Enable[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox: Power State 3 enable/disable; 0: Disable; <b>1: Enable</b>.
+  UINT8  Psi4Enable[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox: Power State 4 enable/disable; 0: Disable; <b>1: Enable</b>.
+  UINT8  VrConfigEnable[MAX_NUM_VRS];             ///< Enable/Disable BIOS configuration of VR; 0: Disable; <b>1: Enable.</b>
+  UINT8  TdcEnable[MAX_NUM_VRS];                  ///< PCODE MMIO Mailbox: Thermal Design Current enable/disable; <b>0: Disable; </b>1: Enable
+  UINT8  TdcTimeWindow[MAX_NUM_VRS];              ///< @deprecated. PCODE MMIO Mailbox: Thermal Design Current time window. Defined in milli seconds. <b>1ms default</b>
+  UINT8  TdcLock[MAX_NUM_VRS];                    ///< PCODE MMIO Mailbox: Thermal Design Current Lock; <b>0: Disable</b>; 1: Enable.
+  UINT8  FastPkgCRampDisable[MAX_NUM_VRS];        ///< Disable Fast Slew Rate for Deep Package C States for VR IA,GT,SA,VLCC,FIVR domain based on Acoustic Noise Mitigation feature enabled. <b>0: False</b>; 1: True
+  UINT8  SlowSlewRate[MAX_NUM_VRS];               ///< Slew Rate configuration for Deep Package C States for VR VR IA,GT,SA,VLCC,FIVR domain based on Acoustic Noise Mitigation feature enabled. <b>0: Fast/2</b>; 1: Fast/4; 2: Fast/8; 3: Fast/16
+  ///@}
+  UINT16 MinVoltageRuntime;                       ///< PCODE MMIO Mailbox: Minimum voltage for runtime. Valid if EnableMinVoltageOverride = 1 .Range 0 to 1999mV. <b> 0: 0mV </b>
+  UINT16 MinVoltageC8;                            ///< PCODE MMIO Mailbox: Minimum voltage for C8. Valid if EnableMinVoltageOverride = 1. Range 0 to 1999mV. <b> 0: 0mV </b>
+  UINT16 PsysOffset1;                             ///< PCODE MMIO Mailbox: Platform Psys offset correction. <b>0: Auto</b> Units 1/1000, Range 0-63999. For an offset of 25.348, enter 25348.
+  UINT8  RsvdBytes2[2];
+  UINT32 TdcTimeWindow1[MAX_NUM_VRS];             ///< PCODE MMIO Mailbox: Thermal Design Current time window. Defined in milli seconds. <b>1ms default</b>
+  UINT8  Irms[MAX_NUM_VRS];                       ///< PCODE MMIO Mailbox: Current root mean square. <b>0: Disable</b>; 1: Enable.
+  UINT8  FivrSpectrumEnable;                      ///< Enable or Disable FIVR Spread Spectrum 0: Disable; <b> 1: Enable.</b>
+  UINT8  Rsvd1[2];
+  UINT8  PreWake;                                 ///< PCODE MMIO Mailbox: Acoustic Noise Mitigation Range. This can be programmed only if AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b> Defines the max pre-wake randomization time in micro ticks. Range is 0-255.
+  UINT8  RampUp;                                  ///< PCODE MMIO Mailbox: Acoustic Noise Mitigation Range. This can be programmed only if AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b> Defines the max ramp up randomization time in micro ticks. Range is 0-255.
+  UINT8  RampDown;                                ///< PCODE MMIO Mailbox: Acoustic Noise Mitigation Range. This can be programmed only if AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b> Defines the max ramp down randomization time in micro ticks. Range is 0-255.
+  UINT8  Rsvd2[1];
+} CPU_POWER_MGMT_VR_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_POWER_MGMT_VR_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
new file mode 100644
index 0000000000..74ca983a5d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
@@ -0,0 +1,64 @@
+/** @file
+  VT-d policy definitions.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _VTD_CONFIG_H_
+#define _VTD_CONFIG_H_
+
+#include <Library/VtdInfoLib.h>
+#pragma pack(push, 1)
+
+#define VTD_CONFIG_REVISION 1
+#define VTD_DXE_CONFIG_REVISION 2
+
+/**
+  The data elements should be initialized by a Platform Module.
+  The data structure is for VT-d driver initialization\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;                      ///< Offset 0-27 Config Block Header
+  /**
+    Offset 28:
+    VT-D Support can be verified by reading CAP ID register as expalined in BIOS Spec.
+    This policy is for debug purpose only.
+    If VT-D is not supported, all other policies in this config block will be ignored.
+    <b>0 = To use Vt-d</b>;
+    1 = Avoids programming Vtd bars, Vtd overrides and DMAR table.
+  **/
+  UINT8        VtdDisable;
+  UINT8        X2ApicOptOut;        ///< Offset 29 :This field is used to enable the X2APIC_OPT_OUT bit in the DMAR table. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        DmaControlGuarantee; ///< Offset 30 :This field is used to enable the DMA_CONTROL_GUARANTEE bit in the DMAR table. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        VtdIgdEnable;        ///< Offset 31 :This field is used to enable the VtdIgdEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        VtdIpuEnable;        ///< Offset 32 :This field is used to enable the VtdIpuEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        VtdIopEnable;        ///< Offset 33 :This field is used to enable the VtdIopEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        VtdItbtEnable;       ///< Offset 34 :This field is used to enable the VtdItbtEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
+  UINT8        PreBootDmaMask;      ///< Offset 35 :Convey PcdVTdPolicyPropertyMask value from EDK2 IntelSiliconPkg
+  /**
+    Offset 36:
+    This field is used to describe the base addresses for VT-d function:\n
+    VTD BAR for Gfx if IGfx is supported : <b>BaseAddress[0]=0xFED90000,\n
+    VTD BAR for IPU if IPU is supporrted : BaseAddress[1]=0xFED92000,\n
+    VTD BAR for other DMA Agents (except Igfx and IPU) : BaseAddress[2]=0xFED91000,\n
+    VTD BAR for iTBT if iTBT is supported : BaseAddress[3]=0xFED84000, BaseAddress[4]=0xFED85000, BaseAddress[5]=0xFED86000,BaseAddress[6]=0xFED87000</b>
+  **/
+  UINT32       BaseAddress[VTD_ENGINE_NUMBER];
+  UINT32       DmaBufferSize;      ///< Offset 64 :Protect Memory Region (PMR) DMA buffer size
+
+
+} VTD_CONFIG;
+
+/**
+  The data structure is for VT-d driver initialization in DXE\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                    ///< Offset 0-27 Config Block Header
+} VTD_DXE_CONFIG;
+#pragma pack(pop)
+
+#endif   //  _VTD_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfig.h
new file mode 100644
index 0000000000..8766762580
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfig.h
@@ -0,0 +1,31 @@
+/** @file
+  WatchDog policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _WATCH_DOG_CONFIG_H_
+#define _WATCH_DOG_CONFIG_H_
+
+#define WATCH_DOG_PREMEM_CONFIG_REVISION 1
+extern EFI_GUID gWatchDogPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This policy clears status bits and disable watchdog, then lock the
+  WDT registers.
+  while WDT is designed to be disabled and locked by Policy,
+  bios should not enable WDT by WDT PPI. In such case, bios shows the
+  warning message but not disable and lock WDT register to make sure
+  WDT event trigger correctly.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  UINT32    DisableAndLock    :  1;     ///< <b>(Test)</b> Set 1 to clear WDT status, then disable and lock WDT registers. <b>0: Disable</b>; 1: Enable.
+  UINT32    RsvdBits          : 31;
+} PCH_WDT_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _WATCH_DOG_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec b/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec
new file mode 100644
index 0000000000..0982758b77
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec
@@ -0,0 +1,1208 @@
+## @file
+#  Component description file for the Silicon Reference Code.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+DEC_SPECIFICATION = 0x00010017
+PACKAGE_NAME = SiPkg
+PACKAGE_VERSION = 0.1
+PACKAGE_GUID = F245E276-44A0-46b3-AEB5-9898BBCF008D
+
+[Includes.Common.Private]
+
+#
+# TigerLake Fru
+#
+Fru/TglCpu/IncludePrivate
+Fru/TglPch/IncludePrivate
+
+##
+# IpBlock IncludePrivate
+#
+IpBlock/Psf/IncludePrivate
+IpBlock/Pmc/IncludePrivate
+IpBlock/Smbus/IncludePrivate
+IpBlock/Graphics/IncludePrivate
+IpBlock/CpuPcieRp/IncludePrivate
+IpBlock/Hda/IncludePrivate
+IpBlock/PchDmi/IncludePrivate
+IpBlock/P2sb/IncludePrivate
+IpBlock/Spi/IncludePrivate
+IpBlock/Gpio/IncludePrivate
+IpBlock/Cnvi/IncludePrivate
+IpBlock/Gbe/IncludePrivate
+IpBlock/PcieRp/IncludePrivate
+IpBlock/Vtd/IncludePrivate
+IpBlock/HostBridge/IncludePrivate
+IpBlock/SerialIo/IncludePrivate
+
+SystemAgent/IncludePrivate
+
+Pch/IncludePrivate
+
+[Includes]
+#
+# TigerLake
+#
+Fru/TglCpu/Include
+Fru/TglPch/Include
+
+# CPU PCIe
+IpBlock/CpuPcieRp/Include
+
+IpBlock/Gpio/Include
+
+
+##
+#
+# This section is for IP ConfigBlock versions control
+#
+# - Memory
+Include/ConfigBlock/Memory/Ver2
+#
+# - Graphics
+Include/ConfigBlock/Graphics/Gen12
+#
+# - CPU PCIe
+Include/ConfigBlock/CpuPcieRp/Gen4
+Include/ConfigBlock/CpuDmi
+
+# - Hybrid Graphics
+Include/ConfigBlock/HybridGraphics
+
+Include
+#
+# SystemAgent
+#
+SystemAgent/Include
+SystemAgent/AcpiTables
+SystemAgent/AcpiTables/SaSsdt
+Include/ConfigBlock/Vtd
+Include/ConfigBlock/PcieRp
+Include/ConfigBlock/Gna
+Include/ConfigBlock/CpuPcieRp/Gen4
+Include/ConfigBlock/CpuPcieRp/Gen3
+Include/ConfigBlock/CpuDmi
+Include/ConfigBlock/HybridGraphics
+Include/ConfigBlock/HostBridge
+#
+# Cpu
+#
+Cpu/Include
+Include/ConfigBlock/Overclocking
+Include/ConfigBlock/VoltageRegulator
+
+#
+# Pch
+#
+Pch/Include
+Include/ConfigBlock/Thermal
+Include/ConfigBlock/P2sb
+Include/ConfigBlock/Ish
+Include/ConfigBlock/Usb
+Include/ConfigBlock/Espi
+Include/ConfigBlock/Fivr
+Include/ConfigBlock/Rtc
+Include/ConfigBlock/Smbus
+Include/ConfigBlock/Pmc
+Include/ConfigBlock/Itss
+Include/ConfigBlock/Scs
+Include/ConfigBlock/Hda
+Include/ConfigBlock/Sata
+Include/ConfigBlock/Rst
+Include/ConfigBlock/Ieh
+Include/ConfigBlock/Me
+Include/ConfigBlock/PchDmi
+Include/ConfigBlock/Gpio
+Include/ConfigBlock/Dci
+Include/ConfigBlock/Cnvi
+Include/ConfigBlock/Gbe
+Include/ConfigBlock/TraceHub
+Include/ConfigBlock/Thc
+Include/ConfigBlock/Wdt
+Include/ConfigBlock/PcieRp/PchPcieRp
+Include/ConfigBlock/PcieRp
+Include/ConfigBlock/Psf
+Include/ConfigBlock/SerialIo
+Include/ConfigBlock/HybridStorage
+Include/ConfigBlock/Spi
+
+
+#
+# - Tcss
+Include/ConfigBlock/Tcss
+[Guids.common.Private]
+#
+# PCH
+#
+gPchDeviceTableHobGuid       = { 0xb3e123d0, 0x7a1e, 0x4db4, { 0xaf, 0x66, 0xbe, 0xd4, 0x1e, 0x9c, 0x66, 0x38 }}
+gWdtHobGuid                  = { 0x65675786, 0xacca, 0x4b11, { 0x8a, 0xb7, 0xf8, 0x43, 0xaa, 0x2a, 0x8b, 0xea }}
+gPchConfigHobGuid            = { 0x524ed3ca, 0xb250, 0x49f5, { 0x94, 0xd9, 0xa2, 0xba, 0xff, 0xc7, 0x0e, 0x14 }}
+gGpioLibUnlockHobGuid        = { 0xA7892E49, 0x0F9F, 0x4166, { 0xB8, 0xD6, 0x8A, 0x9B, 0xD9, 0x8B, 0x17, 0x38 }}
+gSiScheduleResetHobGuid      = { 0xEA0597FF, 0x8858, 0x41CA, { 0xBB, 0xC1, 0xFE, 0x18, 0xFC, 0xD2, 0x8E, 0x22 }}
+gCnviConfigHobGuid           = { 0xa8d6e4d9, 0x94b7, 0x4fc9, { 0x94, 0x3f, 0x7a, 0x9c, 0xb2, 0x31, 0x57, 0xce }}
+
+#
+# CPU
+#
+gPeiAcpiCpuDataGuid          = { 0x7682bbef, 0xb0b6, 0x4939, { 0xae, 0x66, 0x1b, 0x3d, 0xf2, 0xf6, 0xaa, 0xf3 }}
+gCpuStatusCodeDataTypeExceptionHandlerGuid = { 0x3BC2BD12, 0xAD2E, 0x11D5, { 0x87, 0xDD, 0x00, 0x06, 0x29, 0x45, 0xC3, 0xB9 }}
+
+#
+# SA
+#
+gSchemaListGuid              = { 0x3047C2AC, 0x5E8E, 0x4C55, { 0xA1, 0xCB, 0xEA, 0xAD, 0x0A, 0x88, 0x86, 0x1B }}
+gEqPhase3SchemaGuid          = { 0x145AC084, 0x340E, 0x4777, { 0xBC, 0x75, 0xF8, 0x50, 0x5F, 0xFD, 0x50, 0x9D }}
+gScoreSchemaGuid             = { 0x8233A1BB, 0x58D5, 0x4F66, { 0xA1, 0x3F, 0x8A, 0xA3, 0xED, 0x6A, 0xF5, 0xA0 }}
+gPortMarginGuid              = { 0xD7154D12, 0x03B2, 0x4054, { 0x8C, 0xD2, 0x9F, 0x4B, 0x20, 0x90, 0xBE, 0xF7 }}
+gJitterTolerenceGuid         = { 0xB52A2E04, 0x45FF, 0x484E, { 0xB5, 0xFE, 0xEE, 0x47, 0x8F, 0x5F, 0x6C, 0x9B }}
+gLaneMarginGuid              = { 0x7AC0996D, 0xA601, 0x4210, { 0x94, 0x4E, 0x93, 0x4E, 0x51, 0x7B, 0x6C, 0x57 }}
+gVocMarginGuid               = { 0x3578349A, 0x9E98, 0x4F70, { 0x91, 0xCB, 0xE2, 0x5B, 0x98, 0x99, 0xBC, 0x16 }}
+
+[Guids]
+gSmbiosProcessorInfoHobGuid        =  {0xe6d73d92, 0xff56, 0x4146, {0xaf, 0xac, 0x1c, 0x18, 0x81, 0x7d, 0x68, 0x71}}
+gSmbiosCacheInfoHobGuid            =  {0xd805b74e, 0x1460, 0x4755, {0xbb, 0x36, 0x1e, 0x8c, 0x8a, 0xd6, 0x78, 0xd7}}
+
+##
+## IntelFrameworkPkg
+##
+# MsegSmramPei.inf
+gEfiSmmPeiSmramMemoryReserveGuid   =  {0x6dadf1d1, 0xd4cc, 0x4910, {0xbb, 0x6e, 0x82, 0xb1, 0xfd, 0x80, 0xff, 0x3d}}
+##
+## MdeModulePkg
+##
+gEfiMemoryTypeInformationGuid  =  {0x4c19049f, 0x4137, 0x4dd3, {0x9c, 0x10, 0x8b, 0x97, 0xa8, 0x3f, 0xfd, 0xfa}}
+gEfiCapsuleVendorGuid  =  {0x711c703f, 0xc285, 0x4b10, {0xa3, 0xb0, 0x36, 0xec, 0xbd, 0x3c, 0x8b, 0xe2}}
+gEfiConsoleOutDeviceGuid = { 0xd3b36f2c, 0xd551, 0x11d4, { 0x9a, 0x46, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d}}
+##
+## Common
+##
+## Include/ConfigBlock/SiConfig.h
+gSiConfigGuid = {0x4ed6d282, 0x22f3, 0x4fe1, {0xa6, 0x61, 0x6, 0x1a, 0x97, 0x38, 0x59, 0xd8}}
+##
+gSiPreMemConfigGuid = {0xb94c004c, 0xa0ab, 0x40f0, {0x9b, 0x61, 0x0b, 0x25, 0x88, 0xbe, 0xfd, 0xc6}}
+##
+##
+gPciePreMemConfigGuid = {0xd0f9c2a9, 0x7332, 0x4733, {0x8d, 0xb1, 0x98, 0x79, 0x27, 0x60, 0xda, 0xe6}}
+##
+gSiPkgTokenSpaceGuid  =  {0x977c97c1, 0x47e1, 0x4b6b, {0x96, 0x69, 0x43, 0x66, 0x99, 0xcb, 0xe4, 0x5b}}
+## Include/SiConfigHob.h
+gSiConfigHobGuid = {0xb3903068, 0x7482, 0x4424, {0xba, 0x4b, 0x40, 0x5f, 0x8f, 0xd7, 0x65, 0x4e}}
+gBootMediaHobGuid = {0x8c7340ea, 0xde8b, 0x4e06, {0xa4, 0x78, 0xec, 0x8b, 0x62, 0xd7, 0xa, 0x8b}}
+gEfiPramConfGuid = { 0xecb54cd9, 0xe5ae, 0x4fdc, { 0xa9, 0x71, 0xe8, 0x77, 0x75, 0x60, 0x68, 0xf7}}
+##
+##
+## IPU's GUIDs
+##
+gIpuDataHobGuid  = {0x61dd66, 0x212b, 0x4dae, {0x9b, 0xc0, 0x30, 0xe0, 0x2e, 0x3f, 0x40, 0xfd}}
+gIpuConfigHobGuid  = {0x446268e5, 0x8c30, 0x4e0a, {0x9b, 0x28, 0xa3, 0xe7, 0xf0, 0x4, 0x31, 0xd0}}
+
+## Include/FspErrorInfo.h
+gFspErrorInfoHobGuid = {0x611e6a88, 0xadb7, 0x4301, {0x93, 0xff, 0xe4, 0x73, 0x04, 0xb4, 0x3d, 0xa6}}
+gStatusCodeDataTypeFspErrorGuid = {0x611e6a88, 0xadb7, 0x4301, {0x93, 0xff, 0xe4, 0x73, 0x04, 0xb4, 0x3d, 0xa6}}
+
+##
+##
+## SystemAgent
+##
+gSaOverclockingPreMemConfigGuid  =  { 0x09ecc29d, 0xdbbe, 0x49fb, { 0xa6, 0x49, 0x4b, 0xf6, 0x40, 0xe2, 0xeb, 0xd6}}
+gSaAcpiTableStorageGuid  =  {0x3c0ed5e2, 0x91ea, 0x4b94, { 0x82, 0xd, 0x9d, 0xaf, 0x9a, 0x3b, 0xb4, 0xa2}}
+gSaDataHobGuid  =  {0xe07d0bda, 0xbf90, 0x46a9, { 0xb0, 0x0e, 0xb2, 0xc4, 0x4a, 0x0e, 0xd6, 0xd0}}
+gPsmiDataHobGuid  =  {0xa9652bd, 0x6acd, 0x47e5, { 0x80, 0x3a, 0x9, 0x53, 0x7b, 0xd2, 0xa8, 0x48 }}
+gSaConfigHobGuid  = {0x762fa2e6, 0xea3b, 0x41c8, { 0x8c, 0x52, 0x63, 0x76, 0x6d, 0x70, 0x39, 0xe0}}
+gCpuPcieHobGuid  = {0x440ab2e5, 0xa3ea, 0x466f, { 0x84, 0x96, 0xdf, 0xb1, 0x3b, 0x75, 0x29, 0x95}}
+gSaPegHobGuid    = {0x5807c388, 0xfa06, 0x4683, { 0xab, 0xd3, 0x1b, 0x31, 0xbb, 0x81, 0x2d, 0x23}}
+gHgAcpiTableStorageGuid  =  {0x8de8964f, 0x2939, 0x4b49, { 0xa3, 0x48, 0xf6, 0xb2, 0xb2, 0xde, 0x4a, 0x42}}
+gSaSsdtAcpiTableStorageGuid  =  {0xca89914d, 0x2317, 0x452e, { 0xb2, 0x45, 0x36, 0xc6, 0xfb, 0x77, 0xa9, 0xc6}}
+gSegSsdtAcpiTableStorageGuid  =  {0x10c3800d, 0xe225, 0x480e, { 0x85, 0xda, 0xbe, 0xed, 0xdb, 0x88, 0xe1, 0xc6}}
+gHgAcpiTablePchStorageGuid  =  {0xe3164526, 0x690a, 0x4e0d, { 0xb0, 0x28, 0xae, 0xa1, 0x6f, 0xe2, 0xbc, 0xf3}}
+gSaMiscPeiPreMemConfigGuid  =  {0x4a525577, 0x3469, 0x4f11, { 0x99, 0xcf, 0xfb, 0xcd, 0x5e, 0xf1, 0x84, 0xe4}}
+gSaMiscPeiConfigGuid  =  {0x1def8e6, 0xe998, 0x4e27, { 0x89, 0x98, 0x9c, 0xfa, 0xb2, 0x92, 0xbc, 0x50}}
+gCpuPciePeiPreMemConfigGuid  =  { 0x81baf3c9, 0xf295, 0x4572, { 0x8b, 0x21, 0x79, 0x3f, 0xa3, 0x1b, 0xa5, 0xdb}}
+gCpuDmiPreMemConfigGuid  =  { 0x30d12ad5, 0xa3c6, 0x49c7, { 0xa2, 0xfd, 0x35, 0x5c, 0xcb, 0x61, 0xcb, 0xcf}}
+gVmdPeiConfigGuid = { 0x79b52c74, 0xb9ba, 0x4f36, {0xa2, 0x40, 0xf2, 0x41, 0x0d, 0x20, 0x84, 0x8a}}
+gVmdInfoHobGuid            = { 0xccd0306e, 0x7fa1, 0x4df5, {0x99, 0x99, 0xc1, 0xf8, 0x9a, 0x1d, 0x1b, 0xa9}}
+gEfiVmdFeatureVariableGuid = { 0x61a14fe8, 0x4dab, 0x4a19, {0xb1, 0xe3, 0x97, 0xfb, 0x23, 0xd0, 0x92, 0x12}}
+gPramPreMemConfigGuid  =  { 0xcf0b9b31, 0xa1a6, 0x46d9, { 0x8d, 0x14, 0xe3, 0xac, 0x69, 0x0f, 0x52, 0x3a}}
+gHybridGraphicsConfigGuid  =  { 0xc7956998, 0xc065, 0x46c4, { 0x8e, 0x2f, 0x58, 0x2b, 0x67, 0xeb, 0xbe, 0x2f}}
+gHybridGraphicsInfoHobGuid =  { 0x46cbed07, 0x717a, 0x4a75, { 0x85, 0xb3, 0xf4, 0xb6, 0xc4, 0xe2, 0x3a, 0x75}}
+gMemoryConfigGuid  =  { 0x26cf084c, 0xc9db, 0x41bb, { 0x92, 0xc6, 0xd1, 0x97, 0xb8, 0xa1, 0xe4, 0xbf}}
+gMemoryConfigNoCrcGuid  =  { 0xc56c73d0, 0x1cdb, 0x4c0c, { 0xa9, 0x57, 0xea, 0x62, 0xa9, 0xe6, 0xf5, 0x0c}}
+gGnaConfigGuid  =  { 0x53e0ef18, 0xb8a8, 0x4795, { 0xa6, 0x6d, 0xe4, 0x77, 0x2c, 0xc3, 0xae, 0x82}}
+gVtdDxeConfigGuid  =  {0xcbbf1996, 0x4a4c, 0x4dd9, {0xab, 0xbe, 0x83, 0x89, 0x73, 0xd, 0x48, 0xb0}}
+gPcieDxeConfigGuid  =  {0x1ed2d6f1, 0xa9d2, 0x476e, {0x8e, 0x74, 0xad, 0xd9, 0x5b, 0x5,  0x10, 0x82}}
+gMemoryDxeConfigGuid  =  {0xa5c7dda8, 0x686b, 0x404f, {0x86, 0x40, 0xf8, 0x2,  0xd,  0x84, 0x4c, 0x94}}
+gFspReservedMemoryResourceHobTsegGuid  =  { 0xd038747c, 0xd00c, 0x4980, { 0xb3, 0x19, 0x49, 0x01, 0x99, 0xa4, 0x7d, 0x55}}
+gCpuPcieRpPrememConfigGuid = { 0x41aef892, 0xc800, 0x4ac0, {0xa9, 0x30, 0x84, 0xac, 0x47, 0xca, 0xca, 0x7e}}
+gCpuPcieRpConfigGuid = { 0x9749a5fb, 0x9130, 0x44f0, {0x8f, 0x61, 0xdb, 0xff, 0x8e, 0xf2, 0xca, 0xc7}}
+## Include/Guid/AcpiS3Context.h
+gEfiAcpiVariableGuid  =  {0xaf9ffd67, 0xec10, 0x488a, {0x9d, 0xfc, 0x6c, 0xbf, 0x5e, 0xe2, 0x2c, 0x2e}}
+## IntelFsp2Pkg/IntelFsp2Pkg.dec gSiMemoryS3DataGuid is the same as gFspNonVolatileStorageHobGuid
+gSiMemoryS3DataGuid       = { 0x721acf02, 0x4d77, 0x4c2a, { 0xb3, 0xdc, 0x27, 0x0b, 0x7b, 0xa9, 0xe4, 0xb0 } }
+gSiMemoryInfoDataGuid     = { 0x9b2071d4, 0xb054, 0x4e0c, { 0x8d, 0x09, 0x11, 0xcf, 0x8b, 0x9f, 0x03, 0x23 } }
+gSiMemoryPlatformDataGuid = { 0x6210d62f, 0x418d, 0x4999, { 0xa2, 0x45, 0x22, 0x10, 0x0a, 0x5d, 0xea, 0x44 } }
+## Include/MrcRmtData.h
+gEfiMemorySchemaGuid  = { 0xCE3F6794, 0x4883, 0x492C, { 0x8D, 0xBA, 0x2F, 0xC0, 0x98, 0x44, 0x77, 0x10}}
+gMrcSchemaListHobGuid = { 0x3047C2AC, 0x5E8E, 0x4C55, { 0xA1, 0xCB, 0xEA, 0xAD, 0x0A, 0x88, 0x86, 0x1B}}
+gRmtResultMetadataGuid = { 0x02CB1552, 0xD659, 0x4232, { 0xB5, 0x1F, 0xCA, 0xB1, 0xE1, 0x1F, 0xCA, 0x87}}
+gRmtResultColumnsGuid  = { 0x0E60A1EB, 0x331F, 0x42A1, { 0x9D, 0xE7, 0x45, 0x3E, 0x84, 0x76, 0x11, 0x54}}
+gMargin2DResultMetadataGuid = { 0x48265582, 0x8E49, 0x4AC7, { 0xAA, 0x06, 0xE1, 0xB9, 0xA7, 0x4C, 0x97, 0x16}}
+gMargin2DResultColumnsGuid  = { 0x91A449EC, 0x8A4A, 0x4736, { 0xAD, 0x71, 0xA3, 0xF6, 0xF6, 0xD7, 0x52, 0xD9}}
+gSaFspErrorTypePeiGopInit = { 0x8106a5cc, 0x30ba, 0x41cf, { 0xa1, 0x78, 0x63, 0x38, 0x91, 0x11, 0xae, 0xb2}}
+gSaFspErrorTypePeiGopGetMode = { 0x348cc7fe, 0x1e9a, 0x4c7a, { 0x86, 0x28, 0xae, 0x48, 0x5b, 0x42, 0x10, 0xf0}}
+gSaFspErrorTypeCallerId = { 0x98230916, 0xe632, 0x49ff, { 0x81, 0x81, 0x55, 0xce, 0xe5, 0x10, 0x36, 0x89}}
+gMrcFspErrorTypeCallerId = { 0x5a47c211, 0x642f, 0x4f92, { 0x9c, 0xb3, 0x7f, 0xeb, 0x93, 0xda, 0xdd, 0xba}}
+gMrcFspErrorTypeMemoryInit = { 0x5de1c071, 0x2c9c, 0x4a53, { 0x80, 0x21, 0x4e, 0x80, 0xd2, 0x5d, 0x44, 0xa8}}
+gSaPciePeiConfigGuid = { 0xdaa929a9, 0x5ec9, 0x486a, { 0xb0, 0xf7, 0x82, 0x3a, 0x55, 0xc7, 0xb5, 0xb3}}
+gSaPciePeiPreMemConfigGuid = { 0xfc5e01a3, 0x69f6, 0x4e35, { 0x9f, 0xcf, 0x6, 0x68, 0x7b, 0xab, 0x31, 0xd7}}
+
+
+#
+# Host Bridge
+#
+gHostBridgePeiPreMemConfigGuid  =  {0xbdef6805, 0x2080, 0x44ad, { 0x93, 0x2e, 0x00, 0x04, 0xf5, 0x2c, 0xb7, 0xa1}}
+gHostBridgePeiConfigGuid  =  {0x3b6d998e, 0x8b6e, 0x4f53, { 0xbe, 0x41, 0x7, 0x41, 0x95, 0x53, 0x8a, 0xaf}}
+gHostBridgeDataHobGuid  =  {0x3b682d57, 0xd402, 0x40a6, { 0xb1, 0x34, 0xa0, 0xc4, 0xf6, 0x31, 0x1d, 0x9}}
+
+#
+# Graphics
+#
+gGraphicsPeiPreMemConfigGuid  =  {0x0319c56b, 0xc43a, 0x42f1, { 0x80, 0xbe, 0xca, 0x5b, 0xd1, 0xd5, 0xc9, 0x28}}
+gGraphicsPeiConfigGuid  =  {0x04249ac0, 0x0088, 0x439f, { 0xa7, 0x4e, 0xa7, 0x04, 0x2a, 0x06, 0x2f, 0x5d}}
+gGraphicsDxeConfigGuid  =  {0x34d93161, 0xf78e, 0x4915, {0xad, 0xc4, 0xdb, 0x67, 0x16, 0x42, 0x39, 0x24}}
+gGraphicsAcpiTableStorageGuid  =  {0xce9caa0e, 0x8248, 0x442c, { 0x9e, 0x57, 0x50, 0xf2, 0x12, 0xe2, 0xba, 0xed}}
+## IpBlock/Graphics/IncludePrivate/GraphicsDataHob.h
+gGraphicsDataHobGuid = { 0x48e6e20a, 0x9110, 0x4332, { 0x8c, 0x9f, 0x5f, 0x7c, 0xae, 0x76, 0xfc, 0xf3}}
+
+#
+# IPU
+#
+gIpuPreMemConfigGuid  =  { 0x830a222b, 0x3ff5, 0x432e, { 0x9d, 0xd5, 0x4e, 0xe3, 0xfc, 0xa2, 0xaa, 0xa2}}
+gIpuAcpiTableStorageGuid  =  {0x9b25dba6, 0x45b3, 0x4190, { 0x99, 0x8d, 0xaf, 0x31, 0xdc, 0x21, 0x78, 0x21}}
+
+## Include/SsaCommonConfig.h
+gSsaPostcodeHookGuid = {0xADF0A27B, 0x61A6, 0x4F18, {0x9E, 0xAC, 0x46, 0x87, 0xE7, 0x9E, 0x6F, 0xBB}}
+gSsaBiosVariablesGuid = {0x43eeffe8, 0xa978, 0x41dc, {0x9d, 0xb6, 0x54, 0xc4, 0x27, 0xf2, 0x7e, 0x2a}}
+gSsaBiosResultsGuid = {0x8f4e928, 0xf5f, 0x46d4, {0x84, 0x10, 0x47, 0x9f, 0xda, 0x27, 0x9d, 0xb6}}
+gHobUsageDataGuid = {0xc764a821, 0xec41, 0x450d, { 0x9c, 0x99, 0x27, 0x20, 0xfc, 0x7c, 0xe1, 0xf6 }}
+##
+## TBT
+##
+gPeiITbtConfigGuid            =  {0xd7e7e1e6, 0xcbec, 0x4f5f, {0xae, 0xd3, 0xfd, 0xc0, 0xa8, 0xb0, 0x7e, 0x25}}
+gDxeITbtConfigGuid            =  {0x196bf9e3, 0x20d7, 0x4b7b, {0x89, 0xf9, 0x31, 0xc2, 0x72, 0x08, 0xc9, 0xb9}}
+gITbtInfoHobGuid              =  {0x74a81eaa, 0x033c, 0x4783, {0xbe, 0x2b, 0x84, 0x85, 0x74, 0xa6, 0x97, 0xb7}}
+
+##
+## TCSS
+##
+gTcssHobGuid  = { 0x455702ce, 0x4adb, 0x45d9, { 0x8b, 0x27, 0xf7, 0xb0, 0xd9, 0x79, 0x8a, 0xe0}}
+gTcssSsdtAcpiTableStorageGuid  =  { 0xbd53572c, 0x6486, 0x45e2, { 0x90, 0xe, 0xb9, 0x8a, 0xc1, 0xa8, 0x25, 0x45}}
+gTcssPeiConfigGuid =  { 0xfb631590, 0x79c9, 0x4f0d, { 0xa9, 0x96, 0xee, 0xe2, 0x98, 0x66, 0xfa, 0xfd}}
+gTcssPeiPreMemConfigGuid = { 0x514ed829, 0xb2bb, 0x46be, { 0xa9, 0x78, 0x6d, 0xc, 0x91, 0xc1, 0xeb, 0xe4}}
+gTcssSsidHobGuid  = { 0x8903d47a, 0x8f82, 0x4063, { 0xa8, 0x40, 0x31, 0x68, 0x9c, 0x9e, 0x78, 0x20}}
+##
+## Telemetry
+##
+gTelemetryPeiConfigGuid       =  { 0x8ebf9fee, 0x7496, 0x42b4, { 0xa6, 0xf6, 0xcf, 0x2b, 0x33, 0x99, 0x30, 0xd6}}
+gTelemetryPeiPreMemConfigGuid =  { 0x422de269, 0xb2ef, 0x4829, { 0x93, 0x36, 0x0b, 0xe4, 0x98, 0xb5, 0x53, 0xb2}}
+
+##
+## VTD
+##
+gVtdDataHobGuid  = {0x1d60dce8, 0x503a, 0x44a8, { 0xb3, 0x2d, 0x56, 0xb3, 0x88, 0xf3, 0x4c, 0x55}}
+gVtdConfigGuid  =  {0x03e5cf63, 0xbebb, 0x4041, { 0xb7, 0xe7, 0xbf, 0x54, 0x61, 0x20, 0xf1, 0xc5}}
+
+#
+# TRACEHUB
+#
+gCpuTraceHubPreMemConfigGuid =  { 0xf2e17477, 0x93f3, 0x430d, { 0x9e, 0x08, 0x3c, 0xcc, 0x6e, 0x2f, 0x6c, 0x4b}}
+gTraceHubDataHobGuid         =  { 0xf1187e54, 0x995f, 0x49d9, { 0xac, 0xee, 0xc5, 0x34, 0xf4, 0x5a, 0x18, 0xc7}}
+
+##
+## Cpu
+##
+gSmramCpuDataHeaderGuid  =  {0x5848fd2d, 0xd6af, 0x474b, {0x82, 0x75, 0x95, 0xdd, 0xe7, 0x0a, 0xe8, 0x23}}
+gCpuAcpiTableStorageGuid  =  {0xc38fb0e2, 0x0c43, 0x49c9, {0xb5, 0x44, 0x9b, 0x17, 0xaa, 0x4d, 0xcb, 0xa3}}
+gTxtInfoHobGuid  =  {0x2986883f, 0x88e0, 0x48d0, {0x4b, 0x82, 0x20, 0xc2, 0x69, 0x48, 0xdd, 0xac}}
+gHtBistHobGuid  =  {0xbe644001, 0xe7d4, 0x48b1, {0xb0, 0x96, 0x8b, 0xa0, 0x47, 0xbc, 0x7a, 0xe7}}
+gProcessorProducerGuid  =  {0x1bf06aea, 0x5bec, 0x4a8d, {0x95, 0x76, 0x74, 0x9b, 0x09, 0x56, 0x2d, 0x30}}
+gCpuInitDataHobGuid  =  {0x266e31cc, 0x13c5, 0x4807, {0xb9, 0xdc, 0x39, 0xa6, 0xba, 0x88, 0xff, 0x1a}}
+gBiosGuardHobGuid  =  {0x66f0c42d, 0x0d0e, 0x4c23, {0x93, 0xc0, 0x2d, 0x52, 0x95, 0xdc, 0x5e, 0x21}}
+gCpuSecurityPreMemConfigGuid = {0xfd5c346, 0x8260, 0x4067, {0x94, 0x69, 0xcf, 0x91, 0x68, 0xa3, 0x42, 0x90}}
+gCpuConfigLibPreMemConfigGuid = {0xfc1c0ec2, 0xc6b4, 0x4f05, {0xbb, 0x85, 0xc8, 0x0, 0x8d, 0x5b, 0x4a, 0xb7}}
+gCpuTxtPreMemConfigGuid = {0x20b4db03, 0xd160, 0x4f83, {0xa4, 0x1, 0x9a, 0x8a, 0xa8, 0x88, 0x68, 0x14}}
+gCpuTestConfigGuid = {0xd4dba957, 0xd9c, 0x4af2, {0x9d, 0x40, 0x35, 0xa8, 0x44, 0xe4, 0x93, 0xad}}
+gBiosGuardConfigGuid = {0x762f9ddb, 0x1c89, 0x4612, {0x84, 0x6b, 0xee, 0xdc, 0x8f, 0x62, 0x25, 0x45}}
+gCpuConfigGuid = {0x48c3aac9, 0xd66c, 0x42e4, {0x9b, 0x1d, 0x39, 0x4, 0x5f, 0x46, 0x53, 0x41}}
+gCpuPidTestConfigGuid = {0x2511095f, 0xd49e, 0x4537, {0xa6, 0x60, 0x88, 0x71, 0x31, 0xd1, 0x53, 0xda}}
+gCpuPowerMgmtBasicConfigGuid = {0xa021e31d, 0x7c14, 0x47da, {0xb5, 0xec, 0xca, 0xbb, 0x4d, 0x76, 0xed, 0xc8}}
+gCpuPowerMgmtCustomConfigGuid = {0x562fa1c8, 0x55ee, 0x4e2f, {0x91, 0xca, 0x8d, 0x84, 0x50, 0x3, 0x2f, 0xe}}
+gCpuPowerMgmtPsysConfigGuid = {0x4e7f850, 0x19b5, 0x47ba, {0x9d, 0x28, 0xb1, 0xe7, 0x5e, 0x1f, 0x48, 0x53}}
+gCpuPowerMgmtTestConfigGuid = {0x5161ed3d, 0x90bf, 0x436f, {0xb8, 0x33, 0xd7, 0x17, 0x89, 0xb3, 0x48, 0xc1}}
+gCpuPowerMgmtVrConfigGuid = {0x254766c9, 0x929d, 0x4eac, {0x9e, 0xec, 0xdf, 0xa2, 0x2, 0x44, 0xb5, 0xea}}
+gTxtPrivateBaseHobGuid = {0x651EBDB4, 0x4E1D, 0x422A, {0x82, 0xFB, 0x1E, 0xDA, 0x66, 0x71, 0x6C, 0x0B}}
+gTxtAcmInfoTableGuid = {0x7FC03AAA, 0x46A7, 0x18DB, {0x2E, 0xAC, 0x69, 0x8F, 0x8D, 0x41, 0x7F, 0x5A}}
+gOverclockingPreMemConfigGuid = {0xad151bbc, 0xd5a0, 0x481e, {0x9d, 0x19, 0xf6, 0x7b, 0x79, 0xe9, 0x8f, 0x68}}
+gCpuDataHobGuid = {0x1eec629f, 0xf3cf, 0x4b02, { 0xa9, 0xa5, 0x27, 0xa2, 0x33, 0x20, 0xbe, 0x5d}}
+
+##
+## Me
+##
+gMePlatformReadyToBootGuid  =  {0x03fdf171, 0x1d67, 0x4ace, {0xa9, 0x04, 0x3e, 0x36, 0xd3, 0x38, 0xfa, 0x74}}
+gMeSsdtAcpiTableStorageGuid  =  {0x9a8f82d5, 0x39b1, 0x48da, {0x92, 0xdc, 0xa2, 0x2d, 0xa8, 0x83, 0x4d, 0xf6}}
+gMeDataHobGuid  =  {0x1e94f097, 0x5acd, 0x4089, {0xb2, 0xe3, 0xb9, 0xa5, 0xc8, 0x79, 0xa7, 0x0c}}
+gMeEDebugHobGuid = {0x5f672ec1, 0xa8f6, 0x47d3, {0x9c, 0xd0, 0x92, 0xe9, 0xe9, 0xe0, 0xb3, 0x84}}
+gPciImrHobGuid  =  {0x49b1eac3, 0x0cd6, 0x451e, {0x96, 0x30, 0x92, 0x4b, 0xc2, 0x69, 0x35, 0x86}}
+gTpm2AcpiTableStorageGuid  =  {0x7d279373, 0xeecc, 0x4d4f, {0xae, 0x2f, 0xce, 0xc4, 0xb7, 0x06, 0xb0, 0x6a}}
+gMeBiosPayloadHobGuid  =  {0x992c52c8, 0xbc01, 0x4ecd, {0x20, 0xbf, 0xf9, 0x57, 0x16, 0x0e, 0x9e, 0xf7}}
+gEfiTouchPanelGuid  =  {0x91b1d27b, 0xe126, 0x48d1, {0x82, 0x34, 0xd2, 0x8b, 0x81, 0xc8, 0x83, 0x62}}
+gMeFwHobGuid  = {0x52885e62, 0x4c4d, 0x9546, {0x2d, 0xba, 0x2a, 0x84, 0x89, 0xee, 0xa8, 0xa3 }}
+gMePeiPreMemConfigGuid  =  {0x67ed113b, 0xd4ab, 0x43f5, {0x9c, 0x3c, 0x35, 0x44, 0x15, 0xaa, 0x47, 0x5c}}
+gMePeiConfigGuid  =  {0x9bad5628, 0x657b, 0x48e3, {0xb1, 0x11, 0xc3, 0xb9, 0xeb, 0xea, 0xee, 0x17}}
+gMeDxeConfigGuid  =  {0xad08bacc, 0x4906, 0x4d9b, {0xbe, 0xd1, 0x81, 0xa5, 0x2c, 0x13, 0xdb, 0xf8}}
+gIvmProtocolGuid  = {0x3C4852D6, 0xD47B, 0x4F46, {0xB0, 0x5E, 0xB5, 0xED, 0xC1, 0xAA, 0x44, 0x0E}}
+gSdmProtocolGuid  = {0xDBA4D603, 0xD7ED, 0x4931, {0x88, 0x23, 0x17, 0xAD, 0x58, 0x57, 0x05, 0xD5}}
+gRtmProtocolGuid  = {0x5565A099, 0x7FE2, 0x45C1, {0xA2, 0x2B, 0xD7, 0xE9, 0xDF, 0xEA, 0x9A, 0x2E}}
+gSvmProtocolGuid  = {0xF47ACC04, 0xD94B, 0x49CA, {0x87, 0xA6, 0x7F, 0x7D, 0xC0, 0x3F, 0xBA, 0xF3}}
+gMeEopDoneHobGuid = {0x247323af, 0xc8f1, 0x4b8c, {0x90, 0x87, 0xaa, 0x4b, 0xa7, 0xb7, 0x6d, 0x6a}}
+gMePreMemPolicyHobGuid = {0xe6de74a5, 0x21b, 0x4f78, {0xa3, 0xcd, 0x34, 0xd6, 0x7e, 0xe4, 0x82, 0xbf}}
+gMePolicyHobGuid =  {0x0341cf17, 0xbc8f, 0x4a20, {0xac, 0x28, 0x6c, 0x3c, 0x32, 0x4c, 0xd4, 0x17}}
+gMeFspErrorTypeEop = {0x948585c4, 0x76a4, 0x45bb, {0xbe, 0x6c, 0x39, 0x61, 0xc3, 0xab, 0xde, 0x15}}
+gMeFspErrorTypeCallerId = {0x1f4dc7e9, 0x26ca, 0x4336, { 0x8c, 0xe3, 0x39, 0x31, 0x3, 0xb5, 0xf3, 0xd7}}
+gMeConfigSpaceGuid = {0xcb405fd3, 0x4404, 0x4ccd, {0x85, 0x18, 0x0d, 0x03, 0x07, 0x48, 0xd0, 0xa6}}
+gMeDidSentHobGuid = {0x4c3d3af1, 0x1720, 0x4c3f, {0xab, 0x7c, 0x36, 0x50, 0xbb, 0x5b, 0x85, 0x7e}}
+gMeDisabledEventHobGuid = {0x1500b6a7, 0xb82f, 0x456b, {0xba, 0x2b, 0x4, 0x72, 0x41, 0x6, 0xf, 0x7}}
+gMeSavedPmconHobGuid = {0xb8baee93, 0xea15, 0x4ddc, {0x90, 0xb8, 0x44, 0x12, 0xd2, 0xea, 0xcf, 0x4f}}
+
+##
+## Amt
+##
+gAmtForcePushPetPolicyGuid  =  {0xacc8e1e4, 0x9f9f, 0x4e40, {0xa5, 0x7e, 0xf9, 0x9e, 0x52, 0xf3, 0x4c, 0xa5}}
+gAmtForcePushPetVariableGuid  =  {0xd7ac94af, 0xa498, 0x45ec, {0xbf, 0xa2, 0xa5, 0x6e, 0x95, 0x34, 0x61, 0x8b}}
+gMeBiosExtensionSetupGuid  =  {0xaf013532, 0xc828, 0x4fbd, {0x20, 0xae, 0xfe, 0xe6, 0xaf, 0xbe, 0xdd, 0x4e}}
+gAmtPetQueueHobGuid  =  {0xca0801d3, 0xafb1, 0x4dec, {0x9b, 0x65, 0x93, 0x65, 0xec, 0xc7, 0x93, 0x6b}}
+gAmtForcePushPetHobGuid  =  {0x4efa0db6, 0x26dc, 0x4bb1, {0xa7, 0x6f, 0x14, 0xbc, 0x63, 0x0c, 0x7b, 0x3c}}
+gAmtPeiConfigGuid  =  {0x7254546a, 0xace3, 0x4a32, {0x9a, 0xc2, 0xf0, 0xcc, 0x28, 0x4e, 0x1e, 0x4d}}
+gAmtDxeConfigGuid  =  {0x3f12ab6b, 0xb04d, 0x4824, {0xbf, 0xb6, 0x3e, 0xe7, 0x5d, 0x02, 0x0b, 0x84}}
+gAmtPolicyHobGuid = {0x703eb2cd, 0x5ca8, 0x4233, {0x9d, 0xa3, 0x0d, 0x2d, 0x57, 0xe6, 0x73, 0x34}}
+gAmtMebxDataGuid  = { 0x912e1538, 0x371d, 0x4ea6, { 0xa8, 0x41, 0xd7, 0x6a, 0x8, 0x93, 0x3a, 0x70}}
+
+##
+## PCH
+##
+gEfiSmbusArpMapGuid  =  {0x707be83e, 0x0bf6, 0x40a5, {0xbe, 0x64, 0x34, 0xc0, 0x3a, 0xa0, 0xb8, 0xe2}}
+gIrmtAcpiTableStorageGuid  =  {0x6684d675, 0xee06, 0x49b2, {0x87, 0x6f, 0x79, 0xc5, 0x8f, 0xdd, 0xa5, 0xb7}}
+gPchGlobalResetGuid  =  { 0x9db31b4c, 0xf5ef, 0x48bb, { 0x94, 0x2b, 0x18, 0x1f, 0x7e, 0x3a, 0x3e, 0x40 }}
+gI2c0MasterGuid  =  {0xa121a5db, 0xb0cb, 0x46ec, {0xa0, 0xcb, 0x27, 0xf8, 0xda, 0x72, 0xd4, 0x0e}}
+gI2c1MasterGuid  =  {0x55e3d0f9, 0xc954, 0x422d, {0x9c, 0x4c, 0xcc, 0x46, 0x12, 0x7c, 0x5b, 0xa8}}
+gI2c2MasterGuid  =  {0x9289aa40, 0xdf32, 0x474e, {0xb0, 0x3a, 0xc7, 0x7f, 0x76, 0xd3, 0x45, 0x21}}
+gI2c3MasterGuid  =  {0xd8b2c17f, 0x4117, 0x4166, {0x90, 0x17, 0x01, 0x68, 0xb4, 0x81, 0xac, 0x18}}
+gI2c4MasterGuid  =  {0x513d943d, 0x15d9, 0x4bd0, {0xb1, 0x41, 0x14, 0x50, 0x2b, 0xbf, 0xa9, 0xf2}}
+gI2c5MasterGuid  =  {0x50df382a, 0xb6bf, 0x4435, {0xae, 0xe6, 0x21, 0xf4, 0x85, 0x7c, 0xa8, 0xb4}}
+gChipsetInitHobGuid  =  {0xc1392859, 0x1f75, 0x446e, {0xb3, 0xf5, 0x83, 0x35, 0xfc, 0xc8, 0xd1, 0xc4}}
+
+gPchGeneralPreMemConfigGuid  = {0xC65F62FA, 0x52B9, 0x4837, {0x86, 0xEB, 0x1A, 0xFB, 0xD4, 0xAD, 0xBB, 0x3E}}
+gDciPreMemConfigGuid  =   {0xAB4AF366, 0x2250, 0x40C3, {0x92, 0xDB, 0x36, 0x61, 0xC6, 0x71, 0x3C, 0x5A}}
+gWatchDogPreMemConfigGuid  =  {0xFBCE08CC, 0x60F2, 0x4BDF, {0xB7, 0x88, 0x09, 0xBB, 0x81, 0x65, 0x52, 0x2B}}
+gPchTraceHubPreMemConfigGuid  = {0x8456c11, 0xdb85, 0x4914, {0x8d, 0x1a, 0xe5, 0xac, 0x64, 0x37, 0xe8, 0x96}}
+gPcieRpPreMemConfigGuid  =  {0x8377AB38, 0xF8B0, 0x476A, { 0x9C, 0xA1, 0x68, 0xEA, 0x78, 0x57, 0xD8, 0x2A}}
+gSmbusPreMemConfigGuid  =  {0x77A6E62C, 0x716B, 0x4386, {0x9E, 0x9C, 0x23, 0xA0, 0x2E, 0x13, 0x7B, 0x3A}}
+gLpcPreMemConfigGuid  =  {0xA6E6032F, 0x1E58, 0x407E, {0x9A, 0xB8, 0xC6, 0x30, 0xC6, 0xC4, 0x11, 0x8E}}
+gHsioPciePreMemConfigGuid  =  {0xE8FB0C12, 0x0DA1, 0x4A20, {0xB3, 0x36, 0xFB, 0x75, 0x93, 0x8C, 0xE0, 0x14}}
+gHsioSataPreMemConfigGuid  =  {0x732260D0, 0xA5C1, 0x4119, {0xAA, 0x0C, 0x93, 0xDC, 0xAC, 0x67, 0x0A, 0x31}}
+
+gPchGeneralConfigGuid  =  {0x6ED94C8C, 0x25F7, 0x4686, {0xB2, 0x46, 0xCA, 0x4D, 0xE2, 0x95, 0x4B, 0x5D}}
+gPchPcieConfigGuid  =  {0x0A53B507, 0x988B, 0x475C, {0xBF, 0x76, 0x33, 0xDE, 0x10, 0x6D, 0x94, 0x84}}
+gPchPcieRpDxeConfigGuid  =  {0x475530EA, 0xBD72, 0x416F, {0x98, 0x9F,0x48, 0x70, 0x5F, 0x14, 0x4E, 0xD9}}
+gSataConfigGuid  =  {0xF5F87B4F, 0xCC3C, 0x408D, {0x89, 0xE3, 0x61, 0xC5, 0x9C, 0x54, 0x07, 0xC4}}
+gRstConfigGuid = {0x43B6F112, 0x3851, 0x4DDC, {0x81, 0xB9, 0xE4, 0x5A, 0x2B, 0xE, 0xB3, 0x25}}
+gIoApicConfigGuid  =  {0x2873D0F1, 0x00F6, 0x40AB, {0xAC, 0x36, 0x9A, 0x68, 0xBA, 0x87, 0x3E, 0x6C}}
+gPchDmiConfigGuid  =  {0xB3A61210, 0x1CD3, 0x4797, {0x8E, 0xE6, 0xD3, 0x42, 0x9C, 0x4F, 0x17, 0xBD}}
+gFlashProtectionConfigGuid  =  {0xD0F71512, 0x9E32, 0x4CC9, {0xA5, 0xA3, 0xAD, 0x67, 0x9A, 0x06, 0x67, 0xB8}}
+gHdAudioPreMemConfigGuid  =  {0xD38F1E2B, 0x21B3, 0x43D1, {0x9F, 0xA8, 0xA5, 0xE1, 0x78, 0x73, 0x1E, 0x88}}
+gHdAudioConfigGuid  =  {0x7EB3CE7E, 0x82E0, 0x4CD7, {0xBD, 0xE5, 0xB2, 0xBF, 0x4E, 0x91, 0xC3, 0x4C}}
+gHdAudioDxeConfigGuid  =  {0x22EFC2DE, 0x66EB, 0x412D, {0x97, 0x17, 0xE7, 0x7A, 0xA1, 0x4E, 0x87, 0x76}}
+gInterruptConfigGuid  =  {0x09A2B815, 0xBE29, 0x45EF, {0xBF, 0xBF, 0x58, 0xEA, 0xAC, 0x5E, 0x29, 0x78}}
+gIshPreMemConfigGuid  =  {0x7C24E649, 0xC1F0, 0x4CF9, {0x87, 0x96, 0xE7, 0xA0, 0xEE, 0x34, 0x43, 0xF8}}
+gIshConfigGuid  =  {0x433AE2AA, 0xC5A6, 0x46ED, {0x94, 0x19, 0x1E, 0x5D, 0xB8, 0x1C, 0x57, 0x40}}
+gGbeConfigGuid  =  {0x4B2DE99E, 0x7517, 0x4D04, {0x8C, 0x02, 0xF1, 0x1A, 0x59, 0x2B, 0x14, 0x2F}}
+gTsnConfigGuid  =  {0x9E9A93CB, 0x0F4E, 0x4E56, {0x90, 0x2D, 0x6C, 0x76, 0xDE, 0x90, 0xF7, 0x71}}
+gLockDownConfigGuid  =  {0x8A838E0A, 0xA639, 0x46F0, {0xA9, 0xCE, 0x70, 0xC4, 0x85, 0xFB, 0xA8, 0x0D}}
+gP2sbConfigGuid  =  {0x2474DCB8, 0x4BB4, 0x49DA, {0x87, 0x83, 0x7C, 0xD3, 0xD3, 0x85, 0xFF, 0x07}}
+gPmConfigGuid  =  {0x93826157, 0xDC85, 0x4E34, {0xAE, 0xD9, 0x6E, 0xA1, 0x0D, 0xF9, 0xE3, 0xA7}}
+gScsConfigGuid  =  {0xF4DE6D52, 0xB5C9, 0x48C0, {0xA0, 0x4A, 0x68, 0x54, 0x20, 0x94, 0x05, 0xD0}}
+gScsInfoHobGuid = {0x94C5E85B, 0xAA6D, 0x481D, {0x8B, 0xBD, 0x54, 0xAA, 0xE2, 0x99, 0x78, 0xB2}}
+gSdCardConfigGuid = {0xD6A3038E, 0x50AE, 0x44B0, {0x93, 0xE2, 0xF7, 0x93, 0xF5, 0x90, 0x50, 0x27}}
+gEmmcConfigGuid = {0xE0C6FB5D, 0x5696, 0x47F3, {0x84, 0xE8, 0xCC, 0x6C, 0x68, 0xA4, 0xB2, 0x1D}}
+gUfsConfigGuid = {0x3AF25C55, 0x76B4, 0x4367, {0x85, 0xEF, 0x9D, 0x51, 0x2F, 0x2F, 0x8F, 0xA7}}
+gEmmcDxeConfigGuid = {0x59440AA6, 0xEB45, 0x4E36, {0xBC, 0x90, 0xBE, 0xF9, 0x0C, 0xB0, 0xC8, 0x18}}
+gSerialIoConfigGuid  =  {0x6CC06EBF, 0x0D34, 0x4340, {0xBC, 0x16, 0xDA, 0x09, 0xE5, 0x78, 0x3A, 0xDB}}
+gSerialIrqConfigGuid  =  {0x251701E7, 0xE266, 0x4623, {0x99, 0x68, 0x73, 0x8C, 0xD2, 0x23, 0x10, 0x96}}
+gSpiConfigGuid  =  {0x150360EF, 0x99BE, 0x4E43, {0x94, 0xBB, 0xBD, 0x40, 0x26, 0xCA, 0x34, 0x57}}
+gEspiConfigGuid  =  {0x60FBF3B8, 0x96D4, 0x4187, {0x84, 0x9E, 0xAA, 0xF7, 0x5C, 0x4B, 0xE1, 0xE3}}
+gThermalConfigGuid  =  {0x4416506D, 0x1197, 0x4722, {0xA5, 0xB4, 0x46, 0x11, 0xF9, 0x23, 0x9E, 0xAE}}
+gUsbConfigGuid  =  {0xB2DA9CCD, 0x6A8C, 0x4BB6, {0xB3, 0xE6, 0xCD, 0xFB, 0xB7, 0x66, 0x8B, 0xDE}}
+gUsb2PhyConfigGuid  =  {0x576C1134, 0x2E0C, 0xCB7D, {0xCD, 0x3F, 0xAC, 0x68, 0x2D, 0xAE, 0xD3, 0xF2}}
+gUsb3HsioConfigGuid  =  {0xF8AFC238, 0xF176, 0x12CE, {0xBE, 0xF4, 0x69, 0xF9, 0xB1, 0xAC, 0x40, 0xD5}}
+gPchPcieStorageDetectHobGuid = {0xC682F3F4, 0x2F46, 0x495E, {0x98, 0xAA, 0x43, 0x14, 0x4B, 0xA5, 0xA4, 0x85}}
+gCnviConfigGuid = {0xE53EBEF7, 0x103D, 0x4A70, {0x9B, 0x6A, 0x73, 0xEE, 0x5F, 0x4C, 0x8D, 0xF5}}
+gHsioConfigGuid = {0xE53EBEE7, 0x103D, 0x4A71, {0x9B, 0x6A, 0x74, 0xEE, 0x5F, 0x4C, 0x8D, 0xF5}}
+gPchRstHobGuid =  {0x4ECA680C, 0x660D, 0x48F8, {0xAA, 0xD8, 0x94, 0xD6, 0x56, 0x10, 0xF9, 0x86}}
+gPchInfoHobGuid  =  {0x99FD5E18, 0xE262, 0x4E6A, {0x82, 0x66, 0x77, 0xD0, 0x36, 0x5F, 0xD6, 0x3E}}
+gGpioDxeConfigGuid  =  {0x06985984, 0xAFA3, 0x429C, {0x80, 0xCD, 0x69, 0x43, 0xF3, 0x38, 0x31, 0x4D}}
+gFivrConfigGuid  =  {0x68EE8BD4, 0x05F2, 0x4656, {0xAE, 0xE4, 0xAD, 0x10, 0xC7, 0x22, 0xC3, 0x4F}}
+gThcConfigGuid  =  {0x1B318AD1, 0xAA0D, 0x4764, {0x99, 0xFD, 0xBB, 0x2B, 0xF4, 0x7F, 0x7E, 0xD6}}
+gIehConfigGuid  =  {0x42C4D7F3, 0x981D, 0x4475, {0xA2, 0xAE, 0xAD, 0xCD, 0xD5, 0xCE, 0x87, 0x1E}}
+gRtcConfigGuid  =  {0x0E9259B8, 0x3DDE, 0x40C7, {0xAA, 0x5F, 0x94, 0x82, 0x9A, 0x86, 0x8F, 0xAF}}
+gCnviConfigGuid =  {0xa660970e, 0x511b, 0x46bb, {0xa7, 0xb8, 0xec, 0xdd, 0xf5, 0xe2, 0x2d, 0x73}}
+gGpioCheckConflictHobGuid = {0x5603f872, 0xefac, 0x40ae, {0xb9, 0x7e, 0x13, 0xb2, 0xf8, 0x07, 0x80, 0x21}}
+gPsfConfigGuid  =  {0x49B12CF6, 0x0A56, 0x4B9F, {0xA8, 0x4C, 0xF5, 0x7D, 0x21, 0x23, 0x8C, 0x77}}
+gHybridStorageConfigGuid = {0x265CE069, 0xD8CF, 0x48BE, {0xAE, 0x12, 0x02, 0x4C, 0x25, 0x12, 0xFA, 0xF8}}
+gHybridStorageHobGuid = {0xFF91F620, 0x069E, 0x4191, {0x83, 0x73, 0x11, 0x60, 0x9F, 0x24, 0x90, 0xEB}}
+gAdrConfigGuid = {0x5B36A07C, 0x3BBF, 0x4D53, {0x8A, 0x2D, 0xE1, 0xCF, 0x97, 0x39, 0x0C, 0x65}}
+gSpiConfigGuid = {0xD61A6A07, 0xAD25, 0xBFC2, {0x8C, 0x60, 0xD0, 0xD1, 0xF4, 0x13, 0x14, 0xBC}}
+
+##
+## Fusa
+##
+gFusaConfigGuid =  {0xF9225896, 0xA9C8, 0x4543, {0xBA, 0x9E, 0x53, 0x32, 0xD7, 0xBF, 0x8C, 0x2B}}
+gSiFusaInfoGuid = {0xcc7876ba, 0xee7b, 0x4bd4, {0x99, 0x4b, 0x7e, 0xc9, 0x74, 0xc9, 0xd8, 0x43}}
+
+##
+## SecurityPkg
+##
+## GUID used to "Tcg2PhysicalPresence" variable and "Tcg2PhysicalPresenceFlags" variable for TPM2 request and response.
+#  Include/Guid/Tcg2PhysicalPresenceData.h
+gEfiTcg2PhysicalPresenceGuid          = { 0xaeb9c5c1, 0x94f1, 0x4d02, { 0xbf, 0xd9, 0x46, 0x2, 0xdb, 0x2d, 0x3c, 0x54 }}
+gEfiTrEEPhysicalPresenceGuid          =  {0xf24643c2, 0xc622, 0x494e, {0x8a, 0x0d, 0x46, 0x32, 0x57, 0x9c, 0x2d, 0x5b}}
+gTcoWdtHobGuid                        = { 0x3e405418, 0x0d8c, 0x4f1a, { 0xb0, 0x55, 0xbe, 0xf9, 0x08, 0x41, 0x46, 0x8d }}
+
+##
+## UEFI Variable Support (Direct SPI and UFS)
+##
+gCseVariableStoragePpiInstanceGuid         = { 0x9513730d, 0x06ce, 0x4cf6, { 0x9d, 0x95, 0xb0, 0x76, 0x31, 0xbc, 0xd5, 0xa9}}
+gFvbVariableStoragePpiInstanceGuid         = { 0x5067b88a, 0xaa37, 0x414d, { 0xa3, 0xca, 0xc8, 0x37, 0xfc, 0xec, 0xd6, 0xf3}}
+gCseVariableStorageProtocolInstanceGuid    = { 0x5d5ede0b, 0x5d93, 0x4aae, { 0xa8, 0xec, 0x08, 0x41, 0xd0, 0x53, 0x85, 0xc4}}
+gFvbVariableStorageProtocolInstanceGuid    = { 0xe98252e8, 0xf209, 0x4ef5, { 0xab, 0x7e, 0x12, 0x69, 0x45, 0x14, 0x47, 0xbe}}
+gPeiVariableCacheHobGuid                   = { 0x35212b29, 0x128a, 0x4754, { 0xb9, 0x96, 0x62, 0x45, 0xcc, 0xa8, 0xa0, 0x66}}
+gCseVariableStorageSecurePreMemoryDataGuid = { 0xa1749e1e, 0x8ce1, 0x4310, { 0xbd, 0x3f, 0x64, 0xc9, 0x01, 0xc6, 0x13, 0xc2}}
+gCseVariableStorageGeneralDataAreaGuid     = { 0x6d7a6128, 0x685b, 0x4f75, { 0x87, 0x87, 0xba, 0x93, 0x08, 0x60, 0x75, 0x0c}}
+gCseVariableStorageFileSystemGuid          = { 0xdb798aca, 0x3533, 0x41c7, { 0x9a, 0x98, 0x00, 0x31, 0x1b, 0x66, 0x0a, 0x15}}
+gBugCheckVariableGuid                      = { 0xba57e015, 0x65b3, 0x4c3c, { 0xb2, 0x74, 0x65, 0x91, 0x92, 0xf6, 0x99, 0xe3}}
+
+##
+## PreMem Performance
+##
+gPerfPchPrePolicyGuid     = {0x3112356F, 0xCC77, 0x4E82, {0x86, 0xD5, 0x3E, 0x25, 0xEE, 0x81, 0x92, 0xA4}}
+gPerfSiValidateGuid       = {0x681F96E6, 0xF9CF, 0x464D, {0x97, 0x9A, 0xB1, 0x11, 0x33, 0xDE, 0x37, 0xA9}}
+gPerfPchValidateGuid      = {0xD0FF37D6, 0xA569, 0x4058, {0xB3, 0xDA, 0x29, 0x0B, 0x38, 0xC5, 0x32, 0x25}}
+gPerfAmtValidateGuid      = {0x9E949422, 0x4A7A, 0x4E41, {0xB0, 0xAB, 0x3C, 0x0D, 0x88, 0x0A, 0x00, 0xFF}}
+gPerfCpuValidateGuid      = {0xB760CFCC, 0xDEEF, 0x4C7E, {0x99, 0x5B, 0xED, 0xFE, 0xF2, 0x23, 0xB2, 0x09}}
+gPerfMeValidateGuid       = {0x8CF7A498, 0x588D, 0x4D39, {0xBD, 0xAC, 0x51, 0x0C, 0x31, 0xAF, 0x45, 0xD0}}
+gPerfSaValidateGuid       = {0xA73B382B, 0x62D4, 0x4A19, {0xBB, 0xF9, 0x09, 0x3E, 0xC5, 0xA5, 0x93, 0x11}}
+gPerfHeciPreMemGuid       = {0xD815D922, 0x4994, 0x40B3, {0x97, 0xCC, 0x07, 0xF3, 0x7D, 0x42, 0xE7, 0x97}}
+gPerfPchPreMemGuid        = {0xBB73E2B1, 0xB9FD, 0x4A80, {0xB8, 0x1A, 0x52, 0x39, 0xE9, 0x4D, 0x06, 0x2E}}
+gPerfCpuPreMemGuid        = {0xAC5FCBC6, 0x084D, 0x445D, {0xB3, 0xF3, 0xCA, 0x16, 0xDE, 0xE9, 0xBB, 0x47}}
+gPerfMePreMemGuid         = {0x6051338E, 0x0FFA, 0x40F7, {0xAF, 0xEF, 0xAB, 0x86, 0x7A, 0x38, 0xCC, 0xF3}}
+gPerfAmtPreMemGuid        = {0xDB732D50, 0x9BB8, 0x489A, {0xA1, 0xD1, 0xDD, 0xD2, 0x16, 0x1D, 0x72, 0xB8}}
+gPerfAmtPostMemGuid       = {0x0329D610, 0x4269, 0xD28F, {0x61, 0xBF, 0xB9, 0xA2, 0xD9, 0xFA, 0x96, 0x93}}
+gPerfSaPreMemGuid         = {0x76F18BDA, 0x2195, 0x4FB6, {0x9A, 0x94, 0x0E, 0x0B, 0xAC, 0xDE, 0xEC, 0xAB}}
+gPerfEvlGuid              = {0x8221518B, 0xAC19, 0x4E32, {0xAB, 0x5F, 0x00, 0x47, 0x0A, 0x50, 0x69, 0x40}}
+gPerfMemGuid              = {0x2B57B316, 0x5CF7, 0x4847, {0xB0, 0x76, 0x6B, 0x5D, 0x23, 0xC3, 0xAA, 0x3E}}
+
+##
+## PostMem Performance
+##
+gPerfPchPostMemGuid       = {0x70B67A99, 0x5556, 0x4315, {0xB3, 0x05, 0xD5, 0xDC, 0x4A, 0x35, 0x63, 0x70}}
+gPerfSaPostMemGuid        = {0x9FF0CE92, 0x883F, 0x43DC, {0x8A, 0x07, 0xE0, 0xCB, 0x6D, 0x56, 0x7D, 0xE0}}
+gPerfS3CpuInitPostMemGuid = {0x976262C2, 0xD202, 0x4D12, {0x82, 0xAD, 0xF4, 0xA9, 0x8F, 0x9B, 0x96, 0x01}}
+gPerfSaSecLockPostMemGuid = {0x272AC110, 0x0B60, 0x4D07, {0xA5, 0x58, 0x6D, 0x73, 0xE2, 0x43, 0x85, 0x95}}
+gPerfCpuStrapPostMemGuid  = {0x8EF4372B, 0x68F0, 0x4957, {0xBC, 0x4D, 0x7E, 0x5C, 0xFE, 0xDA, 0xB6, 0x3E}}
+gPerfMpPostMemGuid        = {0xA59BAC5B, 0xC6A4, 0x4AEB, {0x84, 0x32, 0x7A, 0x8B, 0x6B, 0x68, 0x5F, 0x37}}
+gPerfCpuPostMemGuid       = {0xE2FE5ED3, 0x1417, 0x451A, {0x95, 0xC9, 0xD0, 0xB2, 0xB9, 0x7B, 0xE0, 0x54}}
+gPerfSaResetPostMemGuid   = {0xBE152BEE, 0xFD19, 0x4274, {0xA8, 0xBA, 0xFB, 0x31, 0x42, 0xB5, 0xB5, 0xC3}}
+gPerfCpuPowerMgmtGuid     = {0x9ED307D6, 0x4AEB, 0x44A9, {0x9B, 0x11, 0xD8, 0x21, 0x84, 0x9A, 0xCB, 0xF7}}
+gPerfMePostMemGuid        = {0x2CC8626D, 0x3387, 0x4817, {0xAB, 0xF6, 0x86, 0x9A, 0xF5, 0xF0, 0x51, 0xAA}}
+gPerfHdaPostMemGuid       = {0xB31883B7, 0x5A05, 0x4040, {0x40, 0x80, 0x66, 0x8D, 0x29, 0x13, 0xD7, 0x84}}
+
+##
+## Dp-In Guid
+##
+## Include/DpInDataHob.h
+gDpInHobGuid = {0x3e110a83, 0xb94b, 0x4648, {0xa2, 0x26, 0x50, 0x9b, 0xd5, 0x55, 0xe3, 0x6b}}
+## Include/ConfigBlock/Tcss/DpInPreMemConfig.h
+gDpInPreMemConfigGuid = {0x80c14ba, 0xcc84, 0x4746, {0xbf, 0x6b, 0xd1, 0xf1, 0x8e, 0xaa, 0xe8, 0x35}}
+
+[Protocols.common.Private]
+##
+## SA
+##
+gSaIotrapSmiProtocolGuid    = { 0x1861e089, 0xcaa3, 0x473e, { 0x84, 0x32, 0xdc, 0x1f, 0x94, 0xc6, 0xc1, 0xa6 }}
+gCpuPcieIoTrapProtocolGuid  = { 0xda904080, 0x33ab, 0x48ca, { 0x97, 0x5b, 0x5f, 0x2f, 0x23, 0x8a, 0x41, 0xb4 }}
+
+gPchPcieIoTrapProtocolGuid      = { 0xd66a1cf,  0x79ad, 0x494b, { 0x97, 0x8b, 0xb2, 0x59, 0x81, 0x68, 0x93, 0x34 }}
+
+[Protocols]
+##
+## MdeModulePkg
+##
+gEfiSmmVariableProtocolGuid  =  {0xed32d533, 0x99e6, 0x4209, {0x9c, 0xc0, 0x2d, 0x72, 0xcd, 0xd9, 0x98, 0xa7}}
+gEdkiiPlatformSpecificResetFilterProtocolGuid  = { 0x695d7835, 0x8d47, 0x4c11, { 0xab, 0x22, 0xfa, 0x8a, 0xcc, 0xe7, 0xae, 0x7a } }
+gEdkiiPlatformSpecificResetHandlerProtocolGuid = { 0x2df6ba0b, 0x7092, 0x440d, { 0xbd, 0x4, 0xfb, 0x9, 0x1e, 0xc3, 0xf3, 0xc1 } }
+
+##
+## SystemAgent
+##
+gBdatAccessGuid                 =  {0x9477482c, 0x8717, 0x4725, {0x98, 0x28, 0x7b, 0xd8, 0xc9, 0xa3, 0x75, 0x6a}}
+gIgdOpRegionProtocolGuid        =  {0x9e67aecf, 0x4fbb, 0x4c84, {0x99, 0xa5, 0x10, 0x73, 0x40, 0x7,  0x6d, 0xb4}}
+gMemInfoProtocolGuid            =  {0xd4d2f201, 0x50e8, 0x4d45, {0x8e, 0x5,  0xfd, 0x49, 0xa8, 0x2a, 0x15, 0x69}}
+gSaPolicyProtocolGuid           =  {0xc6aa1f27, 0x5597, 0x4802, {0x9f, 0x63, 0xd6, 0x28, 0x36, 0x59, 0x86, 0x35}}
+gSaNvsAreaProtocolGuid          =  {0x149a10a5, 0x9d06, 0x4c6b, {0xbe, 0x44, 0x08, 0x92, 0xce, 0x20, 0x61, 0xac}}
+gGopPolicyProtocolGuid          =  {0xec2e931b, 0x3281, 0x48a5, {0x81, 0x07, 0xdf, 0x8a, 0x8b, 0xed, 0x3c, 0x5d}}
+gGen12PolicyProtocolGuid        =  {0x40f60ea0, 0x6c96, 0x4ed3, {0x96, 0xe5, 0xba, 0x6f, 0x6d, 0x66, 0x28, 0x9f}}
+gGen9PolicyProtocolGuid         =  {0xeaaed1ba, 0xf15c, 0x4112, {0xb5, 0x82, 0x90, 0x63, 0xac, 0xa0, 0x7f, 0x06}}
+gGopComponentName2ProtocolGuid  =  {0x651b7ebd, 0xce13, 0x41d0, {0x82, 0xe5, 0xa0, 0x63, 0xab, 0xbe, 0x9b, 0xb6}}
+gGopOverrideProtocolGuid        =  {0x4a89a16e, 0x67b8, 0x4429, {0x8c, 0x47, 0x43, 0x67, 0x90, 0xf2, 0xf2, 0x69}}
+gMemoryAddressEncodeDecodeProtocolGuid = {0x603df7ca, 0x1ba8, 0x4c12, {0xa9, 0x8a, 0x49, 0x6d, 0xfe, 0x77, 0xeb, 0xdf}}
+
+##
+## TBT
+##
+gITbtPolicyProtocolGuid       =  {0xb0563c42, 0x28ea, 0x40e6, {0x99, 0x84, 0xd5, 0xbf, 0xf8, 0xb0, 0x40, 0x56}}
+gITbtNvsAreaProtocolGuid      =  {0xdabf85bd, 0xfbdc, 0x4ed2, {0xb1, 0x0d, 0xc9, 0x08, 0xd0, 0x8c, 0xee, 0xe8}}
+gDisableITbtBmeProtocolGuid      =  {0x89a9adc3, 0x9b7c, 0x4b53, {0x82, 0xbf, 0x78, 0x72, 0x6b, 0x91, 0x4f, 0x9f}}
+
+##
+## Cpu
+##
+gCpuInfoProtocolGuid  =  {0xe223cf65, 0xf6ce, 0x4122, {0xb3, 0xaf, 0x4b, 0xd1, 0x8a, 0xff, 0x40, 0xa1}}
+gSmmBiosGuardProtocolGuid  =  {0x17565311, 0x4b71, 0x4340, {0x88, 0xaa, 0xdc, 0x9f, 0x44, 0x22, 0xe5, 0x3a}}
+gCpuNvsAreaProtocolGuid  =  {0xb9cf3f43, 0xbe3e, 0x4e45, {0xa0, 0xbe, 0x1a, 0x4, 0x89, 0xdf, 0x1a, 0xc9}}
+gDxeCpuPolicyProtocolGuid  =  {0x8282b977, 0x22f9, 0x4134, {0x99, 0x43, 0x7b, 0xcc, 0x5f, 0x40, 0x33, 0x52}}
+gBiosGuardNvsAreaProtocolGuid  =  {0x5df588da, 0x991e, 0x4a7f, {0x80, 0x51, 0x70, 0xc7, 0x12, 0xb7, 0xba, 0xb0}}
+gSmmResourceConfigProtocolGuid = {0xA37FC2D2, 0x822D, 0x4A63, {0x9C, 0x42, 0xBE, 0xB1, 0xD6, 0xEE, 0x85, 0x39}}
+
+##
+## Me
+##
+gActiveManagementProtocolGuid     = {0xd25dc167, 0xeb6a, 0x432d, {0x65, 0x91, 0xbf, 0x80, 0x29, 0xb0, 0x05, 0xbb}}
+gAlertStandardFormatProtocolGuid  = {0x45de9920, 0xcd54, 0x446a, {0xa0, 0x3c, 0x22, 0xe6, 0xfb, 0xb4, 0x51, 0xe4}}
+gHeciProtocolGuid                 = {0x3c7bc880, 0x41f8, 0x4869, {0xae, 0xfc, 0x87, 0x0a, 0x3e, 0xd2, 0x82, 0x99}}
+gHeciFlowProtocolGuid             = {0x1498d127, 0x123c, 0x4e52, {0x84, 0x00, 0xcc, 0x3c, 0x9f, 0x79, 0xc4, 0x0e}}
+gMebxProtocolGuid                 = {0x01ab1829, 0xcecd, 0x4cfa, {0xa1, 0x8c, 0xea, 0x75, 0xd6, 0x6f, 0x3e, 0x74}}
+gDxeMePolicyGuid                  = {0xa0b5dc52, 0x4f34, 0x3990, {0xd4, 0x91, 0x10, 0x8b, 0xe8, 0xba, 0x75, 0x42}}
+gMeInfoProtocolGuid               = {0x7523c8e4, 0x4fbe, 0x9661, {0x29, 0x96, 0x14, 0x97, 0xff, 0x36, 0x2f, 0x3b}}
+gPlatformMeHookProtocolGuid       = {0xbc52476e, 0xf67e, 0x4301, {0xb2, 0x62, 0x36, 0x9c, 0x48, 0x78, 0xaa, 0xc2}}
+gMeNvsAreaProtocolGuid            = {0x3bffecfd, 0xd75f, 0x4975, {0xb8, 0x88, 0x39, 0x02, 0xbd, 0x69, 0x00, 0x2b}}
+gJhiProtocolGuid                  = {0xccba3051, 0xa574, 0x4f9d, {0x96, 0xf4, 0xec, 0x0d, 0x4a, 0x87, 0xbc, 0x5a}}
+gIntegratedTouchHidProtocolGuid   = {0x3d0479c1, 0x6b19, 0x4191, {0xb8, 0x09, 0x60, 0x08, 0xdd, 0x07, 0x97, 0x55}}
+gIntegratedTouchProtocolGuid      = {0x2b12e46f, 0x3c24, 0x47ff, {0x8b, 0x89, 0xc0, 0x60, 0x2c, 0x1c, 0x61, 0x42}}
+gMeEopDoneProtocolGuid            = {0x8d9b3387, 0x73db, 0x456f, {0x88, 0x9d, 0x6f, 0xfe, 0x90, 0x82, 0x64, 0x09}}
+gMeSendEopInFspProtocolGuid       = {0xcecdba92, 0x76c6, 0x4063, {0xaa, 0x6b, 0x19, 0xfc, 0x60, 0x5c, 0x70, 0xff}}
+
+gHeciAccessProtocolGuid          = {0x3a5aab32, 0xd5a7, 0x4ce8, {0x88, 0xe2, 0xed, 0x8f, 0x7b, 0x43, 0x23, 0x9d}}
+gHeciTransportProtocolGuid       = {0x9fc932b9, 0x8851, 0x43f7, {0x8a, 0x58, 0xa8, 0xd9, 0x04, 0x01, 0xcd, 0x78}}
+gHeciControlProtocolGuid         = {0xd86381d8, 0xff7e, 0x462e, {0x9b, 0x55, 0x02, 0x0a, 0x64, 0x1b, 0xe3, 0x4f}}
+gHeciAccessSmmProtocolGuid       = {0x5da6182c, 0xf679, 0x49eb, {0x96, 0xf5, 0xe6, 0x24, 0x9b, 0x54, 0x0b, 0x96}}
+gHeciTransportSmmProtocolGuid    = {0xf5f7b292, 0xbb38, 0x4e59, {0xa1, 0x6e, 0x0f, 0x27, 0x15, 0xd4, 0xb7, 0xf4}}
+gHeciControlSmmProtocolGuid      = {0x7e1e508d, 0x7def, 0x4d69, {0xa9, 0xb3, 0xa5, 0x23, 0xe8, 0x48, 0xc6, 0x98}}
+
+##
+## Amt
+##
+gAmtSaveMebxProtocolGuid          = {0x86682c04, 0xea42, 0x49e5, {0x96, 0x81, 0xe3, 0x32, 0xaa, 0xb0, 0x9e, 0xd7}}
+gDxeAmtPolicyGuid                 = {0x6725e645, 0x4a7f, 0x9969, {0x82, 0xec, 0xd1, 0x87, 0x21, 0xde, 0x5a, 0x57}}
+gAmtReadyToBootProtocolGuid       = {0xcc9d5c0b, 0x9010, 0x45f1, {0x99, 0x3c, 0x83, 0x27, 0x67, 0xf1, 0x67, 0x77}}
+gMeSmbiosTablesUpdateProtocolGuid = {0x5054ee06, 0x4ce0, 0x4acc, {0x9a, 0x80, 0xdf, 0x73, 0xbf, 0xa5, 0x38, 0xdd}}
+gOneClickRecoveryProtocolGuid     = {0x93598eac, 0xc62b, 0x4dbb, {0x96, 0x76, 0xe0, 0x5e, 0x8c, 0xc3, 0x84, 0x44}}
+
+##
+## PCH
+##
+gThcProtocolGuid  = {0x00860921, 0x7B9B, 0x4EA8, {0xAD, 0x23, 0x3C, 0xCA, 0x33, 0x9E, 0x7D, 0xFE}}
+gPchSpiProtocolGuid  =  {0xc7d289, 0x1347, 0x4de0, {0xbf, 0x42, 0xe, 0x26, 0x9d, 0xe, 0xf3, 0x4a}}
+gWdtProtocolGuid  =  {0xb42b8d12, 0x2acb, 0x499a, {0xa9, 0x20, 0xdd, 0x5b, 0xe6, 0xcf, 0x09, 0xb1}}
+gPchSerialIoUartDebugInfoProtocolGuid  =  {0x2fd2b1bd, 0x0387, 0x4ec6, {0x94, 0x1f, 0xf1, 0x4b, 0x7f, 0x1c, 0x94, 0xb6}}
+gEfiSmmSmbusProtocolGuid  =  {0x72e40094, 0x2ee1, 0x497a, {0x8f, 0x33, 0x4c, 0x93, 0x4a, 0x9e, 0x9c, 0x0c}}
+gPchSmmSpiProtocolGuid  =  {0x56521f06, 0xa62, 0x4822, {0x99, 0x63, 0xdf, 0x1, 0x9d, 0x72, 0xc7, 0xe1}}
+gPchSmmIoTrapControlGuid  =  {0x514d2afd, 0x2096, 0x4283, {0x9d, 0xa6, 0x70, 0x0c, 0xd2, 0x7d, 0xc7, 0xa5}}
+gPchTcoSmiDispatchProtocolGuid  =  {0x9e71d609, 0x6d24, 0x47fd, {0xb5, 0x72, 0x61, 0x40, 0xf8, 0xd9, 0xc2, 0xa4}}
+gPchPcieSmiDispatchProtocolGuid  =  {0x3e7d2b56, 0x3f47, 0x42aa, {0x8f, 0x6b, 0x22, 0xf5, 0x19, 0x81, 0x8d, 0xab}}
+gPchAcpiSmiDispatchProtocolGuid  =  {0xd52bb262, 0xf022, 0x49ec, {0x86, 0xd2, 0x7a, 0x29, 0x3a, 0x7a, 0x05, 0x4b}}
+gPchSmiDispatchProtocolGuid  =  {0xE6A81BBF, 0x873D, 0x47FD, {0xB6, 0xBE, 0x61, 0xB3, 0xE5, 0x72, 0x09, 0x93}}
+gPchNvsAreaProtocolGuid  =  {0x2e058b2b, 0xedc1, 0x4431, {0x87, 0xd9, 0xc6, 0xc4, 0xea, 0x10, 0x2b, 0xe3}}
+gPchEspiSmiDispatchProtocolGuid  =  {0xB3C14FF3, 0xBAE8, 0x456C, {0x86, 0x31, 0x27, 0xFE, 0x0C, 0xEB, 0x34, 0x0C}}
+gPchSmmPeriodicTimerControlGuid  =  {0x6906E93B, 0x603B, 0x4A0F, {0x86, 0x92, 0x83, 0x20, 0x04, 0xAA, 0xF2, 0xDB}}
+gIoTrapExDispatchProtocolGuid  =  {0x5B48E913, 0x707B, 0x4F9D, {0xAF, 0x2E, 0xEE, 0x03, 0x5B, 0xCE, 0x39, 0x5D}}
+gPchPolicyProtocolGuid           =  {0x543d5c93, 0x6a28, 0x4513, {0x85, 0x9a, 0x82, 0xa7, 0xb9, 0x12, 0xcb, 0xbe}}
+gScsEmmcSoftwareTuningProtocolGuid = {0x972215b2, 0x9616, 0x4de4, {0xa9, 0x75, 0xb0, 0x74, 0x3e, 0xe1, 0x78, 0x54}}
+
+##
+## Hsti
+##
+## HstiSiliconDxe Driver Entry Point
+gHstiProtocolGuid = { 0x1b05de41, 0xc93b, 0x4bb4, { 0xad, 0x47, 0x2a, 0x78, 0xac, 0xf, 0xc9, 0xe4 }}
+## Handler to gather and publish HSTI results on ReadyToBootEvent
+gHstiPublishCompleteProtocolGuid =  {0x0f500be6, 0xece4, 0x4ed8, { 0x90, 0x81, 0x9a, 0xa9, 0xa5, 0x23, 0xfb, 0x7b}}
+gEfiAdapterInformationProtocolGuid = { 0xE5DD1403, 0xD622, 0xC24E, {0x84, 0x88, 0xC7, 0x1B, 0x17, 0xF5, 0xE8, 0x02 }}
+
+##
+## Silicon Policy
+##
+## Include/Protocol/SiPolicyProtocol.h
+gDxeSiPolicyProtocolGuid = { 0xeca27516, 0x306c, 0x4e28, { 0x8c, 0x94, 0x4e, 0x52, 0x10, 0x96, 0x69, 0x5e }}
+
+##
+## DGR
+##
+gEfiSpaLogOutputProtocolGuid = { 0x1d10d46b, 0x0306, 0x454a, { 0x90, 0x8c, 0x93, 0x65, 0xb3, 0x8a, 0x90, 0x26 }}
+
+[Ppis.common.Private]
+gPchHsioChipsetInitSusTblDataPpiGuid = { 0x97ed4e5d, 0x01a5, 0x4a3c, { 0xb7, 0xe9, 0x1a, 0x4e, 0xa3, 0xdd, 0x23, 0xce }}
+gHybridStorageCfgPpiGuid = {0x8557e481, 0xc00e, 0x4929, {0xb4, 0x53, 0xf6, 0xc2, 0x53, 0x79, 0xb0, 0x13}}
+
+[Ppis]
+##
+## MdeModulePkg
+##
+gPeiCapsulePpiGuid  =  {0x3acf33ee, 0xd892, 0x40f4, {0xa2, 0xfc, 0x38, 0x54, 0xd2, 0xe1, 0x32, 0x3d}}
+gPeiSmmControlPpiGuid  =  {0x61c68702, 0x4d7e, 0x4f43, {0x8d, 0xef, 0xa7, 0x43, 0x05, 0xce, 0x74, 0xc5}}
+gEdkiiPlatformSpecificResetFilterPpiGuid = { 0x8c9f4de3, 0x7b90, 0x47ef, { 0x93, 0x8, 0x28, 0x7c, 0xec, 0xd6, 0x6d, 0xe8 } }
+gEdkiiPlatformSpecificResetNotificationPpiGuid = { 0xe09f355d, 0xdae8, 0x4910, { 0xb1, 0x4a, 0x92, 0x78, 0xf, 0xdc, 0xf7, 0xcb } }
+gEdkiiPlatformSpecificResetHandlerPpiGuid = { 0x75cf14ae, 0x3441, 0x49dc, { 0xaa, 0x10, 0xbb, 0x35, 0xa7, 0xba, 0x8b, 0xab } }
+
+##
+## SecurityPkg
+##
+gPeiTpmInitializedPpiGuid  =  {0xe9db0d58, 0xd48d, 0x47f6, {0x9c, 0x6e, 0x6f, 0x40, 0xe8, 0x6c, 0x7b, 0x41}}
+gPeiTpmInitializationDonePpiGuid = {0xa030d115, 0x54dd, 0x447b, { 0x90, 0x64, 0xf2, 0x6, 0x88, 0x3d, 0x7c, 0xcc}}
+##
+## Common
+##
+## Include/Ppi/SiPolicy.h
+gSiPolicyPpiGuid  =  {0xaebffa01, 0x7edc, 0x49ff, {0x8d, 0x88, 0xcb, 0x84, 0x8c, 0x5e, 0x86, 0x70}}
+## Include/Ppi/SiPolicy.h
+gSiPreMemPolicyPpiGuid = {0xc133fe57, 0x17c7, 0x4b09, {0x8b, 0x3c, 0x97, 0xc1, 0x89, 0xd0, 0xab, 0x8d}}
+gFspApiModePpiGuid          = {0xa1eeab87, 0xc859, 0x479d, {0x89, 0xb5, 0x14, 0x61, 0xf4, 0x06, 0x1a, 0x3e}}
+## Silicon Initialization PPI is used to export End of Silicon init.
+gEndOfSiInitPpiGuid         = {0xE2E3D5D1, 0x8356, 0x4F96, {0x9C, 0x9E, 0x2E, 0xC3, 0x48, 0x1D, 0xEA, 0x88}}
+gEfiEndOfPeiSignal2PpiGuid  = {0x22918381, 0xd018, 0x4d7c, {0x9d, 0x62, 0xf5, 0xa5, 0x70, 0x1c, 0x66, 0x80}}
+gFspTempRamExitPpiGuid      = {0xbc1cfbdb, 0x7e50, 0x42be, {0xb4, 0x87, 0x22, 0xe0, 0xa9, 0x0c, 0xb0, 0x52}}
+gFspmArchConfigPpiGuid      = {0x824d5a3a, 0xaf92, 0x4c0c, {0x9f, 0x19, 0x19, 0x52, 0x6d, 0xca, 0x4a, 0xbb}}
+gSiPreMemDefaultPolicyInitPpiGuid =  {0xfec36242, 0xf8d8, 0x4b43, {0x87, 0x94, 0x4f, 0x1f, 0x9f, 0x63, 0x8d, 0xdc}}
+gSiPreMemPolicyReadyPpiGuid = {0x85270bef, 0x6984, 0x4375, {0xa6, 0xea, 0xb5, 0xaa, 0x90, 0x6e, 0xdd, 0x4a}}
+gSiDefaultPolicyInitPpiGuid = {0xf69abf86, 0x4048, 0x44ef, { 0xa8, 0xef, 0x6c, 0x7f, 0x20, 0x4a, 0xc8, 0xda}}
+gSiPolicyReadyPpiGuid       = {0xd570de8c, 0xb9c4, 0x4ffa, {0xad, 0xee, 0xa5, 0x82, 0x7c, 0xe3, 0x17, 0x79}}
+
+##
+## UEFI Variable Support (Override Until BP1.5)
+##
+gEdkiiVariableStoragePpiGuid  =  { 0x90d915c5, 0xe4c1, 0x4da8, {0xa7, 0x6f, 0x9,  0xe5, 0x78, 0x91, 0x65, 0x48}}
+gEdkiiVariableStorageSelectorPpiGuid  =  { 0x782546d1, 0x03ab, 0x41e4, {0xa0, 0x1d, 0x7a, 0x9b, 0x22, 0xba, 0x2e, 0x1e}}
+gReadOnlyVariablePreMemoryDescriptorPpiGuid  =  { 0xbe136fc9, 0xc277, 0x4dd1, {0xbe, 0x42, 0xce, 0xf0, 0x9f, 0xf4, 0x3f, 0x55}}
+gEfiReadyToInstallEndOfPei2PpiGuid = {0xeef72924, 0x2db2, 0x4569, { 0x86, 0x3f, 0xd4, 0x86, 0xae, 0x7a, 0xe4, 0x12}}
+
+##
+## SystemAgent
+##
+gSsaBiosCallBacksPpiGuid  =  {0x99b56126, 0xe16c, 0x4d9b, {0xbb, 0x71, 0xaa, 0x35, 0x46, 0x1a, 0x70, 0x2f}}
+gSsaBiosServicesPpiGuid   =  {0x55750d10, 0x6d3d, 0x4bf5, {0x89, 0xd8, 0xe3, 0x5e, 0xf0, 0xb0, 0x90, 0xf4}}
+gEnablePeiGraphicsPpiGuid =  {0x8e3bb474, 0x545,  0x4902, {0x86, 0xb0, 0x6c, 0xb5, 0xe2, 0x64, 0xb4, 0xa5}}
+gPeiGraphicsFramebufferReadyPpiGuid = {0x590ad868, 0xb0b1, 0x4d20, {0x91, 0xff, 0xc2, 0xa9, 0xd6, 0x88, 0x81, 0x94}}
+gMrcMemoryInitDonePpiGuid =  {0x0ff07255, 0x67c2, 0x456d, {0x9a, 0x95, 0xc9, 0x16, 0x2c, 0x23, 0x86, 0x8d}}
+## X Compatibility support PPI
+gCompatibleMemoryInitPpiGuid = {0xca311f82, 0xf490, 0x4b12, {0x9e, 0xe1, 0x2b, 0x66, 0xa3, 0x6c, 0x3e, 0xa}}
+gVmdInitDonePpiGuid =          {0x42a187c8, 0xca0a, 0x4750, {0x82, 0xfd, 0xc9, 0xa0, 0xd5, 0x9, 0xfe, 0xd1}}
+
+##
+## TwoLm
+##
+gMrcMemoryInitDonePpiGuid  = { 0x598907f5, 0xd5fc, 0x435c, { 0x8a, 0x7f, 0x53, 0xc5, 0xa4, 0xb5, 0x31, 0xc4}}
+
+##
+## Nvdimm Cache Info
+##
+gNvdimmCachePpiGuid  = { 0x1bbc5601, 0xe571, 0x4ae0, { 0xbc, 0x38, 0xb8, 0x65, 0x0d, 0x50, 0x6f, 0x5b}}
+
+##
+## Cpu
+##
+gPeiCachePpiGuid  =  {0x09be4bc2, 0x790e, 0x4dea, {0x8b, 0xdc, 0x38, 0x05, 0x16, 0x98, 0x39, 0x44}}
+gPeiTxtMemoryUnlockedPpiGuid  =  {0x38cdd10b, 0x767d, 0x4f6e, {0xa7, 0x44, 0x67, 0xee, 0x1d, 0xfe, 0x2f, 0xa5}}
+gPeiTxtReadyToRunMemoryInitPpiGuid = {0x9ecafd30, 0x29e2, 0x42f6, {0xba, 0xf3, 0x8b, 0x7d, 0xb8, 0xfe, 0x1f, 0x22}}
+gPeiReadyToInstallMpPpiGuid = { 0x1a266768, 0xfd43, 0x4e18, { 0xa8, 0x8a, 0x35, 0xc7, 0x94, 0xc3, 0x91, 0x0e }}
+##
+## Me
+##
+gHeciPpiGuid  =  {0xd14319e2, 0x407a, 0x9580, {0x8d, 0xe5, 0x51, 0xa8, 0xff, 0xc6, 0xd7, 0xd7}}
+gMbpSensitivePpiGuid  =  {0xed7c9ce9, 0x5912, 0x4807, {0xec, 0x90, 0x22, 0x18, 0xbc, 0x7b, 0xfc, 0x6c}}
+gHeci3IntegratedTouchControllerGuid  =  {0x3e8d0870, 0x271a, 0x4208, {0x8e, 0xb5, 0x9a, 0xcb, 0x94, 0x02, 0xae, 0x04}}
+gSiNvmOwnershipAcquiredPpiGuid = {0xe5db3d8c, 0xefa4, 0x4308, {0x9a, 0xab, 0x6b, 0x97, 0x81, 0x09, 0x98, 0xa0}}
+gHeciAccessPpiGuid = {0x3a5aab32, 0xd5a7, 0x4ce8, {0x88, 0xe2, 0xed, 0x8f, 0x7b, 0x43, 0x23, 0x9d}}
+gHeciTransportPpiGuid = {0x9fc932b9, 0x8851, 0x43f7, {0x8a, 0x58, 0xa8, 0xd9, 0x04, 0x01, 0xcd, 0x78}}
+gHeciControlPpiGuid  = {0xd86381d8, 0xff7e, 0x462e, {0x9b, 0x55, 0x02, 0x0a, 0x64, 0x1b, 0xe3, 0x4f}}
+gMeBeforeDidSentPpiGuid = {0xd497b143, 0xf3ef, 0x4192, {0xa8, 0xc5, 0x5e, 0xf6, 0xcd, 0x6e, 0x4c, 0x87}}
+
+##
+## PCH
+##
+gWdtPpiGuid  =  {0xf38d1338, 0xaf7a, 0x4fb6, {0x91, 0xdb, 0x1a, 0x9c, 0x21, 0x83, 0x57, 0x0d}}
+gPchSpiPpiGuid  =  {0xdade7ce3, 0x6971, 0x4b75, {0x82, 0x5e, 0xe, 0xe0, 0xeb, 0x17, 0x72, 0x2d}}
+gPeiSmbusPolicyPpiGuid  =  {0x63b6e435, 0x32bc, 0x49c6, {0x81, 0xbd, 0xb7, 0xa1, 0xa0, 0xfe, 0x1a, 0x6c}}
+
+##
+## TCSS
+##
+gTcssPeiInitDonePpiGuid = {0x5ad291b8, 0xace4, 0x416a, {0xb7, 0x50, 0x7, 0x63, 0x59, 0xfc, 0xc1, 0x5b}}
+
+[LibraryClasses]
+## @libraryclass
+## Common
+##
+MmPciLib|Include/Library/MmPciLib.h
+
+## @libraryclass
+## SampleCode
+##
+## CPU
+##
+CpuPolicyLib|Cpu/Include/Library/CpuPolicyLib.h
+
+## @libraryclass
+## Me
+##
+
+MeChipsetLib|Me/Include/Library/MeChipsetLib.h
+
+PeiMePolicyLib|Me/Include/Library/PeiMePolicyLib.h
+PttHciLib|Me/Include/Library/PttHciLib.h
+PttHeciLib|Me/Include/Library/PttHeciLib.h
+## @libraryclass
+## Pch
+##
+GpioLib|Include/Library/GpioLib.h
+GpioLib|Include/Library/GpioNativeLib.h
+PchCycleDecodingLib|Pch/Include/Library/PchCycleDecodingLib.h
+EspiLib|Include/Library/PchEspiLib.h
+GbeLib|Include/Library/GbeLib.h
+GbeMdiLib|IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h
+PchHsioLib|Pch/IncludePrivate/PchHsio.h
+PchInfoLib|Pch/Include/Library/PchInfoLib.h
+PchP2sbLib|Pch/Include/Library/PchP2sbLib.h
+PchPcieRpLib|Pch/Include/Library/PchPcieRpLib.h
+PchPcrLib|Pch/Include/Library/PchPcrLib.h
+PchPolicyLib|Pch/Include/Library/PchPolicyLib.h
+PchSbiAccessLib|Pch/IncludePrivate/Library/PchSbiAccessLib.h
+SerialIoAccessLib|Include/Library/SerialIoAccessLib.h
+DxePchPolicyLib|Pch/Include/Library/DxePchPolicyLib.h
+
+## @libraryclass
+## Sa
+##
+DxeSaPolicyLib|SystemAgent/Include/Library/DxeSaPolicyLib.h
+SaPlatformLib|SystemAgent/Include/Library/SaPlatformLib.h
+Include/Library/VoltageRegulatorCommands.h
+
+[PcdsFixedAtBuild]
+## From MdeModulePkg.dec
+## Progress Code for S3 Suspend start.
+## PROGRESS_CODE_S3_SUSPEND_START   = (EFI_SOFTWARE_SMM_DRIVER | (EFI_OEM_SPECIFIC | 0x00000000))    = 0x03078000
+gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendStart|0x03078000|UINT32|0x30001032
+## Progress Code for S3 Suspend end.
+## PROGRESS_CODE_S3_SUSPEND_END   = (EFI_SOFTWARE_SMM_DRIVER | (EFI_OEM_SPECIFIC | 0x00000001))    = 0x03078001
+gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendEnd|0x03078001|UINT32|0x30001033
+##
+## PcdNemCodeCacheBase is usally the same as PEI FV Base address,
+## FLASH_BASE+FLASH_REGION_FV_RECOVERY_OFFSET from PlatformPkg.fdf.
+##
+## Restriction:
+## 1) PcdNemCodeCacheBase - (PcdTemporaryRamBase + PcdTemporaryRamSize) >= 4K
+## 2) PcdTemporaryRamBase >= 4G - 64M
+##
+gSiPkgTokenSpaceGuid.PcdNemCodeCacheBase|0xFFF80000|UINT32|0x20000009
+##
+## NemCodeCacheSize is usally the same as PEI FV Size,
+## FLASH_REGION_FV_RECOVERY_SIZE from PlatformPkg.fdf.
+##
+## Restriction:
+## 1) PcdNemTotalCacheSize = NemCodeCacheSize + PcdTemporaryRamSize
+## <= Maximun CPU NEM total size (Code + Data)
+## = LLC size - 0.5M
+## 2) PcdTemporaryRamSize  <= Maximum CPU NEM data size
+## =  MLC size
+## NOTE: The size restriction may be changed in next generation processor.
+## Please refer to Processor BWG for detail.
+##
+gSiPkgTokenSpaceGuid.PcdBiosAreaBaseAddress|0xFF800000|UINT32|0x10000001
+gSiPkgTokenSpaceGuid.PcdBiosSize|0x00800000|UINT32|0x10000002
+gSiPkgTokenSpaceGuid.PcdTemporaryRamBase|0xfef00000|UINT32|0x00010028
+gSiPkgTokenSpaceGuid.PcdTemporaryRamSize|0x2000|UINT32|0x00010029
+gSiPkgTokenSpaceGuid.PcdTopMemoryCacheSize|0x0|UINT32|0x0001002A
+gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvBase|0xFFE60000|UINT32|0x30000004
+gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvSize|0x000A0000|UINT32|0x30000005
+gSiPkgTokenSpaceGuid.PcdFlashMicrocodeOffset|0x00000060|UINT32|0x30000013
+gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvOffset|0x00660000|UINT32|0x30000006
+##
+## The CPU Trace Hub's BARs base and size
+##
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubMtbBarBase|0xfad00000|UINT32|0x30000007
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubMtbBarSize|0x100000|UINT32|0x30000008
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubSwBarBase|0xfc000000|UINT32|0x30000009
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubSwBarSize|0x800000|UINT32|0x3000000A
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubRtitBarBase|0xfacfc000|UINT32|0x3000000B
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubRtitBarSize|0x4000|UINT32|0x3000000C
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubFwBarBase|0xfae00000|UINT32|0x3000000D
+gSiPkgTokenSpaceGuid.PcdCpuTraceHubFwBarSize|0x200000|UINT32|0x3000000E
+
+gSiPkgTokenSpaceGuid.PcdFspWrapperEnable    |FALSE|BOOLEAN|0x3000000F
+gSiPkgTokenSpaceGuid.PcdFspBinaryEnable|FALSE|BOOLEAN|0x30000010
+gSiPkgTokenSpaceGuid.PcdEmbeddedEnable|0x0|UINT8|0x30000012
+
+##
+## PcdEfiGcdAllocateType is using for EFI_GCD_ALLOCATE_TYPE selection
+## value of the struct
+##  0x00 EfiGcdAllocateAnySearchBottomUp
+##  0x01 EfiGcdAllocateMaxAddressSearchBottomUp
+##  0x03 EfiGcdAllocateAnySearchTopDown
+##  0x04 EfiGcdAllocateMaxAddressSearchTopDown
+##
+##  below value should not using in this situation
+##  0x05 EfiGcdMaxAllocateType : design for max value of struct
+##  0x02 EfiGcdAllocateAddress : design for speccification address allocate
+##
+gSiPkgTokenSpaceGuid.PcdEfiGcdAllocateType|0x01|UINT8|0x40000000
+
+##
+##  Handshake register value driven to DMA controller PCIE venodr specific configuration register from FW
+##  (LC/CM to host)
+##
+gSiPkgTokenSpaceGuid.PcdITbtToPcieRegister|0xEC|UINT8|0x40000003
+##
+##  Handshake register value driven from DMA controller PCIE venodr specific configuration register to FW
+##  (HOST to LC/CM)
+##
+gSiPkgTokenSpaceGuid.PcdPcieToITbtRegister|0xF0|UINT8|0x40000004
+
+gSiPkgTokenSpaceGuid.PcdAbove4GBMmioBase|0x0000004000000000|UINT64|0x40000005
+gSiPkgTokenSpaceGuid.PcdAbove4GBMmioSize|0x0000004000000000|UINT64|0x40000006
+
+gSiPkgTokenSpaceGuid.PcdSmmEntryPointBinFile|{ 0x52, 0xce, 0xc8, 0xe0, 0x51, 0x2b, 0xc2, 0x4c, 0xb3, 0xc7, 0xd2, 0x11, 0xa6, 0x25, 0xc1, 0xba }|VOID*|0x40000007
+gSiPkgTokenSpaceGuid.PcdSpsBinFile|{ 0xEE, 0xE3, 0x34, 0x71, 0xA6, 0x7F, 0x89, 0x44, 0x87, 0xA7, 0xAE, 0x38, 0x98, 0x4E, 0xAE, 0xD8 }|VOID*|0x40000008
+gSiPkgTokenSpaceGuid.PcdSpsSmmEntryPointBinFile|{ 0x5B, 0x63, 0x7D, 0x7C, 0x9C, 0x8B, 0x3C, 0x46, 0x9F, 0x7F, 0x91, 0xF6, 0x09, 0x06, 0x84, 0x8F }|VOID*|0x40000009
+gSiPkgTokenSpaceGuid.PcdSpaBinFile|{ 0xE1, 0x19, 0xB7, 0x7B, 0x2A, 0x53, 0x40, 0x7B, 0xA3, 0x4C, 0xC4, 0xF9, 0xE2, 0x6C, 0x27, 0x74 }|VOID*|0x4000000A
+gSiPkgTokenSpaceGuid.PcdSpaSmmEntryPointBinFile|{ 0xD7, 0xAD, 0xB2, 0x9F, 0x4D, 0x53, 0x4B, 0xA6, 0x8D, 0x55, 0x5D, 0x28, 0x91, 0x60, 0x10, 0x19 }|VOID*|0x4000000B
+
+##
+## - DpIn Silicon Feature
+##
+#  Note: PcdDpInEnable is Default Disable. Override it based on Platform/ CPU
+gSiPkgTokenSpaceGuid.PcdDpInEnable|FALSE|BOOLEAN|0x4000000C
+#  Note: For PcdMaxDpInExtPortSupported, we can have Maximum value of 0x08.
+#    Please Don't exceed beyond that. As it will cause boundary overflow.
+#    Currently hadrware wise maximum Dp-In External Port supported is 4.
+#    And it will never exceed the value of 0x08. That's why we don't support
+#    PcdMaxDpInExtPortSupported value more than 0x08
+gSiPkgTokenSpaceGuid.PcdMaxDpInExtPortSupported|0x4|UINT8|0x4000000D
+
+gSiPkgTokenSpaceGuid.VtdEngine1BaseAddeess|0xFED90000|UINT32|0x50000001
+gSiPkgTokenSpaceGuid.VtdEngine2BaseAddeess|0xFED92000|UINT32|0x50000002
+gSiPkgTokenSpaceGuid.VtdEngine3BaseAddeess|0xFED91000|UINT32|0x50000003
+gSiPkgTokenSpaceGuid.VtdEngine4BaseAddeess|0xFED84000|UINT32|0x50000004
+gSiPkgTokenSpaceGuid.VtdEngine5BaseAddeess|0xFED85000|UINT32|0x50000005
+gSiPkgTokenSpaceGuid.VtdEngine6BaseAddeess|0xFED86000|UINT32|0x50000006
+gSiPkgTokenSpaceGuid.VtdEngine7BaseAddeess|0xFED87000|UINT32|0x50000007
+##
+## Those PCDs are used to control build process.
+##
+gSiPkgTokenSpaceGuid.PcdTraceHubEnable               |FALSE|BOOLEAN|0xF0000001
+gSiPkgTokenSpaceGuid.PcdSmmVariableEnable            |FALSE|BOOLEAN|0xF0000002
+gSiPkgTokenSpaceGuid.PcdAtaEnable                    |FALSE|BOOLEAN|0xF0000004
+gSiPkgTokenSpaceGuid.PcdAcpiEnable                   |TRUE |BOOLEAN|0xF0000009
+gSiPkgTokenSpaceGuid.PcdSourceDebugEnable            |FALSE|BOOLEAN|0xF000000B
+gSiPkgTokenSpaceGuid.PcdPpmEnable                    |TRUE |BOOLEAN|0xF000000C
+gSiPkgTokenSpaceGuid.PcdIntegratedTouchEnable        |FALSE|BOOLEAN|0xF000000F
+gSiPkgTokenSpaceGuid.PcdPttEnable                    |FALSE|BOOLEAN|0xF0000011
+gSiPkgTokenSpaceGuid.PcdJhiEnable                    |FALSE|BOOLEAN|0xF0000012
+gSiPkgTokenSpaceGuid.PcdSoftwareGuardEnable          |FALSE|BOOLEAN|0xF0000013
+gSiPkgTokenSpaceGuid.PcdSmbiosEnable                 |TRUE |BOOLEAN|0xF0000014
+gSiPkgTokenSpaceGuid.PcdS3Enable                     |TRUE |BOOLEAN|0xF0000015
+gSiPkgTokenSpaceGuid.PcdOverclockEnable              |FALSE|BOOLEAN|0xF0000016
+gSiPkgTokenSpaceGuid.PcdCpuPowerOnConfigEnable       |FALSE|BOOLEAN|0xF0000017
+gSiPkgTokenSpaceGuid.PcdSsaFlagEnable                |FALSE|BOOLEAN|0xF0000018
+gSiPkgTokenSpaceGuid.PcdEvLoaderEnable               |FALSE|BOOLEAN|0xF0000019
+gSiPkgTokenSpaceGuid.PcdIgdEnable                    |TRUE |BOOLEAN|0xF000001A
+gSiPkgTokenSpaceGuid.PcdPegEnable                    |TRUE |BOOLEAN|0xF000001B
+gSiPkgTokenSpaceGuid.PcdSaDmiEnable                  |TRUE |BOOLEAN|0xF000001C
+gSiPkgTokenSpaceGuid.PcdGnaEnable                    |FALSE |BOOLEAN|0xF000001E
+gSiPkgTokenSpaceGuid.PcdVtdEnable                    |TRUE |BOOLEAN|0xF0000020
+gSiPkgTokenSpaceGuid.PcdBiosGuardEnable              |FALSE|BOOLEAN|0xF0000021
+gSiPkgTokenSpaceGuid.PcdSimicsEnable                 |FALSE|BOOLEAN|0xF0000022
+gSiPkgTokenSpaceGuid.PcdBdatEnable                   |FALSE|BOOLEAN|0xF0000023
+gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable       |TRUE |BOOLEAN|0xF0000024
+gSiPkgTokenSpaceGuid.PcdPeiDisplayEnable             |TRUE |BOOLEAN|0xF0000025
+gSiPkgTokenSpaceGuid.PcdOcWdtEnable                  |FALSE|BOOLEAN|0xF0000029
+gSiPkgTokenSpaceGuid.PcdMinTreeEnable                |FALSE|BOOLEAN|0xF000002A  # To separate modules used in mininal source tree and advanced features
+gSiPkgTokenSpaceGuid.PcdBootGuardEnable              |FALSE|BOOLEAN|0xF0000030
+gSiPkgTokenSpaceGuid.PcdSerialIoUartEnable           |FALSE|BOOLEAN|0xF0000033
+gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable         |FALSE|BOOLEAN|0xF0000037
+gSiPkgTokenSpaceGuid.PcdBfxEnable                    |FALSE|BOOLEAN|0xF000003A
+gSiPkgTokenSpaceGuid.PcdThcEnable                    |FALSE|BOOLEAN|0xF000003B
+
+gSiPkgTokenSpaceGuid.PcdPpamEnable                   |FALSE|BOOLEAN|0xF000003F
+gSiPkgTokenSpaceGuid.PcdPsmiEnable                   |FALSE|BOOLEAN|0xF0000042
+gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                |TRUE |BOOLEAN|0xF0000043
+gSiPkgTokenSpaceGuid.PcdHybridStorageSupport         |FALSE|BOOLEAN|0xF0000044
+gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported     |TRUE |BOOLEAN|0xF0000045
+gSiPkgTokenSpaceGuid.PcdTmeLibSupported              |FALSE|BOOLEAN|0xF0000046
+gSiPkgTokenSpaceGuid.PcdAdlLpSupport                 |FALSE|BOOLEAN|0xF0000047
+gSiPkgTokenSpaceGuid.PcdSpsStateSaveEnable           |FALSE|BOOLEAN|0xF0000048
+gSiPkgTokenSpaceGuid.PcdSpaEnable                    |FALSE|BOOLEAN|0xF0000049
+
+## PCD for TraceHub
+[PcdsDynamic, PcdsPatchableInModule]
+## From MdeModulePkg.dec
+## Default OEM ID for ACPI table creation, its length must be 0x6 bytes to follow ACPI specification.
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemId|"INTEL "|VOID*|0x30001034
+## Default OEM Table ID for ACPI table creation, it is "EDK2    ".
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemTableId|0x20202020324B4445|UINT64|0x30001035
+## Default OEM Revision for ACPI table creation.
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemRevision|0x00000002|UINT32|0x30001036
+## Default Creator ID for ACPI table creation.
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorId|0x20202020|UINT32|0x30001037
+## Default Creator Revision for ACPI table creation.
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision|0x01000013|UINT32|0x30001038
+## ME HECI interface configuration
+gMeConfigSpaceGuid.PcdHeciDumpsEnabled|TRUE|BOOLEAN|0x50000001
+gMeConfigSpaceGuid.PcdHeciTimeoutsEnabled|TRUE|BOOLEAN|0x50000002
+
+
+[PcdsFixedAtBuild, PcdsPatchableInModule]
+## This value is used to set the base address of PCH devices
+gSiPkgTokenSpaceGuid.PcdSmbusBaseAddress|0x0000EFA0|UINT16|0x00010031
+gSiPkgTokenSpaceGuid.PcdTcoBaseAddress|0x0400|UINT16|0x00010033
+gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress|0x1800|UINT16|0x00010035
+
+
+## Stack size in the temporary RAM.
+## 0 means half of TemporaryRamSize.
+gSiPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize|0|UINT32|0x00010036
+##
+## PcdFviSmbiosType determines the SMBIOS OEM type (0x80 to 0xFF) defined in SMBIOS,
+## values 0-0x7F will be treated as disable FVI reporting.
+## FVI structure uses it as SMBIOS OEM type to provide version information.
+##
+gSiPkgTokenSpaceGuid.PcdFviSmbiosType|0xDD|UINT8|0x00010037
+gSiPkgTokenSpaceGuid.PcdSaPciPrint|FALSE|BOOLEAN|0x00010039
+##
+## SMBIOS defaults
+##
+gSiPkgTokenSpaceGuid.PcdSmbiosDefaultSocketDesignation|"U3E1"|VOID*|0x0001003a
+gSiPkgTokenSpaceGuid.PcdSmbiosDefaultSerialNumber|"To Be Filled By O.E.M."|VOID*|0x0001003b
+gSiPkgTokenSpaceGuid.PcdSmbiosDefaultAssetTag|"To Be Filled By O.E.M."|VOID*|0x0001003c
+gSiPkgTokenSpaceGuid.PcdSmbiosDefaultPartNumber|"To Be Filled By O.E.M."|VOID*|0x0001003d
+
+##
+## Allocate 56 KB [0x2000..0xFFFF] of I/O space for Pci Devices
+## If PcdPciReservedMemLimit =0  Pci Reserved default  MMIO Limit is 0xE0000000 else use PcdPciReservedMemLimit .
+##
+gSiPkgTokenSpaceGuid.PcdPciReservedIobase       |0x2000 |UINT16|0x00010041
+gSiPkgTokenSpaceGuid.PcdPciReservedIoLimit      |0xFFFF |UINT16|0x00010042
+gSiPkgTokenSpaceGuid.PcdPciReservedMemLimit     |0x0000 |UINT32|0x00010043
+gSiPkgTokenSpaceGuid.PcdPciDmaAbove4G           |FALSE |BOOLEAN|0x00010044
+gSiPkgTokenSpaceGuid.PcdPciNoExtendedConfigSpace|FALSE |BOOLEAN|0x00010045
+
+##
+## Default 8MB TSEG for Release build BIOS when IED disabled (Also a default)
+##
+gSiPkgTokenSpaceGuid.PcdTsegSize|0x00800000|UINT32|0x00010046
+##
+## gSiPkgTokenSpaceGuid.PcdFwStsSmbiosType determines the SMBIOS OEM type (0x80 to 0xFF) defined
+## in SMBIOS, values 0-0x7F will be treated as disable FWSTS SMBIOS reporting.
+## FWSTS structure uses it as SMBIOS OEM type to provide FWSTS information.
+##
+gSiPkgTokenSpaceGuid.PcdFwStsSmbiosType|0xDB|UINT8|0x00010047
+
+##
+## Maximum Address the AP Wakeup Buffer can start.
+##
+gSiPkgTokenSpaceGuid.PcdCpuApWakeupBufferMaxAddr|0x58000|UINT32|0x00010048
+
+##
+## Silicon Reference Code versions
+##
+##Revision:Weekly build number
+gSiPkgTokenSpaceGuid.PcdSiliconInitVersionRevision|0x33|UINT8|0x00010051
+
+##Build[7:4]:Daily build number.
+##Build[3:0]:Patch build number.
+
+##
+## Temp MEM IO resource
+##
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin    |2         |UINT8 |0x00010053
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax    |10        |UINT8 |0x00010054
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr  |0xFE600000|UINT32|0x00010055
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemSize      |0x00200000|UINT32|0x00010056
+
+##
+## This PCD specifies the base address of the HPET timer.
+## The acceptable values are 0xFED00000, 0xFED01000, 0xFED02000, and 0xFED03000
+##
+gSiPkgTokenSpaceGuid.PcdSiHpetBaseAddress    |0xFED00000|UINT32|0x00010057
+##
+## This PCD specifies the base address of the IO APIC.
+## The acceptable values are 0xFECxx000.
+##
+gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress  |0xFEC00000|UINT32|0x00010058
+
+
+##
+## VTD Base Addresses
+##
+
+## Null-terminated string of the Version of Physical Presence interface supported by platform.
+# @Prompt Version of Physical Presence interface supported by platform.
+gSiPkgTokenSpaceGuid.PcdTcgPhysicalPresenceInterfaceVer|"1.3"|VOID*|0x00000008
+
+## This PCD specifies Master of TraceHub device
+gSiPkgTokenSpaceGuid.PcdTraceHubDebugLibMaster|0x0|UINT32|0x00011000
+## This PCD specifies Channel of TraceHub device
+gSiPkgTokenSpaceGuid.PcdTraceHubDebugLibChannel|0x0|UINT32|0x00011001
+
+
+[PcdsPatchableInModule, PcdsFixedAtBuild]
+## This value is used to set the base address of MCH
+gSiPkgTokenSpaceGuid.PcdMchBaseAddress|0xFEDC0000|UINT64|0x00010030
+## 128KB window
+gSiPkgTokenSpaceGuid.PcdMchMmioSize|0x20000|UINT32|0x50000000
+gSiPkgTokenSpaceGuid.PcdSiliconInitVersionMajor   |0x0A|UINT8|0x00010049
+gSiPkgTokenSpaceGuid.PcdSiliconInitVersionValue   |0x0000000800260020|UINT64|0x00010077
+
+##Minor:the program that supported by same core generation.
+gSiPkgTokenSpaceGuid.PcdSiliconInitVersionMinor   |0x00|UINT8|0x00010050
+
+gSiPkgTokenSpaceGuid.PcdSiliconInitVersionBuild   |0x10|UINT8|0x00010052
+gSiPkgTokenSpaceGuid.PcdRegBarBaseAddress|0xFB000000|UINT32|0x00010059
+[PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
+##
+## SerialIo Uart Configuration
+##
+gSiPkgTokenSpaceGuid.PcdSerialIoUartDebugEnable   |0          |UINT8 |0x00210001 # 0:Disable, 1:Enable and Initialize, 2:Enable without Initializing
+gSiPkgTokenSpaceGuid.PcdSerialIoUartNumber        |2          |UINT8 |0x00210002
+gSiPkgTokenSpaceGuid.PcdSerialIoUartMode          |2          |UINT8 |0x00210003 # 0:Disabled, 1:Enabled, 2:Hidden, 3:COM, 4:SkipInit
+gSiPkgTokenSpaceGuid.PcdSerialIoUartBaudRate      |115200     |UINT32|0x00210004 # 0:Default, Max:6000000
+gSiPkgTokenSpaceGuid.PcdSerialIoUartParity        |1          |UINT8 |0x00210008 # 0:DefaultParity, 1:NoParity, 2:EvenParity, 3:OddParity
+gSiPkgTokenSpaceGuid.PcdSerialIoUartDataBits      |8          |UINT8 |0x00210009 # 0:Default, 5,6,7,8
+gSiPkgTokenSpaceGuid.PcdSerialIoUartStopBits      |1          |UINT8 |0x0021000A # 0:DefaultStopBits, 1:OneStopBit, 2:OneFiveStopBits, 3:TwoStopBits
+gSiPkgTokenSpaceGuid.PcdSerialIoUartAutoFlow      |0          |UINT8 |0x0021000B # 0:No HW flow control, Only RX/TX Enabled; 1:HW Flow Control On, Rts/Cts lines enabled;
+gSiPkgTokenSpaceGuid.PcdSerialIoUartRxPinMux      |0x0        |UINT32|0x0021000C # Pin muxing config for UART Rx pin
+gSiPkgTokenSpaceGuid.PcdSerialIoUartTxPinMux      |0x0        |UINT32|0x00210010 # Pin muxing config for UART Tx pin
+gSiPkgTokenSpaceGuid.PcdSerialIoUartRtsPinMux     |0x0        |UINT32|0x00210014 # Pin muxing config for UART Rts pin
+gSiPkgTokenSpaceGuid.PcdSerialIoUartCtsPinMux     |0x0        |UINT32|0x00210018 # Pin muxing config for UART Cts pin
+gSiPkgTokenSpaceGuid.PcdSerialIoUartDebugMmioBase |0xFE036000 |UINT32|0x0021001C # PcdSerialIoUartMode = Enabled, need to assign MMIO Resource in SEC/PEI Phase
+
+gSiPkgTokenSpaceGuid.PcdLpcUartDebugEnable        |0x1        |UINT8 |0x00210026 # 0:Disable, 1:Enable
+gSiPkgTokenSpaceGuid.PcdDebugInterfaceFlags       |0x12       |UINT8 |0x00210027 # BIT0-RAM, BIT1-UART, BIT3-USB3, BIT4-Serial IO, BIT5-TraceHub, BIT2 - Not used.
+gSiPkgTokenSpaceGuid.PcdSerialDebugLevel          |0x3        |UINT8 |0x00210028 # {0:Disable, 1:Error Only, 2:Error and Warnings, 3:Load Error Warnings and Info, 4:Load Error Warnings and Info, 5:Load Error Warnings Info and Verbose
+gSiPkgTokenSpaceGuid.PcdIsaSerialUartBase         |0x0        |UINT8 |0x00210029 # 0:0x3F8, 1:0x2F8
+
+## UART Lib TimeOut
+gSiPkgTokenSpaceGuid.PcdSerialIoUartTimeOut             |1000000 |UINT32 |0x00210020 # Write TimeOut in Micro Seconds - 0 = disabbled, default 1 second,
+gSiPkgTokenSpaceGuid.PcdSerialIoUartLibSkipMmioCheck    |FALSE   |BOOLEAN|0x00210024 # If TRUE MMIO sanity checks are skipped
+
+## UART Dxe Driver IgnoreBaudRateSet
+## TRUE - Blocks changing BaudRate, so that driver will not override UART's initial configuration.
+##        Required to support redirection on higher BaudRates.
+## FALSE - Allows for UART settings to be changed through the Serial Io Protocol
+##
+gSiPkgTokenSpaceGuid.PcdSerialIoUartDriverIgnoreBaudRateSet|FALSE|BOOLEAN|0x00210025
+
+##
+## SerialIo 2nd Uart Configuration
+##
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartEnable    |0          |UINT8 |0x0021002A # 0:Disable, 1:Enable and Initialize, 2:Enable without Initializing
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartNumber    |2          |UINT8 |0x0021002B
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartMode      |2          |UINT8 |0x0021002C # 0:Disabled, 1:Enabled, 2:Hidden, 3:COM, 4:SkipInit
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartBaudRate  |115200     |UINT32|0x0021002D # 0:Default, Max:6000000
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartParity    |1          |UINT8 |0x00210031 # 0:DefaultParity, 1:NoParity, 2:EvenParity, 3:OddParity
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartDataBits  |8          |UINT8 |0x00210032 # 0:Default, 5,6,7,8
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartStopBits  |1          |UINT8 |0x00210033 # 0:DefaultStopBits, 1:OneStopBit, 2:OneFiveStopBits, 3:TwoStopBits
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartAutoFlow  |0          |UINT8 |0x00210034 # 0:No HW flow control, Only RX/TX Enabled; 1:HW Flow Control On, Rts/Cts lines enabled;
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartRxPinMux  |0x0        |UINT32|0x00210035 # Pin muxing config for UART Rx pin
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartTxPinMux  |0x0        |UINT32|0x00210039 # Pin muxing config for UART Tx pin
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartRtsPinMux |0x0        |UINT32|0x0021003D # Pin muxing config for UART Rts pin
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartCtsPinMux |0x0        |UINT32|0x00210041 # Pin muxing config for UART Cts pin
+gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartMmioBase  |0xFE034000 |UINT32|0x00210045 # PcdSerialIoUartMode = Enabled, need to assign MMIO Resource in SEC/PEI Phase
+
+##
+## PCI Express MMIO region length
+## Valid settings: 0x20000000/512MB, 0x10000000/256MB, 0x8000000/128MB, 0x4000000/64MB
+##
+gSiPkgTokenSpaceGuid.PcdPciExpressRegionLength|0x10000000|UINT32|0x00200001
+##
+## Typically this should be the same with gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress.
+## This PCD is added for supporting different PCD type in different phases.
+##
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress |0xC0000000|UINT64|0x00200002
+##
+## PCI Express MMIO temporary region length in SEC phase.
+## Valid settings: 0x20000000/512MB, 0x10000000/256MB, 0x8000000/128MB, 0x4000000/64MB
+##
+gSiPkgTokenSpaceGuid.PcdTemporaryPciExpressRegionLength|0x10000000|UINT32|0x00200005
+
+## Specifies the SMRR2 base address.<BR><BR>
+# @Prompt SMRR2 base address.
+# @Expression  0x80000001 | (gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Base & 0xfff) == 0
+gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Base|0|UINT32|0x20000002
+
+## Specifies the SMRR2 range size.<BR><BR>
+# @Prompt SMRR2 range size.
+# @Expression  0x80000001 | (gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Size & 0xfff) == 0
+gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Size|0|UINT32|0x20000003
+
+## Specifies the SMRR2 range cache type.
+#  If SMRR2 is used to map a flash/ROM based handler, it would be configured as WP.<BR><BR>
+#  5: WP(Write Protect).<BR>
+#  6: WB(Write Back).<BR>
+# @Prompt SMRR2 range cache type.
+gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2CacheType|5|UINT8|0x20000004
+
+## Indidates if SMM PROT MODE feature is supported.<BR><BR>
+#   TRUE  - SMM PROT MODE feature is supported.<BR>
+#   FALSE - SMM PROT MODE feature is not supported.<BR>
+# @Prompt  SMM PROT MODE feature.
+gSiPkgTokenSpaceGuid.PcdCpuSmmProtectedModeEnable|FALSE|BOOLEAN|0x20000008
+
+## Specifies the a size of memory region to reserve in SMM for testing only.
+#  One can look in BIOS serial log for PCD to get region base address.
+#  Note: A different region may be allocated in release build than debug build.
+# @Prompt SMM test region size.\r
+gSiPkgTokenSpaceGuid.PcdSmmTestRsvMemorySize|0x0|UINT32|0x2000000E
+
+[PcdsDynamic]
+
+## Indidates if SMM Code Access Check feature is supported.<BR><BR>
+#   TRUE  - SMM Code Access Check feature is supported.<BR>
+#   FALSE - SMM Code Access Check feature is not supported.<BR>
+# @Prompt  SMM Code Access Check feature.
+gSiPkgTokenSpaceGuid.PcdCpuSmmCodeAccessCheckEnable|TRUE|BOOLEAN|0x001000D
+
+## Causes all UEFI variables to be treated as volatile and hence never written to non-volatile
+## storage.
+## This is useful in cases such as a simulation environment that does not emulate a non-volatile
+## storage device or in recovery scenarios where system errors prevent non-volatile storage from being accessed
+gSiPkgTokenSpaceGuid.PcdNvVariableEmulationMode|FALSE|BOOLEAN|0x0010000E
+
+## Enables or disables storage of UEFI variables using the CSE Variable Storage drivers
+##   If disabled at runtime, it must be set before the CSE Variable Storage driver loads.
+gSiPkgTokenSpaceGuid.PcdEnableCseVariableStorage|FALSE|BOOLEAN|0x0010000F
+
+## Enables or disables storage of UEFI variables using the FVB Variable Storage drivers
+##  If disabled at runtime, it must be set before the FVB Variable Storage driver loads.
+gSiPkgTokenSpaceGuid.PcdEnableFvbVariableStorage|TRUE|BOOLEAN|0x00100010
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:51   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other " Heng Luo
                   ` (38 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Include/Library
  * Include/Ppi
  * Include/Protocol

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h       |  64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h   | 332 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h        | 153 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h              | 140 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h               |  63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h           | 342 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h              | 720 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h        | 149 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h             |  27 +++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h         | 123 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h            | 256 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h        | 173 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h               | 355 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h       |  79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h              | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h    | 113 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h     |  56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h         | 290 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h           |  53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h        |  32 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h |  34 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h       |  33 +++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h                 |  79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.h   |  61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h           |  73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h         |  22 ++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h                 | 301 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 27 files changed, 4235 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h
new file mode 100644
index 0000000000..dbf786ec9a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h
@@ -0,0 +1,64 @@
+/** @file
+  Header file for Config Block Lib implementation
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CONFIG_BLOCK_LIB_H_
+#define _CONFIG_BLOCK_LIB_H_
+
+/**
+  Create config block table
+
+  @param[in]     TotalSize                    - Max size to be allocated for the Config Block Table
+  @param[out]    ConfigBlockTableAddress      - On return, points to a pointer to the beginning of Config Block Table Address
+
+  @retval EFI_INVALID_PARAMETER - Invalid Parameter
+  @retval EFI_OUT_OF_RESOURCES  - Out of resources
+  @retval EFI_SUCCESS           - Successfully created Config Block Table at ConfigBlockTableAddress
+**/
+EFI_STATUS
+EFIAPI
+CreateConfigBlockTable (
+  IN     UINT16    TotalSize,
+  OUT    VOID      **ConfigBlockTableAddress
+  );
+
+/**
+  Add config block into config block table structure
+
+  @param[in]     ConfigBlockTableAddress      - A pointer to the beginning of Config Block Table Address
+  @param[out]    ConfigBlockAddress           - On return, points to a pointer to the beginning of Config Block Address
+
+  @retval EFI_OUT_OF_RESOURCES - Config Block Table is full and cannot add new Config Block or
+                                 Config Block Offset Table is full and cannot add new Config Block.
+  @retval EFI_SUCCESS          - Successfully added Config Block
+**/
+EFI_STATUS
+EFIAPI
+AddConfigBlock (
+  IN     VOID      *ConfigBlockTableAddress,
+  OUT    VOID      **ConfigBlockAddress
+  );
+
+/**
+  Retrieve a specific Config Block data by GUID
+
+  @param[in]      ConfigBlockTableAddress      - A pointer to the beginning of Config Block Table Address
+  @param[in]      ConfigBlockGuid              - A pointer to the GUID uses to search specific Config Block
+  @param[out]     ConfigBlockAddress           - On return, points to a pointer to the beginning of Config Block Address
+
+  @retval EFI_NOT_FOUND         - Could not find the Config Block
+  @retval EFI_SUCCESS           - Config Block found and return
+**/
+EFI_STATUS
+EFIAPI
+GetConfigBlock (
+  IN     VOID      *ConfigBlockTableAddress,
+  IN     EFI_GUID  *ConfigBlockGuid,
+  OUT    VOID      **ConfigBlockAddress
+  );
+
+#endif // _CONFIG_BLOCK_LIB_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h
new file mode 100644
index 0000000000..564fcccb43
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h
@@ -0,0 +1,332 @@
+/** @file
+  Header file for CPU REGBAR ACCESS library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_REGBAR_ACCESS_LIB_H_
+#define _CPU_REGBAR_ACCESS_LIB_H_
+
+#define INVALID_DATA_64  0xFFFFFFFFFFFFFFFF
+#define INVALID_DATA_32  0xFFFFFFFF
+#define INVALID_DATA_16  0xFFFF
+#define INVALID_DATA_8   0xFF
+#define INVALID_PID      0xFF
+
+typedef UINT8    CPU_SB_DEVICE_PID;
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 8bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset              Register offset of this Port ID
+
+  @retval     UINT64           REGBAR register value.
+**/
+UINT64
+CpuRegbarRead64 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  );
+
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset              Register offset of this Port ID
+
+  @retval     UINT32           REGBAR register value.
+**/
+UINT32
+CpuRegbarRead32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  );
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset              Register offset of this Port ID
+
+  @retval     UINT16           REGBAR register value.
+**/
+UINT16
+CpuRegbarRead16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  );
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset              Register offset of this Port ID
+
+  @retval     UINT8            REGBAR regsiter value
+**/
+UINT8
+CpuRegbarRead8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 8bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset              Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT64           Value written to register
+**/
+UINT64
+CpuRegbarWrite64 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT64                            Data
+  );
+
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+**/
+UINT32
+CpuRegbarWrite32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            Data
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+**/
+UINT16
+CpuRegbarWrite16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            Data
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+**/
+UINT8
+CpuRegbarWrite8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             Data
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarOr32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            OrData
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarOr16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            OrData
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+
+**/
+UINT8
+CpuRegbarOr8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             OrData
+  );
+
+/**
+  Performs a bitwise AND of a 32-bit data.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevice      CPU SB Device
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarAnd32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            AndData
+  );
+
+/**
+  Performs a bitwise AND of a 16-bit data.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevice      CPU SB Device
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarAnd16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            AndData
+  );
+
+/**
+  Performs a bitwise AND of a 8-bit data.
+  It programs REGBAR register and size in 1byte.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevice      CPU SB Device
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+
+**/
+UINT8
+CpuRegbarAnd8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             AndData
+  );
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarAndThenOr32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarAndThenOr16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            AndData,
+  IN  UINT16                            OrData
+  );
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+
+**/
+UINT8
+CpuRegbarAndThenOr8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             AndData,
+  IN  UINT8                             OrData
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h
new file mode 100644
index 0000000000..c48ea3667f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h
@@ -0,0 +1,153 @@
+/** @file
+  Prototype of the DxePchHdaNhltLib library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _DXE_HDA_NHLT_LIB_H_
+#define _DXE_HDA_NHLT_LIB_H_
+
+#include <DxeHdaNhlt.h>
+
+/**
+  Returns pointer to Endpoint ENDPOINT_DESCRIPTOR structure.
+
+  @param[in] *NhltTable    Endpoint for which Format address is retrieved
+  @param[in] FormatIndex   Index of Format to be retrieved
+
+  @retval                  Pointer to ENDPOINT_DESCRIPTOR structure with given index
+**/
+ENDPOINT_DESCRIPTOR *
+GetNhltEndpoint (
+  IN CONST NHLT_ACPI_TABLE      *NhltTable,
+  IN CONST UINT8                EndpointIndex
+  );
+
+/**
+  Returns pointer to Endpoint Specific Configuration SPECIFIC_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which config address is retrieved
+
+  @retval                  Pointer to SPECIFIC_CONFIG structure with endpoint's capabilities
+**/
+SPECIFIC_CONFIG *
+GetNhltEndpointDeviceCapabilities (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  );
+
+/**
+  Returns pointer to all Formats Configuration FORMATS_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which Formats address is retrieved
+
+  @retval                  Pointer to FORMATS_CONFIG structure
+**/
+FORMATS_CONFIG *
+GetNhltEndpointFormatsConfig (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  );
+
+/**
+  Returns pointer to Format Configuration FORMAT_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which Format address is retrieved
+  @param[in] FormatIndex   Index of Format to be retrieved
+
+  @retval                  Pointer to FORMAT_CONFIG structure with given index
+**/
+FORMAT_CONFIG *
+GetNhltEndpointFormat (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
+  IN CONST UINT8                FormatIndex
+  );
+
+/**
+  Returns pointer to all Device Information DEVICES_INFO structure.
+
+  @param[in] *Endpoint     Endpoint for which DevicesInfo address is retrieved
+
+  @retval                  Pointer to DEVICES_INFO structure
+**/
+DEVICES_INFO *
+GetNhltEndpointDevicesInfo (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  );
+
+/**
+  Returns pointer to Device Information DEVICES_INFO structure.
+
+  @param[in] *Endpoint       Endpoint for which Device Info address is retrieved
+  @param[in] DeviceInfoIndex Index of Device Info to be retrieved
+
+  @retval                    Pointer to DEVICE_INFO structure with given index
+**/
+DEVICE_INFO *
+GetNhltEndpointDeviceInfo (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
+  IN CONST UINT8                DeviceInfoIndex
+  );
+
+
+/**
+  Returns pointer to OED Configuration SPECIFIC_CONFIG structure.
+
+  @param[in] *NhltTable    NHLT table for which OED address is retrieved
+
+  @retval                  Pointer to SPECIFIC_CONFIG structure with NHLT capabilities
+**/
+SPECIFIC_CONFIG *
+GetNhltOedConfig (
+  IN CONST NHLT_ACPI_TABLE      *NhltTable
+  );
+
+/**
+  Prints Format configuration.
+
+  @param[in] *Format       Format to be printed
+
+  @retval None
+**/
+VOID
+NhltFormatDump (
+  IN CONST FORMAT_CONFIG        *Format
+  );
+
+
+/**
+  Prints Endpoint configuration.
+
+  @param[in] *Endpoint     Endpoint to be printed
+
+  @retval None
+**/
+VOID
+NhltEndpointDump (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  );
+
+/**
+  Prints OED (Offload Engine Driver) configuration.
+
+  @param[in] *OedConfig   OED to be printed
+
+  @retval None
+**/
+VOID
+NhltOedConfigDump (
+  IN CONST SPECIFIC_CONFIG      *OedConfig
+  );
+
+/**
+  Prints NHLT (Non HDA-Link Table) to be exposed via ACPI (aka. OED (Offload Engine Driver) Configuration Table).
+
+  @param[in] *NhltTable    The NHLT table to print
+
+  @retval None
+**/
+VOID
+NhltAcpiTableDump (
+  IN NHLT_ACPI_TABLE            *NhltTable
+  );
+
+#endif // _DXE_HDA_NHLT_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h
new file mode 100644
index 0000000000..6d8466ab7a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h
@@ -0,0 +1,140 @@
+/** @file
+  Header file for PchEspiLib.
+  All function in this library is available for PEI, DXE, and SMM,
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _ESPI_LIB_H_
+#define _ESPI_LIB_H_
+
+/**
+  Checks if there's second slave connected under CS#1
+
+  @retval TRUE      There's second slave
+  @retval FALSE     There's no second slave
+**/
+BOOLEAN
+IsEspiSecondSlaveSupported (
+  VOID
+  );
+
+/**
+  Checks in slave General Capabilities register if it supports channel with requested number
+
+  @param[in]  SlaveId         Id of slave to check
+  @param[in]  ChannelNumber   Number of channel of which to check
+
+  @retval TRUE      Channel with requested number is supported by slave device
+  @retval FALSE     Channel with requested number is not supported by slave device
+**/
+BOOLEAN
+IsEspiSlaveChannelSupported (
+  UINT8   SlaveId,
+  UINT8   ChannelNumber
+  );
+
+/**
+  Is eSPI enabled in strap.
+
+  @retval TRUE          Espi is enabled in strap
+  @retval FALSE         Espi is disabled in strap
+**/
+BOOLEAN
+IsEspiEnabled (
+  VOID
+  );
+
+/**
+  Get configuration from eSPI slave
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[in]  SlaveAddress  Slave Configuration Register Address
+  @param[out] OutData       Configuration data read
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PchLp
+  @retval EFI_INVALID_PARAMETER Slave configuration register address exceed maximum allowed
+  @retval EFI_INVALID_PARAMETER Slave configuration register address is not DWord aligned
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveGetConfig (
+  IN  UINT32 SlaveId,
+  IN  UINT32 SlaveAddress,
+  OUT UINT32 *OutData
+  );
+
+/**
+  Set eSPI slave configuration
+
+  Note: A Set_Configuration must always be followed by a Get_Configuration in order to ensure
+  that the internal state of the eSPI-MC is consistent with the Slave's register settings.
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[in]  SlaveAddress  Slave Configuration Register Address
+  @param[in]  InData        Configuration data to write
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PchLp
+  @retval EFI_INVALID_PARAMETER Slave configuration register address exceed maximum allowed
+  @retval EFI_INVALID_PARAMETER Slave configuration register address is not DWord aligned
+  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to 0x7FF has been locked
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveSetConfig (
+  IN  UINT32 SlaveId,
+  IN  UINT32 SlaveAddress,
+  IN  UINT32 InData
+  );
+
+/**
+  Get status from eSPI slave
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[out] OutData       Configuration data read
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PchLp
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveGetStatus (
+  IN  UINT32 SlaveId,
+  OUT UINT16 *OutData
+  );
+
+/**
+  eSPI slave in-band reset
+
+  @param[in]  SlaveId       eSPI slave ID
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PchLp
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveInBandReset (
+  IN  UINT32 SlaveId
+  );
+
+/**
+  eSPI Slave channel reset helper function
+
+  @param[in]  SlaveId           eSPI slave ID
+  @param[in]  ChannelNumber     Number of channel to reset
+
+  @retval     EFI_SUCCESS       Operation succeeded
+  @retval     EFI_UNSUPPORTED   Slave doesn't support that channel or invalid number specified
+  @retval     EFI_TIMEOUT       Operation has timeouted
+**/
+EFI_STATUS
+PchEspiSlaveChannelReset (
+  IN  UINT8   SlaveId,
+  IN  UINT8   ChannelNumber
+  );
+
+#endif // _ESPI_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h
new file mode 100644
index 0000000000..9d72b9ac7c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h
@@ -0,0 +1,63 @@
+/** @file
+  Header file for GbeLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GBE_LIB_H_
+#define _GBE_LIB_H_
+
+/**
+  Check whether GbE region is valid
+  Check SPI region directly since GbE might be disabled in SW.
+
+  @retval TRUE                    Gbe Region is valid
+  @retval FALSE                   Gbe Region is invalid
+**/
+BOOLEAN
+IsGbeRegionValid (
+  VOID
+  );
+
+/**
+  Check whether GBE controller is enabled in the platform.
+
+  @retval TRUE                    GbE is enabled
+  @retval FALSE                   GbE is disabled
+**/
+BOOLEAN
+IsGbePresent (
+  VOID
+  );
+
+/**
+  Checks if Gbe is Enabled or Disabled
+
+  @retval  BOOLEAN    TRUE if device is enabled, FALSE otherwise.
+**/
+BOOLEAN
+IsGbeEnabled (
+  VOID
+  );
+
+/**
+  Returns Gigabit Ethernet PCI Device Number
+
+  @retval  GbE device number
+**/
+UINT8
+GbeDevNumber (
+  VOID
+  );
+
+/**
+  Returns Gigabit Ethernet PCI Function Number
+
+  @retval  GbE function number
+**/
+UINT8
+GbeFuncNumber (
+  VOID
+  );
+
+#endif // _GBE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h
new file mode 100644
index 0000000000..88a21efb32
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h
@@ -0,0 +1,342 @@
+/** @file
+  Header file for GpioConfig structure used by GPIO library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_CONFIG_H_
+#define _GPIO_CONFIG_H_
+
+#pragma pack(push, 1)
+
+///
+/// For any GpioPad usage in code use GPIO_PAD type
+///
+typedef UINT32 GPIO_PAD;
+
+///
+/// GpioPad with additional native function information.
+/// This type is used to represent signal muxing alternatives. Platform will provide such value to
+/// identify muxing selection for given signal on a specific SOC.
+/// Please refer to the board layout
+///
+typedef UINT32 GPIO_NATIVE_PAD;
+
+
+///
+/// For any GpioGroup usage in code use GPIO_GROUP type
+///
+typedef UINT32 GPIO_GROUP;
+
+/**
+  GPIO configuration structure used for pin programming.
+  Structure contains fields that can be used to configure pad.
+**/
+typedef struct {
+  /**
+  Pad Mode
+  Pad can be set as GPIO or one of its native functions.
+  When in native mode setting Direction (except Inversion), OutputState,
+  InterruptConfig, Host Software Pad Ownership and OutputStateLock are unnecessary.
+  Refer to definition of GPIO_PAD_MODE.
+  Refer to EDS for each native mode according to the pad.
+  **/
+  UINT32 PadMode            : 5;
+  /**
+  Host Software Pad Ownership
+  Set pad to ACPI mode or GPIO Driver Mode.
+  Refer to definition of GPIO_HOSTSW_OWN.
+  **/
+  UINT32 HostSoftPadOwn     : 2;
+  /**
+  GPIO Direction
+  Can choose between In, In with inversion, Out, both In and Out, both In with inversion and out or disabling both.
+  Refer to definition of GPIO_DIRECTION for supported settings.
+  **/
+  UINT32 Direction           : 6;
+  /**
+  Output State
+  Set Pad output value.
+  Refer to definition of GPIO_OUTPUT_STATE for supported settings.
+  This setting takes place when output is enabled.
+  **/
+  UINT32 OutputState         : 2;
+  /**
+  GPIO Interrupt Configuration
+  Set Pad to cause one of interrupts (IOxAPIC/SCI/SMI/NMI).
+  This setting is applicable only if GPIO is in GpioMode with input enabled.
+  Refer to definition of GPIO_INT_CONFIG for supported settings.
+  **/
+  UINT32 InterruptConfig     : 9;
+  /**
+  GPIO Power Configuration.
+  This setting controls Pad Reset Configuration.
+  Refer to definition of GPIO_RESET_CONFIG for supported settings.
+  **/
+  UINT32 PowerConfig        : 8;
+  /**
+  GPIO Electrical Configuration
+  This setting controls pads termination.
+  Refer to definition of GPIO_ELECTRICAL_CONFIG for supported settings.
+  **/
+  UINT32 ElectricalConfig   : 9;
+  /**
+  GPIO Lock Configuration
+  This setting controls pads lock.
+  Refer to definition of GPIO_LOCK_CONFIG for supported settings.
+  **/
+  UINT32 LockConfig         : 4;
+  /**
+  Additional GPIO configuration
+  Refer to definition of GPIO_OTHER_CONFIG for supported settings.
+  **/
+  UINT32 OtherSettings      : 9;
+
+  UINT32 RsvdBits           : 10;    ///< Reserved bits for future extension
+} GPIO_CONFIG;
+
+
+typedef enum {
+  GpioHardwareDefault        = 0x0    ///< Leave setting unmodified
+} GPIO_HARDWARE_DEFAULT;
+
+/**
+  GPIO Pad Mode
+  Refer to GPIO documentation on native functions available for certain pad.
+  If GPIO is set to one of NativeX modes then following settings are not applicable
+  and can be skipped:
+  - Interrupt related settings
+  - Host Software Ownership
+  - Output/Input enabling/disabling
+  - Output lock
+**/
+typedef enum {
+  GpioPadModeHwDefault  = 0x0,
+  GpioPadModeGpio       = 0x1,
+  GpioPadModeNative1    = 0x3,
+  GpioPadModeNative2    = 0x5,
+  GpioPadModeNative3    = 0x7,
+  GpioPadModeNative4    = 0x9,
+  GpioPadModeNative5    = 0xB,
+  GpioPadModeNative6    = 0xD,
+  GpioPadModeNative7    = 0xF
+} GPIO_PAD_MODE;
+
+/**
+  Host Software Pad Ownership modes
+  This setting affects GPIO interrupt status registers. Depending on chosen ownership
+  some GPIO Interrupt status register get updated and other masked.
+  Please refer to EDS for HOSTSW_OWN register description.
+**/
+typedef enum {
+  GpioHostOwnDefault = 0x0,   ///< Leave ownership value unmodified
+  /**
+  Set HOST ownership to ACPI.
+  Use this setting if pad is not going to be used by GPIO OS driver.
+  If GPIO is configured to generate SCI/SMI/NMI then this setting must be
+  used for interrupts to work
+  **/
+  GpioHostOwnAcpi    = 0x1,
+  /**
+  Set HOST ownership to GPIO Driver mode.
+  Use this setting only if GPIO pad should be controlled by GPIO OS Driver.
+  GPIO OS Driver will be able to control the pad if appropriate entry in
+  ACPI exists (refer to ACPI specification for GpioIo and GpioInt descriptors)
+  **/
+  GpioHostOwnGpio    = 0x3
+} GPIO_HOSTSW_OWN;
+
+///
+/// GPIO Direction
+///
+typedef enum {
+  GpioDirDefault         = 0x0,                ///< Leave pad direction setting unmodified
+  GpioDirInOut           = (0x1 | (0x1 << 3)), ///< Set pad for both output and input
+  GpioDirInInvOut        = (0x1 | (0x3 << 3)), ///< Set pad for both output and input with inversion
+  GpioDirIn              = (0x3 | (0x1 << 3)), ///< Set pad for input only
+  GpioDirInInv           = (0x3 | (0x3 << 3)), ///< Set pad for input with inversion
+  GpioDirOut             = 0x5,                ///< Set pad for output only
+  GpioDirNone            = 0x7                 ///< Disable both output and input
+} GPIO_DIRECTION;
+
+/**
+  GPIO Output State
+  This field is relevant only if output is enabled
+**/
+typedef enum {
+  GpioOutDefault         = 0x0,  ///< Leave output value unmodified
+  GpioOutLow             = 0x1,  ///< Set output to low
+  GpioOutHigh            = 0x3   ///< Set output to high
+} GPIO_OUTPUT_STATE;
+
+/**
+  GPIO interrupt configuration
+  This setting is applicable only if pad is in GPIO mode and has input enabled.
+  GPIO_INT_CONFIG allows to choose which interrupt is generated (IOxAPIC/SCI/SMI/NMI)
+  and how it is triggered (edge or level). Refer to PADCFG_DW0 register description in
+  EDS for details on this settings.
+  Field from GpioIntNmi to GpioIntApic can be OR'ed with GpioIntLevel to GpioIntBothEdge
+  to describe an interrupt e.g. GpioIntApic | GpioIntLevel
+  If GPIO is set to cause an SCI then also GPI_GPE_EN is enabled for this pad.
+  If GPIO is set to cause an NMI then also GPI_NMI_EN is enabled for this pad.
+  Not all GPIO are capable of generating an SMI or NMI interrupt.
+  When routing GPIO to cause an IOxAPIC interrupt care must be taken, as this
+  interrupt cannot be shared and its IRQn number is not configurable.
+  Refer to EDS for GPIO pads IRQ numbers (PADCFG_DW1.IntSel)
+  If GPIO is under GPIO OS driver control and appropriate ACPI GpioInt descriptor
+  exist then use only trigger type setting (from GpioIntLevel to GpioIntBothEdge).
+  This type of GPIO Driver interrupt doesn't have any additional routing setting
+  required to be set by BIOS. Interrupt is handled by GPIO OS Driver.
+**/
+
+typedef enum {
+  GpioIntDefault           = 0x0,  ///< Leave value of interrupt routing unmodified
+  GpioIntDis               = 0x1,  ///< Disable IOxAPIC/SCI/SMI/NMI interrupt generation
+  GpioIntNmi               = 0x3,  ///< Enable NMI interrupt only
+  GpioIntSmi               = 0x5,  ///< Enable SMI interrupt only
+  GpioIntSci               = 0x9,  ///< Enable SCI interrupt only
+  GpioIntApic              = 0x11, ///< Enable IOxAPIC interrupt only
+  GpioIntLevel       = (0x1 << 5), ///< Set interrupt as level triggered
+  GpioIntEdge        = (0x3 << 5), ///< Set interrupt as edge triggered (type of edge depends on input inversion)
+  GpioIntLvlEdgDis   = (0x5 << 5), ///< Disable interrupt trigger
+  GpioIntBothEdge    = (0x7 << 5)  ///< Set interrupt as both edge triggered
+} GPIO_INT_CONFIG;
+
+#define B_GPIO_INT_CONFIG_INT_SOURCE_MASK  0x1F ///< Mask for GPIO_INT_CONFIG for interrupt source
+#define B_GPIO_INT_CONFIG_INT_TYPE_MASK    0xE0 ///< Mask for GPIO_INT_CONFIG for interrupt type
+
+/**
+  GPIO Power Configuration
+  GPIO_RESET_CONFIG allows to set GPIO Reset type (PADCFG_DW0.PadRstCfg) which will
+  be used to reset certain GPIO settings.
+  Refer to EDS for settings that are controllable by PadRstCfg.
+**/
+typedef enum {
+  GpioResetDefault   = 0x00,        ///< Leave value of pad reset unmodified
+  /**
+  Resume Reset (RSMRST)
+    GPP: PadRstCfg = 00b = "Powergood"
+    GPD: PadRstCfg = 11b = "Resume Reset"
+  Pad setting will reset on:
+  - DeepSx transition
+  - G3
+  Pad settings will not reset on:
+  - S3/S4/S5 transition
+  - Warm/Cold/Global reset
+  **/
+  GpioResumeReset      = 0x01,
+  /**
+  Host Deep Reset
+    PadRstCfg = 01b = "Deep GPIO Reset"
+  Pad settings will reset on:
+  - Warm/Cold/Global reset
+  - DeepSx transition
+  - G3
+  Pad settings will not reset on:
+  - S3/S4/S5 transition
+  **/
+  GpioHostDeepReset    = 0x03,
+  /**
+  Platform Reset (PLTRST)
+    PadRstCfg = 10b = "GPIO Reset"
+  Pad settings will reset on:
+  - S3/S4/S5 transition
+  - Warm/Cold/Global reset
+  - DeepSx transition
+  - G3
+  **/
+  GpioPlatformReset    = 0x05,
+  /**
+  Deep Sleep Well Reset (DSW_PWROK)
+    GPP: not applicable
+    GPD: PadRstCfg = 00b = "Powergood"
+  Pad settings will reset on:
+  - G3
+  Pad settings will not reset on:
+  - S3/S4/S5 transition
+  - Warm/Cold/Global reset
+  - DeepSx transition
+  **/
+  GpioDswReset         = 0x07
+} GPIO_RESET_CONFIG;
+
+/**
+  GPIO Electrical Configuration
+  Configuration options for GPIO termination setting
+**/
+typedef enum {
+  GpioTermDefault          = 0x0,  ///< Leave termination setting unmodified
+  GpioTermNone             = 0x1,  ///< none
+  GpioTermWpd5K            = 0x5,  ///< 5kOhm weak pull-down
+  GpioTermWpd20K           = 0x9,  ///< 20kOhm weak pull-down
+  GpioTermWpu1K            = 0x13, ///< 1kOhm weak pull-up
+  GpioTermWpu2K            = 0x17, ///< 2kOhm weak pull-up
+  GpioTermWpu5K            = 0x15, ///< 5kOhm weak pull-up
+  GpioTermWpu20K           = 0x19, ///< 20kOhm weak pull-up
+  GpioTermWpu1K2K          = 0x1B, ///< 1kOhm & 2kOhm weak pull-up
+  /**
+  Native function controls pads termination
+  This setting is applicable only to some native modes.
+  Please check EDS to determine which native functionality
+  can control pads termination
+  **/
+  GpioTermNative           = 0x1F
+} GPIO_ELECTRICAL_CONFIG;
+
+#define B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK    0x1F   ///< Mask for GPIO_ELECTRICAL_CONFIG for termination value
+
+/**
+  GPIO LockConfiguration
+  Set GPIO configuration lock and output state lock.
+  GpioPadConfigUnlock/Lock and GpioOutputStateUnlock can be OR'ed.
+  By default GPIO pads will be locked unless GPIO lib is explicitly
+  informed that certain pad is to be left unlocked.
+  Lock settings reset is in Powergood domain. Care must be taken when using this setting
+  as fields it locks may be reset by a different signal and can be controlled
+  by what is in GPIO_RESET_CONFIG (PADCFG_DW0.PadRstCfg). GPIO library provides
+  functions which allow to unlock a GPIO pad. If possible each GPIO lib function will try to unlock
+  an already locked pad upon request for reconfiguration
+**/
+typedef enum {
+  /**
+  Perform default action
+   - if pad is an GPO, lock configuration but leave output unlocked
+   - if pad is an GPI, lock everything
+   - if pad is in native, lock everything
+**/
+  GpioLockDefault         = 0x0,
+  GpioPadConfigUnlock     = 0x3,  ///< Leave Pad configuration unlocked
+  GpioPadConfigLock       = 0x1,  ///< Lock Pad configuration
+  GpioOutputStateUnlock   = 0xC,  ///< Leave Pad output control unlocked
+  GpioPadUnlock           = 0xF,  ///< Leave both Pad configuration and output control unlocked
+  GpioPadLock             = 0x5,  ///< Lock both Pad configuration and output control
+  /**
+    Below statuses are used for
+    return from GpioGetPadConfig function
+  **/
+  GpioLockTxLockCfgUnLock = 0x7,  ///< Tx State locked, Pad Configuration unlocked
+  GpioLockTxUnLockCfgLock = 0xD   ///< Tx State unlocked, Pad Configuration locked
+} GPIO_LOCK_CONFIG;
+
+#define B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK  0x3  ///< Mask for GPIO_LOCK_CONFIG for Pad Configuration Lock
+#define B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK    0xC  ///< Mask for GPIO_LOCK_CONFIG for Pad Output Lock
+
+/**
+  Other GPIO Configuration
+  GPIO_OTHER_CONFIG is used for less often settings and for future extensions
+  Supported settings:
+   - RX raw override to '1' - allows to override input value to '1'
+      This setting is applicable only if in input mode (both in GPIO and native usage).
+      The override takes place at the internal pad state directly from buffer and before the RXINV.
+**/
+typedef enum {
+  GpioRxRaw1Default           = 0x0,  ///< Use default input override value
+  GpioRxRaw1Dis               = 0x1,  ///< Don't override input
+  GpioRxRaw1En                = 0x3   ///< Override input to '1'
+} GPIO_OTHER_CONFIG;
+
+#define B_GPIO_OTHER_CONFIG_RXRAW_MASK           0x3   ///< Mask for GPIO_OTHER_CONFIG for RxRaw1 setting
+
+#pragma pack(pop)
+
+#endif //_GPIO_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h
new file mode 100644
index 0000000000..5b3cf502a0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h
@@ -0,0 +1,720 @@
+/** @file
+  Header file for GpioLib.
+  All function in this library is available for PEI, DXE, and SMM
+
+  @note: When GPIO pads are owned by ME Firmware, BIOS/host should not
+         attempt to access these GPIO Pads registers, registers value
+         returned in this case will be 0xFF.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_LIB_H_
+#define _GPIO_LIB_H_
+
+#include <Library/GpioConfig.h>
+
+#define GPIO_NAME_LENGTH_MAX  32
+
+typedef struct {
+  GPIO_PAD           GpioPad;
+  GPIO_CONFIG        GpioConfig;
+} GPIO_INIT_CONFIG;
+
+/**
+  This procedure will initialize multiple GPIO pins. Use GPIO_INIT_CONFIG structure.
+  Structure contains fields that can be used to configure each pad.
+  Pad not configured using GPIO_INIT_CONFIG will be left with hardware default values.
+  Separate fields could be set to hardware default if it does not matter, except
+  GpioPad and PadMode.
+  Function will work in most efficient way if pads which belong to the same group are
+  placed in adjacent records of the table.
+  Although function can enable pads for Native mode, such programming is done
+  by reference code when enabling related silicon feature.
+
+  @param[in] NumberofItem               Number of GPIO pads to be updated
+  @param[in] GpioInitTableAddress       GPIO initialization table
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+EFI_STATUS
+GpioConfigurePads (
+  IN UINT32                    NumberOfItems,
+  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
+  );
+
+//
+// Functions for setting/getting multiple GpioPad settings
+//
+
+/**
+  This procedure will read multiple GPIO settings
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[out] GpioData                  GPIO data structure
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadConfig (
+  IN  GPIO_PAD               GpioPad,
+  OUT GPIO_CONFIG            *GpioData
+  );
+
+/**
+  This procedure will configure multiple GPIO settings
+
+  @param[in] GpioPad                    GPIO Pad
+  @param[in] GpioData                   GPIO data structure
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_CONFIG               *GpioData
+  );
+
+//
+// Functions for setting/getting single GpioPad properties
+//
+
+/**
+  This procedure will set GPIO output level
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Output value
+                                  0: OutputLow, 1: OutputHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetOutputValue (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    Value
+  );
+
+/**
+  This procedure will get GPIO output level
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] OutputVal           GPIO Output value
+                                  0: OutputLow, 1: OutputHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetOutputValue (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *OutputVal
+  );
+
+/**
+  This procedure will get GPIO input level
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] InputVal            GPIO Input value
+                                  0: InputLow, 1: InputHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetInputValue (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *InputVal
+  );
+
+/**
+  This procedure will get GPIO IOxAPIC interrupt number
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] IrqNum              IRQ number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadIoApicIrqNumber (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *IrqNum
+  );
+
+/**
+  This procedure will configure GPIO input inversion
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value for GPIO input inversion
+                                  0: No input inversion, 1: Invert input
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetInputInversion (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    Value
+  );
+
+/**
+  This procedure will get GPIO pad input inversion value
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] InvertState         GPIO inversion state
+                                  0: No input inversion, 1: Inverted input
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetInputInversion (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *InvertState
+  );
+
+/**
+  This procedure will set GPIO interrupt settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of Level/Edge
+                                  use GPIO_INT_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadInterruptConfig (
+  IN GPIO_PAD                 GpioPad,
+  IN GPIO_INT_CONFIG          Value
+  );
+
+/**
+  This procedure will set GPIO electrical settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of termination
+                                  use GPIO_ELECTRICAL_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadElectricalConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_ELECTRICAL_CONFIG    Value
+  );
+
+/**
+  This procedure will set GPIO Reset settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value for Pad Reset Configuration
+                                  use GPIO_RESET_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadResetConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_RESET_CONFIG         Value
+  );
+
+/**
+  This procedure will get GPIO Reset settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of Pad Reset Configuration
+                                  based on GPIO_RESET_CONFIG
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadResetConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_RESET_CONFIG         *Value
+  );
+
+/**
+  This procedure will get Gpio Pad Host Software Ownership
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] PadHostSwOwn        Value of Host Software Pad Owner
+                                  0: ACPI Mode, 1: GPIO Driver mode
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetHostSwOwnershipForPad (
+  IN GPIO_PAD                 GpioPad,
+  OUT UINT32                  *PadHostSwOwn
+  );
+
+/**
+  This procedure will set Gpio Pad Host Software Ownership
+
+  @param[in] GpioPad              GPIO pad
+  @param[in]  PadHostSwOwn        Pad Host Software Owner
+                                  0: ACPI Mode, 1: GPIO Driver mode
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetHostSwOwnershipForPad (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    PadHostSwOwn
+  );
+
+///
+/// Possible values of Pad Ownership
+/// If Pad is not under Host ownership then GPIO registers
+/// are not accessible by host (e.g. BIOS) and reading them
+/// will return 0xFFs.
+///
+typedef enum {
+  GpioPadOwnHost = 0x0,
+  GpioPadOwnCsme = 0x1,
+  GpioPadOwnIsh  = 0x2,
+} GPIO_PAD_OWN;
+
+/**
+  This procedure will get Gpio Pad Ownership
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] PadOwnVal           Value of Pad Ownership
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadOwnership (
+  IN  GPIO_PAD                GpioPad,
+  OUT GPIO_PAD_OWN            *PadOwnVal
+  );
+
+/**
+  This procedure will check state of Pad Config Lock for pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] PadCfgLockRegVal    Value of PadCfgLock register
+                                  Bit position - PadNumber
+                                  Bit value - 0: NotLocked, 1: Locked
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioGetPadCfgLockForGroupDw (
+  IN  GPIO_GROUP                  Group,
+  IN  UINT32                      DwNum,
+  OUT UINT32                      *PadCfgLockRegVal
+  );
+
+/**
+  This procedure will check state of Pad Config Lock for selected pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] PadCfgLock          PadCfgLock for selected pad
+                                  0: NotLocked, 1: Locked
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadCfgLock (
+  IN GPIO_PAD                   GpioPad,
+  OUT UINT32                    *PadCfgLock
+  );
+
+/**
+  This procedure will check state of Pad Config Tx Lock for pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLockTx register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] PadCfgLockTxRegVal  Value of PadCfgLockTx register
+                                  Bit position - PadNumber
+                                  Bit value - 0: NotLockedTx, 1: LockedTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioGetPadCfgLockTxForGroupDw (
+  IN  GPIO_GROUP                  Group,
+  IN  UINT32                      DwNum,
+  OUT UINT32                      *PadCfgLockTxRegVal
+  );
+
+/**
+  This procedure will check state of Pad Config Tx Lock for selected pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] PadCfgLock          PadCfgLockTx for selected pad
+                                  0: NotLockedTx, 1: LockedTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadCfgLockTx (
+  IN GPIO_PAD                   GpioPad,
+  OUT UINT32                    *PadCfgLockTx
+  );
+
+/**
+  This procedure will clear PadCfgLock for selected pads within one group.
+  Unlocking a pad will cause an SMI (if enabled)
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToUnlock        Bitmask for pads which are going to be unlocked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotUnlock, 1: Unlock
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfgForGroupDw (
+  IN GPIO_GROUP                Group,
+  IN UINT32                    DwNum,
+  IN UINT32                    PadsToUnlock
+  );
+
+/**
+  This procedure will clear PadCfgLock for selected pad.
+  Unlocking a pad will cause an SMI (if enabled)
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioUnlockPadCfg (
+  IN GPIO_PAD                   GpioPad
+  );
+
+/**
+  This procedure will set PadCfgLock for selected pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLock          Bitmask for pads which are going to be locked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotLock, 1: Lock
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioLockPadCfgForGroupDw (
+  IN GPIO_GROUP                   Group,
+  IN UINT32                       DwNum,
+  IN UINT32                       PadsToLock
+  );
+
+/**
+  This procedure will set PadCfgLock for selected pad
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioLockPadCfg (
+  IN GPIO_PAD                   GpioPad
+  );
+
+/**
+  This procedure will clear PadCfgLockTx for selected pads within one group.
+  Unlocking a pad will cause an SMI (if enabled)
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLockTx register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToUnlockTx      Bitmask for pads which are going to be unlocked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotUnLockTx, 1: LockTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfgTxForGroupDw (
+  IN GPIO_GROUP                Group,
+  IN UINT32                    DwNum,
+  IN UINT32                    PadsToUnlockTx
+  );
+
+/**
+  This procedure will clear PadCfgLockTx for selected pad.
+  Unlocking a pad will cause an SMI (if enabled)
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioUnlockPadCfgTx (
+  IN GPIO_PAD                   GpioPad
+  );
+
+/**
+  This procedure will set PadCfgLockTx for selected pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLockTx        Bitmask for pads which are going to be locked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotLockTx, 1: LockTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioLockPadCfgTxForGroupDw (
+  IN GPIO_GROUP                   Group,
+  IN UINT32                       DwNum,
+  IN UINT32                       PadsToLockTx
+  );
+
+/**
+  This procedure will set PadCfgLockTx for selected pad
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioLockPadCfgTx (
+  IN GPIO_PAD                   GpioPad
+  );
+
+/**
+  This procedure will get Group to GPE mapping.
+  It will assume that only first 32 pads can be mapped to GPE.
+  To handle cases where groups have more than 32 pads and higher part of group
+  can be mapped please refer to GpioGetGroupDwToGpeDwX()
+
+  @param[out] GroupToGpeDw0       GPIO group to be mapped to GPE_DW0
+  @param[out] GroupToGpeDw1       GPIO group to be mapped to GPE_DW1
+  @param[out] GroupToGpeDw2       GPIO group to be mapped to GPE_DW2
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetGroupToGpeDwX (
+  IN GPIO_GROUP               *GroupToGpeDw0,
+  IN GPIO_GROUP               *GroupToGpeDw1,
+  IN GPIO_GROUP               *GroupToGpeDw2
+  );
+
+/**
+  This procedure will get Group to GPE mapping. If group has more than 32 bits
+  it is possible to map only single DW of pins (e.g. 0-31, 32-63) because
+  ACPI GPE_DWx register is 32 bits large.
+
+  @param[out]  GroupToGpeDw0       GPIO group mapped to GPE_DW0
+  @param[out]  GroupDwForGpeDw0    DW of pins mapped to GPE_DW0
+  @param[out]  GroupToGpeDw1       GPIO group mapped to GPE_DW1
+  @param[out]  GroupDwForGpeDw1    DW of pins mapped to GPE_DW1
+  @param[out]  GroupToGpeDw2       GPIO group mapped to GPE_DW2
+  @param[out]  GroupDwForGpeDw2    DW of pins mapped to GPE_DW2
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetGroupDwToGpeDwX (
+  OUT GPIO_GROUP                *GroupToGpeDw0,
+  OUT UINT32                    *GroupDwForGpeDw0,
+  OUT GPIO_GROUP                *GroupToGpeDw1,
+  OUT UINT32                    *GroupDwForGpeDw1,
+  OUT GPIO_GROUP                *GroupToGpeDw2,
+  OUT UINT32                    *GroupDwForGpeDw2
+  );
+
+/**
+  This procedure will get GPE number for provided GpioPad.
+  PCH allows to configure mapping between GPIO groups and related GPE (GpioSetGroupToGpeDwX())
+  what results in the fact that certain Pad can cause different General Purpose Event. Only three
+  GPIO groups can be mapped to cause unique GPE (1-tier), all others groups will be under one common
+  event (GPE_111 for 2-tier).
+
+  1-tier:
+  Returned GpeNumber is in range <0,95>. GpioGetGpeNumber() can be used
+  to determine what _LXX ACPI method would be called on event on selected GPIO pad
+
+  2-tier:
+  Returned GpeNumber is 0x6F (111). All GPIO pads which are not mapped to 1-tier GPE
+  will be under one master GPE_111 which is linked to _L6F ACPI method. If it is needed to determine
+  what Pad from 2-tier has caused the event, _L6F method should check GPI_GPE_STS and GPI_GPE_EN
+  registers for all GPIO groups not mapped to 1-tier GPE.
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpeNumber           GPE number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpeNumber (
+  IN GPIO_PAD                   GpioPad,
+  OUT UINT32                    *GpeNumber
+  );
+
+/**
+  This procedure is used to clear SMI STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioClearGpiSmiSts (
+  IN GPIO_PAD                   GpioPad
+  );
+
+/**
+  This procedure is used by Smi Dispatcher and will clear
+  all GPI SMI Status bits
+
+  @retval EFI_SUCCESS             The function completed successfully
+**/
+EFI_STATUS
+GpioClearAllGpiSmiSts (
+  VOID
+  );
+
+/**
+  This procedure is used to disable all GPI SMI
+
+  @retval EFI_SUCCESS             The function completed successfully
+**/
+EFI_STATUS
+GpioDisableAllGpiSmi (
+  VOID
+  );
+
+/**
+  This procedure is used to register GPI SMI dispatch function.
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpiNum              GPI number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiSmiNum (
+  IN GPIO_PAD          GpioPad,
+  OUT UINTN            *GpiNum
+  );
+
+/**
+  This procedure is used to check GPIO inputs belongs to 2 tier or 1 tier architecture
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval     Data                0 means 1-tier, 1 means 2-tier
+**/
+BOOLEAN
+GpioCheckFor2Tier (
+  IN GPIO_PAD                  GpioPad
+  );
+
+/**
+  This procedure is used to clear GPE STS for a specified GpioPad
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioClearGpiGpeSts (
+  IN GPIO_PAD                  GpioPad
+  );
+
+/**
+  This procedure is used to read GPE STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpeSts              Gpe status for given pad
+                                  The GpeSts is true if the status register is set for given Pad number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiGpeSts (
+  IN GPIO_PAD                  GpioPad,
+  OUT BOOLEAN                  *GpeSts
+  );
+
+/**
+  This procedure is used to get SMI STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] SmiSts              Smi status for given pad
+                                  The SmiSts is true if the status register is set for given Pad number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiSmiSts (
+  IN GPIO_PAD                   GpioPad,
+  OUT BOOLEAN                   *SmiSts
+  );
+
+/**
+  Generates GPIO name from GpioPad
+
+  @param[in]  GpioPad             GpioPad
+  @param[out] GpioNameBuffer      Caller allocated buffer for GPIO name of GPIO_NAME_LENGTH_MAX size
+  @param[in]  GpioNameBufferSize  Size of the buffer
+
+  @retval CHAR8*  Pointer to the GPIO name
+**/
+CHAR8*
+GpioGetPadName (
+  IN  GPIO_PAD  GpioPad,
+  OUT CHAR8*    GpioNameBuffer,
+  IN  UINT32    GpioNameBufferSize
+  );
+
+/**
+  Generates GPIO group name from GroupIndex
+
+  @param[in] GroupIndex  Gpio GroupIndex
+
+  @retval CHAR8*  Pointer to the GPIO group name
+**/
+CONST
+CHAR8*
+GpioGetGroupName (
+  IN UINT32  GroupIndex
+  );
+
+#endif // _GPIO_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h
new file mode 100644
index 0000000000..b09600dd30
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h
@@ -0,0 +1,149 @@
+/** @file
+  Header file for GpioLib for native and Si specific usage.
+  All function in this library is available for PEI, DXE, and SMM,
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_NATIVE_LIB_H_
+#define _GPIO_NATIVE_LIB_H_
+
+#include <Library/GpioConfig.h>
+
+/**
+  This procedure will get number of pads for certain GPIO group
+
+  @param[in] Group            GPIO group number
+
+  @retval Value               Pad number for group
+                              If illegal group number then return 0
+**/
+UINT32
+GpioGetPadPerGroup (
+  IN GPIO_GROUP        Group
+  );
+
+/**
+  This procedure will get number of groups
+
+  @param[in] none
+
+  @retval Value               Group number
+**/
+UINT32
+GpioGetNumberOfGroups (
+  VOID
+  );
+/**
+  This procedure will get lowest group
+
+  @param[in] none
+
+  @retval Value               Lowest Group
+**/
+GPIO_GROUP
+GpioGetLowestGroup (
+  VOID
+  );
+
+/**
+  This procedure will get highest group
+
+  @param[in] none
+
+  @retval Value               Highest Group
+**/
+GPIO_GROUP
+GpioGetHighestGroup (
+  VOID
+  );
+
+/**
+  This procedure will get group
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Group
+**/
+GPIO_GROUP
+GpioGetGroupFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  );
+
+/**
+  This procedure will get group index (0 based) from GpioPad
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Group Index
+**/
+UINT32
+GpioGetGroupIndexFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  );
+
+/**
+  This procedure will get group index (0 based) from group
+
+  @param[in] GpioGroup        Gpio Group
+
+  @retval Value               Group Index
+**/
+UINT32
+GpioGetGroupIndexFromGroup (
+  IN GPIO_GROUP        GpioGroup
+  );
+
+/**
+  This procedure will get group from group index (0 based)
+
+  @param[in] GroupIndex        Group Index
+
+  @retval GpioGroup            Gpio Group
+**/
+GPIO_GROUP
+GpioGetGroupFromGroupIndex (
+  IN UINT32        GroupIndex
+  );
+
+/**
+  This procedure will get pad number (0 based) from Gpio Pad
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Pad Number
+**/
+UINT32
+GpioGetPadNumberFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  );
+
+/**
+  This procedure will return GpioPad from Group and PadNumber
+
+  @param[in] Group              GPIO group
+  @param[in] PadNumber          GPIO PadNumber
+
+  @retval GpioPad               GpioPad
+**/
+GPIO_PAD
+GpioGetGpioPadFromGroupAndPadNumber (
+  IN GPIO_GROUP      Group,
+  IN UINT32          PadNumber
+  );
+
+/**
+  This procedure will return GpioPad from GroupIndex and PadNumber
+
+  @param[in] GroupIndex         GPIO GroupIndex
+  @param[in] PadNumber          GPIO PadNumber
+
+  @retval GpioPad               GpioPad
+**/
+GPIO_PAD
+GpioGetGpioPadFromGroupIndexAndPadNumber (
+  IN UINT32          GroupIndex,
+  IN UINT32          PadNumber
+  );
+
+#endif // _GPIO_NATIVE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h
new file mode 100644
index 0000000000..a53887ffcb
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h
@@ -0,0 +1,27 @@
+/** @file
+  Get Pci Express address library implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _MM_PCI_LIB_H_
+#define _MM_PCI_LIB_H_
+
+/**
+  This procedure will get PCIE address
+
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+
+  @retval PCIE address
+**/
+UINTN
+EFIAPI
+MmPciBase (
+  IN UINT32                       Bus,
+  IN UINT32                       Device,
+  IN UINT32                       Function
+);
+
+#endif // _PEI_DXE_SMM_MM_PCI_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h
new file mode 100644
index 0000000000..3c46029b7f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h
@@ -0,0 +1,123 @@
+/** @file
+  Header file for PchPcieRpLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCIERP_LIB_H_
+#define _PCH_PCIERP_LIB_H_
+
+#include <Library/PchPcrLib.h>
+
+/**
+  PCIe controller bifurcation configuration.
+**/
+typedef enum {
+  PcieBifurcationDefault = 0,
+  PcieBifurcation4x1,
+  PcieBifurcation1x2_2x1,
+  PcieBifurcation2x2,
+  PcieBifurcation1x4,
+  PcieBifurcation4x2,
+  PcieBifurcation1x4_2x2,
+  PcieBifurcation2x2_1x4,
+  PcieBifurcation2x4,
+  PcieBifurcation1x8,
+  PcieBifurcationUnknown,
+  PcieBifurcationMax
+} PCIE_BIFURCATION_CONFIG;
+
+/**
+  This function returns PID according to PCIe controller index
+
+  @param[in] ControllerIndex     PCIe controller index
+
+  @retval PCH_SBI_PID    Returns PID for SBI Access
+**/
+PCH_SBI_PID
+PchGetPcieControllerSbiPid (
+  IN UINT32  ControllerIndex
+  );
+
+/**
+  This function returns PID according to Root Port Number
+
+  @param[in] RpIndex     Root Port Index (0-based)
+
+  @retval PCH_SBI_PID    Returns PID for SBI Access
+**/
+PCH_SBI_PID
+GetRpSbiPid (
+  IN UINTN  RpIndex
+  );
+
+/**
+  Get Pch Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber            Root port physical number. (0-based)
+  @param[out] RpDev               Return corresponding root port device number.
+  @param[out] RpFun               Return corresponding root port function number.
+
+  @retval EFI_SUCCESS
+**/
+EFI_STATUS
+EFIAPI
+GetPchPcieRpDevFun (
+  IN  UINTN   RpNumber,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  );
+
+/**
+  Get Root Port physical Number by Pch Pcie Root Port Device and Function Number
+
+  @param[in]  RpDev                 Root port device number.
+  @param[in]  RpFun                 Root port function number.
+  @param[out] RpNumber              Return corresponding physical Root Port index (0-based)
+
+  @retval     EFI_SUCCESS           Physical root port is retrieved
+  @retval     EFI_INVALID_PARAMETER RpDev and/or RpFun are invalid
+  @retval     EFI_UNSUPPORTED       Root port device and function is not assigned to any physical root port
+**/
+EFI_STATUS
+EFIAPI
+GetPchPcieRpNumber (
+  IN  UINTN   RpDev,
+  IN  UINTN   RpFun,
+  OUT UINTN   *RpNumber
+  );
+
+/**
+  Gets pci segment base address of PCIe root port.
+
+  @param RpIndex    Root Port Index (0 based)
+  @return PCIe port base address.
+**/
+UINT64
+PchPcieBase (
+  IN  UINT32   RpIndex
+  );
+
+/**
+  Determines whether L0s is supported on current stepping.
+
+  @return TRUE if L0s is supported, FALSE otherwise
+**/
+BOOLEAN
+PchIsPcieL0sSupported (
+  VOID
+  );
+
+/**
+  Some early PCH steppings require Native ASPM to be disabled due to hardware issues:
+   - RxL0s exit causes recovery
+   - Disabling PCIe L0s capability disables L1
+  Use this function to determine affected steppings.
+
+  @return TRUE if Native ASPM is supported, FALSE otherwise
+**/
+BOOLEAN
+PchIsPcieNativeAspmSupported (
+  VOID
+  );
+#endif // _PCH_PCIERP_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h
new file mode 100644
index 0000000000..f46c3da0e1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h
@@ -0,0 +1,256 @@
+/** @file
+  Header file for PchPcrLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCR_LIB_H_
+#define _PCH_PCR_LIB_H_
+
+#include <PchReservedResources.h>
+
+/**
+  Definition for PCR address
+  The PCR address is used to the PCR MMIO programming
+
+  SBREG_BAR_20BITADDRESS is configured by SoC
+
+  SBREG_BAR_20BITADDRESS=1, the format has included 16b addressing.
+  +---------------------------------------------------------------------------------------------+
+  | Addr[63:28]    | Addr[27:24]           | Addr[23:16]     | Addr[15:2]           | Addr[1:0] |
+  +----------------+-----------------------+-----------------+----------------------------------+
+  | REG_BAR[63:28] | TargetRegister[19:16] | TargetPort[7:0] | TargetRegister[15:2]             |
+  +---------------------------------------------------------------------------------------------+
+
+  SBREG_BAR_20BITADDRESS=0
+  +---------------------------------------------------------------------------------------------+
+  | Addr[63:24]    | Addr[27:24]           | Addr[23:16]     | Addr[15:2]           | Addr[1:0] |
+  +----------------+-----------------------+-----------------+----------------------------------+
+  | REG_BAR[63:24] | REG_BAR[27:24]        | TargetPort[7:0] | TargetRegister[15:2]             |
+  +---------------------------------------------------------------------------------------------+
+**/
+#define PCH_PCR_ADDRESS(Pid, Offset)    (PCH_PCR_BASE_ADDRESS | (UINT32) (((Offset) & 0x0F0000) << 8) | ((UINT8)(Pid) << 16) | (UINT16) ((Offset) & 0xFFFF))
+
+/**
+  PCH PCR boot script accessing macro
+  Those macros are only available for DXE phase.
+**/
+#define PCH_PCR_BOOT_SCRIPT_WRITE(Width, Pid, Offset, Count, Buffer) \
+          S3BootScriptSaveMemWrite (Width, PCH_PCR_ADDRESS (Pid, Offset), Count, Buffer); \
+
+#define PCH_PCR_BOOT_SCRIPT_READ_WRITE(Width, Pid, Offset, DataOr, DataAnd) \
+          S3BootScriptSaveMemReadWrite (Width, PCH_PCR_ADDRESS (Pid, Offset), DataOr, DataAnd); \
+
+#define PCH_PCR_BOOT_SCRIPT_READ(Width, Pid, Offset, BitMask, BitValue) \
+          S3BootScriptSaveMemPoll (Width, PCH_PCR_ADDRESS (Pid, Offset), BitMask, BitValue, 1, 1);
+
+typedef UINT8          PCH_SBI_PID;
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT32       PCR register value.
+**/
+UINT32
+PchPcrRead32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  );
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT16       PCR register value.
+**/
+UINT16
+PchPcrRead16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  );
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT8        PCR register value
+**/
+UINT8
+PchPcrRead8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval UINT32       Value written to register
+**/
+UINT32
+PchPcrWrite32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            InData
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval  UINT16      Value written to register
+**/
+UINT16
+PchPcrWrite16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT16                            InData
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval  UINT8       Value written to register
+**/
+UINT8
+PchPcrWrite8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT8                             InData
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT32      Value written to register
+
+**/
+UINT32
+PchPcrAndThenOr32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  );
+
+/**
+  Write PCR register and read back.
+  The read back ensures the PCR cycle is completed before next operation.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT32      Value read back from the register
+**/
+UINT32
+PchPcrAndThenOr32WithReadback (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval UINT16       Value written to register
+
+**/
+UINT16
+PchPcrAndThenOr16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT16                            AndData,
+  IN  UINT16                            OrData
+  );
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT8       Value written to register
+
+**/
+UINT8
+PchPcrAndThenOr8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT8                             AndData,
+  IN  UINT8                             OrData
+  );
+
+
+typedef enum {
+  PchIpDmi = 1,
+  PchIpIclk,
+} PCH_IP_PID_ENUM;
+
+#define PCH_INVALID_PID 0
+
+/**
+  Get PCH IP PID number
+
+  @param[in]  IpEnum   PCH IP in PCH_IP_PID_ENUM
+
+  @retval     0        PID of this IP is not supported
+              !0       PID of the IP.
+**/
+PCH_SBI_PID
+PchPcrGetPid (
+  PCH_IP_PID_ENUM  IpEnum
+  );
+
+#endif // _PCH_PCR_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h
new file mode 100644
index 0000000000..8ab20f0db7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h
@@ -0,0 +1,173 @@
+/** @file
+  Header file for PCI Express helpers base library
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCIE_HELPER_LIB_H_
+#define _PCIE_HELPER_LIB_H_
+
+#include <PcieRegs.h>
+#include <Library/PciSegmentLib.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <IndustryStandard/Pci.h>
+
+/**
+  Find the Offset to a given Capabilities ID
+  CAPID list:
+    0x01 = PCI Power Management Interface
+    0x04 = Slot Identification
+    0x05 = MSI Capability
+    0x10 = PCI Express Capability
+
+  @param[in] DeviceBase           device's base address
+  @param[in] CapId                CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PcieBaseFindCapId (
+  IN UINT64  DeviceBase,
+  IN UINT8   CapId
+  );
+
+/**
+  Find the Offset to a given Capabilities ID
+  CAPID list:
+    0x01 = PCI Power Management Interface
+    0x04 = Slot Identification
+    0x05 = MSI Capability
+    0x10 = PCI Express Capability
+
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PcieFindCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT8   CapId
+  );
+
+/**
+  Search and return the offset of desired Pci Express Capability ID
+  CAPID list:
+    0x0001 = Advanced Error Reporting Capability
+    0x0002 = Virtual Channel Capability
+    0x0003 = Device Serial Number Capability
+    0x0004 = Power Budgeting Capability
+
+  @param[in] DeviceBase           device base address
+  @param[in] CapId                Extended CAPID to search for
+
+  @retval 0                       CAPID not found, this includes situation where device doesn't exist
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT16
+PcieBaseFindExtendedCapId (
+  IN UINT64  DeviceBase,
+  IN UINT16  CapId
+  );
+
+/**
+  Search and return the offset of desired Pci Express Capability ID
+  CAPID list:
+    0x0001 = Advanced Error Rreporting Capability
+    0x0002 = Virtual Channel Capability
+    0x0003 = Device Serial Number Capability
+    0x0004 = Power Budgeting Capability
+
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                Extended CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT16
+PcieFindExtendedCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT16  CapId
+  );
+
+/*
+  Checks device's Slot Clock Configuration
+
+  @param[in] Base            device's base address
+  @param[in] PcieCapOffset   devices Pci express capability list register offset
+
+  @retval TRUE when device device uses slot clock, FALSE otherwise
+*/
+BOOLEAN
+GetScc (
+  UINT64    Base,
+  UINT8     PcieCapOffset
+  );
+
+/*
+  Sets Common Clock Configuration bit for given device.
+  @param[in] PcieCapOffset   devices Pci express capability list register offset
+  @param[in] Base            device's base address
+*/
+VOID
+EnableCcc (
+  UINT64    Base,
+  UINT8     PcieCapOffset
+  );
+
+/*
+  Retrains link behind given device.
+  It only makes sense to call it for downstream ports.
+  If called for upstream port nothing will happen, it won't enter infinite loop.
+
+  @param[in] Base                 device's base address
+  @param[in] PcieCapOffset        devices Pci express capability list register offset
+  @param[boolean] WaitUnitlDone   when TRUE, function waits until link has retrained
+*/
+VOID
+RetrainLink (
+  UINT64  Base,
+  UINT8   PcieCapOffset,
+  BOOLEAN WaitUntilDone
+  );
+
+/*
+  Checks if device at given address exists
+
+  @param[in] Base            device's base address
+
+  @retval TRUE when device exists; FALSE otherwise
+*/
+BOOLEAN
+IsDevicePresent (
+  UINT64 Base
+  );
+
+/*
+  Checks if device is a multifunction device
+
+  @param[in] Base            device's base address
+
+  @retval TRUE if multifunction; FALSE otherwise
+*/
+BOOLEAN
+IsMultifunctionDevice (
+  UINT64 Base
+  );
+#endif // _PCIE_HELPER_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h
new file mode 100644
index 0000000000..0b8ad7a182
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h
@@ -0,0 +1,355 @@
+/** @file
+  Header file for PmcLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PMC_LIB_H_
+#define _PMC_LIB_H_
+
+#pragma pack(1)
+
+typedef enum {
+  PmcTPch25_10us = 0,
+  PmcTPch25_100us,
+  PmcTPch25_1ms,
+  PmcTPch25_10ms,
+} PMC_TPCH25_TIMING;
+
+typedef enum {
+  PmcNotASleepState,
+  PmcInS0State,
+  PmcS1SleepState,
+  PmcS2SleepState,
+  PmcS3SleepState,
+  PmcS4SleepState,
+  PmcS5SleepState,
+  PmcUndefinedState,
+} PMC_SLEEP_STATE;
+
+typedef struct {
+  UINT32    Buf0;
+  UINT32    Buf1;
+  UINT32    Buf2;
+  UINT32    Buf3;
+} PMC_IPC_COMMAND_BUFFER;
+
+//
+// Structure to Check different attributes for CrashLog supported by PMC.
+//
+typedef union {
+  struct {
+    UINT32  Avail      : 1;        ///< CrashLog feature availability bit
+    UINT32  Dis        : 1;        ///< CrasLog Disable bit
+    UINT32  Rsvd       : 2;        ///< Reserved
+    UINT32  Size       : 12;       ///< CrasLog data size. (If it is zero, use default size 0xC00)
+    UINT32  BaseOffset : 16;       ///< Start offset of CrashLog in PMC SSRAM
+  } Bits;
+  struct {
+    UINT32  Avail      : 1;        ///< CrashLog feature availability bit
+    UINT32  Dis        : 1;        ///< CrasLog Disable bit
+    UINT32  Mech       : 2;        ///< CrashLog mechanism
+    UINT32  ManuTri    : 1;        ///< Manul trigger command.
+    UINT32  Clr        : 1;        ///< Clear Command
+    UINT32  AllReset   : 1;        ///< Trigger on all reset command
+    UINT32  ReArm      : 1;        ///< Re-arm command
+    UINT32  Rsvd       : 20;       ///< Pch Specific reserved
+    UINT32  CrashLogReq: 1;        ///< Crash log requestor flow
+    UINT32  TriArmedSts: 1;        ///< Trigger armed status, re-arm indication bit.
+    UINT32  TriAllReset: 1;        ///< Trigger on all resets status
+    UINT32  CrashDisSts: 1;        ///< Crash log disabled status
+    UINT32  PchRsvd    : 16;       ///< Pch Specific reserved
+    UINT32  DesTableOffset: 16;    ///< Descriptor Table offset
+  } Bits64;
+  UINT32  Uint32;
+  UINT64  Uint64;
+} PMC_IPC_DISCOVERY_BUF;
+
+typedef union {
+  struct {
+    UINT32 Offset   : 16;
+    UINT32 Size     : 16;
+  } Info;
+  UINT32 Uint32;
+} PMC_CRASHLOG_RECORDS;
+
+typedef struct PmcCrashLogLink {
+  PMC_CRASHLOG_RECORDS      Record;
+  UINT64                    AllocateAddress;
+  struct PmcCrashLogLink    *Next;
+} PMC_CRASHLOG_LINK;
+
+#pragma pack()
+
+/**
+  Get PCH ACPI base address.
+
+  @retval Address                   Address of PWRM base address.
+**/
+UINT16
+PmcGetAcpiBase (
+  VOID
+  );
+
+/**
+  Get PCH PWRM base address.
+
+  @retval Address                   Address of PWRM base address.
+**/
+UINT32
+PmcGetPwrmBase (
+  VOID
+  );
+
+/**
+  This function sets tPCH25 timing
+
+  @param[in] TimingValue       tPCH25 timing value (10us, 100us, 1ms, 10ms)
+**/
+VOID
+PmcSetTPch25Timing (
+  IN PMC_TPCH25_TIMING    TimingValue
+  );
+
+/**
+  This function checks if RTC Power Failure occurred by
+  reading RTC_PWR_FLR bit
+
+  @retval RTC Power Failure state: TRUE  - Battery is always present.
+                                   FALSE - CMOS is cleared.
+**/
+BOOLEAN
+PmcIsRtcBatteryGood (
+  VOID
+  );
+
+/**
+  This function checks if Power Failure occurred by
+  reading PWR_FLR bit
+
+  @retval Power Failure state
+**/
+BOOLEAN
+PmcIsPowerFailureDetected (
+  VOID
+  );
+
+/**
+  This function checks if Power Failure occurred by
+  reading SUS_PWR_FLR bit
+
+  @retval SUS Power Failure state
+**/
+BOOLEAN
+PmcIsSusPowerFailureDetected (
+  VOID
+  );
+
+/**
+  This function clears Power Failure status (PWR_FLR)
+**/
+VOID
+PmcClearPowerFailureStatus (
+  VOID
+  );
+
+/**
+  This function clears Global Reset status (GBL_RST_STS)
+**/
+VOID
+PmcClearGlobalResetStatus (
+  VOID
+  );
+
+/**
+  This function clears Host Reset status (HOST_RST_STS)
+**/
+VOID
+PmcClearHostResetStatus (
+  VOID
+  );
+
+/**
+  This function clears SUS Power Failure status (SUS_PWR_FLR)
+**/
+VOID
+PmcClearSusPowerFailureStatus (
+  VOID
+  );
+
+/**
+  This function sets state to which platform will get after power is reapplied
+
+  @param[in] PowerStateAfterG3          0: S0 state (boot)
+                                        1: S5/S4 State
+**/
+VOID
+PmcSetPlatformStateAfterPowerFailure (
+  IN UINT8 PowerStateAfterG3
+  );
+
+/**
+  This function enables Power Button SMI
+**/
+VOID
+PmcEnablePowerButtonSmi (
+  VOID
+  );
+
+/**
+  This function disables Power Button SMI
+**/
+VOID
+PmcDisablePowerButtonSmi (
+  VOID
+  );
+
+/**
+  This function reads PM Timer Count driven by 3.579545 MHz clock
+
+  @retval PM Timer Count
+**/
+UINT32
+PmcGetTimerCount (
+  VOID
+  );
+
+/**
+  Get Sleep Type that platform has waken from
+
+  @retval SleepType                Sleep Type
+**/
+PMC_SLEEP_STATE
+PmcGetSleepTypeAfterWake (
+  VOID
+  );
+
+/**
+  Clear PMC Wake Status
+**/
+VOID
+PmcClearWakeStatus (
+  VOID
+  );
+
+/**
+  Configure sleep state
+
+  @param[in] SleepState         S0/S1/S3/S4/S5, refer to PMC_SLEEP_STATE
+**/
+VOID
+PmcSetSleepState (
+  PMC_SLEEP_STATE  SleepState
+  );
+
+/**
+  Check if platform boots after shutdown caused by power button override event
+
+  @retval  TRUE   Power Button Override occurred in last system boot
+  @retval  FALSE  Power Button Override didn't occur
+**/
+BOOLEAN
+PmcIsPowerButtonOverrideDetected (
+  VOID
+  );
+
+/**
+  This function will set the DISB - DRAM Initialization Scratchpad Bit.
+**/
+VOID
+PmcSetDramInitScratchpad (
+  VOID
+  );
+
+/**
+  Check global SMI enable is set
+
+  @retval TRUE  Global SMI enable is set
+          FALSE Global SMI enable is not set
+**/
+BOOLEAN
+PmcIsGblSmiEn (
+  VOID
+  );
+
+/**
+  This function checks if SMI Lock is set
+
+  @retval SMI Lock state
+**/
+BOOLEAN
+PmcIsSmiLockSet (
+  VOID
+  );
+
+/**
+  This function checks if Debug Mode is locked
+
+  @retval Debug Mode Lock state
+**/
+BOOLEAN
+PmcIsDebugModeLocked (
+  VOID
+  );
+
+/**
+  Check TCO second timeout status.
+
+  @retval  TRUE   TCO reboot happened.
+  @retval  FALSE  TCO reboot didn't happen.
+**/
+BOOLEAN
+TcoSecondToHappened (
+  VOID
+  );
+
+/**
+  This function clears the Second TO status bit
+**/
+VOID
+TcoClearSecondToStatus (
+  VOID
+  );
+
+/**
+  Check TCO SMI ENABLE is locked
+
+  @retval TRUE  TCO SMI ENABLE is locked
+          FALSE TCO SMI ENABLE is not locked
+**/
+BOOLEAN
+TcoIsSmiLock (
+  VOID
+  );
+
+/**
+  Check if user wants to turn off in PEI phase
+
+**/
+VOID
+CheckPowerOffNow(
+  VOID
+  );
+
+
+/**
+  Clear any SMI status or wake status left from boot.
+**/
+VOID
+ClearSmiAndWake (
+  VOID
+  );
+
+/**
+  Function to check if Dirty Warm Reset occurs
+  (Global Reset has been converted to Host Reset)
+
+  @reval TRUE DWR occurs
+  @reval FALSE Normal boot flow
+**/
+BOOLEAN
+PmcIsDwrBootMode (
+  VOID
+  );
+
+#endif // _PMC_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h
new file mode 100644
index 0000000000..9ab55ad9d0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h
@@ -0,0 +1,79 @@
+/** @file
+  System reset Library Services.  This library class defines a set of
+  methods that reset the whole system.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef __RESET_SYSTEM_LIB_H__
+#define __RESET_SYSTEM_LIB_H__
+
+/**
+  This function causes a system-wide reset (cold reset), in which
+  all circuitry within the system returns to its initial state. This type of reset
+  is asynchronous to system operation and operates without regard to
+  cycle boundaries.
+
+  If this function returns, it means that the system does not support cold reset.
+**/
+VOID
+EFIAPI
+ResetCold (
+  VOID
+  );
+
+/**
+  This function causes a system-wide initialization (warm reset), in which all processors
+  are set to their initial state. Pending cycles are not corrupted.
+
+  If this function returns, it means that the system does not support warm reset.
+**/
+VOID
+EFIAPI
+ResetWarm (
+  VOID
+  );
+
+/**
+  This function causes the system to enter a power state equivalent
+  to the ACPI G2/S5 or G3 states.
+
+  If this function returns, it means that the system does not support shutdown reset.
+**/
+VOID
+EFIAPI
+ResetShutdown (
+  VOID
+  );
+
+/**
+  This function causes the system to enter S3 and then wake up immediately.
+
+  If this function returns, it means that the system does not support S3 feature.
+**/
+VOID
+EFIAPI
+EnterS3WithImmediateWake (
+  VOID
+  );
+
+/**
+  This function causes a systemwide reset. The exact type of the reset is
+  defined by the EFI_GUID that follows the Null-terminated Unicode string passed
+  into ResetData. If the platform does not recognize the EFI_GUID in ResetData
+  the platform must pick a supported reset type to perform.The platform may
+  optionally log the parameters from any non-normal reset that occurs.
+
+  @param[in]  DataSize   The size, in bytes, of ResetData.
+  @param[in]  ResetData  The data buffer starts with a Null-terminated string,
+                         followed by the EFI_GUID.
+**/
+VOID
+EFIAPI
+ResetPlatformSpecific (
+  IN UINTN   DataSize,
+  IN VOID    *ResetData
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h
new file mode 100644
index 0000000000..bc1555ed19
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h
@@ -0,0 +1,112 @@
+/** @file
+  Header file for SataLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SATA_LIB_H_
+#define _SATA_LIB_H_
+
+#define SATA_1_CONTROLLER_INDEX             0
+#define SATA_2_CONTROLLER_INDEX             1
+#define SATA_3_CONTROLLER_INDEX             2
+
+/**
+  Get Maximum Sata Port Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     Maximum Sata Port Number
+**/
+UINT8
+MaxSataPortNum (
+  IN UINT32     SataCtrlIndex
+  );
+
+/**
+  Gets Maximum Sata Controller Number
+
+  @retval Maximum Sata Controller Number
+**/
+UINT8
+MaxSataControllerNum (
+  VOID
+  );
+
+/**
+  Get SATA controller's Port Present Status
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     Port Present Status
+**/
+UINT8
+GetSataPortPresentStatus (
+  IN UINT32  SataCtrlIndex
+  );
+
+/**
+  Get SATA controller Function Disable Status
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval 0 SATA Controller is not Function Disabled
+  @retval 1 SATA Controller is Function Disabled
+**/
+BOOLEAN
+SataControllerFunctionDisableStatus (
+  IN UINT32  SataCtrlIndex
+  );
+
+/**
+  Get SATA controller ABAR size
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller ABAR size
+**/
+UINT32
+GetSataAbarSize (
+  IN UINT32  SataCtrlIndex
+  );
+
+/**
+  Get SATA controller AHCI base address
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller AHCI base address
+**/
+UINT32
+GetSataAhciBase (
+  IN UINT32  SataCtrlIndex
+  );
+
+/**
+  Check if SATA controller supports RST remapping
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     TRUE                Controller supports remapping
+  @retval     FALSE               Controller does not support remapping
+**/
+BOOLEAN
+IsRemappingSupportedOnSata (
+  IN UINT32  SataCtrlIndex
+  );
+
+/**
+  Checks if SoC supports the SATA PGD power down on given
+  SATA controller.
+
+  @param[in] SataCtrlIndex  SATA controller index
+
+  @retval TRUE   SATA PGD power down supported
+  @retval FALSE  SATA PGD power down not supported
+**/
+BOOLEAN
+IsSataPowerGatingSupported (
+  IN UINT32 SataCtrlIndex
+  );
+
+#endif // _SATA_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h
new file mode 100644
index 0000000000..3c8aae6ac2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h
@@ -0,0 +1,113 @@
+/** @file
+  Header file for Serial Io Common Lib
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_ACCESS_LIB_H_
+#define _SERIAL_IO_ACCESS_LIB_H_
+
+/**
+  Returns BAR0
+
+  @param[in] PciCfgBase         Pci Config Base
+
+  @retval    64bit MMIO BAR Address
+**/
+UINT64
+GetSerialIoBar (
+  IN UINT64        PciCfgBase
+  );
+
+/**
+  Returns I2C Pci Config Space
+
+  @param[in] I2cNumber         I2C Number
+
+  @retval    I2C Pci Config Space Address
+**/
+UINT64
+GetSerialIoI2cPciCfg (
+  IN UINT8        I2cNumber
+  );
+
+/**
+  Returns SPI Pci Config Space
+
+  @param[in] SpiNumber         SPI Number
+
+  @retval    SPI Pci Config Space Address
+**/
+UINT64
+GetSerialIoSpiPciCfg (
+  IN UINT8        SpiNumber
+  );
+
+/**
+  Returns UART Pci Config Space
+
+  @param[in] UartNumber         UART Number
+
+  @retval    UART Pci Config Space Address
+**/
+UINT64
+GetSerialIoUartPciCfg (
+  IN UINT8        UartNumber
+  );
+
+/**
+  Checks if Device with given PciDeviceId is one of SerialIo I2C controllers
+  If yes, its number is returned through I2cIndex parameter, otherwise I2cIndex is not updated
+
+  @param[in]  PciDevId                  Device ID
+  @param[out] I2cNumber                 Number of SerialIo I2C controller
+
+  @retval TRUE                          yes it is a SerialIo I2C controller
+  @retval FALSE                         no it isn't a SerialIo I2C controller
+**/
+BOOLEAN
+IsSerialIoI2cDeviceId (
+  IN  UINT16    PciDevId,
+  OUT UINT8     *I2cNumber
+  );
+
+/**
+  Checks if I2c is Function 0 Enabled
+
+  @param[in] I2cIndex                   Number of the SerialIo I2C controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoI2cFunction0Enabled (
+  IN UINT8    I2cIndex
+  );
+
+/**
+  Checks if Uart is Function 0 Enabled
+
+  @param[in] UartIndex                   Number of the SerialIo Uart controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoUartFunction0Enabled (
+  IN UINT8    UartIndex
+  );
+
+/**
+  Checks if Spi is Function 0 Enabled
+
+  @param[in] SpiIndex                   Number of the SerialIo Spi controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoSpiFunction0Enabled (
+  IN UINT8    SpiIndex
+  );
+
+#endif // _SERIAL_IO_ACCESS_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h
new file mode 100644
index 0000000000..7732ccf59e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h
@@ -0,0 +1,56 @@
+/** @file
+  Prototype of the SiConfigBlockLib library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_CONFIG_BLOCK_LIB_H_
+#define _SI_CONFIG_BLOCK_LIB_H_
+
+
+typedef
+VOID
+(*LOAD_DEFAULT_FUNCTION) (
+  IN VOID   *ConfigBlockPointer
+  );
+
+typedef struct {
+  EFI_GUID               *Guid;
+  UINT16                 Size;
+  UINT8                  Revision;
+  LOAD_DEFAULT_FUNCTION  LoadDefault;
+} COMPONENT_BLOCK_ENTRY;
+
+/**
+  GetComponentConfigBlockTotalSize get config block table total size.
+
+  @param[in] ComponentBlocks    Component blocks array
+  @param[in] TotalBlockCount    Number of blocks
+
+  @retval                       Size of config block table
+**/
+UINT16
+EFIAPI
+GetComponentConfigBlockTotalSize (
+  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
+  IN UINT16                TotalBlockCount
+  );
+
+/**
+  AddComponentConfigBlocks add all config blocks.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add config blocks
+  @param[in] ComponentBlocks            Config blocks array
+  @param[in] TotalBlockCount            Number of blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+AddComponentConfigBlocks (
+  IN VOID                  *ConfigBlockTableAddress,
+  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
+  IN UINT16                TotalBlockCount
+  );
+#endif // _SI_CONFIG_BLOCK_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h
new file mode 100644
index 0000000000..50f9e048b3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h
@@ -0,0 +1,290 @@
+/** @file
+  SPI library header for abstraction of SPI HW registers accesses
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SPI_ACCESS_LIB_H_
+#define _SPI_ACCESS_LIB_H_
+
+/**
+  Returns SPI PCI Config Space base address
+
+  @retval  UINT64  SPI Config Space base address
+**/
+UINT64
+SpiGetPciCfgAddress (
+  VOID
+  );
+
+/**
+  Returns SPI BAR0 value
+
+  @retval  UINT32  PCH SPI BAR0 value
+**/
+UINT32
+SpiGetBar0 (
+  VOID
+  );
+
+/**
+  Returns SPI Device number
+
+  @retval UINT8   PCH SPI Device number
+**/
+UINT8
+SpiDeviceNumber (
+  VOID
+  );
+
+/**
+  Returns SPI Function number
+
+  @retval UINT8   PCH SPI Function number
+**/
+UINT8
+SpiFunctionNumber (
+  VOID
+  );
+
+/**
+  Returns descriptor signature
+
+  @retval UINT32    Descriptor signature
+**/
+UINT32
+SpiGetDescriptorSignature (
+  VOID
+  );
+
+/**
+  Returns supported features and R/W frequencies of Flash Component
+
+  @retval UINT32    Flash Component features descriptor
+**/
+UINT32
+SpiGetFlashComponentDescription (
+  VOID
+  );
+
+/**
+  Returns number of Flash Components
+
+  @retval UINT32    Flash components number
+**/
+UINT32
+SpiGetFlashComponentsNumber (
+  VOID
+  );
+
+/**
+  Returns total Flash size with regards to number of flash components
+
+  @retval UINT32    Total Flash Memory size
+**/
+UINT32
+SpiGetTotalFlashSize (
+  VOID
+  );
+
+/**
+  Checks if PCH SPI Controler is present and available
+
+  @retval TRUE    PCH SPI controller is avaialable
+  @retval FALSE   PCH SPI controller is not available
+**/
+BOOLEAN
+SpiIsControllerAvailable (
+  VOID
+  );
+
+/**
+  Checks BIOS lock bits for proper value and checks if write protection is enabled
+  Expected vales are: LE bit set, EISS bit set and WPD bit cleared
+
+  @retval  TRUE    All protection bits are set correctly
+  @retval  FALSE   Not all protection bits had exepcted values
+**/
+BOOLEAN
+SpiIsWriteProtectionEnabled (
+  VOID
+  );
+
+/**
+  Returns Flash Descriptor Override Pin Strap status
+
+  @retval TRUE     Flash Descriptor override is enabled
+  @retval FALSE    Flash Descriptor override is disabled
+**/
+BOOLEAN
+SpiIsFlashDescriptorOverrideEnabled (
+  VOID
+  );
+
+/**
+  Returns Flash Configuration Lock Down bit status
+
+  @retval TRUE    Flash Configuration Lock Down bit is set
+  @retval FALSE   Flash Configuration Lock Down bit is not set
+**/
+BOOLEAN
+SpiIsFlashConfigurationLockDownEnabled (
+  VOID
+  );
+
+/**
+  Returns Top Swap functionality enable state
+
+  @retval TRUE    Top Swap is enabled
+  @retval FALSE   Top Swap is disabled
+**/
+BOOLEAN
+SpiIsTopSwapEnabled (
+  VOID
+  );
+
+/**
+  Return Component Property Parameter Table for a given component number
+
+  @param[in]  ComponentNumber   SPI Component number
+  @param[out] CppTable          Component Poperty Parameter Table value
+
+  @retval TRUE  Vendor Specific Component Capabilities Register value was read
+  @reval  FALSE Vendor Specific Component Capabilities Register value was not present
+**/
+BOOLEAN
+SpiGetComponentPropertyParameterTable (
+  IN  UINT8  ComponentNumber,
+  OUT UINT32 *CppTable
+  );
+
+/**
+  Returns valid bit status in given Component Property Parameter Table
+
+  @param[in] CppTable          Component Poperty Parameter Table value
+
+  @retval TRUE    Valid bit is set
+  @reval  FALSE   Valid bit is not set
+**/
+BOOLEAN
+SpiIsCppValidBitSet (
+  IN UINT32  CppTable
+  );
+
+/**
+  Checks if Flash Descriptor is valid
+
+  @retval TRUE  Flash Descriptor is valid
+  @retval FALSE Flash Descriptor is invalid
+**/
+BOOLEAN
+SpiIsFlashDescriptorValid (
+  VOID
+  );
+
+/**
+  Returns masked BIOS Master Read Access
+
+  @retval UINT32    Already masked BIOS Master Read Access
+**/
+UINT32
+SpiGetMasterReadAccess (
+  VOID
+  );
+
+/**
+  Returns masked BIOS Master Write Access
+
+  @retval UINT32    Already masked BIOS Master Write Access
+**/
+UINT32
+SpiGetMasterWriteAccess (
+  VOID
+  );
+
+/**
+  Returns GbE Region Access rights
+
+  @retval UINT32    GbE Region access rights
+**/
+UINT32
+SpiGetGbeRegionAccess (
+  VOID
+  );
+
+/**
+  Returns CSME region access rights
+
+  @retval UINT32    CSME Region Access rights
+**/
+UINT32
+SpiGetCsmeRegionAccess (
+  VOID
+  );
+
+/**
+  Returns EC region access right
+
+  @retval UINT32     EC Region access rights
+**/
+UINT32
+SpiGetEcRegionAccess (
+  VOID
+  );
+
+/**
+  Checks if Slave Attached Flash (SAF) mode is active
+
+  @retval TRUE    SAF mode is active
+  @retval FALSE   SAF mode is not active
+**/
+BOOLEAN
+SpiIsSafModeActive (
+  VOID
+  );
+
+/**
+  Checks validity of GbE region
+
+  @retval TRUE    GbE region is valid
+  @retval FALSE   GbE regios in invalid
+**/
+BOOLEAN
+SpiIsGbeRegionValid (
+  VOID
+  );
+
+/**
+  Returns status of BIOS Interface Lockdown
+
+  @retval TRUE  BIOS Interface Lockdown is enabled
+  @retval FALSE BIOS Interface Lockdown is disabled
+**/
+BOOLEAN
+SpiIsBiosInterfaceLockdownEnabled (
+  VOID
+  );
+
+/**
+  Returns TRUE if BIOS Boot Strap is set to SPI
+
+  @retval TRUE    BIOS Boot strap is set to SPI
+  @retval FALSE   BIOS Boot strap is set to LPC/eSPI
+**/
+BOOLEAN
+SpiIsBiosBootFromSpi (
+  VOID
+  );
+
+/**
+  Check SPI write status disable is set
+
+  @retval TRUE    Write status disable is set
+  @retval FALSE   Write status disable is not set
+**/
+BOOLEAN
+SpiIsWriteStatusDisable (
+  VOID
+  );
+
+#endif // _SPI_ACCESS_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h
new file mode 100644
index 0000000000..69eed8d32d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h
@@ -0,0 +1,53 @@
+/** @file
+  Header file for VtdInfoLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _VTD_INFO_LIB_H_
+#define _VTD_INFO_LIB_H_
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/HobLib.h>
+
+#define VTD_ENGINE_NUMBER             7
+
+#pragma pack(1)
+
+/**
+  Get VTD Engine Base Address from PCD values.
+
+  @param[in]  VtdEngineNumber        - Engine number for which VTD Base Adderess is required.
+
+  @retval   VTD Engine Base Address
+**/
+UINT32
+GetVtdBaseAddress (
+  IN UINT8        VtdEngineNumber
+  );
+
+/**
+  Read VTD Engine Base Address from VTD BAR Offsets.
+
+  @param[in]  VtdEngineNumber        - Engine number for which VTD Base Adderess is required.
+
+  @retval   VTD Engine Base Address
+**/
+UINT32
+ReadVtdBaseAddress (
+  IN UINT8        VtdEngineNumber
+  );
+
+/**
+  GetMaxVtdEngineNumber: Get Maximum Vtd Engine Number
+
+  @retval Vtd Engine Number
+**/
+UINT8
+GetMaxVtdEngineNumber(
+  VOID
+);
+
+#pragma pack()
+#endif // _VTD_INFO_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h
new file mode 100644
index 0000000000..f296c780f5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h
@@ -0,0 +1,32 @@
+/** @file
+  Header file for FSP-M Arch Config PPI
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _FSPM_ARCH_CONFIG_PPI_H_
+#define _FSPM_ARCH_CONFIG_PPI_H_
+
+///
+/// Global ID for the FSPM_ARCH_CONFIG_PPI.
+///
+#define FSPM_ARCH_CONFIG_GUID \
+  { \
+    0x824d5a3a, 0xaf92, 0x4c0c, { 0x9f, 0x19, 0x19, 0x52, 0x6d, 0xca, 0x4a, 0xbb } \
+  }
+
+///
+/// This PPI provides FSP-M Arch Config PPI.
+///
+typedef struct {
+  UINT8         Revision;
+  UINT8         Reserved[3];
+  VOID          *NvsBufferPtr;
+  UINT32        BootLoaderTolumSize;
+  UINT8         Reserved1[4];
+} FSPM_ARCH_CONFIG_PPI;
+
+extern EFI_GUID gFspmArchConfigPpiGuid;
+
+#endif // _FSPM_ARCH_CONFIG_PPI_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h
new file mode 100644
index 0000000000..3fd917c2b9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h
@@ -0,0 +1,34 @@
+/** @file
+  This file defines the function to initialize default silicon policy PPI.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
+#define _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
+
+//
+// Forward declaration for the PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI.
+//
+typedef struct _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI;
+
+/**
+  Initialize and install default silicon policy PPI
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PEI_PREMEM_POLICY_INIT) (
+  VOID
+  );
+
+///
+/// This PPI provides function to install default silicon policy
+///
+struct _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI {
+  PEI_PREMEM_POLICY_INIT   PeiPreMemPolicyInit;   ///< PeiPreMemPolicyInit()
+};
+
+extern EFI_GUID gSiPreMemDefaultPolicyInitPpiGuid;
+
+#endif // _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h
new file mode 100644
index 0000000000..9cb34728cc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h
@@ -0,0 +1,33 @@
+/** @file
+  This file defines the function to initialize default silicon policy PPI.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
+#define _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
+
+//
+// Forward declaration for the PEI_SI_DEFAULT_POLICY_INIT_PPI.
+//
+typedef struct _PEI_SI_DEFAULT_POLICY_INIT_PPI PEI_SI_DEFAULT_POLICY_INIT_PPI;
+
+/**
+  Initialize and install default silicon policy PPI
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PEI_POLICY_INIT) (
+  VOID
+  );
+
+///
+/// This PPI provides function to install default silicon policy
+///
+struct _PEI_SI_DEFAULT_POLICY_INIT_PPI {
+  PEI_POLICY_INIT   PeiPolicyInit;    ///< PeiPolicyInit()
+};
+
+extern EFI_GUID gSiDefaultPolicyInitPpiGuid;
+
+#endif // _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h
new file mode 100644
index 0000000000..eb75c4cc4d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h
@@ -0,0 +1,79 @@
+/** @file
+  Silicon Policy PPI is used for specifying platform
+  related Intel silicon information and policy setting.
+  This PPI is consumed by the silicon PEI modules and carried
+  over to silicon DXE modules.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SI_POLICY_PPI_H_
+#define _SI_POLICY_PPI_H_
+
+#include <SiPolicyStruct.h>
+#include <PchPolicyCommon.h>
+#include <PchPreMemPolicyCommon.h>
+#include <MePolicyCommon.h>
+#include <CpuPolicyCommon.h>
+#include <Uefi.h>
+#include <Library/ConfigBlockLib.h>
+
+#ifndef DISABLED
+#define DISABLED  0
+#endif
+#ifndef ENABLED
+#define ENABLED   1
+#endif
+
+extern EFI_GUID gSiPreMemPolicyPpiGuid;
+extern EFI_GUID gSiPolicyPpiGuid;
+
+
+#include <GraphicsConfig.h>
+extern EFI_GUID gGraphicsPeiPreMemConfigGuid;
+extern EFI_GUID gGraphicsPeiConfigGuid;
+
+#include <VtdConfig.h>
+extern EFI_GUID gVtdConfigGuid;
+
+#include <GnaConfig.h>
+extern EFI_GUID gGnaConfigGuid;
+
+
+
+#include <CpuPcieConfigGen3.h>
+#include <CpuPcieConfig.h>
+extern EFI_GUID gCpuPciePeiPreMemConfigGuid;
+extern EFI_GUID gCpuPcieRpConfigGuid;
+
+
+#include <HybridGraphicsConfig.h>
+extern EFI_GUID gHybridGraphicsConfigGuid;
+
+#include <ConfigBlock/PramPreMemConfig.h>
+#include <MemoryConfig.h>
+extern EFI_GUID gMemoryConfigGuid;
+extern EFI_GUID gMemoryConfigNoCrcGuid;
+
+#include <ConfigBlock/SaMiscPeiPreMemConfig.h>
+extern EFI_GUID gSaMiscPeiPreMemConfigGuid;
+
+#include <ConfigBlock/SaMiscPeiConfig.h>
+extern EFI_GUID gSaMiscPeiConfigGuid;
+
+
+#include <TraceHubConfig.h>
+extern EFI_GUID gCpuTraceHubConfigGuid;
+
+#include <HostBridgeConfig.h>
+extern EFI_GUID gHostBridgePeiPreMemConfigGuid;
+extern EFI_GUID gHostBridgePeiConfigGuid;
+
+#include <CpuDmiPreMemConfig.h>
+extern EFI_GUID gCpuDmiPreMemConfigGuid;
+
+typedef struct _SI_PREMEM_POLICY_STRUCT SI_PREMEM_POLICY_PPI;
+typedef struct _SI_POLICY_STRUCT SI_POLICY_PPI;
+
+#endif // _SI_POLICY_PPI_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.h
new file mode 100644
index 0000000000..1d69ee0e8d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.h
@@ -0,0 +1,61 @@
+/** @file
+  Protocol to retrieve the GOP driver version
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GOP_COMPONENT_NAME2_H_
+#define _GOP_COMPONENT_NAME2_H_
+
+
+typedef struct _GOP_COMPONENT_NAME2_PROTOCOL  GOP_COMPONENT_NAME2_PROTOCOL;
+
+///
+/// GOP Component protocol for retrieving driver name
+///
+typedef
+EFI_STATUS
+(EFIAPI *GOP_COMPONENT_NAME2_GET_DRIVER_NAME) (
+  IN  GOP_COMPONENT_NAME2_PROTOCOL * This,
+  IN  CHAR8                           *Language,
+  OUT CHAR16                          **DriverName
+  );
+
+///
+/// GOP Component protocol for retrieving controller name
+///
+typedef
+EFI_STATUS
+(EFIAPI *GOP_COMPONENT_NAME2_GET_CONTROLLER_NAME) (
+  IN  GOP_COMPONENT_NAME2_PROTOCOL          * This,
+  IN  EFI_HANDLE                               ControllerHandle,
+  IN  EFI_HANDLE                               ChildHandle OPTIONAL,
+  IN  CHAR8                                    *Language,
+  OUT CHAR16                                   **ControllerName
+  );
+
+///
+/// GOP Component protocol for retrieving driver version
+///
+typedef
+EFI_STATUS
+(EFIAPI *GOP_COMPONENT_NAME2_GET_DRIVER_VERSION) (
+  IN  GOP_COMPONENT_NAME2_PROTOCOL          * This,
+  IN  CHAR8                                    *Language,
+  OUT CHAR16                                   **DriverVersion
+  );
+
+/**
+  GOP Component protocol\n
+  This protocol will be installed by GOP driver and can be used to retrieve GOP information.
+**/
+struct _GOP_COMPONENT_NAME2_PROTOCOL {
+  GOP_COMPONENT_NAME2_GET_DRIVER_NAME      GetDriverName;          ///< Protocol function to get driver name
+  GOP_COMPONENT_NAME2_GET_DRIVER_VERSION   GetDriverVersion;       ///< Protocol function to get driver version
+  GOP_COMPONENT_NAME2_GET_CONTROLLER_NAME  GetControllerName;      ///< Protocol function to get controller name
+  CHAR8                                    *SupportedLanguages;    ///< Number of Supported languages.
+};
+
+extern EFI_GUID gGopComponentName2ProtocolGuid;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h
new file mode 100644
index 0000000000..c8dc17008e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h
@@ -0,0 +1,73 @@
+/** @file
+  Interface definition for GopPolicy Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GOP_POLICY_PROTOCOL_H_
+#define _GOP_POLICY_PROTOCOL_H_
+
+
+#define GOP_POLICY_PROTOCOL_REVISION_01  0x01
+#define GOP_POLICY_PROTOCOL_REVISION_03  0x03
+
+typedef enum {
+  LidClosed,
+  LidOpen,
+  LidStatusMax
+} LID_STATUS;
+
+typedef enum {
+  Docked,
+  UnDocked,
+  DockStatusMax
+} DOCK_STATUS;
+
+///
+/// Function to retrieve LID status
+///
+typedef
+EFI_STATUS
+(EFIAPI *GET_PLATFORM_LID_STATUS) (
+  OUT LID_STATUS * CurrentLidStatus
+  );
+
+///
+/// Function to retrieve Dock status
+///
+typedef
+EFI_STATUS
+(EFIAPI *GET_PLATFORM_DOCK_STATUS) (
+ OUT DOCK_STATUS  CurrentDockStatus
+);
+
+///
+/// Function to retrieve VBT table address and size
+///
+typedef
+EFI_STATUS
+(EFIAPI *GET_VBT_DATA) (
+  OUT EFI_PHYSICAL_ADDRESS * VbtAddress,
+  OUT UINT32               *VbtSize
+  );
+
+/**
+  System Agent Graphics Output Protocol (GOP) - Policy Protocol\n
+  Graphics Output Protocol (GOP) is a UEFI API replacing legacy Video ROMs for EFI boot\n
+  When GOP Driver is used this protocol can be consumed by GOP driver or platform code for GOP relevant initialization\n
+  All functions in this protocol should be initialized by platform code basing on platform implementation\n
+**/
+typedef struct {
+  UINT32                    Revision;              ///< Protocol revision
+  GET_PLATFORM_LID_STATUS   GetPlatformLidStatus;  ///< Protocol function to get Lid Status. Platform code should provide this function basing on design.
+  GET_VBT_DATA              GetVbtData;            ///< Protocol function to get Vbt Data address and size. Platform code should provide this function basing on design.
+  GET_PLATFORM_DOCK_STATUS  GetPlatformDockStatus;  ///< Function pointer for get platform dock status.
+  EFI_GUID                  GopOverrideGuid;        ///< A GUID provided by BIOS in case GOP is to be overridden.
+} GOP_POLICY_PROTOCOL;
+
+extern EFI_GUID gGopPolicyProtocolGuid;
+extern EFI_GUID gGen12PolicyProtocolGuid;
+extern EFI_GUID gGen9PolicyProtocolGuid;
+extern EFI_GUID gIntelGraphicsVbtGuid;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h
new file mode 100644
index 0000000000..c030f771e3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h
@@ -0,0 +1,22 @@
+/** @file
+  This file is part of the IGD OpRegion Implementation.  The IGD OpRegion is
+  an interface between system BIOS, ASL code, and Graphics drivers.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IGD_OPREGION_PROTOCOL_H_
+#define _IGD_OPREGION_PROTOCOL_H_
+
+#include <IndustryStandard/IgdOpRegion.h>
+
+extern EFI_GUID gIgdOpRegionProtocolGuid;
+
+///
+/// IGD OpRegion Protocol
+///
+typedef struct {
+  IGD_OPREGION_STRUCTURE  *OpRegion; ///< IGD Operation Region Structure
+} IGD_OPREGION_PROTOCOL;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h
new file mode 100644
index 0000000000..c13dc5a5f5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h
@@ -0,0 +1,301 @@
+/** @file
+  This file defines the PCH SPI Protocol which implements the
+  Intel(R) PCH SPI Host Controller Compatibility Interface.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SPI_PROTOCOL_H_
+#define _PCH_SPI_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                   gPchSpiProtocolGuid;
+extern EFI_GUID                   gPchSmmSpiProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_SPI_PROTOCOL  PCH_SPI_PROTOCOL;
+
+//
+// SPI protocol data structures and definitions
+//
+
+/**
+  Flash Region Type
+**/
+typedef enum {
+  FlashRegionDescriptor,
+  FlashRegionBios,
+  FlashRegionMe,
+  FlashRegionGbE,
+  FlashRegionPlatformData,
+  FlashRegionDer,
+  FlashRegionSecondaryBios,
+  FlashRegionuCodePatch,
+  FlashRegionEC,
+  FlashRegionDeviceExpansion2,
+  FlashRegionIE,
+  FlashRegion10Gbe_A,
+  FlashRegion10Gbe_B,
+  FlashRegion13,
+  FlashRegion14,
+  FlashRegion15,
+  FlashRegionAll,
+  FlashRegionMax
+} FLASH_REGION_TYPE;
+//
+// Protocol member functions
+//
+
+/**
+  Read data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[out] Buffer              The Pointer to caller-allocated buffer containing the dada received.
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_READ) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *Buffer
+  );
+
+/**
+  Write data to the flash part. Remark: Erase may be needed before write to the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[in] Buffer               Pointer to caller-allocated buffer containing the data sent during the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_WRITE) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *Buffer
+  );
+
+/**
+  Erase some area on the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_ERASE) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount
+  );
+
+/**
+  Read SFDP data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] Address              The starting byte address for SFDP data read.
+  @param[in] ByteCount            Number of bytes in SFDP data portion of the SPI cycle
+  @param[out] SfdpData            The Pointer to caller-allocated buffer containing the SFDP data received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_READ_SFDP) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *SfdpData
+  );
+
+/**
+  Read Jedec Id from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] ByteCount            Number of bytes in JedecId data portion of the SPI cycle, the data size is 3 typically
+  @param[out] JedecId             The Pointer to caller-allocated buffer containing JEDEC ID received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_READ_JEDEC_ID) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *JedecId
+  );
+
+/**
+  Write the status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[in] StatusValue          The Pointer to caller-allocated buffer containing the value of Status register writing
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_WRITE_STATUS) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *StatusValue
+  );
+
+/**
+  Read status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[out] StatusValue         The Pointer to caller-allocated buffer containing the value of Status register received.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_FLASH_READ_STATUS) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *StatusValue
+  );
+
+/**
+  Get the SPI region base and size, based on the enum type
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for for the base address which is listed in the Descriptor.
+  @param[out] BaseAddress         The Flash Linear Address for the Region 'n' Base
+  @param[out] RegionSize          The size for the Region 'n'
+
+  @retval EFI_SUCCESS             Read success
+  @retval EFI_INVALID_PARAMETER   Invalid region type given
+  @retval EFI_DEVICE_ERROR        The region is not used
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_GET_REGION_ADDRESS) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  OUT    UINT32             *BaseAddress,
+  OUT    UINT32             *RegionSize
+  );
+
+/**
+  Read PCH Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing PCH Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_READ_PCH_SOFTSTRAP) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  );
+
+/**
+  Read CPU Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        CPU Soft Strap address offset from FCPUSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle.
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing CPU Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SPI_READ_CPU_SOFTSTRAP) (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  );
+
+/**
+  These protocols/PPI allows a platform module to perform SPI operations through the
+  Intel PCH SPI Host Controller Interface.
+**/
+struct _PCH_SPI_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                             Revision;
+  PCH_SPI_FLASH_READ                FlashRead;          ///< Read data from the flash part.
+  PCH_SPI_FLASH_WRITE               FlashWrite;         ///< Write data to the flash part. Remark: Erase may be needed before write to the flash part.
+  PCH_SPI_FLASH_ERASE               FlashErase;         ///< Erase some area on the flash part.
+  PCH_SPI_FLASH_READ_SFDP           FlashReadSfdp;      ///< Read SFDP data from the flash part.
+  PCH_SPI_FLASH_READ_JEDEC_ID       FlashReadJedecId;   ///< Read Jedec Id from the flash part.
+  PCH_SPI_FLASH_WRITE_STATUS        FlashWriteStatus;   ///< Write the status register in the flash part.
+  PCH_SPI_FLASH_READ_STATUS         FlashReadStatus;    ///< Read status register in the flash part.
+  PCH_SPI_GET_REGION_ADDRESS        GetRegionAddress;   ///< Get the SPI region base and size
+  PCH_SPI_READ_PCH_SOFTSTRAP        ReadPchSoftStrap;   ///< Read PCH Soft Strap Values
+  PCH_SPI_READ_CPU_SOFTSTRAP        ReadCpuSoftStrap;   ///< Read CPU Soft Strap Values
+};
+
+/**
+  PCH SPI PPI/PROTOCOL revision number
+
+  Revision 1:   Initial version
+**/
+#define PCH_SPI_SERVICES_REVISION       1
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
  2021-02-01  1:36 ` [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:52   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers Heng Luo
                   ` (37 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Include/Pins
  * Include/Register
  * Include/*.h

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h            |  53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h             |  38 ++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h      |  75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h             | 138 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h                    |  57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h         |  24 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h               | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h    | 110 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h     |  72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h      | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h  | 226 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h  |  16 ++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h    |  36 ++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h |  93 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h       | 258 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h       |  45 +++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h      |  56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h  |  47 +++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h       |  51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h        | 213 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h            |  17 +++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h         |  64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 22 files changed, 1965 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h
new file mode 100644
index 0000000000..ad34e4ea42
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h
@@ -0,0 +1,53 @@
+/** @file
+  Header file for Config Block Lib implementation
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CONFIG_BLOCK_H_
+#define _CONFIG_BLOCK_H_
+
+#include <Uefi/UefiBaseType.h>
+#include <Uefi/UefiMultiPhase.h>
+#include <Pi/PiBootMode.h>
+#include <Pi/PiHob.h>
+
+#pragma pack (push,1)
+
+///
+/// Config Block Header
+///
+typedef struct _CONFIG_BLOCK_HEADER {
+  EFI_HOB_GUID_TYPE GuidHob;                      ///< Offset 0-23  GUID extension HOB header
+  UINT8             Revision;                     ///< Offset 24    Revision of this config block
+  UINT8             Attributes;                   ///< Offset 25    The main revision for config block
+  UINT8             Reserved[2];                  ///< Offset 26-27 Reserved for future use
+} CONFIG_BLOCK_HEADER;
+
+///
+/// Config Block
+///
+typedef struct _CONFIG_BLOCK {
+  CONFIG_BLOCK_HEADER            Header;          ///< Offset 0-27  Header of config block
+  //
+  // Config Block Data
+  //
+} CONFIG_BLOCK;
+
+///
+/// Config Block Table Header
+///
+typedef struct _CONFIG_BLOCK_TABLE_STRUCT {
+  CONFIG_BLOCK_HEADER            Header;          ///< Offset 0-27  GUID number for main entry of config block
+  UINT8                          Rsvd0[2];        ///< Offset 28-29 Reserved for future use
+  UINT16                         NumberOfBlocks;  ///< Offset 30-31 Number of config blocks (N)
+  UINT32                         AvailableSize;   ///< Offset 32-35 Current config block table size
+///
+/// Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+///
+} CONFIG_BLOCK_TABLE_HEADER;
+#pragma pack (pop)
+
+#endif // _CONFIG_BLOCK_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h
new file mode 100644
index 0000000000..23a408e8dc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h
@@ -0,0 +1,38 @@
+/** @file
+  The GUID definition for CpuPcieHob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PCIE_HOB_H_
+#define _CPU_PCIE_HOB_H_
+
+#include <Base.h>
+#include <CpuPcieInfo.h>
+#include <CpuPcieConfig.h>
+
+extern EFI_GUID gCpuPcieHobGuid;
+#pragma pack (push,1)
+
+/**
+  The CPU_PCIE_HOB block describes the expected configuration of the CpuPcie controllers
+**/
+typedef struct {
+  ///
+  /// These members describe the configuration of each CPU PCIe root port.
+  ///
+  EFI_HOB_GUID_TYPE           EfiHobGuidType;                           ///< Offset 0 - 23: GUID Hob type structure for gCpuPcieHobGuid
+  CPU_PCIE_ROOT_PORT_CONFIG   RootPort[CPU_PCIE_MAX_ROOT_PORTS];
+  UINT8                       L1SubStates[CPU_PCIE_MAX_ROOT_PORTS];  ///< The L1 Substates configuration of the root port
+
+  UINT32                      DekelFwVersionMinor;                      ///< Dekel Firmware Minor Version
+  UINT32                      DekelFwVersionMajor;                      ///< Dekel Firmware Major Version
+  BOOLEAN                     InitPcieAspmAfterOprom;                   ///< 1=initialize PCIe ASPM after Oprom; 0=before (This will be set basing on policy)
+  UINT32                      RpEnabledMask;                            ///< Rootport enabled mask based on DEVEN register
+  UINT32                      RpEnMaskFromDevEn;                        ///< Rootport enabled mask based on Device Id
+  UINT8                       DisableClkReqMsg[CPU_PCIE_MAX_ROOT_PORTS];     ///< 1=ClkReqMsg disabled, 0=ClkReqMsg enabled
+  UINT8                       SlotSelection;                            ///< 1=M2 slot, 0=CEMx4 slot
+  BOOLEAN                     ComplianceTest;                           ///< Compliance Test based on policy
+} CPU_PCIE_HOB;
+#pragma pack (pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h
new file mode 100644
index 0000000000..5b058c7a45
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h
@@ -0,0 +1,75 @@
+/** @file
+  This code defines ACPI DMA Remapping table related definitions.
+  See the System Agent BIOS specification for definition of the table.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DMA_REMAPPING_TABLE_H_
+#define _DMA_REMAPPING_TABLE_H_
+
+#include <Uefi.h>
+#include <Base.h>
+#include <IndustryStandard/DmaRemappingReportingTable.h>
+#include <IndustryStandard/Acpi.h>
+#include <TcssInfo.h>
+
+#pragma pack(1)
+///
+/// DMAR table signature
+///
+#define EFI_ACPI_VTD_DMAR_TABLE_SIGNATURE   0x52414D44  ///< "DMAR"
+#define EFI_ACPI_DMAR_TABLE_REVISION        2
+#define EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH  0x10
+#define EFI_ACPI_RMRR_HEADER_LENGTH         0x18
+#define MAX_PCI_DEPTH                       5
+
+typedef struct {
+  EFI_ACPI_DMAR_DEVICE_SCOPE_STRUCTURE_HEADER DeviceScopeStructureHeader;
+  EFI_ACPI_DMAR_PCI_PATH                      PciPath;     // device, function
+} EFI_ACPI_DEV_SCOPE_STRUCTURE;
+
+typedef struct {
+  EFI_ACPI_DMAR_DRHD_HEADER     DrhdHeader;
+  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];
+} EFI_ACPI_DRHD_ENGINE1_STRUCT;
+
+typedef struct {
+  EFI_ACPI_DMAR_DRHD_HEADER     DrhdHeader;
+  //
+  // @todo use PCD
+  //
+  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[2];
+} EFI_ACPI_DRHD_ENGINE3_STRUCT;
+
+typedef struct {
+  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
+  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[2];
+} EFI_ACPI_RMRR_USB_STRUC;
+
+typedef struct {
+  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
+  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];    // IGD
+} EFI_ACPI_RMRR_IGD_STRUC;
+
+typedef struct {
+  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
+  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];    // IGD - DiSM
+} EFI_ACPI_RMRR_IGD_DISM_STRUC;
+
+typedef struct {
+  EFI_ACPI_DMAR_ANDD_HEADER     AnddHeader;
+  UINT8                         AcpiObjectName[20];
+} EFI_ACPI_ANDD_STRUC;
+
+typedef struct {
+  EFI_ACPI_DMAR_HEADER          DmarHeader;
+  EFI_ACPI_DRHD_ENGINE1_STRUCT  DrhdEngine1;
+  EFI_ACPI_DRHD_ENGINE3_STRUCT  DrhdEngine3;
+  EFI_ACPI_RMRR_IGD_STRUC       RmrrIgd;
+  EFI_ACPI_RMRR_IGD_DISM_STRUC  RmrrIgdDism;
+} EFI_ACPI_DMAR_TABLE;
+
+#pragma pack()
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h
new file mode 100644
index 0000000000..edb3855b68
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h
@@ -0,0 +1,138 @@
+/** @file
+  Header file for DxePchHdaNhltLib - NHLT structure definitions.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _DXE_HDA_NHLT_H_
+#define _DXE_HDA_NHLT_H_
+
+#include <IndustryStandard/Acpi.h>
+
+//
+// ACPI support protocol instance signature definition.
+//
+#define NHLT_ACPI_TABLE_SIGNATURE  SIGNATURE_32 ('N', 'H', 'L', 'T')
+
+// MSFT defined structures
+#define SPEAKER_FRONT_LEFT      0x1
+#define SPEAKER_FRONT_RIGHT     0x2
+#define SPEAKER_FRONT_CENTER    0x4
+#define SPEAKER_BACK_LEFT       0x10
+#define SPEAKER_BACK_RIGHT      0x20
+
+#define KSAUDIO_SPEAKER_MONO   (SPEAKER_FRONT_CENTER)
+#define KSAUDIO_SPEAKER_STEREO (SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT)
+#define KSAUDIO_SPEAKER_QUAD   (SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT | SPEAKER_BACK_LEFT | SPEAKER_BACK_RIGHT)
+
+#define WAVE_FORMAT_EXTENSIBLE    0xFFFE /* Microsoft */
+#define KSDATAFORMAT_SUBTYPE_PCM \
+        {0x00000001, 0x0000, 0x0010, {0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}}
+
+#pragma pack (push, 1)
+
+typedef struct {
+  UINT16  wFormatTag;
+  UINT16  nChannels;
+  UINT32  nSamplesPerSec;
+  UINT32  nAvgBytesPerSec;
+  UINT16  nBlockAlign;
+  UINT16  wBitsPerSample;
+  UINT16  cbSize;
+} WAVEFORMATEX;
+
+typedef struct {
+  WAVEFORMATEX Format;
+  union {
+    UINT16 wValidBitsPerSample;
+    UINT16 wSamplesPerBlock;
+    UINT16 wReserved;
+  } Samples;
+  UINT32       dwChannelMask;
+  GUID         SubFormat;
+} WAVEFORMATEXTENSIBLE;
+
+//
+// List of supported link type.
+//
+enum NHLT_LINK_TYPE
+{
+  HdaNhltLinkHd   = 0,
+  HdaNhltLinkDsp  = 1,
+  HdaNhltLinkDmic = 2,
+  HdaNhltLinkSsp  = 3,
+  HdaNhltLinkInvalid
+};
+
+//
+// List of supported device type.
+//
+enum NHLT_SSP_DEVICE_TYPE
+{
+  HdaNhltSspDeviceBt   = 0,
+  HdaNhltSspDeviceI2s  = 4,
+  HdaNhltSspDeviceInvalid
+};
+
+enum NHLT_PDM_DEVICE_TYPE
+{
+  HdaNhltPdmDeviceDmic = 0,
+  HdaNhltPdmDeviceInvalid
+};
+
+typedef struct {
+  UINT32    CapabilitiesSize;
+  UINT8     Capabilities[1];
+} SPECIFIC_CONFIG;
+
+typedef struct {
+  WAVEFORMATEXTENSIBLE Format;
+  SPECIFIC_CONFIG      FormatConfiguration;
+} FORMAT_CONFIG;
+
+typedef struct {
+  UINT8           FormatsCount;
+  FORMAT_CONFIG   FormatsConfiguration[1];
+} FORMATS_CONFIG;
+
+typedef struct {
+  UINT8           DeviceId[16];
+  UINT8           DeviceInstanceId;
+  UINT8           DevicePortId;
+} DEVICE_INFO;
+
+typedef struct {
+  UINT8           DeviceInfoCount;
+  DEVICE_INFO     DeviceInformation[1];
+} DEVICES_INFO;
+
+typedef struct {
+  UINT32          EndpointDescriptorLength;
+  UINT8           LinkType;
+  UINT8           InstanceId;
+  UINT16          HwVendorId;
+  UINT16          HwDeviceId;
+  UINT16          HwRevisionId;
+  UINT32          HwSubsystemId;
+  UINT8           DeviceType;
+  UINT8           Direction;
+  UINT8           VirtualBusId;
+  SPECIFIC_CONFIG EndpointConfig;
+  FORMATS_CONFIG  FormatsConfig;
+  DEVICES_INFO    DevicesInformation;
+} ENDPOINT_DESCRIPTOR;
+
+//
+// High Level Table structure
+//
+typedef struct {
+  EFI_ACPI_DESCRIPTION_HEADER Header; //{'N', 'H', 'L', 'T'}
+  UINT8                       EndpointCount;   // Actual number of endpoints
+  ENDPOINT_DESCRIPTOR         EndpointDescriptors[1];
+  SPECIFIC_CONFIG             OedConfiguration;
+} NHLT_ACPI_TABLE;
+
+#pragma pack (pop)
+
+#endif // _DXE_PCH_HDA_NHLT_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h
new file mode 100644
index 0000000000..ab3f2c9cd0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h
@@ -0,0 +1,57 @@
+/** @file
+  Header file for HD Audio configuration.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _HDA_H_
+#define _HDA_H_
+
+typedef enum {
+  HdaVc0 = 0,
+  HdaVc1 = 1
+} HDAUDIO_VC_TYPE;
+
+typedef enum {
+  HdaDmicDisabled = 0,
+  HdaDmic2chArray = 1,
+  HdaDmic4chArray = 2,
+  HdaDmic1chArray = 3
+} HDAUDIO_DMIC_TYPE;
+
+typedef enum {
+  HdaLinkFreq6MHz  = 0,
+  HdaLinkFreq12MHz = 1,
+  HdaLinkFreq24MHz = 2,
+  HdaLinkFreq48MHz = 3,
+  HdaLinkFreq96MHz = 4,
+  HdaLinkFreqInvalid
+} HDAUDIO_LINK_FREQUENCY;
+
+typedef enum  {
+  HdaIDispMode2T  = 0,
+  HdaIDispMode1T  = 1,
+  HdaIDispMode4T  = 2,
+  HdaIDispMode8T  = 3,
+  HdaIDispMode16T = 4,
+  HdaIDispTModeInvalid
+} HDAUDIO_IDISP_TMODE;
+
+typedef enum {
+  HdaLink      = 0,
+  HdaIDispLink = 1,
+  HdaDmic      = 2,
+  HdaSsp       = 3,
+  HdaSndw      = 4,
+  HdaLinkUnsupported
+} HDAUDIO_LINK_TYPE;
+
+typedef enum {
+  HdaDmicClockSelectBoth = 0,
+  HdaDmicClockSelectClkA = 1,
+  HdaDmicClockSelectClkB = 2,
+  HdaDmicClockSelectInvalid
+} HDAUDIO_DMIC_CLOCK_SELECT;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h
new file mode 100644
index 0000000000..023ba12daa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h
@@ -0,0 +1,24 @@
+/** @file
+  Definition for ME common policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _ME_POLICY_COMMON_H_
+#define _ME_POLICY_COMMON_H_
+
+#include <ConfigBlock.h>
+
+#include <MePeiConfig.h>
+
+#ifndef PLATFORM_POR
+#define PLATFORM_POR  0
+#endif
+#ifndef FORCE_ENABLE
+#define FORCE_ENABLE  1
+#endif
+#ifndef FORCE_DISABLE
+#define FORCE_DISABLE 2
+#endif
+
+#endif // _ME_POLICY_COMMON_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h
new file mode 100644
index 0000000000..d98019d1b4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h
@@ -0,0 +1,155 @@
+/** @file
+  Register names for PCIE standard register
+
+  Conventions:
+
+  - Prefixes:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register sizes
+    Definitions beginning with "N_" are the bit position
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCIE_REGS_H_
+#define _PCIE_REGS_H_
+
+#include <IndustryStandard/Pci30.h>
+
+//
+// PCI type 0 Header
+//
+#define R_PCI_BCC_OFFSET                          0x0B
+
+//
+// PCI type 1 Header
+//
+#define R_PCI_BRIDGE_BNUM                         0x18 ///< Bus Number Register
+#define B_PCI_BRIDGE_BNUM_SBBN                    0x00FF0000 ///< Subordinate Bus Number
+#define B_PCI_BRIDGE_BNUM_SCBN                    0x0000FF00 ///< Secondary Bus Number
+
+//
+// PCI Express Capability List Register (CAPID:10h)
+//
+#define R_PCIE_XCAP_OFFSET                        0x02 ///< PCI Express Capabilities Register (Offset 02h)
+#define B_PCIE_XCAP_DT                            (BIT7 | BIT6 | BIT5 | BIT4) ///< Device/Port Type
+#define N_PCIE_XCAP_DT                            4
+
+#define R_PCIE_DCAP_OFFSET                        0x04 ///< Device Capabilities Register (Offset 04h)
+#define B_PCIE_DCAP_RBER                          BIT15 ///< Role-Based Error Reporting
+#define B_PCIE_DCAP_E1AL                          (BIT11 | BIT10 | BIT9) ///< Endpoint L1 Acceptable Latency
+#define N_PCIE_DCAP_E1AL                          9
+#define B_PCIE_DCAP_E0AL                          (BIT8 | BIT7 | BIT6) ///< Endpoint L0s Acceptable Latency
+#define N_PCIE_DCAP_E0AL                          6
+#define B_PCIE_DCAP_MPS                           (BIT2 | BIT1 | BIT0) ///< Max_Payload_Size Supported
+
+#define R_PCIE_DCTL_OFFSET                        0x08 ///< Device Control Register (Offset 08h)
+#define B_PCIE_DCTL_MPS                           (BIT7 | BIT6 | BIT5) ///< Max_Payload_Size
+#define N_PCIE_DCTL_MPS                           5
+
+#define R_PCIE_LCAP_OFFSET                        0x0C ///< Link Capabilities Register (Offset 0Ch)
+#define B_PCIE_LCAP_CPM                           BIT18 ///< Clock Power Management
+#define B_PCIE_LCAP_EL1                           (BIT17 | BIT16 | BIT15) ///< L1 Exit Latency
+#define N_PCIE_LCAP_EL1                           15
+#define B_PCIE_LCAP_EL0                           (BIT14 | BIT13 | BIT12) ///< L0s Exit Latency
+#define N_PCIE_LCAP_EL0                           12
+#define B_PCIE_LCAP_APMS_L0S                      BIT10
+#define B_PCIE_LCAP_APMS_L1                       BIT11
+#define B_PCIE_LCAP_MLS                           (BIT3 | BIT2 | BIT1 | BIT0) ///< Max Link Speed
+#define V_PCIE_LCAP_MLS_GEN3                      3
+#define V_PCIE_LCAP_MLS_GEN4                      4
+
+#define R_PCIE_LCTL_OFFSET                        0x10 ///< Link Control Register (Offset 10h)
+#define B_PCIE_LCTL_ECPM                          BIT8 ///< Enable Clock Power Management
+#define B_PCIE_LCTL_CCC                           BIT6 ///< Common Clock Configuration
+#define B_PCIE_LCTL_RL                            BIT5 ///< Retrain Link
+#define B_PCIE_LCTL_ASPM                          (BIT1 | BIT0) ///< Active State Power Management (ASPM) Control
+#define V_PCIE_LCTL_ASPM_L0S                      1
+#define V_PCIE_LCTL_ASPM_L1                       2
+#define V_PCIE_LCTL_ASPM_L0S_L1                   3
+
+#define R_PCIE_LSTS_OFFSET                        0x12 ///< Link Status Register (Offset 12h)
+#define B_PCIE_LSTS_LA                            BIT13 ///< Data Link Layer Link Active
+#define B_PCIE_LSTS_SCC                           BIT12 ///< Slot Clock Configuration
+#define B_PCIE_LSTS_LT                            BIT11 ///< Link Training
+#define B_PCIE_LSTS_NLW                           0x03F0 ///< Negotiated Link Width
+#define N_PCIE_LSTS_NLW                           4
+#define B_PCIE_LSTS_CLS                           0x000F ///< Current Link Speed
+
+#define R_PCIE_SLCAP_OFFSET                       0x14 ///< Slot Capabilities Register (Offset 14h)
+#define B_PCIE_SLCAP_HPC                          BIT6       ///< Hot-Plug Capable
+
+#define R_PCIE_SLSTS_OFFSET                       0x1A ///< Slot Status Register (Offset 1Ah)
+#define B_PCIE_SLSTS_PDS                          BIT6 ///< Presence Detect State
+
+#define R_PCIE_DCAP2_OFFSET                       0x24 ///< Device Capabilities 2 Register (Offset 24h)
+#define B_PCIE_DCAP2_LTRMS                        BIT11 ///< LTR Mechanism Supported
+
+#define R_PCIE_DCTL2_OFFSET                       0x28 ///< Device Control 2 Register (Offset 28h)
+#define B_PCIE_DCTL2_LTREN                        BIT10 ///< LTR Mechanism Enable
+
+#define B_PCIE_LCTL2_TLS                          (BIT3 | BIT2 | BIT1 | BIT0) ///< Target Link Speed
+
+//
+// Latency Tolerance Reporting Extended Capability Registers (CAPID:0018h)
+//
+#define R_PCIE_LTRECH_CID                         0x0018
+
+#define R_PCIE_LTRECH_MSLR_OFFSET                 0x04
+#define N_PCIE_LTRECH_MSLR_VALUE                  0
+#define N_PCIE_LTRECH_MSLR_SCALE                  10
+
+#define R_PCIE_LTRECH_MNSLR_OFFSET                0x06
+#define N_PCIE_LTRECH_MNSLR_VALUE                 0
+#define N_PCIE_LTRECH_MNSLR_SCALE                 10
+
+//
+// Secondary PCI Express Extended Capability Header (CAPID:0019h)
+//
+#define R_PCIE_EX_LCTL3_OFFSET                    0x04 ///< Link Control 3 Register
+#define B_PCIE_EX_LCTL3_PE                        BIT0 ///< Perform Equalization
+
+//
+// L1 Sub-States Extended Capability Register (CAPID:001Eh)
+//
+#define V_PCIE_EX_L1S_CID                        0x001E ///< Capability ID
+#define R_PCIE_EX_L1SCAP_OFFSET                  0x04 ///< L1 Sub-States Capabilities
+#define B_PCIE_EX_L1SCAP_PTV                     0x00F80000 //< Port Tpower_on value
+#define N_PCIE_EX_L1SCAP_PTV                     19
+#define B_PCIE_EX_L1SCAP_PTPOS                   0x00030000 //< Port Tpower_on scale
+#define N_PCIE_EX_L1SCAP_PTPOS                   16
+#define B_PCIE_EX_L1SCAP_CMRT                    0x0000FF00 //< Common Mode Restore time
+#define N_PCIE_EX_L1SCAP_CMRT                    8
+#define B_PCIE_EX_L1SCAP_L1PSS                   BIT4 ///< L1 PM substates supported
+#define B_PCIE_EX_L1SCAP_AL1SS                   BIT3 ///< ASPM L1.1 supported
+#define B_PCIE_EX_L1SCAP_AL12S                   BIT2 ///< ASPM L1.2 supported
+#define B_PCIE_EX_L1SCAP_PPL11S                  BIT1 ///< PCI-PM L1.1 supported
+#define B_PCIE_EX_L1SCAP_PPL12S                  BIT0 ///< PCI-PM L1.2 supported
+#define R_PCIE_EX_L1SCTL1_OFFSET                 0x08 ///< L1 Sub-States Control 1
+#define B_PCIE_EX_L1SCTL1_L1SSEIE                BIT4
+#define N_PCIE_EX_L1SCTL1_L12LTRTLSV             29
+#define N_PCIE_EX_L1SCTL1_L12LTRTLV              16
+#define R_PCIE_EX_L1SCTL2_OFFSET                 0x0C ///< L1 Sub-States Control 2
+#define N_PCIE_EX_L1SCTL2_POWT                   3
+
+//
+// PTM Extended Capability Register (CAPID:001Fh)
+//
+#define V_PCIE_EX_PTM_CID                         0x001F ///< Capability ID
+#define R_PCIE_EX_PTMCAP_OFFSET                   0x04 ///< PTM Capabilities
+#define R_PCIE_EX_PTMCTL_OFFSET                   0x08 ///< PTM Control Register
+
+//
+// Base Address Offset
+//
+#define B_PCI_BAR_MEMORY_TYPE_MASK                (BIT1 | BIT2)
+#define B_PCI_BAR_MEMORY_TYPE_64                  BIT2
+
+//
+// PCI Express Extended Capability Header
+//
+#define R_PCIE_CFG_EXCAP_OFFSET                   0x100
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h
new file mode 100644
index 0000000000..ef94790985
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h
@@ -0,0 +1,110 @@
+/** @file
+  GPIO pins for TGL-PCH-LP,
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_PINS_VER2_LP_H_
+#define _GPIO_PINS_VER2_LP_H_
+///
+/// This header file should be used together with
+/// PCH GPIO lib in C and ASL. All defines used
+/// must match both ASL/C syntax
+///
+
+///
+/// Unique ID used in GpioPad defines
+///
+#define GPIO_VER2_LP_CHIPSET_ID     0x9
+
+///
+/// TGL LP GPIO Groups
+/// Use below for functions from PCH GPIO Lib which
+/// require GpioGroup as argument
+///
+#define GPIO_VER2_LP_GROUP_GPP_B    0x0900
+#define GPIO_VER2_LP_GROUP_GPP_A    0x0902
+#define GPIO_VER2_LP_GROUP_GPP_R    0x0903
+#define GPIO_VER2_LP_GROUP_GPD      0x0905
+#define GPIO_VER2_LP_GROUP_GPP_S    0x0906
+#define GPIO_VER2_LP_GROUP_GPP_H    0x0907
+#define GPIO_VER2_LP_GROUP_GPP_D    0x0908
+#define GPIO_VER2_LP_GROUP_GPP_C    0x090B
+#define GPIO_VER2_LP_GROUP_GPP_F    0x090C
+#define GPIO_VER2_LP_GROUP_GPP_E    0x090E
+
+
+///
+/// TGL LP GPIO pins
+/// Use below for functions from PCH GPIO Lib which
+/// require GpioPad as argument. Encoding used here
+/// has all information required by library functions
+///
+#define GPIO_VER2_LP_GPP_B2                  0x09000002
+#define GPIO_VER2_LP_GPP_B4                  0x09000004
+#define GPIO_VER2_LP_GPP_B14                 0x0900000E
+#define GPIO_VER2_LP_GPP_B15                 0x0900000F
+#define GPIO_VER2_LP_GPP_B16                 0x09000010
+#define GPIO_VER2_LP_GPP_B18                 0x09000012
+#define GPIO_VER2_LP_GPP_B23                 0x09000017
+#define GPIO_VER2_LP_GSPI0_CLK_LOOPBK        0x09000018
+
+#define GPIO_VER2_LP_GPP_A10                 0x0902000A
+#define GPIO_VER2_LP_GPP_A11                 0x0902000B
+#define GPIO_VER2_LP_GPP_A13                 0x0902000D
+#define GPIO_VER2_LP_GPP_A14                 0x0902000E
+#define GPIO_VER2_LP_GPP_A23                 0x09020017
+#define GPIO_VER2_LP_ESPI_CLK_LOOPBK         0x09020018
+
+#define GPIO_VER2_LP_GPP_R5                  0x09030005
+#define GPIO_VER2_LP_GPP_R6                  0x09030006
+
+#define GPIO_VER2_LP_GPD7                    0x09050007
+
+#define GPIO_VER2_LP_INPUT3VSEL              0x0905000C
+
+#define GPIO_VER2_LP_GPP_H0                  0x09070000
+#define GPIO_VER2_LP_GPP_H1                  0x09070001
+#define GPIO_VER2_LP_GPP_H12                 0x0907000C
+#define GPIO_VER2_LP_GPP_H13                 0x0907000D
+#define GPIO_VER2_LP_GPP_H15                 0x0907000F
+#define GPIO_VER2_LP_GPP_H19                 0x09070013
+
+#define GPIO_VER2_LP_GPP_D16                 0x09080010
+#define GPIO_VER2_LP_GSPI2_CLK_LOOPBK        0x09080014
+
+#define GPIO_VER2_LP_GPP_C2                  0x090B0002
+#define GPIO_VER2_LP_GPP_C5                  0x090B0005
+#define GPIO_VER2_LP_GPP_C8                  0x090B0008
+#define GPIO_VER2_LP_GPP_C12                 0x090B000C
+#define GPIO_VER2_LP_GPP_C13                 0x090B000D
+#define GPIO_VER2_LP_GPP_C14                 0x090B000E
+#define GPIO_VER2_LP_GPP_C15                 0x090B000F
+#define GPIO_VER2_LP_GPP_C22                 0x090B0016
+#define GPIO_VER2_LP_GPP_C23                 0x090B0017
+
+#define GPIO_VER2_LP_GPP_F4                  0x090C0004
+#define GPIO_VER2_LP_GPP_F5                  0x090C0005
+#define GPIO_VER2_LP_GPP_F9                  0x090C0009
+#define GPIO_VER2_LP_GPP_F10                 0x090C000A
+#define GPIO_VER2_LP_GPP_F20                 0x090C0014
+#define GPIO_VER2_LP_GPP_F21                 0x090C0015
+#define GPIO_VER2_LP_GPPF_CLK_LOOPBK         0x090C0018
+
+#define GPIO_VER2_LP_GPP_E3                  0x090E0003
+#define GPIO_VER2_LP_GPP_E7                  0x090E0007
+#define GPIO_VER2_LP_GPP_E8                  0x090E0008
+#define GPIO_VER2_LP_GPP_E22                 0x090E0016
+#define GPIO_VER2_LP_GPP_E23                 0x090E0017
+#define GPIO_VER2_LP_GPPE_CLK_LOOPBK         0x090E0018
+
+//
+// GPIO Pin Muxing
+// Determines a selection of physical pad for a given signal.
+// Please refer to GPIO_NATIVE_PAD type.
+// If certain signal is not listed below it means that it can be enabled
+// only on a single pad and muxing setting is not needed.
+//
+#define GPIO_VER2_LP_MUXING_SERIALIO_I2C4_SDA_GPP_H8         0x1947CC08
+#define GPIO_VER2_LP_MUXING_SERIALIO_I2C4_SCL_GPP_H9         0x1947AC09
+#endif // _GPIO_PINS_VER2_LP_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h
new file mode 100644
index 0000000000..215fd0407e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h
@@ -0,0 +1,72 @@
+/** @file
+  Register names for Flash registers
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _FLASH_REGS_H_
+#define _FLASH_REGS_H_
+
+//
+// Flash Descriptor Base Address Region (FDBAR) from Flash Region 0
+//
+#define R_FLASH_FDBAR_FLASH_MAP0          0x04
+#define B_FLASH_FDBAR_NC                  0x00000300                    ///< Number Of Components
+#define N_FLASH_FDBAR_NC                  8                             ///< Number Of Components
+#define R_FLASH_FDBAR_FLASH_MAP1          0x08
+#define B_FLASH_FDBAR_FPSBA               0x00FF0000                    ///< PCH Strap Base Address, [23:16] represents [11:4]
+#define N_FLASH_FDBAR_FPSBA               16                            ///< PCH Strap base Address bit position
+#define N_FLASH_FDBAR_FPSBA_REPR          4                             ///< PCH Strap base Address bit represents position
+#define B_FLASH_FDBAR_PCHSL               0xFF000000                    ///< PCH Strap Length, [31:24] represents number of Dwords
+#define N_FLASH_FDBAR_PCHSL               24                            ///< PCH Strap Length bit position
+#define R_FLASH_FDBAR_FLASH_MAP2          0x0C
+#define B_FLASH_FDBAR_FCPUSBA             0x00000FFC                    ///< CPU Strap Base Address [11:2]
+#define N_FLASH_FDBAR_FCPUSBA             2                             ///< CPU Strap Base Address bit position
+#define B_FLASH_FDBAR_CPUSL               0x00FF0000                    ///< CPU Strap Length, [23:16] represents number of Dwords
+#define N_FLASH_FDBAR_CPUSL               16                            ///< CPU Strap Length bit position
+
+//
+// Flash Component Base Address (FCBA) from Flash Region 0
+//
+#define R_FLASH_FCBA_FLCOMP               0x00                          ///< Flash Components Register
+#define B_FLASH_FLCOMP_COMP1_MASK         0xF0                          ///< Flash Component 1 Size MASK
+#define N_FLASH_FLCOMP_COMP1              4                             ///< Flash Component 1 Size bit position
+#define B_FLASH_FLCOMP_COMP0_MASK         0x0F                          ///< Flash Component 0 Size MASK
+#define V_FLASH_FLCOMP_COMP_512KB         0x80000
+//
+// Descriptor Upper Map Section from Flash Region 0
+//
+#define R_FLASH_UMAP1                     0xEFC                         ///< Flash Upper Map 1
+#define B_FLASH_UMAP1_MDTBA               0xFF000000                    ///< MIP Descriptor Table Base Address
+#define N_FLASH_UMAP1_MDTBA               24                            ///< MDTBA bits position
+#define N_FLASH_UMAP1_MDTBA_REPR          4                             ///< MDTBA address representation position
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h
new file mode 100644
index 0000000000..e4bf2018b7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h
@@ -0,0 +1,121 @@
+/** @file
+  Register names for PCH GPIO
+
+Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_REGS_H_
+#define _GPIO_REGS_H_
+
+//
+// PADCFG register is split into multiple DW registers
+// S_GPIO_PCR_PADCFG refers to number of bytes used by all those registers for one pad
+//
+#define S_GPIO_PCR_PADCFG               0x10
+
+//
+// Pad Configuration Register DW0
+//
+
+//Pad Reset Config
+#define B_GPIO_PCR_RST_CONF             (BIT31 | BIT30)
+#define N_GPIO_PCR_RST_CONF             30
+#define V_GPIO_PCR_RST_CONF_POW_GOOD    0x00
+#define V_GPIO_PCR_RST_CONF_DEEP_RST    0x01
+#define V_GPIO_PCR_RST_CONF_GPIO_RST    0x02
+#define V_GPIO_PCR_RST_CONF_RESUME_RST  0x03  // Only for GPD Group
+
+//RX Raw Override to 1
+#define B_GPIO_PCR_RX_RAW1              BIT28
+#define N_GPIO_PCR_RX_RAW1              28
+
+//RX Level/Edge Configuration
+#define B_GPIO_PCR_RX_LVL_EDG           (BIT26 | BIT25)
+#define N_GPIO_PCR_RX_LVL_EDG           25
+
+//RX Invert
+#define B_GPIO_PCR_RXINV                BIT23
+#define N_GPIO_PCR_RXINV                23
+
+//GPIO Input Route IOxAPIC
+#define B_GPIO_PCR_RX_APIC_ROUTE        BIT20
+
+//GPIO Input Route SCI
+#define B_GPIO_PCR_RX_SCI_ROUTE         BIT19
+
+//GPIO Input Route SMI
+#define B_GPIO_PCR_RX_SMI_ROUTE         BIT18
+
+//GPIO Input Route NMI
+#define B_GPIO_PCR_RX_NMI_ROUTE         BIT17
+#define N_GPIO_PCR_RX_NMI_ROUTE         17
+
+//GPIO Pad Mode
+#define B_GPIO_PCR_PAD_MODE             (BIT12 | BIT11 | BIT10)
+#define N_GPIO_PCR_PAD_MODE             10
+
+//GPIO RX Disable
+#define B_GPIO_PCR_RXDIS                BIT9
+
+//GPIO TX Disable
+#define B_GPIO_PCR_TXDIS                BIT8
+#define N_GPIO_PCR_TXDIS                8
+
+//GPIO RX State
+#define B_GPIO_PCR_RX_STATE             BIT1
+#define N_GPIO_PCR_RX_STATE             1
+
+//GPIO TX State
+#define B_GPIO_PCR_TX_STATE             BIT0
+#define N_GPIO_PCR_TX_STATE             0
+
+//Termination
+#define B_GPIO_PCR_TERM                (BIT13 | BIT12 | BIT11 | BIT10)
+#define N_GPIO_PCR_TERM                 10
+
+//Interrupt number
+#define B_GPIO_PCR_INTSEL               0x7F
+#define N_GPIO_PCR_INTSEL               0
+
+///
+/// GPIO SMI data used for EFI_SMM_GPI_DISPATCH2_PROTOCOL
+/// Below defines are to be used internally by PCH SMI dispatcher only
+///
+#define PCH_GPIO_NUM_SUPPORTED_GPIS       512
+#define S_GPIO_PCR_GP_SMI_STS               4
+
+///
+/// Groups mapped to 2-tier General Purpose Event will all be under
+/// one master GPE_111 (0x6F)
+///
+#define PCH_GPIO_2_TIER_MASTER_GPE_NUMBER  0x6F
+
+#endif // _GPIO_REGS_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h
new file mode 100644
index 0000000000..1dc05869dd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h
@@ -0,0 +1,226 @@
+/** @file
+  Register names for VER2 GPIO
+
+Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_REGS_VER2_H_
+#define _GPIO_REGS_VER2_H_
+
+//
+// PCH-LP GPIO
+//
+#define GPIO_VER2_PCH_LP_GPIO_GPP_B_PAD_MAX    26
+#define GPIO_VER2_PCH_LP_GPIO_GPP_A_PAD_MAX    25
+#define GPIO_VER2_PCH_LP_GPIO_GPP_R_PAD_MAX    8
+#define GPIO_VER2_PCH_LP_GPIO_GPD_PAD_MAX      17
+#define GPIO_VER2_PCH_LP_GPIO_GPP_S_PAD_MAX    8
+#define GPIO_VER2_PCH_LP_GPIO_GPP_H_PAD_MAX    24
+#define GPIO_VER2_PCH_LP_GPIO_GPP_D_PAD_MAX    21
+#define GPIO_VER2_PCH_LP_GPIO_GPP_F_PAD_MAX    25
+#define GPIO_VER2_PCH_LP_GPIO_GPP_C_PAD_MAX    24
+#define GPIO_VER2_PCH_LP_GPIO_GPP_E_PAD_MAX    25
+#define GPIO_VER2_PCH_LP_GPIO_CPU_PAD_MAX      15
+
+//
+// PCH-LP GPIO registers
+//
+
+//
+// GPIO Community 0 Private Configuration Registers
+//
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PAD_OWN        0x20
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PAD_OWN        0x38
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCK     0x80
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCKTX   0x84
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCK     0x90
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCKTX   0x94
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_HOSTSW_OWN     0xB0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_HOSTSW_OWN     0xB8
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IS         0x0100
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IS         0x0108
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IE         0x0120
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IE         0x0128
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_STS    0x0140
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_STS    0x0148
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_EN     0x0160
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_EN     0x0168
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_STS        0x0180
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_EN         0x01A0
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_STS        0x01C0
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_EN         0x01E0
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFG_OFFSET  0x700
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFG_OFFSET  0x9A0
+
+//
+// GPIO Community 1 Private Configuration Registers
+//
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PAD_OWN        0x20
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PAD_OWN        0x24
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PAD_OWN        0x30
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCK     0x80
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCKTX   0x84
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCK     0x88
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCKTX   0x8C
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCK     0x90
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCKTX   0x94
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_HOSTSW_OWN     0xB0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_HOSTSW_OWN     0xB4
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_HOSTSW_OWN     0xB8
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IS         0x0100
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IS         0x0104
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IS         0x0108
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IE         0x0120
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IE         0x0124
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IE         0x0128
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_STS    0x0140
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_STS    0x0144
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_STS    0x0148
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_EN     0x0160
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_EN     0x0164
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_EN     0x0168
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_STS        0x0188
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_EN         0x01A8
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_STS        0x01C8
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_EN         0x01E8
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFG_OFFSET  0x700
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFG_OFFSET  0x780
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFG_OFFSET  0x900
+
+//
+// GPIO Community 2 Private Configuration Registers
+//
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PAD_OWN          0x20
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCK       0x80
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCKTX     0x84
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_HOSTSW_OWN       0xB0
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IS           0x0100
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IE           0x0120
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_STS      0x0140
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_EN       0x0160
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFG_OFFSET    0x700
+
+//
+// GPIO Community 4 Private Configuration Registers
+//
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PAD_OWN        0x20
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PAD_OWN        0x2C
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PAD_OWN        0x40
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCK     0x80
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCKTX   0x84
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCK     0x88
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCKTX   0x8C
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCK     0x98
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCKTX   0x9C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_HOSTSW_OWN     0xB0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_HOSTSW_OWN     0xB4
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_HOSTSW_OWN     0xBC
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IS         0x0100
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IS         0x0104
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IS         0x010C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IE         0x0120
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IE         0x0124
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IE         0x012C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_STS    0x0140
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_STS    0x0144
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_STS    0x014C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_EN     0x0160
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_EN     0x0164
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_EN     0x016C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_STS        0x0180
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_STS        0x018C
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_EN         0x01A0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_EN         0x01AC
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_STS        0x01C0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_STS        0x01CC
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_EN         0x01E0
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_EN         0x01EC
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFG_OFFSET  0x700
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFG_OFFSET  0x880
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFG_OFFSET  0xA70
+
+//
+// GPIO Community 5 Private Configuration Registers
+//
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PAD_OWN        0x20
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCK     0x80
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCKTX   0x84
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_HOSTSW_OWN     0xB0
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IS         0x0100
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IE         0x0120
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_STS    0x0140
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_EN     0x0160
+
+#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFG_OFFSET  0x700
+
+#endif // _GPIO_REGS_VER2_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h
new file mode 100644
index 0000000000..5447fabccf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h
@@ -0,0 +1,16 @@
+/** @file
+  Register names for PCH DMI SIP14
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_DMI14_REGS_H_
+#define _PCH_DMI14_REGS_H_
+
+//
+// DMI Control
+//
+#define R_PCH_DMI14_PCR_DMIC                       0x2234                              ///< DMI Control
+#define B_PCH_DMI14_PCR_DMIC_SRL                   BIT31                               ///< Secured register lock
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h
new file mode 100644
index 0000000000..e9e6f80327
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h
@@ -0,0 +1,36 @@
+/** @file
+  Register names for PCH DMI and OP-DMI
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_DMI_REGS_H_
+#define _PCH_DMI_REGS_H_
+
+//
+// PCH DMI Chipset Configuration Registers (PID:DMI)
+//
+
+//
+// PCH DMI Source Decode PCRs (Common)
+//
+#define R_PCH_DMI_PCR_LPCLGIR1                   0x2730                       ///< LPC Generic I/O Range 1
+#define R_PCH_DMI_PCR_LPCGMR                     0x2740                       ///< LPC Generic Memory Range
+#define R_PCH_DMI_PCR_SEGIR                      0x27BC                       ///< Second ESPI Generic I/O Range
+#define R_PCH_DMI_PCR_SEGMR                      0x27C0                       ///< Second ESPI Generic Memory Range
+#define R_PCH_DMI_PCR_LPCBDE                     0x2744                       ///< LPC BIOS Decode Enable
+#define R_PCH_DMI_PCR_UCPR                       0x2748                       ///< uCode Patch Region
+#define B_PCH_DMI_PCR_UCPR_UPRE                  BIT0                         ///< uCode Patch Region Enable
+#define R_PCH_DMI_PCR_GCS                        0x274C                       ///< Generic Control and Status
+#define B_PCH_DMI_PCR_BBS                        BIT10                        ///< Boot BIOS Strap
+#define B_PCH_DMI_PCR_RPR                        BIT11                        ///< Reserved Page Route
+#define B_PCH_DMI_PCR_BILD                       BIT0                         ///< BIOS Interface Lock-Down
+#define R_PCH_DMI_PCR_IOT1                       0x2750                       ///< I/O Trap Register 1
+#define R_PCH_DMI_PCR_LPCIOD                     0x2770                       ///< LPC I/O Decode Ranges
+#define R_PCH_DMI_PCR_LPCIOE                     0x2774                       ///< LPC I/O Enables
+#define R_PCH_DMI_PCR_TCOBASE                    0x2778                       ///< TCO Base Address
+#define B_PCH_DMI_PCR_TCOBASE_TCOBA              0xFFE0                       ///< TCO Base Address Mask
+#define R_PCH_DMI_PCR_GPMR1                      0x277C                       ///< General Purpose Memory Range 1
+#define R_PCH_DMI_PCR_GPMR1DID                   0x2780                       ///< General Purpose Memory Range 1 Destination ID
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h
new file mode 100644
index 0000000000..c3497b1013
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h
@@ -0,0 +1,93 @@
+/** @file
+  Register names for PCH PCI-E root port devices
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PCIE_H_
+#define _PCH_REGS_PCIE_H_
+
+#define R_PCH_PCIE_CFG_CLIST                          0x40
+#define R_PCH_PCIE_CFG_LCAP                           (R_PCH_PCIE_CFG_CLIST + R_PCIE_LCAP_OFFSET)
+#define N_PCH_PCIE_CFG_LCAP_PN                        24
+#define R_PCH_PCIE_CFG_LCTL                           (R_PCH_PCIE_CFG_CLIST + R_PCIE_LCTL_OFFSET)
+#define R_PCH_PCIE_CFG_LSTS                           (R_PCH_PCIE_CFG_CLIST + R_PCIE_LSTS_OFFSET)
+#define R_PCH_PCIE_CFG_SLCAP                          (R_PCH_PCIE_CFG_CLIST + R_PCIE_SLCAP_OFFSET)
+#define R_PCH_PCIE_CFG_SLSTS                          (R_PCH_PCIE_CFG_CLIST + R_PCIE_SLSTS_OFFSET)
+
+#define R_PCH_PCIE_CFG_MPC2                           0xD4
+#define B_PCH_PCIE_CFG_MPC2_EOIFD                     BIT1
+
+#define R_PCH_PCIE_CFG_MPC                            0xD8
+#define S_PCH_PCIE_CFG_MPC                            4
+#define B_PCH_PCIE_CFG_MPC_PMCE                       BIT31
+#define B_PCH_PCIE_CFG_MPC_HPME                       BIT1
+#define N_PCH_PCIE_CFG_MPC_HPME                       1
+
+#define R_PCH_PCIE_CFG_SMSCS                          0xDC
+#define S_PCH_PCIE_CFG_SMSCS                          4
+#define B_PCH_PCIE_CFG_SMSCS_PMCS                     BIT31
+#define N_PCH_PCIE_CFG_SMSCS_LERSMIS                  5
+#define N_PCH_PCIE_CFG_SMSCS_HPLAS                    4
+#define N_PCH_PCIE_CFG_SMSCS_HPPDM                    1
+
+//CES.RE, CES.BT, CES.BD
+
+#define R_PCH_PCIE_CFG_EX_SPEECH                      0xA30 ///< Secondary PCI Express Extended Capability Header
+#define R_PCH_PCIE_CFG_EX_LCTL3                       (R_PCH_PCIE_CFG_EX_SPEECH + R_PCIE_EX_LCTL3_OFFSET)
+
+#define R_PCH_PCIE_CFG_LTROVR                         0x400
+#define B_PCH_PCIE_CFG_LTROVR_LTRNSROVR               BIT31 ///< LTR Non-Snoop Requirement Bit Override
+#define B_PCH_PCIE_CFG_LTROVR_LTRSROVR                BIT15 ///< LTR Snoop Requirement Bit Override
+
+#define R_PCH_PCIE_CFG_LTROVR2                        0x404
+#define B_PCH_PCIE_CFG_LTROVR2_FORCE_OVERRIDE         BIT3 ///< LTR Force Override Enable
+#define B_PCH_PCIE_CFG_LTROVR2_LOCK                   BIT2 ///< LTR Override Lock
+#define B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN             BIT1 ///< LTR Non-Snoop Override Enable
+#define B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN              BIT0 ///< LTR Snoop Override Enable
+
+#define R_PCH_PCIE_CFG_PCIEPMECTL                     0x420
+#define B_PCH_PCIE_CFG_PCIEPMECTL_DLSULPPGE           BIT30
+#define B_PCH_PCIE_CFG_PCIEPMECTL_L1LE                BIT17
+#define B_PCH_PCIE_CFG_PCIEPMECTL_L1FSOE              BIT0
+
+#define R_PCH_PCIE_CFG_EQCFG1                         0x450
+#define S_PCH_PCIE_CFG_EQCFG1                         4
+#define N_PCH_PCIE_CFG_EQCFG1_LERSMIE                 21
+
+//
+// PCIE PCRs (PID:SPA SPB SPC SPD SPE SPF)
+//
+#define R_SPX_PCR_PCD                         0                       ///< Port configuration and disable
+#define B_SPX_PCR_PCD_RP1FN                   (BIT2 | BIT1 | BIT0)    ///< Port 1 Function Number
+#define S_SPX_PCR_PCD_RP_FIELD                4                       ///< 4 bits for each RP FN
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h
new file mode 100644
index 0000000000..fac1497773
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h
@@ -0,0 +1,258 @@
+/** @file
+  Register names for PCH PMC device
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PMC_H_
+#define _PCH_REGS_PMC_H_
+
+//
+// ACPI and legacy I/O register offsets from ACPIBASE
+//
+#define R_ACPI_IO_PM1_STS                        0x00
+#define S_ACPI_IO_PM1_STS                        2
+#define B_ACPI_IO_PM1_STS_WAK                    BIT15
+#define B_ACPI_IO_PM1_STS_PCIEXP_WAKE_STS        BIT14
+#define B_ACPI_IO_PM1_STS_PRBTNOR                BIT11
+#define B_ACPI_IO_PM1_STS_RTC                    BIT10
+#define B_ACPI_IO_PM1_STS_PWRBTN                 BIT8
+#define B_ACPI_IO_PM1_STS_GBL                    BIT5
+#define B_ACPI_IO_PM1_STS_TMROF                  BIT0
+#define N_ACPI_IO_PM1_STS_RTC                    10
+#define N_ACPI_IO_PM1_STS_PWRBTN                 8
+#define N_ACPI_IO_PM1_STS_TMROF                  0
+
+#define R_ACPI_IO_PM1_EN                         0x02
+#define S_ACPI_IO_PM1_EN                         2
+#define B_ACPI_IO_PM1_EN_PWRBTN                  BIT8
+#define N_ACPI_IO_PM1_EN_RTC                     10
+#define N_ACPI_IO_PM1_EN_PWRBTN                  8
+#define N_ACPI_IO_PM1_EN_TMROF                   0
+
+#define R_ACPI_IO_PM1_CNT                        0x04
+#define B_ACPI_IO_PM1_CNT_SLP_EN                 BIT13
+#define B_ACPI_IO_PM1_CNT_SLP_TYP                (BIT12 | BIT11 | BIT10)
+#define V_ACPI_IO_PM1_CNT_S0                     0
+#define V_ACPI_IO_PM1_CNT_S1                     BIT10
+#define V_ACPI_IO_PM1_CNT_S3                     (BIT12 | BIT10)
+#define V_ACPI_IO_PM1_CNT_S4                     (BIT12 | BIT11)
+#define V_ACPI_IO_PM1_CNT_S5                     (BIT12 | BIT11 | BIT10)
+#define B_ACPI_IO_PM1_CNT_SCI_EN                 BIT0
+
+#define R_ACPI_IO_PM1_TMR                        0x08
+#define B_ACPI_IO_PM1_TMR_VAL                    0xFFFFFF
+#define V_ACPI_IO_PM1_TMR_MAX_VAL                0x1000000       ///< The timer is 24 bit overflow
+
+#define R_ACPI_IO_SMI_EN                              0x30
+#define S_ACPI_IO_SMI_EN                              4
+#define B_ACPI_IO_SMI_EN_LEGACY_USB2                  BIT17
+#define B_ACPI_IO_SMI_EN_TCO                          BIT13
+#define B_ACPI_IO_SMI_EN_BIOS_RLS                     BIT7
+#define B_ACPI_IO_SMI_EN_SWSMI_TMR                    BIT6
+#define B_ACPI_IO_SMI_EN_APMC                         BIT5
+#define B_ACPI_IO_SMI_EN_LEGACY_USB                   BIT3
+#define B_ACPI_IO_SMI_EN_BIOS                         BIT2
+#define B_ACPI_IO_SMI_EN_EOS                          BIT1
+#define B_ACPI_IO_SMI_EN_GBL_SMI                      BIT0
+#define N_ACPI_IO_SMI_EN_LEGACY_USB3                  31
+#define N_ACPI_IO_SMI_EN_ESPI                         28
+#define N_ACPI_IO_SMI_EN_PERIODIC                     14
+#define N_ACPI_IO_SMI_EN_TCO                          13
+#define N_ACPI_IO_SMI_EN_MCSMI                        11
+#define N_ACPI_IO_SMI_EN_SWSMI_TMR                    6
+#define N_ACPI_IO_SMI_EN_APMC                         5
+#define N_ACPI_IO_SMI_EN_ON_SLP_EN                    4
+#define N_ACPI_IO_SMI_EN_LEGACY_USB                   3
+
+#define R_ACPI_IO_SMI_STS                             0x34
+#define S_ACPI_IO_SMI_STS                             4
+#define B_ACPI_IO_SMI_STS_GPIO_UNLOCK                 BIT27
+#define B_ACPI_IO_SMI_STS_SMBUS                       BIT16
+#define B_ACPI_IO_SMI_STS_PERIODIC                    BIT14
+#define B_ACPI_IO_SMI_STS_TCO                         BIT13
+#define B_ACPI_IO_SMI_STS_MCSMI                       BIT11
+#define B_ACPI_IO_SMI_STS_SWSMI_TMR                   BIT6
+#define B_ACPI_IO_SMI_STS_APM                         BIT5
+#define B_ACPI_IO_SMI_STS_ON_SLP_EN                   BIT4
+#define B_ACPI_IO_SMI_STS_BIOS                        BIT2
+#define N_ACPI_IO_SMI_STS_LEGACY_USB3                 31
+#define N_ACPI_IO_SMI_STS_ESPI                        28
+#define N_ACPI_IO_SMI_STS_SPI                         26
+#define N_ACPI_IO_SMI_STS_MONITOR                     21
+#define N_ACPI_IO_SMI_STS_PCI_EXP                     20
+#define N_ACPI_IO_SMI_STS_SMBUS                       16
+#define N_ACPI_IO_SMI_STS_SERIRQ                      15
+#define N_ACPI_IO_SMI_STS_PERIODIC                    14
+#define N_ACPI_IO_SMI_STS_TCO                         13
+#define N_ACPI_IO_SMI_STS_MCSMI                       11
+#define N_ACPI_IO_SMI_STS_GPIO_SMI                    10
+#define N_ACPI_IO_SMI_STS_GPE0                        9
+#define N_ACPI_IO_SMI_STS_PM1_STS_REG                 8
+#define N_ACPI_IO_SMI_STS_SWSMI_TMR                   6
+#define N_ACPI_IO_SMI_STS_APM                         5
+#define N_ACPI_IO_SMI_STS_ON_SLP_EN                   4
+#define N_ACPI_IO_SMI_STS_LEGACY_USB                  3
+
+#define R_ACPI_IO_DEVACT_STS                          0x44
+#define B_ACPI_IO_DEVACT_STS_KBC                      BIT12
+#define B_ACPI_IO_DEVACT_STS_PIRQDH                   BIT9
+#define B_ACPI_IO_DEVACT_STS_PIRQCG                   BIT8
+#define B_ACPI_IO_DEVACT_STS_PIRQBF                   BIT7
+#define B_ACPI_IO_DEVACT_STS_PIRQAE                   BIT6
+
+#define R_ACPI_IO_GPE0_STS_127_96                  0x6C
+#define S_ACPI_IO_GPE0_STS_127_96                  4
+#define B_ACPI_IO_GPE0_STS_127_96_WADT             BIT18
+#define B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS  BIT17
+#define B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE         BIT16
+#define B_ACPI_IO_GPE0_STS_127_96_PME_B0           BIT13
+#define B_ACPI_IO_GPE0_STS_127_96_PME              BIT11
+#define B_ACPI_IO_GPE0_STS_127_96_BATLOW           BIT10
+#define B_ACPI_IO_GPE0_STS_127_96_RI               BIT8
+#define B_ACPI_IO_GPE0_STS_127_96_SMB_WAK          BIT7
+#define B_ACPI_IO_GPE0_STS_127_96_SWGPE            BIT2
+#define N_ACPI_IO_GPE0_STS_127_96_PME_B0           13
+#define N_ACPI_IO_GPE0_STS_127_96_PME              11
+
+#define R_ACPI_IO_GPE0_EN_127_96                   0x7C
+#define S_ACPI_IO_GPE0_EN_127_96                   4
+#define B_ACPI_IO_GPE0_EN_127_96_WADT              BIT18
+#define B_ACPI_IO_GPE0_EN_127_96_LAN_WAKE          BIT16
+#define B_ACPI_IO_GPE0_EN_127_96_PME_B0            BIT13
+#define B_ACPI_IO_GPE0_EN_127_96_ME_SCI            BIT12
+#define B_ACPI_IO_GPE0_EN_127_96_PME               BIT11
+#define B_ACPI_IO_GPE0_EN_127_96_BATLOW            BIT10
+#define B_ACPI_IO_GPE0_EN_127_96_RI                BIT8
+#define B_ACPI_IO_GPE0_EN_127_96_SWGPE             BIT2
+#define N_ACPI_IO_GPE0_EN_127_96_PME_B0            13
+#define N_ACPI_IO_GPE0_EN_127_96_PME               11
+
+//
+// TCO register I/O map
+//
+#define R_TCO_IO_TCO1_STS                            0x04
+#define S_TCO_IO_TCO1_STS                            2
+#define B_TCO_IO_TCO1_STS_DMISERR                    BIT12
+#define B_TCO_IO_TCO1_STS_DMISMI                     BIT10
+#define B_TCO_IO_TCO1_STS_DMISCI                     BIT9
+#define B_TCO_IO_TCO1_STS_BIOSWR                     BIT8
+#define B_TCO_IO_TCO1_STS_NEWCENTURY                 BIT7
+#define B_TCO_IO_TCO1_STS_TIMEOUT                    BIT3
+#define B_TCO_IO_TCO1_STS_TCO_INT                    BIT2
+#define B_TCO_IO_TCO1_STS_SW_TCO_SMI                 BIT1
+#define N_TCO_IO_TCO1_STS_DMISMI                     10
+#define N_TCO_IO_TCO1_STS_BIOSWR                     8
+#define N_TCO_IO_TCO1_STS_NEWCENTURY                 7
+#define N_TCO_IO_TCO1_STS_TIMEOUT                    3
+#define N_TCO_IO_TCO1_STS_SW_TCO_SMI                 1
+#define N_TCO_IO_TCO1_STS_NMI2SMI                    0
+
+#define R_TCO_IO_TCO2_STS                            0x06
+#define S_TCO_IO_TCO2_STS                            2
+#define B_TCO_IO_TCO2_STS_SECOND_TO                  BIT1
+#define B_TCO_IO_TCO2_STS_INTRD_DET                  BIT0
+#define N_TCO_IO_TCO2_STS_INTRD_DET                  0
+
+#define R_TCO_IO_TCO1_CNT                            0x08
+#define S_TCO_IO_TCO1_CNT                            2
+#define B_TCO_IO_TCO1_CNT_LOCK                       BIT12
+#define N_TCO_IO_TCO1_CNT_NMI2SMI_EN                 9
+
+#define R_TCO_IO_TCO2_CNT                            0x0A
+#define S_TCO_IO_TCO2_CNT                            2
+#define N_TCO_IO_TCO2_CNT_INTRD_SEL                  2
+
+//
+// PWRM Registers
+//
+#define R_PMC_PWRM_GEN_PMCON_A                              0x1020                        ///< in CNL located in PWRM
+#define B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS                  BIT24
+#define B_PMC_PWRM_GEN_PMCON_A_DISB                         BIT23
+#define B_PMC_PWRM_GEN_PMCON_A_ALLOW_L1LOW_C0               BIT19
+#define B_PMC_PWRM_GEN_PMCON_A_MS4V                         BIT18
+#define B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR                  BIT16
+#define B_PMC_PWRM_GEN_PMCON_A_PWR_FLR                      BIT14
+#define B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS                 BIT9
+#define B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK                BIT8
+#define B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN                   BIT0
+#define B_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL                   0xC0
+#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_64MS              0xC0
+#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_32MS              0x80
+#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_16MS              0x40
+#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_1_5MS             0x00
+#define B_PMC_PWRM_GEN_PMCON_A_PER_SMI_SEL                  0x6
+#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_64S                  0x0000
+#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_32S                  0x0002
+#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_16S                  0x0004
+#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_8S                   0x0006
+
+#define R_PMC_PWRM_GEN_PMCON_B                              0x1024
+#define B_PMC_PWRM_GEN_PMCON_B_SLPSX_STR_POL_LOCK           BIT18            ///< Lock down SLP_S3/SLP_S4 Minimum Assertion width
+#define B_PMC_PWRM_GEN_PMCON_B_PWRBTN_LVL                   BIT9
+#define B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK                     BIT4
+#define B_PMC_PWRM_GEN_PMCON_B_RTC_PWR_STS                  BIT2
+
+#define R_PMC_PWRM_CRID                                     0x1030           ///< Configured Revision ID
+#define V_PMC_PWRM_CRID_RID_SEL_CRID0                       1
+#define B_PMC_PWRM_CRID_CRID_LK                             BIT31            ///< CRID Lock
+
+#define R_PMC_PWRM_ETR3                                     0x1048          ///< in CNL this is PWRM register
+#define B_PMC_PWRM_ETR3_CF9LOCK                             BIT31           ///< CF9h Lockdown
+#define B_PMC_PWRM_ETR3_CF9GR                               BIT20           ///< CF9h Global Reset
+#define B_PMC_PWRM_ETR3_CWORWRE                             BIT18
+
+#define R_PMC_PWRM_CFG                                      0x1818                      ///< Power Management Configuration
+#define B_PMC_PWRM_CFG_DBG_MODE_LOCK                        BIT27                       ///< Debug Mode Lock
+#define B_PMC_PWRM_CFG_PMCREAD_DISABLE                      BIT22                       ///< Disable Reads to PMC
+#define B_PMC_PWRM_CFG_TIMING_TPCH25                        (BIT1 | BIT0)               ///< tPCH25 timing
+
+#define R_PMC_PWRM_DSX_CFG                                  0x1834                      ///< Deep SX Configuration
+#define B_PMC_PWRM_DSX_CFG_LAN_WAKE_EN                      BIT0                        ///< LAN_WAKE Pin DeepSx Enable
+
+#define R_PMC_PWRM_GPIO_CFG                                 0x1920
+#define B_PMC_PWRM_GPIO_CFG_GPE0_DW2                        (BIT11 | BIT10 | BIT9 | BIT8)
+#define N_PMC_PWRM_GPIO_CFG_GPE0_DW2                        8
+#define B_PMC_PWRM_GPIO_CFG_GPE0_DW1                        (BIT7 | BIT6 | BIT5 | BIT4)
+#define N_PMC_PWRM_GPIO_CFG_GPE0_DW1                        4
+#define B_PMC_PWRM_GPIO_CFG_GPE0_DW0                        (BIT3 | BIT2 | BIT1 | BIT0)
+#define N_PMC_PWRM_GPIO_CFG_GPE0_DW0                        0
+
+#define R_PMC_PWRM_HPR_CAUSE0                               0x192C   ///< Host partition reset causes
+#define B_PMC_PWRM_HPR_CAUSE0_GBL_TO_HOST                   BIT15    ///< Global reset converted to Host reset
+
+#define R_PMC_PWRM_ST_PG_FDIS_PMC_1                         0x1E20 ///< Static PG Related Function Disable Register 1
+#define B_PMC_PWRM_ST_PG_FDIS_PMC_1_ST_FDIS_LK              BIT31 ///< Static Function Disable Lock (ST_FDIS_LK)
+
+#define R_PMC_PWRM_FUSE_DIS_RD_2                            0x1E44 ///< Fuse Disable Read 2 Register
+#define B_PMC_PWRM_FUSE_DIS_RD_2_GBE_FUSE_SS_DIS            BIT0  ///< GBE Fuse or Soft Strap Disable
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h
new file mode 100644
index 0000000000..5824663d22
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h
@@ -0,0 +1,45 @@
+/** @file
+  Register names for RTC device
+
+Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _REGS_RTC_H_
+#define _REGS_RTC_H_
+
+#define R_RTC_IO_INDEX                           0x70
+#define R_RTC_IO_TARGET                          0x71
+#define R_RTC_IO_INDEX_ALT                       0x74
+#define R_RTC_IO_TARGET_ALT                      0x75
+#define R_RTC_IO_EXT_INDEX_ALT                   0x76
+#define R_RTC_IO_REGD                            0x0D
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h
new file mode 100644
index 0000000000..2037bb003d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h
@@ -0,0 +1,56 @@
+/** @file
+  Register names for SATA controllers
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SATA_REGS_H_
+#define _SATA_REGS_H_
+
+//
+//  SATA Controller Common Registers
+//
+#define R_SATA_CFG_AHCI_BAR                 0x24
+#define R_SATA_CFG_MAP                      0x90
+#define N_SATA_CFG_MAP_SPD                  16
+#define R_SATA_CFG_PCS                      0x94
+#define B_SATA_CFG_PCS_P0P                  BIT16
+#define R_SATA_CFG_SATAGC                   0x9C
+#define B_SATA_CFG_SATAGC_ASSEL             (BIT2 | BIT1 | BIT0)
+#define V_SATA_CFG_SATAGC_ASSEL_2K          0x0
+#define V_SATA_CFG_SATAGC_ASSEL_16K         0x1
+#define V_SATA_CFG_SATAGC_ASSEL_32K         0x2
+#define V_SATA_CFG_SATAGC_ASSEL_64K         0x3
+#define V_SATA_CFG_SATAGC_ASSEL_128K        0x4
+#define V_SATA_CFG_SATAGC_ASSEL_256K        0x5
+#define V_SATA_CFG_SATAGC_ASSEL_512K        0x6
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h
new file mode 100644
index 0000000000..9864dd872d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h
@@ -0,0 +1,47 @@
+/** @file
+  Register names for Serial IO Controllers
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_REGS_H_
+#define _SERIAL_IO_REGS_H_
+
+//
+// Serial IO Controllers PCI Configuration Registers
+// registers accessed using PciD21FxRegBase + offset
+//
+#define R_SERIAL_IO_CFG_BAR0_LOW                            0x10
+#define R_SERIAL_IO_CFG_BAR0_HIGH                           0x14
+
+#define R_SERIAL_IO_CFG_PME_CTRL_STS                        0x84
+
+#endif //_SERIAL_IO_REGS_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h
new file mode 100644
index 0000000000..ea832873bf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h
@@ -0,0 +1,51 @@
+/** @file
+  Register names for USB Host and device controller
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _USB_REGS_H_
+#define _USB_REGS_H_
+
+//
+// XHCI PCI Config Space registers
+//
+#define R_XHCI_CFG_PWR_CNTL_STS             0x74
+#define B_XHCI_CFG_PWR_CNTL_STS_PWR_STS     (BIT1 | BIT0)
+#define V_XHCI_CFG_PWR_CNTL_STS_PWR_STS_D3  (BIT1 | BIT0)
+
+//
+// xDCI (OTG) MMIO registers
+//
+#define R_XDCI_MEM_GCTL                       0xC110  ///< Xdci Global Ctrl
+
+#endif // _USB_REGS_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h
new file mode 100644
index 0000000000..e2e1cf2ad2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h
@@ -0,0 +1,213 @@
+/** @file
+  Serial IO policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_DEVICES_H_
+#define _SERIAL_IO_DEVICES_H_
+
+#include <Protocol/SerialIo.h>
+#include <PchLimits.h>
+
+#pragma pack (push,1)
+
+/**
+  Available working modes for SerialIo SPI Host Controller
+
+       0: SerialIoSpiDisabled;
+          - Device is placed in D3
+          - Gpio configuration is skipped
+          - PSF:
+          !important! If given device is Function 0 and other higher functions on given device
+                      are enabled, PSF disabling is skipped. PSF default will remain and device PCI CFG Space will still be visible.
+                      This is needed to allow PCI enumerator access functions above 0 in a multifunction device.
+    <b>1: SerialIoSpiPci;</b>
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device will be enabled in PSF
+          - Only BAR0 will be enabled
+       2: SerialIoSpiHidden;
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device disabled in the PSF
+          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
+          - BAR0 assigned from the global PCH reserved memory range, reported as motherboard resource by SIRC
+       @note
+           If this controller is located at function 0 and it's mode is set to hidden it will not be visible in the PCI space.
+**/
+typedef enum {
+  SerialIoSpiDisabled,
+  SerialIoSpiPci,
+  SerialIoSpiHidden
+} SERIAL_IO_SPI_MODE;
+
+/**
+  Used to set Inactive/Idle polarity of Spi Chip Select
+**/
+typedef enum {
+  SerialIoSpiCsActiveLow  = 0,
+  SerialIoSpiCsActiveHigh = 1
+} SERIAL_IO_CS_POLARITY;
+
+/**
+  The SERIAL_IO_SPI_CONFIG provides the configurations to set the Serial IO SPI controller
+**/
+typedef struct {
+  UINT8 Mode;                                          ///< <b>SerialIoSpiPci </b> see SERIAL_IO_SPI_MODE
+  UINT8 DefaultCsOutput;                               ///< <b>0 = CS0</b> CS1, CS2, CS3. Default CS used by the SPI HC
+  UINT8 CsPolarity[PCH_MAX_SERIALIO_SPI_CHIP_SELECTS]; ///< Selects SPI ChipSelect signal polarity, 0 = low <b>1 = High</b>
+  UINT8 CsEnable[PCH_MAX_SERIALIO_SPI_CHIP_SELECTS];   ///< <b>0 = Enable</b> 1 = Disable. Based on this setting GPIO for given SPIx CSx will be configured in Native mode
+  UINT8 CsMode;                                        ///< <b>0 = HW Control</b> 1 = SW Control. Sets Chip Select Control mode Hardware or Software.
+  UINT8 CsState;                                       ///< <b>0 = CS is set to low</b> 1 = CS is set to high
+} SERIAL_IO_SPI_CONFIG;
+
+/**
+  Available working modes for SerialIo UART Host Controller
+
+       0: SerialIoUartDisabled;
+          - Device is placed in D3
+          - Gpio configuration is skipped
+          - PSF:
+          !important! If given device is Function 0 and other higher functions on given device
+                      are enabled, PSF disabling is skipped. PSF default will remain and device PCI CFG Space will still be visible.
+                      This is needed to allow PCI enumerator access functions above 0 in a multifunction device.
+    <b>1: SerialIoUartPci;</b>
+          - Designated for Serial IO UART OS driver usage
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device will be enabled in PSF
+          - Only BAR0 will be enabled
+       2: SerialIoUartHidden;
+          - Designated for BIOS and/or DBG2 OS kernel debug
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device disabled in the PSF
+          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
+          - BAR0 assigned from the global PCH reserved memory range, reported as motherboard resource by SIRC
+       @note
+           If this controller is located at function 0 and it's mode is set to hidden it will not be visible in the PCI space.
+       3: SerialIoUartCom;
+          - Designated for 16550/PNP0501 compatible COM device
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device disabled in the PSF
+          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
+          - BAR0 assigned from the global PCH reserved memory range, reported as motherboard resource by SIRC
+       4: SerialIoUartSkipInit;
+          - Gpio configuration is skipped
+          - PSF configuration is skipped
+          - BAR assignemnt is skipped
+          - D-satate setting is skipped
+
+**/
+typedef enum {
+  SerialIoUartDisabled,
+  SerialIoUartPci,
+  SerialIoUartHidden,
+  SerialIoUartCom,
+  SerialIoUartSkipInit
+} SERIAL_IO_UART_MODE;
+
+/**
+  UART Settings
+**/
+typedef struct {
+  UINT32      BaudRate;    ///< <b> 115200 </b> Max 6000000  MdePkg.dec  PcdUartDefaultBaudRate
+  UINT8       Parity;      ///< <b> 1 - No Parity</b> see EFI_PARITY_TYPE MdePkg.dec PcdUartDefaultParity
+  UINT8       DataBits;    ///< <b>8</b> MdePkg.dec PcdUartDefaultDataBits
+  UINT8       StopBits;    ///< <b>1 - One Stop Bit</b> see EFI_STOP_BITS_TYPE  MdePkg.dec  PcdUartDefaultStopBits
+  UINT8       AutoFlow;    ///< <b>FALSE</b>  IntelFrameworkModulePkg.dsc PcdIsaBusSerialUseHalfHandshake
+} SERIAL_IO_UART_ATTRIBUTES;
+
+/**
+  UART signals pin muxing settings. If signal can be enable only on a single pin
+  then this parameter is ignored by RC. Refer to GPIO_*_MUXING_SERIALIO_UARTx_* in GpioPins*.h
+  for supported settings on a given platform
+**/
+typedef struct {
+  UINT32 Rx;  ///< RXD Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_UARTx_RXD_*
+  UINT32 Tx;  ///< TXD Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_UARTx_TXD_*
+  UINT32 Rts; ///< RTS Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_UARTx_RTS_*
+  UINT32 Cts; ///< CTS Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_UARTx_CTS_*
+} UART_PIN_MUX;
+
+/**
+  Serial IO UART Controller Configuration
+**/
+typedef struct {
+  SERIAL_IO_UART_ATTRIBUTES Attributes;  ///< see SERIAL_IO_UART_ATTRIBUTES
+  UART_PIN_MUX              PinMux;      ///< UART pin mux configuration
+  UINT8                     Mode;        ///< <b> SerialIoUartPci </b> see SERIAL_IO_UART_MODE
+  UINT8                     DBG2;        ///< <b> FALSE </b> If TRUE adds UART to DBG2 table and overrides UartPg to SerialIoUartPgDisabled
+  UINT8                     PowerGating; ///< <b> SerialIoUartPgAuto </b> Applies to Hidden/COM/SkipInit see SERIAL_IO_UART_PG
+  UINT8                     DmaEnable;   ///< <b> TRUE </b> Applies to SerialIoUartPci only. Informs OS driver to use DMA, if false it will run in PIO mode
+} SERIAL_IO_UART_CONFIG;
+
+typedef enum {
+  SerialIoUartPgDisabled,  ///< No _PS0/_PS3 support, device left in D0, after initialization
+/**
+  In mode: SerialIoUartCom;
+           _PS0/_PS3  that supports getting device out of reset
+  In mode: SerialIoUartPci
+           Keeps UART in D0 and assigns Fixed MMIO for SEC/PEI usage only
+**/
+  SerialIoUartPgEnabled,
+  SerialIoUartPgAuto       ///< _PS0 and _PS3, detection through ACPI if device was initialized prior to first PG. If it was used (DBG2) PG is disabled,
+} SERIAL_IO_UART_PG;
+
+/**
+  Available working modes for SerialIo I2C Host Controller
+
+       0: SerialIoI2cDisabled;
+          - Device is placed in D3
+          - Gpio configuration is skipped
+          - PSF:
+          !important! If given device is Function 0 and other higher functions on given device
+                      are enabled, PSF disabling is skipped. PSF default will remain and device PCI CFG Space will still be visible.
+                      This is needed to allow PCI enumerator access functions above 0 in a multifunction device.
+    <b>1: SerialIoI2cPci;</b>
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device will be enabled in PSF
+          - Only BAR0 will be enabled
+       2: SerialIoI2cHidden;
+          - Gpio pin configuration in native mode for each assigned pin
+          - Device disabled in the PSF
+          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
+          - BAR0 assigned from the global PCH reserved memory range, reported as motherboard resource by SIRC
+       @note
+           If this controller is located at function 0 and it's mode is set to hidden it will not be visible in the PCI space.
+**/
+typedef enum {
+  SerialIoI2cDisabled,
+  SerialIoI2cPci,
+  SerialIoI2cHidden
+} SERIAL_IO_I2C_MODE;
+
+/**
+  I2C signals pin muxing settings. If signal can be enable only on a single pin
+  then this parameter is ignored by RC. Refer to GPIO_*_MUXING_SERIALIO_I2Cx_* in GpioPins*.h
+  for supported settings on a given platform
+**/
+typedef struct {
+  UINT32   Sda;   ///< SDA Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_I2Cx_SDA_*
+  UINT32   Scl;   ///< SCL Pin mux configuration. Refer to GPIO_*_MUXING_SERIALIO_I2Cx_SCL_*
+} I2C_PIN_MUX;
+
+/**
+  Serial IO I2C Controller Configuration
+**/
+typedef struct {
+  UINT8        Mode;        /// <b>SerialIoI2cPci <b> see SERIAL_IO_I2C_MODE
+  /**
+    I2C Pads Internal Termination.
+    For more information please see Platform Design Guide.
+    Supported values (check GPIO_ELECTRICAL_CONFIG for reference):
+    <b>GpioTermNone: No termination</b>,
+    GpioTermWpu1K: 1kOhm weak pull-up,
+    GpioTermWpu5K: 5kOhm weak pull-up,
+    GpioTermWpu20K: 20kOhm weak pull-up
+  **/
+  UINT8        PadTermination;
+  UINT8        Reserved[2];
+  I2C_PIN_MUX  PinMux;      ///< I2C pin mux configuration
+} SERIAL_IO_I2C_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _SERIAL_IO_DEVICES_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h
new file mode 100644
index 0000000000..191bd815a1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h
@@ -0,0 +1,17 @@
+/** @file
+  Silicon Config HOB is used for gathering platform
+  related Intel silicon information and config setting.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_CONFIG_HOB_H_
+#define _SI_CONFIG_HOB_H_
+
+#include <SiPolicyStruct.h>
+
+extern EFI_GUID gSiConfigHobGuid;
+
+// Rename SI_CONFIG_HOB into SI_CONFIG_HOB_DATA for it does not follow HOB structure.
+typedef CONST SI_CONFIG SI_CONFIG_HOB_DATA;
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h
new file mode 100644
index 0000000000..7b646d8972
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h
@@ -0,0 +1,64 @@
+/** @file
+  Intel reference code configuration policies.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_POLICY_STRUCT_H_
+#define _SI_POLICY_STRUCT_H_
+
+#include <ConfigBlock.h>
+#include <ConfigBlock/SiPreMemConfig.h>
+#include <ConfigBlock/SiConfig.h>
+
+/**
+  Silicon Policy revision number
+  Any change to this structure will result in an update in the revision number
+
+  This member specifies the revision of the Silicon Policy. This field is used to indicate change
+  to the policy structure.
+
+  <b>Revision 1</b>:
+   - Initial version.
+**/
+#define SI_POLICY_REVISION  1
+
+/**
+  Silicon pre-memory Policy revision number
+  Any change to this structure will result in an update in the revision number
+
+  <b>Revision 1</b>:
+   - Initial version.
+**/
+#define SI_PREMEM_POLICY_REVISION  1
+
+
+/**
+  SI Policy PPI in Pre-Mem\n
+  All SI config block change history will be listed here\n\n
+
+  - <b>Revision 1</b>:
+    - Initial version.\n
+**/
+struct _SI_PREMEM_POLICY_STRUCT {
+  CONFIG_BLOCK_TABLE_HEADER      TableHeader;   ///< Config Block Table Header
+/*
+  Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+*/
+};
+
+/**
+  SI Policy PPI\n
+  All SI config block change history will be listed here\n\n
+
+  - <b>Revision 1</b>:
+    - Initial version.\n
+**/
+struct _SI_POLICY_STRUCT {
+  CONFIG_BLOCK_TABLE_HEADER      TableHeader;   ///< Config Block Table Header
+/*
+  Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+*/
+};
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
  2021-02-01  1:36 ` [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers Heng Luo
  2021-02-01  1:36 ` [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers Heng Luo
                   ` (36 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds header files common to CPU modules.

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h                |  83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPreMemConfig.h | 148 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConfig.h         |  52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtBasicConfig.h  | 226 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtCustomConfig.h |  76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtPsysConfig.h   |  36 ++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtTestConfig.h   | 150 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPreMemConfig.h  |  63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.h            |  51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h                            |  12 ++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h                        |  21 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h                      |  23 +++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h                   |  18 ++++++++++++++++++
 13 files changed, 959 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
new file mode 100644
index 0000000000..d837500a38
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
@@ -0,0 +1,83 @@
+/** @file
+  CPU Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_CONFIG_H_
+#define _CPU_CONFIG_H_
+
+#define CPU_CONFIG_REVISION 3
+
+extern EFI_GUID gCpuConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CPU Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Add SmbiosType4MaxSpeedOverride.
+  <b>Revision 3</b>:
+  - Add AvxDisable & Avx3Disable.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  UINT32                MicrocodePatchRegionSize;
+  EFI_PHYSICAL_ADDRESS  MicrocodePatchAddress;    ///< Pointer to microcode patch that is suitable for this processor.
+  /**
+    Enable or Disable Advanced Encryption Standard (AES) feature.
+    For some countries, this should be disabled for legal reasons.
+    -    0: Disable
+    - <b>1: Enable</b>
+  **/
+  UINT32 AesEnable           : 1;
+  /**
+    Enable or Disable Trusted Execution Technology (TXT) feature.
+    -    0: Disable
+    - <b>1: Enable</b>
+  **/
+  UINT32 TxtEnable           : 1;
+  UINT32 SkipMpInit          : 1;                 ///< For Fsp only, Silicon Initialization will skip MP Initialization (including BSP) if enabled. For non-FSP, this should always be 0.
+  /**
+    Enable or Disable or Auto for PPIN Support to view Protected Processor Inventory Number.
+    - <b>0: Disable</b>
+    -    1: Enable
+    -    2: Auto : Feature is based on End Of Manufacturing (EOM) flag. If EOM is set, it is disabled.
+  **/
+  UINT32 PpinSupport         : 2;
+  /**
+    Enable or Disable #AC machine check on split lock.
+    - <b>0: Disable</b>
+    -    1: Enable
+  **/
+  UINT32 AcSplitLock         : 1;
+  /**
+  Enable or Disable Avx.
+  -      1: Disable
+  -  <b> 0: Enable</b>
+  **/
+  UINT32 AvxDisable          : 1;
+  /**
+  Enable or Disable Avx3.
+  -      1: Disable
+  -  <b> 0: Enable</b>
+  **/
+  UINT32 Avx3Disable         : 1;
+  UINT32 RsvdBits            : 24;                ///< Reserved for future use
+  /**
+    Provide the option for platform to override the MaxSpeed field of Smbios Type 4.
+    Value 4000 means 4000MHz.
+    If this value is not zero, it dominates the field.
+    If this value is zero, CPU RC will update the field according to the max radio.
+    <b>default is 0.</b>
+  **/
+  UINT16 SmbiosType4MaxSpeedOverride;
+  UINT8  Reserved0[2];                            ///< Reserved for future use
+} CPU_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPreMemConfig.h
new file mode 100644
index 0000000000..bf3f436ddd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPreMemConfig.h
@@ -0,0 +1,148 @@
+/** @file
+  CPU Security PreMemory Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
+#define _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
+
+#define CPU_CONFIG_LIB_PREMEM_CONFIG_REVISION 6
+
+extern EFI_GUID gCpuConfigLibPreMemConfigGuid;
+
+#define BOOT_FREQUENCY_MAX_BATTERY_PERF   0
+#define BOOT_FREQUENCY_MAX_NON_TURBO_PERF 1
+#define BOOT_FREQUENCY_TURBO_PERF         2
+
+#pragma pack (push,1)
+
+/**
+  CPU Config Library PreMemory Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Expand the supported number of processor cores (ActiveCoreCount1).
+  <b>Revision  3</b>:
+  - Added PECI Sx and C10 Reset.
+  <b>Revision  4</b>:
+  - Added ActiveSmallCoreCount.
+  <b>Revision  5</b>:
+  - Added CrashLogGprs
+  <b>Revision  6</b>:
+  - Added ConfigTdpLevel
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER Header;            ///< Config Block Header
+  UINT32 HyperThreading             : 1; ///< Enable or Disable Hyper Threading; 0: Disable; <b>1: Enable</b>.
+  /**
+  Sets the boot frequency starting from reset vector.
+   - 0: Maximum battery performance.
+   - 1: Maximum non-turbo performance
+   -<b>2: Turbo performance</b>.
+  @note If Turbo is selected BIOS will start in max non-turbo mode and switch to Turbo mode.
+  **/
+  UINT32 BootFrequency              : 2;
+  /**
+    Number of processor cores to enable.
+    - <b> 0: All cores</b>
+    -     1: 1 core
+    -     2: 2 cores
+    -     3: 3 cores
+  **/
+  UINT32 ActiveCoreCount            : 3; ///< @deprecated due to core active number limitaion.
+  UINT32 JtagC10PowerGateDisable    : 1; ///< False: JTAG is power gated in C10 state. True: keeps the JTAG power up during C10 and deeper power states for debug purpose. <b>0: False<\b>; 1: True.
+  UINT32 BistOnReset                : 1; ///< <b>(Test)</b> Enable or Disable BIST on Reset; <b>0: Disable</b>; 1: Enable.
+  /**
+    Enable or Disable Virtual Machine Extensions (VMX) feature.
+    -    0: Disable
+    - <b>1: Enable</b>
+  **/
+  UINT32 VmxEnable                  : 1;
+  /**
+  Processor Early Power On Configuration FCLK setting.
+   - <b>0: 800 MHz (ULT/ULX)</b>.
+   - <b>1: 1 GHz (DT/Halo)</b>. Not supported on ULT/ULX.
+   - 2: 400 MHz.
+   - 3: Reserved.
+  **/
+  UINT32 FClkFrequency              : 2;
+  /**
+  Enable or Disable CrashLog feature
+    -    0: Disable
+    - <b>1: Enable</b>
+  **/
+  UINT32 CrashLogEnable              : 1;
+
+  /**
+  Enable or Disable Total Memory Encryption (TME) feature.
+    - <b>0: Disable</b>
+    -    1: Enable
+  **/
+  UINT32 TmeEnable                  : 1;
+
+  UINT32 DebugInterfaceEnable       : 2; ///< Enable or Disable processor debug features; 0: Disable; 1: Enable; <b>2: No Change</b>.
+  UINT32 DebugInterfaceLockEnable   : 1; ///< Lock or Unlock debug interface features; 0: Disable; <b>1: Enable</b>.
+
+  /**
+    Number of big cores in processor to enable. And support up to 16 cores.
+    - <b> 0: All cores</b>
+    -     1: 1 core
+    -     2: 2 cores
+    -     3: 3 cores
+  **/
+  UINT32 ActiveCoreCount1           : 4;
+
+  /**
+  Enables a mailbox command to resolve rare PECI related Sx issues.
+  @note This should only be used on systems that observe PECI Sx issues.
+  - <b>0: Disable</b>
+  -    1: Enable
+  **/
+  UINT32 PeciSxReset                : 1;
+
+  /**
+  Enables the mailbox command to resolve PECI reset issues during Pkg-C10 exit.
+  If Enabled, BIOS will send the CPU message to disable peci reset on C10 exit.
+  The default value is <b>1: Enable</b> for CML, and <b>0: Disable</b> for all other CPU's
+  - 0: Disable
+  - 1: Enable
+  **/
+  UINT32 PeciC10Reset               : 1;
+
+  /**
+    Number of small cores in processor to enable. And support the enabling of up to 63 cores.
+    - <b> 0: All cores</b>
+    -     1: 1 core
+    -     2: 2 cores
+    -     3: 3 cores
+  **/
+  UINT32 ActiveSmallCoreCount       : 6;
+
+  /**
+  Enable or Disable CrashLog GPRs dump
+    - <b>0: Disable</b>
+    -    1: Gprs Enabled, Smm Gprs Enabled
+         2: Gprs Enabled, Smm Gprs Disabled
+  **/
+  UINT32 CrashLogGprs               : 2;
+
+  UINT32 RsvdBits                   : 2;
+
+  /**
+    CpuRatio - Max non-turbo ratio (Flexible Ratio Boot) is set to CpuRatio. <b>0: Disabled</b> If disabled, doesn't override max-non turbo ratio.
+  **/
+  UINT8  CpuRatio;
+  /**
+    Configuration for boot TDP selection; <b>0: TDP Nominal</b>; 1: TDP Down; 2: TDP Up.
+  **/
+  UINT8  ConfigTdpLevel;
+  UINT8  Reserved[2];                    ///< Reserved for alignment
+  UINT32 ElixirSpringsPatchAddr;         ///< Address of Elixir Springs Patch(es)
+  UINT32 ElixirSpringsPatchSize;         ///< Elixir Springs Patch(es) Size.
+} CPU_CONFIG_LIB_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConfig.h
new file mode 100644
index 0000000000..4fcb92cb27
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConfig.h
@@ -0,0 +1,52 @@
+/** @file
+  CPU PID Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PID_TEST_CONFIG_H_
+#define _CPU_PID_TEST_CONFIG_H_
+
+#define CPU_PID_TEST_CONFIG_REVISION 1
+
+extern EFI_GUID gCpuPidTestConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  PID Tuning Configuration Structure.
+  Domain is mapped to Kp = 0, Ki = 1, Kd = 2.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  UINT16  Ratl[3];                                ///< RATL setting, in 1/256 units. Range is 0 - 65280
+  UINT16  VrTdcVr0[3];                            ///< VR Thermal Design Current for VR0. In 1/256 units. Range is 0 - 65280
+  UINT16  VrTdcVr1[3];                            ///< VR Thermal Design Current for VR1. In 1/256 units. Range is 0 - 65280
+  UINT16  VrTdcVr2[3];                            ///< VR Thermal Design Current for VR2. In 1/256 units. Range is 0 - 65280
+  UINT16  VrTdcVr3[3];                            ///< VR Thermal Design Current for VR3. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPsysPl1Msr[3];                       ///< Power Budget Management Psys PL1 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPsysPl1MmioPcs[3];                   ///< Power Budget Management Psys PL1 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPsysPl2Msr[3];                       ///< Power Budget Management Psys PL2 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPsysPl2MmioPcs[3];                   ///< Power Budget Management Psys PL2 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPkgPl1Msr[3];                        ///< Power Budget Management Package PL1 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPkgPl1MmioPcs[3];                    ///< Power Budget Management Package PL1 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPkgPl2Msr[3];                        ///< Power Budget Management Package PL2 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  PbmPkgPl2MmioPcs[3];                    ///< Power Budget Management Package PL2 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  UINT16  DdrPl1Msr[3];                           ///< DDR PL1 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  DdrPl1MmioPcs[3];                       ///< DDR PL1 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  UINT16  DdrPl2Msr[3];                           ///< DDR PL2 MSR. In 1/256 units. Range is 0 - 65280
+  UINT16  DdrPl2MmioPcs[3];                       ///< DDR PL2 MMIO/PCS. In 1/256 units. Range is 0 - 65280
+  /**
+  Enable or Disable PID Tuning programming flow.
+  If disabled, all other policies in this config block are ignored.
+  **/
+  UINT8   PidTuning;
+  UINT8   Rsvd;                                   ///< Reserved for DWORD alignment.
+} CPU_PID_TEST_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_PID_TEST_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtBasicConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtBasicConfig.h
new file mode 100644
index 0000000000..0255d49bdf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtBasicConfig.h
@@ -0,0 +1,226 @@
+/** @file
+  CPU Power Management Basic Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POWER_MGMT_BASIC_CONFIG_H_
+#define _CPU_POWER_MGMT_BASIC_CONFIG_H_
+
+#define CPU_POWER_MGMT_BASIC_CONFIG_REVISION 5
+
+extern EFI_GUID gCpuPowerMgmtBasicConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CPU Power Management Basic Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Changed EnableItbm default to be disable
+  - Deprecated EnableItbmDriver due to Platform doesn't have ITBMT OS driver
+  <b>Revision 3</b>:
+  - Add ApplyConfigTdp for TDP initialization settings based on non-cTDP or cTDP
+  <b>Revision 4</b>:
+  - Add Hwp Lock support
+  <b>Revision 5</b>:
+  - Add VccInDemotionOverride and VccInDemotionMs
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+  Sets the boot frequency starting from reset vector.
+   - 0: Maximum battery performance.
+   - 1: Maximum non-turbo performance.
+   - <b>2: Turbo performance.</b>
+  @note If Turbo is selected BIOS will start in max non-turbo mode and switch to Turbo mode.
+  **/
+  UINT32 BootFrequency                  : 2;       //@deprecated
+  UINT32 SkipSetBootPState              : 1;      ///< Choose whether to skip SetBootPState function for all APs; <b>0: Do not skip</b>; 1: Skip.
+  /**
+  Enable or Disable Intel Speed Shift Technology.
+  Enabling allows for processor control of P-state transitions.
+  0: Disable; <b>1: Enable;</b> Bit 1 is ignored.
+  @note Currently this feature is recommended to be enabled only on win10
+  **/
+  UINT32 Hwp                            : 2;
+  /**
+  Hardware Duty Cycle Control configuration. 0: Disabled; <b>1: Enabled</b> 2-3:Reserved
+  HDC enables the processor to autonomously force components to enter into an idle state to lower effective frequency.
+  This allows for increased package level C6 residency.
+  @note Currently this feature is recommended to be enabled only on win10
+  **/
+  UINT32 HdcControl                     : 2;
+  UINT32 PowerLimit2                    : 1;      ///< Enable or Disable short duration Power Limit (PL2). 0: Disable; <b>1: Enable</b>
+  UINT32 TurboPowerLimitLock            : 1;      ///< MSR 0x610[63] and 0x618[63]: Locks all Turbo power limit settings to read-only; <b>0: Disable</b>; 1: Enable (Lock).
+  UINT32 PowerLimit3DutyCycle           : 8;      ///< Package PL3 Duty Cycle. Specifies the PL3 duty cycle percentage, Range 0-100. <b>Default: 0</b>.
+  UINT32 PowerLimit3Lock                : 1;      ///< Package PL3 MSR 615h lock; <b>0: Disable</b>; 1: Enable (Lock).
+  UINT32 PowerLimit4Lock                : 1;      ///< Package PL4 MSR 601h lock; <b>0: Disable</b>; 1: Enable (Lock).
+  /**
+  Tcc Offset Clamp for Runtime Average Temperature Limit (RATL) allows CPU to throttle below P1.
+  For Y SKU, the recommended default for this policy is <b>1: Enabled</b>, which indicates throttling below P1 is allowed.
+  For all other SKUs the recommended default are  <b>0: Disabled</b>.
+  **/
+  UINT32 TccOffsetClamp                 : 1;
+  UINT32 TccOffsetLock                  : 1;      ///< Tcc Offset Lock for Runtime Average Temperature Limit (RATL) to lock temperature target MSR 1A2h; 0: Disabled; <b>1: Enabled (Lock)</b>.
+  UINT32 TurboMode                      : 1;      ///< Enable or Disable Turbo Mode. Disable; <b>1: Enable</b>
+  UINT32 HwpInterruptControl            : 1;      ///< Set HW P-State Interrupts Enabled  for MISC_PWR_MGMT MSR 0x1AA[7]; <b>0: Disable</b>; 1: Enable.
+  UINT32 ApplyConfigTdp                 : 1;      ///< Switch TDP applied setting based on non-cTDP or TDP; 0: non-cTDP; <b>1: cTDP</b>.
+  UINT32 HwpLock                        : 1;      ///< HWP Lock in MISC PWR MGMT MSR 1AAh; <b>0: Disable</b>; 1: Enable (Lock).
+  UINT32 VccInDemotionOverride          : 1;      ///< Enable VccIn Demotion Override configuration. <b>0: Disable</b>; 1: Enable.
+  UINT32 RsvdBits                       : 6;      ///< Reserved for future use.
+
+  /**
+   1-Core Ratio Limit: LFM to Fused 1-Core Ratio Limit. For overclocking parts: LFM to Fused 1-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 1-Core Ratio Limit Must be greater than or equal to 2-Core Ratio Limit, 3-Core Ratio Limit, 4-Core Ratio Limit.
+  **/
+  UINT8  OneCoreRatioLimit;
+  /**
+   2-Core Ratio Limit: LFM to Fused 2-Core Ratio Limit, For overclocking part: LFM to Fused 2-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 2-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  TwoCoreRatioLimit;
+  /**
+   3-Core Ratio Limit: LFM to Fused 3-Core Ratio Limit, For overclocking part: LFM to Fused 3-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 3-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  ThreeCoreRatioLimit;
+  /**
+   4-Core Ratio Limit: LFM to Fused 4-Core Ratio Limit, For overclocking part: LFM to Fused 4-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 4-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  FourCoreRatioLimit;
+  /**
+   5-Core Ratio Limit: LFM to Fused 5-Core Ratio Limit, For overclocking part: LFM to Fused 5-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 5-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  FiveCoreRatioLimit;
+  /**
+   6-Core Ratio Limit: LFM to Fused 6-Core Ratio Limit, For overclocking part: LFM to Fused 6-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 6-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  SixCoreRatioLimit;
+  /**
+   7-Core Ratio Limit: LFM to Fused 7-Core Ratio Limit, For overclocking part: LFM to Fused 7-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 7-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  SevenCoreRatioLimit;
+  /**
+   8-Core Ratio Limit: LFM to Fused 8-Core Ratio Limit, For overclocking part: LFM to Fused 8-Core Ratio Limit + OC Bins.
+   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
+     - This 8-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
+  **/
+  UINT8  EightCoreRatioLimit;
+  /**
+  TCC Activation Offset. Offset from factory set TCC activation temperature at which the Thermal Control Circuit must be activated.
+  TCC will be activated at (TCC Activation Temperature - TCC Activation Offset), in degrees Celcius.
+  For Y SKU, the recommended default for this policy is  <b>10</b>
+  For all other SKUs the recommended default are <b>0</b>, causing TCC to activate at TCC Activation temperature.
+  @note The policy is recommended for validation purpose only.
+  **/
+  UINT8  TccActivationOffset;
+  /**
+  Intel Turbo Boost Max Technology 3.0
+  Enabling it on processors with OS support will allow OS to exploit the diversity in max turbo frequency of the cores.
+  <b>0: Disable</b>; 1: Enable;
+  **/
+  UINT8  EnableItbm                     : 1;
+  /**
+  @deprecated: Platform doesn't have Intel Turbo Boost Max Technology 3.0 Driver
+  Enabling it will load the driver upon ACPI device with HID = INT3510.
+  <b> 0: Disable;</b> 1: Enable;
+  **/
+  UINT8  EnableItbmDriver               : 1;
+  /**
+  Per Core P State OS control mode
+  Disabling will set PCU_MISC_CONFIG (Command 0x06) Bit 31 = 1. When set, the highest core request is used for all other core requests.
+  0: Disable;<b> 1: Enable;</b>
+  **/
+  UINT8  EnablePerCorePState            : 1;
+  /**
+  HwP Autonomous Per Core P State
+  Disabling will set Bit 30 = 1, command 0x11. When set, autonomous will request the same value
+  for all cores all the time.
+  0: Disable;<b> 1: Enable;</b>
+  **/
+  UINT8  EnableHwpAutoPerCorePstate     : 1;
+  /**
+  HwP Autonomous EPP grouping.
+  Disabling will set Bit 29 = 1, command 0x11. When set, autonomous will not necesarrily request the same value
+  for all cores with same EPP.
+  Enabling will clean Bit 29 = 0, command 0x11. Autonomous will request same values for all cores with same EPP.
+  0: Disable;<b> 1: Enable;</b>
+  **/
+  UINT8  EnableHwpAutoEppGrouping       : 1;
+  /**
+  EPB override over PECI
+  Enable by sending pcode command 0x2b , subcommand 0x3 to 1.
+  This will allow OOB EPB PECI override control.
+  <b>0: Disable;</b> 1: Enable;
+  **/
+  UINT8  EnableEpbPeciOverride          : 1;
+  /**
+  Support for Fast MSR for IA32_HWP_REQUEST.
+  On systems with HwP enabled, if this feature is available as indicated by MSR 0x65F[0] = 1,
+  set MSR 0x657[0] = 1.
+  0: Disable; <b> 1: Enable;</b>
+  **/
+  UINT8  EnableFastMsrHwpReq            : 1;
+  UINT8  ReservedBits1                  : 1;      ///< Reserved for future use.
+  UINT8  MinRingRatioLimit;                       ///< Minimum Ring Ratio Limit. Range from 0 to Max Turbo Ratio. 0 = AUTO/HW Default
+  UINT8  MaxRingRatioLimit;                       ///< Maximum Ring Ratio Limit. Range from 0 to Max Turbo Ratio. 0 = AUTO/HW Default
+  /**
+  Package Long duration turbo mode power limit (PL1).
+  Default is the TDP power limit of processor. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  **/
+  UINT16 PowerLimit1;
+  /**
+  Package Short duration turbo mode power limit (PL2). Allows for short excursions above TDP power limit.
+  Default = 1.25 * TDP Power Limit. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  **/
+  UINT16 PowerLimit2Power;
+  /**
+  Package PL3 power limit. PL3 is the CPU Peak Power Occurences Limit.
+  <b>Default: 0</b>. Range 0-65535. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  **/
+  UINT16 PowerLimit3;
+  /**
+  Package PL4 power limit. PL4 is a Preemptive CPU Package Peak Power Limit, it will never be exceeded.
+  Power is premptively lowered before limit is reached. <b>Default: 0</b>. Range 0-65535.
+  Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  **/
+  UINT16 PowerLimit4;
+  /**
+  Package Long duration turbo mode power limit (PL1) time window in seconds.
+  Used in calculating the average power over time.
+  Mobile: <b> 28s</b>
+  Desktop: <b> 8s</b>
+  Range: 0 - 128s
+  **/
+  UINT32 PowerLimit1Time;
+  UINT32 PowerLimit3Time;                         ///< Package PL3 time window. Range from 3ms to 64ms.
+  /**
+  Tcc Offset Time Window can range from 5ms to 448000ms for Runtime Average Temperature Limit (RATL).
+  For Y SKU, the recommended default for this policy is <b>5000: 5 seconds</b>, For all other SKUs the recommended default are <b>0: Disabled</b>
+  **/
+  UINT32 TccOffsetTimeWindowForRatl;
+  /**
+  Customize the VccIn Demotion in ms accordingly. Values used by OEM expected to be in lower end of 1-30 ms range.
+  Value 1 means 1ms, value 2 means 2ms, and so on. Value 0 will disable VccIn Demotion knob.
+  <b> It's 30ms by silicon default</b>.
+  **/
+  UINT32 VccInDemotionMs;
+} CPU_POWER_MGMT_BASIC_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_POWER_MGMT_BASIC_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtCustomConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtCustomConfig.h
new file mode 100644
index 0000000000..e1a5bcc684
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtCustomConfig.h
@@ -0,0 +1,76 @@
+/** @file
+  CPU Power Managment Custom Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
+#define _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
+
+#define CPU_POWER_MGMT_CUSTOM_CONFIG_REVISION 1
+
+extern EFI_GUID gCpuPowerMgmtCustomConfigGuid;
+
+#pragma pack (push,1)
+
+///
+/// Defines the maximum number of custom ratio states supported.
+///
+#define MAX_CUSTOM_RATIO_TABLE_ENTRIES    40
+#define MAX_16_CUSTOM_RATIO_TABLE_ENTRIES 16
+
+///
+/// Defines the maximum number of custom ConfigTdp entries supported.
+/// @warning: Changing this define would cause DWORD alignment issues in policy structures.
+///
+#define MAX_CUSTOM_CTDP_ENTRIES 3
+
+///
+/// This structure is used to describe the custom processor ratio table desired by the platform.
+///
+typedef struct {
+  UINT8  MaxRatio;                                           ///< The maximum ratio of the custom ratio table.
+  UINT8  NumberOfEntries;                                    ///< The number of custom ratio state entries, ranges from 2 to 40 for a valid custom ratio table.
+  UINT8  Rsvd0[2];                                           ///< Reserved for DWORD alignment.
+  UINT32 Cpuid;                                              ///< The CPU ID for which this custom ratio table applies.
+  UINT8  StateRatio[MAX_CUSTOM_RATIO_TABLE_ENTRIES];         ///< The processor ratios in the custom ratio table.
+  ///
+  /// If there are more than 16 total entries in the StateRatio table, then use these 16 entries to fill max 16 table.
+  /// @note If NumberOfEntries is 16 or less, or the first entry of this table is 0, then this table is ignored,
+  /// and up to the top 16 values from the StateRatio table is used instead.
+  ///
+  UINT8  StateRatioMax16[MAX_16_CUSTOM_RATIO_TABLE_ENTRIES];
+#if ((MAX_CUSTOM_RATIO_TABLE_ENTRIES + MAX_16_CUSTOM_RATIO_TABLE_ENTRIES) % 4)
+  UINT8  Rsvd1[4 - ((MAX_CUSTOM_RATIO_TABLE_ENTRIES + MAX_16_CUSTOM_RATIO_TABLE_ENTRIES) % 4)];  ///< If needed, add padding for dword alignment.
+#endif
+} PPM_CUSTOM_RATIO_TABLE;
+
+///
+/// PPM Custom ConfigTdp Settings
+///
+typedef struct _PPM_CUSTOM_CTDP_TABLE {
+  UINT32 CustomPowerLimit1Time      :  8;            ///< Short term Power Limit time window value for custom cTDP level.
+  UINT32 CustomTurboActivationRatio :  8;            ///< Turbo Activation Ratio for custom cTDP level.
+  UINT32 RsvdBits                   : 16;            ///< Bits reserved for DWORD alignment.
+  UINT16 CustomPowerLimit1;                          ///< Short term Power Limit value for custom cTDP level. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  UINT16 CustomPowerLimit2;                          ///< Long term Power Limit value for custom cTDP level. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+} PPM_CUSTOM_CTDP_TABLE;
+
+/**
+  CPU Power Management Custom Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER    Header;                                                ///< Config Block Header
+  PPM_CUSTOM_RATIO_TABLE CustomRatioTable;                                      ///< Custom Processor Ratio Table Instance
+  PPM_CUSTOM_CTDP_TABLE  CustomConfigTdpTable[MAX_CUSTOM_CTDP_ENTRIES];         ///< Custom ConfigTdp Settings Instance
+  UINT32                 ConfigTdpLock  : 1;                                    ///< Lock the ConfigTdp mode settings from runtime changes; <b>0: Disable</b>; 1: Enable.
+  UINT32                 ConfigTdpBios  : 1;                                    ///< Configure whether to load Configurable TDP SSDT; <b>0: Disable</b>; 1: Enable.
+  UINT32                 RsvdBits       : 30;                                   ///< Reserved for future use
+} CPU_POWER_MGMT_CUSTOM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtPsysConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtPsysConfig.h
new file mode 100644
index 0000000000..f1ceb8f43b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtPsysConfig.h
@@ -0,0 +1,36 @@
+/** @file
+  CPU Power Management Psys(Platform) Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POWER_MGMT_PSYS_CONFIG_H_
+#define _CPU_POWER_MGMT_PSYS_CONFIG_H_
+
+#define CPU_POWER_MGMT_PSYS_CONFIG_REVISION 1
+
+extern EFI_GUID gCpuPowerMgmtPsysConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CPU Power Management Psys(Platform) Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  UINT32 PsysPowerLimit1       : 1;               ///< MSR 0x65C[15]: PL1 Enable activates the PL1 value to limit average platform power
+  UINT32 PsysPowerLimit1Time   : 8;               ///< MSR 0x65C[23:17]: PL1 timewindow in seconds.
+  UINT32 PsysPowerLimit2       : 1;               ///< MSR 0x65C[47]: PL2 Enable activates the PL2 value to limit average platform power
+  UINT32 RsvdBits              : 22;              ///< Reserved for future use.
+  UINT16 PsysPowerLimit1Power;                    ///< MSR 0x65C[14:0]: Platform PL1 power. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  UINT16 PsysPowerLimit2Power;                    ///< MSR 0x65C[46:32]]: Platform PL2 power. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
+  UINT16 PsysPmax;                                ///< PCODE MMIO Mailbox: Platform Power Pmax. <b>0 - Auto</b> Specified in 1/8 Watt increments. 0-1024 Watts. Value of 800 = 100W.
+  UINT8  Rsvd[2];                                 ///< Reserved for future use and config block alignment
+} CPU_POWER_MGMT_PSYS_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_POWER_MGMT_PSYS_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtTestConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtTestConfig.h
new file mode 100644
index 0000000000..bd641f27c5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtTestConfig.h
@@ -0,0 +1,150 @@
+/** @file
+  CPU Power Management Test Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POWER_MGMT_TEST_CONFIG_H_
+#define _CPU_POWER_MGMT_TEST_CONFIG_H_
+
+#define CPU_POWER_MGMT_TEST_CONFIG_REVISION 4
+
+extern EFI_GUID gCpuPowerMgmtTestConfigGuid;
+
+#pragma pack (push,1)
+
+///
+/// PPM Package C State Limit
+///
+typedef enum {
+  PkgC0C1                 = 0,
+  PkgC2,
+  PkgC3,
+  PkgC6,
+  PkgC7,
+  PkgC7s,
+  PkgC8,
+  PkgC9,
+  PkgC10,
+  PkgCMax,
+  PkgCpuDefault = 254,
+  PkgAuto = 255
+} MAX_PKG_C_STATE;
+
+///
+/// PPM Package C State Time Limit
+///
+typedef enum {
+  TimeUnit1ns             = 0,
+  TimeUnit32ns,
+  TimeUnit1024ns,
+  TimeUnit32768ns,
+  TimeUnit1048576ns,
+  TimeUnit33554432ns,
+  TimeUnitMax
+} C_STATE_TIME_UNIT;
+
+///
+/// Custom Power Units. User can choose to enter in watts or 125 milliwatt increments.
+///
+typedef enum {
+  PowerUnitWatts = 0,     ///< in Watts.
+  PowerUnit125MilliWatts, ///< in 125 milliwatt increments. Example: 90 power units times 125 mW equals 11.250 W.
+  PowerUnitMax
+} CUSTOM_POWER_UNIT;
+
+///
+/// PPM Interrupt Redirection Mode Selection
+///
+typedef enum {
+  PpmIrmFixedPriority     = 0,
+  PpmIrmRoundRobin,
+  PpmIrmHashVector,
+  PpmIrmReserved1,
+  PpmIrmReserved2,
+  PpmIrmReserved3,
+  PpmIrmReserved4,
+  PpmIrmNoChange
+} PPM_IRM_SETTING;
+
+/**
+  CPU Power Management Test Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Add  CstateLatencyControl0TimeUnit for WHL only
+  - Add  CstateLatencyControl0Irtl for WHL only
+  <b>Revision 3</b>:
+  - Change C State LatencyContol to Auto as default.
+  <b>Revision 4</b>:
+  - Deprecate ConfigTdpLevel. Move to premem.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                    ///< Offset 0-27  Config Block Header
+  UINT32 Eist                          : 1;        ///< Offset 28-31 Enable or Disable Intel SpeedStep Technology. 0: Disable; <b>1: Enable</b>
+  UINT32 EnergyEfficientPState         : 1;        ///<              Enable or Disable Energy Efficient P-state will be applied in Turbo mode. Disable; <b>1: Enable</b>
+  UINT32 EnergyEfficientTurbo          : 1;        ///<              Enable or Disable Energy Efficient Turbo, will be applied in Turbo mode. Disable; <b>1: Enable</b>
+  UINT32 TStates                       : 1;        ///<              Enable or Disable T states; <b>0: Disable</b>; 1: Enable.
+  UINT32 BiProcHot                     : 1;        ///<              Enable or Disable Bi-Directional PROCHOT#; 0: Disable; <b>1: Enable</b>.
+  UINT32 DisableProcHotOut             : 1;        ///<              Enable or Disable PROCHOT# signal being driven externally; 0: Disable; <b>1: Enable</b>.
+  UINT32 ProcHotResponse               : 1;        ///<              Enable or Disable PROCHOT# Response; <b>0: Disable</b>; 1: Enable.
+  UINT32 DisableVrThermalAlert         : 1;        ///<              Enable or Disable VR Thermal Alert; <b>0: Disable</b>; 1: Enable.
+  UINT32 EnableAllThermalFunctions     : 1;        ///<              Enable or Disable Thermal Reporting through ACPI tables; 0: Disable; <b>1: Enable</b>.
+  UINT32 ThermalMonitor                : 1;        ///<              Enable or Disable Thermal Monitor; 0: Disable; <b>1: Enable</b>.
+  UINT32 Cx                            : 1;        ///<              Enable or Disable CPU power states (C-states). 0: Disable; <b>1: Enable</b>
+  UINT32 PmgCstCfgCtrlLock             : 1;        ///<              If enabled, sets MSR 0xE2[15]; 0: Disable; <b>1: Enable</b>.
+  UINT32 C1e                           : 1;        ///<              Enable or Disable Enhanced C-states. 0: Disable; <b>1: Enable</b>
+  UINT32 C1AutoDemotion                : 1;        ///<              Enable or Disable C6/C7 auto demotion to C1. 0: Disabled; <b>1: C1 Auto demotion</b>
+  UINT32 C1UnDemotion                  : 1;        ///<              Enable or Disable C1UnDemotion. 0: Disabled; <b>1: C1 Auto undemotion</b>
+  UINT32 C3AutoDemotion                : 1;        ///<              [CoffeeLake Only] Enable or Disable C6/C7 auto demotion to C3  0: Disabled; <b>1: C3 Auto demotion</b>
+  UINT32 C3UnDemotion                  : 1;        ///<              [CoffeeLake Only] Enable or Disable C3UnDemotion. 0: Disabled; <b>1: C3 Auto undemotion</b>
+  UINT32 PkgCStateDemotion             : 1;        ///<              Enable or Disable Package Cstate Demotion. Disable; <b>1: Enable</b> [WhiskeyLake] <b>Disable</b>; 1: Enable
+  UINT32 PkgCStateUnDemotion           : 1;        ///<              Enable or Disable Package Cstate UnDemotion. Disable; <b>1: Enable</b> [WhiskeyLake] <b>Disable</b>; 1: Enable
+  UINT32 CStatePreWake                 : 1;        ///<              Enable or Disable CState-Pre wake. Disable; <b>1: Enable</b>
+  UINT32 TimedMwait                    : 1;        ///<              Enable or Disable TimedMwait Support. <b>Disable</b>; 1: Enable
+  UINT32 CstCfgCtrIoMwaitRedirection   : 1;        ///<              Enable or Disable IO to MWAIT redirection; <b>0: Disable</b>; 1: Enable.
+  UINT32 ProcHotLock                   : 1;        ///<              If enabled, sets MSR 0x1FC[23]; <b>0: Disable</b>; 1: Enable.
+  UINT32 RaceToHalt                    : 1;        ///<              Enable or Disable Race To Halt feature; 0: Disable; <b>1: Enable </b>. RTH will dynamically increase CPU frequency in order to enter pkg C-State faster to reduce overall power. (RTH is controlled through MSR 1FC bit 20)
+  UINT32 ConfigTdpLevel                : 8;        ///<              @deprecated. Move to premem phase.
+  UINT16 CstateLatencyControl1Irtl;                ///< Offset 32-33 Interrupt Response Time Limit of LatencyContol1 MSR 0x60B[9:0].<b>0 is Auto</b>.
+  UINT16 CstateLatencyControl2Irtl;                ///< Offset 34-35 Interrupt Response Time Limit of LatencyContol2 MSR 0x60C[9:0].<b>0 is Auto</b>.
+  UINT16 CstateLatencyControl3Irtl;                ///< Offset 36-37 Interrupt Response Time Limit of LatencyContol3 MSR 0x633[9:0].<b>0 is Auto</b>.
+  UINT16 CstateLatencyControl4Irtl;                ///< Offset 38-39 Interrupt Response Time Limit of LatencyContol4 MSR 0x634[9:0].<b>0 is Auto</b>.
+  UINT16 CstateLatencyControl5Irtl;                ///< Offset 40-41 Interrupt Response Time Limit of LatencyContol5 MSR 0x635[9:0].<b>0 is Auto</b>.
+  // Due to the removal of CstateLatencyControl0Irtl, PkgCStateLimit is not aligned to 32-bit address.
+  UINT8  Rsvd1[2];                                 ///< Offset 42-43 Reserved for config block alignment.
+  MAX_PKG_C_STATE   PkgCStateLimit;                ///< Offset 44    This field is used to set the Max Pkg Cstate. Default set to Auto which limits the Max Pkg Cstate to deep C-state.
+  /**
+     @todo: The following enums have to be replaced with policies.
+  **/
+  C_STATE_TIME_UNIT Reserved;                      ///< Offset 45    Reserved for config block alignment.
+  C_STATE_TIME_UNIT CstateLatencyControl1TimeUnit; ///< Offset 46    TimeUnit for Latency Control1 MSR 0x60B[12:10]; <b>2: 1024ns</b>.
+  C_STATE_TIME_UNIT CstateLatencyControl2TimeUnit; ///< Offset 47    TimeUnit for Latency Control2 MSR 0x60C[12:10]; <b>2: 1024ns</b>.
+  C_STATE_TIME_UNIT CstateLatencyControl3TimeUnit; ///< Offset 48    TimeUnit for Latency Control3 MSR 0x633[12:10]; <b>2: 1024ns</b>.
+  C_STATE_TIME_UNIT CstateLatencyControl4TimeUnit; ///< Offset 49    TimeUnit for Latency Control4 MSR 0x634[12:10]; <b>2: 1024ns</b>.
+  C_STATE_TIME_UNIT CstateLatencyControl5TimeUnit; ///< Offset 50    TimeUnit for Latency Control5 MSR 0x635[12:10]; <b>2: 1024ns</b>.
+  /**
+  Offset 51  Default power unit in watts or in 125 milliwatt increments.
+  - 0: PowerUnitWatts.
+  - <b>1: PowerUnit125MilliWatts</b>.
+  **/
+  CUSTOM_POWER_UNIT CustomPowerUnit;
+  /**
+  Offset 52  Interrupt Redirection Mode Select.
+   - 0: Fixed priority.             //Default under CNL.
+   - 1: Round robin.
+   - 2: Hash vector.
+   - 4: PAIR with fixed priority.   //Default under KBL, not available under CNL.
+   - 5: PAIR with round robin.      //Not available under CNL.
+   - 6: PAIR with hash vector.      //Not available under CNL.
+   - 7: No change.
+  **/
+  PPM_IRM_SETTING      PpmIrmSetting;
+  // Move the padding to previous offset to align the structure at 32-bit address.
+  UINT8  Rsvd[4];                                 ///< Offset 53-56 Reserved for future use and config block alignment
+} CPU_POWER_MGMT_TEST_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_POWER_MGMT_TEST_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPreMemConfig.h
new file mode 100644
index 0000000000..24614fe497
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPreMemConfig.h
@@ -0,0 +1,63 @@
+/** @file
+  CPU Security PreMemory Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_SECURITY_PREMEM_CONFIG_H_
+#define _CPU_SECURITY_PREMEM_CONFIG_H_
+
+#define CPU_SECURITY_PREMEM_CONFIG_REVISION 1
+
+extern EFI_GUID gCpuSecurityPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CPU Security PreMemory Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER Header;                      ///< Config Block Header
+  UINT32              PrmrrSize;                   ///< PRMRR Size.<b>Software Control: 0x0</b>  32MB: 0x2000000, 64MB: 0x4000000, 128 MB: 0x8000000, 256 MB: 0x10000000, 512 MB: 0x20000000
+  UINT16              BiosSize;                    ///< Flash information for BIOS Guard: BIOS Size in KB.
+  UINT8               Reserved[2];                 ///< Reserved for future use
+/**
+   Enable or Disable BIOS Guard; 0: Disable; <b>1: Enable</b>.
+    - This is an optional feature and can be opted out.
+    - If this policy is set to Disabled, the policies in the BIOS_GUARD_CONFIG will be ignored.
+    - If PeiBiosGuardLibNull is used, this policy will have no effect.
+**/
+  UINT32              BiosGuard               :  1;
+  UINT32              BiosGuardToolsInterface :  1; ///< BIOS Guard Tools Interface; <b>0: Disable</b>, 1:Enable
+/**
+   Enable or Disable Software Guard Extensions; <b>0: Disable</b>; 1: Enable.
+    - This is an optional feature and can be opted out.
+    - If this policy is set to Disabled, the policies in the CPU_SGX_CONFIG will be ignored.
+    - If BaseSoftwareGuardLibNull is used, this policy will have no effect.
+**/
+  UINT32              EnableSgx               :  1;
+/**
+   Enable or Disable Trusted Execution Technology; <b>0: Disable</b>; 1: Enable.
+    - This is an optional feature and can be opted out.
+    - If this policy is set to Disabled, the policies in the CPU_TXT_PREMEM_CONFIG will be ignored.
+    - If PeiTxtLibNull is used, this policy will have no effect.
+**/
+  UINT32              Txt                     :  1;
+  UINT32              SkipStopPbet            :  1; ///< <b>(Test)</b> Skip Stop PBET Timer; <b>0: Disable</b>; 1: Enable.
+  ///
+  /// <b>(Test)</b> This policy indicates whether or not BIOS should allocate PRMRR memory for C6DRAM power gating feature.
+  ///  - 0: Don't allocate any PRMRR memory for C6DRAM power gating feature.
+  ///  - <b>1: Allocate PRMRR memory for C6DRAM power gating feature</b>.
+  ///
+  UINT32              EnableC6Dram            :  1;
+  UINT32              ResetAux                :  1; ///< <b>(Test)</b> Reset Auxiliary content, <b>0: Disabled</b>, 1: Enabled
+  UINT32              TxtAcheckRequest        :  1; ///< <b>(Test)</b> AcheckRequest <b>0: Disabled</b>, 1: Enabled. When Enabled, it will call Acheck regardless of crashcode value
+  UINT32              RsvdBits                : 24; ///< Reserved for future use
+} CPU_SECURITY_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_SECURITY_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.h
new file mode 100644
index 0000000000..ee946290e0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.h
@@ -0,0 +1,51 @@
+/** @file
+  CPU Test Config Block.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_TEST_CONFIG_H_
+#define _CPU_TEST_CONFIG_H_
+
+#define CPU_TEST_CONFIG_REVISION 2
+
+extern EFI_GUID gCpuTestConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  CPU Test Configuration Structure.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Removed Voltage Optimization feature.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  UINT32                MlcStreamerPrefetcher           : 1;     ///< Enable or Disable MLC Streamer Prefetcher; 0: Disable; <b>1: Enable</b>.
+  UINT32                MlcSpatialPrefetcher            : 1;     ///< Enable or Disable MLC Spatial Prefetcher; 0: Disable; <b>1: Enable</b>.
+  UINT32                MonitorMwaitEnable              : 1;     ///< Enable or Disable Monitor /MWAIT instructions; 0: Disable; <b>1: Enable</b>.
+  UINT32                MachineCheckEnable              : 1;     ///< Enable or Disable initialization of machine check registers; 0: Disable; <b>1: Enable</b>.
+  UINT32                ProcessorTraceOutputScheme      : 1;     ///< Control on Processor Trace output scheme; <b>0: Single Range Output</b>; 1: ToPA Output.
+  UINT32                ProcessorTraceEnable            : 1;     ///< Enable or Disable Processor Trace feature; <b>0: Disable</b>; 1: Enable.
+  UINT32                ThreeStrikeCounterDisable       : 1;     ///< Disable Three strike counter; <b>0: FALSE</b>; 1: TRUE.
+  UINT32                RsvdBits                        : 25;     ///< Reserved for future use
+  /**
+     Base address of memory region allocated for Processor Trace.
+     Processor Trace requires 2^N alignment and size in bytes per thread, from 4KB to 128MB.
+     - <b>NULL: Disable</b>
+  **/
+  EFI_PHYSICAL_ADDRESS  ProcessorTraceMemBase;
+  /**
+     Length in bytes of memory region allocated for Processor Trace.
+     Processor Trace requires 2^N alignment and size in bytes per thread, from 4KB to 128MB.
+     - <b>0: Disable</b>
+  **/
+  UINT32                ProcessorTraceMemLength;
+  UINT8                 Reserved0[4];
+} CPU_TEST_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _CPU_TEST_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h
new file mode 100644
index 0000000000..5d5e4df071
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h
@@ -0,0 +1,12 @@
+/** @file
+  Macros to simplify and abstract the interface to CPU configuration.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPUACCESS_H_
+#define _CPUACCESS_H_
+
+#include "CpuDataStruct.h"
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h
new file mode 100644
index 0000000000..ba9a840e54
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h
@@ -0,0 +1,21 @@
+/** @file
+  This file declares various data structures used in CPU reference code.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CPU_DATA_STRUCT_H
+#define _CPU_DATA_STRUCT_H
+
+///
+/// Structure to hold the return value of AsmCpuid instruction
+///
+typedef struct {
+  UINT32 RegEax; ///< Value of EAX.
+  UINT32 RegEbx; ///< Value of EBX.
+  UINT32 RegEcx; ///< Value of ECX.
+  UINT32 RegEdx; ///< Value of EDX.
+} EFI_CPUID_REGISTER;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
new file mode 100644
index 0000000000..1178f68d0c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
@@ -0,0 +1,23 @@
+/** @file
+  CPU Policy Structure definition which will contain several config blocks during runtime.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_POLICY_COMMON_H_
+#define _CPU_POLICY_COMMON_H_
+
+#include <ConfigBlock.h>
+#include <ConfigBlock/CpuConfig.h>
+#include <ConfigBlock/CpuPidTestConfig.h>
+#include <ConfigBlock/CpuPowerMgmtBasicConfig.h>
+#include <ConfigBlock/CpuPowerMgmtCustomConfig.h>
+#include <ConfigBlock/CpuPowerMgmtPsysConfig.h>
+#include <ConfigBlock/CpuPowerMgmtTestConfig.h>
+#include <ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h>
+#include <ConfigBlock/CpuTestConfig.h>
+#include <ConfigBlock/CpuSecurityPreMemConfig.h>
+#include <ConfigBlock/CpuConfigLibPreMemConfig.h>
+#include <OverclockingConfig.h>
+
+#endif // _CPU_POLICY_COMMON_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
new file mode 100644
index 0000000000..a2cd1db1d6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
@@ -0,0 +1,18 @@
+
+/** @file
+  CommonMsr.h
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _COMMONMSR_h
+#define _COMMONMSR_h
+#include <Base.h>
+
+/**
+  Special Chipset Usage MSR
+**/
+#define MSR_SPCL_CHIPSET_USAGE 0x000001FE
+
+#endif /* _COMMONMSR_h */
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (2 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers Heng Luo
                   ` (35 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Pch/Include

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtectionConfig.h   |  55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h              |  57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h          |  58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.h          |  64 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig.h          |  61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h               |  38 ++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConfig.h        |  72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.h         | 258 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h                  | 590 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h                | 552 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h                          |  70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h                           |  67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h                     |  55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h               |  56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h            |  21 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h           | 184 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch.h         | 134 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch.h         | 144 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch.h         | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h                  |  40 ++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h             | 132 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapControl.h        |  65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTimerControl.h |  65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.h          | 150 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h                    |  16 ++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h                 | 145 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h                 |  50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h                |  66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 28 files changed, 3431 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtectionConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtectionConfig.h
new file mode 100644
index 0000000000..d1e10c3422
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtectionConfig.h
@@ -0,0 +1,55 @@
+/** @file
+  FlashProtection policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _FLASH_PROTECTION_CONFIG_H_
+#define _FLASH_PROTECTION_CONFIG_H_
+
+#define FLASH_PROTECTION_CONFIG_REVISION 1
+extern EFI_GUID gFlashProtectionConfigGuid;
+
+#pragma pack (push,1)
+
+//
+// Flash Protection Range Register
+//
+#define PCH_FLASH_PROTECTED_RANGES         5
+
+/**
+  Protected Flash Range
+**/
+typedef struct {
+  UINT32                WriteProtectionEnable     :  1;     ///< Write or erase is blocked by hardware. <b>0: Disable</b>; 1: Enable.
+  UINT32                ReadProtectionEnable      :  1;     ///< Read is blocked by hardware. <b>0: Disable</b>; 1: Enable.
+  UINT32                RsvdBits                  :  30;    ///< Reserved
+  /**
+    The address of the upper limit of protection
+    This is a left shifted address by 12 bits with address bits 11:0 are assumed to be FFFh for limit comparison
+  **/
+  UINT16                ProtectedRangeLimit;
+  /**
+    The address of the upper limit of protection
+    This is a left shifted address by 12 bits with address bits 11:0 are assumed to be 0
+  **/
+  UINT16                ProtectedRangeBase;
+} PROTECTED_RANGE;
+
+/**
+  The PCH provides a method for blocking writes and reads to specific ranges
+  in the SPI flash when the Protected Ranges are enabled.
+  PROTECTED_RANGE is used to specify if flash protection are enabled,
+  the write protection enable bit and the read protection enable bit,
+  and to specify the upper limit and lower base for each register
+  Platform code is responsible to get the range base by PchGetSpiRegionAddresses routine,
+  and set the limit and base accordingly.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                                     ///< Config Block Header
+  PROTECTED_RANGE       ProtectRange[PCH_FLASH_PROTECTED_RANGES];   ///< Protected Flash Ranges
+} PCH_FLASH_PROTECTION_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _FLASH_PROTECTION_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
new file mode 100644
index 0000000000..ec27845a48
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
@@ -0,0 +1,57 @@
+/** @file
+  HSIO policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HSIO_CONFIG_H_
+#define _HSIO_CONFIG_H_
+#define HSIO_PREMEM_CONFIG_REVISION 1 //@deprecated
+extern EFI_GUID gHsioPreMemConfigGuid; //@deprecated
+
+#define HSIO_CONFIG_REVISION 1
+extern EFI_GUID gHsioConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PCH_HSIO_PREMEM_CONFIG block provides HSIO message related settings.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+
+  /**
+  <b>(Test)</b>
+  0- Disable, disable will prevent the HSIO version check and ChipsetInit HECI message from being sent
+  <b>1- Enable</b> ChipsetInit HECI message
+  **/
+  UINT8     ChipsetInitMessage;
+  /**
+  <b>(Test)</b>
+  <b>0- Disable</b>
+  1- Enable When enabled, this is used to bypass the reset after ChipsetInit HECI message.
+  **/
+  UINT8     BypassPhySyncReset;
+  UINT8     RsvdBytes[2];
+
+} PCH_HSIO_PREMEM_CONFIG;
+
+
+/**
+  The PCH_HSIO_CONFIG block provides HSIO message related settings.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
+  /**
+    Policy used to point to the Base (+ OEM) ChipsetInit binary used to sync between BIOS and CSME
+  **/
+  UINT32    ChipsetInitBinPtr;
+  /**
+    Policy used to indicate the size of the Base (+ OEM) ChipsetInit binary used to sync between BIOS and CSME
+  **/
+  UINT32    ChipsetInitBinLen;
+} PCH_HSIO_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _HSIO_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h
new file mode 100644
index 0000000000..bc23f3e1a6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h
@@ -0,0 +1,58 @@
+/** @file
+  HSIO pcie policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HSIO_PCIE_CONFIG_H_
+#define _HSIO_PCIE_CONFIG_H_
+
+#include <PchLimits.h>
+
+#define HSIO_PCIE_PREMEM_CONFIG_REVISION 1
+extern EFI_GUID gHsioPciePreMemConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PCH_HSIO_PCIE_LANE_CONFIG describes HSIO settings for PCIe lane
+**/
+typedef struct {
+  //
+  // HSIO Rx Eq
+  // Refer to the EDS for recommended values.
+  // Note that these setting are per-lane and not per-port
+  //
+  UINT32  HsioRxSetCtleEnable           : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 3 Set CTLE Value
+  UINT32  HsioRxSetCtle                 : 6;      ///< PCH PCIe Gen 3 Set CTLE Value
+  UINT32  HsioTxGen1DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 1 TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen1DownscaleAmp        : 6;      ///< PCH PCIe Gen 1 TX Output Downscale Amplitude Adjustment value
+  UINT32  HsioTxGen2DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 2 TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen2DownscaleAmp        : 6;      ///< PCH PCIe Gen 2 TX Output Downscale Amplitude Adjustment value
+  UINT32  HsioTxGen3DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 3 TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen3DownscaleAmp        : 6;      ///< PCH PCIe Gen 3 TX Output Downscale Amplitude Adjustment value
+  UINT32  RsvdBits0                     : 4;      ///< Reserved Bits
+
+  UINT32  HsioTxGen1DeEmphEnable        : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 1 TX Output De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen1DeEmph              : 6;      ///< PCH PCIe Gen 1 TX Output De-Emphasis Adjustment Setting
+  UINT32  HsioTxGen2DeEmph3p5Enable     : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 2 TX Output -3.5dB Mode De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen2DeEmph3p5           : 6;      ///< PCH PCIe Gen 2 TX Output -3.5dB Mode De-Emphasis Adjustment Setting
+  UINT32  HsioTxGen2DeEmph6p0Enable     : 1;      ///< <b>0: Disable</b>; 1: Enable PCH PCIe Gen 2 TX Output -6.0dB Mode De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen2DeEmph6p0           : 6;      ///< PCH PCIe Gen 2 TX Output -6.0dB Mode De-Emphasis Adjustment Setting
+  UINT32  RsvdBits1                     : 11;     ///< Reserved Bits
+} PCH_HSIO_PCIE_LANE_CONFIG;
+
+///
+/// The PCH_HSIO_PCIE_CONFIG block describes the configuration of the HSIO for PCIe lanes
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  ///
+  /// These members describe the configuration of HSIO for PCIe lanes.
+  ///
+  PCH_HSIO_PCIE_LANE_CONFIG         Lane[PCH_MAX_PCIE_ROOT_PORTS];
+} PCH_HSIO_PCIE_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _HSIO_PCIE_LANE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.h
new file mode 100644
index 0000000000..21b0d7ff63
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.h
@@ -0,0 +1,64 @@
+/** @file
+  Hsio Sata policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HSIO_SATA_CONFIG_H_
+#define _HSIO_SATA_CONFIG_H_
+
+#define HSIO_SATA_PREMEM_CONFIG_REVISION 1
+extern EFI_GUID gHsioSataPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PCH_HSIO_SATA_PORT_LANE describes HSIO settings for SATA Port lane
+**/
+typedef struct {
+  //
+  // HSIO Rx Eq
+  //
+  UINT32  HsioRxGen1EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1: Enable Receiver Equalization Boost Magnitude Adjustment Value override
+  UINT32  HsioRxGen1EqBoostMag         : 6;       ///< SATA 1.5 Gb/sReceiver Equalization Boost Magnitude Adjustment value
+  UINT32  HsioRxGen2EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1: Enable Receiver Equalization Boost Magnitude Adjustment Value override
+  UINT32  HsioRxGen2EqBoostMag         : 6;       ///< SATA 3.0 Gb/sReceiver Equalization Boost Magnitude Adjustment value
+  UINT32  HsioRxGen3EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1: Enable Receiver Equalization Boost Magnitude Adjustment Value override
+  UINT32  HsioRxGen3EqBoostMag         : 6;       ///< SATA 6.0 Gb/sReceiver Equalization Boost Magnitude Adjustment value
+  //
+  // HSIO Tx Eq
+  //
+  UINT32  HsioTxGen1DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 1.5 Gb/s TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen1DownscaleAmp       : 6;       ///< SATA 1.5 Gb/s TX Output Downscale Amplitude Adjustment value
+  UINT32  RsvdBits0                    : 4;       ///< Reserved bits
+
+  UINT32  HsioTxGen2DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 3.0 Gb/s TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen2DownscaleAmp       : 6;       ///< SATA 3.0 Gb/s TX Output Downscale Amplitude Adjustment
+  UINT32  HsioTxGen3DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 6.0 Gb/s TX Output Downscale Amplitude Adjustment value override
+  UINT32  HsioTxGen3DownscaleAmp       : 6;       ///< SATA 6.0 Gb/s TX Output Downscale Amplitude Adjustment
+  UINT32  HsioTxGen1DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 1.5 Gb/s TX Output De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen1DeEmph             : 6;       ///< SATA 1.5 Gb/s TX Output De-Emphasis Adjustment Setting
+
+  UINT32  HsioTxGen2DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 3.0 Gb/s TX Output De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen2DeEmph             : 6;       ///< SATA 3.0 Gb/s TX Output De-Emphasis Adjustment Setting
+  UINT32  RsvdBits1                    : 4;       ///< Reserved bits
+
+  UINT32  HsioTxGen3DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1: Enable SATA 6.0 Gb/s TX Output De-Emphasis Adjustment Setting value override
+  UINT32  HsioTxGen3DeEmph             : 6;       ///< SATA 6.0 Gb/s TX Output De-Emphasis Adjustment Setting value override
+  UINT32  RsvdBits2                    : 25;      ///< Reserved bits
+} PCH_HSIO_SATA_PORT_LANE;
+
+///
+/// The PCH_HSIO_SATA_CONFIG block describes the HSIO configuration of the SATA controller.
+///
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  ///
+  /// These members describe the configuration of HSIO for SATA lanes.
+  ///
+  PCH_HSIO_SATA_PORT_LANE        PortLane[PCH_MAX_SATA_PORTS];
+} PCH_HSIO_SATA_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _HSIO_SATA_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig.h
new file mode 100644
index 0000000000..23f116cf3d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig.h
@@ -0,0 +1,61 @@
+/** @file
+  Lock down policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _LOCK_DOWN_CONFIG_H_
+#define _LOCK_DOWN_CONFIG_H_
+
+#define LOCK_DOWN_CONFIG_REVISION 1
+extern EFI_GUID gLockDownConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  The PCH_LOCK_DOWN_CONFIG block describes the expected configuration of the PCH
+  for security requirement.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    <b>(Test)</b> Enable SMI_LOCK bit to prevent writes to the Global SMI Enable bit. 0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32  GlobalSmi      :  1;
+  /**
+    <b>(Test)</b> Enable BIOS Interface Lock Down bit to prevent writes to the Backup Control Register
+    Top Swap bit and the General Control and Status Registers Boot BIOS Straps.
+    Intel strongly recommends that BIOS sets the BIOS Interface Lock Down bit. Enabling this bit
+    will mitigate malicious software attempts to replace the system BIOS with its own code.
+    0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32  BiosInterface  :  1;
+  /**
+    Enable the BIOS Lock Enable (BLE) feature and set EISS bit (D31:F5:RegDCh[5])
+    for the BIOS region protection. When it is enabled, the BIOS Region can only be
+    modified from SMM.
+    If this EISS bit is set, then WPD must be a '1' and InSMM.STS must be '1' also
+    in order to write to BIOS regions of SPI Flash. If this EISS bit is clear,
+    then the InSMM.STS is a don't care.
+    The BIOS must set the EISS bit while BIOS Guard support is enabled.
+    In recovery path, platform can temporary disable EISS for SPI programming in
+    PEI phase or early DXE phase.
+    When PcdSmmVariableEnable is FALSE, to support BIOS regions update outside of SMM,
+    the BiosLock must be set to Disabled by platform.
+    0: Disable; <b>1: Enable.</b>
+  **/
+  UINT32  BiosLock       :  1;
+  /**
+    <b>(Test)</b> This test option when set will force all GPIO pads to be unlocked
+    before BIOS transitions to POSTBOOT_SAI. This option should not be enabled in production
+    configuration and used only for debug purpose when free runtime reconfiguration of
+    GPIO pads is needed.
+    <b>0: Disable</b>; 1: Enable.
+  **/
+  UINT32  UnlockGpioPads :  1;
+  UINT32  RsvdBits0      : 28;             ///< Reserved bits
+} PCH_LOCK_DOWN_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _LOCK_DOWN_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
new file mode 100644
index 0000000000..3fc64aa056
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
@@ -0,0 +1,38 @@
+/** @file
+  Lpc policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _LPC_CONFIG_H_
+#define _LPC_CONFIG_H_
+
+#define LPC_PREMEM_CONFIG_REVISION 1
+extern EFI_GUID gLpcPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure contains the policies which are related to LPC.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    Enhance the port 8xh decoding.
+    Original LPC only decodes one byte of port 80h, with this enhancement LPC can decode word or dword of port 80h-83h.
+    @note: this will occupy one LPC generic IO range register. While this is enabled, read from port 80h always return 0x00.
+    0: Disable, <b>1: Enable</b>
+  **/
+  UINT32    EnhancePort8xhDecoding      :  1;
+  /**
+   Hardware Autonomous Enable.
+   When enabled, LPC will automatically engage power gating when it has reached its idle condition.
+   0: Disable, <b>1: Enable</b>
+  **/
+  UINT32    LpcPmHAE                    :  1;
+  UINT32    RsvdBits                    : 30;     ///< Reserved bits
+} PCH_LPC_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _LPC_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConfig.h
new file mode 100644
index 0000000000..da77abc1b3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConfig.h
@@ -0,0 +1,72 @@
+/** @file
+  PCH General policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_GENERAL_CONFIG_H_
+#define _PCH_GENERAL_CONFIG_H_
+
+#define PCH_GENERAL_CONFIG_REVISION 1
+#define PCH_GENERAL_PREMEM_CONFIG_REVISION 2
+
+extern EFI_GUID gPchGeneralConfigGuid;
+extern EFI_GUID gPchGeneralPreMemConfigGuid;
+
+#pragma pack (push,1)
+
+enum PCH_RESERVED_PAGE_ROUTE {
+  PchReservedPageToLpc,                   ///< Port 80h cycles are sent to LPC.
+  PchReservedPageToPcie                   ///< Port 80h cycles are sent to PCIe.
+};
+
+/**
+  PCH General Configuration
+  <b>Revision 1</b>:  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    This member describes whether or not the Compatibility Revision ID (CRID) feature
+    of PCH should be enabled. <b>0: Disable</b>; 1: Enable
+  **/
+  UINT32    Crid            :  1;
+  /**
+    Set to enable low latency of legacy IO.
+    Some systems require lower IO latency irrespective of power.
+    This is a tradeoff between power and IO latency.
+    @note: Once this is enabled, DmiAspm, Pcie DmiAspm in SystemAgent
+    and ITSS Clock Gating are forced to disabled.
+    <b>0: Disable</b>, 1: Enable
+  **/
+  UINT32    LegacyIoLowLatency  :  1;
+  UINT32    RsvdBits0           : 30;       ///< Reserved bits
+} PCH_GENERAL_CONFIG;
+
+/**
+  PCH General Pre-Memory Configuration
+  <b>Revision 1</b>:  - Initial version.
+  <b>Revision 2</b>:  - Added GpioOverride.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
+  /**
+    Control where the Port 80h cycles are sent, <b>0: LPC</b>; 1: PCI.
+  **/
+  UINT32    Port80Route     :  1;
+  UINT32    IotgPllSscEn    :  1;       ///< Need to disable CPU Side SSC for A0 PO
+  /**
+    Gpio override Level
+    -- <b>0: Disable</b>;
+    -  1: Override Level 1 - only skips GpioSetNativePadByFunction
+    -  2: Override Level 2 - skips GpioSetNativePadByFunction and GpioSetPadMode
+    Additional policy that allows GPIO configuration to be done by external means.
+    If equal to 1  PCH will skip every Pad configuration.
+  **/
+  UINT32    GpioOverride    :  3;
+  UINT32    RsvdBits0       : 27;       ///< Reserved bits
+} PCH_GENERAL_PREMEM_CONFIG;
+
+#pragma pack (pop)
+
+#endif // _PCH_GENERAL_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.h
new file mode 100644
index 0000000000..94509a80fe
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.h
@@ -0,0 +1,258 @@
+/** @file
+  Header file for PchCycleDecodingLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_CYCLE_DECODING_LIB_H_
+#define _PCH_CYCLE_DECODING_LIB_H_
+
+
+/**
+  Get PCH TCO base address.
+
+  @param[out] Address                   Address of TCO base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid pointer passed.
+**/
+EFI_STATUS
+PchTcoBaseGet (
+  OUT UINT16                            *Address
+  );
+
+///
+/// structure of LPC general IO range register
+/// It contains base address, address mask, and enable status.
+///
+typedef struct {
+  UINT32                                BaseAddr :16;
+  UINT32                                Length   :15;
+  UINT32                                Enable   : 1;
+} PCH_LPC_GEN_IO_RANGE;
+
+#define PCH_LPC_GEN_IO_RANGE_MAX        4
+#define ESPI_CS1_GEN_IO_RANGE_MAX       1
+
+///
+/// structure of LPC general IO range register list
+/// It lists all LPC general IO ran registers supported by PCH.
+///
+typedef struct {
+  PCH_LPC_GEN_IO_RANGE                  Range[PCH_LPC_GEN_IO_RANGE_MAX];
+} PCH_LPC_GEN_IO_RANGE_LIST;
+
+/**
+  Set PCH LPC/eSPI generic IO range.
+  For generic IO range, the base address must align to 4 and less than 0xFFFF, and the length must be power of 2
+  and less than or equal to 256. Moreover, the address must be length aligned.
+  This function basically checks the address and length, which should not overlap with all other generic ranges.
+  If no more generic range register available, it returns out of resource error.
+  This cycle decoding is also required on DMI side.
+  Some IO ranges below 0x100 have fixed target. The target might be ITSS,RTC,LPC,PMC or terminated inside P2SB
+  but all predefined and can't be changed. IO range below 0x100 will be rejected in this function except below ranges:
+    0x00-0x1F,
+    0x44-0x4B,
+    0x54-0x5F,
+    0x68-0x6F,
+    0x80-0x8F,
+    0xC0-0xFF
+  Steps of programming generic IO range:
+  1. Program LPC/eSPI PCI Offset 84h ~ 93h of Mask, Address, and Enable.
+  2. Program LPC/eSPI Generic IO Range in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcGenIoRangeSet (
+  IN  UINT16                            Address,
+  IN  UINTN                             Length
+  );
+
+/**
+  Set PCH LPC/eSPI memory range decoding.
+  This cycle decoding is required to be set on DMI side
+  Programming steps:
+  1. Program LPC PCI Offset 98h [0] to [0] to disable memory decoding first before changing base address.
+  2. Program LPC PCI Offset 98h [31:16, 0] to [Address, 1].
+  3. Program LPC Memory Range in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcMemRangeSet (
+  IN  UINT32                            Address
+  );
+
+/**
+  Set PCH eSPI CS1# memory range decoding.
+  This cycle decoding is required to be set on DMI side
+  Programming steps:
+  1. Program eSPI PCI Offset A8h (eSPI CS1#) [0] to [0] to disable memory decoding first before changing base address.
+  2. Program eSPI PCI Offset A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
+  3. Program eSPI Memory Range in DMI
+
+  @param[in] Address                    Address for memory for decoding.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
+**/
+EFI_STATUS
+PchEspiCs1MemRangeSet (
+  IN  UINT32                            Address
+  );
+
+/**
+  Get PCH LPC/eSPI memory range decoding address.
+
+  @param[out] Address                   Address of LPC/eSPI memory decoding base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
+**/
+EFI_STATUS
+PchLpcMemRangeGet (
+  OUT UINT32                            *Address
+  );
+
+/**
+  Get PCH eSPI CS1# memory range decoding address.
+
+  @param[out] Address                   Address of eSPI CS1# memory decoding base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
+  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
+**/
+EFI_STATUS
+PchEspiCs1MemRangeGet (
+  OUT UINT32                            *Address
+  );
+
+/**
+  Set PCH BIOS range deocding.
+  This will check General Control and Status bit 10 (GCS.BBS) to identify SPI or LPC/eSPI and program BDE register accordingly.
+  Please check EDS for detail of BiosDecodeEnable bit definition.
+    bit 15: F8-FF Enable
+    bit 14: F0-F8 Enable
+    bit 13: E8-EF Enable
+    bit 12: E0-E8 Enable
+    bit 11: D8-DF Enable
+    bit 10: D0-D7 Enable
+    bit  9: C8-CF Enable
+    bit  8: C0-C7 Enable
+    bit  7: Legacy F Segment Enable
+    bit  6: Legacy E Segment Enable
+    bit  5: Reserved
+    bit  4: Reserved
+    bit  3: 70-7F Enable
+    bit  2: 60-6F Enable
+    bit  1: 50-5F Enable
+    bit  0: 40-4F Enable
+  This cycle decoding is allowed to set when DMIC.SRL is 0.
+  Programming steps:
+  1. if GCS.BBS is 0 (SPI), program SPI PCI offset D8h to BiosDecodeEnable.
+     if GCS.BBS is 1 (LPC/eSPi), program LPC/eSPI PCI offset D8h to BiosDecodeEnable.
+  2. program LPC/eSPI/SPI BIOS Decode Enable, PCR[DMI] + 2744h to the same value programmed in LPC/eSPI or SPI PCI Offset D8h.
+
+  @param[in] BiosDecodeEnable           Bios decode enable setting.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+**/
+EFI_STATUS
+PchBiosDecodeEnableSet (
+  IN  UINT16                            BiosDecodeEnable
+  );
+
+/**
+  Set PCH LPC IO decode ranges.
+  Program LPC I/O Decode Ranges, PCR[DMI] + 2770h[15:0] to the same value programmed in LPC offset 80h.
+  Please check EDS for detail of Lpc IO decode ranges bit definition.
+  Bit  12: FDD range
+  Bit 9:8: LPT range
+  Bit 6:4: ComB range
+  Bit 2:0: ComA range
+
+  @param[in] LpcIoDecodeRanges          Lpc IO decode ranges bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcIoDecodeRangesSet (
+  IN  UINT16                            LpcIoDecodeRanges
+  );
+
+/**
+  Set PCH LPC and eSPI CS0# IO enable decoding.
+  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset 82h.
+  Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
+  in LPC/eSPI PCI offset 82h[13:10] is always forwarded by DMI to subtractive agent for handling.
+  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
+
+  @param[in] LpcIoEnableDecoding        LPC IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcIoEnableDecodingSet (
+  IN  UINT16                            LpcIoEnableDecoding
+  );
+
+/**
+  Set PCH eSPI CS1# IO enable decoding.
+  Setup I/O Enables in DMI to the same value program in eSPI PCI offset A0h (eSPI CS1#).
+  Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
+  in eSPI PCI offset A0h[13:10] is always forwarded by DMI to subtractive agent for handling.
+  Please check EDS for detail of eSPI IO decode ranges bit definition.
+
+  @param[in] IoEnableDecoding           eSPI IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMI configuration is locked
+**/
+EFI_STATUS
+PchEspiCs1IoEnableDecodingSet (
+  IN  UINT16                            IoEnableDecoding
+  );
+
+/**
+  Get IO APIC regsiters base address.
+
+  @param[out] IoApicBase                Buffer of IO APIC regsiter address
+
+  @retval EFI_SUCCESS                   Successfully completed.
+**/
+EFI_STATUS
+PchIoApicBaseGet (
+  OUT UINT32                            *IoApicBase
+  );
+
+/**
+  Get HPET base address.
+  This function will be unavailable after P2SB is hidden by PSF.
+
+  @param[out] HpetBase                  Buffer of HPET base address
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid offset passed.
+**/
+EFI_STATUS
+PchHpetBaseGet (
+  OUT UINT32                            *HpetBase
+  );
+
+#endif // _PCH_CYCLE_DECODING_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h
new file mode 100644
index 0000000000..c8aee81a8b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h
@@ -0,0 +1,590 @@
+/** @file
+  Header file for PchInfoLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_INFO_LIB_H_
+#define _PCH_INFO_LIB_H_
+
+#include <Hda.h>
+#include <Uefi/UefiBaseType.h>
+
+typedef UINT8 PCH_STEPPING;
+
+typedef UINT8 PCH_SERIES;
+#define PCH_LP                  2
+
+typedef UINT8 PCH_GENERATION;
+#define TGL_PCH                 5
+
+typedef enum {
+  RstUnsupported  = 0,
+  RstPremium,
+  RstOptane,
+  RstMaxMode
+} RST_MODE;
+
+/**
+  Return Pch stepping type
+
+  @retval PCH_STEPPING            Pch stepping type
+**/
+PCH_STEPPING
+PchStepping (
+  VOID
+  );
+
+/**
+  Return Pch Series
+
+  @retval PCH_SERIES                Pch Series
+**/
+PCH_SERIES
+PchSeries (
+  VOID
+  );
+
+/**
+  Return Pch Generation
+
+  @retval PCH_GENERATION            Pch Generation
+**/
+PCH_GENERATION
+PchGeneration (
+  VOID
+  );
+
+/**
+  Check if this is TGL PCH generation
+
+  @retval TRUE                It's TGL PCH
+  @retval FALSE               It's not TGL PCH
+**/
+BOOLEAN
+IsTglPch (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Pcie Root Port Number
+
+  @retval PcieMaxRootPort         Pch Maximum Pcie Root Port Number
+**/
+UINT8
+GetPchMaxPciePortNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Pcie Controller Number
+
+  @retval Pch Maximum Pcie Controller Number
+**/
+UINT8
+GetPchMaxPcieControllerNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Pcie Clock Number
+
+  @retval Pch Maximum Pcie Clock Number
+**/
+UINT8
+GetPchMaxPcieClockNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Pcie ClockReq Number
+
+  @retval Pch Maximum Pcie ClockReq Number
+**/
+UINT8
+GetPchMaxPcieClockReqNum (
+  VOID
+  );
+
+/**
+  Get Pch Usb2 Maximum Physical Port Number
+
+  @retval Pch Usb2 Maximum Physical Port Number
+**/
+UINT8
+GetPchUsb2MaxPhysicalPortNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Usb2 Port Number of XHCI Controller
+
+  @retval Pch Maximum Usb2 Port Number of XHCI Controller
+**/
+UINT8
+GetPchXhciMaxUsb2PortNum (
+  VOID
+  );
+
+/**
+  Get Pch Usb3 Maximum Physical Port Number
+
+  @retval Pch Usb3 Maximum Physical Port Number
+**/
+UINT8
+GetPchUsb3MaxPhysicalPortNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Usb3 Port Number of XHCI Controller
+
+  @retval Pch Maximum Usb3 Port Number of XHCI Controller
+**/
+UINT8
+GetPchXhciMaxUsb3PortNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Serial IO I2C controllers number
+
+  @retval Pch Maximum Serial IO I2C controllers number
+**/
+UINT8
+GetPchMaxSerialIoI2cControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Serial IO SPI controllers number
+
+  @retval Pch Maximum Serial IO SPI controllers number
+**/
+UINT8
+GetPchMaxSerialIoSpiControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Serial IO UART controllers number
+
+  @retval Pch Maximum Serial IO UART controllers number
+**/
+UINT8
+GetPchMaxSerialIoUartControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Serial IO SPI Chip Selects count
+
+  @retval Pch Maximum Serial IO SPI Chip Selects nu,ber
+**/
+UINT8
+GetPchMaxSerialIoSpiChipSelectsNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH UART Controller number
+
+  @retval Pch Maximum ISH UART controllers number
+**/
+UINT8
+GetPchMaxIshUartControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH I2C Controller number
+
+  @retval Pch Maximum ISH I2C controllers number
+**/
+UINT8
+GetPchMaxIshI2cControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH I3C Controller number
+
+  @retval Pch Maximum ISH I3C controllers number
+**/
+UINT8
+GetPchMaxIshI3cControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH SPI Controller number
+
+  @retval Pch Maximum ISH SPI controllers number
+**/
+UINT8
+GetPchMaxIshSpiControllersNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH SPI Controller Cs pins number
+
+  @retval Pch Maximum ISH SPI controller Cs pins number
+**/
+UINT8
+GetPchMaxIshSpiControllerCsPinsNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ISH GP number
+
+  @retval Pch Maximum ISH GP number
+**/
+UINT8
+GetPchMaxIshGpNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum ME Applet count
+
+  @retval Pch Maximum ME Applet number
+**/
+UINT8
+GetPchMaxMeAppletCount (
+  VOID
+  );
+
+/**
+Get Pch Maximum ME Session count
+
+@retval Pch Maximum ME Sesion number
+**/
+UINT8
+GetPchMaxMeSessionCount(
+  VOID
+);
+
+/**
+  Get Pch Maximum Type C Port Number
+
+  @retval Pch Maximum Type C Port Number
+**/
+UINT8
+GetPchMaxTypeCPortNum (
+  VOID
+  );
+
+#define PCH_STEPPING_STR_LENGTH_MAX 3
+
+/**
+  Get PCH stepping ASCII string.
+  Function determines major and minor stepping versions and writes them into a buffer.
+  The return string is zero terminated
+
+  @param [out]     Buffer               Output buffer of string
+  @param [in]      BufferSize           Buffer size.
+                                        Must not be less then PCH_STEPPING_STR_LENGTH_MAX
+
+  @retval EFI_SUCCESS                   String copied successfully
+  @retval EFI_INVALID_PARAMETER         The stepping is not supported, or parameters are NULL
+  @retval EFI_BUFFER_TOO_SMALL          Input buffer size is too small
+**/
+EFI_STATUS
+PchGetSteppingStr (
+  OUT    CHAR8                          *Buffer,
+  IN     UINT32                         BufferSize
+  );
+
+/**
+  Get PCH series ASCII string.
+  The return string is zero terminated.
+
+  @retval Static ASCII string of PCH Series
+**/
+CHAR8*
+PchGetSeriesStr (
+  );
+
+/**
+  Check if this chipset supports eMMC controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchEmmcSupported (
+  VOID
+  );
+
+/**
+  Check if this chipset supports SD controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchSdCardSupported (
+  VOID
+  );
+
+/**
+  Check if this chipset supports THC controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchThcSupported (
+  VOID
+  );
+
+/**
+  Check if this chipset supports HSIO BIOS Sync
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchChipsetInitSyncSupported (
+  VOID
+  );
+
+/**
+  Gets the maximum number of UFS controller supported by this chipset.
+
+  @return Number of supported UFS controllers
+**/
+UINT8
+PchGetMaxUfsNum (
+  VOID
+  );
+
+/**
+  Check whether integrated LAN controller is supported.
+
+  @retval TRUE                    GbE is supported in PCH
+  @retval FALSE                   GbE is not supported by PCH
+**/
+BOOLEAN
+PchIsGbeSupported (
+  VOID
+  );
+
+/**
+  Check whether integrated TSN is supported.
+
+  @retval TRUE                    TSN is supported in current PCH
+  @retval FALSE                   TSN is not supported on current PCH
+**/
+BOOLEAN
+PchIsTsnSupported (
+  VOID
+  );
+
+/**
+  Check whether ISH is supported.
+
+  @retval TRUE                    ISH is supported in PCH
+  @retval FALSE                   ISH is not supported by PCH
+**/
+BOOLEAN
+PchIsIshSupported (
+  VOID
+  );
+
+/**
+  Check whether ATX Shutdown (PS_ON) is supported.
+
+  @retval    TRUE           ATX Shutdown (PS_ON) is supported in PCH
+  @retval    FALSE          ATX Shutdown (PS_ON) is not supported by PCH
+**/
+BOOLEAN
+IsPchPSOnSupported (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Hda Sndw Link
+
+  @retval Pch Maximum Hda Sndw Link
+**/
+UINT8
+GetPchHdaMaxSndwLinkNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Hda Ssp Link
+
+  @retval Pch Maximum Hda Ssp Link
+**/
+UINT8
+GetPchHdaMaxSspLinkNum (
+  VOID
+  );
+
+/**
+  Get Pch Maximum Hda Dmic Link
+
+  @retval Pch Maximum Hda Dmic Link
+**/
+UINT8
+GetPchHdaMaxDmicLinkNum (
+  VOID
+  );
+
+/**
+  Check if given Audio Interface is supported
+
+  @param[in] AudioLinkType   Link type support to be checked
+  @param[in] AudioLinkIndex  Link number
+
+  @retval    TRUE           Link supported
+  @retval    FALSE          Link not supported
+**/
+BOOLEAN
+IsAudioInterfaceSupported (
+  IN HDAUDIO_LINK_TYPE     AudioLinkType,
+  IN UINT32                AudioLinkIndex
+  );
+
+/**
+  Check if given Display Audio Link T-Mode is supported
+
+  @param[in] Tmode          T-mode support to be checked
+
+  @retval    TRUE           T-mode supported
+  @retval    FALSE          T-mode not supported
+**/
+BOOLEAN
+IsAudioIDispTmodeSupported (
+  IN HDAUDIO_IDISP_TMODE Tmode
+  );
+
+/**
+  Check if link between PCH and CPU is an P-DMI
+
+  @retval    TRUE           P-DMI link
+  @retval    FALSE          Not an P-DMI link
+**/
+BOOLEAN
+IsPchWithPdmi (
+  VOID
+  );
+
+/**
+  Check if link between PCH and CPU is an OP-DMI
+
+  @retval    TRUE           OP-DMI link
+  @retval    FALSE          Not an OP-DMI link
+**/
+BOOLEAN
+IsPchWithOpdmi (
+  VOID
+  );
+
+/**
+  Check if link between PCH and CPU is an F-DMI
+
+  @retval    TRUE           F-DMI link
+  @retval    FALSE          Not an F-DMI link
+**/
+BOOLEAN
+IsPchWithFdmi (
+  VOID
+  );
+
+/**
+  Get Pch Maximum THC count
+
+  @retval Pch Maximum THC count number
+**/
+UINT8
+GetPchMaxThcCount (
+  VOID
+  );
+
+typedef enum {
+  SataSosc125Mhz = 0,
+  SataSosc120Mhz,
+  SataSosc100Mhz,
+  SataSosc25Mhz,
+  SataSosc19p2Mhz,
+  SataSoscUnsupported
+} SATA_SOSC_CLK_FREQ;
+
+/**
+  Returns a frequency of the sosc_clk signal.
+  All SATA controllers on the system are assumed to
+  work on the same sosc_clk frequency.
+
+  @retval Frequency of the sosc_clk signal.
+**/
+SATA_SOSC_CLK_FREQ
+GetSataSoscClkFreq (
+  VOID
+  );
+
+/**
+  Check if SATA support should be awake after function disable
+
+  @retval    TRUE
+  @retval    FALSE
+**/
+BOOLEAN
+IsSataSupportWakeAfterFunctionDisable (
+  VOID
+  );
+
+
+//
+// USB2 PHY reference frequencies values (MHz)
+//
+typedef enum {
+  FREQ_19_2 = 0u,
+  FREQ_24_0,
+  FREQ_96_0,
+  FREQ_MAX
+} USB2_PHY_REF_FREQ;
+
+/**
+  Returns USB2 PHY Reference Clock frequency value used by PCH
+  This defines what electrical tuning parameters shall be used
+  during USB2 PHY initialization programming
+
+  @retval Frequency reference clock for USB2 PHY
+**/
+USB2_PHY_REF_FREQ
+GetUsb2PhyRefFreq (
+  VOID
+  );
+
+/**
+  return support status for P2SB PCR 20-bit addressing
+
+  @retval    TRUE
+  @retval    FALSE
+**/
+BOOLEAN
+IsP2sb20bPcrSupported (
+  VOID
+  );
+
+/**
+  Check if SPI in a given PCH generation supports an Extended BIOS Range Decode
+
+  @retval TRUE or FALSE if PCH supports Extended BIOS Range Decode
+**/
+BOOLEAN
+IsExtendedBiosRangeDecodeSupported (
+  VOID
+  );
+
+/**
+  Returns DMI target for current PCH SPI
+
+  @retval PCH SPI DMI target
+**/
+UINT16
+GetPchSpiDmiTarget (
+  VOID
+  );
+#endif // _PCH_INFO_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
new file mode 100644
index 0000000000..85456653de
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
@@ -0,0 +1,552 @@
+/** @file
+  Header file for PchPciBdfLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCI_BDF_LIB_H_
+#define _PCH_PCI_BDF_LIB_H_
+
+
+/**
+  Get eSPI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval eSPI controller address in PCI Segment Library representation
+**/
+UINT64
+EspiPciCfgBase (
+  VOID
+  );
+
+/**
+  Get GbE controller address that can be passed to the PCI Segment Library functions.
+
+  @retval GbE controller address in PCI Segment Library representation
+**/
+UINT64
+GbePciCfgBase (
+  VOID
+  );
+
+/**
+  Returns Gigabit Ethernet PCI Device Number
+
+  @retval  GbE device number
+**/
+UINT8
+GbeDevNumber (
+  VOID
+  );
+
+/**
+  Returns Gigabit Ethernet PCI Function Number
+
+  @retval  GbE function number
+**/
+UINT8
+GbeFuncNumber (
+  VOID
+  );
+
+/**
+  Get HDA controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HDA controller address in PCI Segment Library representation
+**/
+UINT64
+HdaPciCfgBase (
+  VOID
+  );
+
+/**
+  Get HDA PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+HdaDevNumber (
+  VOID
+  );
+
+/**
+  Get HDA PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+HdaFuncNumber (
+  VOID
+  );
+
+
+/**
+  Get P2SB controller address that can be passed to the PCI Segment Library functions.
+
+  @retval P2SB controller address in PCI Segment Library representation
+**/
+UINT64
+P2sbPciCfgBase (
+  VOID
+  );
+
+/**
+  Get P2SB PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+P2sbDevNumber (
+  VOID
+  );
+
+/**
+  Returns SPI PCI Config Space base address
+
+  @retval  UINT64  SPI Config Space base address
+**/
+UINT64
+SpiPciCfgBase (
+  VOID
+  );
+
+/**
+  Returns SPI Device number
+
+  @retval UINT8   PCH SPI Device number
+**/
+UINT8
+SpiDevNumber (
+  VOID
+  );
+
+/**
+  Returns SPI Function number
+
+  @retval UINT8   PCH SPI Function number
+**/
+UINT8
+SpiFuncNumber (
+  VOID
+  );
+
+/**
+  Get XHCI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval XHCI controller address in PCI Segment Library representation
+**/
+UINT64
+PchXhciPciCfgBase (
+  VOID
+  );
+
+/**
+  Get XHCI controller PCIe Device Number
+
+  @retval XHCI controller PCIe Device Number
+**/
+UINT8
+PchXhciDevNumber (
+  VOID
+  );
+
+/**
+  Get XHCI controller PCIe Function Number
+
+  @retval XHCI controller PCIe Function Number
+**/
+UINT8
+PchXhciFuncNumber (
+  VOID
+  );
+
+/**
+  Get XDCI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval XDCI controller address in PCI Segment Library representation
+**/
+UINT64
+PchXdciPciCfgBase (
+  VOID
+  );
+
+/**
+  Get XDCI controller PCIe Device Number
+
+  @retval XDCI controller PCIe Device Number
+**/
+UINT8
+PchXdciDevNumber (
+  VOID
+  );
+
+/**
+  Get XDCI controller PCIe Function Number
+
+  @retval XDCI controller PCIe Function Number
+**/
+UINT8
+PchXdciFuncNumber (
+  VOID
+  );
+
+/**
+  Get SMBUS controller address that can be passed to the PCI Segment Library functions.
+
+  @retval SMBUS controller address in PCI Segment Library representation
+**/
+UINT64
+SmbusPciCfgBase (
+  VOID
+  );
+
+/**
+  Return DMA Smbus Device Number
+
+  @retval DMA Smbus Device Number
+**/
+UINT8
+SmbusDmaDevNumber (
+  VOID
+  );
+
+/**
+  Return DMA Smbus Function Number
+
+  @retval  DMA Smbus Function Number
+**/
+UINT8
+SmbusDmaFuncNumber (
+  VOID
+  );
+
+/**
+  Get DMA SMBUS controller address that can be passed to the PCI Segment Library functions.
+
+  @retval DMA SMBUS controller address in PCI Segment Library representation
+**/
+UINT64
+SmbusDmaPciCfgBase (
+  VOID
+  );
+
+/**
+  Return Smbus Device Number
+
+  @retval Smbus Device Number
+**/
+UINT8
+SmbusDevNumber (
+  VOID
+  );
+
+/**
+  Return Smbus Function Number
+
+  @retval  Smbus Function Number
+**/
+UINT8
+SmbusFuncNumber (
+  VOID
+  );
+
+/**
+  Gets SATA controller PCIe config space base address
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller PCIe config space base address
+**/
+UINT64
+SataPciCfgBase (
+  IN UINT32 SataCtrlIndex
+  );
+
+/**
+  Gets SATA controller PCIe Device Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller PCIe Device Number
+**/
+UINT8
+SataDevNumber (
+  IN UINT32 SataCtrlIndex
+  );
+
+/**
+  Gets SATA controller PCIe Function Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller PCIe Function Number
+**/
+UINT8
+SataFuncNumber (
+  IN UINT32 SataCtrlIndex
+  );
+
+/**
+  Returns PCH LPC device PCI base address.
+
+  @retval                   PCH LPC PCI base address.
+**/
+UINT64
+LpcPciCfgBase (
+  VOID
+  );
+
+/**
+  Get LPC controller PCIe Device Number
+
+  @retval LPC controller PCIe Device Number
+**/
+UINT8
+LpcDevNumber (
+  VOID
+  );
+
+/**
+  Get Thermal Device PCIe Device Number
+
+  @retval Thermal Device PCIe Device Number
+**/
+UINT8
+ThermalDevNumber (
+  VOID
+  );
+
+/**
+  Get Thermal Device PCIe Function Number
+
+  @retval Thermal Device PCIe Function Number
+**/
+UINT8
+ThermalFuncNumber (
+  VOID
+  );
+
+/**
+  Returns Thermal Device PCI base address.
+
+  @retval                   Thermal Device PCI base address.
+**/
+UINT64
+ThermalPciCfgBase (
+  VOID
+  );
+
+/**
+  Get LPC controller PCIe Function Number
+
+  @retval LPC controller PCIe Function Number
+**/
+UINT8
+LpcFuncNumber (
+  VOID
+  );
+
+/**
+  Get Serial IO I2C controller PCIe Device Number
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller PCIe Device Number
+**/
+UINT8
+SerialIoI2cDevNumber (
+  IN UINT8       I2cNumber
+  );
+
+/**
+  Get Serial IO I2C controller PCIe Function Number
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller PCIe Function Number
+**/
+UINT8
+SerialIoI2cFuncNumber (
+  IN UINT8       I2cNumber
+  );
+
+/**
+  Get Serial IO I2C controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoI2cPciCfgBase (
+  IN UINT8        I2cNumber
+  );
+
+/**
+  Get Serial IO SPI controller PCIe Device Number
+
+  @param[in]  I2cNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller PCIe Device Number
+**/
+UINT8
+SerialIoSpiDevNumber (
+  IN UINT8       SpiNumber
+  );
+
+/**
+  Get Serial IO SPI controller PCIe Function Number
+
+  @param[in]  SpiNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller PCIe Function Number
+**/
+UINT8
+SerialIoSpiFuncNumber (
+  IN UINT8       SpiNumber
+  );
+
+/**
+  Get Serial IO SPI controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  SpiNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoSpiPciCfgBase (
+  IN UINT8        SpiNumber
+  );
+
+/**
+  Get Serial IO UART controller PCIe Device Number
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller PCIe Device Number
+**/
+UINT8
+SerialIoUartDevNumber (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Get Serial IO UART controller PCIe Function Number
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller PCIe Function Number
+**/
+UINT8
+SerialIoUartFuncNumber (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Get Serial IO UART controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoUartPciCfgBase (
+  IN UINT8        UartNumber
+  );
+
+/**
+  Get PCH PCIe controller PCIe Device Number
+
+  @param[in]  RpIndex       Root port physical number. (0-based)
+
+  @retval PCH PCIe controller PCIe Device Number
+**/
+UINT8
+PchPcieRpDevNumber (
+  IN  UINTN   RpIndex
+  );
+
+/**
+  Get PCH PCIe controller PCIe Function Number
+
+  @param[in]  RpIndex       Root port physical number. (0-based)
+
+  @retval PCH PCIe controller PCIe Function Number
+**/
+UINT8
+PchPcieRpFuncNumber (
+  IN  UINTN   RpIndex
+  );
+
+/**
+  Get PCH PCIe controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  RpIndex       PCH PCIe Root Port physical number. (0-based)
+
+  @retval PCH PCIe controller address in PCI Segment Library representation
+**/
+UINT64
+PchPcieRpPciCfgBase (
+  IN  UINT32   RpIndex
+  );
+
+/**
+  Get HECI1 PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+PchHeci1DevNumber (
+  VOID
+  );
+
+/**
+  Get HECI1 PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+PchHeci1FuncNumber (
+  VOID
+  );
+
+/**
+  Get HECI1 controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HECI1 controller address in PCI Segment Library representation
+**/
+UINT64
+PchHeci1PciCfgBase (
+  VOID
+  );
+
+/**
+  Get HECI3 PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+PchHeci3DevNumber (
+  VOID
+  );
+
+/**
+  Get HECI3 PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+PchHeci3FuncNumber (
+  VOID
+  );
+
+/**
+  Get HECI3 controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HECI3 controller address in PCI Segment Library representation
+**/
+UINT64
+PchHeci3PciCfgBase (
+  VOID
+  );
+
+#endif //_PCH_PCI_BDF_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h
new file mode 100644
index 0000000000..845bb19a65
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h
@@ -0,0 +1,70 @@
+/** @file
+  This file contains definitions of PCH Info HOB.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_INFO_HOB_H_
+#define _PCH_INFO_HOB_H_
+
+extern EFI_GUID gPchInfoHobGuid;
+
+#define PCH_INFO_HOB_REVISION  4
+
+#pragma pack (push,1)
+/**
+  This structure is used to provide the information of PCH controller.
+
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Add CridSupport, CridOrgRid, and CridNewRid.
+  <b>Revision 3</b>:
+  - Add Thc0Strap.
+  <b>Revision 4</b>
+  - Removed GbePciePortNumber
+**/
+typedef struct {
+  /**
+    This member specifies the revision of the PCH Info HOB. This field is used
+    to indicate backwards compatible changes to the protocol. Platform code that
+    consumes this protocol must read the correct revision value to correctly interpret
+    the content of the protocol fields.
+  **/
+  UINT8        Revision;
+  UINT8        PcieControllerCfg[6];
+  /**
+    THC strap disable/enable status
+  **/
+  UINT8       Thc0Strap;
+  UINT32       PciePortFuses;
+  /**
+    Bit map for PCIe Root Port Lane setting. If bit is set it means that
+    corresponding Root Port has its lane enabled.
+    BIT0 - RP0, BIT1 - RP1, ...
+    This information needs to be passed through HOB as FIA registers
+    are not accessible with POSTBOOT_SAI
+  **/
+  UINT32       PciePortLaneEnabled;
+  /**
+    Publish Hpet BDF and IoApic BDF information for VTD.
+  **/
+  UINT32       HpetBusNum    :  8;
+  UINT32       HpetDevNum    :  5;
+  UINT32       HpetFuncNum   :  3;
+  UINT32       IoApicBusNum  :  8;
+  UINT32       IoApicDevNum  :  5;
+  UINT32       IoApicFuncNum :  3;
+  /**
+    Publish the CRID information.
+  **/
+  UINT32       CridOrgRid    :  8;
+  UINT32       CridNewRid    :  8;
+  UINT32       CridSupport   :  1;
+  UINT32       Rsvdbits      : 15;
+} PCH_INFO_HOB;
+
+#pragma pack (pop)
+
+#endif // _PCH_INFO_HOB_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h
new file mode 100644
index 0000000000..04ad17c8bd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h
@@ -0,0 +1,67 @@
+/** @file
+  Build time limits of PCH resources.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_LIMITS_H_
+#define _PCH_LIMITS_H_
+/*
+ * Defines povided in this file are indended to be used only where static value
+ * is needed. They are set to values which allow to accomodate multiple projects
+ * needs. Where runtime usage is possible please used dedicated functions from
+ * PchInfoLib to retrieve accurate values
+ */
+
+//
+// PCIe limits
+//
+#define PCH_MAX_PCIE_ROOT_PORTS             24
+#define PCH_MAX_PCIE_CONTROLLERS            6
+
+//
+// PCIe clocks limits
+//
+#define PCH_MAX_PCIE_CLOCKS                 16
+
+//
+// RST PCIe Storage Cycle Router limits
+//
+#define PCH_MAX_RST_PCIE_STORAGE_CR         3
+
+//
+// SATA limits
+//
+#define PCH_MAX_SATA_CONTROLLERS            3
+#define PCH_MAX_SATA_PORTS                  8
+
+//
+// SerialIo limits
+//
+#define PCH_MAX_SERIALIO_I2C_CONTROLLERS      8
+#define PCH_MAX_SERIALIO_SPI_CONTROLLERS      7
+#define PCH_MAX_SERIALIO_SPI_CHIP_SELECTS     2
+#define PCH_MAX_SERIALIO_UART_CONTROLLERS     7
+
+//
+// ISH limits
+//
+#define PCH_MAX_ISH_GP_PINS                   8
+#define PCH_MAX_ISH_UART_CONTROLLERS          2
+#define PCH_MAX_ISH_I2C_CONTROLLERS           3
+#define PCH_MAX_ISH_SPI_CONTROLLERS           1
+#define PCH_MAX_ISH_SPI_CS_PINS               1
+//
+// HDA limits
+//
+#define PCH_MAX_HDA_SDI                       2
+#define PCH_MAX_HDA_SSP_LINK_NUM              6
+#define PCH_MAX_HDA_SNDW_LINK_NUM             4
+
+//
+// Number of eSPI slaves
+//
+#define PCH_MAX_ESPI_SLAVES                  2
+
+#endif // _PCH_LIMITS_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
new file mode 100644
index 0000000000..7b749818fa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
@@ -0,0 +1,55 @@
+/** @file
+  PCH configuration based on PCH policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_POLICY_COMMON_H_
+#define _PCH_POLICY_COMMON_H_
+
+#include <ConfigBlock.h>
+#include <UsbConfig.h>
+#include <Usb2PhyConfig.h>
+#include <Usb3HsioConfig.h>
+
+#include "PchLimits.h"
+#include "ConfigBlock/PchGeneralConfig.h"
+#include <PchPcieRpConfig.h>
+#include <IoApicConfig.h>
+#include <SataConfig.h>
+#include <RstConfig.h>
+#include <PchDmiConfig.h>
+#include "ConfigBlock/FlashProtectionConfig.h"
+#include <InterruptConfig.h>
+#include <HdAudioConfig.h>
+#include <IshConfig.h>
+#include <GbeConfig.h>
+#include "ConfigBlock/LockDownConfig.h"
+#include "P2sbConfig.h"
+#include <PmConfig.h>
+#include <ScsConfig.h>
+#include <SerialIoConfig.h>
+#include <ThcConfig.h>
+#include <ThermalConfig.h>
+#include <EspiConfig.h>
+#include <CnviConfig.h>
+#include <IehConfig.h>
+#include <PsfConfig.h>
+#include <FivrConfig.h>
+#include <AdrConfig.h>
+#include <RtcConfig.h>
+#include <HybridStorageConfig.h>
+#include <SpiConfig.h>
+
+#ifndef FORCE_ENABLE
+#define FORCE_ENABLE  1
+#endif
+#ifndef FORCE_DISABLE
+#define FORCE_DISABLE 2
+#endif
+#ifndef PLATFORM_POR
+#define PLATFORM_POR  0
+#endif
+
+
+#endif // _PCH_POLICY_COMMON_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h
new file mode 100644
index 0000000000..25e99d3a68
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h
@@ -0,0 +1,56 @@
+/** @file
+  PCH configuration based on PCH policy
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PREMEM_POLICY_COMMON_H_
+#define _PCH_PREMEM_POLICY_COMMON_H_
+
+#include <ConfigBlock.h>
+
+#include "PchLimits.h"
+#include "ConfigBlock/PchGeneralConfig.h"
+#include <DciConfig.h>
+#include <WatchDogConfig.h>
+#include <SmbusConfig.h>
+#include "ConfigBlock/LpcConfig.h"
+#include "ConfigBlock/HsioPcieConfig.h"
+#include "ConfigBlock/HsioSataConfig.h"
+#include "ConfigBlock/HsioConfig.h"
+
+#pragma pack (push,1)
+
+#ifndef FORCE_ENABLE
+#define FORCE_ENABLE  1
+#endif
+#ifndef FORCE_DISABLE
+#define FORCE_DISABLE 2
+#endif
+#ifndef PLATFORM_POR
+#define PLATFORM_POR  0
+#endif
+
+/**
+  PCH Policy revision number
+  Any backwards compatible changes to this structure will result in an update in the revision number
+**/
+#define PCH_PREMEM_POLICY_REVISION  1
+
+/**
+  PCH Policy PPI\n
+  All PCH config block change history will be listed here\n\n
+
+  - <b>Revision 1</b>:
+    - Initial version.\n
+**/
+typedef struct _PCH_PREMEM_POLICY {
+  CONFIG_BLOCK_TABLE_HEADER      TableHeader;
+/*
+  Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+*/
+} PCH_PREMEM_POLICY;
+
+#pragma pack (pop)
+
+#endif // _PCH_PREMEM_POLICY_COMMON_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
new file mode 100644
index 0000000000..4573a11520
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
@@ -0,0 +1,21 @@
+/** @file
+  PCH Reset Platform Specific definitions.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_RESET_PLATFORM_SPECIFIC_H_
+#define _PCH_RESET_PLATFORM_SPECIFIC_H_
+
+#define PCH_PLATFORM_SPECIFIC_RESET_STRING   L"PCH_RESET"
+#define PCH_RESET_DATA_STRING_MAX_LENGTH     (sizeof (PCH_PLATFORM_SPECIFIC_RESET_STRING) / sizeof (UINT16))
+
+extern EFI_GUID gPchGlobalResetGuid;
+
+typedef struct _RESET_DATA {
+  CHAR16   Description[PCH_RESET_DATA_STRING_MAX_LENGTH];
+  EFI_GUID Guid;
+} PCH_RESET_DATA;
+
+#endif // _PCH_RESET_PLATFORM_SPECIFIC_H_
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
new file mode 100644
index 0000000000..4d6241c32b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
@@ -0,0 +1,184 @@
+/** @file
+  PCH IO TrapEx Dispatch Protocol
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IO_TRAP_EX_DISPATCH_H_
+#define _IO_TRAP_EX_DISPATCH_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                                       gIoTrapExDispatchProtocolGuid;
+
+typedef struct _IO_TRAP_EX_DISPATCH_PROTOCOL          IO_TRAP_EX_DISPATCH_PROTOCOL;
+
+/**
+  IO Trap Ex valid types
+**/
+typedef enum {
+  IoTrapExTypeWrite,
+  IoTrapExTypeRead,
+  IoTrapExTypeReadWrite,
+  IoTrapExTypeMaximum
+} IO_TRAP_EX_DISPATCH_TYPE;
+
+/**
+  IO Trap Ex context structure containing information about the
+  IO trap Ex event that should invoke the handler.
+  ByteEnableMask bitwise to ignore the ByteEnable setting. E.g. 1111b for any byte access.
+
+  Here are some examples for the usage.
+  1.  To trigger the TRAP for the IO address from 0x2000 to 0x20FF with BYTE/WORD/DWORD read/write access:
+      Address        = 0x2000
+      Length         = 0x100
+      Type           = IoTrapExTypeReadWrite
+      ByteEnable     = 0x00 (BE is not matter)
+      ByteEnableMask = 0x0F (BEM 0xF for any BYTE/WORD/DWORD access)
+  2.  To trigger the TRAP for port 0x61 with BYTE read access:
+      Address        = 0x60
+      Length         = 4
+      Type           = IoTrapExTypeRead
+      ByteEnable     = 0x02 (BE is 0010b to trap only second byte of every DWORD)
+      ByteEnableMask = 0x00 (BEM doesn't mask any BE bit)
+  3.  To trigger the TRAP for port 0x60 and 0x64 with BYTE write access:
+      Address        = 0x60
+      Length         = 8
+      Type           = IoTrapExTypeWrite
+      ByteEnable     = 0x01 (BE is 0001b to trap only first byte of every DWORD)
+      ByteEnableMask = 0x00 (BEM doesn't mask any BE bit)
+**/
+typedef struct {
+  /**
+    The Address must be dword alignment.
+  **/
+  UINT16                                Address;
+  UINT16                                Length;
+  IO_TRAP_EX_DISPATCH_TYPE              Type;
+  /**
+    Bitmap to enable trap for each byte of every dword alignment address.
+    The Io Trap Address must be dword alignment for ByteEnable.
+    E.g. 0001b for first byte, 0010b for second byte, 1100b for third and fourth byte.
+  **/
+  UINT8                                 ByteEnable;
+  /**
+    ByteEnableMask bitwise to ignore the ByteEnable setting. E.g. 1111b for any byte access.
+    The Io Trap Address must be dword alignment for ByteEnableMask.
+  **/
+  UINT8                                 ByteEnableMask;
+} IO_TRAP_EX_REGISTER_CONTEXT;
+
+/**
+  Callback function for an PCH IO TRAP EX handler dispatch.
+
+  @param[in] Address                    DWord-aligned address of the trapped cycle.
+  @param[in] ByteEnable                 This is the DWord-aligned byte enables associated with the trapped cycle.
+                                        A 1 in any bit location indicates that the corresponding byte is enabled in the cycle.
+  @param[in] WriteCycle                 TRUE = Write cycle; FALSE = Read cycle
+  @param[in] WriteData                  DWord of I/O write data. This field is undefined after trapping a read cycle.
+                                        The byte of WriteData is only valid if the corresponding bits in ByteEnable is 1.
+                                        E.g.
+                                        If ByteEnable is 0001b, then only first byte of WriteData is valid.
+                                        If ByteEnable is 0010b, then only second byte of WriteData is valid.
+**/
+typedef
+VOID
+(EFIAPI *IO_TRAP_EX_DISPATCH_CALLBACK) (
+  IN UINT16                             Address,
+  IN UINT8                              ByteEnable,
+  IN BOOLEAN                            WriteCycle,
+  IN UINT32                             WriteData
+  );
+
+/**
+  Register a new IO Trap Ex SMI dispatch function.
+  The caller will provide information of IO trap setting via the context.
+  Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
+  This is the function to extend the IoTrap capability, and it's expected
+  to handle the special ByteEnable and ByteEnableMask setting.
+  This register function will occupy one IoTrap register if possible.
+  And it only support one handler for one IoTrap event.
+  The Address of context MUST NOT be 0, and MUST be dword alignment.
+  The Length of context MUST not less than 4, and MUST be power of 2.
+  The ByteEnable and ByteEnableMask MUST not be zero at the same time.
+  if the IO Trap handler is not used. It also enable the IO Trap Range to generate
+  SMI.
+  Caller must take care of reserving the IO addresses in ACPI.
+
+  @param[in] This                 Pointer to the IO_TRAP_EX_DISPATCH_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for
+                                  this SMI source.
+  @param[in] RegisterContext      Pointer to the dispatch function's context.
+                                  The caller fills this context in before calling
+                                  the register function to indicate to the register
+                                  function the IO trap Ex SMI source for which the dispatch
+                                  function should be invoked.  This MUST not be NULL.
+  @param[out] DispatchHandle      Handle of dispatch function.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
+  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *IO_TRAP_EX_DISPATCH_REGISTER) (
+  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
+  IN  IO_TRAP_EX_DISPATCH_CALLBACK  DispatchFunction,
+  IN  IO_TRAP_EX_REGISTER_CONTEXT   *RegisterContext,
+  OUT EFI_HANDLE                    *DispatchHandle
+  );
+
+/**
+  Unregister a SMI source dispatch function.
+  This function is unsupported.
+
+  @param[in] This                 Pointer to the IO_TRAP_EX_DISPATCH_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_UNSUPPORTED         The function is unsupported.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *IO_TRAP_EX_DISPATCH_UNREGISTER) (
+  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
+  IN  EFI_HANDLE                    DispatchHandle
+  );
+
+/**
+  Interface structure for the IO trap Extention protocol.
+  This protocol exposes full IO TRAP capability for ByteEnable and ByteEnableMask setting.
+  Platform code should fully control the ByteEnable and ByteEnableMake while using this protocol.
+
+  Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
+  This is the function to extend the IoTrap capability, and it's expected
+  to handle the special ByteEnable and ByteEnableMask setting.
+
+  The protocol is low level, It returns PSTH trapped cycle. This might not be safe for multithread
+  if more than one thread triggers the same IOTRAP at the same time.
+**/
+struct _IO_TRAP_EX_DISPATCH_PROTOCOL {
+  /**
+    Register function for PCH IO TRAP EX DISPATCH PROTOCOL.
+    The caller will provide information of IO trap setting via the context.
+    Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
+    This is the function to extend the IoTrap capability, and it's expected
+    to handle the special ByteEnable and ByteEnableMask setting.
+    This register function will occupy one IoTrap register if possible.
+    And it only support one handler for one IoTrap event.
+    The Address of context MUST NOT be 0, and MUST be dword alignment.
+    The Length of context MUST not less than 4, and MUST be power of 2.
+    The ByteEnable and ByteEnableMask MUST not be zero at the same time.
+    if the IO Trap handler is not used. It also enable the IO Trap Range to
+    generate SMI.
+  **/
+  IO_TRAP_EX_DISPATCH_REGISTER      Register;
+  /**
+    Unregister function for PCH IO TRAP EX DISPATCH PROTOCOL.
+  **/
+  IO_TRAP_EX_DISPATCH_UNREGISTER    UnRegister;
+};
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch.h
new file mode 100644
index 0000000000..136734d9ff
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch.h
@@ -0,0 +1,134 @@
+/** @file
+  APIs of PCH ACPI SMI Dispatch Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_ACPI_SMI_DISPATCH_PROTOCOL_H_
+#define _PCH_ACPI_SMI_DISPATCH_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                         gPchAcpiSmiDispatchProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_ACPI_SMI_DISPATCH_PROTOCOL    PCH_ACPI_SMI_DISPATCH_PROTOCOL;
+
+//
+// Member functions
+//
+
+/**
+  Callback function for an PCH ACPI SMI handler dispatch.
+
+  @param[in] DispatchHandle             The unique handle assigned to this handler by register function.
+
+**/
+typedef
+VOID
+(EFIAPI *PCH_ACPI_SMI_DISPATCH_CALLBACK) (
+  IN EFI_HANDLE                         DispatchHandle
+  );
+
+/**
+  Register a child SMI source dispatch function for PCH ACPI SMI events.
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchFunction           Pointer to dispatch function to be invoked for
+                                        this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function, for when interfacing
+                                        with the parent SMM driver.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR              The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or SMM) to manage this child.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_ACPI_SMI_DISPATCH_REGISTER) (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent ACPI SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_ACPI_SMI_DISPATCH_UNREGISTER) (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  Interface structure for PCH ACPI SMIs Dispatch Protocol
+  The PCH ACPI SMI DISPATCH PROTOCOL provides the ability to dispatch function for PCH ACPI related SMIs.
+  It contains SMI types of Pme, RtcAlarm, PmeB0, and Time overflow.
+**/
+struct _PCH_ACPI_SMI_DISPATCH_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                                 Revision;
+  /**
+    Smi unregister function for PCH ACPI SMI DISPATCH PROTOCOL.
+  **/
+  PCH_ACPI_SMI_DISPATCH_UNREGISTER      UnRegister;
+  /**
+    Pme
+    The event is triggered by hardware when the PME# signal goes active.
+    Additionally, the event is only triggered when SCI_EN is not set.
+  **/
+  PCH_ACPI_SMI_DISPATCH_REGISTER        PmeRegister;
+  /**
+    PmeB0
+    The event is triggered PCH when any internal device with PCI Power Management
+    capabilities on bus 0 asserts the equivalent of the PME# signal.
+    Additionally, the event is only triggered when SCI_EN is not set.
+    The following are internal devices which can set this bit:
+    Intel HD Audio, Intel Management Engine "maskable" wake events, Integrated LAN,
+    SATA, xHCI, Intel SST
+  **/
+  PCH_ACPI_SMI_DISPATCH_REGISTER        PmeB0Register;
+  /**
+    RtcAlarm
+    The event is triggered by hardware when the RTC generates an alarm
+    (assertion of the IRQ8# signal).
+  **/
+  PCH_ACPI_SMI_DISPATCH_REGISTER        RtcAlarmRegister;
+  /**
+    TmrOverflow
+    The event is triggered any time bit 22 of the 24-bit timer goes high
+    (bits are numbered from 0 to 23).
+    This will occur every 2.3435 seconds. When the TMROF_EN bit (ABASE + 02h, bit 0) is set,
+    then the setting of the TMROF_STS bit will additionally generate an SMI#
+    Additionally, the event is only triggered when SCI_EN is not set.
+  **/
+  PCH_ACPI_SMI_DISPATCH_REGISTER        TmrOverflowRegister;
+};
+
+/**
+  PCH ACPI SMI dispatch revision number
+
+  Revision 1:   Initial version
+**/
+#define PCH_ACPI_SMI_DISPATCH_REVISION            1
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch.h
new file mode 100644
index 0000000000..4ea48c3fcd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch.h
@@ -0,0 +1,144 @@
+/** @file
+  SmmEspiDispatch Protocol
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_ESPI_SMI_DISPATCH_PROTOCOL_H_
+#define _PCH_ESPI_SMI_DISPATCH_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID gPchEspiSmiDispatchProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_ESPI_SMI_DISPATCH_PROTOCOL PCH_ESPI_SMI_DISPATCH_PROTOCOL;
+
+//
+// Member functions
+//
+
+/**
+  Callback function for an PCH eSPI SMI handler dispatch.
+
+  @param[in] DispatchHandle             The unique handle assigned to this handler by register function.
+**/
+typedef
+VOID
+(EFIAPI *PCH_ESPI_SMI_DISPATCH_CALLBACK) (
+  IN EFI_HANDLE DispatchHandle
+  );
+
+/**
+  Generic function to register different types of eSPI SMI types
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration successful
+  @retval     EFI_ACCESS_DENIED Return access denied if the EndOfDxe event has been triggered
+  @retval     others            Registration failed
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_ESPI_SMI_REGISTER) (
+  IN PCH_ESPI_SMI_DISPATCH_PROTOCOL *This,
+  IN PCH_ESPI_SMI_DISPATCH_CALLBACK DispatchFunction,
+  OUT EFI_HANDLE                    *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to unregister a callback based on handle
+
+  @param[in]  This                    Not used
+  @param[in]  DispatchHandle          Handle acquired during registration
+
+  @retval     EFI_SUCCESS             Unregister successful
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has bad pointer
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in database
+  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
+**/
+
+typedef
+EFI_STATUS
+(EFIAPI *PCH_ESPI_SMI_UNREGISTER) (
+  IN PCH_ESPI_SMI_DISPATCH_PROTOCOL *This,
+  IN EFI_HANDLE                     DispatchHandle
+  );
+
+/**
+  Interface structure for PCH eSPI SMIs Dispatch Protocol
+  The PCH ESPI SMI DISPATCH PROTOCOL provides the ability to dispatch function for PCH eSPI related SMIs.
+  It contains SMI types of BiosWr, EcAssertedVw, and eSPI Master asserted SMIs
+**/
+struct _PCH_ESPI_SMI_DISPATCH_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                   Revision;
+  /**
+    Unregister eSPI SMI events
+  **/
+  PCH_ESPI_SMI_UNREGISTER UnRegister;
+  /**
+    Register a BIOS Write Protect event
+  **/
+  PCH_ESPI_SMI_REGISTER   BiosWrProtectRegister;
+  /**
+    Register a BIOS Write Report event
+  **/
+  PCH_ESPI_SMI_REGISTER   BiosWrReportRegister;
+  /**
+    Register a Peripheral Channel Non Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   PcErrNonFatalRegister;
+  /**
+    Register a Peripheral Channel Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   PcErrFatalRegister;
+  /**
+    Register a Virtual Wire Non Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   VwErrNonFatalRegister;
+  /**
+    Register a Virtual Wire Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   VwErrFatalRegister;
+  /**
+    Register a Flash Channel Non Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   FlashErrNonFatalRegister;
+  /**
+    Register a Flash Channel Fatal Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   FlashErrFatalRegister;
+  /**
+    Register a Link Error event
+  **/
+  PCH_ESPI_SMI_REGISTER   LnkErrType1Register;
+  /**
+    Register a SMI handler for Espi slaver
+    This routine will also lock down ESPI_SMI_LOCK bit after registration and prevent
+    this handler from unregistration.
+    On platform that supports more than 1 device through another chip select (SPT-H),
+    the SMI handler itself needs to inspect both the eSPI devices' interrupt status registers
+    (implementation specific for each Slave) in order to identify and service the cause.
+    After servicing it, it has to clear the Slaves' internal SMI# status registers
+  **/
+  PCH_ESPI_SMI_REGISTER   EspiSlaveSmiRegister;
+};
+
+/**
+  PCH ESPI SMI dispatch revision number
+
+  Revision 1:   Initial version
+**/
+#define PCH_ESPI_SMI_DISPATCH_REVISION            1
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch.h
new file mode 100644
index 0000000000..b75b9ab45d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch.h
@@ -0,0 +1,166 @@
+/** @file
+  APIs of PCH PCIE SMI Dispatch Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCIE_SMI_DISPATCH_PROTOCOL_H_
+#define _PCH_PCIE_SMI_DISPATCH_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                         gPchPcieSmiDispatchProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_PCIE_SMI_DISPATCH_PROTOCOL    PCH_PCIE_SMI_DISPATCH_PROTOCOL;
+
+typedef enum {
+  PchRpIndex0      = 0,
+  PchRpIndex1      = 1,
+  PchRpIndex2      = 2,
+  PchRpIndex3      = 3,
+  PchRpIndex4      = 4,
+  PchRpIndex5      = 5,
+  PchRpIndex6      = 6,
+  PchRpIndex7      = 7,
+  PchRpIndex8      = 8,
+  PchRpIndex9      = 9,
+  PchRpIndex10     = 10,
+  PchRpIndex11     = 11,
+  PchRpIndex12     = 12,
+  PchRpIndex13     = 13,
+  PchRpIndex14     = 14,
+  PchRpIndex15     = 15,
+  PchRpIndex16     = 16,
+  PchRpIndex17     = 17,
+  PchRpIndex18     = 18,
+  PchRpIndex19     = 19,
+  PchRpIndex20     = 20,
+  PchRpIndex21     = 21,
+  PchRpIndex22     = 22,
+  PchRpIndex23     = 23,
+  /**
+    Quantity of PCH and CPU PCIe ports, as well as their encoding in this enum, may change between
+    silicon generations and series. Do not assume that PCH port 0 will be always encoded by 0.
+    Instead, it is recommended to use (PchRpIndex0 + PchPortIndex) style to be forward-compatible
+  **/
+  CpuRpIndex0      = 0x40,
+  CpuRpIndex1      = 0x41,
+  CpuRpIndex2      = 0x42,
+  CpuRpIndex3      = 0x43
+} PCIE_COMBINED_RPINDEX;
+
+//
+// Member functions
+//
+
+typedef struct {
+  UINT8                                 RpIndex; ///< Root port index (0-based), 0: RP1, 1: RP2, n: RP(N+1)
+  UINT8                                 BusNum;  ///< Root port pci bus number
+  UINT8                                 DevNum;  ///< Root port pci device number
+  UINT8                                 FuncNum; ///< Root port pci function number
+} PCH_PCIE_SMI_RP_CONTEXT;
+
+/**
+  Callback function for an PCH PCIE RP SMI handler dispatch.
+
+  @param[in] DispatchHandle             The unique handle assigned to this handler by register function.
+  @param[in] RpContext                  Pointer of PCH PCIE Root Port context.
+
+**/
+typedef
+VOID
+(EFIAPI *PCH_PCIE_SMI_RP_DISPATCH_CALLBACK) (
+  IN EFI_HANDLE                         DispatchHandle,
+  IN PCH_PCIE_SMI_RP_CONTEXT            *RpContext
+  );
+
+/**
+  Register a child SMI source dispatch function for PCH PCIERP SMI events.
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchFunction           Pointer to dispatch function to be invoked for
+                                        this SMI source
+  @param[in] RpIndex                    Refer PCIE_COMBINED_RPINDEX for PCH RP index and CPU RP index.
+                                        0: RP1, 1: RP2, n: RP(N+1)
+  @param[out] DispatchHandle            Handle of dispatch function, for when interfacing
+                                        with the parent SMM driver.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR              The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or SMM) to manage this child.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_PCIE_SMI_RP_DISPATCH_REGISTER) (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
+  IN  UINTN                             RpIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent PCIE SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_PCIE_SMI_DISPATCH_UNREGISTER) (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  Interface structure for PCH PCIE SMIs Dispatch Protocol
+  The PCH PCIE SMI DISPATCH PROTOCOL provides the ability to dispatch function for PCH PCIE related SMIs.
+  It contains SMI types of HotPlug, LinkActive, and Link EQ.
+**/
+struct _PCH_PCIE_SMI_DISPATCH_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                                 Revision;
+  /**
+    Smi unregister function for PCH PCIE SMI DISPATCH PROTOCOL.
+  **/
+  PCH_PCIE_SMI_DISPATCH_UNREGISTER      UnRegister;
+  /**
+    PcieRpXHotPlug
+    The event is triggered when PCIE root port Hot-Plug Presence Detect.
+  **/
+  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     HotPlugRegister;
+  /**
+    PcieRpXLinkActive
+    The event is triggered when Hot-Plug Link Active State Changed.
+  **/
+  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     LinkActiveRegister;
+  /**
+    PcieRpXLinkEq
+    The event is triggered when Device Requests Software Link Equalization.
+  **/
+  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     LinkEqRegister;
+};
+
+/**
+  PCH PCIE SMI dispatch revision number
+
+  Revision 1:   Initial version
+**/
+#define PCH_PCIE_SMI_DISPATCH_REVISION            1
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h
new file mode 100644
index 0000000000..ba7cbdb23e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h
@@ -0,0 +1,40 @@
+/** @file
+  Interface definition details between Pch and platform drivers during DXE phase.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_POLICY_H_
+#define _PCH_POLICY_H_
+
+#include <ConfigBlock.h>
+#include <Library/ConfigBlockLib.h>
+#include "../IncludePrivate/PchConfigHob.h"    // To Be corrected
+#include <Library/HobLib.h>
+
+extern EFI_GUID gPchPolicyProtocolGuid;
+
+#define PCH_POLICY_PROTOCOL_REVISION  1
+
+
+/**
+  PCH DXE Policy
+
+  The PCH_POLICY_PROTOCOL producer drvier is recommended to
+  set all the PCH_POLICY_PROTOCOL size buffer zero before init any member parameter,
+  this clear step can make sure no random value for those unknown new version parameters.
+
+  Make sure to update the Revision if any change to the protocol, including the existing
+  internal structure definations.\n
+  Note: Here revision will be bumped up when adding/removing any config block under this structure.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_TABLE_HEADER      TableHeader;
+/*
+  Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+*/
+} PCH_POLICY_PROTOCOL;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
new file mode 100644
index 0000000000..12b5f8117b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
@@ -0,0 +1,132 @@
+/** @file
+  APIs of PCH SMI Dispatch Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SMI_DISPATCH_PROTOCOL_H_
+#define _PCH_SMI_DISPATCH_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                         gPchSmiDispatchProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_SMI_DISPATCH_PROTOCOL         PCH_SMI_DISPATCH_PROTOCOL;
+
+//
+// Member functions
+//
+
+/**
+  Callback function for an PCH SMI handler dispatch.
+
+  @param[in] DispatchHandle             The unique handle assigned to this handler by register function.
+
+**/
+typedef
+VOID
+(EFIAPI *PCH_SMI_DISPATCH_CALLBACK) (
+  IN EFI_HANDLE                         DispatchHandle
+  );
+
+/**
+  Register a child SMI source dispatch function for specific PCH SMI dispatch event.
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchFunction           Pointer to dispatch function to be invoked for
+                                        this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function, for when interfacing
+                                        with the parent SMM driver.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR              The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or SMM) to manage this child.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMI_DISPATCH_REGISTER) (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMI_DISPATCH_UNREGISTER) (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  Interface structure for PCH specific SMIs Dispatch Protocol
+  The PCH SMI DISPATCH PROTOCOL provides the ability to dispatch function for PCH misc SMIs.
+  It contains legacy SMIs and new PCH SMI types like:
+  SerialIrq, McSmi, Smbus, ...
+**/
+struct _PCH_SMI_DISPATCH_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                                 Revision;
+  /**
+    Smi unregister function for PCH SMI DISPATCH PROTOCOL.
+  **/
+  PCH_SMI_DISPATCH_UNREGISTER           UnRegister;
+  /**
+    SerialIrq
+    The event is triggered while the SMI# was caused by the SERIRQ decoder.
+  **/
+  PCH_SMI_DISPATCH_REGISTER             SerialIrqRegister;
+  /**
+    McSmi
+    The event is triggered if there has been an access to the power management
+    microcontroller range (62h or 66h) and the Microcontroller Decode Enable #1 bit
+    in the LPC Bridge I/O Enables configuration register is 1 .
+  **/
+  PCH_SMI_DISPATCH_REGISTER             McSmiRegister;
+  /**
+    SmBus
+    The event is triggered while the SMI# was caused by:
+    1. The SMBus Slave receiving a message that an SMI# should be caused, or
+    2. The SMBALERT# signal goes active and the SMB_SMI_EN bit is set and the
+       SMBALERT_DIS bit is cleared, or
+    3. The SMBus Slave receiving a Host Notify message and the HOST_NOTIFY_INTREN and
+       the SMB_SMI_EN bits are set, or
+    4. The PCH detecting the SMLINK_SLAVE_SMI command while in the S0 state.
+  **/
+  PCH_SMI_DISPATCH_REGISTER             SmbusRegister;
+  /**
+    SPI Asynchronous
+    When registered, the flash controller will generate an SMI when it blocks a BIOS write or erase.
+  **/
+  PCH_SMI_DISPATCH_REGISTER             SpiAsyncRegister;
+};
+
+/**
+  PCH SMI dispatch revision number
+
+  Revision 1:   Initial version
+**/
+#define PCH_SMI_DISPATCH_REVISION                 1
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapControl.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapControl.h
new file mode 100644
index 0000000000..9f2793634e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapControl.h
@@ -0,0 +1,65 @@
+/** @file
+  PCH SMM IO Trap Control Protocol
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SMM_IO_TRAP_CONTROL_H_
+#define _PCH_SMM_IO_TRAP_CONTROL_H_
+
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                                   gPchSmmIoTrapControlGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL  PCH_SMM_IO_TRAP_CONTROL_PROTOCOL;
+
+//
+// Related Definitions
+//
+
+//
+// Member functions
+//
+
+/**
+  The Prototype of Pause and Resume IoTrap callback function.
+
+  @param[in] This                 Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of the child service to change state.
+
+  @retval EFI_SUCCESS             This operation is complete.
+  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED       The SMI status is alrady PAUSED/RESUMED.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMM_IO_TRAP_CONTROL_FUNCTION) (
+  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL           * This,
+  IN EFI_HANDLE                                 DispatchHandle
+  );
+
+/**
+  Interface structure for the SMM IO trap pause and resume protocol
+  This protocol provides the functions to runtime control the IoTrap SMI enabled/disable.
+  This applys the capability to the DispatchHandle which returned by IoTrap callback
+  registration, and the DispatchHandle which must be MergeDisable = TRUE and Address != 0.
+  Besides, when S3 resuem, it only restores the state of IoTrap callback registration.
+  The Paused/Resume state won't be restored after S3 resume.
+**/
+struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL {
+  /**
+    This runtime pauses a registered IoTrap handler.
+  **/
+  PCH_SMM_IO_TRAP_CONTROL_FUNCTION      Pause;
+  /**
+    This runtime resumes a registered IoTrap handler.
+  **/
+  PCH_SMM_IO_TRAP_CONTROL_FUNCTION      Resume;
+};
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTimerControl.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTimerControl.h
new file mode 100644
index 0000000000..a7b44c5f7e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTimerControl.h
@@ -0,0 +1,65 @@
+/** @file
+  PCH SMM Periodic Timer Control Protocol
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
+#define _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
+
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                                             gPchSmmPeriodicTimerControlGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL     PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL;
+
+//
+// Related Definitions
+//
+
+//
+// Member functions
+//
+
+/**
+  The Prototype of Pause and Resume SMM PERIODIC TIMER function.
+
+  @param[in] This                       Pointer to the PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle             Handle of the child service to change state.
+
+  @retval EFI_SUCCESS                   This operation is complete.
+  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED             The SMI status is alrady PAUSED/RESUMED.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION) (
+  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
+  IN EFI_HANDLE                                   DispatchHandle
+  );
+
+/**
+  Interface structure for the SMM PERIODIC TIMER pause and resume protocol
+  This protocol provides the functions to runtime control the SM periodic timer enabled/disable.
+  This applies the capability to the DispatchHandle which returned by SMM periodic timer callback
+  registration.
+  Besides, when S3 resume, it only restores the state of callback registration.
+  The Paused/Resume state won't be restored after S3 resume.
+**/
+struct _PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL {
+  /**
+    This runtime pauses the registered periodic timer handler.
+  **/
+  PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION         Pause;
+  /**
+    This runtime resumes the registered periodic timer handler.
+  **/
+  PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION         Resume;
+};
+
+#endif // _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.h
new file mode 100644
index 0000000000..b443484f39
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.h
@@ -0,0 +1,150 @@
+/** @file
+  APIs of PCH TCO SMI Dispatch Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_TCO_SMI_DISPATCH_PROTOCOL_H_
+#define _PCH_TCO_SMI_DISPATCH_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                         gPchTcoSmiDispatchProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_TCO_SMI_DISPATCH_PROTOCOL     PCH_TCO_SMI_DISPATCH_PROTOCOL;
+
+//
+// Member functions
+//
+
+/**
+  Callback function for an PCH TCO SMI handler dispatch.
+
+  @param[in] DispatchHandle             The unique handle assigned to this handler by register function.
+
+**/
+typedef
+VOID
+(EFIAPI *PCH_TCO_SMI_DISPATCH_CALLBACK) (
+  IN EFI_HANDLE                         DispatchHandle
+  );
+
+/**
+  Register a child SMI source dispatch function for PCH TCO SMI events.
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchFunction           Pointer to dispatch function to be invoked for
+                                        this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function, for when interfacing
+                                        with the parent SMM driver.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR              The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or SMM) to manage this child.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_TCO_SMI_DISPATCH_REGISTER) (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent TCO SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe event has been triggered
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PCH_TCO_SMI_DISPATCH_UNREGISTER) (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  Interface structure for PCH TCO SMIs Dispatch Protocol
+  The PCH TCO SMI DISPATCH PROTOCOL provides the ability to dispatch function for PCH TCO related SMIs.
+  It contains SMI types of Mch, TcoTimeout, OsTco, Nmi, IntruderDectect, and BiowWp.
+**/
+struct _PCH_TCO_SMI_DISPATCH_PROTOCOL {
+  /**
+    This member specifies the revision of this structure. This field is used to
+    indicate backwards compatible changes to the protocol.
+  **/
+  UINT8                                 Revision;
+  /**
+    Smi unregister function for PCH TCO SMI DISPATCH PROTOCOL.
+  **/
+  PCH_TCO_SMI_DISPATCH_UNREGISTER       UnRegister;
+  /**
+    Mch
+    The event is triggered when PCH received a DMI special cycle message using DMI indicating that
+    it wants to cause an SMI.
+    The software must read the processor to determine the reason for the SMI.
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         MchRegister;
+  /**
+    TcoTimeout
+    The event is triggered by PCH to indicate that the SMI was caused by the TCO timer reaching 0.
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         TcoTimeoutRegister;
+  /**
+    OsTco
+    The event is triggered when software caused an SMI# by writing to the TCO_DAT_IN register (TCOBASE + 02h).
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         OsTcoRegister;
+  /**
+    Nmi
+    The event is triggered by the PCH when an SMI# occurs because an event occurred that would otherwise have
+    caused an NMI (because NMI2SMI_EN is set)
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         NmiRegister;
+  /**
+    IntruderDectect
+    The event is triggered by PCH to indicate that an intrusion was detected.
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         IntruderDetRegister;
+  /**
+    SpiBiosWp
+    This event is triggered when SMI# was caused by the TCO logic and
+    SPI flash controller asserted Synchronous SMI by BIOS lock enable set.
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         SpiBiosWpRegister;
+  /**
+    LpcBiosWp
+    This event is triggered when SMI# was caused by the TCO logic and
+    LPC/eSPI BIOS lock enable set.
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         LpcBiosWpRegister;
+  /**
+    NewCentury
+    This event is triggered when SMI# was caused by the TCO logic and
+    year of RTC date rolls over a century (99 to 00).
+  **/
+  PCH_TCO_SMI_DISPATCH_REGISTER         NewCenturyRegister;
+};
+
+/**
+  PCH TCO SMI dispatch revision number
+
+  Revision 1:   Initial version
+  Revision 2:   Add NEWCENTURY support
+**/
+#define PCH_TCO_SMI_DISPATCH_REVISION             2
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h
new file mode 100644
index 0000000000..679cb17f6c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h
@@ -0,0 +1,16 @@
+/** @file
+  Generic register definitions for PCH.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_H_
+#define _PCH_REGS_H_
+
+///
+/// The default PCH PCI segment and bus number
+///
+#define DEFAULT_PCI_SEGMENT_NUMBER_PCH  0
+#define DEFAULT_PCI_BUS_NUMBER_PCH      0
+
+#endif //_PCH_REGS_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
new file mode 100644
index 0000000000..32dd88be0e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
@@ -0,0 +1,145 @@
+/** @file
+  Register names for PCH LPC/eSPI device
+
+Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_LPC_H_
+#define _PCH_REGS_LPC_H_
+
+#define B_LPC_CFG_DID         0xFFE0
+
+//
+// PCI to LPC Bridge Registers
+//
+
+#define R_LPC_CFG_IOD                             0x80
+#define V_LPC_CFG_IOD_COMB_2F8                    1
+#define V_LPC_CFG_IOD_COMA_3F8                    0
+#define V_LPC_CFG_IOD_COMA_2F8                    1
+#define R_LPC_CFG_IOE                             0x82
+#define B_LPC_CFG_IOE_SE                          BIT12           ///< Super I/O Enable, Enables decoding of I/O locations 2Eh and 2Fh to LPC.
+#define B_LPC_CFG_IOE_KE                          BIT10           ///< Keyboard Enable, Enables decoding of the keyboard I/O locations 60h and 64h to LPC.
+#define B_LPC_CFG_IOE_PPE                         BIT2            ///< Parallel Port Enable, Enables decoding of the LPT range to LPC. Range is selected by LIOD.LPT.
+#define B_LPC_CFG_IOE_CBE                         BIT1            ///< Com Port B Enable, Enables decoding of the COMB range to LPC. Range is selected LIOD.CB.
+#define B_LPC_CFG_IOE_CAE                         BIT0            ///< Com Port A Enable, Enables decoding of the COMA range to LPC. Range is selected LIOD.CA.
+#define R_LPC_CFG_ULKMC                           0x94
+#define B_LPC_CFG_ULKMC_A20PASSEN                 BIT5
+#define B_LPC_CFG_ULKMC_64WEN                     BIT3
+#define B_LPC_CFG_ULKMC_64REN                     BIT2
+#define B_LPC_CFG_ULKMC_60WEN                     BIT1
+#define B_LPC_CFG_ULKMC_60REN                     BIT0
+#define R_LPC_CFG_LGMR                            0x98
+#define B_LPC_CFG_LGMR_MA                         0xFFFF0000
+#define B_LPC_CFG_LGMR_LMRD_EN                    BIT0
+#define R_ESPI_CFG_CS1IORE                        0xA0
+#define R_ESPI_CFG_CS1GMR1                        0xA8
+
+#define R_LPC_CFG_BDE                             0xD8                          ///< BIOS decode enable
+
+//
+// APM Registers
+//
+#define R_PCH_IO_APM_CNT                             0xB2
+#define R_PCH_IO_APM_STS                             0xB3
+
+#define R_LPC_CFG_BC                              0xDC            ///< Bios Control
+#define S_LPC_CFG_BC                              1
+#define N_LPC_CFG_BC_LE                           1
+#define B_LPC_CFG_BC_WPD                          BIT0            ///< Write Protect Disable
+
+#define R_ESPI_CFG_PCBC                           0xDC            ///< Peripheral Channel BIOS Control
+#define S_ESPI_CFG_PCBC                           4               ///< Peripheral Channel BIOS Control register size
+#define B_ESPI_CFG_PCBC_BWRE                      BIT11           ///< BIOS Write Report Enable
+#define B_ESPI_CFG_PCBC_BWRS                      BIT10           ///< BIOS Write Report Status
+#define B_ESPI_CFG_PCBC_BWPDS                     BIT8            ///< BIOS Write Protect Disable Status
+#define N_ESPI_CFG_PCBC_BWPDS                     8               ///< BIOS Write Protect Disable Status bit position
+#define B_ESPI_CFG_PCBC_ESPI_EN                   BIT2            ///< eSPI Enable Pin Strap
+#define B_ESPI_CFG_PCBC_LE                        BIT1            ///< Lock Enable
+#define N_ESPI_CFG_PCBC_LE                        1
+
+//
+// eSPI slave registers
+//
+#define B_ESPI_SLAVE_BME                          BIT2            ///< Bus Master Enable
+
+//
+// Reset Generator I/O Port
+//
+#define R_PCH_IO_RST_CNT                             0xCF9
+#define V_PCH_IO_RST_CNT_FULLRESET                   0x0E
+#define V_PCH_IO_RST_CNT_HARDRESET                   0x06
+
+//
+// eSPI PCR Registers
+//
+#define R_ESPI_PCR_SLV_CFG_REG_CTL            0x4000                  ///< Slave Configuration Register and Link Control
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE       BIT31                   ///< Slave Configuration Register Access Enable
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS       (BIT30 | BIT29 | BIT28) ///< Slave Configuration Register Access Status
+#define N_ESPI_PCR_SLV_CFG_REG_CTL_SCRS       28                      ///< Slave Configuration Register Access Status bit position
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SBLCL      BIT27                   ///< IOSF-SB eSPI Link Configuration Lock
+#define V_ESPI_PCR_SLV_CFG_REG_CTL_SCRS_NOERR 7                       ///< No errors (transaction completed successfully)
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SID        (BIT20 | BIT19)         ///< Slave ID
+#define N_ESPI_PCR_SLV_CFG_REG_CTL_SID        19                      ///< Slave ID bit position
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRT       (BIT17 | BIT16)         ///< Slave Configuration Register Access Type
+#define N_ESPI_PCR_SLV_CFG_REG_CTL_SCRT       16                      ///< Slave Configuration Register Access Type bit position
+#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA       0x00000FFF              ///< Slave Configuration Register Address
+#define R_ESPI_PCR_SLV_CFG_REG_DATA           0x4004                  ///< Slave Configuration Register Data
+
+#define R_ESPI_PCR_PCERR_SLV0                 0x4020          ///< Peripheral Channel Error for Slave 0
+#define B_ESPI_PCR_PCERR_PCURD                BIT24           ///< Peripheral Channel Unsupported Request Detected
+#define R_ESPI_PCR_VWERR_SLV0                 0x4030          ///< Virtual Wire Channel Error for Slave 0
+#define R_ESPI_PCR_FCERR_SLV0                 0x4040          ///< Flash Access Channel Error for Slave 0
+#define B_ESPI_PCR_FCERR_SAFBLK               BIT17           ///< SAF Blocked (SAFBLK)
+#define B_ESPI_PCR_XERR_XNFEE                 (BIT14 | BIT13) ///< Non-Fatal Error Reporting Enable bits
+#define N_ESPI_PCR_XERR_XNFEE                 13              ///< Non-Fatal Error Reporting Enable bit position
+#define V_ESPI_PCR_XERR_XNFEE_SMI             3               ///< Enable Non-Fatal Error Reporting as SMI
+#define B_ESPI_PCR_XERR_XNFES                 BIT12           ///< Fatal Error Status
+#define B_ESPI_PCR_XERR_XFEE                  (BIT6 | BIT5)   ///< Fatal Error Reporting Enable bits
+#define N_ESPI_PCR_XERR_XFEE                  5               ///< Fatal Error Reporting Enable bit position
+#define V_ESPI_PCR_XERR_XFEE_SMI              3               ///< Enable Fatal Error Reporting as SMI
+#define B_ESPI_PCR_XERR_XFES                  BIT4            ///< Fatal Error Status
+#define S_ESPI_PCR_XERR                       4               ///< Channel register sizes
+#define B_ESPI_PCR_PCERR_SLV0_PCURD           BIT24           ///< Peripheral Channel Unsupported Request Detected
+#define R_ESPI_PCR_LNKERR_SLV0                0x4050          ///< Link Error for Slave 0
+#define S_ESPI_PCR_LNKERR_SLV0                4               ///< Link Error for Slave 0 register size
+#define B_ESPI_PCR_LNKERR_SLV0_SLCRR          BIT31           ///< eSPI Link and Slave Channel Recovery Required
+#define B_ESPI_PCR_LNKERR_SLV0_LFET1E         (BIT22 | BIT21) ///< Fatal Error Type 1 Reporting Enable
+#define N_ESPI_PCR_LNKERR_SLV0_LFET1E         21              ///< Fatal Error Type 1 Reporting Enable bit position
+#define V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI     3               ///< Enable Fatal Error Type 1 Reporting as SMI
+#define B_ESPI_PCR_LNKERR_SLV0_LFET1S         BIT20           ///< Link Fatal Error Type 1 Status
+#define R_ESPI_PCR_LNKERR_SLV1                0x4054          ///< Link Error for Slave 1
+#define R_ESPI_PCR_CFG_VAL                    0xC00C          ///< ESPI Enabled Strap
+#define B_ESPI_PCR_CFG_VAL_ESPI_EN            BIT0            ///< ESPI Enabled Strap bit position
+#define R_ESPI_PCR_SOFTSTRAPS                 0xC210          ///< eSPI Sofstraps Register 0
+#define B_ESPI_PCR_SOFTSTRAPS_CS1_EN          BIT12           ///< CS1# Enable
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
new file mode 100644
index 0000000000..dc32f1e5b3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
@@ -0,0 +1,50 @@
+/** @file
+  Register definition for PSF component
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PSF_H_
+#define _PCH_REGS_PSF_H_
+//
+// PSFx segment registers
+//
+
+#define N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC          1
+#define B_PCH_PSFX_PCR_MC_CONTROL_MCASTX_MULTCEN        BIT0
+
+//
+// PSFx PCRs definitions
+//
+#define B_PCH_PSFX_PCR_TARGET_PSFID                     0xFF0000
+#define N_PCH_PSFX_PCR_TARGET_PSFID                     16
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
new file mode 100644
index 0000000000..2007eae44f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
@@ -0,0 +1,66 @@
+/** @file
+  Register definition for PSTH component
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PSTH_H_
+#define _PCH_REGS_PSTH_H_
+
+//
+// Private chipset regsiter (Memory space) offset definition
+// The PCR register defines is used for PCR MMIO programming and PCH SBI programming as well.
+//
+
+//
+// PSTH and IO Trap PCRs (PID:PSTH)
+//
+#define R_PSTH_PCR_PSTHCTL          0x1D00                ///< PSTH control register
+#define B_PSTH_PCR_PSTHIOSFPTCGE    BIT2                  ///< PSTH IOSF primary trunk clock gating enable
+#define R_PSTH_PCR_TRPST            0x1E00                ///< Trap status regsiter
+#define R_PSTH_PCR_TRPC             0x1E10                ///< Trapped cycle
+#define B_PSTH_PCR_TRPC_RW          BIT24                 ///< Read/Write#: 1=Read, 0=Write
+#define B_PSTH_PCR_TRPC_AHBE        0x00000000000F0000    ///< Active high byte enables
+#define B_PSTH_PCR_TRPC_IOA         0x000000000000FFFC    ///< Trap cycle I/O address
+#define R_PSTH_PCR_TRPD             0x1E18                ///< Trapped write data
+#define R_PSTH_PCR_TRPREG0          0x1E80                ///< IO Tarp 0 register
+#define R_PSTH_PCR_TRPREG1          0x1E88                ///< IO Tarp 1 register
+#define R_PSTH_PCR_TRPREG2          0x1E90                ///< IO Tarp 2 register
+#define R_PSTH_PCR_TRPREG3          0x1E98                ///< IO Tarp 3 register
+#define B_PSTH_PCR_TRPREG_RWM       BIT17                 ///< 49 - 32 for 32 bit access, Read/Write mask
+#define B_PSTH_PCR_TRPREG_RWIO      BIT16                 ///< 48 - 32 for 32 bit access, Read/Write#, 1=Read, 0=Write
+#define N_PSTH_PCR_TRPREG_RWIO      16                    ///< 48 - 32 for 32 bit access, 16bit shift for Read/Write field
+#define N_PSTH_PCR_TRPREG_BEM       36
+#define N_PSTH_PCR_TRPREG_BE        32
+#define B_PSTH_PCR_TRPREG_AD        0x000000000000FFFC    ///< IO Address
+#define B_PSTH_PCR_TRPREG_TSE       BIT0                  ///< Trap and SMI# Enable
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (3 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers Heng Luo
                   ` (34 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Pch/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleResetLib.h |  47 +++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivateLib.h   |  26 ++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h               | 269 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob.h        |  21 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h              | 319 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h                  |  58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.h        |  30 ++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h        |  35 +++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.h         |  21 +++++++++++++++++++++
 9 files changed, 826 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleResetLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleResetLib.h
new file mode 100644
index 0000000000..2ad80a0269
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleResetLib.h
@@ -0,0 +1,47 @@
+/** @file
+  Reset scheduling library services
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SI_SCHEDULE_RESET_LIB_H_
+#define _SI_SCHEDULE_RESET_LIB_H_
+
+#include <Uefi/UefiMultiPhase.h>
+#include <PchResetPlatformSpecific.h>
+
+/**
+  This function updates the reset information in SiScheduleResetHob
+  @param[in] ResetType        UEFI defined reset type.
+  @param[in] ResetData        Optional element used to introduce a platform specific reset.
+                               The exact type of the reset is defined by the EFI_GUID that follows
+                               the Null-terminated Unicode string.
+**/
+VOID
+SiScheduleResetSetType (
+  IN EFI_RESET_TYPE     ResetType,
+  IN PCH_RESET_DATA     *ResetData OPTIONAL
+  );
+
+/**
+  This function returns TRUE or FALSE depending on whether a reset is required based on SiScheduleResetHob
+
+  @retval     BOOLEAN       The function returns FALSE if no reset is required
+**/
+BOOLEAN
+SiScheduleResetIsRequired (
+  VOID
+  );
+
+/**
+  This function performs reset based on SiScheduleResetHob
+
+  @retval     BOOLEAN       The function returns FALSE if no reset is required
+**/
+BOOLEAN
+SiScheduleResetPerformReset (
+  VOID
+  );
+
+#endif //_SI_SCHEDULE_RESET_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivateLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivateLib.h
new file mode 100644
index 0000000000..955dac5a82
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivateLib.h
@@ -0,0 +1,26 @@
+/** @file
+  Header file for private PCH SMM Lib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SMM_PCH_PRIVATE_LIB_H_
+#define _SMM_PCH_PRIVATE_LIB_H_
+
+/**
+  Set InSmm.Sts bit
+**/
+VOID
+PchSetInSmmSts (
+  VOID
+  );
+
+/**
+  Clear InSmm.Sts bit
+**/
+VOID
+PchClearInSmmSts (
+  VOID
+  );
+
+#endif // _SMM_PCH_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
new file mode 100644
index 0000000000..13a41f8d04
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
@@ -0,0 +1,269 @@
+/** @file
+  The GUID definition for PchConfigHob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_CONFIG_HOB_H_
+#define _PCH_CONFIG_HOB_H_
+
+#include <ConfigBlock.h>
+#include <SmbusConfig.h>
+#include <InterruptConfig.h>
+#include <PchPcieRpConfig.h>
+#include <SataConfig.h>
+#include <RstConfig.h>
+#include <ConfigBlock/FlashProtectionConfig.h>
+#include <FivrConfig.h>
+#include <ThcConfig.h>
+#include <SerialIoConfig.h>
+
+
+extern EFI_GUID gPchConfigHobGuid;
+
+#pragma pack (push,1)
+
+/**
+  This structure contains the HOB which are related to PCH general config.
+**/
+typedef struct {
+  /**
+    This member describes whether or not the Compatibility Revision ID (CRID) feature
+    of PCH should be enabled. <b>0: Disable</b>; 1: Enable
+  **/
+  UINT32 Crid      :  1;
+  UINT32 RsvdBits0 : 31; ///< Reserved bits
+} GENERAL_HOB;
+
+/**
+  The SMBUS_CONFIG block lists the reserved addresses for non-ARP capable devices in the platform.
+**/
+typedef struct {
+  UINT8 RsvdBytes[3];          ///< Reserved bytes
+  UINT8 NumRsvdSmbusAddresses; ///< The number of elements in the RsvdSmbusAddressTable.
+  /**
+    Array of addresses reserved for non-ARP-capable SMBus devices.
+  **/
+  UINT8 RsvdSmbusAddressTable[PCH_MAX_SMBUS_RESERVED_ADDRESS];
+} SMBUS_HOB;
+
+/**
+  The INTERRUPT_HOB describes interrupt settings for PCH.
+**/
+typedef struct {
+  UINT8                        NumOfDevIntConfig;                             ///< Number of entries in DevIntConfig table
+  UINT8                        GpioIrqRoute;                                  ///< Interrupt routing for GPIO. Default is <b>14</b>.
+  UINT8                        Rsvd0[2];                                      ///< Reserved bytes, align to multiple 4.
+  PCH_DEVICE_INTERRUPT_CONFIG  DevIntConfig[PCH_MAX_DEVICE_INTERRUPT_CONFIG]; ///< Array which stores PCH devices interrupts settings
+} INTERRUPT_HOB;
+
+/**
+  The SERIAL_IO block provides the configurations to set the Serial IO controllers
+**/
+typedef struct {
+  SERIAL_IO_SPI_CONFIG  SpiDeviceConfig[PCH_MAX_SERIALIO_SPI_CONTROLLERS];   ///< SPI Configuration
+  SERIAL_IO_I2C_CONFIG  I2cDeviceConfig[PCH_MAX_SERIALIO_I2C_CONTROLLERS];   ///< I2C Configuration
+  SERIAL_IO_UART_CONFIG UartDeviceConfig[PCH_MAX_SERIALIO_UART_CONTROLLERS]; ///< UART Configuration
+} SERIAL_IO_HOB;
+
+/**
+  The PCIERP_HOB block describes the expected configuration of the PCH PCI Express controllers
+**/
+typedef struct {
+  ///
+  /// These members describe the configuration of each PCH PCIe root port.
+  ///
+  PCH_PCIE_ROOT_PORT_CONFIG    RootPort[PCH_MAX_PCIE_ROOT_PORTS];
+  PCH_PCIE_CLOCK               PcieClock[PCH_MAX_PCIE_CLOCKS];
+  /**
+    This member allows BIOS to control ICC PLL Shutdown by determining PCIe devices are LTR capable
+    or leaving untouched.
+    - <b>0: Disable, ICC PLL Shutdown is determined by PCIe device LTR capablility.</b>
+      - To allow ICC PLL shutdown if all present PCIe devices are LTR capable or if no PCIe devices are
+        presented for maximum power savings where possible.
+      - To disable ICC PLL shutdown when BIOS detects any non-LTR capable PCIe device for ensuring device
+        functionality.
+    - 1: Enable, To allow ICC PLL shutdown even if some devices do not support LTR capability.
+  **/
+  UINT32  AllowNoLtrIccPllShutdown :  1;
+  UINT32  RsvdBits0                : 31; ///< Reserved bits
+} PCIERP_HOB;
+
+/**
+  The HDAUDIO_HOB block describes the configuration of the PCH cAVS controller
+**/
+typedef struct {
+  UINT32  DspEnable             :  1; ///< DSP enablement: 0: Disable; <b>1: Enable</b>
+  UINT32  DspUaaCompliance      :  1; ///< UAA-mode Select: <b>0: Non-Uaa</b>; 1: UAA
+  UINT32  CodecSxWakeCapability :  1; ///< Capability to detect wake initiated by a codec in Sx, <b>0: Disable</b>; 1: Enable
+  UINT32  AudioLinkSndw1        :  1; ///< SoundWire1 link enablement: <b>0: Disable</b>; 1: Enable. Muxed with HDA
+  UINT32  AudioLinkSndw2        :  1; ///< SoundWire2 link enablement: <b>0: Disable</b>; 1: Enable. Muxed with SSP1
+  UINT32  AudioLinkSndw3        :  1; ///< SoundWire3 link enablement: <b>0: Disable</b>; 1: Enable. Muxed with DMIC1
+  UINT32  AudioLinkSndw4        :  1; ///< SoundWire4 link enablement: <b>0: Disable</b>; 1: Enable. Muxed with DMIC0
+  UINT32  Pme                   :  1; ///< Azalia wake-on-ring, <b>0: Disable</b>; 1: Enable
+  UINT32  RsvdBits0             : 24; ///< Reserved bits
+} HDAUDIO_HOB;
+
+/**
+  The SATA_HOB block describes the configuration of the PCH SATA controllers
+**/
+typedef struct {
+  /**
+    This member describes whether or not the SATA controllers should be enabled. 0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32                        Enable          :  1;
+  UINT32                        TestMode        :  1; ///< <b>(Test)</b> <b>0: Disable</b>; 1: Allow entrance to the PCH SATA test modes
+  UINT32                        RsvdBits0       : 30; ///< Reserved bits
+  /**
+    This member configures the features, property, and capability for each SATA port.
+  **/
+  PCH_SATA_PORT_CONFIG          PortSettings[PCH_MAX_SATA_PORTS];
+} SATA_HOB;
+
+/**
+  The RST block describes the configuration of the RST PCIE Cycle Routers
+**/
+typedef struct {
+  /**
+    This member describes the details of implementation of Intel RST for PCIe Storage remapping (Intel RST Driver is required)
+  **/
+  RST_HARDWARE_REMAPPED_STORAGE_CONFIG   RstHardwareRemappedStorageConfig[PCH_MAX_RST_PCIE_STORAGE_CR];
+} RST_HOB;
+
+typedef struct {
+  UINT32  Enabled  : 1; ///< Indicates that SD card has been enabled
+  UINT32  Reserved : 31;
+} SD_CARD_HOB;
+
+/**
+  The EMMC_HOB block describes integrated eMMC settings for PCH.
+**/
+typedef struct {
+  UINT32  Enabled                      :  1;  ///< Determine if eMMC is enabled - 0: Disabled, <b>1: Enabled</b>.
+  UINT32  Hs400Enabled                 :  1;  ///< Determine eMMC HS400 Mode if EmmcEnabled - <b>0: Disabled</b>, 1: Enabled
+  /**
+    Determine if HS400 Training is required, set to FALSE if Hs400 Data is valid. <b>0: Disabled</b>, 1: Enabled.
+    First Boot or CMOS clear, system boot with Default settings, set tuning required.
+    Subsequent Boots, Get Variable 'Hs400TuningData'
+      - if failed to get variable, set tuning required
+      - if passed, retrieve Hs400DataValid, Hs400RxStrobe1Dll and Hs400TxDataDll from variable. Set tuning not required.
+  **/
+  UINT32  Hs400DllDataValid            :  1;  ///< Set if HS400 Tuning Data Valid
+  UINT32  RsvdBits                     : 29;
+} EMMC_HOB;
+
+/**
+  The PCH_LOCK_DOWN_CONFIG block describes the expected configuration of the PCH
+  for security requirement.
+**/
+typedef struct {
+  UINT32  GlobalSmi      :  1;
+  /**
+    <b>(Test)</b> Enable BIOS Interface Lock Down bit to prevent writes to the Backup Control Register
+    Top Swap bit and the General Control and Status Registers Boot BIOS Straps. 0: Disable; <b>1: Enable</b>.
+  **/
+  UINT32  BiosInterface  :  1;
+  /**
+    Enable the BIOS Lock Enable (BLE) feature and set EISS bit (D31:F5:RegDCh[5])
+    for the BIOS region protection. When it is enabled, the BIOS Region can only be
+    modified from SMM after EndOfDxe protocol is installed.
+    Note: When BiosLock is enabled, platform code also needs to update to take care
+    of BIOS modification (including SetVariable) in DXE or runtime phase after
+    EndOfDxe protocol is installed.
+    Enable InSMM.STS (EISS) in SPI
+    If this EISS bit is set, then WPD must be a '1' and InSMM.STS must be '1' also
+    in order to write to BIOS regions of SPI Flash. If this EISS bit is clear,
+    then the InSMM.STS is a don't care.
+    The BIOS must set the EISS bit while BIOS Guard support is enabled.
+    In recovery path, platform can temporary disable EISS for SPI programming in
+    PEI phase or early DXE phase.
+    0: Disable; <b>1: Enable.</b>
+  **/
+  UINT32  BiosLock        :  1;
+  UINT32  RsvdBits        : 29;
+} LOCK_DOWN_HOB;
+
+/**
+  The PM_HOB block describes expected miscellaneous power management settings.
+  The PowerResetStatusClear field would clear the Power/Reset status bits, please
+  set the bits if you want PCH Init driver to clear it, if you want to check the
+  status later then clear the bits.
+**/
+typedef struct {
+  UINT32 PsOnEnable             :  1; ///< Indicates if PS_ON support has been enabled, <b>0: Disable</b>; 1: Enable.
+  UINT32 EnableTimedGpio0       :  1; ///< Enable Bit for Timed GPIO 0 <b>0 = disable</b>; 1 = enable
+  UINT32 EnableTimedGpio1       :  1; ///< Enable Bit for Timed GPIO 1 <b>0 = disable</b>; 1 = enable
+  UINT32 RsvdBits1              : 29;
+} PM_HOB;
+
+/**
+  FIVR_HOB block
+**/
+typedef struct {
+  /**
+    Additional External Vnn VR rail configuration dedicated for Sx.
+    Required only if External Vnn VR needs different settings for Sx than
+    those specified in ExtVnnRail (refer to PCH_FIVR_CONFIG.ExtVnnRail)
+  **/
+  FIVR_EXT_RAIL_CONFIG     ExtVnnRailSx;
+} FIVR_HOB;
+
+/**
+  PCH Trace Hub HOB settings.
+**/
+typedef struct {
+  UINT32  PchTraceHubMode       :  2; ///< <b>0 = Disable</b>; 1 = Target Debugger mode; 2 = Host Debugger mode
+  UINT32  Rsvd1                 : 30; ///< Reserved bits
+  /**
+    Trace hub memory buffer region size policy.
+    The avaliable memory size options are: 0:0MB (none), 1:1MB, <b>2:8MB</b>, 3:64MB, 4:128MB, 5:256MB, 6:512MB.
+    Note : Limitation of total buffer size (CPU + PCH) is 512MB. If iTbt is enabled, the total size limits to 256 MB.
+    Refer to TRACE_BUFFER_SIZE
+  **/
+  UINT32  MemReg0Size;
+  UINT32  MemReg1Size;
+} PCH_TRACEHUB_HOB;
+
+/**
+  PCH eSPI HOB settings.
+**/
+typedef struct {
+  UINT32  BmeMasterSlaveEnabled :  1; ///< <b>0 = BME disable</b>; 1 = BME enable
+  UINT32  RsvdBits              : 31; ///< Reserved bits
+} PCH_ESPI_HOB;
+
+/**
+  THC HOB settings.
+**/
+typedef struct {
+  THC_PORT  ThcPort[2]; ///< Port Configuration
+} THC_HOB;
+
+
+/**
+  This structure contains the HOBs which are related to PCH controllers
+**/
+typedef struct {
+  EFI_HOB_GUID_TYPE  EfiHobGuidType;     ///< GUID HOB type structure for gPchConfigHobGuid
+  GENERAL_HOB        General;            ///< Pch general HOB definition
+  INTERRUPT_HOB      Interrupt;          ///< Interrupt HOB definition
+  SERIAL_IO_HOB      SerialIo;           ///< Serial io HOB definition
+  PCIERP_HOB         PcieRp;             ///< PCIE root port HOB definition
+  SD_CARD_HOB        SdCard;             ///< SD card HOB definition
+  EMMC_HOB           Emmc;               ///< eMMC HOB definition
+  LOCK_DOWN_HOB      LockDown;           ///< Lock down HOB definition
+  PM_HOB             Pm;                 ///< PM HOB definition
+  HDAUDIO_HOB        HdAudio;            ///< HD audio definition
+  SATA_HOB           Sata[PCH_MAX_SATA_CONTROLLERS]; ///< SATA definition
+  RST_HOB            Rst;                ///< RST definition
+  PROTECTED_RANGE    ProtectRange[PCH_FLASH_PROTECTED_RANGES];
+  SMBUS_HOB          Smbus;
+  PCH_TRACEHUB_HOB   PchTraceHub;        ///< PCH Trace Hub definition
+  PCH_ESPI_HOB       Espi;               ///< PCH eSPI definition
+  THC_HOB            Thc;                ///< PCH Tocuh Host Controller definition
+  FIVR_HOB           Fivr;               ///< PCH FIVR HOB definition
+
+
+} PCH_CONFIG_HOB;
+#pragma pack (pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob.h
new file mode 100644
index 0000000000..040bc270e6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob.h
@@ -0,0 +1,21 @@
+/** @file
+
+  Definitions required to create HybridStorageHob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_HYBRIDSTORAGE_HOB_
+#define _PCH_HYBRIDSTORAGE_HOB_
+
+extern EFI_GUID  gHybridStorageHobGuid;
+
+//
+//  Passes to DXE Hybrid Storage location
+//
+typedef struct {
+  UINT32 HybridStorageLocation;
+} PCH_HYBRIDSTORAGE_HOB;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
new file mode 100644
index 0000000000..200f3ca8fa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
@@ -0,0 +1,319 @@
+//
+// Automatically generated by GenNvs ver 2.4.6
+// Please DO NOT modify !!!
+//
+
+/** @file
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+  //
+  // Define PCH NVS Area operatino region.
+  //
+#ifndef _PCH_NVS_AREA_DEF_H_
+#define _PCH_NVS_AREA_DEF_H_
+
+#pragma pack (push,1)
+typedef struct {
+  UINT16   PchSeries;                               ///< Offset 0       PCH Series
+  UINT16   PchGeneration;                           ///< Offset 2       PCH Generation
+  UINT16   PchStepping;                             ///< Offset 4       PCH Stepping
+  UINT32   RpAddress[28];                           ///< Offset 6       Root Port address 1
+                                                    ///< Offset 10      Root Port address 2
+                                                    ///< Offset 14      Root Port address 3
+                                                    ///< Offset 18      Root Port address 4
+                                                    ///< Offset 22      Root Port address 5
+                                                    ///< Offset 26      Root Port address 6
+                                                    ///< Offset 30      Root Port address 7
+                                                    ///< Offset 34      Root Port address 8
+                                                    ///< Offset 38      Root Port address 9
+                                                    ///< Offset 42      Root Port address 10
+                                                    ///< Offset 46      Root Port address 11
+                                                    ///< Offset 50      Root Port address 12
+                                                    ///< Offset 54      Root Port address 13
+                                                    ///< Offset 58      Root Port address 14
+                                                    ///< Offset 62      Root Port address 15
+                                                    ///< Offset 66      Root Port address 16
+                                                    ///< Offset 70      Root Port address 17
+                                                    ///< Offset 74      Root Port address 18
+                                                    ///< Offset 78      Root Port address 19
+                                                    ///< Offset 82      Root Port address 20
+                                                    ///< Offset 86      Root Port address 21
+                                                    ///< Offset 90      Root Port address 22
+                                                    ///< Offset 94      Root Port address 23
+                                                    ///< Offset 98      Root Port address 24
+                                                    ///< Offset 102     Root Port address 25
+                                                    ///< Offset 106     Root Port address 26
+                                                    ///< Offset 110     Root Port address 27
+                                                    ///< Offset 114     Root Port address 28
+  UINT64   NHLA;                                    ///< Offset 118     HD-Audio NHLT ACPI address
+  UINT32   NHLL;                                    ///< Offset 126     HD-Audio NHLT ACPI length
+  UINT32   ADFM;                                    ///< Offset 130     HD-Audio DSP Feature Mask
+  UINT8    SWQ0;                                    ///< Offset 134     HD-Audio SoundWire Link #1 quirk mask
+  UINT8    SWQ1;                                    ///< Offset 135     HD-Audio SoundWire Link #2 quirk mask
+  UINT8    SWQ2;                                    ///< Offset 136     HD-Audio SoundWire Link #3 quirk mask
+  UINT8    SWQ3;                                    ///< Offset 137     HD-Audio SoundWire Link #4 quirk mask
+  UINT8    ACS0;                                    ///< Offset 138     HD-Audio SoundWire Link #1 Autonomous Clock Stop
+  UINT8    ACS1;                                    ///< Offset 139     HD-Audio SoundWire Link #2 Autonomous Clock Stop
+  UINT8    ACS2;                                    ///< Offset 140     HD-Audio SoundWire Link #3 Autonomous Clock Stop
+  UINT8    ACS3;                                    ///< Offset 141     HD-Audio SoundWire Link #4 Autonomous Clock Stop
+  UINT8    DAI0;                                    ///< Offset 142     HD-Audio SoundWire Link #1 Data On Active Interval Select
+  UINT8    DAI1;                                    ///< Offset 143     HD-Audio SoundWire Link #2 Data On Active Interval Select
+  UINT8    DAI2;                                    ///< Offset 144     HD-Audio SoundWire Link #3 Data On Active Interval Select
+  UINT8    DAI3;                                    ///< Offset 145     HD-Audio SoundWire Link #4 Data On Active Interval Select
+  UINT8    DOD0;                                    ///< Offset 146     HD-Audio SoundWire Link #1 Data On Delay Select
+  UINT8    DOD1;                                    ///< Offset 147     HD-Audio SoundWire Link #2 Data On Delay Select
+  UINT8    DOD2;                                    ///< Offset 148     HD-Audio SoundWire Link #3 Data On Delay Select
+  UINT8    DOD3;                                    ///< Offset 149     HD-Audio SoundWire Link #4 Data On Delay Select
+  UINT8    SWMC;                                    ///< Offset 150     HD-Audio SoundWire Master Count
+  UINT8    XTAL;                                    ///< Offset 151     XTAL frequency: 0: 24MHz; 1: 38.4MHz; 2: Unsupported
+  UINT32   DSPM;                                    ///< Offset 152     HD-Audio DSP Stolen Memory Base Address (@todo: Remove after CNL-LP B0)
+  UINT32   SBRG;                                    ///< Offset 156     SBREG_BAR
+  UINT8    GEI0;                                    ///< Offset 160     GPIO GroupIndex mapped to GPE_DW0
+  UINT8    GEI1;                                    ///< Offset 161     GPIO GroupIndex mapped to GPE_DW1
+  UINT8    GEI2;                                    ///< Offset 162     GPIO GroupIndex mapped to GPE_DW2
+  UINT8    GED0;                                    ///< Offset 163     GPIO DW part of group mapped to GPE_DW0
+  UINT8    GED1;                                    ///< Offset 164     GPIO DW part of group mapped to GPE_DW1
+  UINT8    GED2;                                    ///< Offset 165     GPIO DW part of group mapped to GPE_DW2
+  UINT16   PcieLtrMaxSnoopLatency[28];              ///< Offset 166     PCIE LTR max snoop Latency 1
+                                                    ///< Offset 168     PCIE LTR max snoop Latency 2
+                                                    ///< Offset 170     PCIE LTR max snoop Latency 3
+                                                    ///< Offset 172     PCIE LTR max snoop Latency 4
+                                                    ///< Offset 174     PCIE LTR max snoop Latency 5
+                                                    ///< Offset 176     PCIE LTR max snoop Latency 6
+                                                    ///< Offset 178     PCIE LTR max snoop Latency 7
+                                                    ///< Offset 180     PCIE LTR max snoop Latency 8
+                                                    ///< Offset 182     PCIE LTR max snoop Latency 9
+                                                    ///< Offset 184     PCIE LTR max snoop Latency 10
+                                                    ///< Offset 186     PCIE LTR max snoop Latency 11
+                                                    ///< Offset 188     PCIE LTR max snoop Latency 12
+                                                    ///< Offset 190     PCIE LTR max snoop Latency 13
+                                                    ///< Offset 192     PCIE LTR max snoop Latency 14
+                                                    ///< Offset 194     PCIE LTR max snoop Latency 15
+                                                    ///< Offset 196     PCIE LTR max snoop Latency 16
+                                                    ///< Offset 198     PCIE LTR max snoop Latency 17
+                                                    ///< Offset 200     PCIE LTR max snoop Latency 18
+                                                    ///< Offset 202     PCIE LTR max snoop Latency 19
+                                                    ///< Offset 204     PCIE LTR max snoop Latency 20
+                                                    ///< Offset 206     PCIE LTR max snoop Latency 21
+                                                    ///< Offset 208     PCIE LTR max snoop Latency 22
+                                                    ///< Offset 210     PCIE LTR max snoop Latency 23
+                                                    ///< Offset 212     PCIE LTR max snoop Latency 24
+                                                    ///< Offset 214     PCIE LTR max snoop Latency 25
+                                                    ///< Offset 216     PCIE LTR max snoop Latency 26
+                                                    ///< Offset 218     PCIE LTR max snoop Latency 27
+                                                    ///< Offset 220     PCIE LTR max snoop Latency 28
+  UINT16   PcieLtrMaxNoSnoopLatency[28];            ///< Offset 222     PCIE LTR max no snoop Latency 1
+                                                    ///< Offset 224     PCIE LTR max no snoop Latency 2
+                                                    ///< Offset 226     PCIE LTR max no snoop Latency 3
+                                                    ///< Offset 228     PCIE LTR max no snoop Latency 4
+                                                    ///< Offset 230     PCIE LTR max no snoop Latency 5
+                                                    ///< Offset 232     PCIE LTR max no snoop Latency 6
+                                                    ///< Offset 234     PCIE LTR max no snoop Latency 7
+                                                    ///< Offset 236     PCIE LTR max no snoop Latency 8
+                                                    ///< Offset 238     PCIE LTR max no snoop Latency 9
+                                                    ///< Offset 240     PCIE LTR max no snoop Latency 10
+                                                    ///< Offset 242     PCIE LTR max no snoop Latency 11
+                                                    ///< Offset 244     PCIE LTR max no snoop Latency 12
+                                                    ///< Offset 246     PCIE LTR max no snoop Latency 13
+                                                    ///< Offset 248     PCIE LTR max no snoop Latency 14
+                                                    ///< Offset 250     PCIE LTR max no snoop Latency 15
+                                                    ///< Offset 252     PCIE LTR max no snoop Latency 16
+                                                    ///< Offset 254     PCIE LTR max no snoop Latency 17
+                                                    ///< Offset 256     PCIE LTR max no snoop Latency 18
+                                                    ///< Offset 258     PCIE LTR max no snoop Latency 19
+                                                    ///< Offset 260     PCIE LTR max no snoop Latency 20
+                                                    ///< Offset 262     PCIE LTR max no snoop Latency 21
+                                                    ///< Offset 264     PCIE LTR max no snoop Latency 22
+                                                    ///< Offset 266     PCIE LTR max no snoop Latency 23
+                                                    ///< Offset 268     PCIE LTR max no snoop Latency 24
+                                                    ///< Offset 270     PCIE LTR max no snoop Latency 25
+                                                    ///< Offset 272     PCIE LTR max no snoop Latency 26
+                                                    ///< Offset 274     PCIE LTR max no snoop Latency 27
+                                                    ///< Offset 276     PCIE LTR max no snoop Latency 28
+  UINT8    XHPC;                                    ///< Offset 278     Number of HighSpeed ports implemented in XHCI controller
+  UINT8    XRPC;                                    ///< Offset 279     Number of USBR ports implemented in XHCI controller
+  UINT8    XSPC;                                    ///< Offset 280     Number of SuperSpeed ports implemented in XHCI controller
+  UINT8    XSPA;                                    ///< Offset 281     Address of 1st SuperSpeed port
+  UINT32   HPTB;                                    ///< Offset 282     HPET base address
+  UINT8    HPTE;                                    ///< Offset 286     HPET enable
+  //SerialIo block
+  UINT8    SM0[7];                                  ///< Offset 287     SerialIo SPI Controller 0 Mode
+                                                    ///< Offset 288     SerialIo SPI Controller 1 Mode
+                                                    ///< Offset 289     SerialIo SPI Controller 2 Mode
+                                                    ///< Offset 290     SerialIo SPI Controller 3 Mode
+                                                    ///< Offset 291     SerialIo SPI Controller 4 Mode
+                                                    ///< Offset 292     SerialIo SPI Controller 5 Mode
+                                                    ///< Offset 293     SerialIo SPI Controller 6 Mode
+  UINT64   SC0[7];                                  ///< Offset 294     SerialIo SPI Controller 0 Pci Config
+                                                    ///< Offset 302     SerialIo SPI Controller 1 Pci Config
+                                                    ///< Offset 310     SerialIo SPI Controller 2 Pci Config
+                                                    ///< Offset 318     SerialIo SPI Controller 3 Pci Config
+                                                    ///< Offset 326     SerialIo SPI Controller 4 Pci Config
+                                                    ///< Offset 334     SerialIo SPI Controller 5 Pci Config
+                                                    ///< Offset 342     SerialIo SPI Controller 6 Pci Config
+  UINT8    IM0[8];                                  ///< Offset 350     SerialIo I2C Controller 0 Mode
+                                                    ///< Offset 351     SerialIo I2C Controller 1 Mode
+                                                    ///< Offset 352     SerialIo I2C Controller 2 Mode
+                                                    ///< Offset 353     SerialIo I2C Controller 3 Mode
+                                                    ///< Offset 354     SerialIo I2C Controller 4 Mode
+                                                    ///< Offset 355     SerialIo I2C Controller 5 Mode
+                                                    ///< Offset 356     SerialIo I2C Controller 6 Mode
+                                                    ///< Offset 357     SerialIo I2C Controller 7 Mode
+  UINT64   IC0[8];                                  ///< Offset 358     SerialIo I2C Controller 0 Pci Config
+                                                    ///< Offset 366     SerialIo I2C Controller 1 Pci Config
+                                                    ///< Offset 374     SerialIo I2C Controller 2 Pci Config
+                                                    ///< Offset 382     SerialIo I2C Controller 3 Pci Config
+                                                    ///< Offset 390     SerialIo I2C Controller 4 Pci Config
+                                                    ///< Offset 398     SerialIo I2C Controller 5 Pci Config
+                                                    ///< Offset 406     SerialIo I2C Controller 6 Pci Config
+                                                    ///< Offset 414     SerialIo I2C Controller 7 Pci Config
+  UINT8    UM0[7];                                  ///< Offset 422     SerialIo UART Controller 0 Mode
+                                                    ///< Offset 423     SerialIo UART Controller 1 Mode
+                                                    ///< Offset 424     SerialIo UART Controller 2 Mode
+                                                    ///< Offset 425     SerialIo UART Controller 3 Mode
+                                                    ///< Offset 426     SerialIo UART Controller 4 Mode
+                                                    ///< Offset 427     SerialIo UART Controller 5 Mode
+                                                    ///< Offset 428     SerialIo UART Controller 6 Mode
+  UINT64   UC0[7];                                  ///< Offset 429     SerialIo UART Controller 0 Pci Config
+                                                    ///< Offset 437     SerialIo UART Controller 1 Pci Config
+                                                    ///< Offset 445     SerialIo UART Controller 2 Pci Config
+                                                    ///< Offset 453     SerialIo UART Controller 3 Pci Config
+                                                    ///< Offset 461     SerialIo UART Controller 4 Pci Config
+                                                    ///< Offset 469     SerialIo UART Controller 5 Pci Config
+                                                    ///< Offset 477     SerialIo UART Controller 6 Pci Config
+  UINT8    UD0[7];                                  ///< Offset 485     SerialIo UART Controller 0 DmaEnable
+                                                    ///< Offset 486     SerialIo UART Controller 1 DmaEnable
+                                                    ///< Offset 487     SerialIo UART Controller 2 DmaEnable
+                                                    ///< Offset 488     SerialIo UART Controller 3 DmaEnable
+                                                    ///< Offset 489     SerialIo UART Controller 4 DmaEnable
+                                                    ///< Offset 490     SerialIo UART Controller 5 DmaEnable
+                                                    ///< Offset 491     SerialIo UART Controller 6 DmaEnable
+  UINT8    UP0[7];                                  ///< Offset 492     SerialIo UART Controller 0 Power Gating
+                                                    ///< Offset 493     SerialIo UART Controller 1 Power Gating
+                                                    ///< Offset 494     SerialIo UART Controller 2 Power Gating
+                                                    ///< Offset 495     SerialIo UART Controller 3 Power Gating
+                                                    ///< Offset 496     SerialIo UART Controller 4 Power Gating
+                                                    ///< Offset 497     SerialIo UART Controller 5 Power Gating
+                                                    ///< Offset 498     SerialIo UART Controller 6 Power Gating
+  UINT8    UI0[7];                                  ///< Offset 499     SerialIo UART Controller 0 Irq
+                                                    ///< Offset 500     SerialIo UART Controller 1 Irq
+                                                    ///< Offset 501     SerialIo UART Controller 2 Irq
+                                                    ///< Offset 502     SerialIo UART Controller 3 Irq
+                                                    ///< Offset 503     SerialIo UART Controller 4 Irq
+                                                    ///< Offset 504     SerialIo UART Controller 5 Irq
+                                                    ///< Offset 505     SerialIo UART Controller 6 Irq
+  //end of SerialIo block
+  UINT8    SGIR;                                    ///< Offset 506     GPIO IRQ
+  UINT8    GPHD;                                    ///< Offset 507     Hide GPIO ACPI device
+  UINT8    RstPcieStorageInterfaceType[3];          ///< Offset 508     RST PCIe Storage Cycle Router#1 Interface Type
+                                                    ///< Offset 509     RST PCIe Storage Cycle Router#2 Interface Type
+                                                    ///< Offset 510     RST PCIe Storage Cycle Router#3 Interface Type
+  UINT8    RstPcieStoragePmCapPtr[3];               ///< Offset 511     RST PCIe Storage Cycle Router#1 Power Management Capability Pointer
+                                                    ///< Offset 512     RST PCIe Storage Cycle Router#2 Power Management Capability Pointer
+                                                    ///< Offset 513     RST PCIe Storage Cycle Router#3 Power Management Capability Pointer
+  UINT8    RstPcieStoragePcieCapPtr[3];             ///< Offset 514     RST PCIe Storage Cycle Router#1 PCIe Capabilities Pointer
+                                                    ///< Offset 515     RST PCIe Storage Cycle Router#2 PCIe Capabilities Pointer
+                                                    ///< Offset 516     RST PCIe Storage Cycle Router#3 PCIe Capabilities Pointer
+  UINT16   RstPcieStorageL1ssCapPtr[3];             ///< Offset 517     RST PCIe Storage Cycle Router#1 L1SS Capability Pointer
+                                                    ///< Offset 519     RST PCIe Storage Cycle Router#2 L1SS Capability Pointer
+                                                    ///< Offset 521     RST PCIe Storage Cycle Router#3 L1SS Capability Pointer
+  UINT8    RstPcieStorageEpL1ssControl2[3];         ///< Offset 523     RST PCIe Storage Cycle Router#1 Endpoint L1SS Control Data2
+                                                    ///< Offset 524     RST PCIe Storage Cycle Router#2 Endpoint L1SS Control Data2
+                                                    ///< Offset 525     RST PCIe Storage Cycle Router#3 Endpoint L1SS Control Data2
+  UINT32   RstPcieStorageEpL1ssControl1[3];         ///< Offset 526     RST PCIe Storage Cycle Router#1 Endpoint L1SS Control Data1
+                                                    ///< Offset 530     RST PCIe Storage Cycle Router#2 Endpoint L1SS Control Data1
+                                                    ///< Offset 534     RST PCIe Storage Cycle Router#3 Endpoint L1SS Control Data1
+  UINT16   RstPcieStorageLtrCapPtr[3];              ///< Offset 538     RST PCIe Storage Cycle Router#1 LTR Capability Pointer
+                                                    ///< Offset 540     RST PCIe Storage Cycle Router#2 LTR Capability Pointer
+                                                    ///< Offset 542     RST PCIe Storage Cycle Router#3 LTR Capability Pointer
+  UINT32   RstPcieStorageEpLtrData[3];              ///< Offset 544     RST PCIe Storage Cycle Router#1 Endpoint LTR Data
+                                                    ///< Offset 548     RST PCIe Storage Cycle Router#2 Endpoint LTR Data
+                                                    ///< Offset 552     RST PCIe Storage Cycle Router#3 Endpoint LTR Data
+  UINT16   RstPcieStorageEpLctlData16[3];           ///< Offset 556     RST PCIe Storage Cycle Router#1 Endpoint LCTL Data
+                                                    ///< Offset 558     RST PCIe Storage Cycle Router#2 Endpoint LCTL Data
+                                                    ///< Offset 560     RST PCIe Storage Cycle Router#3 Endpoint LCTL Data
+  UINT16   RstPcieStorageEpDctlData16[3];           ///< Offset 562     RST PCIe Storage Cycle Router#1 Endpoint DCTL Data
+                                                    ///< Offset 564     RST PCIe Storage Cycle Router#2 Endpoint DCTL Data
+                                                    ///< Offset 566     RST PCIe Storage Cycle Router#3 Endpoint DCTL Data
+  UINT16   RstPcieStorageEpDctl2Data16[3];          ///< Offset 568     RST PCIe Storage Cycle Router#1 Endpoint DCTL2 Data
+                                                    ///< Offset 570     RST PCIe Storage Cycle Router#2 Endpoint DCTL2 Data
+                                                    ///< Offset 572     RST PCIe Storage Cycle Router#3 Endpoint DCTL2 Data
+  UINT16   RstPcieStorageRpDctl2Data16[3];          ///< Offset 574     RST PCIe Storage Cycle Router#1 RootPort DCTL2 Data
+                                                    ///< Offset 576     RST PCIe Storage Cycle Router#2 RootPort DCTL2 Data
+                                                    ///< Offset 578     RST PCIe Storage Cycle Router#3 RootPort DCTL2 Data
+  UINT32   RstPcieStorageUniqueTableBar[3];         ///< Offset 580     RST PCIe Storage Cycle Router#1 Endpoint unique MSI-X Table BAR
+                                                    ///< Offset 584     RST PCIe Storage Cycle Router#2 Endpoint unique MSI-X Table BAR
+                                                    ///< Offset 588     RST PCIe Storage Cycle Router#3 Endpoint unique MSI-X Table BAR
+  UINT32   RstPcieStorageUniqueTableBarValue[3];    ///< Offset 592     RST PCIe Storage Cycle Router#1 Endpoint unique MSI-X Table BAR value
+                                                    ///< Offset 596     RST PCIe Storage Cycle Router#2 Endpoint unique MSI-X Table BAR value
+                                                    ///< Offset 600     RST PCIe Storage Cycle Router#3 Endpoint unique MSI-X Table BAR value
+  UINT32   RstPcieStorageUniquePbaBar[3];           ///< Offset 604     RST PCIe Storage Cycle Router#1 Endpoint unique MSI-X PBA BAR
+                                                    ///< Offset 608     RST PCIe Storage Cycle Router#2 Endpoint unique MSI-X PBA BAR
+                                                    ///< Offset 612     RST PCIe Storage Cycle Router#3 Endpoint unique MSI-X PBA BAR
+  UINT32   RstPcieStorageUniquePbaBarValue[3];      ///< Offset 616     RST PCIe Storage Cycle Router#1 Endpoint unique MSI-X PBA BAR value
+                                                    ///< Offset 620     RST PCIe Storage Cycle Router#2 Endpoint unique MSI-X PBA BAR value
+                                                    ///< Offset 624     RST PCIe Storage Cycle Router#3 Endpoint unique MSI-X PBA BAR value
+  UINT32   RstPcieStorageRootPortNum[3];            ///< Offset 628     RST PCIe Storage Cycle Router#1 Root Port number
+                                                    ///< Offset 632     RST PCIe Storage Cycle Router#2 Root Port number
+                                                    ///< Offset 636     RST PCIe Storage Cycle Router#3 Root Port number
+  UINT8    EMH4;                                    ///< Offset 640     eMMC HS400 mode enabled
+  UINT8    EMDS;                                    ///< Offset 641     eMMC Driver Strength
+  UINT8    CpuSku;                                  ///< Offset 642     CPU SKU
+  UINT16   IoTrapAddress[4];                        ///< Offset 643
+  UINT8    IoTrapStatus[4];                         ///< Offset 651
+  UINT16   PMBS;                                    ///< Offset 655     ACPI IO BASE address
+  UINT32   PWRM;                                    ///< Offset 657     PWRM MEM BASE address
+  // CNVi specific
+  UINT8    CnviMode;                                ///< Offset 661     CNVi mode
+  UINT8    CnviBtCore;                              ///< Offset 662     CNVi BT Core
+  UINT8    CnviBtAudioOffload;                      ///< Offset 663     CNVi BT Audio Offload
+  // PCH Trace Hub
+  UINT8    PchTraceHubMode;                         ///< Offset 664     PCH Trace Hub Mode
+  // PCH PS_ON support
+  UINT8    PsOnEnable;                              ///< Offset 665     PCH PS_ON enable
+  //
+  // These are for PchApciTablesSelfTest use
+  //
+  UINT8    LtrEnable[24];                           ///< Offset 666     Latency Tolerance Reporting Enable
+                                                    ///< Offset 667     Latency Tolerance Reporting Enable
+                                                    ///< Offset 668     Latency Tolerance Reporting Enable
+                                                    ///< Offset 669     Latency Tolerance Reporting Enable
+                                                    ///< Offset 670     Latency Tolerance Reporting Enable
+                                                    ///< Offset 671     Latency Tolerance Reporting Enable
+                                                    ///< Offset 672     Latency Tolerance Reporting Enable
+                                                    ///< Offset 673     Latency Tolerance Reporting Enable
+                                                    ///< Offset 674     Latency Tolerance Reporting Enable
+                                                    ///< Offset 675     Latency Tolerance Reporting Enable
+                                                    ///< Offset 676     Latency Tolerance Reporting Enable
+                                                    ///< Offset 677     Latency Tolerance Reporting Enable
+                                                    ///< Offset 678     Latency Tolerance Reporting Enable
+                                                    ///< Offset 679     Latency Tolerance Reporting Enable
+                                                    ///< Offset 680     Latency Tolerance Reporting Enable
+                                                    ///< Offset 681     Latency Tolerance Reporting Enable
+                                                    ///< Offset 682     Latency Tolerance Reporting Enable
+                                                    ///< Offset 683     Latency Tolerance Reporting Enable
+                                                    ///< Offset 684     Latency Tolerance Reporting Enable
+                                                    ///< Offset 685     Latency Tolerance Reporting Enable
+                                                    ///< Offset 686     Latency Tolerance Reporting Enable
+                                                    ///< Offset 687     Latency Tolerance Reporting Enable
+                                                    ///< Offset 688     Latency Tolerance Reporting Enable
+                                                    ///< Offset 689     Latency Tolerance Reporting Enable
+  UINT8    GBES;                                    ///< Offset 690     GbE Support
+  UINT32   PchxDCIPwrDnScale;                       ///< Offset 691     PCH xDCI Power Down Scale Value, DWC_USB3_GCTL_INIT[31:19]
+  UINT8    EmmcEnabled;                             ///< Offset 695     Set to indicate that eMMC is enabled
+  UINT8    SdCardEnabled;                           ///< Offset 696     Set to indicate that SD card is enabled
+  UINT8    EnableTimedGpio0;                        ///< Offset 697     Set to indicate that Timed GPIO 0 is enabled
+  UINT8    EnableTimedGpio1;                        ///< Offset 698     Set to indicate that Timed GPIO 1 is enabled
+  UINT8    ClockToRootPortMap[18];                  ///< Offset 699     CLOCK index to root port index map. Used during PCIe D3Cold flows
+  UINT16   TcoBase;                                 ///< Offset 717     TCO base address
+  UINT16   IclkPid;                                 ///< Offset 719     Iclk PID number
+  UINT16   CnviPortId;                              ///< Offset 721     CNVi sideband port id
+  UINT32   HybridStorageLocation;                   ///< Offset 723
+  UINT8    SataPortPresence;                        ///< Offset 727     Holds information from SATA PCS register about SATA ports which recieved COMINIT from connected devices.
+} PCH_NVS_AREA;
+
+#pragma pack(pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h
new file mode 100644
index 0000000000..428858afcf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h
@@ -0,0 +1,58 @@
+/** @file
+
+  Definitions required to create RstHob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_RST_HOB_
+#define _PCH_RST_HOB_
+
+extern EFI_GUID  gPchRstHobGuid;
+
+//
+// This struct is used to record the fields that should be restored during device wake up
+//
+typedef struct {
+  UINT8     PmCapPtr;
+  UINT8     PcieCapPtr;
+  UINT16    L1ssCapPtr;
+  UINT8     EndpointL1ssControl2;
+  UINT32    EndpointL1ssControl1;
+  UINT16    LtrCapPtr;
+  UINT32    EndpointLtrData;
+  UINT16    EndpointLctlData16;
+  UINT16    EndpointDctlData16;
+  UINT16    EndpointDctl2Data16;
+  UINT16    RootPortDctl2Data16;
+} SAVED_DEVICE_CONFIG_SPACE;
+
+//
+// This structure is used to record the result of PCIe storageremapping for each cycle router
+//
+typedef struct {
+  UINT8                                 RootPortNum;                      // Indicates the root port number with RST PCIe Storage Remapping remapping supported and PCIe storage device plugged on, numbering is 0-based
+  UINT8                                 DeviceInterface;                  // Indicates the interface of the PCIe storage device (AHCI or NVMe)
+  UINT32                                EndPointUniqueMsixTableBar;       // Records the PCIe storage device's MSI-X Table BAR if it supports unique MSI-X Table BAR
+  UINT32                                EndPointUniqueMsixTableBarValue;  // Records the PCIe storage device's MSI-X Table BAR value if it supports unique MSI-X Table BAR
+  UINT32                                EndPointUniqueMsixPbaBar;         // Records the PCIe storage device's MSI-X PBA BAR if it supports unique MSI-X PBA BAR
+  UINT32                                EndPointUniqueMsixPbaBarValue;    // Records the PCIe storage device's MSI-X PBA BAR value if it supports unique MSI-X PBA BAR
+} RST_CR_CONFIGURATION;
+
+//
+//  Passes to DXE results of PCIe storage remapping
+//
+typedef struct {
+  //
+  // Stores configuration information about cycle router
+  //
+  RST_CR_CONFIGURATION  RstCrConfiguration[PCH_MAX_RST_PCIE_STORAGE_CR];
+
+  //
+  // Saved fields from hidden device config space to be used later by RST driver
+  //
+  SAVED_DEVICE_CONFIG_SPACE  SavedRemapedDeviceConfigSpace[PCH_MAX_RST_PCIE_STORAGE_CR];
+} PCH_RST_HOB;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.h
new file mode 100644
index 0000000000..1c45d89225
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.h
@@ -0,0 +1,30 @@
+/** @file
+  This file defines the PCH NVS Area Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_NVS_AREA_H_
+#define _PCH_NVS_AREA_H_
+
+//
+// PCH NVS Area definition
+//
+#include <Pch/IncludePrivate/PchNvsAreaDef.h>
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                         gPchNvsAreaProtocolGuid;
+
+/**
+  This protocol is used to sync PCH information from POST to runtime ASL.
+  This protocol exposes the pointer of PCH NVS Area only. Please refer to
+  ASL definition for PCH NVS AREA.
+**/
+typedef struct {
+  PCH_NVS_AREA                          *Area;
+} PCH_NVS_AREA_PROTOCOL;
+
+#endif // _PCH_NVS_AREA_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
new file mode 100644
index 0000000000..ecea5db4fc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
@@ -0,0 +1,35 @@
+/** @file
+  This file defines the PCH PCIE IoTrap Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PCIE_IOTRAP_H_
+#define _PCH_PCIE_IOTRAP_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                       gPchPcieIoTrapProtocolGuid;
+
+//
+// Forward reference for ANSI C compatibility
+//
+typedef struct _PCH_PCIE_IOTRAP_PROTOCOL PCH_PCIE_IOTRAP_PROTOCOL;
+
+///
+/// Pcie Trap valid types
+///
+typedef enum {
+  PchPciePmTrap,
+  PcieTrapTypeMaximum
+} PCH_PCIE_TRAP_TYPE;
+
+/**
+ This protocol is used to provide the IoTrap address to trigger PCH PCIE call back events
+**/
+struct _PCH_PCIE_IOTRAP_PROTOCOL {
+  UINT16      PcieTrapAddress;
+};
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.h
new file mode 100644
index 0000000000..0d9b167588
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.h
@@ -0,0 +1,21 @@
+/** @file
+  This file contains definitions of Si Schedule Reset HOB.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SI_SCHEDULE_RESET_HOB_H_
+#define _SI_SCHEDULE_RESET_HOB_H_
+
+/**
+  This structure is used to provide information about PCH Resets
+**/
+typedef struct {
+  EFI_RESET_TYPE             ResetType;
+  PCH_RESET_DATA             ResetData;
+} SI_SCHEDULE_RESET_HOB;
+
+extern EFI_GUID gSiScheduleResetHobGuid;
+
+#endif // _SI_SCHEDULE_RESET_HOB_H_
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (4 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers Heng Luo
                   ` (33 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * SystemAgent/Include

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/MemoryDxeConfig.h       | 123 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDxeConfig.h         | 114 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramPreMemConfig.h      |  34 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiConfig.h       |  24 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiPreMemConfig.h | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatformLib.h             |  48 ++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h                        | 264 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h                 |  61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 8 files changed, 772 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/MemoryDxeConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/MemoryDxeConfig.h
new file mode 100644
index 0000000000..451e295b49
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/MemoryDxeConfig.h
@@ -0,0 +1,123 @@
+/** @file
+  Memory DXE Policy definitions
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _MEMORY_DXE_CONFIG_H_
+#define _MEMORY_DXE_CONFIG_H_
+
+#pragma pack(push, 1)
+
+#define MEMORY_DXE_CONFIG_REVISION 1
+
+typedef struct _MEMORY_DXE_CONFIG  MEMORY_DXE_CONFIG;
+
+/**
+  Retrieves the OEM custom string for the SMBIOS Type 17 Table DeviceLocator field.
+  Implementation of this function is optional, if this function pointer is NULL then
+  the reference implementation of DeviceLocator will be used.
+
+  @param[in]  This                          A pointer to this instance of MEMORY_DXE_CONFIG.
+  @param[in]  Controller                    Desired Controller to get a DeviceLocator string for.
+  @param[in]  Dimm                          Desired DIMM to get a DeviceLocator string for.
+  @param[in]  MdSocket                      0 = Memory Down, 1 = Socketed.
+
+  @retval                                   The DeviceLocator string
+  @retval     NULL                          If the return value is NULL, the default value will be used.
+**/
+typedef
+CHAR8*
+(EFIAPI *MEMORY_DXE_CONFIG_GET_DEVICE_LOCATOR_STRING)(
+  IN CONST    MEMORY_DXE_CONFIG   *This,
+  IN          UINT8               Controller,
+  IN          UINT8               Dimm,
+  IN          UINT8               MdSocket
+  );
+
+/**
+  Retrieves the OEM custom string for the SMBIOS Type 17 Table BankLocator field.
+  Implementation of this function is optional, if this function pointer is NULL then
+  the reference implementation of DeviceLocator will be used.
+
+  @param[in]  This                          A pointer to this instance of MEMORY_DXE_CONFIG.
+  @param[in]  Controller                    Desired Controller to get a BankLocator string for.
+  @param[in]  Dimm                          Desired DIMM to get a BankLocator string for.
+  @param[in]  MdSocket                      0 = Memory Down, 1 = Socketed.
+
+  @retval                                   The BankLocator string
+  @retval     NULL                          If the return value is NULL, the default value will be used.
+**/
+typedef
+CHAR8*
+(EFIAPI *MEMORY_DXE_CONFIG_GET_BANK_LOCATOR_STRING)(
+  IN CONST    MEMORY_DXE_CONFIG   *This,
+  IN          UINT8               Controller,
+  IN          UINT8               Dimm,
+  IN          UINT8               MdSocket
+  );
+
+/**
+  The Memory Configuration includes DIMM SPD address Map and DIMM Slot Mechanical present bit map.
+  The data elements should be initialized by a Platform Module.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+struct _MEMORY_DXE_CONFIG {
+  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27: Config Block Header
+/**
+  Offset 28:
+  Dimm SPD address
+  Only Server support 2 channels * 3 slots per channel = 6 sockets totally
+  The Desktop and mobile only support 2 channels * 2 slots per channel = 4 sockets totally
+  So there is mapping rule here for Desktop and mobile that there are no more 4 DIMMS totally in a system:
+    Channel A/ Slot 0 --> Dimm 0 --> SpdAddressTable[0]
+    Channel A/ Slot 1 --> Dimm 1 --> SpdAddressTable[1]
+    Channel B/ Slot 0 --> Dimm 2 --> SpdAddressTable[2]
+    Channel B/ Slot 1 --> Dimm 3 --> SpdAddressTable[3]
+  Refer to SmbiosMemory.c for use
+  If change the mapping rule, please update the Revision number.
+**/
+  UINT8                                           *SpdAddressTable;
+/**
+  Offset 36:
+  Channel A DIMM Slot Mechanical present bit map, bit 0 -> DIMM 0, bit 1 -> DIMM1, ...
+  if the bit is 1, the related DIMM slot is present.
+  E.g. if channel A has 2 DIMMs,  ChannelASlotMap = 0x03;
+  E.g. if channel A has only 1 DIMMs,  ChannelASlotMap = 0x01;
+  Refer to SmbiosMemory.c
+**/
+  UINT8                                           ChannelASlotMap;
+/**
+  Offset 37:
+  Channel B DIMM Slot Mechanical present bit map, bit 0 -> DIMM 0, bit 1 -> DIMM1, ...
+  if the bit is 1, the related DIMM slot is present.
+  E.g. if channel B has 2 DIMMs,  ChannelBSlotMap = 0x03;
+  E.g. if channel B has only 1 DIMMs,  ChannelBSlotMap = 0x01;
+  Refer to SmbiosMemory.c
+**/
+  UINT8                                           ChannelBSlotMap;
+/**
+  Offset 38:
+  MRC execution time measurement: <b>0=Disable</b>, 1=Enable
+**/
+  UINT8                                           MrcTimeMeasure;
+/**
+  Offset 39:
+  Fast boot: 0=Disable, <b>1=Enable</b>
+**/
+  UINT8                                           MrcFastBoot;
+/**
+  Offset 40:
+  Retrieves the OEM custom string for the SMBIOS Type 17 Table DeviceLocator field.
+**/
+  MEMORY_DXE_CONFIG_GET_DEVICE_LOCATOR_STRING     GetDeviceLocatorString;
+/**
+  Offset 48:
+  Retrieves the OEM custom string for the SMBIOS Type 17 Table BankLocator field.
+**/
+  MEMORY_DXE_CONFIG_GET_BANK_LOCATOR_STRING       GetBankLocatorString;
+};
+#pragma pack(pop)
+
+#endif // _MEMORY_DXE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDxeConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDxeConfig.h
new file mode 100644
index 0000000000..799121f1ab
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDxeConfig.h
@@ -0,0 +1,114 @@
+/** @file
+  PCIE DXE policy definitions
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCIE_DXE_CONFIG_H_
+#define _PCIE_DXE_CONFIG_H_
+
+#include "CpuPcieInfo.h"
+
+#pragma pack(push, 1)
+
+#define PCIE_DXE_CONFIG_REVISION 2
+
+typedef struct {
+  UINT16  VendorId; ///< Offset 0 PCI Config space offset 0
+  UINT16  DeviceId; ///< Offset 2 PCI Config space offset 2
+/**
+  Offset 4:
+  SnoopLatency bit definition
+  Note: All Reserved bits must be set to 0
+
+  BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                When clear values in bits 9:0 will be ignored
+  BIT[14]     - Should be set to 0b
+  BIT[13]     - Reserved
+  BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                000b - 1 ns
+                001b - 32 ns
+                010b - 1024 ns
+                011b - 32,768 ns
+                100b - 1,048,576 ns
+                101b - 33,554,432 ns
+                110b - Reserved
+                111b - Reserved
+  BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied with
+                the scale in bits 12:10
+**/
+  UINT16  SnoopLatency;
+/**
+  Offset 6:
+  NonSnoopLatency bit definition
+  Note: All Reserved bits must be set to 0
+
+  BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
+                When clear values in bits 9:0 will be ignored
+  BIT[14]     - Should be set to 0b
+  BIT[13]     - Reserved
+  BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
+                000b - 1 ns
+                001b - 32 ns
+                010b - 1024 ns
+                011b - 32,768 ns
+                100b - 1,048,576 ns
+                101b - 33,554,432 ns
+                110b - Reserved
+                111b - Reserved
+  BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be multiplied with
+                the scale in bits 12:10
+**/
+  UINT16  NonSnoopLatency;
+  UINT8   RevId;    ///<   Offset 8 PCI Config space offset 8; 0xFF means all steppings
+  UINT8   Rsvd0[3]; ///<   Offset 9
+} PCIE_LTR_DEV_INFO;
+
+///
+/// PCIE Power Optimizer config
+///
+typedef struct {
+  UINT16  LtrMaxSnoopLatency;   ///< Offset 0 LTR Maximum Snoop Latency: <b>0x0846=70us</b>
+  UINT16  LtrMaxNoSnoopLatency; ///< Offset 2 LTR Maximum Non-Snoop Latency: <b>0x0846=70us</b>
+  UINT8   ObffEnable;           ///< Offset 4 LTR enable/disable: 0=Disable, <b>1=Enable</b>
+  UINT8   LtrEnable;            ///< Offset 5 LTR enable/disable: 0=Disable, <b>1=Enable</b>
+  UINT8   Rsvd0[2];             ///< Offset 6 Reserved
+} CPU_PCIE_PWR_OPT;
+
+
+/**
+  The PCI Express Configuration info includes PCI Resources Range Base and Limits and the control
+  for PEG ASPM.
+  The data elements should be initialized by a Platform Module.\n
+  @note <b>Optional.</b> These policies will be ignored if there is no PEG port present on board.
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  -  Adding PEG RTD3 Support Setup Variable
+  <b>Revision 3</b>:
+  -  Adding CPU PCIE RTD3 Support Setup Variable
+  -  Deprecating PEG RTD3 Support Setup Variable
+  <b>Revision 4</b>:
+  -  Deprecating CPU PCIE RTD3 Support Setup Variable
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER      Header;                         ///< Offset 0-27 Config Block Header
+/**
+  Offset 28: This field is used to describe the ASPM control for PEG Ports\n
+  0=ASPM Disabled, 1=ASPM L0s Enabled, 2=ASPM L1 Enabled, 3=ASPM L0sL1 Enabled, <b>4=ASPM AUTO</b>
+**/
+  UINT8                    PegAspm[SA_PEG_MAX_FUN];
+/**
+  Offset 32: PCIe Hot Plug Enable/Disable. It has 2 policies.
+   - <b>Disabled (0x0)</b>     : No hotplug.
+   - Enabled (0x1)      : Bios assist hotplug.
+**/
+  UINT8                    PegRootPortHPE[SA_PEG_MAX_FUN];
+  CPU_PCIE_PWR_OPT          PegPwrOpt[SA_PEG_MAX_FUN];     ///< Offset 36: This field is used to describe the PCIe LTR/OBFF relevant settings
+  UINT32                   PegRtd3;                       ///  Deprecated Policy
+  UINT8                    CpuPcieRtd3;                   ///< Enable/Disable RTD3 Support for CPU PCIE. 0=Disable and 1=Enable (default)  // Deprecated Policy
+  UINT8                    Rsvd3[3];
+} PCIE_DXE_CONFIG;
+#pragma pack(pop)
+
+#endif // _PCIE_DXE_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramPreMemConfig.h
new file mode 100644
index 0000000000..8947e80b22
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramPreMemConfig.h
@@ -0,0 +1,34 @@
+/** @file
+  Policy definition for Persisted Ram (Pram) Config Block
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PRAM_PREMEM_CONFIG__H_
+#define _PRAM_PREMEM_CONFIG__H_
+#pragma pack(push, 1)
+
+#define PRAM_PREMEM_CONFIG_REVISION 1
+
+/**
+ Defines Pram configuration parameters.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;    ///< Offset 0-27 Config Block Header
+  /**
+  Offset 28:
+  Size of Pram
+  If disabled, or if PcdSaOcEnable is disabled, all other policies in this config block are ignored.
+  <b>0=Disable</b>,
+  1=4MB,
+  2=16MB,
+  3=64MB
+  **/
+  UINT8   Pram;
+  UINT8   Rsvd[3];                ///< Offset 29 Reserved for DWORD alignment
+} PRAM_PREMEM_CONFIG;
+#pragma pack(pop)
+
+#endif // _PRAM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiConfig.h
new file mode 100644
index 0000000000..203d894df9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiConfig.h
@@ -0,0 +1,24 @@
+/** @file
+  Policy details for miscellaneous configuration in System Agent
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_MISC_PEI_CONFIG_H_
+#define _SA_MISC_PEI_CONFIG_H_
+
+#pragma pack(push, 1)
+
+#define SA_MISC_PEI_CONFIG_REVISION 1
+
+/**
+  This configuration block is to configure SA Miscellaneous variables during PEI Post-Mem.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block Header
+} SA_MISC_PEI_CONFIG;
+#pragma pack(pop)
+
+#endif // _SA_MISC_PEI_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiPreMemConfig.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiPreMemConfig.h
new file mode 100644
index 0000000000..8c660b31a9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscPeiPreMemConfig.h
@@ -0,0 +1,104 @@
+/** @file
+  Policy details for miscellaneous configuration in System Agent
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_MISC_PEI_PREMEM_CONFIG_H_
+#define _SA_MISC_PEI_PREMEM_CONFIG_H_
+
+#pragma pack(push, 1)
+
+#ifndef MEM_CFG_MAX_SOCKETS
+#define MEM_CFG_MAX_SOCKETS 16
+#endif
+
+#define SA_MISC_PEI_PREMEM_CONFIG_REVISION 2
+
+/**
+  This configuration block is to configure SA Miscellaneous variables during PEI Pre-Mem phase like programming
+  different System Agent BARs, TsegSize, MmioSize required etc.
+  <b>Revision 1</b>:
+  - Initial version.
+  <b>Revision 2</b>:
+  - Deprecate IedSize.
+**/
+typedef struct {
+  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block Header
+  /**
+    Offset 28 Memory DIMMs' SPD address for reading SPD data.
+    TGL Mapping
+      0 - Controller 0 Channel 0 Dimm 0 - DDR4 - DDR5 - LPDDR4 - LPDDR5
+      1 - Controller 0 Channel 0 Dimm 1 - DDR4
+      2 - Controller 0 Channel 1 Dimm 0 -------- DDR5 - LPDDR4 - LPDDR5
+      3 - Controller 0 Channel 1 Dimm 1 -------- DDR5 2DPC
+      4 - Controller 0 Channel 2 Dimm 0 --------------- LPDDR4 - LPDDR5
+      6 - Controller 0 Channel 3 Dimm 0 --------------- LPDDR4 - LPDDR5
+      8 - Controller 1 Channel 0 Dimm 0 - DDR4 - DDR5 - LPDDR4 - LPDDR5
+      9 - Controller 1 Channel 0 Dimm 1 - DDR4
+     10 - Controller 1 Channel 1 Dimm 0 -------- DDR5 - LPDDR4 - LPDDR5
+     11 - Controller 1 Channel 1 Dimm 1 -------- DDR5 2DPC
+     12 - Controller 1 Channel 2 Dimm 0 --------------- LPDDR4 - LPDDR5
+     14 - Controller 1 Channel 3 Dimm 0 --------------- LPDDR4 - LPDDR5
+  **/
+  UINT8   SpdAddressTable[MEM_CFG_MAX_SOCKETS];
+  VOID    *S3DataPtr;                        ///< Offset 44 Memory data save pointer for S3 resume. The memory space should be allocated and filled with proper S3 resume data on a resume path
+  UINT32  SmbusBar;                          ///< Offset 48 Address of System Agent SMBUS BAR: <b>0xEFA0</b>
+  /**
+    Offset 52 Size of TSEG in bytes. (Must be power of 2)
+    <b>0x400000</b>: 4MB for Release build (When IED enabled, it will be 8MB)
+    0x1000000      : 16MB for Debug build (Regardless IED enabled or disabled)
+  **/
+  UINT32  TsegSize;
+  /**
+    Offset 56
+    <b>(Test)</b> Size of IED region in bytes.
+    <b>0</b> : IED Disabled (no memory occupied)
+    0x400000 : 4MB SMM memory occupied by IED (Part of TSEG)
+    <b>Note: Enabling IED may also enlarge TsegSize together.</b>
+    @deprecated
+  **/
+  UINT32  IedSize;
+  UINT32  SkipExtGfxScan:1;                  ///< <b>(Test)</b> OFfset 60:0 :1=Skip External Gfx Device Scan; <b>0=Scan for external graphics devices</b>. Set this policy to skip External Graphics card scanning if the platform uses Internal Graphics only.
+  UINT32  BdatEnable:1;                      ///< Offset 60:1 :This field enables the generation of the BIOS DATA ACPI Tables: <b>0=FALSE</b>, 1=TRUE.
+  UINT32  TxtImplemented:1;                  ///< OFfset 60:2 :This field currently is used to tell MRC if it should run after TXT initializatoin completed: <b>0=Run without waiting for TXT</b>, 1=Run after TXT initialization by callback
+  /**
+   Offset 60:3 :
+   <b>(Test)</b> Scan External Discrete Graphics Devices for Legacy Only VGA OpROMs
+
+   When enabled, if the primary graphics device is an external discrete graphics device, Si will scan the
+   graphics device for legacy only VGA OpROMs.
+
+   This is intended to ease the implementation of a BIOS feature to automatically enable CSM if the Primary Gfx device
+   only supports Legacy VBIOS (No UEFI GOP Present).  Otherwise disabling CSM won't result in no video being displayed.
+   This is useful for platforms that implement PCIe slots that allow the end user to install an arbitrary Gfx device.
+
+   This setting will only take effect if SkipExtGfxScan == 0.  It is ignored otherwise.
+
+  - Disabled (0x0)         : Don't Scan for Legacy Only VGA OpROMs (Default)
+  - <b>Enabled</b>  (0x1)  : Scan External Gfx for Legacy Only VGA OpROM
+  **/
+  UINT32  ScanExtGfxForLegacyOpRom:1;
+  UINT32  RsvdBits0  :28;                    ///< Offset 60:4 :Reserved for future use
+  UINT8   UserBd;                            ///< Offset 64 <b>0=Mobile/Mobile Halo</b>, 1=Desktop/DT Halo, 5=ULT/ULX/Mobile Halo, 7=UP Server
+  UINT8   LockPTMregs;                       ///< <b>(Test)</b> Offset 65 Lock PCU Thermal Management registers: 0=FALSE, <b>1=TRUE</b>
+  UINT8   BdatTestType;                      ///< Offset 66 When BdatEnable is set to TRUE, this option selects the type of data which will be populated in the BIOS Data ACPI Tables: <b>0=RMT</b>, 1=RMT Per Bit, 2=Margin 2D.
+  UINT8   CridEnable;                        ///< Offset 67 For Platforms supporting Intel(R) SIPP, this policy is use control enable/disable Compatibility Revision ID (CRID) feature: <b>0=FALSE</b>, 1=TRUE
+  UINT32  AcpiReservedMemorySize;            ///< Offset 68 The Size of a Reserved memory buffer allocated in previous boot for S3 resume used. Originally it is retrieved from AcpiVariableCompatibility variable.
+  UINT32  OpRomScanTempMmioBar;              ///< <b>(Test)</b> Offset 72 Temporary address to MMIO map OpROMs during VGA scanning.  Used for ScanExtGfxForLegacyOpRom feature.  MUST BE 16MB ALIGNED!
+  UINT32  OpRomScanTempMmioLimit;            ///< <b>(Test)</b> Offset 76 Limit address for OpROM MMIO range.  Used for ScanExtGfxForLegacyOpRom feature. (OpROMScanTempMmioLimit - OpRomScanTempMmioBar) MUST BE >= 16MB!
+  UINT64  AcpiReservedMemoryBase;            ///< Offset 80 The Base address of a Reserved memory buffer allocated in previous boot for S3 resume used. Originally it is retrieved from AcpiVariableCompatibility variable.
+  UINT64  SystemMemoryLength;                ///< Offset 88 Total system memory length from previous boot, this is required for S3 resume. Originally it is retrieved from AcpiVariableCompatibility variable.
+
+  UINT8   WrcFeatureEnable;                   ///< Offset 96: Enable/Disable WRC (Write Cache) feature of IOP. When enabled, supports IO devices allocating onto the ring and into LLC.
+  UINT8   Reserved1[3];                       ///< Reserved for config block alignment.
+
+
+  // Since the biggest element is UINT64, this structure should be aligned with 64 bits.
+  UINT8   Rsvd[4];                           ///< Reserved for config block alignment.
+
+
+} SA_MISC_PEI_PREMEM_CONFIG;
+#pragma pack(pop)
+
+#endif // _SA_MISC_PEI_PREMEM_CONFIG_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatformLib.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatformLib.h
new file mode 100644
index 0000000000..daf3746605
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatformLib.h
@@ -0,0 +1,48 @@
+/** @file
+  Header file for SaPlatformLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SA_PLATFORM_LIB_H_
+#define _SA_PLATFORM_LIB_H_
+
+
+/**
+  Checks if SKU is Mobile
+
+  @retval FALSE  SKU is not Mobile
+  @retval TRUE   SKU is Mobile
+**/
+BOOLEAN
+EFIAPI
+IsMobileSku (
+  VOID
+  );
+
+/**
+  Checks if SKU is Desktop
+
+  @retval FALSE  SKU is not Desktop
+  @retval TRUE   SKU is Desktop
+**/
+BOOLEAN
+EFIAPI
+IsDesktopSku (
+  VOID
+  );
+
+/**
+  Checks if SKU is Server
+
+  @retval FALSE  SKU is not Server
+  @retval TRUE   SKU is Server
+**/
+BOOLEAN
+EFIAPI
+IsServerSku (
+  VOID
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
new file mode 100644
index 0000000000..b50d7e5188
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
@@ -0,0 +1,264 @@
+/** @file
+  This file contains definitions required for creation of
+  Memory S3 Save data, Memory Info data and Memory Platform
+  data hobs.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _MEM_INFO_HOB_H_
+#define _MEM_INFO_HOB_H_
+
+#pragma pack (push, 1)
+
+extern EFI_GUID gSiMemoryS3DataGuid;
+extern EFI_GUID gSiMemoryInfoDataGuid;
+extern EFI_GUID gSiMemoryPlatformDataGuid;
+
+#define MAX_TRACE_CACHE_TYPE  3
+
+#define MAX_NODE        2
+#define MAX_CH          4
+#define MAX_DIMM        2
+
+///
+/// Host reset states from MRC.
+///
+#define  WARM_BOOT        2
+
+#define R_MC_CHNL_RANK_PRESENT  0x7C
+#define   B_RANK0_PRS           BIT0
+#define   B_RANK1_PRS           BIT1
+#define   B_RANK2_PRS           BIT4
+#define   B_RANK3_PRS           BIT5
+
+// @todo remove and use the MdePkg\Include\Pi\PiHob.h
+#if !defined(_PEI_HOB_H_) && !defined(__PI_HOB_H__)
+#ifndef __HOB__H__
+typedef struct _EFI_HOB_GENERIC_HEADER {
+  UINT16  HobType;
+  UINT16  HobLength;
+  UINT32  Reserved;
+} EFI_HOB_GENERIC_HEADER;
+
+typedef struct _EFI_HOB_GUID_TYPE {
+  EFI_HOB_GENERIC_HEADER  Header;
+  EFI_GUID                Name;
+  ///
+  /// Guid specific data goes here
+  ///
+} EFI_HOB_GUID_TYPE;
+#endif
+#endif
+
+///
+/// Defines taken from MRC so avoid having to include MrcInterface.h
+///
+
+//
+// Matches MAX_SPD_SAVE define in MRC
+//
+#ifndef MAX_SPD_SAVE
+#define MAX_SPD_SAVE 29
+#endif
+
+//
+// MRC version description.
+//
+typedef struct {
+  UINT8  Major;     ///< Major version number
+  UINT8  Minor;     ///< Minor version number
+  UINT8  Rev;       ///< Revision number
+  UINT8  Build;     ///< Build number
+} SiMrcVersion;
+
+//
+// Matches MrcDimmSts enum in MRC
+//
+#ifndef DIMM_ENABLED
+#define DIMM_ENABLED     0  // DIMM/rank Pair is enabled, presence will be detected.
+#endif
+#ifndef DIMM_DISABLED
+#define DIMM_DISABLED    1  // DIMM/rank Pair is disabled, regardless of presence.
+#endif
+#ifndef DIMM_PRESENT
+#define DIMM_PRESENT     2  // There is a DIMM present in the slot/rank pair and it will be used.
+#endif
+#ifndef DIMM_NOT_PRESENT
+#define DIMM_NOT_PRESENT 3  // There is no DIMM present in the slot/rank pair.
+#endif
+
+//
+// Matches MrcBootMode enum in MRC
+//
+#ifndef __MRC_BOOT_MODE__
+#define __MRC_BOOT_MODE__                 //The below values are originated from MrcCommonTypes.h
+  #ifndef INT32_MAX
+  #define INT32_MAX                       (0x7FFFFFFF)
+  #endif  //INT32_MAX
+typedef enum {
+  bmCold,                                 ///< Cold boot
+  bmWarm,                                 ///< Warm boot
+  bmS3,                                   ///< S3 resume
+  bmFast,                                 ///< Fast boot
+  MrcBootModeMax,                         ///< MRC_BOOT_MODE enumeration maximum value.
+  MrcBootModeDelim = INT32_MAX            ///< This value ensures the enum size is consistent on both sides of the PPI.
+} MRC_BOOT_MODE;
+#endif  //__MRC_BOOT_MODE__
+
+//
+// Matches MrcDdrType enum in MRC
+//
+#ifndef MRC_DDR_TYPE_DDR4
+#define MRC_DDR_TYPE_DDR4     0
+#endif
+#ifndef MRC_DDR_TYPE_DDR3
+#define MRC_DDR_TYPE_DDR3     1
+#endif
+#ifndef MRC_DDR_TYPE_LPDDR3
+#define MRC_DDR_TYPE_LPDDR3   2
+#endif
+#ifndef MRC_DDR_TYPE_LPDDR4
+#define MRC_DDR_TYPE_LPDDR4   3
+#endif
+#ifndef MRC_DDR_TYPE_WIO2
+#define MRC_DDR_TYPE_WIO2     4
+#endif
+#ifndef MRC_DDR_TYPE_UNKNOWN
+#define MRC_DDR_TYPE_UNKNOWN  5
+#endif
+
+#define MAX_PROFILE_NUM     4 // number of memory profiles supported
+#define MAX_XMP_PROFILE_NUM 2 // number of XMP profiles supported
+
+//
+// DIMM timings
+//
+typedef struct {
+  UINT32 tCK;       ///< Memory cycle time, in femtoseconds.
+  UINT16 NMode;     ///< Number of tCK cycles for the channel DIMM's command rate mode.
+  UINT16 tCL;       ///< Number of tCK cycles for the channel DIMM's CAS latency.
+  UINT16 tCWL;      ///< Number of tCK cycles for the channel DIMM's minimum CAS write latency time.
+  UINT16 tFAW;      ///< Number of tCK cycles for the channel DIMM's minimum four activate window delay time.
+  UINT16 tRAS;      ///< Number of tCK cycles for the channel DIMM's minimum active to precharge delay time.
+  UINT16 tRCDtRP;   ///< Number of tCK cycles for the channel DIMM's minimum RAS# to CAS# delay time and Row Precharge delay time.
+  UINT16 tREFI;     ///< Number of tCK cycles for the channel DIMM's minimum Average Periodic Refresh Interval.
+  UINT16 tRFC;      ///< Number of tCK cycles for the channel DIMM's minimum refresh recovery delay time.
+  UINT16 tRFCpb;    ///< Number of tCK cycles for the channel DIMM's minimum per bank refresh recovery delay time.
+  UINT16 tRFC2;     ///< Number of tCK cycles for the channel DIMM's minimum refresh recovery delay time.
+  UINT16 tRFC4;     ///< Number of tCK cycles for the channel DIMM's minimum refresh recovery delay time.
+  UINT16 tRPab;     ///< Number of tCK cycles for the channel DIMM's minimum row precharge delay time for all banks.
+  UINT16 tRRD;      ///< Number of tCK cycles for the channel DIMM's minimum row active to row active delay time.
+  UINT16 tRRD_L;    ///< Number of tCK cycles for the channel DIMM's minimum row active to row active delay time for same bank groups.
+  UINT16 tRRD_S;    ///< Number of tCK cycles for the channel DIMM's minimum row active to row active delay time for different bank groups.
+  UINT16 tRTP;      ///< Number of tCK cycles for the channel DIMM's minimum internal read to precharge command delay time.
+  UINT16 tWR;       ///< Number of tCK cycles for the channel DIMM's minimum write recovery time.
+  UINT16 tWTR;      ///< Number of tCK cycles for the channel DIMM's minimum internal write to read command delay time.
+  UINT16 tWTR_L;    ///< Number of tCK cycles for the channel DIMM's minimum internal write to read command delay time for same bank groups.
+  UINT16 tWTR_S;    ///< Number of tCK cycles for the channel DIMM's minimum internal write to read command delay time for different bank groups.
+  UINT16 tCCD_L;  ///< Number of tCK cycles for the channel DIMM's minimum CAS-to-CAS delay for same bank group.
+} MRC_CH_TIMING;
+
+///
+/// Memory SMBIOS & OC Memory Data Hob
+///
+typedef struct {
+  UINT8            Status;                  ///< See MrcDimmStatus for the definition of this field.
+  UINT8            DimmId;
+  UINT32           DimmCapacity;            ///< DIMM size in MBytes.
+  UINT16           MfgId;
+  UINT8            ModulePartNum[20];       ///< Module part number for DDR3 is 18 bytes however for DRR4 20 bytes as per JEDEC Spec, so reserving 20 bytes
+  UINT8            RankInDimm;              ///< The number of ranks in this DIMM.
+  UINT8            SpdDramDeviceType;       ///< Save SPD DramDeviceType information needed for SMBIOS structure creation.
+  UINT8            SpdModuleType;           ///< Save SPD ModuleType information needed for SMBIOS structure creation.
+  UINT8            SpdModuleMemoryBusWidth; ///< Save SPD ModuleMemoryBusWidth information needed for SMBIOS structure creation.
+  UINT8            SpdSave[MAX_SPD_SAVE];   ///< Save SPD Manufacturing information needed for SMBIOS structure creation.
+  UINT16           Speed;                   ///< The maximum capable speed of the device, in MHz
+  UINT8            MdSocket;                ///< MdSocket: 0 = Memory Down, 1 = Socketed. Needed for SMBIOS structure creation.
+} DIMM_INFO;
+
+typedef struct {
+  UINT8            Status;                  ///< Indicates whether this channel should be used.
+  UINT8            ChannelId;
+  UINT8            DimmCount;               ///< Number of valid DIMMs that exist in the channel.
+  MRC_CH_TIMING    Timing[MAX_PROFILE_NUM]; ///< The channel timing values.
+  DIMM_INFO        DimmInfo[MAX_DIMM];      ///< Save the DIMM output characteristics.
+} CHANNEL_INFO;
+
+typedef struct {
+  UINT8            Status;                  ///< Indicates whether this controller should be used.
+  UINT16           DeviceId;                ///< The PCI device id of this memory controller.
+  UINT8            RevisionId;              ///< The PCI revision id of this memory controller.
+  UINT8            ChannelCount;            ///< Number of valid channels that exist on the controller.
+  CHANNEL_INFO     ChannelInfo[MAX_CH];     ///< The following are channel level definitions.
+} CONTROLLER_INFO;
+
+typedef struct {
+  UINT64   BaseAddress;   ///< Trace Base Address
+  UINT64   TotalSize;     ///< Total Trace Region of Same Cache type
+  UINT8    CacheType;     ///< Trace Cache Type
+  UINT8    ErrorCode;     ///< Trace Region Allocation Fail Error code
+  UINT8    Rsvd[2];
+} PSMI_MEM_INFO;
+
+typedef struct {
+  UINT8             Revision;
+  UINT16            DataWidth;              ///< Data width, in bits, of this memory device
+  /** As defined in SMBIOS 3.0 spec
+    Section 7.18.2 and Table 75
+  **/
+  UINT8             MemoryType;             ///< DDR type: DDR3, DDR4, or LPDDR3
+  UINT16            MaximumMemoryClockSpeed;///< The maximum capable speed of the device, in megahertz (MHz)
+  UINT16            ConfiguredMemoryClockSpeed; ///< The configured clock speed to the memory device, in megahertz (MHz)
+  /** As defined in SMBIOS 3.0 spec
+    Section 7.17.3 and Table 72
+  **/
+  UINT8             ErrorCorrectionType;
+
+  SiMrcVersion      Version;
+  BOOLEAN           EccSupport;
+  UINT8             MemoryProfile;
+  UINT32            TotalPhysicalMemorySize;
+  UINT32            DefaultXmptCK[MAX_XMP_PROFILE_NUM];///< Stores the tCK value read from SPD XMP profiles if they exist.
+  UINT8             XmpProfileEnable;                  ///< If XMP capable DIMMs are detected, this will indicate which XMP Profiles are common among all DIMMs.
+  UINT8             Ratio;
+  UINT8             RefClk;
+  UINT32            VddVoltage[MAX_PROFILE_NUM];
+  CONTROLLER_INFO   Controller[MAX_NODE];
+} MEMORY_INFO_DATA_HOB;
+
+/**
+  Memory Platform Data Hob
+
+  <b>Revision 1:</b>
+  - Initial version.
+  <b>Revision 2:</b>
+  - Added TsegBase, PrmrrSize, PrmrrBase, Gttbase, MmioSize, PciEBaseAddress fields
+**/
+typedef struct {
+  UINT8             Revision;
+  UINT8             Reserved[3];
+  UINT32            BootMode;
+  UINT32            TsegSize;
+  UINT32            TsegBase;
+  UINT32            PrmrrSize;
+  UINT64            PrmrrBase;
+  UINT32            PramSize;
+  UINT64            PramBase;
+  UINT64            DismLimit;
+  UINT64            DismBase;
+  UINT32            GttBase;
+  UINT32            MmioSize;
+  UINT32            PciEBaseAddress;
+  PSMI_MEM_INFO     PsmiInfo[MAX_TRACE_CACHE_TYPE];
+} MEMORY_PLATFORM_DATA;
+
+typedef struct {
+  EFI_HOB_GUID_TYPE    EfiHobGuidType;
+  MEMORY_PLATFORM_DATA Data;
+  UINT8                *Buffer;
+} MEMORY_PLATFORM_DATA_HOB;
+
+#pragma pack (pop)
+
+#endif // _MEM_INFO_HOB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
new file mode 100644
index 0000000000..4ff2578038
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
@@ -0,0 +1,61 @@
+/** @file
+  Interface definition details between System Agent and platform drivers during DXE phase.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_POLICY_H_
+#define _SA_POLICY_H_
+
+#include <ConfigBlock.h>
+#include <Library/ConfigBlockLib.h>
+#include <GraphicsConfig.h>
+#include <ConfigBlock/MemoryDxeConfig.h>
+#include <ConfigBlock/PcieDxeConfig.h>
+#include <VtdConfig.h>
+
+///
+/// Extern the GUID for protocol users.
+///
+extern EFI_GUID gSaPolicyProtocolGuid;
+extern EFI_GUID gGraphicsDxeConfigGuid;
+extern EFI_GUID gPcieDxeConfigGuid;
+extern EFI_GUID gMemoryDxeConfigGuid;
+extern EFI_GUID gVtdDxeConfigGuid;
+
+/**
+  Don't change the original SA_POLICY_PROTOCOL_REVISION macro, external
+  modules maybe have consumed this macro in their source code.  Directly
+  update the SA_POLICY_PROTOCOL_REVISION version number may cause those
+  external modules to auto mark themselves wrong version info.
+  Always create new version macro for new Policy protocol interface.
+**/
+#define SA_POLICY_PROTOCOL_REVISION  1
+
+#define CPU_PCIE_DEV_END_OF_TABLE                0xFFFF
+
+#define LTR_MAX_SNOOP_LATENCY_VALUE             0x0846    ///< Intel recommended maximum value for Snoop Latency
+#define LTR_MAX_NON_SNOOP_LATENCY_VALUE         0x0846    ///< Intel recommended maximum value for Non-Snoop Latency
+
+
+/**
+  SA DXE Policy
+
+ The SA_POLICY_PROTOCOL producer drvier is recommended to
+ set all the SA_POLICY_PROTOCOL size buffer zero before init any member parameter,
+ this clear step can make sure no random value for those unknow new version parameters.
+
+ Make sure to update the Revision if any change to the protocol, including the existing
+ internal structure definations.\n
+  Note: Here revision will be bumped up when adding/removing any config block under this structure.\n
+  <b>Revision 1</b>:
+  - Initial version.
+**/
+typedef struct {
+  CONFIG_BLOCK_TABLE_HEADER      TableHeader;    ///< Offset 0-31
+/*
+  Individual Config Block Structures are added here in memory as part of AddConfigBlock()
+*/
+} SA_POLICY_PROTOCOL;
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (5 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers Heng Luo
                   ` (32 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * SystemAgent/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaIotrapSmi.h |  42 ++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaNvsArea.h   |  30 ++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHob.h          |  50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaDef.h         | 222 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 344 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaIotrapSmi.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaIotrapSmi.h
new file mode 100644
index 0000000000..2e86d497f9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaIotrapSmi.h
@@ -0,0 +1,42 @@
+/** @file
+  This file defines the SA Iotrap SMI Protocol to provide the
+  I/O address for registered Iotrap SMI.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_IOTRAP_SMI_PROTOCOL_H_
+#define _SA_IOTRAP_SMI_PROTOCOL_H_
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID                       gSaIotrapSmiProtocolGuid;
+
+#define SA_IOTRAP_SMI_PROTOCOL_REVISION_1 1
+
+//
+// SA IO Trap SMI Protocol definition (Private protocol for RC internal use only)
+//
+typedef struct {
+/*
+ Protocol revision number
+ Any backwards compatible changes to this protocol will result in an update in the revision number
+ Major changes will require publication of a new protocol
+
+  <b>Revision 1</b>:
+    - First version
+*/
+  UINT8   Revision;
+  UINT16  SaIotrapSmiAddress;
+} SA_IOTRAP_SMI_PROTOCOL;
+
+///
+/// Pcie Trap valid types
+///
+typedef enum {
+  CpuPciePmTrap,
+  CpuPcieTrapTypeMaximum
+} CPU_PCIE_TRAP_TYPE;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaNvsArea.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaNvsArea.h
new file mode 100644
index 0000000000..785a808cf4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaNvsArea.h
@@ -0,0 +1,30 @@
+/** @file
+  Definition of the System Agent global NVS area protocol.
+  This protocol publishes the address and format of a global ACPI NVS buffer
+  used as a communications buffer between SMM/DXE/PEI code and ASL code.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SYSTEM_AGENT_NVS_AREA_H_
+#define _SYSTEM_AGENT_NVS_AREA_H_
+
+//
+// SA NVS Area definition
+//
+#include <SaNvsAreaDef.h>
+
+//
+// Extern the GUID for protocol users.
+//
+extern EFI_GUID gSaNvsAreaProtocolGuid;
+
+///
+/// System Agent Global NVS Area Protocol
+///
+typedef struct {
+  SYSTEM_AGENT_NVS_AREA *Area;        ///< System Agent Global NVS Area Structure
+} SYSTEM_AGENT_NVS_AREA_PROTOCOL;
+
+#endif // _SYSTEM_AGENT_NVS_AREA_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHob.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHob.h
new file mode 100644
index 0000000000..65622069e6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHob.h
@@ -0,0 +1,50 @@
+/** @file
+  The GUID definition for SaConfigHob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_CONFIG_HOB_H_
+#define _SA_CONFIG_HOB_H_
+
+#include <Register/SaRegsHostBridge.h>
+#include <Base.h>
+#include "CpuPcieInfo.h"
+#include <Library/PcdLib.h>
+
+extern EFI_GUID gSaConfigHobGuid;
+#define SA_VTD_ENGINE_NUMBER        3
+
+#pragma pack (push,1)
+///
+/// DPR Directory Types
+///
+typedef enum {
+  EnumDprDirectoryTxt   = 0,
+} DPR_DIRECTORY_ELEMENT;
+
+#define DPR_DIRECTORY_TYPE_TXT          0x01      ///< DPR directory type - TXT
+#define DPR_DIRECTORY_TYPE_BIOSGUARD    0x02      ///< DPR directory type - BIOS Guard
+#define DPR_DIRECTORY_MAX               1         ///< DPR Maximum Size
+
+///
+/// DPR directory entry definition
+///
+typedef struct {
+  UINT8   Type;          ///< DPR Directory Type
+  UINT8   Size;          ///< DPR Size in MB
+  UINT32  PhysBase;      ///< Must be 4K aligned (bits 11..0 must be clear)
+  UINT16  Reserved;      ///< Must be 0
+} DPR_DIRECTORY_ENTRY;
+
+///
+/// System Agent Config Hob
+///
+typedef struct {
+  EFI_HOB_GUID_TYPE        EfiHobGuidType;                           ///< GUID Hob type structure for gSaConfigHobGuid
+  DPR_DIRECTORY_ENTRY      DprDirectory[DPR_DIRECTORY_MAX];          ///< DPR directory entry definition
+  UINT8                    ApertureSize;                             ///< Aperture size value
+  BOOLEAN                  CridEnable;                               ///< This field inidicates if CRID is enabled or disabled (to support Intel(R) SIPP)
+} SA_CONFIG_HOB;
+#pragma pack (pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaDef.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaDef.h
new file mode 100644
index 0000000000..6ee2343363
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaDef.h
@@ -0,0 +1,222 @@
+//
+// Automatically generated by GenNvs ver 2.4.6
+// Please DO NOT modify !!!
+//
+
+/** @file
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+  //
+  // Define SA NVS Area operation region.
+  //
+#ifndef _SA_NVS_AREA_DEF_H_
+#define _SA_NVS_AREA_DEF_H_
+
+#pragma pack (push,1)
+typedef struct {
+  UINT32   IgdOpRegionAddress;                      ///< Offset 0       IGD OpRegion base address
+  UINT8    GfxTurboIMON;                            ///< Offset 4       IMON Current Value
+  UINT8    IgdState;                                ///< Offset 5       IGD State (Primary Display = 1)
+  UINT8    IgdBootType;                             ///< Offset 6       IGD Boot Display Device
+  UINT8    IgdPanelType;                            ///< Offset 7       IGD Panel Type CMOS option
+  UINT8    IgdPanelScaling;                         ///< Offset 8       IGD Panel Scaling
+  UINT8    IgdBiaConfig;                            ///< Offset 9       IGD BIA Configuration
+  UINT8    IgdSscConfig;                            ///< Offset 10      IGD SSC Configuration
+  UINT8    IgdDvmtMemSize;                          ///< Offset 11      IGD DVMT Memory Size
+  UINT8    IgdFunc1Enable;                          ///< Offset 12      IGD Function 1 Enable
+  UINT8    IgdHpllVco;                              ///< Offset 13      HPLL VCO
+  UINT8    IgdSciSmiMode;                           ///< Offset 14      GMCH SMI/SCI mode (0=SCI)
+  UINT8    IgdPAVP;                                 ///< Offset 15      IGD PAVP data
+  UINT8    CurrentDeviceList;                       ///< Offset 16      Current Attached Device List
+  UINT16   CurrentDisplayState;                     ///< Offset 17      Current Display State
+  UINT16   NextDisplayState;                        ///< Offset 19      Next Display State
+  UINT8    NumberOfValidDeviceId;                   ///< Offset 21      Number of Valid Device IDs
+  UINT32   DeviceId1;                               ///< Offset 22      Device ID 1
+  UINT32   DeviceId2;                               ///< Offset 26      Device ID 2
+  UINT32   DeviceId3;                               ///< Offset 30      Device ID 3
+  UINT32   DeviceId4;                               ///< Offset 34      Device ID 4
+  UINT32   DeviceId5;                               ///< Offset 38      Device ID 5
+  UINT32   DeviceId6;                               ///< Offset 42      Device ID 6
+  UINT32   DeviceId7;                               ///< Offset 46      Device ID 7
+  UINT32   DeviceId8;                               ///< Offset 50      Device ID 8
+  UINT32   DeviceId9;                               ///< Offset 54      Device ID 9
+  UINT32   DeviceId10;                              ///< Offset 58      Device ID 10
+  UINT32   DeviceId11;                              ///< Offset 62      Device ID 11
+  UINT32   DeviceId12;                              ///< Offset 66      Device ID 12
+  UINT32   DeviceId13;                              ///< Offset 70      Device ID 13
+  UINT32   DeviceId14;                              ///< Offset 74      Device ID 14
+  UINT32   DeviceId15;                              ///< Offset 78      Device ID 15
+  UINT32   DeviceIdX;                               ///< Offset 82      Device ID for eDP device
+  UINT32   NextStateDid1;                           ///< Offset 86      Next state DID1 for _DGS
+  UINT32   NextStateDid2;                           ///< Offset 90      Next state DID2 for _DGS
+  UINT32   NextStateDid3;                           ///< Offset 94      Next state DID3 for _DGS
+  UINT32   NextStateDid4;                           ///< Offset 98      Next state DID4 for _DGS
+  UINT32   NextStateDid5;                           ///< Offset 102     Next state DID5 for _DGS
+  UINT32   NextStateDid6;                           ///< Offset 106     Next state DID6 for _DGS
+  UINT32   NextStateDid7;                           ///< Offset 110     Next state DID7 for _DGS
+  UINT32   NextStateDid8;                           ///< Offset 114     Next state DID8 for _DGS
+  UINT32   NextStateDidEdp;                         ///< Offset 118     Next state DID for eDP
+  UINT8    LidState;                                ///< Offset 122     Lid State (Lid Open = 1)
+  UINT32   AKsv0;                                   ///< Offset 123     First four bytes of AKSV (manufacturing mode)
+  UINT8    AKsv1;                                   ///< Offset 127     Fifth byte of AKSV (manufacturing mode)
+  UINT8    BrightnessPercentage;                    ///< Offset 128     Brightness Level Percentage
+  UINT8    AlsEnable;                               ///< Offset 129     Ambient Light Sensor Enable
+  UINT8    AlsAdjustmentFactor;                     ///< Offset 130     Ambient Light Adjusment Factor
+  UINT8    LuxLowValue;                             ///< Offset 131     LUX Low Value
+  UINT8    LuxHighValue;                            ///< Offset 132     LUX High Value
+  UINT8    ActiveLFP;                               ///< Offset 133     Active LFP
+  UINT8    IpuAcpiMode;                             ///< Offset 134     IPU ACPI device type (0=Disabled, 1=AVStream virtual device as child of GFX)
+  UINT8    EdpValid;                                ///< Offset 135     Check for eDP display device
+  UINT8    HgMode;                                  ///< Offset 136     SG Mode (0=Disabled, 1=HG Muxed, 2=HG Muxless, 3=DGPU Only)
+  UINT8    HgFeatureList;                           ///< Offset 137     HG Feature List
+  UINT8    Pcie0GpioSupport;                        ///< Offset 138     PCIe0 GPIO Support (0=Disabled, 1=PCH Based, 2=I2C Based)
+  UINT8    Pcie0HoldRstExpanderNo;                  ///< Offset 139     PCIe0 HLD RST IO Expander Number
+  UINT32   Pcie0HoldRstGpioNo;                      ///< Offset 140     PCIe0 HLD RST GPIO Number
+  UINT8    Pcie0HoldRstActiveInfo;                  ///< Offset 144     PCIe0 HLD RST GPIO Active Information
+  UINT8    Pcie0PwrEnExpanderNo;                    ///< Offset 145     PCIe0 PWR Enable IO Expander Number
+  UINT32   Pcie0PwrEnGpioNo;                        ///< Offset 146     PCIe0 PWR Enable GPIO Number
+  UINT8    Pcie0PwrEnActiveInfo;                    ///< Offset 150     PCIe0 PWR Enable GPIO Active Information
+  UINT8    Pcie1GpioSupport;                        ///< Offset 151     PCIe1 GPIO Support (0=Disabled, 1=PCH Based, 2=I2C Based)
+  UINT8    Pcie1HoldRstExpanderNo;                  ///< Offset 152     PCIe1 HLD RST IO Expander Number
+  UINT32   Pcie1HoldRstGpioNo;                      ///< Offset 153     PCIe1 HLD RST GPIO Number
+  UINT8    Pcie1HoldRstActiveInfo;                  ///< Offset 157     PCIe1 HLD RST GPIO Active Information
+  UINT8    Pcie1PwrEnExpanderNo;                    ///< Offset 158     PCIe1 PWR Enable IO Expander Number
+  UINT32   Pcie1PwrEnGpioNo;                        ///< Offset 159     PCIe1 PWR Enable GPIO Number
+  UINT8    Pcie1PwrEnActiveInfo;                    ///< Offset 163     PCIe1 PWR Enable GPIO Active Information
+  UINT8    Pcie2GpioSupport;                        ///< Offset 164     PCIe2 GPIO Support (0=Disabled, 1=PCH Based, 2=I2C Based)
+  UINT8    Pcie2HoldRstExpanderNo;                  ///< Offset 165     PCIe2 HLD RST IO Expander Number
+  UINT32   Pcie2HoldRstGpioNo;                      ///< Offset 166     PCIe2 HLD RST GPIO Number
+  UINT8    Pcie2HoldRstActiveInfo;                  ///< Offset 170     PCIe2 HLD RST GPIO Active Information
+  UINT8    Pcie2PwrEnExpanderNo;                    ///< Offset 171     PCIe2 PWR Enable IO Expander Number
+  UINT32   Pcie2PwrEnGpioNo;                        ///< Offset 172     PCIe2 PWR Enable GPIO Number
+  UINT8    Pcie2PwrEnActiveInfo;                    ///< Offset 176     PCIe2 PWR Enable GPIO Active Information
+  UINT8    Pcie3GpioSupport;                        ///< Offset 177     PCIe3 GPIO Support (0=Disabled, 1=PCH Based, 2=I2C Based)
+  UINT8    Pcie3HoldRstExpanderNo;                  ///< Offset 178     PCIe3 HLD RST IO Expander Number
+  UINT32   Pcie3HoldRstGpioNo;                      ///< Offset 179     PCIe3 HLD RST GPIO Number
+  UINT8    Pcie3HoldRstActiveInfo;                  ///< Offset 183     PCIe3 HLD RST GPIO Active Information
+  UINT8    Pcie3PwrEnExpanderNo;                    ///< Offset 184     PCIe3 PWR Enable IO Expander Number
+  UINT32   Pcie3PwrEnGpioNo;                        ///< Offset 185     PCIe3 PWR Enable GPIO Number
+  UINT8    Pcie3PwrEnActiveInfo;                    ///< Offset 189     PCIe3 PWR Enable GPIO Active Information
+  UINT32   Pcie3WakeGpioNo;                         ///< Offset 190     PCIe3 RTD3 Device Wake GPIO Number
+  UINT16   DelayAfterPwrEn;                         ///< Offset 194     Delay after power enable for PCIe
+  UINT16   DelayAfterHoldReset;                     ///< Offset 196     Delay after Hold Reset for PCIe
+  UINT8    Pcie0EpCapOffset;                        ///< Offset 198     PCIe0 Endpoint Capability Structure Offset
+  UINT32   XPcieCfgBaseAddress;                     ///< Offset 199     Any Device's PCIe Config Space Base Address
+  UINT16   GpioBaseAddress;                         ///< Offset 203     GPIO Base Address
+  UINT32   NvIgOpRegionAddress;                     ///< Offset 205     NVIG opregion address
+  UINT32   NvHmOpRegionAddress;                     ///< Offset 209     NVHM opregion address
+  UINT32   ApXmOpRegionAddress;                     ///< Offset 213     AMDA opregion address
+  UINT8    Peg0LtrEnable;                           ///< Offset 217     Latency Tolerance Reporting Enable
+  UINT8    Peg0ObffEnable;                          ///< Offset 218     Optimized Buffer Flush and Fill
+  UINT8    Peg1LtrEnable;                           ///< Offset 219     Latency Tolerance Reporting Enable
+  UINT8    Peg1ObffEnable;                          ///< Offset 220     Optimized Buffer Flush and Fill
+  UINT8    Peg2LtrEnable;                           ///< Offset 221     Latency Tolerance Reporting Enable
+  UINT8    Peg2ObffEnable;                          ///< Offset 222     Optimized Buffer Flush and Fill
+  UINT8    Peg3LtrEnable;                           ///< Offset 223     Latency Tolerance Reporting Enable
+  UINT8    Peg3ObffEnable;                          ///< Offset 224     Optimized Buffer Flush and Fill
+  UINT16   PegLtrMaxSnoopLatency;                   ///< Offset 225     SA Peg Latency Tolerance Reporting Max Snoop Latency
+  UINT16   PegLtrMaxNoSnoopLatency;                 ///< Offset 227     SA Peg Latency Tolerance Reporting Max No Snoop Latency
+  UINT64   Mmio64Base;                              ///< Offset 229     Base of above 4GB MMIO resource
+  UINT64   Mmio64Length;                            ///< Offset 237     Length of above 4GB MMIO resource
+  UINT32   CpuIdInfo;                               ///< Offset 245     CPU ID info to get Family Id or Stepping
+  UINT32   Mmio32Base;                              ///< Offset 249     Base of below 4GB MMIO resource
+  UINT32   Mmio32Length;                            ///< Offset 253     Length of below 4GB MMIO resource
+  UINT32   Pcie0WakeGpioNo;                         ///< Offset 257     PCIe0 RTD3 Device Wake GPIO Number
+  UINT32   Pcie1WakeGpioNo;                         ///< Offset 261     PCIe1 RTD3 Device Wake GPIO Number
+  UINT32   Pcie2WakeGpioNo;                         ///< Offset 265     PCIe2 RTD3 Device Wake GPIO Number
+  UINT8    VtdDisable;                              ///< Offset 269     VT-d Enable/Disable
+  UINT32   VtdBaseAddress[7];                       ///< Offset 270     VT-d Base Address 1
+                                                    ///< Offset 274     VT-d Base Address 2
+                                                    ///< Offset 278     VT-d Base Address 3
+                                                    ///< Offset 282     VT-d Base Address 4 (iTBT PCIE0)
+                                                    ///< Offset 286     VT-d Base Address 5 (iTBT PCIE1)
+                                                    ///< Offset 290     VT-d Base Address 6 (iTBT PCIE2)
+                                                    ///< Offset 294     VT-d Base Address 7 (iTBT PCIE3)
+  UINT16   VtdEngine1Vid;                           ///< Offset 298     VT-d Engine#1 Vendor ID
+  UINT16   VtdEngine2Vid;                           ///< Offset 300     VT-d Engine#2 Vendor ID
+  UINT8    RootPortIndex;                           ///< Offset 302     RootPort Number
+  UINT32   RootPortAddress;                         ///< Offset 303     RootPortAddress
+  UINT8    CpuTraceHubMode;                         ///< Offset 307     CPU Trace Hub Mode
+  UINT8    SimicsEnvironment;                       ///< Offset 308     Simics Environment information
+  UINT8    ItbtXhciEn;                              ///< Offset 309     TCSS XHCI Device Enable
+  UINT8    ItbtXdciEn;                              ///< Offset 310     TCSS XDCI Device Enable
+  UINT8    ItbtDmaEn[2];                            ///< Offset 311     TCSS DMA 0 Device Enable
+                                                    ///< Offset 312     TCSS DMA 1 Device Enable
+  UINT8    ItbtPcieRpEn[4];                         ///< Offset 313     TCSS ItbtPcieRp PCIE RP 0 Device Enable
+                                                    ///< Offset 314     TCSS ItbtPcieRp PCIE RP 1 Device Enable
+                                                    ///< Offset 315     TCSS ItbtPcieRp PCIE RP 2 Device Enable
+                                                    ///< Offset 316     TCSS ItbtPcieRp PCIE RP 3 Device Enable
+  UINT32   ItbtPcieRpAddress[4];                    ///< Offset 317     TCSS ItbtPcie Root Port address 0
+                                                    ///< Offset 321     TCSS ItbtPcie Root Port address 1
+                                                    ///< Offset 325     TCSS ItbtPcie Root Port address 2
+                                                    ///< Offset 329     TCSS ItbtPcie Root Port address 3
+  UINT32   TcssxDCIPwrDnScale;                      ///< Offset 333     TCSS xDCI Power Down Scale Value, DWC_USB3_GCTL_INIT[31:19]
+  UINT8    TcssxDCIInt;                             ///< Offset 337     TCSS xDCI Int Pin
+  UINT8    TcssxDCIIrq;                             ///< Offset 338     TCSS xDCI Irq Number
+  UINT8    TcssRtd3;                                ///< Offset 339     TCSS RTD3
+  UINT32   TcssDma0RmrrAddr;                        ///< Offset 340     TCSS DMA0 RMRR address
+  UINT32   TcssDma1RmrrAddr;                        ///< Offset 344     TCSS DMA1 RMRR address
+  UINT8    LtrEnable[4];                            ///< Offset 348     Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+                                                    ///< Offset 349     Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+                                                    ///< Offset 350     Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+                                                    ///< Offset 351     Latency Tolerance Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
+  UINT16   PcieLtrMaxSnoopLatency[4];               ///< Offset 352     PCIE LTR max snoop Latency 0
+                                                    ///< Offset 354     PCIE LTR max snoop Latency 1
+                                                    ///< Offset 356     PCIE LTR max snoop Latency 2
+                                                    ///< Offset 358     PCIE LTR max snoop Latency 3
+  UINT16   PcieLtrMaxNoSnoopLatency[4];             ///< Offset 360     PCIE LTR max no snoop Latency 0
+                                                    ///< Offset 362     PCIE LTR max no snoop Latency 1
+                                                    ///< Offset 364     PCIE LTR max no snoop Latency 2
+                                                    ///< Offset 366     PCIE LTR max no snoop Latency 3
+  UINT8    IomReady;                                ///< Offset 368     IOM Ready
+  UINT8    TcssIomVccSt;                            ///< Offset 369     TCSS IOM VccSt
+  UINT8    CpuPcieRp0Enable;                        ///< Offset 370     <0:Disabled, 1:Enabled>
+  UINT8    CpuPcieRp1Enable;                        ///< Offset 371     <0:Disabled, 1:Enabled>
+  UINT8    CpuPcieRp2Enable;                        ///< Offset 372     <0:Disabled, 1:Enabled>
+  UINT8    CpuPcieRp3Enable;                        ///< Offset 373     <0:Disabled, 1:Enabled>
+  UINT8    VmdEnable;                               ///< Offset 374     VMD Device Enable
+  UINT32   DeviceIdY;                               ///< Offset 375     Device ID for second LFP device
+  UINT32   NextStateDidEdp2;                        ///< Offset 379     Next state DID for Second Display
+  UINT8    SlotSelection;                           ///< Offset 383     PCIe slot selection
+  UINT8    VmdRp1to8;                               ///< Offset 384     VMD PCH RP 1 to 8 <0:Disabled, 1:Enabled>
+  UINT8    VmdRp9to16;                              ///< Offset 385     VMD PCH RP 9 to 16 <0:Disabled, 1:Enabled>
+  UINT8    VmdRp17to24;                             ///< Offset 386     VMD PCH RP 17 to 24 <0:Disabled, 1:Enabled>
+  UINT8    VmdSataPort[8];                          ///< Offset 387     VMD SATA PORT 0 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 388     VMD SATA PORT 1 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 389     VMD SATA PORT 2 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 390     VMD SATA PORT 3 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 391     VMD SATA PORT 4 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 392     VMD SATA PORT 5 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 393     VMD SATA PORT 6 <0:Disabled, 1:Enabled>
+                                                    ///< Offset 394     VMD SATA PORT 7 <0:Disabled, 1:Enabled>
+  UINT8    VmdCpuRp;                                ///< Offset 395     VMD CPU RP      <0:Disabled, 1:Enabled>
+  UINT8    CpuPcieRtd3;                             ///< Offset 396     RTD3 Support for CPU PCIE.
+  UINT32   LaneUsed;                                ///< Offset 397     Lane Used of each CSI Port <0:Not Configured, 1:x1, 2:x2, 3:x3 4:x4>
+  UINT32   CsiSpeed;                                ///< Offset 401     Speed of each CSI Port <0:Not configured, 1:<416GMbps, 2:<1.5Gbps, 3:<2.0Gbps, 4:<2.5Gbps, 5:<4Gbps, 6:>4Gbps>
+  UINT8    MaxPegPortNumber;                        ///< Offset 405     Max PEG port number
+  UINT8    MemBootMode;                             ///< Offset 406     Current Memory Boot Mode <0: BOOT_MODE_1LM(Default), 1: BOOT_MODE_2LM, 2: BOOT_MODE_PROVISION>
+  UINT8    DpmemSupport;                            ///< Offset 407     Dynamic PMem Support <0: Disabled, 1:Enabled>
+  UINT64   PmemStartingAddress;                     ///< Offset 408     Private Pmem Starting address
+  UINT64   PmemRangeLength;                         ///< Offset 416     Private Pmem Range Length
+  UINT8    Pcie3EpCapOffset;                        ///< Offset 424     PCIe3 Endpoint Capability Structure Offset
+  UINT8    Pcie0SrcClkNo;                           ///< Offset 425     PCIe0 RTD3 Device Source Clock Number
+  UINT8    Pcie1SrcClkNo;                           ///< Offset 426     PCIe1 RTD3 Device Source Clock Number
+  UINT8    Pcie2SrcClkNo;                           ///< Offset 427     PCIe2 RTD3 Device Source Clock Number
+  UINT8    Pcie3SrcClkNo;                           ///< Offset 428     PCIe2 RTD3 Device Source Clock Number
+  UINT8    Pcie0SecBusNum;                          ///< Offset 429     PCIe0 Secondary Bus Number (PCIe0 Endpoint Bus Number)
+  UINT8    Pcie1SecBusNum;                          ///< Offset 430     PCIe1 Secondary Bus Number (PCIe0 Endpoint Bus Number)
+  UINT8    Pcie2SecBusNum;                          ///< Offset 431     PCIe2 Secondary Bus Number (PCIe0 Endpoint Bus Number)
+  UINT8    Pcie3SecBusNum;                          ///< Offset 432     PCIe2 Secondary Bus Number (PCIe0 Endpoint Bus Number)
+  UINT8    Pcie1EpCapOffset;                        ///< Offset 433     PCIe1 Endpoint Capability Structure Offset
+  UINT8    Pcie2EpCapOffset;                        ///< Offset 434     PCIe2 Endpoint Capability Structure Offset
+  UINT8    IsBridgeDeviceBehindPeg1;                ///< Offset 435     Is bridge device behind PEG1
+  UINT8    IsBridgeDeviceBehindPeg2;                ///< Offset 436     Is bridge device behind PEG2
+  UINT8    IsBridgeDeviceBehindPeg3;                ///< Offset 437     Is bridge device behind PEG3
+  UINT8    HgSlot;                                  ///< Offset 438     Slot selection between PCH/PEG
+} SYSTEM_AGENT_NVS_AREA;
+
+#pragma pack(pop)
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (6 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers Heng Luo
                   ` (31 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Fru/TglCpu/Include

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFruLib.h |  57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHostBridge.h | 145 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h                  |  12 ++++++++++++
 3 files changed, 214 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFruLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFruLib.h
new file mode 100644
index 0000000000..89cf952717
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFruLib.h
@@ -0,0 +1,57 @@
+/** @file
+  Header file for CpuPcieInfoFruLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PCIE_INFO_FRU_LIB_H_
+#define _CPU_PCIE_INFO_FRU_LIB_H_
+
+#include <CpuPcieInfo.h>
+
+#define CPU_PCIE_MAX_ROOT_PORTS       4
+
+#define CPU_PCIE_ULT_ULX_MAX_ROOT_PORT     1
+
+#include <Library/CpuRegbarAccessLib.h>
+
+/**
+  Get CPU Maximum Pcie Root Port Number
+
+  @retval PcieMaxRootPort         Pch Maximum Pcie Root Port Number
+**/
+UINT8
+GetMaxCpuPciePortNum (
+  VOID
+  );
+
+/**
+  Get CPU Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber              Root port physical number. (0-based)
+  @param[out] RpDev                 Return corresponding root port device number.
+  @param[out] RpFun                 Return corresponding root port function number.
+
+  @retval     EFI_SUCCESS           Root port device and function is retrieved
+  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
+**/
+EFI_STATUS
+EFIAPI
+GetCpuPcieRpDevFun (
+  IN  UINTN   RpNumber,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  );
+
+/**
+  Gets pci segment base address of PCIe root port.
+
+  @param  RpIndex    Root Port Index (0 based)
+  @return PCIe port  base address.
+**/
+UINT64
+CpuPcieBase (
+  IN  UINT32   RpIndex
+  );
+
+#endif // _CPU_PCIE_INFO_FRU_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHostBridge.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHostBridge.h
new file mode 100644
index 0000000000..32e38fa072
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHostBridge.h
@@ -0,0 +1,145 @@
+/** @file
+  Register names for Host Bridge block
+  <b>Conventions</b>:
+  - Prefixes:
+    - Definitions beginning with "R_" are registers
+    - Definitions beginning with "B_" are bits within registers
+    - Definitions beginning with "V_" are meaningful values of bits within the registers
+    - Definitions beginning with "S_" are register sizes
+    - Definitions beginning with "N_" are the bit position
+  - In general, SA registers are denoted by "_SA_" in register names
+  - Registers / bits that are different between SA generations are denoted by
+    "_SA_[generation_name]_" in register/bit names. e.g., "_SA_HSW_"
+  - Registers / bits that are different between SKUs are denoted by "_[SKU_name]"
+    at the end of the register/bit names
+  - Registers / bits of new devices introduced in a SA generation will be just named
+    as "_SA_" without [generation_name] inserted.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_REGS_HOST_BRIDGE_H_
+#define _SA_REGS_HOST_BRIDGE_H_
+
+#define SA_SEG_NUM              0x00
+#define V_SA_DEVICE_ID_INVALID  0xFFFF
+//
+// DEVICE 0 (Memory Controller Hub)
+//
+#define SA_MC_BUS          0x00
+#define SA_MC_DEV          0x00
+#define SA_MC_FUN          0x00
+#define V_SA_MC_VID        0x8086
+#define R_SA_MC_DEVICE_ID  0x02
+#define R_SA_MC_CAPID0_B   0xE8
+
+//
+// SA DMI configuration
+//
+
+//
+// Maximum DMI lanes and bundles supported (x8 and 4 lanes)
+//
+#define SA_DMI_MAX_LANE                      0x08
+#define SA_DMI_MAX_BUNDLE                    0x04
+#define SA_DMI_MAX_LANE_VER1                 0x04
+#define SA_DMI_MAX_BUNDLE_VER1               0x02
+
+
+//
+// TigerLake Mobile SA Device IDs B0:D0:F0
+//
+#define V_SA_DEVICE_ID_MB_ULT_1 0x9A14   ///< TigerLake Ult (TGL-U 4+2)
+#define V_SA_DEVICE_ID_MB_ULT_2 0x9A04   ///< TigerLake Ult (TGL-U 2+2)
+
+#define V_SA_DEVICE_ID_MB_ULX_1 0x9A12   ///< TigerLake Ulx (TGL-Y 4+2)
+#define V_SA_DEVICE_ID_MB_ULX_2 0x9A02   ///< TigerLake Ulx (TGL-Y 2+2)
+
+/**
+ <b>Description</b>:
+ - This is the base address for the Host Memory Mapped Configuration space.  There is no physical memory within this 32KB window that can be addressed.  The 32KB reserved by this register does not alias to any PCI 2.3 compliant memory mapped space.  On reset, the Host MMIO Memory Mapped Configuation space is disabled and must be enabled by writing a 1 to MCHBAREN [Dev 0, offset48h, bit 0].
+ - All the bits in this register are locked in LT mode.
+ - The register space contains memory control, initialization, timing, and buffer strength registers; clocking registers; and power and thermal management registers.
+**/
+#define R_SA_MCHBAR  (0x48)
+
+/**
+ <b>Description</b>:
+ - All the bits in this register are LT lockable.
+**/
+#define R_SA_GGC (0x50)
+
+/**
+ Description of GMS (8:15)
+ - This field is used to select the amount of Main Memory that is pre-allocated to support the Internal Graphics device in VGA (non-linear) and Native (linear) modes.  The BIOS ensures that memory is pre-allocated only when Internal graphics is enabled.
+ - This register is also LT lockable.
+ - Valid options are 0 (0x0) to 2048MB (0x40) in multiples of 32 MB
+ - All other values are reserved
+ - Hardware does not clear or set any of these bits automatically based on IGD being disabled/enabled.
+ - BIOS Requirement: BIOS must not set this field to 0h if IVD (bit 1 of this register) is 0.
+**/
+#define N_SA_GGC_GMS_OFFSET  (0x8)
+#define B_SA_GGC_GMS_MASK    (0xff00)
+
+/**
+ Description of GGMS (6:7)
+ - This field is used to select the amount of Main Memory that is pre-allocated to support the Internal Graphics Translation Table.  The BIOS ensures that memory is pre-allocated only when Internal graphics is enabled.
+ - GSM is assumed to be a contiguous physical DRAM space with DSM, and BIOS needs to allocate a contiguous memory chunk.  Hardware will derive the base of GSM from DSM only using the GSM size programmed in the register.
+ - Valid options:
+ - 0h: 0 MB of memory pre-allocated for GTT.
+ - 1h: 2 MB of memory pre-allocated for GTT.
+ - 2h: 4 MB of memory pre-allocated for GTT.
+ - 3h: 8 MB of memory pre-allocated for GTT.
+ - Others: Reserved
+ - Hardware functionality in case of programming this value to Reserved is not guaranteed.
+**/
+#define N_SA_GGC_GGMS_OFFSET  (0x6)
+#define B_SA_GGC_GGMS_MASK    (0xc0)
+#define V_SA_GGC_GGMS_8MB     3
+
+/**
+ Description:
+ - Allows for enabling/disabling of PCI devices and functions that are within the CPU package. The table below the bit definitions describes the behavior of all combinations of transactions to devices controlled by this register.
+  All the bits in this register are LT Lockable.
+**/
+#define R_SA_DEVEN (0x54)
+
+/**
+ Description of D2EN (4:4)
+ - 0:  Bus 0 Device 2 is disabled and hidden
+ - 1:  Bus 0 Device 2 is enabled and visible
+ - This bit will remain 0 if Device 2 capability is disabled.
+**/
+#define B_SA_DEVEN_D2EN_MASK     (0x10)
+
+
+///
+/// Description:
+///  The SMRAMC register controls how accesses to Compatible SMRAM spaces are treated.  The Open, Close and Lock bits function only when G_SMRAME bit is set to 1.  Also, the Open bit must be reset before the Lock bit is set.
+///
+#define R_SA_SMRAMC  (0x88)
+
+///
+/// Description:
+///  This register contains the base address of stolen DRAM memory for the GTT. BIOS determines the base of GTT stolen memory by subtracting the GTT graphics stolen memory size (PCI Device 0 offset 52 bits 9:8) from the Graphics Base of  Data Stolen Memory (PCI Device 0 offset B0 bits 31:20).
+///
+#define R_SA_BGSM  (0xb4)
+
+
+///
+/// Description:
+///  This register contains the Top of low memory address.
+///
+#define R_SA_TOLUD (0xbc)
+
+///
+/// Description of TOLUD (20:31)
+///  This register contains bits 31 to 20 of an address one byte above the maximum DRAM memory below 4G that is usable by the operating system. Address bits 31 down to 20 programmed to 01h implies a minimum memory size of 1MB. Configuration software must set this value to the smaller of the following 2 choices: maximum amount memory in the system minus ME stolen memory plus one byte or the minimum address allocated for PCI memory. Address bits 19:0 are assumed to be 0_0000h for the purposes of address comparison. The Host interface positively decodes an address towards DRAM if the incoming address is less than the value programmed in this register.
+///  The Top of Low Usable DRAM is the lowest address above both Graphics Stolen memory and Tseg. BIOS determines the base of Graphics Stolen Memory by subtracting the Graphics Stolen Memory Size from TOLUD and further decrements by Tseg size to determine base of Tseg. All the Bits in this register are locked in LT mode.
+///  This register must be 1MB aligned when reclaim is enabled.
+///
+#define B_SA_TOLUD_TOLUD_MASK      (0xfff00000)
+#define R_SA_MC_CAPID0_A_OFFSET    0xE4
+#define V_SA_LTR_MAX_SNOOP_LATENCY_VALUE           0x0846  ///< Intel recommended maximum value for Snoop Latency (70us)
+#define V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE       0x0846  ///< Intel recommended maximum value for Non-Snoop Latency (70us)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h
new file mode 100644
index 0000000000..cd8d57d948
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h
@@ -0,0 +1,12 @@
+/** @file
+  Register names for TCSS USB devices
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _TCSS_INFO_H_
+#define _TCSS_INFO_H_
+
+#define MAX_ITBT_PCIE_PORT        4
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (7 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers Heng Luo
                   ` (30 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Fru/TglCpu/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInitFruLib.h | 18 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuPcieRegs.h  | 24 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRegs.h      | 42 ++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuRegs.h      | 31 +++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdRegs.h      | 22 ++++++++++++++++++++++
 5 files changed, 137 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInitFruLib.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInitFruLib.h
new file mode 100644
index 0000000000..a46b29cbbe
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInitFruLib.h
@@ -0,0 +1,18 @@
+/** @file
+  Vtd Initialization Fru Library header file
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _VTD_INIT_FRU_LIB_H_
+#define _VTD_INIT_FRU_LIB_H_
+
+///
+/// TCSS DMA controller RMRR buffer 4MB for each DMA controller
+///
+#define RMRR_TCSS_DMA_SIZE  0x400000
+
+extern UINT16  mDevEnMap[][2];
+extern UINTN   mDevEnMapSize;
+
+#endif // _VTD_INIT_FRU_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuPcieRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuPcieRegs.h
new file mode 100644
index 0000000000..a571381202
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuPcieRegs.h
@@ -0,0 +1,24 @@
+/** @file
+  This file contains definitions of  PCIe Configuration
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _CPU_PCIE_REGS_H_
+#define _CPU_PCIE_REGS_H_
+
+#define  R_PCIE_LCAP                              0x4C
+#define  R_PCIE_LCTL                              0x50
+#define  R_PCIE_LSTS                              0x52
+#define  R_PCIE_SLCAP                             0x54
+#define  R_PCIE_SLSTS                             0x5A
+#define  R_PCIE_LCTL2                             0x70
+#define  R_PCIE_MPC                               0xD8
+#define  B_PCIE_MPC_HPME                          BIT1
+#define  R_PCIE_PGTHRES                           0x5C0
+#define  B_PCIE_PGTHRES_L1PGLTREN                 BIT0
+#define  R_PCIE_LCTL3                             0xA34
+#define  B_PCIE_LCTL3_PE                          BIT0
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRegs.h
new file mode 100644
index 0000000000..f0b30107f4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRegs.h
@@ -0,0 +1,42 @@
+/** @file
+  Register names for IGD block
+  <b>Conventions</b>:
+  - Prefixes:
+    - Definitions beginning with "R_" are registers
+    - Definitions beginning with "B_" are bits within registers
+    - Definitions beginning with "V_" are meaningful values of bits within the registers
+    - Definitions beginning with "S_" are register sizes
+    - Definitions beginning with "N_" are the bit position
+  - In general, SA registers are denoted by "_SA_" in register names
+  - Registers / bits that are different between SA generations are denoted by
+    "_SA_[generation_name]_" in register/bit names. e.g., "_SA_HSW_"
+  - Registers / bits that are different between SKUs are denoted by "_[SKU_name]"
+    at the end of the register/bit names
+  - Registers / bits of new devices introduced in a SA generation will be just named
+    as "_SA_" without [generation_name] inserted.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IGD_REGS_H_
+#define _IGD_REGS_H_
+
+///
+/// Device 2 Register Equates
+///
+//
+// The following equates must be reviewed and revised when the specification is ready.
+//
+#define IGD_BUS_NUM          0x00
+#define IGD_DEV_NUM          0x02
+#define IGD_FUN_NUM          0x00
+
+///
+/// GTTMMADR aligned to 16MB (Base address = [38:24])
+///
+#define R_SA_IGD_GTTMMADR          0x10
+
+#define R_SA_IGD_SWSCI_OFFSET      0x00E8
+#define R_SA_IGD_ASLS_OFFSET       0x00FC  ///< ASL Storage
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuRegs.h
new file mode 100644
index 0000000000..afc72e8db0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuRegs.h
@@ -0,0 +1,31 @@
+/** @file
+  Register names for IPU block
+  <b>Conventions</b>:
+  - Prefixes:
+    - Definitions beginning with "R_" are registers
+    - Definitions beginning with "B_" are bits within registers
+    - Definitions beginning with "V_" are meaningful values of bits within the registers
+    - Definitions beginning with "S_" are register sizes
+    - Definitions beginning with "N_" are the bit position
+  - IPU registers are denoted by "_IPU_" in register names
+  - Registers / bits that are different between IPU generations are denoted by
+    "_IPU_[generation_name]_" in register/bit names. e.g., "_IPU_TGL_"
+  - Registers / bits that are different between SKUs are denoted by "_[SKU_name]"
+    at the end of the register/bit names
+  - Registers / bits of new devices introduced in a IPU generation will be just named
+    as "_IPU_" without [generation_name] inserted.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IPU_REGS_H_
+#define _IPU_REGS_H_
+
+//
+// Device 5 Equates
+//
+#define IPU_BUS_NUM    0x00
+#define IPU_DEV_NUM    0x05
+#define IPU_FUN_NUM    0x00
+
+#endif  // _IPU_REGS_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdRegs.h
new file mode 100644
index 0000000000..d796a44afc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdRegs.h
@@ -0,0 +1,22 @@
+/** @file
+  Register names for VTD block
+  <b>Conventions</b>:
+  - Prefixes:
+    - Definitions beginning with "R_" are registers
+    - Definitions beginning with "B_" are bits within registers
+    - Definitions beginning with "V_" are meaningful values of bits within the registers
+    - Definitions beginning with "S_" are register sizes
+    - Definitions beginning with "N_" are the bit position
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _VTD_REGS_H_
+#define _VTD_REGS_H_
+
+///
+/// Vt-d Engine base address.
+///
+#define R_MCHBAR_VTD1_OFFSET                 0x5400  ///< HW UNIT1 for IGD
+#define R_MCHBAR_VTD3_OFFSET                 0x5410  ///< HW UNIT3 for all other - PEG, USB, SATA etc
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (8 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers Heng Luo
                   ` (29 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Fru/TglPch/Include

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h     | 326 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h        |  16 ++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResources.h |  55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 397 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
new file mode 100644
index 0000000000..0d00f25d5e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
@@ -0,0 +1,326 @@
+/** @file
+  Header file for TigerLake PCH devices PCI Bus Device Function map.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_BDF_ASSIGNMENT_H_
+#define _PCH_BDF_ASSIGNMENT_H_
+
+#define NOT_PRESENT                     0xFF
+
+#define MAX_SATA_CONTROLLER             1
+
+//
+// PCH PCIe Controllers
+//
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_2          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_3          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_4          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_6          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_7          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_8          28
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9          29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_10         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_11         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_12         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_14         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_15         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_16         29
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_18         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_19         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_20         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_22         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_23         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_24         27
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_25         NOT_PRESENT
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_26         NOT_PRESENT
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_27         NOT_PRESENT
+#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_28         NOT_PRESENT
+
+//
+// USB3 (XHCI) Controller PCI config
+//
+#define PCI_DEVICE_NUMBER_PCH_XHCI                    20
+#define PCI_FUNCTION_NUMBER_PCH_XHCI                  0
+
+//
+// xDCI (OTG) USB Device Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_XDCI                    20
+#define PCI_FUNCTION_NUMBER_PCH_XDCI                  1
+
+//
+//  Thermal Device
+//
+#define PCI_DEVICE_NUMBER_PCH_THERMAL                 NOT_PRESENT
+#define PCI_FUNCTION_NUMBER_PCH_THERMAL               NOT_PRESENT
+
+//
+// CSME HECI #1
+//
+#define PCI_DEVICE_NUMBER_PCH_HECI1                   22
+#define PCI_FUNCTION_NUMBER_PCH_HECI1                 0
+
+//
+// CSME HECI #2
+//
+#define PCI_DEVICE_NUMBER_PCH_HECI2                   22
+#define PCI_FUNCTION_NUMBER_PCH_HECI2                 1
+
+//
+// CSME IDE-Redirection (IDE-R)
+//
+#define PCI_DEVICE_NUMBER_PCH_IDER                    22
+#define PCI_FUNCTION_NUMBER_PCH_IDER                  2
+
+//
+// CSME Keyboard and Text (KT) Redirection
+//
+#define PCI_DEVICE_NUMBER_PCH_KTR                     22
+#define PCI_FUNCTION_NUMBER_PCH_KTR                   3
+
+//
+// CSME HECI #3
+//
+#define PCI_DEVICE_NUMBER_PCH_HECI3                   22
+#define PCI_FUNCTION_NUMBER_PCH_HECI3                 4
+
+//
+// CSME HECI #4
+//
+#define PCI_DEVICE_NUMBER_PCH_HECI4                   22
+#define PCI_FUNCTION_NUMBER_PCH_HECI4                 5
+
+//
+// CSME MROM
+//
+#define PCI_DEVICE_NUMBER_PCH_MROM                    NOT_PRESENT
+#define PCI_FUNCTION_NUMBER_PCH_MROM                  NOT_PRESENT
+
+//
+// CSME WLAN
+//
+#define PCI_DEVICE_NUMBER_PCH_WLAN                    22
+#define PCI_FUNCTION_NUMBER_PCH_WLAN                  7
+
+//
+// SATA Controllers
+//
+#define PCI_DEVICE_NUMBER_PCH_SATA_1                  23
+#define PCI_FUNCTION_NUMBER_PCH_SATA_1                0
+#define PCI_DEVICE_NUMBER_PCH_SATA_2                  NOT_PRESENT
+#define PCI_FUNCTION_NUMBER_PCH_SATA_2                NOT_PRESENT
+#define PCI_DEVICE_NUMBER_PCH_SATA_3                  NOT_PRESENT
+#define PCI_FUNCTION_NUMBER_PCH_SATA_3                NOT_PRESENT
+
+//
+//  PCH LP Serial IO I2C #0 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C0          21
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C0        0
+
+//
+//  PCH LP Serial IO I2C #1 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C1          21
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C1        1
+
+//
+//  PCH LP Serial IO I2C #2 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C2          21
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C2        2
+
+//
+//  PCH LP Serial IO I2C #3 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C3          21
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C3        3
+
+//
+//  PCH LP Serial IO I2C #4 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C4          25
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C4        0
+
+//
+//  PCH LP Serial IO I2C #5 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C5          25
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C5        1
+
+//
+//  PCH LP Serial IO I2C #6 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C6          16
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C6        0
+
+//
+//  PCH LP Serial IO I2C #7 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C7          16
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C7        1
+
+//
+//  PCH LP Serial IO SPI #0 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI0          30
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI0        2
+
+//
+//  PCH LP Serial IO SPI #1 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI1          30
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI1        3
+
+//
+//  PCH LP Serial IO SPI #2 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI2          18
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI2        6
+
+//
+//  PCH LP Serial IO SPI #3 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI3          19
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI3        0
+
+//
+//  PCH LP Serial IO SPI #4 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI4          19
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI4        1
+
+//
+//  PCH LP Serial IO SPI #5 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI5          19
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI5        2
+
+//
+//  PCH LP Serial IO SPI #6 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI6          19
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI6        3
+
+//
+//  PCH LP Serial IO UART #0 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART0         30
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART0       0
+
+//
+//  PCH LP Serial IO UART #1 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART1         30
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART1       1
+
+//
+//  PCH LP Serial IO UART #2 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART2         25
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART2       2
+
+//
+//  PCH LP Serial IO UART #3 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART3         17
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART3       0
+
+//
+//  PCH LP Serial IO UART #4 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART4         17
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART4       1
+
+//
+//  PCH LP Serial IO UART #5 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART5         17
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART5       2
+
+//
+//  PCH LP Serial IO UART #6 Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART6         17
+#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART6       3
+
+//
+// DMA-SMBus Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_DMA_SMBUS               30
+#define PCI_FUNCTION_NUMBER_PCH_DMA_SMBUS             4
+
+//
+// TSN GbE Controller #1
+//
+#define PCI_DEVICE_NUMBER_PCH_TSN0                    30
+#define PCI_FUNCTION_NUMBER_PCH_TSN0                  4
+
+//
+// TSN GbE Controller #2
+//
+#define PCI_DEVICE_NUMBER_PCH_TSN1                    30
+#define PCI_FUNCTION_NUMBER_PCH_TSN1                  5
+
+//
+// LPC Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_LPC                     31
+#define PCI_FUNCTION_NUMBER_PCH_LPC                   0
+
+//
+// eSPI Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_ESPI                    31
+#define PCI_FUNCTION_NUMBER_PCH_ESPI                  0
+
+//
+// Primary to Sideband (P2SB) Bridge
+//
+#define PCI_DEVICE_NUMBER_PCH_P2SB                    31
+#define PCI_FUNCTION_NUMBER_PCH_P2SB                  1
+
+//
+// PMC (D31:F2)
+//
+#define PCI_DEVICE_NUMBER_PCH_PMC                     31
+#define PCI_FUNCTION_NUMBER_PCH_PMC                   2
+
+//
+// PMC SSRAM Registers
+//
+#define PCI_DEVICE_NUMBER_PCH_PMC_SSRAM               20
+#define PCI_FUNCTION_NUMBER_PCH_PMC_SSRAM             2
+
+//
+// HD-A Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_HDA                     31
+#define PCI_FUNCTION_NUMBER_PCH_HDA                   3
+
+//
+// SMBus Controller
+//
+#define PCI_DEVICE_NUMBER_PCH_SMBUS                   31
+#define PCI_FUNCTION_NUMBER_PCH_SMBUS                 4
+
+//
+// SPI Controller (D31:F5)
+//
+#define PCI_DEVICE_NUMBER_PCH_SPI                     31
+#define PCI_FUNCTION_NUMBER_PCH_SPI                   5
+
+//
+// Gigabit Ethernet LAN Controller (D31:F6)
+//
+#define PCI_DEVICE_NUMBER_GBE                         31
+#define PCI_FUNCTION_NUMBER_GBE                       6
+
+#endif // _PCH_BDF_ASSIGNMENT_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h
new file mode 100644
index 0000000000..d3548796a3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h
@@ -0,0 +1,16 @@
+/** @file
+  Pcie Root Port info header
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_PCIERP_INFO_H_
+#define _PCH_PCIERP_INFO_H_
+
+//
+// Number of PCIe ports per PCIe controller
+//
+#define PCH_PCIE_CONTROLLER_PORTS                     4u
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResources.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResources.h
new file mode 100644
index 0000000000..283246692f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResources.h
@@ -0,0 +1,55 @@
+/** @file
+  PCH preserved MMIO resource definitions.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PRESERVED_RESOURCES_H_
+#define _PCH_PRESERVED_RESOURCES_H_
+
+/**
+  Detailed recommended static allocation
+  +-------------------------------------------------------------------------+
+  | PCH preserved MMIO range, 32 MB, from 0xFC800000 to 0xFE7FFFFF          |
+  +-------------------------------------------------------------------------+
+  | Size        | Start       | End         | Usage                         |
+  | 8 MB        | 0xFC800000  | 0xFCFFFFFF  | TraceHub SW BAR               |
+  | 16 MB       | 0xFD000000  | 0xFDFFFFFF  | SBREG                         |
+  | 64 KB       | 0xFE000000  | 0xFE00FFFF  | PMC MBAR                      |
+  | 4 KB        | 0xFE010000  | 0xFE010FFF  | SPI BAR0                      |
+  | 176 KB      | 0xFE020000  | 0xFE04BFFF  | SerialIo BAR in ACPI mode     |
+  | 400 KB      | 0xFE04C000  | 0xFE0AFFFF  | Unused                        |
+  | 64 KB       | 0xFE0B0000  | 0xFE0BFFFF  | eSPI LGMR BAR                 |
+  | 64 KB       | 0xFE0C0000  | 0xFE0CFFFF  | eSPI2 SEGMR BAR               |
+  | 192 KB      | 0xFE0D0000  | 0xFE0FFFFF  | Unused                        |
+  | 1 MB        | 0xFE100000  | 0xFE1FFFFF  | TraceHub MTB BAR              |
+  | 2 MB        | 0xFE200000  | 0xFE3FFFFF  | TraceHub FW BAR               |
+  | 2 MB        | 0xFE400000  | 0xFE5FFFFF  | Unused                        |
+  | 2 MB        | 0xFE600000  | 0xFE7FFFFF  | Temp address                  |
+  +-------------------------------------------------------------------------+
+**/
+#define PCH_PRESERVED_BASE_ADDRESS      0xFC800000     ///< Pch preserved MMIO base address
+#define PCH_PRESERVED_MMIO_SIZE         0x02000000     ///< 32MB
+#define PCH_TRACE_HUB_SW_BASE_ADDRESS   0xFC800000     ///< TraceHub SW MMIO base address
+#define PCH_TRACE_HUB_SW_MMIO_SIZE      0x00800000     ///< 8MB
+#define PCH_PCR_BASE_ADDRESS            0xFD000000     ///< SBREG MMIO base address
+#define PCH_PCR_MMIO_SIZE               0x01000000     ///< 16MB
+#define PCH_PWRM_BASE_ADDRESS           0xFE000000     ///< PMC MBAR MMIO base address
+#define PCH_PWRM_MMIO_SIZE              0x00010000     ///< 64KB
+#define PCH_SPI_BASE_ADDRESS            0xFE010000     ///< SPI BAR0 MMIO base address
+#define PCH_SPI_MMIO_SIZE               0x00001000     ///< 4KB
+#define PCH_SERIAL_IO_BASE_ADDRESS      0xFE020000     ///< SerialIo MMIO base address
+#define PCH_SERIAL_IO_MMIO_SIZE         0x0002C000     ///< 176KB
+#define PCH_ESPI_LGMR_BASE_ADDRESS      0xFE0B0000     ///< eSPI LGMR MMIO base address
+#define PCH_ESPI_LGMR_MMIO_SIZE         0x00010000     ///< 64KB
+#define PCH_ESPI_SEGMR_BASE_ADDRESS     0xFE0C0000     ///< Second eSPI GMR MMIO base address
+#define PCH_ESPI_SEGMR_MMIO_SIZE        0x00010000     ///< 64KB
+#define PCH_TRACE_HUB_MTB_BASE_ADDRESS  0xFE100000     ///< TraceHub MTB MMIO base address
+#define PCH_TRACE_HUB_MTB_MMIO_SIZE     0x00100000     ///< 1MB
+#define PCH_TRACE_HUB_FW_BASE_ADDRESS   0xFE200000     ///< TraceHub FW MMIO base address
+#define PCH_TRACE_HUB_FW_MMIO_SIZE      0x00200000     ///< 2MB
+#define PCH_TEMP_BASE_ADDRESS           0xFE600000     ///< preserved temp address for misc usage,
+#define PCH_TEMP_MMIO_SIZE              0x00200000     ///< 2MB
+
+#endif // _PCH_PRESERVED_RESOURCES_H_
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (9 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component Heng Luo
                   ` (28 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following header files:
  * Fru/TglPch/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPcrRegs.h | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPcrRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPcrRegs.h
new file mode 100644
index 0000000000..4987d21f09
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPcrRegs.h
@@ -0,0 +1,66 @@
+/** @file
+  Register names for PCH private chipset register
+
+Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PCR_H_
+#define _PCH_REGS_PCR_H_
+
+/**
+  Definition for SBI PID
+  The PCH_SBI_PID defines the PID for PCR MMIO programming and PCH SBI programming as well.
+**/
+#define PID_CNVI       0x73
+#define PID_ICLK       0xAD
+#define PID_DMI        0x88
+#define PID_PSTH       0x89
+#define PID_ESPISPI    0x72
+#define PID_SPF        0x85
+#define PID_SPE        0x84
+#define PID_SPD        0x83
+#define PID_SPC        0x82
+#define PID_SPB        0x81
+#define PID_SPA        0x80
+#define PID_PSF6       0x7F
+#define PID_PSF4       0xBD
+#define PID_PSF3       0xBC
+#define PID_PSF2       0xBB
+#define PID_PSF1       0xBA
+#define PID_GPIOCOM0   0x6E
+#define PID_GPIOCOM1   0x6D
+#define PID_GPIOCOM2   0x6C
+#define PID_GPIOCOM3   0x6B
+#define PID_GPIOCOM4   0x6A
+#define PID_GPIOCOM5   0x69
+#define PID_CSME_PSF   0x8F
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (10 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component Heng Luo
                   ` (27 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Cnvi/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHob.h | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHob.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHob.h
new file mode 100644
index 0000000000..e881e49d62
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHob.h
@@ -0,0 +1,27 @@
+/** @file
+  This file defines the CNVi CONFIG HOB
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CNVI_CONFIG_HOB_H_
+#define _CNVI_CONFIG_HOB_H_
+
+#include <Base.h>
+
+extern EFI_GUID gCnviConfigHobGuid;
+#pragma pack (push,1)
+
+/**
+  This HOB is used to pass CNVi related private information to DXE phase
+**/
+typedef struct {
+  EFI_HOB_GUID_TYPE EfiHobGuidType; ///< GUID HOB type structure for gCnviConfigHobGuid
+  UINT32 Mode           :  1; ///< 0: Disabled, <b>1: Auto</b>
+  UINT32 BtCore         :  1; ///< 0: Disabled, <b>1: Enabled</b>
+  UINT32 BtAudioOffload :  1; ///< <b>0: Disabled</b>, 1: Enabled
+  UINT32 RsvdBits0      : 29; ///< Reserved bits
+} CNVI_CONFIG_HOB;
+#pragma pack (pop)
+
+#endif // _CNVI_CONFIG_HOB_H_
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (11 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:53   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component Heng Luo
                   ` (26 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/CpuPcieRp/Include
  * IpBlock/CpuPcieRp/IncludePrivate
  * IpBlock/CpuPcieRp/Library
  * IpBlock/CpuPcieRp/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h                                                   |  31 +++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieInitCommon.h                                     | 353 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieRpLib.h                                          |  47 +++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library/DxeCpuPcieRpLib.h                                |  18 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/CpuPcieInitCommon.c               | 445 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf |  33 +++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/CpuPcieRpLib.c                            |  48 ++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf                 |  32 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.c                        |  62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf                      |  40 ++++++++++++++++++++++++++++++++++++++++
 10 files changed, 1109 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h
new file mode 100644
index 0000000000..15eeab0ecf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h
@@ -0,0 +1,31 @@
+/** @file
+  This file contains definitions of PCIe controller information
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PCIE_INFO_H_
+#define _CPU_PCIE_INFO_H_
+
+#define PCIE_HWEQ_COEFFS_MAX    5
+
+//
+// Device 1 Memory Mapped IO Register Offset Equates
+//
+#define SA_PEG_DEV_NUM     0x01
+#define SA_PEG0_DEV_NUM    SA_PEG_DEV_NUM
+#define SA_PEG3_DEV_NUM    0x06
+
+//
+// SA PCI Express* Port configuration
+//
+
+#define CPU_PCIE_MAX_ROOT_PORTS            4
+
+#define SA_PEG_MAX_FUN           0x04
+#define SA_PEG_MAX_LANE          0x14
+#define SA_PEG_MAX_FUN_GEN3      0x03
+#define SA_PEG_MAX_LANE_GEN3     0x10
+#define SA_PEG_MAX_BUNDLE_GEN3   0x08
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieInitCommon.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieInitCommon.h
new file mode 100644
index 0000000000..79b255c273
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieInitCommon.h
@@ -0,0 +1,353 @@
+/** @file
+Header file for CpuPcieInitCommonLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PCIE_INIT_COMMON_H_
+#define _CPU_PCIE_INIT_COMMON_H_
+
+#include <Library/CpuRegbarAccessLib.h>
+
+/**
+  Print registers value
+
+  @param[in] PrintMmioBase       Mmio base address
+  @param[in] PrintSize           Number of registers
+  @param[in] OffsetFromBase      Offset from mmio base address
+
+  @retval None
+**/
+VOID
+SaPrintRegisters (
+  IN  UINTN        PrintMmioBase,
+  IN  UINT32       PrintSize,
+  IN  UINT32       OffsetFromBase
+  );
+
+/**
+  Print registers value
+
+  @param[in] PrintPciSegmentBase Pci segment base address
+  @param[in] PrintSize           Number of registers
+  @param[in] OffsetFromBase      Offset from mmio base address
+
+  @retval None
+**/
+VOID
+SaPrintPciRegisters (
+  IN  UINT64       PrintPciSegmentBase,
+  IN  UINT32       PrintSize,
+  IN  UINT32       OffsetFromBase
+  );
+
+//
+// 2LM: PegPcie APIs for Sideband Access Mechanism in 2LM mode
+//
+/**
+Reads an 8-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentRead8 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+@return The 8-bit PCI configuration register specified by Address.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentRead8 (
+  IN UINT64                    Address
+  );
+
+/**
+Writes an 8-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentWrite8 function.
+
+@param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  Value       The value to write.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentWrite8 (
+  IN UINT64                    Address,
+  IN UINT8                     Value
+  );
+
+/**
+Reads a 16-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentRead16 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+@return The 16-bit PCI configuration register specified by Address.
+
+**/
+UINT16
+EFIAPI
+PegPciSegmentRead16 (
+  IN UINT64                    Address
+  );
+
+/**
+Writes a 16-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentWrite16 function.
+
+@param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  Value       The value to write.
+
+@return The parameter of Value.
+
+**/
+UINT16
+EFIAPI
+PegPciSegmentWrite16  (
+  IN UINT64                    Address,
+  IN UINT16                    Value
+  );
+
+/**
+Reads a 32-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentRead32 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+@return The 32-bit PCI configuration register specified by Address.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentRead32 (
+  IN UINT64                    Address
+  );
+
+/**
+Writes a 32-bit PCI configuration register.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentWrite32 function.
+
+@param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  Value       The value to write.
+
+@return The parameter of Value.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentWrite32 (
+  IN UINT64                    Address,
+  IN UINT32                    Value
+  );
+
+/**
+Performs a bitwise OR of a 16-bit PCI configuration register with a 16-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentOr16 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+**/
+UINT16
+EFIAPI
+PegPciSegmentOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    OrData
+  );
+
+/**
+Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAnd32 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PegPciSegmentAnd16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData
+  );
+
+/**
+Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAnd8 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentAnd8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData
+  );
+
+/**
+Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentOr32 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    OrData
+  );
+
+/**
+Performs a bitwise OR of a 8-bit PCI configuration register with a 8-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentOr8 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     OrData
+  );
+
+/**
+Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAnd32 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentAnd32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData
+  );
+
+/**
+Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value,
+followed a  bitwise OR with another 32-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAndThenOr32 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  );
+
+/**
+Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value,
+followed a  bitwise OR with another 16-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAndThenOr16 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PegPciSegmentAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  );
+
+/**
+Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit value,
+followed a  bitwise OR with another 8-bit value.
+
+Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+Other calls to this function will be routed to core PciSegmentAndThenOr8 function.
+
+@param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+@param  AndData   The value to AND with the PCI configuration register.
+@param  OrData    The value to OR with the PCI configuration register.
+
+@return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  );
+
+/**
+Find the Offset to a Capabilities ID
+@param[in] Segment              Pci Segment Number
+@param[in] Bus                  Pci Bus Number
+@param[in] Device               Pci Device Number
+@param[in] Function             Pci Function Number
+@param[in] CapId                CAPID to search for
+
+@retval 0                       CAPID not found
+@retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PegPcieFindCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT8   CapId
+  );
+#endif // _CPU_PCIE_INIT_COMMON_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieRpLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieRpLib.h
new file mode 100644
index 0000000000..ebb568193a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcieRpLib.h
@@ -0,0 +1,47 @@
+/** @file
+  Header file for CpuPcieRpLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _CPU_PCIERP_LIB_H_
+#define _CPU_PCIERP_LIB_H_
+
+#include <Ppi/SiPolicy.h>
+#include <Library/HobLib.h>
+
+#pragma pack(1)
+
+typedef struct {
+  UINT8   Segment;
+  UINT8   Bus;
+  UINT8   Device;
+  UINT8   Function;
+  BOOLEAN Enable;
+} CPU_PCIE_RP_INFO;
+
+#pragma pack()
+
+/**
+  Determines whether PCIe link is active
+
+  @param[in] RpBase    Root Port base address
+  @retval Link Active state
+**/
+BOOLEAN
+CpuPcieIsLinkActive (
+  UINT64  RpBase
+  );
+
+/**
+  Get max PCIe link speed supported by the root port.
+
+  @param[in] RpBase    Root Port pci segment base address
+  @return    Max link speed
+**/
+UINT32
+CpuPcieGetMaxLinkSpeed (
+  UINT64 RpBase
+  );
+
+#endif // _CPU_PCIERP_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library/DxeCpuPcieRpLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library/DxeCpuPcieRpLib.h
new file mode 100644
index 0000000000..593e1893bb
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library/DxeCpuPcieRpLib.h
@@ -0,0 +1,18 @@
+/** @file
+  Header file for private DxeCpuPcieRpLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_PCIE_RP_INIT_LIB_H_
+#define _DXE_PCIE_RP_INIT_LIB_H_
+
+/**
+  Update CPU PCIE RP NVS AREA tables
+
+**/
+VOID
+UpdateCpuPcieNVS (
+  VOID
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/CpuPcieInitCommon.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/CpuPcieInitCommon.c
new file mode 100644
index 0000000000..28032e5b24
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/CpuPcieInitCommon.c
@@ -0,0 +1,445 @@
+/** @file
+ common library for CPU PCIe INIT PEI/DXE/SMM modules
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/PcieHelperLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/IoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/CpuPcieRpLib.h>
+#include <Register/CpuPcieRegs.h>
+#include <Library/CpuPcieInitCommon.h>
+#include <Library/CpuRegbarAccessLib.h>
+
+/**
+  Print registers value
+
+  @param[in] PrintMmioBase       Mmio base address
+  @param[in] PrintSize           Number of registers
+  @param[in] OffsetFromBase      Offset from mmio base address
+
+  @retval None
+**/
+VOID
+SaPrintRegisters (
+  IN  UINTN        PrintMmioBase,
+  IN  UINT32       PrintSize,
+  IN  UINT32       OffsetFromBase
+  )
+{
+  UINT32  Offset;
+  DEBUG ((DEBUG_VERBOSE, "       00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F"));
+  for (Offset = 0; Offset < PrintSize; Offset++) {
+    if ((Offset % 16) == 0) {
+      DEBUG ((DEBUG_VERBOSE, "\n %04X: ", (Offset + OffsetFromBase) & 0xFFF0));
+    }
+    DEBUG ((DEBUG_VERBOSE, "%02X ", MmioRead8 (PrintMmioBase + Offset)));
+  }
+  DEBUG ((DEBUG_VERBOSE, "\n"));
+}
+
+/**
+  Print registers value
+
+  @param[in] PrintPciSegmentBase Pci segment base address
+  @param[in] PrintSize           Number of registers
+  @param[in] OffsetFromBase      Offset from mmio base address
+
+  @retval None
+**/
+VOID
+SaPrintPciRegisters (
+  IN  UINT64       PrintPciSegmentBase,
+  IN  UINT32       PrintSize,
+  IN  UINT32       OffsetFromBase
+  )
+{
+  UINT32  Offset;
+  DEBUG ((DEBUG_VERBOSE, "       00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F"));
+  for (Offset = 0; Offset < PrintSize; Offset++) {
+    if ((Offset % 16) == 0) {
+      DEBUG ((DEBUG_VERBOSE, "\n %04X: ", (Offset + OffsetFromBase) & 0xFFF0));
+    }
+    DEBUG ((DEBUG_VERBOSE, "%02X ", PciSegmentRead8 (PrintPciSegmentBase + Offset)));
+  }
+  DEBUG ((DEBUG_VERBOSE, "\n"));
+}
+
+//
+// 2LM: PegPcie APIs using the Sideband Access Mechanism
+//
+/**
+  Reads an 8-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentRead8 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 8-bit PCI configuration register specified by Address.
+**/
+UINT8
+EFIAPI
+PegPciSegmentRead8 (
+  IN UINT64                    Address
+  )
+{
+  return PciSegmentRead8 (Address);
+}
+
+/**
+  Writes an 8-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentWrite8 function.
+
+  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT8
+EFIAPI
+PegPciSegmentWrite8 (
+  IN UINT64                    Address,
+  IN UINT8                     Value
+  )
+{
+  return PciSegmentWrite8 (Address, Value);
+}
+
+/**
+  Reads a 16-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentRead16 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 16-bit PCI configuration register specified by Address.
+**/
+UINT16
+EFIAPI
+PegPciSegmentRead16 (
+  IN UINT64                    Address
+  )
+{
+  return PciSegmentRead16 (Address);
+}
+
+/**
+  Writes a 16-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentWrite16 function.
+
+  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+**/
+UINT16
+EFIAPI
+PegPciSegmentWrite16 (
+  IN UINT64                    Address,
+  IN UINT16                     Value
+  )
+{
+  return PciSegmentWrite16 (Address, Value);
+}
+
+/**
+  Reads a 32-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentRead32 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 32-bit PCI configuration register specified by Address.
+**/
+UINT32
+EFIAPI
+PegPciSegmentRead32 (
+  IN UINT64                    Address
+  )
+{
+  return PciSegmentRead32 (Address);
+}
+
+/**
+  Writes a 32-bit PCI configuration register.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentWrite32 function.
+
+  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+**/
+UINT32
+EFIAPI
+PegPciSegmentWrite32 (
+  IN UINT64                    Address,
+  IN UINT32                     Value
+  )
+{
+  return PciSegmentWrite32 (Address, Value);
+}
+
+/**
+  Performs a bitwise OR of a 16-bit PCI configuration register with a 16-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentOr16 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT16
+EFIAPI
+PegPciSegmentOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentOr16 (Address, OrData);
+}
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAnd32 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PegPciSegmentAnd16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData
+  )
+{
+  return PciSegmentAnd16 (Address, AndData);
+}
+
+/**
+  Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAnd8 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PegPciSegmentAnd8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData
+  )
+{
+  return PciSegmentAnd8 (Address, AndData);
+}
+
+/**
+  Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentOr32 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT32
+EFIAPI
+PegPciSegmentOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentOr32 (Address, OrData);
+}
+
+/**
+  Performs a bitwise OR of a 8-bit PCI configuration register with a 8-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentOr8 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT8
+EFIAPI
+PegPciSegmentOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentOr8 (Address, OrData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAnd32 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PegPciSegmentAnd32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData
+  )
+{
+  return PciSegmentAnd32 (Address, AndData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value,
+  followed a  bitwise OR with another 32-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAndThenOr32 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT32
+EFIAPI
+PegPciSegmentAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentAndThenOr32 (Address, AndData, OrData);
+}
+
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value,
+  followed a  bitwise OR with another 16-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAndThenOr16 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT16
+EFIAPI
+PegPciSegmentAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentAndThenOr16 (Address, AndData, OrData);
+}
+
+
+/**
+  Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit value,
+  followed a  bitwise OR with another 8-bit value.
+
+  Its a wrapper library function. This function uses side band access for PEG60 when 2LM mode is enabled.
+  Other calls to this function will be routed to core PciSegmentAndThenOr8 function.
+
+  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+**/
+UINT8
+EFIAPI
+PegPciSegmentAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentAndThenOr8 (Address, AndData, OrData);
+}
+
+
+/**
+  Find the Offset to a Capabilities ID
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PegPcieFindCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT8   CapId
+  )
+{
+  return PcieFindCapId (Segment, Bus, Device, Function, CapId);
+}
+
+
+/**
+  Search and return the offset of desired Pci Express extended Capability ID
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                Extended CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT16
+PegPcieFindExtendedCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT16  CapId
+  )
+{
+  return PcieFindExtendedCapId (Segment, Bus, Device, Function, CapId);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
new file mode 100644
index 0000000000..2ad30ab7c9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
@@ -0,0 +1,33 @@
+## @file
+#  Component description file for the CpuPcieInitCommonLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010017
+  BASE_NAME                      = PeiDxeSmmCpuPcieInitCommonLib
+  FILE_GUID                      = 68992CB0-A3A5-4f73-9370-93A3559F84C8
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = CpuPcieInitCommonLib
+
+[Sources]
+  CpuPcieInitCommon.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[LibraryClasses]
+  IoLib
+  DebugLib
+  PciSegmentLib
+  CpuPcieRpLib
+  CpuRegbarAccessLib
+  BasePcieHelperLib
+
+[Pcd]
+  gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                  ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/CpuPcieRpLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/CpuPcieRpLib.c
new file mode 100644
index 0000000000..02cd482b55
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/CpuPcieRpLib.c
@@ -0,0 +1,48 @@
+/** @file
+  CPU PCIe root port library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <PcieRegs.h>
+#include <Register/CpuPcieRegs.h>
+#include "CpuPcieInfo.h"
+#include <Library/CpuPcieInitCommon.h>
+#include <Library/PciLib.h>
+#include <IndustryStandard/Pci22.h>
+
+/**
+  Determines whether PCIe link is active
+
+  @param[in] RpBase    Root Port base address
+  @retval Link Active state
+**/
+BOOLEAN
+CpuPcieIsLinkActive (
+  UINT64  RpBase
+  )
+{
+  return !! (PegPciSegmentRead16 (RpBase + R_PCIE_LSTS) & B_PCIE_LSTS_LA);
+}
+
+/**
+  Get max PCIe link speed supported by the root port.
+
+  @param[in] RpBase    Root Port base address
+  @return    Max link speed
+**/
+UINT32
+CpuPcieGetMaxLinkSpeed (
+  UINT64 RpBase
+  )
+{
+  return PegPciSegmentRead32 (RpBase + R_PCIE_LCAP) & B_PCIE_LCAP_MLS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
new file mode 100644
index 0000000000..cea8bcbecd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
@@ -0,0 +1,32 @@
+## @file
+# CPU PCIE root port Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmCpuPcieRpLib
+FILE_GUID = 00199A03-41F4-43c7-B6D5-5A3AA1EE78D0
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = CpuPcieRpLib
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+CpuPcieRpLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.c
new file mode 100644
index 0000000000..48ef8165de
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.c
@@ -0,0 +1,62 @@
+/** @file
+  The DXE CPU PCIE RP Library Implements After Memory PEIM
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Ppi/SiPolicy.h>
+#include <Library/HobLib.h>
+#include <Library/PciSegmentLib.h>
+#include <IndustryStandard/Pci22.h>
+#include <Protocol/SaPolicy.h>
+#include <Protocol/SaNvsArea.h>
+#include <Library/PcdLib.h>
+#include <Library/PciExpressHelpersLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <ConfigBlock/PcieDxeConfig.h>
+#include <Register/SaRegsHostBridge.h>
+
+/**
+Update CPU PCIE RP NVS AREA tables
+
+**/
+VOID
+UpdateCpuPcieNVS (
+  VOID
+  )
+{
+  EFI_STATUS                       Status;
+  PCIE_DXE_CONFIG                  *PcieDxeConfig;
+  SA_POLICY_PROTOCOL               *SaPolicy;
+  SYSTEM_AGENT_NVS_AREA_PROTOCOL   *SaNvsAreaProtocol;
+
+  DEBUG ((DEBUG_INFO, "Update Cpu Pcie NVS Area.\n"));
+
+  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **) &SaPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = GetConfigBlock ((VOID *)SaPolicy, &gPcieDxeConfigGuid, (VOID *)&PcieDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->LocateProtocol (&gSaNvsAreaProtocolGuid, NULL, (VOID **) &SaNvsAreaProtocol);
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Locate SA NVS Area failed.\n"));
+    return;
+  }
+
+  SaNvsAreaProtocol->Area->Peg0LtrEnable  = PcieDxeConfig->PegPwrOpt[0].LtrEnable;
+  SaNvsAreaProtocol->Area->Peg0ObffEnable = PcieDxeConfig->PegPwrOpt[0].ObffEnable;
+  SaNvsAreaProtocol->Area->Peg1LtrEnable  = PcieDxeConfig->PegPwrOpt[1].LtrEnable;
+  SaNvsAreaProtocol->Area->Peg1ObffEnable = PcieDxeConfig->PegPwrOpt[1].ObffEnable;
+  SaNvsAreaProtocol->Area->Peg2LtrEnable  = PcieDxeConfig->PegPwrOpt[2].LtrEnable;
+  SaNvsAreaProtocol->Area->Peg2ObffEnable = PcieDxeConfig->PegPwrOpt[2].ObffEnable;
+  SaNvsAreaProtocol->Area->Peg3LtrEnable  = PcieDxeConfig->PegPwrOpt[3].LtrEnable;
+  SaNvsAreaProtocol->Area->Peg3ObffEnable = PcieDxeConfig->PegPwrOpt[3].ObffEnable;
+  SaNvsAreaProtocol->Area->PegLtrMaxSnoopLatency = V_SA_LTR_MAX_SNOOP_LATENCY_VALUE;
+  SaNvsAreaProtocol->Area->PegLtrMaxNoSnoopLatency = V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
new file mode 100644
index 0000000000..dc9b893be3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
@@ -0,0 +1,40 @@
+## @file
+#   The DXE CPU PCIE RP Library Implements After Memory PEIM
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeCpuPcieRpLib
+FILE_GUID = D563A22E-6A01-4EF7-84D1-78B6717E3402
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+UEFI_SPECIFICATION_VERSION = 2.00
+LIBRARY_CLASS = DxeCpuPcieRpLib
+
+[LibraryClasses]
+IoLib
+BaseLib
+DebugLib
+BaseMemoryLib
+UefiBootServicesTableLib
+UefiLib
+HobLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeCpuPcieRpLib.c
+
+[Guids]
+gPcieDxeConfigGuid
+
+[Protocols]
+gSaPolicyProtocolGuid                  ## CONSUMES
+gSaNvsAreaProtocolGuid                 ## CONSUMES
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (12 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component Heng Luo
                   ` (25 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Espi/Library

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/EspiLib.c            | 469 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/PeiDxeSmmEspiLib.inf |  38 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 507 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/EspiLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/EspiLib.c
new file mode 100644
index 0000000000..2d1928ce18
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/EspiLib.c
@@ -0,0 +1,469 @@
+/** @file
+  This file contains routines for eSPI
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/EspiLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/TimerLib.h>
+#include <PchLimits.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchRegsLpc.h>
+
+#define CHANNEL_RESET_TIMEOUT     100   ///< Channel reset timeout in us after which to report error
+#define SLAVE_CHANNELS_MAX        7     ///< Max number of channels
+
+//
+// eSPI Slave registers
+//
+#define R_ESPI_SLAVE_GENCAP               0x08      ///< General Capabilities and Configurations
+#define B_ESPI_SLAVE_GENCAP_SUPPCHAN      0xFF      ///< Channels supported bit mask
+#define R_ESPI_SLAVE_CHACAP_BASE          0x10      ///< Base address from which channel Cap and Conf registers start on slave
+#define S_ESPI_SLAVE_CHACAP_OFFSET        0x10      ///< Offset for each channel from base
+#define B_ESPI_SLAVE_CHACAP_CHEN          BIT0      ///< Slave Channel enable bit
+#define B_ESPI_SLAVE_CHACAP_CHRDY         BIT1      ///< Slave Channel ready bit
+
+/**
+  Checks if second slave capability is enabled
+
+  @retval TRUE      There's second slave
+  @retval FALSE     There's no second slave
+**/
+BOOLEAN
+IsEspiSecondSlaveSupported (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Checks in slave General Capabilities register if it supports channel with requested number
+
+  @param[in]  SlaveId         Id of slave to check
+  @param[in]  ChannelNumber   Number of channel of which to check
+
+  @retval TRUE      Channel with requested number is supported by slave device
+  @retval FALSE     Channel with requested number is not supported by slave device
+**/
+BOOLEAN
+IsEspiSlaveChannelSupported (
+  UINT8   SlaveId,
+  UINT8   ChannelNumber
+  )
+{
+  UINT32  Data32;
+  UINT8   SupportedChannels;
+
+  PchEspiSlaveGetConfig (SlaveId, R_ESPI_SLAVE_GENCAP, &Data32);
+  SupportedChannels = (UINT8) (Data32 & B_ESPI_SLAVE_GENCAP_SUPPCHAN);
+
+  DEBUG ((DEBUG_INFO, "Slave %d supported channels 0x%4X\n", SlaveId, SupportedChannels));
+
+  if (ChannelNumber > SLAVE_CHANNELS_MAX || !(SupportedChannels & (BIT0 << ChannelNumber))) {
+    // Incorrect channel number was specified. Either exceeded max or Slave doesn't support that channel.
+    return FALSE;
+  }
+
+  return TRUE;
+}
+
+/**
+  Is eSPI enabled in strap.
+
+  @retval TRUE          Espi is enabled in strap
+  @retval FALSE         Espi is disabled in strap
+**/
+BOOLEAN
+IsEspiEnabled (
+  VOID
+  )
+{
+  return (PchPcrRead32 (PID_ESPISPI, R_ESPI_PCR_CFG_VAL) & B_ESPI_PCR_CFG_VAL_ESPI_EN) != 0;
+}
+
+/**
+  eSPI helper function to clear slave configuration register status
+
+  @retval EFI_SUCCESS Write to private config space succeed
+  @retval others      Read / Write failed
+**/
+STATIC
+VOID
+EspiClearScrs (
+  VOID
+  )
+{
+  PchPcrAndThenOr32 (
+    PID_ESPISPI,
+    R_ESPI_PCR_SLV_CFG_REG_CTL,
+    (UINT32) ~0,
+     B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS
+     );
+}
+
+/**
+  eSPI helper function to poll slave configuration register enable for 0
+  and to check for slave configuration register status
+
+  @retval EFI_SUCCESS       Enable bit is zero and no error in status bits
+  @retval EFI_DEVICE_ERROR  Error in SCRS
+  @retval others            Read / Write to private config space failed
+**/
+STATIC
+EFI_STATUS
+EspiPollScreAndCheckScrs (
+  VOID
+  )
+{
+  UINT32     ScrStat;
+
+  do {
+    ScrStat = PchPcrRead32 (PID_ESPISPI, R_ESPI_PCR_SLV_CFG_REG_CTL);
+  } while ((ScrStat & B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE) != 0);
+
+  ScrStat = (ScrStat & B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS) >> N_ESPI_PCR_SLV_CFG_REG_CTL_SCRS;
+  if (ScrStat != V_ESPI_PCR_SLV_CFG_REG_CTL_SCRS_NOERR) {
+    DEBUG ((DEBUG_ERROR, "eSPI slave config register status (error) is %x \n", ScrStat));
+    return EFI_DEVICE_ERROR;
+  }
+  return EFI_SUCCESS;
+}
+
+typedef enum {
+  EspiSlaveOperationConfigRead,
+  EspiSlaveOperationConfigWrite,
+  EspiSlaveOperationStatusRead,
+  EspiSlaveOperationInBandReset
+} ESPI_SLAVE_OPERATION;
+
+/**
+  Helper library to do all the operations regards to eSPI slave
+
+  @param[in]      SlaveId         eSPI Slave ID
+  @param[in]      SlaveAddress    Slave address to be put in R_ESPI_PCR_SLV_CFG_REG_CTL[11:0]
+  @param[in]      SlaveOperation  Based on ESPI_SLAVE_OPERATION
+  @param[in,out]  Data
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PCH_LP
+  @retval EFI_INVALID_PARAMETER Slave configuration register address exceed maximum allowed
+  @retval EFI_INVALID_PARAMETER Slave configuration register address is not DWord aligned
+  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to 0x7FF has been locked
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+STATIC
+EFI_STATUS
+EspiSlaveOperationHelper (
+  IN     UINT32               SlaveId,
+  IN     UINT32               SlaveAddress,
+  IN     ESPI_SLAVE_OPERATION SlaveOperation,
+  IN OUT UINT32               *Data
+  )
+{
+  EFI_STATUS  Status;
+  UINT32      Data32;
+
+  //
+  // Check the SlaveId is 0 or 1
+  //
+  if (SlaveId >= PCH_MAX_ESPI_SLAVES) {
+    DEBUG ((DEBUG_ERROR, "eSPI Slave ID of %d or more is not accepted \n", PCH_MAX_ESPI_SLAVES));
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Check if SlaveId 1 is used, it is not a PCH_LP
+  //
+  if (SlaveId == 1) {
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Check the address is not more then 0xFFF
+  //
+  if (SlaveAddress > B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA) {
+    DEBUG ((DEBUG_ERROR, "eSPI Slave address must be less than 0x%x \n", (B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA + 1)));
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Check the address is DWord aligned
+  //
+  if ((SlaveAddress & 0x3) != 0) {
+    DEBUG ((DEBUG_ERROR, "eSPI Slave address must be DWord aligned \n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Check if write is allowed
+  //
+  if ((SlaveOperation == EspiSlaveOperationConfigWrite) &&
+      (SlaveAddress <= 0x7FF)) {
+
+    //
+    // If the SLCRR is not set in corresponding slave, we will check the lock bit
+    //
+    Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16) (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_LNKERR_SLV0)));
+    if ((Data32 & B_ESPI_PCR_LNKERR_SLV0_SLCRR) == 0) {
+
+      Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16) R_ESPI_PCR_SLV_CFG_REG_CTL);
+      if ((Data32 & B_ESPI_PCR_SLV_CFG_REG_CTL_SBLCL) != 0) {
+        DEBUG ((DEBUG_ERROR, "eSPI Slave write to address range 0 to 0x7FF has been locked \n"));
+        return EFI_ACCESS_DENIED;
+      }
+    }
+  }
+
+  //
+  // Input check done, now go through all the processes
+  //
+   EspiClearScrs ();
+
+  if (SlaveOperation == EspiSlaveOperationConfigWrite) {
+    PchPcrWrite32 (
+      PID_ESPISPI,
+      (UINT16) R_ESPI_PCR_SLV_CFG_REG_DATA,
+      *Data
+      );
+  }
+
+  PchPcrAndThenOr32 (
+    PID_ESPISPI,
+    (UINT16) R_ESPI_PCR_SLV_CFG_REG_CTL,
+    (UINT32) ~(B_ESPI_PCR_SLV_CFG_REG_CTL_SID | B_ESPI_PCR_SLV_CFG_REG_CTL_SCRT | B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA),
+    (B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE |
+     (SlaveId << N_ESPI_PCR_SLV_CFG_REG_CTL_SID) |
+     (((UINT32) SlaveOperation) << N_ESPI_PCR_SLV_CFG_REG_CTL_SCRT) |
+     SlaveAddress
+     )
+    );
+
+  Status = EspiPollScreAndCheckScrs ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if ((SlaveOperation == EspiSlaveOperationConfigRead) || (SlaveOperation == EspiSlaveOperationStatusRead)) {
+    Data32 = PchPcrRead32 (
+               PID_ESPISPI,
+               (UINT16) R_ESPI_PCR_SLV_CFG_REG_DATA
+               );
+    if (SlaveOperation == EspiSlaveOperationStatusRead) {
+      *Data = Data32 & 0xFFFF;
+    } else {
+      *Data = Data32;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Get configuration from eSPI slave
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[in]  SlaveAddress  Slave Configuration Register Address
+  @param[out] OutData       Configuration data read
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PCH_LP
+  @retval EFI_INVALID_PARAMETER Slave configuration register address exceed maximum allowed
+  @retval EFI_INVALID_PARAMETER Slave configuration register address is not DWord aligned
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveGetConfig (
+  IN  UINT32 SlaveId,
+  IN  UINT32 SlaveAddress,
+  OUT UINT32 *OutData
+  )
+{
+  //
+  // 1. Clear status from previous transaction by writing 111b to status in SCRS, PCR[eSPI] + 4000h [30:28]
+  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit [20:19]=<SlvID>, Bit [17:16] = 00b, Bit[11:0] = <addr_xxx>.
+  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
+  // 4. Check the transaction status in SCRS (bits [30:28])
+  // 5. Read SLV_CFG_REG_DATA.
+  //
+  return EspiSlaveOperationHelper (SlaveId, SlaveAddress, EspiSlaveOperationConfigRead, OutData);
+}
+
+/**
+  Set eSPI slave configuration
+
+  Note: A Set_Configuration must always be followed by a Get_Configuration in order to ensure
+  that the internal state of the eSPI-MC is consistent with the Slave's register settings.
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[in]  SlaveAddress  Slave Configuration Register Address
+  @param[in]  InData        Configuration data to write
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PCH_LP
+  @retval EFI_INVALID_PARAMETER Slave configuration register address exceed maximum allowed
+  @retval EFI_INVALID_PARAMETER Slave configuration register address is not DWord aligned
+  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to 0x7FF has been locked
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveSetConfig (
+  IN  UINT32 SlaveId,
+  IN  UINT32 SlaveAddress,
+  IN  UINT32 InData
+  )
+{
+  EFI_STATUS  Status;
+  UINT32      Data32;
+
+  //
+  // 1. Clear status from previous transaction by writing 111b to status in SCRS, PCR[eSPI] + 4000h [30:28]
+  // 2. Program SLV_CFG_REG_DATA with the write value.
+  // 3. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit [20:19]=<SlvID>, Bit [17:16] = 01b, Bit[11:0] = <addr_xxx>.
+  // 4. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
+  // 5. Check the transaction status in SCRS (bits [30:28])
+  //
+  Status = EspiSlaveOperationHelper (SlaveId, SlaveAddress, EspiSlaveOperationConfigWrite, &InData);
+  PchEspiSlaveGetConfig (SlaveId, SlaveAddress, &Data32);
+  return Status;
+}
+
+/**
+  Get status from eSPI slave
+
+  @param[in]  SlaveId       eSPI slave ID
+  @param[out] OutData       Configuration data read
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PCH_LP
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveGetStatus (
+  IN  UINT32 SlaveId,
+  OUT UINT16 *OutData
+  )
+{
+  EFI_STATUS  Status;
+  UINT32      TempOutData;
+
+  TempOutData = 0;
+
+  //
+  // 1. Clear status from previous transaction by writing 111b to status in SCRS, PCR[eSPI] + 4000h [30:28]
+  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit [20:19]=<SlvID>, Bit [17:16] = 10b, Bit[11:0] = <addr_xxx>.
+  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
+  // 4. Check the transaction status in SCRS (bits [30:28])
+  // 5. Read SLV_CFG_REG_DATA [15:0].
+  //
+  Status = EspiSlaveOperationHelper (SlaveId, 0, EspiSlaveOperationStatusRead, &TempOutData);
+  *OutData = (UINT16) TempOutData;
+
+  return Status;
+}
+
+/**
+  eSPI slave in-band reset
+
+  @param[in]  SlaveId           eSPI slave ID
+
+  @retval EFI_SUCCESS           Operation succeed
+  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is used in PCH_LP
+  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of operation
+**/
+EFI_STATUS
+PchEspiSlaveInBandReset (
+  IN  UINT32 SlaveId
+  )
+{
+  //
+  // 1. Clear status from previous transaction by writing 111b to status in SCRS, PCR[eSPI] + 4000h [30:28]
+  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit [20:19]=<SlvID>, Bit [17:16] = 11b).
+  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
+  // 4. Check the transaction status in SCRS (bits [30:28])
+  //
+  return EspiSlaveOperationHelper (SlaveId, 0, EspiSlaveOperationInBandReset, NULL);
+}
+
+/**
+  eSPI Slave channel reset helper function
+
+  @param[in]  SlaveId           eSPI slave ID
+  @param[in]  ChannelNumber     Number of channel to reset
+
+  @retval     EFI_SUCCESS       Operation succeeded
+  @retval     EFI_UNSUPPORTED   Slave doesn't support that channel or invalid number specified
+  @retval     EFI_TIMEOUT       Operation has timeouted
+**/
+EFI_STATUS
+PchEspiSlaveChannelReset (
+  IN  UINT8   SlaveId,
+  IN  UINT8   ChannelNumber
+  )
+{
+  UINT8       Timeout;
+  UINT32      Data32;
+  UINT32      SlaveChannelAddress;
+  BOOLEAN     SlaveBmeSet;
+
+  DEBUG ((DEBUG_INFO, "eSPI slave %d channel %d reset\n", SlaveId, ChannelNumber));
+
+  Timeout = CHANNEL_RESET_TIMEOUT;
+  SlaveBmeSet = FALSE;
+
+  if (!IsEspiSlaveChannelSupported (SlaveId, ChannelNumber)) {
+    // Incorrect channel number was specified. Either exceeded max or Slave doesn't support that channel.
+    DEBUG ((DEBUG_ERROR, "Channel %d is not valid channel number for slave %d!\n", ChannelNumber, SlaveId));
+    return EFI_UNSUPPORTED;
+  }
+
+  // Calculating slave channel address
+  SlaveChannelAddress = R_ESPI_SLAVE_CHACAP_BASE + (S_ESPI_SLAVE_CHACAP_OFFSET * ChannelNumber);
+
+  // If we're resetting Peripheral Channel then we need to disable Bus Mastering first and reenable after reset
+  if (ChannelNumber == 0) {
+    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
+    if ((Data32 & B_ESPI_SLAVE_BME) != 0) {
+      Data32 &= ~(B_ESPI_SLAVE_BME);
+      PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
+      SlaveBmeSet = TRUE;
+    }
+  }
+
+  // Disable channel
+  PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
+  Data32 &= ~(B_ESPI_SLAVE_CHACAP_CHEN);
+  PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
+
+  // Enable channel
+  PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
+  Data32 |= B_ESPI_SLAVE_CHACAP_CHEN;
+  PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
+
+  DEBUG ((DEBUG_INFO, "Waiting for Channel Ready bit\n"));
+  // Wait until channel is ready by polling Channel Ready bit
+  while (((Data32 & B_ESPI_SLAVE_CHACAP_CHRDY) == 0) && (Timeout > 0)) {
+    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
+    MicroSecondDelay (1);
+    --Timeout;
+  }
+
+  if (Timeout == 0) {
+    // The waiting for channel to be ready has timed out
+    DEBUG ((DEBUG_ERROR, "The operation of channel %d reset for slave %d has timed out!\n", ChannelNumber, SlaveId));
+    return EFI_TIMEOUT;
+  }
+
+  if (ChannelNumber == 0 && SlaveBmeSet) {
+    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
+    Data32 |= B_ESPI_SLAVE_BME;
+    PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
+  }
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/PeiDxeSmmEspiLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/PeiDxeSmmEspiLib.inf
new file mode 100644
index 0000000000..440051432f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/PeiDxeSmmEspiLib.inf
@@ -0,0 +1,38 @@
+## @file
+# Component description file for the PeiDxeSmmPchEspiLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmEspiLib
+FILE_GUID = 7F25F990-7989-4413-B414-1EDE557E9389
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = EspiLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PchPcrLib
+TimerLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+EspiLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (13 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component Heng Luo
                   ` (24 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Gbe/IncludePrivate
  * IpBlock/Gbe/Library
  * IpBlock/Gbe/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h                       | 324 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/GbeRegs.h                        |  68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/GbeLib.c                         | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/PeiDxeSmmGbeLib.inf              |  43 +++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/GbeMdiLib.c            | 388 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf |  34 ++++++++++++++++++++++++++++++++++
 6 files changed, 978 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h
new file mode 100644
index 0000000000..b8274ed3dc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h
@@ -0,0 +1,324 @@
+/** @file
+  Header file for GbeMdiLib.
+
+  Conventions:
+
+  - Prefixes:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register sizes
+    Definitions beginning with "N_" are the bit position
+  - In general, PCH registers are denoted by "_PCH_" in register names
+  - Registers / bits that are different between PCH generations are denoted by
+    "_PCH_[generation_name]_" in register/bit names.
+  - Registers / bits that are specific to PCH-H denoted by "_H_" in register/bit names.
+    Registers / bits that are specific to PCH-LP denoted by "_LP_" in register/bit names.
+    e.g., "_PCH_LP_"
+    Registers / bits names without or _LP_ apply for LP.
+  - Registers / bits that are different between SKUs are denoted by "_[SKU_name]"
+    at the end of the register/bit names
+  - Registers / bits of new devices introduced in a PCH generation will be just named
+    as "_PCH_" without [generation_name] inserted.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GBE_MDI_LIB_H_
+#define _GBE_MDI_LIB_H_
+
+//
+// Maximum loop time for GbE status check
+// 4000 * 50 = 200 mSec in total
+//
+#define GBE_MAX_LOOP_TIME       4000
+#define GBE_ACQUIRE_MDIO_DELAY  50
+#define GBE_MDI_SET_PAGE_DELAY  4000 // 4 mSec delay after setting page
+
+//
+// LAN PHY MDI settings
+//
+// MDI Control Register Bits
+// 31:30 Reserved
+//       This field is reserved and returns 0.
+// 29    Interrupt Enable.
+//       When this bit is set to 1 by software, it causes the device to assert
+//       an interrupt indicating the end of an MDI cycle.
+// 28    Ready.
+//       Set to 1 by the device at the end of MDI transaction (i.e., indicates a Read or
+//       Write has been completed. It should be reset to 0 by software at the same time the
+//       command is written.
+// 27:26 Opcode
+//       For an MDI write, the opcode equals 01b, and for MDI read, 10b. 00b and
+//       11b are reserved and should not be used.
+// 25:21 PHYAdd
+//       PHY Address
+// 20:16 RegAdd
+//       PHY Register Address
+// 15:0  Data
+
+#define B_PHY_MDI_READY                BIT28
+#define B_PHY_MDI_READ                 BIT27
+#define B_PHY_MDI_WRITE                BIT26
+//
+//      PHY SPECIFIC registers
+//
+#define B_PHY_MDI_PHY_ADDRESS_02       BIT22
+//
+//      PHY GENERAL registers
+//      Registers 0 to 15 are defined by the specification
+//      Registers 16 to 31 are left available to the vendor
+//
+#define B_PHY_MDI_PHY_ADDRESS_01       BIT21
+#define B_PHY_MDI_PHY_ADDRESS_MASK    (BIT25 | BIT24 | BIT23 | BIT22 | BIT21)
+//
+//  PHY Identifier Register 2
+//  Bits [15:10] - PHY ID Number   - The PHY identifier composed of bits 3 through 18
+//                                   of the Organizationally Unique Identifier (OUI)
+//  Bits [9:4]   - Device Model Number
+//  Bits [3:0]   - Device Revision Number
+//
+#define R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2  0x00030000
+
+#define MDI_REG_SHIFT(x)                              (x << 16)
+#define B_PHY_MDI_PHY_REGISTER_MASK                   (BIT20 | BIT19 | BIT18 | BIT17 | BIT16)
+#define R_PHY_MDI_PHY_REG_SET_ADDRESS                 0x00110000 // Used after new page setting
+#define R_PHY_MDI_PHY_REG_DATA_READ_WRITE             0x00120000
+#define R_PHY_MDI_PHY_REG_SET_PAGE                    0x001F0000
+
+//
+// LAN PHY MDI registers and bits
+//
+
+//
+// Page 769 Port Control Registers
+// 6020h (769 * 32)
+//
+#define PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS        769
+//
+// Custom Mode Control PHY Address 01, Page 769, Register 16
+//
+#define R_PHY_MDI_PAGE_769_REGISETER_16_CMC            0x0010
+//
+// Custom Mode Control
+// Page 769, Register 16, BIT 10
+// 0 - normal MDIO frequency access
+// 1 - reduced MDIO frequency access (slow mdio)
+//     required for read during cable disconnect
+//
+#define B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS        BIT10
+//
+//  Port General Configuration PHY Address 01, Page 769, Register 17
+//
+#define R_PHY_MDI_PAGE_769_REGISETER_17_PGC            0x0011
+//
+// Page 769, Register 17, BIT 4
+// Enables host wake up
+//
+#define B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP            BIT4
+//
+// Page 769, Register 17, BIT 2
+// Globally enable the MAC power down feature while the
+// GbE supports WoL. When set to 1b,
+// pages 800 and 801 are enabled for
+// configuration and Host_WU_Active is not blocked for writes.
+//
+#define B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE            BIT2
+
+//
+// Page 800 Wake Up Registers
+// 6400h (800 * 32)
+//
+#define PHY_MDI_PAGE_800_WAKE_UP_REGISTERS             800
+//
+// Wake Up Control - WUC PHY Address 01, Page 800, Register 1
+// 1h (Register 1)
+//
+#define R_PHY_MDI_PAGE_800_REGISETER_1_WUC             0x0001
+//
+// Wake Up Control - (WUC)
+// Page 800, Register 1, BIT 0
+// Advance Power Management Enable (APME)
+// If set to 1b, APM wake up is enabled.
+//
+#define B_PHY_MDI_PAGE_800_REGISETER_1_WUC_APME                     BIT0
+//
+// Receive Address Low - RAL PHY Address 01, Page 800, Register 16
+// 10h (Register 16)
+//
+#define R_PHY_MDI_PAGE_800_REGISETER_16_RAL0           0x0010
+//
+// Receive Address Low - RAL PHY Address 01, Page 800, Register 17
+// 11h (Register 17)
+//
+#define R_PHY_MDI_PAGE_800_REGISETER_17_RAL1           0x0011
+//
+// Receive Address High - RAH PHY Address 01, Page 800, Register 18
+// 12h (Register 18)
+//
+#define R_PHY_MDI_PAGE_800_REGISETER_18_RAH0           0x0012
+//
+// Receive Address High - RAH PHY Address 01, Page 800, Register 19
+// 13h (Register 19)
+//
+#define R_PHY_MDI_PAGE_800_REGISETER_19_RAH1           0x0013
+//
+// Setting AV (BIT15 RAH is divided on two registers)
+// RAH Register 19, Page 800, BIT 31
+//
+// Address valid (AV)
+// When this bit is set, the relevant RAL and RAH are valid
+//
+#define B_PHY_MDI_PAGE_800_REGISETER_19_RAH1_ADDRESS_VALID          BIT15
+//
+// Page 803 Host WoL Packet
+// 6460h (803 * 32)
+//
+#define PHY_MDI_PAGE_803_HOST_WOL_PACKET               803
+//
+// Host WoL Packet Clear - HWPC PHY Address 01, Page 803, Register 66
+//
+#define R_PHY_MDI_PAGE_803_REGISETER_66_HWPC           0x0042
+
+
+/**
+  Change Extended Device Control Register BIT 11 to 1 which
+  forces the interface between the MAC and the Phy to be on SMBus.
+  Cleared on the assertion of PCI reset.
+
+  @param [in]  GbeBar   GbE MMIO space
+
+**/
+VOID
+GbeMdiForceMACtoSMB (
+  IN      UINT32  GbeBar
+  );
+
+/**
+  Test for MDIO operation complete.
+
+  @param [in]  GbeBar   GbE MMIO space
+
+  @retval EFI_SUCCESS
+  @retval EFI_TIMEOUT
+**/
+EFI_STATUS
+GbeMdiWaitReady (
+  IN      UINT32  GbeBar
+  );
+
+/**
+  Acquire MDIO software semaphore.
+
+  1. Ensure that MBARA offset F00h [5] = 1b
+  2. Poll MBARA offset F00h [5] up to 200ms
+
+  @param [in] GbeBar   GbE MMIO space
+
+  @retval EFI_SUCCESS
+  @retval EFI_TIMEOUT
+**/
+EFI_STATUS
+GbeMdiAcquireMdio (
+  IN      UINT32  GbeBar
+  );
+
+/**
+  Release MDIO software semaphore by clearing MBARA offset F00h [5]
+
+  @param [in]  GbeBar   GbE MMIO space
+**/
+VOID
+GbeMdiReleaseMdio (
+  IN      UINT32  GbeBar
+  );
+
+/**
+  Sets page on MDI
+  Page setting is attempted twice.
+  If first attempt failes MAC and the Phy are force to be on SMBus
+
+  @param [in]  GbeBar  GbE MMIO space
+  @param [in]  Data    Value to write in lower 16bits.
+
+  @retval EFI_SUCCESS       Page setting was successfull
+  @retval EFI_DEVICE_ERROR  Returned if both attermps of setting page failed
+**/
+EFI_STATUS
+GbeMdiSetPage (
+  IN      UINT32  GbeBar,
+  IN      UINT32  Page
+  );
+
+/**
+  Sets Register in current page.
+
+  @param [in]  GbeBar      GbE MMIO space
+  @param [in]  register    Register number
+
+  @return EFI_STATUS
+**/
+EFI_STATUS
+GbeMdiSetRegister (
+  IN      UINT32  GbeBar,
+  IN      UINT32  Register
+  );
+
+
+/**
+  Perform MDI read.
+
+  @param [in]  GbeBar       GbE MMIO space
+  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
+  @param [in]  PhyRegister  Phy Register
+  @param [out] ReadData     Return Value
+
+  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
+  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
+  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton failed
+**/
+EFI_STATUS
+GbeMdiRead (
+  IN      UINT32  GbeBar,
+  IN      UINT32  PhyAddress,
+  IN      UINT32  PhyRegister,
+  OUT     UINT16  *ReadData
+  );
+
+/**
+  Perform MDI write.
+
+  @param [in]  GbeBar       GbE MMIO space
+  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
+  @param [in]  PhyRegister  Phy Register
+  @param [in]  WriteData    Value to write in lower 16bits.
+
+  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
+  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
+  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton failed
+**/
+EFI_STATUS
+GbeMdiWrite (
+  IN      UINT32  GbeBar,
+  IN      UINT32  PhyAddress,
+  IN      UINT32  PhyRegister,
+  IN      UINT32  WriteData
+  );
+
+/**
+  Gets Phy Revision and Model Number
+  from PHY IDENTIFIER register 2 (offset 3)
+
+  @param [in]  GbeBar           GbE MMIO space
+  @param [out] LanPhyRevision   Return Value
+
+  @return EFI_STATUS
+  @return EFI_INVALID_PARAMETER When GbeBar is incorrect
+**/
+EFI_STATUS
+GbeMdiGetLanPhyRevision (
+  IN      UINT32  GbeBar,
+  OUT     UINT16  *LanPhyRevision
+  );
+
+#endif // _GBE_MDI_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/GbeRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/GbeRegs.h
new file mode 100644
index 0000000000..307f1e159e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/GbeRegs.h
@@ -0,0 +1,68 @@
+/** @file
+  Register names for GbE device
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GBE_REGS_H_
+#define _GBE_REGS_H_
+
+#define R_GBE_CFG_MBARA               0x10
+#define N_GBE_CFG_MBARA_ALIGN         17
+#define R_GBE_CFG_PMCS                0xCC
+#define B_GBE_CFG_PMCS_PS             (BIT1 | BIT0)
+#define V_GBE_CFG_PMCS_PS0            0x00
+//
+// Gigabit Ethernet LAN Capabilities and Status Registers (Memory space)
+//
+#define R_GBE_MEM_CSR_CTRL                    0
+//
+// LANPHYPC:
+// Connects to the LCD DEVICE_OFF# signal in the
+// LAN Connected Device
+//
+#define B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE  BIT16 // When set to 1 SW driver has the ability to control the LANPHYPC pin value.
+#define B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL       BIT17 // When set to 1 this bit will define the value of the LANPHYPC pin.
+#define R_GBE_MEM_CSR_CTRL_EXT             0x0018
+#define B_GBE_MEM_CSR_CTRL_EXT_LPCD        BIT2  //LCD Power Cycle Done (LPCD). This bit indicates whether LCD power cycle is done
+                                                 //- the bit is set 50/100mSec after LANPHYPC pin assertion.
+#define B_GBE_MEM_CSR_CTRL_EXT_FORCE_SMB   BIT11
+#define R_GBE_MEM_CSR_MDIC                 0x0020
+#define B_GBE_MEM_CSR_MDIC_RB              BIT28
+#define R_GBE_MEM_CSR_EXTCNF_CTRL          0x0F00
+#define B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG   BIT5
+#define R_GBE_MEM_CSR_RAL                  0x5400
+#define R_GBE_MEM_CSR_RAH                  0x5404
+#define B_GBE_MEM_CSR_RAH_RAH              0x0000FFFF
+#define R_GBE_MEM_CSR_WUC                  0x5800
+#define B_GBE_MEM_CSR_WUC_APME             BIT0
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/GbeLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/GbeLib.c
new file mode 100644
index 0000000000..3b51b9eb62
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/GbeLib.c
@@ -0,0 +1,121 @@
+/** @file
+  Gbe Library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PmcPrivateLib.h>
+#include <Library/SpiAccessLib.h>
+#include <Library/GbeMdiLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Register/GbeRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Check whether GbE region is valid
+  Check SPI region directly since GbE might be disabled in SW.
+
+  @retval TRUE                    Gbe Region is valid
+  @retval FALSE                   Gbe Region is invalid
+**/
+BOOLEAN
+IsGbeRegionValid (
+  VOID
+  )
+{
+  return SpiIsGbeRegionValid ();
+}
+
+/**
+  Check whether GBE controller is enabled in the platform.
+
+  @retval TRUE                    GbE is enabled
+  @retval FALSE                   GbE is disabled
+**/
+BOOLEAN
+IsGbePresent (
+  VOID
+  )
+{
+  //
+  // Check PCH Support
+  //
+  if (!PchIsGbeSupported ()) {
+    return FALSE;
+  }
+  //
+  // Check PMC strap/fuse
+  //
+  if (!PmcIsGbeSupported ()) {
+    return FALSE;
+  }
+  //
+  // Check GbE NVM
+  //
+  if (IsGbeRegionValid () == FALSE) {
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Verifies Gigabit Ethernet PCI Class Code
+
+  @param [in]  GbePciCfgBase      GbE PCI Config Space Address
+
+  @retval TRUE                    GbE Class Code match
+  @retval FALSE                   GbE Class Code does not match
+**/
+BOOLEAN
+STATIC
+GbeCheckClassCode (
+  UINT64 GbePciCfgBase
+  )
+{
+  UINT8 BaseCode;
+  UINT8 SubClassCode;
+
+  SubClassCode  = PciSegmentRead8 (GbePciCfgBase + PCI_CLASSCODE_OFFSET + 1);
+  BaseCode      = PciSegmentRead8 (GbePciCfgBase + PCI_CLASSCODE_OFFSET + 2);
+
+  if ((BaseCode != PCI_CLASS_NETWORK) || (SubClassCode != PCI_CLASS_NETWORK_ETHERNET)) {
+    DEBUG ((DEBUG_ERROR, "GbeCheckClassCode : BaseCode(0x%x) or ClassCode(0x%x) is not supported\n", BaseCode, SubClassCode));
+    ASSERT (FALSE);
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Checks if Gbe is Enabled or Disabled
+
+  @retval  BOOLEAN    TRUE if device is enabled, FALSE otherwise.
+**/
+BOOLEAN
+IsGbeEnabled (
+  VOID
+  )
+{
+  UINT64  GbePciBase;
+
+  GbePciBase = GbePciCfgBase ();
+
+  if (PciSegmentRead32 (GbePciBase) != 0xFFFFFFFF) {
+    return GbeCheckClassCode (GbePciBase);
+  }
+
+  return FALSE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/PeiDxeSmmGbeLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/PeiDxeSmmGbeLib.inf
new file mode 100644
index 0000000000..4fef1288af
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/PeiDxeSmmGbeLib.inf
@@ -0,0 +1,43 @@
+## @file
+# Gbe Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmGbeLib
+FILE_GUID = FC022ED0-6EB3-43E1-A740-0BA27CBBD010
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = GbeLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchInfoLib
+PchPcrLib
+PchCycleDecodingLib
+PmcPrivateLib
+SpiAccessLib
+GbeMdiLib
+PchPciBdfLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+GbeLib.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/GbeMdiLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/GbeMdiLib.c
new file mode 100644
index 0000000000..7917474406
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/GbeMdiLib.c
@@ -0,0 +1,388 @@
+/** @file
+  Gbe MDI Library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/TimerLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/GbeMdiLib.h>
+#include <Register/GbeRegs.h>
+
+
+/**
+  Validates both Phy Address and Regster.
+
+  @param [in]  PhyAddress
+  @param [in]  PhyRegister
+
+  @retval BOOLEAN   TRUE  Validation passed
+                    FALSE If the data is not within its range
+
+**/
+BOOLEAN
+IsPhyAddressRegisterValid (
+  IN      UINT32  PhyAddress,
+  IN      UINT32  PhyRegister
+  )
+{
+  if (((PhyAddress & (~B_PHY_MDI_PHY_ADDRESS_MASK)) != 0) || ((PhyRegister & (~B_PHY_MDI_PHY_REGISTER_MASK)) != 0)) {
+    DEBUG ((DEBUG_ERROR, "IsPhyAddressRegisterValid validation failed! PhyAddress: 0x%08X PhyRegister: 0x%08X \n", PhyAddress, PhyRegister));
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Change Extended Device Control Register BIT 11 to 1 which
+  forces the interface between the MAC and the Phy to be on SMBus.
+  Cleared on the assertion of PCI reset.
+
+  @param [in]  GbeBar   GbE MMIO space
+
+**/
+VOID
+GbeMdiForceMacToSmb (
+  IN      UINT32  GbeBar
+  )
+{
+  MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL_EXT, B_GBE_MEM_CSR_CTRL_EXT_FORCE_SMB);
+}
+
+/**
+  Test for MDIO operation complete.
+
+  @param [in]  GbeBar   GbE MMIO space
+
+  @retval EFI_SUCCESS
+  @retval EFI_TIMEOUT
+**/
+EFI_STATUS
+GbeMdiWaitReady (
+  IN      UINT32  GbeBar
+  )
+{
+  UINT32  Count;
+
+  for (Count = 0; Count < GBE_MAX_LOOP_TIME; ++Count) {
+    if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_MDIC) & B_GBE_MEM_CSR_MDIC_RB) {
+      return EFI_SUCCESS;
+    }
+    MicroSecondDelay (GBE_ACQUIRE_MDIO_DELAY);
+  }
+  DEBUG ((DEBUG_ERROR, "GbeMdiWaitReady Timeout reached. MDIO operation failed to complete in %d micro seconds\n", GBE_MAX_LOOP_TIME * GBE_ACQUIRE_MDIO_DELAY));
+  return EFI_TIMEOUT;
+}
+
+/**
+  Acquire MDIO software semaphore.
+
+  1. Ensure that MBARA offset F00h [5] = 1b
+  2. Poll MBARA offset F00h [5] up to 200ms
+
+  @param [in] GbeBar   GbE MMIO space
+
+  @retval EFI_SUCCESS
+  @retval EFI_TIMEOUT
+**/
+EFI_STATUS
+GbeMdiAcquireMdio (
+  IN      UINT32  GbeBar
+  )
+{
+  UINT32  ExtCnfCtrl;
+  UINT32  Count;
+
+  MmioOr32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL, B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
+  for (Count = 0; Count < GBE_MAX_LOOP_TIME; ++Count) {
+    ExtCnfCtrl = MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL);
+    if (ExtCnfCtrl & B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG) {
+      return EFI_SUCCESS;
+    }
+    MicroSecondDelay (GBE_ACQUIRE_MDIO_DELAY);
+  }
+  DEBUG ((DEBUG_ERROR, "GbeMdiAcquireMdio Timeout. Unable to acquire MDIO Semaphore in %d micro seconds\n", GBE_MAX_LOOP_TIME * GBE_ACQUIRE_MDIO_DELAY));
+  return EFI_TIMEOUT;
+}
+
+/**
+  Release MDIO software semaphore by clearing MBARA offset F00h [5]
+
+  @param [in]  GbeBar   GbE MMIO space
+**/
+VOID
+GbeMdiReleaseMdio (
+  IN      UINT32  GbeBar
+  )
+{
+  ASSERT (MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL) & B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
+  MmioAnd32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL, (UINT32) ~B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
+  ASSERT ((MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL) & B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG) == 0);
+}
+
+/**
+  Sets page on MDI
+  Page setting is attempted twice.
+  If first attempt failes MAC and the Phy are force to be on SMBus.
+
+  Waits 4 mSec after page setting
+
+  @param [in]  GbeBar  GbE MMIO space
+  @param [in]  Data    Value to write in lower 16bits.
+
+  @retval EFI_SUCCESS       Page setting was successfull
+  @retval EFI_DEVICE_ERROR  Returned if both attermps of setting page failed
+**/
+EFI_STATUS
+GbeMdiSetPage (
+  IN      UINT32  GbeBar,
+  IN      UINT32  Page
+  )
+{
+  EFI_STATUS  Status;
+
+  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY) & (B_PHY_MDI_WRITE | B_PHY_MDI_PHY_ADDRESS_01 | R_PHY_MDI_PHY_REG_SET_PAGE | ((Page * 32) & 0xFFFF)));
+
+  Status = GbeMdiWaitReady (GbeBar);
+
+  if (Status == EFI_TIMEOUT) {
+    DEBUG ((DEBUG_INFO, "GbeMdiSetPage Timeout reached. Forcing the interface between the MAC and the Phy to be on SMBus\n"));
+    GbeMdiForceMacToSmb (GbeBar);
+    //
+    // Retry page setting
+    //
+    MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY) & (B_PHY_MDI_WRITE | B_PHY_MDI_PHY_ADDRESS_01 | R_PHY_MDI_PHY_REG_SET_PAGE | ((Page * 32) & 0xFFFF)));
+    Status = GbeMdiWaitReady (GbeBar);
+    if (Status == EFI_TIMEOUT) {
+      DEBUG ((DEBUG_ERROR, "GbeMdiSetPage retry page setting failed!\n"));
+      return EFI_DEVICE_ERROR;
+    }
+  }
+
+  //
+  // Delay required for page to set properly
+  //
+  MicroSecondDelay (GBE_MDI_SET_PAGE_DELAY);
+
+  return Status;
+}
+
+/**
+  Sets Register in current page.
+
+  @param [in]  GbeBar      GbE MMIO space
+  @param [in]  register    Register number valid only in lower 16 Bits
+
+  @return EFI_STATUS
+**/
+EFI_STATUS
+GbeMdiSetRegister (
+  IN      UINT32  GbeBar,
+  IN      UINT32  Register
+  )
+{
+  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY) & (B_PHY_MDI_WRITE | B_PHY_MDI_PHY_ADDRESS_01 | R_PHY_MDI_PHY_REG_SET_ADDRESS | (Register & 0xFFFF)));
+  return GbeMdiWaitReady (GbeBar);
+}
+
+/**
+  Perform MDI write.
+
+  @param [in]  GbeBar       GbE MMIO space
+  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
+  @param [in]  PhyRegister  Phy Register
+  @param [in]  WriteData    Value to write in lower 16bits.
+
+  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
+  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
+  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton failed
+**/
+EFI_STATUS
+GbeMdiWrite (
+  IN      UINT32  GbeBar,
+  IN      UINT32  PhyAddress,
+  IN      UINT32  PhyRegister,
+  IN      UINT32  WriteData
+  )
+{
+  if(!IsPhyAddressRegisterValid (PhyAddress, PhyRegister)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiWrite PhyAddressRegister validaton failed!\n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY) & (B_PHY_MDI_WRITE | PhyAddress | PhyRegister | (WriteData & 0xFFFF)));
+  return GbeMdiWaitReady (GbeBar);
+}
+
+/**
+  Perform MDI read.
+
+  @param [in]  GbeBar       GbE MMIO space
+  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
+  @param [in]  PhyRegister  Phy Register
+  @param [out] ReadData     Return Value
+
+  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
+  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
+  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton failed
+**/
+EFI_STATUS
+GbeMdiRead (
+  IN      UINT32  GbeBar,
+  IN      UINT32  PhyAddress,
+  IN      UINT32  PhyRegister,
+  OUT     UINT16  *ReadData
+  )
+{
+  EFI_STATUS    Status;
+
+  if(!IsPhyAddressRegisterValid (PhyAddress, PhyRegister)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiRead PhyAddressRegister validaton failed!\n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY) & (B_PHY_MDI_READ | PhyAddress | PhyRegister));
+  Status = GbeMdiWaitReady (GbeBar);
+  if (EFI_SUCCESS == Status) {
+    *ReadData = (UINT16) MmioRead32 (GbeBar + R_GBE_MEM_CSR_MDIC);
+  }
+  return Status;
+}
+
+/**
+  Gets Phy Revision and Model Number
+  from PHY IDENTIFIER register 2 (offset 3)
+
+  @param [in]  GbeBar           GbE MMIO space
+  @param [out] LanPhyRevision   Return Value
+
+  @return EFI_STATUS
+  @return EFI_INVALID_PARAMETER When GbeBar is incorrect
+                                When Phy register or address is out of bounds
+**/
+EFI_STATUS
+GbeMdiGetLanPhyRevision (
+  IN      UINT32  GbeBar,
+  OUT     UINT16  *LanPhyRevision
+  )
+{
+  EFI_STATUS    Status;
+  UINT8         LpcdLoop;
+  UINT8         Delay;
+
+  if (!((GbeBar & 0xFFFFF000) > 0)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision GbeBar validation failed! Bar: 0x%08X \n", GbeBar));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = GbeMdiAcquireMdio (GbeBar);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to aquire MDIO semaphore. Status: %r\n", Status));
+    return Status;
+  }
+
+  Status = GbeMdiSetPage (GbeBar, PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to Set Page 769. Status: %r\n", Status));
+    GbeMdiReleaseMdio (GbeBar);
+    return Status;
+  }
+
+  //
+  //  Set register to: Custom Mode Control
+  //   Reduced MDIO frequency access (slow mdio)
+  //   BIT 10 set to 1
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_16_CMC), BIT13 | B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS | BIT8 | BIT7);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to enable slow MDIO mode. Status: %r\n", Status));
+    GbeMdiReleaseMdio (GbeBar);
+    return Status;
+  }
+
+  //
+  // Read register PHY Version from PHY IDENTIFIER 2 (offset 0x3)
+  //  Bits [9:4]   - Device Model Number
+  //  Bits [3:0]   - Device Revision Number
+  //
+  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02, R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
+
+  //
+  // Failed to obtain PHY REV
+  //
+  if (*LanPhyRevision == 0x0) {
+    if ((MmioRead32 (GbeBar + R_GBE_MEM_CSR_CTRL) & (B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE | B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL))) {
+      DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to read Phy Revision. Other component tried to initialize GbE and failed.\n"));
+      Status = EFI_DEVICE_ERROR;
+      goto phy_exit;
+    }
+    DEBUG ((DEBUG_INFO, "GbeMdiGetLanPhyRevision failed to read Revision. Overriding LANPHYPC\n", Status));
+    //
+    // Taking over LANPHYPC
+    // 1. SW signal override - 1st cycle.
+    // 2. Turn LCD on - 2nd cycle.
+    //
+    MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL, B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE);
+    MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL, B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL);
+
+    //
+    // Poll on LPCD for 100mSec
+    //
+    LpcdLoop = 101;
+    while (LpcdLoop > 0) {
+      if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_CTRL_EXT) & B_GBE_MEM_CSR_CTRL_EXT_LPCD) {
+        break;
+      } else {
+        LpcdLoop--;
+        MicroSecondDelay (1000);
+      }
+    }
+
+    if (LpcdLoop > 0) {
+      Delay = 100;
+      Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02, R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
+      while (*LanPhyRevision == 0 && Delay > 0) {
+        Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02, R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
+        if (EFI_ERROR(Status)) {
+          break;
+        }
+        MicroSecondDelay (1000);
+        Delay --;
+      }
+    }
+    //
+    // Restore LANPHYPC
+    // 1. Turn LCD off - 1st cycle.
+    // 2. Remove SW signal override - 2nd cycle.
+    //
+    MmioAnd32 (GbeBar + R_GBE_MEM_CSR_CTRL, (UINT32) ~B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL);
+    MmioAnd32 (GbeBar + R_GBE_MEM_CSR_CTRL, (UINT32) ~B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE);
+  }
+
+phy_exit:
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to read Revision and Model Number from PHY Identifier 2. Status: %r\n", Status));
+    GbeMdiReleaseMdio (GbeBar);
+    return Status;
+  }
+
+  //
+  //  Switch back to normal MDIO frequency access
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,  MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_16_CMC), (~B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS) & (BIT13 | BIT8 | BIT7));
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to disable slow MDIO mode. Status: %r\n", Status));
+  }
+
+  GbeMdiReleaseMdio (GbeBar);
+
+  return Status;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf
new file mode 100644
index 0000000000..99a01177f6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf
@@ -0,0 +1,34 @@
+## @file
+# Gbe MDI Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmGbeMdiLib
+FILE_GUID = 0360E6F6-892A-4852-BF98-15C0D30D8A48
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = GbeMdiLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+TimerLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+GbeMdiLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (14 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component Heng Luo
                   ` (23 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Gpio/Include
  * IpBlock/Gpio/IncludePrivate
  * IpBlock/Gpio/Library
  * IpBlock/Gpio/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckConflictLib.h                                 |   43 ++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/DxeGpioPolicyLib.h                              |   55 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioHelpersLib.h                                |  105 +++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioNameBufferLib.h                             |   23 +++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioPrivateLib.h                                | 1197 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.c            |  140 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.inf          |   29 +++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.c    |   35 +++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.inf  |   26 ++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioInit.c                                    |  558 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLib.c                                     | 2387 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLibrary.h                                 |   82 ++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNames.c                                   |   86 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNativeLib.c                               |  193 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/PeiDxeSmmGpioLib.inf                          |   49 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.c         |  119 ++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf       |   26 ++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf           |   32 ++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/GpioNameBufferDxe.c                |   19 +++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.c                     |   87 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.inf                   |   31 ++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioNamesVer2.c                 |   88 +++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLib.c                |  395 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLibVer2.c            |  131 ++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf |   46 +++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.c                   |  413 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.inf                 |   48 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/GpioNameBufferPei.c                |   67 +++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf           |   35 +++++++++++++
 29 files changed, 6545 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckConflictLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckConflictLib.h
new file mode 100644
index 0000000000..5e3dd90ae6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckConflictLib.h
@@ -0,0 +1,43 @@
+/** @file
+  Header file for checking Gpio PadMode conflict.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_CHECK_CONFLICT_LIB_H_
+#define _GPIO_CHECK_CONFLICT_LIB_H_
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/GpioConfig.h>
+#include <Library/GpioLib.h>
+
+extern EFI_GUID gGpioCheckConflictHobGuid;
+
+typedef struct {
+  GPIO_PAD  GpioPad;
+  UINT32    GpioPadMode:5;
+  UINT32    Reserved:27;
+} GPIO_PAD_MODE_INFO;
+
+/**
+  Check Gpio PadMode conflict and report it.
+**/
+VOID
+GpioCheckConflict (
+  VOID
+  );
+
+/**
+  This library will create one Hob for each Gpio config table
+  without PadMode is GpioHardwareDefault
+
+  @param[in]  GpioDefinition    Point to Platform Gpio table
+  @param[in]  GpioTableCount    Number of Gpio table entries
+**/
+VOID
+CreateGpioCheckConflictHob (
+  IN GPIO_INIT_CONFIG          *GpioDefinition,
+  IN UINT32                    GpioTableCount
+  );
+
+#endif // _GPIO_CHECK_CONFLICT_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/DxeGpioPolicyLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/DxeGpioPolicyLib.h
new file mode 100644
index 0000000000..d86e6624b7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/DxeGpioPolicyLib.h
@@ -0,0 +1,55 @@
+/** @file
+  DXE Gpio policy library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_GPIO_POLICY_LIB_H_
+#define _DXE_GPIO_POLICY_LIB_H_
+
+#include <Protocol/PchPolicy.h>
+
+/**
+  Print GPIO_DXE_CONFIG and serial out.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+GpioDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  );
+
+/**
+  Load DXE Config block default for GPIO
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+GpioDxeLoadConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  );
+
+/**
+  Get Gpio config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+GpioDxeGetConfigBlockTotalSize (
+  VOID
+  );
+
+/**
+  Add Gpio ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+GpioDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  );
+
+#endif // _DXE_GPIO_POLICY_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioHelpersLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioHelpersLib.h
new file mode 100644
index 0000000000..d2a8d24c8a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioHelpersLib.h
@@ -0,0 +1,105 @@
+/** @file
+  Header file for GPIO Helpers Lib implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_HELPERS_LIB_H_
+#define _GPIO_HELPERS_LIB_H_
+
+#include <Library/GpioConfig.h>
+
+/**
+  This procedure stores GPIO pad unlock information
+
+  @param[in] GpioPad         GPIO pad
+  @param[in] GpioLockConfig  GPIO Lock Configuration
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreUnlockData (
+  IN GPIO_PAD             GpioPad,
+  IN GPIO_LOCK_CONFIG     GpioLockConfig
+  );
+
+/**
+  This procedure stores GPIO group data about pads which PadConfig needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLock          DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockPadConfigData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  );
+
+/**
+  This procedure stores GPIO group data about pads which Output state needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLock          DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockOutputData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  );
+
+/**
+  This procedure will get GPIO group data with pads, which PadConfig is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockPadConfigMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  );
+
+/**
+  This procedure will get GPIO group data with pads, which Output is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockOutputMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  );
+
+/**
+  Returns Gpio Override Level1 Information
+
+  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
+**/
+BOOLEAN
+GpioOverrideLevel1Enabled (
+  VOID
+  );
+#endif // _GPIO_HELPERS_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioNameBufferLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioNameBufferLib.h
new file mode 100644
index 0000000000..c60709c637
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioNameBufferLib.h
@@ -0,0 +1,23 @@
+/** @file
+  Header file for GpioMemLib. This library provides GpioLib with static memory to hold GpioName.
+  Static memory is handled differently in PEI and DXE phase. For PEI pre mem we use private HOB to store
+  gpio name since .data section is read only. For PEI post mem and DXE simple static buffer is used.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_NAME_BUFFER_LIB_H_
+#define _GPIO_NAME_BUFFER_LIB_H_
+
+#define GPIO_NAME_LENGTH_MAX  32
+
+/**
+  Returns pointer to the global buffer to be used by GpioNamesLib
+
+  @retval CHAR8*  Pointer to the buffer
+**/
+CHAR8*
+GpioGetStaticNameBuffer (
+  VOID
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioPrivateLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioPrivateLib.h
new file mode 100644
index 0000000000..be41f80c24
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioPrivateLib.h
@@ -0,0 +1,1197 @@
+/** @file
+  Header file for GpioPrivateLib.
+  All function in this library is available for PEI, DXE, and SMM,
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_PRIVATE_LIB_H_
+#define _GPIO_PRIVATE_LIB_H_
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/GpioConfig.h>
+#include <Library/PchPcrLib.h>
+#include <TcssPeiConfig.h>
+
+/**
+  GPIO Standby State configuration
+  Standby State options for GPIO Pads
+**/
+typedef enum {
+  GpioIosStateDefault         = 0x0,
+  GpioIosStateLatchLastValue  = (0x0 << 1) | 0x01,  ///< Latch last value driven on TX, TX Enable and RX Enable
+  GpioIosStateTx0Rx0RxDis     = (0x1 << 1) | 0x01,  ///< TX: 0, RX: 0 (internally), RX disabled
+  GpioIosStateTx0Rx1RxDis     = (0x2 << 1) | 0x01,  ///< TX: 0, RX: 1 (internally), RX disabled
+  GpioIosStateTx1Rx0RxDis     = (0x3 << 1) | 0x01,  ///< TX: 1, RX: 0 (internally), RX disabled
+  GpioIosStateTx1Rx1RxDis     = (0x4 << 1) | 0x01,  ///< TX: 1, RX: 1 (internally), RX disabled
+  GpioIosStateTx0RxEn         = (0x5 << 1) | 0x01,  ///< TX: 0, RX enabled
+  GpioIosStateTx1RxEn         = (0x6 << 1) | 0x01,  ///< TX: 1, RX enabled
+  GpioIosStateHizRx0          = (0x7 << 1) | 0x01,  ///< Hi-Z, RX: 0 (internally)
+  GpioIosStateHizRx1          = (0x8 << 1) | 0x01,  ///< Hi-Z, RX: 1 (internally)
+  GpioIosStateTxDisRxEn       = (0x9 << 1) | 0x01,  ///< TX Disabled and RX Enabled (i.e. wake or interrupt)
+  GpioIosStateMasked          = (0xF << 1) | 0x01   ///< IO Standby signal is masked for this pad. In this mode, a pad operates as if IOStandby has not been asserted.
+} GPIO_IOSTANDBY_STATE;
+
+/**
+  GPIO Standby Term configuration
+  Standby Termination options for GPIO Pads
+**/
+typedef enum {
+  GpioIosTermDefault         = 0x00,
+  GpioIosTermSame            = (0x00 << 1) | 0x01, ///< Same as state specified in Term
+  GpioIosTermPuDisPdDis      = (0x01 << 1) | 0x01, ///< Disable Pullup and Pulldown
+  GpioIosTermPuDisPdEn       = (0x02 << 1) | 0x01, ///< Enable Pulldown
+  GpioIosTermPuEnPdDis       = (0x03 << 1) | 0x01  ///< Enable Pullup
+} GPIO_IOSTANDBY_TERM;
+
+//
+// Structure for native pin data
+//
+typedef struct {
+  GPIO_PAD              Pad;
+  GPIO_PAD_MODE         Mode;
+  GPIO_IOSTANDBY_STATE  IosState;
+  GPIO_IOSTANDBY_TERM   IosTerm;
+} GPIO_PAD_NATIVE_FUNCTION;
+
+//
+// Structure for Serial GPIO pin definition
+//
+typedef struct {
+  GPIO_PAD_NATIVE_FUNCTION  Sclock;
+  GPIO_PAD_NATIVE_FUNCTION  Sload;
+  GPIO_PAD_NATIVE_FUNCTION  Sdataout;
+} SGPIO_PINS;
+
+//
+// Structure for USB Virtual Wire OverCurrent Pad Mode group
+//
+typedef struct {
+  GPIO_PAD       OcRxPad;
+  GPIO_PAD       OcTxPad;
+} GPIO_VWOC_FUNCTION;
+
+//
+// Below defines are based on GPIO_CONFIG structure fields
+//
+#define B_GPIO_PAD_MODE_MASK                            0xF
+#define N_GPIO_PAD_MODE_BIT_POS                         0
+#define B_GPIO_HOSTSW_OWN_MASK                          0x3
+#define N_GPIO_HOSTSW_OWN_BIT_POS                       0
+#define B_GPIO_DIRECTION_MASK                           0x1F
+#define B_GPIO_DIRECTION_DIR_MASK                       0x7
+#define N_GPIO_DIRECTION_DIR_BIT_POS                    0
+#define B_GPIO_DIRECTION_INV_MASK                       0x18
+#define N_GPIO_DIRECTION_INV_BIT_POS                    3
+#define B_GPIO_OUTPUT_MASK                              0x3
+#define N_GPIO_OUTPUT_BIT_POS                           0
+#define N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS            0
+#define N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS              5
+#define B_GPIO_RESET_CONFIG_RESET_MASK                  0x3F
+#define N_GPIO_RESET_CONFIG_OLD_RESET_TYPE              BIT1
+#define B_GPIO_RESET_CONFIG_OLD_RESET_MASK              0xF
+#define N_GPIO_RESET_CONFIG_RESET_BIT_POS               0
+#define B_GPIO_RESET_CONFIG_GPD_RESET_MASK              (BIT5 | BIT4)
+#define B_GPIO_RESET_CONFIG_GPP_RESET_MASK              (BIT3 | BIT2)
+#define N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS    0
+#define N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS               0
+#define B_GPIO_GPIO_IOSTANDBY_STATE_MASK                ((0xF << 1) | 0x01)
+#define B_GPIO_GPIO_IOSTANDBY_STATE_POS                 0
+#define B_GPIO_GPIO_IOSTANDBY_TERM_MASK                 ((0x2 << 1) | 0x01)
+#define B_GPIO_GPIO_IOSTANDBY_TERM_POS                  0
+
+//
+// Structure for storing information about registers offset, community,
+// maximal pad number for available groups
+//
+typedef struct {
+  PCH_SBI_PID  Community;
+  UINT16       PadOwnOffset;
+  UINT16       HostOwnOffset;
+  UINT16       GpiIsOffset;
+  UINT16       GpiIeOffset;
+  UINT16       GpiGpeStsOffset;
+  UINT16       GpiGpeEnOffset;
+  UINT16       SmiStsOffset;
+  UINT16       SmiEnOffset;
+  UINT16       NmiStsOffset;
+  UINT16       NmiEnOffset;
+  UINT16       PadCfgLockOffset;
+  UINT16       PadCfgLockTxOffset;
+  UINT16       PadCfgOffset;
+  UINT16       PadPerGroup;
+} GPIO_GROUP_INFO;
+
+//
+// If in GPIO_GROUP_INFO structure certain register doesn't exist
+// it will have value equal to NO_REGISTER_FOR_PROPERTY
+//
+#define NO_REGISTER_FOR_PROPERTY 0xFFFF
+
+#define GPIO_PAD_DEF(Group,Pad)                (UINT32)(((Group) << 16) + (Pad))
+#define GPIO_GROUP_DEF(GroupIndex,ChipsetId)   ((GroupIndex) | ((ChipsetId) << 8))
+#define GPIO_GET_GROUP_INDEX(Group)            ((Group) & 0x1F)
+#define GPIO_GET_GROUP_FROM_PAD(GpioPad)       (((GpioPad) & 0x0F1F0000) >> 16)
+#define GPIO_GET_GROUP_INDEX_FROM_PAD(GpioPad) GPIO_GET_GROUP_INDEX (GPIO_GET_GROUP_FROM_PAD(GpioPad))
+#define GPIO_GET_PAD_NUMBER(GpioPad)           ((GpioPad) & 0x1FF)
+#define GPIO_GET_CHIPSET_ID(GpioPad)           (((GpioPad) >> 24) & 0xF)
+
+#define GPIO_GET_PAD_POSITION(PadNumber)       ((PadNumber) % 32)
+#define GPIO_GET_DW_NUM(PadNumber)             ((PadNumber) / 32u)
+
+/**
+  This procedure will retrieve address and length of GPIO info table
+
+  @param[out]  GpioGroupInfoTableLength   Length of GPIO group table
+
+  @retval Pointer to GPIO group table
+**/
+CONST GPIO_GROUP_INFO*
+GpioGetGroupInfoTable (
+  OUT UINT32              *GpioGroupInfoTableLength
+  );
+
+typedef struct {
+  CONST CHAR8*    GpioGroupPrefix;
+  CONST GPIO_PAD  FirstUniqueGpio;
+  CONST CHAR8**   GroupUniqueNames;
+  CONST UINT32    UniqueNamesTableSize;
+} GPIO_GROUP_NAME_INFO;
+
+//
+// Helper macros for initializing GPIO_GROUP_NAME_INFO structures
+//
+#define GPIO_GROUP_NAME(GroupName,FirstUniqueGpio,GroupUniqueNamesTable) \
+  {GroupName, FirstUniqueGpio, GroupUniqueNamesTable, ARRAY_SIZE (GroupUniqueNamesTable)}
+
+#define GPIO_GROUP_NAME_BASIC(GroupName) \
+  {GroupName, 0, NULL, 0}
+
+/**
+  Returns GPIO_GROUP_NAME_INFO corresponding to the give GpioPad
+
+  @param[in]  GroupIndex  Group index
+
+  @retval  GPIO_GROUP_NAME_INFO*  Pointer to the GPIO_GROUP_NAME_INFO
+  @retval  NULL                   If no group descriptor was found
+**/
+CONST
+GPIO_GROUP_NAME_INFO*
+GpioGetGroupNameInfo (
+  IN UINT32  GroupIndex
+  );
+
+/**
+  Get GPIO Chipset ID specific to PCH generation and series
+**/
+UINT32
+GpioGetThisChipsetId (
+  VOID
+  );
+
+/**
+  This procedure is used to check if GpioPad is valid for certain chipset
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval TRUE                    This pin is valid on this chipset
+          FALSE                   Incorrect pin
+**/
+BOOLEAN
+GpioIsCorrectPadForThisChipset (
+  IN  GPIO_PAD        GpioPad
+  );
+
+/**
+  Generates GPIO name from GpioPad
+  This function returns pointer to the static buffer.
+
+  @param[in] GpioPad  GpioPad
+
+  @retval CHAR8*  Pointer to the GPIO name
+**/
+CHAR8*
+GpioName (
+  IN GPIO_PAD  GpioPad
+  );
+
+/**
+  Generates GPIO name from GpioNativePad
+  This function returns pointer to the static buffer.
+
+  @param[in] GpioNativePad  GpioNativePad
+
+  @retval CHAR8*  Pointer to the GPIO name
+**/
+CHAR8*
+GpioPinMuxName (
+  IN GPIO_NATIVE_PAD  GpioNativePad
+  );
+
+/**
+  Generates GPIO Pad Termination string
+  This function returns pointer to the static buffer.
+
+  @param[in] GpioPadTermination  GPIO Pad Termination
+
+  @retval CHAR8*  Painter to the pad termianation string
+**/
+CHAR8*
+GpioGetPadTerminationString (
+  IN GPIO_ELECTRICAL_CONFIG PadTermination
+  );
+
+/**
+  This procedure will get value of selected gpio register
+
+  @param[in]  Group               GPIO group number
+  @param[in]  Offset              GPIO register offset
+  @param[out] RegVal              Value of gpio register
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetReg (
+  IN  GPIO_GROUP              Group,
+  IN  UINT32                  Offset,
+  OUT UINT32                  *RegVal
+  );
+
+/**
+  This procedure will set value of selected gpio register
+
+  @param[in] Group               GPIO group number
+  @param[in] Offset              GPIO register offset
+  @param[in] RegVal              Value of gpio register
+
+  @retval EFI_SUCCESS            The function completed successfully
+  @retval EFI_INVALID_PARAMETER  Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetReg (
+  IN GPIO_GROUP              Group,
+  IN UINT32                  Offset,
+  IN UINT32                  RegVal
+  );
+
+/**
+  This procedure is used by PchSmiDispatcher and will return information
+  needed to register GPI SMI.
+
+  @param[in]  Index                   GPI SMI number
+  @param[out] GpioPin                 GPIO pin
+  @param[out] GpiSmiBitOffset         GPI SMI bit position within GpiSmi Registers
+  @param[out] GpiHostSwOwnRegAddress  Address of HOSTSW_OWN register
+  @param[out] GpiSmiStsRegAddress     Address of GPI SMI status register
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetPadAndSmiRegs (
+  IN UINT32            Index,
+  OUT GPIO_PAD         *GpioPin,
+  OUT UINT8            *GpiSmiBitOffset,
+  OUT UINT32           *GpiHostSwOwnRegAddress,
+  OUT UINT32           *GpiSmiStsRegAddress
+  );
+
+/**
+  This procedure will set GPIO Driver IRQ number
+
+  @param[in]  Irq                 Irq number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid IRQ number
+**/
+EFI_STATUS
+GpioSetIrq (
+  IN  UINT8          Irq
+  );
+
+/**
+  This function provides GPIO Community PortIDs
+
+  @param[out] NativePinsTable                Table with GPIO COMMx SBI PortIDs
+
+  @retval      Number of communities
+**/
+UINT32
+GpioGetComSbiPortIds (
+  OUT PCH_SBI_PID    **GpioComSbiIds
+  );
+
+/**
+  This function provides list of GPIO for which IO Standby State configuration
+  has to be set as 'Masked'
+
+  @param[out] GpioPadsList                Table with pads
+
+  @retval      Number of pads
+**/
+UINT32
+GpioGetIoStandbyStateConfigurationPadsList (
+  OUT GPIO_PAD_NATIVE_FUNCTION    **GpioPadsList
+  );
+
+
+/**
+  This procedure will perform special handling of GPP_A_12.
+
+  @param[in]  None
+
+  @retval None
+**/
+VOID
+GpioA12SpecialHandling (
+  VOID
+  );
+
+//
+// Structure which stores information needed to map GPIO Group
+// to 1-Tier GPE. Configuration is needed both in PMC and GPIO IP.
+// Because GPE_DWx can handle only 32 pins only single double word can
+// be mapped at a time. Each DW for a group has different configuration in PMC and GPIO
+//
+typedef struct {
+  GPIO_GROUP  Group;
+  UINT8       GroupDw;
+  UINT8       PmcGpeDwxVal;
+} GPIO_GROUP_TO_GPE_MAPPING;
+
+/**
+  Get information for GPIO Group required to program GPIO and PMC for desired 1-Tier GPE mapping
+
+  @param[out] GpioGroupToGpeMapping        Table with GPIO Group to GPE mapping
+  @param[out] GpioGroupToGpeMappingLength  GPIO Group to GPE mapping table length
+**/
+VOID
+GpioGetGroupToGpeMapping (
+  OUT GPIO_GROUP_TO_GPE_MAPPING  **GpioGroupToGpeMapping,
+  OUT UINT32                     *GpioGroupToGpeMappingLength
+  );
+
+/**
+  This procedure will return Port ID of GPIO Community from GpioPad
+
+  @param[in] GpioPad            GpioPad
+
+  @retval GpioCommunityPortId   Port ID of GPIO Community
+**/
+UINT8
+GpioGetGpioCommunityPortIdFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  );
+
+/**
+  This procedure will return PadCfg address from GpioPad
+
+  @param[in] GpioPad            GpioPad
+
+  @retval GpioPadCfgAddress     PadCfg Address of GpioPad
+**/
+UINT32
+GpioGetGpioPadCfgAddressFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  );
+
+/**
+  This procedure is used to unlock all GPIO pads.
+  This function can only be called when platform is still in HOSTIA_BOOT_SAI.
+**/
+VOID
+GpioUnlockAllPads (
+  VOID
+  );
+
+/**
+  This procedure will check if GpioPad is owned by host.
+
+  @param[in] GpioPad       GPIO pad
+
+  @retval TRUE             GPIO pad is owned by host
+  @retval FALSE            GPIO pad is not owned by host and should not be used with GPIO lib API
+**/
+BOOLEAN
+GpioIsPadHostOwned (
+  IN GPIO_PAD             GpioPad
+  );
+
+
+/**
+  This procedure will check if GpioPad argument is valid.
+  Function will check below conditions:
+   - GpioPad represents a pad for current PCH
+   - GpioPad belongs to valid GpioGroup
+   - GPIO PadNumber is not greater than number of pads for this group
+
+  @param[in] GpioPad       GPIO pad
+
+  @retval TRUE             GPIO pad is valid and can be used with GPIO lib API
+  @retval FALSE            GPIO pad is invalid and cannot be used with GPIO lib API
+**/
+BOOLEAN
+GpioIsPadValid (
+  IN GPIO_PAD             GpioPad
+  );
+
+/**
+  This procedure will read GPIO Pad Configuration register
+
+  @param[in] GpioPad          GPIO pad
+  @param[in] DwReg            Choose PADCFG register: 0:DW0, 1:DW1
+
+  @retval PadCfgRegValue      PADCFG_DWx value
+**/
+UINT32
+GpioReadPadCfgReg (
+  IN GPIO_PAD             GpioPad,
+  IN UINT8                DwReg
+  );
+
+/**
+  This procedure will write or read GPIO Pad Configuration register
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] DwReg                Choose PADCFG register: 0:DW0, 1:DW1
+  @param[in] PadCfgAndMask        Mask to be AND'ed with PADCFG reg value
+  @param[in] PadCfgOrMask         Mask to be OR'ed with PADCFG reg value
+
+  @retval none
+**/
+VOID
+GpioWritePadCfgReg (
+  IN GPIO_PAD             GpioPad,
+  IN UINT8                DwReg,
+  IN UINT32               PadCfgAndMask,
+  IN UINT32               PadCfgOrMask
+  );
+
+/**
+  This procedure will Enable USB Virtual Wire Overcurrent pin
+
+  @param[in] GpioPad             GPIO Pad
+
+  @retval EFI_SUCCESS
+**/
+EFI_STATUS
+GpioSetVwOverCurrentPin (
+  IN GPIO_VWOC_FUNCTION GpioPad
+  );
+
+/**
+  This procedure will set Native Function IOSF-SB Virtual Wire Message Generation bit
+  in DW0 of requested GPIO Pad
+
+  @param[in] GPIO_PAD   GpioPad
+**/
+VOID
+GpioSetNafVweBit (
+  IN CONST GPIO_PAD PadCfg
+  );
+
+/**
+  This procedure will set GPIO mode
+
+  @param[in] GpioPad             GPIO pad
+  @param[in] PadModeValue        GPIO pad mode value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetPadMode (
+  IN GPIO_PAD                GpioPad,
+  IN GPIO_PAD_MODE           PadModeValue
+  );
+
+/**
+  This procedure will set GPIO pad to native mode.
+  To be used if no other settings are to be configured when enabling native mode.
+
+  @param[in]  GpioNativePad       GPIO Pad with native mode information
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetNativePad (
+  IN GPIO_NATIVE_PAD  GpioNativePad
+  );
+
+/**
+  This procedure will set GPIO pad to native function based on provided native function
+  and platform muxing selection (if needed).
+
+  @param[in]  PadFunction         PadMode for a specific native signal. Please refer to GpioNativePads.h
+  @param[in]  PinMux              GPIO Native pin mux platform config.
+                                  This argument is optional and needs to be
+                                  provided only if feature can be enabled
+                                  on multiple pads
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetNativePadByFunction (
+  IN UINT32  PadFunction,
+  IN UINT32  PinMux
+  );
+
+/**
+  This procedure will get GPIO mode
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] PadModeValue        GPIO pad mode value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetPadMode (
+  IN  GPIO_PAD                 GpioPad,
+  OUT GPIO_PAD_MODE            *PadModeValue
+  );
+
+/**
+  This procedure will check if group is within DeepSleepWell.
+
+  @param[in]  Group               GPIO Group
+
+  @retval GroupWell               TRUE:  This is DSW Group
+                                  FALSE: This is not DSW Group
+**/
+BOOLEAN
+GpioIsDswGroup (
+  IN  GPIO_GROUP         Group
+  );
+
+/**
+  The function performs GPIO Power Management programming.
+**/
+VOID
+GpioConfigurePm (
+  VOID
+  );
+
+/**
+  This function performs initial IO Standby State related configurations
+**/
+VOID
+GpioConfigureIoStandbyState (
+  VOID
+  );
+
+/**
+  This function enables SCS SD Card controller card detect pin
+
+  @param[in]  none
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableScsSdCardDetect (
+  VOID
+  );
+
+/**
+  This function sets HDA SSP interface pins into native mode
+
+  @param[in]  SspInterfaceNumber   SSPx interface number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableHdaSsp (
+  IN  UINT32            SspInterfaceNumber
+  );
+
+/**
+  This function sets HDA SSP Master Clock into native mode
+
+  @param[in]  MclkIndex       MCLK index
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableHdaSspMasterClock (
+  IN UINT32  MclkIndex
+  );
+
+/**
+  This function sets HDA SoundWire interface pins into native mode
+
+  @param[in]  SndwInterfaceNumber   SNDWx interface number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableHdaSndw (
+  IN  UINT32            SndwInterfaceNumber
+  );
+
+/**
+  This function provides SPI IO pin for Touch Host Controller
+
+  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
+  @param[in]  IoIndex                   IoIndex Valid from 0 (SPI_IO_0) to 3 (SPI_IO_3)
+
+  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex or IoIndex is invalid
+**/
+GPIO_PAD_NATIVE_FUNCTION
+GpioGetThcSpiIo (
+  IN  UINT32                      SpiIndex,
+  IN  UINT32                      IoIndex
+  );
+
+/**
+  This function provides SPI ChipSelect pin for Touch Host Controller
+
+  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
+
+  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
+**/
+GPIO_PAD_NATIVE_FUNCTION
+GpioGetThcSpiCs (
+  IN  UINT32                      SpiIndex
+  );
+
+/**
+  This function provides SPI Clock pin for Touch Host Controller
+
+  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
+
+  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
+**/
+GPIO_PAD_NATIVE_FUNCTION
+GpioGetThcSpiClk (
+  IN  UINT32                      SpiIndex
+  );
+
+/**
+  This function provides SPI Reset pin for Touch Host Controller
+
+  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
+
+  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
+**/
+GPIO_PAD_NATIVE_FUNCTION
+GpioGetThcSpiReset (
+  IN  UINT32                      SpiIndex
+  );
+
+/**
+  This function sets SMBUS controller pins into native mode
+
+  @param[in]  none
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableSmbus (
+  VOID
+  );
+
+/**
+  This function sets SMBUS ALERT pins into native mode
+
+  @param[in]  none
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableSmbusAlert (
+  VOID
+  );
+
+/**
+  This function provides Serial GPIO pins
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[out] SgpioPins           SATA Serial GPIO pins
+**/
+VOID
+GpioGetSataSgpioPins (
+  IN  UINT32        SataCtrlIndex,
+  OUT SGPIO_PINS    *SgpioPins
+  );
+
+/**
+  This function sets Serial GPIO pins into native mode
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[in]  SataPort            SATA port number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableSataSgpio (
+  IN  UINT32  SataCtrlIndex
+  );
+
+/**
+  This function enables USB OverCurrent pins by setting
+  USB2 OCB pins into native mode
+
+  @param[in]  OcPinNumber            USB OC pin number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableUsbOverCurrent (
+  IN  UINTN   OcPinNumber
+  );
+
+/**
+  This function enables USB Virtual Wire OverCurrent pins by OcPinNumber.
+
+  @param[in]  OcPinNumber            USB OC pin number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableUsbVwOverCurrent (
+  IN  UINTN   OcPinNumber
+  );
+
+/**
+  This function sets SATA DevSlp pins into native mode
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[in]  SataPort            SATA port number
+  @param[in]  ResetType           GPIO reset type (see GPIO_RESET_CONFIG in GpioConfig.h)
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableSataDevSlpPin (
+  IN  UINT32  SataCtrlIndex,
+  IN  UINTN   SataPort,
+  IN  UINT32  ResetType
+  );
+
+/**
+  This function checks if SataDevSlp pin is in native mode
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[in]  SataPort            SATA port
+  @param[out] DevSlpPad           DevSlpPad
+                                  This is an optional parameter and may be NULL.
+
+  @retval TRUE                    DevSlp is in native mode
+          FALSE                   DevSlp is not in native mode
+**/
+BOOLEAN
+GpioIsSataDevSlpPinEnabled (
+  IN  UINT32          SataCtrlIndex,
+  IN  UINTN           SataPort,
+  OUT GPIO_PAD        *DevSlpPad  OPTIONAL
+  );
+
+/**
+  This function sets SATAGPx pin into native mode
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[in]  SataPort            SATA port number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableSataGpPin (
+  IN  UINT32  SataCtrlIndex,
+  IN  UINTN   SataPort
+  );
+
+/**
+  This function provides SATA GP pin data
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @param[in]  SataPort            SATA port number
+  @param[out] NativePin           SATA GP pin
+**/
+VOID
+GpioGetSataGpPin (
+  IN  UINT32                    SataCtrlIndex,
+  IN  UINTN                     SataPort,
+  OUT GPIO_PAD_NATIVE_FUNCTION  *NativePin
+  );
+
+/**
+  This function sets SATA LED pin into native mode. SATA LED indicates
+  SATA controller activity
+
+  @param[in]  SataCtrlIndex       SATA controller index
+  @retval     Status
+**/
+EFI_STATUS
+GpioEnableSataLed (
+  IN  UINT32                    SataCtrlIndex
+  );
+
+/**
+  Returns pad for given CLKREQ# index.
+
+  @param[in]  ClkreqIndex       CLKREQ# number
+
+  @return CLKREQ# pad.
+**/
+GPIO_PAD
+GpioGetClkreqPad (
+  IN     UINT32   ClkreqIndex
+  );
+
+/**
+  Enables CLKREQ# pad in native mode.
+
+  @param[in]  ClkreqIndex       CLKREQ# number
+
+  @return none
+**/
+VOID
+GpioEnableClkreq (
+  IN     UINT32   ClkreqIndex
+  );
+
+/**
+  This function sets PCHHOT pin into native mode
+
+  @param[in]  none
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnablePchHot (
+  VOID
+  );
+
+/**
+  This function sets VRALERTB pin into native mode
+
+  @param[in]  none
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableVrAlert (
+  VOID
+  );
+
+/**
+  This function sets CPU GP pins into native mode
+
+  @param[in]  CpuGpPinNum               CPU GP pin number
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableCpuGpPin (
+  IN  UINT32                            CpuGpPinNum
+  );
+
+/**
+This function sets CPU C10 Gate pins into native mode
+
+@retval Status
+**/
+EFI_STATUS
+GpioEnableCpuC10GatePin (
+  VOID
+  );
+
+//
+// DDPx pins
+//
+typedef enum {
+  GpioDdp1 = 0x01,
+  GpioDdp2 = 0x02,
+  GpioDdp3 = 0x03,
+  GpioDdp4 = 0x04,
+  GpioDdpA = 0x10,
+  GpioDdpB = 0x11,
+  GpioDdpC = 0x12,
+  GpioDdpD = 0x13,
+  GpioDdpF = 0x15,
+} GPIO_DDP;
+
+/**
+  This function sets DDP pins into native mode
+
+  @param[in]  DdpInterface   DDPx interface
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableDpInterface (
+  IN  GPIO_DDP            DdpInterface
+  );
+
+//
+// DDI Port TBT_LSX interface
+//
+typedef enum {
+  GpioTbtLsxDdi1,
+  GpioTbtLsxDdi2,
+  GpioTbtLsxDdi3,
+  GpioTbtLsxDdi4,
+  GpioTbtLsxDdi5,
+  GpioTbtLsxDdi6
+} GPIO_TBT_LSX;
+
+/**
+  This function sets TBT_LSx pin into native mode
+
+  @param[in]  TbtLsxDdiPort     TBT_LSx DDI Port Number
+
+  @retval     Status
+**/
+EFI_STATUS
+GpioEnableTbtLsxInterface (
+  IN GPIO_TBT_LSX  TbtLsxDdiPort
+  );
+
+/**
+  This function configures GPIO connection between CNVi and CRF
+
+  @retval Status
+**/
+EFI_STATUS
+GpioConfigureCnviCrfConnection (
+  VOID
+  );
+
+/**
+  This function sets CNVi Bluetooth Enable value
+
+  @param[in] Value                CNVi BT enable value
+                                  0: Disable, 1: Enable
+  @retval Status
+**/
+EFI_STATUS
+GpioSetCnviBtEnState (
+   IN  UINT32  Value
+  );
+
+/**
+  This function sets CNVi Bluetooth Wireless Charging support
+
+  @param[in] BtWirelessCharging   CNVi BT Wireless Charging support
+                                  0: Normal BT operation (no Wireless Charging support)
+                                  1: Enable BT Wireless Charging
+  @retval Status
+**/
+EFI_STATUS
+GpioSetCnviBtWirelessCharging (
+  IN  UINT32  BtWirelessCharging
+  );
+
+/**
+  This function enables and configures CNVi Bluetooth Host wake-up interrupt
+
+  @param[in] None
+
+  @retval Status
+**/
+EFI_STATUS
+GpioConfigureCnviBtHostWakeInt (
+  VOID
+  );
+
+/**
+  This function enables IMGU CLKOUT native pin
+
+  @param[in] ImguClkOutPinIndex    The index of IMGU CLKOUT natine pin
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableImguClkOut (
+  IN UINT8 ImguClkOutPinIndex
+  );
+
+/**
+  Power button debounce configuration
+  Debounce time can be specified in microseconds. Only certain values according
+  to below formula are supported:
+   DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(glitch filter clock period).
+  RTC clock with f = 32 KHz is used for glitch filter.
+   DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(31.25 us).
+  Supported DebounceTime values are following:
+   DebounceTime = 0 -> Debounce feature disabled
+   DebounceTime > 0 && < 250us -> Not supported
+   DebounceTime = 250us - 1024000us -> Supported range (DebounceTime = 250us * 2^n)
+  For values not supported by HW, they will be rounded down to closest supported one
+
+  @param[in] DebounceTime    Debounce Time in microseconds
+                             If Debounce Time = 0, Debouncer feature will be disabled
+                             Function will set DebounceTime argument to rounded supported value
+**/
+VOID
+GpioSetPwrBtnDebounceTimer (
+  IN UINT32                DebounceTime
+  );
+
+
+/**
+  VCCIO level selection
+**/
+typedef enum {
+  GpioVcc3v3,
+  GpioVcc1v8,
+  MaxVccioSel
+} GPIO_VCCIO_SEL;
+/**
+  The function sets VCCIOSEL
+
+  @param[in]  GpioPad             GPIO pad
+  @param[in]  VccioSel            Pad voltage
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         The Pin is owned by others
+  @retval EFI_INVALID_PARAMETER   Invalid group or parameter
+**/
+EFI_STATUS
+GpioSetVccLevel (
+  IN  GPIO_PAD        GpioPad,
+  IN  GPIO_VCCIO_SEL  VccioSel
+  );
+
+/**
+  SBU (Sideband use) pins are used as auxiliary signals for Type C connector,
+  which are hard-wired to BSSB_LS natively for debug function.
+  when USB-C is enablde and debug not needed, disable pins (BSSB) used for debug through TypeC connector,
+  program SBU pins to high-Z/open circuit per USB-C spec.
+
+  @param[in]  UsbTcPortEnBitmap   USB Type C port enabled bitmap
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         SBU pads are not supported
+  @retval EFI_INVALID_PARAMETER   Invalid input parameter
+**/
+EFI_STATUS
+GpioDisableTypeCSbuDebug (
+  IN UINT32           UsbTcPortEnBitmap
+  );
+
+/**
+  When 2-wire DCI OOB is connected via SBU from Type C port, need set IO Standby state to masked (to operate as if no standby signal asserted)
+  to remain connection in low power state.
+
+  @param[in] DciPortId            DCI connection port ID
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         SBU pads are not supported
+  @retval EFI_INVALID_PARAMETER   Invalid input parameter
+**/
+EFI_STATUS
+Gpio2WireDciOobSetting (
+  IN UINT8                        DciPortId
+  );
+
+/**
+  This function enables the virtual wire msg bus from GPIO controller
+  to FIA. The virtual wire is used to transfer CLKREQ assert/de-assert
+  msg for CPU PCIe ports. Each of the PCIe ports has its dedicated VW
+  msg.
+
+  @param[in] PortIndex            Index of the CPU PCIe port for which VW
+                                  should be enabled.
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         Failed to set native mode.
+**/
+EFI_STATUS
+GpioEnableCpuPcieVwClkReqMsgBus (
+  IN UINT32  PortIndex
+  );
+
+/**
+  This function sets Time Sync Gpio into native mode
+
+  @param[in]  Index       index
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableTimeSync (
+  IN UINT32  Index
+  );
+
+/**
+  This function sets Tsn into native mode
+
+  @retval Status
+**/
+EFI_STATUS
+GpioEnableTsn (
+  VOID
+  );
+
+/**
+  This function is to be used In GpioLockPads() to override a lock request by SOC code.
+
+  @param[in]  Group          GPIO group
+  @param[in]  DwNum          Register number for current group (parameter applicable in accessing whole register).
+                             For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] *UnlockCfgPad  DWORD bitmask for pads which are going to be left unlocked
+                             Bit position - PadNumber
+                             Bit value - 0: to be locked, 1: Leave unlocked
+  @param[out] *UnlockTxPad   DWORD bitmask for pads which are going to be left unlocked
+                             Bit position - PadNumber
+                             Bit value - 0: to be locked, 1: Leave unlocked
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid input parameter
+**/
+EFI_STATUS
+GpioUnlockOverride (
+  IN  GPIO_GROUP  Group,
+  IN  UINT32      DwNum,
+  OUT UINT32      *UnlockCfgPad,
+  OUT UINT32      *UnlockTxPad
+  );
+
+/**
+  Check if 0x13 opcode supported for writing to GPIO lock unlock register
+
+  @retval TRUE                It's supported
+  @retval FALSE               It's not supported
+**/
+BOOLEAN
+IsGpioLockOpcodeSupported (
+  VOID
+  );
+
+/**
+  Configures IO standby related settings for the GPIO pad.
+
+  @param[in]  GpioPad             GPIO pad
+  @param[in]  IoStandbyState      GPIO pad IO Standby state
+  @param[in]  IoStandbyTerm       GPIO pad IO Standby termination
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioConfigurePadIoStandby (
+  IN GPIO_PAD              GpioPad,
+  IN GPIO_IOSTANDBY_STATE  IoStandbyState,
+  IN GPIO_IOSTANDBY_TERM   IoStandbyTerm
+  );
+
+/**
+  Checks if GPIO PinMux corresponds to I2C4 B
+
+  @param[in] SdaPinMux    GPIO pad pinmux for SDA
+  @param[in] SclPinMux    GPIO pad pinmux for SCL
+
+  @retval TRUE         PinMux corresponds to I2C4 B
+          FALSE        PinMux equals to I2C4 A
+**/
+EFI_STATUS
+GpioIsSerialIoI2c4bMuxed (
+  IN UINT32  SdaPinMux,
+  IN UINT32  SclPinMux
+  );
+
+#endif // _GPIO_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.c
new file mode 100644
index 0000000000..5a6360931b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.c
@@ -0,0 +1,140 @@
+/** @file
+  Implementation of BaseGpioCheckConflictLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/GpioCheckConflictLib.h>
+#include <Uefi/UefiMultiPhase.h>
+#include <Pi/PiBootMode.h>
+#include <Pi/PiHob.h>
+#include <Library/HobLib.h>
+#include <Library/DebugLib.h>
+#include <Library/GpioPrivateLib.h>
+
+/**
+  Check Gpio PadMode conflict and report it.
+
+  @retval     none.
+**/
+VOID
+GpioCheckConflict (
+  VOID
+  )
+{
+  EFI_HOB_GUID_TYPE              *GpioCheckConflictHob;
+  GPIO_PAD_MODE_INFO             *GpioCheckConflictHobData;
+  UINT32                          HobDataSize;
+  UINT32                          GpioCount;
+  UINT32                          GpioIndex;
+  GPIO_CONFIG                     GpioActualConfig;
+
+  GpioCheckConflictHob = NULL;
+  GpioCheckConflictHobData = NULL;
+
+  DEBUG ((DEBUG_INFO, "GpioCheckConflict Start..\n"));
+
+  //
+  // Use Guid to find HOB.
+  //
+  GpioCheckConflictHob = (EFI_HOB_GUID_TYPE *) GetFirstGuidHob (&gGpioCheckConflictHobGuid);
+  if (GpioCheckConflictHob == NULL) {
+    DEBUG ((DEBUG_INFO, "[GPIO Conflict Check] No GPIO HOB found.\n"));
+  } else {
+    while (GpioCheckConflictHob != NULL) {
+      //
+      // Find the Data area pointer and Data size from the Hob
+      //
+      GpioCheckConflictHobData = (GPIO_PAD_MODE_INFO *) GET_GUID_HOB_DATA (GpioCheckConflictHob);
+      HobDataSize = GET_GUID_HOB_DATA_SIZE (GpioCheckConflictHob);
+
+      GpioCount = HobDataSize / sizeof (GPIO_PAD_MODE_INFO);
+      DEBUG ((DEBUG_INFO, "[GPIO Conflict Check] Hob : GpioCount =  %d\n", GpioCount));
+
+      //
+      // Probe Gpio entries in Hob and compare which are conflicted
+      //
+      for (GpioIndex = 0; GpioIndex < GpioCount ; GpioIndex++) {
+        GpioGetPadConfig (GpioCheckConflictHobData[GpioIndex].GpioPad, &GpioActualConfig);
+        if (GpioCheckConflictHobData[GpioIndex].GpioPadMode != GpioActualConfig.PadMode) {
+          DEBUG ((DEBUG_ERROR, "[GPIO Conflict Check] Identified conflict on pad %a (actual: 0x%X, expected: 0x%X)\n",
+                  GpioName (GpioCheckConflictHobData[GpioIndex].GpioPad),
+                  GpioActualConfig.PadMode,
+                  GpioCheckConflictHobData[GpioIndex].GpioPadMode));
+        }
+      }
+      //
+      // Find next Hob and return the Hob pointer by the specific Hob Guid
+      //
+      GpioCheckConflictHob = GET_NEXT_HOB (GpioCheckConflictHob);
+      GpioCheckConflictHob = GetNextGuidHob (&gGpioCheckConflictHobGuid, GpioCheckConflictHob);
+    }
+
+    DEBUG ((DEBUG_INFO, "GpioCheckConflict End.\n"));
+  }
+
+  return;
+}
+
+/**
+  This libaray will create one Hob for each Gpio config table
+  without PadMode is GpioHardwareDefault
+
+  @param[in]  GpioDefinition    Point to Platform Gpio table
+  @param[in]  GpioTableCount    Number of Gpio table entries
+
+  @retval     none.
+**/
+VOID
+CreateGpioCheckConflictHob (
+  IN GPIO_INIT_CONFIG          *GpioDefinition,
+  IN UINT32                    GpioTableCount
+  )
+{
+
+  UINT32                   Index;
+  UINT32                   GpioIndex;
+  GPIO_PAD_MODE_INFO       *GpioCheckConflictHobData;
+  UINT16                   GpioCount;
+
+  GpioCount = 0;
+  GpioIndex = 0;
+
+  DEBUG ((DEBUG_INFO, "CreateGpioCheckConflictHob Start \n"));
+
+  for (Index = 0; Index < GpioTableCount ; Index++) {
+    if (GpioDefinition[Index].GpioConfig.PadMode == GpioHardwareDefault) {
+      continue;
+    } else {
+      //
+      // Calculate non-default GPIO number
+      //
+      GpioCount++;
+    }
+  }
+
+  //
+  // Build a HOB tagged with a GUID for identification and returns
+  // the start address of GUID HOB data.
+  //
+  GpioCheckConflictHobData = (GPIO_PAD_MODE_INFO *) BuildGuidHob (&gGpioCheckConflictHobGuid , GpioCount * sizeof (GPIO_PAD_MODE_INFO));
+
+  //
+  // Record Non Default Gpio entries to the Hob
+  //
+  for (Index = 0; Index < GpioTableCount; Index++) {
+    if (GpioDefinition[Index].GpioConfig.PadMode == GpioHardwareDefault) {
+      continue;
+    } else {
+      if (GpioCheckConflictHobData != NULL) {
+        GpioCheckConflictHobData[GpioIndex].GpioPad = GpioDefinition[Index].GpioPad;
+        GpioCheckConflictHobData[GpioIndex].GpioPadMode = GpioDefinition[Index].GpioConfig.PadMode;
+        GpioIndex++;
+      }
+    }
+  }
+
+  DEBUG ((DEBUG_INFO, "CreateGpioCheckConflictHob End \n"));
+  return;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.inf
new file mode 100644
index 0000000000..f7e1de774d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.inf
@@ -0,0 +1,29 @@
+## @file
+#  Component information file for BaseGpioCheckConflictLib.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+[Defines]
+  INF_VERSION                    = 0x00010017
+  BASE_NAME                      = BaseGpioCheckConflictLib
+  FILE_GUID                      = C19A848A-F013-4DBF-9C23-F0F74DEA6F14
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = GpioCheckConflictLib
+
+[LibraryClasses]
+  DebugLib
+  HobLib
+  GpioLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+  BaseGpioCheckConflictLib.c
+
+[Guids]
+  gGpioCheckConflictHobGuid
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.c
new file mode 100644
index 0000000000..2f83f95b27
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.c
@@ -0,0 +1,35 @@
+/** @file
+  Implementation of BaseGpioCheckConflicLibNull.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/GpioCheckConflictLib.h>
+
+/**
+  Check Gpio PadMode conflict and report it.
+**/
+VOID
+GpioCheckConflict (
+  VOID
+  )
+{
+  return;
+}
+
+/**
+  This libaray will create one Hob for each Gpio config table
+  without PadMode is GpioHardwareDefault
+
+  @param[in]  GpioDefinition    Point to Platform Gpio table
+  @param[in]  GpioTableCount    Number of Gpio table entries
+**/
+VOID
+CreateGpioCheckConflictHob (
+  IN GPIO_INIT_CONFIG          *GpioDefinition,
+  IN UINT32                    GpioTableCount
+  )
+{
+  return;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.inf
new file mode 100644
index 0000000000..1c226d7c16
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflictLibNull/BaseGpioCheckConflictLibNull.inf
@@ -0,0 +1,26 @@
+## @file
+#  Component information file for BaseGpioCheckConflictLib.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+[Defines]
+  INF_VERSION                    = 0x00010017
+  BASE_NAME                      = BaseGpioCheckConflictLibNull
+  FILE_GUID                      = C19A848A-F013-4DBF-9C23-F0F74DEA6F14
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = GpioCheckConflictLib
+
+[LibraryClasses]
+  DebugLib
+  HobLib
+  GpioLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+  BaseGpioCheckConflictLibNull.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioInit.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioInit.c
new file mode 100644
index 0000000000..99dbbf0ca6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioInit.c
@@ -0,0 +1,558 @@
+/** @file
+  This file contains routines for GPIO initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "GpioLibrary.h"
+#include <Register/PchPcrRegs.h>
+#include <Library/GpioCheckConflictLib.h>
+
+//
+// GPIO_GROUP_DW_DATA structure is used by GpioConfigurePch function
+// to cache values which will be programmed into respective GPIO registers
+// after all GpioPads are processed. This way MMIO accesses are decreased
+// and instead of doing one programming for one GpioPad there is only
+// one access for whole register.
+//
+typedef struct {
+  UINT32             HostSoftOwnReg;
+  UINT32             HostSoftOwnRegMask;
+  UINT32             GpiGpeEnReg;
+  UINT32             GpiGpeEnRegMask;
+  UINT32             GpiNmiEnReg;
+  UINT32             GpiNmiEnRegMask;
+  UINT32             GpiSmiEnReg;
+  UINT32             GpiSmiEnRegMask;
+  UINT32             ConfigUnlockMask;
+  UINT32             OutputUnlockMask;
+} GPIO_GROUP_DW_DATA;
+
+//
+// GPIO_GROUP_DW_NUMBER contains number of DWords required to
+// store Pad data for all groups. Each pad uses one bit.
+//
+#define GPIO_GROUP_DW_NUMBER  1
+
+/**
+  Get GPIO DW Register values (HOSTSW_OWN, GPE_EN, NMI_EN, Lock).
+
+  @param[in]     PadNumber      GPIO pad number
+  @param[in]     GpioConfig     GPIO Config data
+  @param[in out] DwRegsValues   Values for GPIO DW Registers
+
+  @retval None
+**/
+STATIC
+VOID
+GpioDwRegValueFromGpioConfig (
+  IN UINT32                 PadNumber,
+  IN CONST GPIO_CONFIG      *GpioConfig,
+  IN OUT GPIO_GROUP_DW_DATA *GroupDwData
+  )
+{
+  UINT32  PadBitPosition;
+  UINT32  DwNum;
+
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+
+  if (DwNum >= GPIO_GROUP_DW_NUMBER) {
+    ASSERT (FALSE);
+    return;
+  }
+  //
+  // Update value to be programmed in HOSTSW_OWN register
+  //
+  GroupDwData[DwNum].HostSoftOwnRegMask |= (GpioConfig->HostSoftPadOwn & 0x1) << PadBitPosition;
+  GroupDwData[DwNum].HostSoftOwnReg |= (GpioConfig->HostSoftPadOwn >> 0x1) << PadBitPosition;
+
+  //
+  // Update value to be programmed in GPI_GPE_EN register
+  //
+  GroupDwData[DwNum].GpiGpeEnRegMask |= (GpioConfig->InterruptConfig & 0x1) << PadBitPosition;
+  GroupDwData[DwNum].GpiGpeEnReg |= ((GpioConfig->InterruptConfig & GpioIntSci) >> 3) << PadBitPosition;
+
+  //
+  // Update value to be programmed in GPI_NMI_EN register
+  //
+  GroupDwData[DwNum].GpiNmiEnRegMask |= (GpioConfig->InterruptConfig & 0x1) << PadBitPosition;
+  GroupDwData[DwNum].GpiNmiEnReg |= ((GpioConfig->InterruptConfig & GpioIntNmi) >> 1) << PadBitPosition;
+
+  //
+  // Update value to be programmed in GPI_SMI_EN register
+  GroupDwData[DwNum].GpiSmiEnRegMask |= (GpioConfig->InterruptConfig & 0x1) << PadBitPosition;
+  GroupDwData[DwNum].GpiSmiEnReg |= ((GpioConfig->InterruptConfig & GpioIntSmi) >> 2) << PadBitPosition;
+  if ((GpioConfig->InterruptConfig & GpioIntSmi) == GpioIntSmi) {
+    GroupDwData[DwNum].HostSoftOwnRegMask |= 1 << PadBitPosition;
+    GroupDwData[DwNum].HostSoftOwnReg |= 1 << PadBitPosition;
+  }
+
+  //
+  // Update information on Pad Configuration Lock
+  //
+  GroupDwData[DwNum].ConfigUnlockMask |= ((GpioConfig->LockConfig >> 1) & 0x1) << PadBitPosition;
+
+  //
+  // Update information on Pad Configuration Lock Tx
+  //
+  GroupDwData[DwNum].OutputUnlockMask |= ((GpioConfig->LockConfig >> 3) & 0x1) << PadBitPosition;
+
+  //
+  // if pad in GpioMode is an output default action should be to leave output unlocked
+  //
+  if ((GpioConfig->PadMode == GpioPadModeGpio) &&
+      (GpioConfig->Direction == GpioDirOut) &&
+      ((GpioConfig->LockConfig & B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) == GpioLockDefault)) {
+    GroupDwData[DwNum].OutputUnlockMask |= 0x1 << PadBitPosition;
+  }
+}
+
+/**
+  This internal procedure will scan GPIO initialization table and unlock
+  all pads present in it
+
+  @param[in] NumberOfItem               Number of GPIO pad records in table
+  @param[in] GpioInitTableAddress       GPIO initialization table
+  @param[in] Index                      Index of GPIO Initialization table record
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+STATIC
+EFI_STATUS
+GpioUnlockPadsForAGroup (
+  IN UINT32                    NumberOfItems,
+  IN GPIO_INIT_CONFIG          *GpioInitTableAddress,
+  IN UINT32                    Index
+  )
+{
+  UINT32                 PadsToUnlock[GPIO_GROUP_DW_NUMBER];
+  UINT32                 DwNum;
+  UINT32                 PadBitPosition;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  CONST GPIO_INIT_CONFIG *GpioData;
+  GPIO_GROUP             Group;
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  GpioData   = &GpioInitTableAddress[Index];
+  Group      = GpioGetGroupFromGpioPad (GpioData->GpioPad);
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioData->GpioPad);
+
+  ZeroMem (PadsToUnlock, sizeof (PadsToUnlock));
+  //
+  // Loop through pads for one group. If pad belongs to a different group then
+  // break and move to register programming.
+  //
+  while (Index < NumberOfItems) {
+
+    GpioData   = &GpioInitTableAddress[Index];
+    if (GroupIndex != GpioGetGroupIndexFromGpioPad (GpioData->GpioPad)) {
+      //if next pad is from different group then break loop
+      break;
+    }
+
+    PadNumber  = GpioGetPadNumberFromGpioPad (GpioData->GpioPad);
+    //
+    // Check if legal pin number
+    //
+    if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
+      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds possible range for group %d\n", PadNumber, GroupIndex));
+      return EFI_INVALID_PARAMETER;
+    }
+
+    PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+    DwNum = GPIO_GET_DW_NUM (PadNumber);
+
+    if (DwNum >= GPIO_GROUP_DW_NUMBER) {
+      ASSERT (FALSE);
+      return EFI_UNSUPPORTED;
+    }
+    //
+    // Update pads which need to be unlocked
+    //
+    PadsToUnlock[DwNum] |= 0x1 << PadBitPosition;
+
+    //Move to next item
+    Index++;
+  }
+
+  for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+    //
+    // Unlock pads
+    //
+    if (PadsToUnlock[DwNum] != 0) {
+      GpioUnlockPadCfgForGroupDw (Group, DwNum, PadsToUnlock[DwNum]);
+      GpioUnlockPadCfgTxForGroupDw (Group, DwNum, PadsToUnlock[DwNum]);
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will initialize multiple PCH GPIO pins
+
+  @param[in] NumberofItem               Number of GPIO pads to be updated
+  @param[in] GpioInitTableAddress       GPIO initialization table
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+STATIC
+EFI_STATUS
+GpioConfigurePch (
+  IN UINT32                    NumberOfItems,
+  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
+  )
+{
+  UINT32                 Index;
+  UINT32                 PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
+  UINT32                 PadCfgDwRegMask[GPIO_PADCFG_DW_REG_NUMBER];
+  UINT32                 PadCfgReg;
+  GPIO_GROUP_DW_DATA     GroupDwData[GPIO_GROUP_DW_NUMBER];
+  UINT32                 DwNum;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  GPIO_PAD_OWN           PadOwnVal;
+  CONST GPIO_INIT_CONFIG *GpioData;
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+  PCH_SBI_PID            GpioCom;
+
+  PadOwnVal = GpioPadOwnHost;
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  Index = 0;
+  while (Index < NumberOfItems) {
+
+    GpioData   = &GpioInitTableAddress[Index];
+    GroupIndex = GpioGetGroupIndexFromGpioPad (GpioData->GpioPad);
+    GpioCom    = GpioGroupInfo[GroupIndex].Community;
+
+    DEBUG_CODE_BEGIN();
+    if (!GpioIsCorrectPadForThisChipset (GpioData->GpioPad)) {
+      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Incorrect GpioPad (0x%08x) used on this chipset!\n", GpioData->GpioPad));
+      ASSERT (FALSE);
+      return EFI_UNSUPPORTED;
+    }
+    DEBUG_CODE_END ();
+
+    //
+    // Unlock pads for a given group which are going to be reconfigured
+    //
+    //
+    // Because PADCFGLOCK/LOCKTX register reset domain is Powergood, lock settings
+    // will get back to default only after G3 or DeepSx transition. On the other hand GpioPads
+    // configuration is controlled by a configurable type of reset - PadRstCfg. This means that if
+    // PadRstCfg != Powergood GpioPad will have its configuration locked despite it being not the
+    // one desired by BIOS. Before reconfiguring all pads they will get unlocked.
+    //
+    GpioUnlockPadsForAGroup (NumberOfItems, GpioInitTableAddress, Index);
+
+    ZeroMem (GroupDwData, sizeof (GroupDwData));
+    //
+    // Loop through pads for one group. If pad belongs to a different group then
+    // break and move to register programming.
+    //
+    while (Index < NumberOfItems) {
+
+      GpioData   = &GpioInitTableAddress[Index];
+      if (GroupIndex != GpioGetGroupIndexFromGpioPad (GpioData->GpioPad)) {
+        //if next pad is from different group then break loop
+        break;
+      }
+
+      PadNumber  = GpioGetPadNumberFromGpioPad (GpioData->GpioPad);
+
+      DEBUG_CODE_BEGIN ();
+      //
+      // Check if legal pin number
+      //
+      if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds possible range for group %d\n", PadNumber, GroupIndex));
+        return EFI_INVALID_PARAMETER;
+      }
+
+      //
+      // Check if selected GPIO Pad is not owned by CSME/ISH
+      //
+      GpioGetPadOwnership (GpioData->GpioPad, &PadOwnVal);
+
+      if (PadOwnVal != GpioPadOwnHost) {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Accessing pad not owned by host (Group=%d, Pad=%d)!\n", GroupIndex, PadNumber));
+        DEBUG ((DEBUG_ERROR, "** Please make sure the GPIO usage in sync between CSME and BIOS configuration. \n"));
+        DEBUG ((DEBUG_ERROR, "** All the GPIO occupied by CSME should not do any configuration by BIOS.\n"));
+        //Move to next item
+        Index++;
+        continue;
+      }
+
+      //
+      // Check if Pad enabled for SCI is to be in unlocked state
+      //
+      if (((GpioData->GpioConfig.InterruptConfig & GpioIntSci) == GpioIntSci) &&
+          ((GpioData->GpioConfig.LockConfig & B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK) != GpioPadConfigUnlock)){
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a used for SCI is not unlocked!\n", GpioName (GpioData->GpioPad)));
+        ASSERT (FALSE);
+        return EFI_INVALID_PARAMETER;
+      }
+      DEBUG_CODE_END ();
+
+      ZeroMem (PadCfgDwReg, sizeof (PadCfgDwReg));
+      ZeroMem (PadCfgDwRegMask, sizeof (PadCfgDwRegMask));
+      //
+      // Get GPIO PADCFG register value from GPIO config data
+      //
+      GpioPadCfgRegValueFromGpioConfig (
+        GpioData->GpioPad,
+        &GpioData->GpioConfig,
+        PadCfgDwReg,
+        PadCfgDwRegMask
+        );
+
+      //
+      // Create PADCFG register offset using group and pad number
+      //
+      PadCfgReg = S_GPIO_PCR_PADCFG * PadNumber + GpioGroupInfo[GroupIndex].PadCfgOffset;
+
+      //
+      // Write PADCFG DW0 register
+      //
+      MmioAndThenOr32 (
+        PCH_PCR_ADDRESS (GpioCom, PadCfgReg),
+        ~PadCfgDwRegMask[0],
+        PadCfgDwReg[0]
+        );
+      //
+      // Write PADCFG DW1 register
+      //
+      MmioAndThenOr32 (
+        PCH_PCR_ADDRESS (GpioCom, PadCfgReg + 0x4),
+        ~PadCfgDwRegMask[1],
+        PadCfgDwReg[1]
+        );
+
+      //
+      // Write PADCFG DW2 register
+      //
+      MmioAndThenOr32 (
+        PCH_PCR_ADDRESS (GpioCom, PadCfgReg + 0x8),
+        ~PadCfgDwRegMask[2],
+        PadCfgDwReg[2]
+        );
+
+      //
+      // Get GPIO DW register values from GPIO config data
+      //
+      GpioDwRegValueFromGpioConfig (
+        PadNumber,
+        &GpioData->GpioConfig,
+        GroupDwData
+        );
+
+      //Move to next item
+      Index++;
+    }
+
+    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+      //
+      // Write HOSTSW_OWN registers
+      //
+      if (GpioGroupInfo[GroupIndex].HostOwnOffset != NO_REGISTER_FOR_PROPERTY) {
+        MmioAndThenOr32 (
+          PCH_PCR_ADDRESS (GpioCom, GpioGroupInfo[GroupIndex].HostOwnOffset + DwNum * 0x4),
+          ~GroupDwData[DwNum].HostSoftOwnRegMask,
+          GroupDwData[DwNum].HostSoftOwnReg
+          );
+      }
+
+      //
+      // Write GPI_GPE_EN registers
+      //
+      if (GpioGroupInfo[GroupIndex].GpiGpeEnOffset != NO_REGISTER_FOR_PROPERTY) {
+        MmioAndThenOr32 (
+          PCH_PCR_ADDRESS (GpioCom, GpioGroupInfo[GroupIndex].GpiGpeEnOffset + DwNum * 0x4),
+          ~GroupDwData[DwNum].GpiGpeEnRegMask,
+          GroupDwData[DwNum].GpiGpeEnReg
+          );
+      }
+
+      //
+      // Write GPI_NMI_EN registers
+      //
+      if (GpioGroupInfo[GroupIndex].NmiEnOffset != NO_REGISTER_FOR_PROPERTY) {
+        MmioAndThenOr32 (
+          PCH_PCR_ADDRESS (GpioCom, GpioGroupInfo[GroupIndex].NmiEnOffset + DwNum * 0x4),
+          ~GroupDwData[DwNum].GpiNmiEnRegMask,
+          GroupDwData[DwNum].GpiNmiEnReg
+          );
+      } else if (GroupDwData[DwNum].GpiNmiEnReg != 0x0) {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %d has no pads supporting NMI\n", GroupIndex));
+        ASSERT_EFI_ERROR (EFI_UNSUPPORTED);
+      }
+
+      //
+      // Write GPI_SMI_EN registers
+      //
+      if (GpioGroupInfo[GroupIndex].SmiEnOffset != NO_REGISTER_FOR_PROPERTY) {
+        MmioAndThenOr32 (
+          PCH_PCR_ADDRESS (GpioCom, GpioGroupInfo[GroupIndex].SmiEnOffset + DwNum * 0x4),
+          ~GroupDwData[DwNum].GpiSmiEnRegMask,
+          GroupDwData[DwNum].GpiSmiEnReg
+          );
+      } else if (GroupDwData[DwNum].GpiSmiEnReg != 0x0) {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %d has no pads supporting SMI\n", GroupIndex));
+        ASSERT_EFI_ERROR (EFI_UNSUPPORTED);
+      }
+
+      //
+      // Update Pad Configuration unlock data
+      //
+      if (GroupDwData[DwNum].ConfigUnlockMask) {
+        GpioStoreGroupDwUnlockPadConfigData (GroupIndex, DwNum, GroupDwData[DwNum].ConfigUnlockMask);
+      }
+
+      //
+      // Update Pad Output unlock data
+      //
+      if (GroupDwData[DwNum].OutputUnlockMask) {
+        GpioStoreGroupDwUnlockOutputData (GroupIndex, DwNum, GroupDwData[DwNum].OutputUnlockMask);
+      }
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will clear all status bits of any GPIO interrupts.
+
+  @param[in] none
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+STATIC
+EFI_STATUS
+GpioClearAllGpioInterrupts (
+  VOID
+  )
+{
+  GPIO_GROUP             Group;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  GPIO_GROUP             GpioGroupLowest;
+  GPIO_GROUP             GpioGroupHighest;
+  UINT32                 GroupIndex;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 DwNum;
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  GpioGroupLowest = GpioGetLowestGroup ();
+  GpioGroupHighest = GpioGetHighestGroup ();
+
+  for (Group = GpioGroupLowest; Group <= GpioGroupHighest; Group++) {
+    GroupIndex = GpioGetGroupIndexFromGroup (Group);
+    //
+    // Check if group has GPI IS register
+    //
+    if (GpioGroupInfo[GroupIndex].GpiIsOffset != NO_REGISTER_FOR_PROPERTY) {
+      //
+      // Clear all GPI_IS Status bits by writing '1'
+      //
+      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+        MmioWrite32 (
+          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, GpioGroupInfo[GroupIndex].GpiIsOffset + DwNum * 0x4),
+          0xFFFFFFFF
+          );
+      }
+    }
+
+    //
+    // Check if group has GPI_GPE_STS register
+    //
+    if (GpioGroupInfo[GroupIndex].GpiGpeStsOffset != NO_REGISTER_FOR_PROPERTY) {
+      //
+      // Clear all GPI_GPE_STS Status bits by writing '1'
+      //
+      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+        MmioWrite32 (
+          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, GpioGroupInfo[GroupIndex].GpiGpeStsOffset + DwNum * 0x4),
+          0xFFFFFFFF
+          );
+      }
+    }
+
+    //
+    // Check if group has SMI_STS register
+    //
+    if (GpioGroupInfo[GroupIndex].SmiStsOffset != NO_REGISTER_FOR_PROPERTY) {
+      //
+      // Clear all SMI_STS Status bits by writing '1'
+      //
+      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+        MmioWrite32 (
+          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, GpioGroupInfo[GroupIndex].SmiStsOffset + DwNum * 4),
+          0xFFFFFFFF
+          );
+      }
+    }
+
+    //
+    // Check if group has NMI_STS register
+    //
+    if (GpioGroupInfo[GroupIndex].NmiStsOffset != NO_REGISTER_FOR_PROPERTY) {
+      //
+      // Clear all NMI_STS Status bits by writing '1'
+      //
+      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
+        MmioWrite32 (
+          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, GpioGroupInfo[GroupIndex].NmiStsOffset + DwNum * 4),
+          0xFFFFFFFF
+          );
+      }
+    }
+
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will initialize multiple GPIO pins. Use GPIO_INIT_CONFIG structure.
+  Structure contains fields that can be used to configure each pad.
+  Pad not configured using GPIO_INIT_CONFIG will be left with hardware default values.
+  Separate fields could be set to hardware default if it does not matter, except
+  GpioPad and PadMode.
+  Function will work in most efficient way if pads which belong to the same group are
+  placed in adjacent records of the table.
+  Although function can enable pads for Native mode, such programming is done
+  by reference code when enabling related silicon feature.
+
+  @param[in] NumberofItem               Number of GPIO pads to be updated
+  @param[in] GpioInitTableAddress       GPIO initialization table
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+EFI_STATUS
+GpioConfigurePads (
+  IN UINT32                    NumberOfItems,
+  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
+  )
+{
+  EFI_STATUS   Status;
+
+  Status =  GpioConfigurePch (NumberOfItems, GpioInitTableAddress);
+
+  CreateGpioCheckConflictHob (GpioInitTableAddress, NumberOfItems);
+
+  GpioClearAllGpioInterrupts ();
+  return Status;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLib.c
new file mode 100644
index 0000000000..d6c13fe581
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLib.c
@@ -0,0 +1,2387 @@
+/** @file
+  This file contains routines for GPIO
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "GpioLibrary.h"
+#include <Register/PchPcrRegs.h>
+
+/**
+  This procedure will check if GpioGroup argument is correct and
+  supplied DW reg number can be used for this group to access DW registers.
+  Function will check below conditions:
+   - Valid GpioGroup
+   - DwNum is has valid value for this group
+
+  @param[in] Group        GPIO group
+  @param[in] DwNum        Register number for current group (parameter applicable in accessing whole register).
+                          For group which has less then 32 pads per group DwNum must be 0.
+
+  @retval TRUE             DW Reg number and GpioGroup is valid
+  @retval FALSE            DW Reg number and GpioGroup is invalid
+**/
+STATIC
+BOOLEAN
+GpioIsGroupAndDwNumValid (
+  IN GPIO_GROUP             Group,
+  IN UINT32                 DwNum
+  )
+{
+  UINT32                 GroupIndex;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  GroupIndex = GpioGetGroupIndexFromGroup (Group);
+
+  if ((Group < GpioGetLowestGroup ()) || (Group > GpioGetHighestGroup ()) || (GroupIndex >= GpioGroupInfoLength)) {
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group argument (%d) is not within range of possible groups for this PCH\n", GroupIndex));
+    goto Error;
+  }
+
+  //
+  // Check if DwNum argument does not exceed number of DWord registers
+  // resulting from available pads for certain group
+  //
+  if (DwNum > GPIO_GET_DW_NUM (GpioGroupInfo[GroupIndex].PadPerGroup - 1)){
+    goto Error;
+  }
+
+  return TRUE;
+Error:
+  ASSERT (FALSE);
+  return FALSE;
+}
+
+//
+// Possible registers to be accessed using GpioReadReg()/GpioWriteReg() functions
+//
+typedef enum {
+  GpioHostOwnershipRegister = 0,
+  GpioGpeEnableRegister,
+  GpioGpeStatusRegister,
+  GpioSmiEnableRegister,
+  GpioSmiStatusRegister,
+  GpioNmiEnableRegister,
+  GpioPadConfigLockRegister,
+  GpioPadLockOutputRegister
+} GPIO_REG;
+
+/**
+  This procedure will read GPIO register
+
+  @param[in] RegType              GPIO register type
+  @param[in] Group                GPIO group
+  @param[in] DwNum                Register number for current group (parameter applicable in accessing whole register).
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] ReadVal             Read data
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         Feature is not supported for this group or pad
+**/
+STATIC
+EFI_STATUS
+GpioReadReg (
+  IN GPIO_REG               RegType,
+  IN GPIO_GROUP             Group,
+  IN UINT32                 DwNum,
+  OUT UINT32                *ReadVal
+  )
+{
+  UINT32                 RegOffset;
+  UINT32                 GroupIndex;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+
+  RegOffset = NO_REGISTER_FOR_PROPERTY;
+  GroupIndex = GpioGetGroupIndexFromGroup (Group);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  switch (RegType) {
+    case GpioHostOwnershipRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset;
+      break;
+    case GpioGpeEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeEnOffset;
+      break;
+    case GpioGpeStatusRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeStsOffset;
+      break;
+    case GpioSmiEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].SmiEnOffset;
+      break;
+    case GpioSmiStatusRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset;
+      break;
+    case GpioNmiEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].NmiEnOffset;
+      break;
+    case GpioPadConfigLockRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockOffset;
+      break;
+    case GpioPadLockOutputRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockTxOffset;
+      break;
+    default:
+      break;
+  }
+
+  //
+  // Check if selected register exists
+  //
+  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // If there are more then 32 pads per group then certain
+  // group information would be split into more then one DWord register.
+  //
+  if ((RegType == GpioPadConfigLockRegister) || (RegType == GpioPadLockOutputRegister)) {
+    //
+    // PadConfigLock and OutputLock registers when used for group containing more than 32 pads
+    // are not placed in a continuous way, e.g:
+    // 0x0 - PadConfigLock_DW0
+    // 0x4 - OutputLock_DW0
+    // 0x8 - PadConfigLock_DW1
+    // 0xC - OutputLock_DW1
+    //
+    RegOffset += DwNum * 0x8;
+  } else {
+    RegOffset += DwNum * 0x4;
+  }
+
+  *ReadVal = MmioRead32 (PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, RegOffset));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will write GPIO register
+
+  @param[in] RegType              GPIO register type
+  @param[in] Group                GPIO group
+  @param[in] DwNum                Register number for current group (parameter applicable in accessing whole register).
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in] RegAndMask           Mask which will be AND'ed with register value
+  @param[in] RegOrMask            Mask which will be OR'ed with register value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         Feature is not supported for this group or pad
+**/
+STATIC
+EFI_STATUS
+GpioWriteReg (
+  IN GPIO_REG               RegType,
+  IN GPIO_GROUP             Group,
+  IN UINT32                 DwNum,
+  IN UINT32                 RegAndMask,
+  IN UINT32                 RegOrMask
+  )
+{
+  UINT32                 RegOffset;
+  UINT32                 GroupIndex;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 PadCfgLock;
+  BOOLEAN                Lockable;
+
+  Lockable = FALSE;
+  PadCfgLock = 0;
+  RegOffset = NO_REGISTER_FOR_PROPERTY;
+  GroupIndex = GpioGetGroupIndexFromGroup (Group);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  switch (RegType) {
+    case GpioHostOwnershipRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset;
+      break;
+    case GpioGpeEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeEnOffset;
+      Lockable = TRUE;
+      break;
+    case GpioGpeStatusRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeStsOffset;
+      break;
+    case GpioSmiEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].SmiEnOffset;
+      Lockable = TRUE;
+      break;
+    case GpioSmiStatusRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset;
+      break;
+    case GpioNmiEnableRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].NmiEnOffset;
+      Lockable = TRUE;
+      break;
+    case GpioPadConfigLockRegister:
+    case GpioPadLockOutputRegister:
+    default:
+      break;
+  }
+
+  //
+  // Check if selected register exists
+  //
+  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (Lockable) {
+    GpioGetPadCfgLockForGroupDw (Group, DwNum, &PadCfgLock);
+    if (PadCfgLock) {
+      //
+      // Check if for pads which are going to be reconfigured lock is set.
+      //
+      if ((~RegAndMask | RegOrMask) & PadCfgLock) {
+        //
+        // Unlock all pads for this Group DW reg for simplicity
+        // even if not all of those pads will have their settings reprogrammed
+        //
+        GpioUnlockPadCfgForGroupDw (Group, DwNum, PadCfgLock);
+      } else {
+        //
+        // No need to perform an unlock as pads which are going to be reconfigured
+        // are not in locked state
+        //
+        PadCfgLock = 0;
+      }
+    }
+  }
+
+  //
+  // If there are more then 32 pads per group then certain
+  // group information would be split into more then one DWord register.
+  //
+  RegOffset += DwNum * 0x4;
+
+  MmioAndThenOr32 (
+    PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, RegOffset),
+    RegAndMask,
+    RegOrMask
+    );
+
+  if (Lockable && PadCfgLock) {
+    //
+    // Lock previously unlocked pads
+    //
+    GpioLockPadCfgForGroupDw (Group, DwNum, PadCfgLock);
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will write GPIO Lock/LockTx register using SBI.
+
+  @param[in] RegType              GPIO register (Lock or LockTx)
+  @param[in] Group                GPIO group number
+  @param[in] DwNum                Register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in] LockRegAndMask       Mask which will be AND'ed with Lock register value
+  @param[in] LockRegOrMask        Mask which will be Or'ed with Lock register value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_UNSUPPORTED         Feature is not supported for this group or pad
+**/
+STATIC
+EFI_STATUS
+GpioWriteLockReg (
+  IN GPIO_REG                  RegType,
+  IN GPIO_GROUP                Group,
+  IN UINT32                    DwNum,
+  IN UINT32                    LockRegAndMask,
+  IN UINT32                    LockRegOrMask
+  )
+{
+  UINT8                  Response;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 RegOffset;
+  UINT32                 OldLockVal;
+  UINT32                 NewLockVal;
+  UINT32                 GroupIndex;
+  EFI_STATUS             Status;
+  PCH_SBI_OPCODE         Opcode;
+
+  OldLockVal = 0;
+  NewLockVal = 0;
+
+  RegOffset = NO_REGISTER_FOR_PROPERTY;
+  GroupIndex = GpioGetGroupIndexFromGroup (Group);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  switch (RegType) {
+    case GpioPadConfigLockRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockOffset;
+      GpioGetPadCfgLockForGroupDw (Group, DwNum, &OldLockVal);
+      break;
+    case GpioPadLockOutputRegister:
+      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockTxOffset;
+      GpioGetPadCfgLockTxForGroupDw (Group, DwNum, &OldLockVal);
+      break;
+    default:
+      break;
+  }
+
+  //
+  // Check if selected register exists
+  //
+  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // If there are more then 32 pads per group then certain
+  // group information would be split into more then one DWord register.
+  // PadConfigLock and OutputLock registers when used for group containing more than 32 pads
+  // are not placed in a continuous way, e.g:
+  // 0x0 - PadConfigLock_DW0
+  // 0x4 - OutputLock_DW0
+  // 0x8 - PadConfigLock_DW1
+  // 0xC - OutputLock_DW1
+  //
+  RegOffset += DwNum *0x8;
+
+  NewLockVal = (OldLockVal & LockRegAndMask) | LockRegOrMask;
+
+  if (IsGpioLockOpcodeSupported ()) {
+    Opcode = GpioLockUnlock;
+  } else {
+    Opcode = PrivateControlWrite;
+  }
+
+  Status = PchSbiExecutionEx (
+             GpioGroupInfo[GroupIndex].Community,
+             RegOffset,
+             Opcode,
+             FALSE,
+             0x000F,
+             0x0000,
+             0x0000,
+             &NewLockVal,
+             &Response
+             );
+  ASSERT_EFI_ERROR (Status);
+  return Status;
+}
+
+/**
+  This internal procedure will calculate GPIO_RESET_CONFIG value  (new type)
+  based on provided PadRstCfg for a specific GPIO Pad.
+
+  @param[in]  GpioPad               GPIO Pad
+  @param[in]  PadRstCfg             GPIO PadRstCfg value
+
+  @retval GpioResetConfig           GPIO Reset configuration (new type)
+**/
+GPIO_RESET_CONFIG
+GpioResetConfigFromPadRstCfg (
+  IN  GPIO_PAD           GpioPad,
+  IN  UINT32             PadRstCfg
+  )
+{
+  GPIO_GROUP           Group;
+
+  static GPIO_RESET_CONFIG  PadRstCfgToGpioResetConfigMap[] = {
+                              GpioDswReset,
+                              GpioHostDeepReset,
+                              GpioPlatformReset,
+                              GpioResumeReset};
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+
+  if (PadRstCfg < 4) {
+    if (!GpioIsDswGroup(Group) && PadRstCfg == 3) {
+      DEBUG ((DEBUG_ERROR, "ERROR: Pad %a is configured to be reset by Global Reset without being part of DSW group\n", GpioName (GpioPad)));
+    }
+    return PadRstCfgToGpioResetConfigMap[PadRstCfg];
+  }
+  return GpioResetDefault;
+}
+
+/**
+  This internal procedure will calculate PadRstCfg register value based
+  on provided GPIO Reset configuration for a certain pad.
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[in]  GpioResetConfig           GPIO Reset configuration
+  @param[out] PadRstCfg                 GPIO PadRstCfg value
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid configuration
+**/
+EFI_STATUS
+GpioPadRstCfgFromResetConfig (
+  IN  GPIO_PAD           GpioPad,
+  IN  GPIO_RESET_CONFIG  GpioResetConfig,
+  OUT UINT32             *PadRstCfg
+  )
+{
+  GPIO_GROUP           Group;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+
+  switch (GpioResetConfig) {
+    case GpioResetDefault:
+      *PadRstCfg = 0x0;
+      break;
+    case GpioHostDeepReset:
+      *PadRstCfg = V_GPIO_PCR_RST_CONF_DEEP_RST;
+      break;
+    case GpioPlatformReset:
+      *PadRstCfg = V_GPIO_PCR_RST_CONF_GPIO_RST;
+      break;
+    case GpioResumeReset:
+      if (GpioIsDswGroup (Group)) {
+        *PadRstCfg = V_GPIO_PCR_RST_CONF_RESUME_RST;
+      } else {
+        *PadRstCfg = V_GPIO_PCR_RST_CONF_POW_GOOD;
+      }
+      break;
+    case GpioDswReset:
+      if (GpioIsDswGroup (Group)) {
+        *PadRstCfg = V_GPIO_PCR_RST_CONF_POW_GOOD;
+      } else {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Only GPD group pads can use GpioDswReset: %a\n", GpioName (GpioPad)));
+        goto Error;
+      }
+      break;
+    default:
+      goto Error;
+  }
+
+  return EFI_SUCCESS;
+Error:
+  ASSERT (FALSE);
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  This internal procedure will get GPIO_CONFIG data from PADCFG registers value
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[in]  PadCfgDwReg               PADCFG DWx register values
+  @param[out] GpioData                  GPIO Configuration data
+
+  @retval Status
+**/
+STATIC
+VOID
+GpioConfigFromPadCfgRegValue (
+  IN GPIO_PAD      GpioPad,
+  IN CONST UINT32  *PadCfgDwReg,
+  OUT GPIO_CONFIG  *GpioConfig
+  )
+{
+  UINT32               PadRstCfg;
+
+  //
+  // Get Reset Type (PadRstCfg)
+  //
+  PadRstCfg = (PadCfgDwReg[0] & B_GPIO_PCR_RST_CONF) >> N_GPIO_PCR_RST_CONF;
+
+  GpioConfig->PowerConfig = GpioResetConfigFromPadRstCfg (
+                              GpioPad,
+                              PadRstCfg
+                              );
+
+  //
+  // Get how interrupt is triggered (RxEvCfg)
+  //
+  GpioConfig->InterruptConfig = ((PadCfgDwReg[0] & B_GPIO_PCR_RX_LVL_EDG) >> (N_GPIO_PCR_RX_LVL_EDG - (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1))) | (0x1 << N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS);
+
+  //
+  // Get interrupt generation (GPIRoutIOxAPIC/SCI/SMI/NMI)
+  //
+  GpioConfig->InterruptConfig |= ((PadCfgDwReg[0] & (B_GPIO_PCR_RX_NMI_ROUTE | B_GPIO_PCR_RX_SCI_ROUTE | B_GPIO_PCR_RX_SMI_ROUTE | B_GPIO_PCR_RX_APIC_ROUTE)) >> (N_GPIO_PCR_RX_NMI_ROUTE - (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1))) | (0x1 << N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS);
+
+  //
+  // Get GPIO direction (GPIORxDis and GPIOTxDis)
+  //
+  GpioConfig->Direction = ((PadCfgDwReg[0] & (B_GPIO_PCR_RXDIS | B_GPIO_PCR_TXDIS)) >> (N_GPIO_PCR_TXDIS - (N_GPIO_DIRECTION_DIR_BIT_POS + 1))) | (0x1 << N_GPIO_DIRECTION_DIR_BIT_POS);
+
+  //
+  // Get GPIO input inversion (RXINV)
+  // (Only meaningful if input enabled)
+  //
+  if((PadCfgDwReg[0] & B_GPIO_PCR_RXDIS) == 0) {
+    GpioConfig->Direction |= ((PadCfgDwReg[0] & B_GPIO_PCR_RXINV) >> (N_GPIO_PCR_RXINV - (N_GPIO_DIRECTION_INV_BIT_POS + 1))) | (0x1 << N_GPIO_DIRECTION_INV_BIT_POS);
+  }
+
+  //
+  // Get GPIO output state (GPIOTxState)
+  //
+  GpioConfig->OutputState = ((PadCfgDwReg[0] & B_GPIO_PCR_TX_STATE) << (N_GPIO_PCR_TX_STATE + (N_GPIO_OUTPUT_BIT_POS + 1))) | (0x1 << N_GPIO_OUTPUT_BIT_POS);
+
+  //
+  // Configure GPIO RX raw override to '1' (RXRAW1)
+  //
+  GpioConfig->OtherSettings = ((PadCfgDwReg[0] & B_GPIO_PCR_RX_RAW1) >> (N_GPIO_PCR_RX_RAW1 - (N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS + 1))) | (0x1 << N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS);
+
+  //
+  // Get GPIO Pad Mode (PMode)
+  //
+  GpioConfig->PadMode = ((PadCfgDwReg[0] & B_GPIO_PCR_PAD_MODE) >> (N_GPIO_PCR_PAD_MODE - (N_GPIO_PAD_MODE_BIT_POS + 1))) | (0x1 << N_GPIO_PAD_MODE_BIT_POS);
+
+  //
+  // Get GPIO termination (Term)
+  //
+  GpioConfig->ElectricalConfig = ((PadCfgDwReg[1] & B_GPIO_PCR_TERM) >> (N_GPIO_PCR_TERM - (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1))) | (0x1 << N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS);
+}
+
+/**
+  This procedure will read multiple GPIO settings
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[out] GpioData                  GPIO data structure
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetPadConfig (
+  IN  GPIO_PAD               GpioPad,
+  OUT GPIO_CONFIG            *GpioData
+  )
+{
+  UINT32               PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
+  UINT32               RegVal;
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               PadBitPosition;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Read PADCFG DW0 register
+  //
+  PadCfgDwReg[0] = GpioReadPadCfgReg (GpioPad, 0);
+
+  //
+  // Read PADCFG DW1 register
+  //
+  PadCfgDwReg[1] = GpioReadPadCfgReg (GpioPad, 1);
+
+  //
+  // Read PADCFG DW2 register
+  //
+  PadCfgDwReg[2] = GpioReadPadCfgReg (GpioPad, 2);
+
+  GpioConfigFromPadCfgRegValue (
+    GpioPad,
+    PadCfgDwReg,
+    GpioData
+    );
+
+  //
+  // Read HOSTSW_OWN registers
+  //
+  GpioReadReg (
+    GpioHostOwnershipRegister,
+    Group,
+    GPIO_GET_DW_NUM (PadNumber),
+    &RegVal
+    );
+
+  //
+  // Get Host Software Ownership
+  //
+  GpioData->HostSoftPadOwn = (((RegVal >> PadBitPosition) & 0x1) << (N_GPIO_HOSTSW_OWN_BIT_POS + 1)) | (0x1 << N_GPIO_HOSTSW_OWN_BIT_POS);
+
+  //
+  // Read PADCFGLOCK register
+  //
+  GpioReadReg (
+    GpioPadConfigLockRegister,
+    Group,
+    GPIO_GET_DW_NUM (PadNumber),
+    &RegVal
+    );
+
+  //
+  // Get Pad Configuration Lock state
+  //
+  GpioData->LockConfig = ((!((RegVal >> PadBitPosition) & 0x1)) << 1) | BIT0;
+
+  //
+  // Read PADCFGLOCKTX register
+  //
+  GpioReadReg (
+    GpioPadLockOutputRegister,
+    Group,
+    GPIO_GET_DW_NUM (PadNumber),
+    &RegVal
+    );
+
+  //
+  // Get Pad Configuration Lock Tx state
+  //
+  GpioData->LockConfig |= ((!((RegVal >> PadBitPosition) & 0x1)) << 3) | BIT2;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will calculate PADCFG register value based on GpioConfig data
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[in]  GpioConfig                GPIO Configuration data
+  @param[out] PadCfgDwReg               PADCFG DWx register value
+  @param[out] PadCfgDwRegMask           Mask with PADCFG DWx register bits to be modified
+
+  @retval Status
+**/
+EFI_STATUS
+GpioPadCfgRegValueFromGpioConfig (
+  IN  GPIO_PAD           GpioPad,
+  IN  CONST GPIO_CONFIG  *GpioConfig,
+  OUT UINT32             *PadCfgDwReg,
+  OUT UINT32             *PadCfgDwRegMask
+  )
+{
+  UINT32               PadRstCfg;
+
+  //
+  // Configure Reset Type (PadRstCfg)
+  // Reset configuration depends on group type.
+  // This field requires support for new and deprecated settings.
+  //
+  GpioPadRstCfgFromResetConfig (
+    GpioPad,
+    GpioConfig->PowerConfig,
+    &PadRstCfg
+    );
+
+  PadCfgDwRegMask[0] |= ((((GpioConfig->PowerConfig & B_GPIO_RESET_CONFIG_RESET_MASK) >> N_GPIO_RESET_CONFIG_RESET_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_RST_CONF);
+  PadCfgDwReg[0] |= PadRstCfg << N_GPIO_PCR_RST_CONF;
+
+  //
+  // Configure how interrupt is triggered (RxEvCfg)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->InterruptConfig & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >> N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_RX_LVL_EDG);
+  PadCfgDwReg[0] |= (((GpioConfig->InterruptConfig & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >> (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1)) << N_GPIO_PCR_RX_LVL_EDG);
+
+  //
+  // Configure interrupt generation (GPIRoutIOxAPIC/SCI/SMI/NMI)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->InterruptConfig & B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >> N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS) == GpioHardwareDefault)  ? 0x0 : (B_GPIO_PCR_RX_NMI_ROUTE | B_GPIO_PCR_RX_SCI_ROUTE | B_GPIO_PCR_RX_SMI_ROUTE | B_GPIO_PCR_RX_APIC_ROUTE));
+  PadCfgDwReg[0] |= (((GpioConfig->InterruptConfig & B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >> (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1)) << N_GPIO_PCR_RX_NMI_ROUTE);
+
+  //
+  // Configure GPIO direction (GPIORxDis and GPIOTxDis)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->Direction & B_GPIO_DIRECTION_DIR_MASK) >> N_GPIO_DIRECTION_DIR_BIT_POS) == GpioHardwareDefault) ? 0x0 : (B_GPIO_PCR_RXDIS | B_GPIO_PCR_TXDIS));
+  PadCfgDwReg[0] |= (((GpioConfig->Direction & B_GPIO_DIRECTION_DIR_MASK) >> (N_GPIO_DIRECTION_DIR_BIT_POS + 1)) << N_GPIO_PCR_TXDIS);
+
+  //
+  // Configure GPIO input inversion (RXINV)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->Direction & B_GPIO_DIRECTION_INV_MASK) >> N_GPIO_DIRECTION_INV_BIT_POS) == GpioHardwareDefault) ?  0x0 : B_GPIO_PCR_RXINV);
+  PadCfgDwReg[0] |= (((GpioConfig->Direction & B_GPIO_DIRECTION_INV_MASK) >> (N_GPIO_DIRECTION_INV_BIT_POS + 1)) << N_GPIO_PCR_RXINV);
+
+  //
+  // Configure GPIO output state (GPIOTxState)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->OutputState & B_GPIO_OUTPUT_MASK) >> N_GPIO_OUTPUT_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_TX_STATE);
+  PadCfgDwReg[0] |= (((GpioConfig->OutputState & B_GPIO_OUTPUT_MASK) >> (N_GPIO_OUTPUT_BIT_POS + 1)) << N_GPIO_PCR_TX_STATE);
+
+  //
+  // Configure GPIO RX raw override to '1' (RXRAW1)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->OtherSettings & B_GPIO_OTHER_CONFIG_RXRAW_MASK) >> N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_RX_RAW1);
+  PadCfgDwReg[0] |= (((GpioConfig->OtherSettings & B_GPIO_OTHER_CONFIG_RXRAW_MASK) >> (N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS + 1)) << N_GPIO_PCR_RX_RAW1);
+
+  //
+  // Configure GPIO Pad Mode (PMode)
+  //
+  PadCfgDwRegMask[0] |= ((((GpioConfig->PadMode & B_GPIO_PAD_MODE_MASK) >> N_GPIO_PAD_MODE_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_PAD_MODE);
+  PadCfgDwReg[0] |= (((GpioConfig->PadMode & B_GPIO_PAD_MODE_MASK) >> (N_GPIO_PAD_MODE_BIT_POS + 1)) << N_GPIO_PCR_PAD_MODE);
+
+  //
+  // Configure GPIO termination (Term)
+  //
+  PadCfgDwRegMask[1] |= ((((GpioConfig->ElectricalConfig & B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >> N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS) == GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_TERM);
+  PadCfgDwReg[1] |= (((GpioConfig->ElectricalConfig & B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >> (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1)) << N_GPIO_PCR_TERM);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will configure multiple GPIO settings
+
+  @param[in] GpioPad                    GPIO Pad
+  @param[in] GpioData                   GPIO data structure
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetPadConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_CONFIG               *GpioData
+  )
+{
+  EFI_STATUS           Status;
+  UINT32               PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
+  UINT32               PadCfgDwRegMask[GPIO_PADCFG_DW_REG_NUMBER];
+  UINT32               HostSoftOwnReg;
+  UINT32               HostSoftOwnRegMask;
+  UINT32               GpiGpeEnReg;
+  UINT32               GpiGpeEnRegMask;
+  UINT32               GpiNmiEnReg;
+  UINT32               GpiNmiEnRegMask;
+  UINT32               GpiSmiEnReg;
+  UINT32               GpiSmiEnRegMask;
+  GPIO_GROUP           Group;
+  UINT32               GroupIndex;
+  UINT32               PadNumber;
+  UINT32               PadBitPosition;
+  UINT32               DwNum;
+  GPIO_LOCK_CONFIG     LockConfig;
+
+  ZeroMem (PadCfgDwReg, sizeof (PadCfgDwReg));
+  ZeroMem (PadCfgDwRegMask, sizeof (PadCfgDwRegMask));
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check if Pad enabled for SCI is to be in unlocked state
+  //
+  if (((GpioData->InterruptConfig & GpioIntSci) == GpioIntSci) &&
+      ((GpioData->LockConfig & B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK) != GpioPadConfigUnlock)){
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a for SCI is not unlocked!\n", GpioName (GpioPad)));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Get GPIO PADCFG register value from GPIO config data
+  //
+  GpioPadCfgRegValueFromGpioConfig (
+    GpioPad,
+    GpioData,
+    PadCfgDwReg,
+    PadCfgDwRegMask
+    );
+
+  //
+  // Write PADCFG DW0 register
+  //
+  GpioWritePadCfgReg (
+    GpioPad,
+    0,
+    ~PadCfgDwRegMask[0],
+    PadCfgDwReg[0]
+    );
+
+  //
+  // Write PADCFG DW1 register
+  //
+  GpioWritePadCfgReg (
+    GpioPad,
+    1,
+    ~PadCfgDwRegMask[1],
+    PadCfgDwReg[1]
+    );
+
+  //
+  // Write PADCFG DW2 register
+  //
+  GpioWritePadCfgReg (
+    GpioPad,
+    2,
+    ~PadCfgDwRegMask[2],
+    PadCfgDwReg[2]
+    );
+
+  //
+  // Update value to be programmed in HOSTSW_OWN register
+  //
+  if ((GpioData->InterruptConfig & GpioIntSmi) == GpioIntSmi) {
+    HostSoftOwnRegMask = 1 << PadBitPosition;
+    HostSoftOwnReg = 1 << PadBitPosition;
+  } else {
+    HostSoftOwnRegMask = (GpioData->HostSoftPadOwn & 0x1) << PadBitPosition;
+    HostSoftOwnReg = (GpioData->HostSoftPadOwn >> 0x1) << PadBitPosition;
+  }
+
+  //
+  // Write HOSTSW_OWN registers
+  //
+  GpioWriteReg (
+    GpioHostOwnershipRegister,
+    Group,
+    DwNum,
+    ~HostSoftOwnRegMask,
+    HostSoftOwnReg
+    );
+
+  //
+  // Update value to be programmed in GPI_GPE_EN register
+  //
+  GpiGpeEnRegMask = (GpioData->InterruptConfig & 0x1) << PadBitPosition;
+  GpiGpeEnReg = ((GpioData->InterruptConfig & GpioIntSci) >> 3) << PadBitPosition;
+
+  //
+  // Write GPI_GPE_EN registers
+  //
+  GpioWriteReg (
+    GpioGpeEnableRegister,
+    Group,
+    DwNum,
+    ~GpiGpeEnRegMask,
+    GpiGpeEnReg
+    );
+
+  //
+  // Update value to be programmed in GPI_NMI_EN register
+  //
+  GpiNmiEnRegMask = (GpioData->InterruptConfig & 0x1) << PadBitPosition;
+  GpiNmiEnReg = ((GpioData->InterruptConfig & GpioIntNmi) >> 1) << PadBitPosition;
+
+  Status = GpioWriteReg (
+             GpioNmiEnableRegister,
+             Group,
+             DwNum,
+             ~GpiNmiEnRegMask,
+             GpiNmiEnReg
+             );
+  if (Status == EFI_UNSUPPORTED) {
+    if (GpiNmiEnReg == 0) {
+      //
+      // Not all GPIO have NMI capabilities. Since we always try to program this register,
+      // even when not enabling NMI for a pad so do not report such access as an error
+      //
+      Status = EFI_SUCCESS;
+    } else {
+      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads supporting NMI\n", GpioGetGroupName (GroupIndex)));
+      ASSERT (FALSE);
+      return Status;
+    }
+  }
+
+  //
+  // Update value to be programmed in GPI_SMI_EN register
+  //
+  GpiSmiEnRegMask = (GpioData->InterruptConfig & 0x1) << PadBitPosition;
+  GpiSmiEnReg = ((GpioData->InterruptConfig & GpioIntSmi) >> 2) << PadBitPosition;
+
+  Status = GpioWriteReg (
+             GpioSmiEnableRegister,
+             Group,
+             DwNum,
+             ~GpiSmiEnRegMask,
+             GpiSmiEnReg
+             );
+  if (Status == EFI_UNSUPPORTED) {
+    if (GpiSmiEnReg == 0) {
+      //
+      // Not all GPIO have SMI capabilities. Since we always try to program this register,
+      // even when not enabling SMI for a pad so do not report such access as an error
+      //
+      Status = EFI_SUCCESS;
+    } else {
+      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads supporting SMI\n", GpioGetGroupName (GroupIndex)));
+      ASSERT (FALSE);
+      return Status;
+    }
+  }
+
+  //
+  // Store unlock data
+  //
+  if (GpioData->LockConfig != GpioLockDefault) {
+    LockConfig = GpioData->LockConfig & B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK;
+    //
+    // If pad in GpioMode is an output default action should be to leave output unlocked
+    //
+    if ((GpioData->PadMode == GpioPadModeGpio) &&
+      (GpioData->Direction == GpioDirOut) &&
+      ((GpioData->LockConfig & B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) == GpioLockDefault)) {
+      LockConfig |= GpioOutputStateUnlock;
+    } else {
+      LockConfig |= GpioData->LockConfig & B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK;
+    }
+    Status = GpioStoreUnlockData (GpioPad, LockConfig);
+  }
+
+  return Status;
+}
+
+/**
+  This procedure will set GPIO output level
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Output value
+                                  0: OutputLow, 1: OutputHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetOutputValue (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    Value
+  )
+{
+  if (Value > 1) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  GpioWritePadCfgReg (
+    GpioPad,
+    0,
+    (UINT32)~B_GPIO_PCR_TX_STATE,
+    Value << N_GPIO_PCR_TX_STATE
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO output level
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] OutputVal           GPIO Output value
+                                  0: OutputLow, 1: OutputHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetOutputValue (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *OutputVal
+  )
+{
+  UINT32      PadCfgReg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
+
+  *OutputVal = (PadCfgReg & B_GPIO_PCR_TX_STATE) >> N_GPIO_PCR_TX_STATE;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO input level
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] InputVal            GPIO Input value
+                                  0: InputLow, 1: InpuHigh
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetInputValue (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *InputVal
+  )
+{
+  UINT32      PadCfgReg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
+
+  *InputVal = (PadCfgReg & B_GPIO_PCR_RX_STATE) >> N_GPIO_PCR_RX_STATE;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO IOxAPIC interrupt number
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] IrqNum              IRQ number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadIoApicIrqNumber (
+  IN GPIO_PAD                  GpioPad,
+  OUT UINT32                   *IrqNum
+  )
+{
+  UINT32      PadCfgReg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgReg = GpioReadPadCfgReg (GpioPad, 1);
+
+  *IrqNum = (PadCfgReg & B_GPIO_PCR_INTSEL) >> N_GPIO_PCR_INTSEL;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will configure GPIO input inversion
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value for GPIO input inversion
+                                  0: No input inversion, 1: Invert input
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetInputInversion (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    Value
+  )
+{
+  if (Value > 1) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  GpioWritePadCfgReg (
+    GpioPad,
+    0,
+    (UINT32)~B_GPIO_PCR_RXINV,
+    Value << N_GPIO_PCR_RXINV
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO pad input inversion value
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] InvertState         GPIO inversion state
+                                  0: No input inversion, 1: Inverted input
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetInputInversion (
+  IN  GPIO_PAD                 GpioPad,
+  OUT UINT32                   *InvertState
+  )
+{
+  UINT32      PadCfgReg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
+
+  *InvertState = (PadCfgReg & B_GPIO_PCR_RXINV) >> N_GPIO_PCR_RXINV;
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will set GPIO interrupt settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of Level/Edge
+                                  use GPIO_INT_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadInterruptConfig (
+  IN GPIO_PAD                 GpioPad,
+  IN GPIO_INT_CONFIG          Value
+  )
+{
+  EFI_STATUS  Status;
+  UINT32      RxLvlEdgeValue;
+  UINT32      IntRouteValue;
+  UINT32      PadNumber;
+  UINT32      GpeEnable;
+  UINT32      NmiEnable;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = EFI_SUCCESS;
+
+  if (((Value & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >> N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS) != GpioHardwareDefault) {
+    RxLvlEdgeValue = ((Value & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >> (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1)) << N_GPIO_PCR_RX_LVL_EDG;
+
+    GpioWritePadCfgReg (
+      GpioPad,
+      0,
+      (UINT32)~B_GPIO_PCR_RX_LVL_EDG,
+      RxLvlEdgeValue
+      );
+  }
+
+  if (((Value & B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >> N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS) != GpioHardwareDefault) {
+
+    IntRouteValue = ((Value & B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >> (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1)) << N_GPIO_PCR_RX_NMI_ROUTE;
+
+    GpioWritePadCfgReg (
+      GpioPad,
+      0,
+      (UINT32)~(B_GPIO_PCR_RX_NMI_ROUTE | B_GPIO_PCR_RX_SCI_ROUTE | B_GPIO_PCR_RX_SMI_ROUTE | B_GPIO_PCR_RX_APIC_ROUTE),
+      IntRouteValue
+      );
+
+    if ((Value & GpioIntSci) == GpioIntSci) {
+      GpeEnable = 0x1;
+    } else {
+      GpeEnable = 0x0;
+    }
+
+    PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+    GpioWriteReg (
+      GpioGpeEnableRegister,
+      GpioGetGroupFromGpioPad (GpioPad),
+      GPIO_GET_DW_NUM (PadNumber),
+      ~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
+      GpeEnable << GPIO_GET_PAD_POSITION (PadNumber)
+      );
+
+    if ((Value & GpioIntNmi) == GpioIntNmi) {
+      NmiEnable = 0x1;
+    } else {
+      NmiEnable = 0x0;
+    }
+
+    Status = GpioWriteReg (
+               GpioNmiEnableRegister,
+               GpioGetGroupFromGpioPad (GpioPad),
+               GPIO_GET_DW_NUM (PadNumber),
+               ~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
+               NmiEnable << GPIO_GET_PAD_POSITION (PadNumber)
+               );
+    if (Status == EFI_UNSUPPORTED) {
+      if (NmiEnable == 0) {
+        //
+        // Not all GPIO have NMI capabilities. Since we always try to program this register,
+        // even when not enabling NMI for a pad so do not report such access as an error
+        //
+        return EFI_SUCCESS;
+      } else {
+        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads supporting NMI\n", GpioGetGroupName (GpioGetGroupIndexFromGpioPad (GpioPad))));
+      }
+    }
+    ASSERT_EFI_ERROR (Status);
+  }
+
+  return Status;
+}
+
+/**
+  This procedure will set GPIO electrical settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of termination
+                                  use GPIO_ELECTRICAL_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadElectricalConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_ELECTRICAL_CONFIG    Value
+  )
+{
+  UINT32      TermValue;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (((Value & B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >> N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS) != GpioHardwareDefault) {
+    TermValue = ((Value & B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >> (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1)) << N_GPIO_PCR_TERM;
+
+    GpioWritePadCfgReg (
+      GpioPad,
+      1,
+      (UINT32)~B_GPIO_PCR_TERM,
+      TermValue
+      );
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will set GPIO Reset settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value for Pad Reset Configuration
+                                  use GPIO_RESET_CONFIG as argument
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetPadResetConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_RESET_CONFIG         Value
+  )
+{
+  UINT32      PadRstCfg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (((Value & B_GPIO_RESET_CONFIG_RESET_MASK) >> N_GPIO_RESET_CONFIG_RESET_BIT_POS) != GpioHardwareDefault) {
+
+    //
+    // Reset configuration depends on group type.
+    // This field requires support for new and deprecated settings.
+    //
+    GpioPadRstCfgFromResetConfig (
+      GpioPad,
+      Value,
+      &PadRstCfg
+      );
+
+    GpioWritePadCfgReg (
+      GpioPad,
+      0,
+      (UINT32)~B_GPIO_PCR_RST_CONF,
+      PadRstCfg << N_GPIO_PCR_RST_CONF
+      );
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO Reset settings
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] Value                Value of Pad Reset Configuration
+                                  based on GPIO_RESET_CONFIG
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadResetConfig (
+  IN GPIO_PAD                  GpioPad,
+  IN GPIO_RESET_CONFIG         *Value
+  )
+{
+  UINT32      PadRstCfg;
+  UINT32      PadCfgDw0Reg;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgDw0Reg = GpioReadPadCfgReg (GpioPad, 0);
+
+  //
+  // Get Reset Type (PadRstCfg)
+  //
+  PadRstCfg = (PadCfgDw0Reg & B_GPIO_PCR_RST_CONF) >> N_GPIO_PCR_RST_CONF;
+
+  *Value = GpioResetConfigFromPadRstCfg (
+             GpioPad,
+             PadRstCfg
+             );
+
+  return EFI_SUCCESS;
+}
+
+
+/**
+  This procedure will get Gpio Pad Host Software Ownership
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] PadHostSwOwn        Value of Host Software Pad Owner
+                                  0: ACPI Mode, 1: GPIO Driver mode
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetHostSwOwnershipForPad (
+  IN GPIO_PAD                 GpioPad,
+  OUT UINT32                  *PadHostSwOwn
+  )
+{
+  UINT32      PadNumber;
+  UINT32      HostSwRegVal;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioReadReg (
+    GpioHostOwnershipRegister,
+    GpioGetGroupFromGpioPad (GpioPad),
+    GPIO_GET_DW_NUM (PadNumber),
+    &HostSwRegVal
+    );
+
+  *PadHostSwOwn = (HostSwRegVal >> GPIO_GET_PAD_POSITION (PadNumber)) & 0x1;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will set Gpio Pad Host Software Ownership
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] PadHostSwOwn         Pad Host Software Owner
+                                  0: ACPI Mode, 1: GPIO Driver mode
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioSetHostSwOwnershipForPad (
+  IN GPIO_PAD                  GpioPad,
+  IN UINT32                    PadHostSwOwn
+  )
+{
+  UINT32      PadNumber;
+
+  if (!GpioIsPadValid (GpioPad) || (PadHostSwOwn > 1)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  return GpioWriteReg (
+           GpioHostOwnershipRegister,
+           GpioGetGroupFromGpioPad (GpioPad),
+           GPIO_GET_DW_NUM (PadNumber),
+           (UINT32)~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
+           PadHostSwOwn << GPIO_GET_PAD_POSITION (PadNumber)
+           );
+}
+
+/**
+  This procedure will get Gpio Pad Ownership
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] PadOwnVal           Value of Pad Ownership
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetPadOwnership (
+  IN  GPIO_PAD                GpioPad,
+  OUT GPIO_PAD_OWN            *PadOwnVal
+  )
+{
+  UINT32                 Mask;
+  UINT32                 RegOffset;
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 PadOwnRegValue;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  //
+  // Calculate RegOffset using Pad Ownership offset and GPIO Pad number.
+  // One DWord register contains information for 8 pads.
+  //
+  RegOffset = GpioGroupInfo[GroupIndex].PadOwnOffset + (PadNumber >> 3) * 0x4;
+
+  //
+  // Calculate pad bit position within DWord register
+  //
+  PadNumber %= 8;
+  Mask = (BIT1 | BIT0) << (PadNumber * 4);
+
+  PadOwnRegValue = MmioRead32 (PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, RegOffset));
+
+  *PadOwnVal = (GPIO_PAD_OWN) ((PadOwnRegValue & Mask) >> (PadNumber * 4));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will check state of Pad Config Lock for pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] PadCfgLockRegVal    Value of PadCfgLock register
+                                  Bit position - PadNumber
+                                  Bit value - 0: NotLocked, 1: Locked
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioGetPadCfgLockForGroupDw (
+  IN  GPIO_GROUP                  Group,
+  IN  UINT32                      DwNum,
+  OUT UINT32                      *PadCfgLockRegVal
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioReadReg (
+           GpioPadConfigLockRegister,
+           Group,
+           DwNum,
+           PadCfgLockRegVal
+           );
+}
+
+/**
+  This procedure will check state of Pad Config Lock for selected pad
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] PadCfgLock          PadCfgLock for selected pad
+                                  0: NotLocked, 1: Locked
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadCfgLock (
+  IN GPIO_PAD                   GpioPad,
+  OUT UINT32                    *PadCfgLock
+  )
+{
+  UINT32      PadNumber;
+  UINT32      PadCfgLockRegVal;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioReadReg (
+    GpioPadConfigLockRegister,
+    GpioGetGroupFromGpioPad (GpioPad),
+    GPIO_GET_DW_NUM (PadNumber),
+    &PadCfgLockRegVal
+    );
+
+  *PadCfgLock = (PadCfgLockRegVal >> GPIO_GET_PAD_POSITION (PadNumber)) & 0x1;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will check state of Pad Config Tx Lock for pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLockTx register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[out] PadCfgLockTxRegVal  Value of PadCfgLockTx register
+                                  Bit position - PadNumber
+                                  Bit value - 0: NotLockedTx, 1: LockedTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioGetPadCfgLockTxForGroupDw (
+  IN  GPIO_GROUP                  Group,
+  IN  UINT32                      DwNum,
+  OUT UINT32                      *PadCfgLockTxRegVal
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioReadReg (
+           GpioPadLockOutputRegister,
+           Group,
+           DwNum,
+           PadCfgLockTxRegVal
+           );
+}
+
+/**
+  This procedure will check state of Pad Config Tx Lock for selected pad
+
+  @param[in] GpioPad              GPIO pad
+  @param[out] PadCfgLock          PadCfgLockTx for selected pad
+                                  0: NotLockedTx, 1: LockedTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadCfgLockTx (
+  IN GPIO_PAD                   GpioPad,
+  OUT UINT32                    *PadCfgLockTx
+  )
+{
+  UINT32      PadNumber;
+  UINT32      PadCfgLockTxRegVal;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioReadReg (
+    GpioPadLockOutputRegister,
+    GpioGetGroupFromGpioPad (GpioPad),
+    GPIO_GET_DW_NUM (PadNumber),
+    &PadCfgLockTxRegVal
+    );
+
+  *PadCfgLockTx = (PadCfgLockTxRegVal >> GPIO_GET_PAD_POSITION (PadNumber)) & 0x1;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will clear PadCfgLock for selected pads within one group.
+  This function should be used only inside SMI.
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToUnlock        Bitmask for pads which are going to be unlocked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotUnlock, 1: Unlock
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfgForGroupDw (
+  IN GPIO_GROUP                Group,
+  IN UINT32                    DwNum,
+  IN UINT32                    PadsToUnlock
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioWriteLockReg (
+           GpioPadConfigLockRegister,
+           Group,
+           DwNum,
+           ~PadsToUnlock,
+           0
+           );
+}
+
+/**
+  This procedure will clear PadCfgLock for selected pad.
+  This function should be used only inside SMI.
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfg (
+  IN GPIO_PAD                   GpioPad
+  )
+{
+  GPIO_GROUP   Group;
+  UINT32       PadNumber;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  return GpioUnlockPadCfgForGroupDw (
+           Group,
+           GPIO_GET_DW_NUM (PadNumber),
+           1 << GPIO_GET_PAD_POSITION (PadNumber)
+           );
+}
+
+/**
+  This procedure will set PadCfgLock for selected pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLock          Bitmask for pads which are going to be locked
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotLock, 1: Lock
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioLockPadCfgForGroupDw (
+  IN GPIO_GROUP                   Group,
+  IN UINT32                       DwNum,
+  IN UINT32                       PadsToLock
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioWriteLockReg (
+           GpioPadConfigLockRegister,
+           Group,
+           DwNum,
+           ~0u,
+           PadsToLock
+           );
+}
+
+/**
+  This procedure will set PadCfgLock for selected pad
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioLockPadCfg (
+  IN GPIO_PAD                   GpioPad
+  )
+{
+  GPIO_GROUP   Group;
+  UINT32       PadNumber;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  return GpioLockPadCfgForGroupDw (
+           Group,
+           GPIO_GET_DW_NUM (PadNumber),
+           1 << GPIO_GET_PAD_POSITION (PadNumber)
+           );
+}
+
+/**
+  This procedure will clear PadCfgLockTx for selected pads within one group.
+  This function should be used only inside SMI.
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLockTx register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToUnlockTx      Bitmask for pads which are going to be unlocked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotUnLockTx, 1: LockTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfgTxForGroupDw (
+  IN GPIO_GROUP                Group,
+  IN UINT32                    DwNum,
+  IN UINT32                    PadsToUnlockTx
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioWriteLockReg (
+           GpioPadLockOutputRegister,
+           Group,
+           DwNum,
+           ~PadsToUnlockTx,
+           0
+           );
+}
+
+/**
+  This procedure will clear PadCfgLockTx for selected pad.
+  This function should be used only inside SMI.
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioUnlockPadCfgTx (
+  IN GPIO_PAD                   GpioPad
+  )
+{
+  GPIO_GROUP   Group;
+  UINT32       PadNumber;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  return GpioUnlockPadCfgTxForGroupDw (
+           Group,
+           GPIO_GET_DW_NUM (PadNumber),
+           1 << GPIO_GET_PAD_POSITION (PadNumber)
+           );
+}
+
+/**
+  This procedure will set PadCfgLockTx for selected pads within one group
+
+  @param[in]  Group               GPIO group
+  @param[in]  DwNum               PadCfgLock register number for current group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  PadsToLockTx        Bitmask for pads which are going to be locked,
+                                  Bit position - PadNumber
+                                  Bit value - 0: DoNotLockTx, 1: LockTx
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter number
+**/
+EFI_STATUS
+GpioLockPadCfgTxForGroupDw (
+  IN GPIO_GROUP                   Group,
+  IN UINT32                       DwNum,
+  IN UINT32                       PadsToLockTx
+  )
+{
+  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return GpioWriteLockReg (
+           GpioPadLockOutputRegister,
+           Group,
+           DwNum,
+           ~0u,
+           PadsToLockTx
+           );
+}
+
+/**
+  This procedure will set PadCfgLockTx for selected pad
+
+  @param[in] GpioPad              GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioLockPadCfgTx (
+  IN GPIO_PAD                   GpioPad
+  )
+{
+  GPIO_GROUP   Group;
+  UINT32       PadNumber;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  return GpioLockPadCfgTxForGroupDw (
+           Group,
+           GPIO_GET_DW_NUM (PadNumber),
+           1 << GPIO_GET_PAD_POSITION (PadNumber)
+           );
+}
+
+/**
+  This procedure will get Group to GPE mapping.
+  It will assume that only first 32 pads can be mapped to GPE.
+  To handle cases where groups have more than 32 pads and higher part of group
+  can be mapped please refer to GpioGetGroupDwToGpeDwX()
+
+  @param[out] GroupToGpeDw0       GPIO group to be mapped to GPE_DW0
+  @param[out] GroupToGpeDw1       GPIO group to be mapped to GPE_DW1
+  @param[out] GroupToGpeDw2       GPIO group to be mapped to GPE_DW2
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetGroupToGpeDwX (
+  IN GPIO_GROUP               *GroupToGpeDw0,
+  IN GPIO_GROUP               *GroupToGpeDw1,
+  IN GPIO_GROUP               *GroupToGpeDw2
+  )
+{
+  UINT32     GroupDw[3];
+  UINT32     Index;
+  EFI_STATUS Status;
+
+  Status = GpioGetGroupDwToGpeDwX (
+             GroupToGpeDw0,
+             &GroupDw[0],
+             GroupToGpeDw1,
+             &GroupDw[1],
+             GroupToGpeDw2,
+             &GroupDw[2]
+             );
+
+  for (Index = 0; Index < ARRAY_SIZE (GroupDw); Index++) {
+    if (GroupDw[Index] != 0) {
+      Status = EFI_UNSUPPORTED;
+      ASSERT (FALSE);
+    }
+  }
+  return Status;
+}
+
+/**
+  This procedure will get Group to GPE mapping. If group has more than 32 bits
+  it is possible to map only single DW of pins (e.g. 0-31, 32-63) because
+  ACPI GPE_DWx register is 32 bits large.
+
+  @param[out]  GroupToGpeDw0       GPIO group mapped to GPE_DW0
+  @param[out]  GroupDwForGpeDw0    DW of pins mapped to GPE_DW0
+  @param[out]  GroupToGpeDw1       GPIO group mapped to GPE_DW1
+  @param[out]  GroupDwForGpeDw1    DW of pins mapped to GPE_DW1
+  @param[out]  GroupToGpeDw2       GPIO group mapped to GPE_DW2
+  @param[out]  GroupDwForGpeDw2    DW of pins mapped to GPE_DW2
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetGroupDwToGpeDwX (
+  OUT GPIO_GROUP                *GroupToGpeDw0,
+  OUT UINT32                    *GroupDwForGpeDw0,
+  OUT GPIO_GROUP                *GroupToGpeDw1,
+  OUT UINT32                    *GroupDwForGpeDw1,
+  OUT GPIO_GROUP                *GroupToGpeDw2,
+  OUT UINT32                    *GroupDwForGpeDw2
+  )
+{
+  UINT32                     PmcGpeDwXValue[3];
+  GPIO_GROUP                 GroupToGpeDwX[3];
+  UINT32                     GroupDwForGpeDwX[3];
+  UINT8                      GpeDwXIndex;
+  UINT32                     Index;
+  GPIO_GROUP_TO_GPE_MAPPING  *GpioGpeMap;
+  UINT32                     GpioGpeMapLength;
+
+  ZeroMem (GroupToGpeDwX, sizeof (GroupToGpeDwX));
+  ZeroMem (GroupDwForGpeDwX, sizeof (GroupDwForGpeDwX));
+
+  PmcGetGpioGpe (&PmcGpeDwXValue[0], &PmcGpeDwXValue[1], &PmcGpeDwXValue[2]);
+  GpioGetGroupToGpeMapping (&GpioGpeMap, &GpioGpeMapLength);
+  for (GpeDwXIndex = 0; GpeDwXIndex < 3; GpeDwXIndex++) {
+    for (Index = 0; Index < GpioGpeMapLength; Index++) {
+
+      if (GpioGpeMap[Index].PmcGpeDwxVal == PmcGpeDwXValue[GpeDwXIndex]) {
+        GroupToGpeDwX[GpeDwXIndex] = GpioGpeMap[Index].Group;
+        GroupDwForGpeDwX[GpeDwXIndex] = GpioGpeMap[Index].GroupDw;
+        break;
+      }
+    }
+  }
+
+  if ((GroupToGpeDwX[0] == 0) ||
+      (GroupToGpeDwX[1] == 0) ||
+      (GroupToGpeDwX[2] == 0)) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  *GroupToGpeDw0 = GroupToGpeDwX[0];
+  *GroupDwForGpeDw0 = GroupDwForGpeDwX[0];
+  *GroupToGpeDw1 = GroupToGpeDwX[1];
+  *GroupDwForGpeDw1 = GroupDwForGpeDwX[1];
+  *GroupToGpeDw2 = GroupToGpeDwX[2];
+  *GroupDwForGpeDw2 = GroupDwForGpeDwX[2];
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPE number for provided GpioPad.
+  PCH allows to configure mapping between GPIO groups and related GPE (GpioSetGroupToGpeDwX())
+  what results in the fact that certain Pad can cause different General Purpose Event. Only three
+  GPIO groups can be mapped to cause unique GPE (1-tier), all others groups will be under one common
+  event (GPE_111 for 2-tier).
+
+  1-tier:
+  Returned GpeNumber is in range <0,95>. GpioGetGpeNumber() can be used
+  to determine what _LXX ACPI method would be called on event on selected GPIO pad
+
+  2-tier:
+  Returned GpeNumber is 0x6F (111). All GPIO pads which are not mapped to 1-tier GPE
+  will be under one master GPE_111 which is linked to _L6F ACPI method. If it is needed to determine
+  what Pad from 2-tier has caused the event, _L6F method should check GPI_GPE_STS and GPI_GPE_EN
+  registers for all GPIO groups not mapped to 1-tier GPE.
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpeNumber           GPE number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpeNumber (
+  IN  GPIO_PAD                  GpioPad,
+  OUT UINT32                    *GpeNumber
+  )
+{
+  GPIO_GROUP           GroupToGpeDwX[3];
+  UINT32               GroupDw[3];
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               Index;
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Get GPIO groups mapping to 1-tier GPE
+  // This mapping is dependent on GPIO IP implementation
+  // and may change between chipset generations
+  //
+  GpioGetGroupDwToGpeDwX (
+    &GroupToGpeDwX[0], &GroupDw[0],
+    &GroupToGpeDwX[1], &GroupDw[1],
+    &GroupToGpeDwX[2], &GroupDw[2]
+    );
+
+  //
+  // Check if pad is routed to 1-Tier GPE
+  //
+  for (Index = 0; Index < 3; Index++) {
+    if ((Group == GroupToGpeDwX[Index]) && (PadNumber >= (32 * GroupDw[Index])) && (PadNumber < (32 * (GroupDw[Index] + 1)))) {
+      *GpeNumber = PadNumber + (32 * Index) - (32 * GroupDw[Index]);
+      return EFI_SUCCESS;
+    }
+  }
+
+  //
+  // If Group number doesn't match any of above then
+  // it means that the pad is routed to 2-tier GPE
+  // which corresponds to  GPE_111 (0x6F)
+  //
+  *GpeNumber = PCH_GPIO_2_TIER_MASTER_GPE_NUMBER;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure is used to clear SMI STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioClearGpiSmiSts (
+  IN GPIO_PAD                   GpioPad
+  )
+{
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               DwNum;
+  UINT32               PadBitPosition;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+
+  //
+  // Clear GPI SMI Status bit by writing '1'
+  //
+  return GpioWriteReg (
+           GpioSmiStatusRegister,
+           Group,
+           DwNum,
+           0u,
+           (UINT32) (BIT0 << PadBitPosition)
+           );
+}
+
+/**
+  This procedure is used by PchSmiDispatcher and will clear
+  all GPI SMI Status bits
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioClearAllGpiSmiSts (
+  VOID
+  )
+{
+  UINT32         DwNum;
+  GPIO_GROUP     Group;
+  GPIO_GROUP     GroupMin;
+  GPIO_GROUP     GroupMax;
+
+  GroupMin = GpioGetLowestGroup ();
+  GroupMax = GpioGetHighestGroup ();
+
+  for (Group = GroupMin; Group <= GroupMax; Group++) {
+    //
+    // Clear all GPI SMI STS
+    //
+    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGetPadPerGroup (Group)); DwNum++) {
+      GpioWriteReg (
+        GpioSmiStatusRegister,
+        Group,
+        DwNum,
+        0u,
+        0xFFFFFFFF
+        );
+    }
+  }
+  return EFI_SUCCESS;
+
+}
+
+/**
+  This procedure is used to disable all GPI SMI
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioDisableAllGpiSmi (
+  VOID
+  )
+{
+  UINT32         DwNum;
+  GPIO_GROUP     Group;
+  GPIO_GROUP     GroupMin;
+  GPIO_GROUP     GroupMax;
+  UINT32         SmiEnRegVal;
+
+  GroupMin = GpioGetLowestGroup ();
+  GroupMax = GpioGetHighestGroup ();
+
+  for (Group = GroupMin; Group <= GroupMax; Group++) {
+    //
+    // Disable all GPI SMI
+    //
+    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM (GpioGetPadPerGroup (Group)); DwNum++) {
+      //
+      // Check which pins have SMI_EN set
+      //
+      GpioReadReg (
+        GpioSmiEnableRegister,
+        Group,
+        DwNum,
+        &SmiEnRegVal
+        );
+      //
+      // Set HOSTSW_OWN to GPIO mode (1) for those pins to disable SMI capability
+      //
+      GpioWriteReg (
+        GpioHostOwnershipRegister,
+        Group,
+        DwNum,
+        ~0u,
+        SmiEnRegVal
+        );
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure is used to register GPI SMI dispatch function.
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpiNum              GPI number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiSmiNum (
+  IN GPIO_PAD          GpioPad,
+  OUT UINTN            *GpiNum
+  )
+{
+  UINT32                 GroupIndex;
+  UINT32                 Index;
+  UINT32                 PadNumber;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  *GpiNum = 0;
+
+  for (Index = 0; Index < GroupIndex; Index++) {
+    *GpiNum += (UINTN) (GpioGroupInfo[Index].PadPerGroup);
+  }
+  *GpiNum += (UINTN) PadNumber;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure is used to check GPIO inputs belongs to 2 tier or 1 tier architecture
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval     Data                0 means 1-tier, 1 means 2-tier
+**/
+BOOLEAN
+GpioCheckFor2Tier (
+  IN GPIO_PAD                  GpioPad
+  )
+{
+  UINT32               Data32;
+
+  GpioGetGpeNumber (GpioPad, &Data32);
+  if (Data32 == PCH_GPIO_2_TIER_MASTER_GPE_NUMBER) {
+    return TRUE;
+  }
+
+  return FALSE;
+}
+
+/**
+  This procedure is used to clear GPE STS for a specified GpioPad
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioClearGpiGpeSts (
+  IN GPIO_PAD                  GpioPad
+  )
+{
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               DwNum;
+  UINT32               PadBitPosition;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check for 2-tier
+  //
+  if (!(GpioCheckFor2Tier (GpioPad))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+
+  //
+  // Clear GPI GPE Status bit by writing '1'
+  //
+  return GpioWriteReg (
+           GpioGpeStatusRegister,
+           Group,
+           DwNum,
+           0u,
+           (UINT32) (BIT0 << PadBitPosition)
+           );
+}
+
+/**
+  This procedure is used to read GPE STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] GpeSts              Gpe status for given pad
+                                  The GpeSts is true if the status register is set for given Pad number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiGpeSts (
+  IN GPIO_PAD                  GpioPad,
+  OUT BOOLEAN                  *GpeSts
+  )
+{
+  UINT32               GpeStsRegVal;
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               DwNum;
+  UINT32               PadBitPosition;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check for 2-tier
+  //
+  if (!(GpioCheckFor2Tier (GpioPad))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+
+  //
+  // Read GPI GPE Status bits
+  //
+  GpioReadReg (
+    GpioGpeStatusRegister,
+    Group,
+    DwNum,
+    &GpeStsRegVal
+    );
+
+  *GpeSts = ((GpeStsRegVal >> PadBitPosition) & 0x1) != 0;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure is used to get SMI STS for a specified Pad
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] SmiSts              Smi status for given pad
+                                  The SmiSts is true if the status register is set for given Pad number
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetGpiSmiSts (
+  IN GPIO_PAD                   GpioPad,
+  OUT BOOLEAN                   *SmiSts
+  )
+{
+  GPIO_GROUP           Group;
+  UINT32               PadNumber;
+  UINT32               DwNum;
+  UINT32               PadBitPosition;
+  UINT32               SmiStsRegister;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Group = GpioGetGroupFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  DwNum = GPIO_GET_DW_NUM (PadNumber);
+  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
+
+  //
+  // Read the SMI Register
+  //
+  GpioReadReg (
+    GpioSmiStatusRegister,
+    Group,
+    DwNum,
+    &SmiStsRegister
+    );
+
+  *SmiSts = (SmiStsRegister & (BIT0 << PadBitPosition)) != 0;
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLibrary.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLibrary.h
new file mode 100644
index 0000000000..d197ee4898
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioLibrary.h
@@ -0,0 +1,82 @@
+/** @file
+  Header file for GPIO Lib implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _GPIO_LIBRARY_H_
+#define _GPIO_LIBRARY_H_
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/GpioLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SataLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PchSbiAccessLib.h>
+#include <Library/PmcPrivateLib.h>
+#include <Library/GpioHelpersLib.h>
+#include <Register/GpioRegs.h>
+
+//
+// Number of PADCFG_DW registers
+//
+#define GPIO_PADCFG_DW_REG_NUMBER  4
+
+/**
+  This internal procedure will calculate GPIO_RESET_CONFIG value  (new type)
+  based on provided PadRstCfg for a specific GPIO Pad.
+
+  @param[in]  GpioPad               GPIO Pad
+  @param[in]  PadRstCfg             GPIO PadRstCfg value
+
+  @retval GpioResetConfig           GPIO Reset configuration (new type)
+**/
+GPIO_RESET_CONFIG
+GpioResetConfigFromPadRstCfg (
+  IN  GPIO_PAD           GpioPad,
+  IN  UINT32             PadRstCfg
+  );
+
+/**
+  This internal procedure will calculate PadRstCfg register value based
+  on provided GPIO Reset configuration for a certain pad.
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[in]  GpioResetConfig           GPIO Reset configuration
+  @param[out] PadRstCfg                 GPIO PadRstCfg value
+
+  @retval EFI_SUCCESS                   The function completed successfully
+  @retval EFI_INVALID_PARAMETER         Invalid configuration
+**/
+EFI_STATUS
+GpioPadRstCfgFromResetConfig (
+  IN  GPIO_PAD           GpioPad,
+  IN  GPIO_RESET_CONFIG  GpioResetConfig,
+  OUT UINT32             *PadRstCfg
+  );
+
+/**
+  This procedure will calculate PADCFG register value based on GpioConfig data
+
+  @param[in]  GpioPad                   GPIO Pad
+  @param[in]  GpioConfig                GPIO Configuration data
+  @param[out] PadCfgDwReg               PADCFG DWx register value
+  @param[out] PadCfgDwRegMask           Mask with PADCFG DWx register bits to be modified
+
+  @retval Status
+**/
+EFI_STATUS
+GpioPadCfgRegValueFromGpioConfig (
+  IN  GPIO_PAD           GpioPad,
+  IN  CONST GPIO_CONFIG  *GpioConfig,
+  OUT UINT32             *PadCfgDwReg,
+  OUT UINT32             *PadCfgDwRegMask
+  );
+
+#endif // _GPIO_LIBRARY_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNames.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNames.c
new file mode 100644
index 0000000000..d21e77ba60
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNames.c
@@ -0,0 +1,86 @@
+/** @file
+  This file contains GPIO name library implementation
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include "GpioLibrary.h"
+#include <Library/PrintLib.h>
+
+/**
+  Generates GPIO group name from GpioPad
+
+  @param[in] GpioPad  GpioPad
+
+  @retval CHAR8*  Pointer to the GPIO group name
+**/
+CONST
+CHAR8*
+GpioGetGroupName (
+  IN UINT32  GroupIndex
+  )
+{
+  CONST GPIO_GROUP_NAME_INFO*  GroupNameInfo;
+
+  GroupNameInfo = GpioGetGroupNameInfo (GroupIndex);
+  if (GroupNameInfo == NULL) {
+    return NULL;
+  } else {
+    return GroupNameInfo->GpioGroupPrefix;
+  }
+}
+
+/**
+  Generates GPIO name from GpioPad
+
+  @param[in]  GpioPad             GpioPad
+  @param[out] GpioNameBuffer      Caller allocated buffer of GPIO_NAME_LENGTH_MAX size
+  @param[in]  GpioNameBufferSize  Size of the buffer
+
+  @retval CHAR8*  Pointer to the GPIO name
+**/
+CHAR8*
+GpioGetPadName (
+  IN GPIO_PAD  GpioPad,
+  OUT CHAR8*   GpioNameBuffer,
+  IN UINT32    GpioNameBufferSize
+  )
+{
+  UINT32                       GroupIndex;
+  UINT32                       PadNumber;
+  UINT32                       FirstUniquePadNumber;
+  CONST GPIO_GROUP_NAME_INFO*  GroupNameInfo;
+
+  if (GpioNameBuffer == NULL) {
+    ASSERT (FALSE);
+    return NULL;
+  }
+  if ((GpioNameBufferSize < GPIO_NAME_LENGTH_MAX) || !GpioIsPadValid (GpioPad)) {
+    ASSERT (FALSE);
+    *GpioNameBuffer = 0;
+    return NULL;
+  }
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  GroupNameInfo = GpioGetGroupNameInfo (GroupIndex);
+  if (GroupNameInfo == NULL) {
+    return NULL;
+  }
+
+  FirstUniquePadNumber = GpioGetPadNumberFromGpioPad (GroupNameInfo->FirstUniqueGpio);
+  if ((PadNumber < FirstUniquePadNumber) || (GroupNameInfo->GroupUniqueNames == NULL)) {
+    AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX, "GPIO_%a%d", GpioGetGroupName (GroupIndex), PadNumber);
+  } else {
+    if ((PadNumber - FirstUniquePadNumber) < GroupNameInfo->UniqueNamesTableSize) {
+      AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX, "GPIO_%a", GroupNameInfo->GroupUniqueNames[PadNumber - FirstUniquePadNumber]);
+    } else {
+      AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX, "GPIO_%08X", GpioPad);
+      ASSERT (FALSE);
+    }
+  }
+
+  return GpioNameBuffer;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNativeLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNativeLib.c
new file mode 100644
index 0000000000..97244c665b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/GpioNativeLib.c
@@ -0,0 +1,193 @@
+/** @file
+  This file contains routines for GPIO native and chipset specific usage
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "GpioLibrary.h"
+
+/**
+  This procedure will get number of pads for certain GPIO group
+
+  @param[in] Group            GPIO group number
+
+  @retval Value               Pad number for group
+                              If illegal group number then return 0
+**/
+UINT32
+GpioGetPadPerGroup (
+  IN GPIO_GROUP      Group
+  )
+{
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 GroupIndex;
+  //
+  // Check if group argument exceeds GPIO GROUP INFO array
+  //
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+  GroupIndex = GpioGetGroupIndexFromGroup (Group);
+
+  if ((UINTN) GroupIndex >= GpioGroupInfoLength) {
+    return 0;
+  } else {
+    return GpioGroupInfo[GroupIndex].PadPerGroup;
+  }
+}
+
+/**
+  This procedure will get number of groups
+
+  @param[in] none
+
+  @retval Value               Group number
+**/
+UINT32
+GpioGetNumberOfGroups (
+  VOID
+  )
+{
+  UINT32                 GpioGroupInfoLength;
+
+  GpioGetGroupInfoTable (&GpioGroupInfoLength);
+  return GpioGroupInfoLength;
+}
+/**
+  This procedure will get lowest group
+
+  @param[in] none
+
+  @retval Value               Lowest Group
+**/
+GPIO_GROUP
+GpioGetLowestGroup (
+  VOID
+  )
+{
+  return GpioGetGroupFromGroupIndex (0);
+}
+/**
+  This procedure will get highest group
+
+  @param[in] none
+
+  @retval Value               Highest Group
+**/
+GPIO_GROUP
+GpioGetHighestGroup (
+  VOID
+  )
+{
+  return GpioGetGroupFromGroupIndex (GpioGetNumberOfGroups () - 1);
+}
+
+/**
+  This procedure will get group number
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Group number
+**/
+GPIO_GROUP
+GpioGetGroupFromGpioPad (
+  IN GPIO_PAD         GpioPad
+  )
+{
+  return GPIO_GET_GROUP_FROM_PAD (GpioPad);
+}
+
+/**
+  This procedure will get group index (0 based)
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Group Index
+**/
+UINT32
+GpioGetGroupIndexFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  )
+{
+  return (UINT32) GPIO_GET_GROUP_INDEX_FROM_PAD (GpioPad);
+}
+
+/**
+  This procedure will get group index (0 based) from group
+
+  @param[in] GpioGroup        Gpio Group
+
+  @retval Value               Group Index
+**/
+UINT32
+GpioGetGroupIndexFromGroup (
+  IN GPIO_GROUP        GpioGroup
+  )
+{
+  return (UINT32) GPIO_GET_GROUP_INDEX (GpioGroup);
+}
+
+/**
+  This procedure will get group from group index (0 based)
+
+  @param[in] GroupIndex        Group Index
+
+  @retval GpioGroup            Gpio Group
+**/
+GPIO_GROUP
+GpioGetGroupFromGroupIndex (
+  IN UINT32        GroupIndex
+  )
+{
+  return GPIO_GROUP_DEF (GroupIndex, GpioGetThisChipsetId ());
+}
+
+/**
+  This procedure will get pad number (0 based) from Gpio Pad
+
+  @param[in] GpioPad          Gpio Pad
+
+  @retval Value               Pad Number
+**/
+UINT32
+GpioGetPadNumberFromGpioPad (
+  IN GPIO_PAD        GpioPad
+  )
+{
+  return (UINT32) GPIO_GET_PAD_NUMBER (GpioPad);
+}
+/**
+  This procedure will return GpioPad from Group and PadNumber
+
+  @param[in] Group              GPIO group
+  @param[in] PadNumber          GPIO PadNumber
+
+  @retval GpioPad               GpioPad
+**/
+GPIO_PAD
+GpioGetGpioPadFromGroupAndPadNumber (
+  IN GPIO_GROUP      Group,
+  IN UINT32          PadNumber
+  )
+{
+  return GPIO_PAD_DEF (Group,PadNumber);
+}
+
+/**
+  This procedure will return GpioPad from GroupIndex and PadNumber
+
+  @param[in] GroupIndex         GPIO GroupIndex
+  @param[in] PadNumber          GPIO PadNumber
+
+  @retval GpioPad               GpioPad
+**/
+GPIO_PAD
+GpioGetGpioPadFromGroupIndexAndPadNumber (
+  IN UINT32          GroupIndex,
+  IN UINT32          PadNumber
+  )
+{
+  GPIO_GROUP Group;
+
+  Group = GPIO_GROUP_DEF (GroupIndex, GpioGetThisChipsetId ());
+  return GPIO_PAD_DEF (Group, PadNumber);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/PeiDxeSmmGpioLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/PeiDxeSmmGpioLib.inf
new file mode 100644
index 0000000000..0a888a38ba
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/PeiDxeSmmGpioLib.inf
@@ -0,0 +1,49 @@
+## @file
+# Component description file for the PeiDxeSmmGpioLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmGpioLib
+FILE_GUID = 16EC5CA8-8195-4847-B6CB-662BD7B763F2
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = GpioLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PrintLib
+PchCycleDecodingLib
+PchSbiAccessLib
+PmcPrivateLib
+GpioPrivateLib
+SataLib
+GpioHelpersLib
+GpioCheckConflictLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Pcd]
+
+[Sources]
+GpioLib.c
+GpioNativeLib.c
+GpioInit.c
+GpioNames.c
+GpioLibrary.h
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.c
new file mode 100644
index 0000000000..2c7a1987d9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.c
@@ -0,0 +1,119 @@
+/** @file
+  This file contains NULL implementation for GPIO Helpers Lib
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/GpioConfig.h>
+
+/**
+  This procedure stores GPIO pad unlock information
+
+  @param[in] GpioPad         GPIO pad
+  @param[in] GpioLockConfig  GPIO Lock Configuration
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreUnlockData (
+  IN GPIO_PAD             GpioPad,
+  IN GPIO_LOCK_CONFIG     GpioLockConfig
+  )
+{
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure stores GPIO group data about pads which PadConfig needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockPadConfigData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  )
+{
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure stores GPIO group data about pads which Output state needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockOutputData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  )
+{
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO group data with pads, which PadConfig is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockPadConfigMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  )
+{
+  return 0;
+}
+
+/**
+  This procedure will get GPIO group data with pads, which Output is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockOutputMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  )
+{
+  return 0;
+}
+
+/**
+  Returns Gpio Override Level1 Information
+
+  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
+**/
+BOOLEAN
+GpioOverrideLevel1Enabled (
+  VOID
+  )
+{
+  return FALSE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
new file mode 100644
index 0000000000..756359d1e3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
@@ -0,0 +1,26 @@
+## @file
+# Component description file for the NULL GpioHelpersLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = BaseGpioHelpersLib
+FILE_GUID = AB282608-2A50-4AE3-9242-64064ECF40D4
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = GpioHelpersLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+BaseGpioHelpersLibNull.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf
new file mode 100644
index 0000000000..43860b7d20
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf
@@ -0,0 +1,32 @@
+## @file
+# Component description file for the DxeGpioMemLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeGpioNameBufferLib
+FILE_GUID = 16EC6AA8-81D5-4847-B6CB-662CDAB863F2
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+LIBRARY_CLASS = GpioNameBufferLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+[LibraryClasses]
+BaseLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+GpioNameBufferDxe.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/GpioNameBufferDxe.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/GpioNameBufferDxe.c
new file mode 100644
index 0000000000..87dc9a2cd5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/GpioNameBufferDxe.c
@@ -0,0 +1,19 @@
+/** @file
+  This file contains implementation of the GpioMemLib for DXE phase
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/GpioNameBufferLib.h>
+
+STATIC CHAR8 mGpioNameBuffer[GPIO_NAME_LENGTH_MAX];
+
+CHAR8*
+GpioGetStaticNameBuffer (
+  VOID
+  )
+{
+  return mGpioNameBuffer;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.c
new file mode 100644
index 0000000000..e9fe6f04e0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.c
@@ -0,0 +1,87 @@
+/** @file
+  This file provides services for Gpio policy function
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/SiConfigBlockLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Protocol/PchPolicy.h>
+#include <ConfigBlock/Gpio/GpioDevConfig.h>
+
+/**
+  Print GPIO_DXE_CONFIG and serial out.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+GpioDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  )
+{
+  EFI_STATUS        Status;
+  GPIO_DXE_CONFIG   *GpioDxeConfig;
+
+  Status = GetConfigBlock ((VOID *) PchPolicy, &gGpioDxeConfigGuid, (VOID *) &GpioDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "------------------ GPIO DXE Config ------------------\n"));
+  DEBUG ((DEBUG_INFO, " HideGpioAcpiDevice : %d\n", GpioDxeConfig->HideGpioAcpiDevice));
+}
+
+/**
+  Load DXE Config block default for GPIO
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+GpioDxeLoadConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  )
+{
+  GPIO_DXE_CONFIG  *GpioDxeConfig;
+  GpioDxeConfig = ConfigBlockPointer;
+
+  DEBUG ((DEBUG_INFO, "GpioDxeConfig->Header.GuidHob.Name = %g\n", &GpioDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "GpioDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", GpioDxeConfig->Header.GuidHob.Header.HobLength));
+
+  GpioDxeConfig->HideGpioAcpiDevice = 0;
+}
+
+STATIC COMPONENT_BLOCK_ENTRY  mGpioBlocks = {
+  &gGpioDxeConfigGuid,
+  sizeof (GPIO_DXE_CONFIG),
+  GPIO_DXE_CONFIG_REVISION,
+  GpioDxeLoadConfigDefault
+};
+
+/**
+  Get Gpio config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+GpioDxeGetConfigBlockTotalSize (
+  VOID
+  )
+{
+  return mGpioBlocks.Size;
+}
+
+/**
+  Add Gpio ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+GpioDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  )
+{
+  return AddComponentConfigBlocks (ConfigBlockTableAddress, &mGpioBlocks, 1);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.inf
new file mode 100644
index 0000000000..1b9d53f40c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.inf
@@ -0,0 +1,31 @@
+## @file
+# Component description file for the Gpio policy library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeGpioPolicyLib
+FILE_GUID = 2D2B8ECA-E343-4036-A289-3F39545AEA06
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeGpioPolicyLib
+
+[LibraryClasses]
+DebugLib
+ConfigBlockLib
+SiConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeGpioPolicyLib.c
+
+[Guids]
+gGpioDxeConfigGuid  ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioNamesVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioNamesVer2.c
new file mode 100644
index 0000000000..4084583122
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioNamesVer2.c
@@ -0,0 +1,88 @@
+/** @file
+  This file contains GPIO name library implementation specific to Ver2
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Library/BaseLib.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/DebugLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Pins/GpioPinsVer2Lp.h>
+
+STATIC CONST CHAR8*  mGpioGppbNames[] = {
+  "GSPI0_CLK_LOOPBK",
+  "GSPI1_CLK_LOOPBK"
+};
+
+STATIC CONST CHAR8*  mGpioGppaNames[] = {
+  "SPI0_CLK_LOOPBK",
+  "ESPI_CLK_LOOPBK"
+};
+
+STATIC CONST CHAR8*  mPchLpGpioGpdNames[] = {
+  "INPUT3VSEL",
+  "SLP_LANB",
+  "SLP_SUSB",
+  "SLP_WAKEB",
+  "SLP_DRAM_RESETB"
+};
+
+STATIC CONST CHAR8*  mPchLpGpioGppdNames[] = {
+  "GSPI2_CLK_LOOPBK"
+};
+
+STATIC CONST CHAR8*  mGpioGppfNames[] = {
+  "GPPF_CLK_LOOPBK"
+};
+
+STATIC CONST CHAR8*  mGpioGppeNames[] = {
+  "GPPE_CLK_LOOPBK"
+};
+
+
+STATIC CONST GPIO_GROUP_NAME_INFO  mPchLpGroupDescriptors[] = {
+  GPIO_GROUP_NAME("GPP_B", GPIO_VER2_LP_GSPI0_CLK_LOOPBK, mGpioGppbNames),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME("GPP_A", GPIO_VER2_LP_ESPI_CLK_LOOPBK, mGpioGppaNames),
+  GPIO_GROUP_NAME_BASIC("GPP_R"),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME("GPD", GPIO_VER2_LP_INPUT3VSEL, mPchLpGpioGpdNames),
+  GPIO_GROUP_NAME_BASIC("GPP_S"),
+  GPIO_GROUP_NAME_BASIC("GPP_H"),
+  GPIO_GROUP_NAME("GPP_D", GPIO_VER2_LP_GSPI2_CLK_LOOPBK, mPchLpGpioGppdNames),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME_BASIC("GPP_C"),
+  GPIO_GROUP_NAME("GPP_F", GPIO_VER2_LP_GPPF_CLK_LOOPBK, mGpioGppfNames),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME("GPP_E", GPIO_VER2_LP_GPPE_CLK_LOOPBK, mGpioGppeNames),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME_BASIC(""),
+  GPIO_GROUP_NAME_BASIC("")
+};
+
+/**
+  Returns GPIO_GROUP_NAME_INFO corresponding to the given GpioPad
+
+  @param[in] GroupIndex  Group index
+
+  @retval GPIO_GROUP_NAME_INFO*  Pointer to the GPIO_GROUP_NAME_INFO
+  @reval  NULL                   If no group descriptor was found
+**/
+CONST
+GPIO_GROUP_NAME_INFO*
+GpioGetGroupNameInfo (
+  IN UINT32  GroupIndex
+  )
+{
+  if (GroupIndex < ARRAY_SIZE (mPchLpGroupDescriptors)) {
+    return &mPchLpGroupDescriptors[GroupIndex];
+  }
+
+  ASSERT (FALSE);
+  return NULL;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLib.c
new file mode 100644
index 0000000000..f750d77e9a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLib.c
@@ -0,0 +1,395 @@
+/** @file
+  This file contains GPIO routines for RC usage
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/GpioLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Library/GpioNameBufferLib.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/GpioRegs.h>
+
+/**
+  This procedure is used to check if GpioPad is valid for certain chipset
+
+  @param[in]  GpioPad             GPIO pad
+
+  @retval TRUE                    This pin is valid on this chipset
+          FALSE                   Incorrect pin
+**/
+BOOLEAN
+GpioIsCorrectPadForThisChipset (
+  IN  GPIO_PAD        GpioPad
+  )
+{
+  return ((GPIO_GET_CHIPSET_ID (GpioPad) == GpioGetThisChipsetId ()) &&
+         (GpioGetGroupIndexFromGpioPad (GpioPad) < GpioGetNumberOfGroups ()));
+}
+
+/**
+  This procedure is used by PchSmiDispatcher and will return information
+  needed to register GPI SMI.
+
+  @param[in]  Index                   GPI SMI number
+  @param[out] GpioPin                 GPIO pin
+  @param[out] GpiSmiBitOffset         GPI SMI bit position within GpiSmi Registers
+  @param[out] GpiHostSwOwnRegAddress  Address of HOSTSW_OWN register
+  @param[out] GpiSmiStsRegAddress     Address of GPI SMI status register
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioGetPadAndSmiRegs (
+  IN UINT32            Index,
+  OUT GPIO_PAD         *GpioPin,
+  OUT UINT8            *GpiSmiBitOffset,
+  OUT UINT32           *GpiHostSwOwnRegAddress,
+  OUT UINT32           *GpiSmiStsRegAddress
+  )
+{
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  GPIO_GROUP             GpioGroup;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 SmiStsRegOffset;
+  UINT32                 HostSwOwnRegOffset;
+  GPIO_PAD_OWN           PadOwnVal;
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  PadNumber = 0;
+  GroupIndex = 0;
+  for (GroupIndex = 0; GroupIndex < GpioGroupInfoLength; GroupIndex++) {
+    PadNumber = Index;
+    if (PadNumber < GpioGroupInfo[GroupIndex].PadPerGroup) {
+      //
+      // Found group and pad number
+      //
+      break;
+    }
+    Index = Index - GpioGroupInfo[GroupIndex].PadPerGroup;
+  }
+
+  //
+  // Check if legal pad number
+  //
+  if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup){
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Check if selected group has GPI SMI Enable and Status registers
+  //
+  if (GpioGroupInfo[GroupIndex].SmiEnOffset == NO_REGISTER_FOR_PROPERTY) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  GpioGroup = GpioGetGroupFromGroupIndex (GroupIndex);
+  *GpioPin = GpioGetGpioPadFromGroupAndPadNumber (GpioGroup, PadNumber);
+
+  DEBUG_CODE_BEGIN ();
+  //
+  // Check if selected GPIO Pad is not owned by CSME/ISH/IE
+  //
+  GpioGetPadOwnership (*GpioPin, &PadOwnVal);
+  if (PadOwnVal != GpioPadOwnHost) {
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a not owned by host!\n", GpioName (*GpioPin)));
+    return EFI_INVALID_PARAMETER;
+  }
+  DEBUG_CODE_END ();
+
+  *GpiSmiBitOffset = (UINT8)(PadNumber % 32);
+
+  HostSwOwnRegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset + (PadNumber / 32) * 0x4;
+  *GpiHostSwOwnRegAddress = PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, HostSwOwnRegOffset);
+
+  SmiStsRegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset + (PadNumber / 32) * 0x4;
+  *GpiSmiStsRegAddress = PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, SmiStsRegOffset);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will check if GpioPad is owned by host.
+
+  @param[in] GpioPad       GPIO pad
+
+  @retval TRUE             GPIO pad is owned by host
+  @retval FALSE            GPIO pad is not owned by host and should not be used with GPIO lib API
+**/
+BOOLEAN
+GpioIsPadHostOwned (
+  IN GPIO_PAD             GpioPad
+  )
+{
+  GPIO_PAD_OWN         PadOwnVal;
+
+  //
+  // Check if selected GPIO Pad is not owned by CSME/ISH
+  // If GPIO is not owned by Host all access to PadCfg will be dropped
+  //
+  GpioGetPadOwnership (GpioPad, &PadOwnVal);
+  if (PadOwnVal != GpioPadOwnHost) {
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a is not owned by host!\n", GpioName (GpioPad)));
+    return FALSE;
+  }
+
+  return TRUE;
+}
+
+/**
+  This procedure will check if GpioPad argument is valid.
+  Function will check below conditions:
+   - GpioPad represents a pad for current PCH
+   - GpioPad belongs to valid GpioGroup
+   - GPIO PadNumber is not greater than number of pads for this group
+
+  @param[in] GpioPad       GPIO pad
+
+  @retval TRUE             GPIO pad is valid and can be used with GPIO lib API
+  @retval FALSE            GPIO pad is invalid and cannot be used with GPIO lib API
+**/
+BOOLEAN
+GpioIsPadValid (
+  IN GPIO_PAD             GpioPad
+  )
+{
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 PadNumber;
+  UINT32                 GroupIndex;
+
+  if (!GpioIsCorrectPadForThisChipset (GpioPad)) {
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Incorrect GpioPad (0x%08x) used on this chipset!\n", GpioPad));
+    goto Error;
+  }
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  //
+  // Check if legal pin number
+  //
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
+    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds range of %a group (max: %d)\n",
+                                                                                   PadNumber,
+                                                                                   GpioGetGroupName (GroupIndex),
+                                                                                   GpioGroupInfo[GroupIndex].PadPerGroup));
+    goto Error;
+  }
+
+  return TRUE;
+Error:
+  ASSERT (FALSE);
+  return FALSE;
+}
+
+/**
+  This procedure will read GPIO Pad Configuration register
+
+  @param[in] GpioPad          GPIO pad
+  @param[in] DwReg            Choose PADCFG register: 0:DW0, 1:DW1
+
+  @retval PadCfgRegValue      PADCFG_DWx value
+**/
+UINT32
+GpioReadPadCfgReg (
+  IN GPIO_PAD             GpioPad,
+  IN UINT8                DwReg
+  )
+{
+  UINT32                 PadCfgReg;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  //
+  // Create Pad Configuration register offset
+  //
+  PadCfgReg = GpioGroupInfo[GroupIndex].PadCfgOffset + S_GPIO_PCR_PADCFG * PadNumber + 0x4 * DwReg;
+
+  return MmioRead32 (PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, PadCfgReg));
+}
+
+/**
+  This procedure will write or read GPIO Pad Configuration register
+
+  @param[in] GpioPad              GPIO pad
+  @param[in] DwReg                Choose PADCFG register: 0:DW0, 1:DW1
+  @param[in] PadCfgAndMask        Mask to be AND'ed with PADCFG reg value
+  @param[in] PadCfgOrMask         Mask to be OR'ed with PADCFG reg value
+
+  @retval none
+**/
+VOID
+GpioWritePadCfgReg (
+  IN GPIO_PAD             GpioPad,
+  IN UINT8                DwReg,
+  IN UINT32               PadCfgAndMask,
+  IN UINT32               PadCfgOrMask
+  )
+{
+  UINT32                 PadCfgReg;
+  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
+  UINT32                 GpioGroupInfoLength;
+  UINT32                 GroupIndex;
+  UINT32                 PadNumber;
+  UINT32                 PadCfgLock;
+  UINT32                 PadCfgLockTx;
+
+  PadCfgLock = 0;
+  PadCfgLockTx = 0;
+
+  //
+  // Check if Pad Configuration (except output state) is to be changed.
+  // If AND and OR masks will indicate that configuration fields (other than output control)
+  // are to be modified it means that there is a need to perform an unlock (if set)
+  //
+  if ((~PadCfgAndMask | PadCfgOrMask) & (UINT32)~B_GPIO_PCR_TX_STATE) {
+    GpioGetPadCfgLock (GpioPad, &PadCfgLock);
+    if (PadCfgLock) {
+      GpioUnlockPadCfg (GpioPad);
+    }
+  }
+
+  //
+  // Check if Pad Output state is to be changed
+  // If AND and OR masks will indicate that output control
+  // is to be modified it means that there is a need to perform an unlock (if set)
+  //
+  if ((~PadCfgAndMask | PadCfgOrMask) & B_GPIO_PCR_TX_STATE) {
+    GpioGetPadCfgLockTx (GpioPad, &PadCfgLockTx);
+    if (PadCfgLockTx) {
+      GpioUnlockPadCfgTx (GpioPad);
+    }
+  }
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+
+  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
+
+  //
+  // Create Pad Configuration register offset
+  //
+  PadCfgReg = GpioGroupInfo[GroupIndex].PadCfgOffset + S_GPIO_PCR_PADCFG * PadNumber + 0x4 * DwReg;
+
+  MmioAndThenOr32 (
+    PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community, PadCfgReg),
+    PadCfgAndMask,
+    PadCfgOrMask
+    );
+
+  if (PadCfgLock) {
+    GpioLockPadCfg (GpioPad);
+  }
+  if (PadCfgLockTx) {
+    GpioLockPadCfgTx (GpioPad);
+  }
+}
+
+/**
+  This procedure will set GPIO mode
+
+  @param[in]  GpioPad             GPIO pad
+  @param[in]  PadModeValue        GPIO pad mode value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
+**/
+EFI_STATUS
+GpioSetPadMode (
+  IN GPIO_PAD                GpioPad,
+  IN GPIO_PAD_MODE           PadModeValue
+  )
+{
+  UINT32               PadCfgOrMask;
+
+  PadCfgOrMask = 0;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (PadModeValue != (GPIO_PAD_MODE)GpioHardwareDefault) {
+
+    PadCfgOrMask = (((PadModeValue & B_GPIO_PAD_MODE_MASK) >> (N_GPIO_PAD_MODE_BIT_POS + 1)) << N_GPIO_PCR_PAD_MODE);
+
+    GpioWritePadCfgReg (
+      GpioPad,
+      0,
+      (UINT32)~B_GPIO_PCR_PAD_MODE,
+      PadCfgOrMask
+      );
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO mode
+
+  @param[in]  GpioPad             GPIO pad
+  @param[out] PadModeValue        GPIO pad mode value
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
+**/
+EFI_STATUS
+GpioGetPadMode (
+  IN  GPIO_PAD                 GpioPad,
+  OUT GPIO_PAD_MODE            *PadModeValue
+  )
+{
+  UINT32        PadCfgRegValue;
+
+  if (!GpioIsPadValid (GpioPad)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (!GpioIsPadHostOwned (GpioPad)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  PadCfgRegValue = GpioReadPadCfgReg (GpioPad, 0);
+
+  *PadModeValue = (GPIO_PAD_MODE)(((PadCfgRegValue & B_GPIO_PCR_PAD_MODE) >> (N_GPIO_PCR_PAD_MODE - (N_GPIO_PAD_MODE_BIT_POS + 1))) | (0x1 << N_GPIO_PAD_MODE_BIT_POS));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Generates GPIO name from GpioPad
+  This function returns pointer to the static buffer
+
+  @param[in] GpioPad  GpioPad
+
+  @retval CHAR8*  Pointer to the gpio name string
+**/
+CHAR8*
+GpioName (
+  IN GPIO_PAD  GpioPad
+  )
+{
+  return GpioGetPadName (GpioPad, GpioGetStaticNameBuffer (), GPIO_NAME_LENGTH_MAX);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLibVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLibVer2.c
new file mode 100644
index 0000000000..9fea5daa28
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/GpioPrivateLibVer2.c
@@ -0,0 +1,131 @@
+/** @file
+  This file contains VER2 specific GPIO information
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/DebugLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/GpioLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Library/GpioHelpersLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/CpuRegbarAccessLib.h>
+#include <Register/GpioRegsVer2.h>
+#include <Register/PmcRegsVer2.h>
+#include <Register/PchPcrRegs.h>
+#include <Pins/GpioPinsVer2Lp.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED GPIO_GROUP_INFO mPchLpGpioGroupInfo[] = {
+  {PID_GPIOCOM0, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_B_PAD_MAX}, //TGL PCH-LP GPP_B
+  {PID_GPIOCOM0, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM0, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_EN, NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_A_PAD_MAX}, //TGL PCH-LP GPP_A
+  {PID_GPIOCOM5, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_EN, NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_R_PAD_MAX}, //TGL PCH-LP GPP_R
+  {PID_GPIOCOM5, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM2, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PAD_OWN,    R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_HOSTSW_OWN,    R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IS,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IE,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_STS,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_EN,   NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCK,    R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCKTX,     R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFG_OFFSET,    GPIO_VER2_PCH_LP_GPIO_GPD_PAD_MAX},   //TGL PCH-LP GPD
+  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_EN, NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_S_PAD_MAX}, //TGL PCH-LP GPP_S
+  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_EN, NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_H_PAD_MAX}, //TGL PCH-LP GPP_H
+  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_D_PAD_MAX}, //TGL PCH-LP GPP_D
+  {PID_GPIOCOM1, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM1, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_C_PAD_MAX}, //TGL PCH-LP GPP_C
+  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_EN, NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_F_PAD_MAX}, //TGL PCH-LP GPP_F
+  {PID_GPIOCOM4, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PAD_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_HOSTSW_OWN,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IE, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_STS, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_EN, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCK,  R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCKTX,   R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFG_OFFSET,  GPIO_VER2_PCH_LP_GPIO_GPP_E_PAD_MAX}, //TGL PCH-LP GPP_E
+  {PID_GPIOCOM4, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM3, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0},
+  {PID_GPIOCOM3, NO_REGISTER_FOR_PROPERTY,                   NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,                         0}
+};
+
+/**
+  This procedure will retrieve address and length of GPIO info table
+
+  @param[out]  GpioGroupInfoTableLength   Length of GPIO group table
+
+  @retval Pointer to GPIO group table
+
+**/
+CONST GPIO_GROUP_INFO*
+GpioGetGroupInfoTable (
+  OUT UINT32              *GpioGroupInfoTableLength
+  )
+{
+  *GpioGroupInfoTableLength = ARRAY_SIZE (mPchLpGpioGroupInfo);
+  return mPchLpGpioGroupInfo;
+}
+
+/**
+  Get GPIO Chipset ID specific to PCH generation and series
+**/
+UINT32
+GpioGetThisChipsetId (
+  VOID
+  )
+{
+  return GPIO_VER2_LP_CHIPSET_ID;
+}
+
+/**
+  This internal procedure will check if group is within DeepSleepWell.
+
+  @param[in]  Group               GPIO Group
+
+  @retval GroupWell               TRUE:  This is DSW Group
+                                  FALSE: This is not DSW Group
+**/
+BOOLEAN
+GpioIsDswGroup (
+  IN  GPIO_GROUP         Group
+  )
+{
+  if (Group == GPIO_VER2_LP_GROUP_GPD) {
+    return TRUE;
+  } else {
+    return FALSE;
+  }
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED GPIO_GROUP_TO_GPE_MAPPING mPchLpGpioGroupToGpeMapping[] = {
+    {GPIO_VER2_LP_GROUP_GPP_B,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_B},
+    {GPIO_VER2_LP_GROUP_GPP_A,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_A},
+    {GPIO_VER2_LP_GROUP_GPP_R,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_R},
+    {GPIO_VER2_LP_GROUP_GPD,     0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPD  },
+    {GPIO_VER2_LP_GROUP_GPP_S,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_S},
+    {GPIO_VER2_LP_GROUP_GPP_H,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_H},
+    {GPIO_VER2_LP_GROUP_GPP_D,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_D},
+    {GPIO_VER2_LP_GROUP_GPP_C,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_C},
+    {GPIO_VER2_LP_GROUP_GPP_F,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_F},
+    {GPIO_VER2_LP_GROUP_GPP_E,   0, V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_E}
+};
+
+/**
+  Get information for GPIO Group required to program GPIO and PMC for desired 1-Tier GPE mapping
+
+  @param[out] GpioGroupToGpeMapping        Table with GPIO Group to GPE mapping
+  @param[out] GpioGroupToGpeMappingLength  GPIO Group to GPE mapping table length
+**/
+VOID
+GpioGetGroupToGpeMapping (
+  OUT GPIO_GROUP_TO_GPE_MAPPING  **GpioGroupToGpeMapping,
+  OUT UINT32                     *GpioGroupToGpeMappingLength
+  )
+{
+  *GpioGroupToGpeMapping = mPchLpGpioGroupToGpeMapping;
+  *GpioGroupToGpeMappingLength = ARRAY_SIZE (mPchLpGpioGroupToGpeMapping);
+}
+
+/**
+  Check if 0x13 opcode supported for writing to GPIO lock unlock register
+
+  @retval TRUE                It's supported
+  @retval FALSE               It's not supported
+**/
+BOOLEAN
+IsGpioLockOpcodeSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
new file mode 100644
index 0000000000..a355f407f8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
@@ -0,0 +1,46 @@
+## @file
+#  Component description file for the PeiDxeSmmGpioPrivateLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION                    = 0x00010017
+BASE_NAME                      = PeiDxeSmmGpioPrivateLibVer2
+FILE_GUID                      = 680A81B0-A087-4687-B5B4-146DA30042D6
+VERSION_STRING                 = 1.0
+MODULE_TYPE                    = BASE
+LIBRARY_CLASS                  = GpioPrivateLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  DebugLib
+  PmcLib
+  PchInfoLib
+  GpioLib
+  GpioNameBufferLib
+  SataLib
+  GpioHelpersLib
+
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  GpioPrivateLib.c
+  GpioPrivateLibVer2.c
+  GpioNamesVer2.c
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdEmbeddedEnable                          ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.c
new file mode 100644
index 0000000000..84bf655ab9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.c
@@ -0,0 +1,413 @@
+/** @file
+  This file contains routines for PEI GPIO Helpers Lib
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/HobLib.h>
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Library/GpioHelpersLib.h>
+#include <Library/PeiServicesLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <ConfigBlock/PchGeneralConfig.h>
+#include <Ppi/SiPolicy.h>
+
+extern EFI_GUID gGpioLibUnlockHobGuid;
+
+//
+//  GPIO Lock HOB
+//  Stores information on GPIO pads that should be left unlocked
+//
+typedef struct {
+  //
+  // GPIO PadConfig unlock data
+  //
+  UINT32  PadConfig;
+  //
+  // GPIO Output unlock data
+  //
+  UINT32  OutputState;
+} GPIO_UNLOCK_HOB_DATA;
+
+/**
+  This procedure will get index of GPIO Unlock HOB structure for selected GroupIndex and DwNum.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+
+  @retval GpioUnlockHobIndex
+**/
+STATIC
+UINT32
+GpioUnlockDataIndex (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  )
+{
+  UINT32         GpioUnlockDataIndex;
+  UINT32         Index;
+
+  GpioUnlockDataIndex = 0;
+
+  for (Index = 0; Index < GroupIndex; Index++) {
+    GpioUnlockDataIndex += GPIO_GET_DW_NUM (GpioGetPadPerGroup (GpioGetGroupFromGroupIndex (Index))) + 1;
+  }
+
+  GpioUnlockDataIndex += DwNum;
+  return GpioUnlockDataIndex;
+}
+
+/**
+  This procedure will create GPIO HOB for storing unlock data
+
+  @retval Pointer to GPIO Unlock data structure
+**/
+STATIC
+GPIO_UNLOCK_HOB_DATA*
+GpioCreateUnlockData (
+  VOID
+  )
+{
+  VOID           *HobData;
+  GPIO_GROUP     Group;
+  GPIO_GROUP     GroupMin;
+  GPIO_GROUP     GroupMax;
+  UINT32         GpioUnlockDataRecords;
+
+  GroupMin = GpioGetLowestGroup ();
+  GroupMax = GpioGetHighestGroup ();
+  GpioUnlockDataRecords = 0;
+
+  for (Group = GroupMin; Group <= GroupMax; Group++) {
+    GpioUnlockDataRecords += GPIO_GET_DW_NUM (GpioGetPadPerGroup (Group)) + 1;
+  }
+
+  HobData = BuildGuidHob (&gGpioLibUnlockHobGuid, GpioUnlockDataRecords * sizeof (GPIO_UNLOCK_HOB_DATA));
+  if (HobData == NULL) {
+    return NULL;
+  }
+
+  ZeroMem (HobData, GpioUnlockDataRecords * sizeof (GPIO_UNLOCK_HOB_DATA));
+
+  return (GPIO_UNLOCK_HOB_DATA*)HobData;
+}
+
+/**
+  This procedure will Get GPIO Unlock data structure for storing unlock data.
+  If HOB doesn't exist it will be created.
+
+  @param[out] GpioUnlockData          pointer to GPIO Unlock data structure
+
+  @retval Length                      number of GPIO unlock data records
+**/
+STATIC
+UINT32
+GpioGetUnlockData (
+  GPIO_UNLOCK_HOB_DATA  **GpioUnlockData
+  )
+{
+  VOID  *Hob;
+
+  Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
+  if (Hob == NULL) {
+    //
+    // It is the first time this function is used so create the HOB
+    //
+    *GpioUnlockData = GpioCreateUnlockData ();
+    if (*GpioUnlockData == NULL) {
+      return 0;
+    }
+    Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
+  } else {
+    *GpioUnlockData = (GPIO_UNLOCK_HOB_DATA*) GET_GUID_HOB_DATA (Hob);
+  }
+  return GET_GUID_HOB_DATA_SIZE (Hob) / sizeof (GPIO_UNLOCK_HOB_DATA);
+}
+
+/**
+  This procedure will get pointer to GPIO Unlock data structure.
+
+  @param[out] GpioUnlockData          pointer to GPIO Unlock data structure
+
+  @retval Length                      number of GPIO unlock data records
+**/
+STATIC
+UINT32
+GpioLocateUnlockData (
+  GPIO_UNLOCK_HOB_DATA  **GpioUnlockData
+  )
+{
+  VOID  *Hob;
+
+  Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
+  if (Hob == NULL) {
+    *GpioUnlockData = NULL;
+    return 0;
+  }
+
+  *GpioUnlockData = (GPIO_UNLOCK_HOB_DATA*) GET_GUID_HOB_DATA (Hob);
+  return GET_GUID_HOB_DATA_SIZE (Hob) / sizeof (GPIO_UNLOCK_HOB_DATA);
+}
+
+/**
+  This procedure stores GPIO pad unlock information
+
+  @param[in] GpioPad         GPIO pad
+  @param[in] GpioLockConfig  GPIO Lock Configuration
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreUnlockData (
+  IN GPIO_PAD             GpioPad,
+  IN GPIO_LOCK_CONFIG     GpioLockConfig
+  )
+{
+  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
+  UINT32               Length;
+  UINT32               GroupIndex;
+  UINT32               PadNumber;
+  UINT32               Index;
+
+  if (GpioLockConfig == GpioLockDefault) {
+    return EFI_SUCCESS;
+  }
+
+  Length = GpioGetUnlockData (&GpioUnlockData);
+  if (Length == 0) {
+    return EFI_NOT_FOUND;
+  }
+
+  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
+  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
+  Index = GpioUnlockDataIndex (GroupIndex, GPIO_GET_DW_NUM (PadNumber));
+
+  if (Index >= Length) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((GpioLockConfig & B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK) == GpioPadConfigUnlock) {
+    GpioUnlockData[Index].PadConfig |= 1 << (GpioGetPadNumberFromGpioPad (GpioPad) % 32);
+  }
+
+  if ((GpioLockConfig & B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) == GpioOutputStateUnlock) {
+    GpioUnlockData[Index].OutputState |= 1 << (GpioGetPadNumberFromGpioPad (GpioPad) % 32);
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure stores GPIO group data about pads which PadConfig needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockPadConfigData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  )
+{
+  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
+  UINT32               Length;
+  UINT32               Index;
+
+  if (UnlockedPads == 0) {
+    //
+    // No pads to be left unlocked
+    //
+    return EFI_SUCCESS;
+  }
+
+  Length = GpioGetUnlockData (&GpioUnlockData);
+  if (Length == 0) {
+    return EFI_NOT_FOUND;
+  }
+
+  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
+  if (Index >= Length) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  GpioUnlockData[Index].PadConfig |= UnlockedPads;
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure stores GPIO group data about pads which Output state needs to be unlocked.
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @param[in]  UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: Skip, 1: Leave unlocked
+  @retval Status
+**/
+EFI_STATUS
+GpioStoreGroupDwUnlockOutputData (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum,
+  IN UINT32                       UnlockedPads
+  )
+{
+  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
+  UINT32               Length;
+  UINT32               Index;
+
+  if (UnlockedPads == 0) {
+    //
+    // No pads to be left unlocked
+    //
+    return EFI_SUCCESS;
+  }
+
+  Length = GpioGetUnlockData (&GpioUnlockData);
+  if (Length == 0) {
+    return EFI_NOT_FOUND;
+  }
+
+  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
+  if (Index >= Length) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  GpioUnlockData[Index].OutputState |= UnlockedPads;
+  return EFI_SUCCESS;
+}
+
+/**
+  This procedure will get GPIO group data with pads, which PadConfig is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockPadConfigMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  )
+{
+  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
+  UINT32               Length;
+  UINT32               Index;
+
+  Length = GpioLocateUnlockData (&GpioUnlockData);
+  if (Length == 0) {
+    return 0;
+  }
+
+  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
+  if (Index >= Length) {
+    return 0;
+  }
+
+  return GpioUnlockData[Index].PadConfig;
+}
+
+/**
+  This procedure will get GPIO group data with pads, which Output is supposed to be left unlock
+
+  @param[in]  GroupIndex          GPIO group index
+  @param[in]  DwNum               DWORD index for a group.
+                                  For group which has less then 32 pads per group DwNum must be 0.
+  @retval     UnlockedPads        DWORD bitmask for pads which are going to be left unlocked
+                                  Bit position - PadNumber
+                                  Bit value - 0: to be locked, 1: Leave unlocked
+**/
+UINT32
+GpioGetGroupDwUnlockOutputMask (
+  IN UINT32                       GroupIndex,
+  IN UINT32                       DwNum
+  )
+{
+  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
+  UINT32               Length;
+  UINT32               Index;
+
+  Length = GpioLocateUnlockData (&GpioUnlockData);
+  if (Length == 0) {
+    return 0;
+  }
+
+  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
+  if (Index >= Length) {
+    return 0;
+  }
+
+  return GpioUnlockData[Index].OutputState;
+}
+
+/**
+  Obtains GpioOverride Information from PreMem config
+
+  @retval  TRUE    GPIO Override obtained successfully
+           FALSE   Unable to obtain GPIO Override data
+**/
+BOOLEAN
+STATIC
+GetGpioOverrideFromConfigBlock (
+  IN OUT  UINT8 *GpioOverride
+  )
+{
+  EFI_STATUS                   Status;
+  SI_PREMEM_POLICY_PPI         *SiPreMemPolicyPpi;
+  PCH_GENERAL_PREMEM_CONFIG    *PchGeneralPreMemConfig;
+
+  Status = PeiServicesLocatePpi (
+             &gSiPreMemPolicyPpiGuid,
+             0,
+             NULL,
+             (VOID **) &SiPreMemPolicyPpi
+             );
+  if (EFI_ERROR (Status)) {
+    return FALSE;
+  }
+  Status = GetConfigBlock ((VOID *) SiPreMemPolicyPpi, &gPchGeneralPreMemConfigGuid, (VOID *) &PchGeneralPreMemConfig);
+  if (EFI_ERROR (Status)) {
+    return FALSE;
+  }
+  *GpioOverride = (UINT8) PchGeneralPreMemConfig->GpioOverride;
+
+  return TRUE;
+}
+
+/**
+  Returns Gpio Override Level1 Information
+
+  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
+**/
+BOOLEAN
+GpioOverrideLevel1Enabled (
+  VOID
+  )
+{
+  UINT8           GpioOverride;
+
+  GpioOverride = 0;
+
+  if (GetGpioOverrideFromConfigBlock (&GpioOverride)) {
+    if (GpioOverride == 1) { return TRUE; }
+  }
+
+  return FALSE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.inf
new file mode 100644
index 0000000000..d70c2a1352
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.inf
@@ -0,0 +1,48 @@
+## @file
+# Component description file for the PeiGpioHelpersLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiGpioHelpersLib
+FILE_GUID = 1838E1E7-3CC4-4A74-90D9-B421EF2A579F
+VERSION_STRING = 1.0
+MODULE_TYPE = PEIM
+LIBRARY_CLASS = GpioHelpersLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+HobLib
+GpioLib
+PeiServicesLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PeiGpioHelpersLib.c
+
+
+[Guids]
+gGpioLibUnlockHobGuid
+gPchGeneralPreMemConfigGuid        ## CONSUMES
+
+[Ppis]
+gSiPreMemPolicyPpiGuid
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/GpioNameBufferPei.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/GpioNameBufferPei.c
new file mode 100644
index 0000000000..920d9a2cbc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/GpioNameBufferPei.c
@@ -0,0 +1,67 @@
+/** @file
+  This file contains GpioMemLib implementation for PEI phase
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/HobLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/GpioNameBufferLib.h>
+
+STATIC CONST EFI_GUID mGpioNamesPrivateHobGuid = {0x9AE3138D, 0x4EBF, 0x4E90, {0x87, 0x96, 0x11, 0xD3, 0x10, 0x04, 0x60, 0x0A}};
+
+STATIC volatile BOOLEAN mGlobalMemoryWorking = FALSE;
+
+STATIC CHAR8 mGpioNameBuffer[GPIO_NAME_LENGTH_MAX];
+
+/**
+  Returns pointer to the buffer taken from GpioLib private HOB
+
+  @retval CHAR8*  Pointer to the buffer
+**/
+STATIC
+CHAR8*
+GetBufferFromHob (
+  VOID
+  )
+{
+  VOID  *Hob;
+  CHAR8 *GpioNameBuffer;
+
+  Hob = NULL;
+  GpioNameBuffer = NULL;
+
+  Hob = GetFirstGuidHob (&mGpioNamesPrivateHobGuid);
+  if (Hob != NULL){
+    GpioNameBuffer = (CHAR8*) GET_GUID_HOB_DATA (Hob);
+  } else {
+    GpioNameBuffer = (CHAR8*) BuildGuidHob (&mGpioNamesPrivateHobGuid, GPIO_NAME_LENGTH_MAX);
+    if (GpioNameBuffer == NULL){
+      DEBUG ((DEBUG_ERROR, "Failed to setup HOB for GPIO names lib\n"));
+      ASSERT (FALSE);
+    }
+  }
+  return GpioNameBuffer;
+}
+
+/**
+  Returns pointer to the global buffer to be used by GpioNamesLib
+
+  @retval CHAR8*  Pointer to the buffer
+**/
+CHAR8*
+GpioGetStaticNameBuffer (
+  VOID
+  )
+{
+  mGlobalMemoryWorking = TRUE;
+
+  if (mGlobalMemoryWorking) {
+    return mGpioNameBuffer;
+  } else {
+    return GetBufferFromHob ();
+  }
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf
new file mode 100644
index 0000000000..0525a42a8d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf
@@ -0,0 +1,35 @@
+## @file
+# Component description file for the PeiGpioMemLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiGpioNameBufferLib
+FILE_GUID = 16EC5CA8-8195-4847-B6CB-662CDAB863F2
+VERSION_STRING = 1.0
+MODULE_TYPE = PEIM
+LIBRARY_CLASS = GpioNameBufferLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32
+#
+
+[LibraryClasses]
+HobLib
+BaseLib
+IoLib
+DebugLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+GpioNameBufferPei.c
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (15 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component Heng Luo
                   ` (22 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Graphics/AcpiTables
  * IpBlock/Graphics/IncludePrivate
  * IpBlock/Graphics/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl                                            | 1955 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommon.asl                                      |  480 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl                                         |  398 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.asl                                      |  127 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl                                        |  314 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.asl                                      |  261 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl                                        |   73 +++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf                                        |   23 +++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsInitLib.h                    |   53 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsPolicyLib.h                  |   71 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeIgdOpRegionInitLib.h                 |  177 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.c         |  135 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf       |   45 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.c     |  118 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf   |   37 +++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInit.c      |  541 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf |   49 ++++++++++++++++++++++
 17 files changed, 4857 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
new file mode 100644
index 0000000000..d00a1d8f58
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
@@ -0,0 +1,1955 @@
+/** @file
+  This file contains the IGD OpRegion/Software ACPI Reference
+  Code.
+  It defines the methods to enable/disable output switching,
+  store display switching and LCD brightness BIOS control
+  and return valid addresses for all display device encoders
+  present in the system, etc.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+External(\PLD1, MethodObj)
+External(\PLD2, MethodObj)
+External(\ECST, MethodObj)
+External(\PBCL, MethodObj)
+External(HDOS, MethodObj)
+External(\ECON, IntObj)
+External(\PNHM, IntObj)
+External(OSYS, IntObj)
+External(CPSC)
+External(\GUAM, MethodObj)
+External(DSEN)
+External(S0ID)
+
+//
+// Default Physical Location of Device
+//
+Name (DPLD, Package (0x1) {
+             ToPLD (
+               PLD_Revision         = 0x2,
+               PLD_IgnoreColor      = 0x1,
+               PLD_Red              = 0x0,
+               PLD_Green            = 0x0,
+               PLD_Blue             = 0x0,
+               PLD_Width            = 0x320, //800 mm
+               PLD_Height           = 0x7D0, //2000 mm
+               PLD_UserVisible      = 0x1, //Set if the device connection point can be seen by the user without disassembly.
+               PLD_Dock             = 0x0, // Set if the device connection point resides in a docking station or port replicator.
+               PLD_Lid              = 0x0, // Set if this device connection point resides on the lid of laptop system.
+               PLD_Panel              = "TOP",    // Describes which panel surface of the systems housing the device connection point resides on.
+               PLD_VerticalPosition   = "CENTER", // Vertical Position on the panel where the device connection point resides.
+               PLD_HorizontalPosition = "RIGHT",  // Horizontal Position on the panel where the device connection point resides.
+               PLD_Shape              = "VERTICALRECTANGLE",
+               PLD_GroupOrientation = 0x0, // if Set, indicates vertical grouping, otherwise horizontal is assumed.
+               PLD_GroupToken       = 0x0, // Unique numerical value identifying a group.
+               PLD_GroupPosition    = 0x0, // Identifies this device connection points position in the group (i.e. 1st, 2nd)
+               PLD_Bay              = 0x0, // Set if describing a device in a bay or if device connection point is a bay.
+               PLD_Ejectable        = 0x0, // Set if the device is ejectable. Indicates ejectability in the absence of _EJx objects
+               PLD_EjectRequired    = 0x0, // OSPM Ejection required: Set if OSPM needs to be involved with ejection process. User-operated physical hardware ejection is not possible.
+               PLD_CabinetNumber    = 0x0, // For single cabinet system, this field is always 0.
+               PLD_CardCageNumber   = 0x0, // For single card cage system, this field is always 0.
+               PLD_Reference        = 0x0, // if Set, this _PLD defines a reference shape that is used to help orient the user with respect to the other shapes when rendering _PLDs.
+               PLD_Rotation         = 0x0, // 0 - 0deg, 1 - 45deg, 2 - 90deg, 3 - 135deg, 4 - 180deg, 5 - 225deg, 6 - 270deg, 7 - 315deg
+               PLD_Order            = 0x3, // Identifies the drawing order of the connection point described by a _PLD
+               PLD_VerticalOffset   = 0x0,
+               PLD_HorizontalOffset = 0x0
+              )
+            } // Package
+) //DPLD
+
+// Enable/Disable Output Switching.  In WIN2K/WINXP, _DOS = 0 will
+// get called during initialization to prepare for an ACPI Display
+// Switch Event.  During an ACPI Display Switch, the OS will call
+// _DOS = 2 immediately after a Notify=0x80 to temporarily disable
+// all Display Switching.  After ACPI Display Switching is complete,
+// the OS will call _DOS = 0 to re-enable ACPI Display Switching.
+Method(_DOS,1)
+{
+  //
+  // Store Display Switching and LCD brightness BIOS control bit
+  //
+  Store(And(Arg0,7),DSEN)
+
+  If(LEqual(And(Arg0,  0x3), 0))     // If _DOS[1:0]=0
+  {
+    If(CondRefOf(HDOS))
+    {
+      HDOS()
+    }
+  }
+}
+
+//
+// Enumerate the Display Environment.  This method will return
+// valid addresses for all display device encoders present in the
+// system.  The Miniport Driver will reject the addresses for every
+// encoder that does not have an attached display device.  After
+// enumeration is complete, the OS will call the _DGS methods
+// during a display switch only for the addresses accepted by the
+// Miniport Driver.  For hot-insertion and removal of display
+// devices, a re-enumeration notification will be required so the
+// address of the newly present display device will be accepted by
+// the Miniport Driver.
+//
+Method(_DOD,0)
+{
+  //
+  // Two LFP devices are supporte by default
+  //
+  Store(2, NDID)
+  If(LNotEqual(DIDL, Zero))
+  {
+    Store(SDDL(DIDL),DID1)
+  }
+  If(LNotEqual(DDL2, Zero))
+  {
+    Store(SDDL(DDL2),DID2)
+  }
+  If(LNotEqual(DDL3, Zero))
+  {
+    Store(SDDL(DDL3),DID3)
+  }
+  If(LNotEqual(DDL4, Zero))
+  {
+    Store(SDDL(DDL4),DID4)
+  }
+  If(LNotEqual(DDL5, Zero))
+  {
+    Store(SDDL(DDL5),DID5)
+  }
+  If(LNotEqual(DDL6, Zero))
+  {
+    Store(SDDL(DDL6),DID6)
+  }
+  If(LNotEqual(DDL7, Zero))
+  {
+    Store(SDDL(DDL7),DID7)
+  }
+  If(LNotEqual(DDL8, Zero))
+  {
+    Store(SDDL(DDL8),DID8)
+  }
+  If(LNotEqual(DDL9, Zero))
+  {
+    Store(SDDL(DDL9),DID9)
+  }
+  If(LNotEqual(DD10, Zero))
+  {
+    Store(SDDL(DD10),DIDA)
+  }
+  If(LNotEqual(DD11, Zero))
+  {
+    Store(SDDL(DD11),DIDB)
+  }
+  If(LNotEqual(DD12, Zero))
+  {
+    Store(SDDL(DD12),DIDC)
+  }
+  If(LNotEqual(DD13, Zero))
+  {
+    Store(SDDL(DD13),DIDD)
+  }
+  If(LNotEqual(DD14, Zero))
+  {
+    Store(SDDL(DD14),DIDE)
+  }
+  If(LNotEqual(DD15, Zero))
+  {
+    Store(SDDL(DD15),DIDF)
+  }
+
+  //
+  // Enumerate the encoders. Note that for
+  // current silicon, the maximum number of encoders
+  // possible is 15.
+  //
+  If(LEqual(NDID,1))
+  {
+    Name(TMP1,Package() {
+          0xFFFFFFFF})
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP1,0))
+    } Else {
+      Store(Or(0x10000,DID1),Index(TMP1,0))
+    }
+    Return(TMP1)
+  }
+
+  If(LEqual(NDID,2))
+  {
+    Name(TMP2,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP2,0))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP2,1))
+    } Else {
+      Store(Or(0x10000,DID2),Index(TMP2,1))
+    }
+    Return(TMP2)
+  }
+
+  If(LEqual(NDID,3))
+  {
+    Name(TMP3,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP3,0))
+    Store(Or(0x10000,DID2),Index(TMP3,1))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP3,2))
+    } Else {
+      Store(Or(0x10000,DID3),Index(TMP3,2))
+    }
+    Return(TMP3)
+  }
+
+  If(LEqual(NDID,4))
+  {
+    Name(TMP4,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP4,0))
+    Store(Or(0x10000,DID2),Index(TMP4,1))
+    Store(Or(0x10000,DID3),Index(TMP4,2))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP4,3))
+    } Else {
+      Store(Or(0x10000,DID4),Index(TMP4,3))
+    }
+    Return(TMP4)
+  }
+
+  If(LEqual(NDID,5))
+  {
+    Name(TMP5,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP5,0))
+    Store(Or(0x10000,DID2),Index(TMP5,1))
+    Store(Or(0x10000,DID3),Index(TMP5,2))
+    Store(Or(0x10000,DID4),Index(TMP5,3))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP5,4))
+    } Else {
+      Store(Or(0x10000,DID5),Index(TMP5,4))
+    }
+    Return(TMP5)
+  }
+
+  If(LEqual(NDID,6))
+  {
+    Name(TMP6,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP6,0))
+    Store(Or(0x10000,DID2),Index(TMP6,1))
+    Store(Or(0x10000,DID3),Index(TMP6,2))
+    Store(Or(0x10000,DID4),Index(TMP6,3))
+    Store(Or(0x10000,DID5),Index(TMP6,4))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP6,5))
+    } Else {
+      Store(Or(0x10000,DID6),Index(TMP6,5))
+    }
+    Return(TMP6)
+  }
+
+  If(LEqual(NDID,7))
+  {
+    Name(TMP7,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP7,0))
+    Store(Or(0x10000,DID2),Index(TMP7,1))
+    Store(Or(0x10000,DID3),Index(TMP7,2))
+    Store(Or(0x10000,DID4),Index(TMP7,3))
+    Store(Or(0x10000,DID5),Index(TMP7,4))
+    Store(Or(0x10000,DID6),Index(TMP7,5))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP7,6))
+    } Else {
+      Store(Or(0x10000,DID7),Index(TMP7,6))
+    }
+    Return(TMP7)
+  }
+
+  If(LEqual(NDID,8))
+  {
+    Name(TMP8,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP8,0))
+    Store(Or(0x10000,DID2),Index(TMP8,1))
+    Store(Or(0x10000,DID3),Index(TMP8,2))
+    Store(Or(0x10000,DID4),Index(TMP8,3))
+    Store(Or(0x10000,DID5),Index(TMP8,4))
+    Store(Or(0x10000,DID6),Index(TMP8,5))
+    Store(Or(0x10000,DID7),Index(TMP8,6))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP8,7))
+    } Else {
+      Store(Or(0x10000,DID8),Index(TMP8,7))
+    }
+    Return(TMP8)
+  }
+
+  If(LEqual(NDID,9))
+  {
+    Name(TMP9,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMP9,0))
+    Store(Or(0x10000,DID2),Index(TMP9,1))
+    Store(Or(0x10000,DID3),Index(TMP9,2))
+    Store(Or(0x10000,DID4),Index(TMP9,3))
+    Store(Or(0x10000,DID5),Index(TMP9,4))
+    Store(Or(0x10000,DID6),Index(TMP9,5))
+    Store(Or(0x10000,DID7),Index(TMP9,6))
+    Store(Or(0x10000,DID8),Index(TMP9,7))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMP9,8))
+    } Else {
+      Store(Or(0x10000,DID9),Index(TMP9,8))
+    }
+    Return(TMP9)
+  }
+
+  If(LEqual(NDID,0x0A))
+  {
+    Name(TMPA,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPA,0))
+    Store(Or(0x10000,DID2),Index(TMPA,1))
+    Store(Or(0x10000,DID3),Index(TMPA,2))
+    Store(Or(0x10000,DID4),Index(TMPA,3))
+    Store(Or(0x10000,DID5),Index(TMPA,4))
+    Store(Or(0x10000,DID6),Index(TMPA,5))
+    Store(Or(0x10000,DID7),Index(TMPA,6))
+    Store(Or(0x10000,DID8),Index(TMPA,7))
+    Store(Or(0x10000,DID9),Index(TMPA,8))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPA,9))
+    } Else {
+      Store(Or(0x10000,DIDA),Index(TMPA,9))
+    }
+    Return(TMPA)
+  }
+
+  If(LEqual(NDID,0x0B))
+  {
+    Name(TMPB,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPB,0))
+    Store(Or(0x10000,DID2),Index(TMPB,1))
+    Store(Or(0x10000,DID3),Index(TMPB,2))
+    Store(Or(0x10000,DID4),Index(TMPB,3))
+    Store(Or(0x10000,DID5),Index(TMPB,4))
+    Store(Or(0x10000,DID6),Index(TMPB,5))
+    Store(Or(0x10000,DID7),Index(TMPB,6))
+    Store(Or(0x10000,DID8),Index(TMPB,7))
+    Store(Or(0x10000,DID9),Index(TMPB,8))
+    Store(Or(0x10000,DIDA),Index(TMPB,9))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPB,10))
+    } Else {
+      Store(Or(0x10000,DIDB),Index(TMPB,10))
+    }
+    Return(TMPB)
+  }
+
+  If(LEqual(NDID,0x0C))
+  {
+    Name(TMPC,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPC,0))
+    Store(Or(0x10000,DID2),Index(TMPC,1))
+    Store(Or(0x10000,DID3),Index(TMPC,2))
+    Store(Or(0x10000,DID4),Index(TMPC,3))
+    Store(Or(0x10000,DID5),Index(TMPC,4))
+    Store(Or(0x10000,DID6),Index(TMPC,5))
+    Store(Or(0x10000,DID7),Index(TMPC,6))
+    Store(Or(0x10000,DID8),Index(TMPC,7))
+    Store(Or(0x10000,DID9),Index(TMPC,8))
+    Store(Or(0x10000,DIDA),Index(TMPC,9))
+    Store(Or(0x10000,DIDB),Index(TMPC,10))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPC,11))
+    } Else {
+      Store(Or(0x10000,DIDC),Index(TMPC,11))
+    }
+    Return(TMPC)
+  }
+
+  If(LEqual(NDID,0x0D))
+  {
+    Name(TMPD,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPD,0))
+    Store(Or(0x10000,DID2),Index(TMPD,1))
+    Store(Or(0x10000,DID3),Index(TMPD,2))
+    Store(Or(0x10000,DID4),Index(TMPD,3))
+    Store(Or(0x10000,DID5),Index(TMPD,4))
+    Store(Or(0x10000,DID6),Index(TMPD,5))
+    Store(Or(0x10000,DID7),Index(TMPD,6))
+    Store(Or(0x10000,DID8),Index(TMPD,7))
+    Store(Or(0x10000,DID9),Index(TMPD,8))
+    Store(Or(0x10000,DIDA),Index(TMPD,9))
+    Store(Or(0x10000,DIDB),Index(TMPD,10))
+    Store(Or(0x10000,DIDC),Index(TMPD,11))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPD,12))
+    } Else {
+      Store(Or(0x10000,DIDD),Index(TMPD,12))
+    }
+    Return(TMPD)
+  }
+
+  If(LEqual(NDID,0x0E))
+  {
+    Name(TMPE,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPE,0))
+    Store(Or(0x10000,DID2),Index(TMPE,1))
+    Store(Or(0x10000,DID3),Index(TMPE,2))
+    Store(Or(0x10000,DID4),Index(TMPE,3))
+    Store(Or(0x10000,DID5),Index(TMPE,4))
+    Store(Or(0x10000,DID6),Index(TMPE,5))
+    Store(Or(0x10000,DID7),Index(TMPE,6))
+    Store(Or(0x10000,DID8),Index(TMPE,7))
+    Store(Or(0x10000,DID9),Index(TMPE,8))
+    Store(Or(0x10000,DIDA),Index(TMPE,9))
+    Store(Or(0x10000,DIDB),Index(TMPE,10))
+    Store(Or(0x10000,DIDC),Index(TMPE,11))
+    Store(Or(0x10000,DIDD),Index(TMPE,12))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPE,13))
+    } Else {
+      Store(Or(0x10000,DIDE),Index(TMPE,13))
+    }
+    Return(TMPE)
+  }
+
+  If(LEqual(NDID,0x0F))
+  {
+    Name(TMPF,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPF,0))
+    Store(Or(0x10000,DID2),Index(TMPF,1))
+    Store(Or(0x10000,DID3),Index(TMPF,2))
+    Store(Or(0x10000,DID4),Index(TMPF,3))
+    Store(Or(0x10000,DID5),Index(TMPF,4))
+    Store(Or(0x10000,DID6),Index(TMPF,5))
+    Store(Or(0x10000,DID7),Index(TMPF,6))
+    Store(Or(0x10000,DID8),Index(TMPF,7))
+    Store(Or(0x10000,DID9),Index(TMPF,8))
+    Store(Or(0x10000,DIDA),Index(TMPF,9))
+    Store(Or(0x10000,DIDB),Index(TMPF,10))
+    Store(Or(0x10000,DIDC),Index(TMPF,11))
+    Store(Or(0x10000,DIDD),Index(TMPF,12))
+    Store(Or(0x10000,DIDE),Index(TMPF,13))
+    If (LEqual(IPTP,1)) {
+      //
+      // IGFX need report IPUA as GFX0 child
+      //
+      Store(0x00023480,Index(TMPF,14))
+    } Else {
+      Store(Or(0x10000,DIDF),Index(TMPF,14))
+    }
+    Return(TMPF)
+  }
+
+  If(LEqual(NDID,0x10))
+  {
+    Name(TMPG,Package() {
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF,
+          0xFFFFFFFF})
+    Store(Or(0x10000,DID1),Index(TMPG,0))
+    Store(Or(0x10000,DID2),Index(TMPG,1))
+    Store(Or(0x10000,DID3),Index(TMPG,2))
+    Store(Or(0x10000,DID4),Index(TMPG,3))
+    Store(Or(0x10000,DID5),Index(TMPG,4))
+    Store(Or(0x10000,DID6),Index(TMPG,5))
+    Store(Or(0x10000,DID7),Index(TMPG,6))
+    Store(Or(0x10000,DID8),Index(TMPG,7))
+    Store(Or(0x10000,DID9),Index(TMPG,8))
+    Store(Or(0x10000,DIDA),Index(TMPG,9))
+    Store(Or(0x10000,DIDB),Index(TMPG,10))
+    Store(Or(0x10000,DIDC),Index(TMPG,11))
+    Store(Or(0x10000,DIDD),Index(TMPG,12))
+    Store(Or(0x10000,DIDE),Index(TMPG,13))
+    Store(Or(0x10000,DIDF),Index(TMPG,14))
+    //
+    // IGFX need report IPUA as GFX0 child
+    // NDID can only be 0x10 if IPU is enabled
+    //
+    Store(0x00023480,Index(TMPG,15))
+    Return(TMPG)
+  }
+
+  //
+  // If nothing else, return Unknown LFP.
+  // (Prevents compiler warning.)
+  //
+  Return(Package() {0x00000400})
+}
+
+Device(DD01)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID1),0x400))
+    {
+      Store(0x1, EDPV)
+      Store(NXD1, NXDX)
+      Store(DID1, DIDX)
+      Return(1)
+    }
+    If(LEqual(DID1,0))
+    {
+      Return(1)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID1))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    Return(CDDS(DID1))
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD1)
+    }
+    Return(NDDS(DID1))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD02)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID2),0x400))
+    {
+      If(LEqual(And(0xF,DID2),0x1))
+      {
+        Store(0x2, EDPV)
+        Store(NXD2, NXDY)
+        Store(DID2, DIDY)
+        Return(2)
+      }
+      Store(0x2, EDPV)
+      Store(NXD2, NXDX)
+      Store(DID2, DIDX)
+      Return(2)
+    }
+    If(LEqual(DID2,0))
+    {
+      Return(2)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID2))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(LIDS,0))
+    {
+      Return(0x0)
+    }
+    Return(CDDS(DID2))
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    //
+    // Return the Next State.
+    //
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD2)
+    }
+    Return(NDDS(DID2))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD03)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID3),0x400))
+    {
+      Store(0x3, EDPV)
+      Store(NXD3, NXDX)
+      Store(DID3, DIDX)
+      Return(3)
+    }
+    If(LEqual(DID3,0))
+    {
+      Return(3)
+    }
+    Else
+    {
+    Return(And(0xFFFF,DID3))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID3,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID3))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD3)
+    }
+    Return(NDDS(DID3))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD04)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID4),0x400))
+    {
+      Store(0x4, EDPV)
+      Store(NXD4, NXDX)
+      Store(DID4, DIDX)
+      Return(4)
+    }
+    If(LEqual(DID4,0))
+    {
+      Return(4)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID4))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID4,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID4))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD4)
+    }
+    Return(NDDS(DID4))
+  }
+
+  //
+  // Device Set State. (See table above.)
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD05)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID5),0x400))
+    {
+      Store(0x5, EDPV)
+      Store(NXD5, NXDX)
+      Store(DID5, DIDX)
+      Return(5)
+    }
+    If(LEqual(DID5,0))
+    {
+      Return(5)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID5))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID5,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID5))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD5)
+    }
+    Return(NDDS(DID5))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD06)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID6),0x400))
+    {
+      Store(0x6, EDPV)
+      Store(NXD6, NXDX)
+      Store(DID6, DIDX)
+      Return(6)
+    }
+    If(LEqual(DID6,0))
+    {
+      Return(6)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID6))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID6,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID6))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD6)
+    }
+    Return(NDDS(DID6))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD07)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID7),0x400))
+    {
+      Store(0x7, EDPV)
+      Store(NXD7, NXDX)
+      Store(DID7, DIDX)
+      Return(7)
+    }
+    If(LEqual(DID7,0))
+    {
+      Return(7)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID7))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID7,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID7))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD7)
+    }
+    Return(NDDS(DID7))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD08)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID8),0x400))
+    {
+      Store(0x8, EDPV)
+      Store(NXD8, NXDX)
+      Store(DID8, DIDX)
+      Return(8)
+    }
+    If(LEqual(DID8,0))
+    {
+      Return(8)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID8))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID8,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID8))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DID8))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD09)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DID9),0x400))
+    {
+      Store(0x9, EDPV)
+      Store(NXD8, NXDX)
+      Store(DID9, DIDX)
+      Return(9)
+    }
+    If(LEqual(DID9,0))
+    {
+      Return(9)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DID9))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DID9,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DID9))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DID9))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0A)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDA),0x400))
+    {
+      Store(0xA, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDA, DIDX)
+      Return(0x0A)
+    }
+    If(LEqual(DIDA,0))
+    {
+      Return(0x0A)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDA))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDA,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DIDA))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDA))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0B)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDB),0x400))
+    {
+      Store(0xB, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDB, DIDX)
+      Return(0X0B)
+    }
+    If(LEqual(DIDB,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDB))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDB,0))
+    {
+      Return(0x0B)
+    }
+    Else
+    {
+      Return(CDDS(DIDB))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDB))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0C)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDC),0x400))
+    {
+      Store(0xC, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDC, DIDX)
+      Return(0X0C)
+    }
+    If(LEqual(DIDC,0))
+    {
+      Return(0x0C)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDC))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDC,0))
+    {
+      Return(0x0C)
+    }
+    Else
+    {
+      Return(CDDS(DIDC))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDC))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0D)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDD),0x400))
+    {
+      Store(0xD, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDD, DIDX)
+      Return(0X0D)
+    }
+    If(LEqual(DIDD,0))
+    {
+      Return(0x0D)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDD))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDD,0))
+    {
+      Return(0x0D)
+    }
+    Else
+    {
+      Return(CDDS(DIDD))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDD))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0E)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDE),0x400))
+    {
+      Store(0xE, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDE, DIDX)
+      Return(0X0E)
+    }
+    If(LEqual(DIDE,0))
+    {
+      Return(0x0E)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDE))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDE,0))
+    {
+      Return(0x0E)
+    }
+    Else
+    {
+      Return(CDDS(DIDE))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDE))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+Device(DD0F)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(And(0x0F00,DIDF),0x400))
+    {
+      Store(0xF, EDPV)
+      Store(NXD8, NXDX)
+      Store(DIDF, DIDX)
+      Return(0X0F)
+    }
+    If(LEqual(DIDF,0))
+    {
+      Return(0x0F)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDF))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(DIDC,0))
+    {
+      Return(0x0F)
+    }
+    Else
+    {
+      Return(CDDS(DIDF))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXD8)
+    }
+    Return(NDDS(DIDF))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+}
+
+//
+//Device for eDP
+//
+Device(DD1F)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(EDPV, 0x0))
+    {
+      Return(0x1F)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDX))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(EDPV, 0x0))
+    {
+      Return(0x00)
+    }
+    Else
+    {
+      Return(CDDS(DIDX))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXDX)
+    }
+    Return(NDDS(DIDX))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+
+  //
+  // Query List of Brightness Control Levels Supported.
+  //
+  Method(_BCL,0)
+  {
+    //
+    // List of supported brightness levels in the following sequence.
+    // Level when machine has full power.
+    // Level when machine is on batteries.
+    // Other supported levels.
+    //
+    If(CondRefOf(\PBCL)) {
+      Return (PBCL())
+    } Else {
+      Return(Package(){80, 50, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100})
+    }
+  }
+
+  //
+  // Set the Brightness Level.
+  //
+  Method (_BCM,1)
+  {
+    //
+    // Set the requested level if it is between 0 and 100%.
+    //
+    If(LAnd(LGreaterEqual(Arg0,0),LLessEqual(Arg0,100)))
+    {
+      \_SB.PC00.GFX0.AINT(1, Arg0)
+      Store(Arg0,BRTL)  // Store Brightness Level.
+    }
+  }
+
+  //
+  // Brightness Query Current level.
+  //
+  Method (_BQC,0)
+  {
+    Return(BRTL)
+  }
+
+  //
+  // Physical Location of Device
+  //
+  Method (_PLD,0)
+  {
+    If(CondRefOf(\PLD1)) {
+      Return (PLD1())
+    } Else {
+      Return (DPLD)
+    }
+  }
+}
+
+//
+// Second Display
+//
+Device(DD2F)
+{
+  //
+  // Return Unique ID.
+  //
+  Method(_ADR,0,Serialized)
+  {
+    If(LEqual(EDPV, 0x0))
+    {
+      Return(0x1F)
+    }
+    If(LEqual(EDPV, 0x1))
+    {
+      Return(0x1F)
+    }
+    Else
+    {
+      Return(And(0xFFFF,DIDY))
+    }
+  }
+
+  //
+  // Return the Current Status.
+  //
+  Method(_DCS,0)
+  {
+    If(LEqual(EDPV, 0x0))
+    {
+      Return(0x00)
+    }
+    If(LEqual(EDPV, 0x1))
+    {
+      Return(0x0)
+    }
+    Else
+    {
+      Return(CDDS(DIDY))
+    }
+  }
+
+  //
+  // Query Graphics State (active or inactive).
+  //
+  Method(_DGS,0)
+  {
+    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
+    {
+      Return (NXDY)
+    }
+    Return(NDDS(DIDY))
+  }
+
+  //
+  // Device Set State.
+  //
+  Method(_DSS,1)
+  {
+    DSST(Arg0)
+  }
+
+  //
+  // Query List of Brightness Control Levels Supported.
+  //
+  Method(_BCL,0)
+  {
+    //
+    // List of supported brightness levels in the following sequence.
+    // Level when machine has full power.
+    // Level when machine is on batteries.
+    // Other supported levels.
+    //
+    If(CondRefOf(\PBCL)) {
+      Return (PBCL())
+    } Else {
+      Return(Package(){80, 50, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100})
+    }
+  }
+
+  //
+  // Set the Brightness Level.
+  //
+  Method (_BCM,1)
+  {
+    //
+    // Set the requested level if it is between 0 and 100%.
+    //
+    If(LAnd(LGreaterEqual(Arg0,0),LLessEqual(Arg0,100)))
+    {
+      \_SB.PC00.GFX0.AINT(1, Arg0)
+      Store(Arg0,BRTL)  // Store Brightness Level.
+    }
+  }
+
+  //
+  // Brightness Query Current level.
+  //
+  Method (_BQC,0)
+  {
+    Return(BRTL)
+  }
+
+  Method (_PLD,0)
+  {
+    If(CondRefOf(\PLD2)) {
+      Return (PLD2())
+    } Else {
+      Return (DPLD)
+    }
+  }
+}
+
+Method(SDDL,1)
+{
+  Increment(NDID)
+  Store(And(Arg0,0xF0F),Local0)
+  Or(0x80000000,Local0, Local1)
+  If(LEqual(DIDL,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL2,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL3,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL4,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL5,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL6,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL7,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL8,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DDL9,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD10,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD11,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD12,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD13,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD14,Local0))
+  {
+    Return(Local1)
+  }
+  If(LEqual(DD15,Local0))
+  {
+    Return(Local1)
+  }
+  Return(0)
+}
+
+Method(CDDS,1)
+{
+  Store(And(Arg0,0xF0F),Local0)
+
+  If(LEqual(0, Local0))
+  {
+    Return(0x1D)
+  }
+  If(LEqual(CADL, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL2, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL3, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL4, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL5, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL6, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL7, Local0))
+  {
+    Return(0x1F)
+  }
+  If(LEqual(CAL8, Local0))
+  {
+    Return(0x1F)
+  }
+  Return(0x1D)
+}
+
+Method(NDDS,1)
+{
+  Store(And(Arg0,0xF0F),Local0)
+
+  If(LEqual(0, Local0))
+  {
+    Return(0)
+  }
+  If(LEqual(NADL, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL2, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL3, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL4, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL5, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL6, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL7, Local0))
+  {
+    Return(1)
+  }
+  If(LEqual(NDL8, Local0))
+  {
+    Return(1)
+  }
+  Return(0)
+}
+
+//
+// Device Set State Table
+//  BIT31  BIT30  Execution
+//  0  0  Don't implement.
+//  0  1  Cache change.  Nothing to Implement.
+//  1  0  Don't Implement.
+//  1  1  Display Switch Complete.  Implement.
+//
+Method(DSST,1)
+{
+  If(LEqual(And(Arg0,0xC0000000),0xC0000000))
+  {
+    //
+    // State change was performed by the
+    // Video Drivers.  Simply update the
+    // New State.
+    //
+    Store(NSTE,CSTE)
+  }
+}
+
+//
+// Include IGD OpRegion/Software SCI interrupt handler/DSM which is used by
+// the graphics drivers to request data from system BIOS.
+//
+include ("IgfxOpRn.asl")
+include ("IgfxDsm.asl")
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommon.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommon.asl
new file mode 100644
index 0000000000..7325b9fdea
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommon.asl
@@ -0,0 +1,480 @@
+/** @file
+  IGD OpRegion/Software SCI Reference Code.
+  This file contains ASL code with the purpose of handling events
+  i.e. hotkeys and other system interrupts.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+//
+// Notes:
+// 1. The following routines are to be called from the appropriate event
+//    handlers.
+// 2. This code cannot comprehend the exact implementation in the OEM's BIOS.
+//    Therefore, an OEM must call these methods from the existing event
+//    handler infrastructure.  Details on when/why to call each method is
+//    included in the method header under the "usage" section.
+//
+
+/************************************************************************;
+;* ACPI Notification Methods
+;************************************************************************/
+
+
+/************************************************************************;
+;*
+;* Name:        PDRD
+;*
+;* Description: Check if the graphics driver is ready to process
+;*              notifications and video extensions.
+;*
+;* Usage:       This method is to be called prior to performing any
+;*              notifications or handling video extensions.
+;*              Ex: If (PDRD()) {Return (FAIL)}
+;*
+;* Input:       None
+;*
+;* Output:      None
+;*
+;* References:  DRDY (Driver ready status), ASLP (Driver recommended
+;*              sleep timeout value).
+;*
+;************************************************************************/
+
+External(HNOT, MethodObj)
+
+Method(PDRD)
+{
+  //
+  // If DRDY is clear, the driver is not ready.  If the return value is
+  // !=0, do not perform any notifications or video extension handling.
+  //
+  Return(LNot(DRDY))
+}
+
+/************************************************************************;
+;*
+;* Name:        PSTS
+;*
+;* Description: Check if the graphics driver has completed the previous
+;*              "notify" command.
+;*
+;* Usage:       This method is called before every "notify" command.  A
+;*              "notify" should only be set if the driver has completed the
+;*              previous command.  Else, ignore the event and exit the parent
+;*              method.
+;*              Ex: If (PSTS()) {Return (FAIL)}
+;*
+;* Input:       None
+;*
+;* Output:      None
+;*
+;* References:  CSTS (Notification status), ASLP (Driver recommended sleep
+;*              timeout value).
+;*
+;************************************************************************/
+
+Method(PSTS)
+{
+  If(LGreater(CSTS, 2))
+  {
+    //
+    // Sleep for ASLP milliseconds if the status is not "success,
+    // failure, or pending"
+    //
+    Sleep(ASLP)
+  }
+
+  Return(LEqual(CSTS, 3)) // Return True if still Dispatched
+}
+
+/************************************************************************;
+;*
+;* Name:  GNOT
+;*
+;* Description: Call the appropriate methods to query the graphics driver
+;*              status.  If all methods return success, do a notification of
+;*              the graphics device.
+;*
+;* Usage:       This method is to be called when a graphics device
+;*              notification is required (display switch hotkey, etc).
+;*
+;* Input:       Arg0 = Current event type:
+;*                1 = display switch
+;*                2 = lid
+;*                3 = dock
+;*              Arg1 = Notification type:
+;*                0 = Re-enumeration
+;*                0x80 = Display switch
+;*
+;* Output:      Returns 0 = success, 1 = failure
+;*
+;* References:  PDRD and PSTS methods.  OSYS (OS version)
+;*
+;************************************************************************/
+
+Method(GNOT, 2)
+{
+  //
+  // Check for 1. Driver loaded, 2. Driver ready.
+  // If any of these cases is not met, skip this event and return failure.
+  //
+  If(PDRD())
+  {
+    Return(0x1) // Return failure if driver not loaded.
+  }
+
+  Store(Arg0, CEVT) // Set up the current event value
+  Store(3, CSTS) // CSTS=BIOS dispatched an event
+
+  If(LAnd(LEqual(CHPD, 0), LEqual(Arg1, 0))) // Do not re-enum if driver supports hotplug
+  {
+    //
+    // Re-enumerate the Graphics Device for non-XP operating systems.
+    //
+    Notify(\_SB.PC00.GFX0, Arg1)
+  }
+
+  If(CondRefOf(HNOT))
+  {
+    HNOT(Arg0)  //Notification handler for Hybrid graphics
+  }
+  Else
+  {
+    Notify(\_SB.PC00.GFX0,0x80)
+  }
+
+  Return(0x0) // Return success
+}
+
+/************************************************************************;
+;*
+;* Name:        GHDS
+;*
+;* Description: Handle a hotkey display switching event (performs a
+;*              Notify(GFX0, 0).
+;*
+;* Usage:       This method must be called when a hotkey event occurs and the
+;*              purpose of that hotkey is to do a display switch.
+;*
+;* Input:       Arg0 = Toggle table number.
+;*
+;* Output:      Returns 0 = success, 1 = failure.
+;*              CEVT and TIDX are indirect outputs.
+;*
+;* References:  TIDX, GNOT
+;*
+;************************************************************************/
+
+Method(GHDS, 1)
+{
+  Store(Arg0, TIDX) // Store the table number
+  //
+  // Call GNOT for CEVT = 1 = hotkey, notify value = 0
+  //
+  Return(GNOT(1, 0)) // Return stats from GNOT
+}
+
+/************************************************************************;
+;*
+;* Name:        GLID
+;*
+;* Description: Handle a lid event (performs the Notify(GFX0, 0), but not the
+;*              lid notify).
+;*
+;* Usage:       This method must be called when a lid event occurs.  A
+;*              Notify(LID0, 0x80) must follow the call to this method.
+;*
+;* Input:       Arg0 = Lid state:
+;*                0 = All closed
+;*                1 = internal LFP lid open
+;*                2 = external lid open
+;*                3 = both external and internal open
+;*
+;* Output:      Returns 0=success, 1=failure.
+;*              CLID and CEVT are indirect outputs.
+;*
+;* References:  CLID, GNOT
+;*
+;************************************************************************/
+
+Method(GLID, 1)
+{
+
+  If (LEqual(Arg0,1))
+  {
+    Store(3,CLID)
+  }
+  Else
+  {
+    Store(Arg0, CLID)
+  }
+  //
+  //Store(Arg0, CLID) // Store the current lid state
+  // Call GNOT for CEVT=2=Lid, notify value = 0
+  //
+  if (GNOT(2, 0)) {
+    Or (CLID, 0x80000000, CLID)
+    Return (1) // Return Fail
+  }
+
+  Return (0) // Return Pass
+}
+
+/************************************************************************;
+;*
+;* Name:  GDCK
+;*
+;* Description: Handle a docking event by updating the current docking status
+;*              and doing a notification.
+;*
+;* Usage:       This method must be called when a docking event occurs.
+;*
+;* Input:       Arg0 = Docking state:
+;*                0 = Undocked
+;*                1 = Docked
+;*
+;* Output:      Returns 0=success, 1=failure.
+;*              CDCK and CEVT are indirect outputs.
+;*
+;* References:  CDCK, GNOT
+;*
+;************************************************************************/
+
+Method(GDCK, 1)
+{
+  Store(Arg0, CDCK) // Store the current dock state
+  //
+  // Call GNOT for CEVT=4=Dock, notify value = 0
+  //
+  Return(GNOT(4, 0)) // Return stats from GNOT
+}
+
+/************************************************************************;
+;* ASLE Interrupt Methods
+;************************************************************************/
+
+/************************************************************************;
+;*
+;* Name:        PARD
+;*
+;* Description: Check if the driver is ready to handle ASLE interrupts
+;*              generate by the system BIOS.
+;*
+;* Usage:       This method must be called before generating each ASLE
+;*              interrupt.
+;*
+;* Input:       None
+;*
+;* Output:      Returns 0 = success, 1 = failure.
+;*
+;* References:  ARDY (Driver readiness), ASLP (Driver recommended sleep
+;*              timeout value)
+;*
+;************************************************************************/
+
+Method(PARD)
+{
+  If(LNot(ARDY))
+  {
+    //
+    // Sleep for ASLP milliseconds if the driver is not ready.
+    //
+    Sleep(ASLP)
+  }
+  //
+  // If ARDY is clear, the driver is not ready.  If the return value is
+  // !=0, do not generate the ASLE interrupt.
+  //
+  Return(LNot(ARDY))
+}
+
+//
+// Intel Ultrabook Event Handler.  Arg0 represents the Ultrabook Event Bit # to pass
+// to the Intel Graphics Driver.  Note that this is a serialized method, meaning
+// sumultaneous events are not allowed.
+//
+Method(IUEH,1,Serialized)
+{
+  And(IUER,0xC0,IUER) // Clear all button events on entry.
+  XOr(IUER,Shiftleft(1,Arg0),IUER) // Toggle status.
+
+  If(LLessEqual(Arg0,4)) // Button Event?
+  {
+    Return(AINT(5,0)) // Generate event and return status.
+
+  }
+  Else // Indicator Event.
+  {
+    Return(AINT(Arg0,0)) // Generate event and return status.
+  }
+}
+
+/************************************************************************;
+;*
+;* Name:        AINT
+;*
+;* Description: Call the appropriate methods to generate an ASLE interrupt.
+;*              This process includes ensuring the graphics driver is ready
+;*              to process the interrupt, ensuring the driver supports the
+;*              interrupt of interest, and passing information about the event
+;*              to the graphics driver.
+;*
+;* Usage:       This method must called to generate an ASLE interrupt.
+;*
+;* Input:       Arg0 = ASLE command function code:
+;*                0 = Set ALS illuminance
+;*                1 = Set backlight brightness
+;*                2 = Do Panel Fitting
+;*                4 = Reserved
+;*                5 = Button Indicator Event
+;*                6 = Convertible Indicator Event
+;*                7 = Docking Indicator Event
+;*              Arg1 = If Arg0 = 0, current ALS reading:
+;*                0 = Reading below sensor range
+;*                1-0xFFFE = Current sensor reading
+;*                0xFFFF = Reading above sensor range
+;*              Arg1 = If Arg0 = 1, requested backlight percentage
+;*
+;* Output:      Returns 0 = success, 1 = failure
+;*
+;* References:  PARD method.
+;*
+;************************************************************************/
+
+Method(AINT, 2)
+{
+  //
+  // Return failure if the requested feature is not supported by the
+  // driver.
+  //
+  If(LNot(And(TCHE, ShiftLeft(1, Arg0))))
+  {
+    Return(0x1)
+  }
+  //
+  // Return failure if the driver is not ready to handle an ASLE
+  // interrupt.
+  //
+  If(PARD())
+  {
+    Return(0x1)
+  }
+  //
+  // Handle Intel Ultrabook Events.
+  //
+  If(LAnd(LGreaterEqual(Arg0,5),LLessEqual(Arg0,7)))
+  {
+    Store(ShiftLeft(1,Arg0), ASLC) // Set Ultrbook Event [6:4].
+    Store(0x01, ASLE) // Generate ASLE interrupt
+
+    Store(0,Local2) // Use Local2 as a timeout counter.  Intialize to zero.
+
+    While(LAnd(LLess(Local2,250),LNotEqual(ASLC,0))) // Wait 1 second or until Driver ACKs a success.
+    {
+      Sleep(4) // Delay 4 ms.
+      Increment(Local2) // Increment Timeout.
+    }
+
+    Return(0) // Return success
+  }
+  //
+  // Evaluate the first argument (Panel fitting, backlight brightness, or ALS).
+  //
+  If(LEqual(Arg0, 2))         // Arg0 = 2, so request a panel fitting mode change.
+  {
+    If(CPFM)                  // If current mode field is non-zero use it.
+    {
+      And(CPFM, 0x0F, Local0) // Create variables without reserved
+      And(EPFM, 0x0F, Local1) // or valid bits.
+
+      If(LEqual(Local0, 1))   // If current mode is centered,
+      {
+        If(And(Local1, 6))    // and if stretched is enabled,
+        {
+          Store(6, PFIT)      // request stretched.
+        }
+        Else                  // Otherwise,
+        {
+          If(And(Local1, 8))  // if aspect ratio is enabled,
+          {
+            Store(8, PFIT)    // request aspect ratio.
+          }
+          Else                // Only centered mode is enabled
+          {
+            Store(1, PFIT)    // so request centered. (No change.)
+          }
+        }
+      }
+      If(LEqual(Local0, 6))   // If current mode is stretched,
+      {
+        If(And(Local1, 8))    // and if aspect ratio is enabled,
+        {
+          Store(8, PFIT)      // request aspect ratio.
+        }
+        Else                  // Otherwise,
+        {
+          If(And(Local1, 1))  // if centered is enabled,
+          {
+            Store(1, PFIT)    // request centered.
+          }
+          Else                // Only stretched mode is enabled
+          {
+            Store(6, PFIT)    // so request stretched. (No change.)
+          }
+        }
+      }
+      If(LEqual(Local0, 8))   // If current mode is aspect ratio,
+      {
+        If(And(Local1, 1))    // and if centered is enabled,
+        {
+          Store(1, PFIT)      // request centered.
+        }
+        Else                  // Otherwise,
+        {
+          If(And(Local1, 6))  // if stretched is enabled,
+          {
+            Store(6, PFIT)    // request stretched.
+          }
+          Else                // Only aspect ratio mode is enabled
+          {
+            Store(8, PFIT)    // so request aspect ratio. (No change.)
+          }
+        }
+      }
+    }
+    //
+    // The following code for panel fitting (within the Else condition) is retained for backward compatiblity.
+    //
+    Else                      // If CFPM field is zero use PFIT and toggle the
+    {
+      Xor(PFIT,7,PFIT)        // mode setting between stretched and centered only.
+    }
+    Or(PFIT,0x80000000,PFIT)  // Set the valid bit for all cases.
+    Store(4, ASLC)            // Store "Panel fitting event" to ASLC[31:1]
+  }
+  Else
+  {
+    If(LEqual(Arg0, 1)) // Arg0=1, so set the backlight brightness.
+    {
+      Store(Divide(Multiply(Arg1, 255), 100), BCLP) // Convert from percent to 0-255.
+      Or(BCLP, 0x80000000, BCLP) // Set the valid bit.
+      Store(2, ASLC) // Store "Backlight control event" to ASLC[31:1]
+    }
+    Else
+    {
+      If(LEqual(Arg0, 0)) // Arg0=0, so set the ALS illuminace
+      {
+        Store(Arg1, ALSI)
+        Store(1, ASLC) // Store "ALS event" to ASLC[31:1]
+      }
+      Else
+      {
+        Return(0x1) // Unsupported function
+      }
+    }
+  }
+
+  Store(0x01, ASLE) // Generate ASLE interrupt
+  Return(0x0) // Return success
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
new file mode 100644
index 0000000000..ecd87e8c1f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
@@ -0,0 +1,398 @@
+/** @file
+  IGD OpRegion/_DSM Reference Code.
+  This file contains Get BIOS Data and Callback functions for
+  the Integrated Graphics Device (IGD) OpRegion/DSM mechanism
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+External(\_SB.PC00.IMMC, MethodObj)
+External(\_SB.PC00.IMMD, MethodObj)
+
+//
+// _DSM Device Specific Method
+//
+// Arg0: UUID Unique function identifier
+// Arg1: Integer Revision Level
+// Arg2: Integer Function Index (1 = Return Supported Functions)
+// Arg3: Additional Inputs/Package Parameters Bits [31:0] input as {Byte0, Byte1, Byte2, Byte3} to BIOS which is passed as 32 bit DWORD by Driver
+//
+Method (_DSM, 4, Serialized, 0, UnknownObj, {BuffObj, IntObj, IntObj, PkgObj}) {
+
+  If (LEqual(Arg0, ToUUID ("3E5B41C6-EB1D-4260-9D15-C71FBADAE414"))) {
+    //
+    // _DSM Definition for Igd functions
+    // Arguments:
+    // Arg0: UUID: 3E5B41C6-EB1D-4260-9D15-C71FBADAE414
+    // Arg1: Revision ID: 1
+    // Arg2: Function Index: 16
+    // Arg3: Additional Inputs Bits[31:0] Arg3 {Byte0, Byte1, Byte2, Byte3}
+    //
+    // Return:
+    // Success for simple notification, Opregion update for some routines and a Package for AKSV
+    //
+    If (Lor(LEqual(Arg2,18),LEqual(Arg2,19))) {
+      CreateDwordField(Arg3, 0x0, DDIN)
+      CreateDwordField(Arg3, 0x4, BUF1)
+      //
+      // OPTS is return buffer from IOM mailbox -
+      // Byte[0] is Status field.
+      // BYTE[1] is HDP Count.
+      //
+      Name(OPTS, Buffer(4){0,0,0,0})
+      CreateByteField(OPTS, 0x00, CMST) // Command Status field
+                                        //         Success - 0
+                                        //         Fail    - 1
+      CreateByteField(OPTS, 0x01, RTB1) // Return Buffer 1
+
+      //
+      // Gfx Empty Dongle Buffer is data for return DSM fun#
+      // with below buffer format
+      // Byte[0-3] is Data field.
+      // Byte[4] is Status field.
+      //
+      Name(GEDB, Buffer(5){0,0,0,0,0})
+      CreateDwordField(GEDB, 0x00, GEDF) // Gfx Empty Dongle Data Field
+      CreateByteField(GEDB, 0x04, GESF)  // Gfx Empty Dongle Status Field
+                                         //         Success - 0
+                                         //         Fail    - None 0
+    }
+
+    //
+    // Switch by function index
+    //
+    Switch(ToInteger(Arg2)) {
+      //
+      // Function Index: 0
+      // Standard query - A bitmask of functions supported
+      //
+      // Return: A bitmask of functions supported
+      //
+      Case (0)
+      {
+        If (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+          Store("iGfx Supported Functions Bitmap ", Debug)
+
+          Return(0xDE7FF)
+        }
+      }
+
+      //
+      // Function Index: 1
+      // Adapter Power State Notification
+      // Arg3 Bits [7:0]: Adapter Power State bits [7:0] from Driver 00h = D0; 01h = D1; 02h = D2; 04h = D3 (Cold/Hot); 08h = D4 (Hibernate Notification)
+      // Return: Success
+      //
+      Case(1) {
+        If (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+          Store(" Adapter Power State Notification ", Debug)
+
+          //
+          // Handle Low Power S0 Idle Capability if enabled
+          //
+          If(LAnd(LEqual(S0ID, 1),LLess(OSYS, 2015))) {
+            //
+            // Call GUAM to trigger CS Entry
+            //   If Adapter Power State Notification = D1 (Arg3[0]=0x01)
+            //
+            If (LEqual (And(DerefOf (Index (Arg3,0)), 0xFF), 0x01)) {
+              // GUAM - Global User Absent Mode Notification Method
+              \GUAM(One) // 0x01 - Power State Standby (CS Entry)
+            }
+            Store(And(DerefOf (Index (Arg3,1)), 0xFF), Local0)
+            //
+            // Call GUAM
+            // If Display Turn ON Notification (Arg3 [1] == 0) for CS Exit
+            //
+            If (LEqual (Local0, 0)) {
+              // GUAM - Global User Absent Mode Notification Method
+              \GUAM(0)
+            }
+          }
+
+          // Upon notification from driver that the Adapter Power State = D0,
+          // check if previous lid event failed.  If it did, retry the lid
+          // event here.
+          If(LEqual(DerefOf (Index (Arg3,0)), 0)) {
+            Store(CLID, Local0)
+            If(And(0x80000000,Local0)) {
+              And(CLID, 0x0000000F, CLID)
+              GLID(CLID)
+            }
+          }
+          Return(0x01)
+        }
+      }
+      //
+      // Function Index: 2
+      // Display Power State Notification
+      // Arg3: Display Power State Bits [15:8]
+      // 00h = On
+      // 01h = Standby
+      // 02h = Suspend
+      // 04h = Off
+      // 08h = Reduced On
+      // Return: Success
+      //
+     Case(2) {
+        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+
+          Store("Display Power State Notification ", Debug)
+          Return(0x01)
+        }
+      }
+
+      //
+      // Function Index: 3
+      // BIOS POST Completion Notification
+      // Return: Success
+      //
+      Case(3) {
+        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+          Store("BIOS POST Completion Notification ", Debug)
+          Return(0x01)      // Not supported, but no failure
+        }
+      }
+
+      //
+      // Function Index: 4
+      // Pre-Hires Set Mode
+      // Return: Success
+      //
+      Case(4) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("Pre-Hires Set Mode ", Debug)
+          Return(0x01)      // Not supported, but no failure
+        }
+      }
+
+      //
+      // Function Index: 5
+      // Post-Hires Set Mode
+      // Return: Success
+      //
+      Case(5) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("Post-Hires Set Mode ", Debug)
+          Return(0x01)      // Not supported, but no failure
+        }
+      }
+
+      //
+      // Function Index: 6
+      // SetDisplayDeviceNotification (Display Switch)
+      // Return: Success
+      //
+      Case(6) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("SetDisplayDeviceNotification", Debug)
+          Return(0x01)      // Not supported, but no failure
+        }
+      }
+
+      //
+      // Function Index: 7
+      // SetBootDevicePreference
+      // Return: Success
+      //
+      Case(7) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          //<TODO> An OEM may elect to implement this method.  In that case,
+          // the input values must be saved into non-volatile storage for
+          // parsing during the next boot.  The following Sample code is Intel
+          // validated implementation.
+
+          Store("SetBootDevicePreference ", Debug)
+          And(DerefOf (Index (Arg3,0)), 0xFF, IBTT) // Save the boot display to NVS
+          Return(0x01)
+        }
+      }
+
+      //
+      // Function Index: 8
+      // SetPanelPreference
+      // Return: Success
+      //
+      Case(8) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          // An OEM may elect to implement this method.  In that case,
+          // the input values must be saved into non-volatile storage for
+          // parsing during the next boot.  The following Sample code is Intel
+          // validated implementation.
+
+          Store("SetPanelPreference ", Debug)
+
+          // Set the panel-related NVRAM variables based the input from the driver.
+          And(DerefOf (Index (Arg3,0)), 0xFF, IPSC)
+
+          // Change panel type if a change is requested by the driver (Change if
+          // panel type input is non-zero).  Zero=No change requested.
+          If(And(DerefOf (Index (Arg3,1)), 0xFF)) {
+            And(DerefOf (Index (Arg3,1)), 0xFF, IPAT)
+            Decrement(IPAT)    // 0 = no change, so fit to CMOS map
+          }
+          And(ShiftRight(DerefOf (Index (Arg3,2)), 4), 0x7, IBIA)
+          Return(0x01)         // Success
+        }
+      }
+
+      //
+      // Function Index: 9
+      // FullScreenDOS
+      // Return: Success
+      //
+      Case(9) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("FullScreenDOS ", Debug)
+          Return(0x01)      // Not supported, but no failure
+        }
+      }
+
+      //
+      // Function Index: 10
+      // APM Complete
+      // Return: Adjusted Lid State
+      //
+     Case(10) {
+        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+
+          Store("APM Complete ", Debug)
+          Store(ShiftLeft(LIDS, 8), Local0) // Report the lid state
+          Add(Local0, 0x100, Local0)        // Adjust the lid state, 0 = Unknown
+          Return(Local0)
+        }
+      }
+
+      //
+      //
+      // Function Index: 13
+      // GetBootDisplayPreference
+      // Arg3 Bits [30:16] : Boot Device Ports
+      // Arg3 Bits [7:0] : Boot Device Type
+      // Return: Boot device port and Boot device type from saved configuration
+      //
+     Case(13) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+
+          Store("GetBootDisplayPreference ", Debug)
+          Or(ShiftLeft(DerefOf (Index (Arg3,3)), 24), ShiftLeft(DerefOf (Index (Arg3,2)), 16), Local0) // Combine Arg3 Bits [31:16]
+          And(Local0, 0xEFFF0000, Local0)
+          And(Local0, ShiftLeft(DeRefOf(Index(DBTB, IBTT)), 16), Local0)
+          Or(IBTT, Local0, Local0) // Arg3 Bits [7:0] = Boot device type
+          Return(Local0)
+        }
+      }
+
+      //
+      // Function Index: 14
+      // GetPanelDetails
+      // Return: Different Panel Settings
+      //
+      Case(14) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("GetPanelDetails ", Debug)
+
+          // Report the scaling setting
+          // Bits [7:0] - Panel Scaling
+          // Bits contain the panel scaling user setting from CMOS
+          // 00h = On: Auto
+          // 01h = On: Force Scaling
+          // 02h = Off
+          // 03h = Maintain Aspect Ratio
+
+          Store(IPSC, Local0)
+          Or(Local0, ShiftLeft(IPAT, 8), Local0)
+
+          // Adjust panel type, 0 = VBT default
+          // Bits [15:8] - Panel Type
+          // Bits contain the panel type user setting from CMOS
+          // 00h = Not Valid, use default Panel Type & Timings from VBT
+          // 01h - 0Fh = Panel Number
+
+          Add(Local0, 0x100, Local0)
+
+          // Report the lid state and Adjust it
+          // Bits [16] - Lid State
+          // Bits contain the current panel lid state
+          // 0 = Lid Open
+          // 1 = Lid Closed
+
+          Or(Local0, ShiftLeft(LIDS, 16), Local0)
+          Add(Local0, 0x10000, Local0)
+
+         // Report the BIA setting
+         // Bits [22:20] - Backlight Image Adaptation (BIA) Control
+         // Bits contain the backlight image adaptation control user setting from CMOS
+         // 000 = VBT Default
+         // 001 = BIA Disabled (BLC may still be enabled)
+         // 010 - 110 = BIA Enabled at Aggressiveness Level [1 - 5]
+
+          Or(Local0, ShiftLeft(IBIA, 20), Local0)
+          Return(Local0)
+        }
+      }
+
+      //
+      // Function Index: 15
+      // GetInternalGraphics
+      // Return: Different Internal Grahics Settings
+      //
+
+      Case(15) {
+        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
+          Store("GetInternalGraphics ", Debug)
+
+          Store(GIVD, Local0)                    // Local0[0]      - VGA mode(1=VGA)
+          Xor(Local0, 1, Local0)                 // Invert the VGA mode polarity
+
+          Or(Local0, ShiftLeft(GMFN, 1), Local0) // Local0[1]      - # IGD PCI functions-1
+                                                 // Local0[3:2]    - Reserved
+                                                 // Local0[4]      - IGD D3 support(0=cold)
+                                                 // Local0[10:5]   - Reserved
+          Or(Local0, ShiftLeft(3, 11), Local0)   // Local0[12:11]  - DVMT version (11b = 5.0)
+
+          //
+          // Report DVMT 5.0 Total Graphics memory size.
+          //
+          Or(Local0, ShiftLeft(IDMS, 17), Local0) // Bits 20:17 are for Gfx total memory size
+
+          // If the "Set Internal Graphics" call is supported, the modified
+          // settings flag must be programmed per the specification.  This means
+          // that the flag must be set to indicate that system BIOS requests
+          // these settings.  Once "Set Internal Graphics" is called, the
+          //  modified settings flag must be cleared on all subsequent calls to
+          // this function.
+
+          // Report the graphics frequency based on B0:D2:F0:RF0h[12].  Must
+          // take into account the current VCO.
+
+          Or(ShiftLeft(DeRefOf(Index(DeRefOf(Index(CDCT, HVCO)), CDVL)), 21),Local0, Local0)
+          Return(Local0)
+        }
+      }
+
+      //
+      // Function Index: 16
+      // GetAKSV
+      // Retrun: 5 bytes of AKSV
+      //
+      Case(16) {
+        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
+
+          Store("GetAKSV ", Debug)
+          Name (KSVP, Package()
+          {
+             0x80000000,
+             0x8000
+          })
+          Store(KSV0, Index(KSVP,0)) // First four bytes of AKSV
+          Store(KSV1, Index(KSVP,1)) // Fifth byte of AKSV
+          Return(KSVP) // Success
+        }
+      }
+    } // End of switch(Arg2)
+  } // End of if (ToUUID("3E5B41C6-EB1D-4260-9D15-C71FBADAE414D"))
+
+  Return (Buffer () {0x00})
+} // End of _DSM
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.asl
new file mode 100644
index 0000000000..2b5f2393b0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.asl
@@ -0,0 +1,127 @@
+/** @file
+  IGD OpRegion/Software SCI Reference Code.
+  This file contains Get BIOS Data Area funciton support for
+  the Integrated Graphics Device (IGD) OpRegion/Software SCI mechanism
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+Method (GBDA, 0, Serialized)
+{
+  //
+  // Supported calls: Sub-function 0
+  //
+  If (LEqual(GESF, 0))
+  {
+    //
+    //<NOTE> Reference code is set to Intel's validated implementation.
+    //
+    Store(0x0000659, PARM)
+    Store(Zero, GESF) // Clear the exit parameter
+    Return(SUCC) // Success
+  }
+  //
+  // Requested callbacks: Sub-function 1
+  //
+  If (LEqual(GESF, 1))
+  {
+    //
+    //<NOTE> Call back functions are where the driver calls the
+    // system BIOS at function indicated event.
+    //
+    Store(0x300482, PARM)
+    If(LEqual(S0ID, One)){
+      Or(PARM, 0x100, PARM) //Request Fn 8 callback in CS systems
+    }
+    Store(Zero, GESF) // Clear the exit parameter
+    Return(SUCC) // Success
+  }
+  //
+  // Get Boot display Preferences: Sub-function 4
+  //
+  If (LEqual(GESF, 4))
+  {
+    //
+    //<NOTE> Get Boot Display Preferences function.
+    //
+    And(PARM, 0xEFFF0000, PARM) // PARM[30:16] = Boot device ports
+    And(PARM, ShiftLeft(DeRefOf(Index(DBTB, IBTT)), 16), PARM)
+    Or(IBTT, PARM, PARM) // PARM[7:0] = Boot device type
+    Store(Zero, GESF) // Clear the exit parameter
+    Return(SUCC) // Success
+  }
+  //
+  // Panel details: Sub-function 5
+  //
+  If (LEqual(GESF, 5))
+  {
+    //
+    //<NOTE> Get Panel Details function.
+    //
+    Store(IPSC, PARM) // Report the scaling setting
+    Or(PARM, ShiftLeft(IPAT, 8), PARM)
+    Add(PARM, 0x100, PARM) // Adjust panel type, 0 = VBT default
+    Or(PARM, ShiftLeft(LIDS, 16), PARM) // Report the lid state
+    Add(PARM, 0x10000, PARM) // Adjust the lid state, 0 = Unknown
+    Or(PARM, ShiftLeft(IBIA, 20), PARM) // Report the BIA setting
+    Store(Zero, GESF)
+    Return(SUCC)
+  }
+  //
+  // Internal graphics: Sub-function 7
+  //
+  If (LEqual(GESF, 7))
+  {
+    Store(GIVD, PARM) // PARM[0]      - VGA mode(1=VGA)
+    Xor(PARM, 1, PARM) // Invert the VGA mode polarity
+    Or(PARM, ShiftLeft(GMFN, 1), PARM) // PARM[1]   - # IGD PCI functions-1
+                                       // PARM[3:2]    - Reserved
+                                       // PARM[4]      - IGD D3 support(0=cold)
+                                       // PARM[10:5]   - Reserved
+    Or(PARM, ShiftLeft(3, 11), PARM) // PARM[12:11] - DVMT mode(11b = 5.0)
+
+    //
+    // Report DVMT 5.0 Total Graphics memory size.
+    //
+    Or(PARM, ShiftLeft(IDMS, 17), PARM) // Bits 20:17 are for Gfx total memory size
+    //
+    // If the "Set Internal Graphics" call is supported, the modified
+    // settings flag must be programmed per the specification.  This means
+    // that the flag must be set to indicate that system BIOS requests
+    // these settings.  Once "Set Internal Graphics" is called, the
+    //  modified settings flag must be cleared on all subsequent calls to
+    // this function.
+    // Report the graphics frequency based on B0:D2:F0:RF0h[12].  Must
+    // take into account the current VCO.
+    //
+    Or(ShiftLeft(Derefof(Index(Derefof(Index(CDCT, HVCO)), CDVL)), 21),PARM, PARM)
+    Store(1, GESF) // Set the modified settings flag
+    Return(SUCC)
+  }
+  //
+  // Spread spectrum clocks: Sub-function 10
+  //
+  If (LEqual(GESF, 10))
+  {
+    Store(0, PARM) // Assume SSC is disabled
+    If(ISSC)
+    {
+      Or(PARM, 3, PARM) // If SSC enabled, return SSC1+Enabled
+    }
+    Store(0, GESF) // Set the modified settings flag
+    Return(SUCC) // Success
+  }
+
+  If (LEqual(GESF, 11))
+  {
+    Store(KSV0, PARM) // First four bytes of AKSV
+    Store(KSV1, GESF) // Fifth byte of AKSV
+
+    Return(SUCC) // Success
+  }
+  //
+  // A call to a reserved "Get BIOS data" function was received.
+  //
+  Store(Zero, GESF) // Clear the exit parameter
+  Return(CRIT) // Reserved, "Critical failure"
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
new file mode 100644
index 0000000000..410524b324
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
@@ -0,0 +1,314 @@
+/** @file
+  IGD OpRegion/Software SCI Reference Code.
+  This file contains the interrupt handler code for the Integrated
+  Graphics Device (IGD) OpRegion/Software SCI mechanism.
+  It defines OperationRegions to cover the IGD PCI configuration space
+  as described in the IGD OpRegion specification.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+//
+//NOTES:
+//
+// (1) The code contained in this file inherits the scope in which it
+//     was included.  So BIOS developers must be sure to include this
+//     file in the scope associated with the graphics device
+//     (ex. \_SB.PC00.GFX0).
+// (2) Create a _L06 method under the GPE scope to handle the event
+//     generated by the graphics driver.  The _L06 method must call
+//     the GSCI method in this file.
+// (3) The MCHP operation region assumes that _ADR and _BBN names
+//     corresponding to bus 0, device0, function 0 have been declared
+//     under the PC00 scope.
+// (4) Before the first execution of the GSCI method, the base address
+//     of the GMCH SCI OpRegion must be programmed where the driver can
+//     access it. A 32bit scratch register at 0xFC in the IGD PCI
+//     configuration space (B0/D2/F0/R0FCh) is used for this purpose.
+
+//  Define an OperationRegion to cover the GMCH PCI configuration space as
+//  described in the IGD OpRegion specificiation.
+//
+Scope(\_SB.PC00)
+{
+  OperationRegion(MCHP, PCI_Config, 0x40, 0xC0)
+  Field(MCHP, AnyAcc, NoLock, Preserve)
+  {
+    Offset(0x14),
+    AUDE, 8,
+
+    Offset(0x60), // Top of Memory register
+    TASM, 10,     // Total system memory (64MB gran)
+        , 6,
+  }
+}
+
+//
+//  Define an OperationRegion to cover the IGD PCI configuration space as
+//  described in the IGD OpRegion specificiation.
+//
+OperationRegion(IGDP, PCI_Config, 0x40, 0xC0)
+Field(IGDP, AnyAcc, NoLock, Preserve)
+{
+  Offset(0x10), // Mirror of gfx control reg
+      , 1,
+  GIVD, 1,      // IGD VGA disable bit
+      , 2,
+  GUMA, 3,      // Stolen memory size
+      , 9,
+  Offset(0x14),
+      , 4,
+  GMFN, 1,      // Gfx function 1 enable
+      , 27,
+  Offset(0xA4),
+  ASLE, 8,      // Reg 0xE4, ASLE interrupt register
+      , 24,     // Only use first byte of ASLE reg
+  Offset(0xA8), // Reg 0xE8, SWSCI control register
+  GSSE, 1,      // Graphics SCI event (1=event pending)
+  GSSB, 14,     // Graphics SCI scratchpad bits
+  GSES, 1,      // Graphics event select (1=SCI)
+  Offset(0xB0), // Gfx Clk Frequency and Gating Control
+      , 12,
+  CDVL, 1,      // Core display clock value
+      , 3,      // Graphics Core Display Clock Select
+  Offset(0xB5),
+  LBPC, 8,      // Legacy brightness control
+  Offset(0xBC),
+  ASLS, 32,     // Reg 0xFC, Address of the IGD OpRegion
+}
+
+//
+//  Define an OperationRegion to cover the IGD OpRegion layout.
+//
+OperationRegion(IGDM, SystemMemory, ASLB, 0x2000)
+Field(IGDM, AnyAcc, NoLock, Preserve)
+{
+  //
+  // OpRegion Header
+  //
+  SIGN, 128,     // Signature-"IntelGraphicsMem"
+  SIZE, 32,      // OpRegion Size
+  OVER, 32,      // OpRegion Version
+  SVER, 256,     // System BIOS Version
+  VVER, 128,     // VBIOS Version
+  GVER, 128,     // Driver version
+  MBOX, 32,      // Mailboxes supported
+  DMOD, 32,      // Driver Model
+  PCON, 32,      // Platform Configuration
+  DVER, 64,      // GOP Version
+  //
+  // OpRegion Mailbox 1 (Public ACPI Methods)
+  // Note: Mailbox 1 is normally reserved for desktop platforms.
+  //
+  Offset(0x100),
+  DRDY, 32,      // Driver readiness (ACPI notification)
+  CSTS, 32,      // Notification status
+  CEVT, 32,      // Current event
+  Offset(0x120),
+  DIDL, 32,      // Supported display device ID list
+  DDL2, 32,      // Allows for 8 devices
+  DDL3, 32,
+  DDL4, 32,
+  DDL5, 32,
+  DDL6, 32,
+  DDL7, 32,
+  DDL8, 32,
+  CPDL, 32,      // Currently present display list
+  CPL2, 32,      // Allows for 8 devices
+  CPL3, 32,
+  CPL4, 32,
+  CPL5, 32,
+  CPL6, 32,
+  CPL7, 32,
+  CPL8, 32,
+  CADL, 32,      // Currently active display list
+  CAL2, 32,      // Allows for 8 devices
+  CAL3, 32,
+  CAL4, 32,
+  CAL5, 32,
+  CAL6, 32,
+  CAL7, 32,
+  CAL8, 32,
+  NADL, 32,      // Next active display list
+  NDL2, 32,      // Allows for 8 devices
+  NDL3, 32,
+  NDL4, 32,
+  NDL5, 32,
+  NDL6, 32,
+  NDL7, 32,
+  NDL8, 32,
+  ASLP, 32,      // ASL sleep timeout
+  TIDX, 32,      // Toggle table index
+  CHPD, 32,      // Current hot plug enable indicator
+  CLID, 32,      // Current lid state indicator
+  CDCK, 32,      // Current docking state indicator
+  SXSW, 32,      // Display switch notify on resume
+  EVTS, 32,      // Events supported by ASL (diag only)
+  CNOT, 32,      // Current OS notifications (diag only)
+  NRDY, 32,
+  //
+  //Extended DIDL list
+  //
+  DDL9, 32,
+  DD10, 32,
+  DD11, 32,
+  DD12, 32,
+  DD13, 32,
+  DD14, 32,
+  DD15, 32,
+  //
+  //Extended Currently attached Display Device List  CPD2
+  //
+  CPL9, 32,
+  CP10, 32,
+  CP11, 32,
+  CP12, 32,
+  CP13, 32,
+  CP14, 32,
+  CP15, 32,
+  //
+  // OpRegion Mailbox 2 (Software SCI Interface)
+  //
+  Offset(0x200), // SCIC
+  SCIE, 1,       // SCI entry bit (1=call unserviced)
+  GEFC, 4,       // Entry function code
+  GXFC, 3,       // Exit result
+  GESF, 8,       // Entry/exit sub-function/parameter
+      , 16,      // SCIC[31:16] reserved
+  Offset(0x204), // PARM
+  PARM, 32,      // PARM register (extra parameters)
+  DSLP,  32,     // Driver sleep time out
+  //
+  // OpRegion Mailbox 3 (BIOS to Driver Notification)
+  // Note: Mailbox 3 is normally reserved for desktop platforms.
+  //
+  Offset(0x300),
+  ARDY, 32,      // Driver readiness (power conservation)
+  ASLC, 32,      // ASLE interrupt command/status
+  TCHE, 32,      // Technology enabled indicator
+  ALSI, 32,      // Current ALS illuminance reading
+  BCLP, 32,      // Backlight brightness
+  PFIT, 32,      // Panel fitting state or request
+  CBLV, 32,      // Current brightness level
+  BCLM, 320,     // Backlight brightness level duty cycle mapping table
+  CPFM, 32,      // Current panel fitting mode
+  EPFM, 32,      // Enabled panel fitting modes
+  PLUT, 592,     // Optional. 74-byte Panel LUT Table
+  PFMB, 32,      // Optional. PWM Frequency and Minimum Brightness
+  CCDV, 32,      // Optional. Gamma, Brightness, Contrast values.
+  PCFT, 32,      // Optional. Power Conservation Features
+  SROT, 32,      // Supported rotation angle.
+  IUER, 32,      // Optional. Intel Ultrabook Event Register.
+  FDSS, 64,      // Optional. FFS Display Physical address
+  FDSP, 32,      // Optional. FFS Display Size
+  STAT, 32,      // State Indicator
+  RVDA, 64,      // Physical address of Raw VBT data
+  RVDS, 32,      // Size of Raw VBT data
+  //
+  // OpRegion Mailbox 4 (VBT)
+  //
+  Offset(0x400),
+  RVBT, 0xC000,  // 6K bytes maximum VBT image
+  //
+  // OpRegion Mailbox 5 (BIOS to Driver Notification Extension)
+  //
+  Offset(0x1C00),
+  PHED, 32,      // Panel Header
+  BDDC, 2048,    // Panel EDID (Max 256 bytes)
+
+}
+
+//
+// Convert boot display type into a port mask.
+//
+Name (DBTB, Package()
+{
+  0x0000,        // Automatic
+  0x0007,        // Port-0 : Integrated CRT
+  0x0038,        // Port-1 : DVO-A, or Integrated LVDS
+  0x01C0,        // Port-2 : SDVO-B, or SDVO-B/C
+  0x0E00,        // Port-3 : SDVO-C
+  0x003F,        // [CRT + DVO-A / Integrated LVDS]
+  0x01C7,        // [CRT + SDVO-B] or [CRT + SDVO-B/C]
+  0x0E07,        // [CRT + SDVO-C]
+  0x01F8,        // [DVO-A / Integrated LVDS + SDVO-B]
+  0x0E38,        // [DVO-A / Integrated LVDS + SDVO-C]
+  0x0FC0,        // [SDVO-B + SDVO-C]
+  0x0000,        // Reserved
+  0x0000,        // Reserved
+  0x0000,        // Reserved
+  0x0000,        // Reserved
+  0x0000,        // Reserved
+  0x7000,        // Port-4: Integrated TV
+  0x7007,        // [Integrated TV + CRT]
+  0x7038,        // [Integrated TV + LVDS]
+  0x71C0,        // [Integrated TV + DVOB]
+  0x7E00         // [Integrated TV + DVOC]
+})
+
+//
+// Core display clock value table.
+//
+Name (CDCT, Package()
+{
+  Package() {228, 320},
+  Package() {222, 333},
+  Package() {222, 333},
+  Package() {  0,   0},
+  Package() {222, 333},
+})
+
+//
+// Defined exit result values:
+//
+Name (SUCC, 1)   // Exit result: Success
+Name (NVLD, 2)   // Exit result: Invalid parameter
+Name (CRIT, 4)   // Exit result: Critical failure
+Name (NCRT, 6)   // Exit result: Non-critical failure
+
+/************************************************************************;
+;*
+;* Name: GSCI
+;*
+;* Description: Handles an SCI generated by the graphics driver.  The
+;*              PARM and SCIC input fields are parsed to determine the
+;*              functionality requested by the driver.  GBDA or SBCB
+;*              is called based on the input data in SCIC.
+;*
+;* Usage:       The method must be called in response to a GPE 06 event
+;*              which will be generated by the graphics driver.
+;*              Ex: Method(\_GPE._L06) {Return(\_SB.PC00.GFX0.GSCI())}
+;*
+;* Input:       PARM and SCIC are indirect inputs
+;*
+;* Output:      PARM and SIC are indirect outputs
+;*
+;* References:  GBDA (Get BIOS Data method), SBCB (System BIOS Callback
+;*              method)
+;*
+;************************************************************************/
+
+Method (GSCI, 0, Serialized)
+{
+  Include("IgfxOpGbda.asl")  // "Get BIOS Data" Functions
+  Include("IgfxOpSbcb.asl")  // "System BIOS CallBacks"
+
+  If (LEqual(GEFC, 4))
+  {
+    Store(GBDA(), GXFC)    // Process Get BIOS Data functions
+  }
+
+  If (LEqual(GEFC, 6))
+  {
+    Store(SBCB(), GXFC)    // Process BIOS Callback functions
+  }
+
+  Store(0, GEFC)           // Wipe out the entry function code
+  Store(1, CPSC)           // Clear CPUSCI_STS to clear the PCH TCO SCI status
+  Store(0, GSSE)           // Clear the SCI generation bit in PCI space.
+  Store(0, SCIE)           // Clr SCI serviced bit to signal completion
+
+  Return(Zero)
+}
+
+Include("IgfxCommon.asl")    // IGD SCI mobile features
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.asl
new file mode 100644
index 0000000000..3c5d4d9862
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.asl
@@ -0,0 +1,261 @@
+/** @file
+  This file contains the system BIOS call back functionality for the
+  OpRegion/Software SCI mechanism.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+Method (SBCB, 0, Serialized)
+{
+  //
+  // Supported Callbacks: Sub-function 0
+  //
+  If (LEqual(GESF, 0x0))
+  {
+    //
+    //<NOTE> An OEM may support the driver->SBIOS status callbacks, but
+    // the supported callbacks value must be modified.  The code that is
+    // executed upon reception of the callbacks must be also be updated
+    // to perform the desired functionality.
+    //
+    Store(0x00000000, PARM)   // No callbacks supported
+    //Store(0x000787FD, PARM) // Used for Intel test implementaion
+    Store(0x000F87DD, PARM)
+    Store(Zero, GESF)         // Clear the exit parameter
+    Return(SUCC)              // "Success"
+  }
+  //
+  // BIOS POST Completion: Sub-function 1
+  //
+  If (LEqual(GESF, 1))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Pre-Hires Set Mode: Sub-function 3
+  //
+  If (LEqual(GESF, 3))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Post-Hires Set Mode: Sub-function 4
+  //
+  If (LEqual(GESF, 4))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Display Switch: Sub-function 5
+  //
+  If (LEqual(GESF, 5))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Adapter Power State: Sub-function 7
+  //
+  If (LEqual(GESF, 7))
+  {
+    //
+    // Handle Low Power S0 Idle Capability if enabled
+    //
+    If(LAnd(LEqual(S0ID, 1),LLess(OSYS, 2015))) {
+      //
+      // Call GUAM to trigger CS Entry
+      //   If Adapter Power State Notification = D1 (PARM[7:0]=0x01)
+      //
+      If (LEqual (And(PARM,0xFF), 0x01)) {
+        // GUAM - Global User Absent Mode Notification Method
+        \GUAM(One) // 0x01 - Power State Standby (CS Entry)
+      }
+      If (LEqual (And(PARM,0xFF), 0x00)) {
+        // GUAM - Global User Absent Mode Notification Method
+        \GUAM(0)
+      }
+    }
+    //
+    // Upon notification from driver that the Adapter Power State = D0,
+    // check if previous lid event failed.  If it did, retry the lid
+    // event here.
+    //
+    If(LEqual(PARM, 0))
+    {
+      Store(CLID, Local0)
+      If(And(0x80000000,Local0))
+      {
+        And(CLID, 0x0000000F, CLID)
+        GLID(CLID)
+      }
+    }
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Display Power State: Sub-function 8
+  //
+  If (LEqual(GESF, 8))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // Set Boot Display: Sub-function 9
+  //
+  If (LEqual(GESF, 9))
+  {
+    //
+    //<NOTE> An OEM may elect to implement this method.  In that case,
+    // the input values must be saved into non-volatile storage for
+    // parsing during the next boot.  The following Sample code is Intel
+    // validated implementation.
+    //
+    And(PARM, 0xFF, IBTT) // Save the boot display to NVS
+    Store(Zero, GESF)     // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)          // Reserved, "Critical failure"
+  }
+  //
+  // Set Panel Details: Sub-function 10 (0Ah)
+  //
+  If (LEqual(GESF, 10))
+  {
+    //
+    //<NOTE> An OEM may elect to implement this method.  In that case,
+    // the input values must be saved into non-volatile storage for
+    // parsing during the next boot.  The following Sample code is Intel
+    // validated implementation.
+    // Set the panel-related NVRAM variables based the input from the driver.
+    //
+    And(PARM, 0xFF, IPSC)
+    //
+    // Change panel type if a change is requested by the driver (Change if
+    // panel type input is non-zero).  Zero=No change requested.
+    //
+    If(And(ShiftRight(PARM, 8), 0xFF))
+    {
+      And(ShiftRight(PARM, 8), 0xFF, IPAT)
+      Decrement(IPAT)    // 0 = no change, so fit to CMOS map
+    }
+    And(ShiftRight(PARM, 20), 0x7, IBIA)
+    Store(Zero, GESF)    // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)         // Success
+  }
+  //
+  // Set Internal Graphics: Sub-function 11 (0Bh)
+  //
+  If (LEqual(GESF, 11))
+  {
+    //
+    //<NOTE> An OEM may elect to implement this method.  In that case,
+    // the input values must be saved into non-volatile storage for
+    // parsing during the next boot.  The following Sample code is Intel
+    // validated implementation.
+    //
+    And(ShiftRight(PARM, 1), 1, IF1E)      // Program the function 1 option
+    If(And(PARM, ShiftLeft(0xF, 13)))      // Use fixed memory if fixed size != 0
+    {
+      //
+      // Fixed memory
+      //
+      And(ShiftRight(PARM, 13), 0xF, IDMS) // Program fixed memory size
+    }
+    Else
+    {
+      //
+      // DVMT memory
+      //
+      And(ShiftRight(PARM, 17), 0xF, IDMS) // Program fixed memory size
+    }
+    Store(Zero, GESF)                      // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)                           // Success
+  }
+  //
+  // Post-Hires to DOS FS: Sub-function 16 (10h)
+  //
+  If (LEqual(GESF, 16))
+  {
+    Store(Zero, GESF) // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)      // Not supported, but no failure
+  }
+  //
+  // APM Complete:  Sub-function 17 (11h)
+  //
+  If (LEqual(GESF, 17))
+  {
+    Store(ShiftLeft(LIDS, 8), PARM) // Report the lid state
+    Add(PARM, 0x100, PARM)          // Adjust the lid state, 0 = Unknown
+    Store(Zero, GESF)               // Clear the exit parameter
+    Return(SUCC)                    // Not supported, but no failure
+  }
+  //
+  // Set Spread Spectrum Clocks: Sub-function 18 (12h)
+  //
+  If (LEqual(GESF, 18))
+  {
+    //
+    //<NOTE> An OEM may elect to implement this method.  In that case,
+    // the input values must be saved into non-volatile storage for
+    // parsing during the next boot.  The following Sample code is Intel
+    // validated implementation.
+    //
+    If(And(PARM, 1))
+    {
+      If(LEqual(ShiftRight(PARM, 1), 1))
+      {
+        Store(1, ISSC)  // Enable HW SSC, only for clock 1
+      }
+      Else
+      {
+        Store(Zero, GESF)
+        Return(CRIT)    // Failure, as the SSC clock must be 1
+      }
+    }
+    Else
+    {
+      Store(0, ISSC)    // Disable SSC
+    }
+    Store(Zero, GESF)   // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)        // Success
+  }
+  //
+  // Post VBE/PM Callback: Sub-function 19 (13h)
+  //
+  If (LEqual(GESF, 19))
+  {
+    Store(Zero, GESF)  // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)       // Not supported, but no failure
+  }
+  //
+  // Set PAVP Data: Sub-function 20 (14h)
+  //
+  If (LEqual(GESF, 20))
+  {
+    And(PARM, 0xF, PAVP) // Store PAVP info
+    Store(Zero, GESF)    // Clear the exit parameter
+    Store(Zero, PARM)
+    Return(SUCC)         // Success
+  }
+
+  //
+  // A call to a reserved "System BIOS callbacks" function was received
+  //
+  Store(Zero, GESF) // Clear the exit parameter
+  Return(SUCC)      // Reserved, "Critical failure"
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
new file mode 100644
index 0000000000..99130a853d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
@@ -0,0 +1,73 @@
+/** @file
+  This file contains the Intel Graphics SSDT Table ASL code.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+DefinitionBlock (
+  "IgfxSsdt.aml",
+  "SSDT",
+  2,
+  "INTEL ",
+  "IgfxSsdt",
+  0x3000
+  )
+{
+  External(\_SB.PC00, DeviceObj)
+  External(\_SB.PC00.GFX0, DeviceObj)
+  External(\NDID)
+  External(\DID1)
+  External(\DID2)
+  External(\DID3)
+  External(\DID4)
+  External(\DID5)
+  External(\DID6)
+  External(\DID7)
+  External(\DID8)
+  External(\DID9)
+  External(\DIDA)
+  External(\DIDB)
+  External(\DIDC)
+  External(\DIDD)
+  External(\DIDE)
+  External(\DIDF)
+  External(\DIDX)
+  External(\DIDY)
+
+  External(\NXD1)
+  External(\NXD2)
+  External(\NXD3)
+  External(\NXD4)
+  External(\NXD5)
+  External(\NXD6)
+  External(\NXD7)
+  External(\NXD8)
+  External(\NXDY)
+
+  External(\IPTP)
+  External(\EDPV)
+  External(\NXDX)
+  External(\HGMD)
+  External(\LIDS)
+  External(\BRTL)
+  External(\NSTE)
+  External(\CSTE)
+  External(\ASLB)
+  External(\IBTT)
+  External(\IPSC)
+  External(\IPAT)
+  External(\IBIA)
+  External(\IDMS)
+  External(\HVCO)
+  External(\ISSC)
+  External(\KSV0)
+  External(\KSV1)
+  External(\IF1E)
+  External(\PAVP)
+
+  Scope (\_SB.PC00.GFX0)
+  {
+    include("Igfx.asl")
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
new file mode 100644
index 0000000000..be28157cef
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
@@ -0,0 +1,23 @@
+## @file
+#  Component description file for the Igfx ACPI tables
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION          = 0x00010005
+BASE_NAME            = IgfxSsdt
+FILE_GUID            = CE9CAA0E-8248-442C-9E57-50F212E2BAED
+MODULE_TYPE          = USER_DEFINED
+VERSION_STRING       = 1.0
+
+[Sources]
+  IgfxSsdt.asl
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[FixedPcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsInitLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsInitLib.h
new file mode 100644
index 0000000000..0e9f119763
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsInitLib.h
@@ -0,0 +1,53 @@
+/** @file
+  Header file for DXE Graphics Init Lib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_GRAPHICS_INIT_LIB_H_
+#define _DXE_GRAPHICS_INIT_LIB_H_
+
+#include <Uefi.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/IoLib.h>
+#include <IndustryStandard/Acpi.h>
+#include <IndustryStandard/Pci.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/UefiLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Protocol/SaPolicy.h>
+#include <Protocol/SaNvsArea.h>
+#include <Protocol/GopComponentName2.h>
+#include <SiConfigHob.h>
+#include <Register/SaRegsHostBridge.h>
+
+/**
+  Initialize GT ACPI tables
+
+  @param[in] ImageHandle - Handle for the image of this driver
+  @param[in] SaPolicy    - SA DXE Policy protocol
+
+  @retval EFI_SUCCESS          - GT ACPI initialization complete
+  @retval EFI_NOT_FOUND        - Dxe System Table not found.
+  @retval EFI_OUT_OF_RESOURCES - Mmio not allocated successfully.
+**/
+EFI_STATUS
+GraphicsInit (
+  IN EFI_HANDLE             ImageHandle,
+  IN SA_POLICY_PROTOCOL     *SaPolicy
+  );
+
+/**
+  Do Post GT PM Init Steps after VBIOS Initialization.
+
+  @retval EFI_SUCCESS          Succeed.
+**/
+EFI_STATUS
+PostPmInitEndOfDxe (
+  VOID
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsPolicyLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsPolicyLib.h
new file mode 100644
index 0000000000..abb5dffc45
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeGraphicsPolicyLib.h
@@ -0,0 +1,71 @@
+/** @file
+  Header file for the DXE Graphics Policy Init library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_GRAPHICS_POLICY_LIB_H_
+#define _DXE_GRAPHICS_POLICY_LIB_H_
+
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Protocol/SaPolicy.h>
+#include <ConfigBlock.h>
+#include <GraphicsConfig.h>
+#include <Library/SiConfigBlockLib.h>
+
+#define WORD_FIELD_VALID_BIT  BIT15
+
+extern EFI_GUID gGraphicsDxeConfigGuid;
+
+/**
+  This function prints the Graphics DXE phase policy.
+
+  @param[in] SaPolicy - SA DXE Policy protocol
+**/
+VOID
+GraphicsDxePolicyPrint (
+  IN  SA_POLICY_PROTOCOL      *SaPolicy
+  );
+
+/**
+  This function Load default Graphics DXE policy.
+
+  @param[in] ConfigBlockPointer    The pointer to add Graphics config block
+**/
+VOID
+LoadIgdDxeDefault (
+  IN VOID    *ConfigBlockPointer
+  );
+
+
+/**
+  Get DXE Graphics config block table total size.
+
+  @retval     Size of DXE Graphics config block table
+**/
+UINT16
+EFIAPI
+GraphicsGetConfigBlockTotalSizeDxe (
+  VOID
+  );
+
+/**
+  GraphicsAddConfigBlocksDxe add all DXE Graphics config block.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add SA config blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+GraphicsAddConfigBlocksDxe (
+  IN VOID           *ConfigBlockTableAddress
+  );
+
+#endif // _DXE_GRAPHICs_POLICY_LIBRARY_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeIgdOpRegionInitLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeIgdOpRegionInitLib.h
new file mode 100644
index 0000000000..683893f940
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/DxeIgdOpRegionInitLib.h
@@ -0,0 +1,177 @@
+/** @file
+  This is part of the implementation of an Intel Graphics drivers OpRegion /
+  Software SCI interface between system BIOS, ASL code, and Graphics drivers.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_IGD_OPREGION_INIT_LIB_H_
+#define _DXE_IGD_OPREGION_INIT_LIB_H_
+
+///
+/// Statements that include other header files.
+///
+#include <Uefi.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <IndustryStandard/Pci.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/UefiLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Register/IgdRegs.h>
+#include <SiConfigHob.h>
+#include <Register/SaRegsHostBridge.h>
+///
+/// Driver Consumed Protocol Prototypes
+///
+#include <Protocol/PciIo.h>
+#include <Protocol/PciRootBridgeIo.h>
+#include <Protocol/SaPolicy.h>
+#include <Protocol/SaNvsArea.h>
+///
+/// Driver Produced Protocol Prototypes
+///
+#include <Protocol/IgdOpRegion.h>
+
+#pragma pack(push, 1)
+///
+///
+/// OpRegion (Miscellaneous) defines.
+///
+/// OpRegion Header defines.
+///
+typedef UINT16  STRING_REF;
+#define HEADER_SIGNATURE            "IntelGraphicsMem"
+#define HEADER_SIZE                 0x2000
+#define HEADER_OPREGION_REV         0x00
+#define HEADER_MBOX_SUPPORT         (HD_MBOX5 + HD_MBOX4 + HD_MBOX3 + HD_MBOX2 + HD_MBOX1)
+#define HD_MBOX1                    BIT0
+#define HD_MBOX2                    BIT1
+#define HD_MBOX3                    BIT2
+#define HD_MBOX4                    BIT3
+#define HD_MBOX5                    BIT4
+#define SVER_SIZE                   32
+
+///
+/// OpRegion Mailbox 1 EQUates.
+///
+/// OpRegion Mailbox 3 EQUates.
+///
+#define ALS_ENABLE            BIT0
+#define BACKLIGHT_BRIGHTNESS  0xFF
+#define FIELD_VALID_BIT       BIT31
+#define PFIT_ENABLE           BIT2
+#define PFIT_OPRN_AUTO        0x00000000
+#define PFIT_OPRN_SCALING     0x00000007
+#define PFIT_OPRN_OFF         0x00000000
+#define PFIT_SETUP_AUTO       0
+#define PFIT_SETUP_SCALING    1
+#define PFIT_SETUP_OFF        2
+#define INIT_BRIGHT_LEVEL     0x64
+#define PFIT_STRETCH          6
+
+///
+/// Video BIOS / VBT defines
+///
+#define OPTION_ROM_SIGNATURE    0xAA55
+#define VBIOS_LOCATION_PRIMARY  0xC0000
+
+#define VBT_SIGNATURE           SIGNATURE_32 ('$', 'V', 'B', 'T')
+///
+/// Typedef stuctures
+///
+typedef struct {
+  UINT16  Signature;  /// 0xAA55
+  UINT8   Size512;
+  UINT8   Reserved[21];
+  UINT16  PcirOffset;
+  UINT16  VbtOffset;
+} INTEL_VBIOS_OPTION_ROM_HEADER;
+
+typedef struct {
+  UINT32  Signature;  /// "PCIR"
+  UINT16  VendorId;   /// 0x8086
+  UINT16  DeviceId;
+  UINT16  Reserved0;
+  UINT16  Length;
+  UINT8   Revision;
+  UINT8   ClassCode[3];
+  UINT16  ImageLength;
+  UINT16  CodeRevision;
+  UINT8   CodeType;
+  UINT8   Indicator;
+  UINT16  Reserved1;
+} INTEL_VBIOS_PCIR_STRUCTURE;
+
+typedef struct {
+  UINT8   HeaderSignature[20];
+  UINT16  HeaderVersion;
+  UINT16  HeaderSize;
+  UINT16  HeaderVbtSize;
+  UINT8   HeaderVbtCheckSum;
+  UINT8   HeaderReserved;
+  UINT32  HeaderOffsetVbtDataBlock;
+  UINT32  HeaderOffsetAim1;
+  UINT32  HeaderOffsetAim2;
+  UINT32  HeaderOffsetAim3;
+  UINT32  HeaderOffsetAim4;
+  UINT8   DataHeaderSignature[16];
+  UINT16  DataHeaderVersion;
+  UINT16  DataHeaderSize;
+  UINT16  DataHeaderDataBlockSize;
+  UINT8   CoreBlockId;
+  UINT16  CoreBlockSize;
+  UINT16  CoreBlockBiosSize;
+  UINT8   CoreBlockBiosType;
+  UINT8   CoreBlockReleaseStatus;
+  UINT8   CoreBlockHWSupported;
+  UINT8   CoreBlockIntegratedHW;
+  UINT8   CoreBlockBiosBuild[4];
+  UINT8   CoreBlockBiosSignOn[155];
+} VBIOS_VBT_STRUCTURE;
+#pragma pack(pop)
+///
+/// Driver Private Function definitions
+///
+
+/**
+  Graphics OpRegion / Software SCI driver installation function.
+
+  @retval EFI_SUCCESS     - The driver installed without error.
+  @retval EFI_ABORTED     - The driver encountered an error and could not complete
+                            installation of the ACPI tables.
+**/
+EFI_STATUS
+IgdOpRegionInit (
+  VOID
+  );
+
+/**
+  Get Intel video BIOS VBT information (i.e. Pointer to VBT and VBT size).
+  The VBT (Video BIOS Table) is a block of customizable data that is built
+  within the video BIOS and edited by customers.
+
+  @retval EFI_SUCCESS            - Video BIOS VBT information returned.
+  @exception EFI_UNSUPPORTED     - Could not find VBT information (*VBiosVbtPtr = NULL).
+**/
+EFI_STATUS
+GetVBiosVbtEndOfDxe (
+  VOID
+  );
+
+/**
+  Update Graphics OpRegion after PCI enumeration.
+
+  @retval EFI_SUCCESS     - The function completed successfully.
+**/
+EFI_STATUS
+UpdateIgdOpRegionEndOfDxe (
+  VOID
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.c
new file mode 100644
index 0000000000..8769f34021
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.c
@@ -0,0 +1,135 @@
+/** @file
+  DXE Library for Initializing SystemAgent Graphics ACPI table initialization.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DxeGraphicsInitLib.h>
+
+
+typedef union {
+  struct {
+    UINT32  Low;
+    UINT32  High;
+  } Data32;
+  UINT64 Data;
+} UINT64_STRUCT;
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT64_STRUCT                 mMchBarBase;
+GLOBAL_REMOVE_IF_UNREFERENCED GOP_COMPONENT_NAME2_PROTOCOL  *GopComponentName2Protocol = NULL;
+
+/**
+    Do Post GT PM Init Steps after VBIOS Initialization.
+
+  @retval EFI_SUCCESS          Succeed.
+**/
+EFI_STATUS
+PostPmInitEndOfDxe (
+  VOID
+  )
+{
+  CHAR16                    *DriverVersion;
+  UINTN                     Index;
+  EFI_STATUS                Status;
+  GRAPHICS_DXE_CONFIG       *GraphicsDxeConfig;
+  SA_POLICY_PROTOCOL        *SaPolicy;
+
+  ///
+  /// Get the platform setup policy.
+  ///
+  DriverVersion = NULL;
+  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **) &SaPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+
+  Status = gBS->LocateProtocol (&gGopComponentName2ProtocolGuid, NULL, (VOID **)&GopComponentName2Protocol);
+  if (!EFI_ERROR (Status)) {
+    Status = GopComponentName2Protocol->GetDriverVersion (
+                                          GopComponentName2Protocol,
+                                          "en-US",
+                                          &DriverVersion
+                                          );
+    if (!EFI_ERROR (Status)) {
+      for (Index = 0; (DriverVersion[Index] != '\0'); Index++) {
+      }
+      Index = (Index+1)*2;
+      CopyMem (GraphicsDxeConfig->GopVersion, DriverVersion, Index);
+    }
+  }
+
+  ///
+  /// Return final status
+  ///
+  return EFI_SUCCESS;
+}
+
+
+/**
+Initialize GT ACPI tables
+
+  @param[in] ImageHandle -     Handle for the image of this driver
+  @param[in] SaPolicy -        SA DXE Policy protocol
+
+  @retval EFI_SUCCESS          - GT ACPI initialization complete
+  @retval EFI_NOT_FOUND        - Dxe System Table not found.
+  @retval EFI_OUT_OF_RESOURCES - Mmio not allocated successfully.
+**/
+EFI_STATUS
+GraphicsInit (
+  IN EFI_HANDLE              ImageHandle,
+  IN SA_POLICY_PROTOCOL      *SaPolicy
+  )
+{
+  EFI_STATUS                      Status;
+  GRAPHICS_DXE_CONFIG             *GraphicsDxeConfig;
+  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
+
+  Status                  = EFI_SUCCESS;
+  mMchBarBase.Data32.High = PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, R_SA_MCHBAR + 4));
+  mMchBarBase.Data32.Low  = PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, R_SA_MCHBAR));
+  mMchBarBase.Data       &= (UINT64) ~BIT0;
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  ///  Locate the SA Global NVS Protocol.
+  ///
+  Status = gBS->LocateProtocol (&gSaNvsAreaProtocolGuid, NULL, (VOID **) &SaNvsAreaProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Update IGD SA Global NVS
+  ///
+  DEBUG ((DEBUG_INFO, " Update Igd SA Global NVS Area.\n"));
+
+  SaNvsAreaProtocol->Area->AlsEnable                    = GraphicsDxeConfig->AlsEnable;
+  ///
+  /// Initialize IGD state by checking if IGD Device 2 Function 0 is enabled in the chipset
+  ///
+  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, R_SA_DEVEN)) & B_SA_DEVEN_D2EN_MASK) {
+    SaNvsAreaProtocol->Area->IgdState = 1;
+  } else {
+    SaNvsAreaProtocol->Area->IgdState = 0;
+  }
+
+  SaNvsAreaProtocol->Area->BrightnessPercentage         = 100;
+  SaNvsAreaProtocol->Area->IgdBootType                  = GraphicsDxeConfig->IgdBootType;
+  SaNvsAreaProtocol->Area->IgdPanelType                 = GraphicsDxeConfig->IgdPanelType;
+  SaNvsAreaProtocol->Area->IgdPanelScaling              = GraphicsDxeConfig->IgdPanelScaling;
+  ///
+  /// Get SFF power mode platform data for the IGD driver.  Flip the bit (bitwise xor)
+  /// since Setup value is opposite of NVS and IGD OpRegion value.
+  ///
+  SaNvsAreaProtocol->Area->IgdDvmtMemSize               = GraphicsDxeConfig->IgdDvmtMemSize;
+  SaNvsAreaProtocol->Area->IgdFunc1Enable               = 0;
+  SaNvsAreaProtocol->Area->IgdHpllVco                   = MmioRead8 (mMchBarBase.Data + 0xC0F) & 0x07;
+  SaNvsAreaProtocol->Area->IgdSciSmiMode                = 0;
+  SaNvsAreaProtocol->Area->GfxTurboIMON                 = GraphicsDxeConfig->GfxTurboIMON;
+  SaNvsAreaProtocol->Area->EdpValid                     = 0;
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf
new file mode 100644
index 0000000000..78c115eb3c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf
@@ -0,0 +1,45 @@
+## @file
+# Component description file for the Dxe Graphics Init library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeGraphicsInitLib
+FILE_GUID = 2E889319-7361-4F6C-B181-EBD7AEF1DE6A
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+LIBRARY_CLASS = DxeGraphicsInitLib
+
+[LibraryClasses]
+UefiLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+IoLib
+PciSegmentLib
+BaseMemoryLib
+MemoryAllocationLib
+MmPciLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeGraphicsInitLib.c
+
+[Guids]
+gGraphicsDxeConfigGuid   ## CONSUMES
+
+[Pcd]
+
+[Protocols]
+gSaPolicyProtocolGuid                  ## CONSUMES
+gSaNvsAreaProtocolGuid                 ## CONSUMES
+gGopComponentName2ProtocolGuid         ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.c
new file mode 100644
index 0000000000..fd284d5f42
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.c
@@ -0,0 +1,118 @@
+/** @file
+  This file provide services for DXE phase Graphics policy default initialization.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DxeGraphicsPolicyLib.h>
+
+/**
+  This function prints the Graphics DXE phase policy.
+
+  @param[in] SaPolicy - SA DXE Policy protocol
+**/
+VOID
+GraphicsDxePolicyPrint (
+  IN  SA_POLICY_PROTOCOL      *SaPolicy
+  )
+{
+  EFI_STATUS                  Status;
+  GRAPHICS_DXE_CONFIG         *GraphicsDxeConfig;
+
+  //
+  // Get requisite IP Config Blocks which needs to be used here
+  //
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+
+  DEBUG_CODE_BEGIN ();
+  DEBUG ((DEBUG_INFO, "\n------------------------ Graphics Policy (DXE) print BEGIN -----------------\n"));
+  DEBUG ((DEBUG_INFO, " Revision : %d\n", GraphicsDxeConfig->Header.Revision));
+  ASSERT (GraphicsDxeConfig->Header.Revision == GRAPHICS_DXE_CONFIG_REVISION);
+  DEBUG ((DEBUG_INFO, "\n------------------------ Graphics Policy (DXE) print END -----------------\n"));
+  DEBUG_CODE_END ();
+
+  return;
+}
+
+
+/**
+  This function Load default Graphics DXE policy.
+
+  @param[in] ConfigBlockPointer    The pointer to add Graphics config block
+**/
+VOID
+LoadIgdDxeDefault (
+  IN VOID    *ConfigBlockPointer
+  )
+{
+  GRAPHICS_DXE_CONFIG        *GraphicsDxeConfig;
+
+  GraphicsDxeConfig = ConfigBlockPointer;
+  DEBUG ((DEBUG_INFO, "GraphicsDxeConfig->Header.GuidHob.Name = %g\n", &GraphicsDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "GraphicsDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", GraphicsDxeConfig->Header.GuidHob.Header.HobLength));
+  ///
+  /// Initialize the Graphics configuration
+  ///
+  GraphicsDxeConfig->PlatformConfig           = 1;
+  GraphicsDxeConfig->AlsEnable                = 2;
+  GraphicsDxeConfig->BacklightControlSupport  = 2;
+  GraphicsDxeConfig->IgdBlcConfig             = 2;
+  GraphicsDxeConfig->IgdDvmtMemSize           = 1;
+  GraphicsDxeConfig->GfxTurboIMON             = 31;
+  ///
+  /// <EXAMPLE> Create a static Backlight Brightness Level Duty cycle Mapping Table
+  /// Possible 20 entries (example used 11), each 16 bits as follows:
+  /// [15] = Field Valid bit, [14:08] = Level in Percentage (0-64h), [07:00] = Desired duty cycle (0 - FFh).
+  ///
+  GraphicsDxeConfig->BCLM[0] = (0x0000 + WORD_FIELD_VALID_BIT);  ///< 0%
+  GraphicsDxeConfig->BCLM[1] = (0x0A19 + WORD_FIELD_VALID_BIT);  ///< 10%
+  GraphicsDxeConfig->BCLM[2] = (0x1433 + WORD_FIELD_VALID_BIT);  ///< 20%
+  GraphicsDxeConfig->BCLM[3] = (0x1E4C + WORD_FIELD_VALID_BIT);  ///< 30%
+  GraphicsDxeConfig->BCLM[4] = (0x2866 + WORD_FIELD_VALID_BIT);  ///< 40%
+  GraphicsDxeConfig->BCLM[5] = (0x327F + WORD_FIELD_VALID_BIT);  ///< 50%
+  GraphicsDxeConfig->BCLM[6] = (0x3C99 + WORD_FIELD_VALID_BIT);  ///< 60%
+  GraphicsDxeConfig->BCLM[7] = (0x46B2 + WORD_FIELD_VALID_BIT);  ///< 70%
+  GraphicsDxeConfig->BCLM[8] = (0x50CC + WORD_FIELD_VALID_BIT);  ///< 80%
+  GraphicsDxeConfig->BCLM[9] = (0x5AE5 + WORD_FIELD_VALID_BIT);  ///< 90%
+  GraphicsDxeConfig->BCLM[10] = (0x64FF + WORD_FIELD_VALID_BIT);  ///< 100%
+}
+
+static COMPONENT_BLOCK_ENTRY  mGraphicsDxeIpBlocks = {
+  &gGraphicsDxeConfigGuid, sizeof (GRAPHICS_DXE_CONFIG), GRAPHICS_DXE_CONFIG_REVISION, LoadIgdDxeDefault};
+
+
+/**
+  Get DXE Graphics config block table total size.
+
+  @retval     Size of DXE Graphics config block table
+**/
+UINT16
+EFIAPI
+GraphicsGetConfigBlockTotalSizeDxe (
+  VOID
+  )
+{
+  return mGraphicsDxeIpBlocks.Size;
+}
+
+/**
+  GraphicsAddConfigBlocksDxe add all DXE Graphics config block.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add SA config blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+GraphicsAddConfigBlocksDxe (
+  IN VOID           *ConfigBlockTableAddress
+  )
+{
+  EFI_STATUS  Status;
+  Status = AddComponentConfigBlocks (ConfigBlockTableAddress, &mGraphicsDxeIpBlocks, 1);
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf
new file mode 100644
index 0000000000..d3ac3c24a1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf
@@ -0,0 +1,37 @@
+## @file
+# Component description file for the DXE Graphics Policy Init library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeGraphicsPolicyLib
+FILE_GUID = C6190599-287E-40F9-9B46-EE112A322EBF
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeGraphicsPolicyLib
+
+[LibraryClasses]
+BaseMemoryLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+HobLib
+SiConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeGraphicsPolicyLib.c
+
+[Guids]
+gGraphicsDxeConfigGuid
+
+[Pcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInit.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInit.c
new file mode 100644
index 0000000000..0e12f62f4e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInit.c
@@ -0,0 +1,541 @@
+/** @file
+  This is part of the implementation of an Intel Graphics drivers OpRegion /
+  Software SCI interface between system BIOS, ASL code, and Graphics drivers.
+  The code in this file will load the driver and initialize the interface
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DxeIgdOpRegionInitLib.h>
+
+#define HEADER_OPREGION_VER_GEN9          0x0200
+#define HEADER_OPREGION_VER_GEN12         0x0201
+
+
+GLOBAL_REMOVE_IF_UNREFERENCED IGD_OPREGION_PROTOCOL           mIgdOpRegion;
+
+/**
+  Get VBT data using SaPlaformPolicy
+
+  @param[out] VbtFileBuffer    Pointer to VBT data buffer.
+
+  @retval EFI_SUCCESS      VBT data was returned.
+  @retval EFI_NOT_FOUND    VBT data not found.
+  @exception EFI_UNSUPPORTED  Invalid signature in VBT data.
+**/
+EFI_STATUS
+GetIntegratedIntelVbtPtr (
+  OUT VBIOS_VBT_STRUCTURE **VbtFileBuffer
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_PHYSICAL_ADDRESS          VbtAddress;
+  UINT32                        Size;
+  GRAPHICS_DXE_CONFIG           *GraphicsDxeConfig;
+  SA_POLICY_PROTOCOL            *SaPolicy;
+
+  ///
+  /// Get the SA policy.
+  ///
+  Status = gBS->LocateProtocol (
+                  &gSaPolicyProtocolGuid,
+                  NULL,
+                  (VOID **) &SaPolicy
+                  );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  VbtAddress = GraphicsDxeConfig->VbtAddress;
+  Size       = GraphicsDxeConfig->Size;
+
+  if (VbtAddress == 0x00000000) {
+    return EFI_NOT_FOUND;
+  } else {
+    ///
+    /// Check VBT signature
+    ///
+    *VbtFileBuffer  = NULL;
+    *VbtFileBuffer = (VBIOS_VBT_STRUCTURE *) (UINTN) VbtAddress;
+    if ((*((UINT32 *) ((*VbtFileBuffer)->HeaderSignature))) != VBT_SIGNATURE) {
+      FreePool (*VbtFileBuffer);
+      *VbtFileBuffer = NULL;
+      return EFI_UNSUPPORTED;
+    }
+  }
+  if (Size == 0) {
+    return EFI_NOT_FOUND;
+  } else {
+    ///
+    /// Check VBT size
+    ///
+    if ((*VbtFileBuffer)->HeaderVbtSize > Size) {
+      (*VbtFileBuffer)->HeaderVbtSize = (UINT16) Size;
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Get a pointer to an uncompressed image of the Intel video BIOS.
+
+  @Note: This function would only be called if the video BIOS at 0xC000 is
+         missing or not an Intel video BIOS.  It may not be an Intel video BIOS
+         if the Intel graphic contoller is considered a secondary adapter.
+
+  @param[out] VBiosImage     - Pointer to an uncompressed Intel video BIOS.  This pointer must
+                               be set to NULL if an uncompressed image of the Intel Video BIOS
+                               is not obtainable.
+
+  @retval EFI_SUCCESS        - VBiosPtr is updated.
+  @exception EFI_UNSUPPORTED - No Intel video BIOS found.
+**/
+EFI_STATUS
+GetIntegratedIntelVBiosPtr (
+  OUT INTEL_VBIOS_OPTION_ROM_HEADER **VBiosImage
+  )
+{
+  EFI_HANDLE                    *HandleBuffer;
+  UINTN                         HandleCount;
+  UINTN                         Index;
+  INTEL_VBIOS_PCIR_STRUCTURE    *PcirBlockPtr;
+  EFI_STATUS                    Status;
+  EFI_PCI_IO_PROTOCOL           *PciIo;
+  INTEL_VBIOS_OPTION_ROM_HEADER *VBiosRomImage;
+
+  ///
+  /// Set as if an umcompressed Intel video BIOS image was not obtainable.
+  ///
+  VBiosRomImage = NULL;
+
+  ///
+  /// Get all PCI IO protocols
+  ///
+  Status = gBS->LocateHandleBuffer (
+                  ByProtocol,
+                  &gEfiPciIoProtocolGuid,
+                  NULL,
+                  &HandleCount,
+                  &HandleBuffer
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Find the video BIOS by checking each PCI IO handle for an Intel video
+  /// BIOS OPROM.
+  ///
+  for (Index = 0; Index < HandleCount; Index++) {
+    Status = gBS->HandleProtocol (
+                    HandleBuffer[Index],
+                    &gEfiPciIoProtocolGuid,
+                    (VOID **) &PciIo
+                    );
+    ASSERT_EFI_ERROR (Status);
+
+    VBiosRomImage = PciIo->RomImage;
+
+    ///
+    /// If this PCI device doesn't have a ROM image, skip to the next device.
+    ///
+    if (!VBiosRomImage) {
+      continue;
+    }
+    ///
+    /// Get pointer to PCIR structure
+    ///
+    PcirBlockPtr = (INTEL_VBIOS_PCIR_STRUCTURE *) ((UINT8 *) VBiosRomImage + VBiosRomImage->PcirOffset);
+
+    ///
+    /// Check if we have an Intel video BIOS OPROM.
+    ///
+    if ((VBiosRomImage->Signature == OPTION_ROM_SIGNATURE) &&
+        (PcirBlockPtr->VendorId == V_SA_MC_VID) &&
+        (PcirBlockPtr->ClassCode[0] == 0x00) &&
+        (PcirBlockPtr->ClassCode[1] == 0x00) &&
+        (PcirBlockPtr->ClassCode[2] == 0x03)
+        ) {
+      ///
+      /// Found Intel video BIOS.
+      ///
+      *VBiosImage = VBiosRomImage;
+      return EFI_SUCCESS;
+    }
+  }
+  ///
+  /// No Intel video BIOS found.
+  ///
+  ///
+  /// Free any allocated buffers
+  ///
+  FreePool (HandleBuffer);
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Get Intel video BIOS VBT information (i.e. Pointer to VBT and VBT size).
+  The VBT (Video BIOS Table) is a block of customizable data that is built
+  within the video BIOS and edited by customers.
+
+  @retval EFI_SUCCESS            - Video BIOS VBT information returned.
+  @exception EFI_UNSUPPORTED     - Could not find VBT information (*VBiosVbtPtr = NULL).
+**/
+EFI_STATUS
+GetVBiosVbtEndOfDxe (
+  VOID
+  )
+{
+  INTEL_VBIOS_OPTION_ROM_HEADER *VBiosPtr;
+  VBIOS_VBT_STRUCTURE           *VBiosVbtPtr;
+  EFI_STATUS                    Status;
+  VBIOS_VBT_STRUCTURE           *VbtFileBuffer;
+  GRAPHICS_DXE_CONFIG           *GraphicsDxeConfig;
+  SA_POLICY_PROTOCOL            *SaPolicy;
+
+  VbtFileBuffer = NULL;
+
+  ///
+  /// Get the SA policy.
+  ///
+  Status = gBS->LocateProtocol (
+                  &gSaPolicyProtocolGuid,
+                  NULL,
+                  (VOID **) &SaPolicy
+                  );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  VBiosPtr = NULL;
+  ///
+  /// Try to get VBT from FV.
+  ///
+  GetIntegratedIntelVbtPtr (&VbtFileBuffer);
+  if (VbtFileBuffer != NULL) {
+    ///
+    /// Video BIOS not found, use VBT from SaPolicy
+    ///
+    DEBUG ((DEBUG_INFO, "VBT data found\n"));
+    CopyMem (mIgdOpRegion.OpRegion->Header.DVER, GraphicsDxeConfig->GopVersion, sizeof(GraphicsDxeConfig->GopVersion));
+    mIgdOpRegion.OpRegion->MBox3.RVDA = 0;
+    mIgdOpRegion.OpRegion->MBox3.RVDS = 0;
+    if ((VbtFileBuffer->HeaderVbtSize > 0x1800)) {  // VBT > 6KB
+      DEBUG ((DEBUG_INFO, "Extended VBT supported\n"));
+      mIgdOpRegion.OpRegion->MBox3.RVDA = sizeof (IGD_OPREGION_STRUCTURE); // Relative offset at the end of Op-region.
+      mIgdOpRegion.OpRegion->MBox3.RVDS = ((VbtFileBuffer->HeaderVbtSize) & (UINT32)~(0x1FF)) + 0x200; // Aligned VBT Data Size to 512 bytes.
+      CopyMem ((CHAR8 *)(UINTN)(mIgdOpRegion.OpRegion) + sizeof (IGD_OPREGION_STRUCTURE), VbtFileBuffer, mIgdOpRegion.OpRegion->MBox3.RVDS);
+    } else {
+      CopyMem (mIgdOpRegion.OpRegion->MBox4.RVBT, VbtFileBuffer, VbtFileBuffer->HeaderVbtSize);
+    }
+    return EFI_SUCCESS;
+  }
+
+  if (VBiosPtr == NULL) {
+    return EFI_UNSUPPORTED;
+  }
+
+  DEBUG ((DEBUG_INFO, "VBIOS found at 0x%X\n", VBiosPtr));
+  VBiosVbtPtr = (VBIOS_VBT_STRUCTURE *) ((UINT8 *) VBiosPtr + VBiosPtr->VbtOffset);
+
+  if ((*((UINT32 *) (VBiosVbtPtr->HeaderSignature))) != VBT_SIGNATURE) {
+    return EFI_UNSUPPORTED;
+  }
+
+  ///
+  /// Initialize Video BIOS version with its build number.
+  ///
+  mIgdOpRegion.OpRegion->Header.VVER[0] = VBiosVbtPtr->CoreBlockBiosBuild[0];
+  mIgdOpRegion.OpRegion->Header.VVER[1] = VBiosVbtPtr->CoreBlockBiosBuild[1];
+  mIgdOpRegion.OpRegion->Header.VVER[2] = VBiosVbtPtr->CoreBlockBiosBuild[2];
+  mIgdOpRegion.OpRegion->Header.VVER[3] = VBiosVbtPtr->CoreBlockBiosBuild[3];
+  CopyMem (mIgdOpRegion.OpRegion->MBox4.RVBT, VBiosVbtPtr, VBiosVbtPtr->HeaderVbtSize);
+
+  ///
+  /// Return final status
+  ///
+  return EFI_SUCCESS;
+}
+
+/**
+  Graphics OpRegion / Software SCI driver installation function.
+
+  @param[in] void         - None
+  @retval EFI_SUCCESS     - The driver installed without error.
+  @retval EFI_ABORTED     - The driver encountered an error and could not complete
+                            installation of the ACPI tables.
+**/
+EFI_STATUS
+IgdOpRegionInit (
+  VOID
+  )
+{
+  EFI_HANDLE                      Handle;
+  EFI_STATUS                      Status;
+  UINT32                          DwordData;
+  UINT64                          IgdBaseAddress;
+  SA_POLICY_PROTOCOL              *SaPolicy;
+  GRAPHICS_DXE_CONFIG             *GraphicsDxeConfig;
+  UINT8                           Index;
+  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
+  VBIOS_VBT_STRUCTURE             *VbtFileBuffer;
+  UINT16                          ExtendedVbtSize;
+
+  ///
+  /// Get the SA policy.
+  ///
+  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **)&SaPolicy);
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid, (VOID *)&GraphicsDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  VbtFileBuffer = NULL;
+  ExtendedVbtSize = 0;
+
+  GetIntegratedIntelVbtPtr (&VbtFileBuffer);
+  ///
+  ///  Locate the SA Global NVS Protocol.
+  ///
+  Status = gBS->LocateProtocol (
+                  &gSaNvsAreaProtocolGuid,
+                  NULL,
+                  (VOID **) &SaNvsAreaProtocol
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Check if VBT size is >6KB then allocate an ACPI NVS memory buffer as the IGD OpRegion + extended VBT size,
+  /// zero initialize it, and set the IGD OpRegion pointer in the Global NVS area structure.
+  ///
+  if ((VbtFileBuffer != NULL) && (VbtFileBuffer->HeaderVbtSize > 0x1800)) {
+    ExtendedVbtSize = ((VbtFileBuffer->HeaderVbtSize) & (UINT32)~(0x1FF)) + 0x200;
+  }
+
+  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof (IGD_OPREGION_STRUCTURE) + ExtendedVbtSize, (VOID **) &mIgdOpRegion.OpRegion);
+  ASSERT_EFI_ERROR (Status);
+  SetMem (mIgdOpRegion.OpRegion, sizeof (IGD_OPREGION_STRUCTURE) + ExtendedVbtSize, 0);
+  SaNvsAreaProtocol->Area->IgdOpRegionAddress = (UINT32) (UINTN) (mIgdOpRegion.OpRegion);
+
+  ///
+  /// If IGD is disabled return
+  ///
+  IgdBaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
+  if (PciSegmentRead32 (IgdBaseAddress + 0) == 0xFFFFFFFF) {
+    return EFI_SUCCESS;
+  }
+  ///
+  /// Initialize OpRegion Header
+  ///
+  CopyMem (mIgdOpRegion.OpRegion->Header.SIGN, HEADER_SIGNATURE, sizeof (HEADER_SIGNATURE));
+  ///
+  /// Set OpRegion Size in KBs
+  ///
+  mIgdOpRegion.OpRegion->Header.SIZE = HEADER_SIZE / 1024;
+  mIgdOpRegion.OpRegion->Header.OVER = (UINT32) (LShiftU64 (HEADER_OPREGION_VER_GEN12, 16) + LShiftU64 (HEADER_OPREGION_REV, 8));
+
+  ///
+  /// All Mailboxes are supported.
+  ///
+  mIgdOpRegion.OpRegion->Header.MBOX = HEADER_MBOX_SUPPORT;
+
+  ///
+  /// Initialize OpRegion Mailbox 1 (Public ACPI Methods).
+  ///
+  /// Note - The initial setting of mailbox 1 fields is implementation specific.
+  /// Adjust them as needed many even coming from user setting in setup.
+  ///
+  ///
+  /// Initialize OpRegion Mailbox 3 (ASLE Interrupt and Power Conservation).
+  ///
+  /// Note - The initial setting of mailbox 3 fields is implementation specific.
+  /// Adjust them as needed many even coming from user setting in setup.
+  ///
+  ///
+  /// Do not initialize TCHE. This field is written by the graphics driver only.
+  ///
+  ///
+  /// The ALSI field is generally initialized by ASL code by reading the embedded controller.
+  ///
+  mIgdOpRegion.OpRegion->Header.PCON = GraphicsDxeConfig->PlatformConfig;
+  mIgdOpRegion.OpRegion->Header.PCON = mIgdOpRegion.OpRegion->Header.PCON | 0x2;
+
+  mIgdOpRegion.OpRegion->MBox3.BCLP = BACKLIGHT_BRIGHTNESS;
+
+  mIgdOpRegion.OpRegion->MBox3.PFIT = (FIELD_VALID_BIT | PFIT_STRETCH);
+
+  ///
+  /// Reporting to driver for VR IMON Calibration. Bits [5-1] values supported 14A to 31A.
+  ///
+  mIgdOpRegion.OpRegion->MBox3.PCFT = (SaNvsAreaProtocol->Area->GfxTurboIMON << 1) & 0x003E;
+
+  ///
+  /// Set Initial current Brightness
+  ///
+  mIgdOpRegion.OpRegion->MBox3.CBLV = (INIT_BRIGHT_LEVEL | FIELD_VALID_BIT);
+
+  ///
+  /// Static Backlight Brightness Level Duty cycle Mapping Table
+  ///
+  for (Index = 0; Index < MAX_BCLM_ENTRIES; Index++) {
+    mIgdOpRegion.OpRegion->MBox3.BCLM[Index] = GraphicsDxeConfig->BCLM[Index];
+  }
+
+  mIgdOpRegion.OpRegion->MBox3.IUER = 0x00;
+
+  if (!EFI_ERROR (Status)) {
+    mIgdOpRegion.OpRegion->MBox3.IUER =  GraphicsDxeConfig->IuerStatusVal;
+  }
+
+  ///
+  /// Initialize hardware state:
+  ///   Set ASLS Register to the OpRegion physical memory address.
+  ///   Set SWSCI register bit 15 to a "1" to activate SCI interrupts.
+  ///
+  PciSegmentWrite32 (IgdBaseAddress + R_SA_IGD_ASLS_OFFSET, (UINT32) (UINTN) (mIgdOpRegion.OpRegion));
+  PciSegmentAndThenOr16 (IgdBaseAddress + R_SA_IGD_SWSCI_OFFSET, (UINT16) ~(BIT0), BIT15);
+
+  DwordData = PciSegmentRead32 (IgdBaseAddress + R_SA_IGD_ASLS_OFFSET);
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) PcdGet64 (PcdPciExpressBaseAddress) + (IgdBaseAddress + R_SA_IGD_ASLS_OFFSET),
+    1,
+    &DwordData
+    );
+  DwordData = PciSegmentRead32 (IgdBaseAddress + R_SA_IGD_SWSCI_OFFSET);
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) PcdGet64 (PcdPciExpressBaseAddress) + (IgdBaseAddress + R_SA_IGD_SWSCI_OFFSET),
+    1,
+    &DwordData
+    );
+
+  ///
+  /// Install OpRegion / Software SCI protocol
+  ///
+  Handle = NULL;
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &Handle,
+                  &gIgdOpRegionProtocolGuid,
+                  &mIgdOpRegion,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Return final status
+  ///
+  return EFI_SUCCESS;
+}
+
+/**
+  Update Graphics OpRegion after PCI enumeration.
+
+  @param[in] void         - None
+  @retval EFI_SUCCESS     - The function completed successfully.
+**/
+EFI_STATUS
+UpdateIgdOpRegionEndOfDxe (
+  VOID
+  )
+{
+  EFI_STATUS                    Status;
+  UINTN                         HandleCount;
+  EFI_HANDLE                    *HandleBuffer;
+  UINTN                         Index;
+  EFI_PCI_IO_PROTOCOL           *PciIo;
+  PCI_TYPE00                    Pci;
+  UINTN                         Segment;
+  UINTN                         Bus;
+  UINTN                         Device;
+  UINTN                         Function;
+
+  Bus      = 0;
+  Device   = 0;
+  Function = 0;
+
+  DEBUG ((DEBUG_INFO, "UpdateIgdOpRegionEndOfDxe\n"));
+
+  mIgdOpRegion.OpRegion->Header.PCON |= BIT8; //Set External Gfx Adapter field is valid
+  mIgdOpRegion.OpRegion->Header.PCON &= (UINT32) (~BIT7); //Assume No External Gfx Adapter
+
+  ///
+  /// Get all PCI IO protocols handles
+  ///
+  Status = gBS->LocateHandleBuffer (
+                  ByProtocol,
+                  &gEfiPciIoProtocolGuid,
+                  NULL,
+                  &HandleCount,
+                  &HandleBuffer
+                  );
+
+  if (!EFI_ERROR (Status)) {
+    for (Index = 0; Index < HandleCount; Index++) {
+      ///
+      /// Get the PCI IO Protocol Interface corresponding to each handle
+      ///
+      Status = gBS->HandleProtocol (
+                      HandleBuffer[Index],
+                      &gEfiPciIoProtocolGuid,
+                      (VOID **) &PciIo
+                      );
+
+      if (!EFI_ERROR (Status)) {
+        ///
+        /// Read the PCI configuration space
+        ///
+        Status = PciIo->Pci.Read (
+                              PciIo,
+                              EfiPciIoWidthUint32,
+                              0,
+                              sizeof (Pci) / sizeof (UINT32),
+                              &Pci
+                              );
+
+        ///
+        /// Find the display controllers devices
+        ///
+        if (!EFI_ERROR (Status) && IS_PCI_DISPLAY (&Pci)) {
+          Status = PciIo->GetLocation (
+                            PciIo,
+                            &Segment,
+                            &Bus,
+                            &Device,
+                            &Function
+                            );
+
+          //
+          // Assumption: Onboard devices will be sits on Bus no 0, while external devices will be sits on Bus no > 0
+          //
+          if (!EFI_ERROR (Status) && (Bus > 0)) {
+            //External Gfx Adapter Detected and Available
+            DEBUG ((DEBUG_INFO, "PCON - External Gfx Adapter Detected and Available\n"));
+            mIgdOpRegion.OpRegion->Header.PCON |= BIT7;
+            break;
+          }
+        }
+      }
+    }
+  }
+
+  ///
+  /// Free any allocated buffers
+  ///
+  if (HandleBuffer != NULL) {
+    FreePool (HandleBuffer);
+  }
+
+  ///
+  /// Return final status
+  ///
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf
new file mode 100644
index 0000000000..20c6265d8f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf
@@ -0,0 +1,49 @@
+## @file
+# Component description file for the Dxe IGD OpRegion library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeIgdOpRegionInitLib
+FILE_GUID = 18D47D72-555E-475B-A4E4-AD20C3BD8B15
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+UEFI_SPECIFICATION_VERSION = 2.00
+LIBRARY_CLASS = DxeIgdOpRegionInitLib
+
+[LibraryClasses]
+UefiLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+PciSegmentLib
+BaseMemoryLib
+MemoryAllocationLib
+IoLib
+S3BootScriptLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+IntelSiliconPkg/IntelSiliconPkg.dec
+
+[Pcd]
+gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
+
+[Sources]
+DxeIgdOpRegionInit.c
+
+[Guids]
+gGraphicsDxeConfigGuid        ## CONSUMES
+
+[Protocols]
+gIgdOpRegionProtocolGuid               ## PRODUCES
+gSaPolicyProtocolGuid                  ## CONSUMES
+gEfiPciIoProtocolGuid                  ## CONSUMES
+gSaNvsAreaProtocolGuid                 ## CONSUMES
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (16 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component Heng Luo
                   ` (21 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Hda/IncludePrivate
  * IpBlock/Hda/Library
  * IpBlock/Hda/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeHdaPolicyLib.h           |  55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/HdaRegs.h                  |  46 ++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.c              | 383 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.inf            |  31 +++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.c   |  92 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.inf |  31 +++++++++++++++++++++++++++++++
 6 files changed, 638 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeHdaPolicyLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeHdaPolicyLib.h
new file mode 100644
index 0000000000..9c42bf5611
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeHdaPolicyLib.h
@@ -0,0 +1,55 @@
+/** @file
+  DXE Hda policy library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_HDA_POLICY_LIB_H_
+#define _DXE_HDA_POLICY_LIB_H_
+
+#include <Protocol/PchPolicy.h>
+
+/**
+  Print HDAUDIO_DXE_CONFIG and serial out.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+HdaDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  );
+
+/**
+  Load Config block default
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+HdaDxeLoadConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  );
+
+/**
+  Get Hda config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+HdaDxeGetConfigBlockTotalSize (
+  VOID
+  );
+
+/**
+  Add Hda ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+HdaDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  );
+
+#endif // _DXE_HDA_POLICY_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/HdaRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/HdaRegs.h
new file mode 100644
index 0000000000..b165e7bb22
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/HdaRegs.h
@@ -0,0 +1,46 @@
+/** @file
+  Register names for High Definition Audio device.
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HDA_REGS_H_
+#define _HDA_REGS_H_
+
+//
+// HD-A Controller Registers
+//
+// PCI Configuration Space Registers
+//
+#define R_HDA_CFG_PCS                           0x54
+#define B_HDA_CFG_PCS_PMEE                      BIT8
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.c
new file mode 100644
index 0000000000..71388934e6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.c
@@ -0,0 +1,383 @@
+/** @file
+  HD Audio NHLT Library implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/DebugLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PcdLib.h>
+#include <ConfigBlock.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/PchInfoLib.h>
+#include <DxeHdaNhlt.h>
+
+/**
+  Returns pointer to Endpoint ENDPOINT_DESCRIPTOR structure.
+
+  @param[in] *NhltTable    Endpoint for which Format address is retrieved
+  @param[in] FormatIndex   Index of Format to be retrieved
+
+  @retval                  Pointer to ENDPOINT_DESCRIPTOR structure with given index
+**/
+ENDPOINT_DESCRIPTOR *
+GetNhltEndpoint (
+  IN CONST NHLT_ACPI_TABLE      *NhltTable,
+  IN CONST UINT8                EndpointIndex
+  )
+{
+  UINT8               Index;
+  ENDPOINT_DESCRIPTOR *Endpoint;
+  Endpoint = (ENDPOINT_DESCRIPTOR*) (NhltTable->EndpointDescriptors);
+
+  if (EndpointIndex > NhltTable->EndpointCount) {
+    return NULL;
+  }
+
+  for (Index = 0; Index < EndpointIndex; Index++) {
+    Endpoint = (ENDPOINT_DESCRIPTOR*) ((UINT8*) (Endpoint) + Endpoint->EndpointDescriptorLength);
+  }
+
+  return Endpoint;
+}
+
+/**
+  Returns pointer to Endpoint Specific Configuration SPECIFIC_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which config address is retrieved
+
+  @retval                  Pointer to SPECIFIC_CONFIG structure with endpoint's capabilities
+**/
+SPECIFIC_CONFIG *
+GetNhltEndpointDeviceCapabilities (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  )
+{
+  return (SPECIFIC_CONFIG*) (&Endpoint->EndpointConfig);
+}
+
+/**
+  Returns pointer to all Formats Configuration FORMATS_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which Formats address is retrieved
+
+  @retval                  Pointer to FORMATS_CONFIG structure
+**/
+FORMATS_CONFIG *
+GetNhltEndpointFormatsConfig (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  )
+{
+  FORMATS_CONFIG *FormatsConfig;
+  FormatsConfig = (FORMATS_CONFIG*) ((UINT8*) (&Endpoint->EndpointConfig)
+                                     + sizeof (Endpoint->EndpointConfig.CapabilitiesSize)
+                                     + Endpoint->EndpointConfig.CapabilitiesSize);
+
+  return FormatsConfig;
+}
+
+/**
+  Returns pointer to Format Configuration FORMAT_CONFIG structure.
+
+  @param[in] *Endpoint     Endpoint for which Format address is retrieved
+  @param[in] FormatIndex   Index of Format to be retrieved
+
+  @retval                  Pointer to FORMAT_CONFIG structure with given index
+**/
+FORMAT_CONFIG *
+GetNhltEndpointFormat (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
+  IN CONST UINT8                FormatIndex
+  )
+{
+  UINT8          Index;
+  UINT32         Length;
+  FORMATS_CONFIG *FormatsConfig;
+  FORMAT_CONFIG  *Format;
+
+  Length = 0;
+  FormatsConfig = GetNhltEndpointFormatsConfig (Endpoint);
+  Format = FormatsConfig->FormatsConfiguration;
+
+  if (FormatIndex > FormatsConfig->FormatsCount) {
+    return NULL;
+  }
+
+  for (Index = 0; Index < FormatIndex; Index++) {
+    Length = sizeof (Format->Format) + Format->FormatConfiguration.CapabilitiesSize
+      + sizeof (Format->FormatConfiguration.CapabilitiesSize);
+    Format = (FORMAT_CONFIG*) ((UINT8*) (Format) + Length);
+  }
+
+  return Format;
+}
+
+/**
+  Returns pointer to all Device Information DEVICES_INFO structure.
+
+  @param[in] *Endpoint     Endpoint for which DevicesInfo address is retrieved
+
+  @retval                  Pointer to DEVICES_INFO structure
+**/
+DEVICES_INFO *
+GetNhltEndpointDevicesInfo (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  )
+{
+  DEVICES_INFO   *DevicesInfo;
+  FORMATS_CONFIG *FormatsConfig;
+  FORMAT_CONFIG  *Format;
+
+  FormatsConfig = GetNhltEndpointFormatsConfig (Endpoint);
+  Format = GetNhltEndpointFormat (Endpoint, FormatsConfig->FormatsCount);
+  DevicesInfo = (DEVICES_INFO*) ((UINT8*) Format);
+
+  return DevicesInfo;
+}
+
+/**
+  Returns pointer to Device Information DEVICES_INFO structure.
+
+  @param[in] *Endpoint       Endpoint for which Device Info address is retrieved
+  @param[in] DeviceInfoIndex Index of Device Info to be retrieved
+
+  @retval                    Pointer to DEVICE_INFO structure with given index
+**/
+DEVICE_INFO *
+GetNhltEndpointDeviceInfo (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
+  IN CONST UINT8                DeviceInfoIndex
+  )
+{
+  DEVICES_INFO  *DevicesInfo;
+  DEVICE_INFO   *DeviceInfo;
+
+  DevicesInfo = GetNhltEndpointDevicesInfo (Endpoint);
+  DeviceInfo = DevicesInfo->DeviceInformation;
+
+  if (DevicesInfo == NULL || DeviceInfoIndex >= DevicesInfo->DeviceInfoCount) {
+    return NULL;
+  }
+
+  DeviceInfo = (DEVICE_INFO*) ((UINT8*) (DeviceInfo) + sizeof (*DeviceInfo) * DeviceInfoIndex);
+
+  return DeviceInfo;
+}
+
+/**
+  Returns pointer to OED Configuration SPECIFIC_CONFIG structure.
+
+  @param[in] *NhltTable    NHLT table for which OED address is retrieved
+
+  @retval                  Pointer to SPECIFIC_CONFIG structure with NHLT capabilities
+**/
+SPECIFIC_CONFIG *
+GetNhltOedConfig (
+  IN CONST NHLT_ACPI_TABLE      *NhltTable
+  )
+{
+  ENDPOINT_DESCRIPTOR *Endpoint;
+  SPECIFIC_CONFIG     *OedConfig;
+
+  Endpoint = GetNhltEndpoint (NhltTable, (NhltTable->EndpointCount));
+  OedConfig = (SPECIFIC_CONFIG*) ((UINT8*) (Endpoint));
+
+  return OedConfig;
+}
+
+/**
+  Prints Format configuration.
+
+  @param[in] *Format       Format to be printed
+
+  @retval None
+**/
+VOID
+NhltFormatDump (
+  IN CONST FORMAT_CONFIG        *Format
+  )
+{
+  UINT32 Index;
+
+  DEBUG ((DEBUG_INFO, "------------------------------- FORMAT -------------------------------\n"));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.wFormatTag      = 0x%x\n", Format->Format.Format.wFormatTag));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.nChannels       = %d\n", Format->Format.Format.nChannels));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.nSamplesPerSec  = %d\n", Format->Format.Format.nSamplesPerSec));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.nAvgBytesPerSec = %d\n", Format->Format.Format.nAvgBytesPerSec));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.nBlockAlign     = %d\n", Format->Format.Format.nBlockAlign));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.wBitsPerSample  = %d\n", Format->Format.Format.wBitsPerSample));
+  DEBUG ((DEBUG_INFO, " Format->Format.Format.cbSize          = %d\n", Format->Format.Format.cbSize));
+  DEBUG ((DEBUG_INFO, " Format->Format.Samples                = %d\n", Format->Format.Samples));
+  DEBUG ((DEBUG_INFO, " Format->Format.dwChannelMask          = 0x%x\n", Format->Format.dwChannelMask));
+  DEBUG ((DEBUG_INFO, " Format->Format.SubFormat              = %g\n", Format->Format.SubFormat));
+
+
+  DEBUG ((DEBUG_INFO, " Format->FormatConfiguration.CapabilitiesSize = %d B\n", Format->FormatConfiguration.CapabilitiesSize));
+  DEBUG ((DEBUG_VERBOSE, " Format->FormatConfiguration.Capabilities:"));
+  for (Index = 0; Index < (  Format->FormatConfiguration.CapabilitiesSize ) ; Index++) {
+    if (Index % 16 == 0) {
+      DEBUG ((DEBUG_VERBOSE, "\n"));
+    }
+    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", Format->FormatConfiguration.Capabilities[Index]));
+  }
+  DEBUG ((DEBUG_VERBOSE, "\n"));
+}
+
+/**
+  Prints Device Information.
+
+  @param[in] *DeviceInfo       DeviceInfo to be printed
+
+  @retval None
+**/
+VOID
+NhltDeviceInfoDump (
+  IN CONST DEVICE_INFO          *DeviceInfo
+  )
+{
+  DEBUG ((DEBUG_INFO, "----------------------------- DEVICE INFO ----------------------------\n"));
+  DEBUG ((DEBUG_INFO, " DeviceInfo->DeviceId         = %a\n",   DeviceInfo->DeviceId));
+  DEBUG ((DEBUG_INFO, " DeviceInfo->DeviceInstanceId = 0x%x\n", DeviceInfo->DeviceInstanceId));
+  DEBUG ((DEBUG_INFO, " DeviceInfo->DevicePortId     = 0x%x\n", DeviceInfo->DevicePortId));
+}
+
+/**
+  Prints Endpoint configuration.
+
+  @param[in] *Endpoint     Endpoint to be printed
+
+  @retval None
+**/
+VOID
+NhltEndpointDump (
+  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
+  )
+{
+  UINT8 Index;
+  FORMATS_CONFIG *FormatsConfigs;
+  FORMAT_CONFIG  *Format;
+  DEVICES_INFO   *DevicesInfo;
+  DEVICE_INFO    *DeviceInfo;
+
+  DEBUG ((DEBUG_INFO, "------------------------------ ENDPOINT ------------------------------\n"));
+  DEBUG ((DEBUG_INFO, " Endpoint->DeviceDescriptorLength = %d B\n", Endpoint->EndpointDescriptorLength));
+  DEBUG ((DEBUG_INFO, " Endpoint->LinkType               = 0x%x\n", Endpoint->LinkType));
+  DEBUG ((DEBUG_INFO, " Endpoint->InstanceId             = 0x%x\n", Endpoint->InstanceId));
+  DEBUG ((DEBUG_INFO, " Endpoint->HwVendorId             = 0x%x\n", Endpoint->HwVendorId));
+  DEBUG ((DEBUG_INFO, " Endpoint->HwDeviceId             = 0x%x\n", Endpoint->HwDeviceId));
+  DEBUG ((DEBUG_INFO, " Endpoint->HwRevisionId           = 0x%x\n", Endpoint->HwRevisionId));
+  DEBUG ((DEBUG_INFO, " Endpoint->HwSubsystemId          = 0x%x\n", Endpoint->HwSubsystemId));
+  DEBUG ((DEBUG_INFO, " Endpoint->DeviceType             = 0x%x\n", Endpoint->DeviceType));
+  DEBUG ((DEBUG_INFO, " Endpoint->Direction              = 0x%x\n", Endpoint->Direction));
+  DEBUG ((DEBUG_INFO, " Endpoint->VirtualBusId           = 0x%x\n", Endpoint->VirtualBusId));
+
+  DEBUG ((DEBUG_INFO, " Endpoint->EndpointConfig.CapabilitiesSize = %d B\n", Endpoint->EndpointConfig.CapabilitiesSize));
+  DEBUG ((DEBUG_VERBOSE, " Endpoint->EndpointConfig.Capabilities:"));
+  for (Index = 0; Index < (Endpoint->EndpointConfig.CapabilitiesSize ) ; Index++) {
+    if (Index % 16 == 0) DEBUG ((DEBUG_VERBOSE, "\n"));
+    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", Endpoint->EndpointConfig.Capabilities[Index]));
+  }
+
+  FormatsConfigs = GetNhltEndpointFormatsConfig (Endpoint);
+
+  DEBUG ((DEBUG_INFO, "\n"));
+  DEBUG ((DEBUG_INFO, " Endpoint->FormatsConfig.FormatsCount = %d\n", FormatsConfigs->FormatsCount));
+  for (Index = 0; Index < FormatsConfigs->FormatsCount; Index++) {
+    Format = GetNhltEndpointFormat (Endpoint, Index);
+    if (Format != NULL) {
+      NhltFormatDump (Format);
+    }
+  }
+
+  DevicesInfo = GetNhltEndpointDevicesInfo (Endpoint);
+  if (DevicesInfo != NULL) {
+    DEBUG ((DEBUG_INFO, "\n"));
+    DEBUG ((DEBUG_INFO, " Endpoint->DevicesInfo.DeviceInfoCount = %d\n", DevicesInfo->DeviceInfoCount));
+    for (Index = 0; Index < DevicesInfo->DeviceInfoCount; Index++) {
+      DeviceInfo = GetNhltEndpointDeviceInfo (Endpoint, Index);
+      if (DeviceInfo != NULL) {
+        NhltDeviceInfoDump (DeviceInfo);
+      }
+    }
+  }
+  DEBUG ((DEBUG_VERBOSE, "\n"));
+}
+
+/**
+  Prints OED (Offload Engine Driver) configuration.
+
+  @param[in] *OedConfig   OED to be printed
+
+  @retval None
+**/
+VOID
+NhltOedConfigDump (
+  IN CONST SPECIFIC_CONFIG      *OedConfig
+  )
+{
+  UINT8 Index;
+
+  DEBUG ((DEBUG_INFO, "-------------------------- OED CONFIGURATION -------------------------\n"));
+  DEBUG ((DEBUG_INFO, " OedConfig->CapabilitiesSize = %d B\n", OedConfig->CapabilitiesSize));
+  DEBUG ((DEBUG_VERBOSE, " OedConfig->Capabilities:"));
+  for (Index = 0; Index < (OedConfig->CapabilitiesSize) ; Index++) {
+    if (Index % 16 == 0) DEBUG ((DEBUG_VERBOSE, "\n"));
+    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", OedConfig->Capabilities[Index]));
+  }
+
+  DEBUG ((DEBUG_VERBOSE, "\n"));
+}
+
+/**
+  Prints NHLT (Non HDA-Link Table) to be exposed via ACPI (aka. OED (Offload Engine Driver) Configuration Table).
+
+  @param[in] *NhltTable    The NHLT table to print
+
+  @retval None
+**/
+VOID
+NhltAcpiTableDump (
+  IN NHLT_ACPI_TABLE            *NhltTable
+  )
+{
+  DEBUG_CODE_BEGIN ();
+  UINT8 Index;
+
+  DEBUG ((DEBUG_INFO, "\n"));
+  DEBUG ((DEBUG_INFO, "--- NHLT ACPI Table Dump [OED (Offload Engine Driver) Configuration] ---\n"));
+
+  DEBUG ((DEBUG_INFO, "sizeof NHLT_ACPI_TABLE = %d B\n", sizeof (NHLT_ACPI_TABLE)));
+  DEBUG ((DEBUG_INFO, "sizeof EFI_ACPI_DESCRIPTION_HEADER = %d B\n", sizeof (EFI_ACPI_DESCRIPTION_HEADER)));
+  DEBUG ((DEBUG_INFO, "sizeof ENDPOINT_DESCRIPTOR = %d B\n", sizeof (ENDPOINT_DESCRIPTOR)));
+  DEBUG ((DEBUG_INFO, "sizeof SPECIFIC_CONFIG = %d B\n", sizeof (SPECIFIC_CONFIG)));
+  DEBUG ((DEBUG_INFO, "sizeof FORMATS_CONFIG = %d B\n", sizeof (FORMATS_CONFIG)));
+  DEBUG ((DEBUG_INFO, "sizeof FORMAT_CONFIG = %d B\n", sizeof (FORMAT_CONFIG)));
+  DEBUG ((DEBUG_INFO, "sizeof WAVEFORMATEXTENSIBLE = %d B\n", sizeof (WAVEFORMATEXTENSIBLE)));
+  DEBUG ((DEBUG_INFO, "sizeof DEVICES_INFO = %d B\n", sizeof (DEVICES_INFO)));
+  DEBUG ((DEBUG_INFO, "sizeof DEVICE_INFO = %d B\n", sizeof (DEVICE_INFO)));
+
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Signature       = 0x%08x\n", NhltTable->Header.Signature));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Length          = 0x%08x\n", NhltTable->Header.Length));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Revision        = 0x%02x\n", NhltTable->Header.Revision));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Checksum        = 0x%02x\n", NhltTable->Header.Checksum));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemId           = %a\n",     NhltTable->Header.OemId));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemTableId      = 0x%lx\n",  NhltTable->Header.OemTableId));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemRevision     = 0x%08x\n", NhltTable->Header.OemRevision));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.CreatorId       = 0x%08x\n", NhltTable->Header.CreatorId));
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.CreatorRevision = 0x%08x\n", NhltTable->Header.CreatorRevision));
+  DEBUG ((DEBUG_INFO, "\n"));
+
+  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE EndpointCount = %d\n", NhltTable->EndpointCount));
+  for (Index = 0; Index < NhltTable->EndpointCount; Index++) {
+    NhltEndpointDump (GetNhltEndpoint (NhltTable, Index));
+  }
+
+  NhltOedConfigDump (GetNhltOedConfig (NhltTable));
+  DEBUG ((DEBUG_INFO, "----------------------------------------------------------------------\n"));
+
+  DEBUG_CODE_END ();
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.inf
new file mode 100644
index 0000000000..a1574c3ab1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.inf
@@ -0,0 +1,31 @@
+## @file
+# Component information file for HD Audio NHLT Library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeHdaNhltLib
+FILE_GUID = DA915B7F-EE08-4C1D-B3D0-DE7C52AB155A
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeHdaNhltLib
+
+[LibraryClasses]
+BaseLib
+DebugLib
+MemoryAllocationLib
+BaseMemoryLib
+PchInfoLib
+ConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeHdaNhltLib.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.c
new file mode 100644
index 0000000000..30843fab39
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.c
@@ -0,0 +1,92 @@
+/** @file
+  This file provides services for Hda policy function
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/SiConfigBlockLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Protocol/PchPolicy.h>
+#include <HdAudioConfig.h>
+
+/**
+  Print HDAUDIO_DXE_CONFIG and serial out.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+HdaDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  )
+{
+  EFI_STATUS            Status;
+  HDAUDIO_DXE_CONFIG    *HdaDxeConfig;
+  UINT32                Index;
+
+  Status = GetConfigBlock ((VOID *) PchPolicy, &gHdAudioDxeConfigGuid, (VOID *) &HdaDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "------------------ HD-Audio DXE Config ------------------\n"));
+
+  for (Index = 0; Index < PCH_MAX_HDA_SNDW_LINK_NUM; Index++) {
+    DEBUG ((DEBUG_INFO, " SNDW%d AutonomousClockStop  : %d\n", Index, HdaDxeConfig->SndwConfig[Index].AutonomousClockStop));
+    DEBUG ((DEBUG_INFO, " SNDW%d DODS                 : %d\n", Index, HdaDxeConfig->SndwConfig[Index].DataOnDelaySelect));
+    DEBUG ((DEBUG_INFO, " SNDW%d DOAS                 : %d\n", Index, HdaDxeConfig->SndwConfig[Index].DataOnActiveIntervalSelect));
+  }
+  DEBUG ((DEBUG_INFO, " DSP Feature Mask              : 0x%x\n", HdaDxeConfig->DspFeatureMask));
+}
+
+/**
+  Load Config block default
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+HdaDxeLoadConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  )
+{
+  HDAUDIO_DXE_CONFIG  *HdAudioDxeConfig;
+  HdAudioDxeConfig = ConfigBlockPointer;
+
+  DEBUG ((DEBUG_INFO, "HdaDxeConfig->Header.GuidHob.Name = %g\n", &HdAudioDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "HdaDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", HdAudioDxeConfig->Header.GuidHob.Header.HobLength));
+}
+
+STATIC COMPONENT_BLOCK_ENTRY  mHdaBlocks = {
+  &gHdAudioDxeConfigGuid,
+  sizeof (HDAUDIO_DXE_CONFIG),
+  HDAUDIO_DXE_CONFIG_REVISION,
+  HdaDxeLoadConfigDefault
+};
+
+/**
+  Get Hda config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+HdaDxeGetConfigBlockTotalSize (
+  VOID
+  )
+{
+  return mHdaBlocks.Size;
+}
+
+/**
+  Add Hda ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+HdaDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  )
+{
+  return AddComponentConfigBlocks (ConfigBlockTableAddress, &mHdaBlocks, 1);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.inf
new file mode 100644
index 0000000000..758499b95e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.inf
@@ -0,0 +1,31 @@
+## @file
+# Component description file for the Hda policy library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeHdaPolicyLib
+FILE_GUID = B053EFE4-0868-4510-A71D-96A85CD16C77
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeHdaPolicyLib
+
+[LibraryClasses]
+DebugLib
+ConfigBlockLib
+SiConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeHdaPolicyLib.c
+
+[Guids]
+gHdAudioDxeConfigGuid  ## CONSUMES
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (17 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component Heng Luo
                   ` (20 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/HostBridge/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBridgeDataHob.h | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBridgeDataHob.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBridgeDataHob.h
new file mode 100644
index 0000000000..41e92da4df
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBridgeDataHob.h
@@ -0,0 +1,25 @@
+/** @file
+  The GUID definition for Host Bridge Data Hob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _HOST_BRIDGE_DATA_HOB_H_
+#define _HOST_BRIDGE_DATA_HOB_H_
+
+#include <Base.h>
+
+extern EFI_GUID gHostBridgeDataHobGuid;
+#pragma pack (push,1)
+
+///
+/// Host Bridge Data Hob
+///
+typedef struct {
+  EFI_HOB_GUID_TYPE        EfiHobGuidType;                       ///< GUID Hob type structure for gSaDataHobGuid
+  UINT8                    EnableAbove4GBMmio;                   ///< 0=Disable above 4GB MMIO resource support, 1=Enable above 4GB MMIO resource support
+  BOOLEAN                  SkipPamLock;                          ///< 0=All PAM registers will be locked in System Agent code, 1=Do not lock PAM registers in System Agent code.
+  UINT8                    Rsvd1[2];                             ///< Reserved for future use
+} HOST_BRIDGE_DATA_HOB;
+#pragma pack (pop)
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (18 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component Heng Luo
                   ` (19 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/P2sb/IncludePrivate
  * IpBlock/P2sb/Library
  * IpBlock/P2sb/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchSbiAccessLib.h                             | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2sbRegs.h                                   |  65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/CpuRegbarAccessLib.c             | 494 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf  |  35 +++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PchPcrLib.c                               | 313 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PeiDxeSmmPchPcrLib.inf                    |  35 +++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PchSbiAccessLib.c            | 253 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf |  36 ++++++++++++++++++++++++++++++++++++
 8 files changed, 1343 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchSbiAccessLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchSbiAccessLib.h
new file mode 100644
index 0000000000..3fab933bbd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchSbiAccessLib.h
@@ -0,0 +1,112 @@
+/** @file
+  Header file for PchSbiAccessLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SBI_ACCESS_LIB_H_
+#define _PCH_SBI_ACCESS_LIB_H_
+
+#include <Library/PchPcrLib.h>
+
+/**
+  PCH SBI opcode definitions
+**/
+typedef enum {
+  MemoryRead             = 0x0,
+  MemoryWrite            = 0x1,
+  PciConfigRead          = 0x4,
+  PciConfigWrite         = 0x5,
+  PrivateControlRead     = 0x6,
+  PrivateControlWrite    = 0x7,
+  GpioLockUnlock         = 0x13
+} PCH_SBI_OPCODE;
+
+/**
+  PCH SBI response status definitions
+**/
+typedef enum {
+  SBI_SUCCESSFUL          = 0,
+  SBI_UNSUCCESSFUL        = 1,
+  SBI_POWERDOWN           = 2,
+  SBI_MIXED               = 3,
+  SBI_INVALID_RESPONSE
+} PCH_SBI_RESPONSE;
+
+/**
+  Execute PCH SBI message
+  Take care of that there is no lock protection when using SBI programming in both POST time and SMI.
+  It will clash with POST time SBI programming when SMI happen.
+  Programmer MUST do the save and restore opration while using the PchSbiExecution inside SMI
+  to prevent from racing condition.
+  This function will reveal P2SB and hide P2SB if it's originally hidden. If more than one SBI access
+  needed, it's better to unhide the P2SB before calling and hide it back after done.
+
+  When the return value is "EFI_SUCCESS", the "Response" do not need to be checked as it would have been
+  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would provide additional information
+  when needed.
+
+  @param[in] Pid                        Port ID of the SBI message
+  @param[in] Offset                     Offset of the SBI message
+  @param[in] Opcode                     Opcode
+  @param[in] Posted                     Posted message
+  @param[in, out] Data32                Read/Write data
+  @param[out] Response                  Response
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_DEVICE_ERROR              Transaction fail
+  @retval EFI_INVALID_PARAMETER         Invalid parameter
+  @retval EFI_TIMEOUT                   Timeout while waiting for response
+**/
+EFI_STATUS
+PchSbiExecution (
+  IN     PCH_SBI_PID                    Pid,
+  IN     UINT64                         Offset,
+  IN     PCH_SBI_OPCODE                 Opcode,
+  IN     BOOLEAN                        Posted,
+  IN OUT UINT32                         *Data32,
+  OUT    UINT8                          *Response
+  );
+
+/**
+  Full function for executing PCH SBI message
+  Take care of that there is no lock protection when using SBI programming in both POST time and SMI.
+  It will clash with POST time SBI programming when SMI happen.
+  Programmer MUST do the save and restore opration while using the PchSbiExecution inside SMI
+  to prevent from racing condition.
+  This function will reveal P2SB and hide P2SB if it's originally hidden. If more than one SBI access
+  needed, it's better to unhide the P2SB before calling and hide it back after done.
+
+  When the return value is "EFI_SUCCESS", the "Response" do not need to be checked as it would have been
+  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would provide additional information
+  when needed.
+
+  @param[in] Pid                        Port ID of the SBI message
+  @param[in] Offset                     Offset of the SBI message
+  @param[in] Opcode                     Opcode
+  @param[in] Posted                     Posted message
+  @param[in] Fbe                        First byte enable
+  @param[in] Bar                        Bar
+  @param[in] Fid                        Function ID
+  @param[in, out] Data32                Read/Write data
+  @param[out] Response                  Response
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_DEVICE_ERROR              Transaction fail
+  @retval EFI_INVALID_PARAMETER         Invalid parameter
+  @retval EFI_TIMEOUT                   Timeout while waiting for response
+**/
+EFI_STATUS
+PchSbiExecutionEx (
+  IN     PCH_SBI_PID                    Pid,
+  IN     UINT64                         Offset,
+  IN     PCH_SBI_OPCODE                 Opcode,
+  IN     BOOLEAN                        Posted,
+  IN     UINT16                         Fbe,
+  IN     UINT16                         Bar,
+  IN     UINT16                         Fid,
+  IN OUT UINT32                         *Data32,
+  OUT    UINT8                          *Response
+  );
+
+#endif // _PCH_SBI_ACCESS_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2sbRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2sbRegs.h
new file mode 100644
index 0000000000..44c71af719
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2sbRegs.h
@@ -0,0 +1,65 @@
+/** @file
+  Register names for PCH P2SB device
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _P2SB_REGS_H_
+#define _P2SB_REGS_H_
+
+//
+// PCI to P2SB Bridge Registers
+//
+
+#define R_IO_APIC_MEM_INDEX_OFFSET                 0x00
+#define R_IO_APIC_MEM_DATA_OFFSET                  0x10
+#define V_P2SB_CFG_IBDF_BUS                        0
+#define V_P2SB_CFG_IBDF_DEV                        30
+#define V_P2SB_CFG_IBDF_FUNC                       7
+#define V_P2SB_CFG_HBDF_BUS                        0
+#define V_P2SB_CFG_HBDF_DEV                        30
+#define V_P2SB_CFG_HBDF_FUNC                       6
+
+//
+// Definition for SBI
+//
+#define R_P2SB_CFG_SBIADDR                         0xD0
+#define R_P2SB_CFG_SBIDATA                         0xD4
+#define R_P2SB_CFG_SBISTAT                         0xD8
+#define B_P2SB_CFG_SBISTAT_OPCODE                  0xFF00
+#define B_P2SB_CFG_SBISTAT_POSTED                  BIT7
+#define B_P2SB_CFG_SBISTAT_RESPONSE                0x0006
+#define N_P2SB_CFG_SBISTAT_RESPONSE                1
+#define B_P2SB_CFG_SBISTAT_INITRDY                 BIT0
+#define R_P2SB_CFG_SBIRID                          0xDA
+#define R_P2SB_CFG_SBIEXTADDR                      0xDC
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/CpuRegbarAccessLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/CpuRegbarAccessLib.c
new file mode 100644
index 0000000000..9d8851ac37
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/CpuRegbarAccessLib.c
@@ -0,0 +1,494 @@
+/** @file
+  CPU REGBAR ACCESS library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/CpuRegbarAccessLib.h>
+
+/**
+  Definition for REGBAR address
+  The REGBAR address is used for the CPU IP's SB register access
+**/
+#define CPU_REGBAR_ADDRESS(Pid, Offset)    (PcdGet32(PcdRegBarBaseAddress) | ((UINT8)(Pid) << 16) | (UINT16)(Offset))
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 8bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of this Port ID
+
+  @retval     UINT64           REGBAR register value.
+**/
+UINT64
+CpuRegbarRead64 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  )
+{
+  UINT8    Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID)
+    return ((UINT64) MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset)) + LShiftU64 ((UINT64) MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset+4)), 32));
+  else
+    return INVALID_DATA_64;
+}
+
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset              Register offset of this Port ID
+
+  @retval     UINT32           REGBAR register value.
+**/
+UINT32
+CpuRegbarRead32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  )
+{
+  UINT8    Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID)
+    return MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset));
+  else
+    return INVALID_DATA_32;
+}
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of this Port ID
+
+  @retval     UINT16           REGBAR register value.
+**/
+UINT16
+CpuRegbarRead16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  )
+{
+  UINT16   DwOffset;
+  UINT32   Data32;
+  UINT16   Data16;
+
+  Data16 = 0;
+  Data32 = 0;
+  DwOffset = 0;
+
+  if (CpuSbDevicePid == INVALID_PID) {
+    return INVALID_DATA_16;
+  }
+  switch (Offset & 0x0003) {
+    case 0:
+      DwOffset = Offset;
+      break;
+    case 2:
+      DwOffset = Offset - 0x2;
+      break;
+  }
+  Data32 = MmioRead32 (CPU_REGBAR_ADDRESS (CpuSbDevicePid, DwOffset));
+  switch (Offset & 0x0003) {
+    case 0:
+      Data16 = (UINT16) Data32;
+      break;
+    case 2:
+      Data16 = (UINT16) (Data32 >> 16);
+      break;
+  }
+  return Data16;
+}
+
+/**
+  Read REGBAR register.
+  It returns REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of this Port ID
+
+  @retval     UINT8            REGBAR regsiter value
+**/
+UINT8
+CpuRegbarRead8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset
+  )
+{
+  UINT16   DwOffset;
+  UINT32   Data32;
+  UINT8    Data8;
+
+  DwOffset = 0;
+  Data32 = 0;
+  Data8 = 0;
+
+  if (CpuSbDevicePid == INVALID_PID)
+    return INVALID_DATA_8;
+  switch (Offset & 0x0003) {
+    case 0:
+      DwOffset = Offset;
+      break;
+    case 1:
+      DwOffset = Offset - 0x1;
+      break;
+    case 2:
+      DwOffset = Offset - 0x2;
+      break;
+    case 3:
+      DwOffset = Offset - 0x3;
+      break;
+  }
+  Data32 = MmioRead32 (CPU_REGBAR_ADDRESS (CpuSbDevicePid, DwOffset));
+  switch (Offset & 0x0003) {
+    case 0:
+      Data8 = (UINT8) Data32;
+      break;
+    case 1:
+      Data8 = (UINT8) (Data32 >> 8);
+      break;
+    case 2:
+      Data8 = (UINT8) (Data32 >> 16);
+      break;
+    case 3:
+      Data8 = (UINT8) (Data32 >> 24);
+      break;
+  }
+  return Data8;
+}
+
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 8bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT64           Value written to register
+**/
+UINT64
+CpuRegbarWrite64 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT64                            Data
+  )
+{
+  UINT8       Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID) {
+    MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset) + 4, (UINT32) RShiftU64 (Data, 32));
+    MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset), (UINT32) Data);
+    return Data;
+  }
+  else
+    return INVALID_DATA_64;
+}
+
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+**/
+UINT32
+CpuRegbarWrite32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            Data
+  )
+{
+  UINT8    Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID)
+    return MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
+  else
+    return INVALID_DATA_32;
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+**/
+UINT16
+CpuRegbarWrite16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            Data
+  )
+{
+  UINT8    Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID)
+    return MmioWrite16 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
+  else
+    return INVALID_DATA_16;
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  Data             Input Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+**/
+UINT8
+CpuRegbarWrite8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             Data
+  )
+{
+  UINT8    Pid;
+
+  Pid = CpuSbDevicePid;
+  if (Pid != INVALID_PID)
+    return MmioWrite8 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
+  else
+    return INVALID_DATA_8;
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarOr32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            OrData
+  )
+{
+  return CpuRegbarWrite32 (CpuSbDevicePid, Offset, CpuRegbarRead32(CpuSbDevicePid, Offset) | OrData);
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarOr16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            OrData
+  )
+{
+  return CpuRegbarWrite16 (CpuSbDevicePid, Offset, CpuRegbarRead16(CpuSbDevicePid, Offset) | OrData);
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+
+**/
+UINT8
+CpuRegbarOr8(
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             OrData
+  )
+{
+  return CpuRegbarWrite8 (CpuSbDevicePid, Offset, CpuRegbarRead8(CpuSbDevicePid, Offset) | OrData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit data.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevice      CPU SB Device
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarAnd32 (
+  IN  CPU_SB_DEVICE_PID                     CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            AndData
+  )
+{
+  return CpuRegbarWrite32 (CpuSbDevicePid, Offset, CpuRegbarRead32 (CpuSbDevicePid, Offset) & AndData);
+}
+
+/**
+  Performs a bitwise AND of a 16-bit data.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevice      CPU SB Device
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarAnd16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            AndData
+  )
+{
+  return CpuRegbarWrite16 (CpuSbDevicePid, Offset, CpuRegbarRead16 (CpuSbDevicePid, Offset) & AndData);
+}
+
+/**
+Performs a bitwise AND of a 8-bit data.
+It programs REGBAR register and size in 1byte.
+The Offset should not exceed 0xFFFF and must be aligned with size.
+
+@param[in]  CpuSbDevice      CPU SB Device
+@param[in]  Offset           Register offset of Port ID.
+@param[in]  AndData          And Data. Must be the same size as Size parameter.
+
+@retval     UINT8           Value written to register
+
+**/
+UINT8
+CpuRegbarAnd8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             AndData
+  )
+{
+  return CpuRegbarWrite8 (CpuSbDevicePid, Offset, CpuRegbarRead8 (CpuSbDevicePid, Offset) & AndData);
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT32           Value written to register
+
+**/
+UINT32
+CpuRegbarAndThenOr32 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  )
+{
+  return CpuRegbarWrite32 (CpuSbDevicePid, Offset, (CpuRegbarRead32 (CpuSbDevicePid, Offset) & AndData) | OrData);
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT16           Value written to register
+
+**/
+UINT16
+CpuRegbarAndThenOr16 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT16                            AndData,
+  IN  UINT16                            OrData
+  )
+{
+  return CpuRegbarWrite16 (CpuSbDevicePid, Offset, (CpuRegbarRead16 (CpuSbDevicePid, Offset) & AndData) | OrData);
+}
+
+/**
+  Write REGBAR register.
+  It programs REGBAR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
+  @param[in]  Offset           Register offset of Port ID.
+  @param[in]  AndData          AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData           OR Data. Must be the same size as Size parameter.
+
+  @retval     UINT8            Value written to register
+
+**/
+UINT8
+CpuRegbarAndThenOr8 (
+  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
+  IN  UINT16                            Offset,
+  IN  UINT8                             AndData,
+  IN  UINT8                             OrData
+  )
+{
+  return CpuRegbarWrite8 (CpuSbDevicePid, Offset, (CpuRegbarRead8 (CpuSbDevicePid, Offset) & AndData) | OrData);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
new file mode 100644
index 0000000000..596543f34f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
@@ -0,0 +1,35 @@
+## @file
+# CPU REGBAR ACCESS Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmCpuRegbarAccessLib
+FILE_GUID = CA92B911-528D-4FBB-9A5A-7BC22AA1A6D0
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = CpuRegbarAccessLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdRegBarBaseAddress
+
+[Sources]
+CpuRegbarAccessLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PchPcrLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PchPcrLib.c
new file mode 100644
index 0000000000..c4f3740c86
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PchPcrLib.c
@@ -0,0 +1,313 @@
+/** @file
+  PCH PCR library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Register/PchPcrRegs.h>
+
+#ifndef MDEPKG_NDEBUG
+/**
+  Checks if the offset is valid for a given memory access width. Offset must align to width size.
+
+  @param[in]  Offset  Offset of a register
+  @param[in]  Size    Size of memory access in bytes
+
+  @retval FALSE  Offset is not valid for a given memory access
+  @retval TRUE   Offset is valid
+**/
+STATIC
+BOOLEAN
+PchIsPcrOffsetValid (
+  IN UINT32  Offset,
+  IN UINTN   Size
+  )
+{
+  if (!IsP2sb20bPcrSupported ()) {
+    if (((Offset & (Size - 1)) != 0) || (Offset > 0xFFFF)) {
+      DEBUG ((DEBUG_ERROR, "PCR offset error. Invalid Offset: %x Size: %x", Offset, Size));
+      return FALSE;
+    } else {
+      return TRUE;
+    }
+  } else {
+    if (((Offset & (Size - 1)) != 0) || (Offset > 0xFFFFF)) {
+      DEBUG ((DEBUG_ERROR, "PCR offset error. Invalid Offset: %x Size: %x", Offset, Size));
+      return FALSE;
+    } else {
+      return TRUE;
+    }
+  }
+}
+#endif
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT32       PCR register value.
+**/
+UINT32
+PchPcrRead32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  )
+{
+#ifndef MDEPKG_NDEBUG
+  ASSERT (PchIsPcrOffsetValid (Offset, 4));
+#endif
+  return MmioRead32 (PCH_PCR_ADDRESS (Pid, Offset));
+}
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT16       PCR register value.
+**/
+UINT16
+PchPcrRead16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  )
+{
+#ifndef MDEPKG_NDEBUG
+  ASSERT (PchIsPcrOffsetValid (Offset, 2));
+#endif
+  return MmioRead16 (PCH_PCR_ADDRESS (Pid, Offset));
+}
+
+/**
+  Read PCR register.
+  It returns PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of this Port ID
+
+  @retval UINT8        PCR register value
+**/
+UINT8
+PchPcrRead8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset
+  )
+{
+  return MmioRead8 (PCH_PCR_ADDRESS (Pid, Offset));
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval UINT32       Value written to register
+**/
+UINT32
+PchPcrWrite32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            Data
+  )
+{
+#ifndef MDEPKG_NDEBUG
+  ASSERT (PchIsPcrOffsetValid (Offset, 4));
+#endif
+  MmioWrite32 (PCH_PCR_ADDRESS (Pid, Offset), Data);
+
+  return Data;
+
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval  UINT16      Value written to register
+**/
+UINT16
+PchPcrWrite16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT16                            Data
+  )
+{
+#ifndef MDEPKG_NDEBUG
+  ASSERT (PchIsPcrOffsetValid (Offset, 2));
+#endif
+  MmioWrite16 (PCH_PCR_ADDRESS (Pid, Offset), Data);
+
+  return Data;
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  Data     Input Data. Must be the same size as Size parameter.
+
+  @retval  UINT8       Value written to register
+**/
+UINT8
+PchPcrWrite8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT8                             Data
+  )
+{
+
+  MmioWrite8 (PCH_PCR_ADDRESS (Pid, Offset), Data);
+
+  return Data;
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT32      Value written to register
+
+**/
+UINT32
+PchPcrAndThenOr32 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  )
+{
+  return PchPcrWrite32 (Pid, Offset, (PchPcrRead32 (Pid, Offset) & AndData) | OrData);
+}
+
+/**
+  Write PCR register and read back.
+  The read back ensures the PCR cycle is completed before next operation.
+  It programs PCR register and size in 4bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT32      Value read back from the register
+**/
+UINT32
+PchPcrAndThenOr32WithReadback (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT32                            AndData,
+  IN  UINT32                            OrData
+  )
+{
+  PchPcrWrite32 (Pid, Offset, (PchPcrRead32 (Pid, Offset) & AndData) | OrData);
+  return PchPcrRead32 (Pid, Offset);
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 2bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval UINT16       Value written to register
+
+**/
+UINT16
+PchPcrAndThenOr16 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT16                            AndData,
+  IN  UINT16                            OrData
+  )
+{
+  return PchPcrWrite16 (Pid, Offset, (PchPcrRead16 (Pid, Offset) & AndData) | OrData);
+}
+
+/**
+  Write PCR register.
+  It programs PCR register and size in 1bytes.
+  The Offset should not exceed 0xFFFF and must be aligned with size.
+
+  @param[in]  Pid      Port ID
+  @param[in]  Offset   Register offset of Port ID.
+  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
+  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
+
+  @retval  UINT8       Value written to register
+
+**/
+UINT8
+PchPcrAndThenOr8 (
+  IN  PCH_SBI_PID                       Pid,
+  IN  UINT32                            Offset,
+  IN  UINT8                             AndData,
+  IN  UINT8                             OrData
+  )
+{
+  return PchPcrWrite8 (Pid, Offset, (PchPcrRead8 (Pid, Offset) & AndData) | OrData);
+}
+
+/**
+  Get PCH IP PID number
+
+  @param[in]  IpEnum   PCH IP in PCH_IP_PID_ENUM
+
+  @retval     0        PID of this IP is not supported
+              !0       PID of the IP.
+**/
+PCH_SBI_PID
+PchPcrGetPid (
+  PCH_IP_PID_ENUM  IpEnum
+  )
+{
+  switch (IpEnum) {
+    case PchIpDmi:
+      return PID_DMI;
+    case PchIpIclk:
+      return PID_ICLK;
+    default:
+      ASSERT (FALSE);
+      return PCH_INVALID_PID;
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PeiDxeSmmPchPcrLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PeiDxeSmmPchPcrLib.inf
new file mode 100644
index 0000000000..2efeba374f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PeiDxeSmmPchPcrLib.inf
@@ -0,0 +1,35 @@
+## @file
+# PCH PCR Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchPcrLib
+FILE_GUID = 117C8D19-445B-46BF-B624-109F63709375
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchPcrLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PchInfoLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PchPcrLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PchSbiAccessLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PchSbiAccessLib.c
new file mode 100644
index 0000000000..8017dee3aa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PchSbiAccessLib.c
@@ -0,0 +1,253 @@
+/** @file
+  PCH SBI access library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <IndustryStandard/Pci30.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchSbiAccessLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Register/PchRegs.h>
+#include <Register/P2sbRegs.h>
+
+/**
+  Execute PCH SBI message
+  Take care of that there is no lock protection when using SBI programming in both POST time and SMI.
+  It will clash with POST time SBI programming when SMI happen.
+  Programmer MUST do the save and restore opration while using the PchSbiExecution inside SMI
+  to prevent from racing condition.
+  This function will reveal P2SB and hide P2SB if it's originally hidden. If more than one SBI access
+  needed, it's better to unhide the P2SB before calling and hide it back after done.
+
+  When the return value is "EFI_SUCCESS", the "Response" do not need to be checked as it would have been
+  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would provide additional information
+  when needed.
+
+  @param[in] Pid                        Port ID of the SBI message
+  @param[in] Offset                     Offset of the SBI message
+  @param[in] Opcode                     Opcode
+  @param[in] Posted                     Posted message
+  @param[in, out] Data32                Read/Write data
+  @param[out] Response                  Response
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_DEVICE_ERROR              Transaction fail
+  @retval EFI_INVALID_PARAMETER         Invalid parameter
+  @retval EFI_TIMEOUT                   Timeout while waiting for response
+**/
+EFI_STATUS
+PchSbiExecution (
+  IN     PCH_SBI_PID                    Pid,
+  IN     UINT64                         Offset,
+  IN     PCH_SBI_OPCODE                 Opcode,
+  IN     BOOLEAN                        Posted,
+  IN OUT UINT32                         *Data32,
+  OUT    UINT8                          *Response
+  )
+{
+  return PchSbiExecutionEx ( Pid,
+           Offset,
+           Opcode,
+           Posted,
+           0x000F,
+           0x0000,
+           0x0000,
+           Data32,
+           Response
+           );
+}
+
+/**
+  Full function for executing PCH SBI message
+  Take care of that there is no lock protection when using SBI programming in both POST time and SMI.
+  It will clash with POST time SBI programming when SMI happen.
+  Programmer MUST do the save and restore opration while using the PchSbiExecution inside SMI
+  to prevent from racing condition.
+  This function will reveal P2SB and hide P2SB if it's originally hidden. If more than one SBI access
+  needed, it's better to unhide the P2SB before calling and hide it back after done.
+
+  When the return value is "EFI_SUCCESS", the "Response" do not need to be checked as it would have been
+  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would provide additional information
+  when needed.
+
+  @param[in] Pid                        Port ID of the SBI message
+  @param[in] Offset                     Offset of the SBI message
+  @param[in] Opcode                     Opcode
+  @param[in] Posted                     Posted message
+  @param[in] Fbe                        First byte enable
+  @param[in] Bar                        Bar
+  @param[in] Fid                        Function ID
+  @param[in, out] Data32                Read/Write data
+  @param[out] Response                  Response
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_DEVICE_ERROR              Transaction fail
+  @retval EFI_INVALID_PARAMETER         Invalid parameter
+  @retval EFI_TIMEOUT                   Timeout while waiting for response
+**/
+EFI_STATUS
+PchSbiExecutionEx (
+  IN     PCH_SBI_PID                    Pid,
+  IN     UINT64                         Offset,
+  IN     PCH_SBI_OPCODE                 Opcode,
+  IN     BOOLEAN                        Posted,
+  IN     UINT16                         Fbe,
+  IN     UINT16                         Bar,
+  IN     UINT16                         Fid,
+  IN OUT UINT32                         *Data32,
+  OUT    UINT8                          *Response
+  )
+{
+  UINT64                                P2sbBase;
+  UINTN                                 Timeout;
+  UINT16                                SbiStat;
+
+  //
+  // Check opcode valid
+  //
+  switch (Opcode) {
+    case MemoryRead:
+    case MemoryWrite:
+    case PciConfigRead:
+    case PciConfigWrite:
+    case PrivateControlRead:
+    case PrivateControlWrite:
+    case GpioLockUnlock:
+      break;
+    default:
+      return EFI_INVALID_PARAMETER;
+      break;
+  }
+
+  P2sbBase = P2sbPciCfgBase ();
+  if (PciSegmentRead16 (P2sbBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    ASSERT (FALSE);
+    return EFI_DEVICE_ERROR;
+  }
+  ///
+  /// BWG Section 2.2.1
+  /// 1. Poll P2SB PCI offset D8h[0] = 0b
+  /// Make sure the previous opeartion is completed.
+  ///
+  Timeout = 0xFFFFFFF;
+  while (Timeout > 0) {
+    SbiStat = PciSegmentRead16 (P2sbBase + R_P2SB_CFG_SBISTAT);
+    if ((SbiStat & B_P2SB_CFG_SBISTAT_INITRDY) == 0) {
+      break;
+    }
+    Timeout--;
+  }
+  if (Timeout == 0) {
+    return EFI_TIMEOUT;
+  }
+  //
+  // Initial Response status
+  //
+  *Response = SBI_INVALID_RESPONSE;
+  SbiStat   = 0;
+  ///
+  /// 2. Write P2SB PCI offset D0h[31:0] with Address and Destination Port ID
+  ///
+  PciSegmentWrite32 (P2sbBase + R_P2SB_CFG_SBIADDR, (UINT32) ((Pid << 24) | (UINT16) Offset));
+  ///
+  /// 3. Write P2SB PCI offset DCh[31:0] with extended address, which is expected to be 0 in CNL PCH.
+  ///
+  PciSegmentWrite32 (P2sbBase + R_P2SB_CFG_SBIEXTADDR, (UINT32) RShiftU64 (Offset, 16));
+  ///
+  /// 5. Set P2SB PCI offset D8h[15:8] = 00000110b for read
+  ///    Set P2SB PCI offset D8h[15:8] = 00000111b for write
+  //
+  // Set SBISTAT[15:8] to the opcode passed in
+  // Set SBISTAT[7] to the posted passed in
+  //
+  PciSegmentAndThenOr16 (
+    (P2sbBase + R_P2SB_CFG_SBISTAT),
+    (UINT16) ~(B_P2SB_CFG_SBISTAT_OPCODE | B_P2SB_CFG_SBISTAT_POSTED),
+    (UINT16) ((Opcode << 8) | (Posted << 7))
+    );
+  ///
+  /// 6. Write P2SB PCI offset DAh[15:0] = F000h
+  ///
+  //
+  // Set RID[15:0] = Fbe << 12 | Bar << 8 | Fid
+  //
+  PciSegmentWrite16 (
+    (P2sbBase + R_P2SB_CFG_SBIRID),
+    (((Fbe & 0x000F) << 12) | ((Bar & 0x0007) << 8) | (Fid & 0x00FF))
+    );
+
+  switch (Opcode) {
+    case MemoryWrite:
+    case PciConfigWrite:
+    case PrivateControlWrite:
+    case GpioLockUnlock:
+      ///
+      /// 4. Write P2SB PCI offset D4h[31:0] with the intended data accordingly
+      ///
+      PciSegmentWrite32 ((P2sbBase + R_P2SB_CFG_SBIDATA), *Data32);
+      break;
+    default:
+      ///
+      /// 4. Write P2SB PCI offset D4h[31:0] with dummy data such as 0,
+      /// because all D0-DFh register range must be touched in CNL PCH
+      /// for a successful SBI transaction.
+      ///
+      PciSegmentWrite32 ((P2sbBase + R_P2SB_CFG_SBIDATA), 0);
+      break;
+  }
+  ///
+  /// 7. Set P2SB PCI offset D8h[0] = 1b, Poll P2SB PCI offset D8h[0] = 0b
+  ///
+  //
+  // Set SBISTAT[0] = 1b, trigger the SBI operation
+  //
+  PciSegmentOr16 (P2sbBase + R_P2SB_CFG_SBISTAT, (UINT16) B_P2SB_CFG_SBISTAT_INITRDY);
+  //
+  // Poll SBISTAT[0] = 0b, Polling for Busy bit
+  //
+  Timeout = 0xFFFFFFF;
+  while (Timeout > 0) {
+    SbiStat = PciSegmentRead16 (P2sbBase + R_P2SB_CFG_SBISTAT);
+    if ((SbiStat & B_P2SB_CFG_SBISTAT_INITRDY) == 0) {
+      break;
+    }
+    Timeout--;
+  }
+  if (Timeout == 0) {
+    //
+    // If timeout, it's fatal error.
+    //
+    return EFI_TIMEOUT;
+  } else {
+    ///
+    /// 8. Check if P2SB PCI offset D8h[2:1] = 00b for successful transaction
+    ///
+    *Response = (UINT8) ((SbiStat & B_P2SB_CFG_SBISTAT_RESPONSE) >> N_P2SB_CFG_SBISTAT_RESPONSE);
+    if (*Response == SBI_SUCCESSFUL) {
+      switch (Opcode) {
+        case MemoryRead:
+        case PciConfigRead:
+        case PrivateControlRead:
+          ///
+          /// 9. Read P2SB PCI offset D4h[31:0] for SBI data
+          ///
+          *Data32 = PciSegmentRead32 (P2sbBase + R_P2SB_CFG_SBIDATA);
+          break;
+        default:
+          break;
+      }
+      return EFI_SUCCESS;
+    } else if (*Response == SBI_POWERDOWN) {
+      return EFI_NO_RESPONSE;
+    } else {
+      return EFI_DEVICE_ERROR;
+    }
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
new file mode 100644
index 0000000000..4199a0a6c7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
@@ -0,0 +1,36 @@
+## @file
+# PCH SBI access library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchSbiAccessLib
+FILE_GUID = 96ECB0FB-A975-4DC8-B88A-D90C3378CE87
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchSbiAccessLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchPciBdfLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PchSbiAccessLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (19 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:54   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component Heng Luo
                   ` (18 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/PchDmi/IncludePrivate
  * IpBlock/PchDmi/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/PchDmiLib.h                             | 175 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.c                   |  50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.h                   |  34 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiLib.c                  | 269 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiWithS3Lib.c            |  73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf       |  42 ++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf |  41 +++++++++++++++++++++++++++++++++++++++++
 7 files changed, 684 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/PchDmiLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/PchDmiLib.h
new file mode 100644
index 0000000000..77db69c75a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/PchDmiLib.h
@@ -0,0 +1,175 @@
+/** @file
+  Header file for PchDmiLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_DMI_LIB_H_
+#define _PCH_DMI_LIB_H_
+
+/**
+  This function checks if DMI Secured Register Lock (SRL) is set
+
+  @retval SRL state
+**/
+BOOLEAN
+IsPchDmiLocked (
+  VOID
+  );
+
+/**
+  Get PCH TCO base address.
+
+  @retval Address                   Address of TCO base address.
+**/
+UINT16
+PchDmiGetTcoBase (
+  VOID
+  );
+
+/**
+  Set PCH LPC/eSPI generic IO range decoding in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+  @param[in] RangeIndex                 Index of choosen range
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcGenIoRange (
+  IN  UINT32                            Address,
+  IN  UINT32                            Length,
+  IN  UINT32                            RangeIndex
+  );
+
+/**
+  Set PCH eSPI eSPI CS1# generic IO range decoding in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetEspiCs1GenIoRange (
+  IN  UINT32                            Address,
+  IN  UINT32                            Length
+  );
+
+/**
+  Set PCH LPC/eSPI memory range decoding in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcMemRange (
+  IN  UINT32                            Address
+  );
+
+/**
+  Set PCH eSPI CS1# memory range decoding in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetEspiCs1MemRange (
+  IN  UINT32                            Address
+  );
+
+/**
+  Check if Boot BIOS Strap is set for SPI.
+
+  @retval TRUE                Boot BIOS Strap set for SPI
+  @retval FALSE               Boot BIOS Strap set for LPC/eSPI
+**/
+BOOLEAN
+PchDmiIsBootBiosStrapSetForSpi (
+  VOID
+  );
+
+/**
+  Set PCH BIOS range decoding in DMI
+  Please check EDS for detail of BiosDecodeEnable bit definition.
+    bit 15: F8-FF Enable
+    bit 14: F0-F8 Enable
+    bit 13: E8-EF Enable
+    bit 12: E0-E8 Enable
+    bit 11: D8-DF Enable
+    bit 10: D0-D7 Enable
+    bit  9: C8-CF Enable
+    bit  8: C0-C7 Enable
+    bit  7: Legacy F Segment Enable
+    bit  6: Legacy E Segment Enable
+    bit  5: Reserved
+    bit  4: Reserved
+    bit  3: 70-7F Enable
+    bit  2: 60-6F Enable
+    bit  1: 50-5F Enable
+    bit  0: 40-4F Enable
+
+  @param[in] BiosDecodeEnable           Bios decode enable setting.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetBiosDecodeEnable (
+  IN  UINT16                            BiosDecodeEnable
+  );
+
+/**
+  Set PCH LPC/eSPI IO decode ranges in DMI
+  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
+  Bit  12: FDD range
+  Bit 9:8: LPT range
+  Bit 6:4: ComB range
+  Bit 2:0: ComA range
+
+  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcIoDecodeRanges (
+  IN  UINT16                            LpcIoDecodeRanges
+  );
+
+/**
+  Set PCH LPC/eSPI IO enable decoding in DMI
+
+  @param[in] LpcIoEnableDecoding        LPC/eSPI IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcIoEnable (
+  IN  UINT16                            LpcIoEnableDecoding
+  );
+
+/**
+  Configure PCH DMI Lock
+**/
+VOID
+PchDmiSetLockWithS3BootScript (
+  VOID
+  );
+
+/**
+  Set BIOS interface Lock-Down
+**/
+VOID
+PchDmiSetBiosLockDownWithS3BootScript (
+  VOID
+  );
+#endif // _PCH_DMI_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.c
new file mode 100644
index 0000000000..60bc29c431
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.c
@@ -0,0 +1,50 @@
+/** @file
+  This file contains functions for PCH DMI SIP14
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchDmiLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Register/PchDmiRegs.h>
+#include <Register/PchDmi14Regs.h>
+#include <Register/PchPcrRegs.h>
+
+/**
+  This function checks if DMI SIP14 Secured Register Lock (SRL) is set
+
+  @retval SRL state
+**/
+BOOLEAN
+IsPchDmi14Locked (
+  VOID
+  )
+{
+  return ((PchPcrRead32 (PID_DMI, R_PCH_DMI14_PCR_DMIC) & B_PCH_DMI14_PCR_DMIC_SRL) != 0);
+}
+
+/**
+ Secure Register Lock data
+
+ @param[out] SrlRegOffset        Register offset holding Secure Register Lock setting
+ @param[out] SrlRegMask          Mask for Secure Register Lock setting
+**/
+VOID
+PchDmi14SrlRegData (
+  OUT UINT16  *SrlRegOffset,
+  OUT UINT32  *SrlRegMask
+  )
+{
+  *SrlRegMask = B_PCH_DMI14_PCR_DMIC_SRL;
+  *SrlRegOffset = R_PCH_DMI14_PCR_DMIC;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.h
new file mode 100644
index 0000000000..4c19ad82d7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmi14.h
@@ -0,0 +1,34 @@
+/** @file
+  Internal header file for PCH DMI library for SIP14
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef __PCH_DMI_14_H__
+#define __PCH_DMI_14_H__
+
+#include <Library/PchDmiLib.h>
+
+/**
+  This function checks if DMI SIP14 Secured Register Lock (SRL) is set
+
+  @retval SRL state
+**/
+BOOLEAN
+IsPchDmi14Locked (
+  VOID
+  );
+
+/**
+ Secure Register Lock data
+
+ @param[out] SrlRegOffset        Register offset holding Secure Register Lock setting
+ @param[out] SrlRegMask          Mask for Secure Register Lock setting
+**/
+VOID
+PchDmi14SrlRegData (
+  OUT UINT16  *SrlRegOffset,
+  OUT UINT32  *SrlRegMask
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiLib.c
new file mode 100644
index 0000000000..972e5145aa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiLib.c
@@ -0,0 +1,269 @@
+/** @file
+  PCH DMI library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchDmiLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchDmiRegs.h>
+#include <Register/PchRegsLpc.h>
+
+#include "PchDmi14.h"
+
+/**
+  This function checks if DMI Secured Register Lock (SRL) is set
+
+  @retval SRL state
+**/
+BOOLEAN
+IsPchDmiLocked (
+  VOID
+  )
+{
+  return IsPchDmi14Locked ();
+}
+
+/**
+  Get PCH TCO base address.
+
+  @retval Address                   Address of TCO base address.
+**/
+UINT16
+PchDmiGetTcoBase (
+  VOID
+  )
+{
+  //
+  // Read "TCO Base Address" PCR[DMI] + 2778h[15:5]
+  //
+  return (PchPcrRead16 (PID_DMI, R_PCH_DMI_PCR_TCOBASE) & B_PCH_DMI_PCR_TCOBASE_TCOBA);
+}
+
+/**
+  Set PCH LPC/eSPI generic IO range decoding in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+  @param[in] RangeIndex                 Index of choosen range
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcGenIoRange (
+  IN  UINT32                            Address,
+  IN  UINT32                            Length,
+  IN  UINT32                            RangeIndex
+  )
+{
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Set PCH eSPI eSPI CS1# generic IO range decoding in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetEspiCs1GenIoRange (
+  IN  UINT32                            Address,
+  IN  UINT32                            Length
+  )
+{
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Set PCH LPC/eSPI memory range decoding in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcMemRange (
+  IN  UINT32                            Address
+  )
+{
+  if (IsPchDmiLocked ()) {
+    DEBUG ((DEBUG_ERROR, "%a Error. DMI is locked.\n", __FUNCTION__));
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Program LPC Memory Range, PCR[DMI] + 2740h to the same value programmed in LPC/eSPI PCI Offset 98h.
+  //
+  PchPcrWrite32 (
+    PID_DMI, R_PCH_DMI_PCR_LPCGMR,
+    (Address | B_LPC_CFG_LGMR_LMRD_EN)
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Set PCH eSPI CS1# memory range decoding in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetEspiCs1MemRange (
+  IN  UINT32                            Address
+  )
+{
+  if (IsPchDmiLocked ()) {
+    DEBUG ((DEBUG_ERROR, "%a Error. DMI is locked.\n", __FUNCTION__));
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Program LPC Memory Range, PCR[DMI] + 27C0h to the same value programmed in eSPI PCI Offset A8h.
+  //
+  PchPcrWrite32 (
+    PID_DMI, R_PCH_DMI_PCR_SEGMR,
+    (Address | B_LPC_CFG_LGMR_LMRD_EN)
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Check if Boot BIOS Strap is set for SPI.
+
+  @retval TRUE                Boot BIOS Strap set for SPI
+  @retval FALSE               Boot BIOS Strap set for LPC/eSPI
+**/
+BOOLEAN
+PchDmiIsBootBiosStrapSetForSpi (
+  VOID
+  )
+{
+  //
+  // Check General Control and Status (GCS) [10]
+  // '0': SPI
+  // '1': LPC/eSPI
+  //
+  return ((PchPcrRead32 (PID_DMI, R_PCH_DMI_PCR_GCS) & B_PCH_DMI_PCR_BBS) != B_PCH_DMI_PCR_BBS);
+}
+
+/**
+  Set PCH BIOS range decoding in DMI
+  Please check EDS for detail of BiosDecodeEnable bit definition.
+    bit 15: F8-FF Enable
+    bit 14: F0-F8 Enable
+    bit 13: E8-EF Enable
+    bit 12: E0-E8 Enable
+    bit 11: D8-DF Enable
+    bit 10: D0-D7 Enable
+    bit  9: C8-CF Enable
+    bit  8: C0-C7 Enable
+    bit  7: Legacy F Segment Enable
+    bit  6: Legacy E Segment Enable
+    bit  5: Reserved
+    bit  4: Reserved
+    bit  3: 70-7F Enable
+    bit  2: 60-6F Enable
+    bit  1: 50-5F Enable
+    bit  0: 40-4F Enable
+
+  @param[in] BiosDecodeEnable           Bios decode enable setting.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetBiosDecodeEnable (
+  IN  UINT16                            BiosDecodeEnable
+  )
+{
+  if (IsPchDmiLocked ()) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // program LPC BIOS Decode Enable, PCR[DMI] + 2744h to the same value programmed in LPC or SPI Offset D8h.
+  //
+  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCBDE, BiosDecodeEnable);
+  return EFI_SUCCESS;
+}
+
+/**
+  Set PCH LPC/eSPI IO decode ranges in DMI
+  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
+  Bit  12: FDD range
+  Bit 9:8: LPT range
+  Bit 6:4: ComB range
+  Bit 2:0: ComA range
+
+  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcIoDecodeRanges (
+  IN  UINT16                            LpcIoDecodeRanges
+  )
+{
+  //
+  // This cycle decoding is only allowed to set when DMI is not locked.
+  //
+  if (IsPchDmiLocked ()) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // program LPC I/O Decode Ranges, PCR[DMI] + 2770h[15:0] to the same value programmed in LPC/eSPI PCI offset 80h.
+  //
+  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCIOD, LpcIoDecodeRanges);
+  return EFI_SUCCESS;
+}
+
+/**
+  Set PCH LPC/eSPI IO enable decoding in DMI
+
+  @param[in] LpcIoEnableDecoding        LPC/eSPI IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchDmiSetLpcIoEnable (
+  IN  UINT16                            LpcIoEnableDecoding
+  )
+{
+  //
+  // This cycle decoding is only allowed to set when DMI is not locked.
+  //
+  if (IsPchDmiLocked ()) {
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // program LPC I/O Decode Ranges, PCR[DMI] + 2774h[15:0] to the same value programmed in LPC/eSPI PCI offset 82h.
+  //
+  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCIOE, LpcIoEnableDecoding);
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiWithS3Lib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiWithS3Lib.c
new file mode 100644
index 0000000000..7d6801ee57
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PchDmiWithS3Lib.c
@@ -0,0 +1,73 @@
+/** @file
+  PCH DMI library with S3 boot script support.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchDmiRegs.h>
+
+#include "PchDmi14.h"
+
+/**
+  Configure DMI Lock
+**/
+VOID
+PchDmiSetLockWithS3BootScript (
+  VOID
+  )
+{
+  UINT32  Data32Or;
+  UINT32  Data32And;
+  UINT16  Address;
+
+  Data32And = 0xFFFFFFFF;
+
+  PchDmi14SrlRegData (&Address, &Data32Or);
+
+  PchPcrAndThenOr32 (
+    PID_DMI, Address,
+    Data32And,
+    Data32Or
+    );
+  PCH_PCR_BOOT_SCRIPT_READ_WRITE (
+    S3BootScriptWidthUint32,
+    PID_DMI, Address,
+    &Data32Or,
+    &Data32And
+    );
+}
+
+/**
+  Set BIOS interface Lock-Down
+**/
+VOID
+PchDmiSetBiosLockDownWithS3BootScript (
+  VOID
+  )
+{
+  UINT32  Data32Or;
+  UINT32  Data32And;
+
+  //
+  // Set BIOS Lock-Down (BILD)
+  // When set, prevents GCS.BBS from being changed
+  //
+  Data32And = 0xFFFFFFFF;
+  Data32Or = B_PCH_DMI_PCR_BILD;
+  PchPcrAndThenOr32 (PID_DMI, R_PCH_DMI_PCR_GCS, Data32And, Data32Or);
+  PCH_PCR_BOOT_SCRIPT_READ_WRITE (
+    S3BootScriptWidthUint32,
+    PID_DMI, R_PCH_DMI_PCR_GCS,
+    &Data32Or,
+    &Data32And
+    );
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf
new file mode 100644
index 0000000000..d33310dd76
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf
@@ -0,0 +1,42 @@
+## @file
+#  Component description file for the PeiDxeSmmPchDmiLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION                    = 0x00010017
+BASE_NAME                      = PeiDxeSmmPchDmiLib
+FILE_GUID                      = 067DC1C4-2668-4F06-9921-307514B66B34
+VERSION_STRING                 = 1.0
+MODULE_TYPE                    = BASE
+LIBRARY_CLASS                  = PchDmiLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  DebugLib
+  PchInfoLib
+  PchPcrLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  PchDmiLib.c
+  PchDmi14.c
+  PchDmi14.h
+
+[Guids]
+  gPchDmiConfigGuid         ## CONSUMES
+
+[Pcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
new file mode 100644
index 0000000000..9381a7b5fd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
@@ -0,0 +1,41 @@
+## @file
+#  Component description file for the PeiDxeSmmPchDmiWithS3Lib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION                    = 0x00010017
+BASE_NAME                      = PeiDxeSmmPchDmiWithS3Lib
+FILE_GUID                      = 32CCA047-6AF0-46FF-83DA-32BA62484075
+VERSION_STRING                 = 1.0
+MODULE_TYPE                    = BASE
+LIBRARY_CLASS                  = PchDmiWithS3Lib
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  DebugLib
+  PchPcrLib
+  PchInfoLib
+  S3BootScriptLib
+  PchDmiLib
+
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  PchDmiWithS3Lib.c
+  PchDmi14.h
+
+[pcd]
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (20 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:55   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component Heng Luo
                   ` (17 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/PcieRp/IncludePrivate
  * IpBlock/PcieRp/Library
  * IpBlock/PcieRp/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/DxePchPcieRpPolicyLib.h                            |   55 ++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PciExpressHelpersLib.h                             |  173 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PcieRpLib.h                                        |  109 ++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/PcieSipRegs.h                                     |   45 ++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.c                             |  315 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.inf                           |   37 +++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLib.c                              |   69 ++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibInternal.h                      |   20 +++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibVer2.c                          |  128 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf               |   39 +++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.c              |  179 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf            |   30 ++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.c        | 1997 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.h        |   40 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf |   49 ++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.c                          |  247 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf                        |   43 +++++++++++++++++++
 17 files changed, 3575 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/DxePchPcieRpPolicyLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/DxePchPcieRpPolicyLib.h
new file mode 100644
index 0000000000..1dea61388e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/DxePchPcieRpPolicyLib.h
@@ -0,0 +1,55 @@
+/** @file
+  DXE PcieRp policy library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_PCH_PCIERP_POLICY_LIB_H_
+#define _DXE_PCH_PCIERP_POLICY_LIB_H_
+
+#include <Protocol/PchPolicy.h>
+
+/**
+  Load DXE Config block default for Pch PCIE RP
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+LoadPchPcieRpDxeConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  );
+
+/**
+  Print PCIE_RP_DXE_CONFIG.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+PchPcieRpDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  );
+
+/**
+  Get PchPcieRp config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+PchPcieRpDxeGetConfigBlockTotalSize (
+  VOID
+  );
+
+/**
+  Add PchPcieRp ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+PchPcieRpDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PciExpressHelpersLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PciExpressHelpersLib.h
new file mode 100644
index 0000000000..d7ca34dc38
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PciExpressHelpersLib.h
@@ -0,0 +1,173 @@
+/** @file
+  Header file for PCI Express helpers library
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCI_EXPRESS_HELPERS_LIB_H_
+#define _PCI_EXPRESS_HELPERS_LIB_H_
+
+#include <PchPolicyCommon.h>
+#include <Library/PcieRpLib.h>
+
+typedef enum {
+  TpoScale2us,
+  TpoScale10us,
+  TpoScale100us,
+  TpoScaleMax
+} T_PO_SCALE;
+//
+// This structure keeps segment:bus:device:function coordinates of a PCIe device
+// in a single variable. PcieCap is offset to PCI Express capabilities.
+//
+typedef struct {
+  UINT32 Seg : 8;
+  UINT32 Bus : 8;
+  UINT32 Dev : 5;
+  UINT32 Func : 3;
+  UINT32 PcieCap : 8;
+} SBDF;
+
+/*
+  Converts Tpower_on from value:scale notation to microseconds
+
+  @param[in] TpoScale   T power on scale
+  @param[in] TpoValue   T power on value
+
+  @retval    number of microseconds
+*/
+UINT32
+TpoToUs (
+  UINT32 TpoScale,
+  UINT32 TpoValue
+  );
+
+/**
+PCIe controller Sku.
+**/
+
+typedef enum {
+  EnumPchPcie = 0,
+  EnumiTbtPcie = 1,
+  EnumCpuPcie = 2,
+  EnumPciSkuMax = 3
+} PCI_SKU;
+
+/*
+  Initializes the following features in rootport and devices behind it:
+  Maximum Payload Size (generic)
+  Rootport packet split (proprietary)
+  EonOfInterrupt forwarding (proprietary)
+  Common Clock Configuration (generic)
+
+  Generic: any code written according to PCIE Express base specification can do that.
+  Proprietary: code uses registers and features that are specific to Intel silicon
+  and probably only this Reference Code knows how to handle that.
+
+  If OEM implemented generic feature enabling in his platform code or trusts Operating System
+  to do it, then those features can be deleted from here.
+
+  CCC requires link retrain, which takes a while. CCC must happen before L0s/L1 programming.
+  If there was guarantee no code would access PCI while links retrain, it would be possible to skip this waiting
+
+  @param[in] RpSegment  address of rootport on PCIe
+  @param[in] RpBus      address of rootport on PCIe
+  @param[in] RpDevice   address of rootport on PCIe
+  @param[in] RpFunction address of rootport on PCIe
+  @param[in] BusMin     minimum Bus number that can be assigned below this rootport
+  @param[in] BusMax     maximum Bus number that can be assigned below this rootport
+*/
+VOID
+RootportDownstreamConfiguration (
+  UINT8                     RpSegment,
+  UINT8                     RpBus,
+  UINT8                     RpDevice,
+  UINT8                     RpFunction,
+  UINT8                     BusMin,
+  UINT8                     BusMax,
+  PCI_SKU                   PciSku
+  );
+
+/*
+  Configures the following power-management related features in rootport and devices behind it:
+  LTR limit (generic)
+  LTR override (proprietary)
+  Clock Power Management (generic)
+  L1 substates (generic except for the override table)
+  L1.LOW substate (proprietary)
+  L0s and L1 (generic)
+
+  Generic: any code written according to PCIE Express base specification can do that.
+  Proprietary: code uses registers and features that are specific to Intel silicon
+  and probably only this Reference Code knows how to handle that.
+
+  If OEM implemented generic feature enabling in his platform code or trusts Operating System
+  to do it, then those features can be deleted from here.
+
+  @param[in] RpSegment                address of rootport on PCIe
+  @param[in] RpBus                    address of rootport on PCIe
+  @param[in] RpDevice                 address of rootport on PCIe
+  @param[in] RpFunction               address of rootport on PCIe
+  @param[in] BusMin                   minimal Bus number that can be assigned below this rootport
+  @param[in] BusMax                   maximum Bus number that can be assigned below this rootport
+  @param[in] PcieRpCommonConfig       a pointer to Pcie Root Port Common Config
+  @param[in] AspmOverrideTableSize    size of override array
+  @param[in] AspmOverrideTable        array of device that need exceptions in configuration
+*/
+VOID
+RootportDownstreamPmConfiguration (
+  UINT8                               RpSegment,
+  UINT8                               RpBus,
+  UINT8                               RpDevice,
+  UINT8                               RpFunction,
+  UINT8                               BusMin,
+  UINT8                               BusMax,
+  PCIE_ROOT_PORT_COMMON_CONFIG        *PcieRpCommonConfig,
+  UINT32                              AspmOverrideTableSize,
+  PCH_PCIE_DEVICE_OVERRIDE            *AspmOverrideTable
+  );
+
+typedef struct {
+  UINT32 MaxSnoopLatencyValue         : 10;
+  UINT32 MaxSnoopLatencyScale         : 3;
+  UINT32 MaxNoSnoopLatencyValue       : 10;
+  UINT32 MaxNoSnoopLatencyScale       : 3;
+  UINT32 Reserved                     : 6;
+} LTR_LIMIT;
+
+/**
+  Checks if given PCI device is capable of Latency Tolerance Reporting
+
+  @param[in] Sbdf            device's segment:bus:device:function coordinates
+
+  @retval TRUE if yes
+**/
+BOOLEAN
+IsLtrCapable (
+  SBDF Sbdf
+  );
+
+/**
+  Returns combination of two LTR override values
+  The resulting LTR override separately chooses stricter limits for snoop and nosnoop
+
+  @param[in] LtrA      LTR override values to be combined
+  @param[in] LtrB      LTR override values to be combined
+
+  @retval LTR override value
+**/
+LTR_OVERRIDE
+CombineLtr (
+  LTR_OVERRIDE LtrA,
+  LTR_OVERRIDE LtrB
+  );
+
+/**
+  Extended Virtual Channel Configuration
+**/
+typedef struct {
+  UINT16 CapOffset;
+  UINT8  ExtVcCount;
+} MULTI_VC_SUPPORT;
+
+#endif // _PCI_EXPRESS_HELPERS_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PcieRpLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PcieRpLib.h
new file mode 100644
index 0000000000..ed75e438c7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PcieRpLib.h
@@ -0,0 +1,109 @@
+/** @file
+  Header file for PCH PCI Express helpers library
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCIE_RP_LIB_
+#define _PCIE_RP_LIB_
+
+#include <PchPolicyCommon.h>
+
+typedef struct {
+  UINT32 MaxSnoopLatencyValue         : 10;
+  UINT32 MaxSnoopLatencyScale         : 3;
+  UINT32 MaxSnoopLatencyRequirement   : 1;
+  UINT32 MaxNoSnoopLatencyValue       : 10;
+  UINT32 MaxNoSnoopLatencyScale       : 3;
+  UINT32 MaxNoSnoopLatencyRequirement : 1;
+  UINT32 ForceOverride                : 1;
+} LTR_OVERRIDE;
+
+/**
+  Get PCIe port number for enabled Root Port.
+
+  @param[in] RpBase    Root Port pci segment base address
+
+  @retval Root Port number (1 based)
+**/
+UINT32
+PciePortNum (
+  IN     UINT64  RpBase
+  );
+
+/**
+  Get PCIe root port index
+  @param[in] RpBase    Root Port pci segment base address
+  @return Root Port index (0 based)
+**/
+UINT32
+PciePortIndex (
+  IN     UINT64  RpBase
+  );
+
+/**
+  This function checks whether PHY lane power gating is enabled on the port.
+
+  @param[in] RpBase                 Root Port base address
+
+  @retval TRUE                      PHY power gating is enabled
+  @retval FALSE                     PHY power gating disabled
+**/
+BOOLEAN
+PcieIsPhyLanePgEnabled (
+  IN     UINT64  RpBase
+  );
+
+/**
+  Configures Root Port packet split.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] Mps                            maximum packet size
+**/
+VOID
+ConfigureRpPacketSplit (
+  UINT64 RpBase,
+  UINT8  Mps
+  );
+
+/**
+  Configures LTR override in Root Port's proprietary registers.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] LtrConfig                      Root Port LTR configuration
+  @param[in] AspmOverride                   combination of LTR override values from all devices under this Root Port
+**/
+VOID
+ConfigureRpLtrOverride (
+  UINT64           RpBase,
+  UINT32           DevNum,
+  LTR_OVERRIDE     *TreeLtr,
+  PCIE_LTR_CONFIG  *LtrConfig
+  );
+
+/**
+  This function configures EOI message forwarding for PCIe port.
+  If there's an IoAPIC behind this port, forwarding will be enabled
+  Otherwise it will be disabled to minimize bus traffic
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] IoApicPresent  TRUE if there's IoAPIC behind this Root Port
+**/
+VOID
+ConfigureEoiForwarding (
+  UINT64   RpBase,
+  BOOLEAN  IoApicPresent
+  );
+
+/**
+  Configures proprietary parts of L1 substates configuration in Root Port
+
+  @param[in] RpSbdf       segment:bus:device:function coordinates of Root Port
+  @param[in] LtrCapable   TRUE if Root Port is LTR capable
+**/
+VOID
+L1ssProprietaryConfiguration (
+  UINT64  RpBase,
+  BOOLEAN LtrCapable
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/PcieSipRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/PcieSipRegs.h
new file mode 100644
index 0000000000..1fc470b8ba
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/PcieSipRegs.h
@@ -0,0 +1,45 @@
+/** @file
+  Register names for PCIe SIP specific registers
+
+  Conventions:
+
+  - Register definition format:
+  Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+  Definitions beginning with "R_" are registers
+  Definitions beginning with "B_" are bits within registers
+  Definitions beginning with "V_" are meaningful values within the bits
+  Definitions beginning with "S_" are register size
+  Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+  Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+  Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+  This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+  Register name without ComponentName applies to all components.
+  Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+  This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+  MEM - MMIO space register of subsystem.
+  IO  - IO space register of subsystem.
+  PCR - Private configuration register of subsystem.
+  CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+  Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCIE_SIP_RP_REGS_H_
+#define _PCIE_SIP_RP_REGS_H_
+
+#include <PcieRegs.h>
+
+#define R_PCIE_CFG_CCFG                               0xD0
+#define B_PCIE_CFG_CCFG_UNRS                          (BIT6 | BIT5 | BIT4)
+#define N_PCIE_CFG_CCFG_UNRS                          4
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.c
new file mode 100644
index 0000000000..1b3e629431
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.c
@@ -0,0 +1,315 @@
+/** @file
+  This file contains routines that support PCI Express initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/PcieHelperLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <PcieRegs.h>
+
+#define ASPM_L1_NO_LIMIT 0xFF
+#define LINK_RETRAIN_WAIT_TIME 1000 // microseconds
+
+/**
+  Finds the Offset to a given Capabilities ID
+  Each capability has an ID and a pointer to next Capability, so they form a linked list.
+  This function walks the list of Capabilities present in device's pci cfg. If requested capability
+  can be found, its offset is returned.
+  If the capability can't be found or if device doesn't exist, function returns 0
+  CAPID list:
+    0x01 = PCI Power Management Interface
+    0x04 = Slot Identification
+    0x05 = MSI Capability
+    0x10 = PCI Express Capability
+
+  @param[in] DeviceBase           device's base address
+  @param[in] CapId                CAPID to search for
+
+  @retval 0                       CAPID not found (this includes situation where device doesn't exit)
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PcieBaseFindCapId (
+  IN UINT64  DeviceBase,
+  IN UINT8   CapId
+  )
+{
+  UINT8  CapHeaderOffset;
+  UINT8  CapHeaderId;
+  UINT16 Data16;
+  //
+  // We do not explicitly check if device exists to save time and avoid unnecessary PCI access
+  // If the device doesn't exist, check for CapHeaderId != 0xFF will fail and function will return offset 0
+  //
+  if ((PciSegmentRead8 (DeviceBase + PCI_PRIMARY_STATUS_OFFSET) & EFI_PCI_STATUS_CAPABILITY) == 0x00) {
+    ///
+    /// Function has no capability pointer
+    ///
+    return 0;
+  } else {
+    ///
+    /// Check the header layout to determine the Offset of Capabilities Pointer Register
+    ///
+    if ((PciSegmentRead8 (DeviceBase + PCI_HEADER_TYPE_OFFSET) & HEADER_LAYOUT_CODE) == (HEADER_TYPE_CARDBUS_BRIDGE)) {
+      ///
+      /// If CardBus bridge, start at Offset 0x14
+      ///
+      CapHeaderOffset = EFI_PCI_CARDBUS_BRIDGE_CAPABILITY_PTR;
+    } else {
+      ///
+      /// Otherwise, start at Offset 0x34
+      ///
+      CapHeaderOffset = PCI_CAPBILITY_POINTER_OFFSET;
+    }
+    ///
+    /// Get Capability Header, A pointer value of 00h is used to indicate the last capability in the list.
+    ///
+    CapHeaderId     = 0;
+    CapHeaderOffset = PciSegmentRead8 (DeviceBase + CapHeaderOffset) & ((UINT8) ~(BIT0 | BIT1));
+    while (CapHeaderOffset != 0 && CapHeaderId != 0xFF) {
+      Data16 = PciSegmentRead16 (DeviceBase + CapHeaderOffset);
+      CapHeaderId = (UINT8)(Data16 & 0xFF);
+      if (CapHeaderId == CapId) {
+        if (CapHeaderOffset > PCI_MAXLAT_OFFSET) {
+          ///
+          /// Return valid capability offset
+          ///
+          return CapHeaderOffset;
+        } else {
+          ASSERT ((FALSE));
+          return 0;
+        }
+      }
+      ///
+      /// Each capability must be DWORD aligned.
+      /// The bottom two bits of all pointers (including the initial pointer at 34h) are reserved
+      /// and must be implemented as 00b although software must mask them to allow for future uses of these bits.
+      ///
+      CapHeaderOffset = (UINT8)(Data16 >> 8);
+    }
+    return 0;
+  }
+}
+
+/**
+  Find the Offset to a given Capabilities ID
+  CAPID list:
+    0x01 = PCI Power Management Interface
+    0x04 = Slot Identification
+    0x05 = MSI Capability
+    0x10 = PCI Express Capability
+
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                CAPID to search for
+
+  @retval 0                       CAPID not found
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT8
+PcieFindCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT8   CapId
+  )
+{
+  UINT64 DeviceBase;
+
+  DeviceBase = PCI_SEGMENT_LIB_ADDRESS (Segment, Bus, Device, Function, 0);
+  return PcieBaseFindCapId (DeviceBase, CapId);
+}
+
+/**
+  Search and return the offset of desired Pci Express Capability ID
+  CAPID list:
+    0x0001 = Advanced Error Reporting Capability
+    0x0002 = Virtual Channel Capability
+    0x0003 = Device Serial Number Capability
+    0x0004 = Power Budgeting Capability
+
+  @param[in] DeviceBase           device base address
+  @param[in] CapId                Extended CAPID to search for
+
+  @retval 0                       CAPID not found, this includes situation where device doesn't exist
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT16
+PcieBaseFindExtendedCapId (
+  IN UINT64  DeviceBase,
+  IN UINT16  CapId
+  )
+{
+  UINT16  CapHeaderOffset;
+  UINT16  CapHeaderId;
+  ///
+  /// Start to search at Offset 0x100
+  /// Get Capability Header, A pointer value of 00h is used to indicate the last capability in the list.
+  ///
+  CapHeaderId     = 0;
+  CapHeaderOffset = R_PCIE_CFG_EXCAP_OFFSET;
+  while (CapHeaderOffset != 0 && CapHeaderId != MAX_UINT16) {
+    CapHeaderId = PciSegmentRead16 (DeviceBase + CapHeaderOffset);
+    if (CapHeaderId == CapId) {
+      return CapHeaderOffset;
+    }
+    ///
+    /// Each capability must be DWORD aligned.
+    /// The bottom two bits of all pointers are reserved and must be implemented as 00b
+    /// although software must mask them to allow for future uses of these bits.
+    ///
+    CapHeaderOffset = (PciSegmentRead16 (DeviceBase + CapHeaderOffset + 2) >> 4) & ((UINT16) ~(BIT0 | BIT1));
+  }
+
+  return 0;
+}
+
+/**
+  Search and return the offset of desired Pci Express Capability ID
+  CAPID list:
+    0x0001 = Advanced Error Reporting Capability
+    0x0002 = Virtual Channel Capability
+    0x0003 = Device Serial Number Capability
+    0x0004 = Power Budgeting Capability
+
+  @param[in] Segment              Pci Segment Number
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+  @param[in] CapId                Extended CAPID to search for
+
+  @retval 0                       CAPID not found, this includes situation where device doesn't exist
+  @retval Other                   CAPID found, Offset of desired CAPID
+**/
+UINT16
+PcieFindExtendedCapId (
+  IN UINT8   Segment,
+  IN UINT8   Bus,
+  IN UINT8   Device,
+  IN UINT8   Function,
+  IN UINT16  CapId
+  )
+{
+  UINT64  DeviceBase;
+
+  DeviceBase = PCI_SEGMENT_LIB_ADDRESS (Segment, Bus, Device, Function, 0);
+  return PcieBaseFindExtendedCapId (DeviceBase, CapId);
+}
+
+/**
+  Checks if PCI device at given address exists
+
+  @param[in] Base            device's base address
+
+  @retval TRUE if exists
+**/
+BOOLEAN
+IsDevicePresent (
+  UINT64 Base
+  )
+{
+  if (PciSegmentRead16 (Base) == 0xFFFF) {
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Checks if device is a multifunction device
+  Besides comparing Multifunction bit (BIT7) it checks if contents of HEADER_TYPE register
+  make sense (header != 0xFF) to prevent false positives when called on devices which do not exist
+
+  @param[in] Base            device's base address
+
+  @retval TRUE if multifunction; FALSE otherwise
+**/
+BOOLEAN
+IsMultifunctionDevice (
+  UINT64 Base
+  )
+{
+  UINT8 HeaderType;
+  HeaderType = PciSegmentRead8(Base + PCI_HEADER_TYPE_OFFSET);
+  if ((HeaderType == 0xFF) || ((HeaderType & HEADER_TYPE_MULTI_FUNCTION) == 0)) {
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Checks device's Slot Clock Configuration
+
+  @param[in] Base            device's base address
+  @param[in] PcieCapOffset   devices Pci express capability list register offset
+
+  @retval TRUE when device uses slot clock, FALSE otherwise
+**/
+BOOLEAN
+GetScc (
+  UINT64    Base,
+  UINT8     PcieCapOffset
+  )
+{
+  return !!(PciSegmentRead16 (Base + PcieCapOffset + R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_SCC);
+}
+
+/**
+  Sets Common Clock Configuration bit for given device.
+
+  @param[in] PcieCapOffset   devices Pci express capability list register offset
+  @param[in] Base            device's base address
+**/
+VOID
+EnableCcc (
+  UINT64    Base,
+  UINT8     PcieCapOffset
+  )
+{
+  PciSegmentOr8 (Base + PcieCapOffset + R_PCIE_LCTL_OFFSET, B_PCIE_LCTL_CCC);
+}
+
+/**
+  Retrains link behind given device.
+  It only makes sense to call it for downstream ports. If called for upstream port nothing will happen.
+  If WaitUntilDone is TRUE function will wait until link retrain had finished, otherwise it will return immediately.
+  Link must finish retrain before software can access the device on the other side. If it's not going to access it
+  then considerable time can be saved by not waiting here.
+
+  @param[in] Base             device's base address
+  @param[in] PcieCapOffset    devices Pci express capability list register offset
+  @param[in] WaitUntilDone    when TRUE, function waits until link has retrained
+**/
+VOID
+RetrainLink (
+  UINT64  Base,
+  UINT8   PcieCapOffset,
+  BOOLEAN WaitUntilDone
+  )
+{
+  UINT16 LinkTraining;
+  UINT32 TimeoutUs;
+
+  TimeoutUs = LINK_RETRAIN_WAIT_TIME;
+  //
+  // Before triggering link retrain make sure it's not already retraining. Otherwise
+  // settings recently entered in LCTL register might go unnoticed
+  //
+  do {
+    LinkTraining = (PciSegmentRead16 (Base + PcieCapOffset + R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_LT);
+    TimeoutUs--;
+  } while (LinkTraining && (TimeoutUs != 0));
+
+  PciSegmentOr8 (Base + PcieCapOffset + R_PCIE_LCTL_OFFSET, B_PCIE_LCTL_RL);
+
+  TimeoutUs = LINK_RETRAIN_WAIT_TIME;
+  if (WaitUntilDone) {
+    do {
+      LinkTraining = (PciSegmentRead16 (Base + PcieCapOffset + R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_LT);
+      TimeoutUs--;
+    } while (LinkTraining && (TimeoutUs != 0));
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.inf
new file mode 100644
index 0000000000..458a540859
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.inf
@@ -0,0 +1,37 @@
+## @file
+# Component description file for the BasePcieHelperLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = BasePcieHelperLib
+FILE_GUID = 568F5812-A9A8-4A4A-AD4D-471DD5F0BC11
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = BasePcieHelperLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+[LibraryClasses]
+DebugLib
+PciSegmentLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+BasePcieHelperLib.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLib.c
new file mode 100644
index 0000000000..153c073093
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLib.c
@@ -0,0 +1,69 @@
+/** @file
+  PCIE root port library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <PcieRegs.h>
+#include <Register/PchRegs.h>
+#include <PchPcieRpInfo.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+#include "PchPcieRpLibInternal.h"
+
+/**
+  Gets pci segment base address of PCIe root port.
+
+  @param RpIndex    Root Port Index (0 based)
+  @return PCIe port base address.
+**/
+UINT64
+PchPcieBase (
+  IN  UINT32   RpIndex
+  )
+{
+  return PchPcieRpPciCfgBase (RpIndex);
+}
+
+/**
+  Determines whether L0s is supported on current stepping.
+
+  @return TRUE if L0s is supported, FALSE otherwise
+**/
+BOOLEAN
+PchIsPcieL0sSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Some early PCH steppings require Native ASPM to be disabled due to hardware issues:
+   - RxL0s exit causes recovery
+   - Disabling PCIe L0s capability disables L1
+  Use this function to determine affected steppings.
+
+  @return TRUE if Native ASPM is supported, FALSE otherwise
+**/
+BOOLEAN
+PchIsPcieNativeAspmSupported (
+  VOID
+  )
+{
+  return PchIsPcieL0sSupported ();
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibInternal.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibInternal.h
new file mode 100644
index 0000000000..1766cff618
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibInternal.h
@@ -0,0 +1,20 @@
+/** @file
+  PCIE root port library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_PCIE_RP_LIB_INTERNAL_H_
+#define _PCH_PCIE_RP_LIB_INTERNAL_H_
+
+typedef struct {
+  UINT8 DevNum;
+  UINT8 Pid;
+  UINT8 RpNumBase;
+} PCH_PCIE_CONTROLLER_INFO;
+
+#endif
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibVer2.c
new file mode 100644
index 0000000000..df90a87df7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PchPcieRpLibVer2.c
@@ -0,0 +1,128 @@
+/** @file
+  PCIE root port library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <PcieRegs.h>
+#include <Register/PchRegs.h>
+#include <PchBdfAssignment.h>
+#include <PchPcieRpInfo.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/PchPcrRegs.h>
+
+#include "PchPcieRpLibInternal.h"
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_CONTROLLER_INFO mPchPcieControllerInfo[] = {
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1,  PID_SPA,  0 },
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5,  PID_SPB,  4 },
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9,  PID_SPC,  8 },
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13, PID_SPD, 12 },
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17, PID_SPE, 16 }, // PCH-H only
+  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21, PID_SPF, 20 }  // PCH-H only
+};
+
+/**
+  Get Pch Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber              Root port physical number. (0-based)
+  @param[out] RpDev                 Return corresponding root port device number.
+  @param[out] RpFun                 Return corresponding root port function number.
+
+  @retval     EFI_SUCCESS           Root port device and function is retrieved
+  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
+**/
+EFI_STATUS
+EFIAPI
+GetPchPcieRpDevFun (
+  IN  UINTN   RpNumber,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  )
+{
+  UINTN       Index;
+  UINTN       FuncIndex;
+  UINT32      PciePcd;
+
+  if (RpNumber >= GetPchMaxPciePortNum ()) {
+    DEBUG ((DEBUG_ERROR, "GetPchPcieRpDevFun invalid RpNumber %x", RpNumber));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Index = RpNumber / PCH_PCIE_CONTROLLER_PORTS;
+  FuncIndex = RpNumber - mPchPcieControllerInfo[Index].RpNumBase;
+  *RpDev = mPchPcieControllerInfo[Index].DevNum;
+  PciePcd = PchPcrRead32 (mPchPcieControllerInfo[Index].Pid, R_SPX_PCR_PCD);
+  *RpFun = (PciePcd >> (FuncIndex * S_SPX_PCR_PCD_RP_FIELD)) & B_SPX_PCR_PCD_RP1FN;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Get Root Port physical Number by Pch Pcie Root Port Device and Function Number
+
+  @param[in]  RpDev                 Root port device number.
+  @param[in]  RpFun                 Root port function number.
+  @param[out] RpNumber              Return corresponding physical Root Port index (0-based)
+
+  @retval     EFI_SUCCESS           Physical root port is retrieved
+**/
+EFI_STATUS
+EFIAPI
+GetPchPcieRpNumber (
+  IN  UINTN   RpDev,
+  IN  UINTN   RpFun,
+  OUT UINTN   *RpNumber
+  )
+{
+  UINT64 RpBase;
+
+  RpBase = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, DEFAULT_PCI_BUS_NUMBER_PCH, RpDev, RpFun, 0);
+  *RpNumber = (PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LCAP) >> N_PCH_PCIE_CFG_LCAP_PN) -1;
+  return EFI_SUCCESS;
+}
+
+/**
+  This function returns PID according to PCIe controller index
+
+  @param[in] ControllerIndex     PCIe controller index
+
+  @retval PCH_SBI_PID    Returns PID for SBI Access
+**/
+PCH_SBI_PID
+PchGetPcieControllerSbiPid (
+  IN UINT32  ControllerIndex
+  )
+{
+  ASSERT (ControllerIndex < ARRAY_SIZE (mPchPcieControllerInfo));
+  return mPchPcieControllerInfo[ControllerIndex].Pid;
+}
+
+/**
+  This function returns PID according to Root Port Number
+
+  @param[in] RpIndex     Root Port Index (0-based)
+
+  @retval PCH_SBI_PID    Returns PID for SBI Access
+**/
+PCH_SBI_PID
+GetRpSbiPid (
+  IN UINTN  RpIndex
+  )
+{
+  return PchGetPcieControllerSbiPid ((UINT32) (RpIndex / PCH_PCIE_CONTROLLER_PORTS));
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
new file mode 100644
index 0000000000..4fc217581b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
@@ -0,0 +1,39 @@
+## @file
+# PCIE root port Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchPcieRpLib
+FILE_GUID = B522981C-E0C5-4E04-A82A-C61D4F0B2C75
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchPcieRpLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchInfoLib
+PchPcrLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PchPcieRpLib.c
+PchPcieRpLibVer2.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.c
new file mode 100644
index 0000000000..577e436e32
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.c
@@ -0,0 +1,179 @@
+/** @file
+  This file provides services for PcieRp policy function
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/SiConfigBlockLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Protocol/PchPolicy.h>
+#include <PchPcieRpConfig.h>
+
+#define PCI_CLASS_NETWORK             0x02
+#define PCI_CLASS_NETWORK_ETHERNET    0x00
+#define PCI_CLASS_NETWORK_OTHER       0x80
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE mPcieDeviceTable[] = {
+  //
+  // Intel PRO/Wireless
+  //
+  { 0x8086, 0x422b, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x422c, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x4238, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x4239, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel WiMAX/WiFi Link
+  //
+  { 0x8086, 0x0082, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0085, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0083, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0084, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0086, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0087, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0088, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0089, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x008F, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0090, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Crane Peak WLAN NIC
+  //
+  { 0x8086, 0x08AE, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x08AF, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Crane Peak w/BT WLAN NIC
+  //
+  { 0x8086, 0x0896, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0897, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Kelsey Peak WiFi, WiMax
+  //
+  { 0x8086, 0x0885, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0886, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Centrino Wireless-N 105
+  //
+  { 0x8086, 0x0894, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0895, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Centrino Wireless-N 135
+  //
+  { 0x8086, 0x0892, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0893, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Centrino Wireless-N 2200
+  //
+  { 0x8086, 0x0890, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0891, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Centrino Wireless-N 2230
+  //
+  { 0x8086, 0x0887, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x0888, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel Centrino Wireless-N 6235
+  //
+  { 0x8086, 0x088E, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x088F, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel CampPeak 2 Wifi
+  //
+  { 0x8086, 0x08B5, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x08B6, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Intel WilkinsPeak 1 Wifi
+  //
+  { 0x8086, 0x08B3, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x08B4, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
+  //
+  // Intel Wilkins Peak 2 Wifi
+  //
+  { 0x8086, 0x08B1, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
+  { 0x8086, 0x08B2, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
+  //
+  // Intel Wilkins Peak PF Wifi
+  //
+  { 0x8086, 0x08B0, 0xff, PCI_CLASS_NETWORK, PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0, 0, 0, 0, 0 },
+  //
+  // Teton Glacier Endpoint
+  //
+  { 0x8086, 0x0975, 0xff, 0, 0, 0, PchPcieL1SubstatesOverride, 0, 0xff, 0x3C, 0, 5, 0, 0, 0, 0 },
+
+  //
+  // End of Table
+  //
+  { 0 }
+};
+
+/**
+  Print PCIE_RP_DXE_CONFIG.
+
+  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
+**/
+VOID
+PchPcieRpDxePrintConfig (
+  IN PCH_POLICY_PROTOCOL    *PchPolicy
+  )
+{
+  EFI_STATUS            Status;
+  PCIE_RP_DXE_CONFIG    *PchPcieRpDxeConfig;
+
+  Status = GetConfigBlock ((VOID *) PchPolicy, &gPchPcieRpDxeConfigGuid, (VOID *) &PchPcieRpDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "------------------ PCH PCIE DXE CONFIG ------------------\n"));
+  DEBUG ((DEBUG_INFO, " PcieDeviceOverrideTablePtr : 0x%x\n",PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr));
+}
+
+/**
+  Load DXE Config block default for Pch PCIE RP
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+LoadPchPcieRpDxeConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  )
+{
+  PCIE_RP_DXE_CONFIG  *PchPcieRpDxeConfig;
+
+  PchPcieRpDxeConfig = ConfigBlockPointer;
+  PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr = mPcieDeviceTable;
+}
+
+STATIC COMPONENT_BLOCK_ENTRY  mPchPcieRpBlocks = {
+  &gPchPcieRpDxeConfigGuid,
+  sizeof (PCIE_RP_DXE_CONFIG),
+  PCIE_RP_DXE_CONFIG_REVISION,
+  LoadPchPcieRpDxeConfigDefault
+};
+
+/**
+  Get PchPcieRp config block table size.
+
+  @retval      Size of config block
+**/
+UINT16
+PchPcieRpDxeGetConfigBlockTotalSize (
+  VOID
+  )
+{
+  return mPchPcieRpBlocks.Size;
+}
+
+/**
+  Add PchPcieRp ConfigBlock.
+
+  @param[in] ConfigBlockTableAddress    The pointer to config block table
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+PchPcieRpDxeAddConfigBlock (
+  IN VOID           *ConfigBlockTableAddress
+  )
+{
+  return AddComponentConfigBlocks (ConfigBlockTableAddress, &mPchPcieRpBlocks, 1);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf
new file mode 100644
index 0000000000..6158e77a35
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf
@@ -0,0 +1,30 @@
+## @file
+# Component description file for the PchPcieRp policy library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxePchPcieRpPolicyLib
+FILE_GUID = 328B0DE5-189A-4DB0-BFE1-557F4F89010B
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxePchPcieRpPolicyLib
+
+[LibraryClasses]
+DebugLib
+ConfigBlockLib
+SiConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxePchPcieRpPolicyLib.c
+
+[Guids]
+gPchPcieRpDxeConfigGuid  ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.c
new file mode 100644
index 0000000000..401a9fbe7b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.c
@@ -0,0 +1,1997 @@
+/** @file
+  This file contains routines that support PCI Express initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PciExpressHelpersLibrary.h"
+#include <Library/BaseMemoryLib.h>
+#include <Library/PcieHelperLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/PcieRpLib.h>
+#include <PchPcieRpInfo.h>
+#include <CpuPcieInfo.h>
+#include <CpuPcieHob.h>
+#include <Library/HobLib.h>
+#include <Register/PchPcieRpRegs.h>
+
+#define ASPM_L1_NO_LIMIT 0xFF
+#define ASPM_L0s_NO_LIMIT 0x7
+#define LINK_RETRAIN_WAIT_TIME 1000 // microseconds
+
+typedef union {
+  struct {
+    UINT32  RequesterCapable       : 1;
+    UINT32  ResponderCapable       : 1;
+    UINT32  RootCapable            : 1;
+    UINT32  Reserved               : 5;
+    UINT32  LocalClockGranularity  : 8;
+    UINT32  Reserved2              : 16;
+  } Bits;
+  UINT32  Uint32;
+} PTM_CAPS;
+
+typedef union {
+  struct {
+    UINT32 Enable                 : 1;
+    UINT32 RootSelect             : 1;
+    UINT32 Reserved               : 6;
+    UINT32 EffectiveGranularity   : 8;
+    UINT32 Reserved2              : 16;
+  } Bits;
+  UINT32  Uint32;
+} PTM_CTRL;
+
+typedef struct {
+  UINT32                          Size;
+  const PCH_PCIE_DEVICE_OVERRIDE* Table;
+} OVERRIDE_TABLE;
+
+typedef enum {
+  DevTypePci,
+  DevTypePcieEndpoint,
+  DevTypePcieUpstream,
+  DevTypePcieDownstream,
+  DevTypeMax
+} PCI_DEV_TYPE;
+
+//
+// This structure keeps in one place all data relevant to enabling L0s and L1.
+// L0s latencies are encoded in the same way as in hardware registers. The only operation
+// that will be performed on them is comparison
+// L1 latencies are decoded to microseconds, because they will be used in subtractions and additions
+//
+typedef struct {
+  UINT32  L0sSupported          : 1;
+  UINT32  L1Supported           : 1;
+  UINT32  L0sAcceptableLatency  : 3; // encoded as in hardware register
+  UINT32  L1AcceptableLatencyUs : 8; // decoded to microseconds
+  UINT32  LinkL0sExitLatency    : 3; // encoded as in hardware register
+  UINT32  LinkL1ExitLatencyUs   : 8; // decoded to microseconds
+} ASPM_CAPS;
+
+typedef struct {
+  UINT32     AspmL11  : 1;
+  UINT32     AspmL12  : 1;
+  UINT32     PmL11    : 1;
+  UINT32     PmL12    : 1;
+  UINT32     Cmrt     : 8; // Common Mode Restore Time
+  UINT32     TpoScale : 2; // T power_on scale
+  UINT32     TpoValue : 6; // T power_on value
+} L1SS_CAPS;
+
+#define MAX_SBDF_TABLE_SIZE 50 //arbitrary table size; big enough to accomodate even full length TBT chain.
+
+typedef struct {
+  UINT32 Count;
+  SBDF   Entry [MAX_SBDF_TABLE_SIZE];
+} SBDF_TABLE;
+
+/**
+  Converts device's segment:bus:device:function coordinates to flat address
+
+  @param[in] Sbdf   device's segment:bus:device:function coordinates
+
+  @retval    address of device's PCI cfg space
+**/
+STATIC
+UINT64
+SbdfToBase (
+  SBDF Sbdf
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (Sbdf.Seg, Sbdf.Bus, Sbdf.Dev, Sbdf.Func, 0);
+}
+
+/*
+  Converts Tpower_on from value:scale notation to microseconds
+
+  @param[in] TpoScale   T power on scale
+  @param[in] TpoValue   T power on value
+
+  @retval    number of microseconds
+*/
+UINT32
+TpoToUs (
+  UINT32 TpoScale,
+  UINT32 TpoValue
+  )
+{
+  static const UINT8 TpoScaleMultiplier[] = {2, 10, 100};
+
+  ASSERT (TpoScale < TpoScaleMax);
+  if (TpoScale >= TpoScaleMax) {
+    return 0;
+  }
+  return (TpoScaleMultiplier[TpoScale] * TpoValue);
+}
+
+/**
+  Get max payload size supported by device.
+
+  @param[in] Sbdf   device's segment:bus:device:function coordinates
+
+  @retval    Max payload size, encoded in the same way as in register (0=128b, 1=256b, etc)
+**/
+STATIC
+UINT8
+GetMps (
+  SBDF Sbdf
+  )
+{
+  return (PciSegmentRead16 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_DCAP_OFFSET) & B_PCIE_DCAP_MPS);
+}
+
+/**
+  Sets Maximum Payload Size to be used by device
+
+  @param[in] Sbdf   device's segment:bus:device:function coordinates
+  @param[in] Mps    Max payload size, encoded in the same way as in register (0=128b, 1=256b, etc)
+**/
+STATIC
+VOID
+SetMps (
+  SBDF  Sbdf,
+  UINT8  Mps
+  )
+{
+  PciSegmentAndThenOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_DCTL_OFFSET, (UINT16) ~B_PCIE_DCTL_MPS, Mps << N_PCIE_DCTL_MPS);
+}
+
+/**
+  Enables LTR feature in given device
+
+  @param[in] Sbdf            device's segment:bus:device:function coordinates
+**/
+STATIC
+VOID
+EnableLtr (
+  SBDF Sbdf
+  )
+{
+  if (Sbdf.PcieCap == 0) {
+    return;
+  }
+  PciSegmentOr32 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_DCTL2_OFFSET, B_PCIE_DCTL2_LTREN);
+}
+
+/**
+  Returns information about type of device.
+
+  @param[out] Sbdf            device's segment:bus:device:function coordinates
+
+  @retval     one of: not a PCIe device (legacy PCI), PCIe endpoint, PCIe upstream port or PCIe downstream port (including rootport)
+**/
+STATIC
+PCI_DEV_TYPE
+GetDeviceType (
+  SBDF Sbdf
+  )
+{
+  UINT8 DeviceType;
+
+  if (Sbdf.PcieCap == 0) {
+    return DevTypePci;
+  }
+  DeviceType = (UINT8) ((PciSegmentRead16 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_XCAP_OFFSET) & B_PCIE_XCAP_DT) >> N_PCIE_XCAP_DT);
+  if (DeviceType == PCIE_DEVICE_PORT_TYPE_UPSTREAM_PORT) {
+    return DevTypePcieUpstream;
+  } else if (DeviceType == PCIE_DEVICE_PORT_TYPE_DOWNSTREAM_PORT || DeviceType == PCIE_DEVICE_PORT_TYPE_ROOT_PORT) {
+    return DevTypePcieDownstream;
+  } else {
+    return DevTypePcieEndpoint;
+  }
+}
+
+/**
+  Initializes Dev:Func numbers for use in FindNextPcieChild or FindNextLegalSbdf functions.
+
+  @param[out] Sbdf            device's segment:bus:device:function coordinates
+**/
+STATIC
+VOID
+InitChildFinder (
+  OUT SBDF *Sbdf
+  )
+{
+  //
+  // Initialize Dev/Func to maximum values, so that when FindNextLegalSbdf ()
+  // is called on those input parameters, it will return 1st legal address (Dev 0 Func 0).
+  //
+  Sbdf->Dev = PCI_MAX_DEVICE;
+  Sbdf->Func = PCI_MAX_FUNC;
+}
+
+/**
+  Checks the device is a bridge and has non-zero secondary bus number assigned.
+  If so, it returns TRUE and initializes ChildSbdf with such values that
+  allow searching for devices on the secondary bus.
+  ChildSbdf will be mangled even if this function returns FALSE.
+
+  Legal bus assignment is assumed. This function doesn't check subordinate bus numbers of
+  the the device it was called on or any bridges between it and root complex
+
+  @param[in]  Sbdf       device's segment:bus:device:function coordinates
+  @param[out] ChildSbdf  SBDF initialized in such way that calling FindNextPcieChild( ) on it will find all children devices
+
+  @retval TRUE if device is a bridge and has a bus behind it; FALSE otherwise
+**/
+STATIC
+BOOLEAN
+HasChildBus (
+  SBDF   Sbdf,
+  SBDF   *ChildSbdf
+  )
+{
+  UINT32 Data32;
+  UINT64 Base;
+  UINT8  SecondaryBus;
+
+  ChildSbdf->Seg = Sbdf.Seg;
+  InitChildFinder (ChildSbdf);
+
+  Base = SbdfToBase (Sbdf);
+
+  if (PciSegmentRead8 (Base + R_PCI_BCC_OFFSET) != PCI_CLASS_BRIDGE) {
+    DEBUG ((DEBUG_INFO, "HasChildBus%02:%02:%02: no\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+    return FALSE;
+  }
+  Data32 = PciSegmentRead32 (Base + PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET);
+  SecondaryBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SCBN) >> 8);
+  ChildSbdf->Bus = SecondaryBus;
+  if (SecondaryBus == 0) {
+    DEBUG ((DEBUG_INFO, "HasChildBus%02x:%02x:%02x: no\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+    return FALSE;
+  } else {
+    DEBUG ((DEBUG_INFO, "HasChildBus%02x:%02x:%02x: yes, %x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, SecondaryBus));
+    return TRUE;
+  }
+}
+
+/**
+  Sets LTR limit in a device.
+
+  @param[in] Base            device's base address
+  @param[in] Ltr             LTR limit
+**/
+STATIC
+VOID
+SetLtrLimit (
+  UINT64    Base,
+  LTR_LIMIT Ltr
+  )
+{
+  UINT16 LtrCapOffset;
+  UINT16 Data16;
+
+  LtrCapOffset = PcieBaseFindExtendedCapId (Base, R_PCIE_LTRECH_CID);
+  if (LtrCapOffset == 0) {
+    return;
+  }
+  Data16 = (UINT16)((Ltr.MaxSnoopLatencyValue << N_PCIE_LTRECH_MSLR_VALUE) | (Ltr.MaxSnoopLatencyScale << N_PCIE_LTRECH_MSLR_SCALE));
+  PciSegmentWrite16(Base + LtrCapOffset + R_PCIE_LTRECH_MSLR_OFFSET, Data16);
+
+  Data16 = (UINT16)((Ltr.MaxNoSnoopLatencyValue << N_PCIE_LTRECH_MNSLR_VALUE) | (Ltr.MaxNoSnoopLatencyScale << N_PCIE_LTRECH_MNSLR_SCALE));
+  PciSegmentWrite16(Base + LtrCapOffset + R_PCIE_LTRECH_MNSLR_OFFSET, Data16);
+}
+
+/**
+  Checks if device at given address exists and is a PCI Express device.
+  PCI express devices are distinguished from PCI by having Capability ID 0x10
+  If the device is PCI express then its SDBF structure gets updated with pointer to
+  the PCIe Capability. This is an optimization feature. It greatly decreases the number
+  of bus accesses, since most features configured by this library depend on registers
+  whose location is relative to PCIe capability.
+
+  @param[in,out] Sbdf   on entry, segment:bus:device:function coordinates
+                        on exit, PcieCap offset is updated
+
+  @retval               TRUE when PCIe device exists; FALSE if it's not PCIe or there's no device at all
+**/
+STATIC
+BOOLEAN
+IsPcieDevice (
+  SBDF *Sbdf
+  )
+{
+  UINT8 PcieCapOffset;
+  UINT64         Base;
+
+  Base = SbdfToBase(*Sbdf);
+
+  if (PciSegmentRead16 (Base) == 0xFFFF) {
+    return FALSE;
+  }
+
+
+  PcieCapOffset = PcieBaseFindCapId (Base, EFI_PCI_CAPABILITY_ID_PCIEXP);
+  if (PcieCapOffset == 0) {
+    DEBUG ((DEBUG_INFO, "IsPcieDevice %02x:%02x:%02x - legacy\n", Sbdf->Bus, Sbdf->Dev, Sbdf->Func));
+    return FALSE;
+  } else {
+    Sbdf->PcieCap = PcieCapOffset;
+    DEBUG ((DEBUG_INFO, "IsPcieDevice %02x:%02x:%02x - yes\n", Sbdf->Bus, Sbdf->Dev, Sbdf->Func));
+    return TRUE;
+  }
+}
+
+/**
+  Returns TRUE and Dev:Func numbers where a PCIe device could legally be located, or FALSE if there
+  no such coordinates left.
+
+  Segment and Bus fields of SBDF structure are input only and determine which bus will be scanned.
+  This function should be called in a while() loop. It replaces the less efficient method of
+  using nested FOR loops that iterate over all device and function numbers. It is optimized for
+  the amount of bus access. If function0 doesn't exist or doesn't have Multifunction bit set,
+  then higher function numbers are skipped. If parent of this bus is a downstream port, then
+  Device numbers 1-31 get skipped too (there can be only Dev0 behind downstream ports)
+  If device/function number == 0x1F/0x7, this function returns first possible address, that is 0:0
+  Any other device number means Dev:Func contain address of last found child device
+  and this function should search for next one
+
+  @param[in]     ParentDevType  type of bridge who's partent of this bus
+  @param[in,out] Sbdf           On entry: location returned previously from this function
+                                          Dev:Func value of 1F:07 means search should start from the beginning
+                                On exit:  if legal Dev:Func combination was found, that Dev:Func is returned
+                                          otherwise, Dev:Func are initialized to 1F:07 for convenience
+
+  @retval TRUE when next legal Dev:Func address was found; FALSE otherwise
+**/
+STATIC
+BOOLEAN
+FindNextLegalSbdf (
+  IN     PCI_DEV_TYPE ParentDevType,
+  IN OUT SBDF         *Sbdf
+  )
+{
+  UINT8  MaxDev;
+  UINT64 Func0Base;
+
+  if (ParentDevType == DevTypePcieEndpoint) {
+    return FALSE;
+  }
+  if (ParentDevType == DevTypePcieUpstream) {
+    MaxDev = PCI_MAX_DEVICE;
+  } else {
+    MaxDev = 0;
+  }
+  Func0Base = PCI_SEGMENT_LIB_ADDRESS (Sbdf->Seg, Sbdf->Bus, Sbdf->Dev, 0, 0);
+  if ((Sbdf->Dev == PCI_MAX_DEVICE) && Sbdf->Func == PCI_MAX_FUNC) {
+    Sbdf->Dev = 0;
+    Sbdf->Func = 0;
+    return TRUE;
+  } else if ((Sbdf->Func == PCI_MAX_FUNC) || (Sbdf->Func == 0 && !IsMultifunctionDevice (Func0Base))) {
+  //
+  // if it's the last function of a device, then return Func0 of new device or FALSE in case there are no more devices
+  //
+    if (Sbdf->Dev == MaxDev) {
+      InitChildFinder (Sbdf);
+      return FALSE;
+    }
+    (Sbdf->Dev)++;
+    Sbdf->Func = 0;
+    return TRUE;
+  } else {
+    (Sbdf->Func)++;
+    return TRUE;
+  }
+}
+
+/**
+  Finds next PCIe (not legacy PCI) device behind given device
+  If device/function number == 0x1F/0x7, this function searches for children from scratch
+  Any other device number means Dev:Func contain address of last found child device
+  and this function should search for next one
+
+  @param[in]     ParentDevType  type of bridge who's partent of this bus
+  @param[in,out] Sbdf           On entry: location returned previously from this function
+                                          Dev:Func value of 0x1F:0x07 means search should start from the beginning
+                                On exit:  if PCIe device was found, its SBDF coordinates are returned
+                                          otherwise, Dev:Func are initialized to 0x1F:0x07 for convenience
+  @retval TRUE when next PCIe device was found; FALSE otherwise
+**/
+BOOLEAN
+FindNextPcieChild (
+  IN     PCI_DEV_TYPE ParentDevType,
+  IN OUT SBDF   *Sbdf
+  )
+{
+  while ( FindNextLegalSbdf (ParentDevType, Sbdf)) {
+    if (IsPcieDevice (Sbdf)) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Checks if given device supports Clock Power Management
+
+  @param[in] Sbdf     segment:bus:device:function coordinates of a device
+
+  @retval TRUE when device supports it, FALSE otherwise
+**/
+STATIC
+BOOLEAN
+IsCpmSupported (
+  SBDF Sbdf
+  )
+{
+  return !!(PciSegmentRead32 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_CPM);
+}
+
+/**
+  Sets Enable Clock Power Management bit for given device
+
+  @param[in] Sbdf            segment:bus:device:function coordinates of a device
+**/
+STATIC
+VOID
+EnableCpm (
+  SBDF Sbdf
+  )
+{
+  PciSegmentOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_LCTL_OFFSET, B_PCIE_LCTL_ECPM);
+}
+
+/**
+  Checks if given device is an IoAPIC
+
+  @param[in] Base            device's base address
+
+  @retval TRUE if it's an IoAPIC
+**/
+BOOLEAN
+IsIoApicDevice (
+  UINT64 Base
+  )
+{
+  UINT8 BaseClassCode;
+  UINT8 SubClassCode;
+  UINT8 ProgInterface;
+
+  BaseClassCode = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET + 2);
+  SubClassCode  = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET + 1);
+  ProgInterface = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET);
+  if ((BaseClassCode == PCI_CLASS_SYSTEM_PERIPHERAL) &&
+      (SubClassCode == PCI_SUBCLASS_PIC) &&
+      ((ProgInterface == PCI_IF_APIC_CONTROLLER) ||
+       (ProgInterface == PCI_IF_APIC_CONTROLLER2))) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  There are some devices which support L1 substates, but due to silicon bugs the corresponding register
+  cannot be found by scanning PCIe capabilities. This function checks list of such devices and if one
+  is found, returns its L1ss capability register offset
+
+  @param[in] Base       base address of device
+  @param[in] Override   table of devices that need override
+
+  @retval               offset to L1ss capability register
+**/
+UINT16
+GetOverrideL1ssCapsOffset (
+  UINT64         Base,
+  OVERRIDE_TABLE *Override
+  )
+{
+  UINT16 DeviceId;
+  UINT16 VendorId;
+  UINT8  Revision;
+  UINT32 Index;
+
+  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
+  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
+  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
+
+  for (Index = 0; Index < Override->Size; Index++) {
+    if (((Override->Table[Index].OverrideConfig & PchPcieL1SubstatesOverride) == PchPcieL1SubstatesOverride) &&
+        (Override->Table[Index].VendorId == VendorId) &&
+        (Override->Table[Index].DeviceId == DeviceId) &&
+        (Override->Table[Index].RevId == Revision || Override->Table[Index].RevId == 0xFFFF)) {
+      return Override->Table[Index].L1SubstatesCapOffset;
+    }
+  }
+  return 0;
+}
+
+/**
+  There are some devices whose implementation of L1 substates is partially broken. This function checks
+  list of such devices and if one is found, overrides their L1ss-related capabilities
+
+  @param[in]     Base       base address of device
+  @param[in]     Override   table of devices that need override
+  @param[in,out] L1ss       on entry, capabilities read from register; on exit, capabilities modified according ot override table
+**/
+STATIC
+VOID
+OverrideL1ssCaps (
+  UINT64         Base,
+  OVERRIDE_TABLE *Override,
+  L1SS_CAPS      *L1ss
+  )
+{
+  UINT16 DeviceId;
+  UINT16 VendorId;
+  UINT8  Revision;
+  UINT32 Index;
+
+  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
+  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
+  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
+
+  for (Index = 0; Index < Override->Size; Index++) {
+    if (((Override->Table[Index].OverrideConfig & PchPcieL1SubstatesOverride) == PchPcieL1SubstatesOverride) &&
+        (Override->Table[Index].VendorId == VendorId) &&
+        (Override->Table[Index].DeviceId == DeviceId) &&
+        (Override->Table[Index].RevId == Revision || Override->Table[Index].RevId == 0xFF)) {
+
+      L1ss->PmL12   &= !!(Override->Table[Index].L1SubstatesCapMask & B_PCIE_EX_L1SCAP_PPL12S);
+      L1ss->PmL11   &= !!(Override->Table[Index].L1SubstatesCapMask & B_PCIE_EX_L1SCAP_PPL11S);
+      L1ss->AspmL12 &= !!(Override->Table[Index].L1SubstatesCapMask & B_PCIE_EX_L1SCAP_AL12S);
+      L1ss->AspmL11 &= !!(Override->Table[Index].L1SubstatesCapMask & B_PCIE_EX_L1SCAP_AL1SS);
+      if (Override->Table[Index].L1sTpowerOnValue != 0) {
+        L1ss->Cmrt = Override->Table[Index].L1sCommonModeRestoreTime;
+        L1ss->TpoScale = Override->Table[Index].L1sTpowerOnScale;
+        L1ss->TpoValue = Override->Table[Index].L1sTpowerOnValue;
+      }
+      return;
+    }
+  }
+}
+
+/**
+  Returns L1 sub states capabilities of a device
+
+  @param[in] Base   base address of a device
+
+  @retval L1SS_CAPS structure filled with device's capabilities
+**/
+STATIC
+L1SS_CAPS
+GetL1ssCaps (
+  UINT64         Base,
+  OVERRIDE_TABLE *Override
+  )
+{
+  L1SS_CAPS Capabilities = {0};
+  UINT16    PcieCapOffset;
+  UINT32    CapsRegister;
+
+  PcieCapOffset = GetOverrideL1ssCapsOffset (Base, Override);
+  if (PcieCapOffset == 0) {
+    PcieCapOffset = PcieBaseFindExtendedCapId (Base, V_PCIE_EX_L1S_CID);
+  }
+  if (PcieCapOffset == 0) {
+    return Capabilities;
+  }
+  CapsRegister = PciSegmentRead32 (Base + PcieCapOffset + R_PCIE_EX_L1SCAP_OFFSET);
+  if (CapsRegister & B_PCIE_EX_L1SCAP_L1PSS) {
+    //
+    // Skip L1.1 checking since some device only indecate L1.2 support.
+    // [1604452805]
+    //
+    Capabilities.PmL11 = !!(CapsRegister & B_PCIE_EX_L1SCAP_PPL11S);
+    Capabilities.PmL12 = !!(CapsRegister & B_PCIE_EX_L1SCAP_PPL12S);
+    Capabilities.AspmL12 = !!(CapsRegister & B_PCIE_EX_L1SCAP_AL12S);
+    Capabilities.AspmL11 = !!(CapsRegister & B_PCIE_EX_L1SCAP_AL1SS);
+    Capabilities.Cmrt = (CapsRegister & B_PCIE_EX_L1SCAP_CMRT) >> N_PCIE_EX_L1SCAP_CMRT;
+    Capabilities.TpoValue = (CapsRegister & B_PCIE_EX_L1SCAP_PTV) >> N_PCIE_EX_L1SCAP_PTV;
+    Capabilities.TpoScale = (CapsRegister & B_PCIE_EX_L1SCAP_PTPOS) >> N_PCIE_EX_L1SCAP_PTPOS;
+  }
+  OverrideL1ssCaps (Base, Override, &Capabilities);
+  return Capabilities;
+}
+
+/**
+  Returns combination of two sets of L1 substate capabilities
+  Given feature is supported by the link only if both sides support it
+  Time parameters for link (Cmrt and Tpo) depend on the bigger value between two sides
+
+  @param[in] L1ssA      L1 substate capabilities of first device
+  @param[in] L1ssB      L1 substate capabilities of second device
+
+  @retval Link's L1 substate capabilities
+**/
+STATIC
+L1SS_CAPS
+CombineL1ss (
+  L1SS_CAPS L1ssA,
+  L1SS_CAPS L1ssB
+  )
+{
+  L1SS_CAPS Combined;
+
+  Combined.PmL12 = L1ssA.PmL12 && L1ssB.PmL12;
+  Combined.PmL11 = L1ssA.PmL11 && L1ssB.PmL11;
+  Combined.AspmL12 = L1ssA.AspmL12 && L1ssB.AspmL12;
+  Combined.AspmL11 = L1ssA.AspmL11 && L1ssB.AspmL11;
+  Combined.Cmrt = MAX (L1ssA.Cmrt, L1ssB.Cmrt);
+  if (TpoToUs (L1ssA.TpoScale, L1ssA.TpoValue) > TpoToUs (L1ssB.TpoScale, L1ssB.TpoValue)) {
+    Combined.TpoScale = L1ssA.TpoScale;
+    Combined.TpoValue = L1ssA.TpoValue;
+  } else {
+    Combined.TpoScale = L1ssB.TpoScale;
+    Combined.TpoValue = L1ssB.TpoValue;
+  }
+  return Combined;
+}
+
+/**
+  Configures L1 substate feature in a device
+
+  @param[in] Sbdf     segment:bus:device:function coordinates of a device
+  @param[in] L1ss     configuration to be programmed
+  @param[in] Override table of devices that require special handling
+**/
+STATIC
+VOID
+SetL1ss (
+  SBDF           Sbdf,
+  L1SS_CAPS      L1ss,
+  OVERRIDE_TABLE *Override,
+  BOOLEAN   IsCpuPcie
+
+  )
+{
+  UINT16    PcieCapOffset;
+  UINT32    Ctrl1Register;
+  UINT32    Ctrl2Register;
+  UINT64    Base;
+
+  Base = SbdfToBase(Sbdf);
+  Ctrl1Register = 0;
+  Ctrl2Register = 0;
+
+  PcieCapOffset = GetOverrideL1ssCapsOffset (Base, Override);
+  if (PcieCapOffset == 0) {
+    PcieCapOffset = PcieBaseFindExtendedCapId (Base, V_PCIE_EX_L1S_CID);
+  }
+  if (PcieCapOffset == 0) {
+    return;
+  }
+
+  Ctrl1Register |= (L1ss.PmL12 ? B_PCIE_EX_L1SCAP_PPL12S : 0);
+  Ctrl1Register |= (L1ss.PmL11 ? B_PCIE_EX_L1SCAP_PPL11S : 0);
+  Ctrl1Register |= (L1ss.AspmL12 ? B_PCIE_EX_L1SCAP_AL12S : 0);
+  Ctrl1Register |= (L1ss.AspmL11 ? B_PCIE_EX_L1SCAP_AL1SS : 0);
+  if ((GetDeviceType (Sbdf) == DevTypePcieDownstream)) {
+    Ctrl1Register |= (L1ss.Cmrt << N_PCIE_EX_L1SCAP_CMRT);
+  }
+  ///
+  /// BWG 1.3 Section 5.5.7.6 LTR Threshold Latency
+  /// Set L1.2 LTR threshold using formula (TpoToUs (L1ss.TpoScale, L1ss.TpoValue) + L1ss.Cmrt + 10)
+  ///
+  Ctrl1Register |= ((TpoToUs (L1ss.TpoScale, L1ss.TpoValue) + L1ss.Cmrt + 10) << N_PCIE_EX_L1SCTL1_L12LTRTLV);
+  Ctrl1Register |= (2 << N_PCIE_EX_L1SCTL1_L12LTRTLSV);
+
+  Ctrl2Register |= (L1ss.TpoScale);
+  Ctrl2Register |= (L1ss.TpoValue << N_PCIE_EX_L1SCTL2_POWT);
+  //
+  // Set CLKREQ Acceleration Interrupt Enable
+  //
+  Ctrl1Register |= B_PCIE_EX_L1SCTL1_L1SSEIE;
+  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL1_OFFSET, 0);
+  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL2_OFFSET, Ctrl2Register);
+  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL1_OFFSET, Ctrl1Register);
+}
+
+/**
+  Converts L1 latency from enumerated register value to microseconds
+
+  @param[in] L1Latency     latency value retrieved from register; see PCIE specification for encoding
+
+  @retval    L1 latency converted to microseconds
+**/
+UINT32
+L1LatencyToUs (
+  UINT32 L1Latency
+  )
+{
+  if (L1Latency < 7) {
+    return 1 * (BIT0 << L1Latency);
+  } else {
+    return ASPM_L1_NO_LIMIT;
+  }
+}
+
+/**
+  Modifies L1 latency by provided value
+
+  @param[in] Aspm     Structure that contains ASPM capabilities of a link, including L1 acceptable latency
+  @param[in] Value    Value, in microseconds, to be added to L1 acceptable latency. Can be negative.
+
+  @retval             Aspm structure with modified L1 acceptable latency
+**/
+STATIC
+ASPM_CAPS
+PatchL1AcceptableLatency (
+  ASPM_CAPS Aspm,
+  INT8      Value
+  )
+{
+  if (Aspm.L1AcceptableLatencyUs != ASPM_L1_NO_LIMIT) {
+    if (Value > 0) {
+      Aspm.L1AcceptableLatencyUs += Value;
+    } else {
+      if (Aspm.L1AcceptableLatencyUs > (UINT32)(-1*Value)) {
+        Aspm.L1AcceptableLatencyUs = Aspm.L1AcceptableLatencyUs + Value;
+      } else {
+        Aspm.L1AcceptableLatencyUs = 0;
+      }
+    }
+  }
+  return Aspm;
+}
+
+/**
+  Reads ASPM capabilities of a device
+
+  @param[in] Sbdf segment:bus:device:function coordinates of a device
+
+  @retval           structure containing device's ASPM capabilities
+**/
+STATIC
+ASPM_CAPS
+GetAspmCaps (
+  SBDF   Sbdf
+  )
+{
+
+  UINT32    LinkCapRegister;
+  UINT32    DevCapRegister;
+  UINT64    Base;
+  ASPM_CAPS Aspm = {0};
+
+  Base = SbdfToBase (Sbdf);
+
+  LinkCapRegister = PciSegmentRead32 (Base + Sbdf.PcieCap + R_PCIE_LCAP_OFFSET);
+  DevCapRegister = PciSegmentRead32 (Base + Sbdf.PcieCap + R_PCIE_DCAP_OFFSET);
+
+  ///
+  /// Check endpoint for pre-1.1 devices based on the Role based Error Reporting Capability bit. Don't report L0s support for old devices
+  ///
+  if (DevCapRegister & B_PCIE_DCAP_RBER) {
+    Aspm.L0sSupported = !!(LinkCapRegister & B_PCIE_LCAP_APMS_L0S);
+  }
+  Aspm.L1Supported = !!(LinkCapRegister & B_PCIE_LCAP_APMS_L1);
+
+  Aspm.LinkL0sExitLatency = (LinkCapRegister & B_PCIE_LCAP_EL0) >> N_PCIE_LCAP_EL0;
+  Aspm.LinkL1ExitLatencyUs = L1LatencyToUs( (LinkCapRegister & B_PCIE_LCAP_EL1) >> N_PCIE_LCAP_EL1);
+
+  if (GetDeviceType (Sbdf) == DevTypePcieEndpoint) {
+    Aspm.L0sAcceptableLatency = (DevCapRegister & B_PCIE_DCAP_E0AL) >> N_PCIE_DCAP_E0AL;
+    Aspm.L1AcceptableLatencyUs = L1LatencyToUs( (DevCapRegister & B_PCIE_DCAP_E1AL) >> N_PCIE_DCAP_E1AL);
+    DEBUG ((DEBUG_INFO, "GetAspmCaps %02x:%02x:%02x L0s%c %d:%d L1%c %d:%d\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func,
+                                                                           Aspm.L0sSupported?'+':'-', Aspm.LinkL0sExitLatency, Aspm.L0sAcceptableLatency,
+                                                                           Aspm.L1Supported?'+':'-', Aspm.LinkL1ExitLatencyUs, Aspm.L1AcceptableLatencyUs));
+  } else {
+    Aspm.L0sAcceptableLatency = ASPM_L0s_NO_LIMIT;
+    Aspm.L1AcceptableLatencyUs = ASPM_L1_NO_LIMIT;
+    DEBUG ((DEBUG_INFO, "GetAspmCaps %02x:%02x:%02x L0s%c %d:x L1%c %d:x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func,
+                                                                           Aspm.L0sSupported?'+':'-', Aspm.LinkL0sExitLatency,
+                                                                           Aspm.L1Supported?'+':'-', Aspm.LinkL1ExitLatencyUs));
+  }
+  return Aspm;
+}
+
+/**
+  Get ASPM L0s and L1 override of given device.
+
+  @param[in] Sbdf                Segment,Bus,Device,Function address of currently visited PCIe device
+  @param[in,out] MyAspm          Current device's ASPM capabilities structure
+  @param[in] Override            Pch Pcie devices OverrideTable
+**/
+STATIC
+VOID
+GetOverrideAspm (
+  SBDF           Sbdf,
+  ASPM_CAPS      *MyAspm,
+  OVERRIDE_TABLE *Override
+  )
+{
+  UINT16      DeviceId;
+  UINT16      VendorId;
+  UINT8       Revision;
+  UINT32      Index;
+  UINT64      Base;
+
+  Base = SbdfToBase (Sbdf);
+
+  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
+  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
+  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
+
+  for (Index = 0; Index < Override->Size; Index++) {
+    if (((Override->Table[Index].OverrideConfig & PchPcieL1L2Override) == PchPcieL1L2Override) &&
+        (Override->Table[Index].VendorId == VendorId) &&
+        (Override->Table[Index].DeviceId == DeviceId) &&
+        (Override->Table[Index].RevId == Revision || Override->Table[Index].RevId == 0xFF)) {
+      DEBUG ((DEBUG_INFO, "GetOverrideAspm %02x:%02x:%02x, original L0sSupported = 0x%x, L1Supported = 0x%x\n",
+              Sbdf.Bus, Sbdf.Dev, Sbdf.Func, MyAspm->L0sSupported, MyAspm->L1Supported));
+      if (MyAspm->L0sSupported) {
+        //
+        // If L0s is supported in capability, apply platform override.
+        //
+        MyAspm->L0sSupported = Override->Table[Index].EndPointAspm & BIT0;
+      }
+      if (MyAspm->L1Supported) {
+        //
+        // If L1 is supported in capability, apply platform override.
+        //
+        MyAspm->L1Supported = (Override->Table[Index].EndPointAspm & BIT1) >> 1;
+      }
+      DEBUG ((DEBUG_INFO, "GetOverrideAspm %02x:%02x:%02x, override L0sSupported = 0x%x, L1Supported = 0x%x\n",
+              Sbdf.Bus, Sbdf.Dev, Sbdf.Func, MyAspm->L0sSupported, MyAspm->L1Supported));
+    }
+  }
+}
+
+/**
+  Combines ASPM capabilities of two devices on both ends of a link to determine link's ASPM capabilities
+
+  @param[in] AspmA, AspmB  ASPM capabilities of two devices
+
+  @retval    ASPM_CAPS structure containing combined ASPM capabilities
+**/
+STATIC
+ASPM_CAPS
+CombineAspm (
+  ASPM_CAPS AspmA,
+  ASPM_CAPS AspmB,
+  BOOLEAN   DownstreamPort
+  )
+{
+  ASPM_CAPS Combined;
+
+  if (DownstreamPort) {
+    //
+    // When combining ASPM in downstream ports, combination must reflect state of link just below
+    // and consider all acceptable latencies of all endpoints anywhere down below that port
+    //
+    Combined.L0sSupported = AspmA.L0sSupported & AspmB.L0sSupported;
+    Combined.L1Supported = AspmA.L1Supported & AspmB.L1Supported;
+    Combined.LinkL0sExitLatency = MAX (AspmA.LinkL0sExitLatency, AspmB.LinkL0sExitLatency);
+    Combined.LinkL1ExitLatencyUs = MAX (AspmA.LinkL1ExitLatencyUs, AspmB.LinkL1ExitLatencyUs);
+    Combined.L0sAcceptableLatency = MIN (AspmA.L0sAcceptableLatency, AspmB.L0sAcceptableLatency);
+    Combined.L1AcceptableLatencyUs = MIN (AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs);
+  } else {
+    //
+    // When combining ASPM in switch upstream ports,
+    // Supported and ExitLatency must only reflect capabilities of upstream port itself
+    // But acceptable latencies must consider all endpoints anywhere below
+    //
+    Combined.L0sSupported = AspmA.L0sSupported;
+    Combined.L1Supported = AspmA.L1Supported;
+    Combined.LinkL0sExitLatency = AspmA.LinkL0sExitLatency;
+    Combined.LinkL1ExitLatencyUs = AspmA.LinkL1ExitLatencyUs;
+    Combined.L0sAcceptableLatency = MIN (AspmA.L0sAcceptableLatency, AspmB.L0sAcceptableLatency);
+    Combined.L1AcceptableLatencyUs = MIN (AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs);
+  }
+  DEBUG ((DEBUG_INFO, "CombineAspm %x:%x -> %x\n", AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs, Combined.L1AcceptableLatencyUs));
+  return Combined;
+}
+
+/**
+  Checks if L1 can be enabled on given link, according to ASPM parameters of that link
+
+  @param[in] Aspm            set of parameters describing this link and endpoint devices below it
+
+  @retval    TRUE if L1 can be enabled
+**/
+STATIC
+BOOLEAN
+IsL1Allowed (
+  ASPM_CAPS Aspm
+  )
+{
+  return (Aspm.L1Supported && (Aspm.L1AcceptableLatencyUs >= Aspm.LinkL1ExitLatencyUs));
+}
+
+/**
+  Checks if L0s can be enabled on given link, according to ASPM parameters of that link
+
+  @param[in] Aspm            set of parameters describing this link and endpoint devices below it
+
+  @retval    TRUE if L0s can be enabled
+**/
+STATIC
+BOOLEAN
+IsL0sAllowed (
+  ASPM_CAPS Aspm
+  )
+{
+  return (Aspm.L0sSupported && (Aspm.L0sAcceptableLatency >= Aspm.LinkL0sExitLatency));
+}
+
+/**
+  Enables L0s and L1 for given port, if possible.
+  L0s/L1 can be enabled if it's supported on both sides of a link and if link's latency doesn't exceed
+  acceptable latency of any endpoint below this link
+
+  @param[in] Base            device's base address
+  @param[in] Aspm            set of parameters describing this link and endpoint devices below it
+**/
+STATIC
+VOID
+SetAspm (
+  SBDF      Sbdf,
+  ASPM_CAPS Aspm
+  )
+{
+  UINT16 DataOr;
+
+  DataOr = 0;
+  if (IsL0sAllowed (Aspm)) {
+    DataOr |= V_PCIE_LCTL_ASPM_L0S;
+  }
+  if (IsL1Allowed (Aspm)) {
+    DataOr |= V_PCIE_LCTL_ASPM_L1;
+  }
+  DEBUG ((DEBUG_INFO, "SetAspm on %02x:%02x:%02x to %d\n", Sbdf.Bus,Sbdf.Dev,Sbdf.Func, DataOr));
+  PciSegmentAndThenOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_LCTL_OFFSET, (UINT16)~B_PCIE_LCTL_ASPM, DataOr);
+}
+
+/**
+  Adds device entry to a list of devices.
+
+  @param[in,out] Table    array of devices
+  @param[in]     Sbdf     segment:bus:device:function coordinates of device to be added to table
+**/
+STATIC
+VOID
+AddToDeviceTable (
+  SBDF_TABLE *Table,
+  SBDF       Sbdf
+  )
+{
+  if (Table->Count < MAX_SBDF_TABLE_SIZE) {
+    Table->Entry[Table->Count++] = Sbdf;
+  } else {
+    ASSERT (FALSE);
+  }
+}
+
+/**
+  Remove device entry from a list and clear its bus assignment
+
+  @param[in,out] Table    array of devices
+**/
+STATIC
+VOID
+ClearBusFromTable (
+  SBDF_TABLE *Table
+  )
+{
+  while (Table->Count > 0) {
+    PciSegmentWrite32 (SbdfToBase (Table->Entry[Table->Count - 1]) + PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, 0);
+    Table->Count--;
+  }
+}
+
+/**
+  Attempts to assign secondary and subordinate bus numbers to uninitialized bridges in PCIe tree
+  If the device is a bridge and already has bus numbers assigned, they won't be changed
+  Otherwise new bus number will be assigned below this bridge.
+  This function can be called from SMM, where BIOS must not modify bus numbers to prevent
+  conflict with OS enumerator. To prevent this, this function returns list of bridges whose
+  bus numbers were changed. All devices from that list must have buses cleared afterwards.
+
+  @param[in] Sbdf                segment:bus:device:function coordinates of device to be added to table
+  @param[in] MinBus              minimum Bus number that can be assigned below this port
+  @param[in] MaxBus              maximum Bus number that can be assigned below this port
+  @param[in] BridgeCleanupList   list of bridges where bus numbers were modified
+
+  @retval    maximum bus number assigned anywhere below this device
+**/
+STATIC
+UINT8
+RecursiveBusAssignment (
+  SBDF       Sbdf,
+  UINT8      MinBus,
+  UINT8      MaxBus,
+  SBDF_TABLE *BridgeCleanupList
+  )
+{
+  UINT64  Base;
+  SBDF    ChildSbdf;
+  PCI_DEV_TYPE DevType;
+  UINT32  Data32;
+  UINT8   BelowBus;
+  UINT8   SecondaryBus;
+  UINT8   SubordinateBus;
+
+  ChildSbdf.Seg = Sbdf.Seg;
+  InitChildFinder (&ChildSbdf);
+  Base = SbdfToBase (Sbdf);
+
+  //
+  // On way down:
+  //   assign secondary bus, then increase it by one before stepping down; temporarily assign max subordinate bus
+  // On way up:
+  //   fix subordinate bus assignment to equal max bus number assigned anywhere below; return that number
+  //
+  DevType = GetDeviceType (Sbdf);
+  if ((Sbdf.Bus >= MaxBus) || (DevType == DevTypePcieEndpoint) || (DevType == DevTypePci)) {
+    return (UINT8) Sbdf.Bus;
+  } else  {
+    Data32 = PciSegmentRead32 (Base + PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET);
+    SecondaryBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SCBN) >> 8);
+    SubordinateBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SBBN) >> 16);
+    if (SecondaryBus != 0) {
+      ChildSbdf.Bus = SecondaryBus;
+      MinBus = SecondaryBus + 1;
+      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentP %x:%x:%x -> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus, MinBus, SubordinateBus));
+      while (FindNextPcieChild (DevType, &ChildSbdf)) {
+        BelowBus = RecursiveBusAssignment (ChildSbdf, MinBus, SubordinateBus, BridgeCleanupList);
+        MinBus = BelowBus + 1;
+      }
+      return SubordinateBus;
+    } else {
+      Data32 = Sbdf.Bus + (MinBus << 8) + (MaxBus << 16);
+      PciSegmentWrite32(Base + PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, Data32);
+      AddToDeviceTable (BridgeCleanupList, Sbdf);
+      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentE %x:%x:%x -> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus, MinBus, MaxBus));
+      BelowBus = MinBus;
+      ChildSbdf.Bus = MinBus;
+      MinBus++;
+      while (FindNextPcieChild (DevType, &ChildSbdf)) {
+        BelowBus = RecursiveBusAssignment (ChildSbdf, MinBus, MaxBus, BridgeCleanupList);
+        MinBus = BelowBus + 1;
+      }
+      Data32  &= ~B_PCI_BRIDGE_BNUM_SBBN;
+      Data32 |= (BelowBus << 16);
+      PciSegmentWrite32 (Base + PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, Data32);
+      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentL %x:%x:%x -> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus, (Data32&0xFF00)>>8, BelowBus));
+      return BelowBus;
+    }
+  }
+}
+
+/**
+  Enables L0s and/or L1 for PCIE links in the hierarchy below
+  L0s/L1 can be enabled when both sides of a link support it and link latency is smaller than acceptable latency
+  ASPM of a given link is independend from any other link (except 1ms L1 adjustment, read below), so it's possible to
+  have a hierarchy when RP link has no ASPM but links below do.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] Depth                          How many links there are between this port and root complex
+  @param[in] Override                       Pch Pcie devices OverrideTable
+
+  @retval structure that describes acceptable latencies of all endpoints below plus ASPM parameters of last link
+**/
+STATIC
+ASPM_CAPS
+RecursiveAspmConfiguration (
+  SBDF           Sbdf,
+  UINT8          Depth,
+  OVERRIDE_TABLE *Override
+  )
+{
+  SBDF         ChildSbdf;
+  ASPM_CAPS    MyAspm;
+  ASPM_CAPS    ChildAspm;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveAspmConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  //
+  // On way down:
+  //   pass number of links traversed; increase it per upstream port visited (not endpoint)
+  // On way up:
+  //   EndPoint: read Acceptable Latencies; subtract Depth From L1AcceptableLat to account for "1us per switch additional delay"
+  //   Downstreamport: AND L0s/L1 caps; calculate LinkLatency; enable L0s/L1 if supported and if acceptable latency is bigger than link latency;
+  //     if L1 not enabled, add back 1us to Acceptable Latency to cancel earlier Depth subtraction
+  //   UpstreamPort: calculate minimum of below Acceptable Latencies; return that, with upper link's Latency and L0s/L1 support
+  //
+  DevType = GetDeviceType(Sbdf);
+  if (DevType == DevTypePcieUpstream) {
+    Depth++;
+  }
+  MyAspm = GetAspmCaps (Sbdf);
+  //
+  // Get ASPM L0s and L1 override
+  //
+  if (Override != NULL) {
+    GetOverrideAspm (Sbdf, &MyAspm, Override);
+  }
+  if (DevType == DevTypePcieEndpoint) {
+    //
+    // Every switch between endpoint and CPU introduces 1us additional latency on L1 exit. This is reflected by
+    // subtracting 1us per switch from endpoint's acceptable L1 latency.
+    // In case L1 doesn't get enabled in one of switches, that 1us will be added back.
+    // This calculation is not precise. It ignores that some switches' added delay may be shadowed by
+    // other links' exit latency. But it guarantees that acceptable latency won't be exceeded and is simple
+    // enough to perform in a single iteration without backtracking.
+    //
+    return PatchL1AcceptableLatency (MyAspm, (-1 * Depth));
+  }
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      ChildAspm = RecursiveAspmConfiguration (ChildSbdf, Depth, Override);
+      MyAspm = CombineAspm (MyAspm, ChildAspm, (DevType == DevTypePcieDownstream));
+    }
+    if (DevType == DevTypePcieDownstream) {
+      SetAspm (Sbdf, MyAspm);
+      //
+      // ASPM config must be consistent across all functions of a device. That's why there's while loop.
+      //
+      while (FindNextPcieChild (DevType, &ChildSbdf)) {
+        SetAspm (ChildSbdf, MyAspm);
+      }
+      if (!IsL1Allowed (MyAspm)) {
+        MyAspm = PatchL1AcceptableLatency (MyAspm, 1);
+      }
+    }
+  }
+  return MyAspm;
+}
+
+/**
+  Enables L1 substates for PCIE links in the hierarchy below
+  L1.1 / L1.2 can be enabled if both sides of a link support it.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+
+  @retval  structure that describes L1ss capabilities of the device
+**/
+STATIC
+L1SS_CAPS
+RecursiveL1ssConfiguration (
+  SBDF           Sbdf,
+  OVERRIDE_TABLE *Override
+  )
+{
+  UINT64  Base;
+  SBDF    ChildSbdf;
+  L1SS_CAPS CombinedCaps;
+  L1SS_CAPS ChildCaps;
+  PCI_DEV_TYPE DevType;
+  BOOLEAN   IsCpuPcie;
+  UINT32    DevNum;
+
+  IsCpuPcie = FALSE;
+
+  DEBUG ((DEBUG_INFO, "RecursiveL1ssConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  Base = SbdfToBase (Sbdf);
+  DevNum = Sbdf.Dev;
+  if (DevNum == SA_PEG0_DEV_NUM || DevNum == SA_PEG3_DEV_NUM) {
+    IsCpuPcie = TRUE;
+  }
+  //
+  // On way down:
+  //   do nothing
+  // On way up:
+  //   In downstream ports, combine L1ss capabilities of that port and device behind it, then enable L1.1 and/or L1.2 if possible
+  //   Return L1ss capabilities
+  //
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      ChildCaps = RecursiveL1ssConfiguration (ChildSbdf, Override);
+      if (DevType == DevTypePcieDownstream && ChildSbdf.Func == 0) {
+        CombinedCaps = CombineL1ss (GetL1ssCaps (Base, Override), ChildCaps);
+        SetL1ss (Sbdf, CombinedCaps, Override, IsCpuPcie);
+        SetL1ss (ChildSbdf, CombinedCaps, Override, IsCpuPcie);
+      }
+    }
+  }
+  return GetL1ssCaps (Base, Override);
+}
+
+/**
+  Checks if there is an IoAPIC device in the PCIe hierarchy.
+  If one is found, this function doesn't check for more and returns
+
+  @param[in] BusLimit                       maximum Bus number that can be assigned below this port
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+
+  @retval  TRUE if IoAPIC device was found
+**/
+STATIC
+BOOLEAN
+RecursiveIoApicCheck (
+  SBDF       Sbdf
+  )
+{
+  SBDF         ChildSbdf;
+  UINT8        IoApicPresent;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveIoApicCheck %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  IoApicPresent = FALSE;
+
+  if (IsIoApicDevice (SbdfToBase (Sbdf))) {
+    DEBUG ((DEBUG_INFO, "IoApicFound @%x:%x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+    return TRUE;
+  }
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      IoApicPresent = RecursiveIoApicCheck (ChildSbdf);
+      if (IoApicPresent) {
+        break;
+      }
+    }
+  }
+  DEBUG ((DEBUG_INFO, "IoApic status %d @%x:%x:%x:%x\n", IoApicPresent, Sbdf.Seg, Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+  return IoApicPresent;
+}
+
+/**
+  Calculates Maximum Payload Size supported by PCIe hierarchy.
+  Starting from a device, it finds the minimum MPS supported by devices below it.
+  There are many valid strategies for setting MPS. This implementation chooses
+  one that is safest, but doesn't guarantee maximum performance:
+    Find minimum MPS under given rootport, then program that minimum value everywhere below that rootport
+
+  @param[in] BusLimit                       maximum Bus number that can be assigned below this port
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+
+  @retval  MPS supported by PCIe hierarchy, calculated as MIN(MPS of all devices below)
+**/
+STATIC
+UINT8
+RecursiveMpsCheck (
+  SBDF       Sbdf
+  )
+{
+  SBDF         ChildSbdf;
+  UINT8        MyMps;
+  UINT8        SubtreeMps;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveMpsCheck %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  MyMps = GetMps (Sbdf);
+  if (MyMps == 0) {
+    return MyMps;
+  }
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      SubtreeMps = RecursiveMpsCheck (ChildSbdf);
+      MyMps = MIN(MyMps, SubtreeMps);
+    }
+  }
+  return MyMps;
+}
+
+/**
+  Sets Maximum Payload Size in PCIe hierarchy.
+  Starting from a device, it programs the same MPS value to it and all devices below it.
+  There are many valid strategies for setting MPS. This implementation chooses
+  one that is safest, but doesn't guarantee maximum performance:
+    Find minimum MPS under given rootport, then program that minimum value everywhere below that rootport
+
+  @param[in] BusLimit                       maximum Bus number that can be assigned below this port
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] Mps                            Maximum Payload Size to be programmed
+**/
+STATIC
+VOID
+RecursiveMpsConfiguration (
+  SBDF       Sbdf,
+  UINT8      Mps
+  )
+{
+  SBDF    ChildSbdf;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveMpsConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      RecursiveMpsConfiguration (ChildSbdf, Mps);
+    }
+  }
+  SetMps (Sbdf, Mps);
+}
+
+/**
+  Sets Enable Clock Power Management bit for devices that support it.
+  A device supports CPM only if all function of this device report CPM support.
+  Downstream ports never report CPM capability, so it's only relevant for upstream ports.
+  When this function executes on upstream component, it will check CPM & set ECPM of downstream component
+  When this function executes on downstream component, all devices below it are guaranteed to
+  return CPM=0 so it will do nothing
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+
+  @retval TRUE = this device supports CPM, FALSE = it doesn't
+**/
+STATIC
+BOOLEAN
+RecursiveCpmConfiguration (
+  SBDF       Sbdf
+  )
+{
+  SBDF         ChildSbdf;
+  BOOLEAN      ChildCpm;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveCpmConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  ChildCpm = FALSE;
+
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    ChildCpm = TRUE;
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      ChildCpm &= RecursiveCpmConfiguration (ChildSbdf);
+    }
+    if (ChildCpm) {
+      while (FindNextPcieChild (DevType, &ChildSbdf)) {
+        EnableCpm (ChildSbdf);
+      }
+    }
+  }
+  return IsCpmSupported (Sbdf);
+}
+
+/**
+  Sets Common Clock Configuration bit for devices that share common clock across link
+  Devices on both sides of a PCIE link share common clock if both upstream component
+  and function 0 of downstream component report Slot Clock Configuration bit = 1.
+  When this function executes on upstream component, it checks SCC of both sides of the link
+  If they both support it, sets CCC for both sides (this means all functions of downstream component)
+  When this function executes on downstream component, it only returns SCC capability
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] WaitForRetrain                 decides if this function should busy-wait for link retrain
+
+  @retval TRUE = this device supports SCC, FALSE = it doesn't
+**/
+STATIC
+BOOLEAN
+RecursiveCccConfiguration (
+  SBDF       Sbdf,
+  BOOLEAN    WaitForRetrain
+  )
+{
+  UINT64       Base;
+  SBDF         ChildSbdf;
+  BOOLEAN      MyScc;
+  BOOLEAN      ChildScc;
+  BOOLEAN      LinkScc;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveCccConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  ChildScc = 0;
+  Base = SbdfToBase(Sbdf);
+  MyScc = GetScc (SbdfToBase(Sbdf), (UINT8)Sbdf.PcieCap);
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      ChildScc |= RecursiveCccConfiguration (ChildSbdf, WaitForRetrain);
+    }
+    if (DevType == DevTypePcieDownstream) {
+      LinkScc = MyScc & ChildScc;
+      if (LinkScc) {
+        EnableCcc (SbdfToBase(Sbdf), (UINT8)Sbdf.PcieCap);
+        while (FindNextPcieChild (DevType, &ChildSbdf)) {
+          EnableCcc (SbdfToBase(ChildSbdf), (UINT8)ChildSbdf.PcieCap);
+        }
+        RetrainLink(Base, (UINT8)Sbdf.PcieCap, WaitForRetrain);
+      }
+    }
+  }
+  return MyScc;
+}
+
+/**
+  Configures Latency Tolerance Reporting in given device and in PCIe tree below it.
+  This function configures Maximum LTR and enables LTR mechanism. It visits devices using depth-first search
+  and skips branches behind devices which do not support LTR.
+  Maximum LTR:
+    This function will set LTR's upper bound for every visited device. Max LTR value is provided as a parameter
+  Enable LTR:
+    LTR should be enabled top-to-bottom in every visited device that supports LTR. This function does not
+    iterate down behind devices with no LTR support. In effect, LTR will be enabled in given device if that device
+    and all devices above it on the way to RootComplex do support LTR.
+
+  This function expects that bridges have bus numbers already configured
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] LtrLimit                       Ltr to be programmed to every endpoint
+
+  @retval MaxLTR programmed in this device
+**/
+STATIC
+VOID
+RecursiveLtrConfiguration (
+  SBDF       Sbdf,
+  LTR_LIMIT  LtrLimit
+  )
+{
+  UINT64  Base;
+  SBDF    ChildSbdf;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveLtrConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  Base = SbdfToBase(Sbdf);
+
+  if (!IsLtrCapable (Sbdf)) {
+    DEBUG ((DEBUG_INFO, "Not LtrCapable %02x:%02x:%02x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+    return;
+  }
+  EnableLtr (Sbdf);
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      RecursiveLtrConfiguration (ChildSbdf, LtrLimit);
+    }
+  }
+  SetLtrLimit (Base, LtrLimit);
+}
+
+/**
+  Checks to see device is PTM Capable
+
+  @param[in] Sbdf    device's segment:bus:device:function coordinates
+
+  @retval TRUE = PTM Capability found, FALSE = Not PTM capable
+**/
+STATIC
+BOOLEAN
+IsPtmCapable (
+  SBDF       Sbdf
+  )
+{
+  UINT16     CapHeaderOffset;
+
+  CapHeaderOffset = PcieFindExtendedCapId ((UINT8) Sbdf.Seg, (UINT8) Sbdf.Bus, (UINT8) Sbdf.Dev, (UINT8) Sbdf.Func, V_PCIE_EX_PTM_CID);
+
+  return (CapHeaderOffset != 0);
+}
+
+/**
+  Get PTM Capability register from PCIe Extended Capability Space.
+
+  @param[in] Sbdf                device's segment:bus:device:function coordinates
+  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
+
+  @retval LocalPtm       Returns PTM Capability.
+                         If Device is not PTM capable then PTM Capability is zeroed out.
+**/
+STATIC
+PTM_CAPS
+GetPtmCapability (
+  SBDF      Sbdf,
+  UINT16    PtmCapHeaderOffset
+  )
+{
+  PTM_CAPS PtmCaps;
+
+  PtmCaps.Uint32 = 0;
+
+  if (PtmCapHeaderOffset != 0) {
+    PtmCaps.Uint32 = PciSegmentRead32 (SbdfToBase (Sbdf) + PtmCapHeaderOffset + R_PCIE_EX_PTMCAP_OFFSET);
+  }
+
+  return PtmCaps;
+}
+
+/**
+  Get PTM Control register from PCIe Extended Capability Space.
+
+  @param[in] Sbdf                device's segment:bus:device:function coordinates
+  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
+
+  @retval LocalPtm       Returns PTM Control.
+                         If Device is not PTM capable then PTM Control is zeroed out.
+**/
+STATIC
+PTM_CTRL
+GetPtmControl (
+  SBDF      Sbdf,
+  UINT16    PtmCapHeaderOffset
+  )
+{
+  PTM_CTRL PtmCtrl;
+
+  PtmCtrl.Uint32 = 0;
+
+  if (PtmCapHeaderOffset != 0) {
+    PtmCtrl.Uint32 = PciSegmentRead32 (SbdfToBase (Sbdf) + PtmCapHeaderOffset + R_PCIE_EX_PTMCTL_OFFSET);
+  }
+
+  return PtmCtrl;
+}
+
+/**
+  Set PTM Control register in the PCIe Extended Capability Space.
+
+  @param[in] Sbdf                device's segment:bus:device:function coordinates
+  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
+  @param[in] PtmCtrl             PTM Control Register
+**/
+STATIC
+VOID
+SetPtmControl (
+  SBDF      Sbdf,
+  UINT16    PtmCapHeaderOffset,
+  PTM_CTRL  PtmCtrl
+  )
+{
+  if (PtmCapHeaderOffset != 0) {
+    PciSegmentWrite32 (SbdfToBase (Sbdf) + PtmCapHeaderOffset + R_PCIE_EX_PTMCTL_OFFSET, PtmCtrl.Uint32);
+  }
+}
+
+/**
+  Enable PTM on device's control register. Set the Effective Clock Granularity.
+
+  @param[in]     Sbdf                 device's segment:bus:device:function coordinates
+  @param[in out] EffectiveGranularity Effective Clock Granularity of the PTM hierarchy
+  @param[in out] PtmHierarchy         Indicates if the current device is within a PTM hierarchy
+**/
+STATIC
+VOID
+SetPtm (
+  IN     SBDF       Sbdf,
+  IN OUT UINT8      *EffectiveGranularity,
+  IN OUT BOOLEAN    *PtmHierarchy
+  )
+{
+  PTM_CTRL CurrentPtmCtrl;
+  PTM_CAPS CurrentPtmCaps;
+  PTM_CTRL OrigPtmCtrl;
+  UINT16   PtmCapHeaderOffset;
+
+  PtmCapHeaderOffset = PcieFindExtendedCapId ((UINT8) Sbdf.Seg, (UINT8) Sbdf.Bus, (UINT8) Sbdf.Dev, (UINT8) Sbdf.Func, V_PCIE_EX_PTM_CID);
+  CurrentPtmCtrl = GetPtmControl (Sbdf, PtmCapHeaderOffset);
+  CurrentPtmCaps = GetPtmCapability (Sbdf, PtmCapHeaderOffset);
+
+  OrigPtmCtrl.Uint32 = CurrentPtmCtrl.Uint32;
+
+  if ( (*PtmHierarchy == FALSE) && CurrentPtmCaps.Bits.RootCapable) {
+    // Select device as PTM Root if PTM Root is not selected.
+    CurrentPtmCtrl.Bits.RootSelect = TRUE;
+    *EffectiveGranularity = (UINT8) CurrentPtmCaps.Bits.LocalClockGranularity;
+    *PtmHierarchy = TRUE;
+  }
+
+  if (*PtmHierarchy == TRUE) {
+    // Enable PTM if device is part of a ptm hierarchy
+    CurrentPtmCtrl.Bits.Enable = TRUE;
+
+    if (CurrentPtmCaps.Bits.RequesterCapable) {
+      // Set Effective Granularity if PTM device is Requester roles.
+      CurrentPtmCtrl.Bits.EffectiveGranularity = *EffectiveGranularity;
+    }
+  }
+
+  if (OrigPtmCtrl.Uint32 != CurrentPtmCtrl.Uint32) {
+    SetPtmControl (Sbdf, PtmCapHeaderOffset, CurrentPtmCtrl);
+  }
+
+  // Update EffectiveGranularity.
+  // Set to zero if 1 or more switches between the root and endpoint report local granularity = 0.
+  // Otherwise set to the max local granularity of the hierarchy.
+  if ( ((CurrentPtmCaps.Bits.LocalClockGranularity == 0) && CurrentPtmCaps.Bits.RequesterCapable) ||
+       (*EffectiveGranularity  == 0) ) {
+    *EffectiveGranularity = 0;
+  } else {
+    *EffectiveGranularity = MAX (*EffectiveGranularity, (UINT8) CurrentPtmCaps.Bits.LocalClockGranularity);
+  }
+}
+
+/**
+  Configures PTM hierarchies by searching for Endpoints and Upstream Switches
+  that are PTM capable. Each PTM device role is identified and configured accordingly.
+  PTM root capable devices are selected as PTM root if the device is not already in a
+  PTM hierarchy.
+  PTM capable Root Ports must be configured before calling this function.
+  @note: This function has not been tested with switches.
+
+  @param[in] Sbdf                 Address of curretly visited Pcie device
+  @param[in] EffectiveGranularity The largest Clock Granularity from Upstream Devices
+  @param[in] PtmHierarchy         TRUE = Device in a PTM Hierarchy, FALSE = Not in PTM Hierarchy
+**/
+STATIC
+VOID
+RecursivePtmConfiguration (
+  SBDF          Sbdf,
+  UINT8         EffectiveGranularity,
+  BOOLEAN       PtmHierarchy
+  )
+{
+  SBDF         ChildSbdf;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursivePtmConfiguration %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  DevType = GetDeviceType (Sbdf);
+
+  if (IsPtmCapable (Sbdf)) {
+    //
+    // Enable PTM for PTM Capable devices (Endpoints, Upstream Switch, and Root Ports).
+    // @Note: Switches have not been tested.
+    //
+    SetPtm (Sbdf, &EffectiveGranularity, &PtmHierarchy);
+  } else if (!IsPtmCapable (Sbdf) && (DevType == DevTypePcieUpstream) ) {
+    //
+    // Non-PTM UpStream Switch Ports breaks the PTM Hierarchy.
+    // No other downstream PTM devices should be PTM enabled until a PTM Root capable device is selected.
+    //
+    PtmHierarchy = FALSE;
+    EffectiveGranularity = 0;
+  }
+
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      RecursivePtmConfiguration (ChildSbdf, EffectiveGranularity, PtmHierarchy);
+    }
+  }
+}
+
+/**
+  Initializes the following features in rootport and devices behind it:
+  Maximum Payload Size (generic)
+  Rootport packet split (proprietary)
+  EonOfInterrupt forwarding (proprietary)
+  Common Clock Configuration (generic)
+
+  Generic: any code written according to PCIE Express base specification can do that.
+  Proprietary: code uses registers and features that are specific to Intel silicon
+  and probably only this Reference Code knows how to handle that.
+
+  If OEM implemented generic feature enabling in his platform code or trusts Operating System
+  to do it, then those features can be deleted from here.
+
+  CCC requires link retrain, which takes a while. CCC must happen before L0s/L1 programming.
+  If there was guarantee no code would access PCI while links retrain, it would be possible to skip this waiting
+
+  @param[in] RpSegment  address of rootport on PCIe
+  @param[in] RpBus      address of rootport on PCIe
+  @param[in] RpDevice   address of rootport on PCIe
+  @param[in] RpFunction address of rootport on PCIe
+  @param[in] BusMin     minimum Bus number that can be assigned below this rootport
+  @param[in] BusMax     maximum Bus number that can be assigned below this rootport
+**/
+VOID
+RootportDownstreamConfiguration (
+  UINT8                     RpSegment,
+  UINT8                     RpBus,
+  UINT8                     RpDevice,
+  UINT8                     RpFunction,
+  UINT8                     BusMin,
+  UINT8                     BusMax,
+  PCI_SKU                   PciSku
+  )
+{
+  UINT8           Mps;
+  BOOLEAN         IoApicPresent;
+  UINT64          RpBase;
+  SBDF            RpSbdf;
+  SBDF_TABLE      BridgeCleanupList;
+
+  IoApicPresent = FALSE;
+  RpBase = PCI_SEGMENT_LIB_ADDRESS (RpSegment, RpBus, RpDevice, RpFunction, 0);
+  if (!(IsDevicePresent (RpBase))) {
+    return;
+  }
+  RpSbdf.Seg = RpSegment;
+  RpSbdf.Bus = RpBus;
+  RpSbdf.Dev = RpDevice;
+  RpSbdf.Func = RpFunction;
+  RpSbdf.PcieCap = PcieBaseFindCapId (RpBase, EFI_PCI_CAPABILITY_ID_PCIEXP);
+
+  DEBUG ((DEBUG_INFO, "RootportDownstreamConfiguration %x:%x\n", RpDevice, RpFunction));
+  BridgeCleanupList.Count = 0;
+  RecursiveBusAssignment (RpSbdf, BusMin, BusMax, &BridgeCleanupList);
+
+  Mps = RecursiveMpsCheck (RpSbdf);
+  RecursiveMpsConfiguration (RpSbdf, Mps);
+  if (PciSku == EnumPchPcie) {
+    RpBase = SbdfToBase (RpSbdf);
+    ConfigureRpPacketSplit(RpBase, Mps);
+    IoApicPresent = RecursiveIoApicCheck(RpSbdf);
+  }
+  if ((PciSku == EnumPchPcie) || (PciSku == EnumCpuPcie)) {
+    ConfigureEoiForwarding (RpBase, IoApicPresent);
+  }
+  RecursiveCccConfiguration (RpSbdf, TRUE);
+
+  if (IsPtmCapable (RpSbdf)) {
+    RecursivePtmConfiguration (RpSbdf, 0, FALSE);
+  }
+
+  ClearBusFromTable (&BridgeCleanupList);
+}
+
+/**
+  Checks if given PCI device is capable of Latency Tolerance Reporting
+
+  @param[in] Sbdf            device's segment:bus:device:function coordinates
+
+  @retval TRUE if yes
+**/
+BOOLEAN
+IsLtrCapable (
+  SBDF Sbdf
+  )
+{
+  if (Sbdf.PcieCap == 0) {
+    return FALSE;
+  }
+  return !!(PciSegmentRead32 (SbdfToBase (Sbdf) + Sbdf.PcieCap + R_PCIE_DCAP2_OFFSET) & B_PCIE_DCAP2_LTRMS);
+}
+
+/**
+  Returns combination of two LTR override values
+  The resulting LTR override separately chooses stricter limits for snoop and nosnoop
+
+  @param[in] LtrA      LTR override values to be combined
+  @param[in] LtrB      LTR override values to be combined
+
+  @retval LTR override value
+**/
+LTR_OVERRIDE
+CombineLtr (
+  LTR_OVERRIDE LtrA,
+  LTR_OVERRIDE LtrB
+  )
+{
+  UINT64        DecodedLatencyA;
+  UINT64        DecodedLatencyB;
+  LTR_OVERRIDE  Result;
+  static UINT32 ScaleEncoding [8] = {1, 32, 1024, 32768, 1048576, 33554432, 0, 0};
+
+  ZeroMem (&Result, sizeof (LTR_OVERRIDE));
+  DecodedLatencyA = ScaleEncoding[LtrA.MaxSnoopLatencyScale] * LtrA.MaxSnoopLatencyValue;
+  DecodedLatencyB = ScaleEncoding[LtrB.MaxSnoopLatencyScale] * LtrB.MaxSnoopLatencyValue;
+  if ((!LtrB.MaxSnoopLatencyRequirement) || ((DecodedLatencyA < DecodedLatencyB) && LtrA.MaxSnoopLatencyRequirement)) {
+    Result.MaxSnoopLatencyValue       = LtrA.MaxSnoopLatencyValue;
+    Result.MaxSnoopLatencyScale       = LtrA.MaxSnoopLatencyScale;
+    Result.MaxSnoopLatencyRequirement = LtrA.MaxSnoopLatencyRequirement;
+  } else {
+    Result.MaxSnoopLatencyValue       = LtrB.MaxSnoopLatencyValue;
+    Result.MaxSnoopLatencyScale       = LtrB.MaxSnoopLatencyScale;
+    Result.MaxSnoopLatencyRequirement = LtrB.MaxSnoopLatencyRequirement;
+  }
+  DecodedLatencyA = ScaleEncoding[LtrA.MaxNoSnoopLatencyScale] * LtrA.MaxNoSnoopLatencyValue;
+  DecodedLatencyB = ScaleEncoding[LtrB.MaxNoSnoopLatencyScale] * LtrB.MaxNoSnoopLatencyValue;
+  if ((!LtrB.MaxNoSnoopLatencyRequirement) || ((DecodedLatencyA < DecodedLatencyB) && LtrA.MaxNoSnoopLatencyRequirement)) {
+    Result.MaxNoSnoopLatencyValue       = LtrA.MaxNoSnoopLatencyValue;
+    Result.MaxNoSnoopLatencyScale       = LtrA.MaxNoSnoopLatencyScale;
+    Result.MaxNoSnoopLatencyRequirement = LtrA.MaxNoSnoopLatencyRequirement;
+  } else {
+    Result.MaxNoSnoopLatencyValue       = LtrB.MaxNoSnoopLatencyValue;
+    Result.MaxNoSnoopLatencyScale       = LtrB.MaxNoSnoopLatencyScale;
+    Result.MaxNoSnoopLatencyRequirement = LtrB.MaxNoSnoopLatencyRequirement;
+  }
+  if (LtrA.ForceOverride || LtrB.ForceOverride) {
+    Result.ForceOverride = TRUE;
+  }
+  DEBUG ((DEBUG_INFO, "CombineLtr: A(V%d S%d E%d : V%d S%d E%d, F%d)\n",
+    LtrA.MaxSnoopLatencyValue, LtrA.MaxSnoopLatencyScale, LtrA.MaxSnoopLatencyRequirement,
+    LtrA.MaxNoSnoopLatencyValue, LtrA.MaxNoSnoopLatencyScale, LtrA.MaxNoSnoopLatencyRequirement,
+    LtrA.ForceOverride
+    ));
+  DEBUG ((DEBUG_INFO, "          : B(V%d S%d E%d : V%d S%d E%d, F%d)\n",
+    LtrB.MaxSnoopLatencyValue, LtrB.MaxSnoopLatencyScale, LtrB.MaxSnoopLatencyRequirement,
+    LtrB.MaxNoSnoopLatencyValue, LtrB.MaxNoSnoopLatencyScale, LtrB.MaxNoSnoopLatencyRequirement,
+    LtrB.ForceOverride
+    ));
+  DEBUG ((DEBUG_INFO, "          : R(V%d S%d E%d : V%d S%d E%d, F%d)\n",
+    Result.MaxSnoopLatencyValue, Result.MaxSnoopLatencyScale, Result.MaxSnoopLatencyRequirement,
+    Result.MaxNoSnoopLatencyValue, Result.MaxNoSnoopLatencyScale, Result.MaxNoSnoopLatencyRequirement,
+    Result.ForceOverride
+    ));
+  return Result;
+}
+
+/**
+  Returns LTR override value for given device
+  The value is extracted from Device Override table. If the device is not found,
+  the returned value will have Requirement bits clear
+
+  @param[in] Base            device's base address
+  @param[in] Override        device override table
+
+  @retval LTR override value
+**/
+LTR_OVERRIDE
+GetOverrideLtr (
+  UINT64         Base,
+  OVERRIDE_TABLE *Override
+  )
+{
+  UINT16       DevId;
+  UINT16       VenId;
+  UINT16       RevId;
+  UINT32       Index;
+  LTR_OVERRIDE ReturnValue = {0};
+
+  VenId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
+  DevId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
+  RevId = PciSegmentRead16 (Base + PCI_REVISION_ID_OFFSET);
+
+  for (Index = 0; Index < Override->Size; Index++) {
+    if (((Override->Table[Index].OverrideConfig & PchPcieLtrOverride) == PchPcieLtrOverride) &&
+        (Override->Table[Index].VendorId == VenId) &&
+        ((Override->Table[Index].DeviceId == DevId) || (Override->Table[Index].DeviceId == 0xFFFF)) &&
+        ((Override->Table[Index].RevId == RevId) || (Override->Table[Index].RevId == 0xFF))) {
+      if (Override->Table[Index].SnoopLatency & 0x8000) {
+        ReturnValue.MaxSnoopLatencyRequirement = 1;
+        ReturnValue.MaxSnoopLatencyValue = Override->Table[Index].SnoopLatency & 0x3FF;
+        ReturnValue.MaxSnoopLatencyScale = (Override->Table[Index].SnoopLatency & 0x1C00) >> 10;
+      }
+      if (Override->Table[Index].NonSnoopLatency & 0x8000) {
+        ReturnValue.MaxNoSnoopLatencyRequirement = 1;
+        ReturnValue.MaxNoSnoopLatencyValue = Override->Table[Index].NonSnoopLatency & 0x3FF;
+        ReturnValue.MaxNoSnoopLatencyScale = (Override->Table[Index].NonSnoopLatency & 0x1C00) >> 10;
+      }
+      ReturnValue.ForceOverride = Override->Table[Index].ForceLtrOverride;
+      break;
+    }
+  }
+  return ReturnValue;
+}
+
+/**
+  In accordance with PCIe spec, devices with no LTR support are considered to have no LTR requirements
+  which means infinite latency tolerance. This was found to cause problems with HID and Audio devices without LTR
+  support placed behind PCIe switches with LTR support, as Switch's upstream link would be allowed to enter L1.2
+  and cause large latency downstream. To work around such issues and to fix some devices with broken
+  LTR reporting, Device Override table was introduced.
+  This function scans PCIe tree for devices mentioned in override table and calculates the strictest
+  LTR requirement between them. That value will be programmed into rootport's LTR override register
+
+  This function expects that bridges have bus numbers already configured
+
+  @param[in] BusLimit                       maximum Bus number that can be assigned below this port
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] AspmOverride                   Device specific ASPM policy override items
+
+  @retval MaxLTR programmed in this device
+**/
+LTR_OVERRIDE
+RecursiveLtrOverrideCheck (
+  SBDF           Sbdf,
+  OVERRIDE_TABLE *AspmOverride
+  )
+{
+  UINT64       Base;
+  SBDF         ChildSbdf;
+  LTR_OVERRIDE MyLtrOverride;
+  LTR_OVERRIDE ChildLtr;
+  PCI_DEV_TYPE DevType;
+
+  DEBUG ((DEBUG_INFO, "RecursiveLtrOverrideCheck %x:%x:%x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
+
+  Base = SbdfToBase(Sbdf);
+
+  MyLtrOverride = GetOverrideLtr (Base, AspmOverride);
+  if (HasChildBus (Sbdf, &ChildSbdf)) {
+    DevType = GetDeviceType (Sbdf);
+    while (FindNextPcieChild (DevType, &ChildSbdf)) {
+      ChildLtr = RecursiveLtrOverrideCheck (ChildSbdf, AspmOverride);
+      MyLtrOverride = CombineLtr (MyLtrOverride, ChildLtr);
+    }
+  }
+  return MyLtrOverride;
+}
+
+/**
+  Configures the following power-management related features in rootport and devices behind it:
+  LTR limit (generic)
+  LTR override (proprietary)
+  Clock Power Management (generic)
+  L1 substates (generic except for the override table)
+  L1.LOW substate (proprietary)
+  L0s and L1 (generic)
+
+  Generic: any code written according to PCIE Express base specification can do that.
+  Proprietary: code uses registers and features that are specific to Intel silicon
+  and probably only this Reference Code knows how to handle that.
+
+  If OEM implemented generic feature enabling in his platform code or trusts Operating System
+  to do it, then those features can be deleted from here.
+
+  @param[in] RpSegment                address of rootport on PCIe
+  @param[in] RpBus                    address of rootport on PCIe
+  @param[in] RpDevice                 address of rootport on PCIe
+  @param[in] RpFunction               address of rootport on PCIe
+  @param[in] BusLimit                 maximum Bus number that can be assigned below this rootport
+  @param[in] PcieRpLtrConfig          address of LTR Policy struct
+  @param[in] PcieRpCommonConfig       address of Common PCIe Policy struct
+  @param[in] AspmOverrideTableSize    size of override array
+  @param[in] AspmOverrideTable        array of device that need exceptions in configuration
+**/
+VOID
+RootportDownstreamPmConfiguration (
+  UINT8                               RpSegment,
+  UINT8                               RpBus,
+  UINT8                               RpDevice,
+  UINT8                               RpFunction,
+  UINT8                               BusMin,
+  UINT8                               BusMax,
+  PCIE_ROOT_PORT_COMMON_CONFIG        *PcieRpCommonConfig,
+  UINT32                              AspmOverrideTableSize,
+  PCH_PCIE_DEVICE_OVERRIDE            *AspmOverrideTable
+  )
+{
+  LTR_LIMIT      PolicyLtr;
+  LTR_OVERRIDE   TreeLtr;
+  OVERRIDE_TABLE PmOverrideTable;
+  UINT64         RpBase;
+  SBDF           RpSbdf;
+  SBDF_TABLE     BridgeCleanupList;
+
+  RpBase = PCI_SEGMENT_LIB_ADDRESS (RpSegment, RpBus, RpDevice, RpFunction, 0);
+  if (!(IsDevicePresent (RpBase))) {
+    return;
+  }
+  PmOverrideTable.Size = AspmOverrideTableSize;
+  PmOverrideTable.Table = AspmOverrideTable;
+
+  DEBUG ((DEBUG_INFO, "RootportDownstreamPmConfiguration %x:%x\n", RpDevice, RpFunction));
+  PolicyLtr.MaxNoSnoopLatencyScale = (PcieRpCommonConfig->PcieRpLtrConfig.LtrMaxNoSnoopLatency & 0x1c00) >> 10;
+  PolicyLtr.MaxNoSnoopLatencyValue = PcieRpCommonConfig->PcieRpLtrConfig.LtrMaxNoSnoopLatency & 0x3FF;
+  PolicyLtr.MaxSnoopLatencyScale   = (PcieRpCommonConfig->PcieRpLtrConfig.LtrMaxSnoopLatency & 0x1c00) >> 10;
+  PolicyLtr.MaxSnoopLatencyValue   = PcieRpCommonConfig->PcieRpLtrConfig.LtrMaxSnoopLatency & 0x3FF;
+
+  RpSbdf.Seg = RpSegment;
+  RpSbdf.Bus = RpBus;
+  RpSbdf.Dev = RpDevice;
+  RpSbdf.Func = RpFunction;
+  RpSbdf.PcieCap = PcieBaseFindCapId (RpBase, EFI_PCI_CAPABILITY_ID_PCIEXP);
+  //
+  // This code could execute either before or after enumeration. If before, then buses would not yet be assigned to bridges,
+  // making devices deeper in the hierarchy inaccessible.
+  // RecursiveBusAssignment will scan whole PCie tree and assign bus numbers to uninitialized bridges, if there are any
+  // List of such bridges will be kept in CleanupList, so that after PM programming is done, bus numbers can brought to original state
+  //
+  BridgeCleanupList.Count = 0;
+  RecursiveBusAssignment(RpSbdf, BusMin, BusMax, &BridgeCleanupList);
+  //
+  // The 'Recursive...' functions below expect bus numbers to be already assigned
+  //
+  RecursiveLtrConfiguration (RpSbdf, PolicyLtr);
+  TreeLtr = RecursiveLtrOverrideCheck (RpSbdf, &PmOverrideTable);
+  ConfigureRpLtrOverride (RpBase, RpSbdf.Dev, &TreeLtr, &(PcieRpCommonConfig->PcieRpLtrConfig));
+  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride %x:%x\n", RpSbdf.Dev, RpSbdf.Func));
+  if (PcieRpCommonConfig->EnableCpm) {
+    RecursiveCpmConfiguration (RpSbdf);
+  }
+  //
+  // L1 substates can be modified only when L1 is disabled, so this function must execute
+  // before Aspm configuration which enables L1
+  //
+  RecursiveL1ssConfiguration (RpSbdf, &PmOverrideTable);
+  L1ssProprietaryConfiguration (RpBase, IsLtrCapable (RpSbdf));
+  RecursiveAspmConfiguration (RpSbdf, 0, &PmOverrideTable);
+
+  ClearBusFromTable (&BridgeCleanupList);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.h
new file mode 100644
index 0000000000..19c1051771
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PciExpressHelpersLibrary.h
@@ -0,0 +1,40 @@
+/** @file
+  Header file for Pci Express helps library implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCI_EXPRESS_HELPERS_LIBRARY_H_
+#define _PCI_EXPRESS_HELPERS_LIBRARY_H_
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/BaseLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <IndustryStandard/Pci.h>
+#include <PchPolicyCommon.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/TimerLib.h>
+#include <Library/PciExpressHelpersLib.h>
+#include <Library/PcieRpLib.h>
+#include <PcieRegs.h>
+#include <Register/CpuPcieRegs.h>
+#include <Register/PchPcieRpRegs.h>
+
+#define LTR_VALUE_MASK (BIT0 + BIT1 + BIT2 + BIT3 + BIT4 + BIT5 + BIT6 + BIT7 + BIT8 + BIT9)
+#define LTR_SCALE_MASK (BIT10 + BIT11 + BIT12)
+
+  #define CONFIG_WRITE_LOOP_COUNT   100000
+
+//
+// LTR related macros
+//
+#define LTR_LATENCY_VALUE(x)           ((x) & LTR_VALUE_MASK)
+#define LTR_SCALE_VALUE(x)             (((x) & LTR_SCALE_MASK) >> 10)
+#define LTR_LATENCY_NS(x)              (LTR_LATENCY_VALUE(x) * (1 << (5 * LTR_SCALE_VALUE(x))))
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
new file mode 100644
index 0000000000..8f673d14c2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
@@ -0,0 +1,49 @@
+## @file
+# Component description file for the PeiDxeSmmPciExpressHelpersLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+  INF_VERSION = 0x00010017
+  BASE_NAME = PeiDxeSmmPciExpressHelpersLib
+  FILE_GUID = 07E3F76D-6D26-419d-9053-58696A15B519
+  VERSION_STRING = 1.0
+  MODULE_TYPE = BASE
+LIBRARY_CLASS = PciExpressHelpersLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+
+[LibraryClasses]
+  IoLib
+  DebugLib
+  PchPcieRpLib
+  PchPcrLib
+  PchInfoLib
+  GpioLib
+  TimerLib
+  BasePcieHelperLib
+  PchPciBdfLib
+  HobLib
+  PcieRpLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  PciExpressHelpersLibrary.c
+  PciExpressHelpersLibrary.h
+
+[Guids]
+  gCpuPcieHobGuid
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.c
new file mode 100644
index 0000000000..15d295a573
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.c
@@ -0,0 +1,247 @@
+/** @file
+  This file contains routines that support PCI Express initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <IndustryStandard/Pci.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PcieHelperLib.h>
+#include <Library/PchSbiAccessLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/PcieRpLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PsfLib.h>
+#include <Library/HobLib.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/PcieSipRegs.h>
+#include <PcieRegs.h>
+#include <PchPcieRpInfo.h>
+#include <CpuPcieInfo.h>
+#include <CpuPcieHob.h>
+
+/**
+  Get PCIe port number for enabled port.
+  @param[in] RpBase    Root Port pci segment base address
+
+  @retval Root Port number (1 based)
+**/
+UINT32
+PciePortNum (
+  IN     UINT64  RpBase
+  )
+{
+  return PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LCAP) >> N_PCH_PCIE_CFG_LCAP_PN;
+}
+
+/**
+  Get PCIe root port index
+
+  @param[in] RpBase    Root Port pci segment base address
+
+  @retval Root Port index (0 based)
+**/
+UINT32
+PciePortIndex (
+  IN     UINT64  RpBase
+  )
+{
+  return PciePortNum (RpBase) - 1;
+}
+
+/**
+  This function checks whether PHY lane power gating is enabled on the port.
+
+  @param[in] RpBase                 Root Port base address
+
+  @retval TRUE                      PHY power gating is enabled
+  @retval FALSE                     PHY power gating disabled
+**/
+BOOLEAN
+PcieIsPhyLanePgEnabled (
+  IN     UINT64  RpBase
+  )
+{
+  UINT32 Data32;
+
+  Data32 = PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL);
+  return (Data32 & B_PCH_PCIE_CFG_PCIEPMECTL_DLSULPPGE) != 0;
+}
+
+/**
+  Configures Root Port packet split.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] Mps                            maximum packet size
+**/
+VOID
+ConfigureRpPacketSplit (
+  UINT64 RpBase,
+  UINT8  Mps
+  )
+{
+  PciSegmentAndThenOr32 (RpBase + R_PCIE_CFG_CCFG, (UINT32) ~(B_PCIE_CFG_CCFG_UNRS), Mps << N_PCIE_CFG_CCFG_UNRS);
+}
+
+/**
+  Configures LTR override in Root Port's proprietary registers.
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] DevNum                         currently visited device number
+  @param[in] RpConfig                       Root Port LTR configuration
+  @param[in] AspmOverride                   combination of LTR override values from all devices under this Root Port
+**/
+VOID
+ConfigureRpLtrOverride (
+  UINT64           RpBase,
+  UINT32           DevNum,
+  LTR_OVERRIDE     *TreeLtr,
+  PCIE_LTR_CONFIG  *LtrConfig
+  )
+{
+  UINT32       OvrEn;
+  UINT32       OvrVal;
+  BOOLEAN      IsCpuPcie;
+  UINT32       LtrCfgLock;
+
+  IsCpuPcie = FALSE;
+  OvrEn = 0;
+  OvrVal = 0;
+  LtrCfgLock = 0;
+
+  if (DevNum == SA_PEG0_DEV_NUM || DevNum == SA_PEG3_DEV_NUM) {
+    IsCpuPcie = TRUE;
+  }
+
+  //
+  // LTR settings from LTROVR register only get acknowledged on rising edge of LTROVR2[1:0]
+  // If those bits were already set (that can happen on a plug-hotUnplug-hotPlug scenario),
+  // they need to be toggled
+  //
+  if (PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LTROVR2) != 0) {
+    PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR2, 0);
+  }
+  //
+  // (*)LatencyOverrideMode = 0 -> no override
+  //                          1 -> override with RP policy values
+  //                          2 -> override with endpoint's override values
+  //
+
+  if (LtrConfig->ForceLtrOverride || TreeLtr->ForceOverride) {
+    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_FORCE_OVERRIDE;
+  }
+  if (LtrConfig->LtrConfigLock == TRUE) {
+    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LOCK;
+  }
+
+  if (LtrConfig->SnoopLatencyOverrideMode == 1) {
+    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN;
+    OvrVal |= LtrConfig->SnoopLatencyOverrideValue;
+    OvrVal |= LtrConfig->SnoopLatencyOverrideMultiplier << 10;
+    OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRSROVR;
+  } else if (LtrConfig->SnoopLatencyOverrideMode == 2) {
+    if (TreeLtr->MaxSnoopLatencyRequirement) {
+      OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN;
+      OvrVal |= TreeLtr->MaxSnoopLatencyValue;
+      OvrVal |= TreeLtr->MaxSnoopLatencyScale << 10;
+      OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRSROVR;
+    }
+  }
+  if (LtrConfig->NonSnoopLatencyOverrideMode == 1) {
+    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN;
+    OvrVal |= LtrConfig->NonSnoopLatencyOverrideValue << 16;
+    OvrVal |= LtrConfig->NonSnoopLatencyOverrideMultiplier << 26;
+    OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRNSROVR;
+  } else if (LtrConfig->NonSnoopLatencyOverrideMode == 2) {
+    if (TreeLtr->MaxNoSnoopLatencyRequirement) {
+      OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN;
+      OvrVal |= TreeLtr->MaxNoSnoopLatencyValue << 16;
+      OvrVal |= TreeLtr->MaxNoSnoopLatencyScale << 26;
+      OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRNSROVR;
+    }
+  }
+  PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR, OvrVal);
+  PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR2, OvrEn);
+
+  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride IsCpuPcie=%d\n", IsCpuPcie));
+  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride %x Val %x En %x\n", RpBase, OvrVal, OvrEn));
+}
+
+/**
+  This function configures EOI message forwarding for PCIe port.
+  If there's an IoAPIC behind this port, forwarding will be enabled
+  Otherwise it will be disabled to minimize bus traffic
+
+  @param[in] Segment,Bus,Device,Function    address of currently visited PCIe device
+  @param[in] IoApicPresent  TRUE if there's IoAPIC behind this Root Port
+**/
+VOID
+ConfigureEoiForwarding (
+  UINT64   RpBase,
+  BOOLEAN  IoApicPresent
+  )
+{
+  UINT32 RpIndex;
+
+  RpIndex = PciePortIndex (RpBase);
+
+  if (IoApicPresent == FALSE) {
+   PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_MPC2, B_PCH_PCIE_CFG_MPC2_EOIFD);
+  } else {
+    ///
+    /// If there is an IOAPIC discovered behind Root Port, program PSF Multicast registers
+    /// in accordance with PCH PCIe BWG  PSF EOI Multicast Configuration
+    ///
+    PciSegmentAnd32 (RpBase + R_PCH_PCIE_CFG_MPC2, (UINT32)~B_PCH_PCIE_CFG_MPC2_EOIFD);
+    PsfConfigurEoiForPciePort (RpIndex);
+  }
+}
+
+/**
+  Configures proprietary parts of L1 substates configuration in Root Port
+
+  @param[in] RpSbdf       segment:bus:device:function coordinates of Root Port
+  @param[in] LtrCapable   TRUE if Root Port is LTR capable
+**/
+VOID
+L1ssProprietaryConfiguration (
+  UINT64  RpBase,
+  BOOLEAN LtrCapable
+  )
+{
+  BOOLEAN ClkreqSupported;
+  BOOLEAN L1ssEnabled;
+  UINT16  PcieCapOffset;
+  UINT32  Data32;
+  BOOLEAN L1LowSupported;
+
+  ClkreqSupported = PcieIsPhyLanePgEnabled (RpBase);
+
+  PcieCapOffset = PcieBaseFindExtendedCapId (RpBase, V_PCIE_EX_L1S_CID);
+  if (PcieCapOffset == 0) {
+    L1ssEnabled = FALSE;
+  } else {
+    Data32 = PciSegmentRead32 (RpBase + PcieCapOffset + R_PCIE_EX_L1SCTL1_OFFSET);
+    L1ssEnabled = Data32 & (B_PCIE_EX_L1SCAP_AL1SS | B_PCIE_EX_L1SCAP_AL12S | B_PCIE_EX_L1SCAP_PPL11S |B_PCIE_EX_L1SCAP_PPL12S);
+  }
+  L1LowSupported = ClkreqSupported && LtrCapable && !L1ssEnabled;
+
+  ///
+  /// If L1.SNOOZ and L1.OFF (L1 Sub-States) are not supported and per-port CLKREQ# is supported, and LTR is supported:
+  /// Enable L1.LOW by setting Dxx:Fn:420[17] = 1b
+  ///
+  if (L1LowSupported) {
+    PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL, (UINT32) B_PCH_PCIE_CFG_PCIEPMECTL_L1LE);
+  } else {
+    PciSegmentAnd32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL, (UINT32) ~B_PCH_PCIE_CFG_PCIEPMECTL_L1LE);
+  }
+
+  if (L1LowSupported || L1ssEnabled) {
+    ///
+    /// f.  Set Dxx:Fn:420h[0] to 1b prior to L1 enabling if any L1substate is enabled (including L1.LOW)
+    ///
+    PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL, B_PCH_PCIE_CFG_PCIEPMECTL_L1FSOE);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf
new file mode 100644
index 0000000000..86dceb14ee
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf
@@ -0,0 +1,43 @@
+## @file
+# Component description file for the PcieClientRpLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+  INF_VERSION = 0x00010017
+  BASE_NAME = PcieClientRpLib
+  FILE_GUID = 77EB467D-674C-4C20-A13E-381600E182C4
+  VERSION_STRING = 1.0
+  MODULE_TYPE = BASE
+  LIBRARY_CLASS = PcieRpLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+[LibraryClasses]
+  IoLib
+  DebugLib
+  PchPcieRpLib
+  PchPcrLib
+  PchInfoLib
+  GpioLib
+  TimerLib
+  PsfLib
+  BasePcieHelperLib
+  PchPciBdfLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  PcieClientRpLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (21 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component Heng Luo
                   ` (16 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Pmc/IncludePrivate
  * IpBlock/Pmc/Library
  * IpBlock/Pmc/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcPrivateLib.h                                 | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/PmcRegsVer2.h                                  |  52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PeiDxeSmmPmcLib.inf                            |  42 ++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PmcLib.c                                       | 545 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf   |  39 +++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf |  40 ++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLib.c                  | 166 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLibWithS3.c            | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 8 files changed, 1126 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcPrivateLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcPrivateLib.h
new file mode 100644
index 0000000000..0f2f251d57
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcPrivateLib.h
@@ -0,0 +1,120 @@
+/** @file
+  Header file for private PmcLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PMC_PRIVATE_LIB_H_
+#define _PMC_PRIVATE_LIB_H_
+
+#include <Library/PmcLib.h>
+#include "Register/PmcRegs.h"
+
+/**
+  This function checks if GbE device is supported (not disabled by fuse)
+
+  @retval GbE support state
+**/
+BOOLEAN
+PmcIsGbeSupported (
+  VOID
+  );
+
+/**
+  This function checks if LAN wake from DeepSx is enabled
+
+  @retval Lan Wake state
+**/
+BOOLEAN
+PmcIsLanDeepSxWakeEnabled (
+  VOID
+  );
+
+/**
+  This function sets SMI Lock with S3 Boot Script programming
+**/
+VOID
+PmcLockSmiWithS3BootScript (
+  VOID
+  );
+
+/**
+  This function sets eSPI SMI Lock
+  @attention This function must be called after eSPI SMI generation has been enabled.
+    This setting is required in all boot modes and before EndOfDxe.
+    If set value will be restored upon S3 resume by bootscript.
+**/
+VOID
+PmcLockEspiSmiWithS3BootScript (
+  VOID
+  );
+
+/**
+  This function checks if eSPI SMI Lock is set
+
+  @retval eSPI SMI Lock state
+**/
+BOOLEAN
+PmcIsEspiSmiLockSet (
+  VOID
+  );
+
+typedef enum {
+  PmcSwSmiRate1p5ms = 0,
+  PmcSwSmiRate16ms,
+  PmcSwSmiRate32ms,
+  PmcSwSmiRate64ms
+} PMC_SWSMI_RATE;
+
+/**
+  This function sets SW SMI Rate.
+
+  @param[in] SwSmiRate        Refer to PMC_SWSMI_RATE for possible values
+**/
+VOID
+PmcSetSwSmiRate (
+  IN PMC_SWSMI_RATE          SwSmiRate
+  );
+
+typedef enum {
+  PmcPeriodicSmiRate8s = 0,
+  PmcPeriodicSmiRate16s,
+  PmcPeriodicSmiRate32s,
+  PmcPeriodicSmiRate64s
+} PMC_PERIODIC_SMI_RATE;
+
+/**
+  This function sets Periodic SMI Rate.
+
+  @param[in] PeriodicSmiRate        Refer to PMC_PERIODIC_SMI_RATE for possible values
+**/
+VOID
+PmcSetPeriodicSmiRate (
+  IN PMC_PERIODIC_SMI_RATE    PeriodicSmiRate
+  );
+
+/**
+  This function reads Power Button Level
+
+  @retval State of PWRBTN# signal (0: Low, 1: High)
+**/
+UINT8
+PmcGetPwrBtnLevel (
+  VOID
+  );
+
+/**
+  This function gets Group to GPE0 configuration
+
+  @param[out] GpeDw0Value       GPIO Group to GPE_DW0 assignment
+  @param[out] GpeDw1Value       GPIO Group to GPE_DW1 assignment
+  @param[out] GpeDw2Value       GPIO Group to GPE_DW2 assignment
+**/
+VOID
+PmcGetGpioGpe (
+  OUT UINT32    *GpeDw0Value,
+  OUT UINT32    *GpeDw1Value,
+  OUT UINT32    *GpeDw2Value
+  );
+
+#endif // _PMC_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/PmcRegsVer2.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/PmcRegsVer2.h
new file mode 100644
index 0000000000..986173dd7d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/PmcRegsVer2.h
@@ -0,0 +1,52 @@
+/** @file
+  Register names for Ver2 PCH PMC device
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_PMC_TGL_H_
+#define _PCH_REGS_PMC_TGL_H_
+
+//
+// PWRM Registers
+//
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_B     0x0
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_A     0x2
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_R     0x3
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPD       0x4
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_S     0x5
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_H     0x6
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_D     0x7
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_F     0xA
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_C     0xB
+#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_E     0xC
+
+#endif // _PCH_REGS_PMC_TGL_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PeiDxeSmmPmcLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PeiDxeSmmPmcLib.inf
new file mode 100644
index 0000000000..eba6db767c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PeiDxeSmmPmcLib.inf
@@ -0,0 +1,42 @@
+## @file
+# PEI/DXE/SMM PCH PMC Lib.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPmcLib
+FILE_GUID = 9D60C364-5086-41E3-BC9D-C62AB7233DBF
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PmcLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchCycleDecodingLib
+PchPcrLib
+PchInfoLib
+BaseMemoryLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress
+gSiPkgTokenSpaceGuid.PcdTcoBaseAddress
+
+[Sources]
+PmcLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PmcLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PmcLib.c
new file mode 100644
index 0000000000..78e596b268
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PmcLib.c
@@ -0,0 +1,545 @@
+/** @file
+  PCH PMC Library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PmcLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <PchReservedResources.h>
+#include <Register/PmcRegs.h>
+#include <Register/PchRegs.h>
+
+/**
+  Get PCH ACPI base address.
+
+  @retval Address                   Address of PWRM base address.
+**/
+UINT16
+PmcGetAcpiBase (
+  VOID
+  )
+{
+  return PcdGet16 (PcdAcpiBaseAddress);
+}
+
+/**
+  Get PCH PWRM base address.
+
+  @retval Address                   Address of PWRM base address.
+**/
+UINT32
+PmcGetPwrmBase (
+  VOID
+  )
+{
+  return PCH_PWRM_BASE_ADDRESS;
+}
+
+/**
+  This function enables Power Button SMI
+**/
+VOID
+PmcEnablePowerButtonSmi (
+  VOID
+  )
+{
+  IoOr16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_EN, B_ACPI_IO_PM1_EN_PWRBTN);
+}
+
+/**
+  This function disables Power Button SMI
+**/
+VOID
+PmcDisablePowerButtonSmi (
+  VOID
+  )
+{
+  IoAnd16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_EN, (UINT16)~B_ACPI_IO_PM1_EN_PWRBTN);
+}
+
+/**
+  This function reads PM Timer Count driven by 3.579545 MHz clock
+
+  @retval PM Timer Count
+**/
+UINT32
+PmcGetTimerCount (
+  VOID
+  )
+{
+  return IoRead32 (PmcGetAcpiBase () + R_ACPI_IO_PM1_TMR) & B_ACPI_IO_PM1_TMR_VAL;
+}
+
+/**
+  Get Sleep Type that platform has waken from
+
+  @retval SleepType                Sleep Type
+**/
+PMC_SLEEP_STATE
+PmcGetSleepTypeAfterWake (
+  VOID
+  )
+{
+  UINT16  AcpiBase;
+  UINT32  PmconA;
+
+  AcpiBase = PmcGetAcpiBase ();
+  PmconA   = MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A);
+
+  DEBUG ((DEBUG_INFO, "PWRM_PMCON_A = 0x%x\n", PmconA));
+
+  //
+  // If Global Reset Status, Power Failure. Host Reset Status bits are set, return S5 State
+  //
+  if ((PmconA & (B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS | B_PMC_PWRM_GEN_PMCON_A_PWR_FLR | B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS)) != 0) {
+    return PmcNotASleepState;
+  }
+
+  if (IoRead16 (AcpiBase + R_ACPI_IO_PM1_STS) & B_ACPI_IO_PM1_STS_WAK) {
+    switch (IoRead16 (AcpiBase + R_ACPI_IO_PM1_CNT) & B_ACPI_IO_PM1_CNT_SLP_TYP) {
+      case V_ACPI_IO_PM1_CNT_S0:
+        return PmcInS0State;
+
+      case V_ACPI_IO_PM1_CNT_S1:
+        return PmcS1SleepState;
+
+      case V_ACPI_IO_PM1_CNT_S3:
+        return PmcS3SleepState;
+
+      case V_ACPI_IO_PM1_CNT_S4:
+        return PmcS4SleepState;
+
+      case V_ACPI_IO_PM1_CNT_S5:
+        return PmcS5SleepState;
+
+      default:
+        ASSERT (FALSE);
+        return PmcUndefinedState;
+    }
+  } else {
+    return PmcNotASleepState;
+  }
+}
+
+/**
+  Clear PMC Wake Status
+**/
+VOID
+PmcClearWakeStatus (
+  VOID
+  )
+{
+  IoWrite16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_STS, B_ACPI_IO_PM1_STS_WAK);
+}
+
+/**
+  Configure sleep state
+
+  @param[in] SleepState         S0/S1/S3/S4/S5, refer to PMC_SLEEP_STATE
+**/
+VOID
+PmcSetSleepState (
+  PMC_SLEEP_STATE  SleepState
+  )
+{
+  UINT16  Data16;
+
+  switch (SleepState) {
+    case PmcInS0State:
+      Data16 = V_ACPI_IO_PM1_CNT_S0;
+      break;
+
+    case PmcS1SleepState:
+      Data16 = V_ACPI_IO_PM1_CNT_S1;
+      break;
+
+    case PmcS3SleepState:
+      Data16 = V_ACPI_IO_PM1_CNT_S3;
+      break;
+
+    case PmcS4SleepState:
+      Data16 = V_ACPI_IO_PM1_CNT_S4;
+      break;
+
+    case PmcS5SleepState:
+      Data16 = V_ACPI_IO_PM1_CNT_S5;
+      break;
+
+    default:
+      ASSERT (FALSE);
+      return;
+
+  }
+  IoAndThenOr16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_CNT, (UINT16) ~B_ACPI_IO_PM1_CNT_SLP_TYP, Data16);
+}
+
+/**
+  Check if platform boots after shutdown caused by power button override event
+
+  @retval  TRUE   Power Button Override occurred in last system boot
+  @retval  FALSE  Power Button Override didn't occur
+**/
+BOOLEAN
+PmcIsPowerButtonOverrideDetected (
+  VOID
+  )
+{
+  return ((IoRead16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_STS) & B_ACPI_IO_PM1_STS_PRBTNOR) != 0);
+}
+
+/**
+  This function sets tPCH25 timing
+
+  @param[in] TimingValue       tPCH25 timing value (10us, 100us, 1ms, 10ms)
+**/
+VOID
+PmcSetTPch25Timing (
+  IN PMC_TPCH25_TIMING    TimingValue
+  )
+{
+  ASSERT (TimingValue <= PmcTPch25_10ms);
+
+  MmioAndThenOr32 (
+    (UINTN) (PmcGetPwrmBase () + R_PMC_PWRM_CFG),
+    (UINT32)~(B_PMC_PWRM_CFG_TIMING_TPCH25),
+    TimingValue
+    );
+}
+
+/**
+  This function checks if RTC Power Failure occurred by
+  reading RTC_PWR_FLR bit
+
+  @retval RTC Power Failure state: TRUE  - Battery is always present.
+                                   FALSE - CMOS is cleared.
+**/
+BOOLEAN
+PmcIsRtcBatteryGood (
+  VOID
+  )
+{
+  return ((MmioRead8 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_B) & B_PMC_PWRM_GEN_PMCON_B_RTC_PWR_STS) == 0);
+}
+
+/**
+  This function checks if Power Failure occurred by
+  reading PWR_FLR bit
+
+  @retval Power Failure state
+**/
+BOOLEAN
+PmcIsPowerFailureDetected (
+  VOID
+  )
+{
+  return ((MmioRead16 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A) & B_PMC_PWRM_GEN_PMCON_A_PWR_FLR) != 0);
+}
+
+/**
+  This function checks if Power Failure occurred by
+  reading SUS_PWR_FLR bit
+
+  @retval SUS Power Failure state
+**/
+BOOLEAN
+PmcIsSusPowerFailureDetected (
+  VOID
+  )
+{
+  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A) & B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR) != 0);
+}
+
+/**
+  This function clears Power Failure status (PWR_FLR)
+**/
+VOID
+PmcClearPowerFailureStatus (
+  VOID
+  )
+{
+  //
+  // Write 1 to clear PWR_FLR
+  // Avoid clearing other W1C bits
+  //
+  MmioAndThenOr8 (
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
+    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS >> 8),
+    B_PMC_PWRM_GEN_PMCON_A_PWR_FLR >> 8
+    );
+}
+
+/**
+  This function clears Global Reset status (GBL_RST_STS)
+**/
+VOID
+PmcClearGlobalResetStatus (
+  VOID
+  )
+{
+  //
+  // Write 1 to clear GBL_RST_STS
+  // Avoid clearing other W1C bits
+  //
+  MmioAndThenOr8 (
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 3,
+    (UINT8) ~0,
+    B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS >> 24
+    );
+}
+
+/**
+  This function clears Host Reset status (HOST_RST_STS)
+**/
+VOID
+PmcClearHostResetStatus (
+  VOID
+  )
+{
+  //
+  // Write 1 to clear HOST_RST_STS
+  // Avoid clearing other W1C bits
+  //
+  MmioAndThenOr8 (
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
+    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_PWR_FLR >> 8),
+    B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS >> 8
+    );
+}
+
+/**
+  This function clears SUS Power Failure status (SUS_PWR_FLR)
+**/
+VOID
+PmcClearSusPowerFailureStatus (
+  VOID
+  )
+{
+  //
+  // BIOS clears this bit by writing a '1' to it.
+  // Take care of other fields, so we don't clear them accidentally.
+  //
+  MmioAndThenOr8 (
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 2,
+    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_MS4V >> 16),
+    B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR >> 16
+    );
+}
+
+/**
+  This function sets state to which platform will get after power is reapplied
+
+  @param[in] PowerStateAfterG3          0: S0 state (boot)
+                                        1: S5/S4 State
+**/
+VOID
+PmcSetPlatformStateAfterPowerFailure (
+  IN UINT8 PowerStateAfterG3
+  )
+{
+  UINT32                PchPwrmBase;
+
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  if (PowerStateAfterG3) {
+    MmioOr8 (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A, B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN);
+  } else {
+    MmioAnd8 (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A, (UINT8)~B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN);
+  }
+}
+
+/**
+  This function will set the DISB - DRAM Initialization Scratchpad Bit.
+**/
+VOID
+PmcSetDramInitScratchpad (
+  VOID
+  )
+{
+  //
+  // Set B_CNL_PCH_PWRM_GEN_PMCON_A_DISB.
+  // NOTE: Byte access and not clear BIT18 and BIT16 (W1C bits)
+  //
+  MmioAndThenOr8 (
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 2,
+    (UINT8) ~((B_PMC_PWRM_GEN_PMCON_A_MS4V | B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR) >> 16),
+    B_PMC_PWRM_GEN_PMCON_A_DISB >> 16
+    );
+}
+
+/**
+  Check global SMI enable is set
+
+  @retval TRUE  Global SMI enable is set
+          FALSE Global SMI enable is not set
+**/
+BOOLEAN
+PmcIsGblSmiEn (
+  VOID
+  )
+{
+  return !!(IoRead32 (PmcGetAcpiBase () + R_ACPI_IO_SMI_EN) & B_ACPI_IO_SMI_EN_GBL_SMI);
+}
+
+/**
+  This function checks if SMI Lock is set
+
+  @retval SMI Lock state
+**/
+BOOLEAN
+PmcIsSmiLockSet (
+  VOID
+  )
+{
+  return ((MmioRead8 ((UINTN) (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_B)) & B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK) != 0);
+}
+
+/**
+  This function checks if Debug Mode is locked
+
+  @retval Debug Mode Lock state
+**/
+BOOLEAN
+PmcIsDebugModeLocked (
+  VOID
+  )
+{
+  //
+  // Get lock info from PWRMBASE + PM_CFG
+  //
+  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_CFG) & B_PMC_PWRM_CFG_DBG_MODE_LOCK) != 0);
+}
+
+/**
+  Check TCO second timeout status.
+
+  @retval  TRUE   TCO reboot happened.
+  @retval  FALSE  TCO reboot didn't happen.
+**/
+BOOLEAN
+TcoSecondToHappened (
+  VOID
+  )
+{
+  ///
+  /// Read the Second TO status bit
+  ///
+  if ((IoRead8 (PcdGet16 (PcdTcoBaseAddress) + R_TCO_IO_TCO2_STS) & R_TCO_IO_TCO2_STS) != 0) {
+    return TRUE;
+  } else {
+    return FALSE;
+  }
+}
+
+/**
+  This function clears the Second TO status bit
+**/
+VOID
+TcoClearSecondToStatus (
+  VOID
+  )
+{
+  IoWrite8 (PcdGet16 (PcdTcoBaseAddress) + R_TCO_IO_TCO2_STS, B_TCO_IO_TCO2_STS_SECOND_TO);
+}
+
+/**
+  Check TCO SMI ENABLE is locked
+
+  @retval TRUE  TCO SMI ENABLE is locked
+          FALSE TCO SMI ENABLE is not locked
+**/
+BOOLEAN
+TcoIsSmiLock (
+  VOID
+  )
+{
+  return !!(IoRead16 (PcdGet16 (PcdTcoBaseAddress) + R_TCO_IO_TCO1_CNT) & B_TCO_IO_TCO1_CNT_LOCK);
+}
+
+/**
+   Check if user wants to turn off in PEI phase and power it off
+   CAUTION: this function will potentially turn off your system
+**/
+VOID
+CheckPowerOffNow (
+  VOID
+  )
+{
+  UINT16  ABase;
+  UINT16  Pm1Sts;
+
+  ABase = PmcGetAcpiBase ();
+
+  //
+  // Read and check the ACPI registers
+  //
+  Pm1Sts = IoRead16 (ABase + R_ACPI_IO_PM1_STS);
+
+  DEBUG ((DEBUG_ERROR, "CheckPowerOffNow ()- Pm1Sts= 0x%04x\n", Pm1Sts));
+
+  if ((Pm1Sts & B_ACPI_IO_PM1_STS_PWRBTN) != 0) {
+    IoWrite16 (ABase + R_ACPI_IO_PM1_STS, B_ACPI_IO_PM1_STS_PWRBTN);
+    IoWrite16 (ABase + R_ACPI_IO_PM1_CNT, V_ACPI_IO_PM1_CNT_S5);
+    IoWrite16 (ABase + R_ACPI_IO_PM1_CNT, V_ACPI_IO_PM1_CNT_S5 | B_ACPI_IO_PM1_CNT_SLP_EN);
+  }
+}
+
+/**
+ Clear any SMI status or wake status.
+**/
+VOID
+ClearSmiAndWake (
+  VOID
+  )
+{
+  UINT16              ABase;
+  UINT16              Pm1Sts;
+
+  ABase = PmcGetAcpiBase ();
+
+  //
+  // Clear any SMI or wake state from the boot
+  //
+  Pm1Sts = B_ACPI_IO_PM1_STS_PWRBTN;
+
+  IoWrite16 (ABase + R_ACPI_IO_PM1_STS, Pm1Sts);
+
+  //
+  // Clear the GPE and PM enable
+  //
+  IoWrite16 (ABase + R_ACPI_IO_PM1_EN, 0);
+  IoWrite32 (ABase + R_ACPI_IO_GPE0_EN_127_96, 0);
+}
+
+
+/**
+  Function to check if Dirty Warm Reset occurs
+  (Global Reset has been converted to Host Reset)
+
+  @reval TRUE DWR occurs
+  @reval FALSE Normal boot flow
+**/
+BOOLEAN
+PmcIsDwrBootMode (
+  VOID
+  )
+{
+  UINT32      PchPwrmBase;
+
+  PchPwrmBase = PmcGetPwrmBase ();
+  ASSERT (PchPwrmBase != 0);
+
+  return !!(MmioRead32 (PchPwrmBase + R_PMC_PWRM_HPR_CAUSE0) & B_PMC_PWRM_HPR_CAUSE0_GBL_TO_HOST);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
new file mode 100644
index 0000000000..2bd57b79f0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
@@ -0,0 +1,39 @@
+## @file
+# PEI/DXE/SMM PCH PMC Private Lib Ver2.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPmcPrivateLibVer2
+FILE_GUID = EB69B12B-6D4C-4B12-BB31-66CBCC4C1DC7
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PmcPrivateLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PmcLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress
+
+[FixedPcd]
+
+[Sources]
+PmcPrivateLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
new file mode 100644
index 0000000000..72a21cfe14
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
@@ -0,0 +1,40 @@
+## @file
+# PEI/DXE/SMM PCH private PMC Lib.
+# This part of PMC lib includes S3BootScript support
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPmcPrivateLibWithS3
+FILE_GUID = 5890CA5A-1955-4A02-A09C-01E4150606CC
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PmcPrivateLibWithS3
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PmcLib
+PcdLib
+S3BootScriptLib
+PchPciBdfLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PmcPrivateLibWithS3.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLib.c
new file mode 100644
index 0000000000..4f04765886
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLib.c
@@ -0,0 +1,166 @@
+/** @file
+  PCH private PMC Library for all PCH generations.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PmcLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PmcPrivateLib.h>
+
+/**
+  This function checks if GbE device is supported (not disabled by fuse)
+
+  @retval GbE support state
+**/
+BOOLEAN
+PmcIsGbeSupported (
+  VOID
+  )
+{
+  //
+  // Get fuse info from PWRMBASE + FUSE_SS_DIS_RD_2
+  //
+  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_FUSE_DIS_RD_2) & B_PMC_PWRM_FUSE_DIS_RD_2_GBE_FUSE_SS_DIS) == 0);
+}
+
+/**
+  This function checks if LAN wake from DeepSx is enabled
+
+  @retval Lan Wake state
+**/
+BOOLEAN
+PmcIsLanDeepSxWakeEnabled (
+  VOID
+  )
+{
+  //
+  // Get wake info from PWRMBASE + DSX_CFG
+  //
+  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_DSX_CFG) & (UINT32) B_PMC_PWRM_DSX_CFG_LAN_WAKE_EN) != 0);
+}
+
+/**
+  This function checks if eSPI SMI Lock is set
+
+  @retval eSPI SMI Lock state
+**/
+BOOLEAN
+PmcIsEspiSmiLockSet (
+  VOID
+  )
+{
+  return ((MmioRead32 ((UINTN) (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A)) & B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK) != 0);
+}
+
+/**
+  This function sets SW SMI Rate.
+
+  @param[in] SwSmiRate        Refer to PMC_SWSMI_RATE for possible values
+**/
+VOID
+PmcSetSwSmiRate (
+  IN PMC_SWSMI_RATE          SwSmiRate
+  )
+{
+  UINT32        PchPwrmBase;
+  STATIC UINT8  SwSmiRateRegVal[4] = {
+    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_1_5MS,
+    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_16MS,
+    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_32MS,
+    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_64MS
+  };
+
+  ASSERT (SwSmiRate <= PmcSwSmiRate64ms);
+
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  //
+  // SWSMI_RATE_SEL BIT (PWRMBASE offset 1020h[7:6]) bits are in RTC well
+  //
+  MmioAndThenOr8 (
+    PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
+    (UINT8)~B_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL,
+    SwSmiRateRegVal[SwSmiRate]
+    );
+}
+
+/**
+  This function sets Periodic SMI Rate.
+
+  @param[in] PeriodicSmiRate        Refer to PMC_PERIODIC_SMI_RATE for possible values
+**/
+VOID
+PmcSetPeriodicSmiRate (
+  IN PMC_PERIODIC_SMI_RATE    PeriodicSmiRate
+  )
+{
+  UINT32        PchPwrmBase;
+  STATIC UINT8  PeriodicSmiRateRegVal[4] = {
+    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_8S,
+    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_16S,
+    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_32S,
+    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_64S
+  };
+
+  ASSERT (PeriodicSmiRate <= PmcPeriodicSmiRate64s);
+
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  MmioAndThenOr8 (
+    PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
+    (UINT8)~B_PMC_PWRM_GEN_PMCON_A_PER_SMI_SEL,
+    PeriodicSmiRateRegVal[PeriodicSmiRate]
+    );
+}
+
+/**
+  This function reads Power Button Level
+
+  @retval State of PWRBTN# signal (0: Low, 1: High)
+**/
+UINT8
+PmcGetPwrBtnLevel (
+  VOID
+  )
+{
+  if (MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_B) & B_PMC_PWRM_GEN_PMCON_B_PWRBTN_LVL) {
+    return 1;
+  } else {
+    return 0;
+  }
+}
+
+/**
+  This function gets Group to GPE0 configuration
+
+  @param[out] GpeDw0Value       GPIO Group to GPE_DW0 assignment
+  @param[out] GpeDw1Value       GPIO Group to GPE_DW1 assignment
+  @param[out] GpeDw2Value       GPIO Group to GPE_DW2 assignment
+**/
+VOID
+PmcGetGpioGpe (
+  OUT UINT32    *GpeDw0Value,
+  OUT UINT32    *GpeDw1Value,
+  OUT UINT32    *GpeDw2Value
+  )
+{
+  UINT32 Data32;
+
+  Data32 = MmioRead32 ((UINTN) (PmcGetPwrmBase () + R_PMC_PWRM_GPIO_CFG));
+
+  *GpeDw0Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW0) >> N_PMC_PWRM_GPIO_CFG_GPE0_DW0);
+  *GpeDw1Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW1) >> N_PMC_PWRM_GPIO_CFG_GPE0_DW1);
+  *GpeDw2Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW2) >> N_PMC_PWRM_GPIO_CFG_GPE0_DW2);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLibWithS3.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLibWithS3.c
new file mode 100644
index 0000000000..02acd0d688
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PmcPrivateLibWithS3.c
@@ -0,0 +1,122 @@
+/** @file
+  PCH private PMC Library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/PmcLib.h>
+#include <Library/PmcPrivateLib.h>
+
+/**
+  This S3 BootScript only function disables triggering Global Reset of both
+  the Host and the ME partitions after CF9h write of 6h or Eh.
+**/
+VOID
+PmcDisableCf9GlobalResetInS3BootScript (
+  VOID
+  )
+{
+  UINT32                          Data;
+
+  UINT32                          PchPwrmBase;
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  Data = MmioRead32 (PchPwrmBase + R_PMC_PWRM_ETR3);
+
+  Data &= (UINT32) ~B_PMC_PWRM_ETR3_CF9GR;
+
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) PchPwrmBase +
+    R_PMC_PWRM_ETR3,
+    1,
+    &Data
+    );
+}
+
+/**
+  This S3 BootScript only function disables triggering Global Reset of both
+  the Host and the ME partitions after CF9h write of 6h or Eh.
+  Global Reset configuration is locked after programming
+**/
+VOID
+PmcDisableCf9GlobalResetWithLockInS3BootScript (
+  VOID
+  )
+{
+  UINT32                          Data;
+
+  UINT32                          PchPwrmBase;
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  Data = MmioRead32 (PchPwrmBase + R_PMC_PWRM_ETR3);
+
+  Data &= (UINT32) ~B_PMC_PWRM_ETR3_CF9GR;
+  Data |= (UINT32) B_PMC_PWRM_ETR3_CF9LOCK;
+
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) PchPwrmBase +
+    R_PMC_PWRM_ETR3,
+    1,
+    &Data
+    );
+}
+
+/**
+  This function sets SMI Lock with S3 Boot Script programming
+**/
+VOID
+PmcLockSmiWithS3BootScript (
+  VOID
+  )
+{
+  UINT32  PchPwrmBase;
+
+  PchPwrmBase = PmcGetPwrmBase ();
+
+  MmioOr8 ((UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B), B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK);
+
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint8,
+    (UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B),
+    1,
+    (VOID *) (UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B)
+    );
+}
+
+/**
+  This function sets eSPI SMI Lock
+  @attention This function must be called after eSPI SMI generation has been enabled.
+    This setting is required in all boot modes and before EndOfDxe.
+    If set value will be restored upon S3 resume by bootscript.
+**/
+VOID
+PmcLockEspiSmiWithS3BootScript (
+  VOID
+  )
+{
+  UINT8   Data8Or;
+  UINT8   Data8And;
+
+  Data8Or  = (UINT8) (B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK >> 8);
+  Data8And = (UINT8)~((B_PMC_PWRM_GEN_PMCON_A_PWR_FLR | B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS) >> 8);
+
+  MmioAndThenOr8 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1, Data8And, Data8Or);
+  S3BootScriptSaveMemReadWrite (
+    S3BootScriptWidthUint8,
+    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
+    &Data8Or,
+    &Data8And
+    );
+}
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (22 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component Heng Luo
                   ` (15 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Psf/IncludePrivate
  * IpBlock/Psf/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.h               | 520 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSmmPsfLibVer2.inf |  40 ++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c                | 203 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibInternal.h        | 470 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibVer2.c            | 115 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 1348 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.h
new file mode 100644
index 0000000000..f333be48d2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.h
@@ -0,0 +1,520 @@
+/** @file
+  Header file for PchPsfPrivateLib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PSF_PRIVATE_LIB_H_
+#define _PCH_PSF_PRIVATE_LIB_H_
+
+#include <Library/PchPcrLib.h>
+#include <Register/PchPcrRegs.h>
+
+typedef struct {
+  UINT32       Id;
+  PCH_SBI_PID  SbPid;
+} PSF_SEGMENT;
+
+/**
+  Get list of supported PSF segments.
+
+  @param[out] PsfTable        Array of supported PSF segments
+  @param[out] PsfTableLength  Length of PsfTable
+**/
+VOID
+PsfSegments (
+  OUT PSF_SEGMENT  **PsfTable,
+  OUT UINT32       *PsfTableLength
+  );
+
+//
+// Structure for storing data on both PSF SideBand Port ID and
+// PSF port register offset for specific device
+//
+typedef struct {
+  PCH_SBI_PID  PsfPid;
+  UINT16       RegBase;
+} PSF_PORT;
+
+/**
+  Disable device at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfDisableDevice (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Enable device at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfEnableDevice (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Hide PciCfgSpace of device at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfHideDevice (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Unhide PciCfgSpace of device at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfUnhideDevice (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Disable device BARs at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+  @param[in] BarDisMask  BIT0-BAR0, BIT1-BAR1,...
+                         Mask corresponds to 32bit wide BARs
+**/
+VOID
+PsfDisableDeviceBar (
+  IN PSF_PORT  PsfPort,
+  IN UINT32    BarDisMask
+  );
+
+/**
+  Enable device BARs at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+  @param[in] BarEnMask   BIT0-BAR0, BIT1-BAR1,...
+                         Mask corresponds to 32bit wide BARs
+**/
+VOID
+PsfEnableDeviceBar (
+  IN PSF_PORT  PsfPort,
+  IN UINT32    BarEnMask
+  );
+
+/**
+  Disable IDER device at PSF level
+**/
+VOID
+PsfDisableIderDevice (
+  VOID
+  );
+
+/**
+  Enable SOL device at PSF level
+**/
+VOID
+PsfEnableSolDevice (
+  VOID
+  );
+
+/**
+  Disable SOL device at PSF level
+**/
+VOID
+PsfDisableSolDevice (
+  VOID
+  );
+
+/**
+  Set PMC ABASE value in PSF
+
+  @param[in] Address     Address for ACPI base.
+**/
+VOID
+PsfSetPmcAbase (
+  IN  UINT16       Address
+  );
+
+/**
+  Get PMC ABASE value from PSF
+
+  @retval Address     Address for ACPI base.
+**/
+UINT16
+PsfGetPmcAbase (
+  VOID
+  );
+
+/**
+  Get PMC PWRMBASE value from PSF
+
+  @retval Address     Address for PWRM base.
+**/
+UINT32
+PsfGetPmcPwrmBase (
+  VOID
+  );
+
+/**
+  Hide Cnvi WiFi device's PciCfgSpace at PSF level
+**/
+VOID
+PsfHideCnviWifiDevice (
+  VOID
+  );
+
+/**
+  Disable Cnvi Wifi device at PSF level
+**/
+VOID
+PsfDisableCnviWifiDevice (
+  VOID
+  );
+
+/**
+  Disable HDAudio device at PSF level
+**/
+VOID
+PsfDisableHdaDevice (
+  VOID
+  );
+
+/**
+  Disable Dsp bar at PSF level
+**/
+VOID
+PsfDisableDspBar (
+  VOID
+  );
+
+/**
+  Disable THC device at PSF level
+
+  @param[in]  ThcNumber                Touch Host Controller Number THC0 or THC1
+**/
+VOID
+PsfDisableThcDevice (
+  IN  UINT32        ThcNumber
+  );
+
+/**
+  Disable xDCI device at PSF level
+**/
+VOID
+PsfDisableXdciDevice (
+  VOID
+  );
+
+/**
+  Disable xHCI device at PSF level
+**/
+VOID
+PsfDisableXhciDevice (
+  VOID
+  );
+
+/**
+  Disable xHCI VTIO Phantom device at PSF level
+**/
+VOID
+PsfDisableXhciVtioDevice (
+  VOID
+  );
+
+/**
+  Disable SATA device at PSF level
+
+  @param[in]  SataCtrlIndex     SATA controller index
+**/
+VOID
+PsfDisableSataDevice (
+  IN UINT32     SataCtrlIndex
+  );
+
+/**
+  Return PSF_PORT for SCS eMMC device
+
+  @retval    PsfPort      PSF PORT structure for SCS eMMC device
+**/
+PSF_PORT
+PsfScsEmmcPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for SCS SD Card device
+
+  @retval    PsfPort      PSF PORT structure for SCS SD Card device
+**/
+PSF_PORT
+PsfScsSdCardPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for SCS UFS device
+
+  @param[in] UfsNum       UFS Device
+
+  @retval    PsfPort      PSF PORT structure for SCS UFS device
+**/
+PSF_PORT
+PsfScsUfsPort (
+  IN UINT32  UfsNum
+  );
+
+/**
+  Disable ISH device at PSF level
+**/
+VOID
+PsfDisableIshDevice (
+  VOID
+  );
+
+/**
+  Disable FPAK device at PSF level
+**/
+VOID
+PsfDisableFpakDevice (
+  VOID
+  );
+
+/**
+  Disable ISH BAR1 at PSF level
+**/
+VOID
+PsfDisableIshBar1 (
+  VOID
+  );
+
+/**
+  Disable GbE device at PSF level
+**/
+VOID
+PsfDisableGbeDevice (
+  VOID
+  );
+
+/**
+  Disable SMBUS device at PSF level
+**/
+VOID
+PsfDisableSmbusDevice (
+  VOID
+  );
+
+/**
+  Disable TraceHub ACPI devices at PSF level
+**/
+VOID
+PsfDisableTraceHubAcpiDevice (
+  VOID
+  );
+
+/**
+  Hide TraceHub ACPI devices PciCfgSpace at PSF level
+**/
+VOID
+PsfHideTraceHubAcpiDevice (
+  VOID
+  );
+
+/**
+  This procedure will hide TraceHub PciCfgSpace at PSF level
+**/
+VOID
+PsfHideTraceHubDevice (
+  VOID
+  );
+
+/**
+  This procedure will unhide TraceHub PciCfgSpace at PSF level
+**/
+VOID
+PsfUnhideTraceHubDevice (
+  VOID
+  );
+
+/**
+  This procedure will disable TraceHub device at PSF level
+**/
+VOID
+PsfDisableTraceHubDevice (
+  VOID
+  );
+
+/**
+  Configures rootspace 3 bus number for PCIe IMR use
+
+  @param[in] Rs3Bus        bus number
+**/
+VOID
+PsfSetRs3Bus (
+  UINT8 Rs3Bus
+  );
+
+/**
+  Disable PCIe Root Port at PSF level
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+**/
+VOID
+PsfDisablePcieRootPort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Program PSF grant counts for SATA
+  Call this before SATA ports are accessed for enumeration
+**/
+VOID
+PsfConfigureSataGrantCounts (
+  VOID
+  );
+
+/**
+  Specifies the root port configuration of the
+  PCIe controller. The number on the left of x
+  signifies the number of root ports in the controller
+  while value on the right is link width. N stands for
+  the number of PCIe lanes per root port instance.
+**/
+typedef enum {
+  PsfPcieCtrl4xn,
+  PsfPcieCtrl1x2n_2xn,
+  PsfPcieCtrl2xn_1x2n,
+  PsfPcieCtrl2x2n,
+  PsfPcieCtrl1x4n,
+  PsfPcieCtrlUndefined
+} PSF_PCIE_CTRL_CONFIG;
+
+/**
+  Program PSF grant counts for PCI express depending on controllers configuration
+
+  @param[in] PsfPcieCtrlConfigTable   Table with PCIe controllers configuration
+  @param[in] NumberOfPcieControllers  Number of PCIe controllers. This is also the size of PsfPcieCtrlConfig table
+**/
+VOID
+PsfConfigurePcieGrantCounts (
+  IN PSF_PCIE_CTRL_CONFIG  *PsfPcieCtrlConfigTable,
+  IN UINT32                NumberOfPcieControllers
+  );
+
+
+/**
+  This function enables EOI message forwarding in PSF for PCIe ports
+  for cases where IOAPIC is present behind this root port.
+
+  @param[in] RpIndex        Root port index (0 based)
+
+  @retval Status
+**/
+EFI_STATUS
+PsfConfigurEoiForPciePort (
+  IN  UINT32   RpIndex
+  );
+
+//
+// Structure for PSF Port Destination ID
+//
+typedef union {
+  UINT32 RegVal;
+  struct {
+    UINT32  ChannelId   : 8;  // Channel ID
+    UINT32  PortId      : 7;  // Port ID
+    UINT32  PortGroupId : 1;  // Port Group ID
+    UINT32  PsfId       : 8;  // PSF ID
+    UINT32  Rsvd        : 7;  // Reserved
+    UINT32  ChanMap     : 1;  // Channel map
+  } Fields;
+} PSF_PORT_DEST_ID;
+
+/**
+  PCIe PSF port destination ID (psf_id:port_group_id:port_id:channel_id)
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval Destination ID
+**/
+PSF_PORT_DEST_ID
+PsfPcieDestinationId (
+  IN UINT32 RpIndex
+  );
+
+/**
+  PSF early initialization.
+**/
+VOID
+PsfEarlyInit (
+  VOID
+  );
+
+/**
+  Assign new function number for PCIe Port Number.
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+  @param[in] NewFunction    New Function number
+**/
+VOID
+PsfSetPcieFunction (
+  IN UINT32  RpIndex,
+  IN UINT32  NewFunction
+  );
+
+/**
+  This function enables PCIe Relaxed Order in PSF
+**/
+VOID
+PsfEnablePcieRelaxedOrder (
+  VOID
+  );
+
+
+/**
+  Enable VTd support in PSF.
+**/
+VOID
+PchPsfEnableVtd (
+  VOID
+  );
+
+/**
+  Disable PSF address-based peer-to-peer decoding.
+**/
+VOID
+PchPsfDisableP2pDecoding (
+  VOID
+  );
+
+/**
+  This procedure will hide PMC device at PSF level
+**/
+VOID
+PsfHidePmcDevice (
+  VOID
+  );
+
+/**
+  This procedure will disable D3:F0 device at PSF level for PCH-LP
+**/
+VOID
+PsfDisableD3F0 (
+  VOID
+  );
+
+/**
+  This procedure will disable PSF upstream completion tracking for HDAudio on PCH-LP
+**/
+VOID
+PsfDisableUpstreamCompletionTrackingForHda (
+  VOID
+  );
+
+#endif // _PCH_PSF_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSmmPsfLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSmmPsfLibVer2.inf
new file mode 100644
index 0000000000..d8fc52444a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSmmPsfLibVer2.inf
@@ -0,0 +1,40 @@
+## @file
+#  PEI/DXE/SMM PCH PSF Private Lib for TigerLake PCH
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION                    = 0x00010017
+BASE_NAME                      = PeiDxeSmmPsfLibTgl
+FILE_GUID                      = 28B03D2C-6FD5-4061-96B8-39E3F0402DE5
+VERSION_STRING                 = 1.0
+MODULE_TYPE                    = BASE
+LIBRARY_CLASS                  = PsfLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  DebugLib
+  PciSegmentLib
+  PchInfoLib
+  PchPcrLib
+  SataLib
+  CpuPcieInfoFruLib
+  PchPciBdfLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+  PsfLib.c
+  PsfLibVer2.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
new file mode 100644
index 0000000000..1f0b11c11a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
@@ -0,0 +1,203 @@
+/** @file
+  This file contains PSF routines for RC usage
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SataLib.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <Library/PsfLib.h>
+#include <PchLimits.h>
+#include <Register/PchRegsPsf.h>
+#include <PchPcieRpInfo.h>
+#include "PsfLibInternal.h"
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Get PSF SideBand Port ID from PSF ID (1 - PSF1, 2 - PSF2, ...)
+
+  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
+
+  @retval PSF SideBand Port ID
+**/
+PCH_SBI_PID
+PsfSbPortId (
+  UINT32        PsfId
+  )
+{
+  UINT32          PsfTableIndex;
+  PSF_SEGMENT     *PsfTable;
+  UINT32          PsfTableSize;
+
+  PsfSegments (&PsfTable, &PsfTableSize);
+
+  for (PsfTableIndex = 0; PsfTableIndex < PsfTableSize; PsfTableIndex++) {
+    if (PsfTable[PsfTableIndex].Id == PsfId) {
+      return PsfTable[PsfTableIndex].SbPid;
+    }
+  }
+
+  ASSERT (FALSE);
+  return 0;
+}
+
+
+/**
+  Get PCH Root PSF ID. This is the PSF segment to which OPDMI/DMI is connected.
+
+  @retval PsfId             Root PSF ID
+**/
+UINT32
+PsfRootId (
+  VOID
+  )
+{
+  PSF_SEGMENT     *PsfTable;
+  UINT32          PsfTableSize;
+
+  PsfSegments (&PsfTable, &PsfTableSize);
+
+  return PsfTable[0].Id;
+}
+
+/**
+  Add EOI Target in a given PSF
+
+  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
+  @param[in] TargetId          EOI Target ID
+**/
+STATIC
+VOID
+PsfAddEoiTarget (
+  UINT32           PsfId,
+  PSF_PORT_DEST_ID TargetId
+  )
+{
+  UINT16      EoiTargetBase;
+  UINT16      EoiControlBase;
+  UINT8       NumOfEnabledTargets;
+  UINT8       MaximalNumberOfTargets;
+  PCH_SBI_PID PsfSbiPortId;
+  UINT32      Data32;
+  UINT8       TargetIndex;
+
+  MaximalNumberOfTargets = PsfEoiRegData (PsfId, &EoiTargetBase, &EoiControlBase);
+  PsfSbiPortId = PsfSbPortId (PsfId);
+
+  //
+  // Get number of enabled agents from PSF_x_PSF_MC_CONTROL_MCAST0_RS0_EOI register
+  //
+  Data32 = PchPcrRead32 (PsfSbiPortId, EoiControlBase);
+  NumOfEnabledTargets = (UINT8) (Data32 >> N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC);
+
+  //
+  // Check if target was not already enabled
+  // Targets from a different PSF segment are aggregated into single destination on
+  // current PSF segment.
+  //
+  for (TargetIndex = 0; TargetIndex < NumOfEnabledTargets; TargetIndex++) {
+    Data32 = PchPcrRead32 (PsfSbiPortId, EoiTargetBase + TargetIndex * 4);
+    //
+    // If target already added don't add it again
+    //
+    if (Data32 == TargetId.RegVal) {
+      ASSERT (FALSE);
+      return;
+    }
+    //
+    // If target is from different PSF segment than currently being analyzed
+    // it is enough that its PsfID is matching
+    //
+    if ((Data32 & B_PCH_PSFX_PCR_TARGET_PSFID) >> N_PCH_PSFX_PCR_TARGET_PSFID == TargetId.Fields.PsfId) {
+      return;
+    }
+  }
+
+  //
+  // Check if next one can be added
+  //
+  if (NumOfEnabledTargets >= MaximalNumberOfTargets) {
+    ASSERT (FALSE);
+    return;
+  }
+
+  //
+  // Add next target
+  // Configure Multicast Destination ID register with target device on PSF.
+  // Configuration must be done in next available PSF_MC_AGENT_MCAST0_RS0_TGT<x>_EOI register
+  // so that other targets  are not overridden. <x> is known from the number of multicast agents
+  // in Multicast Control Register. Value programmed is based on
+  // PsfID, PortGroupID, PortID and ChannelID of the target
+  //
+  PchPcrWrite32 (PsfSbiPortId, EoiTargetBase + NumOfEnabledTargets * 4, TargetId.RegVal);
+
+  //
+  // Enable new target
+  // Configure PSF_x_PSF_MC_CONTROL_MCAST0_RS0_EOI, increase NumMc and set MultCEn
+  //
+  NumOfEnabledTargets++;
+  Data32 = (NumOfEnabledTargets << N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC) | B_PCH_PSFX_PCR_MC_CONTROL_MCASTX_MULTCEN;
+  PchPcrWrite32 (PsfSbiPortId, EoiControlBase, Data32);
+}
+
+/**
+  Enable EOI Target
+
+  @param[in] TargetId  Target ID
+**/
+STATIC
+VOID
+PsfEnableEoiTarget (
+  PSF_PORT_DEST_ID     TargetId
+  )
+{
+  UINT32 RootLevelPsf;
+
+  RootLevelPsf = PsfRootId ();
+
+  //
+  // Enable EOI target in root PSF
+  //
+  PsfAddEoiTarget (RootLevelPsf, TargetId);
+
+  //
+  // Enable EOI target on other PSF segment if target
+  // is not located on root PSF
+  //
+  if (TargetId.Fields.PsfId != RootLevelPsf) {
+    PsfAddEoiTarget (TargetId.Fields.PsfId, TargetId);
+  }
+}
+
+/**
+  This function enables EOI message forwarding in PSF for PCIe ports
+  for cases where IOAPIC is present behind this root port.
+
+  @param[in] RpIndex        Root port index (0 based)
+
+  @retval Status
+**/
+EFI_STATUS
+PsfConfigurEoiForPciePort (
+  IN  UINT32  RpIndex
+  )
+{
+  ASSERT (RpIndex < GetPchMaxPciePortNum ());
+
+  //
+  // If there is an IOAPIC discovered behind root port program PSF Multicast registers
+  // accordingly to CNL PCH BWG PSF EOI Multicast Configuration
+  // Since there is a device behind RootPort to which EOI needs to be forwarded
+  // enable multicast (MULTCEN) and increase the number of multicast agents (NUMMC)
+  // in Multicast Control Register.
+  //
+  PsfEnableEoiTarget (PsfPcieDestinationId (RpIndex));
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibInternal.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibInternal.h
new file mode 100644
index 0000000000..9d636b5298
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibInternal.h
@@ -0,0 +1,470 @@
+/** @file
+  This file contains internal header for PSF lib usage
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_PSF_PRIVATE_LIB_INTERNAL_H_
+#define _PCH_PSF_PRIVATE_LIB_INTERNAL_H_
+
+#include <Library/PsfLib.h>
+#include <Register/PchPcrRegs.h>
+
+#define PSF_PORT_NULL ((PSF_PORT){0,0})
+#define PSF_IS_PORT_NULL(PsfPort) ((PsfPort.PsfPid == 0) && (PsfPort.RegBase == 0))
+
+typedef struct {
+  PCH_SBI_PID  PsfPid;
+  UINT32       RegisterAddress;
+  UINT8        Fro;
+} PSF_PORT_RELAXED_ORDERING_CONFIG_REG;
+/**
+  Disable bridge (e.g. PCIe Root Port) at PSF level
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfDisableBridge (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Disable bridge (e.g. PCIe Root Port) at PSF level in RS3
+
+  @param[in] PsfPort  PSF PORT data structure
+**/
+VOID
+PsfRs3DisableBridge (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Check if bridge (e.g. PCIe Root Port) is enabled at PSF level
+
+  @param[in] PsfPort  PSF PORT data structure
+
+  @retval TRUE        Bridge behind PSF Port is enabled
+          FALSE       Bridge behind PSF Port is disabled
+**/
+BOOLEAN
+PsfIsBridgeEnabled (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Disable device IOSpace at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+**/
+VOID
+PsfDisableDeviceIoSpace (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Enable device IOSpace at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+**/
+VOID
+PsfEnableDeviceIoSpace (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Disable device Memory Space at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+**/
+VOID
+PsfDisableDeviceMemSpace (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Enable device Memory Space at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+**/
+VOID
+PsfEnableDeviceMemSpace (
+  IN PSF_PORT  PsfPort
+  );
+
+/**
+  Set device BARx address at PSF level
+  Method not for bridges (e.g. PCIe Root Port)
+
+  @param[in] PsfPort     PSF PORT data structure
+  @param[in] BarNum      BAR Number (0:BAR0, 1:BAR1, ...)
+  @param[in] BarValue    32bit BAR value
+**/
+VOID
+PsfSetDeviceBarValue (
+  IN PSF_PORT  PsfPort,
+  IN UINT8     BarNum,
+  IN UINT32    BarValue
+  );
+
+/**
+  Return PSF_PORT for TraceHub device
+
+  @retval    PsfPort         PSF PORT structure for TraceHub device
+**/
+PSF_PORT
+PsfTraceHubPort (
+  VOID
+  );
+
+/**
+  This procedure will return PSF_PORT for TraceHub ACPI device
+
+  @retval    PsfPort         PSF PORT structure for TraceHub ACPI device
+**/
+PSF_PORT
+PsfTraceHubAcpiDevPort (
+  VOID
+  );
+
+/**
+  This procedure will return PSF_PORT for SOL device
+
+  @retval    PsfPort         PSF PORT structure for SOL device
+**/
+PSF_PORT
+PsfSolPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for ISH device
+
+  @retval    PsfPort         PSF PORT structure for ISH device
+**/
+PSF_PORT
+PsfIshPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for FPAK device
+
+  @retval    PsfPort         PSF PORT structure for FPAK device
+**/
+PSF_PORT
+PsfFpakPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for CNVi device
+
+  @retval    PsfPort         PSF PORT structure for CNVi device
+**/
+PSF_PORT
+PsfCnviPort (
+  VOID
+  );
+
+/**
+  Return PSF_PORT for PMC device
+
+  @retval    PsfPort         PSF PORT structure for PMC device
+**/
+PSF_PORT
+PsfPmcPort (
+  VOID
+  );
+
+/**
+  Return second level PSF_PORT to which PCIE Root Port device is connected (directly)
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe
+**/
+PSF_PORT
+PsfPcieSecondLevelPort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Return PSF_PORT at root PSF level to which PCIe Root Port device is connected
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe
+
+**/
+PSF_PORT
+PsfRootPciePort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Return RS3 PSF_PORT at root PSF level to which PCIe Root Port device is connected
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe
+**/
+PSF_PORT
+PsfRootRs3PciePort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Check if PCIe Root Port is enabled
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval TRUE              PCIe Root Port is enabled
+          FALSE             PCIe Root Port is disabled
+**/
+BOOLEAN
+PsfIsPcieRootPortEnabled (
+  IN UINT32  RpIndex
+  );
+
+//
+// Type of enpoint connected to PSF port.
+// PsfNullPort is used for ports which do not exist
+//
+typedef enum {
+  PsfNullPort,
+  PsfToPsfPort,
+  PsfPcieCtrlPort
+} PSF_TOPO_PORT_TYPE;
+
+//
+// Structure for storing information on location in PSF topology
+// Every PSF node is identified by PsfID and PsfPortId
+//
+typedef struct {
+  UINT8         PsfId;
+  UINT8         PortId;
+} PSF_TOPO_PORT;
+
+#define PSF_TOPO_PORT_NULL ((PSF_TOPO_PORT){0, 0})
+#define PSF_IS_TOPO_PORT_NULL(PsfTopoPort) (((PsfTopoPort).PsfId == 0) && ((PsfTopoPort).PortId == 0))
+
+//
+// This is optional field containing PSF port specific data
+//
+typedef union {
+  UINT32  PcieCtrlIndex;
+} PSF_TOPO_PORT_DATA;
+
+//
+// Structure representing PSF port in PSF topology
+// If port is of PsfToPsfPort type Child will point to the first
+// port of sub PSF segment.
+//
+typedef struct PSF_TOPOLOGY {
+  PSF_TOPO_PORT              PsfPort;
+  PSF_TOPO_PORT_TYPE         PortType;
+  CONST struct PSF_TOPOLOGY  *Child;
+  PSF_TOPO_PORT_DATA         PortData;
+} PSF_TOPOLOGY;
+
+//
+// Tag for identifying last element of PSF_TOPOLOGY type array
+//
+#define PSF_TOPOLOGY_END   {{0, 0}, PsfNullPort, NULL}
+
+/**
+  Get PSF Pcie Tree topology
+
+  @param[in] PsfTopology          PSF Port from PSF PCIe tree topology
+
+  @retval PsfTopology             PSF PCIe tree topology
+**/
+CONST PSF_TOPOLOGY*
+PsfGetRootPciePsfTopology (
+  VOID
+  );
+
+//
+// Structure for storing data on PCIe controller to PSF assignment and GrantCount register offsets
+//
+typedef struct {
+  PCH_SBI_PID  PsfPid;
+  UINT16       DevGntCnt0Base;
+  UINT16       TargetGntCntPg1Tgt0Base;
+} PSF_GRANT_COUNT_REG;
+
+/**
+  Grant count regs data for PSF that is directly connected to PCIe Root Ports
+
+  @param[in]  Controller     PCIe Root Port Controller index (0 based)
+  @param[out] GrantCountReg  Structure with PSF Grant Count register data
+**/
+VOID
+PsfPcieGrantCountBaseReg (
+  IN  UINT8                Controller,
+  OUT PSF_GRANT_COUNT_REG  *GrantCountReg
+  );
+
+/**
+  Get Grant Count number (Device Grant Count and Target Grant Count)
+  for PSF that is directly connected to PCIe Root Ports
+
+  @param[in]  Controller    PCIe Root Port Controller index
+  @param[in]  Channel       PCIe Root Port Channel index
+  @param[out] DgcrNo        Device Grant Count number
+  @param[out] PgTgtNo       Target Grant Count number
+**/
+VOID
+PsfPcieGrantCountNumber (
+  IN  UINT8 Controller,
+  IN  UINT8 Channel,
+  OUT UINT8 *DgcrNo,
+  OUT UINT8 *PgTgtNo
+  );
+
+/**
+  Grant count regs data for a given PSF-to-PSF port.
+
+  @param[in] PsfTopoPort         PSF-to-PSF port
+
+  @param[out] GrantCountReg      Structure with PSF Grant Count register data
+**/
+VOID
+PsfSegmentGrantCountBaseReg (
+  IN PSF_TOPO_PORT         PsfTopoPort,
+  OUT PSF_GRANT_COUNT_REG  *GrantCountReg
+  );
+
+/**
+  Grant Count number (Device Grant Count and Target Grant Count) for a given PSF-to-PSF port.
+
+  @param[in] PsfTopoPort         PSF-to-PSF port
+  @param[out] DgcrNo             Device Grant Count number
+  @param[out] PgTgtNo            Target Grant Count number
+**/
+VOID
+PsfSegmentGrantCountNumber (
+  IN PSF_TOPO_PORT PsfTopoPort,
+  OUT UINT8        *DgcrNo,
+  OUT UINT8        *PgTgtNo
+  );
+
+//
+// Do not override PSF Grant Count value and leave HW default setting
+//
+#define DEFAULT_PCIE_GRANT_COUNT 0xFF
+
+/**
+  Get PSF SideBand Port ID from PSF ID (1 - PSF1, 2 - PSF2, ...)
+
+  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
+
+  @retval PSF SideBand Port ID
+**/
+PCH_SBI_PID
+PsfSbPortId (
+  UINT32        PsfId
+  );
+
+/**
+  Get EOI register data for given PSF ID
+
+  @param[in]  PsfId           PSF ID (1 - PSF1, 2 - PSF2, ...)
+  @param[out] EoiTargetBase   EOI Target register
+  @param[out] EoiControlBase  EOI Control register
+
+  @retval MaxTargets          Number of supported targets
+
+**/
+UINT8
+PsfEoiRegData (
+  UINT32        PsfId,
+  UINT16        *EoiTargetBase,
+  UINT16        *EoiControlBase
+  );
+
+/**
+  Get MCTP register data for given PSF ID
+
+  @param[in]  PsfId            PSF ID (1 - PSF1, 2 - PSF2, ...)
+  @param[out] MctpTargetBase   MCTP Target register
+  @param[out] MctpControlBase  MCTP Control register
+
+  @retval MaxTargets           Number of supported targets
+
+**/
+UINT8
+PsfMctpRegData (
+  UINT32        PsfId,
+  UINT16        *MctpTargetBase,
+  UINT16        *MctpControlBase
+  );
+
+/**
+  Check if MCTP is supported
+
+  @retval TRUE              MCTP is supported
+          FALSE             MCTP is not supported
+**/
+BOOLEAN
+PsfIsMctpSupported (
+  VOID
+  );
+
+/**
+  Return the PSF (Root level) Function Config PSF_PORT for PCIe Root Port
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe Function Config
+**/
+PSF_PORT
+PsfRootPcieFunctionConfigPort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Return the PSF (Root level) RS3 Function Config PSF_PORT for PCIe Root Port
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe Function Config
+**/
+PSF_PORT
+PsfRootRs3PcieFunctionConfigPort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  Return the PSF Function Config Second Level PSF_PORT for PCIe Root Port
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval    PsfPort        PSF PORT structure for PCIe Function Config
+**/
+PSF_PORT
+PsfPcieFunctionConfigSecondLevelPort (
+  IN UINT32  RpIndex
+  );
+
+/**
+  This function returns Psf Port Relaxed Ordering Configs
+
+  @param[out] PsfPortRelaxedOrderingConfigRegs                          PCH Series specific table
+  @param[out] PsfPortRelaxedOrderingConfigRegsTableSize                 PCH Series specific table size
+  @param[out] PsfPortRelaxedOrderingConfigRegsPchTypeSpecific           PCH type specific table
+  @param[out] PsfPortRelaxedOrderingConfigRegsPchTypeSpecificTableSize  PCH type specific table size
+**/
+VOID
+GetPsfPortRelaxedOrderingTables (
+  PSF_PORT_RELAXED_ORDERING_CONFIG_REG** PsfPortRelaxedOrderingConfigRegs,
+  UINT32*                                PsfPortRelaxedOrderingConfigRegsTableSize,
+  PSF_PORT_RELAXED_ORDERING_CONFIG_REG** PsfPortRelaxedOrderingConfigRegsPchTypeSpecific,
+  UINT32*                                PsfPortRelaxedOrderingConfigRegsPchTypeSpecificTableSize
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibVer2.c
new file mode 100644
index 0000000000..fd21e5bed4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibVer2.c
@@ -0,0 +1,115 @@
+/** @file
+  This file contains internal PSF routines for PCH PSF VER2 lib usage
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SataLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Register/PchRegsPsf.h>
+#include "PsfLibInternal.h"
+#include <PchPcieRpInfo.h>
+
+
+/**
+  Get EOI register data for given PSF ID
+
+  @param[in]  PsfId           PSF ID (1 - PSF1, 2 - PSF2, ...)
+  @param[out] EoiTargetBase   EOI Target register
+  @param[out] EoiControlBase  EOI Control register
+
+  @retval MaxTargets          Number of supported targets
+
+**/
+UINT8
+PsfEoiRegData (
+  UINT32        PsfId,
+  UINT16        *EoiTargetBase,
+  UINT16        *EoiControlBase
+  )
+{
+  UINT8  MaxTargets;
+
+  MaxTargets = 0;
+  *EoiTargetBase = 0;
+  *EoiControlBase = 0;
+
+  switch (PsfId) {
+    case 1:
+      break;
+
+    case 3:
+      break;
+
+    case 7:
+      break;
+
+    case 8:
+      break;
+
+    case 9:
+      break;
+
+    default:
+      break;
+
+  }
+  return MaxTargets;
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED PSF_PORT_DEST_ID PchLpRpDestId[] =
+{
+  {0x18000}, {0x18001}, {0x18002}, {0x18003}, // SPA: PSF1, PortID = 0
+  {0x18100}, {0x18101}, {0x18102}, {0x18103}, // SPB: PSF1, PortID = 1
+  {0x18200}, {0x18201}, {0x18202}, {0x18203}, // SPC: PSF1, PortID = 2
+};
+
+/**
+  PCIe PSF port destination ID (psf_id:port_group_id:port_id:channel_id)
+
+  @param[in] RpIndex        PCIe Root Port Index (0 based)
+
+  @retval Destination ID
+**/
+PSF_PORT_DEST_ID
+PsfPcieDestinationId (
+  IN UINT32  RpIndex
+  )
+{
+  if (RpIndex < ARRAY_SIZE (PchLpRpDestId)) {
+    return PchLpRpDestId[RpIndex];
+  }
+  ASSERT (FALSE);
+  return (PSF_PORT_DEST_ID){0};
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED PSF_SEGMENT mPchLpPsfTable[] =
+{
+  {1, PID_PSF1},
+  {2, PID_PSF2},
+  {3, PID_PSF3},
+  {4, PID_PSF4},
+  {5, PID_CSME_PSF},
+  {6, PID_PSF6}
+};
+
+/**
+  Get list of supported PSF segments.
+
+  @param[out] PsfTable        Array of supported PSF segments
+  @param[out] PsfTableLength  Length of PsfTable
+**/
+VOID
+PsfSegments (
+  OUT PSF_SEGMENT  **PsfTable,
+  OUT UINT32       *PsfTableLength
+  )
+{
+*PsfTable = mPchLpPsfTable;
+    *PsfTableLength = ARRAY_SIZE (mPchLpPsfTable);
+}
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (23 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component Heng Luo
                   ` (14 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Sata/Library

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/PeiDxeSmmSataLibVer2.inf |  32 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLib.c                | 138 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLibVer2.c            |  83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 253 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/PeiDxeSmmSataLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/PeiDxeSmmSataLibVer2.inf
new file mode 100644
index 0000000000..1c304fed59
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/PeiDxeSmmSataLibVer2.inf
@@ -0,0 +1,32 @@
+## @file
+# PEI/DXE/SMM PCH SATA library Ver2
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchSataLibVer2
+FILE_GUID = 2519ADE8-D971-4551-8A8E-2EB55DFC555B
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = SataLib
+
+[LibraryClasses]
+BaseLib
+PciSegmentLib
+PchInfoLib
+PchPciBdfLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+SataLib.c
+SataLibVer2.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLib.c
new file mode 100644
index 0000000000..49cba49910
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLib.c
@@ -0,0 +1,138 @@
+/** @file
+  Pch SATA library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SataLib.h>
+#include <Register/PchRegs.h>
+#include <Register/SataRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Get SATA controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller address in PCI Segment Library representation
+**/
+UINT64
+SataRegBase (
+  IN UINT32      SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+
+  return SataPciCfgBase (SataCtrlIndex);
+}
+
+/**
+  Get SATA controller's Port Present Status
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     Port Present Status
+**/
+UINT8
+GetSataPortPresentStatus (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+
+  return PciSegmentRead8 (SataPciCfgBase (SataCtrlIndex) + R_SATA_CFG_PCS + 2);
+}
+
+/**
+  Get SATA controller Function Disable Status
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval 0 SATA Controller is not Function Disabled
+  @retval 1 SATA Controller is Function Disabled
+**/
+BOOLEAN
+SataControllerFunctionDisableStatus (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  UINT32 SataGc;
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+  SataGc = PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) + R_SATA_CFG_SATAGC);
+  return !!(SataGc & BIT10);
+}
+
+/**
+  Get SATA controller ABAR size
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller ABAR size
+**/
+UINT32
+GetSataAbarSize (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  UINT32 SataGc;
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+  SataGc = PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) + R_SATA_CFG_SATAGC);
+
+  switch (SataGc & B_SATA_CFG_SATAGC_ASSEL) {
+    case V_SATA_CFG_SATAGC_ASSEL_2K:
+      return SIZE_2KB;
+      break;
+
+    case V_SATA_CFG_SATAGC_ASSEL_16K:
+      return SIZE_16KB;
+      break;
+
+    case V_SATA_CFG_SATAGC_ASSEL_32K:
+      return SIZE_32KB;
+      break;
+
+    case V_SATA_CFG_SATAGC_ASSEL_64K:
+      return SIZE_64KB;
+      break;
+
+    case V_SATA_CFG_SATAGC_ASSEL_128K:
+      return SIZE_128KB;
+      break;
+
+    case V_SATA_CFG_SATAGC_ASSEL_512K:
+      return SIZE_256KB;
+      break;
+
+    default:
+      return SIZE_2KB;
+      break;
+  }
+}
+
+/**
+  Get SATA controller AHCI base address
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller AHCI base address
+**/
+UINT32
+GetSataAhciBase (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+
+  return PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) + R_SATA_CFG_AHCI_BAR) & 0xFFFFF800;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLibVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLibVer2.c
new file mode 100644
index 0000000000..cde74e4e76
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/SataLibVer2.c
@@ -0,0 +1,83 @@
+/** @file
+  Pch SATA library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/DebugLib.h>
+#include <Library/PchInfoLib.h>
+#include <PchLimits.h>
+#include <Register/SataRegs.h>
+#include <Library/SataLib.h>
+
+/**
+  Get Maximum Sata Controller Number
+
+  @retval Maximum Sata Controller Number
+**/
+UINT8
+MaxSataControllerNum (
+  VOID
+  )
+{
+  return 1;
+}
+
+/**
+  Get Maximum Sata Port Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     Maximum Sata Port Number
+**/
+UINT8
+MaxSataPortNum (
+  IN UINT32      SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+
+  return 2;
+}
+
+/**
+  Check if SATA controller supports RST remapping
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval     TRUE                Controller supports remapping
+  @retval     FALSE               Controller does not support remapping
+
+**/
+BOOLEAN
+IsRemappingSupportedOnSata (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
+
+  return FALSE;
+}
+
+/**
+  Checks if SoC supports the SATA PGD power down on given
+  SATA controller.
+
+  @param[in] SataCtrlIndex  SATA controller index
+
+  @retval TRUE   SATA PGD power down supported
+  @retval FALSE  SATA PGD power down not supported
+**/
+BOOLEAN
+IsSataPowerGatingSupported (
+  IN UINT32 SataCtrlIndex
+  )
+{
+  return TRUE;
+}
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (24 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component Heng Luo
                   ` (13 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/SerialIo/IncludePrivate
  * IpBlock/SerialIo/Library
  * IpBlock/SerialIo/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>

Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/SerialIoPrivateLib.h                                    | 377 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/SerialIoRegsVer2.h                                     | 108 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf              |  35 +++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/SerialIoAccessLib.c                         | 266 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf |  34 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLib.c                | 156 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2c.c             | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c         |  70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibInternal.h        |  20 ++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpi.c             | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c         |  82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUart.c            | 136 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c        |  82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 13 files changed, 1610 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/SerialIoPrivateLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/SerialIoPrivateLib.h
new file mode 100644
index 0000000000..47057cd2ef
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/SerialIoPrivateLib.h
@@ -0,0 +1,377 @@
+/** @file
+  Header file for Serial IO Private Lib implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_PRIVATE_LIB_H_
+#define _SERIAL_IO_PRIVATE_LIB_H_
+
+#include <SerialIoDevices.h>
+#include <Library/SerialIoAccessLib.h>
+
+/**
+  Serial Io Pci Device State structure.
+  Used to preserve current information about the device when it is configured in Pci mode prior to Pch Initialization.
+**/
+typedef struct {
+  UINT64 PciCfgBar0;       ///< Pci Config Space Base Address Register
+  UINT8  PciCfgCommand;    ///< Pci Config Space Command Register
+  UINT8  PciCfgPmeCtrlSts; ///< Pci Config Space Pme Control Status
+  UINT8  PprReset;         ///< MMIO Proprietary Reset Register
+} SERIAL_IO_PCI_DEVICE_STATE;
+
+/**
+  Checks if higher functions are enabled.
+  Used for Function 0 Serial Io Device disabling
+
+  @param[in] DeviceNum       Device Number
+
+  @retval TRUE               At least one higher function device is enabled
+          FALSE              Higher functions are disabled
+**/
+BOOLEAN
+SerialIoHigherFunctionsEnabled (
+  IN UINT8                    DeviceNum
+  );
+
+/**
+  Places SerialIo device in D3
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoSetD3 (
+  IN UINT64                    PciCfgBase
+  );
+
+/**
+  Places SerialIo device in D0
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoSetD0 (
+  IN UINT64                    PciCfgBase
+  );
+
+/**
+  Allows Memory Access
+
+  @param[in] PciCfgBase       Pci Config Offset
+  @param[in] Hidden           Mode that determines access type
+
+**/
+VOID
+SerialIoEnableMse (
+  IN UINT64                    PciCfgBase,
+  IN BOOLEAN                   Hidden
+  );
+
+/**
+  Disable SerialIo memory access
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoDisableMse (
+  IN UINT64                    PciCfgBase
+  );
+
+/**
+  Disable SerialIo memory encoding
+  Designated for Pci modes
+
+  @param[in] PciCfgBase       Pci Config Offset
+  @param[in] RemoveTempBar    Remove temporary mem base address or not
+
+**/
+VOID
+SerialIoMmioDisable (
+  IN UINT64                    PciCfgBase,
+  IN BOOLEAN                   RemoveBar
+  );
+
+/**
+  Gets Fixed Base Address used for BAR0
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Config control offset
+**/
+UINT32
+GetSerialIoSpiFixedMmioAddress (
+  IN UINT8       SpiNumber
+  );
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoSpiFixedPciCfgAddress (
+  IN UINT8       SpiNumber
+  );
+
+/**
+  Gets Spi Device Id
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoSpiDeviceId (
+  IN UINT8       SpiNumber
+  );
+
+/**
+  Checks if SPI is Hidden, and it's Pci Config space available
+
+  @param[in] SpiNumber       Selects Serial IO SPI device
+
+  @retval   TRUE             SPI is in hidden mode
+  @retval   FALSE            SPI is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoSpiHidden (
+  IN UINT8               SpiNumber
+  );
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] SpiNumber         SPI Number
+  @param[in] SpiDeviceConfig   SerialIo SPI Config
+
+**/
+VOID
+SerialIoSpiBootHandler (
+  IN UINT8                      SpiNumber,
+  IN SERIAL_IO_SPI_CONFIG       *SpiDeviceConfig
+  );
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     SpiNumber         SPI Number
+  @param[in]     SpiDeviceConfig   SerialIo SPI Config
+  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
+  @param[in/out] Command           Pci Command register data to save
+  @param[in/out] Pme               Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoSpiS3Handler (
+  IN     UINT8                 SpiNumber,
+  IN     SERIAL_IO_SPI_CONFIG  *SpiDeviceConfig,
+  IN OUT UINT64                *S3PciCfgBase,
+  IN OUT UINT32                *Command,
+  IN OUT UINT32                *Pme
+  );
+
+/**
+  Gets Pci Config control offset
+
+  @param[in] UartNumber              Serial IO device UART number
+
+  @retval                            Config control offset
+**/
+UINT16
+GetSerialIoUartConfigControlOffset (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Gets Fixed Base Address used for BAR0
+
+  @param[in] UartNumber              Serial IO device UART number
+
+  @retval                            Config control offset
+**/
+UINT32
+GetSerialIoUartFixedMmioAddress (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] UartNumber              Serial IO device UART number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoUartFixedPciCfgAddress (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Returns UART S3 boot script PCI address
+
+  @param[in] UartNumber         UART Number
+
+  @retval    UART  S3 boot script PCI address
+**/
+UINT64
+GetSerialIoUartS3PciBase (
+  IN UINT8        UartNumber
+  );
+
+/**
+  Returns SPI S3 boot script PCI address
+
+  @param[in] UartNumber         UART Number
+
+  @retval    SPI S3 boot script PCI address
+**/
+UINT64
+GetSerialIoSpiS3PciBase (
+  IN UINT8        SpiNumber
+  );
+
+/**
+  Returns I2C S3 boot script PCI address
+
+  @param[in] I2cNumber         I2C Number
+
+  @retval    I2C  S3 boot script PCI address
+**/
+UINT64
+GetSerialIoI2cS3PciBase (
+  IN UINT8        I2cNumber
+  );
+
+/**
+  Gets Uarts Device Id
+
+  @param[in] UartNumbe               Serial IO device UART number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoUartDeviceId (
+  IN UINT8       UartNumber
+  );
+
+/**
+  Checks if UART is Hidden, and it's Pci Config space available
+
+  @param[in]      UartNumber     Selects Serial IO UART device
+
+  @retval   TRUE             UART is in hidden mode
+  @retval   FALSE            UART is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoUartHidden (
+  IN UINT8               UartNumber
+  );
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] UartNumber         UART Number
+  @param[in] UartDeviceConfig   SerialIo UART Config
+
+**/
+VOID
+SerialIoUartBootHandler (
+  IN UINT8                      UartNumber,
+  IN SERIAL_IO_UART_CONFIG      *UartDeviceConfig
+  );
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     UartNumber         UART Number
+  @param[in]     UartDeviceConfig   SerialIo UART Config
+  @param[in/out] S3PciCfgBase       S3 Boot Script Pci Config Base
+  @param[in/out] Command            Pci Command register data to save
+  @param[in/out] Pme                Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoUartS3Handler (
+  IN     UINT8                  UartNumber,
+  IN     SERIAL_IO_UART_CONFIG  *UartDeviceConfig,
+  IN OUT UINT64                 *S3PciCfgBase,
+  IN OUT UINT32                 *Command,
+  IN OUT UINT32                 *Pme
+  );
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] I2cNumber               Serial IO device I2C number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoI2cFixedPciCfgAddress (
+  IN UINT8       I2cNumber
+  );
+
+/**
+  Gets I2C Device Id
+
+  @param[in] I2cNumber               Serial IO device I2C number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoI2cDeviceId (
+  IN UINT8       I2cNumber
+  );
+
+/**
+  Checks if I2C is Hidden, and it's Pci Config space available
+
+  @param[in] 2cNumber        Selects Serial IO I2C device
+
+  @retval   TRUE             I2C is in hidden mode
+  @retval   FALSE            I2C is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoI2cHidden (
+  IN UINT8               I2cNumber
+  );
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] I2cNumber         I2C Number
+  @param[in] I2cDeviceConfig   SerialIo I2C Config
+
+**/
+VOID
+SerialIoI2cBootHandler (
+  IN UINT8                      I2cNumber,
+  IN SERIAL_IO_I2C_CONFIG       *I2cDeviceConfig
+  );
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     I2cNumber         I2C Number
+  @param[in]     I2cDeviceConfig   SerialIo I2C Config
+  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
+  @param[in/out] Command           Pci Command register data to save
+  @param[in/out] Pme               Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoI2cS3Handler (
+  IN     UINT8                 I2cNumber,
+  IN     SERIAL_IO_I2C_CONFIG  *I2cDeviceConfig,
+  IN OUT UINT64                *S3PciCfgBase,
+  IN OUT UINT32                *Command,
+  IN OUT UINT32                *Pme
+  );
+
+#endif // _SERIAL_IO_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/SerialIoRegsVer2.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/SerialIoRegsVer2.h
new file mode 100644
index 0000000000..01840b14c9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/SerialIoRegsVer2.h
@@ -0,0 +1,108 @@
+/** @file
+  Device IDs for Serial IO Controllers for TGL PCH
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_REGS_VER2_H_
+#define _SERIAL_IO_REGS_VER2_H_
+//
+//  Serial IO I2C0 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C0_DEVICE_ID       0xA0E8
+
+//
+//  Serial IO I2C1 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C1_DEVICE_ID       0xA0E9
+
+//
+//  Serial IO I2C2 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C2_DEVICE_ID       0xA0EA
+
+//
+//  Serial IO I2C3 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C3_DEVICE_ID       0xA0EB
+
+//
+//  Serial IO I2C4 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C4_DEVICE_ID       0xA0C5
+
+//
+//  Serial IO I2C5 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C5_DEVICE_ID       0xA0C6
+
+//
+//  Serial IO SPI0 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI0_DEVICE_ID       0xA0AA
+
+//
+//  Serial IO SPI1 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI1_DEVICE_ID       0xA0AB
+
+//
+//  Serial IO SPI2 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI2_DEVICE_ID       0xA0FB
+
+//
+//  Serial IO SPI3 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI3_DEVICE_ID       0xA0FD
+
+//
+//  Serial IO UART0 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART0_DEVICE_ID      0xA0A8
+
+//
+//  Serial IO UART1 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART1_DEVICE_ID      0xA0A9
+
+//
+//  Serial IO UART2 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART2_DEVICE_ID      0xA0C7
+
+//
+//  Serial IO UART3 Controller Registers
+//
+#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART3_DEVICE_ID      0xA0DA
+
+#endif //_SERIAL_IO_REGS_VER2_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
new file mode 100644
index 0000000000..9178840ca8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
@@ -0,0 +1,35 @@
+## @file
+# Component description file for PEI/DXE/SMM Serial Io Access Lib.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+  INF_VERSION    = 0x00010017
+  BASE_NAME      = PeiDxeSmmSerialIoAccessLib
+  FILE_GUID      = F1A20692-26CA-4CA4-A775-695BBD6D3EC7
+  VERSION_STRING = 1.0
+  MODULE_TYPE    = BASE
+  LIBRARY_CLASS  = SerialIoAccessLib
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  DebugLib
+  PcdLib
+  PciSegmentLib
+  PchPcrLib
+  SerialIoPrivateLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+  SerialIoAccessLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/SerialIoAccessLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/SerialIoAccessLib.c
new file mode 100644
index 0000000000..2b3a3dca5a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/SerialIoAccessLib.c
@@ -0,0 +1,266 @@
+/** @file
+  Serial Io Common Lib implementation.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Include/PcieRegs.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/DebugLib.h>
+#include <PchLimits.h>
+#include <PchReservedResources.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Returns BAR0
+
+  @param[in] PciCfgBase         Pci Config Base
+
+  @retval    64bit MMIO BAR Address
+**/
+UINT64
+GetSerialIoBar (
+  IN UINT64        PciCfgBase
+  )
+{
+  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
+    return (UINT64) ((PciSegmentRead32 ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET)) & 0xFFFFF000) + LShiftU64 (PciSegmentRead32 ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET + 4)), 32));
+  }
+  return (UINT64) ((MmioRead32 ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET)) & 0xFFFFF000) + LShiftU64 (MmioRead32 ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET + 4)), 32));
+}
+
+/**
+  Returns I2C Pci Config Space
+
+  @param[in] I2cNumber         I2C Number
+
+  @retval    I2C Pci Config Space Address
+**/
+UINT64
+GetSerialIoI2cPciCfg (
+  IN UINT8        I2cNumber
+  )
+{
+  if (IsSerialIoI2cHidden (I2cNumber)) {
+    return (UINTN) GetSerialIoI2cFixedPciCfgAddress (I2cNumber);
+  }
+  return SerialIoI2cPciCfgBase (I2cNumber);
+}
+
+/**
+  Returns SPI Pci Config Space
+
+  @param[in] SpiNumber         SPI Number
+
+  @retval    SPI Pci Config Space Address
+**/
+UINT64
+GetSerialIoSpiPciCfg (
+  IN UINT8        SpiNumber
+  )
+{
+  if (IsSerialIoSpiHidden (SpiNumber)) {
+    return (UINTN) GetSerialIoSpiFixedPciCfgAddress (SpiNumber);
+  }
+  return SerialIoSpiPciCfgBase (SpiNumber);
+}
+
+/**
+  Returns UART Pci Config Space
+
+  @param[in] UartNumber         UART Number
+
+  @retval    UART Pci Config Space Address
+**/
+UINT64
+GetSerialIoUartPciCfg (
+  IN UINT8        UartNumber
+  )
+{
+  if (IsSerialIoUartHidden (UartNumber)) {
+    return GetSerialIoUartFixedPciCfgAddress (UartNumber);
+  }
+  return SerialIoUartPciCfgBase (UartNumber);
+}
+
+/**
+  Returns SPI S3 boot script PCI address
+
+  @param[in] UartNumber         UART Number
+
+  @retval    SPI S3 boot script PCI address
+**/
+UINT64
+GetSerialIoSpiS3PciBase (
+  IN UINT8        SpiNumber
+  )
+{
+  if (IsSerialIoSpiHidden (SpiNumber)) {
+  //
+  // It's not expected to return Spi S3 Boot Script PCI address for non PCI mode.
+  //
+    ASSERT (TRUE);
+  }
+  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoSpiDevNumber (SpiNumber),
+           SerialIoSpiFuncNumber (SpiNumber),
+           0
+           );
+}
+
+/**
+  Returns UART S3 boot script PCI address
+
+  @param[in] UartNumber         UART Number
+
+  @retval    UART  S3 boot script PCI address
+**/
+UINT64
+GetSerialIoUartS3PciBase (
+  IN UINT8        UartNumber
+  )
+{
+  if (IsSerialIoUartHidden (UartNumber)) {
+  //
+  // It's not expected to return Uart S3 Boot Script PCI address for non PCI mode.
+  //
+    ASSERT (TRUE);
+  }
+  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoUartDevNumber (UartNumber),
+           SerialIoUartFuncNumber (UartNumber),
+           0
+           );
+}
+
+/**
+  Returns I2C S3 boot script PCI address
+
+  @param[in] I2cNumber         I2C Number
+
+  @retval    I2C  S3 boot script PCI address
+**/
+UINT64
+GetSerialIoI2cS3PciBase (
+  IN UINT8        I2cNumber
+  )
+{
+  if (IsSerialIoI2cHidden (I2cNumber)) {
+  //
+  // It's not expected to return I2c S3 Boot Script PCI address for non PCI mode.
+  //
+    ASSERT (TRUE);
+  }
+  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoI2cDevNumber (I2cNumber),
+           SerialIoI2cFuncNumber (I2cNumber),
+           0
+           );
+}
+
+/**
+  Checks if Device with given PciDeviceId is one of SerialIo I2C controllers
+  If yes, its number is returned through I2cIndex parameter, otherwise I2cIndex is not updated
+
+  @param[in]  PciDevId                  Device ID
+  @param[out] I2cNumber                 Number of SerialIo I2C controller
+
+  @retval TRUE                          yes it is a SerialIo I2C controller
+  @retval FALSE                         no it isn't a SerialIo I2C controller
+**/
+BOOLEAN
+IsSerialIoI2cDeviceId (
+  IN  UINT16    PciDevId,
+  OUT UINT8     *I2cNumber
+  )
+{
+  UINT8 Index;
+
+  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
+    if (PciDevId == GetSerialIoI2cDeviceId (Index)) {
+      *I2cNumber = Index;
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Checks if I2c is Function 0 Enabled
+
+  @param[in] I2cIndex                   Number of the SerialIo I2C controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoI2cFunction0Enabled (
+  IN UINT8    I2cIndex
+  )
+{
+  if (SerialIoI2cFuncNumber (I2cIndex) == 0) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cIndex))) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Checks if Uart is Function 0 Enabled
+
+  @param[in] UartIndex                   Number of the SerialIo Uart controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoUartFunction0Enabled (
+  IN UINT8    UartIndex
+  )
+{
+  if (SerialIoUartFuncNumber (UartIndex) == 0) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber (UartIndex))) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Checks if Spi is Function 0 Enabled
+
+  @param[in] SpiIndex                   Number of the SerialIo Spi controller
+
+  @retval TRUE                          Enabled
+  @retval FALSE                         Disabled
+**/
+BOOLEAN
+IsSerialIoSpiFunction0Enabled (
+  IN UINT8    SpiIndex
+  )
+{
+  if (SerialIoSpiFuncNumber (SpiIndex) == 0) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiIndex))) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
new file mode 100644
index 0000000000..8981be2496
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
@@ -0,0 +1,34 @@
+## @file
+# Serial Io Private Lib Ver 2
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  INF_VERSION    = 0x00010017
+  BASE_NAME      = PeiDxeSmmSerialIoLibVer2
+  FILE_GUID      = 9D9F99CD-C072-48C2-BF78-ABA3D664C0FA
+  VERSION_STRING = 1.0
+  MODULE_TYPE    = BASE
+  LIBRARY_CLASS  = SerialIoPrivateLib
+
+[LibraryClasses]
+  BaseLib
+  IoLib
+  PciSegmentLib
+  SerialIoAccessLib
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+  SerialIoPrivateLib.c
+  SerialIoPrivateLibI2c.c
+  SerialIoPrivateLibI2cVer2.c
+  SerialIoPrivateLibSpi.c
+  SerialIoPrivateLibSpiVer2.c
+  SerialIoPrivateLibUart.c
+  SerialIoPrivateLibUartVer2.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLib.c
new file mode 100644
index 0000000000..9b84c2dda6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLib.c
@@ -0,0 +1,156 @@
+/** @file
+  Serial IO Private Lib implementation.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Register/PchRegs.h>
+#include <Register/SerialIoRegs.h>
+#include <Include/PcieRegs.h>
+#include <IndustryStandard/Pci30.h>
+#include <PchReservedResources.h>
+
+/**
+  Checks if higher functions are enabled.
+  Used for Function 0 Serial Io Device disabling
+
+  @param[in] DeviceNum       Device Number
+
+  @retval TRUE               At least one higher function device is enabled
+          FALSE              Higher functions are disabled
+**/
+BOOLEAN
+SerialIoHigherFunctionsEnabled (
+  IN UINT8                    DeviceNum
+  )
+{
+  UINT8 FuncNum;
+  //
+  // Check all other func devs(1 to 7) status except func 0.
+  //
+  for (FuncNum = 1; FuncNum <= PCI_MAX_FUNC; FuncNum++) {
+    if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+                                                   DEFAULT_PCI_BUS_NUMBER_PCH,
+                                                   DeviceNum,
+                                                   FuncNum,
+                                                   PCI_DEVICE_ID_OFFSET)
+                          ) != 0xFFFF) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Places SerialIo device in D3
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoSetD3 (
+  IN UINT64                    PciCfgBase
+  )
+{
+  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
+    PciSegmentOr32 (PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, BIT1 | BIT0);
+  } else {
+    MmioOr8 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, BIT1 | BIT0);
+    //
+    // Reading back value after write to ensure bridge observes the BAR1 write access
+    //
+    MmioRead8 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
+  }
+}
+
+/**
+  Places SerialIo device in D0
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoSetD0 (
+  IN UINT64                    PciCfgBase
+  )
+{
+  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
+    PciSegmentAnd32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, (UINT32) ~(BIT1 | BIT0));
+  } else {
+    MmioAnd32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, (UINT32) ~(BIT1 | BIT0));
+    //
+    // Reading back value after write to ensure bridge observes the BAR1 write access
+    //
+    MmioRead32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
+  }
+}
+
+/**
+  Allows memory access
+
+  @param[in] PciCfgBase       Pci Config Offset
+  @param[in] Hidden           Mode that determines access type
+
+**/
+VOID
+SerialIoEnableMse (
+  IN UINT64                    PciCfgBase,
+  IN BOOLEAN                   Hidden
+  )
+{
+  if (Hidden) {
+    MmioOr16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+    //
+    // Reading back value after write to ensure bridge observes the BAR1 write access
+    //
+    MmioRead16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET);
+  } else {
+    PciSegmentOr16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+  }
+}
+
+/**
+  Disable SerialIo memory access
+
+  @param[in] PciCfgBase       Pci Config Offset
+
+**/
+VOID
+SerialIoDisableMse (
+  IN UINT64                    PciCfgBase
+  )
+{
+  PciSegmentAnd16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET, (UINT16) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+}
+
+/**
+  Disable SerialIo memory encoding
+  Designated for Pci modes
+
+  @param[in] PciCfgBase       Pci Config Offset
+  @param[in] RemoveTempBar    Remove temporary mem base address or not
+
+**/
+VOID
+SerialIoMmioDisable (
+  IN UINT64                    PciCfgBase,
+  IN BOOLEAN                   RemoveBar
+  )
+{
+  SerialIoDisableMse (PciCfgBase);
+
+  if (RemoveBar == TRUE) {
+    PciSegmentWrite32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_BAR0_LOW,  0x0);
+    PciSegmentWrite32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_BAR0_HIGH,  0x0);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2c.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2c.c
new file mode 100644
index 0000000000..7601081cfa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2c.c
@@ -0,0 +1,122 @@
+/** @file
+  Common Serial IO Private Lib implementation - I2C part
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Register/SerialIoRegs.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchLimits.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Checks if I2C is Hidden, and it's Pci Config space available
+
+  @param[in] I2cNumber     Selects Serial IO I2C device
+
+  @retval   TRUE             I2C is in hidden mode
+  @retval   FALSE            I2C is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoI2cHidden (
+  IN UINT8               I2cNumber
+  )
+{
+  if (MmioRead16 (GetSerialIoI2cFixedPciCfgAddress (I2cNumber) + PCI_DEVICE_ID_OFFSET) == GetSerialIoI2cDeviceId (I2cNumber)) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] I2cNumber         I2C Number
+  @param[in] I2cDeviceConfig   SerialIo I2C Config
+
+**/
+VOID
+SerialIoI2cBootHandler (
+  IN UINT8                      I2cNumber,
+  IN SERIAL_IO_I2C_CONFIG       *I2cDeviceConfig
+  )
+{
+  UINT64   PciCfgBase;
+  BOOLEAN  TurnOff;
+
+  TurnOff = FALSE;
+
+  if (I2cDeviceConfig->Mode == SerialIoI2cPci) {
+    TurnOff = TRUE;
+  }
+
+  if ((I2cDeviceConfig->Mode == SerialIoI2cDisabled) && (SerialIoI2cFuncNumber (I2cNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (TurnOff) {
+    PciCfgBase = GetSerialIoI2cPciCfg (I2cNumber);
+    SerialIoSetD3 (PciCfgBase);
+    SerialIoMmioDisable (PciCfgBase, TRUE);
+  }
+}
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     I2cNumber         I2C Number
+  @param[in]     I2cDeviceConfig   SerialIo I2C Config
+  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
+  @param[in/out] Command           Pci Command register data to save
+  @param[in/out] Pme               Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoI2cS3Handler (
+  IN     UINT8                 I2cNumber,
+  IN     SERIAL_IO_I2C_CONFIG  *I2cDeviceConfig,
+  IN OUT UINT64                *S3PciCfgBase,
+  IN OUT UINT32                *Command,
+  IN OUT UINT32                *Pme
+  )
+{
+  BOOLEAN  TurnOff;
+  UINT64   PciCfgBase;
+
+  *S3PciCfgBase = 0;
+  TurnOff       = FALSE;
+
+  if (I2cDeviceConfig->Mode == SerialIoI2cPci) {
+    TurnOff = TRUE;
+  }
+
+  if ((I2cDeviceConfig->Mode == SerialIoI2cDisabled) && (SerialIoI2cFuncNumber (I2cNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (TurnOff) {
+    *S3PciCfgBase = GetSerialIoI2cS3PciBase (I2cNumber);
+    PciCfgBase    = GetSerialIoI2cPciCfg (I2cNumber);
+    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
+    *Pme          = *Pme | BIT0 | BIT1;
+    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET);
+    *Command      = *Command & (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE | EFI_PCI_COMMAND_BUS_MASTER);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c
new file mode 100644
index 0000000000..fd684ca2a9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c
@@ -0,0 +1,70 @@
+/** @file
+  Serial IO I2C Private Lib implementation TigerLake specific.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Register/SerialIoRegsVer2.h>
+#include <IndustryStandard/Pci30.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchReservedResources.h>
+#include <PchLimits.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoI2cDevId [] = {
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C0_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C1_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C2_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C3_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C4_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C5_DEVICE_ID
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoI2cFixedAddress [] = {
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x0000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x1000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x2000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x3000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x4000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x5000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x6000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x7000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x8000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x9000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0xA000,  PCH_SERIAL_IO_BASE_ADDRESS + 0xB000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0xC000,  PCH_SERIAL_IO_BASE_ADDRESS + 0xD000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0xE000,  PCH_SERIAL_IO_BASE_ADDRESS + 0xF000}
+};
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] I2cNumber               Serial IO device I2C number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoI2cFixedPciCfgAddress (
+  IN UINT8       I2cNumber
+  )
+{
+  return mSerialIoI2cFixedAddress[I2cNumber].Bar1;
+}
+
+
+/**
+  Gets I2C Device Id
+
+  @param[in] I2cNumber               Serial IO device I2C number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoI2cDeviceId (
+  IN UINT8       I2cNumber
+  )
+{
+  return mPchLpSerialIoI2cDevId[I2cNumber];
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibInternal.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibInternal.h
new file mode 100644
index 0000000000..b5e8aba9ac
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibInternal.h
@@ -0,0 +1,20 @@
+/** @file
+  Header file for SerialIoPrivateLibInternal.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SERIAL_IO_PRIVATE_LIB_INTERNAL_H_
+#define _SERIAL_IO_PRIVATE_LIB_INTERNAL_H_
+
+typedef struct {
+  UINT32 Bar0;
+  UINT32 Bar1;
+} SERIAL_IO_CONTROLLER_DESCRIPTOR;
+
+typedef struct {
+  UINT8  DevNum;
+  UINT8  FuncNum;
+} SERIAL_IO_BDF_NUMBERS;
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpi.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpi.c
new file mode 100644
index 0000000000..a926941baf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpi.c
@@ -0,0 +1,122 @@
+/** @file
+  Common Serial IO Private Lib implementation - SPI part
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Register/SerialIoRegs.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchLimits.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Checks if SPI is Hidden, and it's Pci Config space available
+
+  @param[in]      SpiNumber     Selects Serial IO SPI device
+
+  @retval   TRUE             SPI is in hidden mode
+  @retval   FALSE            SPI is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoSpiHidden (
+  IN UINT8               SpiNumber
+  )
+{
+  if (MmioRead16 (GetSerialIoSpiFixedPciCfgAddress (SpiNumber) + PCI_DEVICE_ID_OFFSET) == GetSerialIoSpiDeviceId (SpiNumber)) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] SpiNumber         SPI Number
+  @param[in] SpiDeviceConfig   SerialIo SPI Config
+
+**/
+VOID
+SerialIoSpiBootHandler (
+  IN UINT8                      SpiNumber,
+  IN SERIAL_IO_SPI_CONFIG       *SpiDeviceConfig
+  )
+{
+  UINT64   PciCfgBase;
+  BOOLEAN  TurnOff;
+
+  TurnOff = FALSE;
+
+  if (SpiDeviceConfig->Mode == SerialIoSpiPci) {
+    TurnOff = TRUE;
+  }
+
+  if ((SpiDeviceConfig->Mode == SerialIoSpiDisabled) && (SerialIoSpiFuncNumber (SpiNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (TurnOff) {
+    PciCfgBase = GetSerialIoSpiPciCfg (SpiNumber);
+    SerialIoSetD3 (PciCfgBase);
+    SerialIoMmioDisable (PciCfgBase, TRUE);
+  }
+}
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     SpiNumber         SPI Number
+  @param[in]     SpiDeviceConfig   SerialIo SPI Config
+  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
+  @param[in/out] Command           Pci Command register data to save
+  @param[in/out] Pme               Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoSpiS3Handler (
+  IN     UINT8                 SpiNumber,
+  IN     SERIAL_IO_SPI_CONFIG  *SpiDeviceConfig,
+  IN OUT UINT64                *S3PciCfgBase,
+  IN OUT UINT32                *Command,
+  IN OUT UINT32                *Pme
+  )
+{
+  BOOLEAN  TurnOff;
+  UINT64   PciCfgBase;
+
+  *S3PciCfgBase = 0;
+  TurnOff       = FALSE;
+
+  if (SpiDeviceConfig->Mode == SerialIoSpiPci) {
+    TurnOff = TRUE;
+  }
+
+  if ((SpiDeviceConfig->Mode == SerialIoSpiDisabled) && (SerialIoSpiFuncNumber (SpiNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (TurnOff) {
+    *S3PciCfgBase = GetSerialIoSpiS3PciBase (SpiNumber);
+    PciCfgBase    = GetSerialIoSpiPciCfg (SpiNumber);
+    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
+    *Pme          = *Pme | BIT0 | BIT1;
+    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET);
+    *Command      = *Command & (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE | EFI_PCI_COMMAND_BUS_MASTER);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c
new file mode 100644
index 0000000000..abda359202
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c
@@ -0,0 +1,82 @@
+/** @file
+  Serial IO Spi Private Lib implementation TigerLake specific.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Register/SerialIoRegsVer2.h>
+#include <IndustryStandard/Pci30.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchReservedResources.h>
+#include <PchLimits.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoSpiDevId [] = {
+  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI0_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI1_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI2_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI3_DEVICE_ID
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoSpiFixedAddress [] = {
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x10000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x11000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x12000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x13000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x14000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x15000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x16000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x17000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x18000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x19000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1A000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x1B000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1C000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x1D000}
+};
+
+/**
+  Gets Fixed Base Address used for BAR0
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Config control offset
+**/
+UINT32
+GetSerialIoSpiFixedMmioAddress (
+  IN UINT8       SpiNumber
+  )
+{
+  return mSerialIoSpiFixedAddress[SpiNumber].Bar0;
+}
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoSpiFixedPciCfgAddress (
+  IN UINT8       SpiNumber
+  )
+{
+  return mSerialIoSpiFixedAddress[SpiNumber].Bar1;
+}
+
+/**
+  Gets Spi Device Id
+
+  @param[in] SpiNumber               Serial IO device SPI number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoSpiDeviceId (
+  IN UINT8       SpiNumber
+  )
+{
+  return mPchLpSerialIoSpiDevId[SpiNumber];
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUart.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUart.c
new file mode 100644
index 0000000000..0f7d6513ce
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUart.c
@@ -0,0 +1,136 @@
+/** @file
+  Serial IO Private Lib implementation - UART part
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Register/SerialIoRegs.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchLimits.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Checks if UART is Hidden, and it's Pci Config space available
+
+  @param[in]      UartNumber     Selects Serial IO UART device
+
+  @retval   TRUE             UART is in hidden mode
+  @retval   FALSE            UART is not in hidden mode
+**/
+BOOLEAN
+IsSerialIoUartHidden (
+  IN UINT8               UartNumber
+  )
+{
+  if (MmioRead16 (GetSerialIoUartFixedPciCfgAddress (UartNumber) + PCI_DEVICE_ID_OFFSET) == GetSerialIoUartDeviceId (UartNumber)) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Configures Serial IO Controller before control is passd to the OS
+
+  @param[in] UartNumber         UART Number
+  @param[in] UartDeviceConfig   SerialIo UART Config
+
+**/
+VOID
+SerialIoUartBootHandler (
+  IN UINT8                      UartNumber,
+  IN SERIAL_IO_UART_CONFIG      *UartDeviceConfig
+  )
+{
+  UINT64   PciCfgBase;
+  BOOLEAN  TurnOff;
+
+  TurnOff = FALSE;
+
+  //
+  // Even if Uart is Hidden and in D3 SerialIoUartLib is capable of setting D0 during each write/read.
+  // In case it is required for Os Debug DBG2 must be set to TRUE.
+  //
+  if (UartDeviceConfig->Mode == SerialIoUartPci || UartDeviceConfig->Mode == SerialIoUartHidden) {
+    TurnOff = TRUE;
+  }
+
+  //
+  // Uart in Com mode will be placed in D3 depending on PG configuration through ACPI _PS3
+  //
+
+  if ((UartDeviceConfig->Mode == SerialIoUartDisabled) && (SerialIoUartFuncNumber (UartNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber (UartNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (UartDeviceConfig->DBG2 == TRUE) {
+    TurnOff = FALSE;
+  }
+
+  if (TurnOff) {
+    PciCfgBase = GetSerialIoUartPciCfg (UartNumber);
+    SerialIoSetD3 (PciCfgBase);
+    if ((UartDeviceConfig->Mode == SerialIoUartPci) || (UartDeviceConfig->Mode == SerialIoUartDisabled)) {
+      SerialIoMmioDisable (PciCfgBase, TRUE);
+    }
+  }
+}
+
+/**
+  Sets Pme Control Status and Command register values required for S3 Boot Script
+
+  @param[in]     UartNumber         UART Number
+  @param[in]     UartDeviceConfig   SerialIo UART Config
+  @param[in/out] S3PciCfgBase       S3 Boot Script Pci Config Base
+  @param[in/out] Command            Pci Command register data to save
+  @param[in/out] Pme                Pci Pme Control register data to save
+
+**/
+VOID
+SerialIoUartS3Handler (
+  IN     UINT8                  UartNumber,
+  IN     SERIAL_IO_UART_CONFIG  *UartDeviceConfig,
+  IN OUT UINT64                 *S3PciCfgBase,
+  IN OUT UINT32                 *Command,
+  IN OUT UINT32                 *Pme
+  )
+{
+  BOOLEAN  TurnOff;
+  UINT64   PciCfgBase;
+
+  *S3PciCfgBase = 0;
+  TurnOff       = FALSE;
+
+  if (UartDeviceConfig->Mode == SerialIoUartPci) {
+    TurnOff = TRUE;
+  }
+
+  if ((UartDeviceConfig->Mode == SerialIoUartDisabled) && (SerialIoUartFuncNumber (UartNumber) == 0x0)) {
+    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber (UartNumber))) {
+      TurnOff = TRUE;
+    }
+  }
+
+  if (TurnOff) {
+    *S3PciCfgBase = GetSerialIoUartS3PciBase (UartNumber);
+    PciCfgBase    = GetSerialIoUartPciCfg (UartNumber);
+    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
+    *Pme          = *Pme | BIT0 | BIT1;
+    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET);
+    *Command      = *Command & (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE | EFI_PCI_COMMAND_BUS_MASTER);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c
new file mode 100644
index 0000000000..91280f8e90
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c
@@ -0,0 +1,82 @@
+/** @file
+  Serial IO Private Uart Lib implementation TigerLake specific.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Register/SerialIoRegsVer2.h>
+#include <IndustryStandard/Pci30.h>
+#include <SerialIoPrivateLibInternal.h>
+#include <PchReservedResources.h>
+#include <PchLimits.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoUartDevId [] = {
+  V_VER2_PCH_LP_SERIAL_IO_CFG_UART0_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_UART1_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_UART2_DEVICE_ID,
+  V_VER2_PCH_LP_SERIAL_IO_CFG_UART3_DEVICE_ID
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoUartFixedAddress [] = {
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1E000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x1F000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x20000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x21000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x22000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x23000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x24000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x25000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x26000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x27000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x28000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x29000},
+  {PCH_SERIAL_IO_BASE_ADDRESS + 0x2A000,  PCH_SERIAL_IO_BASE_ADDRESS + 0x2B000}
+};
+
+/**
+  Gets Fixed Base Address used for BAR0
+
+  @param[in] UartNumber              Serial IO device UART number
+
+  @retval                            Config control offset
+**/
+UINT32
+GetSerialIoUartFixedMmioAddress (
+  IN UINT8       UartNumber
+  )
+{
+  return mSerialIoUartFixedAddress[UartNumber].Bar0;
+}
+
+/**
+  Gets Fixed Address used for Pci Config Space manipulation
+
+  @param[in] UartNumber              Serial IO device UART number
+
+  @retval                            Pci Config Address
+**/
+UINT32
+GetSerialIoUartFixedPciCfgAddress (
+  IN UINT8       UartNumber
+  )
+{
+  return mSerialIoUartFixedAddress[UartNumber].Bar1;
+}
+
+/**
+  Gets Uarts Device Id
+
+  @param[in] UartNumbe               Serial IO device UART number
+
+  @retval                            Device Id
+**/
+UINT16
+GetSerialIoUartDeviceId (
+  IN UINT8       UartNumber
+  )
+{
+  return mPchLpSerialIoUartDevId[UartNumber];
+}
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (25 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component Heng Luo
                   ` (12 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Smbus/IncludePrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/SmbusRegs.h | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/SmbusRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/SmbusRegs.h
new file mode 100644
index 0000000000..c863615583
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/SmbusRegs.h
@@ -0,0 +1,50 @@
+/** @file
+  Register names for PCH Smbus Device.
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_REGS_SMBUS_H_
+#define _PCH_REGS_SMBUS_H_
+
+//
+// SMBus Controller Registers
+//
+#define R_SMBUS_CFG_BASE                      0x20
+#define B_SMBUS_CFG_BASE_BAR                  0x0000FFE0
+
+//
+// SMBus I/O Registers
+//
+#define R_SMBUS_IO_HSTS                  0x00  ///< Host Status Register R/W
+#define B_SMBUS_IO_SMBALERT_STS          0x20
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (26 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component Heng Luo
                   ` (11 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Spi/IncludePrivate
  * IpBlock/Spi/Library
  * IpBlock/Spi/LibraryPrivate
  * IpBlock/Spi/Smm

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAccessPrivateLib.h                                 |   40 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCommonLib.h                                        |  364 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRegs.h                                            |  136 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/PeiDxeSmmSpiAccessLib.inf                      |   33 ++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/SpiAccessLib.c                                 |  477 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/BaseSpiCommonLib.inf                         |   31 +++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/SpiCommon.c                                  | 1115 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf |   40 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/SpiAccessPrivateLib.c            |  133 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c                                                                    |  296 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf                                                               |   47 +++++++++++++++++++++++++++++++++++++
 11 files changed, 2712 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAccessPrivateLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAccessPrivateLib.h
new file mode 100644
index 0000000000..6da88a9047
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAccessPrivateLib.h
@@ -0,0 +1,40 @@
+/** @file
+  SPI library header for abstraction of SPI HW registers accesses
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SPI_ACCESS_PRIVATE_LIB_H_
+#define _SPI_ACCESS_PRIVATE_LIB_H_
+
+/**
+  Disable EISS (Enable InSMM.STS)
+**/
+VOID
+SpiDisableEiss (
+  VOID
+  );
+
+/**
+  Configure BiosLockEnable bit and BiosInterfaceLock bit according to policy setting.
+
+  @param[in] BiosLockEnable     Policy for BiosLockEnable bit programming
+  @param[in] BiosInterfaceLock  Policy for BiosInterfaceLock bit programming
+
+**/
+VOID
+SpiBiosLockEnableAndBiosInterfaceLockWithS3BootScript (
+  IN BOOLEAN  BiosLockEnable,
+  IN BOOLEAN  BiosInterfaceLock
+  );
+
+/**
+  Clears BIOS Write Protect Disable bit
+**/
+VOID
+SpiClearBiosWriteProtectDisable (
+  VOID
+  );
+
+#endif // _SPI_ACCESS_PRIVATE_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCommonLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCommonLib.h
new file mode 100644
index 0000000000..3290f77122
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCommonLib.h
@@ -0,0 +1,364 @@
+/** @file
+  Header file for the PCH SPI Common Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SPI_COMMON_LIB_H_
+#define _SPI_COMMON_LIB_H_
+
+#include <Protocol/Spi.h>
+
+//
+// Maximum time allowed while waiting the SPI cycle to complete
+//  Wait Time = 6 seconds = 6000000 microseconds
+//  Wait Period = 10 microseconds
+//
+#define SPI_WAIT_TIME   6000000     ///< Wait Time = 6 seconds = 6000000 microseconds
+#define SPI_WAIT_PERIOD 10          ///< Wait Period = 10 microseconds
+
+///
+/// Flash cycle Type
+///
+typedef enum {
+  FlashCycleRead,
+  FlashCycleWrite,
+  FlashCycleErase,
+  FlashCycleReadSfdp,
+  FlashCycleReadJedecId,
+  FlashCycleWriteStatus,
+  FlashCycleReadStatus,
+  FlashCycleMax
+} FLASH_CYCLE_TYPE;
+
+///
+/// Flash Component Number
+///
+typedef enum {
+  FlashComponent0,
+  FlashComponent1,
+  FlashComponentMax
+} FLASH_COMPONENT_NUM;
+
+///
+/// Private data structure definitions for the driver
+///
+#define PCH_SPI_PRIVATE_DATA_SIGNATURE  SIGNATURE_32 ('P', 'S', 'P', 'I')
+
+typedef struct {
+  UINT32                Signature;
+  EFI_HANDLE            Handle;
+  PCH_SPI_PROTOCOL      SpiProtocol;
+  UINT16                PchAcpiBase;
+  UINT64                PchSpiBase;
+  UINT8                 ReadPermission;
+  UINT8                 WritePermission;
+  UINT32                SfdpVscc0Value;
+  UINT32                SfdpVscc1Value;
+  UINT16                PchStrapBaseAddr;
+  UINT16                PchStrapSize;
+  UINT16                CpuStrapBaseAddr;
+  UINT16                CpuStrapSize;
+  UINT8                 NumberOfComponents;
+  UINT32                Component1StartAddr;
+  UINT32                TotalFlashSize;
+} SPI_INSTANCE;
+
+#define SPI_INSTANCE_FROM_SPIPROTOCOL(a)  CR (a, SPI_INSTANCE, SpiProtocol, PCH_SPI_PRIVATE_DATA_SIGNATURE)
+
+//
+// Function prototypes used by the SPI protocol.
+//
+
+/**
+  Initialize an SPI protocol instance.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval EFI_SUCCESS             The protocol instance was properly initialized
+  @exception EFI_UNSUPPORTED      The PCH is not supported by this module
+**/
+EFI_STATUS
+SpiProtocolConstructor (
+  IN     SPI_INSTANCE       *SpiInstance
+  );
+
+/**
+  This function is a hook for Spi to disable BIOS Write Protect
+
+  @retval EFI_SUCCESS             The protocol instance was properly initialized
+  @retval EFI_ACCESS_DENIED       The BIOS Region can only be updated in SMM phase
+
+**/
+EFI_STATUS
+EFIAPI
+DisableBiosWriteProtect (
+  VOID
+  );
+
+/**
+  This function is a hook for Spi to enable BIOS Write Protect
+
+
+**/
+VOID
+EFIAPI
+EnableBiosWriteProtect (
+  VOID
+  );
+
+/**
+  Acquire pch spi mmio address.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval PchSpiBar0              return SPI MMIO address
+**/
+UINTN
+AcquireSpiBar0 (
+  IN  SPI_INSTANCE                *SpiInstance
+  );
+
+/**
+  Release pch spi mmio address.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval None
+**/
+VOID
+ReleaseSpiBar0 (
+  IN  SPI_INSTANCE                *SpiInstance
+  );
+
+/**
+  Check if it's granted to do flash write.
+
+  @retval TRUE    It's secure to do flash write.
+  @retval FALSE   It's not secure to do flash write.
+**/
+BOOLEAN
+IsSpiFlashWriteGranted (
+  VOID
+  );
+
+/**
+  Read data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[out] Buffer              The Pointer to caller-allocated buffer containing the dada received.
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashRead (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *Buffer
+  );
+
+/**
+  Write data to the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[in] Buffer               Pointer to caller-allocated buffer containing the data sent during the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashWrite (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *Buffer
+  );
+
+/**
+  Erase some area on the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashErase (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount
+  );
+
+/**
+  Read SFDP data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] Address              The starting byte address for SFDP data read.
+  @param[in] ByteCount            Number of bytes in SFDP data portion of the SPI cycle
+  @param[out] SfdpData            The Pointer to caller-allocated buffer containing the SFDP data received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadSfdp (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *SfdpData
+  );
+
+/**
+  Read Jedec Id from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] ByteCount            Number of bytes in JedecId data portion of the SPI cycle, the data size is 3 typically
+  @param[out] JedecId             The Pointer to caller-allocated buffer containing JEDEC ID received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadJedecId (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *JedecId
+  );
+
+/**
+  Write the status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[in] StatusValue          The Pointer to caller-allocated buffer containing the value of Status register writing
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashWriteStatus (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *StatusValue
+  );
+
+/**
+  Read status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[out] StatusValue         The Pointer to caller-allocated buffer containing the value of Status register received.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadStatus (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *StatusValue
+  );
+
+/**
+  Get the SPI region base and size, based on the enum type
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for for the base address which is listed in the Descriptor.
+  @param[out] BaseAddress         The Flash Linear Address for the Region 'n' Base
+  @param[out] RegionSize          The size for the Region 'n'
+
+  @retval EFI_SUCCESS             Read success
+  @retval EFI_INVALID_PARAMETER   Invalid region type given
+  @retval EFI_DEVICE_ERROR        The region is not used
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolGetRegionAddress (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  OUT    UINT32             *BaseAddress,
+  OUT    UINT32             *RegionSize
+  );
+
+/**
+  Read PCH Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing PCH Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolReadPchSoftStrap (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  );
+
+/**
+  Read CPU Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        CPU Soft Strap address offset from FCPUSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle.
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing CPU Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolReadCpuSoftStrap (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRegs.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRegs.h
new file mode 100644
index 0000000000..8e2029500c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRegs.h
@@ -0,0 +1,136 @@
+/** @file
+  Register names for PCH SPI device.
+
+  Conventions:
+
+  - Register definition format:
+    Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterSpace_RegisterName
+  - Prefix:
+    Definitions beginning with "R_" are registers
+    Definitions beginning with "B_" are bits within registers
+    Definitions beginning with "V_" are meaningful values within the bits
+    Definitions beginning with "S_" are register size
+    Definitions beginning with "N_" are the bit position
+  - [GenerationName]:
+    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
+    Register name without GenerationName applies to all generations.
+  - [ComponentName]:
+    This field indicates the component name that the register belongs to (e.g. PCH, SA etc.)
+    Register name without ComponentName applies to all components.
+    Register that is specific to -LP denoted by "_PCH_LP_" in component name.
+  - SubsystemName:
+    This field indicates the subsystem name of the component that the register belongs to
+    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
+  - RegisterSpace:
+    MEM - MMIO space register of subsystem.
+    IO  - IO space register of subsystem.
+    PCR - Private configuration register of subsystem.
+    CFG - PCI configuration space register of subsystem.
+  - RegisterName:
+    Full register name.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SPI_REGS_H_
+#define _SPI_REGS_H_
+
+//
+// SPI Registers
+//
+#define R_SPI_CFG_BAR0                      0x10
+#define B_SPI_CFG_BAR0_MASK                 0x0FFF
+
+#define R_SPI_CFG_BDE                       0xD8
+
+#define R_SPI_CFG_BC                        0xDC
+#define S_SPI_CFG_BC                        4
+#define N_SPI_CFG_BC_ASE_BWP                11
+#define B_SPI_CFG_BC_ASE_BWP                BIT11
+#define N_SPI_CFG_BC_ASYNC_SS               10
+#define B_SPI_CFG_BC_ASYNC_SS               BIT10
+#define N_SPI_CFG_BC_SYNC_SS                8
+#define B_SPI_CFG_BC_SYNC_SS                BIT8
+#define B_SPI_CFG_BC_BILD                   BIT7
+#define B_SPI_CFG_BC_BBS                    BIT6            ///< Boot BIOS strap
+#define N_SPI_CFG_BC_BBS                    6
+#define V_SPI_CFG_BC_BBS_SPI                0               ///< Boot BIOS strapped to SPI
+#define B_SPI_CFG_BC_EISS                   BIT5            ///< Enable InSMM.STS
+#define B_SPI_CFG_BC_TSS                    BIT4
+#define B_SPI_CFG_BC_SRC                    (BIT3 | BIT2)
+#define N_SPI_CFG_BC_SRC                    2
+#define V_SPI_CFG_BC_SRC_PREF_DIS_CACHE_DIS 0x01            ///< No prefetching and no caching
+#define B_SPI_CFG_BC_LE                     BIT1            ///< Lock Enable
+#define N_SPI_CFG_BC_BLE                    1
+#define B_SPI_CFG_BC_WPD                    BIT0            ///< Write Protect Disable
+
+//
+// BIOS Flash Program Registers (based on SPI_BAR0)
+//
+#define R_SPI_MEM_HSFSC                     0x04                          ///< Hardware Sequencing Flash Status and Control Register(32bits)
+#define B_SPI_MEM_HSFSC_FDBC_MASK           0x3F000000                    ///< Flash Data Byte Count ( <= 64), Count = (Value in this field) + 1.
+#define N_SPI_MEM_HSFSC_FDBC                24
+#define B_SPI_MEM_HSFSC_CYCLE_MASK          0x001E0000                    ///< Flash Cycle.
+#define N_SPI_MEM_HSFSC_CYCLE               17
+#define V_SPI_MEM_HSFSC_CYCLE_READ          0                             ///< Flash Cycle Read
+#define V_SPI_MEM_HSFSC_CYCLE_WRITE         2                             ///< Flash Cycle Write
+#define V_SPI_MEM_HSFSC_CYCLE_4K_ERASE      3                             ///< Flash Cycle 4K Block Erase
+#define V_SPI_MEM_HSFSC_CYCLE_64K_ERASE     4                             ///< Flash Cycle 64K Sector Erase
+#define V_SPI_MEM_HSFSC_CYCLE_READ_SFDP     5                             ///< Flash Cycle Read SFDP
+#define V_SPI_MEM_HSFSC_CYCLE_READ_JEDEC_ID 6                             ///< Flash Cycle Read JEDEC ID
+#define V_SPI_MEM_HSFSC_CYCLE_WRITE_STATUS  7                             ///< Flash Cycle Write Status
+#define V_SPI_MEM_HSFSC_CYCLE_READ_STATUS   8                             ///< Flash Cycle Read Status
+#define B_SPI_MEM_HSFSC_CYCLE_FGO           BIT16                         ///< Flash Cycle Go.
+#define B_SPI_MEM_HSFSC_FLOCKDN             BIT15                         ///< Flash Configuration Lock-Down
+#define B_SPI_MEM_HSFSC_FDV                 BIT14                         ///< Flash Descriptor Valid, once valid software can use hareware sequencing regs
+#define B_SPI_MEM_HSFSC_FDOPSS              BIT13                         ///< Flash Descriptor Override Pin-Strap Status
+#define B_SPI_MEM_HSFSC_WRSDIS              BIT11                         ///< Write Status Disable
+#define B_SPI_MEM_HSFSC_SAF_MODE_ACTIVE     BIT7                          ///< Indicates flash is attached either directly to the PCH via the SPI bus or EC/BMC
+#define B_SPI_MEM_HSFSC_SCIP                BIT5                          ///< SPI cycle in progress
+#define B_SPI_MEM_HSFSC_SAF_DLE             BIT4                          ///< SAF Data length error
+#define B_SPI_MEM_HSFSC_SAF_ERROR           BIT3                          ///< SAF Error
+#define B_SPI_MEM_HSFSC_AEL                 BIT2                          ///< Access Error Log
+#define B_SPI_MEM_HSFSC_FCERR               BIT1                          ///< Flash Cycle Error
+#define B_SPI_MEM_HSFSC_FDONE               BIT0                          ///< Flash Cycle Done
+#define R_SPI_MEM_FADDR                     0x08                          ///< SPI Flash Address
+#define B_SPI_MEM_FADDR_MASK                0x07FFFFFF                    ///< SPI Flash Address Mask (0~26bit)
+#define R_SPI_MEM_DLOCK                     0x0C                          ///< Discrete Lock Bits
+#define B_SPI_MEM_DLOCK_PR0LOCKDN           BIT8                          ///< PR0LOCKDN
+#define R_SPI_MEM_FDATA00                   0x10                          ///< SPI Data 00 (32 bits)
+#define R_SPI_MEM_FRAP                      0x50                          ///< Flash Region Access Permissions Register
+#define B_SPI_MEM_FRAP_BRWA_MASK            0x0000FF00                    ///< BIOS Region Write Access MASK, Region0~7 - 0: Flash Descriptor; 1: BIOS; 2: ME; 3: GbE; 4: PlatformData
+#define N_SPI_MEM_FRAP_BRWA                 8                             ///< BIOS Region Write Access bit position
+#define B_SPI_MEM_FRAP_BRRA_MASK            0x000000FF                    ///< BIOS Region Read Access MASK, Region0~7 - 0: Flash Descriptor; 1: BIOS; 2: ME; 3: GbE; 4: PlatformData
+#define B_SPI_MEM_FRAP_BMRAG_MASK           0x00FF0000                    ///< BIOS Master Read Access Grant
+#define B_SPI_MEM_FRAP_BMWAG_MASK           0xFF000000                    ///< BIOS Master Write Access Grant
+#define R_SPI_MEM_FREG0_FLASHD              0x54                          ///< Flash Region 0(Flash Descriptor)(32bits)
+#define R_SPI_MEM_FREG3_GBE                 0x60                          ///< Flash Region 3(GbE)(32bits)
+#define S_SPI_MEM_FREGX                     4                             ///< Size of Flash Region register
+#define B_SPI_MEM_FREGX_LIMIT_MASK          0x7FFF0000                    ///< Flash Region Limit [30:16] represents [26:12], [11:0] are assumed to be FFFh
+#define N_SPI_MEM_FREGX_LIMIT               16                            ///< Region limit bit position
+#define N_SPI_MEM_FREGX_LIMIT_REPR          12                            ///< Region limit bit represents position
+#define B_SPI_MEM_FREGX_BASE_MASK           0x00007FFF                    ///< Flash Region Base, [14:0] represents [26:12]
+#define N_SPI_MEM_FREGX_BASE                0                             ///< Region base bit position
+#define N_SPI_MEM_FREGX_BASE_REPR           12                            ///< Region base bit represents position
+#define R_SPI_MEM_PR0                       0x84                          ///< Protected Region 0 Register
+#define S_SPI_MEM_PRX                       4                             ///< Protected Region X Register size
+#define B_SPI_MEM_PRX_WPE                   BIT31                         ///< Write Protection Enable
+#define B_SPI_MEM_PRX_PRL_MASK              0x7FFF0000                    ///< Protected Range Limit Mask, [30:16] here represents upper limit of address [26:12]
+#define N_SPI_MEM_PRX_PRL                   16                            ///< Protected Range Limit bit position
+#define B_SPI_MEM_PRX_RPE                   BIT15                         ///< Read Protection Enable
+#define B_SPI_MEM_PRX_PRB_MASK              0x00007FFF                    ///< Protected Range Base Mask, [14:0] here represents base limit of address [26:12]
+#define N_SPI_MEM_PRX_PRB                   0                             ///< Protected Range Base bit position
+#define R_SPI_MEM_FDOC                      0xB4                          ///< Flash Descriptor Observability Control Register(32 bits)
+#define B_SPI_MEM_FDOC_FDSS_MASK            (BIT14 | BIT13 | BIT12)       ///< Flash Descritor Section Select
+#define V_SPI_MEM_FDOC_FDSS_FSDM            0x0000                        ///< Flash Signature and Descriptor Map
+#define V_SPI_MEM_FDOC_FDSS_COMP            0x1000                        ///< Component
+#define V_SPI_MEM_FDOC_FDSS_MSTR            0x3000                        ///< Master
+#define B_SPI_MEM_FDOC_FDSI_MASK            0x0FFC                        ///< Flash Descriptor Section Index
+#define R_SPI_MEM_FDOD                      0xB8                          ///< Flash Descriptor Observability Data Register(32 bits)
+#define R_SPI_MEM_SFDP0_VSCC0               0xC4                          ///< Vendor Specific Component Capabilities Register(32 bits)
+#define B_SPI_MEM_SFDPX_VSCCX_CPPTV         BIT31                         ///< Component Property Parameter Table Valid
+#define B_SPI_MEM_SFDP0_VSCC0_VCL           BIT30                         ///< Vendor Component Lock
+#define B_SPI_MEM_SFDPX_VSCCX_EO_64K        BIT29                         ///< 64k Erase valid (EO_64k_valid)
+#define R_SPI_MEM_SFDP1_VSCC1               0xC8                          ///< Vendor Specific Component Capabilities Register(32 bits)
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/PeiDxeSmmSpiAccessLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/PeiDxeSmmSpiAccessLib.inf
new file mode 100644
index 0000000000..bba0b1fef3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/PeiDxeSmmSpiAccessLib.inf
@@ -0,0 +1,33 @@
+## @file
+# Component description file for PCH SPI access library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION     = 0x00010017
+BASE_NAME       = PeiDxeSmmSpiAccessLib
+FILE_GUID       = A6D4C05A-F6CB-46D5-4BA1-8C47B139DCA6
+VERSION_STRING  = 1.0
+MODULE_TYPE     = BASE
+LIBRARY_CLASS   = SpiAccessLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchPciBdfLib
+PchPcrLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+SpiAccessLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/SpiAccessLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/SpiAccessLib.c
new file mode 100644
index 0000000000..c91b9aaf4d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/SpiAccessLib.c
@@ -0,0 +1,477 @@
+/** @file
+  SPI library for abstraction of SPI HW registers accesses
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <IndustryStandard/Pci22.h>
+#include <Library/BaseLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/SpiAccessLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/PchPcrLib.h>
+#include <Register/SpiRegs.h>
+#include <Register/FlashRegs.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchDmiRegs.h>
+
+/**
+  Checks if PCH SPI Controler is present and available
+
+  @retval TRUE    PCH SPI controller is avaialable
+  @retval FALSE   PCH SPI controller is not available
+**/
+BOOLEAN
+SpiIsControllerAvailable (
+  VOID
+  )
+{
+  //
+  // Checks for SPI controller
+  //
+  return (PciSegmentRead16 (SpiPciCfgBase () + PCI_VENDOR_ID_OFFSET) != 0xFFFF);
+}
+
+/**
+  Returns PCH SPI BAR0 value
+
+  @retval  UINT32  PCH SPI BAR0 value
+**/
+UINT32
+SpiGetBar0 (
+  VOID
+  )
+{
+  UINT32  SpiBar0;
+
+  ASSERT (SpiIsControllerAvailable ());
+  SpiBar0 = PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BAR0) & ~B_SPI_CFG_BAR0_MASK;
+  ASSERT (SpiBar0 != 0);
+
+  return SpiBar0;
+}
+
+/**
+  Reads given descriptor section and returns value
+
+  @param[in] UINT16   Descriptor section
+  @param[in] UINT16   Offset
+
+  @retval UINT32      Read value from a section under given offset
+**/
+STATIC
+UINT32
+SpiReadDescriptor (
+  IN  UINT16  DescriptorSection,
+  IN  UINT16  Offset
+  )
+{
+  UINT32  SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  MmioWrite32 (SpiBar0 + R_SPI_MEM_FDOC, (DescriptorSection | Offset));
+  return MmioRead32 (SpiBar0 + R_SPI_MEM_FDOD);
+}
+
+/**
+  Returns descriptor signature
+
+  @retval UINT32    Descriptor signature
+**/
+UINT32
+SpiGetDescriptorSignature (
+  VOID
+  )
+{
+  //
+  // Read Descriptor offset 0x10 - To get Descriptor Signature
+  // Signature section 0x0000 + offset 0x0 which points to Descriptor offset 0x10
+  //
+  return SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM, 0x0);
+}
+
+/**
+  Returns supported features and R/W frequencies of Flash Component
+
+  @retval UINT32    Flash Component features descriptor
+**/
+UINT32
+SpiGetFlashComponentDescription (
+  VOID
+  )
+{
+  //
+  // Read Descriptor offset 0x30 - To get supported features and R/W frequencies
+  // Component section 0x1000 + offset 0x0 which points to Descriptor offset 0x30
+  //
+  return SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_COMP, 0x0);
+}
+
+/**
+  Returns number of Flash Components
+
+  @retval UINT32    Flash components number
+**/
+UINT32
+SpiGetFlashComponentsNumber (
+  VOID
+  )
+{
+  //
+  // Read Descriptor offset 0x14 - To get number of components
+  // Signature section 0x0000 + offset 0x4 which points to Descriptor offset 0x14
+  //
+  return ((SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM, R_FLASH_FDBAR_FLASH_MAP0) & B_FLASH_FDBAR_NC) >> N_FLASH_FDBAR_NC);
+}
+
+/**
+  Returns total Flash size with regards to number of flash components
+
+  @retval UINT32    Total Flash Memory size
+**/
+UINT32
+SpiGetTotalFlashSize (
+  VOID
+  )
+{
+  UINT32  Data32;
+  UINT32  ComponentsNumber;
+  UINT32  TotalFlashSize;
+
+  Data32 = SpiGetFlashComponentDescription ();
+  ComponentsNumber = SpiGetFlashComponentsNumber ();
+
+  TotalFlashSize = (V_FLASH_FLCOMP_COMP_512KB << ((UINT8) (Data32 & B_FLASH_FLCOMP_COMP0_MASK)));
+  if (ComponentsNumber == 1) {
+    TotalFlashSize += (V_FLASH_FLCOMP_COMP_512KB << ((UINT8) ((Data32 & B_FLASH_FLCOMP_COMP1_MASK) >> 4)));
+  }
+
+  return TotalFlashSize;
+}
+
+/**
+  Checks BIOS lock bits for proper value and checks if write protection is enabled
+  Expected vales are: LE bit set, EISS bit set and WPD bit cleared
+
+  @retval  TRUE    All protection bits are set correctly
+  @retval  FALSE   Not all protection bits had exepcted values
+**/
+BOOLEAN
+SpiIsWriteProtectionEnabled (
+  VOID
+  )
+{
+  UINT32  BiosControl;
+  BiosControl = PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC);
+
+  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL LE: %x\n", (BiosControl & B_SPI_CFG_BC_LE) != 0 ));
+  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL WPD: %x\n", (BiosControl & B_SPI_CFG_BC_WPD) != 0 ));
+  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL EISS: %x\n", (BiosControl & B_SPI_CFG_BC_EISS) != 0 ));
+
+  return (((BiosControl & B_SPI_CFG_BC_LE) != 0) &&
+          ((BiosControl & B_SPI_CFG_BC_WPD) == 0) &&
+          ((BiosControl & B_SPI_CFG_BC_EISS) != 0));
+}
+
+/**
+  Returns status of BIOS Interface Lockdown
+
+  @retval TRUE  BIOS Interface Lockdown is enabled
+  @retval FALSE BIOS Interface Lockdown is disabled
+**/
+BOOLEAN
+SpiIsBiosInterfaceLockdownEnabled (
+  VOID
+  )
+{
+  return !!(PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC) & B_SPI_CFG_BC_BILD);
+}
+
+/**
+  Returns Flash Descriptor Override Pin Strap status
+
+  @retval TRUE     Flash Descriptor override is enabled
+  @retval FALSE    Flash Descriptor override is disabled
+**/
+BOOLEAN
+SpiIsFlashDescriptorOverrideEnabled (
+  VOID
+  )
+{
+  UINT32  SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  return !!(MmioRead16 (SpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_FDOPSS);
+}
+
+/**
+  Returns Flash Configuration Lock Down bit status
+
+  @retval TRUE    Flash Configuration Lock Down bit is set
+  @retval FALSE   Flash Configuration Lock Down bit is not set
+**/
+BOOLEAN
+SpiIsFlashConfigurationLockDownEnabled (
+  VOID
+  )
+{
+  UINT32  SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  return !!(MmioRead16 (SpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_FLOCKDN);
+}
+
+/**
+  Returns Top Swap functionality enable state
+
+  @retval TRUE    Top Swap is enabled
+  @retval FALSE   Top Swap is disabled
+**/
+BOOLEAN
+SpiIsTopSwapEnabled (
+  VOID
+  )
+{
+  return !!(PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC) & B_SPI_CFG_BC_TSS);
+}
+
+/**
+  Return Component Property Parameter Table for a given component number
+
+  @param[in]  ComponentNumber   SPI Component number
+  @param[out] CppTable          Component Poperty Parameter Table value
+
+  @retval TRUE  Vendor Specific Component Capabilities Register value was read
+  @reval  FALSE Vendor Specific Component Capabilities Register value was not present
+**/
+BOOLEAN
+SpiGetComponentPropertyParameterTable (
+  IN  UINT8  ComponentNumber,
+  OUT UINT32 *CppTable
+  )
+{
+  UINT32 SpiBar0;
+  UINT32 Data32;
+  SpiBar0 = SpiGetBar0 ();
+
+  //
+  // More than 2 components not supported
+  //
+  switch (ComponentNumber) {
+    case 0:
+      *CppTable = MmioRead32 (SpiBar0 + R_SPI_MEM_SFDP0_VSCC0);
+      return TRUE;
+    case 1:
+      Data32    = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM, R_FLASH_FDBAR_FLASH_MAP0);
+      *CppTable = MmioRead32 (SpiBar0 + R_SPI_MEM_SFDP1_VSCC1);
+      return !!(Data32 & BIT8);
+    default:
+      return FALSE;
+  }
+}
+
+/**
+  Returns valid bit status in given Component Property Parameter Table
+
+  @param[in] CppTable          Component Poperty Parameter Table value
+
+  @retval TRUE    Valid bit is set
+  @reval  FALSE   Valid bit is not set
+**/
+BOOLEAN
+SpiIsCppValidBitSet (
+  IN UINT32  CppTable
+  )
+{
+  return !!(CppTable & B_SPI_MEM_SFDPX_VSCCX_CPPTV);
+}
+
+/**
+  Checks if Flash Descriptor is valid
+
+  @retval TRUE  Flash Descriptor is valid
+  @retval FALSE Flash Descriptor is invalid
+**/
+BOOLEAN
+SpiIsFlashDescriptorValid (
+  VOID
+  )
+{
+  UINT32 SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  return !!(MmioRead32 (SpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_FDV);
+}
+
+/**
+  Reads and returns value from Flash Region Access Permissions Register (FRAP)
+
+  @retval UINT32  Flash Region Access Permissions Register value
+**/
+STATIC
+UINT32
+SpiGetFlashRegionAccessPermissions (
+  VOID
+  )
+{
+  return MmioRead32 (SpiGetBar0 () + R_SPI_MEM_FRAP);
+}
+
+/**
+  Returns masked BIOS Master Read Access
+
+  @retval UINT32    Already masked BIOS Master Read Access
+**/
+UINT32
+SpiGetMasterReadAccess (
+  VOID
+  )
+{
+  UINT32 Data32;
+  Data32 = SpiGetFlashRegionAccessPermissions () & B_SPI_MEM_FRAP_BMRAG_MASK;
+  DEBUG ((DEBUG_INFO, "BMRAG 0x%x\n", Data32));
+
+  return Data32;
+}
+
+/**
+  Returns masked BIOS Master Write Access
+
+  @retval UINT32    Already masked BIOS Master Write Access
+**/
+UINT32
+SpiGetMasterWriteAccess (
+  VOID
+  )
+{
+  UINT32 Data32;
+  Data32 = SpiGetFlashRegionAccessPermissions () & B_SPI_MEM_FRAP_BMWAG_MASK;
+  DEBUG ((DEBUG_INFO, "BMWAG 0x%x\n", Data32));
+
+  return Data32;
+}
+
+/**
+  Returns GbE Region Access rights
+
+  @retval UINT32    GbE Region access rights
+**/
+UINT32
+SpiGetGbeRegionAccess (
+  VOID
+  )
+{
+  UINT32 Data32;
+
+  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x8);
+  DEBUG ((DEBUG_INFO, "GbE Region Access 0x%x\n", Data32));
+
+  return Data32;
+}
+
+/**
+  Returns CSME region access rights
+
+  @retval UINT32    CSME Region Access rights
+**/
+UINT32
+SpiGetCsmeRegionAccess (
+  VOID
+  )
+{
+  UINT32 Data32;
+
+  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x4);
+  DEBUG ((DEBUG_INFO, "CSME Region Access 0x%x\n", Data32));
+
+  return Data32;
+}
+
+/**
+  Returns EC region access right
+
+  @retval UINT32     EC Region access rights
+**/
+UINT32
+SpiGetEcRegionAccess (
+  VOID
+  )
+{
+  UINT32 Data32;
+
+  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x10);
+  DEBUG ((DEBUG_INFO, "EC Region Access 0x%x\n", Data32));
+
+  return Data32;
+}
+
+/**
+  Checks if Slave Attached Flash (SAF) mode is active
+
+  @retval TRUE    SAF mode is active
+  @retval FALSE   SAF mode is not active
+**/
+BOOLEAN
+SpiIsSafModeActive (
+  VOID
+  )
+{
+  UINT32 SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  return !!(MmioRead32 (SpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_SAF_MODE_ACTIVE);
+}
+
+/**
+  Checks validity of GbE region
+
+  @retval TRUE    GbE region is valid
+  @retval FALSE   GbE regios in invalid
+**/
+BOOLEAN
+SpiIsGbeRegionValid (
+  VOID
+  )
+{
+  UINT32  SpiBar0;
+  SpiBar0 = SpiGetBar0 ();
+
+  if (MmioRead32 (SpiBar0 + R_SPI_MEM_FREG3_GBE) != B_SPI_MEM_FREGX_BASE_MASK) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Returns TRUE if BIOS Boot Strap is set to SPI
+
+  @retval TRUE    BIOS Boot strap is set to SPI
+  @retval FALSE   BIOS Boot strap is set to LPC/eSPI
+**/
+BOOLEAN
+SpiIsBiosBootFromSpi (
+  VOID
+  )
+{
+  return !!(((PciSegmentRead8 (SpiPciCfgBase () + R_SPI_CFG_BC) & B_SPI_CFG_BC_BBS) >> N_SPI_CFG_BC_BBS) == V_SPI_CFG_BC_BBS_SPI);
+}
+
+/**
+  Check SPI write status disable is set
+
+  @retval TRUE    Write status disable is set
+  @retval FALSE   Write status disable is not set
+**/
+BOOLEAN
+SpiIsWriteStatusDisable (
+  VOID
+  )
+{
+  return !!(MmioRead32 (SpiGetBar0 () + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_WRSDIS);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/BaseSpiCommonLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/BaseSpiCommonLib.inf
new file mode 100644
index 0000000000..a1a5467745
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/BaseSpiCommonLib.inf
@@ -0,0 +1,31 @@
+## @file
+#  Component description file for the PchSpiCommonLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BaseSpiCommonLib
+  FILE_GUID                      = A37CB67E-7D85-45B3-B07E-BF65BDB603E8
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = SpiCommonLib
+
+[Sources]
+  SpiCommon.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[LibraryClasses]
+  IoLib
+  DebugLib
+  PmcLib
+  PchPciBdfLib
+  SpiAccessLib
+
+[Pcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/SpiCommon.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/SpiCommon.c
new file mode 100644
index 0000000000..954b349e7c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/SpiCommon.c
@@ -0,0 +1,1115 @@
+/** @file
+  PCH SPI Common Driver implements the SPI Host Controller Compatibility Interface.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/BaseLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Library/PmcLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Protocol/Spi.h>
+#include <Library/SpiCommonLib.h>
+#include <Register/PchRegs.h>
+#include <Register/SpiRegs.h>
+#include <Register/FlashRegs.h>
+#include <Register/PmcRegs.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/SpiAccessLib.h>
+
+/**
+  Initialize an SPI protocol instance.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval EFI_SUCCESS             The protocol instance was properly initialized
+  @exception EFI_UNSUPPORTED      The PCH is not supported by this module
+**/
+EFI_STATUS
+SpiProtocolConstructor (
+  IN     SPI_INSTANCE       *SpiInstance
+  )
+{
+  UINTN           PchSpiBar0;
+  UINT32          Data32;
+  UINT16          Mdtba;
+  EFI_STATUS      Status;
+
+  //
+  // Initialize the SPI protocol instance
+  //
+  SpiInstance->Signature                    = PCH_SPI_PRIVATE_DATA_SIGNATURE;
+  SpiInstance->Handle                       = NULL;
+  SpiInstance->SpiProtocol.Revision         = PCH_SPI_SERVICES_REVISION;
+  SpiInstance->SpiProtocol.FlashRead        = SpiProtocolFlashRead;
+  SpiInstance->SpiProtocol.FlashWrite       = SpiProtocolFlashWrite;
+  SpiInstance->SpiProtocol.FlashErase       = SpiProtocolFlashErase;
+  SpiInstance->SpiProtocol.FlashReadSfdp    = SpiProtocolFlashReadSfdp;
+  SpiInstance->SpiProtocol.FlashReadJedecId = SpiProtocolFlashReadJedecId;
+  SpiInstance->SpiProtocol.FlashWriteStatus = SpiProtocolFlashWriteStatus;
+  SpiInstance->SpiProtocol.FlashReadStatus  = SpiProtocolFlashReadStatus;
+  SpiInstance->SpiProtocol.GetRegionAddress = SpiProtocolGetRegionAddress;
+  SpiInstance->SpiProtocol.ReadPchSoftStrap = SpiProtocolReadPchSoftStrap;
+  SpiInstance->SpiProtocol.ReadCpuSoftStrap = SpiProtocolReadCpuSoftStrap;
+
+  SpiInstance->PchSpiBase = SpiPciCfgBase ();
+
+  SpiInstance->PchAcpiBase = PmcGetAcpiBase ();
+  ASSERT (SpiInstance->PchAcpiBase != 0);
+
+  PchSpiBar0 = PciSegmentRead32 (SpiInstance->PchSpiBase + R_SPI_CFG_BAR0) & ~(B_SPI_CFG_BAR0_MASK);
+  if (PchSpiBar0 == 0) {
+    DEBUG ((DEBUG_ERROR, "ERROR : PchSpiBar0 is invalid!\n"));
+    ASSERT (FALSE);
+  }
+
+  if ((MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_FDV) == 0) {
+    DEBUG ((DEBUG_ERROR, "ERROR : SPI Flash Signature invalid, cannot use the Hardware Sequencing registers!\n"));
+    ASSERT (FALSE);
+  }
+
+  //
+  // Get Region 0 - 7 read Permission bits, region 8 and above are not permitted.
+  //
+  SpiInstance->ReadPermission = MmioRead8 (PchSpiBar0 + R_SPI_MEM_FRAP) & B_SPI_MEM_FRAP_BRRA_MASK;
+  DEBUG ((DEBUG_INFO, "Flash Region read Permission : %0x\n", SpiInstance->ReadPermission));
+  //
+  // Get Region 0 - 7 write Permission bits, region 8 and above are not permitted.
+  //
+  SpiInstance->WritePermission = (UINT8) ((MmioRead16 (PchSpiBar0 + R_SPI_MEM_FRAP) &
+                                           B_SPI_MEM_FRAP_BRWA_MASK) >> N_SPI_MEM_FRAP_BRWA);
+  DEBUG ((DEBUG_INFO, "Flash Region write Permission : %0x\n", SpiInstance->WritePermission));
+
+  SpiInstance->SfdpVscc0Value = MmioRead32 (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0);
+  DEBUG ((DEBUG_INFO, "Component 0 SFDP VSCC value : %0x\n", SpiInstance->SfdpVscc0Value));
+  SpiInstance->SfdpVscc1Value = MmioRead32 (PchSpiBar0 + R_SPI_MEM_SFDP1_VSCC1);
+  DEBUG ((DEBUG_INFO, "Component 1 SFDP VSCC value : %0x\n", SpiInstance->SfdpVscc1Value));
+
+  //
+  // Select to Flash Map 0 Register to get the number of flash Component
+  //
+  MmioAndThenOr32 (
+    PchSpiBar0 + R_SPI_MEM_FDOC,
+    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK | B_SPI_MEM_FDOC_FDSI_MASK)),
+    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM | R_FLASH_FDBAR_FLASH_MAP0)
+    );
+
+  //
+  // Copy Zero based Number Of Components
+  //
+  SpiInstance->NumberOfComponents = (UINT8) ((MmioRead16 (PchSpiBar0 + R_SPI_MEM_FDOD) & B_FLASH_FDBAR_NC) >> N_FLASH_FDBAR_NC);
+  DEBUG ((DEBUG_INFO, "Component Number : %0x\n", SpiInstance->NumberOfComponents + 1));
+
+  MmioAndThenOr32 (
+    PchSpiBar0 + R_SPI_MEM_FDOC,
+    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK | B_SPI_MEM_FDOC_FDSI_MASK)),
+    (UINT32) (V_SPI_MEM_FDOC_FDSS_COMP | R_FLASH_FCBA_FLCOMP)
+    );
+
+  //
+  // Copy Component 0 Density
+  //
+  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
+  if (SpiInstance->NumberOfComponents > 0) {
+    SpiInstance->Component1StartAddr = V_FLASH_FLCOMP_COMP_512KB <<
+      (Data32 & B_FLASH_FLCOMP_COMP0_MASK);
+    DEBUG ((DEBUG_INFO, "Component 1 StartAddr : %0x\n", SpiInstance->Component1StartAddr));
+    SpiInstance->TotalFlashSize = SpiInstance->Component1StartAddr +
+      (V_FLASH_FLCOMP_COMP_512KB <<
+      ((Data32 & B_FLASH_FLCOMP_COMP1_MASK) >>
+      N_FLASH_FLCOMP_COMP1));
+  } else {
+    SpiInstance->TotalFlashSize = V_FLASH_FLCOMP_COMP_512KB <<
+      (Data32 & B_FLASH_FLCOMP_COMP0_MASK);
+  }
+  DEBUG ((DEBUG_INFO, "Total Flash Size : %0x\n", SpiInstance->TotalFlashSize));
+
+  //
+  // Select FLASH_MAP1 to get Flash PCH Strap Base Address
+  //
+  MmioAndThenOr32 (
+    (PchSpiBar0 + R_SPI_MEM_FDOC),
+    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK | B_SPI_MEM_FDOC_FDSI_MASK)),
+    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM | R_FLASH_FDBAR_FLASH_MAP1)
+    );
+  //
+  // Align FPSBA with address bits for the PCH Strap portion of flash descriptor
+  //
+  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
+  SpiInstance->PchStrapBaseAddr = (UINT16) (((Data32 & B_FLASH_FDBAR_FPSBA)
+                                             >> N_FLASH_FDBAR_FPSBA)
+                                            << N_FLASH_FDBAR_FPSBA_REPR);
+  DEBUG ((DEBUG_INFO, "PchStrapBaseAddr : %0x\n", SpiInstance->PchStrapBaseAddr));
+  ASSERT (SpiInstance->PchStrapBaseAddr != 0);
+  //
+  // PCH Strap Length, [31:24] represents number of Dwords
+  //
+  SpiInstance->PchStrapSize = (UINT16) (((Data32 & B_FLASH_FDBAR_PCHSL)
+                                         >> N_FLASH_FDBAR_PCHSL)
+                                        * sizeof (UINT32));
+  DEBUG ((DEBUG_INFO, "PchStrapSize : %0x\n", SpiInstance->PchStrapSize));
+
+  //
+  // Select FLASH_MAP2 to get Flash CPU Strap Base Address
+  //
+  MmioAndThenOr32 (
+    (PchSpiBar0 + R_SPI_MEM_FDOC),
+    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK | B_SPI_MEM_FDOC_FDSI_MASK)),
+    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM | R_FLASH_FDBAR_FLASH_MAP2)
+    );
+  //
+  // Align FPSBA with address bits for the CPU Strap portion of flash descriptor
+  //
+  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
+  //
+  // CPU Strap Length, [23:16] represents number of Dwords
+  //
+  SpiInstance->CpuStrapSize = (UINT16) (((Data32 & B_FLASH_FDBAR_CPUSL)
+                                         >> N_FLASH_FDBAR_CPUSL)
+                                        * sizeof (UINT32));
+
+  //
+  // CPU Strap Address [11:2] represent offset from MDTBA
+  //
+  SpiInstance->CpuStrapBaseAddr = (UINT16) ((Data32 & B_FLASH_FDBAR_FCPUSBA) >> N_FLASH_FDBAR_FCPUSBA);
+  ASSERT (SpiInstance->CpuStrapBaseAddr != 0);
+
+  if (SpiInstance->CpuStrapBaseAddr != 0x300) {
+    Status = SpiProtocolFlashRead (&(SpiInstance->SpiProtocol), FlashRegionAll, R_FLASH_UMAP1, sizeof (Data32), (UINT8 *) (&Data32));
+    ASSERT_EFI_ERROR (Status);
+    Mdtba = (UINT16)(((Data32 & B_FLASH_UMAP1_MDTBA) >> N_FLASH_UMAP1_MDTBA) << N_FLASH_UMAP1_MDTBA_REPR);
+    DEBUG ((DEBUG_INFO, "Mdtba : %0x\n", Mdtba));
+    // Add MDTBA offset for final address of CPU Straps
+    SpiInstance->CpuStrapBaseAddr += Mdtba;
+  }
+
+  DEBUG ((DEBUG_INFO, "CpuStrapBaseAddr : %0x\n", SpiInstance->CpuStrapBaseAddr));
+  DEBUG ((DEBUG_INFO, "CpuStrapSize : %0x\n", SpiInstance->CpuStrapSize));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Delay for at least the request number of microseconds for Runtime usage.
+
+  @param[in] ABase                Acpi base address
+  @param[in] Microseconds         Number of microseconds to delay.
+
+**/
+VOID
+EFIAPI
+PchPmTimerStallRuntimeSafe (
+  IN  UINT16  ABase,
+  IN  UINTN   Microseconds
+  )
+{
+  UINTN   Ticks;
+  UINTN   Counts;
+  UINTN   CurrentTick;
+  UINTN   OriginalTick;
+  UINTN   RemainingTick;
+
+  if (Microseconds == 0) {
+    return;
+  }
+
+  OriginalTick   = IoRead32 ((UINTN) (ABase + R_ACPI_IO_PM1_TMR)) & B_ACPI_IO_PM1_TMR_VAL;
+  CurrentTick    = OriginalTick;
+
+  //
+  // The timer frequency is 3.579545 MHz, so 1 ms corresponds 3.58 clocks
+  //
+  Ticks = Microseconds * 358 / 100 + OriginalTick + 1;
+
+  //
+  // The loops needed by timer overflow
+  //
+  Counts = Ticks / V_ACPI_IO_PM1_TMR_MAX_VAL;
+
+  //
+  // Remaining clocks within one loop
+  //
+  RemainingTick = Ticks % V_ACPI_IO_PM1_TMR_MAX_VAL;
+
+  //
+  // not intend to use TMROF_STS bit of register PM1_STS, because this adds extra
+  // one I/O operation, and maybe generate SMI
+  //
+  while ((Counts != 0) || (RemainingTick > CurrentTick)) {
+    CurrentTick = IoRead32 ((UINTN) (ABase + R_ACPI_IO_PM1_TMR)) & B_ACPI_IO_PM1_TMR_VAL;
+    //
+    // Check if timer overflow
+    //
+    if ((CurrentTick < OriginalTick)) {
+      if (Counts != 0) {
+        Counts--;
+      } else {
+        //
+        // If timer overflow and Counts equ to 0, that means we already stalled more than
+        // RemainingTick, break the loop here
+        //
+        break;
+      }
+    }
+
+    OriginalTick = CurrentTick;
+  }
+}
+
+/**
+  Wait execution cycle to complete on the SPI interface.
+
+  @param[in] This                 The SPI protocol instance
+  @param[in] PchSpiBar0           Spi MMIO base address
+  @param[in] ErrorCheck           TRUE if the SpiCycle needs to do the error check
+
+  @retval TRUE                    SPI cycle completed on the interface.
+  @retval FALSE                   Time out while waiting the SPI cycle to complete.
+                                  It's not safe to program the next command on the SPI interface.
+**/
+STATIC
+BOOLEAN
+WaitForSpiCycleComplete (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINTN              PchSpiBar0,
+  IN     BOOLEAN            ErrorCheck
+  )
+{
+  UINT64        WaitTicks;
+  UINT64        WaitCount;
+  UINT32        Data32;
+  SPI_INSTANCE  *SpiInstance;
+
+  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+
+  //
+  // Convert the wait period allowed into to tick count
+  //
+  WaitCount = SPI_WAIT_TIME / SPI_WAIT_PERIOD;
+  //
+  // Wait for the SPI cycle to complete.
+  //
+  for (WaitTicks = 0; WaitTicks < WaitCount; WaitTicks++) {
+    Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC);
+    if ((Data32 & B_SPI_MEM_HSFSC_SCIP) == 0) {
+      MmioWrite32 (PchSpiBar0 + R_SPI_MEM_HSFSC, B_SPI_MEM_HSFSC_FCERR | B_SPI_MEM_HSFSC_FDONE);
+      if (((Data32 & B_SPI_MEM_HSFSC_FCERR) != 0) && (ErrorCheck == TRUE)) {
+        return FALSE;
+      } else {
+        return TRUE;
+      }
+    }
+    PchPmTimerStallRuntimeSafe (SpiInstance->PchAcpiBase, SPI_WAIT_PERIOD);
+  }
+  return FALSE;
+}
+
+/**
+  This function sends the programmed SPI command to the slave device.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SpiRegionType        The SPI Region type for flash cycle which is listed in the Descriptor
+  @param[in] FlashCycleType       The Flash SPI cycle type list in HSFC (Hardware Sequencing Flash Control Register) register
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[in,out] Buffer           Pointer to caller-allocated buffer containing the dada received or sent during the SPI cycle.
+
+  @retval EFI_SUCCESS             SPI command completes successfully.
+  @retval EFI_DEVICE_ERROR        Device error, the command aborts abnormally.
+  @retval EFI_ACCESS_DENIED       Some unrecognized or blocked command encountered in hardware sequencing mode
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+**/
+STATIC
+EFI_STATUS
+SendSpiCmd (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     FLASH_CYCLE_TYPE   FlashCycleType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  IN OUT UINT8              *Buffer
+  )
+{
+  EFI_STATUS      Status;
+  UINT32          Index;
+  SPI_INSTANCE    *SpiInstance;
+  UINT64          SpiBaseAddress;
+  UINTN           PchSpiBar0;
+  UINT32          HardwareSpiAddr;
+  UINT32          FlashRegionSize;
+  UINT32          SpiDataCount;
+  UINT32          FlashCycle;
+  UINT8           BiosCtlSave;
+  UINT32          SmiEnSave;
+  UINT16          ABase;
+  UINT32          HsfstsCtl;
+
+  //
+  // For flash write, there is a requirement that all CPU threads are in SMM
+  // before the flash protection is disabled.
+  //
+  if ((FlashCycleType == FlashCycleWrite) || (FlashCycleType == FlashCycleErase)) {
+    if (!IsSpiFlashWriteGranted ()) {
+      return EFI_ACCESS_DENIED;
+    }
+  }
+
+  Status            = EFI_SUCCESS;
+  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+  SpiBaseAddress    = SpiInstance->PchSpiBase;
+  PchSpiBar0        = AcquireSpiBar0 (SpiInstance);
+  ABase             = SpiInstance->PchAcpiBase;
+
+  //
+  // Disable SMIs to make sure normal mode flash access is not interrupted by an SMI
+  // whose SMI handler accesses flash (e.g. for error logging)
+  //
+  // *** NOTE: if the SMI_LOCK bit is set (i.e., PMC PCI Offset A0h [4]='1'),
+  // clearing B_GBL_SMI_EN will not have effect. In this situation, some other
+  // synchronization methods must be applied here or in the consumer of the
+  // SendSpiCmd. An example method is disabling the specific SMI sources
+  // whose SMI handlers access flash before flash cycle and re-enabling the SMI
+  // sources after the flash cycle .
+  //
+  SmiEnSave   = IoRead32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN));
+  IoWrite32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN), SmiEnSave & (UINT32) (~B_ACPI_IO_SMI_EN_GBL_SMI));
+  BiosCtlSave = PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) & B_SPI_CFG_BC_SRC;
+
+  //
+  // If it's write cycle, disable Prefetching, Caching and disable BIOS Write Protect
+  //
+  if ((FlashCycleType == FlashCycleWrite) ||
+      (FlashCycleType == FlashCycleErase)) {
+    Status = DisableBiosWriteProtect ();
+    if (EFI_ERROR (Status)) {
+      goto SendSpiCmdEnd;
+    }
+    PciSegmentAndThenOr8 (
+      SpiBaseAddress + R_SPI_CFG_BC,
+      (UINT8) (~B_SPI_CFG_BC_SRC),
+      (UINT8) (V_SPI_CFG_BC_SRC_PREF_DIS_CACHE_DIS <<  N_SPI_CFG_BC_SRC)
+      );
+  }
+  //
+  // Make sure it's safe to program the command.
+  //
+  if (!WaitForSpiCycleComplete (This, PchSpiBar0, FALSE)) {
+    Status = EFI_DEVICE_ERROR;
+    goto SendSpiCmdEnd;
+  }
+
+  //
+  // Check if Write Status isn't disabled in HW Sequencing
+  //
+  if (FlashCycleType == FlashCycleWriteStatus) {
+    HsfstsCtl = MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC);
+    if ((HsfstsCtl & B_SPI_MEM_HSFSC_WRSDIS) != 0) {
+      Status = EFI_ACCESS_DENIED;
+      goto SendSpiCmdEnd;
+    }
+  }
+
+  Status = SpiProtocolGetRegionAddress (This, FlashRegionType, &HardwareSpiAddr, &FlashRegionSize);
+  if (EFI_ERROR (Status)) {
+    goto SendSpiCmdEnd;
+  }
+  HardwareSpiAddr += Address;
+  if ((Address + ByteCount) > FlashRegionSize) {
+    Status = EFI_INVALID_PARAMETER;
+    goto SendSpiCmdEnd;
+  }
+
+  //
+  // Check for PCH SPI hardware sequencing required commands
+  //
+  FlashCycle = 0;
+  switch (FlashCycleType) {
+    case FlashCycleRead:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    case FlashCycleWrite:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_WRITE << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    case FlashCycleErase:
+      if (((ByteCount % SIZE_4KB) != 0) ||
+          ((HardwareSpiAddr % SIZE_4KB) != 0)) {
+        ASSERT (FALSE);
+        Status = EFI_INVALID_PARAMETER;
+        goto SendSpiCmdEnd;
+      }
+      break;
+    case FlashCycleReadSfdp:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_SFDP << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    case FlashCycleReadJedecId:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_JEDEC_ID << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    case FlashCycleWriteStatus:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_WRITE_STATUS << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    case FlashCycleReadStatus:
+      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_STATUS << N_SPI_MEM_HSFSC_CYCLE);
+      break;
+    default:
+      //
+      // Unrecognized Operation
+      //
+      ASSERT (FALSE);
+      Status = EFI_INVALID_PARAMETER;
+      goto SendSpiCmdEnd;
+      break;
+  }
+
+  do {
+    SpiDataCount = ByteCount;
+    if ((FlashCycleType == FlashCycleRead) ||
+        (FlashCycleType == FlashCycleWrite) ||
+        (FlashCycleType == FlashCycleReadSfdp)) {
+      //
+      // Trim at 256 byte boundary per operation,
+      // - PCH SPI controller requires trimming at 4KB boundary
+      // - Some SPI chips require trimming at 256 byte boundary for write operation
+      // - Trimming has limited performance impact as we can read / write atmost 64 byte
+      //   per operation
+      //
+      if (HardwareSpiAddr + ByteCount > ((HardwareSpiAddr + BIT8) &~(BIT8 - 1))) {
+        SpiDataCount = (((UINT32) (HardwareSpiAddr) + BIT8) &~(BIT8 - 1)) - (UINT32) (HardwareSpiAddr);
+      }
+      //
+      // Calculate the number of bytes to shift in/out during the SPI data cycle.
+      // Valid settings for the number of bytes duing each data portion of the
+      // PCH SPI cycles are: 0, 1, 2, 3, 4, 5, 6, 7, 8, 16, 24, 32, 40, 48, 56, 64
+      //
+      if (SpiDataCount >= 64) {
+        SpiDataCount = 64;
+      } else if ((SpiDataCount &~0x07) != 0) {
+        SpiDataCount = SpiDataCount &~0x07;
+      }
+    }
+    if (FlashCycleType == FlashCycleErase) {
+      if (((ByteCount / SIZE_64KB) != 0) &&
+          ((ByteCount % SIZE_64KB) == 0) &&
+          ((HardwareSpiAddr % SIZE_64KB) == 0)) {
+        if ((SpiInstance->NumberOfComponents == 0) ||
+            (HardwareSpiAddr < SpiInstance->Component1StartAddr)) {
+          //
+          // Check whether Component0 support 64k Erase
+          //
+          if ((SpiInstance->SfdpVscc0Value & B_SPI_MEM_SFDPX_VSCCX_EO_64K) != 0) {
+            SpiDataCount = SIZE_64KB;
+          } else {
+            SpiDataCount = SIZE_4KB;
+          }
+        } else {
+          //
+          // Check whether Component1 support 64k Erase
+          //
+          if ((SpiInstance->SfdpVscc1Value & B_SPI_MEM_SFDPX_VSCCX_EO_64K) != 0) {
+            SpiDataCount = SIZE_64KB;
+          } else {
+            SpiDataCount = SIZE_4KB;
+          }
+        }
+      } else {
+        SpiDataCount = SIZE_4KB;
+      }
+      if (SpiDataCount == SIZE_4KB) {
+        FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_4K_ERASE << N_SPI_MEM_HSFSC_CYCLE);
+      } else {
+        FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_64K_ERASE << N_SPI_MEM_HSFSC_CYCLE);
+      }
+    }
+    //
+    // If it's write cycle, load data into the SPI data buffer.
+    //
+    if ((FlashCycleType == FlashCycleWrite) || (FlashCycleType == FlashCycleWriteStatus)) {
+      if ((SpiDataCount & 0x07) != 0) {
+        //
+        // Use Byte write if Data Count is 0, 1, 2, 3, 4, 5, 6, 7
+        //
+        for (Index = 0; Index < SpiDataCount; Index++) {
+          MmioWrite8 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index, Buffer[Index]);
+        }
+      } else {
+        //
+        // Use Dword write if Data Count is 8, 16, 24, 32, 40, 48, 56, 64
+        //
+        for (Index = 0; Index < SpiDataCount; Index += sizeof (UINT32)) {
+          MmioWrite32 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index, *(UINT32 *) (Buffer + Index));
+        }
+      }
+    }
+
+    //
+    // Set the Flash Address
+    //
+    MmioWrite32 (
+      (PchSpiBar0 + R_SPI_MEM_FADDR),
+      (UINT32) (HardwareSpiAddr & B_SPI_MEM_FADDR_MASK)
+      );
+
+    //
+    // Set Data count, Flash cycle, and Set Go bit to start a cycle
+    //
+    MmioAndThenOr32 (
+      PchSpiBar0 + R_SPI_MEM_HSFSC,
+      (UINT32) (~(B_SPI_MEM_HSFSC_FDBC_MASK | B_SPI_MEM_HSFSC_CYCLE_MASK)),
+      (UINT32) ((((SpiDataCount - 1) << N_SPI_MEM_HSFSC_FDBC) & B_SPI_MEM_HSFSC_FDBC_MASK) | FlashCycle | B_SPI_MEM_HSFSC_CYCLE_FGO)
+      );
+    //
+    // end of command execution
+    //
+    // Wait the SPI cycle to complete.
+    //
+    if (!WaitForSpiCycleComplete (This, PchSpiBar0, TRUE)) {
+      ASSERT (FALSE);
+      Status = EFI_DEVICE_ERROR;
+      goto SendSpiCmdEnd;
+    }
+    //
+    // If it's read cycle, load data into the call's buffer.
+    //
+    if ((FlashCycleType == FlashCycleRead) ||
+        (FlashCycleType == FlashCycleReadSfdp) ||
+        (FlashCycleType == FlashCycleReadJedecId) ||
+        (FlashCycleType == FlashCycleReadStatus)) {
+      if ((SpiDataCount & 0x07) != 0) {
+        //
+        // Use Byte read if Data Count is 0, 1, 2, 3, 4, 5, 6, 7
+        //
+        for (Index = 0; Index < SpiDataCount; Index++) {
+          Buffer[Index] = MmioRead8 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index);
+        }
+      } else {
+        //
+        // Use Dword read if Data Count is 8, 16, 24, 32, 40, 48, 56, 64
+        //
+        for (Index = 0; Index < SpiDataCount; Index += sizeof (UINT32)) {
+          *(UINT32 *) (Buffer + Index) = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index);
+        }
+      }
+    }
+
+    HardwareSpiAddr += SpiDataCount;
+    Buffer += SpiDataCount;
+    ByteCount -= SpiDataCount;
+  } while (ByteCount > 0);
+
+SendSpiCmdEnd:
+  //
+  // Restore the settings for SPI Prefetching and Caching and enable BIOS Write Protect
+  //
+  if ((FlashCycleType == FlashCycleWrite) ||
+      (FlashCycleType == FlashCycleErase)) {
+    EnableBiosWriteProtect ();
+    PciSegmentAndThenOr8 (
+      SpiBaseAddress + R_SPI_CFG_BC,
+      (UINT8) ~B_SPI_CFG_BC_SRC,
+      BiosCtlSave
+      );
+  }
+  //
+  // Restore SMIs.
+  //
+  IoWrite32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN), SmiEnSave);
+
+  ReleaseSpiBar0 (SpiInstance);
+
+  return Status;
+}
+
+/**
+  Read data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[out] Buffer              The Pointer to caller-allocated buffer containing the dada received.
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashRead (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *Buffer
+  )
+{
+  EFI_STATUS        Status;
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionType,
+             FlashCycleRead,
+             Address,
+             ByteCount,
+             Buffer
+             );
+  return Status;
+}
+
+/**
+  Write data to the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+  @param[in] Buffer               Pointer to caller-allocated buffer containing the data sent during the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashWrite (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *Buffer
+  )
+{
+  EFI_STATUS        Status;
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionType,
+             FlashCycleWrite,
+             Address,
+             ByteCount,
+             Buffer
+             );
+  return Status;
+}
+
+/**
+  Erase some area on the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for flash cycle which is listed in the Descriptor.
+  @param[in] Address              The Flash Linear Address must fall within a region for which BIOS has access permissions.
+  @param[in] ByteCount            Number of bytes in the data portion of the SPI cycle.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashErase (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount
+  )
+{
+  EFI_STATUS        Status;
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionType,
+             FlashCycleErase,
+             Address,
+             ByteCount,
+             NULL
+             );
+  return Status;
+}
+
+/**
+  Read SFDP data from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] Address              The starting byte address for SFDP data read.
+  @param[in] ByteCount            Number of bytes in SFDP data portion of the SPI cycle
+  @param[out] SfdpData            The Pointer to caller-allocated buffer containing the SFDP data received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode enabled
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadSfdp (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             Address,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *SfdpData
+  )
+{
+  SPI_INSTANCE      *SpiInstance;
+  EFI_STATUS        Status;
+  UINT32            FlashAddress;
+
+  if (SpiIsSafModeActive ()) {
+    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is active.\n", __FUNCTION__));
+    return EFI_UNSUPPORTED;
+  }
+
+  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+  Status            = EFI_SUCCESS;
+
+  if (ComponentNumber > SpiInstance->NumberOfComponents) {
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  FlashAddress = 0;
+  if (ComponentNumber == FlashComponent1) {
+    FlashAddress = SpiInstance->Component1StartAddr;
+  }
+  FlashAddress += Address;
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionAll,
+             FlashCycleReadSfdp,
+             FlashAddress,
+             ByteCount,
+             SfdpData
+             );
+  return Status;
+}
+
+/**
+  Read Jedec Id from the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ComponentNumber      The Componen Number for chip select
+  @param[in] ByteCount            Number of bytes in JedecId data portion of the SPI cycle, the data size is 3 typically
+  @param[out] JedecId             The Pointer to caller-allocated buffer containing JEDEC ID received
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode enabled
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadJedecId (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT8              ComponentNumber,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *JedecId
+  )
+{
+  SPI_INSTANCE      *SpiInstance;
+  EFI_STATUS        Status;
+  UINT32            Address;
+
+  if (SpiIsSafModeActive ()) {
+    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is active.\n", __FUNCTION__));
+    return EFI_UNSUPPORTED;
+  }
+
+  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+  Status            = EFI_SUCCESS;
+
+  if (ComponentNumber > SpiInstance->NumberOfComponents) {
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Address = 0;
+  if (ComponentNumber == FlashComponent1) {
+    Address = SpiInstance->Component1StartAddr;
+  }
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionAll,
+             FlashCycleReadJedecId,
+             Address,
+             ByteCount,
+             JedecId
+             );
+  return Status;
+}
+
+/**
+  Write the status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[in] StatusValue          The Pointer to caller-allocated buffer containing the value of Status register writing
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode enabled
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashWriteStatus (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  IN     UINT8              *StatusValue
+  )
+{
+  EFI_STATUS        Status;
+
+  if (SpiIsSafModeActive ()) {
+    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is active.\n", __FUNCTION__));
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionAll,
+             FlashCycleWriteStatus,
+             0,
+             ByteCount,
+             StatusValue
+             );
+  return Status;
+}
+
+/**
+  Read status register in the flash part.
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] ByteCount            Number of bytes in Status data portion of the SPI cycle, the data size is 1 typically
+  @param[out] StatusValue         The Pointer to caller-allocated buffer containing the value of Status register received.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode enabled
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolFlashReadStatus (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             ByteCount,
+  OUT    UINT8              *StatusValue
+  )
+{
+  EFI_STATUS        Status;
+
+  if (SpiIsSafModeActive ()) {
+    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is active.\n", __FUNCTION__));
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Sends the command to the SPI interface to execute.
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionAll,
+             FlashCycleReadStatus,
+             0,
+             ByteCount,
+             StatusValue
+             );
+  return Status;
+}
+
+/**
+  Get the SPI region base and size, based on the enum type
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] FlashRegionType      The Flash Region type for for the base address which is listed in the Descriptor.
+  @param[out] BaseAddress         The Flash Linear Address for the Region 'n' Base
+  @param[out] RegionSize          The size for the Region 'n'
+
+  @retval EFI_SUCCESS             Read success
+  @retval EFI_INVALID_PARAMETER   Invalid region type given
+  @retval EFI_DEVICE_ERROR        The region is not used
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolGetRegionAddress (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     FLASH_REGION_TYPE  FlashRegionType,
+  OUT    UINT32             *BaseAddress,
+  OUT    UINT32             *RegionSize
+  )
+{
+  SPI_INSTANCE    *SpiInstance;
+  UINTN           PchSpiBar0;
+  UINT32          ReadValue;
+
+  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+
+  if (FlashRegionType >= FlashRegionMax) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (FlashRegionType == FlashRegionAll) {
+    *BaseAddress  = 0;
+    *RegionSize   = SpiInstance->TotalFlashSize;
+    return EFI_SUCCESS;
+  }
+
+  PchSpiBar0      = AcquireSpiBar0 (SpiInstance);
+  ReadValue = MmioRead32 (PchSpiBar0 + (R_SPI_MEM_FREG0_FLASHD + (S_SPI_MEM_FREGX * ((UINT32) FlashRegionType))));
+  ReleaseSpiBar0 (SpiInstance);
+
+  //
+  // If the region is not used, the Region Base is 7FFFh and Region Limit is 0000h
+  //
+  if (ReadValue == B_SPI_MEM_FREGX_BASE_MASK) {
+    return EFI_DEVICE_ERROR;
+  }
+  *BaseAddress = ((ReadValue & B_SPI_MEM_FREGX_BASE_MASK) >> N_SPI_MEM_FREGX_BASE) <<
+    N_SPI_MEM_FREGX_BASE_REPR;
+  //
+  // Region limit address Bits[11:0] are assumed to be FFFh
+  //
+  *RegionSize = ((((ReadValue & B_SPI_MEM_FREGX_LIMIT_MASK) >> N_SPI_MEM_FREGX_LIMIT) + 1) <<
+                 N_SPI_MEM_FREGX_LIMIT_REPR) - *BaseAddress;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Read PCH Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing PCH Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolReadPchSoftStrap (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  )
+{
+  SPI_INSTANCE      *SpiInstance;
+  UINT32            StrapFlashAddr;
+  EFI_STATUS        Status;
+
+  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+
+  if (ByteCount == 0) {
+    *(UINT16 *) SoftStrapValue = SpiInstance->PchStrapSize;
+    return EFI_SUCCESS;
+  }
+
+  if ((SoftStrapAddr + ByteCount) > (UINT32) SpiInstance->PchStrapSize) {
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // PCH Strap Flash Address = FPSBA + RamAddr
+  //
+  StrapFlashAddr = SpiInstance->PchStrapBaseAddr + SoftStrapAddr;
+
+  //
+  // Read PCH Soft straps from using execute command
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionDescriptor,
+             FlashCycleRead,
+             StrapFlashAddr,
+             ByteCount,
+             SoftStrapValue
+             );
+  return Status;
+}
+
+/**
+  Read CPU Soft Strap Values
+
+  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
+  @param[in] SoftStrapAddr        CPU Soft Strap address offset from FCPUSBA.
+  @param[in] ByteCount            Number of bytes in SoftStrap data portion of the SPI cycle.
+  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer containing CPU Soft Strap Value.
+                                  If the value of ByteCount is 0, the data type of SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap Length
+                                  It is the caller's responsibility to make sure Buffer is large enough for the total number of bytes read.
+
+  @retval EFI_SUCCESS             Command succeed.
+  @retval EFI_INVALID_PARAMETER   The parameters specified are not valid.
+  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
+**/
+EFI_STATUS
+EFIAPI
+SpiProtocolReadCpuSoftStrap (
+  IN     PCH_SPI_PROTOCOL   *This,
+  IN     UINT32             SoftStrapAddr,
+  IN     UINT32             ByteCount,
+  OUT    VOID               *SoftStrapValue
+  )
+{
+  SPI_INSTANCE      *SpiInstance;
+  UINT32            StrapFlashAddr;
+  EFI_STATUS        Status;
+
+  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
+
+  if (ByteCount == 0) {
+    *(UINT16 *) SoftStrapValue = SpiInstance->CpuStrapSize;
+    return EFI_SUCCESS;
+  }
+
+  if ((SoftStrapAddr + ByteCount) > (UINT32) SpiInstance->CpuStrapSize) {
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // CPU Strap Flash Address = FCPUSBA + RamAddr
+  //
+  StrapFlashAddr = SpiInstance->CpuStrapBaseAddr + SoftStrapAddr;
+
+  //
+  // Read Cpu Soft straps from using execute command
+  //
+  Status = SendSpiCmd (
+             This,
+             FlashRegionDescriptor,
+             FlashCycleRead,
+             StrapFlashAddr,
+             ByteCount,
+             SoftStrapValue
+             );
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
new file mode 100644
index 0000000000..4e059494d8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
@@ -0,0 +1,40 @@
+## @file
+# Component description file for PCH SPI access private library
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION     = 0x00010017
+BASE_NAME       = PeiDxeSmmSpiAccessPrivateLib
+FILE_GUID       = 2CD382D7-9928-C32A-601D-69797C618A6D
+VERSION_STRING  = 1.0
+MODULE_TYPE     = BASE
+LIBRARY_CLASS   = SpiAccessPrivateLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+SpiAccessLib
+PcdLib
+S3BootScriptLib
+PchPciBdfLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+SpiAccessPrivateLib.c
+
+
+[Pcd]
+gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/SpiAccessPrivateLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/SpiAccessPrivateLib.c
new file mode 100644
index 0000000000..de1f3d3f86
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/SpiAccessPrivateLib.c
@@ -0,0 +1,133 @@
+/** @file
+  SPI library for abstraction of SPI HW registers accesses
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/SpiAccessLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/DebugLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Register/SpiRegs.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Disable EISS (Enable InSMM.STS)
+**/
+VOID
+SpiDisableEiss (
+  VOID
+  )
+{
+  UINT64  SpiBaseAddress;
+  SpiBaseAddress = SpiPciCfgBase ();
+
+  ASSERT ((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) & B_SPI_CFG_BC_LE) == 0);
+
+  PciSegmentAnd8 (SpiBaseAddress + R_SPI_CFG_BC, (UINT8) ~(B_SPI_CFG_BC_EISS));
+}
+
+/**
+  Configure BiosLockEnable bit and BiosInterfaceLock bit according to policy setting.
+
+  @param[in] BiosLockEnable     Policy for BiosLockEnable bit programming
+  @param[in] BiosInterfaceLock  Policy for BiosInterfaceLock bit programming
+
+**/
+VOID
+SpiBiosLockEnableAndBiosInterfaceLockWithS3BootScript (
+  IN BOOLEAN  BiosLockEnable,
+  IN BOOLEAN  BiosInterfaceLock
+  )
+{
+  UINT64                   SpiBaseAddress;
+  UINT8                    SpiData8;
+
+  if (!BiosLockEnable && !BiosInterfaceLock) {
+    return;
+  }
+
+  SpiBaseAddress = SpiPciCfgBase ();
+
+  ///
+  /// PCH BIOS Spec Flash Security Recommendation
+  ///
+  /// BIOS needs to enable the BIOS Lock Enable (BLE) feature of the PCH by setting
+  /// SPI/eSPI/LPC PCI offset DCh[1] = 1b.
+  /// When this bit is set, attempts to write the Write Protect Disable (WPD) bit
+  /// in PCH will cause a SMI which will allow the BIOS to verify that the write is
+  /// from a valid source.
+  /// Remember that BIOS needs to set SPI/LPC/eSPI PCI Offset DC [0] = 0b to enable
+  /// BIOS region protection before exiting the SMI handler.
+  /// Also, TCO_EN bit needs to be set (SMI_EN Register, ABASE + 30h[13] = 1b) to keep
+  /// BLE feature enabled after booting to the OS.
+  /// Intel requires that BIOS enables the Lock Enable (LE) feature of the PCH to
+  /// ensure SMM protection of flash.
+  /// RC installs a default SMI handler that clears WPD.
+  /// There could be additional SMI handler to log such attempt if desired.
+  ///
+  /// BIOS needs to enable the "Enable in SMM.STS" (EISS) feature of the PCH by setting
+  /// SPI PCI offset DCh[5] = 1b for SPI or setting eSPI PCI offset DCh[5] = 1b for eSPI.
+  /// When this bit is set, the BIOS region is not writable until SMM sets the InSMM.STS bit,
+  /// to ensure BIOS can only be modified from SMM. Please refer to CPU BWG for more details
+  /// on InSMM.STS bit.
+  /// Intel requires that BIOS enables the Lock Enable (LE) feature of the PCH to ensure
+  /// SMM protection of flash.
+  /// SPI PCI offset DCh[1] = 1b for SPI or setting eSPI PCI offset DCh[1] = 1b for eSPI.
+  /// When this bit is set, EISS is locked down.
+  ///
+  SpiData8 = 0;
+  if (BiosLockEnable) {
+    SpiData8 |= B_SPI_CFG_BC_EISS | B_SPI_CFG_BC_LE;
+  }
+  ///
+  /// BIOS also needs to set the BIOS Interface Lock Down bit in multiple locations
+  /// (PCR[DMI] + 274Ch[0], LPC/eSPI PCI offset DCh[7] and SPI PCI offset DCh[7]).
+  /// (done in PchInit/Dxe/PchInit.c by PchDmiSetBiosLockDownWithS3BootScript ()) for PCR[DMI] 274Ch)
+  /// Setting these bits will prevent writes to the Top Swap bit (under their respective locations)
+  /// and the Boot BIOS Straps. Enabling this bit will mitigate malicious software
+  /// attempts to replace the system BIOS option ROM with its own code.
+  ///
+  if (BiosInterfaceLock) {
+    SpiData8 |= B_SPI_CFG_BC_BILD;
+  }
+
+  PciSegmentOr8 (SpiBaseAddress + R_SPI_CFG_BC, SpiData8);
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint8,
+    PcdGet64 (PcdPciExpressBaseAddress) + SpiBaseAddress + R_SPI_CFG_BC,
+    1,
+    (VOID *) (UINTN) (PcdGet64 (PcdPciExpressBaseAddress) + SpiBaseAddress + R_SPI_CFG_BC)
+    );
+  //
+  // Reads back for posted write to take effect
+  //
+  SpiData8 = PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC);
+  S3BootScriptSaveMemPoll  (
+    S3BootScriptWidthUint8,
+    PcdGet64 (PcdPciExpressBaseAddress) + SpiBaseAddress + R_SPI_CFG_BC,
+    &SpiData8,
+    &SpiData8,
+    1,
+    1
+    );
+}
+
+/**
+  Clears BIOS Write Protect Disable bit
+**/
+VOID
+SpiClearBiosWriteProtectDisable (
+  VOID
+  )
+{
+  //
+  // Disable BIOSWE bit to protect BIOS
+  //
+  PciSegmentAnd8 (SpiPciCfgBase () + R_SPI_CFG_BC, (UINT8) ~B_SPI_CFG_BC_WPD);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
new file mode 100644
index 0000000000..419eddaff3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
@@ -0,0 +1,296 @@
+/** @file
+  PCH SPI SMM Driver implements the SPI Host Controller Compatibility Interface.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Protocol/Spi.h>
+#include <Protocol/SmmCpu.h>
+#include <Library/SpiCommonLib.h>
+#include <PchReservedResources.h>
+#include <Library/SmmPchPrivateLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Register/SpiRegs.h>
+
+//
+// Global variables
+//
+GLOBAL_REMOVE_IF_UNREFERENCED SPI_INSTANCE          *mSpiInstance;
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_CPU_PROTOCOL  *mSmmCpuProtocol;
+//
+// mPchSpiResvMmioAddr keeps the reserved MMIO range assiged to SPI.
+// In SMM it always set back the reserved MMIO address to SPI BAR0 to ensure the MMIO range
+// won't overlap with SMRAM range, and trusted.
+//
+GLOBAL_REMOVE_IF_UNREFERENCED UINT32                mSpiResvMmioAddr;
+
+/**
+  <b>SPI Runtime SMM Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+    The SPI SMM module provide a standard way for other modules to use the PCH SPI Interface in SMM.
+
+  - @pre
+    - EFI_SMM_BASE2_PROTOCOL
+      - Documented in System Management Mode Core Interface Specification .
+
+  - @result
+    The SPI SMM driver produces @link _PCH_SPI_PROTOCOL PCH_SPI_PROTOCOL @endlink with GUID
+    gPchSmmSpiProtocolGuid which is different from SPI RUNTIME driver.
+
+  - <b>Integration Check List</b>\n
+    - This driver supports Descriptor Mode only.
+    - This driver supports Hardware Sequence only.
+    - When using SMM SPI Protocol to perform flash access in an SMI handler,
+      and the SMI occurrence is asynchronous to normal mode code execution,
+      proper synchronization mechanism must be applied, e.g. disable SMI before
+      the normal mode SendSpiCmd() starts and re-enable SMI after
+      the normal mode SendSpiCmd() completes.
+      @note The implementation of SendSpiCmd() uses GBL_SMI_EN in
+      SMI_EN register (ABase + 30h) to disable and enable SMIs. But this may
+      not be effective as platform may well set the SMI_LOCK bit (i.e., PMC PCI Offset A0h [4]).
+      So the synchronization at caller level is likely needed.
+
+  @param[in] ImageHandle          Image handle of this driver.
+  @param[in] SystemTable          Global system service table.
+
+  @retval EFI_SUCCESS             Initialization complete.
+  @exception EFI_UNSUPPORTED      The chipset is unsupported by this driver.
+  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to initialize the driver.
+  @retval EFI_DEVICE_ERROR        Device error, driver exits abnormally.
+**/
+EFI_STATUS
+EFIAPI
+InstallPchSpi (
+  IN EFI_HANDLE            ImageHandle,
+  IN EFI_SYSTEM_TABLE      *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Init PCH spi reserved MMIO address.
+  //
+  mSpiResvMmioAddr = PCH_SPI_BASE_ADDRESS;
+
+  ///
+  /// Allocate pool for SPI protocol instance
+  ///
+  Status = gSmst->SmmAllocatePool (
+                    EfiRuntimeServicesData, /// MemoryType don't care
+                    sizeof (SPI_INSTANCE),
+                    (VOID **) &mSpiInstance
+                    );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if (mSpiInstance == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  ZeroMem ((VOID *) mSpiInstance, sizeof (SPI_INSTANCE));
+  ///
+  /// Initialize the SPI protocol instance
+  ///
+  Status = SpiProtocolConstructor (mSpiInstance);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  ///
+  /// Install the SMM PCH_SPI_PROTOCOL interface
+  ///
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &(mSpiInstance->Handle),
+                    &gPchSmmSpiProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &(mSpiInstance->SpiProtocol)
+                    );
+  if (EFI_ERROR (Status)) {
+    gSmst->SmmFreePool (mSpiInstance);
+    return EFI_DEVICE_ERROR;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Acquire PCH spi mmio address.
+  If it is ever different from the preallocated address, reassign it back.
+  In SMM, it always override the BAR0 and returns the reserved MMIO range for SPI.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval PchSpiBar0              return SPI MMIO address
+**/
+UINTN
+AcquireSpiBar0 (
+  IN  SPI_INSTANCE                *SpiInstance
+  )
+{
+  UINT32                          SpiBar0;
+  //
+  // Save original SPI physical MMIO address
+  //
+  SpiBar0 = PciSegmentRead32 (SpiInstance->PchSpiBase + R_SPI_CFG_BAR0) & ~(B_SPI_CFG_BAR0_MASK);
+
+  if (SpiBar0 != mSpiResvMmioAddr) {
+    //
+    // Temporary disable MSE, and override with SPI reserved MMIO address, then enable MSE.
+    //
+    PciSegmentAnd8 (SpiInstance->PchSpiBase + PCI_COMMAND_OFFSET, (UINT8) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+    PciSegmentWrite32 (SpiInstance->PchSpiBase + R_SPI_CFG_BAR0, mSpiResvMmioAddr);
+    PciSegmentOr8 (SpiInstance->PchSpiBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+  }
+  //
+  // SPIBAR0 will be different before and after PCI enum so need to get it from SPI BAR0 reg.
+  //
+  return mSpiResvMmioAddr;
+}
+
+/**
+  Release pch spi mmio address. Do nothing.
+
+  @param[in] SpiInstance          Pointer to SpiInstance to initialize
+
+  @retval None
+**/
+VOID
+ReleaseSpiBar0 (
+  IN  SPI_INSTANCE                *SpiInstance
+  )
+{
+}
+
+/**
+  This function is a hook for Spi to disable BIOS Write Protect
+
+  @retval EFI_SUCCESS             The protocol instance was properly initialized
+  @retval EFI_ACCESS_DENIED       The BIOS Region can only be updated in SMM phase
+
+**/
+EFI_STATUS
+EFIAPI
+DisableBiosWriteProtect (
+  VOID
+  )
+{
+  UINT64     SpiBaseAddress;
+
+  SpiBaseAddress = SpiPciCfgBase ();
+  // Write clear BC_SYNC_SS prior to change WPD from 0 to 1.
+  //
+  PciSegmentOr8 (
+    SpiBaseAddress + R_SPI_CFG_BC + 1,
+    (B_SPI_CFG_BC_SYNC_SS >> 8)
+    );
+  ///
+  /// Set BIOSWE bit (SPI PCI Offset DCh [0]) = 1b
+  /// Enable the access to the BIOS space for both read and write cycles
+  ///
+  PciSegmentOr8 (
+    SpiBaseAddress + R_SPI_CFG_BC,
+    B_SPI_CFG_BC_WPD
+    );
+
+  ///
+  /// PCH BIOS Spec Section 3.7 BIOS Region SMM Protection Enabling
+  /// If the following steps are implemented:
+  ///  - Set the EISS bit (SPI PCI Offset DCh [5]) = 1b
+  ///  - Follow the 1st recommendation in section 3.6
+  /// the BIOS Region can only be updated by following the steps bellow:
+  ///  - Once all threads enter SMM
+  ///  - Read memory location FED30880h OR with 00000001h, place the result in EAX,
+  ///    and write data to lower 32 bits of MSR 1FEh (sample code available)
+  ///  - Set BIOSWE bit (SPI PCI Offset DCh [0]) = 1b
+  ///  - Modify BIOS Region
+  ///  - Clear BIOSWE bit (SPI PCI Offset DCh [0]) = 0b
+  ///
+  if ((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) & B_SPI_CFG_BC_EISS) != 0) {
+    PchSetInSmmSts ();
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This function is a hook for Spi to enable BIOS Write Protect
+**/
+VOID
+EFIAPI
+EnableBiosWriteProtect (
+  VOID
+  )
+{
+  UINT64     SpiBaseAddress;
+
+  SpiBaseAddress = SpiPciCfgBase ();
+  ///
+  /// Clear BIOSWE bit (SPI PCI Offset DCh [0]) = 0b
+  /// Disable the access to the BIOS space for write cycles
+  ///
+  PciSegmentAnd8 (
+    SpiBaseAddress + R_SPI_CFG_BC,
+    (UINT8) (~B_SPI_CFG_BC_WPD)
+    );
+
+  ///
+  /// Check if EISS bit is set
+  ///
+  if (((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC)) & B_SPI_CFG_BC_EISS) == B_SPI_CFG_BC_EISS) {
+    PchClearInSmmSts ();
+  }
+}
+
+/**
+  Check if it's granted to do flash write.
+
+  @retval TRUE    It's secure to do flash write.
+  @retval FALSE   It's not secure to do flash write.
+**/
+BOOLEAN
+IsSpiFlashWriteGranted (
+  VOID
+  )
+{
+  EFI_STATUS    Status;
+  UINT32        CpuIndex;
+  UINT64        ProcessorId;
+
+  if (mSmmCpuProtocol == NULL) {
+    Status = gSmst->SmmLocateProtocol (&gEfiSmmCpuProtocolGuid, NULL, (VOID **)&mSmmCpuProtocol);
+    ASSERT_EFI_ERROR (Status);
+    if (mSmmCpuProtocol == NULL) {
+      return TRUE;
+    }
+  }
+
+  for (CpuIndex = 0; CpuIndex < gSmst->NumberOfCpus; CpuIndex++) {
+    Status = mSmmCpuProtocol->ReadSaveState (
+                                mSmmCpuProtocol,
+                                sizeof (ProcessorId),
+                                EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID,
+                                CpuIndex,
+                                &ProcessorId
+                                );
+    //
+    // If the processor is in SMM at the time the SMI occurred,
+    // it will return success. Otherwise, EFI_NOT_FOUND is returned.
+    //
+    if (EFI_ERROR (Status)) {
+      return FALSE;
+    }
+  }
+
+  return TRUE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
new file mode 100644
index 0000000000..033134cea1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
@@ -0,0 +1,47 @@
+## @file
+# Component description file for the SPI SMM driver.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = SpiSmm
+FILE_GUID = 27F4917B-A707-4aad-9676-26DF168CBF0D
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_SMM_DRIVER
+PI_SPECIFICATION_VERSION = 1.10
+ENTRY_POINT = InstallPchSpi
+
+
+[LibraryClasses]
+DebugLib
+IoLib
+UefiDriverEntryPoint
+UefiBootServicesTableLib
+BaseLib
+SmmServicesTableLib
+SpiCommonLib
+SmmPchPrivateLib
+PchPciBdfLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+Spi.c
+
+
+[Protocols]
+gPchSmmSpiProtocolGuid ## PRODUCES
+gEfiSmmCpuProtocolGuid ## CONSUMES
+
+
+[Depex]
+gEfiSmmBase2ProtocolGuid AND # This is for SmmServicesTableLib
+gEfiSmmCpuProtocolGuid # This is for CpuSmmDisableBiosWriteProtect()
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (27 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances Heng Luo
                   ` (10 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * IpBlock/Vtd/IncludePrivate
  * IpBlock/Vtd/Library
  * IpBlock/Vtd/LibraryPrivate

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdInitLib.h              |  62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdPolicyLib.h            |  67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.h                         |  32 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/PeiDxeSmmVtdInfoLib.inf |  45 +++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/VtdInfoLib.c            |  86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.c        | 684 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.inf      |  71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.c    |  90 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf  |  35 +++++++++++++++++++++++++++++++++++
 9 files changed, 1172 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdInitLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdInitLib.h
new file mode 100644
index 0000000000..e439cfbac2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdInitLib.h
@@ -0,0 +1,62 @@
+/** @file
+  Header file for DXE VTD Init Lib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_VTD_INIT_LIB_H_
+#define _DXE_VTD_INIT_LIB_H_
+
+#include <Uefi.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/UefiLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/VtdInfoLib.h>
+#include <Library/SaPlatformLib.h>
+#include <IndustryStandard/Acpi.h>
+#include <IndustryStandard/Pci.h>
+#include <VtdDataHob.h>
+#include <PchConfigHob.h>
+#include <PchInfoHob.h>
+#include <Register/P2sbRegs.h>
+#include <Register/IpuRegs.h>
+#include <Register/IgdRegs.h>
+#include <Register/VtdRegs.h>
+#include <DmaRemappingTable.h>
+#include <Protocol/AcpiSystemDescriptionTable.h>
+#include <Protocol/AcpiTable.h>
+#include <Protocol/SaPolicy.h>
+#include <Protocol/SaNvsArea.h>
+#include <Protocol/FirmwareVolume2.h>
+
+/**
+  Locate the VT-d ACPI tables data file and read ACPI SSDT tables.
+  Publish the appropriate SSDT based on current configuration and capabilities.
+
+  @param[in] SaPolicy            SA DXE Policy protocol
+
+  @retval EFI_SUCCESS - Vtd initialization complete
+  @retval Other       - No Vtd function initiated
+**/
+EFI_STATUS
+VtdInit (
+  IN  SA_POLICY_PROTOCOL    *SaPolicy
+  );
+
+/**
+  EndOfPcieEnum routine for update DMAR
+**/
+VOID
+UpdateDmarEndOfPcieEnum (
+  VOID
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdPolicyLib.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdPolicyLib.h
new file mode 100644
index 0000000000..d55cf6bc34
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdPolicyLib.h
@@ -0,0 +1,67 @@
+/** @file
+  Prototype of the DXE VTD Policy Init library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_VTD_POLICY_INIT_LIB_H_
+#define _DXE_VTD_POLICY_INIT_LIB_H_
+
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Protocol/SaPolicy.h>
+#include <ConfigBlock.h>
+#include <VtdConfig.h>
+#include <Library/SiConfigBlockLib.h>
+
+extern EFI_GUID gVtdDxeConfigGuid;
+
+/**
+  This function Load default Vtd DXE policy.
+
+  @param[in] ConfigBlockPointer    The pointer to add VTD config block
+**/
+VOID
+VtdLoadDefaultDxe (
+  IN VOID    *ConfigBlockPointer
+  );
+
+/**
+  This function prints the DXE phase VTD policy.
+
+  @param[in] SaPolicy - Instance of SA_POLICY_PROTOCOL
+**/
+VOID
+VtdPrintPolicyDxe (
+  IN  SA_POLICY_PROTOCOL      *SaPolicy
+  );
+
+/**
+  This function is used to add VTD Config Block.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add VTD config blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+VtdAddConfigBlocksDxe (
+  IN VOID           *ConfigBlockTableAddress
+  );
+
+/**
+  Get VTD DXE config block table total size.
+
+  @retval     Size of VTD DXE config block table
+**/
+UINT16
+EFIAPI
+VtdGetConfigBlockTotalSizeDxe (
+  VOID
+  );
+#endif // _DXE_VTD_POLICY_INIT_LIB_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.h b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.h
new file mode 100644
index 0000000000..0f9d500af9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.h
@@ -0,0 +1,32 @@
+/** @file
+  The GUID definition for Vtd Data Hob
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _VTD_DATA_HOB_H_
+#define _VTD_DATA_HOB_H_
+
+#include <Library/VtdInfoLib.h>
+#include <Base.h>
+
+extern EFI_GUID gVtdDataHobGuid;
+
+#pragma pack (push,1)
+
+///
+/// The data elements should be initialized by a Platform Module.
+/// The data structure is for VT-d driver initialization
+///
+typedef struct {
+  EFI_HOB_GUID_TYPE     EfiHobGuidType;                    ///< GUID Hob type structure for gVtdDataHobGuid
+  BOOLEAN               VtdDisable;                        ///< 1 = Avoids programming Vtd bars, Vtd overrides and DMAR table
+  UINT32                BaseAddress[VTD_ENGINE_NUMBER];    ///< This field is used to describe the base addresses for VT-d function
+  BOOLEAN               X2ApicOptOut;                      ///< This field is used to enable the X2APIC_OPT_OUT bit in the DMAR table. <b>1=Enable/Set</b> and 0=Disable/Clear
+  BOOLEAN               DmaControlGuarantee;               ///< This field is used to enable the DMA_CONTROL_GUARANTEE bit in the DMAR table. <b>1=Enable/Set</b> and 0=Disable/Clear
+  BOOLEAN               InterruptRemappingSupport;         ///< This field is used to indicate Interrupt Remapping supported or not
+  UINT32                DmaBufferBase;                     ///< Iommu PEI DMA buffer base in low memory region, in Mbytes units
+} VTD_DATA_HOB;
+
+#pragma pack (pop)
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/PeiDxeSmmVtdInfoLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/PeiDxeSmmVtdInfoLib.inf
new file mode 100644
index 0000000000..c7c5e56b84
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/PeiDxeSmmVtdInfoLib.inf
@@ -0,0 +1,45 @@
+## @file
+# VTD Common Library.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmVtdInfoLib
+FILE_GUID = A1480873-3FDA-4E90-B450-743D8031F9DE
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = VtdInfoLib
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+HobLib
+VtdInfoLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+VtdInfoLib.c
+
+[Pcd]
+gSiPkgTokenSpaceGuid.VtdEngine1BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine2BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine3BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine4BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine5BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine6BaseAddeess
+gSiPkgTokenSpaceGuid.VtdEngine7BaseAddeess
+
+[FixedPcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/VtdInfoLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/VtdInfoLib.c
new file mode 100644
index 0000000000..e4f08592cc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/VtdInfoLib.c
@@ -0,0 +1,86 @@
+/** @file
+  VTD Info library.
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Ppi/SiPolicy.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/VtdInfoLib.h>
+#include <Register/VtdRegs.h>
+
+/**
+  Get VTD Engine Base Address from PCD value
+
+  @param[in]  VtdEngineNumber        - Engine number for which VTD Base Adderess is required.
+
+  @retval   VTD Engine Base Address
+**/
+UINT32
+GetVtdBaseAddress (
+  IN UINT8        VtdEngineNumber
+  )
+{
+  switch (VtdEngineNumber) {
+    case 0:
+      return PcdGet32(VtdEngine1BaseAddeess);
+      break;
+    case 2:
+      return PcdGet32(VtdEngine3BaseAddeess);
+      break;
+    default:
+      return 0x0;
+      break;
+  }
+}
+
+
+/**
+  Read VTD Engine Base Address from VTD BAR Offsets.
+
+  @param[in]  VtdEngineNumber        - Engine number for which VTD Base Adderess is required.
+
+  @retval   VTD Engine Base Address
+**/
+UINT32
+ReadVtdBaseAddress (
+  IN UINT8        VtdEngineNumber
+  )
+{
+  UINT64              McD0BaseAddress;
+  UINTN               MchBar;
+
+  McD0BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, 0);
+  MchBar          = PciSegmentRead32 (McD0BaseAddress + R_SA_MCHBAR) & (~BIT0);
+
+  switch (VtdEngineNumber) {
+    case 0:
+      return (MmioRead32 (MchBar + R_MCHBAR_VTD1_OFFSET) & (~BIT0));
+      break;
+    case 2:
+      return (MmioRead32 (MchBar + R_MCHBAR_VTD3_OFFSET) & (~BIT0));
+      break;
+    default:
+      return 0x0;
+      break;
+  }
+}
+
+/**
+  GetMaxVtdEngineNumber: Get Maximum Vtd Engine Number
+
+  @retval Vtd Engine Number
+**/
+UINT8
+GetMaxVtdEngineNumber(
+  VOID
+)
+{
+  return (UINT8)VTD_ENGINE_NUMBER;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.c
new file mode 100644
index 0000000000..faac07c45d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.c
@@ -0,0 +1,684 @@
+/** @file
+  DXE Library for VTD ACPI table initialization.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DxeVtdInitLib.h>
+#include <Library/DxeVtdPolicyLib.h>
+#include <Library/VtdInitFruLib.h>
+#include <Register/SaRegsHostBridge.h>
+
+///
+/// Global Variables
+///
+GLOBAL_REMOVE_IF_UNREFERENCED VTD_DATA_HOB     *mVtdDataHob;
+
+BOOLEAN mInterruptRemappingSupport;
+
+/**
+  Get the corresponding device Enable/Disable bit according DevNum and FunNum
+
+  @param[in] DevNum  - Device Number
+  @param[in] FunNum  - Function Number
+
+  @retval If the device is found, return disable/Enable bit in FD/Deven reigster
+  @retval If not found return 0xFF
+**/
+UINT16
+GetFunDisableBit (
+  UINT8 DevNum,
+  UINT8 FunNum
+  )
+{
+  UINTN Index;
+
+  for (Index = 0; Index < mDevEnMapSize; Index++) {
+    if (mDevEnMap[Index][0] == ((DevNum << 0x08) | FunNum)) {
+      return mDevEnMap[Index][1];
+    }
+  }
+
+  return 0xFF;
+}
+
+/**
+  Update the DRHD structure
+
+  @param[in, out] DrhdEnginePtr       - A pointer to DRHD structure
+**/
+VOID
+UpdateDrhd (
+  IN OUT VOID *DrhdEnginePtr
+  )
+{
+  UINT16                        Length;
+  UINT16                        DisableBit;
+  BOOLEAN                       NeedRemove;
+  EFI_ACPI_DRHD_ENGINE1_STRUCT  *DrhdEngine;
+
+  //
+  // Convert DrhdEnginePtr to EFI_ACPI_DRHD_ENGINE1_STRUCT Pointer
+  //
+  DrhdEngine      = (EFI_ACPI_DRHD_ENGINE1_STRUCT *) DrhdEnginePtr;
+  Length          = DrhdEngine->DrhdHeader.Header.Length;
+  DisableBit = GetFunDisableBit (
+                 DrhdEngine->DeviceScope[0].PciPath.Device,
+                 DrhdEngine->DeviceScope[0].PciPath.Function
+                 );
+  NeedRemove = FALSE;
+
+  if ((DisableBit == 0xFF) ||
+      (DrhdEngine->DrhdHeader.RegisterBaseAddress == 0) ||
+      ((DisableBit == 0x80) &&
+       (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0, DrhdEngine->DeviceScope[0].PciPath.Device, DrhdEngine->DeviceScope[0].PciPath.Function, 0x00)) == 0xFFFFFFFF))
+      ) {
+    NeedRemove = TRUE;
+  }
+  if ((DrhdEngine->DeviceScope[0].PciPath.Device == IGD_DEV_NUM) && (DrhdEngine->DeviceScope[0].PciPath.Function == IGD_FUN_NUM) &&
+      (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0, DrhdEngine->DeviceScope[0].PciPath.Device, DrhdEngine->DeviceScope[0].PciPath.Function, 0x00)) != 0xFFFFFFFF)) {
+    NeedRemove = FALSE;
+  }
+  if (NeedRemove) {
+    Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
+  }
+  ///
+  /// If no devicescope is left, we set the structure length as 0x00
+  ///
+  if ((Length > EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) || (DrhdEngine->DrhdHeader.Flags == 0x01)) {
+    DrhdEngine->DrhdHeader.Header.Length = Length;
+  } else {
+    DrhdEngine->DrhdHeader.Header.Length = 0;
+  }
+}
+
+/**
+  Get IOAPIC ID from LPC
+
+  @retval APIC ID
+**/
+UINT8
+GetIoApicId (
+  VOID
+  )
+{
+  UINT32                IoApicAddress;
+  UINT32                IoApicId;
+
+  IoApicAddress = PcdGet32 (PcdSiIoApicBaseAddress);
+  ///
+  /// Get current IO APIC ID
+  ///
+  MmioWrite8 ((UINTN) (IoApicAddress + R_IO_APIC_MEM_INDEX_OFFSET), 0);
+  IoApicId = MmioRead32 ((UINTN) (IoApicAddress + R_IO_APIC_MEM_DATA_OFFSET)) >> 24;
+
+  return (UINT8) IoApicId;
+}
+
+/**
+  Update the second DRHD structure
+
+  @param[in, out] DrhdEnginePtr       - A pointer to DRHD structure
+**/
+VOID
+UpdateDrhd2 (
+  IN OUT VOID *DrhdEnginePtr
+  )
+{
+  UINT16                        Length;
+  UINTN                         DeviceScopeNum;
+  UINTN                         ValidDeviceScopeNum;
+  UINT16                        Index;
+  UINT8                         Bus;
+  UINT8                         Path[2];
+  BOOLEAN                       NeedRemove;
+  EFI_ACPI_DRHD_ENGINE3_STRUCT  *DrhdEngine;
+  VOID                          *HobPtr;
+  PCH_INFO_HOB                  *PchInfoHob;
+
+  ///
+  /// Convert DrhdEnginePtr to EFI_ACPI_DRHD_ENGINE3_STRUCT Pointer
+  ///
+  DrhdEngine      = (EFI_ACPI_DRHD_ENGINE3_STRUCT *) DrhdEnginePtr;
+
+  Length          = DrhdEngine->DrhdHeader.Header.Length;
+  DeviceScopeNum  = (DrhdEngine->DrhdHeader.Header.Length - EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) / sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
+  Bus             = 0;
+  ValidDeviceScopeNum = 0;
+  Path[0]         = 0;
+  Path[1]         = 0;
+
+  HobPtr = GetFirstGuidHob (&gPchInfoHobGuid);
+  ASSERT (HobPtr != NULL);
+  if (HobPtr == NULL) {
+    return;
+  }
+  PchInfoHob = (PCH_INFO_HOB *) GET_GUID_HOB_DATA (HobPtr);
+  ASSERT (PchInfoHob != NULL);
+  if (PchInfoHob == NULL) {
+    return;
+  }
+
+  for (Index = 0; Index < DeviceScopeNum; Index++) {
+    NeedRemove = FALSE;
+    /**
+      For HPET and APIC, update device scope if Interrupt remapping is supported. remove device scope
+      if interrupt remapping is not supported.
+      - Index = 0 - IOAPIC
+      - Index = 1 - HPET
+    **/
+    if (mInterruptRemappingSupport) {
+      if (Index == 0) {
+        ///
+        /// Update source id for IoApic's device scope entry
+        ///
+        Bus = (UINT8) PchInfoHob->IoApicBusNum;
+        Path[0] = (UINT8) PchInfoHob->IoApicDevNum;
+        Path[1] = (UINT8) PchInfoHob->IoApicFuncNum;
+        DrhdEngine->DeviceScope[Index].DeviceScopeStructureHeader.StartBusNumber = Bus;
+        DrhdEngine->DeviceScope[Index].PciPath.Device = Path[0];
+        DrhdEngine->DeviceScope[Index].PciPath.Function = Path[1];
+        //
+        // Update APIC ID
+        //
+        DrhdEngine->DeviceScope[Index].DeviceScopeStructureHeader.EnumerationId = GetIoApicId ();
+      }
+      if (Index == 1) {
+        ///
+        /// Update source id for HPET's device scope entry
+        ///
+        Bus     = (UINT8) PchInfoHob->HpetBusNum;
+        Path[0] = (UINT8) PchInfoHob->HpetDevNum;
+        Path[1] = (UINT8) PchInfoHob->HpetFuncNum;
+        DrhdEngine->DeviceScope[Index].DeviceScopeStructureHeader.StartBusNumber = Bus;
+        DrhdEngine->DeviceScope[Index].PciPath.Device = Path[0];
+        DrhdEngine->DeviceScope[Index].PciPath.Function = Path[1];
+      }
+    } else {
+      if ((Index == 0) || (Index == 1)) {
+        NeedRemove = TRUE;
+      }
+    }
+
+    CopyMem (
+      &DrhdEngine->DeviceScope[ValidDeviceScopeNum],
+      &DrhdEngine->DeviceScope[Index],
+      sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE)
+      );
+    if (NeedRemove) {
+      Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
+    } else {
+      ValidDeviceScopeNum++;
+    }
+  }
+  ///
+  /// If no devicescope is left, we set the structure length as 0x00
+  ///
+  if ((Length > EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) || (DrhdEngine->DrhdHeader.Flags == 0x01)) {
+    DrhdEngine->DrhdHeader.Header.Length = Length;
+  } else {
+    DrhdEngine->DrhdHeader.Header.Length = 0;
+  }
+}
+
+/**
+  Update the RMRR structure
+
+  @param[in, out] RmrrPtr             - A pointer to RMRR structure
+**/
+VOID
+UpdateRmrr (
+  IN OUT VOID *RmrrPtr
+  )
+{
+  UINT16                  Length;
+  UINT16                  DisableBit;
+  UINTN                   DeviceScopeNum;
+  UINTN                   ValidDeviceScopeNum;
+  UINTN                   Index;
+  BOOLEAN                 NeedRemove;
+  EFI_ACPI_RMRR_USB_STRUC *Rmrr;
+
+  ///
+  /// To make sure all devicescope can be checked,
+  /// we convert the RmrrPtr to EFI_ACPI_RMRR_USB_STRUC pointer
+  ///
+  Rmrr                = (EFI_ACPI_RMRR_USB_STRUC *) RmrrPtr;
+
+  Length              = Rmrr->RmrrHeader.Header.Length;
+  ValidDeviceScopeNum = 0;
+  DeviceScopeNum      = (Rmrr->RmrrHeader.Header.Length - EFI_ACPI_RMRR_HEADER_LENGTH) / sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
+  for (Index = 0; Index < DeviceScopeNum; Index++) {
+    DisableBit = GetFunDisableBit (
+                   Rmrr->DeviceScope[Index].PciPath.Device,
+                   Rmrr->DeviceScope[Index].PciPath.Function
+                   );
+    NeedRemove = FALSE;
+    if ((DisableBit == 0xFF) ||
+        ((DisableBit == 0x80) &&
+         (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0, Rmrr->DeviceScope[Index].PciPath.Device, Rmrr->DeviceScope[Index].PciPath.Function, 0x00)) == 0xFFFFFFFF))
+        ) {
+      NeedRemove = TRUE;
+    } else if (DisableBit == 0x8F) {
+      DEBUG ((DEBUG_ERROR, "Rmrr->RmrrHeader.ReservedMemoryRegionBaseAddress %x\n", Rmrr->RmrrHeader.ReservedMemoryRegionBaseAddress));
+
+      if (Rmrr->RmrrHeader.ReservedMemoryRegionBaseAddress != 0) {
+        DEBUG ((DEBUG_ERROR, "NeedRemove = FALSE\n"));
+        NeedRemove = FALSE;
+      } else {
+        DEBUG ((DEBUG_ERROR, "NeedRemove = TRUE\n"));
+        NeedRemove = TRUE;
+      }
+    }
+    CopyMem (
+      &Rmrr->DeviceScope[ValidDeviceScopeNum],
+      &Rmrr->DeviceScope[Index],
+      sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE)
+      );
+
+    if (Rmrr->RmrrHeader.ReservedMemoryRegionLimitAddress == 0x0) {
+      NeedRemove = TRUE;
+    }
+
+    if (NeedRemove) {
+      Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
+    } else {
+      ValidDeviceScopeNum++;
+    }
+  }
+  ///
+  /// If No deviceScope is left, set length as 0x00
+  ///
+  if (Length > EFI_ACPI_RMRR_HEADER_LENGTH) {
+    Rmrr->RmrrHeader.Header.Length = Length;
+  } else {
+    Rmrr->RmrrHeader.Header.Length = 0;
+  }
+}
+
+/**
+  Update the DMAR table
+
+  @param[in, out] TableHeader         - The table to be set
+  @param[in, out] Version             - Version to publish
+**/
+VOID
+DmarTableUpdate (
+  IN OUT   EFI_ACPI_DESCRIPTION_HEADER       *TableHeader,
+  IN OUT   EFI_ACPI_TABLE_VERSION            *Version
+  )
+{
+  EFI_ACPI_DMAR_TABLE *DmarTable;
+  EFI_ACPI_DMAR_TABLE TempDmarTable;
+  UINTN               Offset;
+  UINTN               StructureLen;
+  UINT64              McD0BaseAddress;
+  UINT32              GttMmAdr;
+  UINT64              McD2BaseAddress;
+  UINT16              IgdMode;
+  UINT16              GttMode;
+  UINT32              IgdMemSize;
+  UINT32              GttMemSize;
+  EFI_STATUS          Status;
+  VTD_DXE_CONFIG      *VtdDxeConfig;
+  SA_POLICY_PROTOCOL  *SaPolicy;
+
+
+  IgdMemSize  = 0;
+  GttMemSize  = 0;
+  DmarTable   = (EFI_ACPI_DMAR_TABLE *) TableHeader;
+
+  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **) &SaPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gVtdDxeConfigGuid, (VOID *)&VtdDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Set INTR_REMAP bit (BIT 0) if interrupt remapping is supported
+  ///
+  if (mInterruptRemappingSupport) {
+    DmarTable->DmarHeader.Flags |= BIT0;
+  }
+
+  if (mVtdDataHob->X2ApicOptOut == 1) {
+    DmarTable->DmarHeader.Flags |= BIT1;
+  } else {
+    DmarTable->DmarHeader.Flags &= 0xFD;
+  }
+
+  ///
+  /// Set DMA_CONTROL_GUARANTEE bit (BIT 2) if Dma Control Guarantee is supported
+  ///
+  if (mVtdDataHob->DmaControlGuarantee == 1) {
+    DmarTable->DmarHeader.Flags |= BIT2;
+  }
+  ///
+  /// Get OemId
+  ///
+  CopyMem (DmarTable->DmarHeader.Header.OemId, PcdGetPtr (PcdAcpiDefaultOemId), sizeof (DmarTable->DmarHeader.Header.OemId));
+  DmarTable->DmarHeader.Header.OemTableId      = PcdGet64 (PcdAcpiDefaultOemTableId);
+  DmarTable->DmarHeader.Header.OemRevision     = PcdGet32 (PcdAcpiDefaultOemRevision);
+  DmarTable->DmarHeader.Header.CreatorId       = PcdGet32 (PcdAcpiDefaultCreatorId);
+  DmarTable->DmarHeader.Header.CreatorRevision = PcdGet32 (PcdAcpiDefaultCreatorRevision);
+
+  ///
+  /// Calculate IGD memsize
+  ///
+  McD0BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, 0);
+  IgdMode = ((PciSegmentRead16 (McD0BaseAddress + R_SA_GGC) & B_SA_GGC_GMS_MASK) >> N_SA_GGC_GMS_OFFSET) & 0xFF;
+  if (IgdMode < 0xF0) {
+    IgdMemSize = IgdMode * 32 * (1024) * (1024);
+  } else {
+    IgdMemSize = 4 * (IgdMode - 0xF0 + 1) * (1024) * (1024);
+  }
+  ///
+  /// Calculate GTT mem size
+  ///
+  GttMemSize = 0;
+  GttMode = (PciSegmentRead16 (McD0BaseAddress + R_SA_GGC) & B_SA_GGC_GGMS_MASK) >> N_SA_GGC_GGMS_OFFSET;
+  if (GttMode <= V_SA_GGC_GGMS_8MB) {
+    GttMemSize = (1 << GttMode) * (1024) * (1024);
+  }
+
+  McD2BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
+  GttMmAdr = (PciSegmentRead32 (McD2BaseAddress + R_SA_IGD_GTTMMADR)) & 0xFFFFFFF0;
+
+  DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress   = (PciSegmentRead32 (McD0BaseAddress + R_SA_BGSM) & ~(0x01));
+  DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionLimitAddress  = DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress + IgdMemSize + GttMemSize - 1;
+  DEBUG ((DEBUG_INFO, "RMRR Base  address IGD %016lX\n", DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress));
+  DEBUG ((DEBUG_INFO, "RMRR Limit address IGD %016lX\n", DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionLimitAddress));
+
+  ///
+  /// Update DRHD structures of DmarTable
+  ///
+  DmarTable->DrhdEngine1.DrhdHeader.RegisterBaseAddress = ReadVtdBaseAddress(0);
+  DmarTable->DrhdEngine3.DrhdHeader.RegisterBaseAddress = ReadVtdBaseAddress (2);
+
+  DEBUG ((DEBUG_INFO, "VTD base address 1 = %x\n", DmarTable->DrhdEngine1.DrhdHeader.RegisterBaseAddress));
+  DEBUG ((DEBUG_INFO, "VTD base address 3 = %x\n", DmarTable->DrhdEngine3.DrhdHeader.RegisterBaseAddress));
+  ///
+  /// copy DmarTable to TempDmarTable to be processed
+  ///
+  CopyMem (&TempDmarTable, DmarTable, sizeof (EFI_ACPI_DMAR_TABLE));
+
+  ///
+  /// Update DRHD structures of temp DMAR table
+  ///
+  UpdateDrhd (&TempDmarTable.DrhdEngine1);
+  UpdateDrhd2 (&TempDmarTable.DrhdEngine3);
+
+  ///
+  /// Remove unused device scope or entire DRHD structures
+  ///
+  Offset = (UINTN) (&TempDmarTable.DrhdEngine1);
+  if (TempDmarTable.DrhdEngine1.DrhdHeader.Header.Length != 0) {
+    Offset += TempDmarTable.DrhdEngine1.DrhdHeader.Header.Length;
+  }
+  if (TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length != 0) {
+    StructureLen = TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length;
+    CopyMem ((VOID *) Offset, (VOID *) &TempDmarTable.DrhdEngine3, TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length);
+    Offset += StructureLen;
+  }
+  ///
+  /// Remove unused device scope or entire RMRR structures
+  ///
+  if (TempDmarTable.RmrrIgd.RmrrHeader.Header.Length != 0) {
+    StructureLen = TempDmarTable.RmrrIgd.RmrrHeader.Header.Length;
+    CopyMem ((VOID *) Offset, (VOID *) &TempDmarTable.RmrrIgd, TempDmarTable.RmrrIgd.RmrrHeader.Header.Length);
+    Offset += StructureLen;
+  }
+  Offset = Offset - (UINTN) &TempDmarTable;
+  ///
+  /// Re-calculate DMAR table check sum
+  ///
+  TempDmarTable.DmarHeader.Header.Checksum = (UINT8) (TempDmarTable.DmarHeader.Header.Checksum + TempDmarTable.DmarHeader.Header.Length - Offset);
+  ///
+  /// Set DMAR table length
+  ///
+  TempDmarTable.DmarHeader.Header.Length = (UINT32) Offset;
+  ///
+  /// Replace DMAR table with rebuilt table TempDmarTable
+  ///
+  CopyMem ((VOID *) DmarTable, (VOID *) &TempDmarTable, TempDmarTable.DmarHeader.Header.Length);
+}
+
+/**
+  EndOfPcieEnumration routine for update DMAR
+**/
+VOID
+UpdateDmarEndOfPcieEnum (
+  VOID
+  )
+{
+  EFI_STATUS                      Status;
+  EFI_HANDLE                      *HandleBuffer;
+  UINTN                           NumberOfHandles;
+  EFI_FV_FILETYPE                 FileType;
+  UINT32                          FvStatus;
+  EFI_FV_FILE_ATTRIBUTES          Attributes;
+  UINTN                           Size;
+  UINTN                           i;
+  INTN                            Instance;
+  EFI_ACPI_TABLE_VERSION          Version;
+  EFI_ACPI_COMMON_HEADER          *CurrentTable;
+  UINTN                           AcpiTableHandle;
+  EFI_FIRMWARE_VOLUME2_PROTOCOL   *FwVol;
+  EFI_ACPI_TABLE_PROTOCOL         *AcpiTable;
+  EFI_ACPI_DESCRIPTION_HEADER     *VtdAcpiTable;
+  STATIC BOOLEAN                  Triggered = FALSE;
+
+
+  if (Triggered) {
+    return;
+  }
+
+  Triggered     = TRUE;
+
+  FwVol         = NULL;
+  AcpiTable     = NULL;
+  VtdAcpiTable  = NULL;
+
+  DEBUG ((DEBUG_INFO, "UpdateDmarEndOfPcieEnum \n"));
+
+
+  ///
+  /// Fix DMAR Table always created, skip install when disabled
+  ///
+  if ((mVtdDataHob->VtdDisable == TRUE) || (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, R_SA_MC_CAPID0_A_OFFSET)) & BIT23)) {
+    DEBUG ((DEBUG_INFO, "Vtd Disabled, skip DMAR Table install\n"));
+    return;
+  }
+
+
+  ///
+  /// Locate ACPI support protocol
+  ///
+  Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID **) &AcpiTable);
+
+  ///
+  /// Locate protocol.
+  /// There is little chance we can't find an FV protocol
+  ///
+  Status = gBS->LocateHandleBuffer (
+                  ByProtocol,
+                  &gEfiFirmwareVolume2ProtocolGuid,
+                  NULL,
+                  &NumberOfHandles,
+                  &HandleBuffer
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Looking for FV with ACPI storage file
+  ///
+  for (i = 0; i < NumberOfHandles; i++) {
+    ///
+    /// Get the protocol on this handle
+    /// This should not fail because of LocateHandleBuffer
+    ///
+    Status = gBS->HandleProtocol (
+                    HandleBuffer[i],
+                    &gEfiFirmwareVolume2ProtocolGuid,
+                    (VOID **) &FwVol
+                    );
+    ASSERT_EFI_ERROR (Status);
+
+    ///
+    /// See if it has the ACPI storage file
+    ///
+    Size      = 0;
+    FvStatus  = 0;
+    Status = FwVol->ReadFile (
+                      FwVol,
+                      &gSaAcpiTableStorageGuid,
+                      NULL,
+                      &Size,
+                      &FileType,
+                      &Attributes,
+                      &FvStatus
+                      );
+
+    ///
+    /// If we found it, then we are done
+    ///
+    if (Status == EFI_SUCCESS) {
+      break;
+    }
+  }
+  ///
+  /// Our exit status is determined by the success of the previous operations
+  /// If the protocol was found, Instance already points to it.
+  ///
+  ///
+  /// Free any allocated buffers
+  ///
+  FreePool (HandleBuffer);
+
+  ///
+  /// Sanity check that we found our data file
+  ///
+  ASSERT (FwVol);
+  if (FwVol == NULL) {
+    return;
+  }
+  ///
+  /// By default, a table belongs in all ACPI table versions published.
+  ///
+  Version = EFI_ACPI_TABLE_VERSION_1_0B | EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0;
+
+  ///
+  /// Read tables from the storage file.
+  ///
+  Instance      = 0;
+  CurrentTable  = NULL;
+
+  while (Status == EFI_SUCCESS) {
+    Status = FwVol->ReadSection (
+                      FwVol,
+                      &gSaAcpiTableStorageGuid,
+                      EFI_SECTION_RAW,
+                      Instance,
+                      (VOID **) &CurrentTable,
+                      &Size,
+                      &FvStatus
+                      );
+
+    if (!EFI_ERROR (Status)) {
+      ///
+      /// Check the Signature ID to modify the table
+      ///
+      if ((CurrentTable != NULL) && ((EFI_ACPI_DESCRIPTION_HEADER *) CurrentTable)->Signature == EFI_ACPI_VTD_DMAR_TABLE_SIGNATURE) {
+        VtdAcpiTable = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTable;
+        DmarTableUpdate (VtdAcpiTable, &Version);
+        break;
+      }
+      ///
+      /// Increment the instance
+      ///
+      Instance++;
+      if (CurrentTable != NULL) {
+        gBS->FreePool (CurrentTable);
+        CurrentTable = NULL;
+      }
+    }
+  }
+  ///
+  /// Update the VTD table in the ACPI tables.
+  ///
+  AcpiTableHandle = 0;
+  if (VtdAcpiTable != NULL) {
+    Status = AcpiTable->InstallAcpiTable (
+                          AcpiTable,
+                          VtdAcpiTable,
+                          VtdAcpiTable->Length,
+                          &AcpiTableHandle
+                          );
+    FreePool (VtdAcpiTable);
+  }
+}
+
+/**
+  Locate the VT-d ACPI tables data file and read ACPI SSDT tables.
+  Publish the appropriate SSDT based on current configuration and capabilities.
+
+  @param[in] SaPolicy     -  SA DXE Policy protocol
+
+  @retval EFI_SUCCESS     - Vtd initialization complete
+  @exception EFI_UNSUPPORTED - Vtd is not enabled by policy
+**/
+EFI_STATUS
+VtdInit (
+  IN  SA_POLICY_PROTOCOL    *SaPolicy
+  )
+{
+  EFI_STATUS                      Status;
+  UINT64                          McD0BaseAddress;
+  UINT64                          McD2BaseAddress;
+  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
+  UINT8                           Index;
+
+  mInterruptRemappingSupport  = FALSE;
+  mVtdDataHob = NULL;
+  mVtdDataHob = GetFirstGuidHob(&gVtdDataHobGuid);
+  if (mVtdDataHob != NULL) {
+    mInterruptRemappingSupport = mVtdDataHob->InterruptRemappingSupport;
+  }
+
+  ///
+  ///  Locate the SA Global NVS Protocol.
+  ///
+  Status = gBS->LocateProtocol (
+                  &gSaNvsAreaProtocolGuid,
+                  NULL,
+                  (VOID **) &SaNvsAreaProtocol
+                  );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  McD0BaseAddress  = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, 0);
+  McD2BaseAddress  = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
+
+  if (mVtdDataHob != NULL) {
+    SaNvsAreaProtocol->Area->VtdDisable = mVtdDataHob->VtdDisable;
+  }
+
+  for (Index = 0; Index < VTD_ENGINE_NUMBER; Index++) {
+    SaNvsAreaProtocol->Area->VtdBaseAddress[Index] = ReadVtdBaseAddress (Index);
+  }
+  SaNvsAreaProtocol->Area->VtdEngine1Vid = PciSegmentRead16(McD2BaseAddress + PCI_VENDOR_ID_OFFSET);
+
+  if (mVtdDataHob != NULL) {
+    if ((mVtdDataHob->VtdDisable) || (PciSegmentRead32 (McD0BaseAddress + R_SA_MC_CAPID0_A_OFFSET) & BIT23)) {
+      DEBUG ((DEBUG_WARN, "VTd disabled or no capability!\n"));
+      return EFI_UNSUPPORTED;
+    }
+  }
+  ///
+  /// Check SA supports VTD and VTD is enabled in setup menu
+  ///
+  DEBUG ((DEBUG_INFO, "VTd enabled\n"));
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.inf
new file mode 100644
index 0000000000..9797c31cc6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.inf
@@ -0,0 +1,71 @@
+## @file
+# Component description file for the Dxe VTD Init library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeVtdInitLib
+FILE_GUID = 9BD11E68-923C-424C-A278-716084B4C931
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+LIBRARY_CLASS = DxeVtdInitLib
+
+[LibraryClasses]
+UefiLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+HobLib
+IoLib
+PciSegmentLib
+BaseMemoryLib
+MemoryAllocationLib
+MmPciLib
+VtdInfoLib
+PchInfoLib
+PchCycleDecodingLib
+SaPlatformLib
+DxeVtdInitFruLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeVtdInitLib.c
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemId
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemTableId
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemRevision
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorId
+gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision
+
+[FixedPcd]
+
+[Guids]
+gPchInfoHobGuid          ## CONSUMES
+gSaAcpiTableStorageGuid
+gVtdDataHobGuid
+gVtdDxeConfigGuid
+
+[Protocols]
+gSaPolicyProtocolGuid                  ## CONSUMES
+gSaNvsAreaProtocolGuid                 ## CONSUMES
+gEfiFirmwareVolume2ProtocolGuid
+gEfiAcpiTableProtocolGuid
+
+[Depex]
+gEfiAcpiTableProtocolGuid AND
+gEfiFirmwareVolume2ProtocolGuid AND
+gSaPolicyProtocolGuid AND
+gEfiPciRootBridgeIoProtocolGuid AND
+gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure that PCI MMIO resource has been prepared and available for this driver to allocate.
+gEfiHiiDatabaseProtocolGuid
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.c
new file mode 100644
index 0000000000..168de0c0a9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.c
@@ -0,0 +1,90 @@
+/** @file
+  This file provides services for DXE VTD policy default initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DxeVtdPolicyLib.h>
+
+/**
+  This function prints the DXE phase VTD policy.
+
+  @param[in] SaPolicy - Instance of SA_POLICY_PROTOCOL
+**/
+VOID
+VtdPrintPolicyDxe (
+  IN  SA_POLICY_PROTOCOL      *SaPolicy
+  )
+{
+  EFI_STATUS                  Status;
+  VTD_DXE_CONFIG             *VtdDxeConfig;
+
+  //
+  // Get requisite IP Config Blocks which needs to be used here
+  //
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gVtdDxeConfigGuid, (VOID *)&VtdDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG_CODE_BEGIN ();
+  DEBUG ((DEBUG_INFO, "\n------------------------ Vtd Policy (DXE) print BEGIN -----------------\n"));
+  DEBUG ((DEBUG_INFO, " Revision : %d\n", VtdDxeConfig->Header.Revision));
+  ASSERT (VtdDxeConfig->Header.Revision == VTD_DXE_CONFIG_REVISION);
+  DEBUG ((DEBUG_INFO, "\n------------------------ Vtd Policy (DXE) print END -----------------\n"));
+  DEBUG_CODE_END ();
+  return;
+}
+
+/**
+  This function Load default Vtd DXE policy.
+
+  @param[in] ConfigBlockPointer    The pointer to add VTD config block
+**/
+VOID
+VtdLoadDefaultDxe (
+  IN VOID    *ConfigBlockPointer
+  )
+{
+  VTD_DXE_CONFIG        *VtdDxeConfig;
+
+  VtdDxeConfig = ConfigBlockPointer;
+  DEBUG ((DEBUG_INFO, "VtdDxeConfig->Header.GuidHob.Name = %g\n", &VtdDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "VtdDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", VtdDxeConfig->Header.GuidHob.Header.HobLength));
+}
+
+static COMPONENT_BLOCK_ENTRY  mVtdDxeIpBlock = {
+  &gVtdDxeConfigGuid, sizeof (VTD_DXE_CONFIG), VTD_DXE_CONFIG_REVISION, VtdLoadDefaultDxe
+};
+
+/**
+  Get VTD DXE config block table total size.
+
+  @retval     Size of VTD DXE config block table
+**/
+UINT16
+EFIAPI
+VtdGetConfigBlockTotalSizeDxe (
+  VOID
+  )
+{
+  return mVtdDxeIpBlock.Size;
+}
+
+/**
+  VtdAddConfigBlocks add VTD DXE config block.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add VTD config blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+VtdAddConfigBlocksDxe (
+  IN VOID           *ConfigBlockTableAddress
+  )
+{
+  EFI_STATUS  Status;
+  Status = AddComponentConfigBlocks (ConfigBlockTableAddress, &mVtdDxeIpBlock, 1);
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf
new file mode 100644
index 0000000000..1fe288416a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf
@@ -0,0 +1,35 @@
+## @file
+# Component description file for the DxeVtdPolicy library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeVtdPolicyLib
+FILE_GUID = 54754C6D-4883-4B67-BBBA-49D241539BE7
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeVtdPolicyLib
+
+[LibraryClasses]
+BaseMemoryLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+HobLib
+SiConfigBlockLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+DxeVtdPolicyLib.c
+
+[Guids]
+gVtdDxeConfigGuid
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (28 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch " Heng Luo
                   ` (9 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * Library/BasePciSegmentMultiSegLibPci
  * Library/BaseSiConfigBlockLib
  * Library/PeiDxeSmmMmPciLib

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf |   38 +++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.uni |   14 ++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/PciSegmentLib.c                  | 1280 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.c                   |   86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf                 |   33 +++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.c                         |   35 +++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.inf                       |   43 ++++++++++++++++++++++++++++++
 7 files changed, 1529 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf
new file mode 100644
index 0000000000..b04bce9cf0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf
@@ -0,0 +1,38 @@
+## @file
+# Instance of PCI Segment Library based on PCI Library.
+#
+# PCI Segment Library that layers on top of the PCI Library which only
+#  supports segment 0 and segment 1 PCI configuration access.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BasePciSegmentMultiSegLibPci
+  MODULE_UNI_FILE                = BasePciSegmentMultiSegLibPci.uni
+  FILE_GUID                      = AC65B409-DF03-466e-8D2B-6FCE1079F0B2
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PciSegmentLib
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  PciSegmentLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
+
+[LibraryClasses]
+  BaseLib
+  PciLib
+  DebugLib
+  PcdLib
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.uni b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.uni
new file mode 100644
index 0000000000..09bd0f5cfc
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.uni
@@ -0,0 +1,14 @@
+/** @file
+  Instance of PCI Segment Library based on PCI Library.
+
+  PCI Segment Library that layers on top of the PCI Library which only
+   supports segment 0 and segment 1 PCI configuration access.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+
+#string STR_MODULE_ABSTRACT             #language en-US "Instance of PCI Segment Library based on PCI Library."
+
+#string STR_MODULE_DESCRIPTION          #language en-US "PCI Segment Library that layers on top of the PCI Library which only supports segment 0 and segment 1 PCI configuration access."
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/PciSegmentLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/PciSegmentLib.c
new file mode 100644
index 0000000000..0d0c64be3f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/PciSegmentLib.c
@@ -0,0 +1,1280 @@
+/** @file
+  PCI Segment Library that layers on top of the PCI Library which only
+   supports segment 0 and segment 1 PCI configuration access.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PciLib.h>
+#include <Library/PciSegmentLib.h>
+
+/**
+  Assert the validity of a PCI Segment address.
+  A valid PCI Segment address should not contain 1's in bits 28..31 and 33..63
+  and the segment should be 0 or 1.
+
+  @param  A The address to validate.
+  @param  M Additional bits to assert to be zero.
+
+**/
+#define ASSERT_INVALID_PCI_SEGMENT_ADDRESS(A,M) \
+  ASSERT (((A) & (0xfffffffef0000000ULL | (M))) == 0)
+
+/**
+  Convert the PCI Segment library address to PCI library address.
+  From ICL generation support the multiple segment, and the segment number start from BIT28,
+  So we convert the Segment Number offset from BIT32 to BIT28
+
+  @param A The address to convert.
+**/
+#define PCI_SEGMENT_TO_PCI_ADDRESS(A) ((UINTN) (UINT32) ((A) | ((RShiftU64 ((A) & BIT32, 4)))))
+
+/**
+  Register a PCI device so PCI configuration registers may be accessed after
+  SetVirtualAddressMap().
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address The address that encodes the PCI Bus, Device, Function and
+                  Register.
+
+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.
+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function
+                                   after ExitBootServices().
+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device
+                                   at runtime could not be mapped.
+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to
+                                   complete the registration.
+
+**/
+RETURN_STATUS
+EFIAPI
+PciSegmentRegisterForRuntimeAccess (
+  IN UINTN  Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+  return PciRegisterForRuntimeAccess (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Reads an 8-bit PCI configuration register.
+
+  Reads and returns the 8-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 8-bit PCI configuration register specified by Address.
+
+**/
+UINT8
+EFIAPI
+PciSegmentRead8 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+
+  return PciRead8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes an 8-bit PCI configuration register.
+
+  Writes the 8-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentWrite8 (
+  IN UINT64                    Address,
+  IN UINT8                     Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+
+  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of an 8-bit PCI configuration register with an 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     OrData
+  )
+{
+  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), (UINT8) (PciSegmentRead8 (Address) | OrData));
+}
+
+/**
+  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentAnd8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData
+  )
+{
+  return PciSegmentWrite8 (Address, (UINT8) (PciSegmentRead8 (Address) & AndData));
+}
+
+/**
+  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit value,
+  followed a  bitwise OR with another 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  performs a bitwise OR between the result of the AND operation and the value specified by OrData,
+  and writes the result to the 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData    The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (Address, (UINT8) ((PciSegmentRead8 (Address) & AndData) | OrData));
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in an 8-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to read.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..7.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..7.
+
+  @return The value of the bit field read from the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldRead8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead8 (PciSegmentRead8 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  8-bit register is returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..7.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..7.
+  @param  Value     The new value of the bit field.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldWrite8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     Value
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldWrite8 (PciSegmentRead8 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit PCI configuration, performs a bitwise OR, and
+  writes the result back to the bit field in the 8-bit port.
+
+  Reads the 8-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 8-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized. Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..7.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..7.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldOr8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldOr8 (PciSegmentRead8 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit PCI configuration register, performs a bitwise
+  AND, and writes the result back to the bit field in the 8-bit register.
+
+  Reads the 8-bit PCI configuration register specified by Address, performs a
+  bitwise AND between the read result and the value specified by AndData, and
+  writes the result to the 8-bit PCI configuration register specified by
+  Address. The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are
+  serialized. Extra left bits in AndData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..7.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..7.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldAnd8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     AndData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldAnd8 (PciSegmentRead8 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  8-bit port.
+
+  Reads the 8-bit PCI configuration register specified by Address, performs a
+  bitwise AND followed by a bitwise OR between the read result and
+  the value specified by AndData, and writes the result to the 8-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..7.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..7.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldAndThenOr8 (PciSegmentRead8 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a 16-bit PCI configuration register.
+
+  Reads and returns the 16-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 16-bit PCI configuration register specified by Address.
+
+**/
+UINT16
+EFIAPI
+PciSegmentRead16 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
+
+  return PciRead16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes a 16-bit PCI configuration register.
+
+  Writes the 16-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+
+**/
+UINT16
+EFIAPI
+PciSegmentWrite16 (
+  IN UINT64                    Address,
+  IN UINT16                    Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
+
+  return PciWrite16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of a 16-bit PCI configuration register with
+  a 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 16-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address The address that encodes the PCI Segment, Bus, Device, Function and
+                  Register.
+  @param  OrData  The value to OR with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16 (Address) | OrData));
+}
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentAnd16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16 (Address) & AndData));
+}
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value,
+  followed a  bitwise OR with another 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  performs a bitwise OR between the result of the AND operation and the value specified by OrData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData    The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) ((PciSegmentRead16 (Address) & AndData) | OrData));
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in a 16-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+  If StartBit is greater than 15, then ASSERT().
+  If EndBit is greater than 15, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to read.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..15.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..15.
+
+  @return The value of the bit field read from the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldRead16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead16 (PciSegmentRead16 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  16-bit register is returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+  If StartBit is greater than 15, then ASSERT().
+  If EndBit is greater than 15, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..15.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..15.
+  @param  Value     The new value of the bit field.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldWrite16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    Value
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldWrite16 (PciSegmentRead16 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+  If StartBit is greater than 15, then ASSERT().
+  If EndBit is greater than 15, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..15.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..15.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldOr16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldOr16 (PciSegmentRead16 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in a 16-bit PCI configuration, performs a bitwise OR,
+  and writes the result back to the bit field in the 16-bit port.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+  Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+  If StartBit is greater than 7, then ASSERT().
+  If EndBit is greater than 7, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    The ordinal of the least significant bit in a byte is bit 0.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    The ordinal of the most significant bit in a byte is bit 7.
+  @param  AndData   The value to AND with the read value from the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldAnd16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    AndData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldAnd16 (PciSegmentRead16 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in a 16-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  16-bit port.
+
+  Reads the 16-bit PCI configuration register specified by Address, performs a
+  bitwise AND followed by a bitwise OR between the read result and
+  the value specified by AndData, and writes the result to the 16-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 15, then ASSERT().
+  If EndBit is greater than 15, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..15.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..15.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldAndThenOr16 (PciSegmentRead16 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a 32-bit PCI configuration register.
+
+  Reads and returns the 32-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 32-bit PCI configuration register specified by Address.
+
+**/
+UINT32
+EFIAPI
+PciSegmentRead32 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
+
+  return PciRead32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes a 32-bit PCI configuration register.
+
+  Writes the 32-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+
+**/
+UINT32
+EFIAPI
+PciSegmentWrite32 (
+  IN UINT64                    Address,
+  IN UINT32                    Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
+
+  return PciWrite32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) | OrData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentAnd32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData
+  )
+{
+  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) & AndData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value,
+  followed a  bitwise OR with another 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  performs a bitwise OR between the result of the AND operation and the value specified by OrData,
+  and writes the result to the 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (Address, (PciSegmentRead32 (Address) & AndData) | OrData);
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in a 32-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+  If StartBit is greater than 31, then ASSERT().
+  If EndBit is greater than 31, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to read.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..31.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..31.
+
+  @return The value of the bit field read from the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldRead32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead32 (PciSegmentRead32 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  32-bit register is returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+  If StartBit is greater than 31, then ASSERT().
+  If EndBit is greater than 31, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..31.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..31.
+  @param  Value     The new value of the bit field.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldWrite32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    Value
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldWrite32 (PciSegmentRead32 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit PCI configuration, performs a bitwise OR, and
+  writes the result back to the bit field in the 32-bit port.
+
+  Reads the 32-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 32-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized. Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 31, then ASSERT().
+  If EndBit is greater than 31, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..31.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..31.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldOr32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldOr32 (PciSegmentRead32 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit PCI configuration register, performs a bitwise
+  AND, and writes the result back to the bit field in the 32-bit register.
+
+
+  Reads the 32-bit PCI configuration register specified by Address, performs a bitwise
+  AND between the read result and the value specified by AndData, and writes the result
+  to the 32-bit PCI configuration register specified by Address. The value written to
+  the PCI configuration register is returned.  This function must guarantee that all PCI
+  read and write operations are serialized.  Extra left bits in AndData are stripped.
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+  If StartBit is greater than 31, then ASSERT().
+  If EndBit is greater than 31, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..31.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..31.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldAnd32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    AndData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldAnd32 (PciSegmentRead32 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  32-bit port.
+
+  Reads the 32-bit PCI configuration register specified by Address, performs a
+  bitwise AND followed by a bitwise OR between the read result and
+  the value specified by AndData, and writes the result to the 32-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If StartBit is greater than 31, then ASSERT().
+  If EndBit is greater than 31, then ASSERT().
+  If EndBit is less than StartBit, then ASSERT().
+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().
+
+  @param  Address   The PCI configuration register to write.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    Range 0..31.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    Range 0..31.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldAndThenOr32 (PciSegmentRead32 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a range of PCI configuration registers into a caller supplied buffer.
+
+  Reads the range of PCI configuration registers specified by StartAddress and
+  Size into the buffer specified by Buffer. This function only allows the PCI
+  configuration registers from a single PCI function to be read. Size is
+  returned. When possible 32-bit PCI configuration read cycles are used to read
+  from StartAdress to StartAddress + Size. Due to alignment restrictions, 8-bit
+  and 16-bit PCI configuration read cycles may be used at the beginning and the
+  end of the range.
+
+  If any reserved bits in StartAddress are set, then ASSERT().
+  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
+  If Size > 0 and Buffer is NULL, then ASSERT().
+
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,
+                        Function and Register.
+  @param  Size          The size in bytes of the transfer.
+  @param  Buffer        The pointer to a buffer receiving the data read.
+
+  @return Size
+
+**/
+UINTN
+EFIAPI
+PciSegmentReadBuffer (
+  IN  UINT64                   StartAddress,
+  IN  UINTN                    Size,
+  OUT VOID                     *Buffer
+  )
+{
+  UINTN                                ReturnValue;
+
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
+  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
+
+  if (Size == 0) {
+    return Size;
+  }
+
+  ASSERT (Buffer != NULL);
+
+  //
+  // Save Size for return
+  //
+  ReturnValue = Size;
+
+  if ((StartAddress & BIT0) != 0) {
+    //
+    // Read a byte if StartAddress is byte aligned
+    //
+    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
+    StartAddress += sizeof (UINT8);
+    Size -= sizeof (UINT8);
+    Buffer = (UINT8*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
+    //
+    // Read a word if StartAddress is word aligned
+    //
+    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*)Buffer + 1;
+  }
+
+  while (Size >= sizeof (UINT32)) {
+    //
+    // Read as many double words as possible
+    //
+    WriteUnaligned32 (Buffer, PciSegmentRead32 (StartAddress));
+    StartAddress += sizeof (UINT32);
+    Size -= sizeof (UINT32);
+    Buffer = (UINT32*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16)) {
+    //
+    // Read the last remaining word if exist
+    //
+    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT8)) {
+    //
+    // Read the last remaining byte if exist
+    //
+    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
+  }
+
+  return ReturnValue;
+}
+
+/**
+  Copies the data in a caller supplied buffer to a specified range of PCI
+  configuration space.
+
+  Writes the range of PCI configuration registers specified by StartAddress and
+  Size from the buffer specified by Buffer. This function only allows the PCI
+  configuration registers from a single PCI function to be written. Size is
+  returned. When possible 32-bit PCI configuration write cycles are used to
+  write from StartAdress to StartAddress + Size. Due to alignment restrictions,
+  8-bit and 16-bit PCI configuration write cycles may be used at the beginning
+  and the end of the range.
+
+  If any reserved bits in StartAddress are set, then ASSERT().
+  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
+  If Size > 0 and Buffer is NULL, then ASSERT().
+
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,
+                        Function and Register.
+  @param  Size          The size in bytes of the transfer.
+  @param  Buffer        The pointer to a buffer containing the data to write.
+
+  @return The parameter of Size.
+
+**/
+UINTN
+EFIAPI
+PciSegmentWriteBuffer (
+  IN UINT64                    StartAddress,
+  IN UINTN                     Size,
+  IN VOID                      *Buffer
+  )
+{
+  UINTN                                ReturnValue;
+
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
+  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
+
+  if (Size == 0) {
+    return 0;
+  }
+
+  ASSERT (Buffer != NULL);
+
+  //
+  // Save Size for return
+  //
+  ReturnValue = Size;
+
+  if ((StartAddress & BIT0) != 0) {
+    //
+    // Write a byte if StartAddress is byte aligned
+    //
+    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
+    StartAddress += sizeof (UINT8);
+    Size -= sizeof (UINT8);
+    Buffer = (UINT8*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
+    //
+    // Write a word if StartAddress is word aligned
+    //
+    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*) Buffer + 1;
+  }
+
+  while (Size >= sizeof (UINT32)) {
+    //
+    // Write as many double words as possible
+    //
+    PciSegmentWrite32 (StartAddress, ReadUnaligned32 (Buffer));
+    StartAddress += sizeof (UINT32);
+    Size -= sizeof (UINT32);
+    Buffer = (UINT32*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16)) {
+    //
+    // Write the last remaining word if exist
+    //
+    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT8)) {
+    //
+    // Write the last remaining byte if exist
+    //
+    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
+  }
+
+  return ReturnValue;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.c
new file mode 100644
index 0000000000..4644de9b74
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.c
@@ -0,0 +1,86 @@
+/** @file
+  This file is BaseSiConfigBlockLib library is used to add config blocks
+  to config block header.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <ConfigBlock.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/SiConfigBlockLib.h>
+
+
+/**
+  GetComponentConfigBlockTotalSize get config block table total size.
+
+  @param[in] ComponentBlocks    Component blocks array
+  @param[in] TotalBlockCount    Number of blocks
+
+  @retval                       Size of config block table
+**/
+UINT16
+EFIAPI
+GetComponentConfigBlockTotalSize (
+  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
+  IN UINT16                TotalBlockCount
+  )
+{
+  UINT16            TotalBlockSize;
+  UINT16            BlockCount;
+
+  TotalBlockSize = 0;
+  for (BlockCount = 0 ; BlockCount < TotalBlockCount; BlockCount++) {
+    TotalBlockSize += (UINT32) ComponentBlocks[BlockCount].Size;
+    DEBUG ((DEBUG_INFO, "TotalBlockSize after adding Block[0x%x]= 0x%x\n", BlockCount, TotalBlockSize));
+  }
+
+  return TotalBlockSize;
+}
+
+/**
+  AddComponentConfigBlocks add all config blocks.
+
+  @param[in] ConfigBlockTableAddress    The pointer to add config blocks
+  @param[in] ComponentBlocks            Config blocks array
+  @param[in] TotalBlockCount            Number of blocks
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+AddComponentConfigBlocks (
+  IN VOID                  *ConfigBlockTableAddress,
+  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
+  IN UINT16                TotalBlockCount
+  )
+{
+  UINT16            BlockCount;
+  VOID              *ConfigBlockPointer;
+  CONFIG_BLOCK      ConfigBlockBuf;
+  EFI_STATUS        Status;
+
+  Status = EFI_SUCCESS;
+
+  //
+  // Initialize ConfigBlockPointer to NULL
+  //
+  ConfigBlockPointer = NULL;
+  //
+  // Loop to identify each config block from ComponentBlocks[] Table and add each of them
+  //
+  for (BlockCount = 0; BlockCount < TotalBlockCount; BlockCount++) {
+    ZeroMem (&ConfigBlockBuf, sizeof (CONFIG_BLOCK));
+    CopyMem (&(ConfigBlockBuf.Header.GuidHob.Name), ComponentBlocks[BlockCount].Guid, sizeof (EFI_GUID));
+    ConfigBlockBuf.Header.GuidHob.Header.HobLength = ComponentBlocks[BlockCount].Size;
+    ConfigBlockBuf.Header.Revision        = ComponentBlocks[BlockCount].Revision;
+    ConfigBlockPointer = (VOID *)&ConfigBlockBuf;
+    Status = AddConfigBlock ((VOID *)ConfigBlockTableAddress, (VOID *)&ConfigBlockPointer);
+    ASSERT_EFI_ERROR (Status);
+    ComponentBlocks[BlockCount].LoadDefault (ConfigBlockPointer);
+  }
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf
new file mode 100644
index 0000000000..e23b2d342f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf
@@ -0,0 +1,33 @@
+## @file
+# Component description file for the BaseSiConfigBlockLib library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = BaseSiConfigBlockLib
+FILE_GUID = 6C068D0F-F48E-48CB-B369-433E507AF4A2
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = SiConfigBlockLib
+
+
+[LibraryClasses]
+DebugLib
+IoLib
+ConfigBlockLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+BaseSiConfigBlockLib.c
+
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.c
new file mode 100644
index 0000000000..48e14dc9ee
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.c
@@ -0,0 +1,35 @@
+/** @file
+  This file contains routines that get PCI Express Address
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/BaseLib.h>
+#include <Library/PcdLib.h>
+#include <Library/DebugLib.h>
+
+/**
+  This procedure will get PCIE address
+
+  @param[in] Bus                  Pci Bus Number
+  @param[in] Device               Pci Device Number
+  @param[in] Function             Pci Function Number
+
+  @retval PCIE address
+**/
+UINTN
+EFIAPI
+MmPciBase (
+  IN UINT32                       Bus,
+  IN UINT32                       Device,
+  IN UINT32                       Function
+  )
+{
+  ASSERT ((Bus <= 0xFF) && (Device <= 0x1F) && (Function <= 0x7));
+
+#ifdef FSP_FLAG
+  return ((UINTN) PcdGet64 (PcdSiPciExpressBaseAddress) + (UINTN) (Bus << 20) + (UINTN) (Device << 15) + (UINTN) (Function << 12));
+#else
+  return ((UINTN) PcdGet64 (PcdPciExpressBaseAddress)   + (UINTN) (Bus << 20) + (UINTN) (Device << 15) + (UINTN) (Function << 12));
+#endif
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.inf
new file mode 100644
index 0000000000..353b97f3f6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.inf
@@ -0,0 +1,43 @@
+## @file
+# Component description file for the PeiDxeSmmMmPciLib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmMmPciLib
+FILE_GUID = D03D6670-A032-11E2-9E96-0800200C9A66
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = MmPciLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF EBC
+#
+
+
+
+[LibraryClasses]
+BaseLib
+PcdLib
+DebugLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
+
+[FixedPcd]
+gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
+
+[Sources]
+PeiDxeSmmMmPciLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch common library instances
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (29 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private " Heng Luo
                   ` (8 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * Pch/Library/BasePchPciBdfLib
  * Pch/Library/BaseResetSystemLib
  * Pch/Library/DxePchPolicyLib
  * Pch/Library/PeiDxeSmmPchCycleDecodingLib
  * Pch/Library/PeiDxeSmmPchInfoLib

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPciBdfLib.inf                         |   33 +++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLib.c                               | 1092 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.c                       |  158 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.inf                     |   38 +++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.c                             |  198 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.inf                           |   43 +++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PchCycleDecodingLib.c            |  587 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf |   42 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLib.c                              |  127 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibPrivate.h                       |   58 +++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibTgl.c                           |  715 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeSmmPchInfoLibTgl.inf                |   43 +++++++++++++++++++++++++++++++++++
 12 files changed, 3134 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPciBdfLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPciBdfLib.inf
new file mode 100644
index 0000000000..4f4096a409
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPciBdfLib.inf
@@ -0,0 +1,33 @@
+## @file
+# PCH PCIe Bus Device Function Library.
+#
+# All functions from this library are available in PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchPciBdfLib
+FILE_GUID = ED0C4241-40FA-4A74-B061-2E45E7AAD7BA
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchPciBdfLib
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchInfoLib
+PchPcieRpLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+PchPciBdfLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLib.c
new file mode 100644
index 0000000000..0db8cea4bb
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLib.c
@@ -0,0 +1,1092 @@
+/** @file
+  PCH PCIe Bus Device Function Library.
+  All functions from this library are available in PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Base.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <Register/PchRegs.h>
+#include <PchBdfAssignment.h>
+
+/**
+  Check if a Device is present for PCH FRU
+  If the data is defined for PCH RFU return it
+  If the data is not defined (Device is NOT present) assert.
+
+  @param[in]  DataToCheck       Device or Function number to check
+
+  @retval Device or Function number value if defined for PCH FRU
+          0xFF if not present in PCH FRU
+**/
+UINT8
+CheckAndReturn (
+  UINT8 DataToCheck
+  )
+{
+  if (DataToCheck == NOT_PRESENT) {
+    ASSERT (FALSE);
+  }
+  return DataToCheck;
+}
+
+/**
+  Get eSPI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval eSPI controller address in PCI Segment Library representation
+**/
+UINT64
+EspiPciCfgBase (
+  VOID
+  )
+{
+  ASSERT (PCI_DEVICE_NUMBER_PCH_ESPI != NOT_PRESENT);
+
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           PCI_DEVICE_NUMBER_PCH_ESPI,
+           PCI_FUNCTION_NUMBER_PCH_ESPI,
+           0
+           );
+}
+
+/**
+  Returns Gigabit Ethernet PCI Device Number
+
+  @retval  GbE device number
+**/
+UINT8
+GbeDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_GBE);
+}
+
+/**
+  Returns Gigabit Ethernet PCI Function Number
+
+  @retval  GbE function number
+**/
+UINT8
+GbeFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_GBE);
+}
+
+/**
+  Get GbE controller address that can be passed to the PCI Segment Library functions.
+
+  @retval GbE controller address in PCI Segment Library representation
+**/
+UINT64
+GbePciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            GbeDevNumber (),
+            GbeFuncNumber (),
+            0
+            );
+}
+
+/**
+  Get HDA PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+HdaDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HDA);
+}
+
+/**
+  Get HDA PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+HdaFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HDA);
+}
+
+/**
+  Get HDA controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HDA controller address in PCI Segment Library representation
+**/
+UINT64
+HdaPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            HdaDevNumber (),
+            HdaFuncNumber (),
+            0
+            );
+}
+
+/**
+  Get P2SB PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+P2sbDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_P2SB);
+}
+
+/**
+  Get P2SB PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+P2sbFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_P2SB);
+}
+
+/**
+  Get P2SB controller address that can be passed to the PCI Segment Library functions.
+
+  @retval P2SB controller address in PCI Segment Library representation
+**/
+UINT64
+P2sbPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           P2sbDevNumber (),
+           P2sbFuncNumber (),
+           0
+           );
+}
+
+/**
+  Returns PCH SPI Device number
+
+  @retval UINT8   PCH SPI Device number
+**/
+UINT8
+SpiDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SPI);
+}
+
+/**
+  Returns PCH SPI Function number
+
+  @retval UINT8   PCH SPI Function number
+**/
+UINT8
+SpiFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SPI);
+}
+
+/**
+  Returns PCH SPI PCI Config Space base address
+
+  @retval  UINT64  PCH SPI Config Space base address
+**/
+UINT64
+SpiPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SpiDevNumber (),
+           SpiFuncNumber (),
+           0
+           );
+}
+
+/**
+  Get XHCI controller PCIe Device Number
+
+  @retval XHCI controller PCIe Device Number
+**/
+UINT8
+PchXhciDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_XHCI);
+}
+
+/**
+  Get XHCI controller PCIe Function Number
+
+  @retval XHCI controller PCIe Function Number
+**/
+UINT8
+PchXhciFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_XHCI);
+}
+
+/**
+  Get XHCI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval XHCI controller address in PCI Segment Library representation
+**/
+UINT64
+PchXhciPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+          DEFAULT_PCI_BUS_NUMBER_PCH,
+          PchXhciDevNumber (),
+          PchXhciFuncNumber (),
+          0
+          );
+}
+
+/**
+  Get XDCI controller PCIe Device Number
+
+  @retval XDCI controller PCIe Device Number
+**/
+UINT8
+PchXdciDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_XDCI);
+}
+
+/**
+  Get XDCI controller PCIe Function Number
+
+  @retval XDCI controller PCIe Function Number
+**/
+UINT8
+PchXdciFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_XDCI);
+}
+
+/**
+  Get XDCI controller address that can be passed to the PCI Segment Library functions.
+
+  @retval XDCI controller address in PCI Segment Library representation
+**/
+UINT64
+PchXdciPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+          DEFAULT_PCI_BUS_NUMBER_PCH,
+          PchXdciDevNumber (),
+          PchXdciFuncNumber (),
+          0
+          );
+}
+
+/**
+  Return Smbus Device Number
+
+  @retval Smbus Device Number
+**/
+UINT8
+SmbusDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SMBUS);
+}
+
+/**
+  Return Smbus Function Number
+
+  @retval  Smbus Function Number
+**/
+UINT8
+SmbusFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SMBUS);
+}
+
+/**
+  Get SMBUS controller address that can be passed to the PCI Segment Library functions.
+
+  @retval SMBUS controller address in PCI Segment Library representation
+**/
+UINT64
+SmbusPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            SmbusDevNumber (),
+            SmbusFuncNumber (),
+            0
+            );
+}
+
+/**
+  Return DMA Smbus Device Number
+
+  @retval DMA Smbus Device Number
+**/
+UINT8
+SmbusDmaDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_DMA_SMBUS);
+}
+
+/**
+  Return DMA Smbus Function Number
+
+  @retval  DMA Smbus Function Number
+**/
+UINT8
+SmbusDmaFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_DMA_SMBUS);
+}
+
+/**
+  Get DMA SMBUS controller address that can be passed to the PCI Segment Library functions.
+
+  @retval DMA SMBUS controller address in PCI Segment Library representation
+**/
+UINT64
+SmbusDmaPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            SmbusDmaDevNumber (),
+            SmbusDmaFuncNumber (),
+            0
+            );
+}
+
+/**
+  Get SATA controller PCIe Device Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller PCIe Device Number
+**/
+UINT8
+SataDevNumber (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MAX_SATA_CONTROLLER);
+
+  if (SataCtrlIndex == 0) {
+    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_1);
+  } else if (SataCtrlIndex == 1) {
+    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_2);
+  } else if (SataCtrlIndex == 2) {
+    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_3);
+  } else {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+}
+
+/**
+  Get SATA controller PCIe Function Number
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller PCIe Function Number
+**/
+UINT8
+SataFuncNumber (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  ASSERT (SataCtrlIndex < MAX_SATA_CONTROLLER);
+
+  if (SataCtrlIndex == 0) {
+    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_1);
+  } else if (SataCtrlIndex == 1) {
+    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_2);
+  } else if (SataCtrlIndex == 2) {
+    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_3);
+  } else {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+}
+
+/**
+  Get SATA controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  SataCtrlIndex       SATA controller index
+
+  @retval SATA controller address in PCI Segment Library representation
+**/
+UINT64
+SataPciCfgBase (
+  IN UINT32  SataCtrlIndex
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SataDevNumber (SataCtrlIndex),
+           SataFuncNumber (SataCtrlIndex),
+           0
+           );
+}
+
+/**
+  Get LPC controller PCIe Device Number
+
+  @retval LPC controller PCIe Device Number
+**/
+UINT8
+LpcDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_LPC);
+}
+
+/**
+  Get LPC controller PCIe Function Number
+
+  @retval LPC controller PCIe Function Number
+**/
+UINT8
+LpcFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_LPC);
+}
+
+/**
+  Returns PCH LPC device PCI base address.
+
+  @retval                   PCH LPC PCI base address.
+**/
+UINT64
+LpcPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           LpcDevNumber (),
+           LpcFuncNumber (),
+           0
+           );
+}
+
+/**
+  Get Thermal Device PCIe Device Number
+
+  @retval Thermal Device PCIe Device Number
+**/
+UINT8
+ThermalDevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_THERMAL);
+}
+
+/**
+  Get Thermal Device PCIe Function Number
+
+  @retval Thermal Device PCIe Function Number
+**/
+UINT8
+ThermalFuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_THERMAL);
+}
+
+/**
+  Returns Thermal Device PCI base address.
+
+  @retval                   Thermal Device PCI base address.
+**/
+UINT64
+ThermalPciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           ThermalDevNumber (),
+           ThermalFuncNumber (),
+           0
+           );
+}
+
+/**
+  Get Serial IO I2C controller PCIe Device Number
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller PCIe Device Number
+**/
+UINT8
+SerialIoI2cDevNumber (
+  IN UINT8       I2cNumber
+  )
+{
+  if (GetPchMaxSerialIoI2cControllersNum () <= I2cNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+  switch (I2cNumber) {
+    case 0:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C0);
+    case 1:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C1);
+    case 2:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C2);
+    case 3:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C3);
+    case 4:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C4);
+    case 5:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C5);
+    case 6:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C6);
+    case 7:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C7);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO I2C controller PCIe Function Number
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller PCIe Function Number
+**/
+UINT8
+SerialIoI2cFuncNumber (
+  IN UINT8       I2cNumber
+  )
+{
+  if (GetPchMaxSerialIoI2cControllersNum () <= I2cNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+  switch (I2cNumber) {
+    case 0:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C0);
+    case 1:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C1);
+    case 2:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C2);
+    case 3:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C3);
+    case 4:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C4);
+    case 5:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C5);
+    case 6:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C6);
+    case 7:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C7);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO I2C controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  I2cNumber       Serial IO I2C controller index
+
+  @retval Serial IO I2C controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoI2cPciCfgBase (
+  IN UINT8        I2cNumber
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoI2cDevNumber (I2cNumber),
+           SerialIoI2cFuncNumber (I2cNumber),
+           0
+           );
+}
+
+/**
+  Get Serial IO SPI controller PCIe Device Number
+
+  @param[in]  I2cNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller PCIe Device Number
+**/
+UINT8
+SerialIoSpiDevNumber (
+  IN UINT8       SpiNumber
+  )
+{
+  if (GetPchMaxSerialIoSpiControllersNum () <= SpiNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+
+  switch (SpiNumber) {
+    case 0:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI0);
+    case 1:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI1);
+    case 2:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI2);
+    case 3:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI3);
+    case 4:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI4);
+    case 5:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI5);
+    case 6:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI6);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO SPI controller PCIe Function Number
+
+  @param[in]  SpiNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller PCIe Function Number
+**/
+UINT8
+SerialIoSpiFuncNumber (
+  IN UINT8       SpiNumber
+  )
+{
+  if (GetPchMaxSerialIoSpiControllersNum () <= SpiNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+
+  switch (SpiNumber) {
+    case 0:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI0);
+    case 1:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI1);
+    case 2:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI2);
+    case 3:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI3);
+    case 4:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI4);
+    case 5:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI5);
+    case 6:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI6);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO SPI controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  SpiNumber       Serial IO SPI controller index
+
+  @retval Serial IO SPI controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoSpiPciCfgBase (
+  IN UINT8        SpiNumber
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoSpiDevNumber (SpiNumber),
+           SerialIoSpiFuncNumber (SpiNumber),
+           0
+           );
+}
+
+/**
+  Get Serial IO UART controller PCIe Device Number
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller PCIe Device Number
+**/
+UINT8
+SerialIoUartDevNumber (
+  IN UINT8       UartNumber
+  )
+{
+  if (GetPchMaxSerialIoUartControllersNum () <= UartNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+  switch (UartNumber) {
+    case 0:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART0);
+    case 1:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART1);
+    case 2:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART2);
+    case 3:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART3);
+    case 4:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART4);
+    case 5:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART5);
+    case 6:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART6);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO UART controller PCIe Function Number
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller PCIe Function Number
+**/
+UINT8
+SerialIoUartFuncNumber (
+  IN UINT8       UartNumber
+  )
+{
+  if (GetPchMaxSerialIoUartControllersNum () <= UartNumber) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+  switch (UartNumber) {
+    case 0:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART0);
+    case 1:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART1);
+    case 2:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART2);
+    case 3:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART3);
+    case 4:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART4);
+    case 5:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART5);
+    case 6:
+      return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART6);
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get Serial IO UART controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  UartNumber       Serial IO UART controller index
+
+  @retval Serial IO UART controller address in PCI Segment Library representation
+**/
+UINT64
+SerialIoUartPciCfgBase (
+  IN UINT8        UartNumber
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+           DEFAULT_PCI_BUS_NUMBER_PCH,
+           SerialIoUartDevNumber (UartNumber),
+           SerialIoUartFuncNumber (UartNumber),
+           0
+           );
+}
+
+/**
+  Get PCH PCIe controller PCIe Device Number
+
+  @param[in]  RpIndex       Root port physical number. (0-based)
+
+  @retval PCH PCIe controller PCIe Device Number
+**/
+UINT8
+PchPcieRpDevNumber (
+  IN  UINTN   RpIndex
+  )
+{
+  if (RpIndex >= GetPchMaxPciePortNum ()) {
+    ASSERT (FALSE);
+    return 0xFF;
+  }
+  switch (RpIndex) {
+    case 0:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1);
+    case 1:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_2);
+    case 2:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_3);
+    case 3:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_4);
+    case 4:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5);
+    case 5:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_6);
+    case 6:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_7);
+    case 7:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_8);
+    case 8:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9);
+    case 9:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_10);
+    case 10:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_11);
+    case 11:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_12);
+    case 12:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13);
+    case 13:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_14);
+    case 14:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_15);
+    case 15:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_16);
+    case 16:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17);
+    case 17:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_18);
+    case 18:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_19);
+    case 19:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_20);
+    case 20:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21);
+    case 21:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_22);
+    case 22:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_23);
+    case 23:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_24);
+    case 24:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_25);
+    case 25:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_26);
+    case 26:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_27);
+    case 27:
+      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_28);
+
+    default:
+      ASSERT (FALSE);
+      return 0xFF;
+  }
+}
+
+/**
+  Get PCH PCIe controller PCIe Function Number
+  Note:
+  For Client PCH generations Function Number can be various
+  depending on "Root Port Function Swapping". For such cases
+  Function Number  MUST be obtain from proper register.
+  For Server PCHs we have no "Root Port Function Swapping"
+  and we can return fixed Function Number.
+  To address this difference in this, PCH generation independent,
+  library we should call specific function in PchPcieRpLib.
+
+  @param[in]  RpIndex       Root port physical number. (0-based)
+
+  @retval PCH PCIe controller PCIe Function Number
+**/
+UINT8
+PchPcieRpFuncNumber (
+  IN  UINTN   RpIndex
+  )
+{
+  UINTN   Device;
+  UINTN   Function;
+
+  GetPchPcieRpDevFun (RpIndex, &Device, &Function);
+
+  return (UINT8)Function;
+}
+
+/**
+  Get PCH PCIe controller address that can be passed to the PCI Segment Library functions.
+
+  @param[in]  RpIndex       PCH PCIe Root Port physical number. (0-based)
+
+  @retval PCH PCIe controller address in PCI Segment Library representation
+**/
+UINT64
+PchPcieRpPciCfgBase (
+  IN  UINT32   RpIndex
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+          DEFAULT_PCI_BUS_NUMBER_PCH,
+          PchPcieRpDevNumber (RpIndex),
+          PchPcieRpFuncNumber (RpIndex),
+          0
+          );
+}
+
+/**
+  Get HECI1 PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+PchHeci1DevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HECI1);
+}
+
+/**
+  Get HECI1 PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+PchHeci1FuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HECI1);
+}
+
+/**
+  Get HECI1 controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HECI1 controller address in PCI Segment Library representation
+**/
+UINT64
+PchHeci1PciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            PchHeci1DevNumber (),
+            PchHeci1FuncNumber (),
+            0
+            );
+}
+
+/**
+  Get HECI3 PCI device number
+
+  @retval PCI dev number
+**/
+UINT8
+PchHeci3DevNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HECI3);
+}
+
+/**
+  Get HECI3 PCI function number
+
+  @retval PCI fun number
+**/
+UINT8
+PchHeci3FuncNumber (
+  VOID
+  )
+{
+  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HECI3);
+}
+
+/**
+  Get HECI3 controller address that can be passed to the PCI Segment Library functions.
+
+  @retval HECI3 controller address in PCI Segment Library representation
+**/
+UINT64
+PchHeci3PciCfgBase (
+  VOID
+  )
+{
+  return PCI_SEGMENT_LIB_ADDRESS (
+            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+            DEFAULT_PCI_BUS_NUMBER_PCH,
+            PchHeci3DevNumber (),
+            PchHeci3FuncNumber (),
+            0
+            );
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.c
new file mode 100644
index 0000000000..2ede8e0021
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.c
@@ -0,0 +1,158 @@
+/** @file
+  System reset library services.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/ResetSystemLib.h>
+#include <Library/PmcLib.h>
+#include <Library/BaseLib.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/PmcRegs.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16           mBaseResetSystemABase;
+
+/**
+  Calling this function causes a system-wide reset. This sets
+  all circuitry within the system to its initial state. This type of reset
+  is asynchronous to system operation and operates without regard to
+  cycle boundaries.
+
+  System reset should not return, if it returns, it means the system does
+  not support cold reset.
+**/
+VOID
+EFIAPI
+ResetCold (
+  VOID
+  )
+{
+  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_FULLRESET);
+}
+
+/**
+  Calling this function causes a system-wide initialization. The processors
+  are set to their initial state, and pending cycles are not corrupted.
+
+  System reset should not return, if it returns, it means the system does
+  not support warm reset.
+**/
+VOID
+EFIAPI
+ResetWarm (
+  VOID
+  )
+{
+  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_HARDRESET);
+}
+
+/**
+  Calling this function causes the system to enter a power state equivalent
+  to the ACPI G2/S5 or G3 states.
+
+  System shutdown should not return, if it returns, it means the system does
+  not support shut down reset.
+**/
+VOID
+EFIAPI
+ResetShutdown (
+  VOID
+  )
+{
+  UINT16         ABase;
+  UINT32         Data32;
+
+  ABase = mBaseResetSystemABase;
+  if (ABase == 0) {
+    ABase = PmcGetAcpiBase ();
+  }
+  ///
+  /// Firstly, GPE0_EN should be disabled to avoid any GPI waking up the system from S5
+  ///
+  IoWrite32 (ABase + R_ACPI_IO_GPE0_EN_127_96, 0);
+
+  ///
+  /// Secondly, PwrSts register must be cleared
+  ///
+  /// Write a "1" to bit[8] of power button status register at
+  /// (PM_BASE + PM1_STS_OFFSET) to clear this bit
+  ///
+  IoWrite16 (ABase + R_ACPI_IO_PM1_STS, B_ACPI_IO_PM1_STS_PWRBTN);
+
+  ///
+  /// Finally, transform system into S5 sleep state
+  ///
+  Data32 = IoRead32 (ABase + R_ACPI_IO_PM1_CNT);
+
+  Data32 = (UINT32) ((Data32 &~(B_ACPI_IO_PM1_CNT_SLP_TYP + B_ACPI_IO_PM1_CNT_SLP_EN)) | V_ACPI_IO_PM1_CNT_S5);
+
+  IoWrite32 (ABase + R_ACPI_IO_PM1_CNT, Data32);
+
+  Data32 = Data32 | B_ACPI_IO_PM1_CNT_SLP_EN;
+
+  IoWrite32 (ABase + R_ACPI_IO_PM1_CNT, Data32);
+
+  return;
+}
+
+/**
+  Calling this function causes the system to enter a power state for platform specific.
+
+  @param[in] DataSize             The size of ResetData in bytes.
+  @param[in] ResetData            Optional element used to introduce a platform specific reset.
+                                  The exact type of the reset is defined by the EFI_GUID that follows
+                                  the Null-terminated Unicode string.
+
+**/
+VOID
+EFIAPI
+ResetPlatformSpecific (
+  IN UINTN            DataSize,
+  IN VOID             *ResetData OPTIONAL
+  )
+{
+  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_FULLRESET);
+}
+
+/**
+  Calling this function causes the system to enter a power state for capsule update.
+
+  Reset update should not return, if it returns, it means the system does
+  not support capsule update.
+
+**/
+VOID
+EFIAPI
+EnterS3WithImmediateWake (
+  VOID
+  )
+{
+  //
+  // In case there are pending capsules to process, need to flush the cache.
+  //
+  AsmWbinvd ();
+
+  ResetWarm ();
+  ASSERT (FALSE);
+}
+
+/**
+  The library constructuor.
+
+  The function does the necessary initialization work for this library instance.
+
+  @retval     EFI_SUCCESS       The function always return EFI_SUCCESS for now.
+**/
+EFI_STATUS
+EFIAPI
+BaseResetSystemLibConstructor (
+  VOID
+  )
+{
+  mBaseResetSystemABase = PmcGetAcpiBase ();
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.inf
new file mode 100644
index 0000000000..a4f805035a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.inf
@@ -0,0 +1,38 @@
+## @file
+# Component description file for Intel Ich7 Reset System Library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = BaseResetSystemLib
+FILE_GUID = D4FF05AA-3C7D-4B8A-A1EE-AA5EFA0B1732
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+UEFI_SPECIFICATION_VERSION = 2.00
+LIBRARY_CLASS = ResetSystemLib
+CONSTRUCTOR = BaseResetSystemLibConstructor
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF
+#
+
+[LibraryClasses]
+IoLib
+BaseLib
+DebugLib
+PmcLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+BaseResetSystemLib.c
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.c
new file mode 100644
index 0000000000..90aea8f420
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.c
@@ -0,0 +1,198 @@
+/** @file
+  This file provide services for DXE phase policy default initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <ConfigBlock.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/SiConfigBlockLib.h>
+#include <Protocol/PchPolicy.h>
+#include <ScsConfig.h>
+#include <Library/DxeGpioPolicyLib.h>
+#include <Library/DxeHdaPolicyLib.h>
+#include <Library/DxePchPcieRpPolicyLib.h>
+
+/**
+  Load DXE Config block default for eMMC
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+LoadEmmcDxeConfigDefault (
+  IN VOID          *ConfigBlockPointer
+  )
+{
+  SCS_EMMC_DXE_CONFIG  *EmmcDxeConfig;
+  EmmcDxeConfig = ConfigBlockPointer;
+
+  DEBUG ((DEBUG_INFO, "EmmcDxeConfig->Header.GuidHob.Name = %g\n", &EmmcDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "EmmcDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", EmmcDxeConfig->Header.GuidHob.Header.HobLength));
+
+  EmmcDxeConfig->DriverStrength = DriverStrength40Ohm;
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED COMPONENT_BLOCK_ENTRY  mPchDxeIpBlocks [] = {
+  {&gEmmcDxeConfigGuid,    sizeof (SCS_EMMC_DXE_CONFIG), SCS_EMMC_DXE_CONFIG_REVISION, LoadEmmcDxeConfigDefault}
+};
+
+/**
+  Print SCS_EMMC_DXE_CONFIG.
+
+  @param[in] EmmcDxeConfig         Pointer to a SCS_EMMC_DXE_CONFIG that provides the eMMC settings
+**/
+VOID
+PchPrintEmmcDxeConfig (
+  IN CONST SCS_EMMC_DXE_CONFIG  *EmmcDxeConfig
+  )
+{
+  DEBUG ((DEBUG_INFO, "------------------ PCH eMMC DXE Config ------------------\n"));
+  DEBUG ((DEBUG_INFO, " DriverStrength : %d\n", EmmcDxeConfig->DriverStrength));
+  DEBUG ((DEBUG_INFO, " EnableSoftwareHs400Tuning: %d\n", EmmcDxeConfig->EnableSoftwareHs400Tuning));
+  DEBUG ((DEBUG_INFO, " TuningLba : %X\n", EmmcDxeConfig->TuningLba));
+  DEBUG ((DEBUG_INFO, " Previous tuning success : %d\n", EmmcDxeConfig->PreviousTuningResults.TuningSuccessful));
+  if (EmmcDxeConfig->PreviousTuningResults.TuningSuccessful) {
+    DEBUG ((DEBUG_INFO, "  Hs400 Rx DLL value : %X\n", EmmcDxeConfig->PreviousTuningResults.Hs400RxValue));
+    DEBUG ((DEBUG_INFO, "  Hs400 Tx DLL value : %X\n", EmmcDxeConfig->PreviousTuningResults.Hs400TxValue));
+  }
+}
+
+/**
+  This function prints the PCH DXE phase policy.
+
+  @param[in] PchPolicy - PCH DXE Policy protocol
+**/
+VOID
+PchPrintPolicyProtocol (
+  IN  PCH_POLICY_PROTOCOL      *PchPolicy
+  )
+{
+  DEBUG_CODE_BEGIN();
+  EFI_STATUS                 Status;
+  SCS_EMMC_DXE_CONFIG        *EmmcDxeConfig;
+
+  //
+  // Get requisite IP Config Blocks which needs to be used here
+  //
+  Status = GetConfigBlock ((VOID *) PchPolicy, &gEmmcDxeConfigGuid, (VOID *)&EmmcDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "------------------------ PCH Policy (DXE) Print Start ------------------------\n"));
+  DEBUG ((DEBUG_INFO, " Revision : %x\n", PchPolicy->TableHeader.Header.Revision));
+
+  PchPrintEmmcDxeConfig (EmmcDxeConfig);
+  GpioDxePrintConfig (PchPolicy);
+  HdaDxePrintConfig (PchPolicy);
+  PchPcieRpDxePrintConfig (PchPolicy);
+
+  DEBUG ((DEBUG_INFO, "------------------------ PCH Policy (DXE) Print End --------------------------\n"));
+  DEBUG_CODE_END();
+}
+
+/**
+  CreatePchDxeConfigBlocks generates the config blocksg of PCH DXE Policy.
+  It allocates and zero out buffer, and fills in the Intel default settings.
+
+  @param[out] PchPolicy                 The pointer to get PCH DXE Protocol instance
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+CreatePchDxeConfigBlocks (
+  IN OUT  PCH_POLICY_PROTOCOL      **DxePchPolicy
+  )
+{
+  UINT16              TotalBlockSize;
+  EFI_STATUS          Status;
+  PCH_POLICY_PROTOCOL *PchPolicyInit;
+  UINT16              RequiredSize;
+
+
+  DEBUG ((DEBUG_INFO, "PCH Create Dxe Config Blocks\n"));
+
+  PchPolicyInit = NULL;
+
+  TotalBlockSize = GetComponentConfigBlockTotalSize (&mPchDxeIpBlocks[0], sizeof (mPchDxeIpBlocks) / sizeof (COMPONENT_BLOCK_ENTRY));
+  TotalBlockSize += GpioDxeGetConfigBlockTotalSize();
+  TotalBlockSize += HdaDxeGetConfigBlockTotalSize();
+  TotalBlockSize += PchPcieRpDxeGetConfigBlockTotalSize();
+
+  DEBUG ((DEBUG_INFO, "TotalBlockSize = 0x%x\n", TotalBlockSize));
+
+  RequiredSize = sizeof (CONFIG_BLOCK_TABLE_HEADER) + TotalBlockSize;
+
+  Status = CreateConfigBlockTable (RequiredSize, (VOID *) &PchPolicyInit);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // General initialization
+  //
+  PchPolicyInit->TableHeader.Header.Revision = PCH_POLICY_PROTOCOL_REVISION;
+  //
+  // Add config blocks.
+  //
+  Status =  AddComponentConfigBlocks ((VOID *) PchPolicyInit, &mPchDxeIpBlocks[0], sizeof (mPchDxeIpBlocks) / sizeof (COMPONENT_BLOCK_ENTRY));
+  ASSERT_EFI_ERROR (Status);
+
+  Status =  GpioDxeAddConfigBlock ((VOID *) PchPolicyInit);
+  ASSERT_EFI_ERROR (Status);
+
+  Status =  HdaDxeAddConfigBlock ((VOID *) PchPolicyInit);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = PchPcieRpDxeAddConfigBlock ((VOID *) PchPolicyInit);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Assignment for returning SaInitPolicy config block base address
+  //
+  *DxePchPolicy = PchPolicyInit;
+  return Status;
+}
+
+/**
+  PchInstallPolicyProtocol installs PCH Policy.
+  While installed, RC assumes the Policy is ready and finalized. So please update and override
+  any setting before calling this function.
+
+  @param[in] ImageHandle                Image handle of this driver.
+  @param[in] SaPolicy                   The pointer to SA Policy Protocol instance
+
+  @retval EFI_SUCCESS                   The policy is installed.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+
+**/
+EFI_STATUS
+EFIAPI
+PchInstallPolicyProtocol (
+  IN  EFI_HANDLE                  ImageHandle,
+  IN  PCH_POLICY_PROTOCOL         *PchPolicy
+  )
+{
+
+  EFI_STATUS            Status;
+
+  ///
+  /// Print PCH DXE Policy
+  ///
+  PchPrintPolicyProtocol (PchPolicy);
+
+  ///
+  /// Install protocol to to allow access to this Policy.
+  ///
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gPchPolicyProtocolGuid,
+                  PchPolicy,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.inf
new file mode 100644
index 0000000000..50e5cdacfd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.inf
@@ -0,0 +1,43 @@
+## @file
+# Component description file for the PeiPchPolicy library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxePchPolicyLib
+FILE_GUID = E2179D04-7026-48A5-9475-309CEA2F21A3
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxePchPolicyLib
+
+
+[LibraryClasses]
+BaseMemoryLib
+UefiBootServicesTableLib
+DebugLib
+ConfigBlockLib
+SiConfigBlockLib
+PchInfoLib
+DxeGpioPolicyLib
+DxeHdaPolicyLib
+DxePchPcieRpPolicyLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+DxePchPolicyLib.c
+
+
+[Guids]
+gEmmcDxeConfigGuid
+
+[Protocols]
+gPchPolicyProtocolGuid ## PRODUCES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PchCycleDecodingLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PchCycleDecodingLib.c
new file mode 100644
index 0000000000..0927cd1ced
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PchCycleDecodingLib.c
@@ -0,0 +1,587 @@
+/** @file
+  PCH cycle decoding configuration and query library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PchDmiLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Register/PchRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/SpiRegs.h>
+#include <Register/SmbusRegs.h>
+#include <Library/EspiLib.h>
+#include <Library/PchPciBdfLib.h>
+
+typedef enum {
+  SlaveLpcEspiCS0,
+  SlaveEspiCS1,
+  SlaveId_Max
+} SLAVE_ID_INDEX;
+
+/**
+  Get PCH TCO base address.
+
+  @param[out] Address                   Address of TCO base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid pointer passed.
+**/
+EFI_STATUS
+PchTcoBaseGet (
+  OUT UINT16                            *Address
+  )
+{
+  if (Address == NULL) {
+    DEBUG ((DEBUG_ERROR, "PchTcoBaseGet Error. Invalid pointer.\n"));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Read "TCO Base Address" from DMI
+  // Don't read TCO base address from SMBUS PCI register since SMBUS might be disabled.
+  //
+  *Address = PchDmiGetTcoBase ();
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Set PCH LPC/eSPI and eSPI CS1# generic IO range decoding.
+
+  Steps of programming generic IO range:
+  1. Program LPC/eSPI PCI Offset 84h ~ 93h (LPC, eSPI CS0#) or A4h (eSPI CS1#) of Mask, Address, and Enable.
+  2. Program LPC/eSPI Generic IO Range in DMI
+
+  @param[in] Address                    Address for generic IO range decoding.
+  @param[in] Length                     Length of generic IO range.
+  @param[in] SlaveId                    Slave ID (refer to SLAVE_ID_INDEX)
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
+  @retval EFI_UNSUPPORTED               DMI configuration is locked,
+                                        GenIO range conflicting with other eSPI CS
+**/
+STATIC
+EFI_STATUS
+LpcEspiGenIoRangeSetHelper (
+  IN  UINT32                            Address,
+  IN  UINT32                            Length,
+  IN  SLAVE_ID_INDEX                    SlaveId
+  )
+{
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Set PCH LPC/eSPI generic IO range.
+  For generic IO range, the base address must align to 4 and less than 0xFFFF, and the length must be power of 2
+  and less than or equal to 256. Moreover, the address must be length aligned.
+  This function basically checks the address and length, which should not overlap with all other generic ranges.
+  If no more generic range register available, it returns out of resource error.
+  This cycle decoding is also required on DMI side
+  Some IO ranges below 0x100 have fixed target. The target might be ITSS,RTC,LPC,PMC or terminated inside P2SB
+  but all predefined and can't be changed. IO range below 0x100 will be rejected in this function except below ranges:
+    0x00-0x1F,
+    0x44-0x4B,
+    0x54-0x5F,
+    0x68-0x6F,
+    0x80-0x8F,
+    0xC0-0xFF
+  Steps of programming generic IO range:
+  1. Program LPC/eSPI PCI Offset 84h ~ 93h of Mask, Address, and Enable.
+  2. Program LPC/eSPI Generic IO Range in DMI
+
+  @param[in] Address                    Address for generic IO range base address.
+  @param[in] Length                     Length of generic IO range.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcGenIoRangeSet (
+  IN  UINT16                            Address,
+  IN  UINTN                             Length
+  )
+{
+  return LpcEspiGenIoRangeSetHelper ((UINT32)Address, (UINT32)Length, SlaveLpcEspiCS0);
+}
+
+
+/**
+  Set PCH LPC/eSPI and eSPI CS1# memory range decoding.
+  This cycle decoding is required to be set on DMI side
+  Programming steps:
+  1. Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [0] to [0] to disable memory decoding first before changing base address.
+  2. Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
+  3. Program LPC/eSPI Memory Range in DMI
+
+  @param[in] Address                    Address for memory for decoding.
+  @param[in] RangeIndex                 Slave ID (refer to SLAVE_ID_INDEX)
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+**/
+STATIC
+EFI_STATUS
+LpcEspiMemRangeSetHelper (
+  IN  UINT32                            Address,
+  IN  SLAVE_ID_INDEX                    SlaveId
+  )
+{
+  UINT64                                LpcBase;
+  EFI_STATUS                            Status;
+  UINT32                                GenMemReg;
+  UINT32                                MemRangeAddr;
+
+  if (((Address & (~B_LPC_CFG_LGMR_MA)) != 0) || (SlaveId >= SlaveId_Max)) {
+    DEBUG ((DEBUG_ERROR, "%a Error. Invalid Address: %x or invalid SlaveId\n", __FUNCTION__, Address));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  LpcBase = LpcPciCfgBase ();
+
+  MemRangeAddr = ~Address;
+  if (SlaveId == SlaveEspiCS1) {
+    GenMemReg = R_ESPI_CFG_CS1GMR1;
+    // Memory Range already decoded for LPC/eSPI?
+    Status = PchLpcMemRangeGet (&MemRangeAddr);
+    if (MemRangeAddr != Address) {
+      Status = PchDmiSetEspiCs1MemRange (Address);
+      if (EFI_ERROR (Status)) {
+        ASSERT_EFI_ERROR (Status);
+        return Status;
+      }
+    }
+  } else {
+    GenMemReg = R_LPC_CFG_LGMR;
+    // Memory Range already decoded for eSPI CS1?
+    Status = PchEspiCs1MemRangeGet (&MemRangeAddr);
+    if (MemRangeAddr != Address) {
+      Status = PchDmiSetLpcMemRange (Address);
+      if (EFI_ERROR (Status)) {
+        ASSERT_EFI_ERROR (Status);
+        return Status;
+      }
+    }
+  }
+
+  //
+  // Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [0] to [0] to disable memory decoding first before changing base address.
+  //
+  PciSegmentAnd32 (
+    LpcBase + GenMemReg,
+    (UINT32) ~B_LPC_CFG_LGMR_LMRD_EN
+    );
+  //
+  // Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
+  //
+  PciSegmentWrite32 (
+    LpcBase + GenMemReg,
+    (Address | B_LPC_CFG_LGMR_LMRD_EN)
+    );
+
+  return Status;
+}
+
+/**
+  Set PCH LPC/eSPI memory range decoding.
+  This cycle decoding is required to be set on DMI side
+  Programming steps:
+  1. Program LPC PCI Offset 98h [0] to [0] to disable memory decoding first before changing base address.
+  2. Program LPC PCI Offset 98h [31:16, 0] to [Address, 1].
+  3. Program LPC Memory Range in DMI
+
+  @param[in] Address                    Address for memory base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcMemRangeSet (
+  IN  UINT32                            Address
+  )
+{
+  return LpcEspiMemRangeSetHelper (Address, SlaveLpcEspiCS0);
+}
+
+/**
+  Set PCH eSPI CS1# memory range decoding.
+  This cycle decoding is required to be set on DMI side
+  Programming steps:
+  1. Program eSPI PCI Offset A8h (eSPI CS1#) [0] to [0] to disable memory decoding first before changing base address.
+  2. Program eSPI PCI Offset A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
+  3. Program eSPI Memory Range in DMI
+
+  @param[in] Address                    Address for memory for decoding.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address or length passed.
+  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
+**/
+EFI_STATUS
+PchEspiCs1MemRangeSet (
+  IN  UINT32                            Address
+  )
+{
+  if (!IsEspiSecondSlaveSupported ()) {
+    return EFI_UNSUPPORTED;
+  }
+
+  return LpcEspiMemRangeSetHelper (Address, SlaveEspiCS1);
+}
+
+/**
+  Get PCH LPC/eSPI and eSPI CS1# memory range decoding address.
+
+  @param[in]  SlaveId                   Slave ID (refer to SLAVE_ID_INDEX)
+  @param[out] Address                   Address of LPC/eSPI or eSPI CS1# memory decoding base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
+  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
+**/
+STATIC
+EFI_STATUS
+LpcEspiMemRangeGetHelper (
+  IN  SLAVE_ID_INDEX                    SlaveId,
+  OUT UINT32                            *Address
+  )
+{
+  UINT32                                GenMemReg;
+
+  if ((Address == NULL) || (SlaveId >= SlaveId_Max)) {
+    DEBUG ((DEBUG_ERROR, "%a Error. Invalid pointer or SlaveId.\n", __FUNCTION__));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (SlaveId == SlaveEspiCS1) {
+    GenMemReg = R_ESPI_CFG_CS1GMR1;
+  } else {
+    GenMemReg = R_LPC_CFG_LGMR;
+  }
+  *Address = PciSegmentRead32 (LpcPciCfgBase () + GenMemReg) & B_LPC_CFG_LGMR_MA;
+  return EFI_SUCCESS;
+}
+
+/**
+  Get PCH LPC/eSPI memory range decoding address.
+
+  @param[out] Address                   Address of LPC/eSPI memory decoding base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
+**/
+EFI_STATUS
+PchLpcMemRangeGet (
+  OUT UINT32                            *Address
+  )
+{
+  return LpcEspiMemRangeGetHelper (SlaveLpcEspiCS0, Address);
+}
+
+/**
+  Get PCH eSPI CS1# memory range decoding address.
+
+  @param[out] Address                   Address of eSPI CS1# memory decoding base address.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
+  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
+**/
+EFI_STATUS
+PchEspiCs1MemRangeGet (
+  OUT UINT32                            *Address
+  )
+{
+  if (!IsEspiSecondSlaveSupported ()) {
+    return EFI_UNSUPPORTED;
+  }
+
+  return LpcEspiMemRangeGetHelper (SlaveEspiCS1, Address);
+}
+
+/**
+  Set PCH BIOS range deocding.
+  This will check General Control and Status bit 10 (GCS.BBS) to identify SPI or LPC/eSPI and program BDE register accordingly.
+  Please check EDS for detail of BiosDecodeEnable bit definition.
+    bit 15: F8-FF Enable
+    bit 14: F0-F8 Enable
+    bit 13: E8-EF Enable
+    bit 12: E0-E8 Enable
+    bit 11: D8-DF Enable
+    bit 10: D0-D7 Enable
+    bit  9: C8-CF Enable
+    bit  8: C0-C7 Enable
+    bit  7: Legacy F Segment Enable
+    bit  6: Legacy E Segment Enable
+    bit  5: Reserved
+    bit  4: Reserved
+    bit  3: 70-7F Enable
+    bit  2: 60-6F Enable
+    bit  1: 50-5F Enable
+    bit  0: 40-4F Enable
+  This cycle decoding is also required in DMI
+  Programming steps:
+  1. if GCS.BBS is 0 (SPI), program SPI offset D8h to BiosDecodeEnable.
+     if GCS.BBS is 1 (LPC/eSPi), program LPC offset D8h to BiosDecodeEnable.
+  2. program LPC BIOS Decode Enable in DMI
+
+  @param[in] BiosDecodeEnable           Bios decode enable setting.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchBiosDecodeEnableSet (
+  IN  UINT16                            BiosDecodeEnable
+  )
+{
+  UINT64                                BaseAddr;
+  EFI_STATUS                            Status;
+
+  Status = PchDmiSetBiosDecodeEnable (BiosDecodeEnable);
+  if (EFI_ERROR (Status)) {
+    ASSERT_EFI_ERROR (Status);
+    return Status;
+  }
+
+  //
+  // Check Boot BIOS Strap in DMI
+  //
+  if (PchDmiIsBootBiosStrapSetForSpi ()) {
+    BaseAddr = SpiPciCfgBase ();
+    //
+    // If SPI, Program SPI offset D8h to BiosDecodeEnable.
+    //
+    PciSegmentWrite16 (BaseAddr + R_SPI_CFG_BDE, BiosDecodeEnable);
+  } else {
+    BaseAddr = LpcPciCfgBase ();
+    //
+    // If LPC/eSPi, program LPC offset D8h to BiosDecodeEnable.
+    //
+    PciSegmentWrite16 (BaseAddr + R_LPC_CFG_BDE, BiosDecodeEnable);
+  }
+
+  return Status;
+}
+
+/**
+  Set PCH LPC/eSPI IO decode ranges.
+  Program LPC/eSPI I/O Decode Ranges in DMI to the same value programmed in LPC/eSPI PCI offset 80h.
+  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
+  Bit  12: FDD range
+  Bit 9:8: LPT range
+  Bit 6:4: ComB range
+  Bit 2:0: ComA range
+
+  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcIoDecodeRangesSet (
+  IN  UINT16                            LpcIoDecodeRanges
+  )
+{
+  UINT64                                LpcBaseAddr;
+  EFI_STATUS                            Status;
+
+  //
+  // Note: Inside this function, don't use debug print since it's could used before debug print ready.
+  //
+
+  LpcBaseAddr = LpcPciCfgBase ();
+
+  //
+  // check if setting is identical
+  //
+  if (LpcIoDecodeRanges == PciSegmentRead16 (LpcBaseAddr + R_LPC_CFG_IOD)) {
+    return EFI_SUCCESS;
+  }
+
+  Status = PchDmiSetLpcIoDecodeRanges (LpcIoDecodeRanges);
+  if (EFI_ERROR (Status)) {
+    ASSERT_EFI_ERROR (Status);
+    return Status;
+  }
+
+  //
+  // program LPC/eSPI PCI offset 80h.
+  //
+  PciSegmentWrite16 (LpcBaseAddr + R_LPC_CFG_IOD, LpcIoDecodeRanges);
+
+  return Status;
+}
+
+/**
+  Set PCH LPC/eSPI and eSPI CS1# IO enable decoding.
+  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset 82h (LPC, eSPI CS0#) or A0h (eSPI CS1#).
+  Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
+  in LPC/eSPI PCI offset 82h[13:10] or A0h[13:10] is always forwarded by DMI to subtractive agent for handling.
+  Please check EDS for detail of Lpc/eSPI IO decode ranges bit definition.
+
+  @param[in] IoEnableDecoding           LPC/eSPI IO enable decoding bit settings.
+  @param[in] SlaveId                    Slave ID (refer to SLAVE_ID_INDEX)
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMI configuration is locked
+**/
+EFI_STATUS
+LpcEspiIoEnableDecodingSetHelper (
+  IN  UINT16                            IoEnableDecoding,
+  IN  SLAVE_ID_INDEX                    SlaveId
+  )
+{
+  UINT64      LpcBaseAddr;
+  EFI_STATUS  Status;
+  UINT16      Cs1IoEnableDecodingOrg;
+  UINT16      Cs0IoEnableDecodingOrg;
+  UINT16      IoEnableDecodingMerged;
+
+  LpcBaseAddr = LpcPciCfgBase ();
+
+  Cs0IoEnableDecodingOrg = PciSegmentRead16 (LpcBaseAddr + R_LPC_CFG_IOE);
+
+  if (IsEspiSecondSlaveSupported ()) {
+    Cs1IoEnableDecodingOrg = PciSegmentRead16 (LpcBaseAddr + R_ESPI_CFG_CS1IORE);
+  } else {
+    Cs1IoEnableDecodingOrg = 0;
+  }
+
+  if (SlaveId == SlaveEspiCS1) {
+    if (IoEnableDecoding == Cs1IoEnableDecodingOrg) {
+      return EFI_SUCCESS;
+    } else {
+      IoEnableDecodingMerged = (Cs0IoEnableDecodingOrg | IoEnableDecoding);
+    }
+  } else {
+    if ((IoEnableDecoding | Cs1IoEnableDecodingOrg) == Cs0IoEnableDecodingOrg) {
+      return EFI_SUCCESS;
+    } else {
+      IoEnableDecodingMerged = (Cs1IoEnableDecodingOrg | IoEnableDecoding);
+    }
+  }
+
+  Status = PchDmiSetLpcIoEnable (IoEnableDecodingMerged);
+  if (EFI_ERROR (Status)) {
+    ASSERT_EFI_ERROR (Status);
+    return Status;
+  }
+
+  //
+  // program PCI offset 82h for LPC/eSPI.
+  //
+  PciSegmentWrite16 (LpcBaseAddr + R_LPC_CFG_IOE, IoEnableDecodingMerged);
+
+  if (SlaveId == SlaveEspiCS1) {
+    //
+    // For eSPI CS1# device program eSPI PCI offset A0h.
+    //
+    PciSegmentWrite16 (LpcBaseAddr + R_ESPI_CFG_CS1IORE, IoEnableDecoding);
+  }
+
+  return Status;
+}
+
+/**
+  Set PCH LPC and eSPI CS0# IO enable decoding.
+  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset 82h.
+  Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
+  in LPC/eSPI PCI offset 82h[13:10] is always forwarded by DMI to subtractive agent for handling.
+  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
+
+  @param[in] LpcIoEnableDecoding        LPC IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
+**/
+EFI_STATUS
+PchLpcIoEnableDecodingSet (
+  IN  UINT16                            LpcIoEnableDecoding
+  )
+{
+  return LpcEspiIoEnableDecodingSetHelper (LpcIoEnableDecoding, SlaveLpcEspiCS0);
+}
+
+/**
+  Set PCH eSPI CS1# IO enable decoding.
+  Setup I/O Enables in DMI to the same value program in eSPI PCI offset A0h (eSPI CS1#).
+  Note: Bit[15:10] of the source decode register is Read-Only. The IO range indicated by the Enables field
+  in eSPI PCI offset A0h[13:10] is always forwarded by DMI to subtractive agent for handling.
+  Please check EDS for detail of eSPI IO decode ranges bit definition.
+
+  @param[in] IoEnableDecoding           eSPI IO enable decoding bit settings.
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_UNSUPPORTED               DMI configuration is locked
+**/
+EFI_STATUS
+PchEspiCs1IoEnableDecodingSet (
+  IN  UINT16                            IoEnableDecoding
+  )
+{
+  if (!IsEspiSecondSlaveSupported ()) {
+    return EFI_UNSUPPORTED;
+  }
+
+  return LpcEspiIoEnableDecodingSetHelper (IoEnableDecoding, SlaveEspiCS1);
+}
+
+
+/**
+  Get IO APIC regsiters base address.
+
+  @param[out] IoApicBase                Buffer of IO APIC regsiter address
+
+  @retval EFI_SUCCESS                   Successfully completed.
+**/
+EFI_STATUS
+PchIoApicBaseGet (
+  OUT UINT32                            *IoApicBase
+  )
+{
+  *IoApicBase = PcdGet32 (PcdSiIoApicBaseAddress);
+  return EFI_SUCCESS;
+}
+
+/**
+  Get HPET base address.
+
+  @param[out] HpetBase                  Buffer of HPET base address
+
+  @retval EFI_SUCCESS                   Successfully completed.
+  @retval EFI_INVALID_PARAMETER         Invalid offset passed.
+**/
+EFI_STATUS
+PchHpetBaseGet (
+  OUT UINT32                            *HpetBase
+  )
+{
+  if (HpetBase == NULL) {
+    DEBUG ((DEBUG_ERROR, "PchHpetBaseGet Error. Invalid pointer.\n"));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  *HpetBase = PcdGet32 (PcdSiHpetBaseAddress);
+  return EFI_SUCCESS;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf
new file mode 100644
index 0000000000..ea6b434f29
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf
@@ -0,0 +1,42 @@
+## @file
+# PCH cycle decoding Lib.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchCycleDecodingLib
+FILE_GUID = 676C749F-9CD1-46B7-BAFD-4B1BC36B4C8E
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchCycleDecodingLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PciSegmentLib
+PchInfoLib
+PchPcrLib
+PchDmiLib
+EspiLib
+PchPciBdfLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+PchCycleDecodingLib.c
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiHpetBaseAddress        ## CONSUMES
+gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress      ## CONSUMES
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLib.c
new file mode 100644
index 0000000000..df8a23d5a3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLib.c
@@ -0,0 +1,127 @@
+/** @file
+  Pch information library.
+
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PrintLib.h>
+#include <Library/PcdLib.h>
+#include "PchInfoLibPrivate.h"
+#include <Register/PchRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <PchPcieRpInfo.h>
+#include <IndustryStandard/Pci30.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Return Pch Series
+
+  @retval PCH_SERIES            Pch Series
+**/
+PCH_SERIES
+PchSeries (
+  VOID
+  )
+{
+  return PCH_LP;
+}
+
+/**
+  Return Pch stepping type
+
+  @retval PCH_STEPPING            Pch stepping type
+**/
+PCH_STEPPING
+PchStepping (
+  VOID
+  )
+{
+  return 0;
+}
+
+/**
+  Check if this is TGL PCH generation
+
+  @retval TRUE                It's TGL PCH
+  @retval FALSE               It's not TGL PCH
+**/
+BOOLEAN
+IsTglPch (
+  VOID
+  )
+{
+  return (PchGeneration () == TGL_PCH);
+}
+
+/**
+  Get PCH stepping ASCII string.
+  Function determines major and minor stepping versions and writes them into a buffer.
+  The return string is zero terminated
+
+  @param [out]     Buffer               Output buffer of string
+  @param [in]      BufferSize           Buffer size.
+                                        Must not be less then PCH_STEPPING_STR_LENGTH_MAX
+
+  @retval EFI_SUCCESS                   String copied successfully
+  @retval EFI_INVALID_PARAMETER         The stepping is not supported, or parameters are NULL
+  @retval EFI_BUFFER_TOO_SMALL          Input buffer size is too small
+**/
+EFI_STATUS
+PchGetSteppingStr (
+  OUT    CHAR8                          *Buffer,
+  IN     UINT32                         BufferSize
+  )
+{
+  PCH_STEPPING PchStep;
+
+  PchStep = PchStepping ();
+
+  if ((Buffer == NULL) || (BufferSize == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+  if (BufferSize < PCH_STEPPING_STR_LENGTH_MAX) {
+    return EFI_BUFFER_TOO_SMALL;
+  }
+
+  PchPrintSteppingStr (Buffer, BufferSize, PchStep);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Get Pch Maximum Pcie Controller Number
+
+  @retval Pch Maximum Pcie Root Port Number
+**/
+UINT8
+GetPchMaxPcieControllerNum (
+  VOID
+  )
+{
+  return GetPchMaxPciePortNum () / PCH_PCIE_CONTROLLER_PORTS;
+}
+
+/**
+  return support status for P2SB PCR 20-bit addressing
+
+  @retval    TRUE
+  @retval    FALSE
+**/
+BOOLEAN
+IsP2sb20bPcrSupported (
+  VOID
+  )
+{
+  return FALSE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibPrivate.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibPrivate.h
new file mode 100644
index 0000000000..a93c3dbafd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibPrivate.h
@@ -0,0 +1,58 @@
+/** @file
+  Private header for PCH Info Lib.
+
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+/**
+  Structure for PCH SKU string mapping
+**/
+struct PCH_SKU_STRING {
+  UINT16        Id;
+  CHAR8         *String;
+};
+
+/**
+  Determine Pch Series based on Device Id
+
+  @param[in] LpcDeviceId      Lpc Device Id
+
+  @retval PCH_SERIES          Pch Series
+**/
+PCH_SERIES
+PchSeriesFromLpcDid (
+  IN UINT16 LpcDeviceId
+  );
+
+/**
+Determine Pch Generation based on Device Id
+
+@param[in] LpcDeviceId            Lpc Device Id
+
+@retval PCH_GENERATION            Pch Generation
+**/
+PCH_GENERATION
+PchGenerationFromDid (
+  IN UINT16 LpcDeviceId
+  );
+
+/**
+  Print Pch Stepping String
+
+  @param[out] Buffer         Output buffer of string
+  @param[in]  BufferSize     Buffer Size
+  @param[in]  PchStep        Pch Stepping Type
+
+  @retval VOID
+**/
+VOID
+PchPrintSteppingStr (
+  OUT CHAR8        *Buffer,
+  IN  UINT32       BufferSize,
+  IN  PCH_STEPPING PchStep
+  );
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibTgl.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibTgl.c
new file mode 100644
index 0000000000..bb3c7975e8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfoLibTgl.c
@@ -0,0 +1,715 @@
+/** @file
+  Pch information library for TGL.
+
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/PchInfoLib.h>
+#include "PchInfoLibPrivate.h"
+#include <Library/PrintLib.h>
+#include <Register/PchRegsLpc.h>
+
+/**
+  Print Pch Stepping String
+
+  @param[out] Buffer         Output buffer of string
+  @param[in]  BufferSize     Buffer Size
+  @param[in]  PchStep        Pch Stepping Type
+
+  @retval VOID
+**/
+VOID
+PchPrintSteppingStr (
+  OUT CHAR8        *Buffer,
+  IN  UINT32       BufferSize,
+  IN  PCH_STEPPING PchStep
+  )
+{
+  AsciiSPrint (Buffer, BufferSize, "%c%c", 'A' + (PchStep >> 4), '0' + (PchStep & 0xF));
+}
+
+/**
+  Return Pch Generation
+
+  @retval PCH_GENERATION      Pch Generation
+**/
+PCH_GENERATION
+PchGeneration (
+  VOID
+  )
+{
+  return TGL_PCH;
+}
+
+
+/**
+  Get PCH series ASCII string.
+
+  @retval PCH Series string
+**/
+CHAR8*
+PchGetSeriesStr (
+  VOID
+  )
+{
+  switch (PchSeries ()) {
+
+    case PCH_LP:
+      return "TGL PCH-LP";
+
+    default:
+      return NULL;
+  }
+}
+
+/**
+  Get Pch Maximum Pcie Clock Number
+
+  @retval Pch Maximum Pcie Clock Number
+**/
+UINT8
+GetPchMaxPcieClockNum (
+  VOID
+  )
+{
+  return 7;
+}
+
+/**
+  Get Pch Maximum Pcie ClockReq Number
+
+  @retval Pch Maximum Pcie ClockReq Number
+**/
+UINT8
+GetPchMaxPcieClockReqNum (
+  VOID
+  )
+{
+  return GetPchMaxPcieClockNum ();
+}
+
+/**
+  Get Pch Maximum Type C Port Number
+
+  @retval Pch Maximum Type C Port Number
+**/
+UINT8
+GetPchMaxTypeCPortNum (
+  VOID
+  )
+{
+  switch (PchSeries ()) {
+    case PCH_LP:
+      return 4;
+    default:
+      return 0;
+  }
+}
+
+/**
+  Check whether integrated LAN controller is supported by PCH Series.
+
+  @retval TRUE                    GbE is supported in current PCH
+  @retval FALSE                   GbE is not supported on current PCH
+**/
+BOOLEAN
+PchIsGbeSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Check whether integrated TSN is supported by PCH Series.
+
+  @retval TRUE                    TSN is supported in current PCH
+  @retval FALSE                   TSN is not supported on current PCH
+**/
+BOOLEAN
+PchIsTsnSupported (
+  VOID
+  )
+{
+#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
+  return TRUE;
+#else
+  return FALSE;
+#endif
+}
+
+/**
+  Check whether ISH is supported by PCH Series.
+
+  @retval TRUE                    ISH is supported in current PCH
+  @retval FALSE                   ISH is not supported on current PCH
+**/
+BOOLEAN
+PchIsIshSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Get Pch Maximum Pcie Root Port Number
+
+  @retval Pch Maximum Pcie Root Port Number
+**/
+UINT8
+GetPchMaxPciePortNum (
+  VOID
+  )
+{
+  switch (PchSeries ()) {
+    case PCH_LP:
+      return 12;
+    default:
+      return 0;
+  }
+}
+
+/**
+  Get Pch Maximum Hda Dmic Link
+
+  @retval Pch Maximum Hda Dmic Link
+**/
+UINT8
+GetPchHdaMaxDmicLinkNum (
+  VOID
+  )
+{
+  return 2;
+}
+
+/**
+  Get Pch Maximum Hda Sndw Link
+
+  @retval Pch Maximum Hda Sndw Link
+**/
+UINT8
+GetPchHdaMaxSndwLinkNum (
+  VOID
+  )
+{
+  return 4;
+}
+
+/**
+  Get Pch Maximum Hda Ssp Link
+
+  @retval Pch Maximum Hda Ssp Link
+**/
+UINT8
+GetPchHdaMaxSspLinkNum (
+  VOID
+  )
+{
+  return 3;
+}
+
+/**
+  Check if given Audio Interface is supported
+
+  @param[in] AudioLinkType   Link type support to be checked
+  @param[in] AudioLinkIndex  Link number
+
+  @retval    TRUE           Link supported
+  @retval    FALSE          Link not supported
+**/
+BOOLEAN
+IsAudioInterfaceSupported (
+  IN HDAUDIO_LINK_TYPE     AudioLinkType,
+  IN UINT32                AudioLinkIndex
+  )
+{
+  //
+  // Interfaces supported:
+  // 1. HDA Link (SDI0/SDI1)
+  // 2. Display Audio Link (SDI2)
+  // 3. SSP[0-5]
+  // 4. SNDW[1-4]
+  //
+  switch (AudioLinkType) {
+    case HdaLink:
+    case HdaIDispLink:
+      return TRUE;
+    case HdaDmic:
+      if (AudioLinkIndex < 2) {
+        return TRUE;
+      } else {
+        return FALSE;
+      }
+    case HdaSsp:
+      if (AudioLinkIndex < 6) {
+        return TRUE;
+      } else {
+        return FALSE;
+      }
+    case HdaSndw:
+      if (AudioLinkIndex < 1) {
+        return TRUE;
+      } else if (AudioLinkIndex < 4) {
+        return TRUE;
+      } else {
+        return FALSE;
+      }
+    default:
+      return FALSE;
+  }
+}
+
+/**
+  Check if given Display Audio Link T-Mode is supported
+
+  @param[in] Tmode          T-mode support to be checked
+
+  @retval    TRUE           T-mode supported
+  @retval    FALSE          T-mode not supported
+**/
+BOOLEAN
+IsAudioIDispTmodeSupported (
+  IN HDAUDIO_IDISP_TMODE Tmode
+  )
+{
+  //
+  // iDisplay Audio Link T-mode support per PCH Generation/Series:
+  // 1. 2T  - TGL-LP/H/N
+  // 2. 4T  - TGL-LP (default), TGL-H, TGL-N
+  // 3. 8T  - TGL-H, TGL-N (default)
+  // 4. 16T - TGL-H, TGL-N (not-POR)
+  //
+  switch (Tmode) {
+    case HdaIDispMode1T:
+      return FALSE;
+    case HdaIDispMode2T:
+    case HdaIDispMode4T:
+    case HdaIDispMode8T:
+      return TRUE;
+    case HdaIDispMode16T:
+      return FALSE;
+    default:
+      return FALSE;
+  }
+}
+
+/**
+Get Pch Usb2 Maximum Physical Port Number
+
+@retval Pch Usb2 Maximum Physical Port Number
+**/
+UINT8
+GetPchUsb2MaxPhysicalPortNum(
+  VOID
+  )
+{
+  switch (PchSeries()) {
+    case PCH_LP:
+      return 10;
+    default:
+      return 0;
+  }
+}
+
+/**
+Get Pch Maximum Usb2 Port Number of XHCI Controller
+
+@retval Pch Maximum Usb2 Port Number of XHCI Controller
+**/
+UINT8
+GetPchXhciMaxUsb2PortNum(
+  VOID
+  )
+{
+  switch (PchSeries()) {
+    case PCH_LP:
+      return 12;
+    default:
+      return 0;
+  }
+}
+
+/**
+Get Pch Maximum Usb3 Port Number of XHCI Controller
+
+@retval Pch Maximum Usb3 Port Number of XHCI Controller
+**/
+UINT8
+GetPchXhciMaxUsb3PortNum(
+  VOID
+  )
+{
+  switch (PchSeries()) {
+    case PCH_LP:
+      return 4;
+    default:
+      return 0;
+  }
+}
+
+/**
+  Gets the maximum number of UFS controller supported by this chipset.
+
+  @return Number of supported UFS controllers
+**/
+UINT8
+PchGetMaxUfsNum (
+  VOID
+  )
+{
+  return 2;
+}
+
+/**
+  Check if this chipset supports eMMC controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchEmmcSupported (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Check if this chipset supports SD controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchSdCardSupported (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Check if this chipset supports THC controller
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchThcSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Check if this chipset supports HSIO BIOS Sync
+
+  @retval BOOLEAN  TRUE if supported, FALSE otherwise
+**/
+BOOLEAN
+IsPchChipsetInitSyncSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Check if link between PCH and CPU is an P-DMI
+
+  @retval    TRUE           P-DMI link
+  @retval    FALSE          Not an P-DMI link
+**/
+BOOLEAN
+IsPchWithPdmi (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Check whether ATX Shutdown (PS_ON) is supported.
+
+  @retval    TRUE           ATX Shutdown (PS_ON) is supported in PCH
+  @retval    FALSE          ATX Shutdown (PS_ON) is not supported by PCH
+**/
+BOOLEAN
+IsPchPSOnSupported (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Check if link between PCH and CPU is an OP-DMI
+
+  @retval    TRUE           OP-DMI link
+  @retval    FALSE          Not an OP-DMI link
+**/
+BOOLEAN
+IsPchWithOpdmi (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Check if link between PCH and CPU is an F-DMI
+
+  @retval    TRUE           F-DMI link
+  @retval    FALSE          Not an F-DMI link
+**/
+BOOLEAN
+IsPchWithFdmi (
+  VOID
+  )
+{
+  return FALSE;
+}
+/**
+  Get Pch Maximum ISH UART Controller number
+
+  @retval Pch Maximum ISH UART controllers number
+**/
+UINT8
+GetPchMaxIshUartControllersNum (
+  VOID
+  )
+{
+  return 2;
+}
+
+/**
+  Get Pch Maximum ISH I2C Controller number
+
+  @retval Pch Maximum ISH I2C controllers number
+**/
+UINT8
+GetPchMaxIshI2cControllersNum (
+  VOID
+  )
+{
+  return 3;
+}
+
+/**
+  Get Pch Maximum ISH I3C Controller number
+
+  @retval Pch Maximum ISH I3C controllers number
+**/
+UINT8
+GetPchMaxIshI3cControllersNum (
+  VOID
+  )
+{
+  return 0;
+}
+
+/**
+  Get Pch Maximum ISH SPI Controller number
+
+  @retval Pch Maximum ISH SPI controllers number
+**/
+UINT8
+GetPchMaxIshSpiControllersNum (
+  VOID
+  )
+{
+  return 1;
+}
+
+/**
+  Get Pch Maximum ISH SPI Controller Cs pins number
+
+  @retval Pch Maximum ISH SPI controller Cs pins number
+**/
+UINT8
+GetPchMaxIshSpiControllerCsPinsNum (
+  VOID
+  )
+{
+  return 1;
+}
+
+/**
+  Get Pch Maximum ISH GP number
+
+  @retval Pch Maximum ISH GP number
+**/
+UINT8
+GetPchMaxIshGpNum (
+  VOID
+  )
+{
+  return 8;
+}
+
+/**
+  Get Pch Maximum Serial IO I2C controllers number
+
+  @retval Pch Maximum Serial IO I2C controllers number
+**/
+UINT8
+GetPchMaxSerialIoI2cControllersNum (
+  VOID
+  )
+{
+  return 6;
+}
+
+/**
+  Get Pch Maximum Serial IO SPI controllers number
+
+  @retval Pch Maximum Serial IO SPI controllers number
+**/
+UINT8
+GetPchMaxSerialIoSpiControllersNum (
+  VOID
+  )
+{
+  return 4;
+}
+
+/**
+  Get Pch Maximum Serial IO UART controllers number
+
+  @retval Pch Maximum Serial IO UART controllers number
+**/
+UINT8
+GetPchMaxSerialIoUartControllersNum (
+  VOID
+  )
+{
+  return 4;
+}
+
+/**
+  Get Pch Maximum Serial IO SPI Chip Selects count
+
+  @retval Pch Maximum Serial IO SPI Chip Selects number
+**/
+UINT8
+GetPchMaxSerialIoSpiChipSelectsNum (
+  VOID
+  )
+{
+  return 2;
+}
+
+/**
+  Get Pch Maximum ME Applet count
+
+  @retval Pch Maximum ME Applet number
+**/
+UINT8
+GetPchMaxMeAppletCount (
+  VOID
+  )
+{
+  return 31;
+}
+
+/**
+  Get Pch Maximum ME Session count
+
+  @retval Pch Maximum ME Sesion number
+**/
+UINT8
+GetPchMaxMeSessionCount (
+  VOID
+  )
+{
+  return 16;
+}
+
+/**
+  Get Pch Maximum THC count
+
+  @retval Pch Maximum THC count number
+**/
+UINT8
+GetPchMaxThcCount (
+  VOID
+  )
+{
+  return 2;
+}
+
+/**
+  Returns a frequency of the sosc_clk signal.
+  All SATA controllers on the system are assumed to
+  work on the same sosc_clk frequency.
+
+  @retval Frequency of the sosc_clk signal.
+**/
+SATA_SOSC_CLK_FREQ
+GetSataSoscClkFreq (
+  VOID
+  )
+{
+  return SataSosc100Mhz;
+}
+
+/**
+  Check if SATA support should be awake after function disable
+
+  @retval    TRUE
+  @retval    FALSE
+**/
+BOOLEAN
+IsSataSupportWakeAfterFunctionDisable (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Returns USB2 PHY Reference Clock frequency value used by PCH
+  This defines what electrical tuning parameters shall be used
+  during USB2 PHY initialization programming
+
+  @retval Frequency reference clock for USB2 PHY
+**/
+USB2_PHY_REF_FREQ
+GetUsb2PhyRefFreq (
+  VOID
+  )
+{
+  return FREQ_19_2;
+}
+
+/**
+  Check if SPI in a given PCH generation supports an Extended BIOS Range Decode
+
+  @retval TRUE or FALSE if PCH supports Extended BIOS Range Decode
+**/
+BOOLEAN
+IsExtendedBiosRangeDecodeSupported (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+#define SPI_PCH_LP_DMI_TARGET   0x23A8
+
+/**
+  Returns DMI target for current PCH SPI
+
+  @retval PCH SPI DMI target value
+**/
+UINT16
+GetPchSpiDmiTarget (
+  VOID
+  )
+{
+  return SPI_PCH_LP_DMI_TARGET;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeSmmPchInfoLibTgl.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeSmmPchInfoLibTgl.inf
new file mode 100644
index 0000000000..4b3fb988d2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeSmmPchInfoLibTgl.inf
@@ -0,0 +1,43 @@
+## @file
+# PCH information library for TigerLake PCH.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmPchInfoLibTgl
+FILE_GUID = 253B9BFC-026F-4BB4-AC2C-AC167BC0F43C
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = PchInfoLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+PrintLib
+PciSegmentLib
+PchPcrLib
+PcdLib
+PchPciBdfLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+PchInfoLib.c
+PchInfoLibTgl.c
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdEmbeddedEnable                        ## CONSUMES
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private library instances
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (30 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and " Heng Luo
                   ` (7 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * Pch/LibraryPrivate/BaseSiScheduleResetLib
  * Pch/LibraryPrivate/SmmPchPrivateLib

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.c   | 171 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.inf |  37 +++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.c               |  57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.inf             |  31 +++++++++++++++++++++++++++++++
 4 files changed, 296 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.c
new file mode 100644
index 0000000000..1880244a01
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.c
@@ -0,0 +1,171 @@
+/** @file
+  Reset scheduling library services
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DebugLib.h>
+#include <Library/ResetSystemLib.h>
+#include <Uefi/UefiBaseType.h>
+#include <Uefi.h>
+#include <Pi/PiMultiPhase.h>
+#include <Library/HobLib.h>
+#include <PchResetPlatformSpecific.h>
+#include <Library/SiScheduleResetLib.h>
+#include <SiScheduleResetHob.h>
+
+/**
+  This function returns SiScheduleResetHob for library use
+**/
+STATIC
+SI_SCHEDULE_RESET_HOB *
+SiScheduleGetResetData (
+  VOID
+  )
+{
+  STATIC SI_SCHEDULE_RESET_HOB *SiScheduleResetHob = NULL;
+  SI_SCHEDULE_RESET_HOB        *SiScheduleResetHobTemp;
+  VOID                         *HobPtr;
+
+  if (SiScheduleResetHob != NULL) {
+    return SiScheduleResetHob;
+  }
+
+  HobPtr = GetFirstGuidHob (&gSiScheduleResetHobGuid);
+  if (HobPtr == NULL) {
+    SiScheduleResetHobTemp = BuildGuidHob (&gSiScheduleResetHobGuid, sizeof (SI_SCHEDULE_RESET_HOB));
+    if (SiScheduleResetHobTemp == NULL) {
+      ASSERT (FALSE);
+      return SiScheduleResetHobTemp;
+    }
+    SiScheduleResetHobTemp->ResetType = 0xFF;
+    DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : Init SiScheduleResetHob\n"));
+  } else {
+    SiScheduleResetHobTemp = (SI_SCHEDULE_RESET_HOB*) GET_GUID_HOB_DATA (HobPtr);
+  }
+  SiScheduleResetHob = SiScheduleResetHobTemp;
+  return SiScheduleResetHobTemp;
+}
+
+/**
+  This function updates the reset information in SiScheduleResetHob
+  @param[in] ResetType        UEFI defined reset type.
+  @param[in] ResetData        Optional element used to introduce a platform specific reset.
+                               The exact type of the reset is defined by the EFI_GUID that follows
+                               the Null-terminated Unicode string.
+**/
+VOID
+SiScheduleResetSetType (
+  IN EFI_RESET_TYPE     ResetType,
+  IN PCH_RESET_DATA     *ResetData OPTIONAL
+  )
+{
+  SI_SCHEDULE_RESET_HOB *SiScheduleResetHob;
+  if (ResetType > EfiResetPlatformSpecific) {
+    DEBUG ((DEBUG_INFO, "Unsupported Reset Type Requested\n"));
+    return;
+  }
+  SiScheduleResetHob = SiScheduleGetResetData ();
+  if (SiScheduleResetHob == NULL) {
+    return;
+  }
+  DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : Current Reset Type = 0x%x\n", SiScheduleResetHob->ResetType));
+  if (SiScheduleResetHob->ResetType == ResetType) {
+    DEBUG ((DEBUG_INFO, "Current Reset Type is same as requested Reset Type\n"));
+    return;
+  }
+  if (SiScheduleResetHob->ResetType == 0xFF) {
+    // Init Reset Type to lowest ResetType
+    SiScheduleResetHob->ResetType = EfiResetWarm;
+  }
+  //
+  // ResetType Priority set as : ResetPlatformSpecific(3) > ResetShutdown(2) > ResetCold(0) > ResetWarm(1)
+  //
+  switch (ResetType) {
+    case EfiResetWarm:
+      break;
+
+    case EfiResetCold:
+      if (SiScheduleResetHob->ResetType == EfiResetWarm) {
+        SiScheduleResetHob->ResetType = ResetType;
+      }
+      break;
+
+    case EfiResetShutdown:
+      if (SiScheduleResetHob->ResetType < ResetType)
+      SiScheduleResetHob->ResetType = ResetType;
+      break;
+
+    case EfiResetPlatformSpecific:
+      SiScheduleResetHob->ResetType = ResetType;
+      SiScheduleResetHob->ResetData = *ResetData;
+      break;
+  }
+  DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : New Reset Type = 0x%x\n", SiScheduleResetHob->ResetType));
+}
+
+/**
+  This function returns TRUE or FALSE depending on whether a reset is required based on SiScheduleResetHob
+
+  @retval     BOOLEAN       The function returns FALSE if no reset is required
+**/
+BOOLEAN
+SiScheduleResetIsRequired (
+  VOID
+  )
+{
+  VOID                  *HobPtr;
+
+  HobPtr = NULL;
+  HobPtr = GetFirstGuidHob (&gSiScheduleResetHobGuid);
+  if (HobPtr == NULL) {
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  This function performs reset based on SiScheduleResetHob
+
+  @retval     BOOLEAN       The function returns FALSE if no reset is required
+**/
+BOOLEAN
+SiScheduleResetPerformReset (
+  VOID
+  )
+{
+  UINTN                 DataSize;
+  SI_SCHEDULE_RESET_HOB *SiScheduleResetHob;
+
+  if (!SiScheduleResetIsRequired ()) {
+    return FALSE;
+  }
+  SiScheduleResetHob = SiScheduleGetResetData ();
+
+  if (SiScheduleResetHob == NULL) {
+    return TRUE;
+  }
+
+  DEBUG ((DEBUG_INFO, "SiScheduleResetPerformReset : Reset Type = 0x%x\n", SiScheduleResetHob->ResetType));
+  switch (SiScheduleResetHob->ResetType) {
+  case EfiResetWarm:
+    ResetWarm ();
+    break;
+
+  case EfiResetCold:
+    ResetCold ();
+    break;
+
+  case EfiResetShutdown:
+    ResetShutdown ();
+    break;
+
+  case EfiResetPlatformSpecific:
+    DataSize = sizeof (PCH_RESET_DATA);
+    ResetPlatformSpecific (DataSize, &SiScheduleResetHob->ResetData);
+    break;
+  }
+  // Code should never reach here
+  ASSERT (FALSE);
+  return TRUE;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.inf
new file mode 100644
index 0000000000..4363a752a9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.inf
@@ -0,0 +1,37 @@
+## @file
+# Component description file for Si Reset Schedule Library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = BaseSiScheduleResetLib
+FILE_GUID = E6F3D551-36C0-4737-80C7-47FC57593163
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = SiScheduleResetLib
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 IPF
+#
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+HobLib
+ResetSystemLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Guids]
+gSiScheduleResetHobGuid
+
+[Sources]
+BaseSiScheduleResetLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.c
new file mode 100644
index 0000000000..46cf735860
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.c
@@ -0,0 +1,57 @@
+/** @file
+  PCH SMM private lib.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Uefi/UefiBaseType.h>
+#include <Library/BaseLib.h>
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Register/CommonMsr.h>
+
+/**
+  Set InSmm.Sts bit
+**/
+VOID
+PchSetInSmmSts (
+  VOID
+  )
+{
+  UINT32      Data32;
+
+
+  ///
+  /// Read memory location FED30880h OR with 00000001h, place the result in EAX,
+  /// and write data to lower 32 bits of MSR 1FEh (sample code available)
+  ///
+  Data32 = MmioRead32 (0xFED30880);
+  AsmWriteMsr32 (MSR_SPCL_CHIPSET_USAGE, Data32 | BIT0);
+  ///
+  /// Read FED30880h back to ensure the setting went through.
+  ///
+  Data32 = MmioRead32 (0xFED30880);
+}
+
+/**
+  Clear InSmm.Sts bit
+**/
+VOID
+PchClearInSmmSts (
+  VOID
+  )
+{
+  UINT32      Data32;
+
+  ///
+  /// Read memory location FED30880h AND with FFFFFFFEh, place the result in EAX,
+  /// and write data to lower 32 bits of MSR 1FEh (sample code available)
+  ///
+  Data32 = MmioRead32 (0xFED30880);
+  AsmWriteMsr32 (MSR_SPCL_CHIPSET_USAGE, Data32 & (UINT32) (~BIT0));
+  ///
+  /// Read FED30880h back to ensure the setting went through.
+  ///
+  Data32 = MmioRead32 (0xFED30880);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.inf
new file mode 100644
index 0000000000..6d4c3a5729
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.inf
@@ -0,0 +1,31 @@
+## @file
+#  PCH SMM private lib.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = SmmPchPrivateLib
+FILE_GUID = FE6495FB-7AA9-4A24-BF3E-4698F7BCE0EE
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_SMM_DRIVER
+LIBRARY_CLASS = SmmPchPrivateLib
+
+
+[LibraryClasses]
+BaseLib
+IoLib
+DebugLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+SmmPchPrivateLib.c
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and library instances
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (31 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd " Heng Luo
                   ` (6 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * SystemAgent/AcpiTables
  * SystemAgent/Library/DxeSaPolicyLib
  * SystemAgent/Library/PeiDxeSmmSaPlatformLib

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp.asl                           |  252 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRpCommon.asl                     |  289 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCommon.asl                           | 1344 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3.asl                             |  124 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl                                  |   26 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.asl                              |   20 ++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf                              |   22 +++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.c                   |  264 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.inf                 |   48 ++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLibrary.h               |   34 +++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/PeiDxeSmmSaPlatformLib.inf |   32 ++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.c        |   68 +++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.h        |   21 ++++++++++++++
 13 files changed, 2544 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp.asl
new file mode 100644
index 0000000000..0babf047ed
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp.asl
@@ -0,0 +1,252 @@
+/** @file
+  This file contains the CPU PCIe Root Port configuration
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+External(LTRX) // CPU PCIe Root Port 0 Latency Tolerance Reporting Enable
+External(LTRY) // CPU PCIe Root Port 1 Latency Tolerance Reporting Enable
+External(LTRZ) // CPU PCIe Root Port 2 Latency Tolerance Reporting Enable
+External(LTRW) // CPU PCIe Root Port 3 Latency Tolerance Reporting Enable
+External(SMSL) // CPU PCIe Root Port Latency Tolerance Reporting Max Snoop Latency
+External(SNSL) // CPU PCIe Root Port Latency Tolerance Reporting Max No Snoop Latency
+External(PG0E) // CpuPcieRp0Enable <b>0: Disable</b>; 1: Enable
+External(PG1E) // CpuPcieRp1Enable <b>0: Disable</b>; 1: Enable
+External(PG2E) // CpuPcieRp2Enable <b>0: Disable</b>; 1: Enable
+External(PG3E) // CpuPcieRp3Enable <b>0: Disable</b>; 1: Enable
+External(\_SB.PC00.PEG0, DeviceObj)
+External(\_SB.PC00.PEG1, DeviceObj)
+External(\_SB.PC00.PEG2, DeviceObj)
+External(\_SB.PC00.PEG3, DeviceObj)
+External(\_SB.PC00.PEG0.PEGP, DeviceObj)
+External(\_SB.PC00.PEG1.PEGP, DeviceObj)
+External(\_SB.PC00.PEG2.PEGP, DeviceObj)
+External(\_SB.PC00.PEG3.PEGP, DeviceObj)
+External(\AR02)
+External(\PD02)
+External(\AR0A)
+External(\PD0A)
+External(\AR0B)
+External(\PD0B)
+External(\AR0C)
+External(\PD0C)
+External(VMDE)
+External(VMCP)
+External(MPGN)
+External(PBR1)
+External(PBR2)
+External(PBR3)
+
+Scope (\_SB.PC00.PEG0) {
+
+  Name(SLOT, 0) // CPU PCIe root port index 0 corresponds to PEG60 (0/6/0)
+
+  Method (_STA, 0x0, NotSerialized) {
+    if(PG0E == 1) { // If CPU PCIe RP0 enabled?
+      Return(0x0F)
+    }
+    Return(0x00)
+  }
+
+  Name(LTEN, 0)
+  Name(LMSL, 0)
+  Name(LNSL, 0)
+
+  Method(_INI)
+  {
+    Store (LTRX, LTEN)
+    Store (SMSL, LMSL)
+    Store (SNSL, LNSL)
+    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
+      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x8),0))) {
+        Store (1, CPMV)
+      }
+    }
+  }
+
+  Method(_PRT,0) {
+    If(PICM) {
+      Return(AR02)
+    } // APIC mode
+    Return (PD02) // PIC Mode
+  } // end _PRT
+
+  Include("CpuPcieRpCommon.asl")
+} // PEG0 scope end
+
+Scope (\_SB.PC00.PEG1) {
+
+  Name(SLOT, 1) // CPU PCIe root port index 1 corresponds to PEG10 (0/1/0)
+
+  Method (_STA, 0x0, NotSerialized) {
+    if(PG1E == 1) { // If CPU PCIe RP1 enabled?
+      Return(0x0F)
+    }
+    Return(0x00)
+  }
+
+  Name(LTEN, 0)
+  Name(LMSL, 0)
+  Name(LNSL, 0)
+
+  Method(_INI)
+  {
+    Store (LTRY, LTEN)
+    Store (SMSL, LMSL)
+    Store (SNSL, LNSL)
+    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
+      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x1),0))) {
+        Store (1, CPMV)
+      }
+    }
+  }
+
+  Method(_PRT,0) {
+    If(PICM) {
+      Return(AR0A)
+    } // APIC mode
+    Return (PD0A) // PIC Mode
+  } // end _PRT
+
+  Include("CpuPcieRpCommon.asl")
+} // PEG1 scope end
+
+Scope (\_SB.PC00.PEG2) {
+
+  Name(SLOT, 2) // CPU PCIe root port index 2 corresponds to PEG11 (0/1/1)
+
+  Method (_STA, 0x0, NotSerialized) {
+    if(PG2E == 1) { // If CPU PCIe RP2 enabled?
+      Return(0x0F)
+    }
+    Return(0x00)
+  }
+
+  Name(LTEN, 0)
+  Name(LMSL, 0)
+  Name(LNSL, 0)
+
+  Method(_INI)
+  {
+    Store (LTRZ, LTEN)
+    Store (SMSL, LMSL)
+    Store (SNSL, LNSL)
+    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
+      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x2),0))) {
+        Store (1, CPMV)
+      }
+    }
+  }
+
+  Method(_PRT,0) {
+    If(PICM) {
+      Return(AR0B)
+    } // APIC mode
+    Return (PD0B) // PIC Mode
+  } // end _PRT
+
+  Include("CpuPcieRpCommon.asl")
+} // PEG2 scope end
+
+If (CondRefOf(\_SB.PC00.PEG3)) {
+  Scope (\_SB.PC00.PEG3) {
+
+    Name(SLOT, 3) // CPU PCIe root port index 3 corresponds to PEG12 (0/1/2)
+
+    Method (_STA, 0x0, NotSerialized) {
+      if(PG3E == 1) { // If CPU PCIe RP3 enabled?
+        Return(0x0F)
+      }
+      Return(0x00)
+    }
+
+    Name(LTEN, 0)
+    Name(LMSL, 0)
+    Name(LNSL, 0)
+
+    Method(_INI)
+    {
+      Store (LTRW, LTEN)
+      Store (SMSL, LMSL)
+      Store (SNSL, LNSL)
+      If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
+        If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x4),0))) {
+          Store (1, CPMV)
+        }
+      }
+    }
+
+    Method(_PRT,0) {
+      If(PICM) {
+        Return(AR0C)
+      } // APIC mode
+      Return (PD0C) // PIC Mode
+    } // end _PRT
+
+    Include("CpuPcieRpCommon.asl")
+  } // PEG3 scope end
+}
+
+Scope(\_SB.PC00.PEG0.PEGP) {
+  Method(_PRW, 0) {
+    Return(GPRW(0x69, 4)) // can wakeup from S4 state
+  }
+}
+
+
+If (PBR1) {
+  Scope(\_SB.PC00.PEG1.PEGP) {
+    Method(_S0W, 0) { Return(4)} //D3cold is supported
+
+    Device (PEGD) {
+      Method(_S0W, 0) { Return(4)} //D3cold is supported
+      Name(_ADR, 0x00000000)
+      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4 state
+    }
+  } // end "P.E.G. Port Slot x16"
+}
+
+Scope(\_SB.PC00.PEG1.PEGP) {
+  Method(_PRW, 0) {
+    Return(GPRW(0x69, 4)) // can wakeup from S4 state
+  }
+}
+
+
+If (PBR2) {
+  Scope(\_SB.PC00.PEG2.PEGP) {
+    Method(_S0W, 0) { Return(4)} //D3cold is supported
+
+    Device (PEGD) {
+      Method(_S0W, 0) { Return(4)} //D3cold is supported
+      Name(_ADR, 0x00000000)
+      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4 state
+    }
+  } // end "P.E.G. Port Slot 2x8"
+}
+
+Scope(\_SB.PC00.PEG2.PEGP) {
+  Method(_PRW, 0) {
+    Return(GPRW(0x69, 4)) // can wakeup from S4 state
+  }
+}
+
+If (PBR3) {
+  Scope(\_SB.PC00.PEG3.PEGP) {
+    Method(_S0W, 0) { Return(4)} //D3cold is supported
+
+    Device (PEGD) {
+      Method(_S0W, 0) { Return(4)} //D3cold is supported
+      Name(_ADR, 0x00000000)
+      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4 state
+    }
+  } // end "P.E.G. Port Slot 1x8 - 2x4"
+}
+
+If (CondRefOf(\_SB.PC00.PEG3)) {
+  Scope(\_SB.PC00.PEG3.PEGP) {
+    Method(_PRW, 0) {
+      Return(GPRW(0x69, 4)) // can wakeup from S4 state
+    }
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRpCommon.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRpCommon.asl
new file mode 100644
index 0000000000..81f785dfc5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRpCommon.asl
@@ -0,0 +1,289 @@
+/** @file
+  This file contains the CPU PCIe Root Port configuration
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+  External(ECR1)
+  External(GPRW, MethodObj)
+  External(PICM)
+  External(\_SB.PC00.PC2M, MethodObj)
+  External(_ADR, IntObj)
+
+
+  OperationRegion(PXCS,SystemMemory,\_SB.PC00.PC2M(_ADR),0x480)
+  Field(PXCS, AnyAcc, NoLock, Preserve)
+  {
+    Offset(0),
+    VDID, 32,
+    Offset(0x50), // LCTL - Link Control Register
+    L0SE, 1,      // 0, L0s Entry Enabled
+    , 3,
+    LDIS, 1,
+    , 3,
+    Offset(0x52), // LSTS - Link Status Register
+    , 13,
+    LASX, 1,      // 0, Link Active Status
+    Offset(0x5A), // SLSTS[7:0] - Slot Status Register
+    ABPX, 1,      // 0, Attention Button Pressed
+    , 2,
+    PDCX, 1,      // 3, Presence Detect Changed
+    , 2,
+    PDSX, 1,      // 6, Presence Detect State
+    , 1,
+    Offset(0x60), // RSTS - Root Status Register
+    , 16,
+    PSPX, 1,      // 16,  PME Status
+    Offset(0xA4),
+    D3HT, 2,      // Power State
+    Offset(0xD8), // 0xD8, MPC - Miscellaneous Port Configuration Register
+    , 30,
+    HPEX, 1,      // 30,  Hot Plug SCI Enable
+    PMEX, 1,      // 31,  Power Management SCI Enable
+    Offset(0xE0), // 0xE0, SPR - Scratch Pad Register
+    , 0,
+    SCB0, 1,      // Sticky Scratch Pad Bit SCB0
+    Offset(0xE2), // 0xE2, RPPGEN - Root Port Power Gating Enable
+    , 2,
+    L23E, 1,       // 2,   L23_Rdy Entry Request (L23ER)
+    L23R, 1,       // 3,   L23_Rdy to Detect Transition (L23R2DT)
+    Offset(0x324), // 0x324 - PCIEDBG
+    , 3,
+    LEDM, 1,       // PCIEDBG.DMIL1EDM
+    Offset(0x328), // 0x328 - PCIESTS1
+    , 24,
+    LTSM, 8,
+  }
+  Field(PXCS,AnyAcc, NoLock, WriteAsZeros)
+  {
+    Offset(0xDC), // 0xDC, SMSCS - SMI/SCI Status Register
+    , 30,
+    HPSX, 1,      // 30,  Hot Plug SCI Status
+    PMSX, 1       // 31,  Power Management SCI Status
+  }
+
+  //
+  // L23D method recovers link from L2 or L3 state. Used for RTD3 flows, right after endpoint is powered up and exits reset.
+  // This flow is implemented in ASL because rootport registers used for L2/L3 entry/exit
+  // are proprietary and OS drivers don't know about them.
+  //
+  Method (L23D, 0, Serialized) {
+    If(LNotEqual(SCB0,0x1)) {
+      Return()
+    }
+
+    /// Set L23_Rdy to Detect Transition  (L23R2DT)
+    Store(1, L23R)
+    Store(0, Local0)
+    /// Wait for transition to Detect
+    While(L23R) {
+      If(Lgreater(Local0, 4))
+      {
+        Break
+      }
+      Sleep(16)
+      Increment(Local0)
+    }
+    Store(0,SCB0)
+
+    /// Once in Detect, wait up to 124 ms for Link Active (typically happens in under 70ms)
+    /// Worst case per PCIe spec from Detect to Link Active is:
+    /// 24ms in Detect (12+12), 72ms in Polling (24+48), 28ms in Config (24+2+2+2+2)
+    Store(0, Local0)
+    While(LEqual(LASX,0)) {
+      If(Lgreater(Local0, 8))
+      {
+        Break
+      }
+      Sleep(16)
+      Increment(Local0)
+    }
+  }
+
+  //
+  // DL23 method puts link to L2 or L3 state. Used for RTD3 flows, before endpoint is powered down.
+  // This flow is implemented in ASL because rootport registers used for L2/L3 entry/exit
+  // are proprietary and OS drivers don't know about them.
+  //
+  Method (DL23, 0, Serialized) {
+    Store(1, L23E)
+    Sleep(16)
+    Store(0, Local0)
+    While(L23E) {
+      If(Lgreater(Local0, 4))
+      {
+        Break
+      }
+      Sleep(16)
+      Increment(Local0)
+    }
+    Store(1,SCB0)
+  }
+
+  Name(LTRV, Package(){0,0,0,0})
+  Name(CPMV, 0) // CPU Rp Mapped under VMD
+
+  //
+  // _DSM Device Specific Method
+  //
+  // Arg0: UUID Unique function identifier
+  // Arg1: Integer Revision Level
+  // Arg2: Integer Function Index (0 = Return Supported Functions)
+  // Arg3: Package Parameters
+  Method(_DSM, 4, Serialized) {
+    //
+    // Switch based on which unique function identifier was passed in
+    //
+    If (LEqual(Arg0, ToUUID ("E5C937D0-3553-4d7a-9117-EA4D19C3434D"))) {
+      //
+      // _DSM Definitions for Latency Tolerance Reporting
+      //
+      // Arguments:
+      // Arg0: UUID: E5C937D0-3553-4d7a-9117-EA4D19C3434D
+      // Arg1: Revision ID: 3
+      // Arg2: Function Index: 0, 6, 8, 9
+      // Arg3: Empty Package
+      //
+      // Switch by function index
+      //
+      Switch(ToInteger(Arg2)) {
+        //
+        // Function Index:0
+        // Standard query - A bitmask of functions supported
+        //
+        Case (0) {
+          Name(OPTS,Buffer(2){0,0})
+          CreateBitField(OPTS,0,FUN0)
+          CreateBitField(OPTS,6,FUN6)
+          CreateBitField(OPTS,8,FUN8)
+          CreateBitField(OPTS,9,FUN9)
+
+          Store(1,FUN0)
+          if(LEqual(LTEN,1)) {
+            Store(1,Fun6)
+          }
+
+          If (LGreaterEqual(Arg1, 2)){ // test Arg1 for Revision ID: 2
+            If(CondRefOf(ECR1)) {
+              if(LEqual(ECR1,1)){
+                if (LGreaterEqual(Arg1, 3)){ // test Arg1 for Revision ID: 3
+                  Store(1,Fun8)
+                  Store(1,Fun9)
+                }
+              }
+            }
+          }
+          Return (OPTS)
+        }
+
+        //
+        // Function Index: 6
+        // LTR Extended Capability Structure
+        //
+        Case(6) {
+          if (LGreaterEqual(Arg1, 2)){ // test Arg1 for Revision ID: 2
+            Store(And(ShiftRight(LMSL,10),7), Index(LTRV, 0))
+            Store(And(LMSL,0x3FF), Index(LTRV, 1))
+            Store(And(ShiftRight(LNSL,10),7), Index(LTRV, 2))
+            Store(And(LNSL,0x3FF), Index(LTRV, 3))
+            Return (LTRV)
+          }
+        }
+        Case(8) { //ECR ACPI additions for FW latency optimizations, DSM for Avoiding Power-On Reset Delay Duplication on Sx Resume
+          If(CondRefOf(ECR1)) {
+            if(LEqual(ECR1,1)){
+              if (LGreaterEqual(Arg1, 3)) { // test Arg1 for Revision ID: 3
+                return (1)
+              }
+            }
+          }
+        }
+        Case(9) { //ECR ACPI additions for FW latency optimizations, DSM for Specifying Device Readiness Durations
+          If(CondRefOf(ECR1)) {
+            if(LEqual(ECR1,1)){
+              if (LGreaterEqual(Arg1, 3)) { // test Arg1 for Revision ID: 3
+                return(Package(5){50000,Ones,Ones,50000,Ones})
+              }
+            }
+          }
+        }
+      } // End of switch(Arg2)
+    } // End of if
+    return (Buffer() {0x00})
+  } // End of _DSM
+
+  Method(_PRW, 0) {
+    Return(GPRW(0x69, 4)) // can wakeup from S4 state
+  }
+
+  Method(_PS0,0,Serialized)
+  {
+    If (LEqual(HPEX, 1)) {
+      Store(0, HPEX) // Disable Hot Plug SCI
+      Store(1, HPSX) // Clear Hot Plug SCI status
+    }
+    If (LEqual (PMEX, 1)) {
+      Store(0, PMEX) // Disable Power Management SCI
+      Store(1, PMSX) // Clear Power Management SCI status
+    }
+  }
+  Method(_PS3,0,Serialized)
+  {
+    If (LEqual (HPEX, 0)) {
+      Store(1, HPEX) // Enable Hot Plug SCI
+      Store(1, HPSX) // Clear Hot Plug SCI status
+    }
+    If (LEqual(PMEX, 0)) {
+      Store(1, PMEX) // Enable Power Management SCI
+      Store(1, PMSX) // Clear Power Management SCI status
+    }
+  }
+
+  Method (_DSD, 0) {
+    Return (
+      Package () {
+        ToUUID("FDF06FAD-F744-4451-BB64-ECD792215B10"),
+        Package () {
+          Package (2) {"FundamentalDeviceResetTriggeredOnD3ToD0", 1},
+        }
+      }
+    ) // End of Return ()
+  }
+
+  //
+  // PCI_EXP_STS Handler for PCIE Root Port
+  //
+  Method(HPME,0,Serialized) {
+    If(LAnd(LNotEqual(VDID,0xFFFFFFFF), LEqual(PMSX,1))) { //if port exists and has PME SCI Status set...
+      Store(1,PMSX) // clear rootport's PME SCI status
+      Store(1,PSPX) // consume one pending PME status to prevent it from blocking the queue
+      Return(0x01)
+    }
+    Return(0x00)
+  }
+
+  //
+  // Sub-Method of _L61 Hot-Plug event
+  // _L61 event handler should invoke this method to support HotPlug wake event from PEG RP
+  //
+  Method(HPEV,0,Serialized) {
+    If(LAnd(LNotEqual(VDID,0xFFFFFFFF), HPSX)) {
+      // Clear HotPlug SCI event status
+      Store(1, HPSX)
+
+      If(LEqual(PDCX, 1)) {
+        // Clear Presence Detect Changed
+        Store(1,PDCX)
+
+        If(LEqual(PDSX, 0)) {
+          // The PCI Express slot is empty, so disable L0s on hot unplug
+          //
+          Store(0,L0SE)
+        }
+        // Perform proper notification
+        // to the OS.
+        Notify(^,0)
+      }
+    }
+  }
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCommon.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCommon.asl
new file mode 100644
index 0000000000..68b10309d4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCommon.asl
@@ -0,0 +1,1344 @@
+/** @file
+  This file contains the device definitions of the SystemAgent
+  PCIE ACPI Reference Code.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+External(\_SB.ISME, MethodObj)
+External(\_SB.SHPO, MethodObj)
+External(\_SB.CAGS, MethodObj)
+External(\_SB.GGOV, MethodObj)
+External(\_SB.SGOV, MethodObj)
+External(\_SB.PC00.PEG0, DeviceObj)
+External(\_SB.PC00.PEG1, DeviceObj)
+External(\_SB.PC00.PEG2, DeviceObj)
+External(\_SB.PC00.PEG3, DeviceObj)
+External(\_SB.PC00.PEG0.PPRW, MethodObj)
+External(\_SB.PC00.PEG1.PPRW, MethodObj)
+External(\_SB.PC00.PEG2.PPRW, MethodObj)
+External(\_SB.PC00.PEG3.PPRW, MethodObj)
+External(\_SB.PC00.PC2M, MethodObj)
+External(P8XH, MethodObj)
+External(SPCO, MethodObj)
+External(PINI, MethodObj) // Platform specific PCIe root port initialization
+External(PRES, MethodObj)
+External(GPRW, MethodObj)
+External(\SLOT)
+External(\P0WK)
+External(\P1WK)
+External(\P2WK)
+External(\P3WK)
+External(\XBAS)
+External(\SBN0)
+External(\SBN1)
+External(\SBN2)
+External(\SBN3)
+External(\EECP)
+External(\EEC1)
+External(\EEC2)
+External(\EEC3)
+External(\SGGP)
+External(\HRE0)
+External(\HRG0)
+External(\HRA0)
+External(\PWE0)
+External(\PWG0)
+External(\PWA0)
+External(\P1GP)
+External(\HRE1)
+External(\HRG1)
+External(\HRA1)
+External(\PWE1)
+External(\PWG1)
+External(\PWA1)
+External(\P2GP)
+External(\HRE2)
+External(\HRG2)
+External(\HRA2)
+External(\PWE2)
+External(\PWG2)
+External(\PWA2)
+External(\P3GP)
+External(\HRE3)
+External(\HRG3)
+External(\HRA3)
+External(\PWE3)
+External(\PWG3)
+External(\PWA3)
+External(\P0SC)
+External(\P1SC)
+External(\P2SC)
+External(\P3SC)
+External(\DLPW)
+External(\DLHR)
+External(\OBFX)
+External(\OBFY)
+External(\OBFZ)
+External(\OBFA)
+External(\OSYS)
+
+//GPE Event handling - Start
+Scope(\_GPE) {
+  //
+  // _L6F Method call for PEG0/1/2/3 ports to handle 2-tier RTD3 GPE events
+  //
+  Method(P0L6,0)
+  {
+    // PEG0 Device Wake Event
+    If (\_SB.ISME(P0WK))
+    {
+      \_SB.SHPO(P0WK, 1)             // set gpio ownership to driver(0=ACPI mode, 1=GPIO mode)
+      Notify(\_SB.PC00.PEG0, 0x02)   // device wake
+      \_SB.CAGS(P0WK)                // Clear GPE status bit for PEG0 WAKE
+    }
+  }
+
+  Method(P1L6,0)
+  {
+    // PEG1 Device Wake Event
+    If (\_SB.ISME(P1WK))
+    {
+      \_SB.SHPO(P1WK, 1)             // set gpio ownership to driver(0=ACPI mode, 1=GPIO mode)
+      Notify(\_SB.PC00.PEG1, 0x02)   // device wake
+      \_SB.CAGS(P1WK)                // Clear GPE status bit for PEG1 WAKE
+    }
+  }
+
+  Method(P2L6,0)
+  {
+    // PEG2 Device Wake Event
+    If (\_SB.ISME(P2WK))
+    {
+      \_SB.SHPO(P2WK, 1)             // set gpio ownership to driver(0=ACPI mode, 1=GPIO mode)
+      Notify(\_SB.PC00.PEG2, 0x02)   // device wake
+      \_SB.CAGS(P2WK)                // Clear GPE status bit for PEG2 WAKE
+    }
+  }
+
+  If (CondRefOf(\_SB.PC00.PEG3)) {
+    Method(P3L6,0)
+    {
+      // PEG2 Device Wake Event
+      If (\_SB.ISME(P3WK))
+      {
+        \_SB.SHPO(P3WK, 1)             // set gpio ownership to driver(0=ACPI mode, 1=GPIO mode)
+        Notify(\_SB.PC00.PEG3, 0x02)   // device wake
+        \_SB.CAGS(P3WK)                // Clear GPE status bit for PEG2 WAKE
+      }
+    }
+  }
+} //Scope(\_GPE)
+
+If(LAnd((LEqual(HGMD,2)), (LEqual(HGST,1)))) {
+///
+/// P.E.G. Root Port D6F0
+///
+Scope(\_SB.PC00.PEG0) {
+  Name(WKEN, 0)
+
+  PowerResource(PG00, 0, 0) {
+    Name(_STA, One)
+    Method(_ON, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGON(0)
+        Store(One, _STA)
+      }
+    }
+    Method(_OFF, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGOF(0)
+        Store(Zero, _STA)
+      }
+    }
+  } //End of PowerResource(PG00, 0, 0)
+
+  Name(_PR0,Package(){PG00})
+  Name(_PR3,Package(){PG00})
+
+  ///
+  /// This method is used to enable/disable wake from PEG60 (WKEN)
+  ///
+  Method(_DSW, 3)
+  {
+    If(Arg1)
+    {
+      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from generating runtime PME
+    }
+    Else
+    { /// If Staying in S0
+      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
+      {
+        Store(1, WKEN)      ///- Set PME
+      } Else {
+        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0 or disabling wake
+      }
+    }
+  } // End _DSW
+
+  ///
+  /// This method is used to change the GPIO ownership back to ACPI and will be called in PEG OFF Method
+  ///
+  Method(P0EW, 0)
+  {
+    If(WKEN)
+    {
+      If(LNotEqual(SGGP, 0x0))
+      {
+        If(LEqual(SGGP, 0x1))      // GPIO mode
+        {
+          \_SB.SGOV(P0WK, 0x1)
+          \_SB.SHPO(P0WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode, 1=GPIO mode)
+        }
+      }
+    }
+  } // End P0EW
+
+  Method(_S0W, 0) {
+    Return(4) //D3cold is supported
+  }
+}// end "P.E.G. Root Port D6F0"
+
+///
+/// P.E.G. Root Port D1F0
+///
+Scope(\_SB.PC00.PEG1) {
+  Name(WKEN, 0)
+
+  PowerResource(PG01, 0, 0) {
+    Name(_STA, One)
+    Method(_ON, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGON(1)
+        Store(One, _STA)
+      }
+    }
+    Method(_OFF, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGOF(1)
+        Store(Zero, _STA)
+      }
+    }
+  } //End of PowerResource(PG01, 0, 0)
+
+  Name(_PR0,Package(){PG01})
+  Name(_PR3,Package(){PG01})
+
+  ///
+  /// This method is used to enable/disable wake from PEG10 (WKEN)
+  ///
+  Method(_DSW, 3)
+  {
+    If(Arg1)
+    {
+      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from generating runtime PME
+    }
+    Else
+    { /// If Staying in S0
+      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
+      {
+        Store(1, WKEN)      ///- Set PME
+      } Else {
+        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0 or disabling wake
+      }
+    }
+  } // End _DSW
+
+  ///
+  /// This method is used to change the GPIO ownership back to ACPI and will be called in PEG OFF Method
+  ///
+  Method(P1EW, 0)
+  {
+    If(WKEN)
+    {
+      If(LNotEqual(P1GP, 0x0))
+      {
+        If(LEqual(P1GP, 0x1))      // GPIO mode
+        {
+          \_SB.SGOV(P1WK, 0x1)
+          \_SB.SHPO(P1WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode, 1=GPIO mode)
+        }
+      }
+    }
+  } // End P1EW
+}// end "P.E.G. Root Port D1F0"
+
+///
+/// P.E.G. Root Port D1F1
+///
+Scope(\_SB.PC00.PEG2) {
+  Name(WKEN, 0)
+
+  PowerResource(PG02, 0, 0) {
+    Name(_STA, One)
+    Method(_ON, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGON(2)
+        Store(One, _STA)
+      }
+    }
+    Method(_OFF, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGOF(2)
+        Store(Zero, _STA)
+      }
+    }
+  } //End of PowerResource(PG02, 0, 0)
+
+  Name(_PR0,Package(){PG02})
+
+  Name(_PR3,Package(){PG02})
+
+  ///
+  /// This method is used to enable/disable wake from PEG11 (WKEN)
+  ///
+  Method(_DSW, 3)
+  {
+    If(Arg1)
+    {
+      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from generating runtime PME
+    }
+    Else
+    { /// If Staying in S0
+      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
+      {
+        Store(1, WKEN)      ///- Set PME
+      } Else {
+        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0 or disabling wake
+      }
+    }
+  } // End _DSW
+
+  ///
+  /// This method is used to change the GPIO ownership back to ACPI and will be called in PEG OFF Method
+  ///
+  Method(P2EW, 0)
+  {
+    If(WKEN)
+    {
+      If(LNotEqual(P2GP, 0x0))
+      {
+        If(LEqual(P2GP, 0x1))      // GPIO mode
+        {
+          \_SB.SGOV(P2WK, 0x1)
+          \_SB.SHPO(P2WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode, 1=GPIO mode)
+        }
+      }
+    }
+  } // End P2EW
+}// end "P.E.G. Root Port D1F1"
+
+///
+/// P.E.G. Root Port D1F2
+///
+Scope(\_SB.PC00.PEG3) {
+  Name(WKEN, 0)
+
+  PowerResource(PG03, 0, 0) {
+    Name(_STA, One)
+    Method(_ON, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGON(3)
+        Store(One, _STA)
+      }
+    }
+    Method(_OFF, 0, Serialized) {
+      If(LGreater(OSYS,2009)) {
+        PGOF(3)
+        Store(Zero, _STA)
+      }
+    }
+  } //End of PowerResource(PG03, 0, 0)
+
+  Name(_PR0,Package(){PG03})
+  Name(_PR3,Package(){PG03})
+
+  ///
+  /// This method is used to enable/disable wake from PEG12 (WKEN)
+  ///
+  Method(_DSW, 3)
+  {
+    If(Arg1)
+    {
+      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from generating runtime PME
+    }
+    Else
+    { /// If Staying in S0
+      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
+      {
+        Store(1, WKEN)      ///- Set PME
+      } Else {
+        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0 or disabling wake
+      }
+    }
+  } // End _DSW
+
+  ///
+  /// This method is used to change the GPIO ownership back to ACPI and will be called in PEG OFF Method
+  ///
+  Method(P3EW, 0)
+  {
+    If(WKEN)
+    {
+      If(LNotEqual(P3GP, 0x0))
+      {
+        If(LEqual(P3GP, 0x1))      // GPIO mode
+        {
+          \_SB.SGOV(P3WK, 0x1)
+          \_SB.SHPO(P3WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode, 1=GPIO mode)
+        }
+      }
+    }
+  } // End P3EW
+}// end "P.E.G. Root Port D1F2"
+
+Scope (\_SB.PC00) {
+
+    Name(IVID, 0xFFFF) //Invalid Vendor ID
+
+    Name(PEBA, 0) //PCIE base address
+
+    Name(PION, 0) //PEG index for ON Method
+    Name(PIOF, 0) //PEG index for OFF Method
+
+    Name(PBUS, 0) //PEG Rootport bus no
+    Name(PDEV, 0) //PEG Rootport device no
+    Name(PFUN, 0) //PEG Rootport function no
+
+    Name(EBUS, 0) //Endpoint bus no
+    Name(EDEV, 0) //Endpoint device no
+    Name(EFN0, 0) //Endpoint function no 0
+    Name(EFN1, 1) //Endpoint function no 1
+
+    Name(LTRS, 0)
+    Name(OBFS, 0)
+
+    Name(DSOF, 0x06) //Device status PCI offset
+    Name(CPOF, 0x34) //Capabilities pointer PCI offset
+    Name(SBOF, 0x19) //PCI-2-PCI Secondary Bus number
+
+    // PEG0 Endpoint variable to save/restore Link Capability, Link control, Subsytem VendorId and Device Id
+    Name (ELC0, 0x00000000)
+    Name (ECP0, 0xffffffff)
+    Name (H0VI, 0x0000)
+    Name (H0DI, 0x0000)
+
+    // PEG1 Endpoint variable to save/restore Link Capability, Link control, Subsytem VendorId and Device Id
+    Name (ELC1, 0x00000000)
+    Name (ECP1, 0xffffffff)
+    Name (H1VI, 0x0000)
+    Name (H1DI, 0x0000)
+
+    // PEG2 Endpoint variable to save/restore Link Capability, Link control, Subsytem VendorId and Device Id
+    Name (ELC2, 0x00000000)
+    Name (ECP2, 0xffffffff)
+    Name (H2VI, 0x0000)
+    Name (H2DI, 0x0000)
+
+    // PEG3 Endpoint variable to save/restore Link Capability, Link control, Subsytem VendorId and Device Id
+    Name (ELC3, 0x00000000)
+    Name (ECP3, 0xffffffff)
+    Name (H3VI, 0x0000)
+    Name (H3DI, 0x0000)
+
+    // PEG_AFELN[15:0]VMTX2_OFFSET variables
+    Name(AFL0, 0)
+    Name(AFL1, 0)
+    Name(AFL2, 0)
+    Name(AFL3, 0)
+    Name(AFL4, 0)
+    Name(AFL5, 0)
+    Name(AFL6, 0)
+    Name(AFL7, 0)
+    Name(AFL8, 0)
+    Name(AFL9, 0)
+    Name(AFLA, 0)
+    Name(AFLB, 0)
+    Name(AFLC, 0)
+    Name(AFLD, 0)
+    Name(AFLE, 0)
+    Name(AFLF, 0)
+
+    //
+    // Define a Memory Region for PEG60 root port that will allow access to its
+    // Register Block.
+    //
+    OperationRegion(OPG0, SystemMemory, Add(XBAS,0x30000), 0x1000)
+    Field(OPG0, AnyAcc,NoLock,Preserve)
+    {
+      Offset(0),
+      P0VI,   16,        //Vendor ID PCI offset
+      P0DI,   16,        //Device ID PCI offset
+      Offset(0x06),
+      DSO0,   16,        //Device status PCI offset
+      Offset(0x34),
+      CPO0,   8,         //Capabilities pointer PCI offset
+      Offset(0x0B0),
+      ,       4,
+      P0LD,   1,         //Link Disable
+      Offset(0x11A),
+      ,       1,
+      P0VC,   1,         //VC0RSTS.VC0NP
+      Offset(0x214),
+      ,       16,
+      P0LS,   4,         //PEGSTS.LKS
+      Offset(0x248),
+      ,       7,
+      Q0L2,   1,         //L23_Rdy Entry Request for RTD3
+      Q0L0,   1,         //L23 to Detect Transition for RTD3
+      Offset(0x504),
+      HST0,  32,
+      Offset(0x508),
+      P0TR,   1,         //TRNEN.TREN
+      Offset(0xC74),
+      P0LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
+      Offset(0xD0C),
+      LRV0,  32,
+    }
+
+    //
+    // Define a Memory Region for Endpoint on PEG60 root port
+    //
+    OperationRegion (PCS0, SystemMemory, Add(XBAS,ShiftLeft(SBN0,20)), 0xF0)
+    Field(PCS0, DWordAcc, Lock, Preserve)
+    {
+        Offset(0x0),
+        D0VI, 16,
+        Offset(0x2C),
+        S0VI, 16,
+        S0DI, 16,
+    }
+
+    OperationRegion(CAP0, SystemMemory, Add(Add(XBAS,ShiftLeft(SBN0,20)),EECP),0x14)
+    Field(CAP0,DWordAcc, NoLock,Preserve)
+    {
+        Offset(0x0C),                    // Link Capabilities Register
+        LCP0,   32,                      // Link Capabilities Register Data
+        Offset(0x10),
+        LCT0,   16,                      // Link Control register
+    }
+
+    //
+    // Define a Memory Region for PEG10 root port that will allow access to its
+    // Register Block.
+    //
+    OperationRegion(OPG1, SystemMemory, Add(XBAS,0x8000), 0x1000)
+    Field(OPG1, AnyAcc,NoLock,Preserve)
+    {
+      Offset(0),
+      P1VI,   16,        //Vendor ID PCI offset
+      P1DI,   16,        //Device ID PCI offset
+      Offset(0x06),
+      DSO1,   16,        //Device status PCI offset
+      Offset(0x34),
+      CPO1,   8,         //Capabilities pointer PCI offset
+      Offset(0x0B0),
+      ,       4,
+      P1LD,   1,         //Link Disable
+      Offset(0x11A),
+      ,       1,
+      P1VC,   1,         //VC0RSTS.VC0NP
+      Offset(0x214),
+      ,       16,
+      P1LS,   4,         //PEGSTS.LKS
+      Offset(0x248),
+      ,       7,
+      Q1L2,   1,         //L23_Rdy Entry Request for RTD3
+      Q1L0,   1,         //L23 to Detect Transition for RTD3
+      Offset(0x504),
+      HST1,  32,
+      Offset(0x508),
+      P1TR,   1,         //TRNEN.TREN
+      Offset(0x70C),
+      PA0V,  32,         //PEG_AFELN0VMTX2_OFFSET
+      Offset(0x71C),
+      PA1V,  32,         //PEG_AFELN1VMTX2_OFFSET
+      Offset(0x72C),
+      PA2V,  32,         //PEG_AFELN2VMTX2_OFFSET
+      Offset(0x73C),
+      PA3V,  32,         //PEG_AFELN3VMTX2_OFFSET
+      Offset(0x74C),
+      PA4V,  32,         //PEG_AFELN4VMTX2_OFFSET
+      Offset(0x75C),
+      PA5V,  32,         //PEG_AFELN5VMTX2_OFFSET
+      Offset(0x76C),
+      PA6V,  32,         //PEG_AFELN6VMTX2_OFFSET
+      Offset(0x77C),
+      PA7V,  32,         //PEG_AFELN7VMTX2_OFFSET
+      Offset(0x78C),
+      PA8V,  32,         //PEG_AFELN8VMTX2_OFFSET
+      Offset(0x79C),
+      PA9V,  32,         //PEG_AFELN9VMTX2_OFFSET
+      Offset(0x7AC),
+      PAAV,  32,         //PEG_AFELNAVMTX2_OFFSET
+      Offset(0x7BC),
+      PABV,  32,         //PEG_AFELNBVMTX2_OFFSET
+      Offset(0x7CC),
+      PACV,  32,         //PEG_AFELNCVMTX2_OFFSET
+      Offset(0x7DC),
+      PADV,  32,         //PEG_AFELNDVMTX2_OFFSET
+      Offset(0x7EC),
+      PAEV,  32,         //PEG_AFELNEVMTX2_OFFSET
+      Offset(0x7FC),
+      PAFV,  32,         //PEG_AFELNFVMTX2_OFFSET
+      Offset(0x91C),
+      ,       31,
+      BSP1,   1,
+      Offset(0x93C),
+      ,       31,
+      BSP2,   1,
+      Offset(0x95C),
+      ,       31,
+      BSP3,   1,
+      Offset(0x97C),
+      ,       31,
+      BSP4,   1,
+      Offset(0x99C),
+      ,       31,
+      BSP5,   1,
+      Offset(0x9BC),
+      ,       31,
+      BSP6,   1,
+      Offset(0x9DC),
+      ,       31,
+      BSP7,   1,
+      Offset(0x9FC),
+       ,       31,
+      BSP8,   1,
+      Offset(0xC20),
+      ,       4,
+      P1AP,   2,         //AFEOVR.RXSQDETOVR
+      Offset(0xC38),
+      ,       3,
+      P1RM,   1,         //CMNSPARE.PCUNOTL1
+      Offset(0xC3C),
+      ,       31,
+      PRST,   1,
+      Offset(0xC74),
+      P1LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
+      Offset(0xD0C),
+      LRV1,  32,
+    }
+
+    //
+    // Define a Memory Region for Endpoint on PEG10 root port
+    //
+    OperationRegion (PCS1, SystemMemory, Add(XBAS,ShiftLeft(SBN1,20)), 0xF0)
+    Field(PCS0, DWordAcc, Lock, Preserve)
+    {
+        Offset(0x0),
+        D1VI, 16,
+        Offset(0x2C),
+        S1VI, 16,
+        S1DI, 16,
+    }
+
+    OperationRegion(CAP1, SystemMemory, Add(Add(XBAS,ShiftLeft(SBN1,20)),EEC1),0x14)
+    Field(CAP0,DWordAcc, NoLock,Preserve)
+    {
+        Offset(0x0C),                    // Link Capabilities Register
+        LCP1,   32,                      // Link Capabilities Register Data
+        Offset(0x10),
+        LCT1,   16,                      // Link Control register
+    }
+
+    //
+    // Define a Memory Region for PEG11 root port that will allow access to its
+    // Register Block.
+    //
+    OperationRegion(OPG2, SystemMemory, Add(XBAS,0x9000), 0x1000)
+    Field(OPG2, AnyAcc,NoLock,Preserve)
+    {
+      Offset(0),
+      P2VI,   16,        //Vendor ID PCI offset
+      P2DI,   16,        //Device ID PCI offset
+      Offset(0x06),
+      DSO2,   16,        //Device status PCI offset
+      Offset(0x34),
+      CPO2,   8,         //Capabilities pointer PCI offset
+      Offset(0x0B0),
+      ,       4,
+      P2LD,   1,         //Link Disable
+      Offset(0x11A),
+      ,       1,
+      P2VC,   1,         //VC0RSTS.VC0NP
+      Offset(0x214),
+      ,       16,
+      P2LS,   4,         //PEGSTS.LKS
+      Offset(0x248),
+      ,       7,
+      Q2L2,   1,         //L23_Rdy Entry Request for RTD3
+      Q2L0,   1,         //L23 to Detect Transition for RTD3
+      Offset(0x504),
+      HST2,  32,
+      Offset(0x508),
+      P2TR,   1,         //TRNEN.TREN
+      Offset(0xC20),
+      ,       4,
+      P2AP,   2,         //AFEOVR.RXSQDETOVR
+      Offset(0xC38),
+      ,       3,
+      P2RM,   1,         //CMNSPARE.PCUNOTL1
+      Offset(0xC74),
+      P2LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
+      Offset(0xD0C),
+      LRV2,  32,
+    }
+
+    //
+    // Define a Memory Region for Endpoint on PEG11 root port
+    //
+    OperationRegion (PCS2, SystemMemory, Add(XBAS,ShiftLeft(SBN2,20)), 0xF0)
+    Field(PCS2, DWordAcc, Lock, Preserve)
+    {
+        Offset(0x0),
+        D2VI, 16,
+        Offset(0x2C),
+        S2VI, 16,
+        S2DI, 16,
+    }
+
+    OperationRegion(CAP2, SystemMemory, Add(Add(XBAS,ShiftLeft(SBN2,20)),EEC2),0x14)
+    Field(CAP2,DWordAcc, NoLock,Preserve)
+    {
+        Offset(0x0C),    // Link Capabilities Register
+        LCP2,   32,      // Link Capabilities Register Data
+        Offset(0x10),
+        LCT2,   16,      // Link Control register
+    }
+
+
+    //
+    // Define a Memory Region for PEG12 root port that will allow access to its
+    // Register Block.
+    //
+    OperationRegion(OPG3, SystemMemory, Add(XBAS,0xA000), 0x1000)
+    Field(OPG3, AnyAcc,NoLock,Preserve)
+    {
+      Offset(0),
+      P3VI,   16,        //Vendor ID PCI offset
+      P3DI,   16,        //Device ID PCI offset
+      Offset(0x06),
+      DSO3,   16,        //Device status PCI offset
+      Offset(0x34),
+      CPO3,   8,         //Capabilities pointer PCI offset
+      Offset(0x0B0),
+      ,       4,
+      P3LD,   1,         //Link Disable
+      Offset(0x11A),
+      ,       1,
+      P3VC,   1,         //VC0RSTS.VC0NP
+      Offset(0x214),
+      ,       16,
+      P3LS,   4,         //PEGSTS.LKS
+      Offset(0x248),
+      ,       7,
+      Q3L2,   1,         //L23_Rdy Entry Request for RTD3
+      Q3L0,   1,         //L23 to Detect Transition for RTD3
+      Offset(0x504),
+      HST3,  32,
+      Offset(0x508),
+      P3TR,   1,         //TRNEN.TREN
+      Offset(0xC20),
+      ,       4,
+      P3AP,   2,         //AFEOVR.RXSQDETOVR
+      Offset(0xC38),
+      ,       3,
+      P3RM,   1,         //CMNSPARE.PCUNOTL1
+      Offset(0xC74),
+      P3LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
+      Offset(0xD0C),
+      LRV3,  32,
+    }
+
+    //
+    // Define a Memory Region for Endpoint on PEG2 root port
+    //
+    OperationRegion (PCS3, SystemMemory, Add(XBAS,ShiftLeft(SBN3,20)), 0xF0)
+    Field(PCS2, DWordAcc, Lock, Preserve)
+    {
+        Offset(0x0),
+        D3VI, 16,
+        Offset(0x2C),
+        S3VI, 16,
+        S3DI, 16,
+    }
+
+    OperationRegion(CAP3, SystemMemory, Add(Add(XBAS,ShiftLeft(SBN3,20)),EEC3),0x14)
+    Field(CAP3,DWordAcc, NoLock,Preserve)
+    {
+        Offset(0x0C),    // Link Capabilities Register
+        LCP3,   32,      // Link Capabilities Register Data
+        Offset(0x10),
+        LCT3,   16,      // Link Control register
+    }
+
+    //
+    // Name: PGON
+    // Description: Function to put the Pcie Endpoint in ON state
+    // Input: Arg0 -> PEG index
+    // Return: Nothing
+    //
+    Method(PGON,1,Serialized)
+    {
+      Store(Arg0, PION)
+
+      //
+      // Check for the GPIO support on PEG0/1/2/3 Configuration and Return if it is not supported.
+      //
+      If (LEqual(PION, 0))
+      {
+        If (LEqual(SGGP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PION, 1))
+      {
+        If (LEqual(P1GP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PION, 2))
+      {
+        If (LEqual(P2GP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PION, 3))
+      {
+        If (LEqual(P3GP, 0x0))
+        {
+          Return ()
+        }
+      }
+      Store(\XBAS, PEBA)
+      Store(GDEV(PIOF), PDEV)
+      Store(GFUN(PIOF), PFUN)
+
+      /// de-assert CLK_REQ MSK
+      PGSC(Arg0, 1)
+
+      If (LEqual(CCHK(PION, 1), 0))
+      {
+        Return ()
+      }
+
+      //Power on the Endpoint
+      GPPR(PION, 1)
+
+      // Restore PEG Recipe before program L23R2DT
+      //\_SB.PC00.PEG1.RAVR()
+
+      // Enable link for RTD3
+      RTEN()
+
+      // Re-store the DGPU Subsystem VendorID, DeviceID & Link control register data
+      If (LEqual(PION, 0))
+      {
+        Store(H0VI, S0VI)
+        Store(H0DI, S0DI)
+        Or(And(ELC0,0x0043),And(LCT0,0xFFBC),LCT0)
+      }
+      ElseIf (LEqual(PION, 1))
+      {
+        Store(H1VI, S1VI)
+        Store(H1DI, S1DI)
+        Or(And(ELC1,0x0043),And(LCT1,0xFFBC),LCT1)
+      }
+      ElseIf (LEqual(PION, 2))
+      {
+        Store(H2VI, S2VI)
+        Store(H2DI, S2DI)
+        Or(And(ELC2,0x0043),And(LCT2,0xFFBC),LCT2)
+      }
+      ElseIf (LEqual(PION, 3))
+      {
+        Store(H3VI, S3VI)
+        Store(H3DI, S3DI)
+        Or(And(ELC3,0x0043),And(LCT3,0xFFBC),LCT3)
+      }
+      Return ()
+    } // End of Method(PGON,1,Serialized)
+
+    //
+    // Name: PGOF
+    // Description: Function to put the Pcie Endpoint in OFF state
+    // Input: Arg0 -> PEG index
+    // Return: Nothing
+    //
+    Method(PGOF,1,Serialized)
+    {
+
+      Store(Arg0, PIOF)
+      //
+      // Check for the GPIO support on PEG0/1/2 Configuration and Return if it is not supported.
+      //
+      If (LEqual(PIOF, 0))
+      {
+        If (LEqual(SGGP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PIOF, 1))
+      {
+        If (LEqual(P1GP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PIOF, 2))
+      {
+        If (LEqual(P2GP, 0x0))
+        {
+          Return ()
+        }
+      }
+      ElseIf (LEqual(PIOF, 3))
+      {
+        If (LEqual(P3GP, 0x0))
+        {
+          Return ()
+        }
+      }
+
+      Store(\XBAS, PEBA)
+      Store(GDEV(PIOF), PDEV)
+      Store(GFUN(PIOF), PFUN)
+
+      If (LEqual(CCHK(PIOF, 0), 0))
+      {
+        Return ()
+      }
+
+      // Save Endpoint Link Control register, Subsystem VendorID & Device ID, Link capability Data
+      If (LEqual(Arg0, 0)) //PEG60
+      {
+        Store(LCT0, ELC0)
+        Store(S0VI, H0VI)
+        Store(S0DI, H0DI)
+        Store(LCP0, ECP0)
+      }
+      ElseIf (LEqual(Arg0, 1)) //PEG10
+      {
+        Store(LCT1, ELC1)
+        Store(S1VI, H1VI)
+        Store(S1DI, H1DI)
+        Store(LCP1, ECP1)
+      }
+      ElseIf (LEqual(Arg0, 2)) //PEG11
+      {
+        Store(LCT2, ELC2)
+        Store(S2VI, H2VI)
+        Store(S2DI, H2DI)
+        Store(LCP2, ECP2)
+      }
+      ElseIf (LEqual(Arg0, 3)) //PEG12
+      {
+        Store(LCT3, ELC3)
+        Store(S3VI, H3VI)
+        Store(S3DI, H3DI)
+        Store(LCP3, ECP3)
+      }
+
+      //\_SB.PC00.PEG0.SAVR()
+
+      // Put link in L2
+      RTDS()
+
+      /// assert CLK_REQ MSK
+      ///
+      /// On RTD3 entry, BIOS will instruct the PMC to disable source clocks.
+      /// This is done through sending a PMC IPC command.
+      ///
+      PGSC(Arg0, 0)
+
+      //Power-off the Endpoint
+      GPPR(PIOF, 0)
+      //Method to set Wake GPIO ownership from GPIO to ACPI for Device Initiated RTD3
+      DIWK(PIOF)
+
+      Return ()
+    } // End of Method(PGOF,1,Serialized)
+
+
+    //
+    // Name: GDEV
+    // Description: Function to return the PEG device no for the given PEG index
+    // Input: Arg0 -> PEG index
+    // Return: PEG device no for the given PEG index
+    //
+    Method(GDEV,1)
+    {
+      If(LEqual(Arg0, 0))
+      {
+        Store(0x6, Local0) //Device6-Function0 = 00110.000
+      }
+      ElseIf(LEqual(Arg0, 1))
+      {
+        Store(0x1, Local0) //Device1-Function0 = 00001.000
+      }
+      ElseIf(LEqual(Arg0, 2))
+      {
+        Store(0x1, Local0) //Device1-Function2 = 00001.001
+      }
+      ElseIf(LEqual(Arg0, 3))
+      {
+        Store(0x1, Local0) //Device1-Function3 = 00001.010
+      }
+
+      Return(Local0)
+    } // End of Method(GDEV,1)
+
+    //
+    // Name: GFUN
+    // Description: Function to return the PEG function no for the given PEG index
+    // Input: Arg0 -> PEG index
+    // Return: PEG function no for the given PEG index
+    //
+    Method(GFUN,1)
+    {
+      If(LEqual(Arg0, 0))
+      {
+        Store(0x0, Local0) //Device6-Function0 = 00110.000
+      }
+      ElseIf(LEqual(Arg0, 1))
+      {
+        Store(0x0, Local0) //Device1-Function0 = 00001.000
+      }
+      ElseIf(LEqual(Arg0, 2))
+      {
+        Store(0x1, Local0) //Device1-Function1 = 00001.001
+      }
+      ElseIf(LEqual(Arg0, 2))
+      {
+        Store(0x2, Local0) //Device1-Function2 = 00001.010
+      }
+
+      Return(Local0)
+    } // End of Method(GFUN,1)
+
+    //
+    // Name: CCHK
+    // Description: Function to check whether _ON/_OFF sequence is allowed to execute for the given PEG controller or not
+    // Input: Arg0 -> PEG index
+    //        Arg1 -> 0 means _OFF sequence, 1 means _ON sequence
+    // Return: 0 - Don't execute the flow, 1 - Execute the flow
+    //
+    Method(CCHK,2)
+    {
+
+      //Check for Referenced PEG controller is present or not
+      If(LEqual(Arg0, 0))
+      {
+        Store(P0VI, Local7)
+      }
+      ElseIf(LEqual(Arg0, 1))
+      {
+        Store(P1VI, Local7)
+      }
+      ElseIf(LEqual(Arg0, 2))
+      {
+        Store(P2VI, Local7)
+      }
+      ElseIf(LEqual(Arg0, 3))
+      {
+        Store(P3VI, Local7)
+      }
+
+      If(LEqual(Local7, IVID))
+      {
+        Return(0)
+      }
+
+      If(LNotEqual(Arg0, 1))
+      {
+        //Check for PEG10 controller presence
+        Store(P1VI, Local7)
+        If(LEqual(Local7, IVID))
+        {
+          Return(0)
+        }
+      }
+
+      //If Endpoint is not present[already disabled] before executing PGOF then don't call the PGOF method
+      //If Endpoint is present[already enabled] before executing PGON then don't call the PGON method
+      If(LEqual(Arg1, 0))
+      {
+        //_OFF sequence condition check
+        If(LEqual(Arg0, 0))
+        {
+          If(LEqual(SGPI(SGGP, PWE0, PWG0, PWA0), 0))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 1))
+        {
+          If(LEqual(SGPI(P1GP, PWE1, PWG1, PWA1), 0))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 2))
+        {
+          If(LEqual(SGPI(P2GP, PWE2, PWG2, PWA2), 0))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 3))
+        {
+          If(LEqual(SGPI(P3GP, PWE3, PWG3, PWA3), 0))
+          {
+            Return(0)
+          }
+        }
+      }
+      ElseIf(LEqual(Arg1, 1))
+      {
+        //_ON sequence condition check
+        If(LEqual(Arg0, 0))
+        {
+          If(LEqual(SGPI(SGGP, PWE0, PWG0, PWA0), 1))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 1))
+        {
+          If(LEqual(SGPI(P1GP, PWE1, PWG1, PWA1), 1))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 2))
+        {
+          If(LEqual(SGPI(P2GP, PWE2, PWG2, PWA2), 1))
+          {
+            Return(0)
+          }
+        }
+        If(LEqual(Arg0, 3))
+        {
+          If(LEqual(SGPI(P3GP, PWE3, PWG3, PWA3), 1))
+          {
+            Return(0)
+          }
+        }
+      }
+
+      Return(1)
+    }
+
+
+    //
+    // Name: SGPI [PCIe GPIO Read]
+    // Description: Function to Read from PCIe GPIO
+    // Input: Arg0 -> Gpio Support
+    //        Arg1 -> Expander Number
+    //        Arg2 -> Gpio Number
+    //        Arg3 -> Active Information
+    // Return: GPIO value
+    //
+    Method(SGPI, 4, Serialized)
+    {
+      If (LEqual(Arg0, 0x01))
+      {
+        //
+        // PCH based GPIO
+        //
+        If (CondRefOf(\_SB.GGOV))
+        {
+          Store(\_SB.GGOV(Arg2), Local0)
+        }
+      }
+      //
+      // Invert if Active Low
+      //
+      If (LEqual(Arg3,0))
+      {
+        Not(Local0, Local0)
+        And (Local0, 0x01, Local0)
+      }
+
+      Return(Local0)
+    }// End of Method(SGPI)
+
+    // Name: PGSC [PEG port source clock control]
+    // Description: Function to enable/disable PEG port source clocks
+    // Input: Arg0 -> PEG index
+    //        Arg1 -> Enable/Disable Clock (0 = Disable, 1 = Enable)
+    // Return: Nothing
+    //
+
+    Method(PGSC, 2, Serialized)
+    {
+      If(LEqual(Arg0, 0)) { // PEG0
+        Store (P0SC, Local0)
+      } ElseIf(LEqual(Arg0, 1)) { // PEG1
+        Store (P1SC, Local0)
+      } ElseIf(LEqual(Arg0, 2)) { // PEG2
+        Store (P2SC, Local0)
+      } ElseIf(LEqual(Arg0, 3)) {// PEG3
+        Store (P3SC, Local0)
+      } Else {
+        Return()
+      }
+
+      SPCO (Local0, Arg1)
+    }// End of Method(PGSC)
+
+    //
+    // Name: GPPR
+    // Description: Function to do Endpoint ON/OFF using GPIOs
+    //              There are two GPIOs currently used to control Third Party Vendor[TPV] DGPU Endpoint devices:
+    //              (1) DGPU_PWR_EN [used for Power control]
+    //              (2) DGPU_HOLD_RST[used for Reset control]
+    // Input: Arg0 -> PEG index
+    //        Arg1 -> 0 means _OFF sequence, 1 means _ON sequence
+    // Return: Nothing
+    //
+    Method(GPPR,2)
+    {
+
+      If(LEqual(Arg1, 0))
+      {
+        //_OFF sequence GPIO programming
+        If(LEqual(Arg0, 0))
+        {
+          SGPO(SGGP, HRE0, HRG0, HRA0, 1) // Assert PCIe0/dGPU_HOLD_RST# (PERST#)
+          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms after Assert the Reset
+          SGPO(SGGP, PWE0, PWG0, PWA0, 0) // Deassert PCIe0/dGPU_PWR_EN#
+        }
+
+        If(LEqual(Arg0, 1))
+        {
+          SGPO(P1GP, HRE1, HRG1, HRA1, 1) // Assert PCIe1_HOLD_RST# (PERST#)
+          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms after Assert the Reset
+          SGPO(P1GP, PWE1, PWG1, PWA1, 0) // Deassert PCIe1_PWR_EN#
+        }
+
+        If(LEqual(Arg0, 2))
+        {
+          SGPO(P2GP, HRE2, HRG2, HRA2, 1) // Assert PCIe2_HOLD_RST# (PERST#)
+          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms after Assert the Reset
+          SGPO(P2GP, PWE2, PWG2, PWA2, 0) // Deassert PCIe2_PWR_EN#
+        }
+
+        If(LEqual(Arg0, 3))
+        {
+          SGPO(P3GP, HRE3, HRG3, HRA3, 1) // Assert PCIe3_HOLD_RST# (PERST#)
+          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms after Assert the Reset
+          SGPO(P3GP, PWE3, PWG3, PWA3, 0) // Deassert PCIe2_PWR_EN#
+        }
+      }
+      ElseIf(LEqual(Arg1, 1))
+      {
+        //_ON sequence GPIO programming
+        If(LEqual(Arg0, 0))
+        {
+          SGPO(SGGP, PWE0, PWG0, PWA0, 1) //Assert dGPU_PWR_EN#
+
+          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
+          SGPO(SGGP, HRE0, HRG0, HRA0, 0) //Deassert dGPU_HOLD_RST# as per the PCIe spec
+
+          //Sleep(DLHR) // Wait for 'given'ms after Deassert
+        }
+
+        If(LEqual(Arg0, 1))
+        {
+          SGPO(P1GP, PWE1, PWG1, PWA1, 1) //Assert dGPU_PWR_EN#
+
+          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
+          SGPO(P1GP, HRE1, HRG1, HRA1, 0) //Deassert dGPU_HOLD_RST# as per the PCIe spec
+
+          //Sleep(DLHR) // Wait for 'given'ms after Deassert
+        }
+
+        If(LEqual(Arg0, 2))
+        {
+          SGPO(P2GP, PWE2, PWG2, PWA2, 1) //Assert dGPU_PWR_EN#
+
+          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
+          SGPO(P2GP, HRE2, HRG2, HRA2, 0) //Deassert dGPU_HOLD_RST# as per the PCIe spec
+
+          //Sleep(DLHR) // Wait for 'given'ms after Deassert
+        }
+
+        If(LEqual(Arg0, 3))
+        {
+          SGPO(P3GP, PWE3, PWG3, PWA3, 1) //Assert dGPU_PWR_EN#
+
+          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
+          SGPO(P3GP, HRE3, HRG3, HRA3, 0) //Deassert dGPU_HOLD_RST# as per the PCIe spec
+
+          //Sleep(DLHR) // Wait for 'given'ms after Deassert
+        }
+      }
+    } // End of Method(GPPR,2)
+
+    //
+    // Name: SGPO [PCIe GPIO Write]
+    // Description: Function to write into PCIe GPIO
+    // Input: Arg0 -> Gpio Support
+    //        Arg1 -> Expander Number
+    //        Arg2 -> Gpio Number
+    //        Arg3 -> Active Information
+    //        Arg4 -> Value to write
+    // Return: Nothing
+    //
+
+    Method(SGPO, 5, Serialized)
+    {
+      //
+      // Invert if Active Low
+      //
+      If (LEqual(Arg3,0))
+      {
+        Not(Arg4, Arg4)
+        And(Arg4, 0x01, Arg4)
+      }
+      If (LEqual(Arg0, 0x01))
+      {
+        //
+        // PCH based GPIO
+        //
+        If (CondRefOf(\_SB.SGOV))
+        {
+          \_SB.SGOV(Arg2, Arg4)
+        }
+      }
+    } // End of Method(SGPO)
+
+    //
+    // Name: DIWK
+    // Description: Function which set the GPIO ownership to ACPI for device initiated RTD3
+    // Input: PEG Index
+    // Return: Nothing
+    //
+    Method(DIWK,1)
+    {
+      If (LEqual(Arg0, 0))
+      {
+        \_SB.PC00.PEG0.P0EW()
+      }
+      ElseIf (LEqual(Arg0, 1))
+      {
+        \_SB.PC00.PEG1.P1EW()
+      }
+      ElseIf (LEqual(Arg0, 2))
+      {
+        \_SB.PC00.PEG2.P2EW()
+      }
+      ElseIf (LEqual(Arg0, 3))
+      {
+        \_SB.PC00.PEG3.P3EW()
+      }
+    }
+  }// End of Scope (\_SB.PC00)
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3.asl
new file mode 100644
index 0000000000..b5d1a4e35e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3.asl
@@ -0,0 +1,124 @@
+/** @file
+  This file contains the device definitions of the SystemAgent
+  PCIE ACPI Reference Code.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+Scope (\_SB.PC00) {
+
+  OperationRegion(PXCS,PCI_Config,0x00,0x480)
+  Field(PXCS,AnyAcc, NoLock, Preserve)
+  {
+    Offset(0),
+    VDID, 32,
+    Offset(0x50), // LCTL - Link Control Register
+    L0SE, 1,      // 0, L0s Entry Enabled
+    , 3,
+    LDIS, 1,
+    , 3,
+    Offset(0x52), // LSTS - Link Status Register
+    , 13,
+    LASX, 1,      // 0, Link Active Status
+    Offset(0x5A), // SLSTS[7:0] - Slot Status Register
+    ABPX, 1,      // 0, Attention Button Pressed
+    , 2,
+    PDCX, 1,      // 3, Presence Detect Changed
+    , 2,
+    PDSX, 1,      // 6, Presence Detect State
+    , 1,
+    Offset(0x60), // RSTS - Root Status Register
+    , 16,
+    PSPX, 1,      // 16,  PME Status
+    Offset(0xA4),
+    D3HT, 2,      // Power State
+    Offset(0xD8), // 0xD8, MPC - Miscellaneous Port Configuration Register
+    , 30,
+    HPEX, 1,      // 30,  Hot Plug SCI Enable
+    PMEX, 1,      // 31,  Power Management SCI Enable
+    Offset(0xE0), // 0xE0, SPR - Scratch Pad Register
+    , 0,
+    SCB0, 1,      // Sticky Scratch Pad Bit SCB0
+    Offset(0xE2), // 0xE2, RPPGEN - Root Port Power Gating Enable
+    , 2,
+    L23E, 1,       // 2,   L23_Rdy Entry Request (L23ER)
+    L23R, 1,       // 3,   L23_Rdy to Detect Transition (L23R2DT)
+    Offset(0x324), // 0x324 - PCIEDBG
+    , 3,
+    LEDM, 1,       // PCIEDBG.DMIL1EDM
+    Offset(0x328), // 0x328 - PCIESTS1
+    , 24,
+    LTSM, 8,
+  }
+  Field(PXCS,AnyAcc, NoLock, WriteAsZeros)
+  {
+    Offset(0xDC), // 0xDC, SMSCS - SMI/SCI Status Register
+    , 30,
+    HPSX, 1,      // 30,  Hot Plug SCI Status
+    PMSX, 1       // 31,  Power Management SCI Status
+  }
+
+    //
+    // Name: RTEN
+    // Description: Function to Enable the link for RTD3 [RCTL.L22DT]
+    // Input: PEG Index
+    // Return: Nothing
+    //
+    Method(RTEN, 0, Serialized)
+    {
+      If (LNotEqual (SCB0,0x1)) {
+        Return ()
+      }
+
+      /// Set L23_Rdy to Detect Transition  (L23R2DT)
+      Store(1, L23R)
+      Store(0, Local0)
+      /// Wait for transition to Detect
+      While(L23R) {
+        If(Lgreater(Local0, 4))
+        {
+          Break
+        }
+        Sleep(16)
+        Increment(Local0)
+      }
+      Store(0,SCB0)
+
+      /// Once in Detect, wait up to 124 ms for Link Active (typically happens in under 70ms)
+      /// Worst case per PCIe spec from Detect to Link Active is:
+      /// 24ms in Detect (12+12), 72ms in Polling (24+48), 28ms in Config (24+2+2+2+2)
+      Store(0, Local0)
+      While(LEqual(LASX,0)) {
+        If(Lgreater(Local0, 8))
+        {
+          Break
+        }
+        Sleep(16)
+        Increment(Local0)
+      }
+    }
+
+    //
+    // Name: RTDS
+    // Description: Function to Disable link for RTD3 [RCTL.L23ER]
+    // Input: PEG Index
+    // Return: Nothing
+    //
+    Method(RTDS, 0, Serialized)
+    {
+      Store(1, L23E)
+      Sleep(16)
+      Store(0, Local0)
+      While(L23E) {
+        If(Lgreater(Local0, 4))
+        {
+          Break
+        }
+        Sleep(16)
+        Increment(Local0)
+      }
+      Store(1,SCB0)
+    }
+
+} // End of Scope (\_SB.PC00)
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
new file mode 100644
index 0000000000..5228d9d753
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
@@ -0,0 +1,26 @@
+/** @file
+  This file contains the device definition of the System Agent
+  ACPI reference code.
+  Currently defines the device objects for the
+  System Agent PCI Express* ports (PEG), iGfx and other devices.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+External(\HGMD)
+External(\HGST)
+External(\_SB.PC00, DeviceObj)
+External(\_SB.PC00.GFX0, DeviceObj)
+External(\_SB.PC00.IPU0, DeviceObj)
+External(\_SB.PC00.B0D3, DeviceObj)
+External(\_SB.PC00.PCIC, MethodObj)
+External(\_SB.PC00.PCID, MethodObj)
+///
+/// CPU PCIe Root Port
+///
+include("CpuPcieRp.asl")
+include("PegCommon.asl")
+If(LAnd((LEqual(HGMD,2)), (LEqual(HGST,1)))) {
+  include("PegRtd3.asl")
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.asl b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.asl
new file mode 100644
index 0000000000..0494c659e0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.asl
@@ -0,0 +1,20 @@
+/** @file
+  This file contains the SystemAgent SSDT Table ASL code.
+  It defines a Global NVS table which exchanges datas between OS
+  and BIOS.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+DefinitionBlock (
+  "SaSsdt.aml",
+  "SSDT",
+  0x02,
+  "SaSsdt",
+  "SaSsdt ",
+  0x3000
+  )
+{
+  Include ("Sa.asl")
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf
new file mode 100644
index 0000000000..d0d1494b99
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf
@@ -0,0 +1,22 @@
+## @file
+#  Component description file for the ACPI tables
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION          = 0x00010005
+BASE_NAME            = SaSsdt
+FILE_GUID            = ca89914d-2317-452e-b245-36c6fb77a9c6
+MODULE_TYPE          = USER_DEFINED
+VERSION_STRING       = 1.0
+
+[Sources]
+  SaSsdt.asl
+
+
+[Packages]
+  MdePkg/MdePkg.dec
+  TigerlakeSiliconPkg/SiPkg.dec
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.c
new file mode 100644
index 0000000000..d33c20605a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.c
@@ -0,0 +1,264 @@
+/** @file
+  This file provide services for DXE phase policy default initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include "DxeSaPolicyLibrary.h"
+#include <Library/DxeGraphicsPolicyLib.h>
+#include <Library/DxeVtdPolicyLib.h>
+#include <Register/SaRegsHostBridge.h>
+
+extern EFI_GUID gMemoryDxeConfigGuid;
+extern EFI_GUID gPcieDxeConfigGuid;
+
+/**
+  This function prints the SA DXE phase policy.
+
+  @param[in] SaPolicy - SA DXE Policy protocol
+**/
+VOID
+SaPrintPolicyProtocol (
+  IN  SA_POLICY_PROTOCOL      *SaPolicy
+  )
+{
+  EFI_STATUS                  Status;
+  PCIE_DXE_CONFIG             *PcieDxeConfig;
+  MEMORY_DXE_CONFIG           *MemoryDxeConfig;
+
+  //
+  // Get requisite IP Config Blocks which needs to be used here
+  //
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gPcieDxeConfigGuid, (VOID *)&PcieDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = GetConfigBlock ((VOID *) SaPolicy, &gMemoryDxeConfigGuid, (VOID *)&MemoryDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+
+  DEBUG_CODE_BEGIN ();
+  INTN  i;
+
+  DEBUG ((DEBUG_INFO, "\n------------------------ SA Policy (DXE) print BEGIN -----------------\n"));
+  DEBUG ((DEBUG_INFO, "Revision : %x\n", SaPolicy->TableHeader.Header.Revision));
+  ASSERT (SaPolicy->TableHeader.Header.Revision == SA_POLICY_PROTOCOL_REVISION);
+
+  DEBUG ((DEBUG_INFO, "------------------------ SA_MEMORY_CONFIGURATION -----------------\n"));
+  //@todo: Matching the hardcode at lines 384.  Need to be addressed.
+  DEBUG ((DEBUG_INFO, " SpdAddressTable[%d] :", 4));
+  for (i = 0; i < 4; i++) {
+    DEBUG ((DEBUG_INFO, " %x", MemoryDxeConfig->SpdAddressTable[i]));
+  }
+  DEBUG ((DEBUG_INFO, "\n"));
+
+  DEBUG ((DEBUG_INFO, " ChannelASlotMap : %x\n", MemoryDxeConfig->ChannelASlotMap));
+  DEBUG ((DEBUG_INFO, " ChannelBSlotMap : %x\n", MemoryDxeConfig->ChannelBSlotMap));
+  DEBUG ((DEBUG_INFO, " MrcTimeMeasure  : %x\n", MemoryDxeConfig->MrcTimeMeasure));
+  DEBUG ((DEBUG_INFO, " MrcFastBoot     : %x\n", MemoryDxeConfig->MrcFastBoot));
+
+  DEBUG ((DEBUG_INFO, "------------------------ CPU_PCIE_CONFIGURATION -----------------\n"));
+  DEBUG ((DEBUG_INFO, " PegAspm[%d] :", SA_PEG_MAX_FUN));
+  for (i = 0; i < SA_PEG_MAX_FUN; i++) {
+    DEBUG ((DEBUG_INFO, " %x", PcieDxeConfig->PegAspm[i]));
+  }
+  DEBUG ((DEBUG_INFO, "\n"));
+
+  DEBUG ((DEBUG_INFO, " PegRootPortHPE[%d] :", SA_PEG_MAX_FUN));
+  for (i = 0; i < SA_PEG_MAX_FUN; i++) {
+    DEBUG ((DEBUG_INFO, " %x", PcieDxeConfig->PegRootPortHPE[i]));
+  }
+  DEBUG ((DEBUG_INFO, "\n"));
+
+
+  DEBUG ((DEBUG_INFO, "\n------------------------ SA Policy (DXE) print END -----------------\n"));
+  DEBUG_CODE_END ();
+
+  return;
+}
+
+/**
+  Load DXE Config block default for PCIe
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+LoadPcieDxeDefault (
+  IN VOID    *ConfigBlockPointer
+  )
+{
+  UINT8                  Index;
+  PCIE_DXE_CONFIG        *PcieDxeConfig;
+
+  PcieDxeConfig = ConfigBlockPointer;
+  DEBUG ((DEBUG_INFO, "PcieDxeConfig->Header.GuidHob.Name = %g\n", &PcieDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "PcieDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", PcieDxeConfig->Header.GuidHob.Header.HobLength));
+  ///
+  /// Initialize the PCIE Configuration
+  /// PEG ASPM per port configuration. 4 PEG controllers i.e. 0,1,2,3
+  ///
+  for (Index = 0; Index < SA_PEG_MAX_FUN; Index++) {
+    PcieDxeConfig->PegAspm[Index]       = CpuPcieAspmAutoConfig;
+  }
+
+  for (Index = 0; Index < SA_PEG_MAX_FUN; Index++) {
+    PcieDxeConfig->PegPwrOpt[Index].LtrEnable            = 1;
+    PcieDxeConfig->PegPwrOpt[Index].LtrMaxSnoopLatency   = V_SA_LTR_MAX_SNOOP_LATENCY_VALUE;
+    PcieDxeConfig->PegPwrOpt[Index].LtrMaxNoSnoopLatency = V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE;
+    PcieDxeConfig->PegPwrOpt[Index].ObffEnable           = 1;
+  }
+}
+
+
+/**
+  Load DXE Config block default
+
+  @param[in] ConfigBlockPointer         Pointer to config block
+**/
+VOID
+LoadMemoryDxeDefault (
+  IN VOID    *ConfigBlockPointer
+  )
+{
+  MEMORY_DXE_CONFIG        *MemoryDxeConfig;
+
+  MemoryDxeConfig = ConfigBlockPointer;
+  DEBUG ((DEBUG_INFO, "MemoryDxeConfig->Header.GuidHob.Name = %g\n", &MemoryDxeConfig->Header.GuidHob.Name));
+  DEBUG ((DEBUG_INFO, "MemoryDxeConfig->Header.GuidHob.Header.HobLength = 0x%x\n", MemoryDxeConfig->Header.GuidHob.Header.HobLength));
+  ///
+  /// Initialize the Memory Configuration
+  ///
+  ///
+  /// DIMM SMBus addresses info
+  /// Refer to the SpdAddressTable[] mapping rule in DxeSaPolicyLibrary.h
+  ///
+  MemoryDxeConfig->SpdAddressTable = AllocateZeroPool (sizeof (UINT8) * 4);
+  ASSERT (MemoryDxeConfig->SpdAddressTable != NULL);
+  if (MemoryDxeConfig->SpdAddressTable != NULL) {
+    MemoryDxeConfig->SpdAddressTable[0] = DIMM_SMB_SPD_P0C0D0;
+    MemoryDxeConfig->SpdAddressTable[1] = DIMM_SMB_SPD_P0C0D1;
+    MemoryDxeConfig->SpdAddressTable[2] = DIMM_SMB_SPD_P0C1D0;
+    MemoryDxeConfig->SpdAddressTable[3] = DIMM_SMB_SPD_P0C1D1;
+  }
+  MemoryDxeConfig->ChannelASlotMap = 0x01;
+  MemoryDxeConfig->ChannelBSlotMap = 0x01;
+}
+
+/**
+  LoadSaDxeConfigBlockDefault - Initialize default settings for each SA Config block
+
+  @param[in] ConfigBlockPointer         The buffer pointer that will be initialized as specific config block
+  @param[in] BlockId                    Request to initialize defaults of specified config block by given Block ID
+
+  @retval EFI_SUCCESS                   The given buffer has contained the defaults of requested config block
+  @retval EFI_NOT_FOUND                 Block ID is not defined so no default Config block will be initialized
+**/
+
+GLOBAL_REMOVE_IF_UNREFERENCED COMPONENT_BLOCK_ENTRY  mSaDxeIpBlocks [] = {
+  {&gPcieDxeConfigGuid,     sizeof (PCIE_DXE_CONFIG),     PCIE_DXE_CONFIG_REVISION,      LoadPcieDxeDefault},
+  {&gMemoryDxeConfigGuid,   sizeof (MEMORY_DXE_CONFIG),   MEMORY_DXE_CONFIG_REVISION,    LoadMemoryDxeDefault}
+};
+
+
+/**
+  CreateSaDxeConfigBlocks generates the config blocksg of SA DXE Policy.
+  It allocates and zero out buffer, and fills in the Intel default settings.
+
+  @param[out] SaPolicy               The pointer to get SA  DXE Protocol instance
+
+  @retval EFI_SUCCESS                   The policy default is initialized.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+**/
+EFI_STATUS
+EFIAPI
+CreateSaDxeConfigBlocks (
+  IN OUT  SA_POLICY_PROTOCOL      **SaPolicy
+  )
+{
+  UINT16              TotalBlockSize;
+  EFI_STATUS          Status;
+  SA_POLICY_PROTOCOL  *SaInitPolicy;
+  UINT16              RequiredSize;
+
+  DEBUG ((DEBUG_INFO, "SA Create Dxe Config Blocks\n"));
+
+  SaInitPolicy = NULL;
+
+  TotalBlockSize = GetComponentConfigBlockTotalSize (&mSaDxeIpBlocks[0], sizeof (mSaDxeIpBlocks) / sizeof (COMPONENT_BLOCK_ENTRY));
+  TotalBlockSize += VtdGetConfigBlockTotalSizeDxe ();
+  TotalBlockSize += GraphicsGetConfigBlockTotalSizeDxe ();
+  DEBUG ((DEBUG_INFO, "TotalBlockSize = 0x%x\n", TotalBlockSize));
+
+  RequiredSize = sizeof (CONFIG_BLOCK_TABLE_HEADER) + TotalBlockSize;
+
+  Status = CreateConfigBlockTable (RequiredSize, (VOID *) &SaInitPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Initialize Policy Revision
+  //
+  SaInitPolicy->TableHeader.Header.Revision = SA_POLICY_PROTOCOL_REVISION;
+  //
+  // Add config blocks.
+  //
+  Status =  AddComponentConfigBlocks ((VOID *) SaInitPolicy, &mSaDxeIpBlocks[0], sizeof (mSaDxeIpBlocks) / sizeof (COMPONENT_BLOCK_ENTRY));
+  ASSERT_EFI_ERROR (Status);
+
+  // Vtd
+  Status = VtdAddConfigBlocksDxe((VOID *) SaInitPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  // Gfx
+  Status = GraphicsAddConfigBlocksDxe ((VOID *) SaInitPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Assignment for returning SaInitPolicy config block base address
+  //
+  *SaPolicy = SaInitPolicy;
+  return Status;
+}
+
+
+/**
+  SaInstallPolicyProtocol installs SA Policy.
+  While installed, RC assumes the Policy is ready and finalized. So please update and override
+  any setting before calling this function.
+
+  @param[in] ImageHandle                Image handle of this driver.
+  @param[in] SaPolicy                   The pointer to SA Policy Protocol instance
+
+  @retval EFI_SUCCESS                   The policy is installed.
+  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create buffer
+
+**/
+EFI_STATUS
+EFIAPI
+SaInstallPolicyProtocol (
+  IN  EFI_HANDLE                  ImageHandle,
+  IN  SA_POLICY_PROTOCOL         *SaPolicy
+  )
+{
+  EFI_STATUS            Status;
+
+  ///
+  /// Print SA DXE Policy
+  ///
+  SaPrintPolicyProtocol (SaPolicy);
+  GraphicsDxePolicyPrint (SaPolicy);
+  VtdPrintPolicyDxe (SaPolicy);
+
+  ///
+  /// Install protocol to to allow access to this Policy.
+  ///
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gSaPolicyProtocolGuid,
+                  SaPolicy,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.inf
new file mode 100644
index 0000000000..8af3d09b80
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.inf
@@ -0,0 +1,48 @@
+## @file
+# Component description file for the PeiSaPolicy library.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeSaPolicyLib
+FILE_GUID = B402A3A4-4B82-410E-B79C-5914880A05E7
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = DxeSaPolicyLib
+
+
+[LibraryClasses]
+BaseMemoryLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+PostCodeLib
+ConfigBlockLib
+HobLib
+DxeGraphicsPolicyLib
+DxeVtdPolicyLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+DxeSaPolicyLib.c
+DxeSaPolicyLibrary.h
+
+
+[Guids]
+gPcieDxeConfigGuid
+gMemoryDxeConfigGuid
+
+
+[Protocols]
+gSaPolicyProtocolGuid ## PRODUCES
+
+[Pcd]
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLibrary.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLibrary.h
new file mode 100644
index 0000000000..d46dd44df3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLibrary.h
@@ -0,0 +1,34 @@
+/** @file
+  Header file for the DxeSaPolicy library.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _DXE_SA_POLICY_LIBRARY_H_
+#define _DXE_SA_POLICY_LIBRARY_H_
+
+#include <Uefi.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <CpuPcieConfigGen3.h>
+#include <CpuPcieConfig.h>
+#include <Protocol/SaPolicy.h>
+
+#define WORD_FIELD_VALID_BIT  BIT15
+#define MAX_PCIE_ASPM_OVERRIDE  500
+#define MAX_PCIE_LTR_OVERRIDE   500
+///
+/// DIMM SMBus addresses
+///
+#define DIMM_SMB_SPD_P0C0D0 0xA0
+#define DIMM_SMB_SPD_P0C0D1 0xA2
+#define DIMM_SMB_SPD_P0C1D0 0xA4
+#define DIMM_SMB_SPD_P0C1D1 0xA6
+#define DIMM_SMB_SPD_P0C0D2 0xA8
+#define DIMM_SMB_SPD_P0C1D2 0xAA
+
+#endif // _DXE_SA_POLICY_LIBRARY_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/PeiDxeSmmSaPlatformLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/PeiDxeSmmSaPlatformLib.inf
new file mode 100644
index 0000000000..0a632fc81a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/PeiDxeSmmSaPlatformLib.inf
@@ -0,0 +1,32 @@
+## @file
+# Component description file for SA Platform Lib
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmSaPlatformLib
+FILE_GUID = 9DB5ACB4-DB23-43AE-A283-2ABEF365CBE0
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = SaPlatformLib
+
+
+[LibraryClasses]
+BaseLib
+BaseMemoryLib
+DebugLib
+IoLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+SaPlatformLibrary.h
+SaPlatformLibrary.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.c
new file mode 100644
index 0000000000..42902d795c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.c
@@ -0,0 +1,68 @@
+/** @file
+  SA Platform Lib implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "SaPlatformLibrary.h"
+#include <Library/PciSegmentLib.h>
+#include <IndustryStandard/Pci22.h>
+#include <CpuPcieInfo.h>
+
+
+/**
+  Checks if SKU is Mobile
+
+  @retval FALSE  SKU is not Mobile
+  @retval TRUE   SKU is Mobile
+**/
+BOOLEAN
+EFIAPI
+IsMobileSku (
+  VOID
+  )
+{
+  UINT16           DeviceId;
+
+  DeviceId = PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, SA_MC_DEV, SA_MC_FUN, R_SA_MC_DEVICE_ID));
+  if (
+      (DeviceId == V_SA_DEVICE_ID_MB_ULT_1) || \
+      (DeviceId == V_SA_DEVICE_ID_MB_ULT_2) || \
+      (DeviceId == V_SA_DEVICE_ID_MB_ULX_1) || \
+      (DeviceId == V_SA_DEVICE_ID_MB_ULX_2) \
+    ) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Checks if SKU is Desktop
+
+  @retval FALSE  SKU is not Desktop
+  @retval TRUE   SKU is Desktop
+**/
+BOOLEAN
+EFIAPI
+IsDesktopSku (
+  VOID
+  )
+{
+  return FALSE;
+}
+
+/**
+  Checks if SKU is Server
+
+  @retval FALSE  SKU is not Server
+  @retval TRUE   SKU is Server
+**/
+BOOLEAN
+EFIAPI
+IsServerSku (
+  VOID
+  )
+{
+  return FALSE;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.h
new file mode 100644
index 0000000000..10513d0ea0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatformLib/SaPlatformLibrary.h
@@ -0,0 +1,21 @@
+/** @file
+  Header file for SA Platform Lib implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _SA_PLATFORM_LIBRARY_IMPLEMENTATION_H_
+#define _SA_PLATFORM_LIBRARY_IMPLEMENTATION_H_
+
+#include <Uefi.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Register/SaRegsHostBridge.h>
+#include <CpuAccess.h>
+#include <Library/SaPlatformLib.h>
+#include <Register/IgdRegs.h>
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd library instances
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (32 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules Heng Luo
                   ` (5 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib
  * Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/CpuPcieInfoFruLib.c            | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf | 36 ++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.c                         | 18 ++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.inf                       | 39 +++++++++++++++++++++++++++++++++++++++
 4 files changed, 174 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/CpuPcieInfoFruLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/CpuPcieInfoFruLib.c
new file mode 100644
index 0000000000..6a9bc89ecf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/CpuPcieInfoFruLib.c
@@ -0,0 +1,81 @@
+/** @file
+  CPU PCIe information library.
+
+  All function in this library is available for PEI, DXE, and SMM,
+  But do not support UEFI RUNTIME environment call.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Uefi/UefiBaseType.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Register/CpuPcieRegs.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <Library/CpuPcieInitCommon.h>
+#include <CpuPcieInfo.h>
+#include <Register/SaRegsHostBridge.h>
+#include <PcieRegs.h>
+
+/**
+  Get Maximum CPU Pcie Root Port Number
+
+  @retval Maximum CPU Pcie Root Port Number
+**/
+UINT8
+GetMaxCpuPciePortNum (
+  VOID
+  )
+{
+  return CPU_PCIE_ULT_ULX_MAX_ROOT_PORT;
+}
+
+/**
+  Get CPU Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber              Root port physical number. (0-based)
+  @param[out] RpDev                 Return corresponding root port device number.
+  @param[out] RpFun                 Return corresponding root port function number.
+
+  @retval     EFI_SUCCESS           Root port device and function is retrieved
+  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
+**/
+EFI_STATUS
+EFIAPI
+GetCpuPcieRpDevFun (
+  IN  UINTN   RpNumber,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  )
+{
+  if (RpNumber > GetMaxCpuPciePortNum ()) {
+    DEBUG ((DEBUG_ERROR, "GetCpuPcieRpDevFun invalid RpNumber %x", RpNumber));
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  //  For TGL - U/Y only one CPU PCIE Root port is present
+  //
+  *RpDev = 6;
+  *RpFun = 0;
+  return EFI_SUCCESS;
+}
+/**
+
+  Gets pci segment base address of PCIe root port.
+
+  @param RpIndex    Root Port Index (0 based)
+
+  @return PCIe port base address.
+**/
+UINT64
+CpuPcieBase (
+  IN  UINT32   RpIndex
+  )
+{
+  UINTN   RpDevice;
+  UINTN   RpFunction;
+  GetCpuPcieRpDevFun (RpIndex, &RpDevice, &RpFunction);
+  return PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, (UINT32) RpDevice, (UINT32) RpFunction, 0);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
new file mode 100644
index 0000000000..b6a40b2f7c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
@@ -0,0 +1,36 @@
+## @file
+# CPU PCIe information library for TigerLake PCH.
+#
+# All function in this library is available for PEI, DXE, and SMM,
+# But do not support UEFI RUNTIME environment call.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PeiDxeSmmCpuPcieInfoFruLib
+FILE_GUID = 59CA5352-ED46-4449-BF1C-0D0074C4D5B1
+VERSION_STRING = 1.0
+MODULE_TYPE = BASE
+LIBRARY_CLASS = CpuPcieInfoFruLib
+
+
+[LibraryClasses]
+IoLib
+BaseLib
+DebugLib
+PrintLib
+PcdLib
+ConfigBlockLib
+CpuPcieInitCommonLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Sources]
+CpuPcieInfoFruLib.c
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.c b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.c
new file mode 100644
index 0000000000..8a0a8b6335
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.c
@@ -0,0 +1,18 @@
+/** @file
+  DXE Flu Library to initialize Vtd
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Base.h>
+
+/**
+  For device that specified by Device Num and Function Num,
+  mDevEnMap is used to check device presence.
+  0x80 means use Device ID to detemine presence
+  0x8F means force to update
+
+  The structure is used to check if device scope is valid when update DMAR table
+**/
+UINT16  mDevEnMap[][2] = {{0x0200, 0x80}, {0x0500, 0x80}, {0x1400, 0x80}, {0x1401, 0x80}, {0x0700, 0x80}, {0x0701, 0x80}, {0x0702, 0x80}, {0x0703, 0x80}, {0x1302, 0x8F}, {0x1303, 0x8F}};
+UINTN   mDevEnMapSize = sizeof (mDevEnMap) / (sizeof (UINT16) * 2);
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.inf b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.inf
new file mode 100644
index 0000000000..e0aa88f68a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.inf
@@ -0,0 +1,39 @@
+## @file
+# Library description file for DXE Phase Vtd Init
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = DxeVtdInitFruLib
+FILE_GUID = 18690D67-08A9-4DCE-B62D-CBE3AF7CFEE7
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+LIBRARY_CLASS = DxeVtdFruLib
+
+
+[LibraryClasses]
+UefiLib
+UefiRuntimeServicesTableLib
+UefiBootServicesTableLib
+DebugLib
+DxeSaPolicyLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Protocols]
+gSaNvsAreaProtocolGuid                  ## CONSUMES
+
+[Sources]
+DxeVtdInitFruLib.c
+
+[FixedPcd]
+
+[Guids]
+gTcssHobGuid                            ## CONSUMES
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (33 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules Heng Luo
                   ` (4 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * Pch/PchInit/Dxe
  * Pch/PchInit/Smm
  * Pch/PchSmiDispatcher/Smm
  * Pch/SmmControl/RuntimeDxe

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c                      |  494 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c                  |   41 ++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c                   |  201 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c                      |  314 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h                      |  122 ++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c                   |  354 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf              |   96 ++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c                      |   89 ++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c                  |   33 +++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c               |  134 ++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c                     |  266 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c          |  137 +++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c                  |   33 +++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c                   |  285 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h                   |  254 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf                 |  110 +++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c                   |  451 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c                  |   67 +++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c              | 1284 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h              |  226 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatch.c      | 2442 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.inf  |  116 ++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper.h        |   40 +++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelperClient.c  |   57 ++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h              | 1043 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCore.c          |  926 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.c          | 1588 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.h          |  341 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.c           |  263 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.c       |  332 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.h       |  155 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeriodicTimer.c |  667 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPowerButton.c   |   81 +++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.c            |  381 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c            |  224 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb.c           |  230 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.c      |  778 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.h      |  107 ++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl.inf       |   54 +++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.c   |  394 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.h   |  130 +++++++++++++++++++++++++++++++++++++++++++++++++
 41 files changed, 15340 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c
new file mode 100644
index 0000000000..e88afa5ded
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c
@@ -0,0 +1,494 @@
+/** @file
+  This is the driver that initializes the Intel PCH.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/HobLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+
+#include "PchInit.h"
+#include <Protocol/PchPolicy.h>
+#include <GpioDevConfig.h>
+#include <ScsConfig.h>
+#include <Library/PchInfoLib.h>
+#include <Library/GpioLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PmcLib.h>
+#include <Library/SerialIoAccessLib.h>
+#include <Library/GbeLib.h>
+#include <PchRstHob.h>
+#include <Library/PchPcieRpLib.h>
+#include <TraceHubConfig.h>
+#include <PchReservedResources.h>
+#include <Library/PciSegmentLib.h>
+#include <Register/PchRegs.h>
+#include <Library/BaseLib.h>
+#include <Register/UsbRegs.h>
+#include <Library/PcdLib.h>
+#include <IndustryStandard/Pci22.h>
+#include <PcieRegs.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <PchHybridStorageHob.h>
+#include <Library/SataLib.h>
+
+//
+// Module variables
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA_PROTOCOL    mPchNvsAreaProtocol;
+
+/**
+  Retrieve interrupt information about a PCH device from policy
+
+  @param[in] UartNumber                 Uart number
+
+  @retval PCH_DEVICE_INTERRUPT_CONFIG   structure with device's interrupt information
+**/
+PCH_DEVICE_INTERRUPT_CONFIG
+GetUartInterrupt (
+  IN UINT8  UartNumber
+  )
+{
+  PCH_DEVICE_INTERRUPT_CONFIG EmptyRecord;
+  UINT8                       DevNum;
+  UINT8                       FuncNum;
+  UINT8                       Index;
+
+  ZeroMem (&EmptyRecord, sizeof (PCH_DEVICE_INTERRUPT_CONFIG));
+  DevNum  = SerialIoUartDevNumber (UartNumber);
+  FuncNum = SerialIoUartFuncNumber (UartNumber);
+
+  for (Index = 0; Index < mPchConfigHob->Interrupt.NumOfDevIntConfig; Index++) {
+    if ((mPchConfigHob->Interrupt.DevIntConfig[Index].Device == DevNum) &&
+        (mPchConfigHob->Interrupt.DevIntConfig[Index].Function == FuncNum)) {
+      return mPchConfigHob->Interrupt.DevIntConfig[Index];
+    }
+  }
+  return EmptyRecord;
+}
+
+/**
+  Update ASL definitions for SerialIo devices.
+
+**/
+VOID
+UpdateSerialIoAcpiData (
+  VOID
+  )
+{
+  UINT8        Index;
+
+  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
+    mPchNvsAreaProtocol.Area->SM0[Index] = mPchConfigHob->SerialIo.SpiDeviceConfig[Index].Mode;
+    mPchNvsAreaProtocol.Area->SC0[Index] = GetSerialIoSpiPciCfg (Index);
+  }
+  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
+    mPchNvsAreaProtocol.Area->IM0[Index] = mPchConfigHob->SerialIo.I2cDeviceConfig[Index].Mode;
+    mPchNvsAreaProtocol.Area->IC0[Index] = GetSerialIoI2cPciCfg (Index);
+  }
+  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++) {
+    mPchNvsAreaProtocol.Area->UM0[Index] = mPchConfigHob->SerialIo.UartDeviceConfig[Index].Mode;
+    mPchNvsAreaProtocol.Area->UC0[Index] = GetSerialIoUartPciCfg (Index);
+    mPchNvsAreaProtocol.Area->UD0[Index] = mPchConfigHob->SerialIo.UartDeviceConfig[Index].DmaEnable;
+    mPchNvsAreaProtocol.Area->UP0[Index] = mPchConfigHob->SerialIo.UartDeviceConfig[Index].PowerGating;
+    mPchNvsAreaProtocol.Area->UI0[Index] = (GetUartInterrupt (Index)).Irq;
+  }
+}
+
+#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
+/**
+  Update NVS Area for Timed GPIO devices.
+**/
+VOID
+UpdateTimedGpioSetup (
+  VOID
+  )
+{
+  mPchNvsAreaProtocol.Area->EnableTimedGpio0 = (UINT8)mPchConfigHob->Pm.EnableTimedGpio0;
+  mPchNvsAreaProtocol.Area->EnableTimedGpio1 = (UINT8)mPchConfigHob->Pm.EnableTimedGpio1;
+}
+#endif
+
+/**
+  Update NVS Area after RST PCIe Storage Remapping and before Boot
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_NOT_FOUND           Couldn't fetch RstHob
+**/
+EFI_STATUS
+PchUpdateNvsAreaAfterRemapping (
+  VOID
+  )
+{
+  UINTN                 Index;
+  VOID                  *Hob;
+  PCH_RST_HOB           *RstHob;
+
+  Hob = GetFirstGuidHob (&gPchRstHobGuid);
+  if (Hob == NULL) {
+    return EFI_NOT_FOUND;
+  }
+
+  RstHob = (PCH_RST_HOB *) GET_GUID_HOB_DATA (Hob);
+
+  for (Index = 0; Index < PCH_MAX_RST_PCIE_STORAGE_CR; Index++) {
+    mPchNvsAreaProtocol.Area->RstPcieStorageInterfaceType[Index]        = RstHob->RstCrConfiguration[Index].DeviceInterface;
+    mPchNvsAreaProtocol.Area->RstPcieStoragePmCapPtr[Index]             = RstHob->SavedRemapedDeviceConfigSpace[Index].PmCapPtr;
+    mPchNvsAreaProtocol.Area->RstPcieStoragePcieCapPtr[Index]           = RstHob->SavedRemapedDeviceConfigSpace[Index].PcieCapPtr;
+    mPchNvsAreaProtocol.Area->RstPcieStorageL1ssCapPtr[Index]           = RstHob->SavedRemapedDeviceConfigSpace[Index].L1ssCapPtr;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpL1ssControl2[Index]       = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointL1ssControl2;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpL1ssControl1[Index]       = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointL1ssControl1;
+    mPchNvsAreaProtocol.Area->RstPcieStorageLtrCapPtr[Index]            = RstHob->SavedRemapedDeviceConfigSpace[Index].LtrCapPtr;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpLtrData[Index]            = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointLtrData;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpLctlData16[Index]         = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointLctlData16;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpDctlData16[Index]         = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointDctlData16;
+    mPchNvsAreaProtocol.Area->RstPcieStorageEpDctl2Data16[Index]        = RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointDctl2Data16;
+    mPchNvsAreaProtocol.Area->RstPcieStorageRpDctl2Data16[Index]        = RstHob->SavedRemapedDeviceConfigSpace[Index].RootPortDctl2Data16;
+    mPchNvsAreaProtocol.Area->RstPcieStorageUniqueTableBar[Index]       = RstHob->RstCrConfiguration[Index].EndPointUniqueMsixTableBar;
+    mPchNvsAreaProtocol.Area->RstPcieStorageUniqueTableBarValue[Index]  = RstHob->RstCrConfiguration[Index].EndPointUniqueMsixTableBarValue;
+    mPchNvsAreaProtocol.Area->RstPcieStorageUniquePbaBar[Index]         = RstHob->RstCrConfiguration[Index].EndPointUniqueMsixPbaBar;
+    mPchNvsAreaProtocol.Area->RstPcieStorageUniquePbaBarValue[Index]    = RstHob->RstCrConfiguration[Index].EndPointUniqueMsixPbaBarValue;
+    mPchNvsAreaProtocol.Area->RstPcieStorageRootPortNum[Index]          = RstHob->RstCrConfiguration[Index].RootPortNum;
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Update the Hybrid storage location NVS Area if Hybrid Storage device is present
+**/
+EFI_STATUS
+UpdateHybridStorageLocation (
+  VOID
+  )
+{
+  VOID                               *Hob;
+  PCH_HYBRIDSTORAGE_HOB              *HybridStorageHob;
+
+  Hob = GetFirstGuidHob (&gHybridStorageHobGuid);
+  if (Hob == NULL) {
+    return EFI_NOT_FOUND;
+  }
+
+  HybridStorageHob = (PCH_HYBRIDSTORAGE_HOB *) GET_GUID_HOB_DATA (Hob);
+  mPchNvsAreaProtocol.Area->HybridStorageLocation = HybridStorageHob->HybridStorageLocation;
+  return EFI_SUCCESS;
+}
+
+/**
+  PCH ACPI initialization before Boot Sript Table is closed
+  It update ACPI table and ACPI NVS area.
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+PchAcpiOnEndOfDxe (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  DEBUG ((DEBUG_INFO, "PchAcpiOnEndOfDxe() Start\n"));
+
+  ///
+  /// Closed the event to avoid call twice when launch shell
+  ///
+  gBS->CloseEvent (Event);
+
+  //
+  // Init HDA Audio ACPI tables
+  //
+  PchHdAudioAcpiInit ();
+  //
+  // Update ASL definitions for SerialIo devices.
+  //
+  UpdateSerialIoAcpiData ();
+  UpdateCnviAcpiData ();
+#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
+  UpdateTimedGpioSetup();
+#endif
+
+  //
+  // Update Pch Nvs Area
+  //
+  PchUpdateNvsArea ();
+
+  DEBUG ((DEBUG_INFO, "PchAcpiOnEndOfDxe() End\n"));
+
+  return;
+}
+
+/**
+  Initialize Pch acpi
+  @param[in] ImageHandle          Handle for the image of this driver
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to initialize the driver
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiInit (
+  IN EFI_HANDLE         ImageHandle
+  )
+{
+  EFI_STATUS  Status;
+  EFI_EVENT   EndOfDxeEvent;
+
+  DEBUG ((DEBUG_INFO, "Install PCH NVS protocol\n"));
+
+  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof (PCH_NVS_AREA), (VOID **) &mPchNvsAreaProtocol.Area);
+  ASSERT_EFI_ERROR (Status);
+
+  ZeroMem ((VOID *) mPchNvsAreaProtocol.Area, sizeof (PCH_NVS_AREA));
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gPchNvsAreaProtocolGuid,
+                  &mPchNvsAreaProtocol,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Update the NVS Area after RST PCIe Storage Remapping
+  ///
+  PchUpdateNvsAreaAfterRemapping ();
+
+  UpdateHybridStorageLocation ();
+  //
+  // Register an end of DXE event for PCH ACPI to do tasks before invoking any UEFI drivers,
+  // applications, or connecting consoles,...
+  //
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  PchAcpiOnEndOfDxe,
+                  NULL,
+                  &gEfiEndOfDxeEventGroupGuid,
+                  &EndOfDxeEvent
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
+
+
+/**
+  Update NVS area for PCIe root ports.
+**/
+STATIC
+VOID
+PcieRpUpdateNvsArea (
+  VOID
+  )
+{
+  UINT32  Index;
+
+  for (Index = 0; Index < PCH_MAX_PCIE_CLOCKS; Index++) {
+    mPchNvsAreaProtocol.Area->ClockToRootPortMap[Index] = mPchConfigHob->PcieRp.PcieClock[Index].Usage;
+  }
+}
+
+/**
+  Update ASL object before Boot
+
+  @retval EFI_STATUS
+  @retval EFI_NOT_READY         The Acpi protocols are not ready.
+**/
+EFI_STATUS
+PchUpdateNvsArea (
+  VOID
+  )
+{
+  EFI_STATUS            Status;
+  UINTN                 Index;
+  UINT32                HpetBaseAdress;
+  GPIO_GROUP            GroupToGpeDwX[3];
+  UINT32                GroupDw[3];
+  UINTN                 RpDev;
+  UINTN                 RpFun;
+  UINT32                Data32;
+  PCH_POLICY_PROTOCOL   *PchPolicy;
+  GPIO_DXE_CONFIG       *GpioDxeConfig;
+  UINT64                XdciPciBase;
+  UINT64                XdciBar;
+  UINT16                PciMemConfig;
+  UINT16                TcoBase;
+  UINT8                 ClearXdciBar = FALSE;
+
+  ///
+  /// Get PCH Policy Protocol
+  ///
+  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID **)&PchPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Get GPIO DXE Config Block
+  ///
+  Status = GetConfigBlock ((VOID *)PchPolicy, &gGpioDxeConfigGuid, (VOID *)&GpioDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Update ASL PCIE port address according to root port device and function
+  //
+  for (Index = 0; Index < GetPchMaxPciePortNum (); Index++) {
+    RpDev = PchPcieRpDevNumber (Index);
+    RpFun = PchPcieRpFuncNumber (Index);
+    Data32 = ((UINT8) RpDev << 16) | (UINT8) RpFun;
+    mPchNvsAreaProtocol.Area->RpAddress[Index] = Data32;
+
+    //
+    // Update Maximum Snoop Latency and Maximum No-Snoop Latency values for PCIE
+    //
+    mPchNvsAreaProtocol.Area->PcieLtrMaxSnoopLatency[Index]   = mPchConfigHob->PcieRp.RootPort[Index].PcieRpCommonConfig.PcieRpLtrConfig.LtrMaxSnoopLatency;
+    mPchNvsAreaProtocol.Area->PcieLtrMaxNoSnoopLatency[Index] = mPchConfigHob->PcieRp.RootPort[Index].PcieRpCommonConfig.PcieRpLtrConfig.LtrMaxNoSnoopLatency;
+  }
+
+  //
+  // Update PCHS.
+  //
+  mPchNvsAreaProtocol.Area->PchSeries     = PchSeries ();
+  //
+  // Update PCHG.
+  //
+  mPchNvsAreaProtocol.Area->PchGeneration = (UINT16) PchGeneration ();
+  //
+  // Update PSTP.
+  //
+  mPchNvsAreaProtocol.Area->PchStepping = (UINT16) PchStepping ();
+  //
+  // Update HPET base address.
+  //
+  PchHpetBaseGet (&HpetBaseAdress);
+  mPchNvsAreaProtocol.Area->HPTE          = TRUE;  // @todo remove the NVS, since it's always enabled.
+  mPchNvsAreaProtocol.Area->HPTB          = HpetBaseAdress;
+  //
+  // Update SBREG_BAR.
+  //
+  mPchNvsAreaProtocol.Area->SBRG          = PCH_PCR_BASE_ADDRESS;
+
+  //
+  // Update base address
+  //
+  mPchNvsAreaProtocol.Area->PMBS = PmcGetAcpiBase ();
+  mPchNvsAreaProtocol.Area->PWRM = PmcGetPwrmBase ();
+  PchTcoBaseGet (&TcoBase);
+  mPchNvsAreaProtocol.Area->TcoBase = TcoBase;
+
+  //
+  // Update PCH PID info
+  //
+  mPchNvsAreaProtocol.Area->IclkPid = PchPcrGetPid (PchIpIclk);
+
+  //
+  // Update GPIO device ACPI variables
+  //
+  mPchNvsAreaProtocol.Area->SGIR = mPchConfigHob->Interrupt.GpioIrqRoute;
+  mPchNvsAreaProtocol.Area->GPHD = (UINT8)GpioDxeConfig->HideGpioAcpiDevice;
+
+  //
+  // Update GPP_X to GPE_DWX mapping.
+  //
+  GpioGetGroupDwToGpeDwX (
+    &GroupToGpeDwX[0], &GroupDw[0],
+    &GroupToGpeDwX[1], &GroupDw[1],
+    &GroupToGpeDwX[2], &GroupDw[2]
+    );
+
+  //
+  // GEI0/1/2 and GED0/1/2 are objects for informing how GPIO groups are mapped to GPE0.
+  // If Group is mapped to 1-Tier GPE information is also stored on what Group DW
+  // is mapped to GPE_DWx. Because GPE_DWx register is 32 bits large if groups have more than
+  // 32 pads only part of it can be mapped.
+  //
+  //  GEIx - GroupIndex mapped to GPE0_DWx
+  //  GEDx - DoubleWorld part of Group: 0 - pins 31-0, 1 - pins 63-32, ...
+  //
+  mPchNvsAreaProtocol.Area->GEI0 = (UINT8) GpioGetGroupIndexFromGroup (GroupToGpeDwX[0]);
+  mPchNvsAreaProtocol.Area->GEI1 = (UINT8) GpioGetGroupIndexFromGroup (GroupToGpeDwX[1]);
+  mPchNvsAreaProtocol.Area->GEI2 = (UINT8) GpioGetGroupIndexFromGroup (GroupToGpeDwX[2]);
+  mPchNvsAreaProtocol.Area->GED0 = (UINT8) GroupDw[0];
+  mPchNvsAreaProtocol.Area->GED1 = (UINT8) GroupDw[1];
+  mPchNvsAreaProtocol.Area->GED2 = (UINT8) GroupDw[2];
+
+  //
+  // SCS Configuration
+  //
+
+  PcieRpUpdateNvsArea ();
+
+  //
+  // SATA configuration.
+  //
+  mPchNvsAreaProtocol.Area->SataPortPresence = GetSataPortPresentStatus (0);
+  DEBUG ((DEBUG_INFO, "SataPortPresence: 0x%x\n", mPchNvsAreaProtocol.Area->SataPortPresence));
+
+  //
+  // CPU SKU
+  //
+  mPchNvsAreaProtocol.Area->CpuSku = 0;
+  mPchNvsAreaProtocol.Area->PsOnEnable            = (UINT8)mPchConfigHob->Pm.PsOnEnable;
+
+  for (Index = 0; Index < GetPchMaxPciePortNum (); Index++) {
+    mPchNvsAreaProtocol.Area->LtrEnable[Index]  = (UINT8)mPchConfigHob->PcieRp.RootPort[Index].PcieRpCommonConfig.LtrEnable;
+  }
+
+  mPchNvsAreaProtocol.Area->GBES = IsGbePresent ();
+
+  //
+  // Update PCH Trace Hub Mode
+  //
+  mPchNvsAreaProtocol.Area->PchTraceHubMode     = (UINT8) mPchConfigHob->PchTraceHub.PchTraceHubMode;
+
+  //
+  // Saving GCTL value into PCH NVS area
+  //
+
+  XdciPciBase = PchXdciPciCfgBase ();
+
+  //
+  // Determine Base address for Base address register (Offset 0x10)
+  //
+  if (PciSegmentRead32 (XdciPciBase) != 0xFFFFFFFF) {
+
+    XdciBar = PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET) & 0xFFFFFFF0;
+
+    if ((PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET) & B_PCI_BAR_MEMORY_TYPE_MASK) == B_PCI_BAR_MEMORY_TYPE_64) {
+      XdciBar += (UINT64)PciSegmentRead32 (XdciPciBase + (PCI_BASE_ADDRESSREG_OFFSET + 4)) << 32;
+    }
+
+    if (XdciBar == 0x0) {
+      ClearXdciBar = TRUE;
+      PciSegmentWrite32 ((XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET), PcdGet32 (PcdSiliconInitTempMemBaseAddr));
+      XdciBar = PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET) & 0xFFFFFFF0;
+
+      if ((PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET) & B_PCI_BAR_MEMORY_TYPE_MASK) == B_PCI_BAR_MEMORY_TYPE_64) {
+        XdciBar += (UINT64)PciSegmentRead32 (XdciPciBase + (PCI_BASE_ADDRESSREG_OFFSET + 4)) << 32;
+      }
+    }
+
+    //
+    // Enable Pci Memconfig to read the correct value for GCTL register
+    //
+    PciMemConfig = PciSegmentRead16 (XdciPciBase + PCI_COMMAND_OFFSET);
+    PciSegmentWrite16 (XdciPciBase + PCI_COMMAND_OFFSET, PciMemConfig | (EFI_PCI_COMMAND_BUS_MASTER | EFI_PCI_COMMAND_MEMORY_SPACE));
+
+    mPchNvsAreaProtocol.Area->PchxDCIPwrDnScale = MmioRead32(XdciBar + R_XDCI_MEM_GCTL);
+    DEBUG ((DEBUG_INFO, "PchxDCIPwrDnScale  0x%x\n", (UINT64)mPchNvsAreaProtocol.Area->PchxDCIPwrDnScale));
+    //
+    // Disable Pci Memconfig & clear Base address
+    //
+    PciSegmentWrite16(XdciPciBase + PCI_COMMAND_OFFSET, PciMemConfig);
+
+    if (ClearXdciBar == TRUE) {
+      PciSegmentWrite32 ((XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET), 0x0);
+      PciSegmentWrite32 ((XdciPciBase + (PCI_BASE_ADDRESSREG_OFFSET + 4)), 0x0);
+    }
+  }
+
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c
new file mode 100644
index 0000000000..5c8e1ce5b4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c
@@ -0,0 +1,41 @@
+/** @file
+  Initializes PCH CNVi device ACPI data.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <CnviConfigHob.h>
+#include "PchInit.h"
+#include <Register/PchPcrRegs.h>
+
+/**
+  Update ASL definitions for CNVi device.
+
+  @retval EFI_SUCCESS         The function completed successfully
+**/
+EFI_STATUS
+UpdateCnviAcpiData (
+  VOID
+  )
+{
+  EFI_PEI_HOB_POINTERS HobPtr;
+  CNVI_CONFIG_HOB      *CnviConfigHob;
+
+  DEBUG ((DEBUG_INFO, "UpdateCnviAcpiData() Start\n"));
+
+  // Get CNVi Config HOB.
+  HobPtr.Guid = GetFirstGuidHob (&gCnviConfigHobGuid);
+  if (HobPtr.Guid != NULL) {
+    CnviConfigHob = (CNVI_CONFIG_HOB *) GET_GUID_HOB_DATA (HobPtr.Guid);
+    mPchNvsAreaProtocol.Area->CnviMode           = (UINT8)CnviConfigHob->Mode;
+    mPchNvsAreaProtocol.Area->CnviBtCore         = (UINT8)CnviConfigHob->BtCore;
+    mPchNvsAreaProtocol.Area->CnviBtAudioOffload = (UINT8)CnviConfigHob->BtAudioOffload;
+  }
+  mPchNvsAreaProtocol.Area->CnviPortId = PID_CNVI;
+  DEBUG ((DEBUG_INFO, "UpdateCnviAcpiData() End\n"));
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c
new file mode 100644
index 0000000000..dbdb028483
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c
@@ -0,0 +1,201 @@
+
+/** @file
+  Initializes the PCH HD Audio ACPI Tables.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+#include <Protocol/AcpiTable.h>
+#include <DxeHdaNhlt.h>
+#include <Library/DxeHdaNhltLib.h>
+#include "PchInit.h"
+#include <HdAudioConfig.h>
+#include <PchConfigHob.h>
+#include <Library/PcdLib.h>
+#include <Protocol/PchPolicy.h>
+#include <HdAudioConfig.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegs.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/PchInfoLib.h>
+
+#define XTAL_FREQ_38P4MHZ    1
+
+/**
+  Retrieves address of NHLT table from XSDT/RSDT.
+
+  @retval NHLT_ACPI_TABLE*  Pointer to NHLT table if found
+  @retval NULL              NHLT could not be found
+**/
+NHLT_ACPI_TABLE *
+LocateNhltAcpiTable (
+  VOID
+  )
+{
+  EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER  *Rsdp;
+  EFI_ACPI_DESCRIPTION_HEADER                   *Xsdt;
+  NHLT_ACPI_TABLE                               *Nhlt;
+  UINTN                                         Index;
+  UINT64                                        Data64;
+  EFI_STATUS                                    Status;
+  Rsdp  = NULL;
+  Xsdt  = NULL;
+  Nhlt  = NULL;
+
+  ///
+  /// Find the AcpiSupport protocol returns RSDP (or RSD PTR) address.
+  ///
+  DEBUG ((DEBUG_INFO, "LocateNhltAcpiTable() Start\n"));
+
+  Status = EfiGetSystemConfigurationTable (&gEfiAcpiTableGuid, (VOID *) &Rsdp);
+  if (EFI_ERROR (Status) || (Rsdp == NULL)) {
+    DEBUG ((DEBUG_ERROR, "EFI_ERROR or Rsdp == NULL\n"));
+    return NULL;
+  }
+
+  Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->XsdtAddress;
+  if (Xsdt == NULL || Xsdt->Signature != EFI_ACPI_5_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {
+    // If XSDT has not been found, check RSDT
+    Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->RsdtAddress;
+    if (Xsdt == NULL || Xsdt->Signature != EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {
+      DEBUG ((DEBUG_ERROR, "XSDT/RSDT == NULL or wrong signature\n"));
+      return NULL;
+    }
+  }
+
+  for (Index = sizeof (EFI_ACPI_DESCRIPTION_HEADER); Index < Xsdt->Length; Index = Index + sizeof (UINT64)) {
+    Data64  = *(UINT64 *) ((UINT8 *) Xsdt + Index);
+    Nhlt    = (NHLT_ACPI_TABLE *) (UINTN) Data64;
+    if (Nhlt != NULL && Nhlt->Header.Signature == NHLT_ACPI_TABLE_SIGNATURE) {
+      break;
+    }
+    Nhlt = NULL;
+  }
+
+  if (Nhlt == NULL || Nhlt->Header.Signature != NHLT_ACPI_TABLE_SIGNATURE) {
+    DEBUG ((DEBUG_ERROR, "Nhlt == NULL or wrong signature\n"));
+    return NULL;
+  }
+
+  DEBUG ((DEBUG_INFO, "Found NhltTable, Address = 0x%016x\n", Nhlt));
+
+  return Nhlt;
+}
+
+/**
+  Sets NVS ACPI variables for HDAS._DSM and SNDW._DSD accordingly to policy.
+
+  @param[in]                NhltAcpiTableAddress
+  @param[in]                NhltAcpiTableLength
+  @param[in]                *HdAudioConfigHob
+  @param[in]                *HdAudioDxeConfig
+**/
+VOID
+UpdateHdaAcpiData (
+  IN       UINT64                 NhltAcpiTableAddress,
+  IN       UINT32                 NhltAcpiTableLength,
+  IN CONST HDAUDIO_HOB            *HdAudioConfigHob,
+  IN CONST HDAUDIO_DXE_CONFIG     *HdAudioDxeConfig
+  )
+{
+  DEBUG ((DEBUG_INFO, "UpdateHdaAcpiData():\n NHLT Address = 0x%016x, Length = 0x%08x\n", NhltAcpiTableAddress, NhltAcpiTableLength));
+  DEBUG ((DEBUG_INFO, " FeatureMask = 0x%08x\n", HdAudioDxeConfig->DspFeatureMask));
+
+  mPchNvsAreaProtocol.Area->XTAL = XTAL_FREQ_38P4MHZ;
+  mPchNvsAreaProtocol.Area->NHLA = NhltAcpiTableAddress;
+  mPchNvsAreaProtocol.Area->NHLL = NhltAcpiTableLength;
+  mPchNvsAreaProtocol.Area->ADFM = HdAudioDxeConfig->DspFeatureMask;
+
+  if (HdAudioConfigHob->DspEnable || HdAudioConfigHob->DspUaaCompliance == FALSE) {
+    mPchNvsAreaProtocol.Area->SWQ0 = HdAudioConfigHob->AudioLinkSndw1 ? 0 : BIT1;
+    mPchNvsAreaProtocol.Area->SWQ1 = HdAudioConfigHob->AudioLinkSndw2 ? 0 : BIT1;
+    mPchNvsAreaProtocol.Area->SWQ2 = HdAudioConfigHob->AudioLinkSndw3 ? 0 : BIT1;
+    mPchNvsAreaProtocol.Area->SWQ3 = HdAudioConfigHob->AudioLinkSndw4 ? 0 : BIT1;
+  } else {
+    mPchNvsAreaProtocol.Area->SWQ0 = BIT1;
+    mPchNvsAreaProtocol.Area->SWQ1 = BIT1;
+    mPchNvsAreaProtocol.Area->SWQ2 = BIT1;
+    mPchNvsAreaProtocol.Area->SWQ3 = BIT1;
+  }
+
+  mPchNvsAreaProtocol.Area->SWMC = GetPchHdaMaxSndwLinkNum ();
+
+  mPchNvsAreaProtocol.Area->ACS0 = (UINT8)HdAudioDxeConfig->SndwConfig[0].AutonomousClockStop;
+  mPchNvsAreaProtocol.Area->ACS1 = (UINT8)HdAudioDxeConfig->SndwConfig[1].AutonomousClockStop;
+  mPchNvsAreaProtocol.Area->ACS2 = (UINT8)HdAudioDxeConfig->SndwConfig[2].AutonomousClockStop;
+  mPchNvsAreaProtocol.Area->ACS3 = (UINT8)HdAudioDxeConfig->SndwConfig[3].AutonomousClockStop;
+
+  mPchNvsAreaProtocol.Area->DAI0 = (UINT8)HdAudioDxeConfig->SndwConfig[0].DataOnActiveIntervalSelect;
+  mPchNvsAreaProtocol.Area->DAI1 = (UINT8)HdAudioDxeConfig->SndwConfig[1].DataOnActiveIntervalSelect;
+  mPchNvsAreaProtocol.Area->DAI2 = (UINT8)HdAudioDxeConfig->SndwConfig[2].DataOnActiveIntervalSelect;
+  mPchNvsAreaProtocol.Area->DAI3 = (UINT8)HdAudioDxeConfig->SndwConfig[3].DataOnActiveIntervalSelect;
+
+  mPchNvsAreaProtocol.Area->DOD0 = (UINT8)HdAudioDxeConfig->SndwConfig[0].DataOnDelaySelect;
+  mPchNvsAreaProtocol.Area->DOD1 = (UINT8)HdAudioDxeConfig->SndwConfig[1].DataOnDelaySelect;
+  mPchNvsAreaProtocol.Area->DOD2 = (UINT8)HdAudioDxeConfig->SndwConfig[2].DataOnDelaySelect;
+  mPchNvsAreaProtocol.Area->DOD3 = (UINT8)HdAudioDxeConfig->SndwConfig[3].DataOnDelaySelect;
+}
+
+/**
+  Initialize Intel High Definition Audio ACPI Tables
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_LOAD_ERROR          ACPI table cannot be installed
+  @retval EFI_UNSUPPORTED         ACPI table not set because DSP is disabled
+**/
+EFI_STATUS
+PchHdAudioAcpiInit (
+  VOID
+  )
+{
+  EFI_STATUS                    Status;
+  UINT64                        HdaPciBase;
+  CONST HDAUDIO_HOB             *HdAudioConfigHob;
+  PCH_POLICY_PROTOCOL           *PchPolicy;
+  HDAUDIO_DXE_CONFIG            *HdAudioDxeConfig;
+  NHLT_ACPI_TABLE               *NhltTable;
+
+
+  DEBUG ((DEBUG_INFO, "PchHdAudioAcpiInit() Start\n"));
+
+  HdAudioConfigHob = &mPchConfigHob->HdAudio;
+
+  ///
+  /// Get PCH Policy Protocol
+  ///
+  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID **)&PchPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Get HD Audio DXE Config Block
+  ///
+  Status = GetConfigBlock ((VOID *)PchPolicy, &gHdAudioDxeConfigGuid, (VOID *)&HdAudioDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  HdaPciBase = HdaPciCfgBase ();
+
+  if ((PciSegmentRead16 (HdaPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) || (HdAudioConfigHob->DspEnable == FALSE)) {
+    // Do not set ACPI tables if HDAudio is Function disabled or DSP is disabled
+    DEBUG ((DEBUG_INFO, "AudioDSP: Non-HDAudio ACPI Table (NHLT) not set!\n"));
+    return EFI_UNSUPPORTED;
+  }
+
+  NhltTable = LocateNhltAcpiTable ();
+  if (NhltTable == NULL) {
+    return EFI_LOAD_ERROR;
+  }
+
+  UpdateHdaAcpiData ((UINT64) (UINTN) NhltTable, (UINT32) (NhltTable->Header.Length), HdAudioConfigHob, HdAudioDxeConfig);
+  DEBUG_CODE ( NhltAcpiTableDump (NhltTable); );
+
+  DEBUG ((DEBUG_INFO, "PchHdAudioAcpiInit() End - Status = %r\n", Status));
+  return Status;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c
new file mode 100644
index 0000000000..734d4e295a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c
@@ -0,0 +1,314 @@
+/** @file
+  This is the Common driver that initializes the Intel PCH.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/TimerLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/HobLib.h>
+
+#include "PchInit.h"
+#include <PchPolicyCommon.h>
+#include <Library/SpiCommonLib.h>
+#include <Library/PmcPrivateLib.h>
+#include <Library/PchDmiLib.h>
+#include <Library/SiScheduleResetLib.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PchPcrLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Library/SpiAccessPrivateLib.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/SpiRegs.h>
+#include <Register/PchRegsPsth.h>
+#include <Register/PmcRegs.h>
+#include <Register/HdaRegs.h>
+#include <Library/GpioCheckConflictLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/PchInfoLib.h>
+
+//
+// Module variables
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_CONFIG_HOB           *mPchConfigHob;
+
+//
+// EFI_EVENT
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_EVENT mHeciEvent;
+
+/**
+  Common PchInit Module Entry Point
+**/
+VOID
+PchInitEntryPointCommon (
+  VOID
+  )
+{
+  EFI_PEI_HOB_POINTERS  HobPtr;
+
+  DEBUG ((DEBUG_INFO, "PchInitEntryPointCommon() Start\n"));
+
+  //
+  // Get PCH Config HOB.
+  //
+  HobPtr.Guid   = GetFirstGuidHob (&gPchConfigHobGuid);
+  ASSERT (HobPtr.Guid != NULL);
+  mPchConfigHob = (PCH_CONFIG_HOB *) GET_GUID_HOB_DATA (HobPtr.Guid);
+
+  DEBUG ((DEBUG_INFO, "PchInitEntryPointCommon() End\n"));
+
+  return;
+}
+
+/**
+  Lock SPI register before boot
+**/
+VOID
+LockSpiConfiguration (
+  VOID
+  )
+{
+  UINTN         Index;
+  UINT16        Data16;
+  UINT16        Data16And;
+  UINT16        Data16Or;
+  UINT32        Data32;
+  UINT32        DlockValue;
+  UINT64        PciSpiRegBase;
+  UINT32        PchSpiBar0;
+  UINT32        Timer;
+
+  PciSpiRegBase = SpiPciCfgBase ();
+
+  //
+  // Check for SPI controller presence before programming
+  //
+  if (PciSegmentRead16 (PciSpiRegBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    return;
+  }
+
+  //
+  // Make sure SPI BAR0 has fixed address before writing to boot script.
+  // The same base address is set in PEI and will be used during resume.
+  //
+  PchSpiBar0 = PCH_SPI_BASE_ADDRESS;
+
+  PciSegmentAnd8    (PciSpiRegBase + PCI_COMMAND_OFFSET, (UINT8) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+  PciSegmentWrite32 (PciSpiRegBase + R_SPI_CFG_BAR0, PchSpiBar0);
+  PciSegmentOr8     (PciSpiRegBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+
+  //
+  // Locking for security reasons only if Extended BIOS Range Decode is supported
+  //
+  if (IsExtendedBiosRangeDecodeSupported ()) {
+    //
+    // Before setting FLOCKDN lock Extended BIOS Range configuration
+    // All configuration of this feature shall be done already at this moment
+    //
+    PciSegmentOr32 (PciSpiRegBase + R_SPI_CFG_BC, BIT28);
+    S3BootScriptSavePciCfgWrite (
+      S3BootScriptWidthUint32,
+      (UINTN) PciSpiRegBase + R_SPI_CFG_BC,
+      1,
+      (VOID *) (UINTN) (PciSpiRegBase + R_SPI_CFG_BC)
+      );
+  }
+
+  //
+  // Program the Flash Protection Range Register based on policy
+  //
+  DlockValue = MmioRead32 (PchSpiBar0 + R_SPI_MEM_DLOCK);
+  for (Index = 0; Index < PCH_FLASH_PROTECTED_RANGES; ++Index) {
+    if ((mPchConfigHob->ProtectRange[Index].WriteProtectionEnable ||
+         mPchConfigHob->ProtectRange[Index].ReadProtectionEnable) != TRUE) {
+      continue;
+    }
+
+    //
+    // Proceed to program the register after ensure it is enabled
+    //
+    Data32 = 0;
+    Data32 |= (mPchConfigHob->ProtectRange[Index].WriteProtectionEnable == TRUE) ? B_SPI_MEM_PRX_WPE : 0;
+    Data32 |= (mPchConfigHob->ProtectRange[Index].ReadProtectionEnable == TRUE) ? B_SPI_MEM_PRX_RPE : 0;
+    Data32 |= ((UINT32) mPchConfigHob->ProtectRange[Index].ProtectedRangeLimit << N_SPI_MEM_PRX_PRL) & B_SPI_MEM_PRX_PRL_MASK;
+    Data32 |= ((UINT32) mPchConfigHob->ProtectRange[Index].ProtectedRangeBase << N_SPI_MEM_PRX_PRB) & B_SPI_MEM_PRX_PRB_MASK;
+    DEBUG ((DEBUG_INFO, "Protected range %d: 0x%08x \n", Index, Data32));
+
+    DlockValue |= (UINT32) (B_SPI_MEM_DLOCK_PR0LOCKDN << Index);
+    MmioWrite32 ((UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index * S_SPI_MEM_PRX))), Data32);
+    S3BootScriptSaveMemWrite (
+      S3BootScriptWidthUint32,
+      (UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index * S_SPI_MEM_PRX))),
+      1,
+      (VOID *) (UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index * S_SPI_MEM_PRX)))
+      );
+  }
+  //
+  // Program DLOCK register
+  //
+  MmioWrite32 ((UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK), DlockValue);
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK),
+    1,
+    (VOID *) (UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK)
+    );
+
+  ///
+  /// PCH BIOS Spec Section 3.6 Flash Security Recommendation
+  /// In PCH SPI controller the BIOS should set the Flash Configuration Lock-Down bit
+  /// (SPI_BAR0 + 04[15]) at end of post.  When set to 1, those Flash Program Registers
+  /// that are locked down by this FLOCKDN bit cannot be written.
+  /// Please refer to the EDS for which program registers are impacted.
+  /// Additionally BIOS must program SPI_BAR0 + 0x04 BIT11 (WRSDIS) to disable Write Status in HW sequencing
+  ///
+
+  //
+  // Ensure there is no pending SPI trasaction before setting lock bits
+  //
+  Timer = 0;
+  while (MmioRead16 (PchSpiBar0 + R_SPI_MEM_HSFSC) & B_SPI_MEM_HSFSC_SCIP) {
+    if (Timer > SPI_WAIT_TIME) {
+      //
+      // SPI transaction is pending too long at this point, exit with error.
+      //
+      DEBUG ((DEBUG_ERROR, "SPI Cycle timeout\n"));
+      ASSERT (FALSE);
+      break;
+    }
+    MicroSecondDelay (SPI_WAIT_PERIOD);
+    Timer += SPI_WAIT_PERIOD;
+  }
+
+  Data16And = B_SPI_MEM_HSFSC_SCIP;
+  Data16    = 0;
+  S3BootScriptSaveMemPoll (
+    S3BootScriptWidthUint16,
+    PchSpiBar0 + R_SPI_MEM_HSFSC,
+    &Data16And,
+    &Data16,
+    SPI_WAIT_PERIOD,
+    SPI_WAIT_TIME / SPI_WAIT_PERIOD
+    );
+
+  //
+  // Clear any outstanding status
+  //
+  Data16Or  = B_SPI_MEM_HSFSC_SAF_DLE
+            | B_SPI_MEM_HSFSC_SAF_ERROR
+            | B_SPI_MEM_HSFSC_AEL
+            | B_SPI_MEM_HSFSC_FCERR
+            | B_SPI_MEM_HSFSC_FDONE;
+  Data16And = 0xFFFF;
+  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And, Data16Or);
+  S3BootScriptSaveMemReadWrite (
+    S3BootScriptWidthUint16,
+    PchSpiBar0 + R_SPI_MEM_HSFSC,
+    &Data16Or,
+    &Data16And
+    );
+
+  //
+  // Set WRSDIS
+  //
+  Data16Or  = B_SPI_MEM_HSFSC_WRSDIS;
+  Data16And = 0xFFFF;
+  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And, Data16Or);
+  S3BootScriptSaveMemReadWrite (
+    S3BootScriptWidthUint16,
+    PchSpiBar0 + R_SPI_MEM_HSFSC,
+    &Data16Or,
+    &Data16And
+    );
+
+  //
+  // Set FLOCKDN
+  //
+  Data16Or  = B_SPI_MEM_HSFSC_FLOCKDN;
+  Data16And = 0xFFFF;
+  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And, Data16Or);
+  S3BootScriptSaveMemReadWrite (
+    S3BootScriptWidthUint16,
+    PchSpiBar0 + R_SPI_MEM_HSFSC,
+    &Data16Or,
+    &Data16And
+    );
+
+  ///
+  /// SPI Flash Programming Guide Section 5.5.2 Vendor Component Lock
+  /// It is strongly recommended that BIOS sets the Vendor Component Lock (VCL) bits. VCL applies
+  /// the lock to both VSCC0 and VSCC1 even if VSCC0 is not used. Without the VCL bits set, it is
+  /// possible to make Host/GbE VSCC register(s) changes in that can cause undesired host and
+  /// integrated GbE Serial Flash functionality.
+  ///
+  MmioOr32 ((UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0), B_SPI_MEM_SFDP0_VSCC0_VCL);
+  S3BootScriptSaveMemWrite (
+    S3BootScriptWidthUint32,
+    (UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0),
+    1,
+    (VOID *) (UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0)
+    );
+}
+
+/**
+  Set HD Audio PME bit
+**/
+VOID
+ConfigureHdAudioPme (
+  VOID
+  )
+{
+  UINT64 HdaPciBase;
+
+  HdaPciBase = HdaPciCfgBase ();
+
+  if (PciSegmentRead16 (HdaPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    return;
+  }
+
+  ///
+  /// PME Enable for Audio controller
+  ///
+  if (mPchConfigHob->HdAudio.Pme == TRUE) {
+    PciSegmentOr32 (HdaPciBase + R_HDA_CFG_PCS, (UINT32) B_HDA_CFG_PCS_PMEE);
+  }
+}
+
+/**
+  Set eSPI BME bit
+**/
+VOID
+ConfigureEspiBme (
+  VOID
+  )
+{
+  UINT64 EspiPciBase;
+
+  EspiPciBase = EspiPciCfgBase ();
+
+  if (PciSegmentRead16 (EspiPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    return;
+  }
+  if ((PciSegmentRead32 (EspiPciBase + R_ESPI_CFG_PCBC) & B_ESPI_CFG_PCBC_ESPI_EN) == 0) {
+    return;
+  }
+
+  //
+  // Refer to PCH BWG.
+  // To enable eSPI bus mastering BIOS must enable BME in eSPI controller
+  // and also set BME bit in the respective slave devices through Configuration
+  // and Capabilities register of each slave using Get_Configuration and Set_Configuration functionality.
+  //
+  // NOTE: The setting is also done in PEI, but might be cleared by PCI bus during PCI enumeration.
+  //       Therefore, reeable it after PCI enumeration done.
+  //
+  if (mPchConfigHob->Espi.BmeMasterSlaveEnabled == TRUE) {
+    PciSegmentOr8 (EspiPciBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_BUS_MASTER);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h
new file mode 100644
index 0000000000..0d6647e3f3
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h
@@ -0,0 +1,122 @@
+/** @file
+  Header file for PCH Initialization Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_INIT_DXE_H_
+#define _PCH_INIT_DXE_H_
+
+#include <SiConfigHob.h>
+#include <PchConfigHob.h>
+#include <Protocol/PchNvsArea.h>
+
+//
+// Data definitions
+//
+extern EFI_HANDLE               mImageHandle;
+
+//
+// Pch NVS area definition
+//
+extern PCH_NVS_AREA_PROTOCOL    mPchNvsAreaProtocol;
+
+extern PCH_CONFIG_HOB           *mPchConfigHob;
+extern SI_CONFIG_HOB_DATA       *mSiConfigHobData;
+
+//
+// Function Prototype
+//
+
+//
+// Local function prototypes
+//
+/**
+  Common PchInit Module Entry Point
+**/
+VOID
+PchInitEntryPointCommon (
+  VOID
+  );
+
+/**
+  Calls Boot Os Hand off routine for each Serial IO Controller
+**/
+VOID
+ConfigureSerialIoAtBoot (
+  VOID
+  );
+
+/**
+  Puts all SerialIo controllers (except UARTs in debug mode) in D3.
+  Clears MemoryEnable for all PCI-mode controllers on S3 resume
+**/
+VOID
+ConfigureSerialIoAtS3Resume (
+  VOID
+  );
+
+/**
+  Add Serial Io UART Hidden Handles
+**/
+VOID
+CreateSerialIoUartHiddenHandle (
+  VOID
+  );
+
+/**
+  Initialize Intel High Definition Audio ACPI Tables
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_LOAD_ERROR          ACPI table cannot be installed
+  @retval EFI_UNSUPPORTED         ACPI table not set because DSP is disabled
+**/
+EFI_STATUS
+PchHdAudioAcpiInit (
+  VOID
+  );
+
+/**
+  Perform the remaining configuration on SATA to perform device detection,
+  then set the SATA SPD and PxE corresponding, and set the Register Lock on PCH SATA
+**/
+VOID
+ConfigureSataOnEndOfDxe (
+  VOID
+  );
+
+/**
+  Update ASL data for CNVI Device.
+
+  @retval EFI_SUCCESS             The function completed successfully
+**/
+EFI_STATUS
+UpdateCnviAcpiData (
+   VOID
+   );
+
+/**
+  Initialize Pch acpi
+  @param[in] ImageHandle          Handle for the image of this driver
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to initialize the driver
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiInit (
+  IN EFI_HANDLE         ImageHandle
+  );
+
+/**
+  Update ASL object before Boot
+
+  @retval EFI_STATUS
+  @retval EFI_NOT_READY         The Acpi protocols are not ready.
+**/
+EFI_STATUS
+PchUpdateNvsArea (
+  VOID
+  );
+
+#endif // _PCH_INIT_DXE_H_
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c
new file mode 100644
index 0000000000..1d4f08a86c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c
@@ -0,0 +1,354 @@
+/** @file
+  This is the Uefi driver that initializes the Intel PCH.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiLib.h>
+
+#include "PchInit.h"
+#include <PchPolicyCommon.h>
+#include <Protocol/PcieIoTrap.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PmcLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PmcPrivateLib.h>
+#include <Library/PciExpressHelpersLib.h>
+#include <PcieRegs.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/PmcRegs.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE               mImageHandle;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                   mPcieIoTrapAddress;
+
+VOID
+EFIAPI
+PchOnBootToOs (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  );
+
+
+VOID
+EFIAPI
+PchOnExitBootServices (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  );
+
+
+VOID
+EFIAPI
+PchOnReadyToBoot (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  );
+
+/**
+  Process all the lock downs
+**/
+VOID
+ProcessSmiLocks (
+  VOID
+  )
+{
+  UINT32        Data32And;
+  UINT32        Data32Or;
+  UINT16        ABase;
+
+  ///
+  /// PCH BIOS Spec Section 3.6 Flash Security Recommendation
+  /// BIOS needs to enables SMI_LOCK (PMC PCI offset A0h[4] = 1b) which prevent writes
+  /// to the Global SMI Enable bit (GLB_SMI_EN ABASE + 30h[0]). Enabling this bit will
+  /// mitigate malicious software attempts to gain system management mode privileges.
+  ///
+  if (mPchConfigHob->LockDown.GlobalSmi == TRUE) {
+    ///
+    /// Save Global SMI Enable bit setting before BIOS enables SMI_LOCK during S3 resume
+    ///
+    ABase = PmcGetAcpiBase ();
+    Data32Or = IoRead32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN));
+    if ((Data32Or & B_ACPI_IO_SMI_EN_GBL_SMI) != 0) {
+      Data32And = 0xFFFFFFFF;
+      Data32Or |= B_ACPI_IO_SMI_EN_GBL_SMI;
+      S3BootScriptSaveIoReadWrite (
+        S3BootScriptWidthUint32,
+        (UINTN) (ABase + R_ACPI_IO_SMI_EN),
+        &Data32Or,  // Data to be ORed
+        &Data32And  // Data to be ANDed
+        );
+    }
+      PmcLockSmiWithS3BootScript ();
+  }
+}
+
+/**
+  Do PCIE power management while resume from S3
+**/
+VOID
+ReconfigurePciePowerManagementForS3 (
+  VOID
+  )
+{
+  EFI_STATUS                            Status;
+  UINT32                                Data32;
+  PCH_PCIE_IOTRAP_PROTOCOL              *PchPcieIoTrapProtocol;
+
+  Status = gBS->LocateProtocol (&gPchPcieIoTrapProtocolGuid, NULL, (VOID **) &PchPcieIoTrapProtocol);
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+  mPcieIoTrapAddress = PchPcieIoTrapProtocol->PcieTrapAddress;
+  DEBUG ((DEBUG_INFO, "PcieIoTrapAddress: %0x\n", mPcieIoTrapAddress));
+
+  if (mPcieIoTrapAddress != 0) {
+    //
+    // Save PCH PCIE IoTrap address to re-config PCIE power management setting after resume from S3
+    //
+    Data32 = PchPciePmTrap;
+    S3BootScriptSaveIoWrite (
+      S3BootScriptWidthUint32,
+      (UINTN) (mPcieIoTrapAddress),
+      1,
+      &Data32
+      );
+  } else {
+    ASSERT (FALSE);
+  }
+}
+
+/**
+  This is the callback function for PCI ENUMERATION COMPLETE.
+**/
+VOID
+EFIAPI
+PchOnPciEnumComplete (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  EFI_STATUS          Status;
+  VOID                *ProtocolPointer;
+
+  ///
+  /// Check if this is first time called by EfiCreateProtocolNotifyEvent() or not,
+  /// if it is, we will skip it until real event is triggered
+  ///
+  Status = gBS->LocateProtocol (&gEfiPciEnumerationCompleteProtocolGuid, NULL, (VOID **) &ProtocolPointer);
+  if (EFI_SUCCESS != Status) {
+    return;
+  }
+  gBS->CloseEvent (Event);
+
+  ReconfigurePciePowerManagementForS3 ();
+  ProcessSmiLocks ();
+  ConfigureSerialIoAtS3Resume ();
+}
+
+/**
+  Register callback functions for PCH DXE.
+**/
+VOID
+PchRegisterNotifications (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+  EFI_EVENT   ReadyToBoot;
+  EFI_EVENT   LegacyBootEvent;
+  EFI_EVENT   ExitBootServicesEvent;
+  VOID        *Registration;
+
+  ///
+  /// Create PCI Enumeration Completed callback for PCH
+  ///
+  EfiCreateProtocolNotifyEvent (
+    &gEfiPciEnumerationCompleteProtocolGuid,
+    TPL_CALLBACK,
+    PchOnPciEnumComplete,
+    NULL,
+    &Registration
+    );
+
+  //
+  // Register a Ready to boot event to config PCIE power management setting after OPROM executed
+  //
+  Status = EfiCreateEventReadyToBootEx (
+             TPL_CALLBACK,
+             PchOnReadyToBoot,
+             NULL,
+             &ReadyToBoot
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Create events for PCH to do the task before ExitBootServices/LegacyBoot.
+  // It is guaranteed that only one of two events below will be signalled
+  //
+  Status = gBS->CreateEvent (
+                  EVT_SIGNAL_EXIT_BOOT_SERVICES,
+                  TPL_CALLBACK,
+                  PchOnExitBootServices,
+                  NULL,
+                  &ExitBootServicesEvent
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = EfiCreateEventLegacyBootEx (
+             TPL_CALLBACK,
+             PchOnBootToOs,
+             NULL,
+             &LegacyBootEvent
+             );
+  ASSERT_EFI_ERROR (Status);
+}
+
+/**
+  <b>PchInit DXE Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+      The PchInit module is a DXE driver that initializes the Intel Platform Controller Hub
+      following the PCH BIOS specification and EDS requirements and recommendations. It consumes
+      the PCH_POLICY_HOB SI_POLICY_HOB for expected configurations per policy.
+      This is the standard EFI driver point that detects whether there is an supported PCH in
+      the system and if so, initializes the chipset.
+
+  - <b>Details</b>\n
+    This module is required for initializing the Intel Platform Controller Hub to
+    follow the PCH BIOS specification and EDS.
+    This includes some initialization sequences, enabling and disabling PCH devices,
+    configuring clock gating, RST PCIe Storage Remapping, SATA controller, ASPM of PCIE devices. Right before end of DXE,
+    it's responsible to lock down registers for security requirement.
+
+  - @pre
+    - PCH PCR base address configured
+    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
+      - This is to ensure that PCI MMIO and IO resource has been prepared and available for this driver to allocate.
+
+  - @result
+    - Publishes the @link _PCH_INFO_PROTOCOL PCH_INFO_PROTOCOL @endlink
+    - Publishes the @link _PCH_EMMC_TUNING_PROTOCOL PCH_EMMC_TUNING_PROTOCOL @endlink
+
+  - <b>References</b>\n
+    - @link _PCH_POLICY PCH_POLICY_HOB @endlink.
+    - @link _SI_POLICY_STRUCT SI_POLICY_HOB @endlink.
+
+  - <b>Integration Checklists</b>\n
+    - Verify prerequisites are met. Porting Recommendations.
+    - No modification of this module should be necessary
+    - Any modification of this module should follow the PCH BIOS Specification and EDS
+
+  @param[in] ImageHandle          Handle for the image of this driver
+  @param[in] SystemTable          Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to initialize the driver
+**/
+EFI_STATUS
+EFIAPI
+PchInitEntryPointDxe (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS            Status;
+
+  DEBUG ((DEBUG_INFO, "PchInitEntryPointDxe() Start\n"));
+
+  mImageHandle = ImageHandle;
+
+  PchInitEntryPointCommon ();
+
+  Status = PchAcpiInit (ImageHandle);
+
+  PchRegisterNotifications ();
+
+  CreateSerialIoUartHiddenHandle ();
+
+  DEBUG ((DEBUG_INFO, "PchInitEntryPointDxe() End\n"));
+
+  return Status;
+}
+
+/**
+  PCH initialization before ExitBootServices / LegacyBoot events
+  Useful for operations which must happen later than at EndOfPost event
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+PchOnBootToOs (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  ///
+  /// Closed the event to avoid call twice
+  ///
+  if (Event != NULL) {
+    gBS->CloseEvent (Event);
+  }
+
+  ConfigureSerialIoAtBoot ();
+
+  return;
+}
+
+/**
+  PCH initialization on ExitBootService. This event is used if only ExitBootService is used
+  and not in legacy boot
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+
+  @retval None
+**/
+VOID
+EFIAPI
+PchOnExitBootServices (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  PchOnBootToOs (NULL, NULL);
+
+  return;
+}
+
+/**
+  PCH initialization before boot to OS
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+PchOnReadyToBoot (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  DEBUG ((DEBUG_INFO, "Uefi PchOnReadyToBoot() Start\n"));
+
+  if (Event != NULL) {
+    gBS->CloseEvent (Event);
+  }
+
+  //
+  // Trigger an Iotrap SMI to config PCIE power management setting after PCI enumrate is done
+  //
+  if (mPcieIoTrapAddress != 0) {
+    IoWrite32 ((UINTN) mPcieIoTrapAddress, PchPciePmTrap);
+  } else {
+    ASSERT (FALSE);
+  }
+
+  DEBUG ((DEBUG_INFO, "Uefi PchOnReadyToBoot() End\n"));
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf
new file mode 100644
index 0000000000..4941ff0f49
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf
@@ -0,0 +1,96 @@
+## @file
+# Component description file for Pch Initialization driver
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PchInitDxeTgl
+FILE_GUID = 4BD0EB2F-3A2D-442E-822D-753516F75424
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+ENTRY_POINT = PchInitEntryPointDxe
+
+
+[LibraryClasses]
+S3BootScriptLib
+PchCycleDecodingLib
+PchPcieRpLib
+PchPcrLib
+PchInfoLib
+PciExpressHelpersLib
+UefiBootServicesTableLib
+DebugLib
+IoLib
+TimerLib
+HobLib
+BaseMemoryLib
+MemoryAllocationLib
+UefiLib
+DxeServicesTableLib
+UefiDriverEntryPoint
+UefiRuntimeServicesTableLib
+GpioLib
+SerialIoAccessLib
+ConfigBlockLib
+PmcLib
+PmcPrivateLibWithS3
+SataLib
+PchDmiWithS3Lib
+GbeLib
+SiScheduleResetLib
+DxeHdaNhltLib
+SpiAccessPrivateLib
+PchPciBdfLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr ## CONSUMES
+gSiPkgTokenSpaceGuid.PcdEmbeddedEnable             ## CONSUMES
+
+[Sources]
+PchInitDxe.c
+PchInit.h
+PchInit.c
+PchSata.c
+PchSerialIo.c
+PchSerialIoDxe.c
+PchHdaAcpi.c
+PchCnviAcpi.c
+PchAcpi.c
+
+
+[Protocols]
+gPchNvsAreaProtocolGuid ## PRODUCES
+gEfiPciIoProtocolGuid ## CONSUMES
+gEfiAcpiTableProtocolGuid ## CONSUMES
+gEfiBlockIoProtocolGuid ## CONSUMES
+gHeciProtocolGuid
+gEfiPciEnumerationCompleteProtocolGuid ## CONSUMES
+gPchPcieIoTrapProtocolGuid ## CONSUMES
+gPchPolicyProtocolGuid ## CONSUMES
+
+
+[Guids]
+gEfiEndOfDxeEventGroupGuid
+gEfiAcpiTableGuid
+gEmmcDxeConfigGuid               ## CONSUMES
+gSiConfigHobGuid                 ## CONSUMES
+gPchConfigHobGuid                ## CONSUMES
+gPchRstHobGuid                   ## CONSUMES
+gHdAudioDxeConfigGuid            ## CONSUMES
+gGpioDxeConfigGuid               ## CONSUMES
+gCnviConfigHobGuid               ## CONSUMES
+gHybridStorageHobGuid            ## CONSUMES
+
+[Depex]
+gEfiPciHostBridgeResourceAllocationProtocolGuid ## This is to ensure that PCI MMIO and IO resource has been prepared and available for this driver to allocate.
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c
new file mode 100644
index 0000000000..886f3b4bc0
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c
@@ -0,0 +1,89 @@
+/** @file
+  Perform related functions for PCH Sata in DXE phase
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/DebugLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/S3BootScriptLib.h>
+
+#include "PchInit.h"
+#include <Library/SataLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Register/SataRegs.h>
+
+/**
+  Perform the remaining configuration on SATA to perform device detection,
+  then set the SATA SPD and PxE corresponding, and set the Register Lock on PCH SATA
+
+  @retval None
+**/
+VOID
+ConfigureSataOnEndOfDxe (
+  VOID
+  )
+{
+  UINT64        PciSataRegBase;
+  UINT16        SataPortsEnabled;
+  UINT32        DwordReg;
+  UINTN         Index;
+  UINT32        SataCtrlIndex;
+
+  for (SataCtrlIndex = 0; SataCtrlIndex < MaxSataControllerNum (); SataCtrlIndex++) {
+    ///
+    /// SATA PCS: Enable the port in any of below condition:
+    /// i.)   Hot plug is enabled
+    /// ii.)  A device is attached
+    /// iii.) Test mode is enabled
+    /// iv.)  Configured as eSATA port
+    ///
+    PciSataRegBase    = SataPciCfgBase (SataCtrlIndex);
+    SataPortsEnabled  = 0;
+
+    DwordReg = PciSegmentRead32 (PciSataRegBase + R_SATA_CFG_PCS);
+    for (Index = 0; Index < MaxSataPortNum (SataCtrlIndex); Index++) {
+      if ((mPchConfigHob->Sata[SataCtrlIndex].PortSettings[Index].HotPlug == TRUE) ||
+          (DwordReg & (B_SATA_CFG_PCS_P0P << Index)) ||
+            (mPchConfigHob->Sata[SataCtrlIndex].TestMode == TRUE) ||
+            (mPchConfigHob->Sata[SataCtrlIndex].PortSettings[Index].External == TRUE)) {
+          SataPortsEnabled |= (mPchConfigHob->Sata[SataCtrlIndex].PortSettings[Index].Enable << Index);
+      }
+    }
+
+    ///
+    /// Set MAP."Sata PortX Disable", SATA PCI offset 90h[23:16] to 1b if SATA Port 0/1/2/3/4/5/6/7 is disabled
+    ///
+    PciSegmentOr32 (PciSataRegBase + R_SATA_CFG_MAP, (~SataPortsEnabled << N_SATA_CFG_MAP_SPD));
+    S3BootScriptSaveMemWrite (
+      S3BootScriptWidthUint32,
+      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_MAP,
+      1,
+      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_MAP)
+      );
+
+    ///
+    /// Program PCS "Port X Enabled", SATA PCI offset 94h[7:0] = Port 0~7 Enabled bit as per SataPortsEnabled value.
+    ///
+    PciSegmentOr16 (PciSataRegBase + R_SATA_CFG_PCS, SataPortsEnabled);
+    S3BootScriptSaveMemWrite (
+      S3BootScriptWidthUint16,
+      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_PCS,
+      1,
+      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_PCS)
+      );
+
+    ///
+    /// Step 14
+    /// Program SATA PCI offset 9Ch [31] to 1b
+    ///
+    PciSegmentOr32 ((UINTN) (PciSataRegBase + R_SATA_CFG_SATAGC), BIT31);
+    S3BootScriptSaveMemWrite (
+      S3BootScriptWidthUint32,
+      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_SATAGC,
+      1,
+      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase + R_SATA_CFG_SATAGC)
+      );
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c
new file mode 100644
index 0000000000..9409a9a387
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c
@@ -0,0 +1,33 @@
+/** @file
+  Initializes Serial IO Controllers.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchInit.h"
+#include <Library/SerialIoPrivateLib.h>
+#include <Library/PchInfoLib.h>
+
+/**
+  Calls Boot Os Hand off routine for each Serial IO Controller
+**/
+VOID
+ConfigureSerialIoAtBoot (
+  VOID
+  )
+{
+  UINT8  Index;
+
+  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
+    SerialIoSpiBootHandler (Index, &mPchConfigHob->SerialIo.SpiDeviceConfig[Index]);
+  }
+
+  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
+    SerialIoI2cBootHandler (Index, &mPchConfigHob->SerialIo.I2cDeviceConfig[Index]);
+  }
+
+  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++) {
+    SerialIoUartBootHandler (Index, &mPchConfigHob->SerialIo.UartDeviceConfig[Index]);
+  }
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c
new file mode 100644
index 0000000000..fde7da6b96
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c
@@ -0,0 +1,134 @@
+/** @file
+  Initializes Serial IO Controllers.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/SerialIoPrivateLib.h>
+#include <Library/PchInfoLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/SerialIoRegs.h>
+#include <PchInit.h>
+
+typedef struct {
+  ACPI_HID_DEVICE_PATH          RootPort;
+  ACPI_EXTENDED_HID_DEVICE_PATH AcpiDev;
+  CHAR8                         HidString[8];
+  UINT16                        DeviceId;
+  UINT8                         UartIndex;
+  EFI_DEVICE_PATH_PROTOCOL      End;
+} SERIALIO_UART_DEVICE_PATH;
+
+#define mPciRootBridge {{ACPI_DEVICE_PATH, ACPI_DP, {(UINT8)(sizeof (ACPI_HID_DEVICE_PATH)), 0}}, EISA_PNP_ID (0x0A03), 0}
+#define mAcpiDev {{ACPI_DEVICE_PATH, ACPI_EXTENDED_DP, {(UINT8)(sizeof (ACPI_EXTENDED_HID_DEVICE_PATH) + (sizeof(CHAR8) * 8) + sizeof (UINT16) + sizeof (UINT8)), 0}},0,0,0}
+#define mEndEntire {END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE, {END_DEVICE_PATH_LENGTH, 0}}
+
+GLOBAL_REMOVE_IF_UNREFERENCED SERIALIO_UART_DEVICE_PATH mSerialIoUartPath = {
+  mPciRootBridge,
+  mAcpiDev,
+  "UART\0\0\0",
+  0xFFFF,
+  0xFF,
+  mEndEntire
+};
+
+/**
+  Add Serial Io UART Hidden Handles
+**/
+VOID
+CreateSerialIoUartHiddenHandle (
+  VOID
+  )
+{
+  EFI_HANDLE               NewHandle;
+  EFI_DEVICE_PATH_PROTOCOL *NewPath;
+  EFI_STATUS               Status;
+  UINT8                    Index;
+  UINT16                   DeviceId;
+
+  DEBUG ((DEBUG_INFO, "CreateSerialIoUartHandle\n"));
+
+  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++) {
+    DEBUG ((DEBUG_INFO, "UART Index: %d Mode: %d\n", Index, mPchConfigHob->SerialIo.UartDeviceConfig[Index].Mode));
+    if (mPchConfigHob->SerialIo.UartDeviceConfig[Index].Mode == SerialIoUartHidden) {
+      NewHandle = NULL;
+      DeviceId = MmioRead16 (GetSerialIoUartFixedPciCfgAddress (Index) + PCI_DEVICE_ID_OFFSET);
+      DEBUG ((DEBUG_INFO, "Creating Handle for UART DEVICE_ID: 0x%X \n", DeviceId));
+      mSerialIoUartPath.AcpiDev.HID  = 0x5432 + (Index << 16); //UAR
+      mSerialIoUartPath.HidString[4] = (CHAR8)('0' + Index);
+      mSerialIoUartPath.DeviceId     = DeviceId;
+      mSerialIoUartPath.UartIndex    = Index;
+      NewPath = DuplicateDevicePath ((EFI_DEVICE_PATH_PROTOCOL*) &mSerialIoUartPath);
+      Status = gBS->InstallMultipleProtocolInterfaces (
+                      &NewHandle,
+                      &gEfiDevicePathProtocolGuid,
+                      NewPath,
+                      NULL
+                      );
+      DEBUG ((DEBUG_INFO, "CreateSerialIoUartHandle Status: %r\n", Status));
+    }
+  }
+}
+
+/**
+  Stores Pme Control Status and Command register values in S3 Boot Script
+
+  @param[in] S3PciCfgBase      S3 Boot Script Pci Config Base
+  @param[in] Command           Pci Command register data to save
+  @param[in] Pme               Pci Pme Control register data to save
+
+**/
+VOID
+STATIC
+SerialIoS3Save (
+  IN UINTN   S3PciCfgBase,
+  IN UINTN   Command,
+  IN UINTN   Pme
+  )
+{
+  if (S3PciCfgBase != 0) {
+    S3BootScriptSavePciCfgWrite (S3BootScriptWidthUint32, S3PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, 1, &Pme);
+    S3BootScriptSavePciCfgWrite (S3BootScriptWidthUint32, S3PciCfgBase + PCI_COMMAND_OFFSET, 1, &Command);
+  }
+}
+
+/**
+  Puts all SerialIo controllers (except UARTs in debug mode) in D3.
+  Clears MemoryEnable for all PCI-mode controllers on S3 resume
+**/
+VOID
+ConfigureSerialIoAtS3Resume (
+  VOID
+  )
+{
+  UINT8     Index;
+  UINTN     S3PciCfgBase;
+  UINT32    Command;
+  UINT32    Pme;
+
+  S3PciCfgBase = 0;
+  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
+    SerialIoSpiS3Handler (Index, &mPchConfigHob->SerialIo.SpiDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
+    SerialIoS3Save (S3PciCfgBase, Command, Pme);
+  }
+
+  S3PciCfgBase = 0;
+  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
+    SerialIoI2cS3Handler (Index, &mPchConfigHob->SerialIo.I2cDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
+    SerialIoS3Save (S3PciCfgBase, Command, Pme);
+  }
+
+  S3PciCfgBase = 0;
+  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++) {
+    SerialIoUartS3Handler (Index, &mPchConfigHob->SerialIo.UartDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
+    SerialIoS3Save (S3PciCfgBase, Command, Pme);
+  }
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c
new file mode 100644
index 0000000000..786ce13915
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c
@@ -0,0 +1,266 @@
+/** @file
+  Gbe Sx handler implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include <Library/TimerLib.h>
+#include "PchInitSmm.h"
+#include <Library/PmcPrivateLib.h>
+#include <Library/GbeMdiLib.h>
+#include <Library/GbeLib.h>
+#include <Register/PchRegs.h>
+#include <Register/GbeRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+
+/**
+  Configure WOL during Sx entry.
+
+  @param [in]  GbeBar   GbE MMIO space
+**/
+VOID
+GbeWolWorkaround (
+  IN      UINT32  GbeBar
+  )
+{
+  UINT32      RAL0;
+  UINT32      RAH0;
+  UINT16      WUC;
+  EFI_STATUS  Status;
+  UINT16      Data16;
+
+  //
+  // 1. Set page to 769 Port Control Registers
+  // 2. Wait 4 mSec
+  //
+  Status = GbeMdiSetPage (GbeBar, PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 3. Set registry to 17 Port General Configuration
+  // 4. Copy all settings from Port General Configuration
+  //
+  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), &Data16);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 5. Modify BIT 4 and BIT 2 to disable host wake up and set MACPD
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), (Data16 | B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE) & (~B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP));
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 6. Read Receive Address Low and Receive Address High from MMIO
+  //
+  RAL0 = MmioRead32 (GbeBar + R_GBE_MEM_CSR_RAL);
+  RAH0 = MmioRead32 (GbeBar + R_GBE_MEM_CSR_RAH);
+
+  //
+  // 7. Set page to 800 Wake Up Registers
+  // 8. Wait 4 mSec
+  //
+  Status = GbeMdiSetPage (GbeBar, PHY_MDI_PAGE_800_WAKE_UP_REGISTERS);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 9. Set registry to 16 Receive Address Low 1/2
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_800_REGISETER_16_RAL0);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 10. Program first 16 bits [0:15] out of 48 in Receive Address Low 1/2
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAL0 & 0xFFFF));
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 11. Set registry to 17 Receive Address Low 2/2
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_800_REGISETER_17_RAL1);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 12. Program second 16 bits [16:31] out of 48 in Receive Address Low 2/2
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAL0 >> 16));
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 13. Set registry to 18 Receive Address High 1/2
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_800_REGISETER_18_RAH0);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 14. Program last 16 bits [32:47] out of 48
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAH0 & B_GBE_MEM_CSR_RAH_RAH));
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 15. Set registry to 19 Receive Address High 2/2
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_800_REGISETER_19_RAH1);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 16. Set Address Valid
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, B_PHY_MDI_PAGE_800_REGISETER_19_RAH1_ADDRESS_VALID);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 17. Set Wake Up Control Register 1
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_800_REGISETER_1_WUC);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 18. Copy WakeUp Control from MAC MMIO
+  //
+  WUC = (UINT16) MmioRead32 (GbeBar + R_GBE_MEM_CSR_WUC);
+
+  //
+  // 19. Store WakeUp Contorl into LCD
+  // Modify APME bit to enable APM wake up
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (WUC & 0xFFFF));
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 20. Set page to 803 Host Wol Packet
+  // 21. Wait 4 mSec
+  //
+  Status = GbeMdiSetPage (GbeBar, PHY_MDI_PAGE_803_HOST_WOL_PACKET);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 22. Set registry to 66 Host WoL Packet Clear
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_803_REGISETER_66_HWPC);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 23. Clear WOL Packet
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, R_PHY_MDI_PHY_REG_DATA_READ_WRITE, 0);
+  if (EFI_ERROR (Status)) return;
+  //
+  // 24. Set page to 769 Port Control Registers
+  // 25. Wait 4 mSec
+  //
+  Status = GbeMdiSetPage (GbeBar, PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 26. Set registry to 17 Port General Configuration
+  //
+  Status = GbeMdiSetRegister (GbeBar, R_PHY_MDI_PAGE_769_REGISETER_17_PGC);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 27. Copy all settings from Port General Configuration
+  //
+  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), &Data16);
+  if (EFI_ERROR (Status)) return;
+
+  //
+  // 28. Modify BIT 4 and BIT 2 to enable host wake up and clear MACPD
+  //
+  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01, MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), (Data16 | B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP) & (~B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE));
+  if (EFI_ERROR (Status)) return;
+}
+
+/**
+  Additional Internal GbE Controller special cases WOL Support.
+
+  System BIOS is required perform additional steps upon S0 to S3,4,5 transition
+  when ME is off and GbE device in D0. This is needed to enable LAN wake
+  in particular when platform is shut-down from EFI.
+**/
+VOID
+GbeSxWorkaround (
+  VOID
+  )
+{
+  UINT64      LanRegBase;
+  UINT32      GbeBar;
+  EFI_STATUS  Status;
+
+  LanRegBase = GbePciCfgBase ();
+
+  if (PciSegmentRead16 (LanRegBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    return;
+  }
+
+  //
+  // Check if GbE device is in D0
+  //
+  if ((PciSegmentRead16 (LanRegBase + R_GBE_CFG_PMCS) & B_GBE_CFG_PMCS_PS) != V_GBE_CFG_PMCS_PS0) {
+    return;
+  }
+
+  ASSERT (mResvMmioSize >= (1 << N_GBE_CFG_MBARA_ALIGN));
+  GbeBar = (UINT32) mResvMmioBaseAddr;
+  if (GbeBar == 0) {
+    ASSERT (FALSE);
+    return;
+  }
+
+  //
+  // Enable MMIO decode using reserved range.
+  //
+  PciSegmentAnd16 (LanRegBase + PCI_COMMAND_OFFSET, (UINT16) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+  PciSegmentWrite32 (LanRegBase + R_GBE_CFG_MBARA, GbeBar);
+  PciSegmentOr16 (LanRegBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+
+  //
+  // If MBARA offset 5800h [0] = 1b then proceed with the w/a
+  //
+  if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_WUC) & B_GBE_MEM_CSR_WUC_APME) {
+    Status = GbeMdiAcquireMdio (GbeBar);
+    ASSERT_EFI_ERROR (Status);
+    if (!EFI_ERROR (Status)) {
+      GbeWolWorkaround (GbeBar);
+      GbeMdiReleaseMdio (GbeBar);
+    }
+  }
+
+  //
+  // Disable MMIO decode.
+  //
+  PciSegmentAnd16 (LanRegBase + PCI_COMMAND_OFFSET, (UINT16) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+  PciSegmentWrite32 (LanRegBase + R_GBE_CFG_MBARA, 0);
+}
+
+/**
+  Enable platform wake from LAN when in DeepSx if platform supports it.
+  Called upon Sx entry.
+**/
+VOID
+GbeConfigureDeepSxWake (
+  VOID
+  )
+{
+  if (PmcIsLanDeepSxWakeEnabled ()) {
+    IoOr32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_GPE0_EN_127_96), (UINT32) B_ACPI_IO_GPE0_EN_127_96_LAN_WAKE);
+  }
+}
+
+/**
+  GbE Sx entry handler
+**/
+VOID
+PchLanSxCallback (
+  VOID
+  )
+{
+  if (IsGbeEnabled ()) {
+    GbeSxWorkaround ();
+    GbeConfigureDeepSxWake ();
+
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
new file mode 100644
index 0000000000..f435af434a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
@@ -0,0 +1,137 @@
+/** @file
+  PCH BIOS Write Protect Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchInitSmm.h"
+#include <Register/PchRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/SpiRegs.h>
+#include <Library/SpiAccessPrivateLib.h>
+#include <Library/PchPciBdfLib.h>
+
+//
+// Global variables
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_TCO_SMI_DISPATCH_PROTOCOL     *mPchTcoSmiDispatchProtocol;
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_ESPI_SMI_DISPATCH_PROTOCOL    *mEspiSmmDispatchProtocol;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT64                            mLpcRegBase;
+
+/**
+  This hardware SMI handler will be run every time the BIOS Write Enable bit is set.
+
+  @param[in] DispatchHandle       Not used
+**/
+VOID
+EFIAPI
+PchSpiBiosWpCallback (
+  IN  EFI_HANDLE                              DispatchHandle
+  )
+{
+  SpiClearBiosWriteProtectDisable ();
+}
+
+/**
+  This hardware SMI handler will be run every time the BIOS Write Enable bit is set.
+
+  @param[in] DispatchHandle       Not used
+
+**/
+VOID
+EFIAPI
+PchLpcBiosWpCallback (
+  IN  EFI_HANDLE                              DispatchHandle
+  )
+{
+  //
+  // Disable BIOSWE bit to protect BIOS
+  //
+  PciSegmentAnd8 ((UINTN) (mLpcRegBase + R_LPC_CFG_BC), (UINT8) ~B_LPC_CFG_BC_WPD);
+}
+
+/**
+  Entry point for Pch Bios Write Protect driver.
+
+  @param[in] ImageHandle          Image handle of this driver.
+  @param[in] SystemTable          Global system service table.
+
+  @retval EFI_SUCCESS             Initialization complete.
+**/
+EFI_STATUS
+EFIAPI
+InstallPchBiosWriteProtect (
+  IN EFI_HANDLE            ImageHandle,
+  IN EFI_SYSTEM_TABLE      *SystemTable
+  )
+{
+  EFI_STATUS              Status;
+  EFI_HANDLE              Handle;
+
+  DEBUG ((DEBUG_INFO, "InstallPchBiosWriteProtect()\n"));
+
+  if (mPchConfigHob->LockDown.BiosLock != TRUE) {
+    return EFI_SUCCESS;
+  }
+
+  mLpcRegBase = LpcPciCfgBase ();
+
+  DEBUG ((DEBUG_INFO, "Installing BIOS Write Protect SMI handler\n"));
+  //
+  // Get the PCH TCO SMM dispatch protocol
+  //
+  mPchTcoSmiDispatchProtocol = NULL;
+  Status = gSmst->SmmLocateProtocol (&gPchTcoSmiDispatchProtocolGuid, NULL, (VOID **) &mPchTcoSmiDispatchProtocol);
+  ASSERT_EFI_ERROR (Status);
+  //
+  // Always register an SPI BiosWp callback function to handle TCO BIOSWR SMI
+  // NOTE: No matter the BIOS resides behind SPI or not, it needs to handle the SPI BIOS WP SMI
+  //       to avoid SMI deadloop on SPI WPD write.
+  //
+  Handle = NULL;
+  Status = mPchTcoSmiDispatchProtocol->SpiBiosWpRegister (
+                                         mPchTcoSmiDispatchProtocol,
+                                         PchSpiBiosWpCallback,
+                                         &Handle
+                                         );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Always register an LPC/eSPI BiosWp callback function to handle TCO BIOSWR SMI
+  // NOTE: No matter the BIOS resides behind LPC/eSPI or not, it needs to handle the BIOS WP SMI
+  //       to avoid SMI deadloop on LPC/eSPI WPD write.
+  //
+  if (IsEspiEnabled ()) {
+    //
+    // Get the PCH ESPI SMM dispatch protocol
+    //
+    mEspiSmmDispatchProtocol = NULL;
+    Status = gSmst->SmmLocateProtocol (&gPchEspiSmiDispatchProtocolGuid, NULL, (VOID **) &mEspiSmmDispatchProtocol);
+    ASSERT_EFI_ERROR (Status);
+
+    //
+    // Register an ESpiBiosWp callback function to handle BIOSWR SMI
+    //
+    Handle = NULL;
+    Status = mEspiSmmDispatchProtocol->BiosWrProtectRegister (
+                                         mEspiSmmDispatchProtocol,
+                                         PchLpcBiosWpCallback,
+                                         &Handle
+                                         );
+    ASSERT_EFI_ERROR (Status);
+  } else {
+    //
+    // Register an LPC BiosWp callback function to handle TCO BIOSWR SMI
+    //
+    Handle = NULL;
+    Status = mPchTcoSmiDispatchProtocol->LpcBiosWpRegister (
+                                           mPchTcoSmiDispatchProtocol,
+                                           PchLpcBiosWpCallback,
+                                           &Handle
+                                           );
+    ASSERT_EFI_ERROR (Status);
+  }
+
+  return EFI_SUCCESS;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
new file mode 100644
index 0000000000..f3d11ab204
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
@@ -0,0 +1,33 @@
+/** @file
+  PCH HD Audio Sx handler implementation.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include "PchInitSmm.h"
+#include <Register/PchRegs.h>
+#include <Register/HdaRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT64  mHdaPciBase;
+GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN mHdaCodecSxWakeCapability = FALSE;
+
+/**
+  Updates Codec Sx Wake Capability setting: disabled/enabled
+**/
+VOID
+UpdateHdaCodecSxWakeCapabilitySetting (
+  VOID
+  )
+{
+  mHdaPciBase = HdaPciCfgBase ();
+
+  if ((mPchConfigHob->HdAudio.CodecSxWakeCapability == FALSE) ||
+      (PciSegmentRead16 (mHdaPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF)) {
+    mHdaCodecSxWakeCapability = FALSE;
+  } else {
+    mHdaCodecSxWakeCapability = TRUE;
+  }
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c
new file mode 100644
index 0000000000..9c2475e3a1
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c
@@ -0,0 +1,285 @@
+/** @file
+  PCH Init Smm module for PCH specific SMI handlers.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchInitSmm.h"
+#include <Register/PchRegs.h>
+#include <Register/UsbRegs.h>
+#include <Register/SmbusRegs.h>
+#include <Library/PchPciBdfLib.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA                              *mPchNvsArea;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                                    mAcpiBaseAddr;
+
+GLOBAL_REMOVE_IF_UNREFERENCED FIVR_EXT_RAIL_CONFIG                      mFivrExtVnnRailSxConfig;
+
+//
+// NOTE: The module variables of policy here are only valid in post time, but not runtime time.
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_CONFIG_HOB                            *mPchConfigHob;
+
+//
+// The reserved MMIO range to be used in Sx handler
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_PHYSICAL_ADDRESS                      mResvMmioBaseAddr;
+GLOBAL_REMOVE_IF_UNREFERENCED UINTN                                     mResvMmioSize;
+
+/**
+  SMBUS Sx entry SMI handler.
+**/
+VOID
+SmbusSxCallback (
+  VOID
+  )
+{
+  UINT64                      SmbusRegBase;
+  UINT16                      SmbusIoBase;
+
+  SmbusRegBase = SmbusPciCfgBase ();
+
+  if (PciSegmentRead32 (SmbusRegBase) == 0xFFFFFFFF) {
+    return;
+  }
+
+  SmbusIoBase = PciSegmentRead16 (SmbusRegBase + R_SMBUS_CFG_BASE) & B_SMBUS_CFG_BASE_BAR;
+  if (SmbusIoBase == 0) {
+    return;
+  }
+
+  PciSegmentOr8 (SmbusRegBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_IO_SPACE);
+  //
+  // Clear SMBUS status and SMB_WAK_STS of GPE0
+  //
+  IoWrite8 (SmbusIoBase + R_SMBUS_IO_HSTS, B_SMBUS_IO_SMBALERT_STS);
+  IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96, B_ACPI_IO_GPE0_STS_127_96_SMB_WAK);
+}
+
+/*
+  PCH xHCI Sx entry SMI handler
+*/
+VOID
+PchXhciSxCallback (
+  VOID
+  )
+{
+  UINTN      XhciPciBase;
+
+  XhciPciBase = PchXhciPciCfgBase ();
+
+  //
+  // Safety check for xHCI existense
+  //
+  if (PciSegmentRead32 (XhciPciBase) == 0xFFFFFFFF) {
+    return;
+  }
+
+  //
+  // If xHCI is in D0 that means OS didn't put it to D3 during Sx entry i.e. USB kernel debug is enabled.
+  // Unless it is put manually to D3, USB wake functionality will not work.
+  //
+  if ((PciSegmentRead8 (XhciPciBase + R_XHCI_CFG_PWR_CNTL_STS) & V_XHCI_CFG_PWR_CNTL_STS_PWR_STS_D3) == 0) {
+    //
+    // Put device to D3 to enable wake functionality for USB devices
+    //
+    PciSegmentOr8 (XhciPciBase + R_XHCI_CFG_PWR_CNTL_STS, (UINT8)(B_XHCI_CFG_PWR_CNTL_STS_PWR_STS));
+  }
+}
+
+/**
+  Cache PCH FIVR policy.
+**/
+VOID
+UpdatePchFivrSettings (
+  VOID
+  )
+{
+  CopyMem (
+    &mFivrExtVnnRailSxConfig,
+    &mPchConfigHob->Fivr.ExtVnnRailSx,
+    sizeof (mFivrExtVnnRailSxConfig)
+    );
+}
+
+/**
+  PCH Sx entry SMI handler.
+
+  @param[in]     Handle          Handle of the callback
+  @param[in]     Context         The dispatch context
+  @param[in,out] CommBuffer      A pointer to a collection of data in memory that will
+                                 be conveyed from a non-SMM environment into an SMM environment.
+  @param[in,out] CommBufferSize  The size of the CommBuffer.
+
+  @retval EFI_SUCCESS
+**/
+EFI_STATUS
+EFIAPI
+PchSxHandler (
+  IN  EFI_HANDLE                   Handle,
+  IN CONST VOID                    *Context OPTIONAL,
+  IN OUT VOID                      *CommBuffer OPTIONAL,
+  IN OUT UINTN                     *CommBufferSize OPTIONAL
+  )
+{
+  PchLanSxCallback ();
+  PchXhciSxCallback ();
+
+  SmbusSxCallback ();
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialize PCH Sx entry SMI handler.
+
+  @param[in] ImageHandle - Handle for the image of this driver
+**/
+VOID
+InitializeSxHandler (
+  IN EFI_HANDLE        ImageHandle
+  )
+{
+  EFI_SMM_SX_REGISTER_CONTEXT               SxDispatchContext;
+  EFI_HANDLE                                SxDispatchHandle;
+  EFI_SLEEP_TYPE                            SxType;
+  EFI_STATUS                                Status;
+
+  DEBUG ((DEBUG_INFO, "InitializeSxHandler() Start\n"));
+
+  //
+  // Register the callback for S3/S4/S5 entry
+  //
+  SxDispatchContext.Phase = SxEntry;
+  for (SxType = SxS3; SxType <= SxS5; SxType++) {
+    SxDispatchContext.Type  = SxType;
+    Status = mSxDispatch->Register (
+                            mSxDispatch,
+                            PchSxHandler,
+                            &SxDispatchContext,
+                            &SxDispatchHandle
+                            );
+    ASSERT_EFI_ERROR (Status);
+  }
+
+  DEBUG ((DEBUG_INFO, "InitializeSxHandler() End\n"));
+}
+
+/**
+  Allocates reserved MMIO for Sx SMI handler use.
+**/
+VOID
+AllocateReservedMmio (
+  VOID
+  )
+{
+  mResvMmioBaseAddr = PcdGet32 (PcdSiliconInitTempMemBaseAddr);
+  mResvMmioSize     = PcdGet32 (PcdSiliconInitTempMemSize);
+  DEBUG ((DEBUG_INFO, "mResvMmioBaseAddr %x, mResvMmioSize %x\n", mResvMmioBaseAddr, mResvMmioSize));
+}
+
+/**
+  Initializes the PCH SMM handler for for PCIE hot plug support
+  <b>PchInit SMM Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+      The PchInitSmm module is a SMM driver that initializes the Intel Platform Controller Hub
+      SMM requirements and services. It consumes the PCH_POLICY_HOB and SI_POLICY_HOB for expected
+      configurations per policy.
+
+  - <b>Details</b>\n
+    This module provides SMI handlers to services PCIE HotPlug SMI, LinkActive SMI, and LinkEq SMI.
+    And also provides port 0x61 emulation support, registers BIOS WP handler to process BIOSWP status,
+    and registers SPI Async SMI handler to handler SPI Async SMI.
+    This module also registers Sx SMI callback function to detail with GPIO Sx Isolation and LAN requirement.
+
+  - @pre
+    - PCH PCR base address configured
+    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
+      - This is to ensure that PCI MMIO and IO resource has been prepared and available for this driver to allocate.
+    - EFI_SMM_BASE2_PROTOCOL
+    - EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
+    - EFI_SMM_SX_DISPATCH2_PROTOCOL
+    - EFI_SMM_CPU_PROTOCOL
+    - @link _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL PCH_SMM_IO_TRAP_CONTROL_PROTOCOL @endlink
+    - @link _PCH_SMI_DISPATCH_PROTOCOL PCH_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_PCIE_SMI_DISPATCH_PROTOCOL PCH_PCIE_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_TCO_SMI_DISPATCH_PROTOCOL PCH_TCO_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_ESPI_SMI_DISPATCH_PROTOCOL PCH_ESPI_SMI_DISPATCH_PROTOCOL @endlink
+
+  - <b>References</b>\n
+    - @link _PCH_POLICY PCH_POLICY_HOB @endlink.
+    - @link _SI_POLICY_STRUCT SI_POLICY_HOB @endlink.
+
+  - <b>Integration Checklists</b>\n
+    - Verify prerequisites are met. Porting Recommendations.
+    - No modification of this module should be necessary
+    - Any modification of this module should follow the PCH BIOS Specification and EDS
+
+  @param[in] ImageHandle - Handle for the image of this driver
+  @param[in] SystemTable - Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS    - PCH SMM handler was installed
+**/
+EFI_STATUS
+EFIAPI
+PchInitSmmEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS                                Status;
+  PCH_NVS_AREA_PROTOCOL                     *PchNvsAreaProtocol;
+  EFI_PEI_HOB_POINTERS                      HobPtr;
+
+  DEBUG ((DEBUG_INFO, "PchInitSmmEntryPoint()\n"));
+
+  Status = gSmst->SmmLocateProtocol (
+                    &gEfiSmmIoTrapDispatch2ProtocolGuid,
+                    NULL,
+                    (VOID **) &mPchIoTrap
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gSmst->SmmLocateProtocol (
+                    &gEfiSmmSxDispatch2ProtocolGuid,
+                    NULL,
+                    (VOID**) &mSxDispatch
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID **) &PchNvsAreaProtocol);
+  ASSERT_EFI_ERROR (Status);
+  mPchNvsArea = PchNvsAreaProtocol->Area;
+
+  //
+  // Get PCH Data HOB.
+  //
+  HobPtr.Guid   = GetFirstGuidHob (&gPchConfigHobGuid);
+  ASSERT (HobPtr.Guid != NULL);
+  mPchConfigHob = (PCH_CONFIG_HOB *) GET_GUID_HOB_DATA (HobPtr.Guid);
+
+  mAcpiBaseAddr = PmcGetAcpiBase ();
+
+  AllocateReservedMmio ();
+
+  InitializeSxHandler (ImageHandle);
+
+  Status = InitializePchPcieSmm (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = InstallPchBiosWriteProtect (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = InstallPchSpiAsyncSmiHandler ();
+  ASSERT_EFI_ERROR (Status);
+
+  UpdateHdaCodecSxWakeCapabilitySetting ();
+
+  UpdatePchFivrSettings ();
+
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h
new file mode 100644
index 0000000000..c2a09acd11
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h
@@ -0,0 +1,254 @@
+/** @file
+  Header file for PCH Init SMM Handler
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_INIT_SMM_H_
+#define _PCH_INIT_SMM_H_
+
+#include <PiDxe.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Protocol/SmmSxDispatch2.h>
+#include <Protocol/SmmIoTrapDispatch2.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/HobLib.h>
+#include <Protocol/SmmCpu.h>
+#include <Library/TimerLib.h>
+
+#include <IndustryStandard/Pci30.h>
+#include <Library/PmcLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/SataLib.h>
+#include <Library/GpioLib.h>
+#include <Library/GpioNativeLib.h>
+#include <Library/EspiLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/ConfigBlockLib.h>
+#include <Library/PciExpressHelpersLib.h>
+#include <Protocol/PchPcieSmiDispatch.h>
+#include <Protocol/PchTcoSmiDispatch.h>
+#include <Protocol/PchSmiDispatch.h>
+#include <Protocol/PchEspiSmiDispatch.h>
+#include <Protocol/PchSmmIoTrapControl.h>
+#include <Protocol/PchNvsArea.h>
+#include <Protocol/PcieIoTrap.h>
+#include <SiConfigHob.h>
+#include <PchConfigHob.h>
+#include <Library/PmcPrivateLib.h>
+
+extern EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
+extern EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
+
+extern PCH_NVS_AREA                              *mPchNvsArea;
+extern UINT16                                    mAcpiBaseAddr;
+
+extern EFI_PHYSICAL_ADDRESS                      mResvMmioBaseAddr;
+extern UINTN                                     mResvMmioSize;
+
+//
+// NOTE: The module variables of policy here are only valid in post time, but not runtime time.
+//
+extern PCH_CONFIG_HOB                            *mPchConfigHob;
+extern SI_CONFIG_HOB_DATA                        *mSiConfigHobData;
+
+/**
+  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
+
+  @param[in] ImageHandle          The image handle of this module
+  @param[in] SystemTable          The EFI System Table
+
+  @retval EFI_SUCCESS             The function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+InitializePchPcieSmm (
+  IN      EFI_HANDLE            ImageHandle,
+  IN      EFI_SYSTEM_TABLE      *SystemTable
+  );
+
+/**
+  Program Common Clock and ASPM of Downstream Devices
+
+  @param[in] PortIndex                  Pcie Root Port Number
+  @param[in] RpDevice                   Pcie Root Pci Device Number
+  @param[in] RpFunction                 Pcie Root Pci Function Number
+
+  @retval EFI_SUCCESS                   Root port complete successfully
+  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
+**/
+EFI_STATUS
+PchPcieSmi (
+  IN  UINT8                             PortIndex,
+  IN  UINT8                             RpDevice,
+  IN  UINT8                             RpFunction
+  );
+
+/**
+  PCIE Hotplug SMI call back function for each Root port
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieSmiRpHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  );
+
+/**
+  PCIE Link Active State Change Hotplug SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieLinkActiveStateChange (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  );
+
+/**
+  PCIE Link Equalization Request SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieLinkEqHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  );
+
+/**
+  An IoTrap callback to config PCIE power management settings
+
+  @param[in] DispatchHandle  - The handle of this callback, obtained when registering
+  @param[in] DispatchContext - Pointer to the EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
+
+**/
+VOID
+EFIAPI
+PchPcieIoTrapSmiCallback (
+  IN     EFI_HANDLE                     DispatchHandle,
+  IN     EFI_SMM_IO_TRAP_CONTEXT        *CallbackContext,
+  IN OUT VOID                           *CommBuffer,
+  IN OUT UINTN                          *CommBufferSize
+  );
+
+/**
+  Initializes the PCH SMM handler for PCH save and restore
+
+  @param[in] ImageHandle - Handle for the image of this driver
+  @param[in] SystemTable - Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS    - PCH SMM handler was installed
+**/
+EFI_STATUS
+EFIAPI
+PchInitLateSmm (
+  IN      EFI_HANDLE            ImageHandle,
+  IN      EFI_SYSTEM_TABLE      *SystemTable
+  );
+
+/**
+  Initialize PCH Sx entry SMI handler.
+
+  @param[in] ImageHandle - Handle for the image of this driver
+**/
+VOID
+InitializeSxHandler (
+  IN EFI_HANDLE        ImageHandle
+  );
+
+/**
+  PCH Sx entry SMI handler.
+
+  @param[in]     Handle          Handle of the callback
+  @param[in]     Context         The dispatch context
+  @param[in,out] CommBuffer      A pointer to a collection of data in memory that will
+                                 be conveyed from a non-SMM environment into an SMM environment.
+  @param[in,out] CommBufferSize  The size of the CommBuffer.
+
+  @retval EFI_SUCCESS
+**/
+
+EFI_STATUS
+EFIAPI
+PchSxHandler (
+  IN  EFI_HANDLE                   Handle,
+  IN CONST VOID                    *Context OPTIONAL,
+  IN OUT VOID                      *CommBuffer OPTIONAL,
+  IN OUT UINTN                     *CommBufferSize OPTIONAL
+  );
+
+/**
+  GbE Sx entry handler
+**/
+VOID
+PchLanSxCallback (
+  VOID
+  );
+
+/**
+  Updates Codec Sx Wake Capability setting: disabled/enabled
+**/
+VOID
+UpdateHdaCodecSxWakeCapabilitySetting (
+  VOID
+  );
+
+/**
+  Register dispatch function to handle GPIO pads Sx isolation
+**/
+VOID
+InitializeGpioSxIsolationSmm (
+  VOID
+  );
+
+/**
+  Entry point for Pch Bios Write Protect driver.
+
+  @param[in] ImageHandle          Image handle of this driver.
+  @param[in] SystemTable          Global system service table.
+
+  @retval EFI_SUCCESS             Initialization complete.
+**/
+EFI_STATUS
+EFIAPI
+InstallPchBiosWriteProtect (
+  IN EFI_HANDLE            ImageHandle,
+  IN EFI_SYSTEM_TABLE      *SystemTable
+  );
+
+/**
+  This fuction install SPI ASYNC SMI handler.
+
+  @retval EFI_SUCCESS             Initialization complete.
+**/
+EFI_STATUS
+EFIAPI
+InstallPchSpiAsyncSmiHandler (
+  VOID
+  );
+
+
+
+
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf
new file mode 100644
index 0000000000..aaf36a7b2a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf
@@ -0,0 +1,110 @@
+## @file
+# Component description file for PchInitSmm driver
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PchInitSmm
+FILE_GUID = D7B10D4E-67E6-4C74-83E9-F9AF0ACC33CC
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_SMM_DRIVER
+PI_SPECIFICATION_VERSION = 1.10
+ENTRY_POINT = PchInitSmmEntryPoint
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64
+#
+
+
+[LibraryClasses]
+UefiBootServicesTableLib
+UefiDriverEntryPoint
+DxeServicesTableLib
+IoLib
+DebugLib
+BaseLib
+BaseMemoryLib
+S3BootScriptLib
+PciExpressHelpersLib
+SmmServicesTableLib
+PciSegmentLib
+HobLib
+GpioLib
+GpioPrivateLib
+ReportStatusCodeLib
+DevicePathLib
+PmcLib
+PchPcieRpLib
+PchInfoLib
+EspiLib
+TimerLib
+ConfigBlockLib
+PmcPrivateLib
+SataLib
+GbeLib
+GbeMdiLib
+SpiAccessPrivateLib
+PchPciBdfLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemSize
+
+
+[Sources]
+PchInitSmm.c
+PchPcieSmm.c
+GbeSxSmm.c
+PchInitSmm.h
+PchBiosWriteProtect.c
+PchSpiAsync.c
+PchHdaSxSmm.c
+
+
+[Protocols]
+gEfiSmmIoTrapDispatch2ProtocolGuid ## CONSUMES
+gEfiSmmSxDispatch2ProtocolGuid ## CONSUMES
+gPchSmmIoTrapControlGuid ## CONSUMES
+gEfiSmmCpuProtocolGuid ## CONSUMES
+gPchNvsAreaProtocolGuid ## CONSUMES
+gPchPcieSmiDispatchProtocolGuid ## CONSUMES
+gPchTcoSmiDispatchProtocolGuid ## CONSUMES
+gPchSmiDispatchProtocolGuid ## CONSUMES
+gPchEspiSmiDispatchProtocolGuid ## CONSUMES
+gPchPcieIoTrapProtocolGuid ## PRODUCES
+gPchPolicyProtocolGuid ##CONSUMES
+
+
+[Guids]
+gSiConfigHobGuid             ## CONSUMES
+gPchConfigHobGuid            ## CONSUMES
+gPchDeviceTableHobGuid
+gPchPcieRpDxeConfigGuid         ## CONSUMES
+
+
+[Depex]
+gEfiSmmIoTrapDispatch2ProtocolGuid AND
+gEfiSmmSxDispatch2ProtocolGuid AND
+gPchSmmIoTrapControlGuid AND
+gPchPcieSmiDispatchProtocolGuid AND
+gPchTcoSmiDispatchProtocolGuid AND
+gEfiSmmCpuProtocolGuid AND
+gPchNvsAreaProtocolGuid AND
+gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure that PCI MMIO resource has been prepared and available for this driver to allocate.
+gEfiSmmBase2ProtocolGuid AND # This is for SmmServicesTableLib
+gPchPolicyProtocolGuid
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c
new file mode 100644
index 0000000000..e885a342a7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c
@@ -0,0 +1,451 @@
+/** @file
+  PCH Pcie SMM Driver Entry
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchInitSmm.h"
+#include <PcieRegs.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Library/PcieHelperLib.h>
+#include <Library/PchPciBdfLib.h>
+#include <Protocol/PchPolicy.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE      *mDevAspmOverride;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT32                        mNumOfDevAspmOverride;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                         mPchBusNumber;
+//
+// @note:
+// These temp bus numbers cannot be used in runtime (hot-plug).
+// These can be used only during boot.
+//
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                         mTempRootPortBusNumMin;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                         mTempRootPortBusNumMax;
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_ROOT_PORT_CONFIG     mPcieRootPortConfig[PCH_MAX_PCIE_ROOT_PORTS];
+
+GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN                       mPchPciePmTrapExecuted = FALSE;
+
+extern EFI_GUID gPchDeviceTableHobGuid;
+
+/**
+  Program Common Clock and ASPM of Downstream Devices
+
+  @param[in] PortIndex                  Pcie Root Port Number
+  @param[in] RpDevice                   Pcie Root Pci Device Number
+  @param[in] RpFunction                 Pcie Root Pci Function Number
+
+  @retval EFI_SUCCESS                   Root port complete successfully
+  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
+**/
+EFI_STATUS
+PchPcieSmi (
+  IN  UINT8                             PortIndex,
+  IN  UINT8                             RpDevice,
+  IN  UINT8                             RpFunction
+  )
+{
+  UINT8                 SecBus;
+  UINT8                 SubBus;
+  UINT64                RpBase;
+  UINT64                EpBase;
+  UINT8                 EpPcieCapPtr;
+  UINT8                 EpMaxSpeed;
+  BOOLEAN               DownstreamDevicePresent;
+  UINT32                Timeout;
+
+  RpBase   = PCI_SEGMENT_LIB_ADDRESS (
+               DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+               mPchBusNumber,
+               (UINT32) RpDevice,
+               (UINT32) RpFunction,
+               0
+               );
+
+  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    return EFI_SUCCESS;
+  }
+  //
+  // Check presence detect state. Here the endpoint must be detected using PDS rather than
+  // the usual LinkActive check, because PDS changes immediately and LA takes a few milliseconds to stabilize
+  //
+  DownstreamDevicePresent = !!(PciSegmentRead16 (RpBase + R_PCH_PCIE_CFG_SLSTS) & B_PCIE_SLSTS_PDS);
+
+  if (DownstreamDevicePresent) {
+    ///
+    /// Make sure the link is active before trying to talk to device behind it
+    /// Wait up to 100ms, according to PCIE spec chapter 6.7.3.3
+    ///
+    Timeout = 100 * 1000;
+    while ((PciSegmentRead16 (RpBase + R_PCH_PCIE_CFG_LSTS) & B_PCIE_LSTS_LA) == 0 ) {
+      MicroSecondDelay (10);
+      Timeout-=10;
+      if (Timeout == 0) {
+        return EFI_NOT_FOUND;
+      }
+    }
+    SecBus  = PciSegmentRead8 (RpBase + PCI_BRIDGE_SECONDARY_BUS_REGISTER_OFFSET);
+    SubBus  = PciSegmentRead8 (RpBase + PCI_BRIDGE_SUBORDINATE_BUS_REGISTER_OFFSET);
+    ASSERT (SecBus != 0 && SubBus != 0);
+    RootportDownstreamConfiguration (
+      DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+      DEFAULT_PCI_BUS_NUMBER_PCH,
+      RpDevice,
+      RpFunction,
+      mTempRootPortBusNumMin,
+      mTempRootPortBusNumMax,
+      EnumPchPcie
+      );
+    RootportDownstreamPmConfiguration (
+      DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+      DEFAULT_PCI_BUS_NUMBER_PCH,
+      RpDevice,
+      RpFunction,
+      mTempRootPortBusNumMin,
+      mTempRootPortBusNumMax,
+      &mPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
+      mNumOfDevAspmOverride,
+      mDevAspmOverride
+    );
+    //
+    // Perform Equalization
+    //
+    EpBase = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, SecBus, 0, 0, 0);
+    EpPcieCapPtr = PcieFindCapId (DEFAULT_PCI_SEGMENT_NUMBER_PCH, SecBus, 0, 0, EFI_PCI_CAPABILITY_ID_PCIEXP);
+    EpMaxSpeed = PciSegmentRead8 (EpBase + EpPcieCapPtr + R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_MLS;
+    if (EpMaxSpeed >= 3) {
+      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_EX_LCTL3, B_PCIE_EX_LCTL3_PE);
+      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_LCTL, B_PCIE_LCTL_RL);
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  PCIE Hotplug SMI call back function for each Root port
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieSmiRpHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  PchPcieSmi (RpContext->RpIndex, RpContext->DevNum, RpContext->FuncNum);
+}
+
+/**
+  PCIE Link Active State Change Hotplug SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieLinkActiveStateChange (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  return;
+}
+
+/**
+  PCIE Link Equalization Request SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+PchPcieLinkEqHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  ///
+  /// From PCI Express specification, the PCIe device can request for Link Equalization. When the
+  /// Link Equalization is requested by the device, an SMI will be generated  by PCIe RP when
+  /// enabled and the SMI subroutine would invoke the Software Preset/Coefficient Search
+  /// software to re-equalize the link.
+  ///
+
+  return;
+
+}
+
+/**
+  An IoTrap callback to config PCIE power management settings
+**/
+VOID
+PchPciePmIoTrapSmiCallback (
+  VOID
+  )
+{
+  UINT32                                    PortIndex;
+  UINT64                                    RpBase;
+  UINT8                                     MaxPciePortNum;
+
+  MaxPciePortNum                   = GetPchMaxPciePortNum ();
+
+  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
+    RpBase = PchPcieRpPciCfgBase (PortIndex);
+
+    if (PciSegmentRead16 (RpBase) != 0xFFFF) {
+      RootportDownstreamPmConfiguration (
+        DEFAULT_PCI_SEGMENT_NUMBER_PCH,
+        DEFAULT_PCI_BUS_NUMBER_PCH,
+        PchPcieRpDevNumber (PortIndex),
+        PchPcieRpFuncNumber (PortIndex),
+        mTempRootPortBusNumMin,
+        mTempRootPortBusNumMax,
+        &mPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
+        mNumOfDevAspmOverride,
+        mDevAspmOverride
+      );
+
+    }
+  }
+}
+
+/**
+  An IoTrap callback to config PCIE power management settings
+
+  @param[in] DispatchHandle  - The handle of this callback, obtained when registering
+  @param[in] DispatchContext - Pointer to the EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
+
+**/
+VOID
+EFIAPI
+PchPcieIoTrapSmiCallback (
+  IN  EFI_HANDLE                            DispatchHandle,
+  IN  EFI_SMM_IO_TRAP_CONTEXT                *CallbackContext,
+  IN OUT VOID                               *CommBuffer,
+  IN OUT UINTN                              *CommBufferSize
+  )
+{
+  if (CallbackContext->WriteData == PchPciePmTrap) {
+    if (mPchPciePmTrapExecuted == FALSE) {
+      PchPciePmIoTrapSmiCallback ();
+      mPchPciePmTrapExecuted = TRUE;
+    }
+  } else {
+    ASSERT_EFI_ERROR (EFI_INVALID_PARAMETER);
+  }
+}
+
+/**
+  This function clear the Io trap executed flag before enter S3
+
+  @param[in] Handle    Handle of the callback
+  @param[in] Context   The dispatch context
+
+  @retval EFI_SUCCESS  PCH register saved
+**/
+EFI_STATUS
+EFIAPI
+PchPcieS3EntryCallBack (
+  IN  EFI_HANDLE                        Handle,
+  IN CONST VOID                    *Context OPTIONAL,
+  IN OUT VOID                      *CommBuffer OPTIONAL,
+  IN OUT UINTN                     *CommBufferSize OPTIONAL
+  )
+{
+  mPchPciePmTrapExecuted = FALSE;
+  return EFI_SUCCESS;
+}
+/**
+  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
+
+  @param[in] ImageHandle          The image handle of this module
+  @param[in] SystemTable          The EFI System Table
+
+  @retval EFI_SUCCESS             The function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+InitializePchPcieSmm (
+  IN      EFI_HANDLE            ImageHandle,
+  IN      EFI_SYSTEM_TABLE      *SystemTable
+  )
+{
+  EFI_STATUS                            Status;
+  UINT8                                 PortIndex;
+  UINT8                                 Data8;
+  UINT32                                Data32Or;
+  UINT32                                Data32And;
+  UINT64                                RpBase;
+  EFI_HANDLE                            PcieHandle;
+  PCH_PCIE_SMI_DISPATCH_PROTOCOL        *PchPcieSmiDispatchProtocol;
+  EFI_HANDLE                            PchIoTrapHandle;
+  EFI_SMM_IO_TRAP_REGISTER_CONTEXT      PchIoTrapContext;
+  EFI_SMM_SX_REGISTER_CONTEXT           SxDispatchContext;
+  PCH_PCIE_IOTRAP_PROTOCOL              *PchPcieIoTrapProtocol;
+  EFI_HANDLE                            SxDispatchHandle;
+  UINT8                                 MaxPciePortNum;
+  PCH_POLICY_PROTOCOL                   *PchPolicy;
+  PCIE_RP_DXE_CONFIG                    *PchPcieRpDxeConfig;
+  UINTN                                 PcieDeviceTableSize;
+  PCH_PCIE_DEVICE_OVERRIDE              *DevAspmOverride;
+  UINTN                                 Count;
+
+  DEBUG ((DEBUG_INFO, "InitializePchPcieSmm () Start\n"));
+
+  MaxPciePortNum    = GetPchMaxPciePortNum ();
+
+  //
+  // Locate Pch Pcie Smi Dispatch Protocol
+  //
+  Status = gSmst->SmmLocateProtocol (&gPchPcieSmiDispatchProtocolGuid, NULL, (VOID**) &PchPcieSmiDispatchProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  mPchBusNumber = DEFAULT_PCI_BUS_NUMBER_PCH;
+  mTempRootPortBusNumMin = PcdGet8 (PcdSiliconInitTempPciBusMin);
+  mTempRootPortBusNumMax = PcdGet8 (PcdSiliconInitTempPciBusMax);
+
+  ASSERT (sizeof mPcieRootPortConfig == sizeof mPchConfigHob->PcieRp.RootPort);
+  CopyMem (
+    mPcieRootPortConfig,
+    &(mPchConfigHob->PcieRp.RootPort),
+    sizeof (mPcieRootPortConfig)
+    );
+
+  DevAspmOverride                   = NULL;
+  mDevAspmOverride                  = NULL;
+  mNumOfDevAspmOverride             = 0;
+
+  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID **) &PchPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = GetConfigBlock ((VOID*) PchPolicy, &gPchPcieRpDxeConfigGuid, (VOID*) &PchPcieRpDxeConfig);
+  ASSERT_EFI_ERROR (Status);
+
+  DevAspmOverride = PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr;
+
+  Count = 0;
+  if (DevAspmOverride != NULL) {
+    for (Count = 0; DevAspmOverride[Count].DeviceId != 0; Count++) {}
+  }
+
+  if (Count !=0) {
+    PcieDeviceTableSize = Count * sizeof (PCH_PCIE_DEVICE_OVERRIDE);
+    Status = gSmst->SmmAllocatePool (
+                      EfiRuntimeServicesData,
+                      PcieDeviceTableSize,
+                      (VOID **) &mDevAspmOverride
+                      );
+    ASSERT_EFI_ERROR (Status);
+    CopyMem (mDevAspmOverride, DevAspmOverride, PcieDeviceTableSize);
+    mNumOfDevAspmOverride = (UINT32) Count;
+  }
+  //
+  // Throught all PCIE root port function and register the SMI Handler for enabled ports.
+  //
+  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
+    RpBase = PchPcieRpPciCfgBase (PortIndex);
+    //
+    // Skip the root port function which is not enabled
+    //
+    if (PciSegmentRead32 (RpBase) == 0xFFFFFFFF) {
+      continue;
+    }
+
+    //
+    // Register SMI Handlers for Hot Plug and Link Active State Change
+    //
+    Data8 = PciSegmentRead8 (RpBase + R_PCH_PCIE_CFG_SLCAP);
+    if (Data8 & B_PCIE_SLCAP_HPC) {
+      PcieHandle = NULL;
+      Status = PchPcieSmiDispatchProtocol->HotPlugRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             PchPcieSmiRpHandlerFunction,
+                                             PortIndex,
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+
+      Status = PchPcieSmiDispatchProtocol->LinkActiveRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             PchPcieLinkActiveStateChange,
+                                             PortIndex,
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+
+      Data32Or  = B_PCH_PCIE_CFG_MPC_HPME;
+      Data32And = (UINT32) ~B_PCH_PCIE_CFG_MPC_HPME;
+      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_MPC, Data32Or);
+      S3BootScriptSaveMemReadWrite (
+        S3BootScriptWidthUint32,
+        PcdGet64 (PcdSiPciExpressBaseAddress) + RpBase + R_PCH_PCIE_CFG_MPC,
+        &Data32Or,  /// Data to be ORed
+        &Data32And  /// Data to be ANDed
+        );
+    }
+
+    //
+    // Register SMI Handler for Link Equalization Request from Gen 3 Devices.
+    //
+    Data8 = PciSegmentRead8 (RpBase + R_PCH_PCIE_CFG_LCAP);
+    if ((Data8 & B_PCIE_LCAP_MLS) == V_PCIE_LCAP_MLS_GEN3) {
+      Status = PchPcieSmiDispatchProtocol->LinkEqRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             PchPcieLinkEqHandlerFunction,
+                                             PortIndex,
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+    }
+  }
+
+  ASSERT_EFI_ERROR (Status);
+
+  PchIoTrapContext.Type     = WriteTrap;
+  PchIoTrapContext.Length   = 4;
+  PchIoTrapContext.Address  = 0;
+  Status = mPchIoTrap->Register (
+                         mPchIoTrap,
+                         (EFI_SMM_HANDLER_ENTRY_POINT2) PchPcieIoTrapSmiCallback,
+                         &PchIoTrapContext,
+                         &PchIoTrapHandle
+                         );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Install the PCH Pcie IoTrap protocol
+  //
+  (gBS->AllocatePool) (EfiBootServicesData, sizeof (PCH_PCIE_IOTRAP_PROTOCOL), (VOID **)&PchPcieIoTrapProtocol);
+  PchPcieIoTrapProtocol->PcieTrapAddress = PchIoTrapContext.Address;
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gPchPcieIoTrapProtocolGuid,
+                  PchPcieIoTrapProtocol,
+                  NULL
+                  );
+
+  //
+  // Register the callback for S3 entry
+  //
+  SxDispatchContext.Type  = SxS3;
+  SxDispatchContext.Phase = SxEntry;
+  Status = mSxDispatch->Register (
+                          mSxDispatch,
+                          PchPcieS3EntryCallBack,
+                          &SxDispatchContext,
+                          &SxDispatchHandle
+                          );
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "InitializePchPcieSmm, IoTrap @ %x () End\n", PchIoTrapContext.Address));
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c
new file mode 100644
index 0000000000..bdae6fe918
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c
@@ -0,0 +1,67 @@
+/** @file
+  PCH SPI Async SMI handler.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchInitSmm.h"
+
+///
+/// Global variables
+///
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMI_DISPATCH_PROTOCOL     *mPchSmiDispatchProtocol;
+
+/**
+  This hardware SMI handler will be run every time the flash write/earse happens.
+
+  @param[in] DispatchHandle       Not used
+
+**/
+VOID
+EFIAPI
+PchSpiAsyncCallback (
+  IN  EFI_HANDLE                              DispatchHandle
+  )
+{
+  //
+  // Dummy SMI handler
+  //
+}
+
+/**
+  This fuction install SPI ASYNC SMI handler.
+
+  @retval EFI_SUCCESS             Initialization complete.
+**/
+EFI_STATUS
+EFIAPI
+InstallPchSpiAsyncSmiHandler (
+  VOID
+  )
+{
+  EFI_STATUS              Status;
+  EFI_HANDLE              Handle;
+
+  DEBUG ((DEBUG_INFO, "InstallPchSpiAsyncSmiHandler()\n"));
+
+  ///
+  /// Get the PCH SMM dispatch protocol
+  ///
+  mPchSmiDispatchProtocol = NULL;
+  Status = gSmst->SmmLocateProtocol (&gPchSmiDispatchProtocolGuid, NULL, (VOID **) &mPchSmiDispatchProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Register an SpiAsync callback function
+  ///
+  Handle = NULL;
+  Status = mPchSmiDispatchProtocol->SpiAsyncRegister (
+                                      mPchSmiDispatchProtocol,
+                                      PchSpiAsyncCallback,
+                                      &Handle
+                                      );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
new file mode 100644
index 0000000000..54a1575f2c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
@@ -0,0 +1,1284 @@
+/** @file
+  Main implementation source file for the Io Trap SMM driver
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Protocol/PchNvsArea.h>
+#include <Library/SmiHandlerProfileLib.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchRegsPsth.h>
+#include <Register/PchDmiRegs.h>
+
+#define GENERIC_IOTRAP_SIZE 0x100
+
+//
+// Module global variables
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE                      mDriverImageHandle;
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE                      mIoTrapHandle;
+
+GLOBAL_REMOVE_IF_UNREFERENCED IO_TRAP_INSTANCE                mIoTrapData;
+GLOBAL_REMOVE_IF_UNREFERENCED IO_TRAP_RECORD                  *mIoTrapRecord;
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA                    *mPchNvsArea;
+
+
+static CONST UINT16             mLengthTable[10] = { 1, 2, 3, 4, 8, 16, 32, 64, 128, 256 };
+
+/**
+  Helper function that encapsulates IoTrap register access.
+  IO trap related register updates must be made in 2 registers, IOTRAP and DMI source decode.
+
+  @param[in] TrapHandlerNum    trap number (0-3)
+  @param[in] Value             value to be written in both registers
+  @param[in] SaveToBootscript  if true, this register write will be saved to bootscript
+
+**/
+VOID
+SetIoTrapLowDword (
+  IN UINT8   TrapHandlerNum,
+  IN UINT32  Value,
+  IN BOOLEAN SaveToBootscript
+  )
+{
+  UINT32  BitMask;
+  UINT32  BitValue;
+  //
+  // To provide sequentially consistent programming model for IO trap
+  // all pending IO cycles must be flushed before enabling and before disabling a trap.
+  // Without this the trap may trigger due to IO cycle issued before the trap is enabled or a cycle issued before the trap is disabled might be missed.
+  // a. Issues a MemRd to PSTH IO Trap Enable bit -> This serves to flush all previous IO cycles.
+  // b. Then only issues a MemWr to PSTH IO Trap Enable == Value
+  // c. Issues another MemRd to PSTH IO Trap Enable bit -> This serves to push the MemWr to PSTH and confirmed that IO Trap is in fact enabled
+  //
+  PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, Value);
+  PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+
+  PchPcrWrite32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8, Value);
+  //
+  // Read back DMI IOTRAP register to enforce ordering so DMI write is completed before any IO reads
+  // from other threads which may occur after this point (after SMI exit).
+  //
+  PchPcrRead32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8);
+  if (SaveToBootscript) {
+    //
+    // Ignore the value check of PCH_PCR_BOOT_SCRIPT_READ
+    //
+    BitMask  = 0;
+    BitValue = 0;
+
+    PCH_PCR_BOOT_SCRIPT_READ (S3BootScriptWidthUint32, PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, &BitMask, &BitValue);
+    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, 1, &Value);
+    PCH_PCR_BOOT_SCRIPT_READ (S3BootScriptWidthUint32, PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, &BitMask, &BitValue);
+    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8, 1, &Value);
+  }
+}
+
+/**
+  Helper function that encapsulates IoTrap register access.
+  IO trap related register updates must be made in 2 registers, IOTRAP and DMI source decode.
+
+  @param[in] TrapHandlerNum    trap number (0-3)
+  @param[in] Value             value to be written in both registers
+  @param[in] SaveToBootscript  if true, this register write will be saved to bootscript
+
+**/
+VOID
+SetIoTrapHighDword (
+  IN UINT8   TrapHandlerNum,
+  IN UINT32  Value,
+  IN BOOLEAN SaveToBootscript
+  )
+{
+  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4, Value);
+  PchPcrWrite32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8 + 4, Value);
+  if (SaveToBootscript) {
+    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4, 1, &Value);
+    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8 + 4, 1, &Value);
+  }
+}
+
+/**
+  Clear pending IOTRAP status.
+  If IOTRAP status is pending and IOTRAP is disabled, then BIOS will not find a match SMI source
+  and will not dispatch any SMI handler for it. The pending status will lead to SMI storm.
+  This prevents that IOTRAP gets triggered by pending IO cycles even after it's disabled.
+
+  @param[in] TrapHandlerNum    trap number (0-3)
+
+**/
+VOID
+ClearPendingIoTrapStatus (
+  IN UINT8   TrapHandlerNum
+  )
+{
+  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPST, (UINT32)(1 << TrapHandlerNum));
+}
+
+/**
+  IO resources allocated to IO traps need to be reported to OS so that they don't get reused.
+  This function makes IO trap allocation data available to ACPI
+
+  @param[in] TrapHandlerNum  trap number (0-3)
+  @param[in] BaseAddress     address of allocated IO resource
+  @param[in] Track           TRUE = resource allocated, FALSE = resource freed
+
+**/
+VOID
+UpdateIoTrapAcpiResources (
+  IN UINT8                TrapHandlerNum,
+  IN EFI_PHYSICAL_ADDRESS BaseAddress,
+  IN BOOLEAN              Track
+  )
+{
+
+  if (Track == TRUE) {
+    mPchNvsArea->IoTrapAddress[TrapHandlerNum] = (UINT16) BaseAddress;
+    mPchNvsArea->IoTrapStatus[TrapHandlerNum] = 1;
+  } else {
+    mPchNvsArea->IoTrapStatus[TrapHandlerNum] = 0;
+  }
+}
+
+/**
+  Get address from IOTRAP low dword.
+
+  @param[in] IoTrapRegLowDword    IOTRAP register low dword
+
+  @retval                         Address of IOTRAP setting.
+**/
+STATIC
+UINT16
+AddressFromLowDword (
+  UINT32  IoTrapRegLowDword
+  )
+{
+  return (UINT16) (IoTrapRegLowDword & B_PSTH_PCR_TRPREG_AD);
+}
+
+/**
+  Get length from IOTRAP low dword.
+
+  @param[in] IoTrapRegLowDword    IOTRAP register low dword
+
+  @retval                         Length of IOTRAP setting.
+**/
+STATIC
+UINT16
+LengthFromLowDword (
+  UINT32  IoTrapRegLowDword
+  )
+{
+  return (UINT16) (((IoTrapRegLowDword >> 16) & 0xFC) + 4);
+}
+
+/**
+  Get ByteEnable from IOTRAP high dword.
+
+  @param[in] IoTrapRegHighDword   IOTRAP register high dword
+
+  @retval                         ByteEnable of IOTRAP setting.
+**/
+STATIC
+UINT8
+ByteEnableFromHighDword (
+  UINT32  IoTrapRegHighDword
+  )
+{
+  return (UINT8) (IoTrapRegHighDword & 0x0F);
+}
+
+/**
+  Get ByteEnableMask from IOTRAP high dword.
+
+  @param[in] IoTrapRegHighDword   IOTRAP register high dword
+
+  @retval                         ByteEnableMask of IOTRAP setting.
+**/
+STATIC
+UINT8
+ByteEnableMaskFromHighDword (
+  UINT32  IoTrapRegHighDword
+  )
+{
+  return (UINT8) ((IoTrapRegHighDword & 0xF0) >> 4);
+}
+
+/**
+  Check the IoTrap register matches the IOTRAP EX content.
+
+  @param[in] IoTrapRecord         IOTRAP registration record structure
+  @param[in] IoTrapRegLowDword    IOTRAP register low dword
+  @param[in] IoTrapRegHighDword   IOTRAP register high dword
+
+  @retval    TRUE                 Content matched
+             FALSE                Content mismatched
+**/
+STATIC
+BOOLEAN
+IsIoTrapExContentMatched (
+  IO_TRAP_RECORD  *IoTrapRecord,
+  UINT32          IoTrapRegLowDword,
+  UINT32          IoTrapRegHighDword
+  )
+{
+  if ((IoTrapRecord->Context.Address == AddressFromLowDword (IoTrapRegLowDword))          &&
+      (IoTrapRecord->Context.Length == LengthFromLowDword (IoTrapRegLowDword))            &&
+      (IoTrapRecord->Context.ByteEnable == ByteEnableFromHighDword (IoTrapRegHighDword))  &&
+      (IoTrapRecord->Context.ByteEnableMask == ByteEnableMaskFromHighDword (IoTrapRegHighDword)))
+  {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+
+/**
+  The helper function for IoTrap callback dispacther
+
+  @param[in] TrapHandlerNum  trap number (0-3)
+**/
+VOID
+IoTrapDispatcherHelper (
+  UINTN                                     TrapHandlerNum
+  )
+{
+  IO_TRAP_RECORD                            *RecordInDb;
+  LIST_ENTRY                                *LinkInDb;
+  EFI_SMM_IO_TRAP_REGISTER_CONTEXT          CurrentIoTrapRegisterData;
+  EFI_SMM_IO_TRAP_CONTEXT                   CurrentIoTrapContextData;
+  UINT16                                    BaseAddress;
+  UINT16                                    StartAddress;
+  UINT16                                    EndAddress;
+  UINT32                                    Data32;
+  UINT8                                     ActiveHighByteEnable;
+  BOOLEAN                                   ReadCycle;
+  UINT32                                    WriteData;
+
+  if (!IsListEmpty (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase))) {
+    Data32 = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPC);
+    WriteData = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPD);
+
+    BaseAddress           = (UINT16) (Data32 & B_PSTH_PCR_TRPC_IOA);
+    ActiveHighByteEnable  = (UINT8)((Data32 & B_PSTH_PCR_TRPC_AHBE) >> 16);
+    ReadCycle             = (BOOLEAN) ((Data32 & B_PSTH_PCR_TRPC_RW) == B_PSTH_PCR_TRPC_RW);
+    //
+    // StartAddress and EndAddress will be equal if it's byte access
+    //
+    EndAddress    = (UINT16) (HighBitSet32 ((UINT32) (ActiveHighByteEnable))) + BaseAddress;
+    StartAddress  = (UINT16) (LowBitSet32 ((UINT32) (ActiveHighByteEnable))) + BaseAddress;
+
+    CurrentIoTrapRegisterData.Type = (EFI_SMM_IO_TRAP_DISPATCH_TYPE)ReadCycle;
+    CurrentIoTrapContextData.WriteData = WriteData;
+
+    LinkInDb = GetFirstNode (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase));
+
+    while (!IsNull (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), LinkInDb)) {
+      RecordInDb = IO_TRAP_RECORD_FROM_LINK (LinkInDb);
+
+      //
+      // If MergeDisable is TRUE, no need to check the address range, dispatch the callback function directly.
+      //
+      if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable) {
+        if (RecordInDb->IoTrapCallback != NULL) {
+          RecordInDb->IoTrapCallback (&RecordInDb->Link, &CurrentIoTrapContextData, NULL, NULL);
+        }
+        if (RecordInDb->IoTrapExCallback != NULL) {
+          RecordInDb->IoTrapExCallback (BaseAddress, ActiveHighByteEnable, !ReadCycle, WriteData);
+        }
+        //
+        // Expect only one callback available. So break immediately.
+        //
+        break;
+      //
+      // If MergeDisable is FALSE, check the address range and trap type.
+      //
+      } else {
+        if ((RecordInDb->Context.Address <= StartAddress) &&
+            (RecordInDb->Context.Address + RecordInDb->Context.Length > EndAddress)) {
+          if ((RecordInDb->Context.Type == IoTrapExTypeReadWrite) || (RecordInDb->Context.Type == (IO_TRAP_EX_DISPATCH_TYPE) CurrentIoTrapRegisterData.Type)) {
+            //
+            // Pass the IO trap context information
+            //
+            RecordInDb->IoTrapCallback (&RecordInDb->Link, &CurrentIoTrapContextData, NULL, NULL);
+          }
+          //
+          // Break if the address is match
+          //
+          break;
+        } else {
+          LinkInDb = GetNextNode (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), &RecordInDb->Link);
+          if (IsNull (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), LinkInDb)) {
+            //
+            // An IO access was trapped that does not have a handler registered.
+            // This indicates an error condition.
+            //
+            ASSERT (FALSE);
+          }
+        }
+      } // end of if else block
+    } // end of while loop
+  } // end of if else block
+}
+
+/**
+  IoTrap dispatcher for IoTrap register 0.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+**/
+VOID
+EFIAPI
+IoTrapDispatcher0 (
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  IoTrapDispatcherHelper (0);
+}
+
+/**
+  IoTrap dispatcher for IoTrap register 1.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+**/
+VOID
+EFIAPI
+IoTrapDispatcher1 (
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  IoTrapDispatcherHelper (1);
+}
+
+/**
+  IoTrap dispatcher for IoTrap register 2.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+**/
+VOID
+EFIAPI
+IoTrapDispatcher2 (
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  IoTrapDispatcherHelper (2);
+}
+
+/**
+  IoTrap dispatcher for IoTrap register 3.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+**/
+VOID
+EFIAPI
+IoTrapDispatcher3 (
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  IoTrapDispatcherHelper (3);
+}
+
+/**
+  IoTrap registratrion helper fucntion.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+  @param[in] IoTrapDispatchFunction     Dispatch function of IoTrapDispatch2Protocol.
+                                        This could be NULL if it's not from IoTrapDispatch2Protocol.
+  @param[in] IoTrapExDispatchFunction   Dispatch function of IoTrapExDispatchProtocol.
+                                        This could be NULL if it's not from IoTrapExDispatchProtocol.
+  @param[in out] Address                The pointer of IO Address.
+                                        If the input Addres is 0, it will return the address assigned
+                                        by registration to this caller.
+  @param[in] Length                     Length of IO address range.
+  @param[in] Type                       Read/Write type of IO trap.
+  @param[in] ByteEnable                 Bitmap to enable trap for each byte of every dword alignment address.
+  @param[in] ByteEnableMask             ByteEnableMask bitwise to ignore the ByteEnable setting.
+
+  @retval    EFI_INVALID_PARAMETER      If Type is invalid,
+                                        If Length is invalid,
+                                        If Address is invalid,
+             EFI_ACCESS_DENIED          If the SmmReadyToLock event has been triggered,
+             EFI_OUT_OF_RESOURCES       If run out of IoTrap register resource,
+                                        If run out of SMM memory pool,
+             EFI_SUCCESS                IoTrap register successfully.
+**/
+EFI_STATUS
+IoTrapRegisterHelper (
+  OUT       EFI_HANDLE                             *DispatchHandle,
+  IN        EFI_SMM_HANDLER_ENTRY_POINT2           IoTrapDispatchFunction,
+  IN        IO_TRAP_EX_DISPATCH_CALLBACK           IoTrapExDispatchFunction,
+  IN OUT    UINT16                                 *Address,
+  IN        UINT16                                 Length,
+  IN        IO_TRAP_EX_DISPATCH_TYPE               Type,
+  IN        UINT8                                  ByteEnable,
+  IN        UINT8                                  ByteEnableMask
+  )
+{
+  EFI_STATUS            Status;
+  EFI_PHYSICAL_ADDRESS  BaseAddress;
+  UINT32                UsedLength;
+  UINT8                 TrapHandlerNum;
+  UINT32                IoTrapRegLowDword;
+  UINT32                IoTrapRegHighDword;
+  BOOLEAN               TempMergeDisable;
+
+  DEBUG ((DEBUG_INFO, "IoTrapRegisterHelper\n"));
+  DEBUG ((DEBUG_INFO, "Address:%x \n", *Address));
+  DEBUG ((DEBUG_INFO, "Length:%x \n", Length));
+  DEBUG ((DEBUG_INFO, "Type:%x \n", Type));
+  DEBUG ((DEBUG_INFO, "ByteEnable:%x \n", ByteEnable));
+  DEBUG ((DEBUG_INFO, "ByteEnableMask:%x \n", ByteEnableMask));
+
+  //
+  // Return error if the type is invalid
+  //
+  if (Type >= IoTrapExTypeMaximum) {
+    DEBUG ((DEBUG_ERROR, "The Dispatch Type %0X is invalid! \n", Type));
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Return error if the Length is invalid
+  //
+  if (Length < 1 || Length > GENERIC_IOTRAP_SIZE) {
+    DEBUG ((DEBUG_ERROR, "The Dispatch Length %0X is invalid! \n", Length));
+    return EFI_INVALID_PARAMETER;
+  }
+  //
+  // Return error if the address is invalid
+  // PCH supports non-aligned address but (Address % 4 + Length) must not be more than 4
+  //
+  if (((Length & (Length - 1)) != 0) && (Length != 3)) {
+    DEBUG ((DEBUG_ERROR, "The Dispatch Length is not power of 2 \n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (((Length >= 4) && (*Address & 0x3)) ||
+      ((Length < 4) && (((*Address & 0x3) + Length) > 4))) {
+    DEBUG ((DEBUG_ERROR, "PCH does not support Dispatch Address %0X and Length %0X combination \n", *Address, Length));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((Length >= 4) && ((*Address & (Length - 1)) != 0)) {
+    DEBUG ((DEBUG_ERROR, "Dispatch Address %0X is not aligned to the Length %0X \n", *Address, Length));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  if (*Address) {
+    TempMergeDisable = TRUE;
+  }else {
+    TempMergeDisable = FALSE;
+  }
+  //
+  // Loop through the first IO Trap handler, looking for the suitable handler
+  //
+  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM; TrapHandlerNum++) {
+    //
+    // Get information from Io Trap handler register
+    //
+    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+
+    //
+    // Check if the IO Trap handler is not used
+    //
+    if (AddressFromLowDword (IoTrapRegLowDword) == 0) {
+      //
+      //  Search available IO address and allocate it if the IO address is 0
+      //
+      BaseAddress = *Address;
+      if (BaseAddress == 0) {
+        //
+        // Allocate 256 byte range from GCD for common pool usage
+        //
+        if ((PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchBottomUp) || (PcdGet8 (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchTopDown)) {
+          BaseAddress = 0xFFFF;
+        }
+        Status = gDS->AllocateIoSpace (
+                        PcdGet8 (PcdEfiGcdAllocateType),
+                        EfiGcdIoTypeIo,
+                        8,
+                        GENERIC_IOTRAP_SIZE,
+                        &BaseAddress,
+                        mDriverImageHandle,
+                        NULL
+                        );
+        if (EFI_ERROR (Status)) {
+          DEBUG ((DEBUG_ERROR, "Can't find any available IO address! \n"));
+          return EFI_OUT_OF_RESOURCES;
+        }
+
+        *Address   = (UINT16) BaseAddress;
+        UsedLength = GENERIC_IOTRAP_SIZE;
+        mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength = Length;
+        mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource = TRUE;
+        UpdateIoTrapAcpiResources (TrapHandlerNum, BaseAddress, TRUE);
+      } else {
+        BaseAddress &= B_PSTH_PCR_TRPREG_AD;
+        UsedLength = Length;
+      }
+
+      Status = PchInternalIoTrapSmiRegister (
+                 mIoTrapData.Entry[TrapHandlerNum].CallbackDispatcher,
+                 TrapHandlerNum,
+                 &mIoTrapHandle
+                 );
+
+      ASSERT_EFI_ERROR (Status);
+      mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle = mIoTrapHandle;
+
+      //
+      // Fill in the Length, address and Enable the IO Trap SMI
+      //
+      IoTrapRegLowDword = (UINT32) (((UsedLength - 1) & ~(BIT1 + BIT0)) << 16) |
+        (UINT16) BaseAddress |
+        B_PSTH_PCR_TRPREG_TSE;
+
+      if (UsedLength < 4) {
+        //
+        // The 4 bits is the Byte Enable Mask bits to indicate which byte that are trapped.
+        // The input ByteEnable and ByteEnableMask are ignored in this case.
+        //
+        IoTrapRegHighDword  = (((1 << UsedLength) - 1) << ((*Address & 0x3) + (N_PSTH_PCR_TRPREG_BEM - 32))) |
+          (UINT32) (Type << N_PSTH_PCR_TRPREG_RWIO);
+      } else {
+        //
+        // Fill in the ByteEnable, ByteEnableMask, and Type of Io Trap register
+        //
+        IoTrapRegHighDword  = ((ByteEnableMask & 0xF) << (N_PSTH_PCR_TRPREG_BEM - 32)) |
+          ((ByteEnable & 0xF) << (N_PSTH_PCR_TRPREG_BE - 32)) |
+          (UINT32) (Type << N_PSTH_PCR_TRPREG_RWIO);
+      }
+      SetIoTrapHighDword (TrapHandlerNum, IoTrapRegHighDword, TRUE);
+      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, TRUE);
+      //
+      // Set MergeDisable flag of the registered IoTrap
+      //
+      mIoTrapData.Entry[TrapHandlerNum].MergeDisable = TempMergeDisable;
+    } else {
+      //
+      // Check next handler if MergeDisable is TRUE or the registered IoTrap if MergeDisable is TRUE
+      // If the Io Trap register is used by IoTrapEx protocol, then the MergeDisable will be FALSE.
+      //
+      if ((TempMergeDisable == TRUE) || (mIoTrapData.Entry[TrapHandlerNum].MergeDisable == TRUE)) {
+        continue;
+      }
+      //
+      // The IO Trap handler is used, calculate the Length
+      //
+      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
+      //
+      //  Assign an addfress from common pool if the caller's address is 0
+      //
+      if (*Address == 0) {
+        //
+        //  Check next handler if it's fully used
+        //
+        if (mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength >= GENERIC_IOTRAP_SIZE) {
+          continue;
+        }
+        //
+        // Check next handler if it's not for a common pool
+        //
+        if (UsedLength < GENERIC_IOTRAP_SIZE) {
+          continue;
+        }
+        //
+        // Check next handler if the size is too big
+        //
+        if (Length >= (UINT16) GENERIC_IOTRAP_SIZE - mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength) {
+          continue;
+        }
+        //
+        // For common pool, we don't need to change the BaseAddress and UsedLength
+        //
+        *Address = (UINT16) (BaseAddress + mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength);
+        mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength += Length;
+      }
+      //
+      // Only set RWM bit when we need both read and write cycles.
+      //
+      IoTrapRegHighDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4);
+      if ((IoTrapRegHighDword & B_PSTH_PCR_TRPREG_RWM) == 0 &&
+          (UINT32) ((IoTrapRegHighDword & B_PSTH_PCR_TRPREG_RWIO) >> N_PSTH_PCR_TRPREG_RWIO) !=
+          (UINT32) Type) {
+        IoTrapRegHighDword = ((IoTrapRegHighDword | B_PSTH_PCR_TRPREG_RWM) & ~B_PSTH_PCR_TRPREG_RWIO);
+        SetIoTrapHighDword (TrapHandlerNum, IoTrapRegHighDword, TRUE);
+      }
+    }
+    break;
+  }
+
+  if (TrapHandlerNum >= IO_TRAP_HANDLER_NUM) {
+    DEBUG ((DEBUG_ERROR, "All IO Trap handler is used, no available IO Trap handler! \n"));
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // Create database record and add to database
+  //
+  Status = gSmst->SmmAllocatePool (
+                    EfiRuntimeServicesData,
+                    sizeof (IO_TRAP_RECORD),
+                    (VOID **) &mIoTrapRecord
+                    );
+
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to allocate memory for mIoTrapRecord! \n"));
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // Gather information about the registration request
+  //
+  mIoTrapRecord->Signature               = IO_TRAP_RECORD_SIGNATURE;
+  mIoTrapRecord->Context.Address         = *Address;
+  mIoTrapRecord->Context.Length          = Length;
+  mIoTrapRecord->Context.Type            = Type;
+  mIoTrapRecord->Context.ByteEnable      = ByteEnable;
+  mIoTrapRecord->Context.ByteEnableMask  = ByteEnableMask;
+  mIoTrapRecord->IoTrapCallback          = IoTrapDispatchFunction;
+  mIoTrapRecord->IoTrapExCallback        = IoTrapExDispatchFunction;
+  mIoTrapRecord->IoTrapNumber            = TrapHandlerNum;
+
+  InsertTailList (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), &mIoTrapRecord->Link);
+
+  //
+  // Child's handle will be the address linked list link in the record
+  //
+  *DispatchHandle = (EFI_HANDLE) (&mIoTrapRecord->Link);
+
+  DEBUG ((DEBUG_INFO, "Result Address:%x \n", *Address));
+  DEBUG ((DEBUG_INFO, "Result Length:%x \n", Length));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  IoTrap unregistratrion helper fucntion.
+
+  @param[in] DispatchHandle             Handle of dispatch function
+
+  @retval    EFI_INVALID_PARAMETER      If DispatchHandle is invalid,
+             EFI_ACCESS_DENIED          If the SmmReadyToLock event has been triggered,
+             EFI_SUCCESS                IoTrap unregister successfully.
+**/
+EFI_STATUS
+IoTrapUnRegisterHelper (
+  IN EFI_HANDLE                                  DispatchHandle
+  )
+{
+  EFI_STATUS            Status;
+  IO_TRAP_RECORD        *RecordToDelete;
+  UINT32                IoTrapRegLowDword;
+  EFI_PHYSICAL_ADDRESS  BaseAddress;
+  UINT32                UsedLength;
+  UINT8                 TrapHandlerNum;
+  UINT8                 LengthIndex;
+  BOOLEAN               RequireToDisableIoTrapHandler;
+
+  if (DispatchHandle == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
+  //
+  // Take the entry out of the linked list
+  //
+  if (RecordToDelete->Link.ForwardLink == (LIST_ENTRY *) EFI_BAD_POINTER) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RequireToDisableIoTrapHandler = FALSE;
+  //
+  // Loop through the first IO Trap handler, looking for the suitable handler
+  //
+  TrapHandlerNum = RecordToDelete->IoTrapNumber;
+
+  if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable) {
+    //
+    // Disable the IO Trap handler if it's the only child of the Trap handler
+    //
+    RequireToDisableIoTrapHandler = TRUE;
+  } else {
+    //
+    // Get information from Io Trap handler register
+    //
+    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+
+    //
+    // Check next Io Trap handler if the IO Trap handler is not used
+    //
+    if (AddressFromLowDword (IoTrapRegLowDword) != 0) {
+
+      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
+
+      //
+      // Check if it's the maximum address of the Io Trap handler
+      //
+      if ((UINTN)(BaseAddress + UsedLength) == (UINTN)(RecordToDelete->Context.Address + RecordToDelete->Context.Length)) {
+
+        if (BaseAddress == RecordToDelete->Context.Address) {
+          //
+          // Disable the IO Trap handler if it's the only child of the Trap handler
+          //
+          RequireToDisableIoTrapHandler = TRUE;
+        } else {
+          //
+          // Calculate the new IO Trap handler Length
+          //
+          UsedLength = UsedLength - RecordToDelete->Context.Length;
+          //
+          // Check the alignment is dword * power of 2 or not
+          //
+          for (LengthIndex = 0; LengthIndex < sizeof (mLengthTable) / sizeof (UINT16); LengthIndex++) {
+            if (UsedLength == mLengthTable[LengthIndex]) {
+              break;
+            }
+          }
+          //
+          // Do not decrease the length if the alignment is not dword * power of 2
+          //
+          if (LengthIndex < sizeof (mLengthTable) / sizeof (UINT16)) {
+            //
+            // Decrease the length to prevent the IO trap SMI
+            //
+            IoTrapRegLowDword = (UINT32) ((((UsedLength - 1) &~(BIT1 + BIT0)) << 16) | BaseAddress | B_PSTH_PCR_TRPREG_TSE);
+          }
+          SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, TRUE);
+        }
+      }
+    }
+  }
+
+  if (RequireToDisableIoTrapHandler) {
+    mIoTrapHandle = mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle;
+    Status        = PchInternalIoTrapSmiUnRegister (mIoTrapHandle);
+    ASSERT_EFI_ERROR (Status);
+
+    SetIoTrapLowDword (TrapHandlerNum, 0, TRUE);
+    SetIoTrapHighDword (TrapHandlerNum, 0, TRUE);
+    //
+    // Also clear pending IOTRAP status.
+    //
+    ClearPendingIoTrapStatus (TrapHandlerNum);
+
+    mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle = 0;
+    mIoTrapData.Entry[TrapHandlerNum].MergeDisable = FALSE;
+    if (mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource == TRUE) {
+      mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource = FALSE;
+      UpdateIoTrapAcpiResources (TrapHandlerNum, 0, FALSE);
+    }
+  }
+
+  RemoveEntryList (&RecordToDelete->Link);
+  Status = gSmst->SmmFreePool (RecordToDelete);
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Register a new IO Trap SMI dispatch function with a parent SMM driver.
+  The caller will provide information about the IO trap characteristics via
+  the context.  This includes base address, length, read vs. r/w, etc.
+  This function will autoallocate IO base address from a common pool if the base address is 0,
+  and the RegisterContext Address field will be updated.
+  The service will not perform GCD allocation if the base address is non-zero.
+  In this case, the caller is responsible for the existence and allocation of the
+  specific IO range.
+  This function looks for the suitable handler and Register a new IoTrap handler
+  if the IO Trap handler is not used. It also enable the IO Trap Range to generate
+  SMI.
+
+  @param[in] This                 Pointer to the EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for
+                                  this SMI source.
+  @param[in, out] RegisterContext Pointer to the dispatch function's context.
+                                  The caller fills this context in before calling
+                                  the register function to indicate to the register
+                                  function the IO trap SMI source for which the dispatch
+                                  function should be invoked.  This may not be NULL.
+                                  If the registration address is not 0, it's caller's responsibility
+                                  to reserve the IO resource in ACPI.
+  @param[out] DispatchHandle      Handle of dispatch function, for when interfacing
+                                  with the parent SMM driver, will be the address of linked
+                                  list link in the call back record.  This may not be NULL.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR        The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
+  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+IoTrapRegister (
+  IN CONST  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL     *This,
+  IN        EFI_SMM_HANDLER_ENTRY_POINT2           DispatchFunction,
+  IN OUT    EFI_SMM_IO_TRAP_REGISTER_CONTEXT       *RegisterContext,
+  OUT       EFI_HANDLE                             *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  DEBUG ((DEBUG_INFO, "IoTrapRegister\n"));
+  Status = IoTrapRegisterHelper (
+             DispatchHandle,
+             DispatchFunction,
+             NULL,
+             &(RegisterContext->Address),
+             RegisterContext->Length,
+             (IO_TRAP_EX_DISPATCH_TYPE) RegisterContext->Type,
+             0x00,
+             0x0F);
+
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (
+      &gEfiSmmIoTrapDispatch2ProtocolGuid,
+      DispatchFunction,
+      (UINTN)RETURN_ADDRESS (0),
+      RegisterContext,
+      sizeof (EFI_SMM_IO_TRAP_REGISTER_CONTEXT)
+      );
+  }
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+IoTrapUnRegister (
+  IN CONST EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL    *This,
+  IN EFI_HANDLE                                  DispatchHandle
+  )
+{
+  IO_TRAP_RECORD *RecordToDelete;
+
+  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
+  SmiHandlerProfileUnregisterHandler (
+    &gIoTrapExDispatchProtocolGuid,
+    RecordToDelete->IoTrapCallback,
+    &RecordToDelete->Context,
+    sizeof (EFI_SMM_IO_TRAP_REGISTER_CONTEXT)
+    );
+  return IoTrapUnRegisterHelper (DispatchHandle);
+}
+
+/**
+  Register a new IO Trap Ex SMI dispatch function.
+
+  @param[in] This                 Pointer to the IO_TRAP_EX_DISPATCH_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for
+                                  this SMI source.
+  @param[in] RegisterContext      Pointer to the dispatch function's context.
+                                  The caller fills this context in before calling
+                                  the register function to indicate to the register
+                                  function the IO trap Ex SMI source for which the dispatch
+                                  function should be invoked.  This MUST not be NULL.
+  @param[out] DispatchHandle      Handle of dispatch function.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
+  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+IoTrapExRegister (
+  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
+  IN  IO_TRAP_EX_DISPATCH_CALLBACK  DispatchFunction,
+  IN  IO_TRAP_EX_REGISTER_CONTEXT   *RegisterContext,
+  OUT EFI_HANDLE                    *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  DEBUG ((DEBUG_INFO, "PchSmmIoTrapExRegister\n"));
+  //
+  // Return error if length is less than 4 and not power of 2.
+  //
+  if ((RegisterContext->Length < 4) || ((RegisterContext->Length & (RegisterContext->Length - 1)) != 0)) {
+    DEBUG ((DEBUG_ERROR, "The Dispatch Length is not power of 2 \n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = IoTrapRegisterHelper (
+             DispatchHandle,
+             NULL,
+             DispatchFunction,
+             &(RegisterContext->Address),
+             RegisterContext->Length,
+             RegisterContext->Type,
+             RegisterContext->ByteEnable,
+             RegisterContext->ByteEnableMask);
+
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (
+      &gIoTrapExDispatchProtocolGuid,
+      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
+      (UINTN)RETURN_ADDRESS (0),
+      RegisterContext,
+      sizeof (*RegisterContext)
+      );
+  }
+  return Status;
+}
+
+/**
+  Unregister a SMI source dispatch function.
+  This function is unsupported.
+
+  @param[in] This                 Pointer to the IO_TRAP_EX_DISPATCH_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_UNSUPPORTED         The function is unsupported.
+**/
+EFI_STATUS
+EFIAPI
+IoTrapExUnRegister (
+  IN IO_TRAP_EX_DISPATCH_PROTOCOL   *This,
+  IN EFI_HANDLE                     DispatchHandle
+  )
+{
+  IO_TRAP_RECORD *RecordToDelete;
+
+  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
+  SmiHandlerProfileUnregisterHandler (
+    &gIoTrapExDispatchProtocolGuid,
+    RecordToDelete->IoTrapCallback,
+    &RecordToDelete->Context,
+    sizeof (RecordToDelete->Context)
+    );
+  return IoTrapUnRegisterHelper (DispatchHandle);
+}
+
+/**
+  Pause IoTrap callback function.
+
+  This function disables the SMI enable of IoTrap according to the DispatchHandle,
+  which is returned by IoTrap callback registration. It only supports the DispatchHandle
+  with MergeDisable TRUE and address not zero.
+
+  NOTE: This call does not guarantee all pending IO cycles to be synchronized
+        and pending IO cycles issued before this call might not be trapped.
+
+  @param[in] This                 Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of the child service to change state.
+
+  @retval EFI_SUCCESS             This operation is complete.
+  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED       The SMI status is alrady PAUSED.
+**/
+EFI_STATUS
+EFIAPI
+IoTrapControlPause (
+  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL   *This,
+  IN EFI_HANDLE                         DispatchHandle
+  )
+{
+  IO_TRAP_RECORD                        *IoTrapRecord;
+  UINT32                                IoTrapRegLowDword;
+  UINT32                                IoTrapRegHighDword;
+  EFI_PHYSICAL_ADDRESS                  BaseAddress;
+  UINT32                                UsedLength;
+  UINT8                                 TrapHandlerNum;
+  BOOLEAN                               TempMergeDisable;
+  BOOLEAN                               DisableIoTrap;
+
+  if (DispatchHandle == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  IoTrapRecord = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
+
+  if (IoTrapRecord->Context.Address) {
+    TempMergeDisable =TRUE;
+  }else {
+    TempMergeDisable = FALSE;
+  }
+
+  if ((IoTrapRecord->Signature != IO_TRAP_RECORD_SIGNATURE) ||
+      (TempMergeDisable != TRUE)                            ||
+      (IoTrapRecord->Context.Address == 0)                  ||
+      (IoTrapRecord->Context.Length == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM; TrapHandlerNum++) {
+    //
+    // This IoTrap register should be merge disabled.
+    //
+    if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable != TRUE) {
+      continue;
+    }
+    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+    IoTrapRegHighDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4);
+    //
+    // Depending on the usage, we will obtain the UsedLength and BaseAddress differently
+    // If the registered trap length is less than 4, we obtain the length from Byte Enable Mask
+    // In the other hand, we obtain the length from Address Mask
+    //
+    if (ByteEnableMaskFromHighDword (IoTrapRegHighDword) != 0xF) {
+      UsedLength = (UINT32) (HighBitSet32 (IoTrapRegHighDword & 0xF0) - LowBitSet32 (IoTrapRegHighDword & 0xF0) + 1);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword) + LowBitSet32 (ByteEnableMaskFromHighDword (IoTrapRegHighDword));
+    } else {
+      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
+    }
+
+    //
+    // The address and length of record matches the IoTrap register's.
+    //
+    DisableIoTrap = FALSE;
+    if ((IoTrapRecord->IoTrapExCallback != NULL) &&
+        IsIoTrapExContentMatched (IoTrapRecord, IoTrapRegLowDword, IoTrapRegHighDword)) {
+      DisableIoTrap = TRUE;
+    } else if ((BaseAddress == IoTrapRecord->Context.Address) &&
+               (UsedLength  == IoTrapRecord->Context.Length )) {
+      DisableIoTrap = TRUE;
+    }
+
+    if (DisableIoTrap) {
+      //
+      // Check if status matched.
+      // If this is already Paused, return warning status.
+      //
+      if ((IoTrapRegLowDword & B_PSTH_PCR_TRPREG_TSE) == 0) {
+        return EFI_ACCESS_DENIED;
+      }
+      //
+      // Clear IoTrap register SMI enable bit
+      //
+      IoTrapRegLowDword &= (~B_PSTH_PCR_TRPREG_TSE);
+      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, FALSE);
+      //
+      // Also clear pending IOTRAP status.
+      //
+      ClearPendingIoTrapStatus (TrapHandlerNum);
+      return EFI_SUCCESS;
+    }
+  }
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  Resume IoTrap callback function.
+
+  This function enables the SMI enable of IoTrap according to the DispatchHandle,
+  which is returned by IoTrap callback registration. It only supports the DispatchHandle
+  with MergeDisable TRUE and address not zero.
+
+  @param[in] This                 Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of the child service to change state.
+
+  @retval EFI_SUCCESS             This operation is complete.
+  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED       The SMI status is alrady RESUMED.
+**/
+EFI_STATUS
+EFIAPI
+IoTrapControlResume (
+  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL   *This,
+  IN EFI_HANDLE                         DispatchHandle
+  )
+{
+  IO_TRAP_RECORD                        *IoTrapRecord;
+  UINT32                                IoTrapRegLowDword;
+  UINT32                                IoTrapRegHighDword;
+  EFI_PHYSICAL_ADDRESS                  BaseAddress;
+  UINT32                                UsedLength;
+  UINT8                                 TrapHandlerNum;
+  BOOLEAN                               TempMergeDisable;
+  BOOLEAN                               EnableIoTrap;
+
+  if (DispatchHandle == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+  IoTrapRecord = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
+
+  if (IoTrapRecord->Context.Address) {
+    TempMergeDisable = TRUE;
+  }else {
+    TempMergeDisable = FALSE;
+  }
+
+  if ((IoTrapRecord->Signature != IO_TRAP_RECORD_SIGNATURE) ||
+      (TempMergeDisable != TRUE)          ||
+      (IoTrapRecord->Context.Address == 0)                  ||
+      (IoTrapRecord->Context.Length == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM; TrapHandlerNum++) {
+    //
+    // This IoTrap register should be merge disabled.
+    //
+    if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable != TRUE) {
+      continue;
+    }
+    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
+    IoTrapRegHighDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4);
+    //
+    // Depending on the usage, we will obtain the UsedLength and BaseAddress differently
+    // If the registered trap length is less than 4, we obtain the length from Byte Enable Mask
+    // In the other hand, we obtain the length from Address Mask
+    //
+    if (ByteEnableMaskFromHighDword (IoTrapRegHighDword) != 0xF) {
+      UsedLength  = (UINT32) (HighBitSet32 (IoTrapRegHighDword & 0xF0) - LowBitSet32 (IoTrapRegHighDword & 0xF0) + 1);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword) + LowBitSet32 (ByteEnableMaskFromHighDword (IoTrapRegHighDword));
+    } else {
+      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
+      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
+    }
+
+    //
+    // The address and length of record matches the IoTrap register's.
+    //
+    EnableIoTrap = FALSE;
+    if ((IoTrapRecord->IoTrapExCallback != NULL) &&
+        IsIoTrapExContentMatched (IoTrapRecord, IoTrapRegLowDword, IoTrapRegHighDword)) {
+      EnableIoTrap = TRUE;
+    } else if ((BaseAddress == IoTrapRecord->Context.Address) &&
+               (UsedLength  == IoTrapRecord->Context.Length )) {
+      EnableIoTrap = TRUE;
+    }
+
+    if (EnableIoTrap) {
+      //
+      // Check if status matched.
+      // If this is already Resume, return warning status.
+      //
+      if ((IoTrapRegLowDword & B_PSTH_PCR_TRPREG_TSE) != 0) {
+        return EFI_ACCESS_DENIED;
+      }
+      //
+      // Set IoTrap register SMI enable bit
+      //
+      IoTrapRegLowDword |= (B_PSTH_PCR_TRPREG_TSE);
+      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, FALSE);
+      return EFI_SUCCESS;
+    }
+  }
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  The IoTrap module abstracts PCH I/O trapping capabilities for other drivers.
+  This driver manages the limited I/O trap resources.
+
+  @param[in] ImageHandle                Image handle for this driver image
+
+  @retval EFI_SUCCESS                   Driver initialization completed successfully
+**/
+EFI_STATUS
+EFIAPI
+InstallIoTrap (
+  IN EFI_HANDLE                         ImageHandle
+  )
+{
+  EFI_STATUS             Status;
+  PCH_NVS_AREA_PROTOCOL  *PchNvsAreaProtocol;
+  UINTN                  TrapHandlerNum;
+
+  //
+  // Initialize the EFI SMM driver library
+  //
+  mDriverImageHandle = ImageHandle;
+
+  //
+  // Initialize the IO TRAP protocol we produce
+  //
+  mIoTrapData.Signature = IO_TRAP_INSTANCE_SIGNATURE;
+  mIoTrapData.EfiSmmIoTrapDispatchProtocol.Register   = IoTrapRegister;
+  mIoTrapData.EfiSmmIoTrapDispatchProtocol.UnRegister = IoTrapUnRegister;
+
+  //
+  // Initialize the IO TRAP EX protocol
+  //
+  mIoTrapData.IoTrapExDispatchProtocol.Register       = IoTrapExRegister;
+  mIoTrapData.IoTrapExDispatchProtocol.UnRegister     = IoTrapExUnRegister;
+
+  //
+  // Initialize the IO TRAP control protocol.
+  //
+  mIoTrapData.PchSmmIoTrapControlProtocol.Pause       = IoTrapControlPause;
+  mIoTrapData.PchSmmIoTrapControlProtocol.Resume      = IoTrapControlResume;
+
+  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM; TrapHandlerNum++) {
+    //
+    // Initialize IO TRAP Callback DataBase
+    //
+    InitializeListHead (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase));
+  }
+  mIoTrapData.Entry[0].CallbackDispatcher = IoTrapDispatcher0;
+  mIoTrapData.Entry[1].CallbackDispatcher = IoTrapDispatcher1;
+  mIoTrapData.Entry[2].CallbackDispatcher = IoTrapDispatcher2;
+  mIoTrapData.Entry[3].CallbackDispatcher = IoTrapDispatcher3;
+
+  //
+  // Get address of PchNvs structure for later use
+  //
+  Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID **) &PchNvsAreaProtocol);
+  ASSERT_EFI_ERROR (Status);
+  mPchNvsArea = PchNvsAreaProtocol->Area;
+
+  //
+  // Install protocol interface
+  //
+  mIoTrapData.Handle = NULL;
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &mIoTrapData.Handle,
+                    &gEfiSmmIoTrapDispatch2ProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mIoTrapData.EfiSmmIoTrapDispatchProtocol
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &mIoTrapData.Handle,
+                    &gIoTrapExDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mIoTrapData.IoTrapExDispatchProtocol
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &mIoTrapData.Handle,
+                    &gPchSmmIoTrapControlGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mIoTrapData.PchSmmIoTrapControlProtocol
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
new file mode 100644
index 0000000000..e69d2e2d4d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
@@ -0,0 +1,226 @@
+/** @file
+  Defines and prototypes for the IoTrap SMM driver
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _IO_TRAP_H_
+#define _IO_TRAP_H_
+
+//
+// Include files
+//
+#include <Library/S3BootScriptLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Protocol/SmmIoTrapDispatch2.h>
+#include <Protocol/PchSmmIoTrapControl.h>
+#include <Protocol/IoTrapExDispatch.h>
+
+#define IO_TRAP_HANDLER_NUM 4
+
+//
+// Driver private data
+//
+#define IO_TRAP_INSTANCE_SIGNATURE  SIGNATURE_32 ('I', 'O', 'T', 'P')
+
+typedef struct {
+  EFI_HANDLE                            IoTrapHandle;
+  /**
+    The callback linked list for all "merged" IoTrap callbacks.
+  **/
+  LIST_ENTRY                            CallbackDataBase;
+  /**
+    The IoTrap IO range used length tracking for "merged" IoTrap register.
+  **/
+  UINT32                                TrapUsedLength;
+  /**
+    Determine if IoTrap can be merged with other IoTrap callbacks.
+    If MergeDisable is TRUE, then there is only one callback function for one IoTrap register.
+    If MergeDisable is FALSE, then there are multiple callbacks in the "CallbackDataBase" for one IoTrap register.
+  **/
+  BOOLEAN                               MergeDisable;
+  /**
+    Indicator of the resource tracking in ACPI.
+    If the registration address is not 0, it's caller's responsibility to reserve the IO resource in ACPI.
+  **/
+  BOOLEAN                               ReservedAcpiIoResource;
+  /**
+    Dispatcher for each IoTrap register.
+  **/
+  PCH_SMI_DISPATCH_CALLBACK             CallbackDispatcher;
+} IO_TRAP_ENTRY_ATTRIBUTES;
+
+typedef struct {
+  UINT32                                Signature;
+  EFI_HANDLE                            Handle;
+  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL    EfiSmmIoTrapDispatchProtocol;
+  PCH_SMM_IO_TRAP_CONTROL_PROTOCOL      PchSmmIoTrapControlProtocol;        ///< Protocol for runtime control the IoTrap state
+  IO_TRAP_EX_DISPATCH_PROTOCOL          IoTrapExDispatchProtocol;           ///< Protocol for IoTrap Extension
+  IO_TRAP_ENTRY_ATTRIBUTES              Entry[IO_TRAP_HANDLER_NUM];
+} IO_TRAP_INSTANCE;
+
+#define IO_TRAP_INSTANCE_FROM_THIS(a) CR (a, IO_TRAP_INSTANCE, EfiSmmIoTrapDispatchProtocol, IO_TRAP_INSTANCE_SIGNATURE)
+
+///
+/// "IOTRAP" RECORD
+/// Linked list data structures
+///
+#define IO_TRAP_RECORD_SIGNATURE  SIGNATURE_32 ('I', 'T', 'R', 'C')
+
+typedef struct _IO_TRAP_RECORD {
+  UINT32                                    Signature;
+  LIST_ENTRY                                Link;
+  IO_TRAP_EX_REGISTER_CONTEXT               Context;
+  /**
+    The callback function of IoTrap protocol.
+    This also indicate it's the record for IoTrapProtocol.
+    Only one of IoTrapCallback or IoTrapExCallback is valid at a time.
+  **/
+  EFI_SMM_HANDLER_ENTRY_POINT2              IoTrapCallback;
+  /**
+    The callback function of IoTrapEx protocol
+    This also indicate it's the record for IoTrapExProtocol.
+    Only one of IoTrapCallback or IoTrapExCallback is valid at a time.
+  **/
+  IO_TRAP_EX_DISPATCH_CALLBACK              IoTrapExCallback;
+  UINT8                                     IoTrapNumber;
+} IO_TRAP_RECORD;
+
+#define IO_TRAP_RECORD_FROM_LINK(_record) CR (_record, IO_TRAP_RECORD, Link, IO_TRAP_RECORD_SIGNATURE)
+
+//
+// Prototypes
+//
+/**
+  The IoTrap module abstracts PCH I/O trapping capabilities for other drivers.
+  This driver manages the limited I/O trap resources.
+
+  @param[in] ImageHandle                Image handle for this driver image
+
+  @retval EFI_SUCCESS                   Driver initialization completed successfully
+**/
+EFI_STATUS
+EFIAPI
+InstallIoTrap (
+  IN EFI_HANDLE                     ImageHandle
+  );
+
+/**
+  Register a new IO Trap SMI dispatch function with a parent SMM driver.
+  The caller will provide information about the IO trap characteristics via
+  the context.  This includes base address, length, read vs. r/w, etc.
+  This function will autoallocate IO base address from a common pool if the base address is 0,
+  and the RegisterContext Address field will be updated.
+  The service will not perform GCD allocation if the base address is non-zero.
+  In this case, the caller is responsible for the existence and allocation of the
+  specific IO range.
+  This function looks for the suitable handler and Register a new IoTrap handler
+  if the IO Trap handler is not used. It also enable the IO Trap Range to generate
+  SMI.
+
+  @param[in] This                 Pointer to the  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for
+                                  this SMI source.
+  @param[in, out] RegisterContext Pointer to the dispatch function's context.
+                                  The caller fills this context in before calling
+                                  the register function to indicate to the register
+                                  function the IO trap SMI source for which the dispatch
+                                  function should be invoked.  This may not be NULL.
+                                  If the registration address is not 0, it's caller's responsibility
+                                  to reserve the IO resource in ACPI.
+  @param[out] DispatchHandle      Handle of dispatch function, for when interfacing
+                                  with the parent SMM driver, will be the address of linked
+                                  list link in the call back record.  This may not be NULL.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR        The driver was unable to enable the SMI source.
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
+  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+IoTrapRegister (
+  IN  CONST   EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL     *This,
+  IN          EFI_SMM_HANDLER_ENTRY_POINT2           DispatchFunction,
+  IN OUT      EFI_SMM_IO_TRAP_REGISTER_CONTEXT       *RegisterContext,
+  OUT EFI_HANDLE                                      *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+  @retval EFI_ACCESS_DENIED       Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+IoTrapUnRegister (
+  IN CONST  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL    *This,
+  IN EFI_HANDLE                                   DispatchHandle
+  );
+
+/**
+  This I/O Trap SMI handler invokes the ACPI reference code to handle the SMI.
+  It currently assumes it owns all of the IO trap SMI.
+
+  @param[in] DispatchHandle           Not used
+
+**/
+VOID
+EFIAPI
+IoTrapCallback (
+  IN  EFI_HANDLE                      DispatchHandle
+  );
+
+/**
+  Pause IoTrap callback function.
+
+  This function disables the SMI enable of IoTrap according to the DispatchHandle,
+  which is returned by IoTrap callback registration. It only supports the DispatchHandle
+  with MergeDisable TRUE and address not zero.
+
+  @param[in] This                 Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of the child service to change state.
+
+  @retval EFI_SUCCESS             This operation is complete.
+  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED       The SMI status is alrady PAUSED.
+**/
+EFI_STATUS
+EFIAPI
+IoTrapControlPause (
+  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL * This,
+  IN EFI_HANDLE                       DispatchHandle
+  );
+
+/**
+  Resume IoTrap callback function.
+
+  This function enables the SMI enable of IoTrap according to the DispatchHandle,
+  which is returned by IoTrap callback registration. It only supports the DispatchHandle
+  with MergeDisable TRUE and address not zero.
+
+  @param[in] This                 Pointer to the PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of the child service to change state.
+
+  @retval EFI_SUCCESS             This operation is complete.
+  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
+  @retval EFI_ACCESS_DENIED       The SMI status is alrady RESUMED.
+**/
+EFI_STATUS
+EFIAPI
+IoTrapControlResume (
+  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL * This,
+  IN EFI_HANDLE                       DispatchHandle
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatch.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatch.c
new file mode 100644
index 0000000000..affbe94eb7
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatch.c
@@ -0,0 +1,2442 @@
+/** @file
+  This function handle the register/unregister of PCH specific SMI events.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Library/SmiHandlerProfileLib.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PmcRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/SpiRegs.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/PchRegsPsth.h>
+#include <Library/PchPciBdfLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <PchBdfAssignment.h>
+#include "PchSmiHelper.h"
+
+/**
+  The internal function used to create and insert a database record
+  for SMI record of Pch Smi types.
+
+  @param[in]  SrcDesc                   The pointer to the SMI source description
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  PchSmiType                Specific SMI type of PCH SMI
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+PchSmiRecordInsert (
+  IN  CONST PCH_SMM_SOURCE_DESC         *SrcDesc,
+  IN  PCH_SMI_CALLBACK_FUNCTIONS        DispatchFunction,
+  IN  PCH_SMI_TYPES                     PchSmiType,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       Record;
+
+  if (SrcDesc == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  ZeroMem (&Record, sizeof (DATABASE_RECORD));
+  //
+  // Gather information about the registration request
+  //
+  Record.Signature                      = DATABASE_RECORD_SIGNATURE;
+  Record.PchSmiCallback                 = DispatchFunction;
+  Record.ProtocolType                   = PchSmiDispatchType;
+  Record.PchSmiType                     = PchSmiType;
+
+  CopyMem (&Record.SrcDesc, SrcDesc, sizeof (PCH_SMM_SOURCE_DESC));
+  Status = SmmCoreInsertRecord (
+             &Record,
+             DispatchHandle
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
+
+//
+// TCO_STS bit that needs to be cleared
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mDescSrcTcoSts = {
+  PCH_SMM_NO_FLAGS,
+  {
+    NULL_BIT_DESC_INITIALIZER,
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_TCO
+    }
+  },
+  NULL_BIT_DESC_INITIALIZER
+};
+
+/**
+  Clear the TCO SMI status bit and block after the SMI handling is done
+
+  @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+
+**/
+VOID
+EFIAPI
+PchTcoSmiClearSourceAndBlock (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  )
+{
+  PchSmmClearSourceAndBlock (SrcDesc);
+  //
+  // Any TCO-based status bits require special handling.
+  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the TCO registers
+  //
+  PchSmmClearSource (&mDescSrcTcoSts);
+}
+
+/**
+  Clear the TCO SMI status bit after the SMI handling is done
+
+  @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+
+**/
+VOID
+EFIAPI
+PchTcoSmiClearSource (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  )
+{
+  PchSmmClearSource (SrcDesc);
+  //
+  // Any TCO-based status bits require special handling.
+  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the TCO registers
+  //
+  PchSmmClearSource (&mDescSrcTcoSts);
+}
+
+/**
+  Initialize Source descriptor structure
+
+   @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+
+**/
+VOID
+EFIAPI
+NullInitSourceDesc (
+   PCH_SMM_SOURCE_DESC                   *SrcDesc
+   )
+{
+  ZeroMem (SrcDesc, sizeof (PCH_SMM_SOURCE_DESC));
+  SrcDesc->En[0].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
+  SrcDesc->En[1].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
+  SrcDesc->Sts[0].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
+  SrcDesc->PmcSmiSts.Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
+}
+
+//
+// Mch srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescMch = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_DMISMI
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of MCH event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiMchRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescMch,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiMchType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSource;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// TcoTimeout srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescTcoTimeout = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_TIMEOUT
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of TcoTimeout event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiTcoTimeoutRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescTcoTimeout,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiTcoTimeoutType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSource;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// OsTco srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescOsTco = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_SW_TCO_SMI
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of OS TCO event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiOsTcoRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescOsTco,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiOsTcoType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSource;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// Nmi
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescNmi = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_CNT}
+      },
+      S_TCO_IO_TCO1_CNT,
+      N_TCO_IO_TCO1_CNT_NMI2SMI_EN
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_NMI2SMI
+    }
+  },
+  //
+  // NOTE: The status of NMI2SMI won't reflect to PMC SMI_STS.
+  //       So skip the top level status check and check the TCO1_STS directly.
+  //
+  NULL_BIT_DESC_INITIALIZER
+};
+
+/**
+  The register function used to register SMI handler of NMI event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiNmiRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescNmi,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiNmiType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSource;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// IntruderDetect srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescIntruderDet = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO2_CNT}
+      },
+      S_TCO_IO_TCO2_CNT,
+      N_TCO_IO_TCO2_CNT_INTRD_SEL
+    }
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO2_STS}
+      },
+      S_TCO_IO_TCO2_STS,
+      N_TCO_IO_TCO2_STS_INTRD_DET
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of Intruder Detect event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiIntruderDetRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescIntruderDet,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiIntruderDetectType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSourceAndBlock;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// SpiBiosWp srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescSpiBiosWp = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
+          R_SPI_CFG_BC
+        ) }
+      },
+      S_SPI_CFG_BC,
+      N_SPI_CFG_BC_BLE
+    },
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
+          R_SPI_CFG_BC
+        ) }
+      },
+      S_SPI_CFG_BC,
+      N_SPI_CFG_BC_SYNC_SS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  Special handling for SPI Write Protect
+
+  @param[in]  SrcDesc   Not used
+**/
+VOID
+EFIAPI
+PchTcoSpiWpClearSource (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  )
+{
+  UINT64 SpiRegBase;
+  UINT32 BiosControl;
+  UINT32 Timeout;
+
+  SpiRegBase = SpiPciCfgBase ();
+  PciSegmentAndThenOr32 (
+    SpiRegBase + R_SPI_CFG_BC,
+    (UINT32) ~B_SPI_CFG_BC_ASYNC_SS,
+    B_SPI_CFG_BC_SYNC_SS
+    );
+  //
+  // Ensure the SYNC is cleared
+  //
+  Timeout = 1000;
+  do {
+    BiosControl = PciSegmentRead32 (SpiRegBase + R_SPI_CFG_BC);
+    Timeout--;
+  } while ((BiosControl & B_SPI_CFG_BC_SYNC_SS) && (Timeout > 0));
+
+  //
+  // Any TCO-based status bits require special handling.
+  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the TCO registers
+  //
+  PchSmmClearSource (&mDescSrcTcoSts);
+}
+
+/**
+  Set SMI_EN_TCO to enable TCO SMI.
+**/
+STATIC
+VOID
+PchSetSmiEnTco (
+  VOID
+  )
+{
+  IoOr32 (mAcpiBaseAddr + R_ACPI_IO_SMI_EN, B_ACPI_IO_SMI_EN_TCO);
+}
+
+/**
+  The register function used to register SMI handler of BIOS write protect event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiSpiBiosWpRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescSpiBiosWp,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiSpiBiosWpType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSpiWpClearSource;
+    PchTcoSpiWpClearSource (NULL);
+    //
+    // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
+    // Only enable SMI_EN_TCO.
+    //
+    PchSetSmiEnTco ();
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// LpcBiosWp srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescLpcBiosWp = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
+          R_LPC_CFG_BC
+        ) }
+      },
+      S_LPC_CFG_BC,
+      N_LPC_CFG_BC_LE
+    }
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_BIOSWR
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of LPC BIOS write protect event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiLpcBiosWpRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  if (IsEspiEnabled ()) {
+    //
+    // Status is D31F0's PCBC.BWPDS
+    //
+    ASSERT (FALSE);
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescLpcBiosWp,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiLpcBiosWpType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSource;
+    PchSmmClearSource (&Record->SrcDesc);
+    //
+    // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
+    // Only enable SMI_EN_TCO.
+    //
+    PchSetSmiEnTco ();
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// NEWCENTURY_STS bit that needs to be cleared
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescNewCentury = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        TCO_ADDR_TYPE,
+        {R_TCO_IO_TCO1_STS}
+      },
+      S_TCO_IO_TCO1_STS,
+      N_TCO_IO_TCO1_STS_NEWCENTURY
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  The register function used to register SMI handler of NEW CENTURY event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiNewCenturyRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescNewCentury,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchTcoSmiNewCenturyType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchTcoSmiClearSourceAndBlock;
+    PchSmmClearSource (&Record->SrcDesc);
+    PchSmmEnableSource (&Record->SrcDesc);
+    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchTcoSmiUnRegister (
+  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *Record;
+  EFI_STATUS                            Status;
+
+  Record = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  if ((Record->SrcDesc.En[1].Reg.Type == ACPI_ADDR_TYPE) &&
+      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Dev == SpiDevNumber ()) &&
+      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Fnc == SpiFuncNumber ()) &&
+      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Reg == R_SPI_CFG_BC) &&
+      (Record->SrcDesc.En[1].Bit == N_SPI_CFG_BC_BLE)) {
+    //
+    // SPI Write Protect cannot be disabled
+    //
+    return EFI_ACCESS_DENIED;
+  } else if ((Record->SrcDesc.En[1].Reg.Type == ACPI_ADDR_TYPE) &&
+             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Dev == LpcDevNumber ()) &&
+             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Fnc == LpcFuncNumber ()) &&
+             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Reg == R_LPC_CFG_BC) &&
+             (Record->SrcDesc.En[1].Bit == N_LPC_CFG_BC_LE)) {
+    //
+    // eSPI/LPC Write Protect cannot be disabled
+    //
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileUnregisterHandler (&gPchTcoSmiDispatchProtocolGuid, Record->Callback, NULL, 0);
+  }
+  return Status;
+}
+
+
+//
+// PcieRpHotPlug srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC PchPcieSmiRpHotPlugTemplate = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_MPC}
+      },
+      S_PCH_PCIE_CFG_MPC,
+      N_PCH_PCIE_CFG_MPC_HPME
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_SMSCS}
+      },
+      S_PCH_PCIE_CFG_SMSCS,
+      N_PCH_PCIE_CFG_SMSCS_HPPDM
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PCI_EXP
+  }
+};
+
+/**
+  The register function used to register SMI handler of PCIE RP hotplug event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH RP index and CPU RP index.
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPcieSmiHotPlugRegister (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
+  IN  UINTN                             RpIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  UINTN                                 RpDev;
+  UINTN                                 RpFun;
+  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
+  DATABASE_RECORD                       *Record;
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
+
+  PchPcieSmiRpHotPlugTemplate.En[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpHotPlugTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+  PchPcieSmiRpHotPlugTemplate.Sts[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpHotPlugTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+
+  Status = PchSmiRecordInsert (
+             &PchPcieSmiRpHotPlugTemplate,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchPcieSmiRpHotplugType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpHotplugType;
+    Record->ChildContext.Pcie.RpIndex = RpIndex;
+    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
+    SmiHandlerProfileRegisterHandler (
+      &gPchPcieSmiDispatchProtocolGuid,
+      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
+      (UINTN)RETURN_ADDRESS (0),
+      &Context,
+      sizeof (Context)
+      );
+  }
+  PchSmmClearSource (&PchPcieSmiRpHotPlugTemplate);
+  PchSmmEnableSource (&PchPcieSmiRpHotPlugTemplate);
+
+  return Status;
+}
+
+//
+// PcieRpLinkActive srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC PchPcieSmiRpLinkActiveTemplate = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_MPC}
+      },
+      S_PCH_PCIE_CFG_MPC,
+      N_PCH_PCIE_CFG_MPC_HPME
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_SMSCS}
+      },
+      S_PCH_PCIE_CFG_SMSCS,
+      N_PCH_PCIE_CFG_SMSCS_HPLAS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PCI_EXP
+  }
+};
+
+/**
+  The register function used to register SMI handler of PCIE RP link active event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH RP index and CPU RP index.
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPcieSmiLinkActiveRegister (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
+  IN  UINTN                             RpIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  UINTN                                 RpDev;
+  UINTN                                 RpFun;
+  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
+  DATABASE_RECORD                       *Record;
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
+
+
+  PchPcieSmiRpLinkActiveTemplate.En[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpLinkActiveTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+  PchPcieSmiRpLinkActiveTemplate.Sts[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpLinkActiveTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+
+  Status = PchSmiRecordInsert (
+             &PchPcieSmiRpLinkActiveTemplate,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchPcieSmiRpLinkActiveType,
+             DispatchHandle
+             );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpLinkActiveType;
+    Record->ChildContext.Pcie.RpIndex = RpIndex;
+    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
+    SmiHandlerProfileRegisterHandler (
+      &gPchPcieSmiDispatchProtocolGuid,
+      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
+      (UINTN)RETURN_ADDRESS (0),
+      &Context,
+      sizeof (Context)
+      );
+  }
+  PchSmmClearSource (&PchPcieSmiRpLinkActiveTemplate);
+  PchSmmEnableSource (&PchPcieSmiRpLinkActiveTemplate);
+
+  return Status;
+}
+
+//
+// PcieRpLinkEq srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC PchPcieSmiRpLinkEqTemplate = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_EQCFG1}
+      },
+      S_PCH_PCIE_CFG_EQCFG1,
+      N_PCH_PCIE_CFG_EQCFG1_LERSMIE
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        {R_PCH_PCIE_CFG_SMSCS}
+      },
+      S_PCH_PCIE_CFG_SMSCS,
+      N_PCH_PCIE_CFG_SMSCS_LERSMIS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PCI_EXP
+  }
+};
+/**
+  The register function used to register SMI handler of PCIE RP Link Equalization Request event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH RP index and CPU RP index.
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPcieSmiLinkEqRegister (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
+  IN  UINTN                             RpIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  UINTN                                 RpDev;
+  UINTN                                 RpFun;
+  EFI_STATUS                            Status;
+  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
+
+  //
+  // Patch the RP device number and function number of srcdesc.
+  //
+  PchPcieSmiRpLinkEqTemplate.En[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpLinkEqTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+  PchPcieSmiRpLinkEqTemplate.Sts[0].Reg.Data.pcie.Fields.Dev = (UINT8) RpDev;
+  PchPcieSmiRpLinkEqTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc = (UINT8) RpFun;
+
+  Status = PchSmiRecordInsert (
+           &PchPcieSmiRpLinkEqTemplate,
+           (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+           PchPcieSmiRpLinkEqType,
+           DispatchHandle
+           );
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpLinkEqType;
+    Record->ChildContext.Pcie.RpIndex = RpIndex;
+    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
+    SmiHandlerProfileRegisterHandler (
+      &gPchPcieSmiDispatchProtocolGuid,
+      (EFI_SMM_HANDLER_ENTRY_POINT2) DispatchFunction,
+      (UINTN)RETURN_ADDRESS (0),
+      &Context,
+      sizeof (Context)
+      );
+  }
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPcieSmiUnRegister (
+  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *RecordToDelete;
+  EFI_STATUS                            Status;
+
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+      SmiHandlerProfileUnregisterHandler (
+        &gPchPcieSmiDispatchProtocolGuid,
+        RecordToDelete->Callback,
+        &RecordToDelete->ChildContext,
+        sizeof (RecordToDelete->ContextSize)
+        );
+  }
+  return Status;
+}
+
+//
+// Pme srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescPme = {
+  PCH_SMM_SCI_EN_DEPENDENT,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_GPE0_EN_127_96}
+      },
+      S_ACPI_IO_GPE0_EN_127_96,
+      N_ACPI_IO_GPE0_EN_127_96_PME
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_GPE0_STS_127_96}
+      },
+      S_ACPI_IO_GPE0_STS_127_96,
+      N_ACPI_IO_GPE0_STS_127_96_PME
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_GPE0
+  }
+};
+
+/**
+  The register function used to register SMI handler of PME event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiSmiPmeRegister (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescPme,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchAcpiSmiPmeType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescPme);
+  PchSmmEnableSource (&mSrcDescPme);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// PmeB0 srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescPmeB0 = {
+  PCH_SMM_SCI_EN_DEPENDENT,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_GPE0_EN_127_96}
+      },
+      S_ACPI_IO_GPE0_EN_127_96,
+      N_ACPI_IO_GPE0_EN_127_96_PME_B0
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_GPE0_STS_127_96}
+      },
+      S_ACPI_IO_GPE0_STS_127_96,
+      N_ACPI_IO_GPE0_STS_127_96_PME_B0
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_GPE0
+  }
+};
+/**
+  The register function used to register SMI handler of PME B0 event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiSmiPmeB0Register (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescPmeB0,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchAcpiSmiPmeB0Type,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescPmeB0);
+  PchSmmEnableSource (&mSrcDescPmeB0);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// RtcAlarm srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescRtcAlarm = {
+  PCH_SMM_SCI_EN_DEPENDENT,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_EN}
+      },
+      S_ACPI_IO_PM1_EN,
+      N_ACPI_IO_PM1_EN_RTC
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_STS}
+      },
+      S_ACPI_IO_PM1_STS,
+      N_ACPI_IO_PM1_STS_RTC
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PM1_STS_REG
+  }
+};
+
+/**
+  The register function used to register SMI handler of RTC alarm event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiSmiRtcAlarmRegister (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescRtcAlarm,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchAcpiSmiRtcAlarmType,
+             DispatchHandle
+             );
+
+  PchSmmClearSource (&mSrcDescRtcAlarm);
+  PchSmmEnableSource (&mSrcDescRtcAlarm);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// TmrOverflow srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescTmrOverflow = {
+  PCH_SMM_SCI_EN_DEPENDENT,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_EN}
+      },
+      S_ACPI_IO_PM1_EN,
+      N_ACPI_IO_PM1_EN_TMROF
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_STS}
+      },
+      S_ACPI_IO_PM1_STS,
+      N_ACPI_IO_PM1_STS_TMROF
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PM1_STS_REG
+  }
+};
+
+/**
+  The register function used to register SMI handler of Timer Overflow event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiSmiTmrOverflowRegister (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescTmrOverflow,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchAcpiSmiTmrOverflowType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescTmrOverflow);
+  PchSmmEnableSource (&mSrcDescTmrOverflow);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchAcpiSmiUnRegister (
+  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  DATABASE_RECORD                   *RecordToDelete;
+  EFI_STATUS                        Status;
+
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileUnregisterHandler (&gPchAcpiSmiDispatchProtocolGuid, RecordToDelete->Callback, NULL, 0);
+  }
+  return Status;
+}
+
+//
+// SerialIrq srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescSerialIrq = {
+  PCH_SMM_NO_FLAGS,
+  {
+    NULL_BIT_DESC_INITIALIZER,
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_SERIRQ
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_SERIRQ
+  }
+};
+
+/**
+  The register function used to register SMI handler of Serial IRQ event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchSmiSerialIrqRegister (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescSerialIrq,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchSmiSerialIrqType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescSerialIrq);
+  PchSmmEnableSource (&mSrcDescSerialIrq);
+  if (!EFI_ERROR (Status)) {
+     SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// McSmi srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescMcSmi = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_MCSMI
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_MCSMI
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_MCSMI
+  }
+};
+
+/**
+  The register function used to register SMI handler of MCSMI event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchSmiMcSmiRegister (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescMcSmi,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchSmiMcSmiType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescMcSmi);
+  PchSmmEnableSource (&mSrcDescMcSmi);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// SmBus srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescSmbus = {
+  PCH_SMM_NO_FLAGS,
+  {
+    NULL_BIT_DESC_INITIALIZER,
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_SMBUS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_SMBUS
+  }
+};
+
+/**
+  The register function used to register SMI handler of SMBUS event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchSmiSmbusRegister (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescSmbus,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchSmiSmBusType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescSmbus);
+  PchSmmEnableSource (&mSrcDescSmbus);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// SpiAsyncSmi srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescSpiAsyncSmi = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
+          R_SPI_CFG_BC
+        ) }
+      },
+      S_SPI_CFG_BC,
+      N_SPI_CFG_BC_ASE_BWP
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
+          R_SPI_CFG_BC
+        ) }
+      },
+      S_SPI_CFG_BC,
+      N_SPI_CFG_BC_ASYNC_SS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_SPI
+  }
+};
+
+/**
+  Special handling for SPI Asynchronous SMI.
+  If SPI ASYNC SMI is enabled, De-assert SMI is sent when Flash Cycle Done
+  transitions from 1 to 0 or when the SMI enable becomes false.
+
+  @param[in]  SrcDesc   Not used
+**/
+VOID
+EFIAPI
+PchSmiSpiAsyncClearSource (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  )
+{
+  UINT64                                SpiRegBase;
+  UINT32                                SpiBar0;
+
+  SpiRegBase = SpiPciCfgBase ();
+  SpiBar0 = PciSegmentRead32 (SpiRegBase + R_SPI_CFG_BAR0) & ~(B_SPI_CFG_BAR0_MASK);
+  if (SpiBar0 != PCH_SPI_BASE_ADDRESS) {
+    //
+    // Temporary disable MSE, and override with SPI reserved MMIO address, then enable MSE.
+    //
+    SpiBar0 = PCH_SPI_BASE_ADDRESS;
+    PciSegmentAnd8 (SpiRegBase + PCI_COMMAND_OFFSET, (UINT8) ~EFI_PCI_COMMAND_MEMORY_SPACE);
+    PciSegmentWrite32 (SpiRegBase + R_SPI_CFG_BAR0, SpiBar0);
+    PciSegmentOr8 (SpiRegBase + PCI_COMMAND_OFFSET, EFI_PCI_COMMAND_MEMORY_SPACE);
+  }
+
+  MmioOr32 (SpiBar0 + R_SPI_MEM_HSFSC, B_SPI_MEM_HSFSC_FDONE);
+}
+
+/**
+  Special handling to enable SPI Asynchronous SMI
+**/
+VOID
+PchSmiSpiAsyncEnableSource (
+  VOID
+  )
+{
+  UINT64 SpiRegBase;
+  UINT32 Data32And;
+  UINT32 Data32Or;
+
+  SpiRegBase = SpiPciCfgBase ();
+  Data32And = (UINT32) ~B_SPI_CFG_BC_SYNC_SS;
+  Data32Or = B_SPI_CFG_BC_ASE_BWP;
+
+  PciSegmentAndThenOr32 (
+    SpiRegBase + R_SPI_CFG_BC,
+    Data32And,
+    Data32Or
+    );
+  S3BootScriptSavePciCfgReadWrite (
+    S3BootScriptWidthUint32,
+    SpiRegBase + R_SPI_CFG_BC,
+    (VOID*) &Data32Or,
+    (VOID*) &Data32And
+    );
+
+  //
+  // Clear the source
+  //
+  PchSmiSpiAsyncClearSource (NULL);
+}
+
+/**
+  The register function used to register SMI handler of SPI Asynchronous event.
+
+  @param[in]  This                      The pointer to the protocol itself
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchSmiSpiAsyncRegister (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescSpiAsyncSmi,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchSmiSpiAsyncType,
+             DispatchHandle
+             );
+
+  if (!EFI_ERROR (Status)) {
+    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
+    Record->ClearSource = PchSmiSpiAsyncClearSource;
+    PchSmiSpiAsyncClearSource (NULL);
+    PchSmiSpiAsyncEnableSource ();
+    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+  @retval EFI_ACCESS_DENIED             Return access denied since SPI aync SMI handler is not able to disabled.
+**/
+EFI_STATUS
+EFIAPI
+PchSmiUnRegister (
+  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *Record;
+  UINT64                                SpiRegBase;
+  EFI_STATUS                            Status;
+
+  Record = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  if ((Record->SrcDesc.En[0].Reg.Type == PCIE_ADDR_TYPE) &&
+      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Dev == SpiDevNumber ()) &&
+      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Fnc == SpiFuncNumber ()) &&
+      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Reg == R_SPI_CFG_BC) &&
+      (Record->SrcDesc.En[0].Bit == N_SPI_CFG_BC_ASE_BWP)) {
+    SpiRegBase = SpiPciCfgBase ();
+    if (PciSegmentRead8 (SpiRegBase + R_SPI_CFG_BC) & B_SPI_CFG_BC_BILD) {
+      //
+      // SPI Asynchronous SMI cannot be disabled
+      //
+      return EFI_ACCESS_DENIED;
+    }
+  }
+  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileUnregisterHandler (&gPchSmiDispatchProtocolGuid, Record->Callback, NULL, 0);
+  }
+  return Status;
+}
+
+
+/**
+  Declaration of PCH TCO SMI DISPATCH PROTOCOL instance
+**/
+PCH_TCO_SMI_DISPATCH_PROTOCOL mPchTcoSmiDispatchProtocol = {
+  PCH_TCO_SMI_DISPATCH_REVISION,        // Revision
+  PchTcoSmiUnRegister,                  // Unregister
+  PchTcoSmiMchRegister,                 // Mch
+  PchTcoSmiTcoTimeoutRegister,          // TcoTimeout
+  PchTcoSmiOsTcoRegister,               // OsTco
+  PchTcoSmiNmiRegister,                 // Nmi
+  PchTcoSmiIntruderDetRegister,         // IntruderDectect
+  PchTcoSmiSpiBiosWpRegister,           // SpiBiosWp
+  PchTcoSmiLpcBiosWpRegister,           // LpcBiosWp
+  PchTcoSmiNewCenturyRegister           // NewCentury
+};
+
+/**
+  Declaration of PCH PCIE SMI DISPATCH PROTOCOL instance
+**/
+PCH_PCIE_SMI_DISPATCH_PROTOCOL mPchPcieSmiDispatchProtocol = {
+  PCH_PCIE_SMI_DISPATCH_REVISION,       // Revision
+  PchPcieSmiUnRegister,                 // Unregister
+  PchPcieSmiHotPlugRegister,            // PcieRpXHotPlug
+  PchPcieSmiLinkActiveRegister,         // PcieRpXLinkActive
+  PchPcieSmiLinkEqRegister              // PcieRpXLinkEq
+};
+
+/**
+  Declaration of PCH ACPI SMI DISPATCH PROTOCOL instance
+**/
+PCH_ACPI_SMI_DISPATCH_PROTOCOL mPchAcpiSmiDispatchProtocol = {
+  PCH_ACPI_SMI_DISPATCH_REVISION,       // Revision
+  PchAcpiSmiUnRegister,                 // Unregister
+  PchAcpiSmiPmeRegister,                // Pme
+  PchAcpiSmiPmeB0Register,              // PmeB0
+  PchAcpiSmiRtcAlarmRegister,           // RtcAlarm
+  PchAcpiSmiTmrOverflowRegister         // TmrOverflow
+};
+
+/**
+  Declaration of MISC PCH SMI DISPATCH PROTOCOL instance
+**/
+PCH_SMI_DISPATCH_PROTOCOL mPchSmiDispatchProtocol = {
+  PCH_SMI_DISPATCH_REVISION,            // Revision
+  PchSmiUnRegister,                     // Unregister
+  PchSmiSerialIrqRegister,              // SerialIrq
+  PchSmiMcSmiRegister,                  // McSmi
+  PchSmiSmbusRegister,                  // SmBus
+  PchSmiSpiAsyncRegister                // SpiAsync
+};
+
+/**
+  Install protocols of PCH specifics SMI types, including
+  PCH TCO SMI types, PCH PCIE SMI types, PCH ACPI SMI types, PCH MISC SMI types.
+
+  @retval                               the result of protocol installation
+**/
+EFI_STATUS
+InstallPchSmiDispatchProtocols (
+  VOID
+  )
+{
+  EFI_HANDLE                            Handle;
+  EFI_STATUS                            Status;
+
+  Handle = NULL;
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gPchTcoSmiDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mPchTcoSmiDispatchProtocol
+                    );
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gPchPcieSmiDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mPchPcieSmiDispatchProtocol
+                    );
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gPchAcpiSmiDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mPchAcpiSmiDispatchProtocol
+                    );
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gPchSmiDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mPchSmiDispatchProtocol
+                    );
+
+  return Status;
+}
+
+/**
+  The function to dispatch all callback function of PCH SMI types.
+
+  @retval EFI_SUCCESS                   Function successfully completed
+  @retval EFI_UNSUPPORTED               no
+**/
+EFI_STATUS
+PchSmiTypeCallbackDispatcher (
+  IN  DATABASE_RECORD                   *Record
+  )
+{
+  EFI_STATUS                            Status;
+  PCH_SMI_TYPES                         PchSmiType;
+  UINTN                                 RpIndex;
+  PCH_PCIE_SMI_RP_CONTEXT               RpContext;
+
+  PchSmiType = Record->PchSmiType;
+  Status     = EFI_SUCCESS;
+
+  switch (PchSmiType) {
+    case PchTcoSmiMchType:
+    case PchTcoSmiTcoTimeoutType:
+    case PchTcoSmiOsTcoType:
+    case PchTcoSmiNmiType:
+    case PchTcoSmiIntruderDetectType:
+    case PchTcoSmiSpiBiosWpType:
+    case PchTcoSmiLpcBiosWpType:
+    case PchTcoSmiNewCenturyType:
+      ((PCH_TCO_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback)) ((EFI_HANDLE)&Record->Link);
+      break;
+    case PchPcieSmiRpHotplugType:
+    case PchPcieSmiRpLinkActiveType:
+    case PchPcieSmiRpLinkEqType:
+      RpContext.BusNum  = DEFAULT_PCI_BUS_NUMBER_PCH;
+      RpContext.DevNum  = (UINT8) Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Dev;
+      RpContext.FuncNum = (UINT8) Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Fnc;
+      GetPcieRpNumber (RpContext.DevNum, RpContext.FuncNum, &RpIndex);
+      RpContext.RpIndex = (UINT8) RpIndex;
+      ((PCH_PCIE_SMI_RP_DISPATCH_CALLBACK) (Record->PchSmiCallback)) ((EFI_HANDLE)&Record->Link, &RpContext);
+      break;
+    case PchAcpiSmiPmeType:
+    case PchAcpiSmiPmeB0Type:
+    case PchAcpiSmiRtcAlarmType:
+    case PchAcpiSmiTmrOverflowType:
+      ((PCH_ACPI_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback)) ((EFI_HANDLE)&Record->Link);
+      break;
+    case PchEspiSmiEspiSlaveType:
+      ((PCH_ESPI_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback)) ((EFI_HANDLE)&Record->Link);
+      break;
+    case PchSmiSerialIrqType:
+    case PchSmiMcSmiType:
+    case PchSmiSmBusType:
+    case PchSmiSpiAsyncType:
+    case PchIoTrapSmiType:                ///< internal type for IoTrap
+      ((PCH_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback)) ((EFI_HANDLE)&Record->Link);
+      break;
+    default:
+      Status = EFI_UNSUPPORTED;
+      break;
+  }
+
+  return Status;
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescIoTrap[4] = {
+  //
+  // PCH I/O Trap register 0 monitor
+  //
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG0) }
+        },
+        4,
+        0
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
+        },
+        1,
+        0
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_MONITOR
+    }
+  },
+  //
+  // PCH I/O Trap register 1 monitor
+  //
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG1) }
+        },
+        4,
+        0
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
+        },
+        1,
+        1
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_MONITOR
+    }
+  },
+  //
+  // PCH I/O Trap register 2 monitor
+  //
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG2) }
+        },
+        4,
+        0
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
+        },
+        1,
+        2
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_MONITOR
+    }
+  },
+  //
+  // PCH I/O Trap register 3 monitor,
+  //
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG3) }
+        },
+        4,
+        0
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          PCR_ADDR_TYPE,
+          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
+        },
+        1,
+        3
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_MONITOR
+    }
+  }
+};
+
+/**
+  The register function used to register SMI handler of IoTrap event.
+  This is internal function and only used by Iotrap module.
+
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  IoTrapIndex               Index number of IOTRAP register
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+PchInternalIoTrapSmiRegister (
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  IN  UINTN                             IoTrapIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  Status = PchSmiRecordInsert (
+             &mSrcDescIoTrap[IoTrapIndex],
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchIoTrapSmiType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescIoTrap[IoTrapIndex]);
+  PchSmmEnableSource (&mSrcDescIoTrap[IoTrapIndex]);
+  return Status;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+**/
+EFI_STATUS
+PchInternalIoTrapSmiUnRegister (
+  IN  EFI_HANDLE                        DispatchHandle
+  )
+{
+  return PchSmmCoreUnRegister (NULL, DispatchHandle);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.inf
new file mode 100644
index 0000000000..97ad2f457e
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.inf
@@ -0,0 +1,116 @@
+## @file
+# Component description file for the Pch SMI Dispatch Handlers module
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = PchSmiDispatcher
+FILE_GUID = B0D6ED53-B844-43f5-BD2F-61095264E77E
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_SMM_DRIVER
+PI_SPECIFICATION_VERSION = 1.10
+ENTRY_POINT = InitializePchSmmDispatcher
+
+
+[LibraryClasses]
+UefiBootServicesTableLib
+UefiDriverEntryPoint
+IoLib
+DebugLib
+PcdLib
+BaseLib
+BaseMemoryLib
+HobLib
+DevicePathLib
+PchCycleDecodingLib
+PchPcieRpLib
+PchPcrLib
+SmmServicesTableLib
+ReportStatusCodeLib
+PerformanceLib
+DxeServicesTableLib
+GpioLib
+GpioPrivateLib
+EspiLib
+S3BootScriptLib
+ConfigBlockLib
+PmcPrivateLib
+PmcLib
+SmiHandlerProfileLib
+CpuPcieRpLib
+PchPciBdfLib
+PmcPrivateLibWithS3
+CpuPcieInfoFruLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Pcd]
+# Progress Code for S3 Suspend start.
+# PROGRESS_CODE_S3_SUSPEND_START = (EFI_SOFTWARE_SMM_DRIVER | (EFI_OEM_SPECIFIC | 0x00000000))    = 0x03078000
+gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendStart
+# Progress Code for S3 Suspend end.
+# PROGRESS_CODE_S3_SUSPEND_END   = (EFI_SOFTWARE_SMM_DRIVER | (EFI_OEM_SPECIFIC | 0x00000001))    = 0x03078001
+gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendEnd
+gSiPkgTokenSpaceGuid.PcdEfiGcdAllocateType
+
+
+[Sources]
+PchSmm.h
+PchSmmCore.c
+PchSmmHelpers.h
+PchSmmHelpers.c
+PchxSmmHelpers.h
+PchxSmmHelpers.c
+PchSmmUsb.c
+PchSmmGpi.c
+PchSmmPowerButton.c
+PchSmmSw.c
+PchSmmSx.c
+PchSmmPeriodicTimer.c
+IoTrap.c
+PchSmiDispatch.c
+PchSmmEspi.c
+PchSmiHelperClient.c
+
+
+[Protocols]
+gEfiPciRootBridgeIoProtocolGuid ## CONSUMES
+gEfiSmmGpiDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmSxDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmSwDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmUsbDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmPowerButtonDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmPeriodicTimerDispatch2ProtocolGuid ## PRODUCES
+gEfiSmmBase2ProtocolGuid ## CONSUMES
+gEfiSmmCpuProtocolGuid ## CONSUMES
+gEfiSmmReadyToLockProtocolGuid ## CONSUMES
+gEfiSmmIoTrapDispatch2ProtocolGuid ## PRODUCES
+gPchSmmIoTrapControlGuid ## PRODUCES
+gPchTcoSmiDispatchProtocolGuid ## PRODUCES
+gPchPcieSmiDispatchProtocolGuid ## PRODUCES
+gPchAcpiSmiDispatchProtocolGuid ## PRODUCES
+gPchSmiDispatchProtocolGuid ## PRODUCES
+gPchEspiSmiDispatchProtocolGuid ## PRODUCES
+gPchSmmPeriodicTimerControlGuid ## PRODUCES
+gIoTrapExDispatchProtocolGuid ## PRODUCES
+gPchNvsAreaProtocolGuid ## CONSUMES
+
+
+[Guids]
+
+
+[Depex]
+gEfiPciRootBridgeIoProtocolGuid AND
+gEfiPciHostBridgeResourceAllocationProtocolGuid AND ## This is to ensure that PCI MMIO resource has been prepared and available for this driver to allocate.
+gEfiSmmCpuProtocolGuid AND
+gEfiSmmBase2ProtocolGuid AND ## This is for SmmServicesTableLib
+gPchNvsAreaProtocolGuid
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper.h
new file mode 100644
index 0000000000..189197f4a2
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper.h
@@ -0,0 +1,40 @@
+/** @file
+  eSPI SMI Dispatch header
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_SMI_HELPER_H_
+#define _PCH_SMI_HELPER_H_
+#include <Uefi/UefiBaseType.h>
+
+/**
+  Get Root Port physical Number by CPU or PCH Pcie Root Port Device and Function Number
+
+  @param[in]  RpDev                 Root port device number.
+  @param[in]  RpFun                 Root port function number.
+  @param[out] RpNumber              Return corresponding physical Root Port index (0-based)
+**/
+VOID
+GetPcieRpNumber (
+  IN  UINTN   RpDev,
+  IN  UINTN   RpFun,
+  OUT UINTN   *RpNumber
+  );
+
+/**
+  Get CPU or PCH Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber              Root port physical number. (0-based)
+  @param[out] RpDev                 Return corresponding root port device number.
+  @param[out] RpFun                 Return corresponding root port function number.
+**/
+VOID
+GetPcieRpDevFun (
+  IN  UINTN   RpIndex,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelperClient.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelperClient.c
new file mode 100644
index 0000000000..7693e76683
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelperClient.c
@@ -0,0 +1,57 @@
+/** @file
+  This file provides function to handle client-server differences.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Register/PmcRegs.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Register/CpuPcieRegs.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <Library/CpuPcieRpLib.h>
+#include <CpuPcieInfo.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/PchPciBdfLib.h>
+
+/**
+  Get Root Port physical Number by CPU or PCH Pcie Root Port Device and Function Number
+
+  @param[in]  RpDev                 Root port device number.
+  @param[in]  RpFun                 Root port function number.
+  @param[out] RpNumber              Return corresponding physical Root Port index (0-based)
+**/
+VOID
+GetPcieRpNumber (
+  IN  UINTN   RpDev,
+  IN  UINTN   RpFun,
+  OUT UINTN   *RpNumber
+  )
+{
+  UINT64  RpBase;
+  RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, RpDev, RpFun, 0);
+  GetPchPcieRpNumber (RpDev, RpFun, RpNumber);
+}
+
+/**
+  Get CPU or PCH Pcie Root Port Device and Function Number by Root Port physical Number
+
+  @param[in]  RpNumber              Root port physical number. (0-based)
+  @param[out] RpDev                 Return corresponding root port device number.
+  @param[out] RpFun                 Return corresponding root port function number.
+**/
+VOID
+GetPcieRpDevFun (
+  IN  UINTN   RpIndex,
+  OUT UINTN   *RpDev,
+  OUT UINTN   *RpFun
+  )
+{
+  if (RpIndex >= CpuRpIndex0 && RpIndex <= CpuRpIndex3) {
+    GetCpuPcieRpDevFun ((RpIndex - CpuRpIndex0), RpDev, RpFun);
+  } else {
+    *RpDev = PchPcieRpDevNumber (RpIndex);
+    *RpFun = PchPcieRpFuncNumber (RpIndex);
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
new file mode 100644
index 0000000000..6a23de2bc9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
@@ -0,0 +1,1043 @@
+/** @file
+  Prototypes and defines for the PCH SMM Dispatcher.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCH_SMM_H_
+#define _PCH_SMM_H_
+
+#include <Uefi.h>
+#include <Protocol/PciRootBridgeIo.h>
+#include <Protocol/LoadedImage.h>
+#include <Protocol/SmmControl2.h>
+#include <Protocol/SmmUsbDispatch2.h>
+#include <Protocol/SmmSxDispatch2.h>
+#include <Protocol/SmmSwDispatch2.h>
+#include <Protocol/SmmGpiDispatch2.h>
+#include <Protocol/SmmPowerButtonDispatch2.h>
+#include <Protocol/SmmPeriodicTimerDispatch2.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IoLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/ReportStatusCodeLib.h>
+#include <Library/PerformanceLib.h>
+#include <Protocol/SmmReadyToLock.h>
+#include <IndustryStandard/Pci30.h>
+#include <Library/PchCycleDecodingLib.h>
+#include <Library/PchPcieRpLib.h>
+#include <Library/PchPcrLib.h>
+#include <Library/PciSegmentLib.h>
+#include <Library/GpioLib.h>
+#include <Library/PchInfoLib.h>
+#include <Library/EspiLib.h>
+#include <Library/GpioPrivateLib.h>
+#include <Protocol/PchTcoSmiDispatch.h>
+#include <Protocol/PchPcieSmiDispatch.h>
+#include <Protocol/PchAcpiSmiDispatch.h>
+#include <Protocol/PchSmiDispatch.h>
+#include <Protocol/PchEspiSmiDispatch.h>
+#include <Protocol/IoTrapExDispatch.h>
+#include <Library/PmcLib.h>
+#include "IoTrap.h"
+
+#define EFI_BAD_POINTER          0xAFAFAFAFAFAFAFAFULL
+
+extern BOOLEAN                   mReadyToLock;
+
+///
+/// Define an enumeration for all the supported protocols
+///
+#define PCH_SMM_PROTOCOL_TYPE_MAX       6
+
+typedef enum {
+  UsbType,
+  SxType,
+  SwType,
+  GpiType,
+  PowerButtonType,
+  PeriodicTimerType,
+  PchSmiDispatchType,
+  PchSmmProtocolTypeMax
+} PCH_SMM_PROTOCOL_TYPE;
+
+///
+/// Define all the supported types of PCH SMI
+///
+typedef enum {
+  PchTcoSmiMchType,
+  PchTcoSmiTcoTimeoutType,
+  PchTcoSmiOsTcoType,
+  PchTcoSmiNmiType,
+  PchTcoSmiIntruderDetectType,
+  PchTcoSmiSpiBiosWpType,
+  PchTcoSmiLpcBiosWpType,
+  PchTcoSmiNewCenturyType,
+  PchPcieSmiRpHotplugType,
+  PchPcieSmiRpLinkActiveType,
+  PchPcieSmiRpLinkEqType,
+  PchAcpiSmiPmeType,
+  PchAcpiSmiPmeB0Type,
+  PchAcpiSmiRtcAlarmType,
+  PchAcpiSmiTmrOverflowType,
+  PchEspiSmiEspiSlaveType,
+  PchSmiSerialIrqType,
+  PchSmiMcSmiType,
+  PchSmiSmBusType,
+  PchSmiSpiAsyncType,
+  PchIoTrapSmiType                      ///< internal SMI type
+} PCH_SMI_TYPES;
+
+///
+/// Generic funciton pointer to cover all Pch SMI function pointer types
+///
+typedef
+VOID
+(EFIAPI *PCH_SMI_CALLBACK_FUNCTIONS) (
+  IN EFI_HANDLE                         DispatchHandle,
+  ...
+  );
+
+
+///
+/// SPECIFYING A REGISTER
+/// We want a general way of referring to addresses.  For this case, we'll only
+/// need addresses in the ACPI table (and the TCO entries within the ACPI table).
+/// However, it's interesting to consider what it would take to support other types
+/// of addresses.  To address Will's concern, I think it prudent to accommodate it
+/// early on in the design.
+///
+/// Addresses we need to consider:
+///
+///  Type:                           Required:
+///  I/O                             Yes
+///    ACPI (special case of I/O)    Only if we want to
+///    TCO  (special case of I/O)    Only if we want to
+///  GPIO  (special case of MMIO)    Only if we want to
+///  Memory (or Memory Mapped I/O)   Only if we want to
+///  PCIE                            Yes, for BiosWp
+///
+typedef enum {
+  ///
+  ///  IO_ADDR_TYPE, /// unimplemented
+  ///
+  ACPI_ADDR_TYPE,
+  TCO_ADDR_TYPE,
+  ///
+  ///  MEMORY_ADDR_TYPE, /// unimplemented
+  ///
+  GPIO_ADDR_TYPE,
+  MEMORY_MAPPED_IO_ADDRESS_TYPE,
+  PCIE_ADDR_TYPE,
+  PCR_ADDR_TYPE,
+  NUM_ADDR_TYPES,                     ///< count of items in this enum
+  PCH_SMM_ADDR_TYPE_NULL        = -1  ///< sentinel to indicate NULL or to signal end of arrays
+} ADDR_TYPE;
+
+//
+// Assumption: 32-bits -- enum's evaluate to integer
+// Assumption: This code will only run on IA-32.  Justification: IA-64 doesn't have SMIs.
+// We don't have to worry about 64-bit addresses.
+// Typedef the size of addresses in case the numbers I'm using are wrong or in case
+// this changes.  This is a good idea because PCI_ADDR will change, for example, when
+// we add support for PciExpress.
+//
+typedef UINT16 IO_ADDR;
+typedef IO_ADDR ACPI_ADDR;  ///< can omit
+typedef IO_ADDR TCO_ADDR;   ///< can omit
+typedef UINTN MEM_ADDR;
+typedef MEM_ADDR *MEMORY_MAPPED_IO_ADDRESS;
+typedef MEM_ADDR *GPIO_ADDR;
+typedef union {
+  UINT32  Raw;
+  struct {
+    UINT32 Reg: 16;
+    UINT32 Fnc: 3;
+    UINT32 Dev: 5;
+    UINT32 Bus: 8;
+  } Fields;
+} PCIE_ADDR;
+
+typedef union {
+  UINT32  Raw;
+  struct {
+    UINT16 Offset;
+    UINT8  Pid;
+    UINT8  Base;
+  } Fields;
+} PCR_ADDR;
+
+typedef struct {
+  ADDR_TYPE Type;
+  union {
+    ///
+    /// used to initialize during declaration/definition
+    ///
+    UINT32                    raw;
+
+    ///
+    /// used to access useful data
+    ///
+    IO_ADDR                   io;
+    ACPI_ADDR                 acpi;
+    TCO_ADDR                  tco;
+    GPIO_ADDR                 gpio;
+    MEM_ADDR                  mem;
+    MEMORY_MAPPED_IO_ADDRESS  Mmio;
+    PCIE_ADDR                 pcie;
+    PCR_ADDR                  Pcr;
+
+  } Data;
+
+} PCH_SMM_ADDRESS;
+
+///
+/// SPECIFYING BITS WITHIN A REGISTER
+/// Here's a struct that helps us specify a source or enable bit.
+///
+typedef struct {
+  PCH_SMM_ADDRESS Reg;
+  UINT8           SizeInBytes;  ///< of the register
+  UINT8           Bit;
+} PCH_SMM_BIT_DESC;
+
+//
+// Sometimes, we'll have bit descriptions that are unused.  It'd be great to have a
+// way to easily identify them:
+//
+#define IS_BIT_DESC_NULL(BitDesc)   ((BitDesc).Reg.Type == PCH_SMM_ADDR_TYPE_NULL)  ///< "returns" true when BitDesc is NULL
+#define NULL_THIS_BIT_DESC(BitDesc) ((BitDesc).Reg.Type = PCH_SMM_ADDR_TYPE_NULL)   ///< will "return" an integer w/ value of 0
+#define NULL_BIT_DESC_INITIALIZER \
+  { \
+    { \
+      PCH_SMM_ADDR_TYPE_NULL, \
+      { \
+        0 \
+      } \
+    }, \
+    0, 0 \
+  }
+//
+// I'd like a type to specify the callback's Sts & En bits because they'll
+// be commonly used together:
+//
+#define NUM_EN_BITS   2
+#define NUM_STS_BITS  1
+
+//
+// Flags
+//
+typedef UINT8 PCH_SMM_SOURCE_FLAGS;
+
+//
+// Flags required to describe the event source
+//
+#define PCH_SMM_NO_FLAGS          0
+#define PCH_SMM_SCI_EN_DEPENDENT  1
+
+typedef struct {
+  PCH_SMM_SOURCE_FLAGS  Flags;
+  PCH_SMM_BIT_DESC      En[NUM_EN_BITS];    ///< Describes the enable bit(s) for the SMI event
+  PCH_SMM_BIT_DESC      Sts[NUM_STS_BITS];  ///< Describes the secondary status bit for the SMI event. Might be the same as TopLevelSmi
+  PCH_SMM_BIT_DESC      PmcSmiSts;          ///< Refereing to the top level status bit in PMC SMI_STS, i.e. R_PCH_SMI_STS
+} PCH_SMM_SOURCE_DESC;
+
+///
+/// Used to initialize null source descriptor
+///
+#define NULL_SOURCE_DESC_INITIALIZER \
+  { \
+    PCH_SMM_NO_FLAGS, \
+    { \
+      NULL_BIT_DESC_INITIALIZER, NULL_BIT_DESC_INITIALIZER \
+    }, \
+    { \
+      NULL_BIT_DESC_INITIALIZER \
+    }, \
+    NULL_BIT_DESC_INITIALIZER \
+  }
+
+///
+/// Define a PCIE RP event context for SmiProfileHandlerInfo tool
+///
+typedef struct {
+  PCH_SMI_TYPES               PchSmiType;
+  UINTN                       RpIndex;
+} PCH_SMM_PCIE_REGISTER_CONTEXT;
+
+///
+/// CHILD CONTEXTS
+/// To keep consistent w/ the architecture, we'll need to provide the context
+/// to the child when we call its callback function.  After talking with Will,
+/// we agreed that we'll need functions to "dig" the context out of the hardware
+/// in many cases (Sx, Trap, Gpi, etc), and we'll need a function to compare those
+/// contexts to prevent unnecessary dispatches.  I'd like a general type for these
+/// "GetContext" functions, so I'll need a union of all the protocol contexts for
+/// our internal use:
+///
+typedef union {
+  //
+  // (in no particular order)
+  //
+  EFI_SMM_SX_REGISTER_CONTEXT             Sx;
+  EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT PeriodicTimer;
+  EFI_SMM_SW_REGISTER_CONTEXT             Sw;
+  EFI_SMM_POWER_BUTTON_REGISTER_CONTEXT   PowerButton;
+  EFI_SMM_USB_REGISTER_CONTEXT            Usb;
+  EFI_SMM_GPI_REGISTER_CONTEXT            Gpi;
+  PCH_SMM_PCIE_REGISTER_CONTEXT           Pcie;
+} PCH_SMM_CONTEXT;
+
+///
+/// Misc data for PchDispatcher usage.
+/// For PeriodicTimer, since the ElapsedTime is removed from EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT of EDKII,
+/// and PchDispatcher needs it for every record. Thus move it here to support ElapsedTime.
+///
+typedef struct {
+  UINTN    ElapsedTime;
+  ///
+  /// A switch to control periodic timer SMI enabling
+  ///
+  BOOLEAN  TimerSmiEnabled;
+} PCH_SMM_MISC_DATA;
+
+//
+// Assumption: PeriodicTimer largest at 3x64-bits or 24 bytes
+//
+typedef struct _DATABASE_RECORD DATABASE_RECORD;
+
+///
+/// Assumption: the GET_CONTEXT function will be as small and simple as possible.
+/// Assumption: We don't need to pass in an enumeration for the protocol because each
+///    GET_CONTEXT function is written for only one protocol.
+/// We also need a function to compare contexts to see if the child should be dispatched
+/// In addition, we need a function to acquire CommBuffer and CommBufferSize for
+///    dispatch callback function of EDKII native support.
+///
+typedef
+VOID
+(EFIAPI *GET_CONTEXT) (
+  IN  DATABASE_RECORD    * Record,
+  OUT PCH_SMM_CONTEXT    * Context
+  );
+
+typedef
+BOOLEAN
+(EFIAPI *CMP_CONTEXT) (
+  IN PCH_SMM_CONTEXT     * Context1,
+  IN PCH_SMM_CONTEXT     * Context2
+  );
+
+typedef
+VOID
+(EFIAPI *GET_COMMBUFFER) (
+  IN  DATABASE_RECORD    * Record,
+  OUT VOID               **CommBuffer,
+  OUT UINTN              * CommBufferSize
+  );
+
+///
+/// Finally, every protocol will require a "Get Context" and "Compare Context" call, so
+/// we may as well wrap that up in a table, too.
+///
+typedef struct {
+  GET_CONTEXT     GetContext;
+  CMP_CONTEXT     CmpContext;
+  GET_COMMBUFFER  GetCommBuffer;
+} CONTEXT_FUNCTIONS;
+
+extern CONTEXT_FUNCTIONS          ContextFunctions[PCH_SMM_PROTOCOL_TYPE_MAX];
+
+///
+/// MAPPING CONTEXT TO BIT DESCRIPTIONS
+/// I'd like to have a general approach to mapping contexts to bit descriptions.
+/// Sometimes, we'll find that we can use table lookups or constant assignments;
+/// other times, we'll find that we'll need to use a function to perform the mapping.
+/// If we define a macro to mask that process, we'll never have to change the code.
+/// I don't know if this is desirable or not -- if it isn't, then we can get rid
+/// of the macros and just use function calls or variable assignments.  Doesn't matter
+/// to me.
+/// Mapping complex contexts requires a function
+///
+
+/**
+  Maps a USB context to a source description.
+
+  @param[in] Context              The context we need to map.  Type must be USB.
+  @param[out] SrcDesc             The source description that corresponds to the given context.
+
+**/
+VOID
+MapUsbToSrcDesc (
+  IN  PCH_SMM_CONTEXT         *Context,
+  OUT PCH_SMM_SOURCE_DESC     *SrcDesc
+  );
+
+/**
+  Figure out which timer the child is requesting and
+  send back the source description
+
+  @param[in] DispatchContext      The pointer to the Dispatch Context instances
+  @param[out] SrcDesc             The pointer to the source description
+
+**/
+VOID
+MapPeriodicTimerToSrcDesc (
+  IN  PCH_SMM_CONTEXT                                         *DispatchContext,
+  OUT PCH_SMM_SOURCE_DESC                                     *SrcDesc
+  );
+
+//
+// Mapping simple contexts can be done by assignment or lookup table
+//
+extern CONST PCH_SMM_SOURCE_DESC  mSxSourceDesc;
+extern CONST PCH_SMM_SOURCE_DESC  mPowerButtonSourceDesc;
+extern CONST PCH_SMM_SOURCE_DESC  mSrcDescNewCentury;
+extern CONST PCH_SMM_SOURCE_DESC  mGpiSourceDescTemplate;
+
+///
+/// For PCHx, APMC is UINT8 port, so the MAX SWI Value is 0xFF.
+///
+#define MAXIMUM_SWI_VALUE 0xFF
+///
+/// Open: Need to make sure this kind of type cast will actually work.
+///   May need an intermediate form w/ two VOID* arguments.  I'll figure
+///   that out when I start compiling.
+///
+typedef
+VOID
+(EFIAPI *PCH_SMM_CLEAR_SOURCE) (
+  CONST PCH_SMM_SOURCE_DESC * SrcDesc
+  );
+
+///
+/// "DATABASE" RECORD
+/// Linked list data structures
+///
+#define DATABASE_RECORD_SIGNATURE SIGNATURE_32 ('D', 'B', 'R', 'C')
+
+struct _DATABASE_RECORD {
+  UINT32                        Signature;
+  LIST_ENTRY                    Link;
+  BOOLEAN                       Processed;
+  ///
+  /// Status and Enable bit description
+  ///
+  PCH_SMM_SOURCE_DESC           SrcDesc;
+
+  ///
+  /// Callback function
+  ///
+  EFI_SMM_HANDLER_ENTRY_POINT2  Callback;
+  PCH_SMM_CONTEXT               ChildContext;
+  UINTN                         ContextSize;
+
+  ///
+  /// Special handling hooks -- init them to NULL if unused/unneeded
+  ///
+  PCH_SMM_CLEAR_SOURCE          ClearSource;
+
+  ///
+  /// Functions required to make callback code general
+  ///
+  CONTEXT_FUNCTIONS             ContextFunctions;
+
+  ///
+  /// The protocol that this record dispatches
+  ///
+  PCH_SMM_PROTOCOL_TYPE         ProtocolType;
+
+  ///
+  /// Misc data for private usage
+  ///
+  PCH_SMM_MISC_DATA             MiscData;
+
+  ///
+  /// PCH SMI callback function
+  ///
+  PCH_SMI_CALLBACK_FUNCTIONS    PchSmiCallback;
+  ///
+  /// Indicate the PCH SMI types.
+  ///
+  PCH_SMI_TYPES                 PchSmiType;
+};
+
+#define DATABASE_RECORD_FROM_LINK(_record)  CR (_record, DATABASE_RECORD, Link, DATABASE_RECORD_SIGNATURE)
+#define DATABASE_RECORD_FROM_CHILDCONTEXT(_record)  CR (_record, DATABASE_RECORD, ChildContext, DATABASE_RECORD_SIGNATURE)
+
+///
+/// HOOKING INTO THE ARCHITECTURE
+///
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMM_GENERIC_REGISTER) (
+  IN  VOID                                    **This,
+  IN  VOID                                    *DispatchFunction,
+  IN  VOID                                    *DispatchContext,
+  OUT EFI_HANDLE                              *DispatchHandle
+  );
+typedef
+EFI_STATUS
+(EFIAPI *PCH_SMM_GENERIC_UNREGISTER) (
+  IN  VOID                                    **This,
+  IN  EFI_HANDLE                              DispatchHandle
+  );
+
+///
+/// Define a memory "stamp" equivalent in size and function to most of the protocols
+///
+typedef struct {
+  PCH_SMM_GENERIC_REGISTER    Register;
+  PCH_SMM_GENERIC_UNREGISTER  Unregister;
+  UINTN                       Extra1;
+  UINTN                       Extra2; ///< may not need this one
+} PCH_SMM_GENERIC_PROTOCOL;
+
+/**
+  Register a child SMI dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for this SMI source.
+  @param[in] DispatchContext      Pointer to the dispatch function's context.
+  @param[out] DispatchHandle      Handle of dispatch function, for when interfacing
+                                  with the parent SMM driver, will be the address of linked
+                                  list link in the call back record.
+
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources to create database record
+  @retval EFI_INVALID_PARAMETER   The input parameter is invalid
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+**/
+EFI_STATUS
+EFIAPI
+PchPiSmmCoreRegister (
+  IN  PCH_SMM_GENERIC_PROTOCOL                          *This,
+  IN  EFI_SMM_HANDLER_ENTRY_POINT2                      DispatchFunction,
+  IN  PCH_SMM_CONTEXT                                   *DispatchContext,
+  OUT EFI_HANDLE                                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPiSmmCoreUnRegister (
+  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
+  IN EFI_HANDLE                                         *DispatchHandle
+  );
+
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchSmmCoreUnRegister (
+  IN  PCH_SMM_GENERIC_PROTOCOL                         *This,
+  IN  EFI_HANDLE                                       *DispatchHandle
+  );
+
+typedef union {
+  PCH_SMM_GENERIC_PROTOCOL                    Generic;
+  EFI_SMM_USB_DISPATCH2_PROTOCOL              Usb;
+  EFI_SMM_SX_DISPATCH2_PROTOCOL               Sx;
+  EFI_SMM_SW_DISPATCH2_PROTOCOL               Sw;
+  EFI_SMM_GPI_DISPATCH2_PROTOCOL              Gpi;
+  EFI_SMM_POWER_BUTTON_DISPATCH2_PROTOCOL     PowerButton;
+  EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL   PeriodicTimer;
+} PCH_SMM_PROTOCOL;
+
+///
+/// Define a structure to help us identify the generic protocol
+///
+#define PROTOCOL_SIGNATURE  SIGNATURE_32 ('P', 'R', 'O', 'T')
+
+typedef struct {
+  UINTN                 Signature;
+
+  PCH_SMM_PROTOCOL_TYPE Type;
+  EFI_GUID              *Guid;
+  PCH_SMM_PROTOCOL      Protocols;
+} PCH_SMM_QUALIFIED_PROTOCOL;
+
+#define QUALIFIED_PROTOCOL_FROM_GENERIC(_generic) \
+  CR ( \
+  _generic, \
+  PCH_SMM_QUALIFIED_PROTOCOL, \
+  Protocols, \
+  PROTOCOL_SIGNATURE \
+  )
+
+///
+/// Create private data for the protocols that we'll publish
+///
+typedef struct {
+  LIST_ENTRY                  CallbackDataBase;
+  EFI_HANDLE                  SmiHandle;
+  EFI_HANDLE                  InstallMultProtHandle;
+  PCH_SMM_QUALIFIED_PROTOCOL  Protocols[PCH_SMM_PROTOCOL_TYPE_MAX];
+} PRIVATE_DATA;
+
+extern PRIVATE_DATA           mPrivateData;
+extern UINT16                 mAcpiBaseAddr;
+extern UINT16                 mTcoBaseAddr;
+
+/**
+  The internal function used to create and insert a database record
+
+  @param[in]  InsertRecord              Record to insert to database.
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+SmmCoreInsertRecord (
+  IN  DATABASE_RECORD                   *NewRecord,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Get the Sleep type
+
+  @param[in] Record               No use
+  @param[out] Context             The context that includes SLP_TYP bits to be filled
+**/
+VOID
+EFIAPI
+SxGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *Context
+  );
+
+/**
+  Register a child SMI source dispatch function for the specified software SMI.
+
+  This service registers a function (DispatchFunction) which will be called when the software
+  SMI source specified by RegisterContext->SwSmiCpuIndex is detected. On return,
+  DispatchHandle contains a unique handle which may be used later to unregister the function
+  using UnRegister().
+
+  @param[in]  This                 Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
+  @param[in]  DispatchFunction     Function to register for handler when the specified software
+                                   SMI is generated.
+  @param[in, out] RegisterContext  Pointer to the dispatch function's context.
+                                   The caller fills this context in before calling
+                                   the register function to indicate to the register
+                                   function which Software SMI input value the
+                                   dispatch function should be invoked for.
+  @param[out] DispatchHandle       Handle generated by the dispatcher to track the
+                                   function instance.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully
+                                 registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR       The SW driver was unable to enable the SMI source.
+  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The SW SMI input value
+                                 is not within a valid range or is already in use.
+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system or SMM) to manage this
+                                 child.
+  @retval EFI_OUT_OF_RESOURCES   A unique software SMI value could not be assigned
+                                 for this dispatch.
+**/
+EFI_STATUS
+EFIAPI
+PchSwSmiRegister (
+  IN  EFI_SMM_SW_DISPATCH2_PROTOCOL       *This,
+  IN  EFI_SMM_HANDLER_ENTRY_POINT2        DispatchFunction,
+  IN  EFI_SMM_SW_REGISTER_CONTEXT         *DispatchContext,
+  OUT EFI_HANDLE                          *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function for the specified software SMI.
+
+  This service removes the handler associated with DispatchHandle so that it will no longer be
+  called in response to a software SMI.
+
+  @param[in] This                Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle      Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully unregistered.
+  @retval EFI_INVALID_PARAMETER  The DispatchHandle was not valid.
+**/
+EFI_STATUS
+EFIAPI
+PchSwSmiUnRegister (
+  IN CONST EFI_SMM_SW_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_HANDLE                     DispatchHandle
+  );
+
+/**
+  Init required protocol for Pch Sw Dispatch protocol.
+**/
+VOID
+PchSwDispatchInit (
+  VOID
+  );
+
+/**
+  Check whether sleep type of two contexts match
+
+  @param[in] Context1             Context 1 that includes sleep type 1
+  @param[in] Context2             Context 2 that includes sleep type 2
+
+  @retval FALSE                   Sleep types match
+  @retval TRUE                    Sleep types don't match
+**/
+BOOLEAN
+EFIAPI
+SxCmpContext (
+  IN PCH_SMM_CONTEXT     *Context1,
+  IN PCH_SMM_CONTEXT     *Context2
+  );
+
+/**
+  Update the elapsed time from the Interval data of DATABASE_RECORD
+
+  @param[in] Record               The pointer to the DATABASE_RECORD.
+  @param[out] HwContext           The Context to be updated.
+**/
+VOID
+EFIAPI
+PeriodicTimerGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *Context
+  );
+
+/**
+  Check whether Periodic Timer of two contexts match
+
+  @param[in] Context1             Context 1 that includes Periodic Timer  1
+  @param[in] Context2             Context 2 that includes Periodic Timer  2
+
+  @retval FALSE                   Periodic Timer match
+  @retval TRUE                    Periodic Timer don't match
+**/
+BOOLEAN
+EFIAPI
+PeriodicTimerCmpContext (
+  IN PCH_SMM_CONTEXT     *Context1,
+  IN PCH_SMM_CONTEXT     *Context2
+  );
+
+/**
+  Gather the CommBuffer information of SmmPeriodicTimerDispatch2.
+
+  @param[in]  Record              No use
+  @param[out] CommBuffer          Point to the CommBuffer structure
+  @param[out] CommBufferSize      Point to the Size of CommBuffer structure
+**/
+VOID
+EFIAPI
+PeriodicTimerGetCommBuffer (
+  IN  DATABASE_RECORD    *Record,
+  OUT VOID               **CommBuffer,
+  OUT UINTN              *CommBufferSize
+  );
+
+/**
+  Get the power button status.
+
+  @param[in] Record               The pointer to the DATABASE_RECORD.
+  @param[out] Context             Calling context from the hardware, will be updated with the current power button status.
+**/
+VOID
+EFIAPI
+PowerButtonGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *Context
+  );
+
+/**
+  Check whether Power Button status of two contexts match
+
+  @param[in] Context1             Context 1 that includes Power Button status 1
+  @param[in] Context2             Context 2 that includes Power Button status 2
+
+  @retval FALSE                   Power Button status match
+  @retval TRUE                    Power Button status don't match
+**/
+BOOLEAN
+EFIAPI
+PowerButtonCmpContext (
+  IN PCH_SMM_CONTEXT     *Context1,
+  IN PCH_SMM_CONTEXT     *Context2
+  );
+
+/**
+  This function is responsible for calculating and enabling any timers that are required
+  to dispatch messages to children. The SrcDesc argument isn't acutally used.
+
+  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC instance.
+**/
+VOID
+EFIAPI
+PchSmmPeriodicTimerClearSource (
+  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
+  );
+
+/**
+  This services returns the next SMI tick period that is supported by the chipset.
+  The order returned is from longest to shortest interval period.
+
+  @param[in] This                 Pointer to the EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL instance.
+  @param[in, out] SmiTickInterval Pointer to pointer of the next shorter SMI interval period that is supported by the child.
+
+  @retval EFI_SUCCESS             The service returned successfully.
+  @retval EFI_INVALID_PARAMETER   The parameter SmiTickInterval is invalid.
+**/
+EFI_STATUS
+PchSmmPeriodicTimerDispatchGetNextShorterInterval (
+  IN CONST EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL    *This,
+  IN OUT UINT64                                         **SmiTickInterval
+  );
+
+/**
+  Install PCH SMM periodic timer control protocol
+
+  @param[in] Handle                     handle for this driver
+
+  @retval EFI_SUCCESS                   Driver initialization completed successfully
+**/
+EFI_STATUS
+EFIAPI
+InstallPchSmmPeriodicTimerControlProtocol (
+  IN EFI_HANDLE                         Handle
+  );
+
+/**
+  When we get an SMI that indicates that we are transitioning to a sleep state,
+  we need to actually transition to that state.  We do this by disabling the
+  "SMI on sleep enable" feature, which generates an SMI when the operating system
+  tries to put the system to sleep, and then physically putting the system to sleep.
+**/
+VOID
+PchSmmSxGoToSleep (
+  VOID
+  );
+
+/**
+  Install protocols of PCH specifics SMI types, including
+  PCH TCO SMI types, PCH PCIE SMI types, PCH ACPI SMI types, PCH MISC SMI types.
+
+  @retval                               the result of protocol installation
+**/
+EFI_STATUS
+InstallPchSmiDispatchProtocols (
+  VOID
+  );
+
+/**
+  The function to dispatch all callback function of PCH SMI types.
+
+  @retval EFI_SUCCESS                   Function successfully completed
+  @retval EFI_UNSUPPORTED               no
+**/
+EFI_STATUS
+PchSmiTypeCallbackDispatcher (
+  IN  DATABASE_RECORD                   *Record
+  );
+
+/**
+  The register function used to register SMI handler of IoTrap event.
+  This is internal function and only used by Iotrap module.
+
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  IoTrapIndex               Index number of IOTRAP register
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+PchInternalIoTrapSmiRegister (
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  IN  UINTN                             IoTrapIndex,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+**/
+EFI_STATUS
+PchInternalIoTrapSmiUnRegister (
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  Register an eSPI SMI handler based on the type
+
+  @param[in]  DispatchFunction        Callback in an event of eSPI SMI
+  @param[in]  PchSmiTypes             The eSPI type published by PchSmiDispatch
+  @param[out] DispatchHandle          The callback handle
+
+  @retval     EFI_INVALID_PARAMETER   Error with NULL SMI source description
+  @retval     EFI_OUT_OF_RESOURCES    Fail to allocate pool for database record
+  @retval     EFI_SUCCESS             Registration is successful.
+**/
+EFI_STATUS
+PchInternalEspiSmiRegister (
+  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
+  IN  PCH_SMI_TYPES                     PchSmiTypes,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  Unregister an eSPI SMI handler
+
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+**/
+EFI_STATUS
+PchInternalEspiSmiUnRegister (
+  IN  EFI_HANDLE                        DispatchHandle
+  );
+
+/**
+  The internal function used to create and insert a database record
+  for SMI record of Pch Smi types.
+
+  @param[in]  SrcDesc                   The pointer to the SMI source description
+  @param[in]  DispatchFunction          Pointer to dispatch function to be invoked for this SMI source
+  @param[in]  PchSmiType                Specific SMI type of PCH SMI
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+PchSmiRecordInsert (
+  IN  CONST PCH_SMM_SOURCE_DESC         *SrcDesc,
+  IN  PCH_SMI_CALLBACK_FUNCTIONS        DispatchFunction,
+  IN  PCH_SMI_TYPES                     PchSmiType,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+extern CONST PCH_SMM_SOURCE_DESC mSrcDescSerialIrq;
+extern CONST PCH_SMM_SOURCE_DESC mSrcDescLpcBiosWp;
+
+/**
+  Clear the TCO SMI status bit and block after the SMI handling is done
+
+  @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+
+**/
+VOID
+EFIAPI
+PchTcoSmiClearSourceAndBlock (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  );
+
+/**
+  Clear the TCO SMI status bit after the SMI handling is done
+
+  @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+
+**/
+VOID
+EFIAPI
+PchTcoSmiClearSource (
+  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
+  );
+
+/**
+  Initialize Source descriptor structure
+
+  @param[in] SrcDesc                    Pointer to the PCH SMI source description table
+**/
+VOID
+EFIAPI
+NullInitSourceDesc (
+  PCH_SMM_SOURCE_DESC                   *SrcDesc
+  );
+
+/**
+  The register function used to register SMI handler of GPI SMI event.
+
+  @param[in]  This               Pointer to the EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
+  @param[in]  DispatchFunction   Function to register for handler when the specified GPI causes an SMI.
+  @param[in]  RegisterContext    Pointer to the dispatch function's context.
+                                 The caller fills this context in before calling
+                                 the register function to indicate to the register
+                                 function the GPI(s) for which the dispatch function
+                                 should be invoked.
+  @param[out] DispatchHandle     Handle generated by the dispatcher to track the
+                                 function instance.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully
+                                 registered and the SMI source has been enabled.
+  @retval EFI_ACCESS_DENIED      Register is not allowed
+  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The GPI input value
+                                 is not within valid range.
+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system or SMM) to manage this child.
+**/
+EFI_STATUS
+EFIAPI
+PchGpiSmiRegister (
+  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_SMM_HANDLER_ENTRY_POINT2    DispatchFunction,
+  IN       EFI_SMM_GPI_REGISTER_CONTEXT    *RegisterContext,
+  OUT      EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  Unregister a GPI SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                 Pointer to the EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchGpiSmiUnRegister (
+  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_HANDLE                      DispatchHandle
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCore.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCore.c
new file mode 100644
index 0000000000..b2e76a8b72
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCore.c
@@ -0,0 +1,926 @@
+/** @file
+  This driver is responsible for the registration of child drivers
+  and the abstraction of the PCH SMI sources.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmm.h"
+#include "PchSmmHelpers.h"
+#include "PchSmmEspi.h"
+#include <Library/SmiHandlerProfileLib.h>
+#include <Register/GpioRegs.h>
+#include <Register/PmcRegs.h>
+#include <Register/RtcRegs.h>
+
+#define PROGRESS_CODE_S3_SUSPEND_START  PcdGet32 (PcdProgressCodeS3SuspendStart)
+//
+// MODULE / GLOBAL DATA
+//
+// Module variables used by the both the main dispatcher and the source dispatchers
+// Declared in PchSmm.h
+//
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                mAcpiBaseAddr;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                mTcoBaseAddr;
+GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN               mReadyToLock;
+GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN               mS3SusStart;
+
+GLOBAL_REMOVE_IF_UNREFERENCED PRIVATE_DATA          mPrivateData = {
+  {
+    NULL,
+    NULL
+  },                                    // CallbackDataBase linked list head
+  NULL,                                 // EFI handle returned when calling InstallMultipleProtocolInterfaces
+  NULL,                                 //
+  {                                     // protocol arrays
+    //
+    // elements within the array
+    //
+    {
+      PROTOCOL_SIGNATURE,
+      UsbType,
+      &gEfiSmmUsbDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
+      }}
+    },
+    {
+      PROTOCOL_SIGNATURE,
+      SxType,
+      &gEfiSmmSxDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
+      }}
+    },
+    {
+      PROTOCOL_SIGNATURE,
+      SwType,
+      &gEfiSmmSwDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchSwSmiRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchSwSmiUnRegister,
+        (UINTN) MAXIMUM_SWI_VALUE
+      }}
+    },
+    {
+      PROTOCOL_SIGNATURE,
+      GpiType,
+      &gEfiSmmGpiDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchGpiSmiRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchGpiSmiUnRegister,
+        (UINTN) PCH_GPIO_NUM_SUPPORTED_GPIS
+      }}
+    },
+    {
+      PROTOCOL_SIGNATURE,
+      PowerButtonType,
+      &gEfiSmmPowerButtonDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
+      }}
+    },
+    {
+      PROTOCOL_SIGNATURE,
+      PeriodicTimerType,
+      &gEfiSmmPeriodicTimerDispatch2ProtocolGuid,
+      {{
+        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
+        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister,
+        (UINTN) PchSmmPeriodicTimerDispatchGetNextShorterInterval
+      }}
+    },
+  }
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONTEXT_FUNCTIONS     mContextFunctions[PCH_SMM_PROTOCOL_TYPE_MAX] = {
+  {
+    NULL,
+    NULL,
+    NULL
+  },
+  {
+    SxGetContext,
+    SxCmpContext,
+    NULL
+  },
+  {
+    NULL,
+    NULL,
+    NULL
+  },
+  {
+    NULL,
+    NULL,
+    NULL
+  },
+  {
+    PowerButtonGetContext,
+    PowerButtonCmpContext,
+    NULL
+  },
+  {
+    PeriodicTimerGetContext,
+    PeriodicTimerCmpContext,
+    PeriodicTimerGetCommBuffer
+  },
+};
+
+//
+// PROTOTYPES
+//
+// Functions use only in this file
+//
+EFI_STATUS
+EFIAPI
+PchSmmCoreDispatcher (
+  IN       EFI_HANDLE         SmmImageHandle,
+  IN CONST VOID               *PchSmmCore,     OPTIONAL
+  IN OUT   VOID               *CommunicationBuffer,
+  IN OUT   UINTN              *SourceSize
+  );
+
+//
+// FUNCTIONS
+//
+/**
+  SMM ready to lock notification event handler.
+
+  @param  Protocol   Points to the protocol's unique identifier
+  @param  Interface  Points to the interface instance
+  @param  Handle     The handle on which the interface was installed
+
+  @retval EFI_SUCCESS   SmmReadyToLockCallback runs successfully
+
+**/
+EFI_STATUS
+EFIAPI
+SmmReadyToLockCallback (
+  IN CONST EFI_GUID                       *Protocol,
+  IN VOID                                 *Interface,
+  IN EFI_HANDLE                           Handle
+  )
+{
+  mReadyToLock = TRUE;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  <b>PchSmiDispatcher SMM Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+    The PchSmiDispatcher module is an SMM driver which  provides SMI handler registration
+    services for PCH generated SMIs.
+
+  - <b>Details</b>\n
+    This module provides SMI handler registration servicies for PCH SMIs.
+    NOTE: All the register/unregister functions will be locked after SMM ready to boot signal event.
+    Please make sure no handler is installed after that.
+
+  - @pre
+    - EFI_SMM_BASE2_PROTOCOL
+      - Documented in the System Management Mode Core Interface Specification
+    - EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+      - Documented in the UEFI 2.0 Specification and above
+    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
+      - This is to ensure that PCI MMIO and IO resource has been prepared and available for this driver to allocate.
+    - EFI_SMM_CPU_PROTOCOL
+
+  - @result
+    The PchSmiDispatcher driver produces:
+    - EFI_SMM_USB_DISPATCH2_PROTOCOL
+    - EFI_SMM_SX_DISPATCH2_PROTOCOL
+    - EFI_SMM_SW_DISPATCH2_PROTOCOL
+    - EFI_SMM_GPI_DISPATCH2_PROTOCOL
+    - EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
+    - EFI_SMM_POWER_BUTTON_DISPATCH2_PROTOCOL
+    - EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL
+    - @link _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL PCH_SMM_IO_TRAP_CONTROL_PROTOCOL @endlink
+    - @link _PCH_PCIE_SMI_DISPATCH_PROTOCOL PCH_PCIE_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_TCO_SMI_DISPATCH_PROTOCOL PCH_TCO_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_ACPI_SMI_DISPATCH_PROTOCOL PCH_ACPI_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_SMI_DISPATCH_PROTOCOL PCH_SMI_DISPATCH_PROTOCOL @endlink
+    - @link _PCH_ESPI_SMI_DISPATCH_PROTOCOL PCH_ESPI_SMI_DISPATCH_PROTOCOL @endlink
+
+  @param[in] ImageHandle          Pointer to the loaded image protocol for this driver
+  @param[in] SystemTable          Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS             PchSmmDispatcher Initialization completed.
+**/
+EFI_STATUS
+EFIAPI
+InitializePchSmmDispatcher (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS           Status;
+  VOID                 *SmmReadyToLockRegistration;
+
+  mS3SusStart = FALSE;
+  //
+  // Access ACPI Base Addresses Register
+  //
+
+  mAcpiBaseAddr = PmcGetAcpiBase ();
+  ASSERT (mAcpiBaseAddr != 0);
+
+  //
+  // Access TCO Base Addresses Register
+  //
+  PchTcoBaseGet (&mTcoBaseAddr);
+  ASSERT (mTcoBaseAddr != 0);
+
+  //
+  // Register a callback function to handle subsequent SMIs.  This callback
+  // will be called by SmmCoreDispatcher.
+  //
+  Status = gSmst->SmiHandlerRegister (PchSmmCoreDispatcher, NULL, &mPrivateData.SmiHandle);
+  ASSERT_EFI_ERROR (Status);
+  //
+  // Initialize Callback DataBase
+  //
+  InitializeListHead (&mPrivateData.CallbackDataBase);
+
+  //
+  // Enable SMIs on the PCH now that we have a callback
+  //
+  PchSmmInitHardware ();
+
+  //
+  // Install and initialize all the needed protocols
+  //
+  PchSwDispatchInit ();
+  PchSmmPublishDispatchProtocols ();
+  InstallPchSmiDispatchProtocols ();
+  InstallIoTrap (ImageHandle);
+  InstallEspiSmi (ImageHandle);
+  InstallPchSmmPeriodicTimerControlProtocol (mPrivateData.InstallMultProtHandle);
+
+  //
+  // Register EFI_SMM_READY_TO_LOCK_PROTOCOL_GUID notify function.
+  //
+  Status = gSmst->SmmRegisterProtocolNotify (
+                    &gEfiSmmReadyToLockProtocolGuid,
+                    SmmReadyToLockCallback,
+                    &SmmReadyToLockRegistration
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  The internal function used to create and insert a database record
+
+  @param[in]  InsertRecord              Record to insert to database.
+  @param[out] DispatchHandle            Handle of dispatch function to register.
+
+  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source description
+  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database record
+  @retval EFI_SUCCESS                   The database record is created successfully.
+**/
+EFI_STATUS
+SmmCoreInsertRecord (
+  IN  DATABASE_RECORD                   *NewRecord,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+  DATABASE_RECORD                       *Record;
+
+  if ((NewRecord == NULL) ||
+      (NewRecord->Signature != DATABASE_RECORD_SIGNATURE))
+  {
+    ASSERT (FALSE);
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = gSmst->SmmAllocatePool (EfiRuntimeServicesData, sizeof (DATABASE_RECORD), (VOID **) &Record);
+  if (EFI_ERROR (Status)) {
+    ASSERT (FALSE);
+    return EFI_OUT_OF_RESOURCES;
+  }
+  CopyMem (Record, NewRecord, sizeof (DATABASE_RECORD));
+
+  //
+  // After ensuring the source of event is not null, we will insert the record into the database
+  //
+  InsertTailList (&mPrivateData.CallbackDataBase, &Record->Link);
+
+  //
+  // Child's handle will be the address linked list link in the record
+  //
+  *DispatchHandle = (EFI_HANDLE) (&Record->Link);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                       Protocol instance pointer.
+  @param[in] DispatchHandle             Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS                   The dispatch function has been successfully
+                                        unregistered and the SMI source has been disabled
+                                        if there are no other registered child dispatch
+                                        functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER         Handle is invalid.
+  @retval EFI_ACCESS_DENIED             Return access denied if the SmmReadyToLock event has been triggered
+**/
+EFI_STATUS
+EFIAPI
+PchPiSmmCoreUnRegister (
+  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
+  IN EFI_HANDLE                                         *DispatchHandle
+  )
+{
+  DATABASE_RECORD                   *RecordToDelete;
+  EFI_STATUS                        Status;
+  PCH_SMM_QUALIFIED_PROTOCOL        *Qualified;
+
+  Qualified      = QUALIFIED_PROTOCOL_FROM_GENERIC (This);
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  Status         = PchSmmCoreUnRegister (NULL, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileUnregisterHandler (
+      Qualified->Guid,
+      RecordToDelete->Callback,
+      &RecordToDelete->ChildContext,
+      RecordToDelete->ContextSize
+      );
+  }
+  return Status;
+}
+
+/**
+  Register a child SMI dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL instance.
+  @param[in] DispatchFunction     Pointer to dispatch function to be invoked for this SMI source.
+  @param[in] DispatchContext      Pointer to the dispatch function's context.
+  @param[out] DispatchHandle      Handle of dispatch function, for when interfacing
+                                  with the parent SMM driver, will be the address of linked
+                                  list link in the call back record.
+
+  @retval EFI_OUT_OF_RESOURCES    Insufficient resources to create database record
+  @retval EFI_INVALID_PARAMETER   The input parameter is invalid
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  registered and the SMI source has been enabled.
+**/
+EFI_STATUS
+EFIAPI
+PchPiSmmCoreRegister (
+  IN  PCH_SMM_GENERIC_PROTOCOL                          *This,
+  IN  EFI_SMM_HANDLER_ENTRY_POINT2                      DispatchFunction,
+  IN  PCH_SMM_CONTEXT                                   *DispatchContext,
+  OUT EFI_HANDLE                                        *DispatchHandle
+  )
+{
+  EFI_STATUS                  Status;
+  DATABASE_RECORD             Record;
+  PCH_SMM_QUALIFIED_PROTOCOL  *Qualified;
+  PCH_SMM_SOURCE_DESC         NullSourceDesc;
+
+  //
+  // Initialize NullSourceDesc
+  //
+  NullInitSourceDesc (&NullSourceDesc);
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the EndOfDxe event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  ZeroMem (&Record, sizeof (DATABASE_RECORD));
+
+  //
+  // Gather information about the registration request
+  //
+  Record.Callback          = DispatchFunction;
+
+  Qualified                = QUALIFIED_PROTOCOL_FROM_GENERIC (This);
+
+  Record.ProtocolType      = Qualified->Type;
+
+  Record.ContextFunctions  = mContextFunctions[Qualified->Type];
+  //
+  // Perform linked list housekeeping
+  //
+  Record.Signature         = DATABASE_RECORD_SIGNATURE;
+
+  switch (Qualified->Type) {
+    //
+    // By the end of this switch statement, we'll know the
+    // source description the child is registering for
+    //
+    case UsbType:
+      Record.ContextSize = sizeof (EFI_SMM_USB_REGISTER_CONTEXT);
+      CopyMem (&Record.ChildContext, DispatchContext, Record.ContextSize);
+      //
+      // Check the validity of Context Type
+      //
+      if ((Record.ChildContext.Usb.Type < UsbLegacy) || (Record.ChildContext.Usb.Type > UsbWake)) {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      MapUsbToSrcDesc (DispatchContext, &Record.SrcDesc);
+      Record.ClearSource = NULL;
+      //
+      // use default clear source function
+      //
+      break;
+
+    case SxType:
+      Record.ContextSize = sizeof (EFI_SMM_SX_REGISTER_CONTEXT);
+      CopyMem (&Record.ChildContext, DispatchContext, Record.ContextSize);
+      //
+      // Check the validity of Context Type and Phase
+      //
+      if ((Record.ChildContext.Sx.Type < SxS0) ||
+          (Record.ChildContext.Sx.Type >= EfiMaximumSleepType) ||
+          (Record.ChildContext.Sx.Phase < SxEntry) ||
+          (Record.ChildContext.Sx.Phase >= EfiMaximumPhase)
+          ) {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      CopyMem (&Record.SrcDesc, &mSxSourceDesc, sizeof (PCH_SMM_SOURCE_DESC));
+      Record.ClearSource = NULL;
+      //
+      // use default clear source function
+      //
+      break;
+
+    case PowerButtonType:
+      Record.ContextSize = sizeof (EFI_SMM_POWER_BUTTON_REGISTER_CONTEXT);
+      CopyMem (&Record.ChildContext, DispatchContext, Record.ContextSize);
+      //
+      // Check the validity of Context Phase
+      //
+      if ((Record.ChildContext.PowerButton.Phase < EfiPowerButtonEntry) ||
+          (Record.ChildContext.PowerButton.Phase > EfiPowerButtonExit))
+      {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      CopyMem (&Record.SrcDesc, &mPowerButtonSourceDesc, sizeof (PCH_SMM_SOURCE_DESC));
+      Record.ClearSource = NULL;
+      //
+      // use default clear source function
+      //
+      break;
+
+    case PeriodicTimerType:
+      Record.ContextSize = sizeof (EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT);
+      CopyMem (&Record.ChildContext, DispatchContext, Record.ContextSize);
+      //
+      // Check the validity of timer value
+      //
+      if (DispatchContext->PeriodicTimer.SmiTickInterval <= 0) {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      MapPeriodicTimerToSrcDesc (DispatchContext, &Record.SrcDesc);
+      Record.MiscData.TimerSmiEnabled = TRUE;
+      Record.ClearSource = PchSmmPeriodicTimerClearSource;
+      break;
+
+    default:
+      return EFI_INVALID_PARAMETER;
+      break;
+  }
+
+  if (CompareSources (&Record.SrcDesc, &NullSourceDesc)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // After ensuring the source of event is not null, we will insert the record into the database
+  // Child's handle will be the address linked list link in the record
+  //
+  Status = SmmCoreInsertRecord (
+             &Record,
+             DispatchHandle
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  if (Record.ClearSource == NULL) {
+    //
+    // Clear the SMI associated w/ the source using the default function
+    //
+    PchSmmClearSource (&Record.SrcDesc);
+  } else {
+    //
+    // This source requires special handling to clear
+    //
+    Record.ClearSource (&Record.SrcDesc);
+  }
+
+  PchSmmEnableSource (&Record.SrcDesc);
+  SmiHandlerProfileRegisterHandler (
+    Qualified->Guid,
+    DispatchFunction,
+    (UINTN)RETURN_ADDRESS (0),
+    DispatchContext,
+    Record.ContextSize
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Unregister a child SMI source dispatch function with a parent SMM driver.
+
+  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchSmmCoreUnRegister (
+  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
+  IN EFI_HANDLE                                         *DispatchHandle
+  )
+{
+  EFI_STATUS                   Status;
+  BOOLEAN                      NeedClearEnable;
+  UINTN                        DescIndex;
+  DATABASE_RECORD              *RecordToDelete;
+  DATABASE_RECORD              *RecordInDb;
+  LIST_ENTRY                   *LinkInDb;
+
+  if (DispatchHandle == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+
+  //
+  // Take the entry out of the linked list
+  //
+  if (RecordToDelete->Link.ForwardLink == (LIST_ENTRY *) EFI_BAD_POINTER) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RemoveEntryList (&RecordToDelete->Link);
+
+  //
+  // Loop through all the souces in record linked list to see if any source enable is equal.
+  // If any source enable is equal, we do not want to disable it.
+  //
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; ++DescIndex) {
+    if (IS_BIT_DESC_NULL (RecordToDelete->SrcDesc.En[DescIndex])) {
+      continue;
+    }
+    NeedClearEnable = TRUE;
+    LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
+    while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+      RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
+      if (IsBitEqualToAnySourceEn (&RecordToDelete->SrcDesc.En[DescIndex], &RecordInDb->SrcDesc)) {
+        NeedClearEnable = FALSE;
+        break;
+      }
+      LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, &RecordInDb->Link);
+    }
+    if (NeedClearEnable == FALSE) {
+      continue;
+    }
+    WriteBitDesc (&RecordToDelete->SrcDesc.En[DescIndex], 0, FALSE);
+  }
+  Status = gSmst->SmmFreePool (RecordToDelete);
+  if (EFI_ERROR (Status)) {
+    ASSERT (FALSE);
+    return Status;
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  This function clears the pending SMI status before set EOS.
+  NOTE: This only clears the pending SMI with known reason.
+        Please do not clear unknown pending SMI status since that will hide potential issues.
+
+  @param[in] SmiStsValue                SMI status
+  @param[in] SciEn                      Sci Enable status
+**/
+STATIC
+VOID
+ClearPendingSmiStatus (
+  UINT32  SmiStsValue,
+  BOOLEAN SciEn
+  )
+{
+  //
+  // Clear NewCentury status if it's not handled.
+  //
+  if (SmiStsValue & B_ACPI_IO_SMI_STS_TCO) {
+    if (IoRead16 (mTcoBaseAddr + R_TCO_IO_TCO1_STS) & B_TCO_IO_TCO1_STS_NEWCENTURY) {
+      PchTcoSmiClearSourceAndBlock (&mSrcDescNewCentury);
+    }
+  }
+  // Clear PWRBTNOR_STS if it's not handled.
+  //
+  if (IoRead16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS) & B_ACPI_IO_PM1_STS_PRBTNOR) {
+    IoWrite16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS, B_ACPI_IO_PM1_STS_PRBTNOR);
+  }
+  //
+  // Clear WADT_STS if this is triggered by WADT timer.
+  //
+  if (!SciEn) {
+    if (IoRead32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96) & B_ACPI_IO_GPE0_STS_127_96_WADT) {
+      IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96, B_ACPI_IO_GPE0_STS_127_96_WADT);
+    }
+  }
+  //
+  // Clear GPIO_UNLOCK_SMI_STS in case it is set as GPIO Unlock SMI is not supported
+  //
+  if (SmiStsValue & B_ACPI_IO_SMI_STS_GPIO_UNLOCK) {
+    IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_SMI_STS, B_ACPI_IO_SMI_STS_GPIO_UNLOCK);
+  }
+}
+
+/**
+  The callback function to handle subsequent SMIs.  This callback will be called by SmmCoreDispatcher.
+
+  @param[in] SmmImageHandle             Not used
+  @param[in] PchSmmCore                 Not used
+  @param[in, out] CommunicationBuffer   Not used
+  @param[in, out] SourceSize            Not used
+
+  @retval EFI_SUCCESS                   Function successfully completed
+**/
+EFI_STATUS
+EFIAPI
+PchSmmCoreDispatcher (
+  IN       EFI_HANDLE         SmmImageHandle,
+  IN CONST VOID               *PchSmmCore,
+  IN OUT   VOID               *CommunicationBuffer,
+  IN OUT   UINTN              *SourceSize
+  )
+{
+  //
+  // Used to prevent infinite loops
+  //
+  UINTN               EscapeCount;
+
+  BOOLEAN             ContextsMatch;
+  BOOLEAN             EosSet;
+  BOOLEAN             SxChildWasDispatched;
+
+  DATABASE_RECORD     *RecordInDb;
+  LIST_ENTRY          *LinkInDb;
+  DATABASE_RECORD     *RecordToExhaust;
+  LIST_ENTRY          *LinkToExhaust;
+
+  PCH_SMM_CONTEXT     Context;
+  VOID                *CommBuffer;
+  UINTN               CommBufferSize;
+
+  EFI_STATUS          Status;
+  BOOLEAN             SciEn;
+  UINT32              SmiEnValue;
+  UINT32              SmiStsValue;
+  UINT8               Port74Save;
+  UINT8               Port76Save;
+
+  PCH_SMM_SOURCE_DESC ActiveSource;
+
+  //
+  // Initialize ActiveSource
+  //
+  NullInitSourceDesc (&ActiveSource);
+
+  EscapeCount           = 3;
+  ContextsMatch         = FALSE;
+  EosSet                = FALSE;
+  SxChildWasDispatched  = FALSE;
+  Status                = EFI_SUCCESS;
+
+  //
+  // Save IO index registers
+  // @note: Save/Restore port 70h directly might break NMI_EN# setting,
+  //       then save/restore 74h/76h instead.
+  // @note: CF8 is not saved. Prefer method is to use MMIO instead of CF8
+  //
+  Port76Save = IoRead8 (R_RTC_IO_EXT_INDEX_ALT);
+  Port74Save = IoRead8 (R_RTC_IO_INDEX_ALT);
+
+  if (!IsListEmpty (&mPrivateData.CallbackDataBase)) {
+    //
+    // We have children registered w/ us -- continue
+    //
+    while ((!EosSet) && (EscapeCount > 0)) {
+      EscapeCount--;
+
+      LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
+
+      //
+      // Cache SciEn, SmiEnValue and SmiStsValue to determine if source is active
+      //
+      SciEn       = PchSmmGetSciEn ();
+      SmiEnValue  = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
+      SmiStsValue = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_STS));
+
+      while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+        RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
+
+        //
+        // look for the first active source
+        //
+        if (!SourceIsActive (&RecordInDb->SrcDesc, SciEn, SmiEnValue, SmiStsValue)) {
+          //
+          // Didn't find the source yet, keep looking
+          //
+          LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, &RecordInDb->Link);
+
+          //
+          // if it's the last one, try to clear EOS
+          //
+          if (IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+            //
+            // Clear pending SMI status before EOS
+            //
+            ClearPendingSmiStatus (SmiStsValue, SciEn);
+            EosSet = PchSmmSetAndCheckEos ();
+          }
+        } else {
+          //
+          // We found a source. If this is a sleep type, we have to go to
+          // appropriate sleep state anyway.No matter there is sleep child or not
+          //
+          if (RecordInDb->ProtocolType == SxType) {
+            SxChildWasDispatched = TRUE;
+          }
+          //
+          // "cache" the source description and don't query I/O anymore
+          //
+          CopyMem ((VOID *) &ActiveSource, (VOID *) &(RecordInDb->SrcDesc), sizeof (PCH_SMM_SOURCE_DESC));
+          LinkToExhaust = LinkInDb;
+
+          //
+          // exhaust the rest of the queue looking for the same source
+          //
+          while (!IsNull (&mPrivateData.CallbackDataBase, LinkToExhaust)) {
+            RecordToExhaust = DATABASE_RECORD_FROM_LINK (LinkToExhaust);
+            //
+            // RecordToExhaust->Link might be removed (unregistered) by Callback function, and then the
+            // system will hang in ASSERT() while calling GetNextNode().
+            // To prevent the issue, we need to get next record in DB here (before Callback function).
+            //
+            LinkToExhaust = GetNextNode (&mPrivateData.CallbackDataBase, &RecordToExhaust->Link);
+
+            if (CompareSources (&RecordToExhaust->SrcDesc, &ActiveSource)) {
+              //
+              // These source descriptions are equal, so this callback should be
+              // dispatched.
+              //
+              if (RecordToExhaust->ContextFunctions.GetContext != NULL) {
+                //
+                // This child requires that we get a calling context from
+                // hardware and compare that context to the one supplied
+                // by the child.
+                //
+                ASSERT (RecordToExhaust->ContextFunctions.CmpContext != NULL);
+
+                //
+                // Make sure contexts match before dispatching event to child
+                //
+                RecordToExhaust->ContextFunctions.GetContext (RecordToExhaust, &Context);
+                ContextsMatch = RecordToExhaust->ContextFunctions.CmpContext (&Context, &RecordToExhaust->ChildContext);
+
+              } else {
+                //
+                // This child doesn't require any more calling context beyond what
+                // it supplied in registration.  Simply pass back what it gave us.
+                //
+                Context       = RecordToExhaust->ChildContext;
+                ContextsMatch = TRUE;
+              }
+
+              if (ContextsMatch) {
+                if (RecordToExhaust->ProtocolType == PchSmiDispatchType) {
+                  //
+                  // For PCH SMI dispatch protocols
+                  //
+                  PchSmiTypeCallbackDispatcher (RecordToExhaust);
+                } else {
+                  if ((RecordToExhaust->ProtocolType == SxType) && (Context.Sx.Type == SxS3) && (Context.Sx.Phase == SxEntry) && !mS3SusStart) {
+                    REPORT_STATUS_CODE (EFI_PROGRESS_CODE, PROGRESS_CODE_S3_SUSPEND_START);
+                    mS3SusStart = TRUE;
+                  }
+                  //
+                  // For EFI standard SMI dispatch protocols
+                  //
+                  if (RecordToExhaust->Callback != NULL) {
+                    if (RecordToExhaust->ContextFunctions.GetCommBuffer != NULL) {
+                      //
+                      // This callback function needs CommBuffer and CommBufferSize.
+                      // Get those from child and then pass to callback function.
+                      //
+                      RecordToExhaust->ContextFunctions.GetCommBuffer (RecordToExhaust, &CommBuffer, &CommBufferSize);
+                    } else {
+                      //
+                      // Child doesn't support the CommBuffer and CommBufferSize.
+                      // Just pass NULL value to callback function.
+                      //
+                      CommBuffer     = NULL;
+                      CommBufferSize = 0;
+                    }
+
+                    PERF_START_EX (NULL, "SmmFunction", NULL, AsmReadTsc (), RecordToExhaust->ProtocolType);
+                    RecordToExhaust->Callback ((EFI_HANDLE) & RecordToExhaust->Link, &Context, CommBuffer, &CommBufferSize);
+                    PERF_END_EX (NULL, "SmmFunction", NULL, AsmReadTsc (), RecordToExhaust->ProtocolType);
+                    if (RecordToExhaust->ProtocolType == SxType) {
+                      SxChildWasDispatched = TRUE;
+                    }
+                  } else {
+                    ASSERT (FALSE);
+                  }
+                }
+              }
+            }
+          }
+
+          if (RecordInDb->ClearSource == NULL) {
+            //
+            // Clear the SMI associated w/ the source using the default function
+            //
+            PchSmmClearSource (&ActiveSource);
+          } else {
+            //
+            // This source requires special handling to clear
+            //
+            RecordInDb->ClearSource (&ActiveSource);
+          }
+          //
+          // Clear pending SMI status before EOS
+          //
+          ClearPendingSmiStatus (SmiStsValue, SciEn);
+          //
+          // Also, try to clear EOS
+          //
+          EosSet = PchSmmSetAndCheckEos ();
+          //
+          // Queue is empty, reset the search
+          //
+          break;
+        }
+      }
+    }
+  }
+  //
+  // If you arrive here, there are two possible reasons:
+  // (1) you've got problems with clearing the SMI status bits in the
+  // ACPI table.  If you don't properly clear the SMI bits, then you won't be able to set the
+  // EOS bit.  If this happens too many times, the loop exits.
+  // (2) there was a SMM communicate for callback messages that was received prior
+  // to this driver.
+  // If there is an asynchronous SMI that occurs while processing the Callback, let
+  // all of the drivers (including this one) have an opportunity to scan for the SMI
+  // and handle it.
+  // If not, we don't want to exit and have the foreground app. clear EOS without letting
+  // these other sources get serviced.
+  //
+  // This assert is not valid with CSM legacy solution because it generates software SMI
+  // to test for legacy USB support presence.
+  // This may not be illegal, so we cannot assert at this time.
+  //
+  //  ASSERT (EscapeCount > 0);
+  //
+  if (SxChildWasDispatched) {
+    //
+    // A child of the SmmSxDispatch protocol was dispatched during this call;
+    // put the system to sleep.
+    //
+    PchSmmSxGoToSleep ();
+  }
+  //
+  // Restore IO index registers
+  // @note: Save/Restore port 70h directly might break NMI_EN# setting,
+  //       then save/restore 74h/76h instead.
+  //
+  IoWrite8 (R_RTC_IO_EXT_INDEX_ALT, Port76Save);
+  IoWrite8 (R_RTC_IO_INDEX_ALT, Port74Save);
+
+  return Status;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.c
new file mode 100644
index 0000000000..9ce4072e37
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.c
@@ -0,0 +1,1588 @@
+/** @file
+  eSPI SMI implementation
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#include "PchSmmEspi.h"
+#include <Library/PmcPrivateLib.h>
+#include <Library/EspiLib.h>
+#include <Library/SmiHandlerProfileLib.h>
+#include <Register/PchRegs.h>
+#include <Register/PchPcrRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Library/PchPciBdfLib.h>
+#include <PchBdfAssignment.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED ESPI_SMI_INSTANCE mEspiSmiInstance = {
+  //
+  // Signature
+  //
+  ESPI_SMI_INSTANCE_SIGNATURE,
+  //
+  // Handle
+  //
+  NULL,
+  //
+  // PchEspiSmiDispatchProtocol
+  //
+  {
+    PCH_ESPI_SMI_DISPATCH_REVISION,
+    EspiSmiUnRegister,
+    BiosWrProtectRegister,
+    BiosWrReportRegister,
+    PcNonFatalErrRegister,
+    PcFatalErrRegister,
+    VwNonFatalErrRegister,
+    VwFatalErrRegister,
+    FlashNonFatalErrRegister,
+    FlashFatalErrRegister,
+    LnkType1ErrRegister,
+    EspiSlaveSmiRegister
+  },
+  //
+  // PchSmiEspiHandle[EspiTopLevelTypeMax]
+  //
+  {
+    NULL, NULL, NULL
+  },
+  //
+  // CallbackDataBase[EspiSmiTypeMax]
+  //
+  {
+    {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL},
+    {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}
+  },
+  //
+  // EspiSmiEventCounter[EspiSmiTypeMax]
+  //
+  {
+    0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+  },
+  //
+  // Barrier[EspiTopLevelTypeMax]
+  //
+  {
+    {
+      BiosWrProtect,
+      BiosWrProtect
+    },
+    {
+      BiosWrReport,
+      LnkType1Err
+    },
+    {
+      EspiSlaveSmi,
+      EspiSlaveSmi
+    }
+  }
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST ESPI_DESCRIPTOR mEspiDescriptor[EspiSmiTypeMax] = {
+  //
+  // BiosWrProtect
+  //
+  {
+    {
+      PCIE_ADDR_TYPE,
+      { (
+        (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+        (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
+        (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
+        R_ESPI_CFG_PCBC
+      ) }
+    },
+    //
+    // SourceIsActiveAndMask and SourceIsActiveValue
+    //
+    B_ESPI_CFG_PCBC_BWPDS | B_ESPI_CFG_PCBC_LE,
+    B_ESPI_CFG_PCBC_BWPDS | B_ESPI_CFG_PCBC_LE,
+    //
+    // ClearStatusAndMask and ClearStatusOrMask
+    //
+    (UINT32) ~B_ESPI_CFG_PCBC_BWRS,
+    B_ESPI_CFG_PCBC_BWPDS
+  },
+  //
+  // BiosWrReport
+  //
+  {
+    {
+      PCIE_ADDR_TYPE,
+      { (
+        (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+        (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
+        (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
+        R_ESPI_CFG_PCBC
+      ) }
+    },
+    B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWRE,
+    B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWRE,
+    (UINT32) ~B_ESPI_CFG_PCBC_BWPDS,
+    B_ESPI_CFG_PCBC_BWRS
+  },
+  //
+  // PcNonFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_PCERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
+    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI << N_ESPI_PCR_XERR_XNFEE)),
+    (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XFES),
+    B_ESPI_PCR_XERR_XNFES
+  },
+  //
+  // PcFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_PCERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI << N_ESPI_PCR_XERR_XFEE)),
+    (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XNFES),
+    B_ESPI_PCR_XERR_XFES
+  },
+  //
+  // VwNonFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_VWERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
+    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI << N_ESPI_PCR_XERR_XNFEE)),
+    (UINT32) ~B_ESPI_PCR_XERR_XFES,
+    B_ESPI_PCR_XERR_XNFES
+  },
+  //
+  // VwFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_VWERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI << N_ESPI_PCR_XERR_XFEE)),
+    (UINT32) ~B_ESPI_PCR_XERR_XNFES,
+    B_ESPI_PCR_XERR_XFES
+  },
+  //
+  // FlashNonFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_FCERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
+    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI << N_ESPI_PCR_XERR_XNFEE)),
+    (UINT32) ~B_ESPI_PCR_XERR_XFES,
+    B_ESPI_PCR_XERR_XNFES
+  },
+  //
+  // FlashFatalErr
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_FCERR_SLV0) }
+    },
+    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI << N_ESPI_PCR_XERR_XFEE)),
+    (UINT32) ~B_ESPI_PCR_XERR_XNFES,
+    B_ESPI_PCR_XERR_XFES
+  },
+  //
+  // LnkType1Err
+  //
+  {
+    {
+      PCR_ADDR_TYPE,
+      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_LNKERR_SLV0) }
+    },
+    B_ESPI_PCR_LNKERR_SLV0_LFET1S | B_ESPI_PCR_LNKERR_SLV0_LFET1E,
+    B_ESPI_PCR_LNKERR_SLV0_LFET1S | (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI << N_ESPI_PCR_LNKERR_SLV0_LFET1E),
+    (UINT32) ~B_ESPI_PCR_LNKERR_SLV0_SLCRR,
+    B_ESPI_PCR_LNKERR_SLV0_LFET1S
+  },
+};
+
+/**
+  Enable eSPI SMI source
+
+  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
+**/
+STATIC
+VOID
+EspiSmiEnableSource (
+  IN CONST  ESPI_SMI_TYPE EspiSmiType
+  )
+{
+  UINT64      PciBaseAddress;
+
+  switch (EspiSmiType) {
+    case BiosWrProtect:
+      //
+      // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
+      //
+      break;
+    case BiosWrReport:
+      PciBaseAddress = EspiPciCfgBase ();
+      PciSegmentAndThenOr32 (
+        PciBaseAddress + R_ESPI_CFG_PCBC,
+        (UINT32) ~(B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWPDS),
+        B_ESPI_CFG_PCBC_BWRE
+        );
+      break;
+    case PcNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_PCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XNFEE
+        );
+      break;
+
+    case PcFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_PCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XFEE
+        );
+      break;
+
+    case VwNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_VWERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XNFEE
+        );
+      break;
+
+    case VwFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_VWERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XFEE
+        );
+      break;
+
+    case FlashNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_FCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XNFEE
+        );
+      break;
+
+    case FlashFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_FCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
+        B_ESPI_PCR_XERR_XFEE
+        );
+      break;
+
+    case LnkType1Err:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_LNKERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR | B_ESPI_PCR_LNKERR_SLV0_LFET1S),
+        (UINT32) (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI << N_ESPI_PCR_LNKERR_SLV0_LFET1E)
+        );
+
+      if (IsEspiSecondSlaveSupported ()) {
+        PchPcrAndThenOr32 (
+          PID_ESPISPI,
+          (UINT16) R_ESPI_PCR_LNKERR_SLV1,
+          (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR | B_ESPI_PCR_LNKERR_SLV0_LFET1S),
+          (UINT32) (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI << N_ESPI_PCR_LNKERR_SLV0_LFET1E)
+          );
+      }
+      break;
+
+    default:
+      DEBUG ((DEBUG_ERROR, "Unsupported EspiSmiType \n"));
+      ASSERT (FALSE);
+      break;
+  }
+}
+
+
+/**
+  Disable eSPI SMI source
+
+  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
+**/
+STATIC
+VOID
+EspiSmiDisableSource (
+  IN CONST  ESPI_SMI_TYPE EspiSmiType
+  )
+{
+
+  switch (EspiSmiType) {
+    case BiosWrProtect:
+    case BiosWrReport:
+      DEBUG ((DEBUG_ERROR, "Bit is write lock, thus BWRE/BWPDS source cannot be disabled \n"));
+      ASSERT (FALSE);
+      break;
+    case PcNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_PCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XNFEE),
+        0
+        );
+      break;
+
+    case PcFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_PCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD | B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+        0
+        );
+      break;
+
+    case VwNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_VWERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XNFEE),
+        0
+        );
+      break;
+
+    case VwFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_VWERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+        0
+        );
+      break;
+
+    case FlashNonFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_FCERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XNFEE),
+        0
+        );
+      break;
+
+    case FlashFatalErr:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+       (UINT16) R_ESPI_PCR_FCERR_SLV0,
+       (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
+       0
+       );
+      break;
+
+    case LnkType1Err:
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) R_ESPI_PCR_LNKERR_SLV0,
+        (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR | B_ESPI_PCR_LNKERR_SLV0_LFET1S),
+        0
+        );
+
+      if (IsEspiSecondSlaveSupported ()) {
+        PchPcrAndThenOr32 (
+          PID_ESPISPI,
+          (UINT16) R_ESPI_PCR_LNKERR_SLV1,
+          (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR | B_ESPI_PCR_LNKERR_SLV0_LFET1S),
+          0
+          );
+      }
+      break;
+
+    default:
+      DEBUG ((DEBUG_ERROR, "Unsupported EspiSmiType \n"));
+      ASSERT (FALSE);
+      break;
+  }
+}
+
+/**
+  Clear a status for the SMI event
+
+  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
+**/
+STATIC
+VOID
+EspiSmiClearStatus (
+  IN CONST  ESPI_SMI_TYPE EspiSmiType
+  )
+{
+  UINT32                  PciBus;
+  UINT32                  PciDev;
+  UINT32                  PciFun;
+  UINT32                  PciReg;
+  UINT64                  PciBaseAddress;
+  CONST ESPI_DESCRIPTOR   *Desc;
+
+  Desc = &mEspiDescriptor[EspiSmiType];
+
+  switch (Desc->Address.Type) {
+    case PCIE_ADDR_TYPE:
+      PciBus  = Desc->Address.Data.pcie.Fields.Bus;
+      PciDev  = Desc->Address.Data.pcie.Fields.Dev;
+      PciFun  = Desc->Address.Data.pcie.Fields.Fnc;
+      PciReg  = Desc->Address.Data.pcie.Fields.Reg;
+      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
+      PciSegmentAndThenOr32 (PciBaseAddress + PciReg, Desc->ClearStatusAndMask, Desc->ClearStatusOrMask);
+      break;
+    case PCR_ADDR_TYPE:
+      PchPcrAndThenOr32 (
+        Desc->Address.Data.Pcr.Fields.Pid,
+        Desc->Address.Data.Pcr.Fields.Offset,
+        Desc->ClearStatusAndMask,
+        Desc->ClearStatusOrMask
+        );
+      break;
+    default:
+      DEBUG ((DEBUG_ERROR, "Address type for eSPI SMI is invalid \n"));
+      ASSERT (FALSE);
+      break;
+  }
+}
+
+/**
+  Checks if a source is active by looking at the enable and status bits
+
+  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
+**/
+STATIC
+BOOLEAN
+EspiSmiSourceIsActive (
+  IN CONST  ESPI_SMI_TYPE EspiSmiType
+  )
+{
+  BOOLEAN                 Active;
+  UINT32                  PciBus;
+  UINT32                  PciDev;
+  UINT32                  PciFun;
+  UINT32                  PciReg;
+  UINT64                  PciBaseAddress;
+  UINT32                  Data32;
+  CONST ESPI_DESCRIPTOR   *Desc;
+
+  Desc = &mEspiDescriptor[EspiSmiType];
+
+  Active = FALSE;
+  switch (Desc->Address.Type) {
+    case PCIE_ADDR_TYPE:
+      PciBus  = Desc->Address.Data.pcie.Fields.Bus;
+      PciDev  = Desc->Address.Data.pcie.Fields.Dev;
+      PciFun  = Desc->Address.Data.pcie.Fields.Fnc;
+      PciReg  = Desc->Address.Data.pcie.Fields.Reg;
+      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
+      Data32 = PciSegmentRead32 (PciBaseAddress + PciReg);
+      break;
+
+    case PCR_ADDR_TYPE:
+      Data32 = PchPcrRead32 (
+                 Desc->Address.Data.Pcr.Fields.Pid,
+                 Desc->Address.Data.Pcr.Fields.Offset
+                 );
+      break;
+
+    default:
+      Data32 = 0;
+      DEBUG ((DEBUG_ERROR, "Address type for eSPI SMI is invalid \n"));
+      ASSERT (FALSE);
+      break;
+  }
+
+  if ((Data32 & Desc->SourceIsActiveAndMask) == Desc->SourceIsActiveValue) {
+    Active = TRUE;
+  }
+
+  return Active;
+}
+
+/**
+  Insert a handler into the corresponding linked list based on EspiSmiType
+
+  @param[in]  DispatchFunction      The callback to execute
+  @param[in]  EspiSmiType           Type based on ESPI_SMI_TYPE to determine which linked list to use
+  @param[out] DispatchHandle        The link to the record in the database
+
+  @retval     EFI_SUCCESS           Record was successfully inserted into master database
+  @retval     EFI_OUT_OF_RESOURCES  Cannot allocate pool to insert record
+**/
+STATIC
+EFI_STATUS
+InsertEspiRecord (
+  IN        PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  IN        ESPI_SMI_TYPE                   EspiSmiType,
+  OUT       EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS      Status;
+  ESPI_SMI_RECORD *Record;
+
+  Status = gSmst->SmmAllocatePool (EfiRuntimeServicesData, sizeof (ESPI_SMI_RECORD), (VOID **) &Record);
+  if (EFI_ERROR (Status)) {
+    ASSERT (FALSE);
+    return EFI_OUT_OF_RESOURCES;
+  }
+  SetMem (Record, sizeof (ESPI_SMI_RECORD), 0);
+
+  Record->Callback  = DispatchFunction;
+  Record->Signature = ESPI_SMI_RECORD_SIGNATURE;
+
+  InsertTailList (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], &Record->Link);
+  EspiSmiClearStatus (EspiSmiType);
+  EspiSmiEnableSource (EspiSmiType);
+
+  ++mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType];
+
+  *DispatchHandle = (EFI_HANDLE) (&Record->Link);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This callback is registered to PchSmiDispatch
+
+  @param[in]  DispatchHandle  Used to determine which source have been triggered
+**/
+VOID
+EspiSmiCallback (
+  IN  EFI_HANDLE                      DispatchHandle
+  )
+{
+  DATABASE_RECORD     *PchSmiRecord;
+  ESPI_TOP_LEVEL_TYPE EspiTopLevelType;
+  ESPI_SMI_TYPE       EspiSmiType;
+  ESPI_SMI_RECORD     *RecordInDb;
+  LIST_ENTRY          *LinkInDb;
+
+  PchSmiRecord = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+
+  if (PchSmiRecord->PchSmiType == PchTcoSmiLpcBiosWpType) {
+    EspiTopLevelType = EspiBiosWrProtect;
+  } else if (PchSmiRecord->PchSmiType == PchSmiSerialIrqType) {
+    EspiTopLevelType = EspiSerialIrq;
+  } else {
+    DEBUG ((DEBUG_ERROR, "EspiSmiCallback was dispatched with a wrong DispatchHandle"));
+    ASSERT (FALSE);
+    return;
+  }
+
+  for (EspiSmiType = mEspiSmiInstance.Barrier[EspiTopLevelType].Start; EspiSmiType <= mEspiSmiInstance.Barrier[EspiTopLevelType].End; ++EspiSmiType) {
+    if (!EspiSmiSourceIsActive (EspiSmiType)) {
+      continue;
+    }
+    //
+    // The source is active, so walk the callback database and dispatch
+    //
+    if (!IsListEmpty (&mEspiSmiInstance.CallbackDataBase[EspiSmiType])) {
+      //
+      // We have children registered w/ us -- continue
+      //
+      LinkInDb = GetFirstNode (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
+
+      while (!IsNull (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], LinkInDb)) {
+        RecordInDb = ESPI_RECORD_FROM_LINK (LinkInDb);
+
+        //
+        // RecordInDb->Link might be removed (unregistered) by Callback function, and then the
+        // system will hang in ASSERT() while calling GetNextNode().
+        // To prevent the issue, we need to get next record in DB here (before Callback function).
+        //
+        LinkInDb = GetNextNode (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], &RecordInDb->Link);
+
+        //
+        // Callback
+        //
+        if (RecordInDb->Callback != NULL) {
+          RecordInDb->Callback ((EFI_HANDLE) &RecordInDb->Link);
+        } else {
+          ASSERT (FALSE);
+        }
+      }
+    } else if (EspiSmiType == LnkType1Err) {
+      //
+      // If no proper handler registered for Link Type 1 Error
+      // Call default SMI handler recover otherwise
+      //
+      EspiDefaultFatalErrorHandler ();
+    }
+
+    //
+    // Finish walking the linked list for the EspiSmiType, so clear status
+    //
+    EspiSmiClearStatus (EspiSmiType);
+  }
+}
+
+//
+// EspiBiosWp srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescEspiBiosWp = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_TCO
+    },
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
+          R_ESPI_CFG_PCBC
+        ) }
+      },
+      S_ESPI_CFG_PCBC,
+      N_ESPI_CFG_PCBC_LE
+    }
+  },
+  {
+    {
+      {
+        PCIE_ADDR_TYPE,
+        { (
+          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
+          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
+          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
+          R_ESPI_CFG_PCBC
+        ) }
+      },
+      S_ESPI_CFG_PCBC,
+      N_ESPI_CFG_PCBC_BWPDS
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_TCO
+  }
+};
+
+/**
+  This function will register EspiSmiCallback with mSrcDescEspiBiosWp source decriptor
+  This function make sure there is only one BIOS WP SMI handler is registered.
+  While any ESPI sub BIOS WP SMI type is registered, all the BIOS WP SMI
+  will go to callback function EspiSmiCallback first, and then dispatchs the callbacks
+  recorded in mEspiSmiInstance.
+
+  @retval EFI_SUCCESS Registration succeed
+  @retval others      Registration failed
+**/
+STATIC
+EFI_STATUS
+RegisterBiosWrProtectIfNull (
+  VOID
+  )
+{
+  EFI_STATUS      Status;
+  DATABASE_RECORD *Record;
+
+  if (mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect] == NULL) {
+    Status = PchSmiRecordInsert (
+               &mSrcDescEspiBiosWp,
+               (PCH_SMI_CALLBACK_FUNCTIONS) EspiSmiCallback,
+               PchTcoSmiLpcBiosWpType,
+               &mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect]
+               );
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "Fail to register BIOS WP SMI handler \n"));
+      return Status;
+    }
+    Record = DATABASE_RECORD_FROM_LINK (mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect]);
+    Record->ClearSource = PchTcoSmiClearSource;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This function will register EspiSmiCallback with mSrcDescSerialIrq source decriptor
+  This function make sure there is only one Serial IRQ SMI handler is registered.
+  While any ESPI sub Serial IRQ SMI type is registered, all the Serial IRQ SMI
+  will go to callback function EspiSmiCallback first, and then dispatchs the callbacks
+  recorded in mEspiSmiInstance.
+
+  @retval EFI_SUCCESS Registration succeed
+  @retval others      Registration failed
+**/
+STATIC
+EFI_STATUS
+RegisterSerialIrqIfNull (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+
+  if (mEspiSmiInstance.PchSmiEspiHandle[EspiSerialIrq] == NULL) {
+    Status = PchSmiRecordInsert (
+               &mSrcDescSerialIrq,
+               (PCH_SMI_CALLBACK_FUNCTIONS) EspiSmiCallback,
+               PchSmiSerialIrqType,
+               &mEspiSmiInstance.PchSmiEspiHandle[EspiSerialIrq]
+               );
+    if (EFI_ERROR (Status)) {
+      DEBUG ((DEBUG_ERROR, "Fail to register Serial IRQ SMI handler \n"));
+      return Status;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Installs and initialize this protocol
+
+  @param[in]  ImageHandle   Not used
+
+  @retval     EFI_SUCCESS   Installation succeed
+  @retval     others        Installation failed
+**/
+EFI_STATUS
+EFIAPI
+InstallEspiSmi (
+  IN EFI_HANDLE           ImageHandle
+  )
+{
+  EFI_STATUS    Status;
+  ESPI_SMI_TYPE EspiSmiType;
+
+  DEBUG ((DEBUG_INFO, "[InstallEspiSmi] Enter\n"));
+
+  //
+  // InitializeListHead for mEspiSmiInstance.CallBackDataBase[EspiTopLevelTypeMax]
+  //
+  for (EspiSmiType = 0; EspiSmiType < EspiSmiTypeMax; ++EspiSmiType) {
+    InitializeListHead (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
+  }
+
+  //
+  // Install EfiEspiSmiDispatchProtocol
+  //
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &mEspiSmiInstance.Handle,
+                    &gPchEspiSmiDispatchProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mEspiSmiInstance.PchEspiSmiDispatchProtocol
+                    );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to install eSPI SMI Dispatch Protocol\n"));
+    ASSERT (FALSE);
+    return Status;
+  }
+
+  // Register eSPI SMM callback to enable Fatal Error handling by default handler
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  // Enable LnkType1Err SMI generation for default handler
+  EspiSmiClearStatus (LnkType1Err);
+  EspiSmiEnableSource (LnkType1Err);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a BIOS Write Protect event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+BiosWrProtectRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterBiosWrProtectIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, BiosWrProtect, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a BIOS Write Report event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+BiosWrReportRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, BiosWrReport, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+PcNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, PcNonFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+PcFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, PcFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+VwNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, VwNonFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+VwFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, VwFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Flash Channel Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+FlashNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, FlashNonFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Flash Channel Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+FlashFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, FlashFatalErr, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Link Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+LnkType1ErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = RegisterSerialIrqIfNull ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  //
+  // Insert a record
+  //
+  Status = InsertEspiRecord (DispatchFunction, LnkType1Err, DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+  return Status;
+}
+
+//
+// EspiSlave srcdesc
+//
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSrcDescEspiSlave = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_ESPI
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_ESPI
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_ESPI
+  }
+};
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a eSPI slave SMI
+  This routine will also lock down ESPI_SMI_LOCK bit after registration and prevent
+  this handler from unregistration.
+  On platform that supports more than 1 device through another chip select (SPT-H),
+  the SMI handler itself needs to inspect both the eSPI devices' interrupt status registers
+  (implementation specific for each Slave) in order to identify and service the cause.
+  After servicing it, it has to clear the Slaves' internal SMI# status registers
+
+  @param[in]  This                      Not used
+  @param[in]  DispatchFunction          The callback to execute
+  @param[out] DispatchHandle            The handle for this callback registration
+
+  @retval     EFI_SUCCESS               Registration succeed
+  @retval     EFI_ACCESS_DENIED         Return access denied if the SmmReadyToLock event has been triggered
+  @retval     EFI_ACCESS_DENIED         The ESPI_SMI_LOCK is set and register is blocked.
+  @retval     others                    Registration failed
+**/
+EFI_STATUS
+EFIAPI
+EspiSlaveSmiRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // If ESPI_SMI_LOCK is set, the register is blocked.
+  //
+  if (PmcIsEspiSmiLockSet ()) {
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // @note: This service doesn't utilize the data base of mEspiSmiInstance.
+  //        While SMI is triggered it directly goes to the registing DispatchFunction
+  //        instead of EspiSmiCallback.
+  //
+  Status = PchSmiRecordInsert (
+             &mSrcDescEspiSlave,
+             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
+             PchEspiSmiEspiSlaveType,
+             DispatchHandle
+             );
+  PchSmmClearSource (&mSrcDescEspiSlave);
+  PchSmmEnableSource (&mSrcDescEspiSlave);
+
+  //
+  // Lock down the ESPI_SMI_LOCK after ESPI SMI is enabled.
+  //
+  PmcLockEspiSmiWithS3BootScript ();
+  //
+  // Keep the DispatchHandle which will be used for unregister function.
+  //
+  mEspiSmiInstance.PchSmiEspiHandle[EspiPmc] = *DispatchHandle;
+
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid, (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction, (UINTN)RETURN_ADDRESS (0), NULL, 0);
+  }
+
+  return Status;
+}
+
+/**
+  eSPI SMI Dispatch Protocol instance to unregister a callback based on handle
+
+  @param[in]  This                    Not used
+  @param[in]  DispatchHandle          Handle acquired during registration
+
+  @retval     EFI_SUCCESS             Unregister successful
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has bad pointer
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in database
+  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
+  @retval     EFI_ACCESS_DENIED       DispatchHandle is not allowed to unregistered
+**/
+EFI_STATUS
+EFIAPI
+EspiSmiUnRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  EFI_HANDLE                      DispatchHandle
+  )
+{
+  EFI_STATUS          Status;
+  ESPI_TOP_LEVEL_TYPE EspiTopLevelType;
+  ESPI_SMI_TYPE       EspiSmiType;
+  BOOLEAN             SafeToDisable;
+  LIST_ENTRY          *LinkInDb;
+  ESPI_SMI_RECORD     *RecordPointer;
+  DATABASE_RECORD    *RecordToDelete;
+
+  if (DispatchHandle == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  if (((LIST_ENTRY *) DispatchHandle)->ForwardLink == (LIST_ENTRY *) EFI_BAD_POINTER) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // For DispatchHandle belongs to Espi Slave SMI, refuses the request of unregistration.
+  //
+  if (mEspiSmiInstance.PchSmiEspiHandle[EspiPmc] == DispatchHandle) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed for ESPI Slave SMI handle! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // Iterate through all the database to find the record
+  //
+  for (EspiSmiType = 0; EspiSmiType < EspiSmiTypeMax; ++EspiSmiType) {
+    LinkInDb = GetFirstNode (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
+
+    while (!IsNull (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], LinkInDb)) {
+      if (LinkInDb != (LIST_ENTRY *) DispatchHandle) {
+        LinkInDb = GetNextNode (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], LinkInDb);
+
+      } else {
+        //
+        // Found the source to be from this list
+        //
+        RemoveEntryList (LinkInDb);
+        RecordPointer = (ESPI_RECORD_FROM_LINK (LinkInDb));
+
+        if (mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] != 0) {
+          if (--mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] == 0) {
+            EspiSmiDisableSource (EspiSmiType);
+          }
+        }
+
+        Status = gSmst->SmmFreePool (RecordPointer);
+        if (EFI_ERROR (Status)) {
+          ASSERT (FALSE);
+        }
+
+        goto EspiSmiUnRegisterEnd;
+      }
+    }
+  }
+  //
+  // If the code reach here, the handle passed in cannot be found
+  //
+  DEBUG ((DEBUG_ERROR, "eSPI SMI handle is not in record database \n"));
+  ASSERT (FALSE);
+  return EFI_INVALID_PARAMETER;
+
+EspiSmiUnRegisterEnd:
+
+  //
+  // Unregister and clear the handle from PchSmiDispatch
+  //
+  for (EspiTopLevelType = 0; EspiTopLevelType < EspiTopLevelTypeMax; ++EspiTopLevelType) {
+    SafeToDisable = TRUE;
+    //
+    // Checks all the child events that belongs to a top level status in PMC
+    //
+    for (EspiSmiType = mEspiSmiInstance.Barrier[EspiTopLevelType].Start; EspiSmiType <= mEspiSmiInstance.Barrier[EspiTopLevelType].End; ++EspiSmiType) {
+      if (mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] != 0) {
+        SafeToDisable = FALSE;
+      }
+    }
+    //
+    // Finally, disable the top level event in PMC
+    //
+    if (SafeToDisable) {
+      if (mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType] != NULL) {
+        Status = PchSmmCoreUnRegister (NULL, mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType]);
+        ASSERT_EFI_ERROR (Status);
+        mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType] = NULL;
+      }
+    }
+  }
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  if (!EFI_ERROR (Status)) {
+    SmiHandlerProfileUnregisterHandler (&gPchEspiSmiDispatchProtocolGuid, RecordToDelete->Callback, NULL, 0);
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Returns AND maks for clearing eSPI channel registers errors statuses
+  In addition to common status bit we add channel specific erro bits to avoid clearing them
+
+  @param[in]  ChannelNumber           Channel number (0 for PC, 1 for VW, 2 for OOB, 3 for FA)
+
+  @retval     UINT32                  AND mask with all the status bit masked to not clear them by mistake
+**/
+UINT32
+GetEspiChannelStatusClearMask (
+  UINT8       ChannelNumber
+  )
+{
+  UINT32    Data32;
+
+  // Common error status bits for all channel registers
+  Data32 = B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES;
+
+  // Check channels for channel specific status bits
+  switch(ChannelNumber) {
+    case 0:   // Peripheral Channel specific status bits
+      Data32 |= B_ESPI_PCR_PCERR_PCURD;
+      break;
+    case 3:   // Flash Access Channel specific status bits
+      Data32 |= B_ESPI_PCR_FCERR_SAFBLK;
+      break;
+  }
+
+  // Return the expected AND mask
+  return (UINT32)~(Data32);
+}
+
+/**
+  Checks if channel error register data has Fatal Error bit set
+  If yes then reset the channel on slave
+
+  @param[in]  ChannelBaseAddress      Base address
+  @param[in]  ChannelNumber           Channel number (0 for PC, 1 for VW, 2 for OOB, 3 for FA)
+  @param[in]  SlaveId                 Slave ID of which channel is to be reset
+**/
+VOID
+CheckSlaveChannelErrorAndReset (
+  UINT16      ChannelBaseAddress,
+  UINT8       ChannelNumber,
+  UINT8       SlaveId
+  )
+{
+  UINT32      Data32;
+  UINT16      ChannelAddress;
+  EFI_STATUS  Status;
+
+  if (ChannelNumber == 2) {
+    DEBUG ((DEBUG_INFO, "Channel %d is not supported by this function due to lack of error register\n", ChannelNumber));
+    return;
+  }
+
+  if (!IsEspiSlaveChannelSupported (SlaveId, ChannelNumber)) {
+    DEBUG ((DEBUG_WARN, "Channel %d is not supported by slave device\n", ChannelNumber));
+    return;
+  }
+
+  // Calculate channel address based on slave id
+  ChannelAddress = (UINT16) (ChannelBaseAddress + (SlaveId * S_ESPI_PCR_XERR));
+
+  // Reading channel error register data
+  Data32 = PchPcrRead32 (PID_ESPISPI, ChannelAddress);
+
+  DEBUG ((DEBUG_INFO, "eSPI channel error register (0x%4X) has value 0x%8X\n", ChannelAddress, Data32));
+
+  // Check Fatal Error status bit in channel error register data
+  if ((Data32 & B_ESPI_PCR_XERR_XFES) != 0) {
+    Status = PchEspiSlaveChannelReset (SlaveId, ChannelNumber);
+
+    if (EFI_ERROR (Status)) {
+      switch (Status) {
+        case EFI_UNSUPPORTED:
+          DEBUG ((DEBUG_ERROR, "Slave doesn't support channel %d\n", ChannelNumber));
+          break;
+        case EFI_TIMEOUT:
+          DEBUG ((DEBUG_ERROR, "Timeout occured during channel %d reset on slave %d\n", ChannelNumber, SlaveId));
+          break;
+        default:
+          DEBUG ((DEBUG_ERROR, "Error occured during channel %d reset\n", ChannelNumber));
+          break;
+      }
+    } else {
+      DEBUG ((DEBUG_INFO, "eSPI Slave %d channel %d reset ended successfully\n", SlaveId, ChannelNumber));
+      // If channel reset was successfull clear the fatal error flag by writing one
+      // we should be aware not to clear other status bits by mistake and mask them
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        ChannelAddress,
+        GetEspiChannelStatusClearMask (ChannelNumber),
+        B_ESPI_PCR_XERR_XFES
+        );
+    }
+  }
+}
+
+/**
+  eSPI SMI handler for Fatal Error recovery flow
+**/
+VOID
+EspiDefaultFatalErrorHandler (
+  VOID
+  )
+{
+  UINT32      Data32;
+  UINT8       SlaveId;
+  UINT8       MaxSlavesCount;
+
+  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Enter\n"));
+
+  MaxSlavesCount = IsEspiSecondSlaveSupported () ? 2 : 1;
+
+  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] MaxSlavesCount %d\n", MaxSlavesCount));
+
+  for (SlaveId = 0; SlaveId < MaxSlavesCount; ++SlaveId) {
+    //
+    // Check if slave has SLCRR bit set. If it does it means it needs recovery.
+    //
+    Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16) (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_XERR)));
+
+    DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Slave %d LNKERR reg 0x%8X\n", SlaveId, Data32));
+    //
+    // If SLCRR[31] bit is set we need to recover that slave
+    //
+    if ((Data32 & B_ESPI_PCR_LNKERR_SLV0_SLCRR) != 0) {
+      // 1. Perform in-band reset
+      PchEspiSlaveInBandReset (SlaveId);
+
+      // 2. Channels reset
+      CheckSlaveChannelErrorAndReset (R_ESPI_PCR_PCERR_SLV0, 0, SlaveId); // Peripheral channel reset
+      CheckSlaveChannelErrorAndReset (R_ESPI_PCR_VWERR_SLV0, 1, SlaveId); // Virtual Wire channel reset
+
+      // Flash Access channel is not supported for CS1#
+      if (SlaveId == 0) {
+        CheckSlaveChannelErrorAndReset (R_ESPI_PCR_PCERR_SLV0, 3, SlaveId); // Flash Access channel reset
+      }
+
+      // Clear SLCRR bit of slave after all channels recovery was done
+      PchPcrAndThenOr32 (
+        PID_ESPISPI,
+        (UINT16) (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_XERR)),
+        (UINT32)~(B_ESPI_PCR_LNKERR_SLV0_LFET1S),
+        (UINT32) (B_ESPI_PCR_LNKERR_SLV0_SLCRR)
+        );
+    }
+  }
+
+  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Exit\n"));
+}
+
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.h
new file mode 100644
index 0000000000..4903464fae
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.h
@@ -0,0 +1,341 @@
+/** @file
+  eSPI SMI Dispatch header
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+
+#ifndef _PCH_SMM_ESPI_H_
+#define _PCH_SMM_ESPI_H_
+
+#include "PchSmmHelpers.h"
+
+#define ESPI_SMI_INSTANCE_SIGNATURE       SIGNATURE_32 ('E', 'S', 'P', 'I')
+#define ESPI_SMI_RECORD_SIGNATURE         SIGNATURE_32 ('E', 'S', 'R', 'C')
+
+#define ESPI_INSTANCE_FROM_THIS(_this)      CR (_this, ESPI_SMI_INSTANCE, EfiEspiSmiDispatchProtocol, ESPI_SMI_INSTANCE_SIGNATURE)
+#define ESPI_RECORD_FROM_LINK(_link)        CR (_link, ESPI_SMI_RECORD, Link, ESPI_SMI_RECORD_SIGNATURE)
+
+typedef enum {
+  EspiBiosWrProtect,    ///< BIOS Write Protect
+  EspiSerialIrq,        ///< eSPI Master Asserted SMI
+  EspiPmc,              ///< eSPI PMC SMI
+  EspiTopLevelTypeMax
+} ESPI_TOP_LEVEL_TYPE;
+
+typedef enum {
+  BiosWrProtect,        ///< BIOS Write Protect
+  BiosWrReport,         ///< Peripheral Channel BIOS Write Protect
+  PcNonFatalErr,        ///< Peripheral Channel Non Fatal Error
+  PcFatalErr,           ///< Peripheral Channel Fatal Error
+  VwNonFatalErr,        ///< Virtual Wire Non Fatal Error
+  VwFatalErr,           ///< Virtual Wire Fatal Error
+  FlashNonFatalErr,     ///< Flash Channel Non Fatal Error
+  FlashFatalErr,        ///< Flash Channel Fatal Error
+  LnkType1Err,          ///< Link Error
+  EspiSlaveSmi,         ///< Espi Slave SMI
+  EspiSmiTypeMax
+} ESPI_SMI_TYPE;
+
+///
+/// This is used to classify ESPI_SMI_TYPE to ESPI_TOP_LEVEL_TYPE.
+/// Used during dispatching and unregistering
+///
+typedef struct {
+  ESPI_SMI_TYPE Start;
+  ESPI_SMI_TYPE End;
+} ESPI_SMI_TYPE_BARRIER;
+
+typedef struct _ESPI_SMI_INSTANCE {
+  ///
+  /// Signature associated with this instance
+  ///
+  UINT32                          Signature;
+  ///
+  /// EFI_HANDLE acquired when installing PchEspiSmiDispatchProtocol
+  ///
+  EFI_HANDLE                      Handle;
+  ///
+  /// The protocol to register or unregister eSPI SMI callbacks
+  ///
+  PCH_ESPI_SMI_DISPATCH_PROTOCOL  PchEspiSmiDispatchProtocol;
+  ///
+  /// The handle acquired when registering eSPI SMI callback to PchSmiDispatch
+  ///
+  EFI_HANDLE                      PchSmiEspiHandle[EspiTopLevelTypeMax];
+  ///
+  /// The linked list for record database.
+  ///
+  LIST_ENTRY                      CallbackDataBase[EspiSmiTypeMax];
+  ///
+  /// This is an internal counter to track the number of eSPI master events have been registered.
+  /// When unregistering, we can disable the SMI if the counter is zero
+  ///
+  UINTN                           EspiSmiEventCounter[EspiSmiTypeMax];
+  ///
+  /// Instance of barrier
+  ///
+  CONST ESPI_SMI_TYPE_BARRIER     Barrier[EspiTopLevelTypeMax];
+} ESPI_SMI_INSTANCE;
+
+typedef struct _ESPI_DESCRIPTOR {
+  PCH_SMM_ADDRESS   Address;
+  UINT32            SourceIsActiveAndMask;
+  UINT32            SourceIsActiveValue;
+  UINT32            ClearStatusAndMask;
+  UINT32            ClearStatusOrMask;
+} ESPI_DESCRIPTOR;
+
+///
+/// A simple record to store the callbacks associated with an eSPI SMI source
+///
+typedef struct _ESPI_SMI_RECORD {
+  UINT32                          Signature;
+  LIST_ENTRY                      Link;
+  PCH_ESPI_SMI_DISPATCH_CALLBACK  Callback;
+} ESPI_SMI_RECORD;
+
+/**
+  Installs and initialize this protocol
+
+  @param[in]  ImageHandle   Not used
+
+  @retval     EFI_SUCCESS   Installation succeed
+  @retval     others        Installation failed
+**/
+EFI_STATUS
+EFIAPI
+InstallEspiSmi (
+  IN EFI_HANDLE           ImageHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a BIOS Write Protect event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+BiosWrProtectRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a BIOS Write Report event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+BiosWrReportRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+PcNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+PcFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+VwNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+VwFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Flash Channel Non Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+FlashNonFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Flash Channel Fatal Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+FlashFatalErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a Link Error event
+
+  @param[in]  This              Not used
+  @param[in]  DispatchFunction  The callback to execute
+  @param[out] DispatchHandle    The handle for this callback registration
+
+  @retval     EFI_SUCCESS       Registration succeed
+  @retval     EFI_ACCESS_DENIED Return access denied if the SmmReadyToLock event has been triggered
+  @retval     others            Registration failed
+**/
+EFI_STATUS
+EFIAPI
+LnkType1ErrRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
+  OUT EFI_HANDLE                      *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to register a eSPI slave SMI
+  NOTE: The register function is not available when the ESPI_SMI_LOCK bit is set.
+        This runtine will also lock donw ESPI_SMI_LOCK bit after registration and
+        prevent this handler from unregistration.
+  On platform that supports more than 1 device through another chip select (SPT-H),
+  the SMI handler itself needs to inspect both the eSPI devices' interrupt status registers
+  (implementation specific for each Slave) in order to identify and service the cause.
+  After servicing it, it has to clear the Slaves' internal SMI# status registers
+
+  @param[in]  This                      Not used
+  @param[in]  DispatchFunction          The callback to execute
+  @param[out] DispatchHandle            The handle for this callback registration
+
+  @retval     EFI_SUCCESS               Registration succeed
+  @retval     EFI_ACCESS_DENIED         Return access denied if the SmmReadyToLock event has been triggered
+  @retval     EFI_ACCESS_DENIED         The ESPI_SMI_LOCK is set and register is blocked.
+  @retval     others                    Registration failed
+**/
+EFI_STATUS
+EFIAPI
+EspiSlaveSmiRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL    *This,
+  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
+  OUT EFI_HANDLE                        *DispatchHandle
+  );
+
+/**
+  eSPI SMI Dispatch Protocol instance to unregister a callback based on handle
+
+  @param[in]  This                    Not used
+  @param[in]  DispatchHandle          Handle acquired during registration
+
+  @retval     EFI_SUCCESS             Unregister successful
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has bad pointer
+  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in database
+  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
+  @retval     EFI_ACCESS_DENIED       DispatchHandle is not allowed to unregistered
+**/
+EFI_STATUS
+EFIAPI
+EspiSmiUnRegister (
+  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
+  IN  EFI_HANDLE                      DispatchHandle
+  );
+
+/**
+  eSPI SMI handler for Fatal Error recovery flow
+
+  @param[in]  DispatchHandle          Handle acquired during registration
+**/
+VOID
+EspiDefaultFatalErrorHandler (
+  VOID
+  );
+
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.c
new file mode 100644
index 0000000000..61f925c860
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.c
@@ -0,0 +1,263 @@
+/** @file
+  File to contain all the hardware specific stuff for the Smm Gpi dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmm.h"
+#include "PchSmmHelpers.h"
+#include <Library/SmiHandlerProfileLib.h>
+#include <Register/GpioRegs.h>
+#include <Register/PmcRegs.h>
+
+//
+// Structure for GPI SMI is a template which needs to have
+// GPI Smi bit offset and Smi Status & Enable registers updated (accordingly
+// to choosen group and pad number) after adding it to SMM Callback database
+//
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mPchGpiSourceDescTemplate = {
+  PCH_SMM_NO_FLAGS,
+  {
+    NULL_BIT_DESC_INITIALIZER,
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        GPIO_ADDR_TYPE, {0x0}
+      },
+      S_GPIO_PCR_GP_SMI_STS, 0x0,
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_GPIO_SMI
+  }
+};
+
+/**
+  The register function used to register SMI handler of GPI SMI event.
+
+  @param[in]  This               Pointer to the EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
+  @param[in]  DispatchFunction   Function to register for handler when the specified GPI causes an SMI.
+  @param[in]  RegisterContext    Pointer to the dispatch function's context.
+                                 The caller fills this context in before calling
+                                 the register function to indicate to the register
+                                 function the GPI(s) for which the dispatch function
+                                 should be invoked.
+  @param[out] DispatchHandle     Handle generated by the dispatcher to track the
+                                 function instance.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully
+                                 registered and the SMI source has been enabled.
+  @retval EFI_ACCESS_DENIED      Register is not allowed
+  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The GPI input value
+                                 is not within valid range.
+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system or SMM) to manage this child.
+**/
+EFI_STATUS
+EFIAPI
+PchGpiSmiRegister (
+  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_SMM_HANDLER_ENTRY_POINT2    DispatchFunction,
+  IN       EFI_SMM_GPI_REGISTER_CONTEXT    *RegisterContext,
+  OUT      EFI_HANDLE                      *DispatchHandle
+  )
+{
+  EFI_STATUS                  Status;
+  DATABASE_RECORD             Record;
+  GPIO_PAD                    GpioPad;
+  UINT8                       GpiSmiBitOffset;
+  UINT32                      GpiHostSwOwnRegAddress;
+  UINT32                      GpiSmiStsRegAddress;
+  UINT32                      Data32Or;
+  UINT32                      Data32And;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the EndOfDxe event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  Status = GpioGetPadAndSmiRegs (
+             (UINT32) RegisterContext->GpiNum,
+             &GpioPad,
+             &GpiSmiBitOffset,
+             &GpiHostSwOwnRegAddress,
+             &GpiSmiStsRegAddress
+             );
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  ZeroMem (&Record, sizeof (DATABASE_RECORD));
+
+  //
+  // Gather information about the registration request
+  //
+  Record.Callback          = DispatchFunction;
+  Record.ChildContext.Gpi  = *RegisterContext;
+  Record.ProtocolType      = GpiType;
+  Record.Signature         = DATABASE_RECORD_SIGNATURE;
+
+  CopyMem (&Record.SrcDesc, &mPchGpiSourceDescTemplate, sizeof (PCH_SMM_SOURCE_DESC) );
+
+  Record.SrcDesc.Sts[0].Reg.Data.raw = GpiSmiStsRegAddress;  // GPI SMI Status register
+  Record.SrcDesc.Sts[0].Bit = GpiSmiBitOffset;               // Bit position for selected pad
+
+  //
+  // Insert GpiSmi handler to PchSmmCore database
+  //
+  *DispatchHandle = NULL;
+
+  Status = SmmCoreInsertRecord (
+             &Record,
+             DispatchHandle
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  SmiHandlerProfileRegisterHandler (
+    &gEfiSmmGpiDispatch2ProtocolGuid,
+    (EFI_SMM_HANDLER_ENTRY_POINT2) DispatchFunction,
+    (UINTN)RETURN_ADDRESS (0),
+    RegisterContext,
+    sizeof(*RegisterContext)
+    );
+
+  //
+  // Enable GPI SMI
+  // HOSTSW_OWN with respect to generating GPI SMI has negative logic:
+  //  - 0 (ACPI mode) - GPIO pad will be capable of generating SMI/NMI/SCI
+  //  - 1 (GPIO mode) - GPIO pad will not generate SMI/NMI/SCI
+  //
+  Data32And  = (UINT32)~(1u << GpiSmiBitOffset);
+  MmioAnd32 (GpiHostSwOwnRegAddress, Data32And);
+
+  //
+  // Add HOSTSW_OWN programming into S3 boot script
+  //
+  Data32Or = 0;
+  S3BootScriptSaveMemReadWrite (S3BootScriptWidthUint32, GpiHostSwOwnRegAddress, &Data32Or, &Data32And);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Unregister a GPI SMI source dispatch function with a parent SMM driver
+
+  @param[in] This                 Pointer to the EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle       Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS             The dispatch function has been successfully
+                                  unregistered and the SMI source has been disabled
+                                  if there are no other registered child dispatch
+                                  functions for this SMI source.
+  @retval EFI_INVALID_PARAMETER   Handle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchGpiSmiUnRegister (
+  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_HANDLE                      DispatchHandle
+  )
+{
+  EFI_STATUS      Status;
+  DATABASE_RECORD *RecordToDelete;
+  DATABASE_RECORD *RecordInDb;
+  LIST_ENTRY      *LinkInDb;
+  GPIO_PAD        GpioPad;
+  UINT8           GpiSmiBitOffset;
+  UINT32          GpiHostSwOwnRegAddress;
+  UINT32          GpiSmiStsRegAddress;
+  UINT32          Data32Or;
+  UINT32          Data32And;
+  BOOLEAN         DisableGpiSmiSource;
+
+
+  if (DispatchHandle == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  if ((RecordToDelete->Signature != DATABASE_RECORD_SIGNATURE) ||
+      (RecordToDelete->ProtocolType != GpiType)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  DisableGpiSmiSource = TRUE;
+  //
+  // Loop through all sources in record linked list to see if any other GPI SMI
+  // is installed on the same pin. If no then disable GPI SMI capability on this pad
+  //
+  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
+  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+    RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
+    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, &RecordInDb->Link);
+    //
+    // If this is the record to delete skip it
+    //
+    if (RecordInDb == RecordToDelete) {
+      continue;
+    }
+    //
+    // Check if record is GPI SMI type
+    //
+    if (RecordInDb->ProtocolType == GpiType) {
+      //
+      // Check if same GPIO pad is the source of this SMI
+      //
+      if (RecordInDb->ChildContext.Gpi.GpiNum == RecordToDelete->ChildContext.Gpi.GpiNum) {
+        DisableGpiSmiSource = FALSE;
+        break;
+      }
+    }
+  }
+
+  if (DisableGpiSmiSource) {
+    GpioGetPadAndSmiRegs (
+      (UINT32) RecordToDelete->ChildContext.Gpi.GpiNum,
+      &GpioPad,
+      &GpiSmiBitOffset,
+      &GpiHostSwOwnRegAddress,
+      &GpiSmiStsRegAddress
+      );
+
+    Data32Or = 1u << GpiSmiBitOffset;
+    Data32And = 0xFFFFFFFF;
+    MmioOr32 (GpiHostSwOwnRegAddress, Data32Or);
+    S3BootScriptSaveMemReadWrite (S3BootScriptWidthUint32, GpiHostSwOwnRegAddress, &Data32Or, &Data32And);
+  }
+
+
+  RemoveEntryList (&RecordToDelete->Link);
+  ZeroMem (RecordToDelete, sizeof (DATABASE_RECORD));
+  Status = gSmst->SmmFreePool (RecordToDelete);
+
+  if (EFI_ERROR (Status)) {
+    ASSERT (FALSE);
+    return Status;
+  }
+  SmiHandlerProfileUnregisterHandler (
+    &gEfiSmmGpiDispatch2ProtocolGuid,
+    RecordToDelete->Callback,
+    &RecordToDelete->ChildContext,
+    RecordToDelete->ContextSize
+    );
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.c
new file mode 100644
index 0000000000..6bbf9ea8e8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.c
@@ -0,0 +1,332 @@
+/** @file
+  Helper functions for PCH SMM dispatcher.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Register/PmcRegs.h>
+
+///
+/// #define BIT_ZERO 0x00000001
+///
+GLOBAL_REMOVE_IF_UNREFERENCED CONST UINT32  BIT_ZERO = 0x00000001;
+
+///
+/// SUPPORT / HELPER FUNCTIONS (PCH version-independent)
+///
+
+/**
+  Compare 2 SMM source descriptors' enable settings.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The enable settings of the 2 SMM source descriptors are identical.
+  @retval FALSE                   The enable settings of the 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareEnables (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  )
+{
+  BOOLEAN IsEqual;
+  UINTN   DescIndex;
+
+  IsEqual = TRUE;
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
+    ///
+    /// It's okay to compare a NULL bit description to a non-NULL bit description.
+    /// They are unequal and these tests will generate the correct result.
+    ///
+    if (Src1->En[DescIndex].Bit != Src2->En[DescIndex].Bit ||
+        Src1->En[DescIndex].Reg.Type != Src2->En[DescIndex].Reg.Type ||
+        Src1->En[DescIndex].Reg.Data.raw != Src2->En[DescIndex].Reg.Data.raw
+        ) {
+      IsEqual = FALSE;
+      break;
+      ///
+      /// out of for loop
+      ///
+    }
+  }
+
+  return IsEqual;
+}
+
+/**
+  Compare a bit descriptor to the enables of source descriptor. Includes null address type.
+
+  @param[in] BitDesc              Pointer to the PCH SMI bit descriptor
+  @param[in] Src                  Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The bit desc is equal to any of the enables in source descriptor
+  @retval FALSE                   The bid desc is not equal to all of the enables in source descriptor
+**/
+BOOLEAN
+IsBitEqualToAnySourceEn (
+  CONST IN PCH_SMM_BIT_DESC    *BitDesc,
+  CONST IN PCH_SMM_SOURCE_DESC *Src
+  )
+{
+  BOOLEAN IsEqual;
+  UINTN   DescIndex;
+
+  IsEqual = FALSE;
+
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; ++DescIndex) {
+    if ((BitDesc->Reg.Type == Src->En[DescIndex].Reg.Type) &&
+        (BitDesc->Reg.Data.raw == Src->En[DescIndex].Reg.Data.raw) &&
+        (BitDesc->Bit == Src->En[DescIndex].Bit)) {
+      IsEqual = TRUE;
+      break;
+    }
+  }
+  return IsEqual;
+}
+
+/**
+  Compare 2 SMM source descriptors' statuses.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The statuses of the 2 SMM source descriptors are identical.
+  @retval FALSE                   The statuses of the 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareStatuses (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  )
+{
+  BOOLEAN IsEqual;
+  UINTN   DescIndex;
+
+  IsEqual = TRUE;
+
+  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
+    ///
+    /// It's okay to compare a NULL bit description to a non-NULL bit description.
+    /// They are unequal and these tests will generate the correct result.
+    ///
+    if (Src1->Sts[DescIndex].Bit != Src2->Sts[DescIndex].Bit ||
+        Src1->Sts[DescIndex].Reg.Type != Src2->Sts[DescIndex].Reg.Type ||
+        Src1->Sts[DescIndex].Reg.Data.raw != Src2->Sts[DescIndex].Reg.Data.raw
+        ) {
+      IsEqual = FALSE;
+      break;
+      ///
+      /// out of for loop
+      ///
+    }
+  }
+
+  return IsEqual;
+}
+
+/**
+  Compare 2 SMM source descriptors, based on Enable settings and Status settings of them.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The 2 SMM source descriptors are identical.
+  @retval FALSE                   The 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareSources (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  )
+{
+  return (BOOLEAN) (CompareEnables (Src1, Src2) && CompareStatuses (Src1, Src2));
+}
+
+/**
+  Check if an SMM source is active.
+
+  @param[in] Src                  Pointer to the PCH SMI source description table
+  @param[in] SciEn                Indicate if SCI is enabled or not
+  @param[in] SmiEnValue           Value from R_ACPI_IO_SMI_EN
+  @param[in] SmiStsValue          Value from R_ACPI_IO_SMI_STS
+
+  @retval TRUE                    It is active.
+  @retval FALSE                   It is inactive.
+**/
+BOOLEAN
+SourceIsActive (
+  CONST IN PCH_SMM_SOURCE_DESC  *Src,
+  CONST IN BOOLEAN              SciEn,
+  CONST IN UINT32               SmiEnValue,
+  CONST IN UINT32               SmiStsValue
+  )
+{
+  UINTN   DescIndex;
+
+  ///
+  /// This source is dependent on SciEn, and SciEn == 1.  An ACPI OS is present,
+  /// so we shouldn't do anything w/ this source until SciEn == 0.
+  ///
+  if ((Src->Flags == PCH_SMM_SCI_EN_DEPENDENT) && (SciEn)) {
+    return FALSE;
+  }
+
+  ///
+  /// Checking top level SMI status. If the status is not active, return false immediately
+  ///
+  if (!IS_BIT_DESC_NULL (Src->PmcSmiSts)) {
+    if ((Src->PmcSmiSts.Reg.Type == ACPI_ADDR_TYPE) &&
+        (Src->PmcSmiSts.Reg.Data.acpi == R_ACPI_IO_SMI_STS) &&
+        ((SmiStsValue & (1u << Src->PmcSmiSts.Bit)) == 0)) {
+      return FALSE;
+    }
+  }
+
+  ///
+  /// Read each bit desc from hardware and make sure it's a one
+  ///
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (Src->En[DescIndex])) {
+      if ((Src->En[DescIndex].Reg.Type == ACPI_ADDR_TYPE) &&
+          (Src->En[DescIndex].Reg.Data.acpi == R_ACPI_IO_SMI_EN) &&
+          ((SmiEnValue & (1u << Src->En[DescIndex].Bit)) == 0)) {
+        return FALSE;
+      } else if (ReadBitDesc (&Src->En[DescIndex]) == 0) {
+        return FALSE;
+      }
+    }
+  }
+
+  ///
+  /// Read each bit desc from hardware and make sure it's a one
+  ///
+  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (Src->Sts[DescIndex])) {
+      if ((Src->Sts[DescIndex].Reg.Type == ACPI_ADDR_TYPE) &&
+          (Src->Sts[DescIndex].Reg.Data.acpi == R_ACPI_IO_SMI_STS) &&
+          ((SmiStsValue & (1u << Src->Sts[DescIndex].Bit)) == 0)) {
+        return FALSE;
+      } else if (ReadBitDesc (&Src->Sts[DescIndex]) == 0) {
+        return FALSE;
+      }
+    }
+  }
+
+  return TRUE;
+}
+
+/**
+  Enable the SMI source event by set the SMI enable bit, this function would also clear SMI
+  status bit to make initial state is correct
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmEnableSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  )
+{
+  UINTN DescIndex;
+
+  ///
+  /// Set enables to 1 by writing a 1
+  ///
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (SrcDesc->En[DescIndex])) {
+      WriteBitDesc (&SrcDesc->En[DescIndex], 1, FALSE);
+    }
+  }
+  ///
+  /// Clear statuses to 0 by writing a 1
+  ///
+  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
+      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
+    }
+  }
+}
+
+/**
+  Disable the SMI source event by clear the SMI enable bit
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmDisableSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  )
+{
+  UINTN DescIndex;
+
+  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (SrcDesc->En[DescIndex])) {
+      WriteBitDesc (&SrcDesc->En[DescIndex], 0, FALSE);
+    }
+  }
+}
+
+/**
+  Clear the SMI status bit by set the source bit of SMI status register
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmClearSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  )
+{
+  UINTN DescIndex;
+
+  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
+    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
+      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
+    }
+  }
+}
+
+/**
+  Sets the source to a 1 and then waits for it to clear.
+  Be very careful when calling this function -- it will not
+  ASSERT.  An acceptable case to call the function is when
+  waiting for the NEWCENTURY_STS bit to clear (which takes
+  3 RTCCLKs).
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmClearSourceAndBlock (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  )
+{
+  UINTN   DescIndex;
+  BOOLEAN IsSet;
+
+  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
+
+    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
+      ///
+      /// Write the bit
+      ///
+      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
+
+      ///
+      /// Don't return until the bit actually clears.
+      ///
+      IsSet = TRUE;
+      while (IsSet) {
+        IsSet = ReadBitDesc (&SrcDesc->Sts[DescIndex]);
+        ///
+        /// IsSet will eventually clear -- or else we'll have
+        /// an infinite loop.
+        ///
+      }
+    }
+  }
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.h
new file mode 100644
index 0000000000..db7713fa02
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpers.h
@@ -0,0 +1,155 @@
+/** @file
+  Helper functions for PCH SMM
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef PCH_SMM_HELPERS_H
+#define PCH_SMM_HELPERS_H
+
+#include "PchSmm.h"
+#include "PchxSmmHelpers.h"
+//
+// ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+// SUPPORT / HELPER FUNCTIONS (PCH version-independent)
+//
+
+/**
+  Publish SMI Dispatch protocols.
+
+
+**/
+VOID
+PchSmmPublishDispatchProtocols (
+  VOID
+  );
+
+/**
+  Compare 2 SMM source descriptors' enable settings.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The enable settings of the 2 SMM source descriptors are identical.
+  @retval FALSE                   The enable settings of the 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareEnables (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  );
+
+/**
+  Compare a bit descriptor to the enables of source descriptor. Includes null address type.
+
+  @param[in] BitDesc              Pointer to the PCH SMI bit descriptor
+  @param[in] Src                  Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The bit desc is equal to any of the enables in source descriptor
+  @retval FALSE                   The bid desc is not equal to all of the enables in source descriptor
+**/
+BOOLEAN
+IsBitEqualToAnySourceEn (
+  CONST IN PCH_SMM_BIT_DESC    *BitDesc,
+  CONST IN PCH_SMM_SOURCE_DESC *Src
+  );
+
+/**
+  Compare 2 SMM source descriptors' statuses.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The statuses of the 2 SMM source descriptors are identical.
+  @retval FALSE                   The statuses of the 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareStatuses (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  );
+
+/**
+  Compare 2 SMM source descriptors, based on Enable settings and Status settings of them.
+
+  @param[in] Src1                 Pointer to the PCH SMI source description table 1
+  @param[in] Src2                 Pointer to the PCH SMI source description table 2
+
+  @retval TRUE                    The 2 SMM source descriptors are identical.
+  @retval FALSE                   The 2 SMM source descriptors are not identical.
+**/
+BOOLEAN
+CompareSources (
+  CONST IN PCH_SMM_SOURCE_DESC *Src1,
+  CONST IN PCH_SMM_SOURCE_DESC *Src2
+  );
+
+/**
+  Check if an SMM source is active.
+
+  @param[in] Src                  Pointer to the PCH SMI source description table
+  @param[in] SciEn                Indicate if SCI is enabled or not
+  @param[in] SmiEnValue           Value from R_PCH_SMI_EN
+  @param[in] SmiStsValue          Value from R_PCH_SMI_STS
+
+  @retval TRUE                    It is active.
+  @retval FALSE                   It is inactive.
+**/
+BOOLEAN
+SourceIsActive (
+  CONST IN PCH_SMM_SOURCE_DESC  *Src,
+  CONST IN BOOLEAN              SciEn,
+  CONST IN UINT32               SmiEnValue,
+  CONST IN UINT32               SmiStsValue
+  );
+
+/**
+  Enable the SMI source event by set the SMI enable bit, this function would also clear SMI
+  status bit to make initial state is correct
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmEnableSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  );
+
+/**
+  Disable the SMI source event by clear the SMI enable bit
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmDisableSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  );
+
+/**
+  Clear the SMI status bit by set the source bit of SMI status register
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmClearSource (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  );
+
+/**
+  Sets the source to a 1 and then waits for it to clear.
+  Be very careful when calling this function -- it will not
+  ASSERT.  An acceptable case to call the function is when
+  waiting for the NEWCENTURY_STS bit to clear (which takes
+  3 RTCCLKs).
+
+  @param[in] SrcDesc              Pointer to the PCH SMI source description table
+
+**/
+VOID
+PchSmmClearSourceAndBlock (
+  CONST PCH_SMM_SOURCE_DESC *SrcDesc
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeriodicTimer.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeriodicTimer.c
new file mode 100644
index 0000000000..3c3e638cbf
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeriodicTimer.c
@@ -0,0 +1,667 @@
+/** @file
+  File to contain all the hardware specific stuff for the Periodical Timer dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Protocol/PchSmmPeriodicTimerControl.h>
+#include <Library/PmcPrivateLib.h>
+
+//
+// There is only one instance for PeriodicTimerCommBuffer.
+// It's safe in SMM since there is no re-entry for the function.
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_PERIODIC_TIMER_CONTEXT          mPchPeriodicTimerCommBuffer;
+
+typedef enum {
+  PERIODIC_TIMER= 0,
+  SWSMI_TIMER,
+  NUM_TIMERS
+} SUPPORTED_TIMER;
+
+typedef struct _TIMER_INTERVAL {
+  UINT64  Interval;
+  UINT8   AssociatedTimer;
+} TIMER_INTERVAL;
+
+#define NUM_INTERVALS 8
+
+//
+// Time constants, in 100 nano-second units
+//
+#define TIME_64s    640000000 ///< 64   s
+#define TIME_32s    320000000 ///< 32   s
+#define TIME_16s    160000000 ///< 16   s
+#define TIME_8s     80000000  ///<  8   s
+#define TIME_64ms   640000    ///< 64   ms
+#define TIME_32ms   320000    ///< 32   ms
+#define TIME_16ms   160000    ///< 16   ms
+#define TIME_1_5ms  15000     ///< 1.5  ms
+
+typedef enum {
+  INDEX_TIME_64s  = 0,
+  INDEX_TIME_32s,
+  INDEX_TIME_16s,
+  INDEX_TIME_8s,
+  INDEX_TIME_64ms,
+  INDEX_TIME_32ms,
+  INDEX_TIME_16ms,
+  INDEX_TIME_1_5ms,
+  INDEX_TIME_MAX
+} TIMER_INTERVAL_INDEX;
+
+static TIMER_INTERVAL mSmmPeriodicTimerIntervals[NUM_INTERVALS] = {
+  {
+    TIME_64s,
+    PERIODIC_TIMER
+  },
+  {
+    TIME_32s,
+    PERIODIC_TIMER
+  },
+  {
+    TIME_16s,
+    PERIODIC_TIMER
+  },
+  {
+    TIME_8s,
+    PERIODIC_TIMER
+  },
+  {
+    TIME_64ms,
+    SWSMI_TIMER
+  },
+  {
+    TIME_32ms,
+    SWSMI_TIMER
+  },
+  {
+    TIME_16ms,
+    SWSMI_TIMER
+  },
+  {
+    TIME_1_5ms,
+    SWSMI_TIMER
+  },
+};
+
+typedef struct _TIMER_INFO {
+  UINTN   NumChildren;        ///< number of children using this timer
+  UINT64  MinReqInterval;     ///< minimum interval required by children
+  UINTN   CurrentSetting;     ///< interval this timer is set at right now (index into interval table)
+} TIMER_INFO;
+
+GLOBAL_REMOVE_IF_UNREFERENCED TIMER_INFO          mTimers[NUM_TIMERS];
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mTimerSourceDesc[NUM_TIMERS] = {
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          ACPI_ADDR_TYPE,
+          {R_ACPI_IO_SMI_EN}
+        },
+        S_ACPI_IO_SMI_EN,
+        N_ACPI_IO_SMI_EN_PERIODIC
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          ACPI_ADDR_TYPE,
+          {R_ACPI_IO_SMI_STS}
+        },
+        S_ACPI_IO_SMI_STS,
+        N_ACPI_IO_SMI_STS_PERIODIC
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_PERIODIC
+    }
+  },
+  {
+    PCH_SMM_NO_FLAGS,
+    {
+      {
+        {
+          ACPI_ADDR_TYPE,
+          {R_ACPI_IO_SMI_EN}
+        },
+        S_ACPI_IO_SMI_EN,
+        N_ACPI_IO_SMI_EN_SWSMI_TMR
+      },
+      NULL_BIT_DESC_INITIALIZER
+    },
+    {
+      {
+        {
+          ACPI_ADDR_TYPE,
+          {R_ACPI_IO_SMI_STS}
+        },
+        S_ACPI_IO_SMI_STS,
+        N_ACPI_IO_SMI_STS_SWSMI_TMR
+      }
+    },
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_SWSMI_TMR
+    }
+  }
+};
+
+/**
+  Program Smm Periodic Timer
+
+  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC instance.
+**/
+VOID
+PchSmmPeriodicTimerProgramTimers (
+  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
+  );
+
+/**
+  Convert the dispatch context to the timer interval, this function will assert if then either:
+  (1) The context contains an invalid interval
+  (2) The timer interval table is corrupt
+
+  @param[in] DispatchContext      The pointer to the Dispatch Context
+
+  @retval TIMER_INTERVAL          The timer interval of input dispatch context
+**/
+TIMER_INTERVAL *
+ContextToTimerInterval (
+  IN  PCH_SMM_CONTEXT     *DispatchContext
+  )
+{
+  UINTN loopvar;
+
+  ///
+  /// Determine which timer this child is using
+  ///
+  for (loopvar = 0; loopvar < NUM_INTERVALS; loopvar++) {
+    if (((DispatchContext->PeriodicTimer.SmiTickInterval == 0) &&
+         (DispatchContext->PeriodicTimer.Period >= mSmmPeriodicTimerIntervals[loopvar].Interval)) ||
+        (DispatchContext->PeriodicTimer.SmiTickInterval == mSmmPeriodicTimerIntervals[loopvar].Interval)) {
+      return &mSmmPeriodicTimerIntervals[loopvar];
+    }
+  }
+  ///
+  /// If this assertion fires, then either:
+  ///    (1) the context contains an invalid interval
+  ///    (2) the timer interval table is corrupt
+  ///
+  ASSERT (FALSE);
+
+  return NULL;
+}
+
+/**
+  Figure out which timer the child is requesting and
+  send back the source description
+
+  @param[in] DispatchContext      The pointer to the Dispatch Context instances
+  @param[out] SrcDesc             The pointer to the source description
+
+**/
+VOID
+MapPeriodicTimerToSrcDesc (
+  IN  PCH_SMM_CONTEXT             *DispatchContext,
+  OUT PCH_SMM_SOURCE_DESC         *SrcDesc
+  )
+{
+  TIMER_INTERVAL  *TimerInterval;
+
+  ///
+  /// Figure out which timer the child is requesting and
+  /// send back the source description
+  ///
+  TimerInterval = ContextToTimerInterval (DispatchContext);
+  if (TimerInterval == NULL) {
+    return;
+  }
+
+  CopyMem (
+    (VOID *) SrcDesc,
+    (VOID *) (&mTimerSourceDesc[TimerInterval->AssociatedTimer]),
+    sizeof (PCH_SMM_SOURCE_DESC)
+    );
+
+  ///
+  /// Program the value of the interval into hardware
+  ///
+  PchSmmPeriodicTimerProgramTimers (SrcDesc);
+}
+
+/**
+  Update the elapsed time from the Interval data of DATABASE_RECORD
+
+  @param[in] Record               The pointer to the DATABASE_RECORD.
+  @param[out] HwContext           The Context to be updated.
+
+**/
+VOID
+EFIAPI
+PeriodicTimerGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *HwContext
+  )
+{
+  TIMER_INTERVAL  *TimerInterval;
+
+  ASSERT (Record->ProtocolType == PeriodicTimerType);
+
+  TimerInterval = ContextToTimerInterval (&Record->ChildContext);
+  if (TimerInterval == NULL) {
+    return;
+  }
+  ///
+  /// Ignore the hardware context. It's not required for this protocol.
+  /// Instead, just increment the child's context.
+  /// Update the elapsed time w/ the data from our tables
+  ///
+  Record->MiscData.ElapsedTime += mTimers[TimerInterval->AssociatedTimer].MinReqInterval;
+  *HwContext = Record->ChildContext;
+}
+
+/**
+  Check whether Periodic Timer of two contexts match
+
+  @param[in] Context1             Context 1 that includes Periodic Timer  1
+  @param[in] Context2             Context 2 that includes Periodic Timer  2
+
+  @retval FALSE                   Periodic Timer match
+  @retval TRUE                    Periodic Timer don't match
+**/
+BOOLEAN
+EFIAPI
+PeriodicTimerCmpContext (
+  IN PCH_SMM_CONTEXT     *HwContext,
+  IN PCH_SMM_CONTEXT     *ChildContext
+  )
+{
+  DATABASE_RECORD        *Record;
+  Record = DATABASE_RECORD_FROM_CHILDCONTEXT (ChildContext);
+
+  if (!Record->MiscData.TimerSmiEnabled) {
+    return FALSE;
+  }
+  if (Record->MiscData.ElapsedTime >= ChildContext->PeriodicTimer.Period) {
+    ///
+    /// For EDKII, the ElapsedTime is reset when PeriodicTimerGetCommBuffer
+    ///
+    return TRUE;
+  } else {
+    return FALSE;
+  }
+}
+
+/**
+  Gather the CommBuffer information of SmmPeriodicTimerDispatch2.
+
+  @param[in]  Record              No use
+  @param[out] CommBuffer          Point to the CommBuffer structure
+  @param[out] CommBufferSize      Point to the Size of CommBuffer structure
+
+**/
+VOID
+EFIAPI
+PeriodicTimerGetCommBuffer (
+  IN  DATABASE_RECORD    *Record,
+  OUT VOID               **CommBuffer,
+  OUT UINTN              *CommBufferSize
+  )
+{
+  ASSERT (Record->ProtocolType == PeriodicTimerType);
+
+  mPchPeriodicTimerCommBuffer.ElapsedTime = Record->MiscData.ElapsedTime;
+
+  ///
+  /// For EDKII, the ElapsedTime is reset here
+  ///
+  Record->MiscData.ElapsedTime = 0;
+
+  ///
+  /// Return the CommBuffer
+  ///
+  *CommBuffer = (VOID *) &mPchPeriodicTimerCommBuffer;
+  *CommBufferSize = sizeof (EFI_SMM_PERIODIC_TIMER_CONTEXT);
+}
+
+/**
+  Program Smm Periodic Timer
+
+  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC instance.
+**/
+VOID
+PchSmmPeriodicTimerProgramTimers (
+  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
+  )
+{
+  SUPPORTED_TIMER Timer;
+  DATABASE_RECORD *RecordInDb;
+  LIST_ENTRY      *LinkInDb;
+  TIMER_INTERVAL  *TimerInterval;
+
+  ///
+  /// Find the minimum required interval for each timer
+  ///
+  for (Timer = 0; Timer < NUM_TIMERS; Timer++) {
+    mTimers[Timer].MinReqInterval = ~ (UINT64) 0x0;
+    mTimers[Timer].NumChildren    = 0;
+  }
+
+  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
+  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+    RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
+    if (RecordInDb->ProtocolType == PeriodicTimerType) {
+      if (RecordInDb->MiscData.TimerSmiEnabled) {
+        ///
+        /// This child is registerd with the PeriodicTimer protocol
+        ///
+        TimerInterval = ContextToTimerInterval (&RecordInDb->ChildContext);
+        if (TimerInterval == NULL) {
+          return;
+        }
+
+        Timer = TimerInterval->AssociatedTimer;
+        if (Timer < 0 || Timer >= NUM_TIMERS) {
+          ASSERT (FALSE);
+          CpuDeadLoop ();
+          return;
+        }
+        if (mTimers[Timer].MinReqInterval > RecordInDb->ChildContext.PeriodicTimer.SmiTickInterval) {
+          mTimers[Timer].MinReqInterval = RecordInDb->ChildContext.PeriodicTimer.SmiTickInterval;
+        }
+        mTimers[Timer].NumChildren++;
+      }
+    }
+    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, &RecordInDb->Link);
+  }
+  ///
+  /// Program the hardware
+  ///
+  if (mTimers[PERIODIC_TIMER].NumChildren > 0) {
+    switch (mTimers[PERIODIC_TIMER].MinReqInterval) {
+      case TIME_64s:
+        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate64s);
+        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_64s;
+        break;
+
+      case TIME_32s:
+        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate32s);
+        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_32s;
+        break;
+
+      case TIME_16s:
+        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate16s);
+        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_16s;
+        break;
+
+      case TIME_8s:
+        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate8s);
+        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_8s;
+        break;
+
+      default:
+        ASSERT (FALSE);
+        break;
+    }
+
+    ///
+    /// Restart the timer here, just need to clear the SMI
+    ///
+    if (SrcDesc->Sts[0].Bit == N_ACPI_IO_SMI_STS_PERIODIC) {
+      PchSmmClearSource (&mTimerSourceDesc[PERIODIC_TIMER]);
+    }
+  } else {
+    PchSmmDisableSource (&mTimerSourceDesc[PERIODIC_TIMER]);
+  }
+
+  if (mTimers[SWSMI_TIMER].NumChildren > 0) {
+    switch (mTimers[SWSMI_TIMER].MinReqInterval) {
+      case TIME_64ms:
+        PmcSetSwSmiRate (PmcSwSmiRate64ms);
+        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_64ms;
+        break;
+
+      case TIME_32ms:
+        PmcSetSwSmiRate (PmcSwSmiRate32ms);
+        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_32ms;
+        break;
+
+      case TIME_16ms:
+        PmcSetSwSmiRate (PmcSwSmiRate16ms);
+        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_16ms;
+        break;
+
+      case TIME_1_5ms:
+        PmcSetSwSmiRate (PmcSwSmiRate1p5ms);
+        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_1_5ms;
+        break;
+
+      default:
+        ASSERT (FALSE);
+        break;
+    }
+
+    ///
+    /// Restart the timer here, need to disable, clear, then enable to restart this timer
+    ///
+    if (SrcDesc->Sts[0].Bit == N_ACPI_IO_SMI_STS_SWSMI_TMR) {
+      PchSmmDisableSource (&mTimerSourceDesc[SWSMI_TIMER]);
+      PchSmmClearSource (&mTimerSourceDesc[SWSMI_TIMER]);
+      PchSmmEnableSource (&mTimerSourceDesc[SWSMI_TIMER]);
+    }
+  } else {
+    PchSmmDisableSource (&mTimerSourceDesc[SWSMI_TIMER]);
+  }
+}
+
+/**
+  This services returns the next SMI tick period that is supported by the chipset.
+  The order returned is from longest to shortest interval period.
+
+  @param[in] This                 Pointer to the EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL instance.
+  @param[in, out] SmiTickInterval Pointer to pointer of the next shorter SMI interval period that is supported by the child.
+
+  @retval EFI_SUCCESS             The service returned successfully.
+  @retval EFI_INVALID_PARAMETER   The parameter SmiTickInterval is invalid.
+**/
+EFI_STATUS
+PchSmmPeriodicTimerDispatchGetNextShorterInterval (
+  IN CONST EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL  *This,
+  IN OUT   UINT64                                     **SmiTickInterval
+  )
+{
+  TIMER_INTERVAL  *IntervalPointer;
+
+  ASSERT (SmiTickInterval != NULL);
+
+  IntervalPointer = (TIMER_INTERVAL *) *SmiTickInterval;
+
+  if (IntervalPointer == NULL) {
+    ///
+    /// The first time child requesting an interval
+    ///
+    IntervalPointer = &mSmmPeriodicTimerIntervals[0];
+  } else if (IntervalPointer == &mSmmPeriodicTimerIntervals[NUM_INTERVALS - 1]) {
+    ///
+    /// At end of the list
+    ///
+    IntervalPointer = NULL;
+  } else {
+    if ((IntervalPointer >= &mSmmPeriodicTimerIntervals[0]) &&
+        (IntervalPointer < &mSmmPeriodicTimerIntervals[NUM_INTERVALS - 1])
+        ) {
+      ///
+      /// Get the next interval in the list
+      ///
+      IntervalPointer++;
+    } else {
+      ///
+      /// Input is out of range
+      ///
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  if (IntervalPointer != NULL) {
+    *SmiTickInterval = &IntervalPointer->Interval;
+  } else {
+    *SmiTickInterval = NULL;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This function is responsible for calculating and enabling any timers that are required
+  to dispatch messages to children. The SrcDesc argument isn't acutally used.
+
+  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC instance.
+
+**/
+VOID
+EFIAPI
+PchSmmPeriodicTimerClearSource (
+  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
+  )
+{
+  PchSmmPeriodicTimerProgramTimers (SrcDesc);
+}
+
+
+/**
+  Check if the handle is in type of PeriodicTimer
+
+  @retval TRUE                          The handle is in type of PeriodicTimer.
+  @retval FALSE                         The handle is not in type of PeriodicTimer.
+**/
+BOOLEAN
+IsSmmPeriodicTimerHandle (
+  IN EFI_HANDLE                         DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *RecordInDb;
+  LIST_ENTRY                            *LinkInDb;
+
+  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
+  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
+    if (DispatchHandle == (EFI_HANDLE) LinkInDb) {
+      RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
+      if (RecordInDb->ProtocolType == PeriodicTimerType) {
+        return TRUE;
+      }
+    }
+    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, LinkInDb);
+  }
+  return FALSE;
+}
+
+/**
+  Pause SMM periodic timer callback function.
+
+  This function disable the SMI enable of SMI timer according to the DispatchHandle,
+  which is returned by SMM periodic timer callback registration.
+
+  @retval EFI_SUCCESS                   This operation is complete.
+  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchSmmPeriodicTimerControlPause (
+  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
+  IN EFI_HANDLE                                   DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *RecordInDb;
+
+  if (IsSmmPeriodicTimerHandle (DispatchHandle) == FALSE) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RecordInDb = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  RecordInDb->MiscData.TimerSmiEnabled = FALSE;
+  //
+  // reset the timer interval per SMI trigger due to stop a periodic timer SMI
+  //
+  PchSmmPeriodicTimerProgramTimers (&RecordInDb->SrcDesc);
+  return EFI_SUCCESS;
+}
+
+/**
+  Resume SMM periodic timer callback function.
+
+  This function enable the SMI enable of SMI timer according to the DispatchHandle,
+  which is returned by SMM periodic timer callback registration.
+
+  @retval EFI_SUCCESS                   This operation is complete.
+  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
+**/
+EFI_STATUS
+EFIAPI
+PchSmmPeriodicTimerControlResume (
+  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
+  IN EFI_HANDLE                                   DispatchHandle
+  )
+{
+  DATABASE_RECORD                       *RecordInDb;
+
+  if (IsSmmPeriodicTimerHandle (DispatchHandle) == FALSE) {
+    return EFI_INVALID_PARAMETER;
+  }
+  RecordInDb = DATABASE_RECORD_FROM_LINK (DispatchHandle);
+  RecordInDb->MiscData.TimerSmiEnabled = TRUE;
+  //
+  // reset the timer interval per SMI trigger due to resume a periodic timer SMI
+  //
+  PchSmmPeriodicTimerProgramTimers (&RecordInDb->SrcDesc);
+  return EFI_SUCCESS;
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL mPchSmmPeriodicTimerControlProtocol = {
+  PchSmmPeriodicTimerControlPause,
+  PchSmmPeriodicTimerControlResume
+};
+
+/**
+  Install PCH SMM periodic timer control protocol
+
+  @param[in] Handle                     handle for this driver
+
+  @retval EFI_SUCCESS                   Driver initialization completed successfully
+**/
+EFI_STATUS
+EFIAPI
+InstallPchSmmPeriodicTimerControlProtocol (
+  IN EFI_HANDLE                         Handle
+  )
+{
+  EFI_STATUS                            Status;
+
+  //
+  // Install protocol interface
+  //
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gPchSmmPeriodicTimerControlGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mPchSmmPeriodicTimerControlProtocol
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPowerButton.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPowerButton.c
new file mode 100644
index 0000000000..bfed944848
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPowerButton.c
@@ -0,0 +1,81 @@
+/** @file
+  File to contain all the hardware specific stuff for the Smm Power Button dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <PchSmmHelpers.h>
+#include <Library/PmcPrivateLib.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mPowerButtonSourceDesc = {
+  PCH_SMM_SCI_EN_DEPENDENT,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_EN}
+      },
+      S_ACPI_IO_PM1_EN,
+      N_ACPI_IO_PM1_EN_PWRBTN
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_PM1_STS}
+      },
+      S_ACPI_IO_PM1_STS,
+      N_ACPI_IO_PM1_STS_PWRBTN
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_PM1_STS_REG
+  }
+};
+
+/**
+  Get the power button status.
+
+  @param[in] Record               The pointer to the DATABASE_RECORD.
+  @param[out] Context             Calling context from the hardware, will be updated with the current power button status.
+
+**/
+VOID
+EFIAPI
+PowerButtonGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *Context
+  )
+{
+  if (PmcGetPwrBtnLevel ()) {
+    Context->PowerButton.Phase = EfiPowerButtonExit;
+  } else {
+    Context->PowerButton.Phase = EfiPowerButtonEntry;
+  }
+}
+
+/**
+  Check whether Power Button status of two contexts match
+
+  @param[in] Context1             Context 1 that includes Power Button status 1
+  @param[in] Context2             Context 2 that includes Power Button status 2
+
+  @retval FALSE                   Power Button status match
+  @retval TRUE                    Power Button status don't match
+**/
+BOOLEAN
+EFIAPI
+PowerButtonCmpContext (
+  IN PCH_SMM_CONTEXT     *Context1,
+  IN PCH_SMM_CONTEXT     *Context2
+  )
+{
+  return (BOOLEAN) (Context1->PowerButton.Phase == Context2->PowerButton.Phase);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.c
new file mode 100644
index 0000000000..9b13bf6308
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.c
@@ -0,0 +1,381 @@
+/** @file
+  File to contain all the hardware specific stuff for the Smm Sw dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Protocol/SmmCpu.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/PmcRegs.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_CPU_PROTOCOL          *mSmmCpuProtocol;
+
+STATIC LIST_ENTRY                       mSwSmiCallbackDataBase;
+
+//
+// "SWSMI" RECORD
+// Linked list data structures
+//
+#define SW_SMI_RECORD_SIGNATURE         SIGNATURE_32 ('S', 'W', 'S', 'M')
+
+#define SW_SMI_RECORD_FROM_LINK(_record)  CR (_record, SW_SMI_RECORD, Link, SW_SMI_RECORD_SIGNATURE)
+
+typedef struct {
+  UINT32                                Signature;
+  LIST_ENTRY                            Link;
+  EFI_SMM_SW_REGISTER_CONTEXT           Context;
+  EFI_SMM_HANDLER_ENTRY_POINT2          Callback;
+} SW_SMI_RECORD;
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSwSourceDesc = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_APMC
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_APM
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_APM
+  }
+};
+
+/**
+  Check the SwSmiInputValue to see if there is a duplicated one in the database
+
+  @param[in] SwSmiInputValue      SwSmiInputValue
+
+  @retval EFI_SUCCESS             There is no duplicated SwSmiInputValue
+  @retval EFI_INVALID_PARAMETER   There is a duplicated SwSmiInputValue
+**/
+EFI_STATUS
+SmiInputValueDuplicateCheck (
+  IN UINTN  SwSmiInputValue
+  )
+{
+  SW_SMI_RECORD   *SwSmiRecord;
+  LIST_ENTRY      *LinkInDb;
+
+  LinkInDb = GetFirstNode (&mSwSmiCallbackDataBase);
+  while (!IsNull (&mSwSmiCallbackDataBase, LinkInDb)) {
+    SwSmiRecord = SW_SMI_RECORD_FROM_LINK (LinkInDb);
+    if (SwSmiRecord->Context.SwSmiInputValue == SwSmiInputValue) {
+      return EFI_INVALID_PARAMETER;
+    }
+    LinkInDb = GetNextNode (&mSwSmiCallbackDataBase, &SwSmiRecord->Link);
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Register a child SMI source dispatch function for the specified software SMI.
+
+  This service registers a function (DispatchFunction) which will be called when the software
+  SMI source specified by RegisterContext->SwSmiCpuIndex is detected. On return,
+  DispatchHandle contains a unique handle which may be used later to unregister the function
+  using UnRegister().
+
+  @param[in]  This                 Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
+  @param[in]  DispatchFunction     Function to register for handler when the specified software
+                                   SMI is generated.
+  @param[in, out] RegisterContext  Pointer to the dispatch function's context.
+                                   The caller fills this context in before calling
+                                   the register function to indicate to the register
+                                   function which Software SMI input value the
+                                   dispatch function should be invoked for.
+  @param[out] DispatchHandle       Handle generated by the dispatcher to track the
+                                   function instance.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully
+                                 registered and the SMI source has been enabled.
+  @retval EFI_DEVICE_ERROR       The SW driver was unable to enable the SMI source.
+  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The SW SMI input value
+                                 is not within a valid range or is already in use.
+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system or SMM) to manage this
+                                 child.
+  @retval EFI_OUT_OF_RESOURCES   A unique software SMI value could not be assigned
+                                 for this dispatch.
+**/
+EFI_STATUS
+EFIAPI
+PchSwSmiRegister (
+  IN  EFI_SMM_SW_DISPATCH2_PROTOCOL       *This,
+  IN  EFI_SMM_HANDLER_ENTRY_POINT2        DispatchFunction,
+  IN  EFI_SMM_SW_REGISTER_CONTEXT         *DispatchContext,
+  OUT EFI_HANDLE                          *DispatchHandle
+  )
+{
+  EFI_STATUS       Status;
+  SW_SMI_RECORD    *SwSmiRecord;
+  UINTN            Index;
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // Find available SW SMI value if the input is -1
+  //
+  if (DispatchContext->SwSmiInputValue == (UINTN) -1) {
+    for (Index = 1; Index < MAXIMUM_SWI_VALUE; Index++) {
+      if (!EFI_ERROR (SmiInputValueDuplicateCheck (Index))) {
+        DispatchContext->SwSmiInputValue = Index;
+        break;
+      }
+    }
+    if (DispatchContext->SwSmiInputValue == (UINTN) -1) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+  }
+  //
+  // Check if it's a valid SW SMI value.
+  // The value must not bigger than 0xFF.
+  // And the value must not be 0xFF sincie it's used for SmmControll protocol.
+  //
+  if (DispatchContext->SwSmiInputValue >= MAXIMUM_SWI_VALUE) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (EFI_ERROR (SmiInputValueDuplicateCheck (DispatchContext->SwSmiInputValue))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Create database record and add to database
+  //
+  Status = gSmst->SmmAllocatePool (
+                    EfiRuntimeServicesData,
+                    sizeof (SW_SMI_RECORD),
+                    (VOID **) &SwSmiRecord
+                    );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((DEBUG_ERROR, "Failed to allocate memory for SwSmiRecord! \n"));
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // Gather information about the registration request
+  //
+  SwSmiRecord->Signature               = SW_SMI_RECORD_SIGNATURE;
+  SwSmiRecord->Context.SwSmiInputValue = DispatchContext->SwSmiInputValue;
+  SwSmiRecord->Callback                = DispatchFunction;
+  //
+  // Publish the S/W SMI numbers in Serial logs used for Debug build.
+  //
+  DEBUG ((DEBUG_INFO, "SW SMI NUM %x  Sw Record at Address 0x%X\n", SwSmiRecord->Context.SwSmiInputValue, SwSmiRecord));
+
+  InsertTailList (&mSwSmiCallbackDataBase, &SwSmiRecord->Link);
+
+  //
+  // Child's handle will be the address linked list link in the record
+  //
+  *DispatchHandle = (EFI_HANDLE) (&SwSmiRecord->Link);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Unregister a child SMI source dispatch function for the specified software SMI.
+
+  This service removes the handler associated with DispatchHandle so that it will no longer be
+  called in response to a software SMI.
+
+  @param[in] This                Pointer to the EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
+  @param[in] DispatchHandle      Handle of dispatch function to deregister.
+
+  @retval EFI_SUCCESS            The dispatch function has been successfully unregistered.
+  @retval EFI_INVALID_PARAMETER  The DispatchHandle was not valid.
+**/
+EFI_STATUS
+EFIAPI
+PchSwSmiUnRegister (
+  IN CONST EFI_SMM_SW_DISPATCH2_PROTOCOL  *This,
+  IN       EFI_HANDLE                     DispatchHandle
+  )
+{
+  EFI_STATUS            Status;
+  SW_SMI_RECORD         *RecordToDelete;
+
+  if (DispatchHandle == 0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Return access denied if the SmmReadyToLock event has been triggered
+  //
+  if (mReadyToLock == TRUE) {
+    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the SmmReadyToLock event has been triggered! \n"));
+    return EFI_ACCESS_DENIED;
+  }
+
+  RecordToDelete = SW_SMI_RECORD_FROM_LINK (DispatchHandle);
+  //
+  // Take the entry out of the linked list
+  //
+  if (RecordToDelete->Signature != SW_SMI_RECORD_SIGNATURE) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RemoveEntryList (&RecordToDelete->Link);
+  ZeroMem (RecordToDelete, sizeof (SW_SMI_RECORD));
+  Status = gSmst->SmmFreePool (RecordToDelete);
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Main entry point for an SMM handler dispatch or communicate-based callback.
+
+  @param[in]     DispatchHandle  The unique handle assigned to this handler by SmiHandlerRegister().
+  @param[in]     Context         Points to an optional handler context which was specified when the
+                                 handler was registered.
+  @param[in,out] CommBuffer      A pointer to a collection of data in memory that will
+                                 be conveyed from a non-SMM environment into an SMM environment.
+  @param[in,out] CommBufferSize  The size of the CommBuffer.
+
+  @retval EFI_SUCCESS                         The interrupt was handled and quiesced. No other handlers
+                                              should still be called.
+  @retval EFI_WARN_INTERRUPT_SOURCE_QUIESCED  The interrupt has been quiesced but other handlers should
+                                              still be called.
+  @retval EFI_WARN_INTERRUPT_SOURCE_PENDING   The interrupt is still pending and other handlers should still
+                                              be called.
+  @retval EFI_INTERRUPT_PENDING               The interrupt could not be quiesced.
+**/
+EFI_STATUS
+EFIAPI
+PchSwSmiDispatcher (
+  IN       EFI_HANDLE         DispatchHandle,
+  IN CONST VOID               *Context,
+  IN OUT   VOID               *CommBuffer,
+  IN OUT   UINTN              *CommBufferSize
+  )
+{
+  EFI_STATUS                            Status;
+  EFI_SMM_SAVE_STATE_IO_INFO            SmiIoInfo;
+  UINTN                                 CpuIndex;
+  SW_SMI_RECORD                         *SwSmiRecord;
+  LIST_ENTRY                            *LinkInDb;
+  EFI_SMM_SW_CONTEXT                    SwSmiCommBuffer;
+  UINTN                                 SwSmiCommBufferSize;
+
+  SwSmiCommBufferSize      = sizeof (EFI_SMM_SW_CONTEXT);
+  //
+  // The value in DataPort might not be accurate in multiple thread environment.
+  // There might be racing condition for R_PCH_IO_APM_STS port.
+  // Therefor, this is just for reference.
+  //
+  SwSmiCommBuffer.DataPort = IoRead8 (R_PCH_IO_APM_STS);
+
+  for (CpuIndex = 0; CpuIndex < gSmst->NumberOfCpus; CpuIndex++) {
+    Status = mSmmCpuProtocol->ReadSaveState (
+                                mSmmCpuProtocol,
+                                sizeof (EFI_SMM_SAVE_STATE_IO_INFO),
+                                EFI_SMM_SAVE_STATE_REGISTER_IO,
+                                CpuIndex,
+                                &SmiIoInfo
+                                );
+    //
+    // If this is not the SMI source, skip it.
+    //
+    if (EFI_ERROR (Status)) {
+      continue;
+    }
+    //
+    // If the IO address is not "BYTE" "WRITE" to "R_PCH_IO_APM_CNT (0xB2)", skip it.
+    //
+    if ((SmiIoInfo.IoPort != R_PCH_IO_APM_CNT) ||
+        (SmiIoInfo.IoType != EFI_SMM_SAVE_STATE_IO_TYPE_OUTPUT) ||
+        (SmiIoInfo.IoWidth != EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8))
+    {
+      continue;
+    }
+    //
+    // If the IO data is used for SmmControl protocol, skip it.
+    //
+    if (SmiIoInfo.IoData == 0xFF) {
+      continue;
+    }
+
+    SwSmiCommBuffer.SwSmiCpuIndex = CpuIndex;
+    SwSmiCommBuffer.CommandPort   = (UINT8) SmiIoInfo.IoData;
+
+    LinkInDb = GetFirstNode (&mSwSmiCallbackDataBase);
+    while (!IsNull (&mSwSmiCallbackDataBase, LinkInDb)) {
+      SwSmiRecord = SW_SMI_RECORD_FROM_LINK (LinkInDb);
+      if (SwSmiRecord->Context.SwSmiInputValue == SmiIoInfo.IoData) {
+        SwSmiRecord->Callback ((EFI_HANDLE) &SwSmiRecord->Link, &SwSmiRecord->Context, &SwSmiCommBuffer, &SwSmiCommBufferSize);
+      }
+      LinkInDb = GetNextNode (&mSwSmiCallbackDataBase, &SwSmiRecord->Link);
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Init required protocol for Pch Sw Dispatch protocol.
+**/
+VOID
+PchSwDispatchInit (
+  VOID
+  )
+{
+  EFI_STATUS                            Status;
+  EFI_HANDLE                            DispatchHandle;
+  DATABASE_RECORD                       Record;
+
+  //
+  // Locate PI SMM CPU protocol
+  //
+  Status = gSmst->SmmLocateProtocol (&gEfiSmmCpuProtocolGuid, NULL, (VOID **)&mSmmCpuProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Initialize SW SMI Callback DataBase
+  //
+  InitializeListHead (&mSwSmiCallbackDataBase);
+
+  //
+  // Insert SwSmi handler to PchSmmCore database
+  // There will always be one SwType record in PchSmmCore database
+  //
+  ZeroMem (&Record, sizeof (DATABASE_RECORD));
+  Record.Signature    = DATABASE_RECORD_SIGNATURE;
+  Record.Callback     = PchSwSmiDispatcher;
+  Record.ProtocolType = SwType;
+
+  CopyMem (&Record.SrcDesc, &mSwSourceDesc, sizeof (PCH_SMM_SOURCE_DESC));
+
+  DispatchHandle      = NULL;
+  Status = SmmCoreInsertRecord (
+             &Record,
+             &DispatchHandle
+             );
+  ASSERT_EFI_ERROR (Status);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
new file mode 100644
index 0000000000..7d79f21dbd
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
@@ -0,0 +1,224 @@
+/** @file
+  File to contain all the hardware specific stuff for the Smm Sx dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Register/PmcRegs.h>
+#include <Register/PchPcieRpRegs.h>
+#include <Library/PchPciBdfLib.h>
+#include "PchSmiHelper.h"
+
+extern BOOLEAN               mS3SusStart;
+#define PROGRESS_CODE_S3_SUSPEND_END  PcdGet32 (PcdProgressCodeS3SuspendEnd)
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mSxSourceDesc = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_ON_SLP_EN
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_ON_SLP_EN
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_ON_SLP_EN
+  }
+};
+
+/**
+  Get the Sleep type
+
+  @param[in] Record               No use
+  @param[out] Context             The context that includes SLP_TYP bits to be filled
+
+**/
+VOID
+EFIAPI
+SxGetContext (
+  IN  DATABASE_RECORD    *Record,
+  OUT PCH_SMM_CONTEXT    *Context
+  )
+{
+  UINT32  Pm1Cnt;
+
+  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
+
+  ///
+  /// By design, the context phase will always be ENTRY
+  ///
+  Context->Sx.Phase = SxEntry;
+
+  ///
+  /// Map the PM1_CNT register's SLP_TYP bits to the context type
+  ///
+  switch (Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) {
+    case V_ACPI_IO_PM1_CNT_S0:
+      Context->Sx.Type = SxS0;
+      break;
+
+    case V_ACPI_IO_PM1_CNT_S1:
+      Context->Sx.Type = SxS1;
+      break;
+
+    case V_ACPI_IO_PM1_CNT_S3:
+      Context->Sx.Type = SxS3;
+      break;
+
+    case V_ACPI_IO_PM1_CNT_S4:
+      Context->Sx.Type = SxS4;
+      break;
+
+    case V_ACPI_IO_PM1_CNT_S5:
+      Context->Sx.Type = SxS5;
+      break;
+
+    default:
+      ASSERT (FALSE);
+      break;
+  }
+}
+
+/**
+  Check whether sleep type of two contexts match
+
+  @param[in] Context1             Context 1 that includes sleep type 1
+  @param[in] Context2             Context 2 that includes sleep type 2
+
+  @retval FALSE                   Sleep types match
+  @retval TRUE                    Sleep types don't match
+**/
+BOOLEAN
+EFIAPI
+SxCmpContext (
+  IN PCH_SMM_CONTEXT     *Context1,
+  IN PCH_SMM_CONTEXT     *Context2
+  )
+{
+  return (BOOLEAN) (Context1->Sx.Type == Context2->Sx.Type);
+}
+
+/**
+  For each PCIE RP clear PME SCI status and disable SCI, then PCIEXP_WAKE_STS from PMC.
+  This prevents platform from waking more than one time due to a single PCIE wake event.
+  Normally it's up to OS to clear SCI statuses. But in a scenario where platform wakes
+  and goes to S5 instead of booting to OS, the SCI status would remain set and would trigger another wake.
+**/
+VOID
+ClearPcieSci (
+  VOID
+  )
+{
+  UINT32 MaxPorts;
+  UINT32 RpIndex;
+  UINT64 RpBase;
+
+  MaxPorts = GetPchMaxPciePortNum ();
+  for (RpIndex = 0; RpIndex < MaxPorts; RpIndex++) {
+    RpBase = PchPcieRpPciCfgBase (RpIndex);
+  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) != 0xFFFF) {
+      PciSegmentAnd8 ((RpBase + R_PCH_PCIE_CFG_MPC + 3), (UINT8)~((UINT8)(B_PCH_PCIE_CFG_MPC_PMCE >> 24)));
+      PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_SMSCS, B_PCH_PCIE_CFG_SMSCS_PMCS);
+    }
+  }
+  IoWrite16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS, B_ACPI_IO_PM1_STS_PCIEXP_WAKE_STS);
+}
+
+
+/**
+  When we get an SMI that indicates that we are transitioning to a sleep state,
+  we need to actually transition to that state.  We do this by disabling the
+  "SMI on sleep enable" feature, which generates an SMI when the operating system
+  tries to put the system to sleep, and then physically putting the system to sleep.
+
+
+**/
+VOID
+PchSmmSxGoToSleep (
+  VOID
+  )
+{
+  UINT32      Pm1Cnt;
+
+  ClearPcieSci ();
+
+  ///
+  /// Disable SMIs
+  ///
+  PchSmmClearSource (&mSxSourceDesc);
+  PchSmmDisableSource (&mSxSourceDesc);
+
+  ///
+  /// Get Power Management 1 Control Register Value
+  ///
+  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
+
+  ///
+  /// Record S3 suspend performance data
+  ///
+  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) == V_ACPI_IO_PM1_CNT_S3) {
+    ///
+    /// Report status code before goto S3 sleep
+    ///
+    REPORT_STATUS_CODE (EFI_PROGRESS_CODE, PROGRESS_CODE_S3_SUSPEND_END);
+    mS3SusStart = FALSE;
+    ///
+    /// Write back cache into memory and invalidate cache before going to sleep.
+    ///
+    AsmWbinvd ();
+  }
+
+  ///
+  /// Now that SMIs are disabled, write to the SLP_EN bit again to trigger the sleep
+  ///
+  Pm1Cnt |= B_ACPI_IO_PM1_CNT_SLP_EN;
+
+  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT), Pm1Cnt);
+
+  ///
+  /// Should only proceed if wake event is generated.
+  ///
+  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) == V_ACPI_IO_PM1_CNT_S1) {
+    while (((IoRead16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS))) & B_ACPI_IO_PM1_STS_WAK) == 0x0);
+  } else {
+    CpuDeadLoop ();
+  }
+  ///
+  /// The system just went to sleep. If the sleep state was S1, then code execution will resume
+  /// here when the system wakes up.
+  ///
+  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
+
+  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) == 0) {
+    ///
+    /// An ACPI OS isn't present, clear the sleep information
+    ///
+    Pm1Cnt &= ~B_ACPI_IO_PM1_CNT_SLP_TYP;
+    Pm1Cnt |= V_ACPI_IO_PM1_CNT_S0;
+
+    IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT), Pm1Cnt);
+  }
+
+  PchSmmClearSource (&mSxSourceDesc);
+  PchSmmEnableSource (&mSxSourceDesc);
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb.c
new file mode 100644
index 0000000000..a0c67bd959
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb.c
@@ -0,0 +1,230 @@
+/** @file
+  File to contain all the hardware specific stuff for the Smm USB dispatch protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Register/UsbRegs.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/PmcRegs.h>
+#include <Library/PchPciBdfLib.h>
+#include <PchBdfAssignment.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mUsb1Legacy = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_LEGACY_USB
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_LEGACY_USB
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_LEGACY_USB
+  }
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC mUsb3Legacy = {
+  PCH_SMM_NO_FLAGS,
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_EN}
+      },
+      S_ACPI_IO_SMI_EN,
+      N_ACPI_IO_SMI_EN_LEGACY_USB3
+    },
+    NULL_BIT_DESC_INITIALIZER
+  },
+  {
+    {
+      {
+        ACPI_ADDR_TYPE,
+        {R_ACPI_IO_SMI_STS}
+      },
+      S_ACPI_IO_SMI_STS,
+      N_ACPI_IO_SMI_STS_LEGACY_USB3
+    }
+  },
+  {
+    {
+      ACPI_ADDR_TYPE,
+      {R_ACPI_IO_SMI_STS}
+    },
+    S_ACPI_IO_SMI_STS,
+    N_ACPI_IO_SMI_STS_LEGACY_USB3
+  }
+};
+
+typedef enum {
+  PchUsbControllerLpc0    = 0,
+  PchUsbControllerXhci,
+  PchUsbControllerTypeMax
+} PCH_USB_CONTROLLER_TYPE;
+
+typedef struct {
+  UINT8                   Function;
+  UINT8                   Device;
+  PCH_USB_CONTROLLER_TYPE UsbConType;
+} USB_CONTROLLER;
+
+GLOBAL_REMOVE_IF_UNREFERENCED USB_CONTROLLER  mUsbControllersMap[] = {
+  {
+    PCI_FUNCTION_NUMBER_PCH_LPC,
+    PCI_DEVICE_NUMBER_PCH_LPC,
+    PchUsbControllerLpc0
+  },
+  {
+    PCI_FUNCTION_NUMBER_PCH_XHCI,
+    PCI_DEVICE_NUMBER_PCH_XHCI,
+    PchUsbControllerXhci
+  }
+};
+
+/**
+  Find the handle that best matches the input Device Path and return the USB controller type
+
+  @param[in] DevicePath           Pointer to the device Path table
+  @param[out] Controller          Returned with the USB controller type of the input device path
+
+  @retval EFI_SUCCESS             Find the handle that best matches the input Device Path
+  @exception EFI_UNSUPPORTED      Invalid device Path table or can't find any match USB device path
+                                  PCH_USB_CONTROLLER_TYPE The USB controller type of the input
+                                  device path
+**/
+EFI_STATUS
+DevicePathToSupportedController (
+  IN  EFI_DEVICE_PATH_PROTOCOL   *DevicePath,
+  OUT PCH_USB_CONTROLLER_TYPE    *Controller
+  )
+{
+  EFI_STATUS                Status;
+  EFI_HANDLE                DeviceHandle;
+  ACPI_HID_DEVICE_PATH      *AcpiNode;
+  PCI_DEVICE_PATH           *PciNode;
+  EFI_DEVICE_PATH_PROTOCOL  *RemaingDevicePath;
+  UINT8                     UsbIndex;
+  ///
+  /// Find the handle that best matches the Device Path. If it is only a
+  /// partial match the remaining part of the device path is returned in
+  /// RemainingDevicePath.
+  ///
+  RemaingDevicePath = DevicePath;
+  Status = gBS->LocateDevicePath (
+                  &gEfiPciRootBridgeIoProtocolGuid,
+                  &DevicePath,
+                  &DeviceHandle
+                  );
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  DevicePath = RemaingDevicePath;
+
+  ///
+  /// Get first node: Acpi Node
+  ///
+  AcpiNode = (ACPI_HID_DEVICE_PATH *) RemaingDevicePath;
+
+  if (AcpiNode->Header.Type != ACPI_DEVICE_PATH ||
+      AcpiNode->Header.SubType != ACPI_DP ||
+      DevicePathNodeLength (&AcpiNode->Header) != sizeof (ACPI_HID_DEVICE_PATH) ||
+      AcpiNode->HID != EISA_PNP_ID (0x0A03) ||
+      AcpiNode->UID != 0
+      ) {
+    return EFI_UNSUPPORTED;
+  } else {
+    ///
+    /// Get the next node: Pci Node
+    ///
+    RemaingDevicePath = NextDevicePathNode (RemaingDevicePath);
+    PciNode           = (PCI_DEVICE_PATH *) RemaingDevicePath;
+    if (PciNode->Header.Type != HARDWARE_DEVICE_PATH ||
+        PciNode->Header.SubType != HW_PCI_DP ||
+        DevicePathNodeLength (&PciNode->Header) != sizeof (PCI_DEVICE_PATH)
+        ) {
+      return EFI_UNSUPPORTED;
+    }
+
+    for (UsbIndex = 0; UsbIndex < sizeof (mUsbControllersMap) / sizeof (USB_CONTROLLER); UsbIndex++) {
+      if ((PciNode->Device == mUsbControllersMap[UsbIndex].Device) &&
+          (PciNode->Function == mUsbControllersMap[UsbIndex].Function)) {
+        *Controller = mUsbControllersMap[UsbIndex].UsbConType;
+        return EFI_SUCCESS;
+      }
+    }
+
+    return EFI_UNSUPPORTED;
+  }
+}
+
+/**
+  Maps a USB context to a source description.
+
+  @param[in] Context              The context we need to map.  Type must be USB.
+  @param[in] SrcDesc              The source description that corresponds to the given context.
+
+**/
+VOID
+MapUsbToSrcDesc (
+  IN  PCH_SMM_CONTEXT         *Context,
+  OUT PCH_SMM_SOURCE_DESC     *SrcDesc
+  )
+{
+  PCH_USB_CONTROLLER_TYPE Controller;
+  EFI_STATUS              Status;
+
+  Status = DevicePathToSupportedController (Context->Usb.Device, &Controller);
+  ///
+  /// Either the device path passed in by the child is incorrect or
+  /// the ones stored here internally are incorrect.
+  ///
+  ASSERT_EFI_ERROR (Status);
+
+  switch (Context->Usb.Type) {
+    case UsbLegacy:
+      switch (Controller) {
+        case PchUsbControllerLpc0:
+          CopyMem ((VOID *) SrcDesc, (VOID *) (&mUsb1Legacy), sizeof (PCH_SMM_SOURCE_DESC));
+          break;
+
+        case PchUsbControllerXhci:
+          CopyMem ((VOID *) SrcDesc, (VOID *) (&mUsb3Legacy), sizeof (PCH_SMM_SOURCE_DESC));
+          break;
+
+        default:
+          ASSERT (FALSE);
+          break;
+      }
+      break;
+
+    case UsbWake:
+      ASSERT (FALSE);
+      break;
+
+    default:
+      ASSERT (FALSE);
+      break;
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.c
new file mode 100644
index 0000000000..a0b7e37d46
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.c
@@ -0,0 +1,778 @@
+/** @file
+  This driver is responsible for the registration of child drivers
+  and the abstraction of the PCH SMI sources.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "PchSmmHelpers.h"
+#include <Register/PchRegs.h>
+#include <Register/PmcRegs.h>
+
+//
+// Help handle porting bit shifts to IA-64.
+//
+#define BIT_ZERO  0x00000001
+
+/**
+  Publish SMI Dispatch protocols.
+
+
+**/
+VOID
+PchSmmPublishDispatchProtocols (
+  VOID
+  )
+{
+  EFI_STATUS Status = EFI_SUCCESS;
+  UINTN      Index;
+  //
+  // Install protocol interfaces.
+  //
+  for (Index = 0; Index < PCH_SMM_PROTOCOL_TYPE_MAX; Index++) {
+    Status = gSmst->SmmInstallProtocolInterface (
+                      &mPrivateData.InstallMultProtHandle,
+                      mPrivateData.Protocols[Index].Guid,
+                      EFI_NATIVE_INTERFACE,
+                      &mPrivateData.Protocols[Index].Protocols.Generic
+                      );
+  }
+  ASSERT_EFI_ERROR (Status);
+}
+
+/**
+  Initialize bits that aren't necessarily related to an SMI source.
+
+
+  @retval EFI_SUCCESS             SMI source initialization completed.
+  @retval Asserts                 Global Smi Bit is not enabled successfully.
+**/
+EFI_STATUS
+PchSmmInitHardware (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Clear all SMIs
+  //
+  PchSmmClearSmi ();
+
+  Status = PchSmmEnableGlobalSmiBit ();
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Be *really* sure to clear all SMIs
+  //
+  PchSmmClearSmi ();
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Enables the PCH to generate SMIs. Note that no SMIs will be generated
+  if no SMI sources are enabled. Conversely, no enabled SMI source will
+  generate SMIs if SMIs are not globally enabled. This is the main
+  switchbox for SMI generation.
+
+
+  @retval EFI_SUCCESS             Enable Global Smi Bit completed
+**/
+EFI_STATUS
+PchSmmEnableGlobalSmiBit (
+  VOID
+  )
+{
+  UINT32  SmiEn;
+
+  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
+
+  //
+  // Set the "global smi enable" bit
+  //
+  SmiEn |= B_ACPI_IO_SMI_EN_GBL_SMI;
+
+  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN), SmiEn);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Clears the SMI after all SMI source have been processed.
+  Note that this function will not work correctly (as it is
+  written) unless all SMI sources have been processed.
+  A revision of this function could manually clear all SMI
+  status bits to guarantee success.
+
+
+  @retval EFI_SUCCESS             Clears the SMIs completed
+  @retval Asserts                 EOS was not set to a 1
+**/
+EFI_STATUS
+PchSmmClearSmi (
+  VOID
+  )
+{
+  BOOLEAN     EosSet;
+  BOOLEAN     SciEn;
+  UINT32      Pm1Cnt;
+  UINT16      Pm1Sts;
+  UINT32      Gpe0Sts;
+  UINT32      SmiSts;
+  UINT16      DevActSts;
+  UINT16      Tco1Sts;
+
+  Gpe0Sts      = 0;
+  //
+  // Determine whether an ACPI OS is present (via the SCI_EN bit)
+  //
+  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
+  SciEn  = (BOOLEAN) ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) == B_ACPI_IO_PM1_CNT_SCI_EN);
+  if (!SciEn) {
+    //
+    // Clear any SMIs that double as SCIs (when SCI_EN==0)
+    //
+    Pm1Sts   = IoRead16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS));
+    Gpe0Sts  = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96));
+
+    Pm1Sts |=
+    (
+      B_ACPI_IO_PM1_STS_WAK |
+      B_ACPI_IO_PM1_STS_PRBTNOR |
+      B_ACPI_IO_PM1_STS_RTC |
+      B_ACPI_IO_PM1_STS_PWRBTN |
+      B_ACPI_IO_PM1_STS_GBL |
+      B_ACPI_IO_PM1_STS_TMROF
+      );
+
+    Gpe0Sts |=
+    (
+      B_ACPI_IO_GPE0_STS_127_96_WADT |
+      B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS |
+      B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE |
+      B_ACPI_IO_GPE0_STS_127_96_PME_B0 |
+      B_ACPI_IO_GPE0_STS_127_96_PME |
+      B_ACPI_IO_GPE0_STS_127_96_BATLOW |
+      B_ACPI_IO_GPE0_STS_127_96_RI |
+      B_ACPI_IO_GPE0_STS_127_96_SWGPE
+      );
+
+    IoWrite16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS), (UINT16) Pm1Sts);
+    IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96), (UINT32) Gpe0Sts);
+  }
+  //
+  // Clear all SMIs that are unaffected by SCI_EN
+  //
+  SmiSts        = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_STS));
+  DevActSts     = IoRead16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_DEVACT_STS));
+  Tco1Sts       = IoRead16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO1_STS));
+
+  SmiSts |=
+  (
+    B_ACPI_IO_SMI_STS_SMBUS |
+    B_ACPI_IO_SMI_STS_PERIODIC |
+    B_ACPI_IO_SMI_STS_TCO |
+    B_ACPI_IO_SMI_STS_MCSMI |
+    B_ACPI_IO_SMI_STS_SWSMI_TMR |
+    B_ACPI_IO_SMI_STS_APM |
+    B_ACPI_IO_SMI_STS_ON_SLP_EN |
+    B_ACPI_IO_SMI_STS_BIOS
+    );
+  DevActSts |=
+  (
+    B_ACPI_IO_DEVACT_STS_KBC |
+    B_ACPI_IO_DEVACT_STS_PIRQDH |
+    B_ACPI_IO_DEVACT_STS_PIRQCG |
+    B_ACPI_IO_DEVACT_STS_PIRQBF |
+    B_ACPI_IO_DEVACT_STS_PIRQAE
+    );
+  Tco1Sts |=
+  (
+    B_TCO_IO_TCO1_STS_DMISERR |
+    B_TCO_IO_TCO1_STS_DMISMI |
+    B_TCO_IO_TCO1_STS_DMISCI |
+    B_TCO_IO_TCO1_STS_BIOSWR |
+    B_TCO_IO_TCO1_STS_NEWCENTURY |
+    B_TCO_IO_TCO1_STS_TIMEOUT |
+    B_TCO_IO_TCO1_STS_TCO_INT |
+    B_TCO_IO_TCO1_STS_SW_TCO_SMI
+    );
+
+  GpioClearAllGpiSmiSts ();
+
+  IoWrite16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO1_STS), Tco1Sts);
+
+  //
+  // We do not want to write 1 to clear INTRD_DET bit.
+  //
+  IoWrite16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO2_STS), (UINT16) ~B_TCO_IO_TCO2_STS_INTRD_DET);
+
+  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_STS), SmiSts);
+
+  IoWrite16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_DEVACT_STS), DevActSts);
+
+  //
+  // Try to clear the EOS bit. ASSERT on an error
+  //
+  EosSet = PchSmmSetAndCheckEos ();
+  ASSERT (EosSet);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Set the SMI EOS bit after all SMI source have been processed.
+
+
+  @retval FALSE                   EOS was not set to a 1; this is an error
+  @retval TRUE                    EOS was correctly set to a 1
+**/
+BOOLEAN
+PchSmmSetAndCheckEos (
+  VOID
+  )
+{
+  UINT32  SmiEn;
+
+  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
+
+  //
+  // Reset the PCH to generate subsequent SMIs
+  //
+  SmiEn |= B_ACPI_IO_SMI_EN_EOS;
+
+  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN), SmiEn);
+
+  //
+  // Double check that the assert worked
+  //
+  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
+
+  //
+  // Return TRUE if EOS is set correctly
+  //
+  if ((SmiEn & B_ACPI_IO_SMI_EN_EOS) == 0) {
+    //
+    // EOS was not set to a 1; this is an error
+    //
+    return FALSE;
+  } else {
+    //
+    // EOS was correctly set to a 1
+    //
+    return TRUE;
+  }
+}
+
+/**
+  Determine whether an ACPI OS is present (via the SCI_EN bit)
+
+
+  @retval TRUE                    ACPI OS is present
+  @retval FALSE                   ACPI OS is not present
+**/
+BOOLEAN
+PchSmmGetSciEn (
+  VOID
+  )
+{
+  BOOLEAN SciEn;
+  UINT32  Pm1Cnt;
+
+  //
+  // Determine whether an ACPI OS is present (via the SCI_EN bit)
+  //
+  Pm1Cnt  = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
+  SciEn   = (BOOLEAN) ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) == B_ACPI_IO_PM1_CNT_SCI_EN);
+
+  return SciEn;
+}
+
+/**
+  Read a specifying bit with the register
+  These may or may not need to change w/ the PCH version; they're highly IA-32 dependent, though.
+
+  @param[in] BitDesc              The struct that includes register address, size in byte and bit number
+
+  @retval TRUE                    The bit is enabled
+  @retval FALSE                   The bit is disabled
+**/
+BOOLEAN
+ReadBitDesc (
+  CONST PCH_SMM_BIT_DESC  *BitDesc
+  )
+{
+  EFI_STATUS  Status;
+  UINT64      Register;
+  UINT32      PciBus;
+  UINT32      PciDev;
+  UINT32      PciFun;
+  UINT32      PciReg;
+  UINTN       RegSize;
+  BOOLEAN     BitWasOne;
+  UINTN       ShiftCount;
+  UINTN       RegisterOffset;
+  UINT32      BaseAddr;
+  UINT64      PciBaseAddress;
+
+  ASSERT (BitDesc != NULL);
+  ASSERT (!IS_BIT_DESC_NULL (*BitDesc));
+
+  RegSize     = 0;
+  Register    = 0;
+  ShiftCount  = 0;
+  BitWasOne   = FALSE;
+
+  switch (BitDesc->Reg.Type) {
+
+    case ACPI_ADDR_TYPE:
+    case TCO_ADDR_TYPE:
+      if (BitDesc->Reg.Type == ACPI_ADDR_TYPE) {
+        RegisterOffset  = BitDesc->Reg.Data.acpi;
+        BaseAddr        = mAcpiBaseAddr;
+      } else {
+        RegisterOffset  = BitDesc->Reg.Data.tco;
+        BaseAddr        = mTcoBaseAddr;
+      }
+      switch (BitDesc->SizeInBytes) {
+
+        case 0:
+          //
+          // Chances are that this field didn't get initialized.
+          // Check your assignments to bit descriptions.
+          //
+          ASSERT (FALSE);
+          break;
+
+        case 1:
+          RegSize = SMM_IO_UINT8;
+          break;
+
+        case 2:
+          RegSize = SMM_IO_UINT16;
+          break;
+
+        case 4:
+          RegSize = SMM_IO_UINT32;
+          break;
+
+        case 8:
+          RegSize = SMM_IO_UINT64;
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+      //
+      // Double check that we correctly read in the acpi base address
+      //
+      ASSERT ((BaseAddr != 0x0) && ((BaseAddr & 0x1) != 0x1));
+
+      ShiftCount      = BitDesc->Bit;
+      //
+      // As current CPU Smm Io can only support at most
+      // 32-bit read/write,if Operation is 64 bit,
+      // we do a 32 bit operation according to BitDesc->Bit
+      //
+      if (RegSize == SMM_IO_UINT64) {
+        RegSize = SMM_IO_UINT32;
+        //
+        // If the operation is for high 32 bits
+        //
+        if (BitDesc->Bit >= 32) {
+          RegisterOffset += 4;
+          ShiftCount -= 32;
+        }
+      }
+
+      Status = gSmst->SmmIo.Io.Read (
+                                 &gSmst->SmmIo,
+                                 RegSize,
+                                 BaseAddr + RegisterOffset,
+                                 1,
+                                 &Register
+                                 );
+      ASSERT_EFI_ERROR (Status);
+
+      if ((Register & (LShiftU64 (BIT_ZERO, ShiftCount))) != 0) {
+        BitWasOne = TRUE;
+      } else {
+        BitWasOne = FALSE;
+      }
+      break;
+
+    case GPIO_ADDR_TYPE:
+    case MEMORY_MAPPED_IO_ADDRESS_TYPE:
+      //
+      // Read the register, and it with the bit to read
+      //
+      switch (BitDesc->SizeInBytes) {
+        case 1:
+          Register = (UINT64) MmioRead8 ((UINTN) BitDesc->Reg.Data.Mmio);
+          break;
+
+        case 2:
+          Register = (UINT64) MmioRead16 ((UINTN) BitDesc->Reg.Data.Mmio);
+          break;
+
+        case 4:
+          Register = (UINT64) MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio);
+          break;
+
+        case 8:
+          Register                      = (UINT64) MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio);
+          *((UINT32 *) (&Register) + 1) = MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio + 4);
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+
+      Register = Register & (LShiftU64 (BIT0, BitDesc->Bit));
+      if (Register) {
+        BitWasOne = TRUE;
+      } else {
+        BitWasOne = FALSE;
+      }
+      break;
+
+    case PCIE_ADDR_TYPE:
+      PciBus  = BitDesc->Reg.Data.pcie.Fields.Bus;
+      PciDev  = BitDesc->Reg.Data.pcie.Fields.Dev;
+      PciFun  = BitDesc->Reg.Data.pcie.Fields.Fnc;
+      PciReg  = BitDesc->Reg.Data.pcie.Fields.Reg;
+      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
+      switch (BitDesc->SizeInBytes) {
+
+        case 0:
+          //
+          // Chances are that this field didn't get initialized.
+          // Check your assignments to bit descriptions.
+          //
+          ASSERT (FALSE);
+          break;
+
+        case 1:
+          Register = (UINT64) PciSegmentRead8 (PciBaseAddress + PciReg);
+          break;
+
+        case 2:
+          Register = (UINT64) PciSegmentRead16 (PciBaseAddress + PciReg);
+          break;
+
+        case 4:
+          Register = (UINT64) PciSegmentRead32 (PciBaseAddress + PciReg);
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+
+      if ((Register & (LShiftU64 (BIT_ZERO, BitDesc->Bit))) != 0) {
+        BitWasOne = TRUE;
+      } else {
+        BitWasOne = FALSE;
+      }
+      break;
+
+    case PCR_ADDR_TYPE:
+      //
+      // Read the register, and it with the bit to read
+      //
+      switch (BitDesc->SizeInBytes) {
+        case 1:
+          Register = PchPcrRead8  (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc->Reg.Data.Pcr.Fields.Offset);
+          break;
+
+        case 2:
+          Register = PchPcrRead16 (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc->Reg.Data.Pcr.Fields.Offset);
+          break;
+
+        case 4:
+          Register = PchPcrRead32 (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc->Reg.Data.Pcr.Fields.Offset);
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+
+      Register = Register & (LShiftU64 (BIT0, BitDesc->Bit));
+      if (Register) {
+        BitWasOne = TRUE;
+      } else {
+        BitWasOne = FALSE;
+      }
+      break;
+
+    default:
+      //
+      // This address type is not yet implemented
+      //
+      ASSERT (FALSE);
+      break;
+  }
+
+  return BitWasOne;
+}
+
+/**
+  Write a specifying bit with the register
+
+  @param[in] BitDesc              The struct that includes register address, size in byte and bit number
+  @param[in] ValueToWrite         The value to be wrote
+  @param[in] WriteClear           If the rest bits of the register is write clear
+
+**/
+VOID
+WriteBitDesc (
+  CONST PCH_SMM_BIT_DESC  *BitDesc,
+  CONST BOOLEAN           ValueToWrite,
+  CONST BOOLEAN           WriteClear
+  )
+{
+  EFI_STATUS  Status;
+  UINT64      Register;
+  UINT64      AndVal;
+  UINT64      OrVal;
+  UINT32      RegSize;
+  UINT32      PciBus;
+  UINT32      PciDev;
+  UINT32      PciFun;
+  UINT32      PciReg;
+  UINTN       RegisterOffset;
+  UINT32      BaseAddr;
+  UINT64      PciBaseAddress;
+
+  ASSERT (BitDesc != NULL);
+  ASSERT (!IS_BIT_DESC_NULL (*BitDesc));
+
+  RegSize   = 0;
+  Register  = 0;
+
+  if (WriteClear) {
+    AndVal = LShiftU64 (BIT_ZERO, BitDesc->Bit);
+  } else {
+    AndVal = ~(LShiftU64 (BIT_ZERO, BitDesc->Bit));
+  }
+
+  OrVal = (LShiftU64 ((UINT32) ValueToWrite, BitDesc->Bit));
+
+  switch (BitDesc->Reg.Type) {
+
+    case ACPI_ADDR_TYPE:
+    case TCO_ADDR_TYPE:
+      if (BitDesc->Reg.Type == ACPI_ADDR_TYPE) {
+        RegisterOffset  = BitDesc->Reg.Data.acpi;
+        BaseAddr        = mAcpiBaseAddr;
+      } else {
+        RegisterOffset  = BitDesc->Reg.Data.tco;
+        BaseAddr        = mTcoBaseAddr;
+      }
+
+      switch (BitDesc->SizeInBytes) {
+
+        case 0:
+          //
+          // Chances are that this field didn't get initialized.
+          // Check your assignments to bit descriptions.
+          //
+          ASSERT (FALSE);
+          break;
+
+        case 1:
+          RegSize = SMM_IO_UINT8;
+          break;
+
+        case 2:
+          RegSize = SMM_IO_UINT16;
+          break;
+
+        case 4:
+          RegSize = SMM_IO_UINT32;
+          break;
+
+        case 8:
+          RegSize = SMM_IO_UINT64;
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+      //
+      // Double check that we correctly read in the acpi base address
+      //
+      ASSERT ((BaseAddr != 0x0) && ((BaseAddr & 0x1) != 0x1));
+
+      //
+      // As current CPU Smm Io can only support at most
+      // 32-bit read/write,if Operation is 64 bit,
+      // we do a 32 bit operation according to BitDesc->Bit
+      //
+      if (RegSize == SMM_IO_UINT64) {
+        RegSize = SMM_IO_UINT32;
+        //
+        // If the operation is for high 32 bits
+        //
+        if (BitDesc->Bit >= 32) {
+          RegisterOffset += 4;
+
+          if (WriteClear) {
+            AndVal = LShiftU64 (BIT_ZERO, BitDesc->Bit - 32);
+          } else {
+            AndVal = ~(LShiftU64 (BIT_ZERO, BitDesc->Bit - 32));
+          }
+
+          OrVal = LShiftU64 ((UINT32) ValueToWrite, BitDesc->Bit - 32);
+        }
+      }
+
+      Status = gSmst->SmmIo.Io.Read (
+                                 &gSmst->SmmIo,
+                                 RegSize,
+                                 BaseAddr + RegisterOffset,
+                                 1,
+                                 &Register
+                                 );
+      ASSERT_EFI_ERROR (Status);
+
+      Register &= AndVal;
+      Register |= OrVal;
+
+      Status = gSmst->SmmIo.Io.Write (
+                                 &gSmst->SmmIo,
+                                 RegSize,
+                                 BaseAddr + RegisterOffset,
+                                 1,
+                                 &Register
+                                 );
+      ASSERT_EFI_ERROR (Status);
+      break;
+
+    case GPIO_ADDR_TYPE:
+    case MEMORY_MAPPED_IO_ADDRESS_TYPE:
+      //
+      // Read the register, or it with the bit to set, then write it back.
+      //
+      switch (BitDesc->SizeInBytes) {
+        case 1:
+          MmioAndThenOr8  ((UINTN) BitDesc->Reg.Data.Mmio, (UINT8)  AndVal, (UINT8)  OrVal);
+          break;
+
+        case 2:
+          MmioAndThenOr16 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT16) AndVal, (UINT16) OrVal);
+          break;
+
+        case 4:
+          MmioAndThenOr32 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT32) AndVal, (UINT32) OrVal);
+          break;
+
+        case 8:
+          Register                      = (UINT64) MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio);
+          *((UINT32 *) (&Register) + 1) = MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio + 4);
+          Register &= AndVal;
+          Register |= OrVal;
+          MmioWrite32 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT32) Register);
+          MmioWrite32 ((UINTN) BitDesc->Reg.Data.Mmio + 4, *((UINT32 *) (&Register) + 1));
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+      break;
+
+    case PCIE_ADDR_TYPE:
+      PciBus  = BitDesc->Reg.Data.pcie.Fields.Bus;
+      PciDev  = BitDesc->Reg.Data.pcie.Fields.Dev;
+      PciFun  = BitDesc->Reg.Data.pcie.Fields.Fnc;
+      PciReg  = BitDesc->Reg.Data.pcie.Fields.Reg;
+      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
+      switch (BitDesc->SizeInBytes) {
+
+        case 0:
+          //
+          // Chances are that this field didn't get initialized -- check your assignments
+          // to bit descriptions.
+          //
+          ASSERT (FALSE);
+          break;
+
+        case 1:
+          PciSegmentAndThenOr8 (PciBaseAddress + PciReg, (UINT8) AndVal, (UINT8) OrVal);
+          break;
+
+        case 2:
+          PciSegmentAndThenOr16 (PciBaseAddress + PciReg, (UINT16) AndVal, (UINT16) OrVal);
+          break;
+
+        case 4:
+          PciSegmentAndThenOr32 (PciBaseAddress + PciReg, (UINT32) AndVal, (UINT32) OrVal);
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+      break;
+
+    case PCR_ADDR_TYPE:
+      //
+      // Read the register, or it with the bit to set, then write it back.
+      //
+      switch (BitDesc->SizeInBytes) {
+        case 1:
+          PchPcrAndThenOr8  ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid, (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT8)  AndVal, (UINT8)  OrVal);
+          break;
+
+        case 2:
+          PchPcrAndThenOr16 ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid, (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT16) AndVal, (UINT16) OrVal);
+          break;
+
+        case 4:
+          PchPcrAndThenOr32 ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid, (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT32) AndVal, (UINT32) OrVal);
+          break;
+
+        default:
+          //
+          // Unsupported or invalid register size
+          //
+          ASSERT (FALSE);
+          break;
+      }
+      break;
+
+    default:
+      //
+      // This address type is not yet implemented
+      //
+      ASSERT (FALSE);
+      break;
+  }
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.h
new file mode 100644
index 0000000000..6dd6f2027d
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelpers.h
@@ -0,0 +1,107 @@
+/** @file
+  This driver is responsible for the registration of child drivers
+  and the abstraction of the PCH SMI sources.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _PCHX_SMM_HELPERS_H_
+#define _PCHX_SMM_HELPERS_H_
+
+#include "PchSmm.h"
+
+/**
+  Initialize bits that aren't necessarily related to an SMI source.
+
+
+  @retval EFI_SUCCESS             SMI source initialization completed.
+  @retval Asserts                 Global Smi Bit is not enabled successfully.
+**/
+EFI_STATUS
+PchSmmInitHardware (
+  VOID
+  );
+
+/**
+  Enables the PCH to generate SMIs. Note that no SMIs will be generated
+  if no SMI sources are enabled. Conversely, no enabled SMI source will
+  generate SMIs if SMIs are not globally enabled. This is the main
+  switchbox for SMI generation.
+
+
+  @retval EFI_SUCCESS             Enable Global Smi Bit completed
+**/
+EFI_STATUS
+PchSmmEnableGlobalSmiBit (
+  VOID
+  );
+
+/**
+  Clears the SMI after all SMI source have been processed.
+  Note that this function will not work correctly (as it is
+  written) unless all SMI sources have been processed.
+  A revision of this function could manually clear all SMI
+  status bits to guarantee success.
+
+
+  @retval EFI_SUCCESS             Clears the SMIs completed
+  @retval Asserts                 EOS was not set to a 1
+**/
+EFI_STATUS
+PchSmmClearSmi (
+  VOID
+  );
+
+/**
+  Set the SMI EOS bit after all SMI source have been processed.
+
+
+  @retval FALSE                   EOS was not set to a 1; this is an error
+  @retval TRUE                    EOS was correctly set to a 1
+**/
+BOOLEAN
+PchSmmSetAndCheckEos (
+  VOID
+  );
+
+/**
+  Determine whether an ACPI OS is present (via the SCI_EN bit)
+
+
+  @retval TRUE                    ACPI OS is present
+  @retval FALSE                   ACPI OS is not present
+**/
+BOOLEAN
+PchSmmGetSciEn (
+  VOID
+  );
+
+/**
+  Read a specifying bit with the register
+
+  @param[in] BitDesc              The struct that includes register address, size in byte and bit number
+
+  @retval TRUE                    The bit is enabled
+  @retval FALSE                   The bit is disabled
+**/
+BOOLEAN
+ReadBitDesc (
+  CONST PCH_SMM_BIT_DESC *BitDesc
+  );
+
+/**
+  Write a specifying bit with the register
+
+  @param[in] BitDesc              The struct that includes register address, size in byte and bit number
+  @param[in] ValueToWrite         The value to be wrote
+  @param[in] WriteClear           If the rest bits of the register is write clear
+
+**/
+VOID
+WriteBitDesc (
+  CONST PCH_SMM_BIT_DESC  *BitDesc,
+  CONST BOOLEAN           ValueToWrite,
+  CONST BOOLEAN           WriteClear
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl.inf b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl.inf
new file mode 100644
index 0000000000..a142cfa95a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl.inf
@@ -0,0 +1,54 @@
+## @file
+# Component description file for SmmControl module
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = SmmControl
+FILE_GUID = A0BAD9F7-AB78-491b-B583-C52B7F84B9E0
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_RUNTIME_DRIVER
+ENTRY_POINT = SmmControlDriverEntryInit
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64
+#
+
+
+
+[LibraryClasses]
+IoLib
+UefiDriverEntryPoint
+DebugLib
+UefiBootServicesTableLib
+UefiRuntimeServicesTableLib
+PmcLib
+GpioLib
+
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+
+[Sources]
+SmmControlDriver.h
+SmmControlDriver.c
+
+
+[Protocols]
+gEfiSmmControl2ProtocolGuid ## PRODUCES
+
+
+[Guids]
+gEfiEventVirtualAddressChangeGuid
+
+
+[Depex]
+TRUE
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.c b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.c
new file mode 100644
index 0000000000..5822f42165
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.c
@@ -0,0 +1,394 @@
+/** @file
+  This is the driver that publishes the SMM Control Protocol.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/IoLib.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Guid/EventGroup.h>
+#include <Library/PmcLib.h>
+#include <Library/GpioLib.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/PchRegsLpc.h>
+#include <Register/SpiRegs.h>
+#include <Register/PmcRegs.h>
+#include "SmmControlDriver.h"
+
+STATIC SMM_CONTROL_PRIVATE_DATA mSmmControl;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                          mABase;
+
+VOID
+EFIAPI
+DisablePendingSmis (
+  VOID
+  );
+
+/**
+  Fixup internal data pointers so that the services can be called in virtual mode.
+
+  @param[in] Event                The event registered.
+  @param[in] Context              Event context.
+
+**/
+VOID
+EFIAPI
+SmmControlVirtualAddressChangeEvent (
+  IN EFI_EVENT                  Event,
+  IN VOID                       *Context
+  )
+{
+  gRT->ConvertPointer (0, (VOID *) &(mSmmControl.SmmControl.Trigger));
+  gRT->ConvertPointer (0, (VOID *) &(mSmmControl.SmmControl.Clear));
+}
+
+/**
+  <b>SmmControl DXE RUNTIME Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+    The SmmControl module is a DXE RUNTIME driver that provides a standard way
+    for other drivers to trigger software SMIs.
+
+  - @pre
+    - PCH Power Management I/O space base address has already been programmed.
+      If SmmControl Runtime DXE driver is run before Status Code Runtime Protocol
+      is installed and there is the need to use Status code in the driver, it will
+      be necessary to add EFI_STATUS_CODE_RUNTIME_PROTOCOL_GUID to the dependency file.
+    - EFI_SMM_BASE2_PROTOCOL
+      - Documented in the System Management Mode Core Interface Specification.
+
+  - @result
+    The SmmControl driver produces the EFI_SMM_CONTROL_PROTOCOL documented in
+    System Management Mode Core Interface Specification.
+
+  @param[in] ImageHandle          Handle for the image of this driver
+  @param[in] SystemTable          Pointer to the EFI System Table
+
+  @retval EFI_STATUS              Results of the installation of the SMM Control Protocol
+**/
+EFI_STATUS
+EFIAPI
+SmmControlDriverEntryInit (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+  EFI_EVENT   Event;
+
+  DEBUG ((DEBUG_INFO, "SmmControlDriverEntryInit() Start\n"));
+
+  //
+  // Get the Power Management I/O space base address. We assume that
+  // this base address has already been programmed if this driver is
+  // being run.
+  //
+  mABase = PmcGetAcpiBase ();
+
+  Status = EFI_SUCCESS;
+  if (mABase != 0) {
+    //
+    // Install the instance of the protocol
+    //
+    mSmmControl.Signature                       = SMM_CONTROL_PRIVATE_DATA_SIGNATURE;
+    mSmmControl.Handle                          = ImageHandle;
+
+    mSmmControl.SmmControl.Trigger              = Activate;
+    mSmmControl.SmmControl.Clear                = Deactivate;
+    mSmmControl.SmmControl.MinimumTriggerPeriod = 0;
+
+    //
+    // Install our protocol interfaces on the device's handle
+    //
+    Status = gBS->InstallMultipleProtocolInterfaces (
+                    &mSmmControl.Handle,
+                    &gEfiSmmControl2ProtocolGuid,
+                    &mSmmControl.SmmControl,
+                    NULL
+                    );
+  } else {
+    Status = EFI_DEVICE_ERROR;
+    return Status;
+  }
+
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  SmmControlVirtualAddressChangeEvent,
+                  NULL,
+                  &gEfiEventVirtualAddressChangeGuid,
+                  &Event
+                  );
+  //
+  // Disable any PCH SMIs that, for whatever reason, are asserted after the boot.
+  //
+  DisablePendingSmis ();
+
+  DEBUG ((DEBUG_INFO, "SmmControlDriverEntryInit() End\n"));
+
+  return Status;
+}
+
+/**
+  Trigger the software SMI
+
+  @param[in] Data                 The value to be set on the software SMI data port
+
+  @retval EFI_SUCCESS             Function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+SmmTrigger (
+  IN UINT8   Data
+  )
+{
+  UINT32  OutputData;
+  UINT32  OutputPort;
+
+  //
+  // Enable the APMC SMI
+  //
+  OutputPort  = mABase + R_ACPI_IO_SMI_EN;
+  OutputData  = IoRead32 ((UINTN) OutputPort);
+  OutputData |= (B_ACPI_IO_SMI_EN_APMC | B_ACPI_IO_SMI_EN_GBL_SMI);
+  DEBUG (
+    (DEBUG_VERBOSE,
+     "The SMI Control Port at address %x will be written to %x.\n",
+     OutputPort,
+     OutputData)
+    );
+  IoWrite32 (
+    (UINTN) OutputPort,
+    (UINT32) (OutputData)
+    );
+
+  OutputPort  = R_PCH_IO_APM_CNT;
+  OutputData  = Data;
+
+  //
+  // Generate the APMC SMI
+  //
+  IoWrite8 (
+    (UINTN) OutputPort,
+    (UINT8) (OutputData)
+    );
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Clear the SMI status
+
+
+  @retval EFI_SUCCESS             The function completes successfully
+  @retval EFI_DEVICE_ERROR        Something error occurred
+**/
+EFI_STATUS
+EFIAPI
+SmmClear (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+  UINT32      OutputData;
+  UINT32      OutputPort;
+
+  Status = EFI_SUCCESS;
+
+  //
+  // Clear the Power Button Override Status Bit, it gates EOS from being set.
+  //
+  OutputPort  = mABase + R_ACPI_IO_PM1_STS;
+  OutputData  = B_ACPI_IO_PM1_STS_PRBTNOR;
+  DEBUG (
+    (DEBUG_VERBOSE,
+     "The PM1 Status Port at address %x will be written to %x.\n",
+     OutputPort,
+     OutputData)
+    );
+  IoWrite16 (
+    (UINTN) OutputPort,
+    (UINT16) (OutputData)
+    );
+
+  //
+  // Clear the APM SMI Status Bit
+  //
+  OutputPort  = mABase + R_ACPI_IO_SMI_STS;
+  OutputData  = B_ACPI_IO_SMI_STS_APM;
+  DEBUG (
+    (DEBUG_VERBOSE,
+     "The SMI Status Port at address %x will be written to %x.\n",
+     OutputPort,
+     OutputData)
+    );
+  IoWrite32 (
+    (UINTN) OutputPort,
+    (UINT32) (OutputData)
+    );
+
+  //
+  // Set the EOS Bit
+  //
+  OutputPort  = mABase + R_ACPI_IO_SMI_EN;
+  OutputData  = IoRead32 ((UINTN) OutputPort);
+  OutputData |= B_ACPI_IO_SMI_EN_EOS;
+  DEBUG (
+    (DEBUG_VERBOSE,
+     "The SMI Control Port at address %x will be written to %x.\n",
+     OutputPort,
+     OutputData)
+    );
+  IoWrite32 (
+    (UINTN) OutputPort,
+    (UINT32) (OutputData)
+    );
+
+  //
+  // There is no need to read EOS back and check if it is set.
+  // This can lead to a reading of zero if an SMI occurs right after the SMI_EN port read
+  // but before the data is returned to the CPU.
+  // SMM Dispatcher should make sure that EOS is set after all SMI sources are processed.
+  //
+  return Status;
+}
+
+/**
+  This routine generates an SMI
+
+  @param[in] This                       The EFI SMM Control protocol instance
+  @param[in, out] CommandPort           The buffer contains data to the command port
+  @param[in, out] DataPort              The buffer contains data to the data port
+  @param[in] Periodic                   Periodic or not
+  @param[in] ActivationInterval         Interval of periodic SMI
+
+  @retval EFI Status                    Describing the result of the operation
+  @retval EFI_INVALID_PARAMETER         Some parameter value passed is not supported
+**/
+EFI_STATUS
+EFIAPI
+Activate (
+  IN CONST EFI_SMM_CONTROL2_PROTOCOL                    * This,
+  IN OUT  UINT8                                         *CommandPort       OPTIONAL,
+  IN OUT  UINT8                                         *DataPort          OPTIONAL,
+  IN      BOOLEAN                                       Periodic           OPTIONAL,
+  IN      UINTN                                         ActivationInterval OPTIONAL
+  )
+{
+  EFI_STATUS  Status;
+  UINT8       Data;
+
+  if (Periodic) {
+    DEBUG ((DEBUG_WARN, "Invalid parameter\n"));
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (CommandPort == NULL) {
+    Data = 0xFF;
+  } else {
+    Data = *CommandPort;
+  }
+  //
+  // Clear any pending the APM SMI
+  //
+  Status = SmmClear ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  return SmmTrigger (Data);
+}
+
+/**
+  This routine clears an SMI
+
+  @param[in] This                 The EFI SMM Control protocol instance
+  @param[in] Periodic             Periodic or not
+
+  @retval EFI Status              Describing the result of the operation
+  @retval EFI_INVALID_PARAMETER   Some parameter value passed is not supported
+**/
+EFI_STATUS
+EFIAPI
+Deactivate (
+  IN CONST EFI_SMM_CONTROL2_PROTOCOL       *This,
+  IN  BOOLEAN                              Periodic OPTIONAL
+  )
+{
+  if (Periodic) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return SmmClear ();
+}
+/**
+  Disable all pending SMIs
+
+**/
+VOID
+EFIAPI
+DisablePendingSmis (
+  VOID
+  )
+{
+  UINT32               Data;
+  BOOLEAN              SciEn;
+
+  //
+  // Determine whether an ACPI OS is present (via the SCI_EN bit)
+  //
+  Data      = IoRead16 ((UINTN) mABase + R_ACPI_IO_PM1_CNT);
+  SciEn     = (BOOLEAN) ((Data & B_ACPI_IO_PM1_CNT_SCI_EN) == B_ACPI_IO_PM1_CNT_SCI_EN);
+
+  if (!SciEn) {
+    //
+    // Clear any SMIs that double as SCIs (when SCI_EN==0)
+    //
+    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_STS, 0xFFFF);
+    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_EN, 0);
+    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_CNT, 0);
+    IoWrite32 (
+      (UINTN) mABase + R_ACPI_IO_GPE0_STS_127_96,
+      (UINT32)( B_ACPI_IO_GPE0_STS_127_96_WADT |
+                B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS |
+                B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE |
+                B_ACPI_IO_GPE0_STS_127_96_PME_B0 |
+                B_ACPI_IO_GPE0_STS_127_96_PME |
+                B_ACPI_IO_GPE0_STS_127_96_BATLOW |
+                B_ACPI_IO_GPE0_STS_127_96_RI |
+                B_ACPI_IO_GPE0_STS_127_96_SWGPE)
+      );
+    IoWrite32 ((UINTN) mABase + R_ACPI_IO_GPE0_EN_127_96, (UINT32) B_ACPI_IO_GPE0_EN_127_96_WADT);
+  }
+  //
+  // Clear and disable all SMIs that are unaffected by SCI_EN
+  //
+  GpioDisableAllGpiSmi ();
+
+  GpioClearAllGpiSmiSts ();
+
+  IoWrite32 ((UINTN) mABase + R_ACPI_IO_DEVACT_STS, 0x0000FFFF);
+
+  IoWrite32 ((UINTN) mABase + R_ACPI_IO_SMI_STS, ~0u);
+
+  //
+  // (Make sure to write this register last -- EOS re-enables SMIs for the PCH)
+  //
+  Data  = IoRead32 ((UINTN) mABase + R_ACPI_IO_SMI_EN);
+  //
+  // clear all bits except those tied to SCI_EN
+  //
+  Data &= B_ACPI_IO_SMI_EN_BIOS_RLS;
+  //
+  // enable SMIs and specifically enable writes to APM_CNT.
+  //
+  Data |= B_ACPI_IO_SMI_EN_GBL_SMI | B_ACPI_IO_SMI_EN_APMC;
+  //
+  //  NOTE: Default value of EOS is set in PCH, it will be automatically cleared Once the PCH asserts SMI# low,
+  //  we don't need to do anything to clear it
+  //
+  IoWrite32 ((UINTN) mABase + R_ACPI_IO_SMI_EN, Data);
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.h b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.h
new file mode 100644
index 0000000000..af368e6945
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControlDriver.h
@@ -0,0 +1,130 @@
+/** @file
+  Header file for SMM Control Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SMM_CONTROL_DRIVER_H_
+#define _SMM_CONTROL_DRIVER_H_
+
+#include <Protocol/SmmControl2.h>
+
+
+#define SMM_CONTROL_PRIVATE_DATA_SIGNATURE  SIGNATURE_32 ('i', '4', 's', 'c')
+
+typedef struct {
+  UINTN                           Signature;
+  EFI_HANDLE                      Handle;
+  EFI_SMM_CONTROL2_PROTOCOL       SmmControl;
+} SMM_CONTROL_PRIVATE_DATA;
+
+#define SMM_CONTROL_PRIVATE_DATA_FROM_THIS(a) CR (a, SMM_CONTROL_PRIVATE_DATA, SmmControl, SMM_CONTROL_DEV_SIGNATURE)
+
+//
+// Prototypes
+//
+
+/**
+  <b>SmmControl DXE RUNTIME Module Entry Point</b>\n
+  - <b>Introduction</b>\n
+    The SmmControl module is a DXE RUNTIME driver that provides a standard way
+    for other drivers to trigger software SMIs.
+
+  - @pre
+    - PCH Power Management I/O space base address has already been programmed.
+      If SmmControl Runtime DXE driver is run before Status Code Runtime Protocol
+      is installed and there is the need to use Status code in the driver, it will
+      be necessary to add EFI_STATUS_CODE_RUNTIME_PROTOCOL_GUID to the dependency file.
+    - EFI_SMM_BASE2_PROTOCOL
+      - Documented in the System Management Mode Core Interface Specification.
+
+  - @result
+    The SmmControl driver produces the EFI_SMM_CONTROL_PROTOCOL documented in
+    System Management Mode Core Interface Specification.
+
+  @param[in] ImageHandle          Handle for the image of this driver
+  @param[in] SystemTable          Pointer to the EFI System Table
+
+  @retval EFI_STATUS              Results of the installation of the SMM Control Protocol
+**/
+EFI_STATUS
+EFIAPI
+SmmControlDriverEntryInit (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  );
+
+/**
+  Trigger the software SMI
+
+  @param[in] Data                 The value to be set on the software SMI data port
+
+  @retval EFI_SUCCESS             Function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+SmmTrigger (
+  UINT8   Data
+  );
+
+/**
+  Clear the SMI status
+
+
+  @retval EFI_SUCCESS             The function completes successfully
+  @retval EFI_DEVICE_ERROR        Something error occurred
+**/
+EFI_STATUS
+EFIAPI
+SmmClear (
+  VOID
+  );
+
+/**
+  This routine generates an SMI
+
+  @param[in] This                       The EFI SMM Control protocol instance
+  @param[in, out] ArgumentBuffer        The buffer of argument
+  @param[in, out] ArgumentBufferSize    The size of the argument buffer
+  @param[in] Periodic                   Periodic or not
+  @param[in] ActivationInterval         Interval of periodic SMI
+
+  @retval EFI Status                    Describing the result of the operation
+  @retval EFI_INVALID_PARAMETER         Some parameter value passed is not supported
+**/
+EFI_STATUS
+EFIAPI
+Activate (
+  IN CONST EFI_SMM_CONTROL2_PROTOCOL    *This,
+  IN OUT  UINT8                         *ArgumentBuffer OPTIONAL,
+  IN OUT  UINT8                         *ArgumentBufferSize OPTIONAL,
+  IN      BOOLEAN                       Periodic OPTIONAL,
+  IN      UINTN                         ActivationInterval OPTIONAL
+  );
+
+/**
+  This routine clears an SMI
+
+  @param[in] This                 The EFI SMM Control protocol instance
+  @param[in] Periodic             Periodic or not
+
+  @retval EFI Status              Describing the result of the operation
+  @retval EFI_INVALID_PARAMETER   Some parameter value passed is not supported
+**/
+EFI_STATUS
+EFIAPI
+Deactivate (
+  IN CONST EFI_SMM_CONTROL2_PROTOCOL    *This,
+  IN       BOOLEAN                      Periodic OPTIONAL
+  );
+/**
+  Disable all pending SMIs
+
+**/
+VOID
+EFIAPI
+DisablePendingSmis (
+  VOID
+  );
+
+#endif
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (34 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files Heng Luo
                   ` (3 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following files:
  * SystemAgent/SaInit/Dxe
  * SystemAgent/SaInit/Smm

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c          | 431 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c          | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h          |  58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c       | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h       | 136 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf     | 117 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c      | 454 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.c   | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.h   | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.inf |  72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 10 files changed, 1803 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c
new file mode 100644
index 0000000000..d84a0c1fa4
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c
@@ -0,0 +1,431 @@
+/** @file
+  This is the driver that initializes the Intel System Agent.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "SaInitDxe.h"
+#include "SaInit.h"
+#include <SaConfigHob.h>
+#include <Protocol/SaNvsArea.h>
+#include <Library/PchInfoLib.h>
+#include <CpuPcieInfo.h>
+#include <Library/DxeCpuPcieRpLib.h>
+#include <SaConfigHob.h>
+#include <CpuPcieHob.h>
+#include <HostBridgeDataHob.h>
+#include <CpuDataStruct.h>
+
+///
+/// Global Variables
+///
+GLOBAL_REMOVE_IF_UNREFERENCED SYSTEM_AGENT_NVS_AREA_PROTOCOL  mSaNvsAreaProtocol;
+GLOBAL_REMOVE_IF_UNREFERENCED SA_POLICY_PROTOCOL              *mSaPolicy;
+extern SA_CONFIG_HOB                                          *mSaConfigHob;
+
+/**
+  A protocol callback which updates 64bits MMIO Base and Length in SA GNVS area
+**/
+VOID
+UpdateSaGnvsForMmioResourceBaseLength (
+  VOID
+  )
+{
+  EFI_PHYSICAL_ADDRESS      PciBaseAddress;
+  UINT32                    Tolud;
+  UINT64                    Length;
+  UINT64                    McD0BaseAddress;
+  UINTN                     ResMemLimit1;
+  UINT8                     EnableAbove4GBMmioBiosAssignemnt;
+  HOST_BRIDGE_DATA_HOB      *HostBridgeDataHob;
+
+  PciBaseAddress = 0;
+  Tolud = 0;
+  Length = 0;
+  ResMemLimit1 = 0;
+  EnableAbove4GBMmioBiosAssignemnt = 0;
+  HostBridgeDataHob = NULL;
+  //
+  // Read memory map registers
+  //
+  McD0BaseAddress        = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0, 0);
+  Tolud                  = PciSegmentRead32 (McD0BaseAddress + R_SA_TOLUD) & B_SA_TOLUD_TOLUD_MASK;
+  PciBaseAddress         = Tolud;
+
+  ResMemLimit1 = (UINTN) PcdGet64 (PcdSiPciExpressBaseAddress);
+
+  Length = ResMemLimit1 - PciBaseAddress;
+
+  //
+  // Get HostBridgeData HOB and see if above 4GB MMIO BIOS assignment enabled
+  //
+  HostBridgeDataHob = (HOST_BRIDGE_DATA_HOB *) GetFirstGuidHob (&gHostBridgeDataHobGuid);
+  if ((HostBridgeDataHob != NULL) && (HostBridgeDataHob->EnableAbove4GBMmio == 1)) {
+    EnableAbove4GBMmioBiosAssignemnt = 1;
+  }
+
+  //
+  // Enable Above 4GB MMIO when Aperture Size is 2GB or higher
+  //
+  if ((mSaConfigHob != NULL) && (mSaConfigHob->ApertureSize >= 15)) {
+    EnableAbove4GBMmioBiosAssignemnt = 1;
+  }
+
+  //
+  // Check Enable Above 4GB MMIO or not
+  //
+
+  DEBUG ((DEBUG_INFO, "Update SA GNVS Area.\n"));
+  mSaNvsAreaProtocol.Area->Mmio32Base   = (UINT32) PciBaseAddress;
+  mSaNvsAreaProtocol.Area->Mmio32Length = (UINT32) Length;
+  if (EnableAbove4GBMmioBiosAssignemnt == 1) {
+    mSaNvsAreaProtocol.Area->Mmio64Base   = BASE_256GB;
+    mSaNvsAreaProtocol.Area->Mmio64Length = SIZE_256GB;
+  }
+  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio64Base = %lx\n", mSaNvsAreaProtocol.Area->Mmio64Base));
+  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio64Length = %lx\n", mSaNvsAreaProtocol.Area->Mmio64Length));
+  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio32Base = %lx\n", mSaNvsAreaProtocol.Area->Mmio32Base));
+  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio32Length = %lx\n", mSaNvsAreaProtocol.Area->Mmio32Length));
+}
+
+/**
+  Install SSDT Table
+
+  @retval EFI_SUCCESS - SSDT Table load successful.
+**/
+EFI_STATUS
+InstallSsdtAcpiTable (
+  IN GUID   SsdtTableGuid,
+  IN UINT64 Signature
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_HANDLE                    *HandleBuffer;
+  BOOLEAN                       LoadTable;
+  UINTN                         NumberOfHandles;
+  UINTN                         Index;
+  INTN                          Instance;
+  UINTN                         Size;
+  UINT32                        FvStatus;
+  UINTN                         TableHandle;
+  EFI_FV_FILETYPE               FileType;
+  EFI_FV_FILE_ATTRIBUTES        Attributes;
+  EFI_FIRMWARE_VOLUME2_PROTOCOL *FwVol;
+  EFI_ACPI_TABLE_PROTOCOL       *AcpiTable;
+  EFI_ACPI_DESCRIPTION_HEADER   *TableHeader;
+  EFI_ACPI_COMMON_HEADER        *Table;
+
+  FwVol         = NULL;
+  Table         = NULL;
+
+  DEBUG ((DEBUG_INFO, "Loading SSDT Table GUID: %g\n", SsdtTableGuid));
+
+  ///
+  /// Locate FV protocol.
+  ///
+  Status = gBS->LocateHandleBuffer (
+                  ByProtocol,
+                  &gEfiFirmwareVolume2ProtocolGuid,
+                  NULL,
+                  &NumberOfHandles,
+                  &HandleBuffer
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Look for FV with ACPI storage file
+  ///
+  for (Index = 0; Index < NumberOfHandles; Index++) {
+    ///
+    /// Get the protocol on this handle
+    /// This should not fail because of LocateHandleBuffer
+    ///
+    Status = gBS->HandleProtocol (
+                    HandleBuffer[Index],
+                    &gEfiFirmwareVolume2ProtocolGuid,
+                    (VOID **) &FwVol
+                    );
+    ASSERT_EFI_ERROR (Status);
+    if (FwVol == NULL) {
+      return EFI_NOT_FOUND;
+    }
+    ///
+    /// See if it has the ACPI storage file
+    ///
+    Size      = 0;
+    FvStatus  = 0;
+    Status = FwVol->ReadFile (
+                      FwVol,
+                      &SsdtTableGuid,
+                      NULL,
+                      &Size,
+                      &FileType,
+                      &Attributes,
+                      &FvStatus
+                      );
+
+    ///
+    /// If we found it, then we are done
+    ///
+    if (!EFI_ERROR (Status)) {
+      break;
+    }
+  }
+  ///
+  /// Our exit status is determined by the success of the previous operations
+  /// If the protocol was found, Instance already points to it.
+  ///
+  ///
+  /// Free any allocated buffers
+  ///
+  FreePool (HandleBuffer);
+
+  ///
+  /// Sanity check that we found our data file
+  ///
+  ASSERT (FwVol);
+
+  ///
+  /// Locate ACPI tables
+  ///
+  Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID **) &AcpiTable);
+
+  ///
+  /// Read tables from the storage file.
+  ///
+  if (FwVol == NULL) {
+    ASSERT_EFI_ERROR (EFI_NOT_FOUND);
+    return EFI_NOT_FOUND;
+  }
+  Instance = 0;
+
+  while (Status == EFI_SUCCESS) {
+    ///
+    /// Read the ACPI tables
+    ///
+    Status = FwVol->ReadSection (
+                      FwVol,
+                      &SsdtTableGuid,
+                      EFI_SECTION_RAW,
+                      Instance,
+                      (VOID **) &Table,
+                      &Size,
+                      &FvStatus
+                      );
+    if (!EFI_ERROR (Status)) {
+      ///
+      /// check and load HybridGraphics SSDT table
+      ///
+      LoadTable   = FALSE;
+      TableHeader = (EFI_ACPI_DESCRIPTION_HEADER *) Table;
+
+      if (((EFI_ACPI_DESCRIPTION_HEADER *) TableHeader)->OemTableId == Signature) {
+        ///
+        /// This is the SSDT table that match the Signature
+        ///
+        DEBUG ((DEBUG_INFO, "Found out SSDT Table GUID: %g\n", SsdtTableGuid));
+        LoadTable = TRUE;
+      }
+
+      ///
+      /// Add the table
+      ///
+      if (LoadTable) {
+        TableHandle = 0;
+        Status = AcpiTable->InstallAcpiTable (
+                              AcpiTable,
+                              TableHeader,
+                              TableHeader->Length,
+                              &TableHandle
+                              );
+      }
+      ///
+      /// Increment the instance
+      ///
+      Instance++;
+      Table = NULL;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This function gets registered as a callback to perform Dmar Igd
+
+  @param[in] Event     - A pointer to the Event that triggered the callback.
+  @param[in] Context   - A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+SaAcpiEndOfDxeCallback (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  EFI_STATUS          Status;
+
+  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, PCI_VENDOR_ID_OFFSET)) != 0xFFFF) {
+    Status = PostPmInitEndOfDxe ();
+    if (EFI_SUCCESS != Status) {
+      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe GraphicsInit Error, Status = %r \n", Status));
+      ASSERT_EFI_ERROR (Status);
+    }
+  }
+
+  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, PCI_VENDOR_ID_OFFSET)) != 0xFFFF) {
+    Status = GetVBiosVbtEndOfDxe ();
+    if (EFI_SUCCESS != Status) {
+      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe Op Region Error, Status = %r \n", Status));
+    }
+
+    Status = UpdateIgdOpRegionEndOfDxe ();
+    if (EFI_SUCCESS != Status) {
+      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe Update Op Region Error, Status = %r \n", Status));
+    }
+  }
+
+  return;
+}
+
+/**
+  SystemAgent Acpi Initialization.
+
+  @param[in] ImageHandle             Handle for the image of this driver
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
+**/
+EFI_STATUS
+EFIAPI
+SaAcpiInit (
+  IN EFI_HANDLE         ImageHandle
+  )
+{
+  EFI_STATUS                Status;
+  EFI_CPUID_REGISTER        CpuidRegs;
+  EFI_EVENT                 EndOfDxeEvent;
+
+  CPU_PCIE_HOB              *CpuPcieHob;
+
+  AsmCpuid (1, &CpuidRegs.RegEax, 0, 0, 0);
+  ///
+  /// Get the platform setup policy.
+  ///
+  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **) &mSaPolicy);
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Install System Agent Global NVS protocol
+  ///
+  DEBUG ((DEBUG_INFO, "Install SA GNVS protocol\n"));
+  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof (SYSTEM_AGENT_NVS_AREA), (VOID **) &mSaNvsAreaProtocol.Area);
+  ASSERT_EFI_ERROR (Status);
+  ZeroMem ((VOID *) mSaNvsAreaProtocol.Area, sizeof (SYSTEM_AGENT_NVS_AREA));
+  mSaNvsAreaProtocol.Area->XPcieCfgBaseAddress  = (UINT32) (PcdGet64 (PcdSiPciExpressBaseAddress));
+  mSaNvsAreaProtocol.Area->CpuIdInfo            = CpuidRegs.RegEax;
+
+  ///
+  /// Get CpuPcieHob HOB
+  ///
+  CpuPcieHob = NULL;
+  CpuPcieHob = (CPU_PCIE_HOB *) GetFirstGuidHob (&gCpuPcieHobGuid);
+  if (CpuPcieHob == NULL) {
+    DEBUG((DEBUG_ERROR, "CpuPcieHob not found\n"));
+    // @todo: Will add it back once it will get add into NVS library since currently it is failing for JSL
+    //ASSERT(CpuPcieHob != NULL);
+    //return EFI_NOT_FOUND;
+  } else {
+    mSaNvsAreaProtocol.Area->SlotSelection = CpuPcieHob->SlotSelection;
+    DEBUG((DEBUG_INFO, "RpEnabledMask == %x\n", CpuPcieHob->RpEnabledMask));
+    if (CpuPcieHob->RpEnabledMask == 0) {
+      DEBUG ((DEBUG_ERROR, "All CPU PCIe root ports are disabled!!\n"));
+    } else {
+      if (CpuPcieHob->RpEnabledMask & BIT0) {
+        mSaNvsAreaProtocol.Area->CpuPcieRp0Enable = 1;
+      }
+      if (CpuPcieHob->RpEnabledMask & BIT1) {
+        mSaNvsAreaProtocol.Area->CpuPcieRp1Enable = 1;
+      }
+      if (CpuPcieHob->RpEnabledMask & BIT2) {
+        mSaNvsAreaProtocol.Area->CpuPcieRp2Enable = 1;
+      }
+      if (CpuPcieHob->RpEnabledMask & BIT3) {
+        mSaNvsAreaProtocol.Area->CpuPcieRp3Enable = 1;
+      }
+    }
+    mSaNvsAreaProtocol.Area->MaxPegPortNumber = GetMaxCpuPciePortNum ();
+  }
+
+  mSaNvsAreaProtocol.Area->SimicsEnvironment = 0;
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gSaNvsAreaProtocolGuid,
+                  &mSaNvsAreaProtocol,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// GtPostInit Initialization
+  ///
+  DEBUG ((DEBUG_INFO, "Initializing GT ACPI tables\n"));
+  GraphicsInit (ImageHandle, mSaPolicy);
+
+  ///
+  /// Audio (dHDA) Initialization
+  ///
+  ///
+  /// Vtd Initialization
+  ///
+  DEBUG ((DEBUG_INFO, "Initializing VT-d ACPI tables\n"));
+  VtdInit (mSaPolicy);
+
+  ///
+  /// IgdOpRegion Install Initialization
+  ///
+  DEBUG ((DEBUG_INFO, "Initializing IGD OpRegion\n"));
+  IgdOpRegionInit ();
+
+  ///
+  /// Register an end of DXE event for SA ACPI to do tasks before invoking any UEFI drivers,
+  /// applications, or connecting consoles,...
+  ///
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  SaAcpiEndOfDxeCallback,
+                  NULL,
+                  &gEfiEndOfDxeEventGroupGuid,
+                  &EndOfDxeEvent
+                  );
+
+  ///
+  /// Install System Agent Global NVS ACPI table
+  ///
+  Status = InstallSsdtAcpiTable (gSaSsdtAcpiTableStorageGuid, SIGNATURE_64 ('S', 'a', 'S', 's', 'd', 't', ' ', 0));
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Update CPU PCIE RP NVS AREA
+  ///
+  UpdateCpuPcieNVS();
+  ///
+  /// Install Intel Graphics SSDT
+  ///
+  Status = InstallSsdtAcpiTable (gGraphicsAcpiTableStorageGuid, SIGNATURE_64 ('I','g','f','x','S','s','d','t'));
+  ASSERT_EFI_ERROR (Status);
+
+  ///
+  /// Install IPU SSDT if IPU is present.
+  ///
+  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, IPU_BUS_NUM, IPU_DEV_NUM, IPU_FUN_NUM, 0)) != V_SA_DEVICE_ID_INVALID) {
+      Status = InstallSsdtAcpiTable (gIpuAcpiTableStorageGuid, SIGNATURE_64 ('I','p','u','S','s','d','t',0));
+      ASSERT_EFI_ERROR (Status);
+
+  }
+
+  return EFI_SUCCESS;
+}
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c
new file mode 100644
index 0000000000..5c0fea422b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c
@@ -0,0 +1,120 @@
+/** @file
+  This is the Common driver that initializes the Intel System Agent.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "SaInit.h"
+#include <Library/PciSegmentLib.h>
+#include <HostBridgeDataHob.h>
+#include <SaConfigHob.h>
+#include <Protocol/PciEnumerationComplete.h>
+
+///
+/// Global Variables
+///
+GLOBAL_REMOVE_IF_UNREFERENCED SA_CONFIG_HOB                          *mSaConfigHob;
+BOOLEAN                                                              mSkipPamLock = FALSE;
+
+/*
+  Intel(R) Core Processor Skylake BWG version 0.4.0
+
+  18.6 System Agent Configuration Locking
+   For reliable operation and security, System BIOS must set the following bits:
+   1. For all modern Intel processors, Intel strongly recommends that BIOS should set
+       the D_LCK bit. Set B0:D0:F0.R088h [4] = 1b to lock down SMRAM space.
+  BaseAddr values for mSaSecurityRegisters that uses PciExpressBaseAddress will be initialized at
+  Runtime inside function CpuPcieInitPolicy().
+*/
+GLOBAL_REMOVE_IF_UNREFERENCED BOOT_SCRIPT_REGISTER_SETTING mSaSecurityRegisters[] = {
+  {0,  R_SA_SMRAMC,  0xFFFFFFFF,  BIT4}
+};
+
+/**
+  SystemAgent Initialization Common Function.
+
+  @retval EFI_SUCCESS   - Always.
+**/
+
+VOID
+SaInitEntryPoint (
+  VOID
+  )
+{
+  HOST_BRIDGE_DATA_HOB        *HostBridgeDataHob;
+
+  ///
+  /// Get Host Bridge Data HOB
+  ///
+  HostBridgeDataHob = NULL;
+  HostBridgeDataHob = (HOST_BRIDGE_DATA_HOB *) GetFirstGuidHob (&gHostBridgeDataHobGuid);
+  if (HostBridgeDataHob != NULL) {
+    mSkipPamLock = HostBridgeDataHob->SkipPamLock;
+  }
+  return;
+}
+
+/**
+  This function does SA security lock
+**/
+VOID
+SaSecurityLock (
+  VOID
+  )
+{
+  UINT8           Index;
+  UINT64          BaseAddress;
+  UINT32          RegOffset;
+  UINT32          Data32And;
+  UINT32          Data32Or;
+
+  ///
+  /// 17.2 System Agent Security Lock configuration
+  ///
+  DEBUG ((DEBUG_INFO, "DXE SaSecurityLock\n"));
+  for (Index = 0; Index < (sizeof (mSaSecurityRegisters) / sizeof (BOOT_SCRIPT_REGISTER_SETTING)); Index++) {
+    BaseAddress = mSaSecurityRegisters[Index].BaseAddr;
+    RegOffset   = mSaSecurityRegisters[Index].Offset;
+    Data32And   = mSaSecurityRegisters[Index].AndMask;
+    Data32Or    = mSaSecurityRegisters[Index].OrMask;
+
+    if (RegOffset == R_SA_SMRAMC) {
+      ///
+      /// SMRAMC LOCK must use CF8/CFC access
+      ///
+      PciCf8Or8 (PCI_CF8_LIB_ADDRESS (SA_MC_BUS, SA_MC_DEV, SA_MC_FUN, R_SA_SMRAMC), (UINT8) Data32Or);
+      BaseAddress = S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (SA_MC_BUS, SA_MC_DEV, SA_MC_FUN, R_SA_SMRAMC);
+      S3BootScriptSavePciCfgReadWrite (
+        S3BootScriptWidthUint8,
+        (UINTN) BaseAddress,
+        &Data32Or,
+        &Data32And
+        );
+    }
+  }
+
+}
+
+/**
+  This function performs SA Security locking in EndOfDxe callback
+
+  @retval EFI_SUCCESS     - Security lock has done
+  @retval EFI_UNSUPPORTED - Security lock not done successfully
+**/
+EFI_STATUS
+SaSecurityInit (
+  VOID
+  )
+{
+
+  UINT8                     Index;
+
+  for (Index = 0; Index < (sizeof (mSaSecurityRegisters) / sizeof (BOOT_SCRIPT_REGISTER_SETTING)); Index++) {
+    if (mSaSecurityRegisters[Index].BaseAddr != PcdGet64 (PcdMchBaseAddress)) {
+      mSaSecurityRegisters[Index].BaseAddr = PcdGet64 (PcdSiPciExpressBaseAddress);
+    }
+  }
+  SaSecurityLock ();
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h
new file mode 100644
index 0000000000..5c8f7dfd5f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h
@@ -0,0 +1,58 @@
+/** @file
+  Header file for SA Common Initialization Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_INITIALIZATION_DRIVER_H_
+#define _SA_INITIALIZATION_DRIVER_H_
+
+#include <Uefi.h>
+#include <IndustryStandard/Acpi.h>
+#include <IndustryStandard/Pci.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/UefiLib.h>
+#include <Library/IoLib.h>
+#include <Library/PciCf8Lib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/SaPlatformLib.h>
+#include <Guid/EventGroup.h>
+#include <Protocol/SaPolicy.h>
+#include <Register/SaRegsHostBridge.h>
+#include <SaConfigHob.h>
+
+extern SA_POLICY_PROTOCOL              *mSaPolicy;
+extern SA_CONFIG_HOB                   *SaConfigHob;
+
+typedef struct {
+  UINT64  BaseAddr;
+  UINT32  Offset;
+  UINT32  AndMask;
+  UINT32  OrMask;
+} BOOT_SCRIPT_REGISTER_SETTING;
+
+/**
+  SystemAgent Initialization Common Function.
+
+  @retval EFI_SUCCESS   - Always.
+**/
+VOID
+SaInitEntryPoint (
+  VOID
+  );
+
+/**
+  This function performs SA Security locking in EndOfDxe callback
+
+  @retval EFI_SUCCESS     - Security lock has done
+  @retval EFI_UNSUPPORTED - Security lock not done successfully
+**/
+EFI_STATUS
+SaSecurityInit (
+  VOID
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c
new file mode 100644
index 0000000000..2a0e0accf5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c
@@ -0,0 +1,181 @@
+/** @file
+  This is the driver that initializes the Intel System Agent.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "SaInitDxe.h"
+#include "SaInit.h"
+#include <SaConfigHob.h>
+#include <Protocol/PciEnumerationComplete.h>
+#include <MemInfoHob.h>
+#include <Protocol/SaIotrapSmi.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT16                   mPcieIoTrapAddress;
+
+///
+/// Global Variables
+///
+extern SA_CONFIG_HOB         *mSaConfigHob;
+
+
+/**
+  SystemAgent Dxe Initialization.
+
+  @param[in] ImageHandle             Handle for the image of this driver
+  @param[in] SystemTable             Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
+**/
+EFI_STATUS
+EFIAPI
+SaInitEntryPointDxe (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS                Status;
+  VOID                      *Registration;
+  EFI_EVENT                 ReadyToBoot;
+
+
+  DEBUG ((DEBUG_INFO, "SaInitDxe Start\n"));
+
+  SaInitEntryPoint ();
+
+  Status = SaAcpiInit (ImageHandle);
+  ///
+  /// Create PCI Enumeration Completed callback for CPU PCIe
+  ///
+  EfiCreateProtocolNotifyEvent (
+    &gEfiPciEnumerationCompleteProtocolGuid,
+    TPL_CALLBACK,
+    CpuPciEnumCompleteCallback,
+    NULL,
+    &Registration
+    );
+
+  //
+  // Register a Ready to boot event to config PCIE power management setting after OPROM executed
+  //
+  Status = EfiCreateEventReadyToBootEx (
+             TPL_CALLBACK,
+             SaOnReadyToBoot,
+             NULL,
+             &ReadyToBoot
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "SaInitDxe End\n"));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Do PCIE power management while resume from S3
+**/
+VOID
+ReconfigureCpuPciePowerManagementForS3 (
+  VOID
+  )
+{
+  EFI_STATUS                            Status;
+  UINT32                                Data32;
+  SA_IOTRAP_SMI_PROTOCOL                *CpuPcieIoTrapProtocol;
+
+  Status = gBS->LocateProtocol (&gCpuPcieIoTrapProtocolGuid, NULL, (VOID **) &CpuPcieIoTrapProtocol);
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+  mPcieIoTrapAddress = CpuPcieIoTrapProtocol->SaIotrapSmiAddress;
+  DEBUG ((DEBUG_INFO, "PcieIoTrapAddress: %0x\n", mPcieIoTrapAddress));
+
+  if (mPcieIoTrapAddress != 0) {
+    //
+    // Save PCH PCIE IoTrap address to re-config PCIE power management setting after resume from S3
+    //
+    Data32 = CpuPciePmTrap;
+    S3BootScriptSaveIoWrite (
+      S3BootScriptWidthUint32,
+      (UINTN) (mPcieIoTrapAddress),
+      1,
+      &Data32
+      );
+  } else {
+    ASSERT (FALSE);
+  }
+}
+
+
+/**
+  SA initialization before boot to OS
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+SaOnReadyToBoot (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  DEBUG ((DEBUG_INFO, "Uefi SaOnReadyToBoot() Start\n"));
+
+  if (Event != NULL) {
+    gBS->CloseEvent (Event);
+  }
+
+  //
+  // Trigger an Iotrap SMI to config PCIE power management setting after PCI enumrate is done
+  //
+#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
+  if (mPcieIoTrapAddress != 0) {
+    IoWrite32 ((UINTN) mPcieIoTrapAddress, CpuPciePmTrap);
+  } else {
+    ASSERT (FALSE);
+  }
+#endif
+  DEBUG ((DEBUG_INFO, "Uefi SaOnReadyToBoot() End\n"));
+}
+
+
+/**
+  This function gets registered as a callback to perform CPU PCIe initialization before EndOfDxe
+
+  @param[in] Event     - A pointer to the Event that triggered the callback.
+  @param[in] Context   - A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+CpuPciEnumCompleteCallback (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  )
+{
+  EFI_STATUS          Status;
+  VOID                *ProtocolPointer;
+
+  DEBUG ((DEBUG_INFO, "CpuPciEnumCompleteCallback Start\n"));
+  ///
+  /// Check if this is first time called by EfiCreateProtocolNotifyEvent() or not,
+  /// if it is, we will skip it until real event is triggered
+  ///
+  Status = gBS->LocateProtocol (&gEfiPciEnumerationCompleteProtocolGuid, NULL, (VOID **) &ProtocolPointer);
+  if (EFI_SUCCESS != Status) {
+    return;
+  }
+
+  gBS->CloseEvent (Event);
+
+  ReconfigureCpuPciePowerManagementForS3();
+  //
+  // Routine for update DMAR
+  //
+  UpdateDmarEndOfPcieEnum ();
+
+  UpdateSaGnvsForMmioResourceBaseLength ();
+  DEBUG ((DEBUG_INFO, "CpuPciEnumCompleteCallback End\n"));
+  return;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h
new file mode 100644
index 0000000000..7110d049a8
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h
@@ -0,0 +1,136 @@
+/** @file
+  Header file for SA Initialization Driver.
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SA_INIT_DXE_DRIVER_H_
+#define _SA_INIT_DXE_DRIVER_H_
+
+#include <Library/UefiBootServicesTableLib.h>
+#include <Protocol/AcpiTable.h>
+#include <Library/DxeVtdInitLib.h>
+#include <Library/DxeIgdOpRegionInitLib.h>
+#include <Library/DxeGraphicsInitLib.h>
+#include <Register/SaRegsHostBridge.h>
+
+///
+/// Driver Consumed Protocol Prototypes
+///
+#include <Protocol/SaPolicy.h>
+
+extern EFI_GUID gSaAcpiTableStorageGuid;
+extern EFI_GUID gSaSsdtAcpiTableStorageGuid;
+
+typedef struct {
+  UINT64                Address;
+  EFI_BOOT_SCRIPT_WIDTH Width;
+  UINT32                Value;
+} BOOT_SCRIPT_PCI_REGISTER_SAVE;
+
+///
+/// Function Prototype
+///
+/**
+  This function gets registered as a callback to perform CPU PCIe initialization before ExitPmAuth
+
+  @param[in] Event     - A pointer to the Event that triggered the callback.
+  @param[in] Context   - A pointer to private data registered with the callback function.
+
+**/
+VOID
+EFIAPI
+CpuPciEnumCompleteCallback (
+  IN EFI_EVENT Event,
+  IN VOID      *Context
+  );
+
+/**
+  <b>System Agent Initialization DXE Driver Entry Point</b>
+  - <b>Introduction</b> \n
+    Based on the information/data in SA_POLICY_PROTOCOL, this module performs further SA initialization in DXE phase,
+    e.g. internal devices enable/disable, SSVID/SID programming, graphic power-management, VT-d, IGD OpRegion initialization.
+    From the perspective of a PCI Express hierarchy, the Broadwell System Agent and PCH together appear as a Root Complex with root ports the number of which depends on how the 8 PCH ports and 4 System Agent PCIe ports are configured [4x1, 2x8, 1x16].
+    There is an internal link (DMI or OPI) that connects the System Agent to the PCH component. This driver includes initialization of SA DMI, PCI Express, SA & PCH Root Complex Topology.
+    For iGFX, this module implements the initialization of the Graphics Technology Power Management from the Broadwell System Agent BIOS Specification and the initialization of the IGD OpRegion/Software SCI - BIOS Specification.
+    The ASL files that go along with the driver define the IGD OpRegion mailboxes in ACPI space and implement the software SCI interrupt mechanism.
+    The IGD OpRegion/Software SCI code serves as a communication interface between system BIOS, ASL, and Intel graphics driver including making a block of customizable data (VBT) from the Intel video BIOS available.
+    Reference Code for the SCI service functions "Get BIOS Data" and "System BIOS Callback" can be found in the ASL files, those functions can be platform specific, the sample provided in the reference code are implemented for Intel CRB.
+    This module implements the VT-d functionality described in the Broadwell System Agent BIOS Specification.
+    This module publishes the LegacyRegion protocol to control the read and write accesses to the Legacy BIOS ranges.
+    E000 and F000 segments are the legacy BIOS ranges and contain pointers to the ACPI regions, SMBIOS tables and so on. This is a private protocol used by Intel Framework.
+    This module registers CallBack function that performs SA security registers lockdown at end of post as required from Broadwell Bios Spec.
+    In addition, this module publishes the SaInfo Protocol with information such as current System Agent reference code version#.
+
+  - @pre
+    - EFI_FIRMWARE_VOLUME_PROTOCOL: Documented in Firmware Volume Specification, available at the URL: http://www.intel.com/technology/framework/spec.htm
+    - SA_POLICY_PROTOCOL: A protocol published by a platform DXE module executed earlier; this is documented in this document as well.
+    - EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL: Documented in the Unified Extensible Firmware Interface Specification, version 2.0, available at the URL: http://www.uefi.org/specs/
+    - EFI_BOOT_SCRIPT_SAVE_PROTOCOL: A protocol published by a platform DXE module executed earlier; refer to the Sample Code section of the Framework PCH Reference Code.
+    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL: Documented in the Unified Extensible Firmware Interface Specification, version 2.0, available at the URL: http://www.uefi.org/specs/
+    - EFI_ACPI_TABLE_PROTOCOL : Documented in PI Specification 1.2
+    - EFI_CPU_IO_PROTOCOL: Documented in CPU I/O Protocol Specification, available at the URL: http://www.intel.com/technology/framework/spec.htm
+    - EFI_DATA_HUB_PROTOCOL: Documented in EFI Data Hub Infrastructure Specification, available at the URL: http://www.intel.com/technology/framework/spec.htm
+    - EFI_HII_PROTOCOL (or EFI_HII_DATABASE_PROTOCOL for UEFI 2.1): Documented in Human Interface Infrastructure Specification, available at the URL: http://www.intel.com/technology/framework/spec.htm
+    (For EFI_HII_DATABASE_PROTOCOL, refer to UEFI Specification Version 2.1 available at the URL: http://www.uefi.org/)
+
+  - @result
+    IGD power-management functionality is initialized;  VT-d is initialized (meanwhile, the DMAR table is updated); IGD OpRegion is initialized - IGD_OPREGION_PROTOCOL installed, IGD OpRegion allocated and mailboxes initialized, chipset initialized and ready to generate Software SCI for Internal graphics events. Publishes the SA_INFO_PROTOCOL with current SA reference code version #. Publishes the EFI_LEGACY_REGION_PROTOCOL documented in the Compatibility Support Module Specification, version 0.9, available at the URL: http://www.intel.com/technology/framework/spec.htm
+
+  - <b>References</b> \n
+    IGD OpRegion/Software SCI for Broadwell
+    Advanced Configuration and Power Interface Specification Revision 4.0a.
+
+  - <b>Porting Recommendations</b> \n
+    No modification of the DXE driver should be typically necessary.
+    This driver should be executed after all related devices (audio, video, ME, etc.) are initialized to ensure correct data in DMAR table and DMA-remapping registers.
+
+  @param[in] ImageHandle             Handle for the image of this driver
+  @param[in] SystemTable             Pointer to the EFI System Table
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
+**/
+EFI_STATUS
+EFIAPI
+SaInitEntryPointDxe (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  );
+
+/**
+  SystemAgent Acpi Initialization.
+
+  @param[in] ImageHandle             Handle for the image of this driver
+
+  @retval EFI_SUCCESS             The function completed successfully
+  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
+**/
+EFI_STATUS
+EFIAPI
+SaAcpiInit (
+  IN EFI_HANDLE         ImageHandle
+  );
+
+/**
+  A protocol callback which updates 64bits MMIO Base and Length in SA GNVS area
+**/
+VOID
+UpdateSaGnvsForMmioResourceBaseLength (
+  VOID
+  );
+
+/**
+  SA initialization before boot to OS
+
+  @param[in] Event                A pointer to the Event that triggered the callback.
+  @param[in] Context              A pointer to private data registered with the callback function.
+**/
+VOID
+EFIAPI
+SaOnReadyToBoot (
+  IN EFI_EVENT    Event,
+  IN VOID         *Context
+  );
+
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf
new file mode 100644
index 0000000000..d23ba0fa3b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf
@@ -0,0 +1,117 @@
+## @file
+# Component description file for SystemAgent Initialization driver
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = SaInitDxe
+FILE_GUID = DE23ACEE-CF55-4fb6-AA77-984AB53DE811
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_DRIVER
+ENTRY_POINT = SaInitEntryPointDxe
+#
+# The following information is for reference only and not required by the build tools.
+#
+# VALID_ARCHITECTURES = IA32 X64 EBC
+#
+
+
+
+[LibraryClasses]
+UefiDriverEntryPoint
+UefiLib
+UefiBootServicesTableLib
+DxeServicesTableLib
+DebugLib
+PciCf8Lib
+PciSegmentLib
+BaseMemoryLib
+MemoryAllocationLib
+IoLib
+S3BootScriptLib
+PmcLib
+PchInfoLib
+GpioLib
+ConfigBlockLib
+SaPlatformLib
+PchPcieRpLib
+DxeGraphicsInitLib
+DxeIgdOpRegionInitLib
+DxeVtdInitLib
+PciExpressHelpersLib
+DxeCpuPcieRpLib
+SataLib
+
+[Packages]
+TigerlakeSiliconPkg/SiPkg.dec
+MdePkg/MdePkg.dec
+UefiCpuPkg/UefiCpuPkg.dec
+IntelSiliconPkg/IntelSiliconPkg.dec
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
+gSiPkgTokenSpaceGuid.PcdMchBaseAddress
+gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress
+gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                  ## CONSUMES
+
+[FixedPcd]
+
+[Sources]
+SaInitDxe.h
+SaInitDxe.c
+SaInit.h
+SaInit.c
+SaAcpi.c
+
+
+[Protocols]
+gEfiAcpiTableProtocolGuid              ## CONSUMES
+gSaNvsAreaProtocolGuid                 ## PRODUCES
+gSaPolicyProtocolGuid                  ## CONSUMES
+gEfiCpuArchProtocolGuid                ## CONSUMES
+gEfiPciEnumerationCompleteProtocolGuid ## CONSUMES
+gEfiPciRootBridgeIoProtocolGuid        ## CONSUMES
+gIgdOpRegionProtocolGuid               ## PRODUCES
+gEfiFirmwareVolume2ProtocolGuid        ## CONSUMES
+gGopComponentName2ProtocolGuid         ## CONSUMES
+gSaIotrapSmiProtocolGuid               ## CONSUMES
+gCpuPcieIoTrapProtocolGuid             ## CONSUMES
+
+[Guids]
+gSaConfigHobGuid
+gHgAcpiTablePchStorageGuid
+gSaAcpiTableStorageGuid
+gHgAcpiTableStorageGuid
+gSaSsdtAcpiTableStorageGuid
+gSegSsdtAcpiTableStorageGuid
+gTcssSsdtAcpiTableStorageGuid
+gGraphicsAcpiTableStorageGuid
+gIpuAcpiTableStorageGuid
+gEfiEndOfDxeEventGroupGuid
+gSiConfigHobGuid        ## CONSUMES
+gGraphicsDxeConfigGuid
+gMemoryDxeConfigGuid
+gPcieDxeConfigGuid
+gPchInfoHobGuid
+gTcssHobGuid
+gSaConfigHobGuid
+gSaDataHobGuid
+gCpuPcieHobGuid
+gHostBridgeDataHobGuid
+gVmdInfoHobGuid                   ## CONSUMES
+
+[FixedPcd]
+
+[Depex]
+gEfiAcpiTableProtocolGuid AND
+gEfiFirmwareVolume2ProtocolGuid AND
+gSaPolicyProtocolGuid AND
+gEfiPciRootBridgeIoProtocolGuid AND
+gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure that PCI MMIO resource has been prepared and available for this driver to allocate.
+gEfiHiiDatabaseProtocolGuid
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
new file mode 100644
index 0000000000..70d47e787f
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
@@ -0,0 +1,454 @@
+/** @file
+  CPU PCIe SMM Driver Entry
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include "SaLateInitSmm.h"
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <PcieRegs.h>
+#include <Register/PchRegs.h>
+#include <Register/CpuPcieRegs.h>
+#include <Library/PcieHelperLib.h>
+#include <CpuPcieInfo.h>
+#include <Library/TimerLib.h>
+#include <Library/PciExpressHelpersLib.h>
+#include <Library/CpuPcieInfoFruLib.h>
+#include <CpuPcieConfig.h>
+#include <Library/CpuPcieRpLib.h>
+#include <Protocol/PchPcieSmiDispatch.h>
+#include <Protocol/PchSmiDispatch.h>
+#include <Protocol/SaIotrapSmi.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/S3BootScriptLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <CpuPcieHob.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                       mSaBusNumber;
+//
+// @note:
+// These temp bus numbers cannot be used in runtime (hot-plug).
+// These can be used only during boot.
+//
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                       mTempRootPortBusNumMin;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                       mTempRootPortBusNumMax;
+GLOBAL_REMOVE_IF_UNREFERENCED CPU_PCIE_ROOT_PORT_CONFIG   mCpuPcieRootPortConfig[CPU_PCIE_MAX_ROOT_PORTS];
+GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN                     mCpuPciePmTrapExecuted = FALSE;
+GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE    *mDevAspmOverride;
+GLOBAL_REMOVE_IF_UNREFERENCED UINT32                      mNumOfDevAspmOverride;
+
+/**
+  An IoTrap callback to config PCIE power management settings
+**/
+VOID
+CpuPciePmIoTrapSmiCallback (
+  VOID
+  )
+{
+  UINT32                                    PortIndex;
+  UINT64                                    RpBase;
+  UINT8                                     MaxPciePortNum;
+  UINTN                                     RpDevice;
+  UINTN                                     RpFunction;
+
+  MaxPciePortNum = GetMaxCpuPciePortNum ();
+
+  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
+    GetCpuPcieRpDevFun (PortIndex, &RpDevice, &RpFunction);
+    RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, (UINT32) RpDevice, (UINT32) RpFunction, 0);
+
+    if (PciSegmentRead16 (RpBase) != 0xFFFF) {
+      mDevAspmOverride                  = NULL;
+      mNumOfDevAspmOverride             = 0;
+      RootportDownstreamPmConfiguration (
+        SA_SEG_NUM,
+        SA_MC_BUS,
+        (UINT8)RpDevice,
+        (UINT8)RpFunction,
+        mTempRootPortBusNumMin,
+        mTempRootPortBusNumMax,
+        &mCpuPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
+        mNumOfDevAspmOverride,
+        mDevAspmOverride
+      );
+
+    }
+  }
+}
+
+/**
+  Program Common Clock and ASPM of Downstream Devices
+
+  @param[in] PortIndex                  Pcie Root Port Number
+  @param[in] RpDevice                   Pcie Root Pci Device Number
+  @param[in] RpFunction                 Pcie Root Pci Function Number
+
+  @retval EFI_SUCCESS                   Root port complete successfully
+  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
+**/
+EFI_STATUS
+CpuPcieSmi (
+  IN  UINT8                             PortIndex,
+  IN  UINT8                             RpDevice,
+  IN  UINT8                             RpFunction
+  )
+{
+  UINT8                 SecBus;
+  UINT8                 SubBus;
+  UINT64                RpBase;
+  UINT64                EpBase;
+  UINT8                 EpPcieCapPtr;
+  UINT8                 EpMaxSpeed;
+  BOOLEAN               DownstreamDevicePresent;
+  UINT32                Timeout;
+  UINT32                MaxLinkSpeed;
+
+  RpBase   = PCI_SEGMENT_LIB_ADDRESS (
+               SA_SEG_NUM,
+               SA_MC_BUS,
+               (UINT32) RpDevice,
+               (UINT32) RpFunction,
+               0
+               );
+
+  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
+    DEBUG((DEBUG_INFO, "PCIe controller is disabled, return!!\n"));
+    return EFI_SUCCESS;
+  }
+  //
+  // Check presence detect state. Here the endpoint must be detected using PDS rather than
+  // the usual LinkActive check, because PDS changes immediately and LA takes a few milliseconds to stabilize
+  //
+  DownstreamDevicePresent = !!(PciSegmentRead16 (RpBase + R_PCIE_SLSTS) & B_PCIE_SLSTS_PDS);
+
+  if (DownstreamDevicePresent) {
+    ///
+    /// Make sure the link is active before trying to talk to device behind it
+    /// Wait up to 100ms, according to PCIE spec chapter 6.7.3.3
+    ///
+    Timeout = 100 * 1000;
+    while (CpuPcieIsLinkActive(RpBase) == 0) {
+      MicroSecondDelay (10);
+      Timeout-=10;
+      if (Timeout == 0) {
+        DEBUG((DEBUG_INFO, "PDS set but timeout while waiting for LA bit to get set!!!\n"));
+        return EFI_NOT_FOUND;
+      }
+    }
+    SecBus  = PciSegmentRead8 (RpBase + PCI_BRIDGE_SECONDARY_BUS_REGISTER_OFFSET);
+    SubBus  = PciSegmentRead8 (RpBase + PCI_BRIDGE_SUBORDINATE_BUS_REGISTER_OFFSET);
+    ASSERT (SecBus != 0 && SubBus != 0);
+    if (SecBus == 0) {
+      DEBUG((DEBUG_INFO, "Secondary Bus is 0, return!!!\n"));
+      return EFI_NOT_FOUND;
+    }
+    RootportDownstreamConfiguration (
+      SA_SEG_NUM,
+      SA_MC_BUS,
+      RpDevice,
+      RpFunction,
+      mTempRootPortBusNumMin,
+      mTempRootPortBusNumMax,
+      EnumCpuPcie
+      );
+    RootportDownstreamPmConfiguration (
+      SA_SEG_NUM,
+      SA_MC_BUS,
+      RpDevice,
+      RpFunction,
+      mTempRootPortBusNumMin,
+      mTempRootPortBusNumMax,
+      &mCpuPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
+      mNumOfDevAspmOverride,
+      mDevAspmOverride
+    );
+    //
+    // Perform Equalization
+    //
+    EpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SecBus, 0, 0, 0);
+    EpPcieCapPtr = PcieFindCapId (SA_SEG_NUM, SecBus, 0, 0, EFI_PCI_CAPABILITY_ID_PCIEXP);
+    EpMaxSpeed = PciSegmentRead8 (EpBase + EpPcieCapPtr + R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_MLS;
+    MaxLinkSpeed = CpuPcieGetMaxLinkSpeed (RpBase);
+    if (EpMaxSpeed < MaxLinkSpeed) {
+        MaxLinkSpeed = EpMaxSpeed;
+    }
+    if (EpMaxSpeed >= V_PCIE_LCAP_MLS_GEN3 && EpMaxSpeed <= V_PCIE_LCAP_MLS_GEN4) {
+      PciSegmentAndThenOr16 (RpBase + R_PCIE_LCTL2, (UINT16)~B_PCIE_LCTL2_TLS, (UINT16)MaxLinkSpeed);
+      PciSegmentOr32 (RpBase + R_PCIE_LCTL3, B_PCIE_LCTL3_PE);
+      PciSegmentOr32 (RpBase + R_PCIE_LCTL, B_PCIE_LCTL_RL);
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  PCIE Hotplug SMI call back function for each Root port
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+CpuPcieSmiRpHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  CpuPcieSmi (RpContext->RpIndex, RpContext->DevNum, RpContext->FuncNum);
+}
+
+/**
+  PCIE Link Active State Change Hotplug SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+CpuPcieLinkActiveStateChange (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  return;
+}
+
+/**
+  PCIE Link Equalization Request SMI call back function for all Root ports
+
+  @param[in] DispatchHandle             Handle of this dispatch function
+  @param[in] RpContext                  Rootport context, which contains RootPort Index,
+                                        and RootPort PCI BDF.
+**/
+VOID
+EFIAPI
+CpuPcieLinkEqHandlerFunction (
+  IN  EFI_HANDLE                        DispatchHandle,
+  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
+  )
+{
+  ///
+  /// From PCI Express specification, the PCIe device can request for Link Equalization. When the
+  /// Link Equalization is requested by the device, an SMI will be generated  by PCIe RP when
+  /// enabled and the SMI subroutine would invoke the Software Preset/Coefficient Search
+  /// software to re-equalize the link.
+  ///
+
+  return;
+
+}
+/**
+  An IoTrap callback to config PCIE power management settings
+
+  @param[in] DispatchHandle  - The handle of this callback, obtained when registering
+  @param[in] DispatchContext - Pointer to the EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
+
+**/
+VOID
+EFIAPI
+CpuPcieIoTrapSmiCallback (
+  IN  EFI_HANDLE                            DispatchHandle,
+  IN  EFI_SMM_IO_TRAP_CONTEXT               *CallbackContext,
+  IN OUT VOID                               *CommBuffer,
+  IN OUT UINTN                              *CommBufferSize
+  )
+{
+  if (CallbackContext->WriteData == CpuPciePmTrap) {
+    if (mCpuPciePmTrapExecuted == FALSE) {
+      CpuPciePmIoTrapSmiCallback ();
+      mCpuPciePmTrapExecuted = TRUE;
+    }
+  } else {
+    ASSERT_EFI_ERROR (EFI_INVALID_PARAMETER);
+  }
+}
+
+/**
+  This function clear the Io trap executed flag before enter S3
+
+  @param[in] Handle    Handle of the callback
+  @param[in] Context   The dispatch context
+
+  @retval EFI_SUCCESS  SA register saved
+**/
+EFI_STATUS
+EFIAPI
+CpuPcieS3EntryCallBack (
+  IN  EFI_HANDLE                   Handle,
+  IN CONST VOID                    *Context OPTIONAL,
+  IN OUT VOID                      *CommBuffer OPTIONAL,
+  IN OUT UINTN                     *CommBufferSize OPTIONAL
+  )
+{
+  mCpuPciePmTrapExecuted = FALSE;
+  return EFI_SUCCESS;
+}
+
+/**
+  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
+
+  @param[in] ImageHandle          The image handle of this module
+  @param[in] SystemTable          The EFI System Table
+
+  @retval EFI_SUCCESS             The function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+InitializeCpuPcieSmm (
+  IN      EFI_HANDLE            ImageHandle,
+  IN      EFI_SYSTEM_TABLE      *SystemTable
+  )
+{
+  EFI_STATUS                            Status;
+  UINT8                                 PortIndex;
+  UINT8                                 Data8;
+  UINT32                                Data32Or;
+  UINT32                                Data32And;
+  UINT64                                RpBase;
+  UINTN                                 RpDevice;
+  UINTN                                 RpFunction;
+  EFI_HANDLE                            PcieHandle;
+  EFI_HANDLE                            PchIoTrapHandle;
+  PCH_PCIE_SMI_DISPATCH_PROTOCOL        *PchPcieSmiDispatchProtocol;
+  EFI_SMM_IO_TRAP_REGISTER_CONTEXT      PchIoTrapContext;
+  EFI_SMM_SX_REGISTER_CONTEXT           SxDispatchContext;
+  SA_IOTRAP_SMI_PROTOCOL                *CpuPcieIoTrapProtocol;
+  EFI_HANDLE                            SxDispatchHandle;
+  UINT8                                 MaxPciePortNum;
+  CPU_PCIE_HOB                          *CpuPcieHob;
+
+  DEBUG ((DEBUG_INFO, "InitializeCpuPcieSmm () Start\n"));
+
+  MaxPciePortNum    = GetMaxCpuPciePortNum ();
+
+  //
+  // Locate Pch Pcie Smi Dispatch Protocol
+  //
+  Status = gSmst->SmmLocateProtocol (&gPchPcieSmiDispatchProtocolGuid, NULL, (VOID**) &PchPcieSmiDispatchProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  mTempRootPortBusNumMin = PcdGet8 (PcdSiliconInitTempPciBusMin);
+  mTempRootPortBusNumMax = PcdGet8 (PcdSiliconInitTempPciBusMax);
+
+  ///
+  /// Locate HOB for CPU PCIe
+  ///
+  CpuPcieHob = GetFirstGuidHob(&gCpuPcieHobGuid);
+  if (CpuPcieHob != NULL) {
+    ASSERT (sizeof mCpuPcieRootPortConfig == sizeof CpuPcieHob->RootPort);
+    CopyMem (
+      mCpuPcieRootPortConfig,
+      &(CpuPcieHob->RootPort),
+      sizeof (mCpuPcieRootPortConfig)
+      );
+  }
+
+  //
+  // Throught all PCIE root port function and register the SMI Handler for enabled ports.
+  //
+  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
+    GetCpuPcieRpDevFun (PortIndex, &RpDevice, &RpFunction);
+    RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, (UINT32) RpDevice, (UINT32) RpFunction, 0);
+    //
+    // Skip the root port function which is not enabled
+    //
+    if (PciSegmentRead32 (RpBase) == 0xFFFFFFFF) {
+      continue;
+    }
+
+    //
+    // Register SMI Handlers for Hot Plug and Link Active State Change
+    //
+    Data8 = PciSegmentRead8 (RpBase + R_PCIE_SLCAP);
+    if (Data8 & B_PCIE_SLCAP_HPC) {
+      PcieHandle = NULL;
+      Status = PchPcieSmiDispatchProtocol->HotPlugRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             CpuPcieSmiRpHandlerFunction,
+                                             (PortIndex + CpuRpIndex0),
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+
+      Status = PchPcieSmiDispatchProtocol->LinkActiveRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             CpuPcieLinkActiveStateChange,
+                                             (PortIndex + CpuRpIndex0),
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+
+      Data32Or  = B_PCIE_MPC_HPME;
+      Data32And = (UINT32) ~B_PCIE_MPC_HPME;
+      S3BootScriptSaveMemReadWrite (
+        S3BootScriptWidthUint32,
+        PcdGet64 (PcdSiPciExpressBaseAddress) + RpBase + R_PCIE_MPC,
+        &Data32Or,  /// Data to be ORed
+        &Data32And  /// Data to be ANDed
+        );
+    }
+
+    //
+    // Register SMI Handler for Link Equalization Request from Gen 3 Devices.
+    //
+    Data8 = PciSegmentRead8 (RpBase + R_PCIE_LCAP);
+    if ((Data8 & B_PCIE_LCAP_MLS) == V_PCIE_LCAP_MLS_GEN3) {
+      Status = PchPcieSmiDispatchProtocol->LinkEqRegister (
+                                             PchPcieSmiDispatchProtocol,
+                                             CpuPcieLinkEqHandlerFunction,
+                                             (PortIndex + CpuRpIndex0),
+                                             &PcieHandle
+                                             );
+      ASSERT_EFI_ERROR (Status);
+    }
+  }
+
+  ASSERT_EFI_ERROR (Status);
+  PchIoTrapContext.Type     = WriteTrap;
+  PchIoTrapContext.Length   = 4;
+  PchIoTrapContext.Address  = 0;
+  Status = mPchIoTrap->Register (
+                         mPchIoTrap,
+                         (EFI_SMM_HANDLER_ENTRY_POINT2) CpuPcieIoTrapSmiCallback,
+                         &PchIoTrapContext,
+                         &PchIoTrapHandle
+                         );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Install the SA Pcie IoTrap protocol
+  //
+  (gBS->AllocatePool) (EfiBootServicesData, sizeof (SA_IOTRAP_SMI_PROTOCOL), (VOID **)&CpuPcieIoTrapProtocol);
+  CpuPcieIoTrapProtocol->SaIotrapSmiAddress = PchIoTrapContext.Address;
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &ImageHandle,
+                  &gCpuPcieIoTrapProtocolGuid,
+                  CpuPcieIoTrapProtocol,
+                  NULL
+                  );
+
+  //
+  // Register the callback for S3 entry
+  //
+  SxDispatchContext.Type  = SxS3;
+  SxDispatchContext.Phase = SxEntry;
+  Status = mSxDispatch->Register (
+                          mSxDispatch,
+                          CpuPcieS3EntryCallBack,
+                          &SxDispatchContext,
+                          &SxDispatchHandle
+                          );
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((DEBUG_INFO, "InitializeCpuPcieSmm, IoTrap @ %x () End\n", PchIoTrapContext.Address));
+
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.c b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.c
new file mode 100644
index 0000000000..0e9ba41f1b
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.c
@@ -0,0 +1,112 @@
+/** @file
+  This SMM driver will handle SA relevant late initialization
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#include <Library/BaseLib.h>
+#include <Base.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PcdLib.h>
+#include <Library/IoLib.h>
+#include <Library/HobLib.h>
+#include <Library/SaPlatformLib.h>
+#include <Protocol/SmmIoTrapDispatch2.h>
+#include "SaLateInitSmm.h"
+#include <Library/PciSegmentLib.h>
+#include <CpuDataStruct.h>
+#include <CpuPcieHob.h>
+#include <Protocol/SaIotrapSmi.h>
+#include <PchPcieRpConfig.h>
+#include <SaConfigHob.h>
+#include "CpuPcieInfo.h"
+#include <Register/CpuPcieRegs.h>
+#include <IndustryStandard/Pci30.h>
+#include <Register/IgdRegs.h>
+#include <Register/CommonMsr.h>
+
+typedef enum {
+  EnumSaSmiCallbackForMaxPayLoad,
+  EnumSaSmiCallbackForSaSaveRestore,
+  EnumSaSmiCallbackForLateInit,
+  EnumSaSmiCallbackForS3resume,
+  EnumSaSmiCallbackMax
+} SMI_OPERATION;
+
+GLOBAL_REMOVE_IF_UNREFERENCED UINT8                           mSaSmiCallbackPhase      = EnumSaSmiCallbackForMaxPayLoad;
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
+
+
+typedef struct {
+  UINT64  BaseAddr;
+  UINT32  Offset;
+  UINT32  AndMask;
+  UINT32  OrMask;
+} BOOT_SCRIPT_REGISTER_SETTING;
+
+/**
+  Initializes the SA SMM handler
+
+  @param[in] ImageHandle - The image handle of Wake On Lan driver
+  @param[in] SystemTable - The standard EFI system table
+
+  @retval EFI_SUCCESS    - SA SMM handler was installed or not necessary
+  @retval EFI_NOT_FOUND  - Fail to register SMI callback or required protocol/hob missing.
+**/
+EFI_STATUS
+EFIAPI
+SaLateInitSmmEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
+  CPU_PCIE_HOB                              *CpuPcieHob = NULL;
+  EFI_STATUS                                Status;
+#endif
+
+  DEBUG ((DEBUG_INFO, "SaLateInitSmmEntryPoint()\n"));
+
+#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
+  CpuPcieHob = (CPU_PCIE_HOB *) GetFirstGuidHob (&gCpuPcieHobGuid);
+  Status = EFI_NOT_FOUND;
+  if (CpuPcieHob == NULL) {
+    DEBUG ((DEBUG_INFO, "CPU PCIE HOB Not found\n"));
+    ASSERT (CpuPcieHob != NULL);
+    return Status;
+  }
+
+  ///
+  /// Locate the PCH Trap dispatch protocol
+  ///
+  Status = gSmst->SmmLocateProtocol (&gEfiSmmIoTrapDispatch2ProtocolGuid, NULL, (VOID **) &mPchIoTrap);
+  ASSERT_EFI_ERROR (Status);
+  Status = gSmst->SmmLocateProtocol (&gEfiSmmSxDispatch2ProtocolGuid, NULL, (VOID**) &mSxDispatch);
+  ASSERT_EFI_ERROR (Status);
+  if (Status == EFI_SUCCESS) {
+    ///
+    /// If ASPM policy is set to "Before OPROM", this SMI callback is not necessary
+    /// Ensure the SMI callback handler will directly return and continue the POST.
+    ///
+    mSaSmiCallbackPhase = EnumSaSmiCallbackMax;
+    Status = EFI_SUCCESS;
+  }
+
+  Status = InitializeCpuPcieSmm (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  if (Status != EFI_SUCCESS) {
+    DEBUG ((DEBUG_ERROR, "Failed to register SaIotrapSmiCallback!\n"));
+    ///
+    /// System will halt when failing to register required SMI handler
+    ///
+    CpuDeadLoop ();
+  }
+#endif
+  return EFI_SUCCESS;
+}
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.h b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.h
new file mode 100644
index 0000000000..c93f92305c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.h
@@ -0,0 +1,122 @@
+/** @file
+  Header file for SA SMM Handler
+
+  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+  SPDX-License-Identifier: BSD-2-Clause-Patent
+**/
+#ifndef _SaLateInitSmm_H_
+#define _SaLateInitSmm_H_
+
+///
+/// Driver Consumed Protocol Prototypes
+///
+
+#include <Protocol/SmmBase2.h>
+#include <Protocol/SmmSxDispatch2.h>
+#include <Protocol/SmmIoTrapDispatch2.h>
+#include <Protocol/SaPolicy.h>
+#include <Library/S3BootScriptLib.h>
+#include <CpuPcieConfig.h>
+#include <Library/CpuPcieInfoFruLib.h>
+
+extern EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
+extern EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
+
+///
+/// The value before AutoConfig match the setting of PCI Express Base Specification 1.1, please be careful for adding new feature
+///
+typedef enum {
+  PcieAspmDisabled,
+  PcieAspmL0s,
+  PcieAspmL1,
+  PcieAspmL0sL1,
+  PcieAspmAutoConfig,
+  PcieAspmMax
+} CPU_PCIE_ASPM_CONFIG;
+
+typedef struct {
+  UINT64                    Address;
+  S3_BOOT_SCRIPT_LIB_WIDTH  Width;
+  UINT32                    Value;
+} BOOT_SCRIPT_PCI_REGISTER_SAVE;
+
+
+/**
+  <b>System Agent Initialization SMM Driver Entry Point</b>
+  - <b>Introduction</b> \n
+    This is an optional driver to support PCIe ASPM initialization later than Option ROM initialization.\n
+    In this scenario S3 Save Boot Script table has been closed per security consideration so the ASPM settings will be stored in SMM memory and restored during S3 resume.
+    If platform does not support this scenario this driver can be excluded and SI_SA_POLICY_PPI -> PCIE_CONFIG -> InitPcieAspmAfterOprom must be set to FALSE. \n
+    Note: When InitPcieAspmAfterOprom enabled, the SMI callback handler must be registered successfully, otherwise it will halt the system.
+
+  - @pre
+    - _EFI_SMM_BASE_PROTOCOL (or _EFI_SMM_BASE2_PROTOCOL for EDK2): Provides SMM infrastructure services.
+    - _EFI_SMM_IO_TRAP_DISPATCH_PROTOCOL (or _EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL for EDK2): Interface structure for the SMM IO trap specific SMI Dispatch Protocol
+    - SA_POLICY_PROTOCOL: A protocol published by a platform DXE module executed earlier; this is documented in this document as well.
+
+  - @result
+    PCIe ASPM has been initialized on all end point devices discovered and same settings will be restored during S3 resume.
+
+  @param[in] ImageHandle - The image handle of Wake On Lan driver
+  @param[in] SystemTable - The standard EFI system table
+
+  @retval EFI_SUCCESS    - SA SMM handler was installed or not necessary
+  @retval EFI_NOT_FOUND  - Fail to register SMI callback or required protocol/hob missing.
+**/
+EFI_STATUS
+EFIAPI
+SaLateInitSmmEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+/**
+An IoTrap callback to config PCIE power management settings
+
+@param[in] DispatchHandle  - The handle of this callback, obtained when registering
+@param[in] DispatchContext - Pointer to the EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
+
+**/
+VOID
+EFIAPI
+CpuPcieIoTrapSmiCallback(
+IN     EFI_HANDLE                     DispatchHandle,
+IN     EFI_SMM_IO_TRAP_CONTEXT        *CallbackContext,
+IN OUT VOID                           *CommBuffer,
+IN OUT UINTN                          *CommBufferSize
+);
+
+/**
+  This function is used to set or clear flags at S3 entry
+  Clear the Io trap executed flag before enter S3
+
+  @param[in] Handle              Handle of the callback
+  @param[in] Context             The dispatch context
+  @param[in,out] CommBuffer      A pointer to a collection of data in memory that will be conveyed from a non-SMM environment into an SMM environment.
+  @param[in,out] CommBufferSize  The size of the CommBuffer.
+  @retval EFI_SUCCESS            SA register saved
+**/
+EFI_STATUS
+EFIAPI
+CpuPcieS3EntryCallBack (
+  IN  EFI_HANDLE                   Handle,
+  IN CONST VOID                    *Context OPTIONAL,
+  IN OUT VOID                      *CommBuffer OPTIONAL,
+  IN OUT UINTN                     *CommBufferSize OPTIONAL
+  );
+
+/**
+  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
+
+  @param[in] ImageHandle          The image handle of this module
+  @param[in] SystemTable          The EFI System Table
+
+  @retval EFI_SUCCESS             The function completes successfully
+**/
+EFI_STATUS
+EFIAPI
+InitializeCpuPcieSmm (
+  IN      EFI_HANDLE            ImageHandle,
+  IN      EFI_SYSTEM_TABLE      *SystemTable
+  );
+#endif
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.inf b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.inf
new file mode 100644
index 0000000000..ef3486d2a6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.inf
@@ -0,0 +1,72 @@
+## @file
+# Component description file for the SA late initialization SMM module.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+INF_VERSION = 0x00010017
+BASE_NAME = SaLateInitSmm
+FILE_GUID = 2D1E361C-7B3F-4d15-8B1F-66E551FABDC7
+VERSION_STRING = 1.0
+MODULE_TYPE = DXE_SMM_DRIVER
+PI_SPECIFICATION_VERSION = 1.10
+ENTRY_POINT = SaLateInitSmmEntryPoint
+
+[LibraryClasses]
+UefiDriverEntryPoint
+UefiBootServicesTableLib
+DxeServicesTableLib
+DebugLib
+HobLib
+BaseLib
+S3BootScriptLib
+PciSegmentLib
+SaPlatformLib
+TimerLib
+PciExpressHelpersLib
+PcdLib
+S3BootScriptLib
+CpuPcieInfoFruLib
+ConfigBlockLib
+CpuPcieRpLib
+
+[Packages]
+MdePkg/MdePkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[Pcd]
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax
+gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin
+gSiPkgTokenSpaceGuid.PcdCpuPcieEnable              ## CONSUMES
+
+
+[Sources]
+SaLateInitSmm.c
+CpuPcieSmm.c
+SaLateInitSmm.h
+
+[Protocols]
+gSaPolicyProtocolGuid              ## CONSUMES
+gEfiSmmIoTrapDispatch2ProtocolGuid ## CONSUMES
+gSaIotrapSmiProtocolGuid           ## PRODUCES
+gCpuPcieIoTrapProtocolGuid         ## PRODUCES
+gEfiSmmSxDispatch2ProtocolGuid     ## CONSUMES
+gPchSmiDispatchProtocolGuid        ## CONSUMES
+gPchPcieSmiDispatchProtocolGuid    ## CONSUMES
+
+[Guids]
+gSaConfigHobGuid
+gCpuPcieHobGuid
+gPcieDxeConfigGuid
+gSaPegHobGuid
+
+[Depex]
+gEfiSmmBase2ProtocolGuid AND
+gEfiSmmSxDispatch2ProtocolGuid AND
+gEfiSmmIoTrapDispatch2ProtocolGuid AND
+gSaPolicyProtocolGuid
+
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (35 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 39/40] TigerlakeSiliconPkg: Add package " Heng Luo
                   ` (2 subsequent siblings)
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Adds the following DSC files:
  * Fru/TglCpu
  * Fru/TglPch

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc | 11 +++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc       |  9 +++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc    | 20 ++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc       |  8 ++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc    |  7 +++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc | 30 ++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc       |  9 +++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc    | 13 +++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc       |  8 ++++++++
 Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc    | 10 ++++++++++
 10 files changed, 125 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc
new file mode 100644
index 0000000000..99ee0eccac
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc
@@ -0,0 +1,11 @@
+## @file
+#  Component description file for the TigerLake CPU Common FRU libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+VtdInfoLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/PeiDxeSmmVtdInfoLib.inf
+CpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
+CpuPcieInfoFruLib|$(PLATFORM_SI_PACKAGE)/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc
new file mode 100644
index 0000000000..874e4cbaad
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc
@@ -0,0 +1,9 @@
+## @file
+#  Component description file for the Tigerlake CPU DXE FRU drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc
new file mode 100644
index 0000000000..5c72c2ac61
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc
@@ -0,0 +1,20 @@
+## @file
+#  Component description file for the Tigerlake CPU DXE FRU libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+DxeGraphicsPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/LibraryPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf
+DxeGraphicsInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/LibraryPrivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf
+DxeIgdOpRegionInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/LibraryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf
+DxeVtdInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitLib.inf
+DxeVtdPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf
+DxeVtdInitFruLib|$(PLATFORM_SI_PACKAGE)/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib/DxeVtdInitFruLib.inf
+
+
+#
+#  CPU PCIe IpBlock
+#
+DxeCpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc
new file mode 100644
index 0000000000..de8288364a
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc
@@ -0,0 +1,8 @@
+## @file
+#  Component description file for the Tigerlake CPU PEI FRU drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc
new file mode 100644
index 0000000000..5355ecb288
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc
@@ -0,0 +1,7 @@
+## @file
+#  Component description file for the Tigerlake CPU PEI FRU ibraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc
new file mode 100644
index 0000000000..b7ba1f752c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc
@@ -0,0 +1,30 @@
+## @file
+#  Component description file for the Tigerlake PCH Common FRU libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+  PsfLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSmmPsfLibVer2.inf
+  PchPcrLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/PeiDxeSmmPchPcrLib.inf
+  PchSbiAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
+  GbeMdiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf
+  GbeLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/PeiDxeSmmGbeLib.inf
+  EspiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Espi/Library/PeiDxeSmmEspiLib/PeiDxeSmmEspiLib.inf
+  PmcLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/PeiDxeSmmPmcLib.inf
+  PmcPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
+  PmcPrivateLibWithS3|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
+  SpiCommonLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/LibraryPrivate/BaseSpiCommonLib/BaseSpiCommonLib.inf
+  GpioLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/PeiDxeSmmGpioLib.inf
+  GpioPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
+  GpioCheckConflictLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/Library/BaseGpioCheckConflictLib/BaseGpioCheckConflictLib.inf
+  PchDmiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf
+  PchDmiWithS3Lib|$(PLATFORM_SI_PACKAGE)/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
+  SataLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Sata/Library/PeiDxeSmmSataLib/PeiDxeSmmSataLibVer2.inf
+  SpiAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib/PeiDxeSmmSpiAccessLib.inf
+  SpiAccessPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
+  PchPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/Library/PeiDxeSmmPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
+  PcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf
+  PciExpressHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
+  BasePcieHelperLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/Library/BasePcieHelperLib/BasePcieHelperLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc
new file mode 100644
index 0000000000..9fefc6b4c9
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc
@@ -0,0 +1,9 @@
+## @file
+#  Component description file for the Tigerlake PCH DXE FRU drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/Smm/SpiSmm.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc
new file mode 100644
index 0000000000..e9be448baa
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc
@@ -0,0 +1,13 @@
+## @file
+#  Component description file for the Tigerlake PCH DXE FRU libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+  DxeHdaNhltLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHdaNhltLib.inf
+  DxeHdaPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib/DxeHdaPolicyLib.inf
+  GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
+  GpioNameBufferLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf
+  DxeGpioPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyLib/DxeGpioPolicyLib.inf
+  DxePchPcieRpPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc
new file mode 100644
index 0000000000..2eacbe905c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc
@@ -0,0 +1,8 @@
+## @file
+#  Component description file for the Tigerlake PCH PEI FRU drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc
new file mode 100644
index 0000000000..d8e6313084
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc
@@ -0,0 +1,10 @@
+## @file
+#  Component description file for the Tigerlake PCH PEI FRU libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+  GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpersLib/PeiGpioHelpersLib.inf
+  GpioNameBufferLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 39/40] TigerlakeSiliconPkg: Add package DSC files
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (36 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:56   ` Nate DeSimone
  2021-02-01  1:36 ` [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers Heng Luo
  2021-02-04  3:51 ` [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Nate DeSimone
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc    | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc      |  49 +++++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc            |  47 +++++++++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc         |  40 ++++++++++++++++++++++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc            |  20 ++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc         |  20 ++++++++++++++++++++
 Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc | 229 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 7 files changed, 527 insertions(+)

diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc
new file mode 100644
index 0000000000..51c40812ea
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc
@@ -0,0 +1,122 @@
+## @file
+#  Silicon build option configuration file.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[BuildOptions]
+# Define Build Options both for EDK and EDKII drivers.
+
+  DEFINE PCH_BUILD_OPTIONS = -DPCH_TGL
+#
+# SA
+#
+!if gSiPkgTokenSpaceGuid.PcdBdatEnable == TRUE
+  DEFINE BDAT_BUILD_OPTION = -DBDAT_SUPPORT=1
+!else
+  DEFINE BDAT_BUILD_OPTION =
+!endif
+
+  DEFINE SLE_BUILD_OPTIONS =
+!if $(TARGET) == RELEASE
+!if gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable == TRUE
+  DEFINE DEBUG_BUILD_OPTIONS =
+!else
+  # MDEPKG_NDEBUG is introduced for the intention
+  # of size reduction when compiler optimization is disabled. If MDEPKG_NDEBUG is
+  # defined, then debug and assert related macros wrapped by it are the NULL implementations.
+  DEFINE DEBUG_BUILD_OPTIONS = -DMDEPKG_NDEBUG
+!endif
+!else
+  DEFINE DEBUG_BUILD_OPTIONS =
+!endif
+
+!if ($(TARGET) == RELEASE) AND (gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable == TRUE)
+  DEFINE RELEASE_CATALOG_BUILD_OPTIONS = -DRELEASE_CATALOG
+!else
+  DEFINE RELEASE_CATALOG_BUILD_OPTIONS =
+!endif
+
+!if gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable == FALSE
+  DEFINE OPTIMIZE_DISABLE_OPTIONS = -Od -GL-
+!else
+  DEFINE OPTIMIZE_DISABLE_OPTIONS =
+!endif
+
+  DEFINE HSLE_BUILD_OPTIONS =
+
+
+  DEFINE CPU_FLAGS = -DCPU_ICL -DCPU_TGL
+
+
+  DEFINE RESTRICTED_OPTION =
+
+!if gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported == FALSE
+  *_*_*_MRC_NDEBUG = -DMDEPKG_NDEBUG
+!endif
+
+DEFINE DSC_SIPKG_FEATURE_BUILD_OPTIONS = $(BDAT_BUILD_OPTION) $(DEBUG_BUILD_OPTIONS)
+DEFINE DSC_SIPKG_FEATURE_BUILD_OPTIONS = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(PCH_BUILD_OPTIONS) $(CPU_FLAGS) $(HSLE_BUILD_OPTIONS)
+
+!if gSiPkgTokenSpaceGuid.PcdSourceDebugEnable == TRUE
+  *_*_X64_GENFW_FLAGS = --keepexceptiontable
+!endif
+
+[BuildOptions.Common.EDKII]
+
+#
+# For IA32 Global Build Flag
+#
+       *_*_IA32_CC_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) -D PI_SPECIFICATION_VERSION=0x00010015 -DASF_PEI
+       *_*_IA32_VFRPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_IA32_APP_FLAGS     = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_IA32_ASLPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_IA32_ASLCC_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+
+#
+# For IA32 Specific Build Flag
+#
+GCC:   *_*_IA32_PP_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+MSFT:  *_*_IA32_ASM_FLAGS     = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+MSFT:  *_*_IA32_CC_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS) -D PI_SPECIFICATION_VERSION=0x00010015 -DASF_PEI /w34668
+MSFT:  *_*_IA32_VFRPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+MSFT:  *_*_IA32_APP_FLAGS     = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+MSFT:  *_*_IA32_ASLPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+MSFT:  *_*_IA32_ASLCC_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+
+#
+# For X64 Global Build Flag
+#
+       *_*_X64_CC_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) -D PI_SPECIFICATION_VERSION=0x00010015
+       *_*_X64_VFRPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_X64_APP_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_X64_ASLPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+       *_*_X64_ASLCC_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+
+#
+# For X64 Specific Build Flag
+#
+GCC:   *_*_X64_PP_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+MSFT:  *_*_X64_ASM_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+MSFT:  *_*_X64_CC_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS) -D PI_SPECIFICATION_VERSION=0x00010015 /w34668
+MSFT:  *_*_X64_VFRPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+MSFT:  *_*_X64_APP_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
+MSFT:  *_*_X64_ASLPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+MSFT:  *_*_X64_ASLCC_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
+
+#
+# For Xcode Specific Build Flag
+#
+# Override assembly code build order
+*_XCODE5_*_*_BUILDRULEORDER = nasm S s
+# Align 47bfbd7f8069e523798ef973c8eb0abd5c6b0746 to fix the usage of VA_START in undefined way
+*_XCODE5_*_CC_FLAGS = -Wno-varargs
+
+# Force PE/COFF sections to be aligned at 4KB boundaries to support page level protection of runtime modules
+[BuildOptions.common.EDKII.DXE_RUNTIME_DRIVER]
+  MSFT:  *_*_*_DLINK_FLAGS      = /ALIGN:4096
+  GCC:   *_GCC*_*_DLINK_FLAGS   = -z common-page-size=0x1000
+
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc
new file mode 100644
index 0000000000..d93ecfc9d6
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc
@@ -0,0 +1,49 @@
+## @file
+#  Component description file for the TigerLake silicon package both Pei and Dxe libraries DSC file.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+#
+# Set PCH generation according PCD.
+# The DEFINE will be used to select PCH library INF file corresponding to PCH generation
+#
+DEFINE  PCH = Cnl
+
+#
+# FRUs
+#
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/CommonLib.dsc
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/CommonLib.dsc
+
+#
+# Common
+#
+ MmPciLib|$(PLATFORM_SI_PACKAGE)/Library/PeiDxeSmmMmPciLib/PeiDxeSmmMmPciLib.inf
+ PciSegmentLib|$(PLATFORM_SI_PACKAGE)/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf
+
+#
+# Pch
+#
+ PchCycleDecodingLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/PeiDxeSmmPchCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf
+ PchInfoLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeSmmPchInfoLibTgl.inf
+ CpuPcieInitCommonLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
+ CpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
+
+ SerialIoAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/SerialIo/Library/PeiDxeSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
+ SerialIoPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
+ ResetSystemLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/BaseResetSystemLib/BaseResetSystemLib.inf
+ #private
+ GpioPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
+
+ SiScheduleResetLib|$(PLATFORM_SI_PACKAGE)/Pch/LibraryPrivate/BaseSiScheduleResetLib/BaseSiScheduleResetLib.inf
+ PchPciBdfLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/BasePchPciBdfLib/BasePchPciBdfLib.inf
+ PcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/PcieClientRpLib/PcieClientRpLib.inf
+
+#
+# SA
+#
+ SaPlatformLib|$(PLATFORM_SI_PACKAGE)/SystemAgent/Library/PeiDxeSmmSaPlatformLib/PeiDxeSmmSaPlatformLib.inf
+ CpuRegbarAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/Library/PeiDxeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc
new file mode 100644
index 0000000000..1a08fbc24c
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc
@@ -0,0 +1,47 @@
+## @file
+#  Component description file for the TigerLake silicon package DXE drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+#
+# FRUs
+#
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/Dxe.dsc
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/Dxe.dsc
+
+#
+# Common
+#
+
+#
+# Pch
+#
+  $(PLATFORM_SI_PACKAGE)/Pch/PchInit/Dxe/PchInitDxeTgl.inf
+  $(PLATFORM_SI_PACKAGE)/Pch/SmmControl/RuntimeDxe/SmmControl.inf
+
+  $(PLATFORM_SI_PACKAGE)/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.inf{
+    <LibraryClasses>
+      #SmiHandlerProfileLib|MdeModulePkg/Library/SmmSmiHandlerProfileLib/SmmSmiHandlerProfileLib.inf
+      SmiHandlerProfileLib|MdePkg/Library/SmiHandlerProfileLibNull/SmiHandlerProfileLibNull.inf
+  }
+  $(PLATFORM_SI_PACKAGE)/Pch/PchInit/Smm/PchInitSmm.inf
+
+#
+# SystemAgent
+#
+
+  $(PLATFORM_SI_PACKAGE)/SystemAgent/SaInit/Dxe/SaInitDxe.inf
+
+  $(PLATFORM_SI_PACKAGE)/SystemAgent/SaInit/Smm/SaLateInitSmm.inf {
+    <LibraryClasses>
+      S3BootScriptLib|MdePkg/Library/BaseS3BootScriptLibNull/BaseS3BootScriptLibNull.inf
+  }
+
+!if gSiPkgTokenSpaceGuid.PcdAcpiEnable == TRUE
+  $(PLATFORM_SI_PACKAGE)/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf
+  $(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
+!endif
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc
new file mode 100644
index 0000000000..210fb37332
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc
@@ -0,0 +1,40 @@
+## @file
+#  Component description file for the TigerLake silicon package DXE libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+#
+# Silicon Init Dxe Library
+#
+
+#
+# FRUs
+#
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/DxeLib.dsc
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/DxeLib.dsc
+
+#
+# Common
+#
+SiConfigBlockLib|$(PLATFORM_SI_PACKAGE)/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf
+
+#
+# Pch
+#
+DxePchPolicyLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/DxePchPolicyLib/DxePchPolicyLib.inf
+SmmPchPrivateLib|$(PLATFORM_SI_PACKAGE)/Pch/LibraryPrivate/SmmPchPrivateLib/SmmPchPrivateLib.inf
+
+#
+# SystemAgent
+#
+DxeSaPolicyLib|$(PLATFORM_SI_PACKAGE)/SystemAgent/Library/DxeSaPolicyLib/DxeSaPolicyLib.inf
+DxeVtdPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib/DxeVtdPolicyLib.inf
+
+#
+#  CPU PCIe IpBlock
+#
+
+DxeCpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc
new file mode 100644
index 0000000000..15fc5685a5
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc
@@ -0,0 +1,20 @@
+## @file
+#  Component description file for the TigerLake silicon package PEI drivers.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+#
+# Common
+#
+
+#
+# SystemAgent
+#
+
+#
+# Cpu
+#
+
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc
new file mode 100644
index 0000000000..6f90ff02bb
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc
@@ -0,0 +1,20 @@
+## @file
+#  Component description file for the TigerLake silicon package PEI libraries.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+#
+# Silicon Init Pei Library
+#
+
+#
+# FRUs
+#
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/PeiLib.dsc
+
+!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/PeiLib.dsc
+
+ SiConfigBlockLib|$(PLATFORM_SI_PACKAGE)/Library/BaseSiConfigBlockLib/BaseSiConfigBlockLib.inf
diff --git a/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc b/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc
new file mode 100644
index 0000000000..73a2594887
--- /dev/null
+++ b/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc
@@ -0,0 +1,229 @@
+## @file
+#  Component description file for the TigerLake silicon package DSC file.
+#
+#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
+#  SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+[Packages]
+MdePkg/MdePkg.dec
+UefiCpuPkg/UefiCpuPkg.dec
+TigerlakeSiliconPkg/SiPkg.dec
+
+[PcdsFixedAtBuild]
+gSiPkgTokenSpaceGuid.PcdSmmVariableEnable            |TRUE
+gSiPkgTokenSpaceGuid.PcdAtaEnable                    |FALSE
+
+gSiPkgTokenSpaceGuid.PcdAcpiEnable                   |TRUE
+gSiPkgTokenSpaceGuid.PcdSourceDebugEnable            |FALSE
+gSiPkgTokenSpaceGuid.PcdPpmEnable                    |TRUE
+gSiPkgTokenSpaceGuid.PcdPttEnable                    |FALSE
+gSiPkgTokenSpaceGuid.PcdJhiEnable                    |FALSE
+gSiPkgTokenSpaceGuid.PcdSmbiosEnable                 |TRUE
+gSiPkgTokenSpaceGuid.PcdS3Enable                     |TRUE
+gSiPkgTokenSpaceGuid.PcdOverclockEnable              |FALSE
+gSiPkgTokenSpaceGuid.PcdCpuPowerOnConfigEnable       |FALSE
+gSiPkgTokenSpaceGuid.PcdBdatEnable                   |TRUE
+gSiPkgTokenSpaceGuid.PcdIgdEnable                    |TRUE
+gSiPkgTokenSpaceGuid.PcdPegEnable                    |TRUE
+gSiPkgTokenSpaceGuid.PcdSaDmiEnable                  |TRUE
+gSiPkgTokenSpaceGuid.PcdVtdEnable                    |TRUE
+gSiPkgTokenSpaceGuid.PcdBiosGuardEnable              |FALSE  #BiosGuardModule.bin
+gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable       |TRUE
+gSiPkgTokenSpaceGuid.PcdPeiDisplayEnable             |TRUE
+gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable         |FALSE
+gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported     |TRUE
+gSiPkgTokenSpaceGuid.PcdOcWdtEnable                  |TRUE
+gSiPkgTokenSpaceGuid.PcdSerialIoUartEnable           |TRUE
+
+gSiPkgTokenSpaceGuid.PcdThcEnable                    |TRUE
+gSiPkgTokenSpaceGuid.PcdPpamEnable                   |TRUE
+gSiPkgTokenSpaceGuid.PcdEmbeddedEnable               |0x0
+gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                |TRUE
+gSiPkgTokenSpaceGuid.PcdHybridStorageSupport         |TRUE
+
+!if gSiPkgTokenSpaceGuid.PcdPpamEnable == TRUE
+#
+# PCD for State Save Support on DGR
+# TRUE - SMM State Save region access is protected
+# FALSE - SMM can have Read/Write access to SMM State Save region
+#
+gSiPkgTokenSpaceGuid.PcdSpsStateSaveEnable           |FALSE
+#
+# PCD to enable SPA Support on DGR
+# Note: This PCD is mainly used for Debugging purpose. Not recommended to set for End Product.
+#
+gSiPkgTokenSpaceGuid.PcdSpaEnable                    |FALSE
+!endif
+
+[PcdsFixedAtBuild.common]
+gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress       |0xC0000000
+gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress         |gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
+gSiPkgTokenSpaceGuid.PcdTemporaryPciExpressRegionLength |0x10000000
+
+[PcdsDynamicDefault.common]
+gSiPkgTokenSpaceGuid.PcdPciExpressRegionLength          |0x10000000
+## Specifies the AP wait loop state during POST phase.
+#  The value is defined as below.
+#  1: Place AP in the Hlt-Loop state.
+#  2: Place AP in the Mwait-Loop state.
+#  3: Place AP in the Run-Loop state.
+# @Prompt The AP wait loop state.
+gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode|2
+## Specifies the AP target C-state for Mwait during POST phase.
+#  The default value 0 means C1 state.
+#  The value is defined as below.<BR><BR>
+# @Prompt The specified AP target C-state for Mwait.
+gUefiCpuPkgTokenSpaceGuid.PcdCpuApTargetCstate|0
+
+[Defines]
+  PLATFORM_NAME = TigerlakeSiliconPkg
+  PLATFORM_GUID = CCD38CA7-61D3-4185-9CDA-A9FDF209CB31
+  PLATFORM_VERSION = 0.4
+  DSC_SPECIFICATION = 0x00010005
+  OUTPUT_DIRECTORY = Build/TigerlakeSiliconPkg
+  SUPPORTED_ARCHITECTURES = IA32|X64
+  BUILD_TARGETS = DEBUG|RELEASE
+  SKUID_IDENTIFIER = DEFAULT
+
+  DEFINE   PLATFORM_SI_PACKAGE        = TigerlakeSiliconPkg
+  #
+  # Definition for Build Flag
+  #
+  !include $(PLATFORM_SI_PACKAGE)/SiPkgBuildOption.dsc
+
+[LibraryClasses.common]
+  #
+  # Entry point
+  #
+  PeiCoreEntryPoint|MdePkg/Library/PeiCoreEntryPoint/PeiCoreEntryPoint.inf
+  PeimEntryPoint|MdePkg/Library/PeimEntryPoint/PeimEntryPoint.inf
+  DxeCoreEntryPoint|MdePkg/Library/DxeCoreEntryPoint/DxeCoreEntryPoint.inf
+  UefiDriverEntryPoint|MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntryPoint.inf
+  UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
+  PeCoffExtraActionLib|MdePkg/Library/BasePeCoffExtraActionLibNull/BasePeCoffExtraActionLibNull.inf
+
+  #
+  # Basic
+  #
+  BaseLib|MdePkg/Library/BaseLib/BaseLib.inf
+  BaseMemoryLib|MdePkg/Library/BaseMemoryLibRepStr/BaseMemoryLibRepStr.inf
+  PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf
+  CpuLib|MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
+  IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
+  PciSegmentLib|$(PLATFORM_SI_PACKAGE)/Library/BasePciSegmentMultiSegLibPci/BasePciSegmentMultiSegLibPci.inf
+  PciLib|MdePkg/Library/BasePciLibPciExpress/BasePciLibPciExpress.inf
+  PciCf8Lib|MdePkg/Library/BasePciCf8Lib/BasePciCf8Lib.inf
+  CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
+  PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
+  PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
+  PciExpressLib|MdePkg/Library/BasePciExpressLib/BasePciExpressLib.inf
+  PostCodeLib|MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort80.inf
+
+  #
+  # UEFI & PI
+  #
+  UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf
+  UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf
+  UefiRuntimeLib|MdePkg/Library/UefiRuntimeLib/UefiRuntimeLib.inf
+  UefiLib|MdePkg/Library/UefiLib/UefiLib.inf
+  DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
+  PeiServicesTablePointerLib|MdePkg/Library/PeiServicesTablePointerLibIdt/PeiServicesTablePointerLibIdt.inf
+  PeiServicesLib|MdePkg/Library/PeiServicesLib/PeiServicesLib.inf
+  DxeServicesLib|MdePkg/Library/DxeServicesLib/DxeServicesLib.inf
+  DxeServicesTableLib|MdePkg/Library/DxeServicesTableLib/DxeServicesTableLib.inf
+
+  S3BootScriptLib|MdePkg/Library/BaseS3BootScriptLibNull/BaseS3BootScriptLibNull.inf
+  S3IoLib|MdePkg/Library/BaseS3IoLib/BaseS3IoLib.inf
+  S3PciLib|MdePkg/Library/BaseS3PciLib/BaseS3PciLib.inf
+
+  UefiUsbLib|MdePkg/Library/UefiUsbLib/UefiUsbLib.inf
+  UefiScsiLib|MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
+  SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
+
+  DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
+
+  #
+  # Misc
+  #
+  DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
+  PerformanceLib|MdePkg/Library/BasePerformanceLibNull/BasePerformanceLibNull.inf
+  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
+  TimerLib|MdePkg/Library/BaseTimerLibNullTemplate/BaseTimerLibNullTemplate.inf
+  ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseReportStatusCodeLibNull.inf
+  MtrrLib|UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
+  RngLib|MdePkg/Library/BaseRngLib/BaseRngLib.inf
+
+#####################################################################################################
+
+#
+# Silicon Init Common Library
+#
+!include $(PLATFORM_SI_PACKAGE)/SiPkgCommonLib.dsc
+ConfigBlockLib|IntelSiliconPkg/Library/BaseConfigBlockLib/BaseConfigBlockLib.inf
+
+[LibraryClasses.IA32]
+#
+# PEI phase common
+#
+  PcdLib|MdePkg/Library/PeiPcdLib/PeiPcdLib.inf
+  HobLib|MdePkg/Library/PeiHobLib/PeiHobLib.inf
+  MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
+  ExtractGuidedSectionLib|MdePkg/Library/PeiExtractGuidedSectionLib/PeiExtractGuidedSectionLib.inf
+  PeiGetVtdPmrAlignmentLib|IntelSiliconPkg/Library/PeiGetVtdPmrAlignmentLib/PeiGetVtdPmrAlignmentLib.inf
+
+#####################################################################################################################################
+
+#
+# Silicon Init Pei Library
+#
+!include $(PLATFORM_SI_PACKAGE)/SiPkgPeiLib.dsc
+
+[LibraryClasses.IA32.SEC]
+  GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
+
+[LibraryClasses.X64]
+ #
+ # DXE phase common
+ #
+  HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
+  PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+  ExtractGuidedSectionLib|MdePkg/Library/DxeExtractGuidedSectionLib/DxeExtractGuidedSectionLib.inf
+
+#
+# Hsti
+#
+  HstiLib|MdePkg/Library/DxeHstiLib/DxeHstiLib.inf
+
+###################################################################################################
+#
+# Silicon Init Dxe Library
+#
+!include $(PLATFORM_SI_PACKAGE)/SiPkgDxeLib.dsc
+
+[LibraryClasses.X64.PEIM]
+
+[LibraryClasses.X64.DXE_CORE]
+  HobLib|MdePkg/Library/DxeCoreHobLib/DxeCoreHobLib.inf
+  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
+
+[LibraryClasses.X64.DXE_SMM_DRIVER]
+  SmmServicesTableLib|MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.inf
+  MemoryAllocationLib|MdePkg/Library/SmmMemoryAllocationLib/SmmMemoryAllocationLib.inf
+  SmmIoLib|MdePkg/Library/SmmIoLib/SmmIoLib.inf
+  SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
+
+[LibraryClasses.X64.SMM_CORE]
+
+[LibraryClasses.X64.UEFI_DRIVER]
+  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
+
+[LibraryClasses.X64.UEFI_APPLICATION]
+  PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf
+
+[Components.IA32]
+!include $(PLATFORM_SI_PACKAGE)/SiPkgPei.dsc
+
+[Components.X64]
+!include $(PLATFORM_SI_PACKAGE)/SiPkgDxe.dsc
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (37 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 39/40] TigerlakeSiliconPkg: Add package " Heng Luo
@ 2021-02-01  1:36 ` Heng Luo
  2021-02-04  3:51   ` Nate DeSimone
  2021-02-04  3:51 ` [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Nate DeSimone
  39 siblings, 1 reply; 81+ messages in thread
From: Heng Luo @ 2021-02-01  1:36 UTC (permalink / raw)
  To: devel; +Cc: Sai Chaganty, Nate DeSimone

REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171

Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
Signed-off-by: Heng Luo <heng.luo@intel.com>
---
 Maintainers.txt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Maintainers.txt b/Maintainers.txt
index 56e16fc48c..34f0b58581 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -242,6 +242,12 @@ F: Silicon/Intel/KabylakeSiliconPkg/
 M: Chasel Chiu <chasel.chiu@intel.com>
 M: Sai Chaganty <rangasai.v.chaganty@intel.com>
 
+Silicon/Intel/TigerlakeSiliconPkg
+F: Silicon/Intel/TigerlakeSiliconPkg/
+M: Sai Chaganty <rangasai.v.chaganty@intel.com>
+M: Nate DeSimone <nathaniel.l.desimone@intel.com>
+R: Heng Luo <heng.luo@intel.com>
+
 Silicon/Intel/SimicsX58SktPkg
 F: Silicon/Intel/SimicsX58SktPkg/
 M: Agyeman Prince <prince.agyeman@intel.com>
-- 
2.24.0.windows.2


^ permalink raw reply related	[flat|nested] 81+ messages in thread

* Re: [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers
  2021-02-01  1:36 ` [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers Heng Luo
@ 2021-02-04  3:51   ` Nate DeSimone
  2021-02-04  8:24     ` Heng Luo
  0 siblings, 1 reply; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:51 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

Thank you so much for all your work on this! I have a couple of minor comments, however due to the size of this patch series I produced a summary of these comments here for your convenience:

[PATCH 01/40]

#1) CpuPcieConfigGen3.h is only used on Rocket Lake boards for backwards socket compatibility with Comet Lake. It is not needed for Tiger Lake. Please remove it.
#2) CpuPcieConfig.h - CPU_PCIE_CONFIG Is missing the following from its definition:

CPU_PCIE_ROOT_PORT_CONFIG2         RootPort2[CPU_PCIE_MAX_ROOT_PORTS];
PCIE_COMMON_CONFIG2                PcieCommonConfig2;

[PATCH 02/40]

#1) FspmArchConfigPpi.h is a duplicate of a header file in IntelFsp2Pkg, please remove this duplicate
#2) SiPolicy.h - Please also remove the #include for CpuPcieConfigGen3.h

[PATCH 34/40]

#1) DxeSaPolicyLib.c - There is an old comment that is no longer relevant, please delete.
#2) DxeSaPolicyLibrary.h - Please also remove the #include for CpuPcieConfigGen3.h

[PATCH 35/40]

#1) DxeVtdInitFruLib.c - Comment on line 2 has a typo "Flu" should be "FRU"

[PATCH 36/40]

#1) PchSmiHelper.h - Comment on line 2 has a typo: "eSPI SMI Dispatch header" should be "PCH SMI Helper Header"

[PATCH 39/40]

#1) SiPkgCommonLib.dsc - The DEFINE  PCH = Cnl is unused, please delete it.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Maintainers.txt | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/Maintainers.txt b/Maintainers.txt index 56e16fc48c..34f0b58581
> 100644
> --- a/Maintainers.txt
> +++ b/Maintainers.txt
> @@ -242,6 +242,12 @@ F: Silicon/Intel/KabylakeSiliconPkg/
>  M: Chasel Chiu <chasel.chiu@intel.com> M: Sai Chaganty
> <rangasai.v.chaganty@intel.com> +Silicon/Intel/TigerlakeSiliconPkg+F:
> Silicon/Intel/TigerlakeSiliconPkg/+M: Sai Chaganty
> <rangasai.v.chaganty@intel.com>+M: Nate DeSimone
> <nathaniel.l.desimone@intel.com>+R: Heng Luo <heng.luo@intel.com>+
> Silicon/Intel/SimicsX58SktPkg F: Silicon/Intel/SimicsX58SktPkg/ M: Agyeman
> Prince <prince.agyeman@intel.com>--
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers
  2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
                   ` (38 preceding siblings ...)
  2021-02-01  1:36 ` [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers Heng Luo
@ 2021-02-04  3:51 ` Nate DeSimone
  39 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:51 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

CpuPcieConfigGen3.h is only used on Rocket Lake boards for backwards socket compatibility with Comet Lake. It is not needed for Tiger Lake. Please remove it. Also, there are some fields missing from CPU_PCIE_CONFIG, please see inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 01/40] TigerlakeSiliconPkg: Add package and
> Include/ConfigBlock headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Create the TigerlakeSiliconPkg to provide an initial package for
> silicon initialization code for Tiger Lake (TGL) products.
> 
> * Major areas of functionality are categorized into CPU, IpBlock, Fru,
>   Platform Controller Hub (PCH), and System Agent subdirectories.
> * Common libraries and headers are kept at the root of the package.
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
> |   67 ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPreM
> emConfig.h             |   86
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/CpuP
> cieConfigGen3.h      |  347
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/CpuP
> cieConfig.h          |  490
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
> |   72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
> |   61 ++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
> |  170
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
> |   33 +++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
> |   31 +++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig.h
> |   37 ++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/Graph
> icsConfig.h         |  211
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.h
> |  227
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBridge
> Config.h           |   62
> ++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/Hybrid
> GraphicsConfig.h   |   66
> +++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/HybridS
> torageConfig.h     |   36 +++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
> |   34 ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
> |  134
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.h
> |   58 ++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
> |   60 +++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
> |  117
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/Memor
> yConfig.h              |  478
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/Overcloc
> kingConfig.h       |  236
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
> |   34 ++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfig.
> h                   |   44 +++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/Pch
> PcieRpConfig.h      |  368
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
> |  213
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
> |   86
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
> |  391
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
> |   32 ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
> |   82
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
> |   38 +++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
> |  168
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
> |  139
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfig.
> h               |   32 ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
> |  152
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
> |   67 ++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig.h
> |   50 ++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
> |   43 ++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
> |  145
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
> |   73
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalConfi
> g.h                 |  153
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubCo
> nfig.h               |  101
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.h
> |   81
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.h
> |  138
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
> |  149
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/Cpu
> PowerMgmtVrConfig.h |  114
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
> |   64 ++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfig.
> h                    |   31 +++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec                                                   | 1208
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++
>  49 files changed, 7309 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
> new file mode 100644
> index 0000000000..de1f4159f0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Cnvi/CnviConfig.h
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  CNVi policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CNVI_CONFIG_H_
> 
> +#define _CNVI_CONFIG_H_
> 
> +
> 
> +#define CNVI_CONFIG_REVISION 1
> 
> +extern EFI_GUID gCnviConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CNVi Mode options
> 
> +**/
> 
> +typedef enum {
> 
> +  CnviModeDisabled = 0,
> 
> +  CnviModeAuto
> 
> +} CNVI_MODE;
> 
> +
> 
> +
> 
> +/**
> 
> +  CNVi signals pin muxing settings. If signal can be enable only on a single pin
> 
> +  then this parameter is ignored by RC. Refer to GPIO_*_MUXING_CNVI_*
> in GpioPins*.h
> 
> +  for supported settings on a given platform
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32 RfReset; ///< RF_RESET# Pin mux configuration. Refer to
> GPIO_*_MUXING_CNVI_RF_RESET_*
> 
> +  UINT32 Clkreq;  ///< CLKREQ Pin mux configuration. Refer to
> GPIO_*_MUXING_CNVI_*_CLKREQ_*
> 
> +} CNVI_PIN_MUX;
> 
> +
> 
> +/**
> 
> +  The CNVI_CONFIG block describes the expected configuration of the CNVi
> IP.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;      ///< Config Block Header
> 
> +  /**
> 
> +    This option allows for automatic detection of Connectivity Solution.
> 
> +    Auto Detection assumes that CNVi will be enabled when available;
> 
> +    Disable allows for disabling CNVi.
> 
> +    CnviModeDisabled = Disabled,
> 
> +    <b>CnviModeAuto = Auto Detection</b>
> 
> +  **/
> 
> +  UINT32 Mode                  :  1;
> 
> +  UINT32 BtCore                :  1; ///< The option to turn ON or OFF the BT Core.
> 0: Disabled, <b>1: Enabled</b>
> 
> +  /**
> 
> +    The option to enable or disable BT Audio Offload.
> 
> +    <b>0: Disabled</b>, 1: Enabled
> 
> +    @note This feature only support with Intel(R) Wireless-AX 22560
> 
> +  **/
> 
> +  UINT32 BtAudioOffload        :  1;
> 
> +  UINT32 RsvdBits              : 29;
> 
> +  /**
> 
> +    CNVi PinMux Configuration
> 
> +    RESET#/CLKREQ to CRF, can have two alternative mappings, depending on
> board routing requirements.
> 
> +  **/
> 
> +  CNVI_PIN_MUX          PinMux;
> 
> +} CNVI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CNVI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPre
> MemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPre
> MemConfig.h
> new file mode 100644
> index 0000000000..527febb0a4
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuDmi/CpuDmiPre
> MemConfig.h
> @@ -0,0 +1,86 @@
> +/** @file
> 
> +  DMI policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_DMI_PREMEM_CONFIG_H_
> 
> +#define _CPU_DMI_PREMEM_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +#define DMI_CONFIG_REVISION 1
> 
> +
> 
> +#define CPU_DMI_HWEQ_COEFFS_MAX    8
> 
> +
> 
> +#pragma pack (push,1)
> 
> +///
> 
> +/// The values before AutoConfig match the setting of PCI Express Base
> Specification 1.1, please be careful for adding new feature
> 
> +///
> 
> +typedef enum {
> 
> +  DmiAspmDisabled,
> 
> +  DmiAspmL0s,
> 
> +  DmiAspmL1,
> 
> +  DmiAspmL0sL1,
> 
> +  DmiAspmAutoConfig,
> 
> +  DmiAspmMax
> 
> +} DMI_ASPM;
> 
> +
> 
> +
> 
> +/**
> 
> +  The CPU_DMI_CONFIG block describes the expected configuration of the
> CPU for DMI.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +
> 
> +/**
> 
> +  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
> 
> +  - Gen1        (0x1)  : Limit Link to Gen1 Speed
> 
> +  - Gen2        (0x2)  : Limit Link to Gen2 Speed    CpuDmiPreMemConfig
> 
> +  - Gen3        (0x3)  : Limit Link to Gen3 Speed
> 
> +  **/
> 
> +  UINT8                  DmiMaxLinkSpeed;
> 
> +  /**
> 
> +   <b>(Test)</b> DMI Equalization Phase 2 Enable Control
> 
> +  - Disabled       (0x0) : Disable phase 2
> 
> +  - Enabled        (0x1) : Enable phase 2
> 
> +  - <b>Auto</b>    (0x2) : Use the current default method (Default)
> 
> +  **/
> 
> +  UINT8                  DmiGen3EqPh2Enable;
> 
> +  /**
> 
> +   <b>(Test)</b> Selects the method for performing Phase3 of Gen3
> Equalization on DMI
> 
> +  - <b>Auto</b> (0x0)  : Use the current default method (Default)
> 
> +  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
> 
> +  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in
> BIOS Reference Code)
> 
> +  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset
> array for Phase1 AND Phase3 (Instead of just Phase1)
> 
> +  - Disabled    (0x4)  : Bypass Equalization Phase 3
> 
> +  **/
> 
> +  UINT8                  DmiGen3EqPh3Method;
> 
> +  /**
> 
> +   <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT8                  DmiGen3ProgramStaticEq;
> 
> +  UINT8                  DmiDeEmphasis;                               ///< DeEmphasis control
> for DMI (-6 dB and -3.5 dB are the options)
> 
> +  UINT8                  DmiAspm;
> 
> +  UINT8                  DmiAspmCtrl;                                 ///< ASPM configuration on
> the CPU side of the DMI/OPI Link. Default is <b>DmiAspmAutoConfig</b>
> 
> +  UINT8                  DmiAspmL1ExitLatency;                        ///< ASPM
> configuration on the CPU side of the DMI/OPI Link. Default is
> <b>DmiAspmAutoConfig</b>
> 
> +  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE];      ///<
> Used for programming DMI Gen3 preset values per lane. Range: 0-9, 8 is
> default for each lane
> 
> +  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE];      ///<
> Used for programming DMI Gen3 preset values per lane. Range: 0-9, 7 is
> default for each lane
> 
> +  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE];        ///< Hint
> value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is default for each
> lane
> 
> +
> 
> +  /**
> 
> +   DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15).
> This setting
> 
> +   has to be specified based upon platform design and must follow the
> guideline. Default is 12.
> 
> +  **/
> 
> +
> 
> +  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE];
> 
> +} CPU_DMI_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_DMI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/Cp
> uPcieConfigGen3.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/Cp
> uPcieConfigGen3.h
> new file mode 100644
> index 0000000000..593e63b4f1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen3/Cp
> uPcieConfigGen3.h
> @@ -0,0 +1,347 @@
> +/** @file
> 
> +Pcie root port policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _CPU_PCIE_CONFIG_GEN3_H_
> 
> +#define _CPU_PCIE_CONFIG_GEN3_H_
> 
> +
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <PcieConfig.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define CPU_PCIE_PEI_PREMEM_CONFIG_GEN3_REVISION 1
> 
> +
> 
> +#define L0_SET                            BIT0
> 
> +#define L1_SET                            BIT1
> 
> +
> 
> +
> 
> +///
> 
> +/// SA GPIO Data Structure
> 
> +///
> 
> +typedef struct {
> 
> +  GPIO_PAD      GpioPad;        ///< Offset 0: GPIO Pad
> 
> +  UINT8         Value;          ///< Offset 4: GPIO Value
> 
> +  UINT8         Rsvd0[3];       ///< Offset 5: Reserved for 4 bytes alignment
> 
> +  UINT32        Active : 1;     ///< Offset 8: 0=Active Low; 1=Active High
> 
> +  UINT32        RsvdBits0 : 31;
> 
> +} SA_GPIO_INFO_PCIE;
> 
> +
> 
> +///
> 
> +/// SA Board PEG GPIO Info
> 
> +///
> 
> +typedef struct {
> 
> +  SA_GPIO_INFO_PCIE  SaPeg0ResetGpio;    ///< Offset 0:  PEG0 PERST#
> GPIO assigned, must be a PCH GPIO pin
> 
> +  SA_GPIO_INFO_PCIE  SaPeg3ResetGpio;    ///< Offset 12: PEG3 PERST#
> GPIO assigned, must be a PCH GPIO pin
> 
> +  BOOLEAN            GpioSupport;        ///< Offset 24: 1=Supported; 0=Not
> Supported
> 
> +  UINT8              Rsvd0[3];           ///< Offset 25: Reserved for 4 bytes alignment
> 
> +} PEG_GPIO_DATA;
> 
> +
> 
> +/**
> 
> +PCI Express and DMI controller configuration\n
> 
> +@note <b>Optional.</b> These policies will be ignored if there is no PEG
> port present on board.
> 
> +<b>Revision 1</b>:
> 
> +- Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER    Header;                                      ///< Offset 0-27
> Config Block Header
> 
> +  /**
> 
> +  Offset 28:0 :
> 
> +  <b>(Test)</b> DMI Link Speed Control
> 
> +  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
> 
> +  - Gen1        (0x1)  : Limit Link to Gen1 Speed
> 
> +  - Gen2        (0x2)  : Limit Link to Gen2 Speed
> 
> +  - Gen3        (0x3)  : Limit Link to Gen3 Speed
> 
> +  **/
> 
> +  UINT8                  DmiMaxLinkSpeed;
> 
> +  /**
> 
> +  Offset 28:2 :
> 
> +  <b>(Test)</b> DMI Equalization Phase 2 Enable Control
> 
> +  - Disabled       (0x0) : Disable phase 2
> 
> +  - Enabled        (0x1) : Enable phase 2
> 
> +  - <b>Auto</b>    (0x2) : Use the current default method (Default)
> 
> +  **/
> 
> +  UINT8                  DmiGen3EqPh2Enable;
> 
> +  /**
> 
> +  Offset 28:4 :
> 
> +  <b>(Test)</b> Selects the method for performing Phase3 of Gen3
> Equalization on DMI
> 
> +  - <b>Auto</b> (0x0)  : Use the current default method (Default)
> 
> +  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
> 
> +  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in
> BIOS Reference Code)
> 
> +  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset
> array for Phase1 AND Phase3 (Instead of just Phase1)
> 
> +  - Disabled    (0x4)  : Bypass Equalization Phase 3
> 
> +  **/
> 
> +  UINT8                  DmiGen3EqPh3Method;
> 
> +  /**
> 
> +  Offset 28:7 :
> 
> +  <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT8                  DmiGen3ProgramStaticEq;
> 
> +
> 
> +  /**
> 
> +  Offset 28:8 to 28:15 :
> 
> +  <b>(Test)</b> PEG Enable Control
> 
> +  - Disabled    (0x0)  : Disable PEG Port
> 
> +  - Enabled     (0x1)  : Enable PEG Port (If Silicon SKU permits it)
> 
> +  - <b>Auto</b> (0x2)  : If an endpoint is present, enable the PEG Port,
> Disable otherwise (Default)
> 
> +  **/
> 
> +  UINT8                  Peg0Enable;        ///< Enable/Disable PEG 0:1:0 Root Port
> 
> +  UINT8                  Peg1Enable;        ///< <b>(Test)</b> Enable/Disable PEG
> 0:1:1 Root Port
> 
> +  UINT8                  Peg2Enable;        ///< <b>(Test)</b> Enable/Disable PEG
> 0:1:2 Root Port
> 
> +  UINT8                  Peg3Enable;        ///< <b>(Test)</b> Enable/Disable PEG
> 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer silicon.
> 
> +
> 
> +  /**
> 
> +  Offset 28:16 :
> 
> +  <b>(Test)</b> PCIe Link Speed Control
> 
> +  - <b>Auto</b> (0x0)  : Maximum possible Link speed (Default)
> 
> +  - Gen1        (0x1)  : Limit Link to Gen1 Speed
> 
> +  - Gen2        (0x2)  : Limit Link to Gen2 Speed
> 
> +  - Gen3        (0x3)  : Limit Link to Gen3 Speed
> 
> +  **/
> 
> +  UINT8                  Peg0MaxLinkSpeed;        ///< PCIe Link Speed Control for
> PEG 0:1:0 Root Port.
> 
> +  UINT8                  Peg1MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link
> Speed Control for PEG 0:1:1 Root Port.
> 
> +  UINT8                  Peg2MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link
> Speed Control for PEG 0:1:2 Root Port.
> 
> +  UINT8                  Peg3MaxLinkSpeed;        ///< <b>(Test)</b> PCIe Link
> Speed Control for PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and
> newer silicon.
> 
> +
> 
> +  /**
> 
> +  Offset 32:0 :
> 
> +  <b>(Test)</b> PCIe Link Width Control
> 
> +  - <b>Auto</b> (0x0)  : Maximum possible Link width (Default)
> 
> +  - X1          (0x1)  : Limit Link to X1 Width
> 
> +  - X2          (0x2)  : Limit Link to X2 Width
> 
> +  - X4          (0x3)  : Limit Link to X4 Width
> 
> +  - X8          (0x4)  : Limit Link to X8 Width
> 
> +  **/
> 
> +  UINT8                  Peg0MaxLinkWidth;        ///< PCIe Link Width Control for
> PEG 0:1:0 Root Port.
> 
> +  UINT8                  Peg1MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width
> Control for PEG 0:1:1 Root Port.
> 
> +  UINT8                  Peg2MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width
> Control for PEG 0:1:2 Root Port.
> 
> +  UINT8                  Peg3MaxLinkWidth;        ///< <b>(Test)</b> PCIe Link Width
> Control for PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and newer
> silicon.
> 
> +  /**
> 
> +  Offset 32:12 to 32:15 :
> 
> +  Power down unused lanes on the PEG Root Port.
> 
> +  - Disabled     (0x0) : No power saving.
> 
> +  - <b>Auto</b>  (0x1) : Bios will power down unused lanes based on the
> max possible link width
> 
> +  **/
> 
> +  UINT8                  Peg0PowerDownUnusedLanes;        ///< Power down
> unused lanes on the PEG 0:1:0 Root Port.
> 
> +  UINT8                  Peg1PowerDownUnusedLanes;        ///< Power down
> unused lanes on the PEG 0:1:1 Root Port.
> 
> +  UINT8                  Peg2PowerDownUnusedLanes;        ///< Power down
> unused lanes on the PEG 0:1:2 Root Port.
> 
> +  UINT8                  Peg3PowerDownUnusedLanes;        ///< Power down
> unused lanes on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs
> and newer silicon.
> 
> +
> 
> +  /**
> 
> +  Offset 32:16 to 32:23 :
> 
> +  <b>(Test)</b> PCIe Equalization Phase 2 Enable Control
> 
> +  - Disabled       (0x0) : Disable phase 2
> 
> +  - Enabled        (0x1) : Enable phase 2
> 
> +  - <b>Auto</b>    (0x2) : Use the current default method (Default)
> 
> +  **/
> 
> +  UINT8                  Peg0Gen3EqPh2Enable;        ///< Phase2 EQ enable on the
> PEG 0:1:0 Root Port.
> 
> +  UINT8                  Peg1Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ
> enable on the PEG 0:1:1 Root Port.
> 
> +  UINT8                  Peg2Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ
> enable on the PEG 0:1:2 Root Port.
> 
> +  UINT8                  Peg3Gen3EqPh2Enable;        ///< <b>(Test)</b> Phase2 EQ
> enable on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and
> newer silicon.
> 
> +
> 
> +  /**
> 
> +  Offset 36:0 to 36:11 :
> 
> +  <b>(Test)</b> Select the method for performing Phase3 of Gen3
> Equalization.
> 
> +  - <b>Auto</b> (0x0)  : Use the current default method (Default)
> 
> +  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
> 
> +  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in
> BIOS Reference Code)
> 
> +  - Static      (0x3)  : Use the Static EQs provided in PegGen3EndPointPreset
> array for Phase1 AND Phase3 (Instead of just Phase1)
> 
> +  - Disabled    (0x4)  : Bypass Equalization Phase 3
> 
> +  **/
> 
> +  UINT8                  Peg0Gen3EqPh3Method;        ///< Phase3 EQ method on
> the PEG 0:1:0 Root Port.
> 
> +  UINT8                  Peg1Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3
> EQ method on the PEG 0:1:1 Root Port.
> 
> +  UINT8                  Peg2Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3
> EQ method on the PEG 0:1:2 Root Port.
> 
> +  UINT8                  Peg3Gen3EqPh3Method;        ///< <b>(Test)</b> Phase3
> EQ method on the PEG 0:6:0 Root Port. Applicable on certain CNL- SKUs and
> newer silicon.
> 
> +  /**
> 
> +  Offset 36:12 :
> 
> +  <b>(Test)</b> Program PEG Gen3 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT8                  PegGen3ProgramStaticEq;
> 
> +  /**
> 
> +  Offset 36:13 :
> 
> +  <b>(Test)</b> Always Attempt Gen3 Software Equalization
> 
> +
> 
> +  When enabled, Gen3 Software Equalization will be executed every boot.
> When disabled, it will be only executed if the CPU
> 
> +  or EP is changed, otherwise it is skipped and the previous EQ value will be
> re-used.
> 
> +
> 
> +  This setting will only have an effect if Software Equalization is enabled and
> OEM Platform Code implements
> 
> +  save/restore of the PegDataPtr data (see below).  If PegDataPtr is not
> saved/restored RC forces this to be enabled.
> 
> +
> 
> +  - <b>Disabled</b> (0x0)  : Reuse EQ settings saved/restored from NVRAM
> whenever possible (Default)
> 
> +  - Enabled         (0x1)  : Re-test and generate new EQ values every boot, not
> recommended
> 
> +  **/
> 
> +  UINT8                  Gen3SwEqAlwaysAttempt;
> 
> +  /**
> 
> +  Offset 36:14 to 36:16 :
> 
> +  <b>(Test)</b> Select number of TxEq presets to test in the PCIe/DMI
> Software Equalization Algorithm
> 
> +  - P7,P3,P5,P8 (0x0)  : Test Presets 7, 3, 5, and 8
> 
> +  - P0-P9       (0x1)  : Test Presets 0-9
> 
> +  - <b>Auto</b> (0x2)  : Use the current default method (Default)
> 
> +  Auto will test Presets 7, 3, 5, and 8.  It is possible for this default to change
> over time;
> 
> +  using "Auto" will ensure Reference Code always uses the latest default
> settings.
> 
> +  @warning Do not change from the default.  Hard to detect issues are likely.
> 
> +  **/
> 
> +  UINT8                  Gen3SwEqNumberOfPresets;
> 
> +  /**
> 
> +  Offset 36:17 to 36:18:
> 
> +  <b>(Test)</b> Offset 36 Enable use of the Voltage Offset and Centering
> Test in the PCIe Software Equalization Algorithm
> 
> +  - Disabled     (0x0) : Disable VOC Test
> 
> +  - Enabled      (0x1) : Enable VOC Test
> 
> +  - <b>Auto</b>  (0x2) : Use the current default (Default)
> 
> +  **/
> 
> +  UINT8                  Gen3SwEqEnableVocTest;
> 
> +  /**
> 
> +  Offset 36:19 :
> 
> +  Select when PCIe ASPM programming will happen in relation to the Oprom
> 
> +  - <b>Before</b> (0x0) : Do PCIe ASPM programming before Oprom.
> (Default)
> 
> +  - After         (0x1) : Do PCIe ASPM programming after Oprom. This will
> require an SMI handler to save/restore ASPM settings.
> 
> +  **/
> 
> +  UINT8                  InitPcieAspmAfterOprom;
> 
> +  /**
> 
> +  Offset 36:20 :
> 
> +  <b>(Test)</b> PCIe Rx Compliance Testing Mode
> 
> +  - <b>Disabled</b> (0x0) : Normal Operation             - Disable PCIe Rx
> Compliance testing (Default)
> 
> +  - Enabled         (0x1) : PCIe Rx Compliance Test Mode - PEG controller is in Rx
> Compliance Testing Mode; it should only be set when doing PCIe compliance
> testing
> 
> +  **/
> 
> +  UINT8                  PegRxCemTestingMode;
> 
> +
> 
> +  /**
> 
> +  Offset 36:21 to 36:24 :
> 
> +  <b>(Test)</b> PCIe Rx Compliance Loopback Lane
> 
> +
> 
> +  When PegRxCemTestingMode is Enabled, the specificied Lane (0 - 15) will
> be
> 
> +  used for RxCEMLoopback.
> 
> +
> 
> +  Default is Lane 0.
> 
> +  **/
> 
> +  UINT8                  PegRxCemLoopbackLane;
> 
> +  /**
> 
> +  Offset 36:25 to 36:28 :
> 
> +  <b>(Test)</b> Generate PCIe BDAT Margin Table. Set this policy to enable
> the generation and addition of PCIe margin data to the BDAT table.
> 
> +  - <b>Disabled</b> (0x0) : Normal Operation          - Disable PCIe BDAT
> margin data generation (Default)
> 
> +  - PortData        (0x1) : Port Data                 - Generate PCIe BDAT margin data
> 
> +  **/
> 
> +  UINT8                 PegGenerateBdatMarginTable;
> 
> +  /**
> 
> +  Offset 36:29 :
> 
> +  <b>(Test)</b> PCIe Non-Protocol Awareness for Rx Compliance Testing
> 
> +  - <b>Disabled</b> (0x0) : Normal Operation                - Disable non-protocol
> awareness (Default)
> 
> +  - Enabled         (0x1) : Non-Protocol Awareness Enabled  - Enable non-
> protocol awareness for compliance testing
> 
> +  **/
> 
> +  UINT8                  PegRxCemNonProtocolAwareness;
> 
> +  /**
> 
> +  Offset 36:30 :
> 
> +  <b>(Test)</b> PCIe Disable Spread Spectrum Clocking. This feature should
> be TRUE only for compliance testing
> 
> +  - <b>False</b>          (0x0) : Normal Operation                 - SSC enabled
> (Default)
> 
> +  - True                  (0x1) : Disable SSC                      - Disable SSC for compliance
> testing
> 
> +  **/
> 
> +  UINT8                  PegDisableSpreadSpectrumClocking;
> 
> +
> 
> +  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE_VER1];
> ///< Offset 40 Used for programming DMI Gen3 preset values per lane.
> Range: 0-9, 8 is default for each lane
> 
> +  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE_VER1];
> ///< Offset 44 Used for programming DMI Gen3 preset values per lane.
> Range: 0-9, 7 is default for each lane
> 
> +  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE_VER1];
> ///< Offset 48 Hint value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is
> default for each lane
> 
> +  /**
> 
> +  Offset 48/60 :
> 
> +  DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15).
> This setting
> 
> +  has to be specified based upon platform design and must follow the
> guideline. Default is 12.
> 
> +  **/
> 
> +
> 
> +  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE_VER1];
> 
> +
> 
> +  UINT8                  PegGen3RootPortPreset[SA_PEG_MAX_LANE_GEN3];
> ///< Offset 54 <b>(Test)</b> Used for programming PEG Gen3 preset values
> per lane. Range: 0-9, 8 is default for each lane
> 
> +  UINT8                  PegGen3EndPointPreset[SA_PEG_MAX_LANE_GEN3];
> ///< Offset 70 <b>(Test)</b> Used for programming PEG Gen3 preset values
> per lane. Range: 0-9, 7 is default for each lane
> 
> +  UINT8                  PegGen3EndPointHint[SA_PEG_MAX_LANE_GEN3];
> ///< Offset 86 <b>(Test)</b> Hint value per lane for the PEG Gen3 End Point.
> Range: 0-6, 2 is default for each lane
> 
> +  /**
> 
> +  Offset 102:
> 
> +  PCIe Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15).
> This setting
> 
> +  has to be specified based upon platform design and must follow the
> guideline. Default is 12.
> 
> +  **/
> 
> +  UINT8                  PegGen3RxCtlePeaking[SA_PEG_MAX_BUNDLE_GEN3];
> 
> +  /**
> 
> +  Offset 110:
> 
> +  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535,
> default is 1000.
> 
> +  @warning Do not change from the default.  Hard to detect issues are likely.
> 
> +  @note An attack on this policy could result in an apparent hang,
> 
> +  but the system will eventually boot.  This variable should be protected.
> 
> +  **/
> 
> +  UINT16                 Gen3SwEqJitterDwellTime;
> 
> +  /**
> 
> +  Offset 112:
> 
> +  This is a memory data pointer for saved preset search results. The
> reference code will store
> 
> +  the Gen3 Preset Search results in the SaPegHob. In order to skip the Gen3
> 
> +  preset search on boots where the PEG card configuration has not changed
> since the previous boot,
> 
> +  platform code can save the contents of the SaPegHob in DXE (When it
> present and for size reported by Header.HobLength)
> 
> +  and provide a pointer to a restored copy of that data. Default value is
> NULL, which results in a full
> 
> +  preset search every boot.
> 
> +
> 
> +  @note An attack on this policy could prevent the PCIe display from
> working until a boot when
> 
> +  PegDataPtr is NULL or Gen3SwEqAlwaysAttempt is enabled.  The variable
> used to save the
> 
> +  preset search results should be protected in a way that it can only be
> modified by the
> 
> +  platform manufacturer.
> 
> +  **/
> 
> +  VOID                   *PegDataPtr;
> 
> +  /**
> 
> +  Offset 116:
> 
> +  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535,
> default is 1.
> 
> +  @warning Do not change from the default.  Hard to detect issues are likely.
> 
> +  **/
> 
> +  UINT16                 Gen3SwEqJitterErrorTarget;
> 
> +
> 
> +  /**
> 
> +  Offset 118:
> 
> +  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535,
> default is 10000.
> 
> +  @warning Do not change from the default.  Hard to detect issues are likely.
> 
> +  @note An attack on this policy could result in an apparent hang,
> 
> +  but the system will eventually boot.  This variable should be protected.
> 
> +  **/
> 
> +  UINT16                  Gen3SwEqVocDwellTime;
> 
> +
> 
> +  /**
> 
> +  Offset 120:
> 
> +  <b>(Test)</b>Used for PCIe Gen3 Software Equalization. Range: 0-65535,
> default is 2.
> 
> +  @warning Do not change from the default.  Hard to detect issues are likely.
> 
> +  **/
> 
> +  UINT16                 Gen3SwEqVocErrorTarget;
> 
> +  /**
> 
> +  Offset 122:
> 
> +  PCIe Hot Plug Enable/Disable. It has 2 policies.
> 
> +  - Disabled (0x0)     : No hotplug.
> 
> +  - Enabled (0x1)      : Bios assist hotplug.
> 
> +  **/
> 
> +  UINT8                  PegRootPortHPE[SA_PEG_MAX_FUN_GEN3];
> 
> +  UINT8                  DmiDeEmphasis;                               ///< Offset 125 This field is
> used to describe the DeEmphasis control for DMI (-6 dB and -3.5 dB are the
> options)
> 
> +  UINT8                  Rsvd0[3];                                    ///< Offset 126
> 
> +  /**
> 
> +  Offset 128:
> 
> +  This contains the PCIe PERST# GPIO information.  This structure is required
> 
> +  for PCIe Gen3 operation. The reference code will use the information in
> this structure in
> 
> +  order to reset PCIe Gen3 devices during equalization, if necessary.  Refer
> to the Platform
> 
> +  Developer's Guide (PDG) for additional details.
> 
> +  **/
> 
> +  PEG_GPIO_DATA          PegGpioData;
> 
> +
> 
> +  /**
> 
> +  Offset 156
> 
> +  <b>(Test)</b> PCIe Override RxCTLE. This feature should only be true to
> disable RxCTLE adaptive behavior for compliance testing
> 
> +  - <b>False</b>          (0x0) : Normal Operation                 - RxCTLE adaptive
> behavior enabled  (Default)
> 
> +  - True                  (0x1) : Override RxCTLE                  - Disable RxCTLE adaptive
> behavior to keep the configured RxCTLE peak values unmodified
> 
> +  From CFL onwards, modularity is introduced to this setup option so that
> the RxCTLE adaptive behavior could be controlled at the controller level.
> 
> +  Making this variable a UINT8 to accomodate the values of all controllers as
> bit definition
> 
> +  **/
> 
> +  UINT8                 PegGen3RxCtleOverride;
> 
> +
> 
> +} PCIE_PEI_PREMEM_CONFIG_GEN3;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_PCIE_CONFIG_GEN3_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/Cp
> uPcieConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/Cp
> uPcieConfig.h
> new file mode 100644
> index 0000000000..5941b6ad4a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/CpuPcieRp/Gen4/Cp
> uPcieConfig.h
> @@ -0,0 +1,490 @@
> +/** @file
> 
> +  Pcie root port policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _CPU_PCIE_CONFIG_H_
> 
> +#define _CPU_PCIE_CONFIG_H_
> 
> +
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <PcieConfig.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define CPU_PCIE_PEI_PREMEM_CONFIG_REVISION 1
> 
> +#define CPU_PCIE_RP_PREMEM_CONFIG_REVISION  4
> 
> +
> 
> +/**
> 
> + Making any setup structure change after code frozen
> 
> + will need to maintain backward compatibility, bump up
> 
> + structure revision and update below history table\n
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +  <b>Revision 2</b>:  - Add Gen3TxOverride and Gen4TxOverride
> 
> +  <b>Revision 3</b>:  - Deprecate Dekel Suqelch Workaround Setup
> Variable
> 
> +  <b>Revision 4</b>:  - Add FOMS Control Policy Setup Variable
> 
> +  <b>Revision 5</b>:  - Add Gen3HwEqOverride and Gen4HwEqOverride
> 
> +  <b>Revision 6</b>:  - Align revision with CPU_PCIE_RP_CONFIG_REVISION
> value
> 
> +**/
> 
> +
> 
> +#define CPU_PCIE_RP_CONFIG_REVISION         6
> 
> +
> 
> +#define L0_SET                            BIT0
> 
> +#define L1_SET                            BIT1
> 
> +
> 
> +
> 
> +
> 
> +
> 
> +/**
> 
> + PCI Express and DMI controller configuration\n
> 
> + @note <b>Optional.</b> These policies will be ignored if there is no PEG
> port present on board.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER    Header;                                      ///< Offset 0-27
> Config Block Header
> 
> +  /**
> 
> +   Offset 28:0 :
> 
> +   <b>(Test)</b> DMI Link Speed Control
> 
> +  - <b>Auto</b> (0x0)  : Maximum possible link speed (Default)
> 
> +  - Gen1        (0x1)  : Limit Link to Gen1 Speed
> 
> +  - Gen2        (0x2)  : Limit Link to Gen2 Speed
> 
> +  - Gen3        (0x3)  : Limit Link to Gen3 Speed
> 
> +  **/
> 
> +  UINT32                 DmiMaxLinkSpeed                 :  2;
> 
> +  /**
> 
> +   Offset 28:2 :
> 
> +   <b>(Test)</b> DMI Equalization Phase 2 Enable Control
> 
> +  - Disabled       (0x0) : Disable phase 2
> 
> +  - Enabled        (0x1) : Enable phase 2
> 
> +  - <b>Auto</b>    (0x2) : Use the current default method (Default)
> 
> +  **/
> 
> +  UINT32                 DmiGen3EqPh2Enable              :  2;
> 
> +  /**
> 
> +   Offset 28:4 :
> 
> +   <b>(Test)</b> Selects the method for performing Phase3 of Gen3
> Equalization on DMI
> 
> +  - <b>Auto</b> (0x0)  : Use the current default method (Default)
> 
> +  - HwEq        (0x1)  : Use Adaptive Hardware Equalization
> 
> +  - SwEq        (0x2)  : Use Adaptive Software Equalization (Implemented in
> BIOS Reference Code)
> 
> +  - Static      (0x3)  : Use the Static EQs provided in DmiGen3EndPointPreset
> array for Phase1 AND Phase3 (Instead of just Phase1)
> 
> +  - Disabled    (0x4)  : Bypass Equalization Phase 3
> 
> +  **/
> 
> +  UINT32                 DmiGen3EqPh3Method              :  3;
> 
> +  /**
> 
> +   Offset 28:7 :
> 
> +   <b>(Test)</b> Program DMI Gen3 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT32                 DmiGen3ProgramStaticEq          :  1;
> 
> +  UINT32                 RsvdBits0                       :  24;        ///< Offset 28:8 :Reserved
> for future use
> 
> +
> 
> +  /**
> 
> +  Offset 32:0 :
> 
> +  Select when PCIe ASPM programming will happen in relation to the Oprom
> 
> +  - <b>Before</b> (0x0) : Do PCIe ASPM programming before Oprom.
> (Default)
> 
> +  - After         (0x1) : Do PCIe ASPM programming after Oprom. This will
> require an SMI handler to save/restore ASPM settings.
> 
> +  **/
> 
> +  UINT32                 InitPcieAspmAfterOprom : 1;
> 
> +  UINT32                 RsvdBits1 : 31;        ///< Offset 32:1 :Reserved for future use
> 
> +
> 
> +  UINT8                  DmiGen3RootPortPreset[SA_DMI_MAX_LANE];      ///<
> Offset 36 Used for programming DMI Gen3 preset values per lane. Range: 0-
> 9, 8 is default for each lane
> 
> +  UINT8                  DmiGen3EndPointPreset[SA_DMI_MAX_LANE];      ///<
> Offset 40/44 Used for programming DMI Gen3 preset values per lane. Range:
> 0-9, 7 is default for each lane
> 
> +  UINT8                  DmiGen3EndPointHint[SA_DMI_MAX_LANE];        ///<
> Offset 44/52 Hint value per lane for the DMI Gen3 End Point. Range: 0-6, 2 is
> default for each lane
> 
> +  /**
> 
> +   Offset 48/60 :
> 
> +   DMI Gen3 RxCTLEp per-Bundle control. The range of the setting is (0-15).
> This setting
> 
> +   has to be specified based upon platform design and must follow the
> guideline. Default is 12.
> 
> +  **/
> 
> +
> 
> +  UINT8                  DmiGen3RxCtlePeaking[SA_DMI_MAX_BUNDLE];
> 
> +
> 
> +  UINT8                  DmiDeEmphasis;                               ///< Offset 64 This field is
> used to describe the DeEmphasis control for DMI (-6 dB and -3.5 dB are the
> options)
> 
> +  UINT8                  Rsvd0[3];                                    ///< Offset 65
> 
> +} PCIE_PEI_PREMEM_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  CPU PCIe Root Port Pre-Memory Configuration
> 
> +  Contains Root Port settings and capabilities
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +  <b>Revision 2</b>:  - Adding Dekel Suqelch Workaround Setup Variable
> 
> +  <b>Revision 3</b>:  - Deprecate Dekel Suqelch Workaround Setup
> Variable
> 
> +  <b>Revision 4</b>:  - Adding CDR Relock Setup Variable
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                                ///< Config Block
> Header
> 
> +  /**
> 
> +  Root Port enabling mask.
> 
> +  Bit0 presents RP1, Bit1 presents RP2, and so on.
> 
> +  0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                RpEnabledMask;
> 
> +  /**
> 
> +  Assertion on Link Down GPIOs
> 
> +  - <b>Disabled</b> (0x0) : Disable assertion on Link Down GPIOs(Default)
> 
> +  - Enabled         (0x1) : Enable assertion on Link Down GPIOs
> 
> +  **/
> 
> +  UINT8                 LinkDownGpios;
> 
> +  /**
> 
> +  Enable ClockReq Messaging
> 
> +  - <b>Disabled</> (0x0) : Disable ClockReq Messaging(Default)
> 
> +  - Enabled        (0x1) : Enable ClockReq Messaging
> 
> +  **/
> 
> +  UINT8                 ClkReqMsgEnable;
> 
> +  /**
> 
> +  Dekel Recipe Workaround
> 
> +  <b>2</b>
> 
> +  1=Minimal, 9=Maximum,
> 
> +  **/
> 
> +  UINT8                 DekelSquelchWa;  // Deprecated variable
> 
> +  UINT8                 Rsvd0[1];
> 
> +  /**
> 
> +  Determines each PCIE Port speed capability.
> 
> +  <b>0: Auto</b>; 1: Gen1; 2: Gen2; 3: Gen3; 4: Gen4 (see:
> CPU_PCIE_SPEED)
> 
> +  **/
> 
> +  UINT8                 PcieSpeed[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +  /**
> 
> +  To Enable/Disable CDR Relock
> 
> +  <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT8                 CdrRelock[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +  /**
> 
> +  This policy is used while programming DEKEL Recipe
> 
> +  <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT8                 Xl1el[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +
> 
> +} CPU_PCIE_RP_PREMEM_CONFIG;
> 
> +
> 
> +typedef enum {
> 
> +  CpuPcieOverrideDisabled             = 0,
> 
> +  CpuPcieL1L2Override                 = 0x01,
> 
> +  CpuPcieL1SubstatesOverride          = 0x02,
> 
> +  CpuPcieL1L2AndL1SubstatesOverride   = 0x03,
> 
> +  CpuPcieLtrOverride                  = 0x04
> 
> +} CPU_PCIE_OVERRIDE_CONFIG;
> 
> +
> 
> +/**
> 
> +  PCIe device table entry entry
> 
> +
> 
> +  The PCIe device table is being used to override PCIe device ASPM settings.
> 
> +  To take effect table consisting of such entries must be instelled as PPI
> 
> +  on gPchPcieDeviceTablePpiGuid.
> 
> +  Last entry VendorId must be 0.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16  VendorId;                    ///< The vendor Id of Pci Express card ASPM
> setting override, 0xFFFF means any Vendor ID
> 
> +  UINT16  DeviceId;                    ///< The Device Id of Pci Express card ASPM
> setting override, 0xFFFF means any Device ID
> 
> +  UINT8   RevId;                       ///< The Rev Id of Pci Express card ASPM setting
> override, 0xFF means all steppings
> 
> +  UINT8   BaseClassCode;               ///< The Base Class Code of Pci Express card
> ASPM setting override, 0xFF means all base class
> 
> +  UINT8   SubClassCode;                ///< The Sub Class Code of Pci Express card
> ASPM setting override, 0xFF means all sub class
> 
> +  UINT8   EndPointAspm;                ///< Override device ASPM (see:
> CPU_PCIE_ASPM_CONTROL)
> 
> +                                       ///< Bit 1 must be set in OverrideConfig for this field to
> take effect
> 
> +  UINT16  OverrideConfig;              ///< The override config bitmap (see:
> CPU_PCIE_OVERRIDE_CONFIG).
> 
> +  /**
> 
> +    The L1Substates Capability Offset Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    This field can be zero if only the L1 Substate value is going to be override.
> 
> +  **/
> 
> +  UINT16  L1SubstatesCapOffset;
> 
> +  /**
> 
> +    L1 Substate Capability Mask. (applicable if bit 2 is set in OverrideConfig)
> 
> +    Set to zero then the L1 Substate Capability [3:0] is ignored, and only L1s
> values are override.
> 
> +    Only bit [3:0] are applicable. Other bits are ignored.
> 
> +  **/
> 
> +  UINT8   L1SubstatesCapMask;
> 
> +  /**
> 
> +    L1 Substate Port Common Mode Restore Time Override. (applicable if bit
> 2 is set in OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sCommonModeRestoreTime;
> 
> +  /**
> 
> +    L1 Substate Port Tpower_on Scale Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sTpowerOnScale;
> 
> +  /**
> 
> +    L1 Substate Port Tpower_on Value Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sTpowerOnValue;
> 
> +
> 
> +  /**
> 
> +    SnoopLatency bit definition
> 
> +    Note: All Reserved bits must be set to 0
> 
> +
> 
> +    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                  When clear values in bits 9:0 will be ignored
> 
> +    BITS[14:13] - Reserved
> 
> +    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                  000b - 1 ns
> 
> +                  001b - 32 ns
> 
> +                  010b - 1024 ns
> 
> +                  011b - 32,768 ns
> 
> +                  100b - 1,048,576 ns
> 
> +                  101b - 33,554,432 ns
> 
> +                  110b - Reserved
> 
> +                  111b - Reserved
> 
> +    BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied
> with
> 
> +                  the scale in bits 12:10
> 
> +
> 
> +    This field takes effect only if bit 3 is set in OverrideConfig.
> 
> +  **/
> 
> +  UINT16  SnoopLatency;
> 
> +  /**
> 
> +    NonSnoopLatency bit definition
> 
> +    Note: All Reserved bits must be set to 0
> 
> +
> 
> +    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                  When clear values in bits 9:0 will be ignored
> 
> +    BITS[14:13] - Reserved
> 
> +    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                  000b - 1 ns
> 
> +                  001b - 32 ns
> 
> +                  010b - 1024 ns
> 
> +                  011b - 32,768 ns
> 
> +                  100b - 1,048,576 ns
> 
> +                  101b - 33,554,432 ns
> 
> +                  110b - Reserved
> 
> +                  111b - Reserved
> 
> +    BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be
> multiplied with
> 
> +                  the scale in bits 12:10
> 
> +
> 
> +    This field takes effect only if bit 3 is set in OverrideConfig.
> 
> +  **/
> 
> +  UINT16  NonSnoopLatency;
> 
> +
> 
> +  /**
> 
> +    Forces LTR override to be permanent
> 
> +    The default way LTR override works is:
> 
> +      rootport uses LTR override values provided by BIOS until connected
> device sends an LTR message, then it will use values from the message
> 
> +    This settings allows force override of LTR mechanism. If it's enabled, then:
> 
> +      rootport will use LTR override values provided by BIOS forever; LTR
> messages sent from connected device will be ignored
> 
> +  **/
> 
> +  UINT8  ForceLtrOverride;
> 
> +  UINT8  Reserved[3];
> 
> +} CPU_PCIE_DEVICE_OVERRIDE;
> 
> +
> 
> +enum CPU_PCIE_SPEED {
> 
> +  CpuPcieAuto,
> 
> +  CpuPcieGen1,
> 
> +  CpuPcieGen2,
> 
> +  CpuPcieGen3,
> 
> +  CpuPcieGen4,
> 
> +  CpuPcieGen5
> 
> +};
> 
> +
> 
> +///
> 
> +/// The values before AutoConfig match the setting of PCI Express Base
> Specification 1.1, please be careful for adding new feature
> 
> +///
> 
> +typedef enum {
> 
> +  CpuPcieAspmDisabled,
> 
> +  CpuPcieAspmL0s,
> 
> +  CpuPcieAspmL1,
> 
> +  CpuPcieAspmL0sL1,
> 
> +  CpuPcieAspmAutoConfig,
> 
> +  CpuPcieAspmMax
> 
> +} CPU_PCIE_ASPM_CONTROL;
> 
> +
> 
> +/**
> 
> +  Refer to SA EDS for the SA implementation values corresponding
> 
> +  to below PCI-E spec defined ranges
> 
> +**/
> 
> +typedef enum {
> 
> +  CpuPcieL1SubstatesDisabled,
> 
> +  CpuPcieL1SubstatesL1_1,
> 
> +  CpuPcieL1SubstatesL1_1_2,
> 
> +  CpuPcieL1SubstatesMax
> 
> +} CPU_PCIE_L1SUBSTATES_CONTROL;
> 
> +
> 
> +enum CPU_PCIE_MAX_PAYLOAD {
> 
> +  CpuPcieMaxPayload128 = 0,
> 
> +  CpuPcieMaxPayload256,
> 
> +  CpuPcieMaxPayload512,
> 
> +  CpuPcieMaxPayloadMax
> 
> +};
> 
> +
> 
> +enum CPU_PCIE_COMPLETION_TIMEOUT {
> 
> +  CpuPcieCompletionTO_Default,
> 
> +  CpuPcieCompletionTO_50_100us,
> 
> +  CpuPcieCompletionTO_1_10ms,
> 
> +  CpuPcieCompletionTO_16_55ms,
> 
> +  CpuPcieCompletionTO_65_210ms,
> 
> +  CpuPcieCompletionTO_260_900ms,
> 
> +  CpuPcieCompletionTO_1_3P5s,
> 
> +  CpuPcieCompletionTO_4_13s,
> 
> +  CpuPcieCompletionTO_17_64s,
> 
> +  CpuPcieCompletionTO_Disabled
> 
> +};
> 
> +
> 
> +
> 
> +enum CPU_PCIE_GEN3_PRESET_COEFF_SELECTION {
> 
> +  CpuPcieGen3PresetSelection,
> 
> +  CpuPcieGen3CoefficientSelection
> 
> +};
> 
> +
> 
> +enum CPU_PCIE_GEN4_PRESET_COEFF_SELECTION {
> 
> +  CpuPcieGen4PresetSelection,
> 
> +  CpuPcieGen4CoefficientSelection
> 
> +};
> 
> +
> 
> +typedef enum {
> 
> +  CpuPcieEqDefault      = 0,  ///< @deprecated since revision 3. Behaves as
> PchPcieEqHardware.
> 
> +  CpuPcieEqHardware     = 1,  ///< Hardware equalization
> 
> +  CpuPcieEqStaticCoeff  = 4   ///< Fixed equalization (requires Coefficient
> settings per lane)
> 
> +} CPU_PCIE_EQ_METHOD;
> 
> +
> 
> +
> 
> +/**
> 
> +  Represent lane specific PCIe Gen3 equalization parameters.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8                  Cm;                 ///< Coefficient C-1
> 
> +  UINT8                  Cp;                 ///< Coefficient C+1
> 
> +  UINT8                  PegGen3RootPortPreset;      ///< <b>(Test)</b> Used for
> programming PEG Gen3 preset values per lane. Range: 0-9, 8 is default for
> each lane
> 
> +  UINT8                  PegGen3EndPointPreset;      ///< <b>(Test)</b> Used for
> programming PEG Gen3 preset values per lane. Range: 0-9, 7 is default for
> each lane
> 
> +  UINT8                  PegGen3EndPointHint;        ///< <b>(Test)</b> Hint value
> per lane for the PEG Gen3 End Point. Range: 0-6, 2 is default for each lane
> 
> +  UINT8                  PegGen4RootPortPreset;      ///< <b>(Test)</b> Used for
> programming PEG Gen4 preset values per lane. Range: 0-9, 8 is default for
> each lane
> 
> +  UINT8                  PegGen4EndPointPreset;      ///< <b>(Test)</b> Used for
> programming PEG Gen4 preset values per lane. Range: 0-9, 7 is default for
> each lane
> 
> +  UINT8                  PegGen4EndPointHint;        ///< <b>(Test)</b> Hint value
> per lane for the PEG Gen4 End Point. Range: 0-6, 2 is default for each lane
> 
> +} CPU_PCIE_EQ_LANE_PARAM;
> 
> +
> 
> +/**
> 
> +  The CPU_PCI_ROOT_PORT_CONFIG describe the feature and capability of
> each CPU PCIe root port.
> 
> +**/
> 
> +typedef struct {
> 
> +
> 
> +  UINT32  ExtSync                         :  1;   ///< Indicate whether the extended
> synch is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  VcEnabled                       :  1;   ///< Virtual Channel. 0: Disable; <b>1:
> Enable</b>
> 
> +  UINT32  MultiVcEnabled                  :  1;   ///< Multiple Virtual Channel. 0:
> Disable; <b>1: Enable</b>
> 
> +  UINT32  PeerToPeer                      :  1;   ///< Peer to Peer Mode. <b>0:
> Disable</b>; 1: Enable.
> 
> +  UINT32  RsvdBits0                       : 28;   ///< Reserved bits
> 
> +  /**
> 
> +  PCIe Gen4 Equalization Method
> 
> +  - HwEq           (0x1) : Hardware Equalization (Default)
> 
> +  - StaticEq       (0x2) : Static Equalization
> 
> +  **/
> 
> +  UINT8   Gen4EqPh3Method;
> 
> +  UINT8   FomsCp;                                 ///< FOM Score Board Control Policy
> 
> +  UINT8   RsvdBytes0[2];                          ///< Reserved bytes
> 
> +
> 
> +  //
> 
> +  // Gen3 Equalization settings
> 
> +  //
> 
> +  UINT32  Gen3Uptp            :  4;               ///< <b>(Test)</b> Upstream Port
> Transmitter Preset used during Gen3 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  UINT32  Gen3Dptp            :  4;               ///< <b>(Test)</b> Downstream Port
> Transmiter Preset used during Gen3 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  //
> 
> +  // Gen4 Equalization settings
> 
> +  //
> 
> +  UINT32  Gen4Uptp            :  4;               ///< <b>(Test)</b> Upstream Port
> Transmitter Preset used during Gen4 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  UINT32  Gen4Dptp            :  4;               ///< <b>(Test)</b> Downstream Port
> Transmiter Preset used during Gen4 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  //
> 
> +  // Gen5 Equalization settings
> 
> +  //
> 
> +  UINT32  Gen5Uptp            :  4;               ///< <b>(Test)</b> Upstream Port
> Transmitter Preset used during Gen5 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  UINT32  Gen5Dptp            :  4;               ///< <b>(Test)</b> Downstream Port
> Transmiter Preset used during Gen5 Link Equalization. Used for all lanes.
> Default is <b>7</b>.
> 
> +  UINT32  RsvdBits1           :  8;               ///< Reserved Bits
> 
> +
> 
> +  PCIE_ROOT_PORT_COMMON_CONFIG                    PcieRpCommonConfig;
> ///< <b>(Test)</b> Includes policies which are common to both SA and PCH
> RootPort
> 
> +
> 
> +} CPU_PCIE_ROOT_PORT_CONFIG;
> 
> +
> 
> +/**
> 
> +  The CPU_PCIE_CONFIG block describes the expected configuration of the
> CPU PCI Express controllers
> 
> +  <b>Revision 1< / b>:
> 
> +  -Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - SlotSelection policy added
> 
> +  <b>Revision 3</b>
> 
> +  - Deprecate PegGen3ProgramStaticEq and PegGen4ProgramStaticEq
> 
> +  <b>Revision 4</b>:
> 
> +  - Deprecating SetSecuredRegisterLock
> 
> +  <b>Revision 5</b>:
> 
> +  - Adding Serl
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER               Header;                   ///< Config Block Header
> 
> +  ///
> 
> +  /// These members describe the configuration of each SA PCIe root port.
> 
> +  ///
> 
> +  CPU_PCIE_ROOT_PORT_CONFIG
> RootPort[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +  ///
> 
> +  /// Gen3 Equalization settings for physical PCIe lane, index 0 represents
> PCIe lane 1, etc.
> 
> +  /// Corresponding entries are used when root port EqPh3Method is
> PchPcieEqStaticCoeff (default).
> 
> +  ///
> 
> +  CPU_PCIE_EQ_LANE_PARAM
> EqPh3LaneParam[SA_PEG_MAX_LANE];
> 
> +  ///
> 
> +  /// List of coefficients used during equalization (applicable to both
> software and hardware EQ)
> 
> +  ///
> 
> +  PCIE_EQ_PARAM
> HwEqGen4CoeffList[PCIE_HWEQ_COEFFS_MAX];  // Deprecated Policy
> 
> +
> 
> +  PCIE_COMMON_CONFIG                PcieCommonConfig;   /// <
> <b>(Test)</b> Includes policies which are common to both SA and PCH PCIe
> 
> +
> 
> +  UINT32  FiaProgramming                  :  1;        /// < Skip Fia Configuration and
> lock if enable
> 
> +  ///
> 
> +  /// This member describes whether the PCI Express Clock Gating for each
> root port
> 
> +  /// is enabled by platform modules. <b>0: Disable</b>; 1: Enable.
> 
> +  ///
> 
> +  UINT32  ClockGating                     :  1;
> 
> +  ///
> 
> +  /// This member describes whether the PCI Express Power Gating for each
> root port
> 
> +  /// is enabled by platform modules. <b>0: Disable</b>; 1: Enable.
> 
> +  ///
> 
> +  UINT32  PowerGating                     :  1;
> 
> +  // Deprecated Policy
> 
> +  /**
> 
> +    <b>(Test)</b> Program PEG Gen3 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT32  PegGen3ProgramStaticEq          :  1;
> 
> +
> 
> +  // Deprecated Policy
> 
> +  /**
> 
> +  <b>(Test)</b> Program PEG Gen4 EQ Phase1 Static Presets
> 
> +  - Disabled        (0x0)  : Disable EQ Phase1 Static Presets Programming
> 
> +  - <b>Enabled</b>  (0x1)  : Enable  EQ Phase1 Static Presets Programming
> (Default)
> 
> +  **/
> 
> +  UINT32  PegGen4ProgramStaticEq          :  1;
> 
> +  /**
> 
> +  <b>(Test)</b> Cpu Pcie Secure Register Lock
> 
> +  - Disabled        (0x0)
> 
> +  - <b>Enabled</b>  (0x1)
> 
> +  **/
> 
> +  UINT32  SetSecuredRegisterLock          :  1;  // Deprecated Policy
> 
> +  ///
> 
> +  /// This member allows to select between the PCI Express M2 or CEMx4
> slot <b>1: PCIe M2</b>; 0: CEMx4 slot.
> 
> +  ///
> 
> +  UINT32  SlotSelection                   :  1;
> 
> +  ///
> 
> +  /// Set/Clear Serl(Secure Equalization Register Lock)
> 
> +  ///
> 
> +  UINT32  Serl                            :  1;
> 
> +
> 
> +  UINT32  RsvdBits0                       : 24;
> 
> +
> 
> +  /**
> 
> +    PCIe device override table
> 
> +    The PCIe device table is being used to override PCIe device ASPM
> settings.
> 
> +    This is a pointer points to a 32bit address. And it's only used in PostMem
> phase.
> 
> +    Please refer to PCH_PCIE_DEVICE_OVERRIDE structure for the table.
> 
> +    Last entry VendorId must be 0.
> 
> +    The prototype of this policy is:
> 
> +    CPU_PCIE_DEVICE_OVERRIDE *PcieDeviceOverrideTablePtr;
> 
> +  **/
> 
> +  UINT32  PcieDeviceOverrideTablePtr;
> 
> +  } CPU_PCIE_CONFIG;

There are two fields missing from this definition:

CPU_PCIE_ROOT_PORT_CONFIG2         RootPort2[CPU_PCIE_MAX_ROOT_PORTS];
PCIE_COMMON_CONFIG2                PcieCommonConfig2;

> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_PCIE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
> new file mode 100644
> index 0000000000..445642da1f
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Dci/DciConfig.h
> @@ -0,0 +1,72 @@
> +/** @file
> 
> +  Dci policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DCI_CONFIG_H_
> 
> +#define _DCI_CONFIG_H_
> 
> +
> 
> +#define DCI_PREMEM_CONFIG_REVISION 2
> 
> +extern EFI_GUID gDciPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +typedef enum {
> 
> +  DciDbcDisabled       = 0x0,
> 
> +  DciDbcUsb2           = 0x1,
> 
> +  DciDbcUsb3           = 0x2,
> 
> +  DciDbcBoth           = 0x3,
> 
> +  DciDbcNoChange       = 0x4,
> 
> +  DciDbcMax
> 
> +} DCI_DBC_MODE;
> 
> +
> 
> +typedef enum {
> 
> +  Usb3TcDbgDisabled    = 0x0,
> 
> +  Usb3TcDbgEnabled     = 0x1,
> 
> +  Usb3TcDbgNoChange    = 0x2,
> 
> +  Usb3TcDbgMax
> 
> +} DCI_USB3_TYPE_C_DEBUG_MODE;
> 
> +
> 
> +/**
> 
> +  The PCH_DCI_PREMEM_CONFIG block describes policies related to Direct
> Connection Interface (DCI)
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Added DciModphyPg
> 
> +  - change to use data in byte unit rather than bit-field
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  /**
> 
> +    DCI enable.
> 
> +    Determine if to enable DCI debug from host.
> 
> +    <b>0:Disabled</b>; 1:Enabled
> 
> +  **/
> 
> +  UINT8    DciEn;
> 
> +  /**
> 
> +    USB DbC enable mode.
> 
> +    Disabled: Clear both USB2/3DBCEN; USB2: Set USB2DBCEN; USB3: Set
> USB3DBCEN; Both: Set both USB2/3DBCEN; No Change: Comply with HW
> value
> 
> +    Refer to definition of DCI_USB_DBC_MODE for supported settings.
> 
> +    0:Disabled; 1:USB2; 2:USB3; 3:Both; <b>4:No Change</b>
> 
> +  **/
> 
> +  UINT8    DciDbcMode;
> 
> +  /**
> 
> +    Enable Modphy power gate when DCI is enable. It must be disabled for 4-
> wire DCI OOB. Set default to HW default : Disabled
> 
> +    <b>0:Disabled</b>; 1:Enabled
> 
> +  **/
> 
> +  UINT8    DciModphyPg;
> 
> +  /**
> 
> +    USB3 Type-C UFP2DFP kenel / platform debug support. No change will do
> nothing to UFP2DFP configuration.
> 
> +    When enabled, USB3 Type C UFP (upstream-facing port) may switch to
> DFP (downstream-facing port) for first connection.
> 
> +    It must be enabled for USB3 kernel(kernel mode debug) and platform
> debug(DFx, DMA, Trace) over UFP Type-C receptacle.
> 
> +    Refer to definition of DCI_USB_TYPE_C_DEBUG_MODE for supported
> settings.
> 
> +    0:Disabled; 1:Enabled; <b>2:No Change</b>
> 
> +  **/
> 
> +  UINT8    DciUsb3TypecUfpDbg;
> 
> +} PCH_DCI_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _DCI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
> new file mode 100644
> index 0000000000..260b582702
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Espi/EspiConfig.h
> @@ -0,0 +1,61 @@
> +/** @file
> 
> +  Espi policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _ESPI_CONFIG_H_
> 
> +#define _ESPI_CONFIG_H_
> 
> +
> 
> +#define ESPI_CONFIG_REVISION 2
> 
> +extern EFI_GUID gEspiConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure contains the policies which are related to ESPI.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial revision
> 
> +  <b>Revision 2</b>:
> 
> +  - Added LockLinkConfiguration field to config block
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    LPC (eSPI) Memory Range Decode Enable. When TRUE, then the range
> 
> +    specified in PCLGMR[31:16] is enabled for decoding to LPC (eSPI).
> 
> +    <b>0: FALSE</b>, 1: TRUE
> 
> +  **/
> 
> +  UINT32    LgmrEnable            :  1;
> 
> +  /**
> 
> +    eSPI Master and Slave BME settings.
> 
> +    When TRUE, then the BME bit enabled in eSPI Master and Slave.
> 
> +    0: FALSE, <b>1: TRUE </b>
> 
> +  **/
> 
> +  UINT32    BmeMasterSlaveEnabled :  1;
> 
> +  /**
> 
> +    Master HOST_C10 (Virtual Wire) to Slave Enable (VWHC10OE)
> 
> +    <b>0b: Disable HOST_C10 reporting (HOST_C10 indication from PMC is
> ignored)</b>
> 
> +    1b: Enable HOST_C10 reporting to Slave via eSPI Virtual Wire (upon
> receiving a HOST_C10 indication from PMC)
> 
> +  **/
> 
> +  UINT32    HostC10ReportEnable   :  1;
> 
> +  /**
> 
> +    eSPI Link Configuration Lock (SBLCL)
> 
> +    If set to TRUE then communication through SET_CONFIG/GET_CONFIG
> 
> +    to eSPI slaves addresses from range 0x0 - 0x7FF
> 
> +    <b>1: TRUE</b>, 0: FALSE
> 
> +  **/
> 
> +  UINT32    LockLinkConfiguration :  1;
> 
> +  /**
> 
> +   Hardware Autonomous Enable (HAE)
> 
> +   If set to TRUE, then the IP may request a PG whenever it is idle
> 
> +  **/
> 
> +  UINT32    EspiPmHAE             :  1;
> 
> +  UINT32    RsvdBits              : 27;     ///< Reserved bits
> 
> +} PCH_ESPI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _ESPI_CONFIG_H_
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
> new file mode 100644
> index 0000000000..0df2755280
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Fivr/FivrConfig.h
> @@ -0,0 +1,170 @@
> +/** @file
> 
> +  PCH FIVR policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _FIVR_CONFIG_H_
> 
> +#define _FIVR_CONFIG_H_
> 
> +
> 
> +#define FIVR_CONFIG_REVISION 1
> 
> +extern EFI_GUID gFivrConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  Rail support in S0ix and Sx
> 
> +  Settings other than FivrRailDisabled can be OR'ed
> 
> +**/
> 
> +typedef enum {
> 
> +  FivrRailDisabled   = 0,
> 
> +  FivrRailInS0i1S0i2 = BIT0,
> 
> +  FivrRailInS0i3     = BIT1,
> 
> +  FivrRailInS3       = BIT2,
> 
> +  FivrRailInS4       = BIT3,
> 
> +  FivrRailInS5       = BIT4,
> 
> +  FivrRailInS0ix     = FivrRailInS0i1S0i2 | FivrRailInS0i3,
> 
> +  FivrRailInSx       = FivrRailInS3 | FivrRailInS4 | FivrRailInS5,
> 
> +  FivrRailAlwaysOn   = FivrRailInS0ix | FivrRailInSx
> 
> +} FIVR_RAIL_SX_STATE;
> 
> +
> 
> +typedef enum {
> 
> +  FivrRetentionActive = BIT0,
> 
> +  FivrNormActive      = BIT1,
> 
> +  FivrMinActive       = BIT2,
> 
> +  FivrMinRetention    = BIT3
> 
> +} FIVR_RAIL_SUPPORTED_VOLTAGE;
> 
> +
> 
> +/**
> 
> +  Structure for V1p05/Vnn VR rail configuration
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    Mask to enable the usage of external VR rail in specific S0ix or Sx states
> 
> +    Use values from FIVR_RAIL_SX_STATE
> 
> +    The default is <b>FivrRailDisabled</b>.
> 
> +  **/
> 
> +  UINT32  EnabledStates   : 5;
> 
> +
> 
> +  /**
> 
> +    VR rail voltage value that will be used in S0i2/S0i3 states.
> 
> +    This value is given in 2.5mV increments (0=0mV, 1=2.5mV, 2=5mV...)
> 
> +    The default for Vnn is set to <b>420 - 1050 mV</b>.
> 
> +  **/
> 
> +  UINT32  Voltage         : 11;
> 
> +  /**
> 
> +    @deprecated
> 
> +    THIS POLICY IS DEPRECATED, PLEASE USE IccMaximum INSTEAD
> 
> +    VR rail Icc Max Value
> 
> +    Granularity of this setting is 1mA and maximal possible value is 500mA
> 
> +    The default is <b> 0mA </b>.
> 
> +  **/
> 
> +  UINT32  IccMax          : 8;
> 
> +
> 
> +  /**
> 
> +  This register holds the control hold off values to be used when
> 
> +  changing the rail control for external bypass value in us
> 
> +  **/
> 
> +  UINT32   CtrlRampTmr    : 8;
> 
> +
> 
> +  /**
> 
> +    Mask to set the supported configuration in VR rail.
> 
> +    Use values from FIVR_RAIL_SUPPORTED_VOLTAGE
> 
> +  **/
> 
> +  UINT32  SupportedVoltageStates   : 4;
> 
> +
> 
> +  /**
> 
> +    VR rail Icc Maximum Value
> 
> +    Granularity of this setting is 1mA and maximal possible value is 500mA
> 
> +    The default is <b> 0mA </b>.
> 
> +  **/
> 
> +  UINT32  IccMaximum                : 16;
> 
> +
> 
> +  UINT32  RsvdBits1                 : 12;
> 
> +
> 
> +} FIVR_EXT_RAIL_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  Structure for VCCIN_AUX voltage rail configuration
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +  Transition time in microseconds from Low Current Mode Voltage to High
> Current Mode Voltage.
> 
> +  Voltage transition time required by motherboard voltage regulator when
> PCH changes
> 
> +  the VCCIN_AUX regulator set point from the low current mode voltage
> and high current mode voltage.
> 
> +  This field has 1us resolution.
> 
> +  When value is 0 PCH will not transition VCCIN_AUX to low current mode
> voltage.
> 
> +  The default is <b> 0xC </b>.
> 
> +  **/
> 
> +  UINT8  LowToHighCurModeVolTranTime;
> 
> +
> 
> +  /**
> 
> +  Transition time in microseconds from Retention Mode Voltage to High
> Current Mode Voltage.
> 
> +  Voltage transition time required by motherboard voltage regulator when
> PCH changes
> 
> +  the VCCIN_AUX regulator set point from the retention mode voltage to
> high current mode voltage.
> 
> +  This field has 1us resolution.
> 
> +  When value is 0 PCH will not transition VCCIN_AUX to retention voltage.
> 
> +  The default is <b> 0x36 </b>.
> 
> +  **/
> 
> +  UINT8  RetToHighCurModeVolTranTime;
> 
> +
> 
> +  /**
> 
> +  Transition time in microseconds from Retention Mode Voltage to Low
> Current Mode Voltage.
> 
> +  Voltage transition time required by motherboard voltage regulator when
> PCH changes
> 
> +  the VCCIN_AUX regulator set point from the retention mode voltage to
> low current mode voltage.
> 
> +  This field has 1us resolution.
> 
> +  When value is 0 PCH will not transition VCCIN_AUX to retention voltage.
> 
> +  The default is <b> 0x2B </b>.
> 
> +  **/
> 
> +  UINT8  RetToLowCurModeVolTranTime;
> 
> +  UINT8  RsvdByte1;
> 
> +  /**
> 
> +  Transition time in microseconds from Off (0V) to High Current Mode
> Voltage.
> 
> +  Voltage transition time required by motherboard voltage regulator when
> PCH changes
> 
> +  the VCCIN_AUX regulator set point from 0V to the high current mode
> voltage.
> 
> +  This field has 1us resolution.
> 
> +  0 = Transition to 0V is disabled
> 
> +  Setting this field to 0 sets VCCIN_AUX as a fixed rail that stays on
> 
> +  in all S0 & Sx power states after initial start up on G3 exit
> 
> +  The default is <b> 0x96 </b>.
> 
> +  **/
> 
> +  UINT32  OffToHighCurModeVolTranTime : 11;
> 
> +  UINT32  RsvdBits1                   : 21;
> 
> +} FIVR_VCCIN_AUX_CONFIG;
> 
> +
> 
> +/**
> 
> +  The PCH_FIVR_CONFIG block describes FIVR settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER      Header;  ///< Config Block Header
> 
> +  /**
> 
> +    External V1P05 VR rail configuration.
> 
> +  **/
> 
> +  FIVR_EXT_RAIL_CONFIG     ExtV1p05Rail;
> 
> +  /**
> 
> +    External Vnn VR rail configuration.
> 
> +  **/
> 
> +  FIVR_EXT_RAIL_CONFIG     ExtVnnRail;
> 
> +  /**
> 
> +    Additional External Vnn VR rail configuration that will get applied
> 
> +    in Sx entry SMI callback. Required only if External Vnn VR
> 
> +    needs different settings for Sx than those specified in ExtVnnRail.
> 
> +  **/
> 
> +  FIVR_EXT_RAIL_CONFIG     ExtVnnRailSx;
> 
> +  /**
> 
> +    VCCIN_AUX voltage rail configuration.
> 
> +  **/
> 
> +  FIVR_VCCIN_AUX_CONFIG    VccinAux;
> 
> +
> 
> +  /**
> 
> +    Enable/Disable FIVR Dynamic Power Management
> 
> +    Default is <b> 1 </b>.
> 
> +  **/
> 
> +  UINT32                   FivrDynPm : 1;
> 
> +  UINT32                   RsvdBits2 : 31;
> 
> +} PCH_FIVR_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _FIVR_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
> new file mode 100644
> index 0000000000..cb9411f9e8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gbe/GbeConfig.h
> @@ -0,0 +1,33 @@
> +/** @file
> 
> +  Gigabit Ethernet policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GBE_CONFIG_H_
> 
> +#define _GBE_CONFIG_H_
> 
> +
> 
> +#define GBE_CONFIG_REVISION 1
> 
> +extern EFI_GUID gGbeConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  PCH intergrated GBE controller configuration settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;  ///< Config Block Header
> 
> +  /**
> 
> +    Determines if enable PCH internal GBE, 0: Disable; <b>1: Enable</b>.
> 
> +    When Enable is changed (from disabled to enabled or from enabled to
> disabled),
> 
> +    it needs to set LAN Disable regsiter, which might be locked by FDSWL
> register.
> 
> +    So it's recommendated to issue a global reset when changing the status
> for PCH Internal LAN.
> 
> +  **/
> 
> +  UINT32  Enable          :  1;
> 
> +  UINT32  LtrEnable       :  1;  ///< <b>0: Disable</b>; 1: Enable LTR capabilty of
> PCH internal LAN.
> 
> +  UINT32  RsvdBits0       : 30;  ///< Reserved bits
> 
> +} GBE_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _GBE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
> new file mode 100644
> index 0000000000..87649253c6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gna/GnaConfig.h
> @@ -0,0 +1,31 @@
> +/** @file
> 
> +  Policy definition for GNA Config Block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GNA_CONFIG_H_
> 
> +#define _GNA_CONFIG_H_
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define GNA_CONFIG_REVISION 1
> 
> +/**
> 
> + GNA config block for configuring GNA.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER         Header;                   ///< Offset 0-27 Config
> Block Header
> 
> +  /**
> 
> +  Offset 28:0
> 
> +  This policy enables the GNA Device (SA Device 8) if supported.
> 
> +  If FALSE, all other policies in this config block will be ignored.
> 
> +  <b>1=TRUE</b>;
> 
> +  0=FALSE.
> 
> +   **/
> 
> +  UINT32                      GnaEnable : 1;
> 
> +  UINT32                      RsvdBits0 : 31; ///< Offset 28:1 :Reserved for future use
> 
> +} GNA_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _GNA_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig
> .h
> new file mode 100644
> index 0000000000..1a724f14da
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Gpio/GpioDevConfig
> .h
> @@ -0,0 +1,37 @@
> +/** @file
> 
> +  GPIO device policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_DEV_CONFIG_H_
> 
> +#define _GPIO_DEV_CONFIG_H_
> 
> +
> 
> +extern EFI_GUID gGpioDxeConfigGuid;
> 
> +
> 
> +#define GPIO_DXE_CONFIG_REVISION 1
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure contains the DXE policies which are related to GPIO device.
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Inital version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
> 
> +  /**
> 
> +    If GPIO ACPI device is not used by OS it can be hidden. In such case
> 
> +    no other device exposed to the system can reference GPIO device in one
> 
> +    of its resources through GpioIo(..) or GpioInt(..) ACPI descriptors.
> 
> +    <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32  HideGpioAcpiDevice    :  1;
> 
> +  UINT32  RsvdBits              : 31;    ///< Reserved bits
> 
> +
> 
> +} GPIO_DXE_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _GPIO_DEV_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/Gra
> phicsConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/Gra
> phicsConfig.h
> new file mode 100644
> index 0000000000..c3b134b830
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Graphics/Gen12/Gra
> phicsConfig.h
> @@ -0,0 +1,211 @@
> +/** @file
> 
> +  Policy definition for Internal Graphics Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GRAPHICS_CONFIG_H_
> 
> +#define _GRAPHICS_CONFIG_H_
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define GRAPHICS_PEI_PREMEM_CONFIG_REVISION 3
> 
> +#define GRAPHICS_PEI_CONFIG_REVISION        7
> 
> +#define GRAPHICS_DXE_CONFIG_REVISION        1
> 
> +
> 
> +#define DDI_DEVICE_NUMBER   4
> 
> +#define MAX_BCLM_ENTRIES    20
> 
> +
> 
> +
> 
> +//
> 
> +// DDI defines
> 
> +//
> 
> +typedef enum {
> 
> +  DdiDisable       = 0x00,
> 
> +  DdiDdcEnable     = 0x01,
> 
> +} DDI_DDC_TBT_VAL;
> 
> +
> 
> +typedef enum {
> 
> +  DdiHpdDisable  = 0x00,
> 
> +  DdiHpdEnable   = 0x01,
> 
> +} DDI_HPD_VAL;
> 
> +
> 
> +typedef enum {
> 
> +  DdiPortDisabled = 0x00,
> 
> +  DdiPortEdp      = 0x01,
> 
> +  DdiPortMipiDsi  = 0x02,
> 
> +} DDI_PORT_SETTINGS;
> 
> +
> 
> +/**
> 
> +  This structure configures the Native GPIOs for DDI port per VBT settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8 DdiPortAConfig; /// The Configuration of DDI port A, this settings
> must match VBT's settings. DdiPortDisabled - No LFP is connected on
> DdiPortA, <b>DdiPortEdp - Set DdiPortA to eDP</b>, DdiPortMipiDsi - Set
> DdiPortA to MIPI DSI
> 
> +  UINT8 DdiPortBConfig; /// The Configuration of DDI port B, this settings
> must match VBT's settings. DdiPortDisabled - No LFP is connected on
> DdiPortB, <b>DdiPortEdp - Set DdiPortB to eDP</b>, DdiPortMipiDsi - Set
> DdiPortB to MIPI DSI
> 
> +  UINT8 DdiPortAHpd;    /// The HPD setting of DDI Port A, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPortBHpd;    /// The HPD setting of DDI Port B, this settings must
> match VBT's settings. DdiHpdDisable - Disable HPD, <b>DdiHpdEnable -
> Enable HPD</b>
> 
> +  UINT8 DdiPortCHpd;    /// The HPD setting of DDI Port C, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPort1Hpd;    /// The HPD setting of DDI Port 1, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPort2Hpd;    /// The HPD setting of DDI Port 2, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPort3Hpd;    /// The HPD setting of DDI Port 3, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPort4Hpd;    /// The HPD setting of DDI Port 4, this settings must
> match VBT's settings. <b>DdiHpdDisable - Disable HPD</b>, DdiHpdEnable -
> Enable HPD
> 
> +  UINT8 DdiPortADdc;    /// The DDC setting of DDI Port A, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +  UINT8 DdiPortBDdc;    /// The DDC setting of DDI Port B, this settings must
> match VBT's settings. DdiDisable - Disable DDC, <b>DdiDdcEnable - Enable
> DDC </b>
> 
> +  UINT8 DdiPortCDdc;    /// The DDC setting of DDI Port C, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +  UINT8 DdiPort1Ddc;    /// The DDC setting of DDI Port 1, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +  UINT8 DdiPort2Ddc;    /// The DDC setting of DDI Port 2, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +  UINT8 DdiPort3Ddc;    /// The DDC setting of DDI Port 3, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +  UINT8 DdiPort4Ddc;    /// The DDC setting of DDI Port 4, this settings must
> match VBT's settings. <b>DdiDisable - Disable DDC</b>, DdiDdcEnable -
> Enable DDC
> 
> +} DDI_CONFIGURATION;
> 
> +
> 
> +/**
> 
> +  This Configuration block is to configure GT related PreMem
> data/variables.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Added DfdRestoreEnable.
> 
> +  <b>Revision 3</b>:
> 
> +  - Added DdiConfiguration.
> 
> +  <b>Revision 4</b>:
> 
> +  - Added GmAdr64 and made GmAdr obselete
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27 Config Block
> Header
> 
> +  /**
> 
> +    Offset 28
> 
> +    Selection of the primary display device: 0=iGFX, 1=PEG, 2=PCIe Graphics
> on PCH, <b>3=AUTO</b>, 4=Switchable Graphics\n
> 
> +    When AUTO mode selected, the priority of display devices is: PCIe
> Graphics on PCH > PEG > iGFX
> 
> +  **/
> 
> +  UINT8                PrimaryDisplay;
> 
> +  /**
> 
> +    Offset 29
> 
> +    Intel Gfx Support. It controls enabling/disabling iGfx device.
> 
> +    When AUTO mode selected, iGFX will be turned off when external
> graphics detected.
> 
> +    If FALSE, all other polices can be ignored.
> 
> +    <b>2 = AUTO</b>;
> 
> +    0 = FALSE;
> 
> +    1 = TRUE.
> 
> +  **/
> 
> +  UINT8                InternalGraphics;
> 
> +  /**
> 
> +    Offset 30
> 
> +    Pre-allocated memory for iGFX\n
> 
> +    0   = 0MB,1 or 247 = 32MB,\n
> 
> +    2   = 64MB,\n
> 
> +    240 = 4MB,     241 = 8MB,\n
> 
> +    242 = 12MB,    243 = 16MB,\n
> 
> +    244 = 20MB,    245 = 24MB,\n
> 
> +    246 = 28MB,    248 = 36MB,\n
> 
> +    249 = 40MB,    250 = 44MB,\n
> 
> +    251 = 48MB,    252 = 52MB,\n
> 
> +    253 = 56MB,<b> 254 = 60MB</b>,\n
> 
> +    <b>Note: enlarging pre-allocated memory for iGFX may need to reduce
> MmioSize because of 4GB boundary limitation</b>
> 
> +  **/
> 
> +  UINT16               IgdDvmt50PreAlloc;
> 
> +  UINT8                PanelPowerEnable;    ///< Offset 32 :<b>(Test)</b> Control
> for enabling/disabling VDD force bit (Required only for early enabling of eDP
> panel): 0=FALSE, <b>1=TRUE</b>
> 
> +  UINT8                ApertureSize;        ///< Offset 33 :Graphics aperture size
> (256MB is the recommended size as per BWG) : 0=128MB,
> <b>1=256MB</b>, 3=512MB, 7=1024MB, 15=2048MB.
> 
> +  UINT8                GtPsmiSupport;       ///< Offset 34 :PSMI support On/Off:
> <b>0=FALSE</b>, 1=TRUE
> 
> +  UINT8                PsmiRegionSize;      ///< Offset 35 :Psmi region size:
> <b>0=32MB</b>, 1=288MB, 2=544MB, 3=800MB, 4=1056MB
> 
> +  UINT8                DismSize;            ///< Offset 36 :DiSM Size for 2LM Sku:
> <b>0=0GB</b>, 1=1GB, 2=2GB, 3=3GB, 4=4GB, 5=5GB, 6=6GB, 7=7GB
> 
> +  UINT8                DfdRestoreEnable;    ///< Offset 37 :Display memory map
> programming for DFD Restore <b>0- Disable</b>, 1- Enable
> 
> +  UINT16               GttSize;             ///< Offset 38 :Selection of iGFX GTT Memory
> size: 1=2MB, 2=4MB, <b>3=8MB</b>
> 
> +  /**
> 
> +  Offset 40
> 
> +  Temp Address of System Agent GTTMMADR: Default is
> <b>0xAF000000</b>
> 
> +  **/
> 
> +  UINT32               GttMmAdr;
> 
> +  UINT32               GmAdr;               ///< Offset 44 Obsolete not to be used, use
> GmAdr64
> 
> +  DDI_CONFIGURATION    DdiConfiguration;    ///< Offset 48 DDI
> configuration, need to match with VBT settings.
> 
> +
> 
> +  UINT8                GtClosEnable;        ///< Offset 50 Gt ClOS
> 
> +  UINT8                Rsvd0[7];            ///< Offset 51 Reserved for 4 bytes of
> alignment
> 
> +  /**
> 
> +  Offset 58
> 
> +  Temp Address of System Agent GMADR: Default is <b>0xB0000000</b>
> 
> +  **/
> 
> +  UINT64               GmAdr64;
> 
> +} GRAPHICS_PEI_PREMEM_CONFIG;
> 
> +
> 
> +/**
> 
> +  This configuration block is to configure IGD related variables used in
> PostMem PEI.
> 
> +  If Intel Gfx Device is not supported, all policies can be ignored.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Removed DfdRestoreEnable.
> 
> +  <b>Revision 3</b>:
> 
> +  - Removed DdiConfiguration.
> 
> +  <b>Revision 4</b>:
> 
> +  - Added new CdClock frequency
> 
> +  <b>Revision 5</b>:
> 
> +  - Added GT Chicket bits
> 
> +  <b>Revision 6</b>:
> 
> +  - Added LogoPixelHeight and LogoPixelWidth
> 
> +  <b>Revision 7</b>:
> 
> +  - Added SkipFspGop
> 
> +
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block
> Header
> 
> +  UINT8                RenderStandby;        ///< Offset 28 :<b>(Test)</b> This field
> is used to enable or disable RC6 (Render Standby): 0=FALSE, <b>1=TRUE</b>
> 
> +  UINT8                PmSupport;            ///< Offset 29 :<b>(Test)</b> IGD PM
> Support TRUE/FALSE: 0=FALSE, <b>1=TRUE</b>
> 
> +  /**
> 
> +    Offset 30
> 
> +    CdClock Frequency select\n
> 
> +    <b>0xFF = Auto. Max CdClock freq based on Reference Clk</b> \n
> 
> +     0: 192 Mhz, 1: 307.2 Mhz, 2: 312 Mhz, 3: 324 Mhz, 4: 326.4 Mhz, 5: 552
> Mhz, 6: 556.8 Mhz, 7: 648 Mhz, 8: 652.8 Mhz
> 
> +
> 
> +  **/
> 
> +  UINT16               CdClock;
> 
> +  UINT8                PeiGraphicsPeimInit;  ///< Offset 32 : This policy is used to
> enable/disable Intel Gfx PEIM.<b>0- Disable</b>, 1- Enable
> 
> +  UINT8                CdynmaxClampEnable;   ///< Offset 33 : This policy is used to
> enable/disable CDynmax Clamping Feature (CCF) <b>1- Enable</b>, 0-
> Disable
> 
> +  UINT16               GtFreqMax;            ///< Offset 34 : <b>(Test)</b> Max GT
> frequency limited by user in multiples of 50MHz: Default value which
> indicates normal frequency is <b>0xFF</b>
> 
> +  UINT8                DisableTurboGt;       ///< Offset 36 : This policy is used to
> enable/disable DisableTurboGt <b>0- Disable</b>, 1- Enable
> 
> +  UINT8                SkipCdClockInit;      ///< Offset 37 : SKip full CD clock
> initialization. <b>0- Disable</b>, 1- Enable
> 
> +  UINT8                RC1pFreqEnable;       ///< Offset 38 : This policy is used to
> enable/disable RC1p Frequency. <b>0- Disable</b>, 1- Enable
> 
> +  UINT8                PavpEnable;           ///< Offset 39 :IGD PAVP TRUE/FALSE:
> 0=FALSE, <b>1=TRUE</b>
> 
> +  VOID*                LogoPtr;              ///< Offset 40 Address of Intel Gfx PEIM
> Logo to be displayed
> 
> +  UINT32               LogoSize;             ///< Offset 44 Intel Gfx PEIM Logo Size
> 
> +  VOID*                GraphicsConfigPtr;    ///< Offset 48 Address of the Graphics
> Configuration Table
> 
> +  VOID*                BltBufferAddress;     ///< Offset 52 Address of Blt buffer for
> PEIM Logo use
> 
> +  UINT32               BltBufferSize;        ///< Offset 56 The size for Blt Buffer,
> calculating by PixelWidth * PixelHeight * 4 bytes (the size of
> EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
> 
> +  UINT8                ProgramGtChickenBits; ///< Offset 60 Program GT Chicket
> bits in GTTMMADR + 0xD00 BITS [3:1].
> 
> +  UINT8                SkipFspGop;           ///< Offset 61 This policy is used to skip
> PEIM GOP in FSP.<b>0- Use FSP provided GOP driver</b>, 1- Skip FSP
> provided GOP driver
> 
> +  UINT8                Rsvd1[2];             ///< Offset 62 Reserved for 4 bytes
> alignment
> 
> +  UINT32               LogoPixelHeight;      ///< Offset 64 Address of
> LogoPixelHeight for PEIM Logo use
> 
> +  UINT32               LogoPixelWidth;       ///< Offset 68 Address of
> LogoPixelWidth for PEIM Logo use
> 
> +} GRAPHICS_PEI_CONFIG;
> 
> +
> 
> +/**
> 
> +  This configuration block is to configure IGD related variables used in DXE.
> 
> +  If Intel Gfx Device is not supported or disabled, all policies will be ignored.
> 
> +  The data elements should be initialized by a Platform Module.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27: Config Block
> Header
> 
> +  UINT32                Size;                     ///< Offset 28 - 31: This field gives the size of
> the GOP VBT Data buffer
> 
> +  EFI_PHYSICAL_ADDRESS  VbtAddress;               ///< Offset 32 - 39: This field
> points to the GOP VBT data buffer
> 
> +  UINT8                 PlatformConfig;           ///< Offset 40: This field gives the
> Platform Configuration Information (0=Platform is S0ix Capable for ULT SKUs
> only, <b>1=Platform is not S0ix Capable</b>, 2=Force Platform is S0ix
> Capable for All SKUs)
> 
> +  UINT8                 AlsEnable;                ///< Offset 41: Ambient Light Sensor
> Enable: <b>0=Disable</b>, 2=Enable
> 
> +  UINT8                 BacklightControlSupport;  ///< Offset 42: Backlight Control
> Support: 0=PWM Inverted, <b>2=PWM Normal</b>
> 
> +  UINT8                 IgdBootType;              ///< Offset 43: IGD Boot Type CMOS
> option: <b>0=Default</b>, 0x01=CRT, 0x04=EFP, 0x08=LFP, 0x20=EFP3,
> 0x40=EFP2, 0x80=LFP2
> 
> +  UINT32                IuerStatusVal;            ///< Offset 44 - 47: Offset 16 This field
> holds the current status of all the supported Ultrabook events (Intel(R)
> Ultrabook Event Status bits)
> 
> +  CHAR16                GopVersion[0x10];         ///< Offset 48 - 79:This field holds
> the GOP Driver Version. It is an Output Protocol and updated by the Silicon
> code
> 
> +  /**
> 
> +    Offset 80: IGD Panel Type CMOS option\n
> 
> +    <b>0=Default</b>, 1=640X480LVDS, 2=800X600LVDS, 3=1024X768LVDS,
> 4=1280X1024LVDS, 5=1400X1050LVDS1\n
> 
> +    6=1400X1050LVDS2, 7=1600X1200LVDS, 8=1280X768LVDS,
> 9=1680X1050LVDS, 10=1920X1200LVDS, 13=1600X900LVDS\n
> 
> +    14=1280X800LVDS, 15=1280X600LVDS, 16=2048X1536LVDS,
> 17=1366X768LVDS
> 
> +  **/
> 
> +  UINT8                 IgdPanelType;
> 
> +  UINT8                 IgdPanelScaling;          ///< Offset 81: IGD Panel Scaling:
> <b>0=AUTO</b>, 1=OFF, 6=Force scaling
> 
> +  UINT8                 IgdBlcConfig;             ///< Offset 82: Backlight Control
> Support: 0=PWM Inverted, <b>2=PWM Normal</b>
> 
> +  UINT8                 IgdDvmtMemSize;           ///< Offset 83: IGD DVMT Memory
> Size: 1=128MB, <b>2=256MB</b>, 3=MAX
> 
> +  UINT8                 GfxTurboIMON;             ///< Offset 84: IMON Current Value:
> 14=Minimal, <b>31=Maximum</b>
> 
> +  UINT8                 Reserved[3];              ///< Offset 85: Reserved for DWORD
> alignment.
> 
> +  UINT16                BCLM[MAX_BCLM_ENTRIES];   ///< Offset 88: IGD Backlight
> Brightness Level Duty cycle Mapping Table.
> 
> +} GRAPHICS_DXE_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _GRAPHICS_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.
> h
> new file mode 100644
> index 0000000000..a2e0a65e45
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Hda/HdAudioConfig.
> h
> @@ -0,0 +1,227 @@
> +/** @file
> 
> +  HDAUDIO policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HDAUDIO_CONFIG_H_
> 
> +#define _HDAUDIO_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +#define HDAUDIO_PREMEM_CONFIG_REVISION 2
> 
> +#define HDAUDIO_CONFIG_REVISION 1
> 
> +#define HDAUDIO_DXE_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gHdAudioPreMemConfigGuid;
> 
> +extern EFI_GUID gHdAudioConfigGuid;
> 
> +extern EFI_GUID gHdAudioDxeConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// The PCH_HDAUDIO_CONFIG block describes the expected configuration
> of the Intel HD Audio feature.
> 
> +///
> 
> +
> 
> +#define HDAUDIO_VERB_TABLE_VIDDID(Vid,Did)
> (UINT32)((UINT16)Vid | ((UINT16)Did << 16))
> 
> +#define HDAUDIO_VERB_TABLE_RID_SDI_SIZE(Rid,Sdi,VerbTableSize)
> (UINT32)((UINT8)Rid | ((UINT8)Sdi << 8) | ((UINT16)VerbTableSize << 16))
> 
> +#define HDAUDIO_VERB_TABLE_CMD_SIZE(VerbTable)                  ((sizeof
> (VerbTable) - sizeof (HDA_VERB_TABLE_HEADER)) / (sizeof (UINT32)))
> 
> +
> 
> +///
> 
> +/// Use this macro to create HDAUDIO_VERB_TABLE and populate size
> automatically
> 
> +///
> 
> +#define HDAUDIO_VERB_TABLE_INIT(Vid,Did,Rid,Sdi,...) \
> 
> +{ \
> 
> +  { Vid, Did, Rid, Sdi, (sizeof((UINT32[]){__VA_ARGS__})/sizeof(UINT32)) }, \
> 
> +  { __VA_ARGS__ } \
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Azalia verb table header
> 
> +  Every verb table should contain this defined header and followed by azalia
> verb commands.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16  VendorId;             ///< Codec Vendor ID
> 
> +  UINT16  DeviceId;             ///< Codec Device ID
> 
> +  UINT8   RevisionId;           ///< Revision ID of the codec. 0xFF matches any
> revision.
> 
> +  UINT8   SdiNum;               ///< SDI number, 0xFF matches any SDI.
> 
> +  UINT16  DataDwords;           ///< Number of data DWORDs following the
> header.
> 
> +} HDA_VERB_TABLE_HEADER;
> 
> +
> 
> +#ifdef _MSC_VER
> 
> +//
> 
> +// Disable "zero-sized array in struct/union" extension warning.
> 
> +// Used for neater verb table definitions.
> 
> +//
> 
> +#pragma warning (push)
> 
> +#pragma warning (disable: 4200)
> 
> +#endif
> 
> +typedef struct  {
> 
> +  HDA_VERB_TABLE_HEADER  Header;
> 
> +  UINT32 Data[];
> 
> +} HDAUDIO_VERB_TABLE;
> 
> +#ifdef _MSC_VER
> 
> +#pragma warning (pop)
> 
> +#endif
> 
> +
> 
> +typedef struct {
> 
> +  UINT32   ClkA;            ///<  Pin mux configuration. Refer to
> GPIO_*_MUXING_DMIC*_CLKA_*
> 
> +  UINT32   ClkB;            ///<  Pin mux configuration. Refer to
> GPIO_*_MUXING_DMIC*_CLKB_*
> 
> +  UINT32   Data;            ///<  Pin mux configuration. Refer to
> GPIO_*_MUXING_DMIC*_DATA_*
> 
> +} HDA_DMIC_PIN_MUX;
> 
> +
> 
> +/**
> 
> +  HD Audio Link Policies
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  Enable    :  1;  ///< HDA interface enable. When enabled related
> pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  RsvdBits0 : 31;
> 
> +  UINT8   SdiEnable[PCH_MAX_HDA_SDI];  ///< HDA SDI signal enable.
> When enabled related SDI pins will be switched to appropriate native mode:
> <b>0: Disable</b>; 1: Enable
> 
> +  UINT8   Reserved[(4 - (PCH_MAX_HDA_SDI % 4)) % 4];  ///< Padding for
> SDI enable table.
> 
> +} HDA_LINK_HDA;
> 
> +
> 
> +/**
> 
> +  HD Audio DMIC Interface Policies
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32             Enable          :  1;  ///< HDA DMIC interface enable. When
> enabled related pins will be switched to native mode: <b>0: Disable</b>; 1:
> Enable.
> 
> +  UINT32             DmicClockSelect :  2;  ///< DMIC link clock select: <b>0:
> Both</b>, 1: ClkA, 2: ClkB; default is "Both"
> 
> +  UINT32             RsvdBits0       : 29;
> 
> +  HDA_DMIC_PIN_MUX   PinMux;          ///< Pin mux configuration.
> 
> +} HDA_LINK_DMIC;
> 
> +
> 
> +/**
> 
> +  HD Audio SSP Interface Policies
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32             Enable    :  1;  ///< HDA SSP interface enable. When enabled
> related pins will be switched to native mode: <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32             RsvdBits0 : 31;
> 
> +} HDA_LINK_SSP;
> 
> +
> 
> +/**
> 
> +  HD Audio SNDW Interface Policies
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32             Enable    :  1;  ///< HDA SNDW interface enable. When
> enabled related pins will be switched to native mode: <b>0: Disable</b>; 1:
> Enable.
> 
> +  UINT32             RsvdBits0 : 31;
> 
> +} HDA_LINK_SNDW;
> 
> +
> 
> +
> 
> +/**
> 
> +  This structure contains the policies which are related to HD Audio device
> (cAVS).
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Inital version.
> 
> +
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
> 
> +  UINT32  Pme                   :  1;    ///< Azalia wake-on-ring, <b>0: Disable</b>; 1:
> Enable
> 
> +  UINT32  CodecSxWakeCapability :  1;    ///< Capability to detect wake
> initiated by a codec in Sx (eg by modem codec), <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  HdAudioLinkFrequency  :  4;    ///< HDA-Link frequency
> (PCH_HDAUDIO_LINK_FREQUENCY enum): <b>2: 24MHz</b>, 1: 12MHz, 0:
> 6MHz
> 
> +  UINT32  RsvdBits0             : 26;    ///< Reserved bits 0
> 
> +  /**
> 
> +    Number of the verb table entry defined in VerbTablePtr.
> 
> +    Each entry points to a verb table which contains HDAUDIO_VERB_TABLE
> structure and verb command blocks.
> 
> +  **/
> 
> +  UINT8   VerbTableEntryNum;
> 
> +  UINT8   Rsvd0[3];                         ///< Reserved bytes, align to multiple 4
> 
> +  /**
> 
> +    Pointer to a verb table array.
> 
> +    This pointer points to 32bits address, and is only eligible and consumed in
> post mem phase.
> 
> +    Each entry points to a verb table which contains HDAUDIO_VERB_TABLE
> structure and verb command blocks.
> 
> +    The prototype of this is:
> 
> +    HDAUDIO_VERB_TABLE **VerbTablePtr;
> 
> +  **/
> 
> +  UINT32  VerbTablePtr;
> 
> +} HDAUDIO_CONFIG;
> 
> +
> 
> +/**
> 
> +  This structure contains the premem policies which are related to HD Audio
> device (cAVS).
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Inital version.
> 
> +  <b>Revision 2:</b>
> 
> +  - Add DmicClockSelect
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;          ///< Config Block Header
> 
> +  UINT32  Enable                :  1;    ///< Intel HD Audio (Azalia) enablement: 0:
> Disable, <b>1: Enable</b>
> 
> +  UINT32  DspEnable             :  1;    ///< DSP enablement: 0: Disable; <b>1:
> Enable</b>
> 
> +  UINT32  VcType                :  1;    ///< Virtual Channel Type Select: <b>0:
> VC0</b>, 1: VC1
> 
> +  /**
> 
> +    Universal Audio Architecture compliance for DSP enabled system:
> 
> +    <b>0: Not-UAA Compliant (Intel SST driver supported only)</b>,
> 
> +       1: UAA Compliant (HDA Inbox driver or SST driver supported)
> 
> +  **/
> 
> +  UINT32  DspUaaCompliance      :  1;
> 
> +  UINT32  IDispLinkFrequency    :  4;    ///< iDisp-Link frequency
> (PCH_HDAUDIO_LINK_FREQUENCY enum): <b>4: 96MHz</b>, 3: 48MHz
> 
> +  UINT32  IDispLinkTmode        :  3;    ///< iDisp-Link T-Mode
> (PCH_HDAUDIO_IDISP_TMODE enum): <b>0: 2T</b>, 1: 1T, 2: 4T, 3: 8T, 4:
> 16T
> 
> +  UINT32  IDispCodecDisconnect  :  1;    ///< iDisplay Audio Codec
> disconnection, <b>0: Not disconnected, enumerable</b>; 1: Disconnected
> SDI, not enumerable
> 
> +  UINT32  PowerGatingSupported  :  1;    ///< Power Gating supported: <b>0:
> Not supported</b>, 1: Supported
> 
> +  UINT32  RsvdBits              : 19;    ///< Reserved bits 0
> 
> +
> 
> +  /**
> 
> +    Audio Link Mode configuration bitmask.
> 
> +    Allows to configure enablement of the following interfaces: HDA-Link,
> DMIC, SSP, SoundWire.
> 
> +  **/
> 
> +
> 
> +  HDA_LINK_HDA          AudioLinkHda;    ///< HDA-Link enablement: 0:
> Disable; <b>1: Enable</b>.
> 
> +  /**
> 
> +    DMIC link enablement: 0: Disable; <b>1: Enable</b>.
> 
> +    DMIC0  LKF: Muxed with SNDW2/SNDW4.
> 
> +  **/
> 
> +  HDA_LINK_DMIC         AudioLinkDmic [2];
> 
> +  /**
> 
> +    I2S/SSP link enablement: <b>0: Disable</b>; 1: Enable.
> 
> +    SSP0/1 LKF: Muxed with HDA.
> 
> +    @note Since the I2S/SSP2 pin set contains pads which are also used for
> CNVi purpose, enabling AudioLinkSsp2
> 
> +    is exclusive with CNVi is present.
> 
> +  **/
> 
> +  HDA_LINK_SSP          AudioLinkSsp  [PCH_MAX_HDA_SSP_LINK_NUM];
> 
> +  /**
> 
> +    SoundWire link enablement: <b>0: Disable</b>; 1: Enable.
> 
> +    SNDW2  LKF: Muxed with DMIC0/DMIC1.
> 
> +    SNDW3  LKF: Muxed with DMIC1.
> 
> +    SNDW4  LKF: Muxed with DMIC0.
> 
> +  **/
> 
> +  HDA_LINK_SNDW         AudioLinkSndw
> [PCH_MAX_HDA_SNDW_LINK_NUM];
> 
> +
> 
> +
> 
> +  UINT16  ResetWaitTimer;                   ///< <b>(Test)</b> The delay timer
> after Azalia reset, the value is number of microseconds. Default is
> <b>600</b>.
> 
> +  UINT8   Rsvd0[2];                         ///< Reserved bytes, align to multiple 4
> 
> +
> 
> +} HDAUDIO_PREMEM_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  AutonomousClockStop        :  1;    ///< SoundWire1 link
> autonomous clock stop capability: <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  DataOnActiveIntervalSelect :  2;    ///< SoundWire1 link data on
> active interval select 0: 3 clock periods; <b>1: 4 clock periods</b>; 2: 5 clock
> periods; 3: 6 clock periods
> 
> +  UINT32  DataOnDelaySelect          :  1;    ///< SoundWire1 link data on delay
> select 0: 2 clock periods; <b>1: 3 clock periods</b>
> 
> +  UINT32  RsvdBits1                  : 28;    ///< Reserved bits 1
> 
> +} HDAUDIO_SNDW_CONFIG;
> 
> +
> 
> +/**
> 
> +  This structure contains the DXE policies which are related to HD Audio
> device (cAVS).
> 
> +  <b>Revision 1:</b>
> 
> +  - Inital version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER        Header;          ///< Config Block Header
> 
> +  /**
> 
> +    SNDW configuration for exposed via SNDW ACPI tables:
> 
> +  **/
> 
> +  HDAUDIO_SNDW_CONFIG
> SndwConfig[PCH_MAX_HDA_SNDW_LINK_NUM];
> 
> +  /**
> 
> +    Bitmask of supported DSP features:
> 
> +    [BIT0] - WoV; [BIT1] - BT Sideband; [BIT2] - Codec VAD; [BIT5] - BT Intel
> HFP; [BIT6] - BT Intel A2DP
> 
> +    [BIT7] - DSP based speech pre-processing disabled; [BIT8] - 0: Intel WoV,
> 1: Windows Voice Activation
> 
> +    Default is <b>zero</b>.
> 
> +  **/
> 
> +  UINT32  DspFeatureMask;
> 
> +} HDAUDIO_DXE_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _HDAUDIO_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBrid
> geConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBrid
> geConfig.h
> new file mode 100644
> index 0000000000..67335be92e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HostBridge/HostBrid
> geConfig.h
> @@ -0,0 +1,62 @@
> +/** @file
> 
> +  Configurations for HostBridge
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HOST_BRIDGE_CONFIG_H_
> 
> +#define _HOST_BRIDGE_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define HOST_BRIDGE_PREMEM_CONFIG_REVISION 1
> 
> +#define HOST_BRIDGE_PEI_CONFIG_REVISION    1
> 
> +
> 
> +extern EFI_GUID gHostBridgePeiPreMemConfigGuid;
> 
> +extern EFI_GUID gHostBridgePeiConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This configuration block describes HostBridge settings in PreMem.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block
> Header
> 
> +  UINT32  MchBar;                            ///< Offset 28 Address of System Agent
> MCHBAR: <b>0xFEDC0000(TGL)/0xFED10000(RKL)/0xFEA80000(JSL)<b>
> 
> +  UINT32  DmiBar;                            ///< Offset 32 Address of System Agent
> DMIBAR: <b>0xFEDA0000</b>
> 
> +  UINT32  EpBar;                             ///< Offset 36 Address of System Agent
> EPBAR: <b>0xFEDA1000</b>
> 
> +  UINT32  GdxcBar;                           ///< Offset 40 Address of System Agent
> GDXCBAR: <b>0xFED84000</b>
> 
> +  UINT32  RegBar;                            ///< Offset 44 Address of System Agent
> REGBAR: <b>0xFB000000</b>
> 
> +  UINT32  EdramBar;                          ///< Offset 48 Address of System Agent
> EDRAMBAR: <b>0xFED80000</b>
> 
> +  /**
> 
> +    Offset 52 :
> 
> +    Size of reserved MMIO space for PCI devices\n
> 
> +    <b>0=AUTO</b>, 512=512MB, 768=768MB, 1024=1024MB, 1280=1280MB,
> 1536=1536MB, 1792=1792MB,
> 
> +    2048=2048MB, 2304=2304MB, 2560=2560MB, 2816=2816MB,
> 3072=3072MB\n
> 
> +    When AUTO mode selected, the MMIO size will be calculated by required
> MMIO size from PCIe devices detected.
> 
> +  **/
> 
> +  UINT32  MmioSize;
> 
> +  UINT32  MmioSizeAdjustment;                ///< Offset 56 Increase (given
> positive value) or Decrease (given negative value) the Reserved MMIO size
> when Dynamic Tolud/AUTO mode enabled (in MBs): <b>0=no
> adjustment</b>
> 
> +  UINT8   EnableAbove4GBMmio;                ///< Offset 60 Enable/disable
> above 4GB MMIO resource support: 0=Disable, <b>1=Enable</b>
> 
> +  UINT8   Reserved[3];                       ///< Offset 61 Reserved for future use.
> 
> +} HOST_BRIDGE_PREMEM_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  This configuration block describes HostBridge settings in Post-Mem.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block
> Header
> 
> +  UINT8  Device4Enable;                      ///< Offser 28 :This policy is used to
> control enable or disable System Agent Thermal device (0,4,0).
> <b>0=FALSE</b>, 1=TRUE.
> 
> +  UINT8  ChapDeviceEnable;                   ///< Offset 29 :<b>(Test)</b>This
> policy is used to control enable or disable System Agent Chap device (0,7,0).
> <b>0=FALSE</b>, 1=TRUE.
> 
> +  UINT8  SkipPamLock;                        ///< Offset 30 :To skip PAM register
> locking. @note It is still recommended to set PCI Config space B0: D0: F0:
> Offset 80h[0]=1 in platform code even Silicon code skipped this.\n <b>0=All
> PAM registers will be locked in Silicon code</b>, 1=Skip lock PAM registers in
> Silicon code.
> 
> +  UINT8  EdramTestMode;                      ///< Offset 28 :EDRAM Test Mode. For
> EDRAM stepping - 0- EDRAM SW Disable, 1- EDRAM SW Enable, <b> 2-
> EDRAM HW Mode</b>
> 
> +} HOST_BRIDGE_PEI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/Hybr
> idGraphicsConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/Hybr
> idGraphicsConfig.h
> new file mode 100644
> index 0000000000..3f420aed48
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridGraphics/Hybr
> idGraphicsConfig.h
> @@ -0,0 +1,66 @@
> +/** @file
> 
> +  Hybrid Graphics policy definitions
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HYBRID_GRAPHICS_CONFIG_H_
> 
> +#define _HYBRID_GRAPHICS_CONFIG_H_
> 
> +
> 
> +#define HYBRID_GRAPHICS_CONFIG_REVISION 2
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +///
> 
> +/// GPIO Support
> 
> +///
> 
> +typedef enum {
> 
> +  NotSupported = 0,
> 
> +  PchGpio,
> 
> +  I2CGpio,
> 
> +} GPIO_SUPPORT;
> 
> +
> 
> +///
> 
> +/// CPU PCIe GPIO Data Structure
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8   ExpanderNo; ///< Offset 0 Expander No For I2C based GPIO
> 
> +  BOOLEAN Active;     ///< Offset 1 0=Active Low; 1=Active High
> 
> +  UINT8   Rsvd0[2];   ///< Offset 2 Reserved
> 
> +  UINT32  GpioNo;     ///< Offset 4 GPIO pad
> 
> +} CPU_PCIE_GPIO_INFO;
> 
> +
> 
> +/**
> 
> + CPU PCIE RTD3 GPIO Data Structure
> 
> +**/
> 
> +typedef struct {
> 
> +  CPU_PCIE_GPIO_INFO  HoldRst;      ///< Offset 0 This field contain PCIe HLD
> RESET GPIO value and level information
> 
> +  CPU_PCIE_GPIO_INFO  PwrEnable;    ///< Offset 8 This field contain PCIe
> PWR Enable GPIO value and level information
> 
> +  UINT32              WakeGpioNo;   ///< Offset 16 This field contain PCIe RTD3
> Device Wake GPIO Number
> 
> +  UINT8               GpioSupport;  ///< Offset 20 Depends on board design the
> GPIO configuration may be different: <b>0=Not Supported</b>, 1=PCH
> Based, 2=I2C based
> 
> +  UINT8               Rsvd0[3];     ///< Offset 21
> 
> +} CPU_PCIE_RTD3_GPIO;
> 
> +
> 
> +/**
> 
> +  This Configuration block configures CPU PCI Express 0/1/2 RTD3 GPIOs &
> Root Port.
> 
> +  Hybrid Gfx uses the same GPIOs & Root port as PCI Express 0/1/2 RTD3.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Add HgSlot Policy: PEG or PCH Slot Slection for Hybrid Graphics
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER Header;                ///< Offset 0-27 Config Block
> Header
> 
> +  CPU_PCIE_RTD3_GPIO  CpuPcie0Rtd3Gpio;      ///< Offset 28 RTD3 GPIOs
> used for PCIe
> 
> +  UINT8               RootPortIndex;         ///< Offset 52 Root Port Index number
> used for HG
> 
> +  UINT8               HgMode;                ///< Offset 53 HgMode:
> <b>0=Disabled</b>, 1=HG Muxed, 2=HG Muxless, 3=PEG
> 
> +  UINT16              HgSubSystemId;         ///< Offset 54 Hybrid Graphics
> Subsystem ID: <b>2212</b>
> 
> +  UINT16              HgDelayAfterPwrEn;     ///< Offset 56 Dgpu Delay after
> Power enable using Setup option: 0=Minimal, 1000=Maximum, <b>300=300
> microseconds</b>
> 
> +  UINT16              HgDelayAfterHoldReset; ///< Offset 58 Dgpu Delay after
> Hold Reset using Setup option: 0=Minimal, 1000=Maximum, <b>100=100
> microseconds</b>
> 
> +  CPU_PCIE_RTD3_GPIO  CpuPcie1Rtd3Gpio;      ///< Offset 60 RTD3 GPIOs
> used for PCIe
> 
> +  CPU_PCIE_RTD3_GPIO  CpuPcie2Rtd3Gpio;      ///< Offset 84 RTD3 GPIOs
> used for PCIe
> 
> +  CPU_PCIE_RTD3_GPIO  CpuPcie3Rtd3Gpio;      ///< Offset 108 RTD3 GPIOs
> used for PCIe
> 
> +  UINT8               HgSlot;                ///< Offset 132 Slot selection between PEG
> and PCH
> 
> +  UINT8               Rsvd0[3];              ///< Offset 133 Reserved Bytes
> 
> +} HYBRID_GRAPHICS_CONFIG;
> 
> +#pragma pack(pop)
> 
> +#endif // _HYBRID_GRAPHICS_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/Hybri
> dStorageConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/Hybri
> dStorageConfig.h
> new file mode 100644
> index 0000000000..705fe43751
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/HybridStorage/Hybri
> dStorageConfig.h
> @@ -0,0 +1,36 @@
> +/** @file
> 
> +  Hybrid Storage policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HYBRID_STORAGE_CONFIG_H_
> 
> +#define _HYBRID_STORAGE_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define HYBRID_STORAGE_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gHybridStorageConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The HYBRID_STORAGE_CONFIG block describes the expected
> configuration for Hybrid Storage device
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Init version
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    Hybrid Storage Mode
> 
> +    <b>0: Disable</b>, 1: Enable Dynamic Configuration
> 
> +  **/
> 
> +  UINT8    HybridStorageMode;
> 
> +  UINT8    RsvdBytes[3];
> 
> +} HYBRID_STORAGE_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _HYBRID_STORAGE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
> new file mode 100644
> index 0000000000..a9275152f5
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ieh/IehConfig.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  Integrated Error Handler policy.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _IEH_CONFIG_H_
> 
> +#define _IEH_CONFIG_H_
> 
> +
> 
> +#define IEH_MODE_BYPASS 0
> 
> +#define IEH_MODE_ENABLE 1
> 
> +
> 
> +#define IEH_CONFIG_REVISION 1
> 
> +extern EFI_GUID gIehConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The IEH_CONFIG block describes the expected configuration of the PCH
> 
> +  Integrated Error Handler.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
> 
> +  /**
> 
> +    IEH mode <b>0: Bypass Mode</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32    Mode            :  1;
> 
> +  UINT32    RsvdBits0       : 31;       ///< Reserved bits
> 
> +} IEH_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _IEH_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
> new file mode 100644
> index 0000000000..75a11e3052
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Ish/IshConfig.h
> @@ -0,0 +1,134 @@
> +/** @file
> 
> +  ISH policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _ISH_CONFIG_H_
> 
> +#define _ISH_CONFIG_H_
> 
> +
> 
> +#define ISH_PREMEM_CONFIG_REVISION 1
> 
> +#define ISH_CONFIG_REVISION 1
> 
> +extern EFI_GUID gIshPreMemConfigGuid;
> 
> +extern EFI_GUID gIshConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  ISH GPIO settings
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    GPIO signals pin muxing settings. If signal can be enable only on a single
> pin
> 
> +    then this parameter should be set to 0. Refer to
> GPIO_*_MUXING_ISH_*x_* in GpioPins*.h
> 
> +    for supported settings on a given platform
> 
> +  **/
> 
> +  UINT32   PinMux;                      ///< GPIO Pin mux configuration. Refer to
> GPIO_*_MUXING_ISH_*x_MOSI_*
> 
> +  /**
> 
> +    GPIO Pads Internal Termination.
> 
> +    For more information please see Platform Design Guide.
> 
> +    Check GPIO_ELECTRICAL_CONFIG for reference
> 
> +  **/
> 
> +  UINT32   PadTermination;
> 
> +} ISH_GPIO_CONFIG;
> 
> +
> 
> +/**
> 
> +  SPI signals settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  ISH_GPIO_CONFIG   Mosi;                        ///< MOSI Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Miso;                        ///< MISO Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Clk;                         ///< CLK  Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Cs[PCH_MAX_ISH_SPI_CS_PINS]; ///< CS   Pin
> configuration.
> 
> +} ISH_SPI_PIN_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  UART signals settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  ISH_GPIO_CONFIG   Rx;    ///< RXD Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Tx;    ///< TXD Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Rts;   ///< RTS Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Cts;   ///< CTS Pin configuration.
> 
> +} ISH_UART_PIN_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  I2C signals settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  ISH_GPIO_CONFIG   Sda;    ///< SDA Pin configuration.
> 
> +  ISH_GPIO_CONFIG   Scl;    ///< SCL Pin configuration.
> 
> +} ISH_I2C_PIN_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  Struct contains GPIO pins assigned and signal settings of SPI
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8               Enable;                            ///< ISH SPI GPIO pins assigned: <b>0:
> False</b> 1: True
> 
> +  UINT8               CsEnable[PCH_MAX_ISH_SPI_CS_PINS]; ///< ISH SPI CS pins
> assigned: <b>0: False</b> 1: True
> 
> +  UINT16              RsvdField0;                        ///< Reserved field
> 
> +  ISH_SPI_PIN_CONFIG  PinConfig;
> 
> +} ISH_SPI;
> 
> +
> 
> +
> 
> +/**
> 
> +  Struct contains GPIO pins assigned and signal settings of UART
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32              Enable      :  1;   ///< ISH UART GPIO pins assigned: <b>0:
> False</b> 1: True
> 
> +  UINT32              RsvdBits0   : 31;   ///< Reserved Bits
> 
> +  ISH_UART_PIN_CONFIG PinConfig;
> 
> +} ISH_UART;
> 
> +
> 
> +/**
> 
> +  Struct contains GPIO pins assigned and signal settings of I2C
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32              Enable      :  1;   ///< ISH I2C GPIO pins assigned: <b>0:
> False</b> 1: True
> 
> +  UINT32              RsvdBits0   : 31;   ///< Reserved Bits
> 
> +  ISH_I2C_PIN_CONFIG  PinConfig;
> 
> +} ISH_I2C;
> 
> +
> 
> +/**
> 
> +  Struct contains GPIO pins assigned and signal settings of GP
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32           Enable      :  1;   ///< ISH GP GPIO pins assigned: <b>0:
> False</b> 1: True
> 
> +  UINT32           RsvdBits0   : 31;   ///< Reserved Bits
> 
> +  ISH_GPIO_CONFIG  PinConfig;
> 
> +} ISH_GP;
> 
> +
> 
> +///
> 
> +/// The ISH_CONFIG block describes Integrated Sensor Hub device.
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;               ///< Config Block Header
> 
> +  ISH_SPI  Spi[PCH_MAX_ISH_SPI_CONTROLLERS];
> 
> +  ISH_UART Uart[PCH_MAX_ISH_UART_CONTROLLERS];
> 
> +  ISH_I2C  I2c[PCH_MAX_ISH_I2C_CONTROLLERS];
> 
> +  ISH_GP   Gp[PCH_MAX_ISH_GP_PINS];
> 
> +
> 
> +  UINT32   PdtUnlock            :  1;         ///< ISH PDT Unlock Msg: <b>0:
> False</b> 1: True
> 
> +  UINT32   RsvdBits0            : 31;         ///< Reserved Bits
> 
> +
> 
> +} ISH_CONFIG;
> 
> +
> 
> +///
> 
> +/// Premem Policy for Integrated Sensor Hub device.
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;     ///< Config Block Header
> 
> +  /**
> 
> +    ISH Controler 0: Disable; <b>1: Enable</b>.
> 
> +    For Desktop sku, the ISH POR should be disabled. <b> 0:Disable </b>.
> 
> +  **/
> 
> +  UINT32    Enable          :  1;
> 
> +  UINT32    RsvdBits0       : 31;   ///< Reserved Bits
> 
> +} ISH_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _ISH_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.
> h
> new file mode 100644
> index 0000000000..7f6fa8675b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/InterruptConfig.
> h
> @@ -0,0 +1,58 @@
> +/** @file
> 
> +  Interrupt policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _INTERRUPT_CONFIG_H_
> 
> +#define _INTERRUPT_CONFIG_H_
> 
> +
> 
> +#define INTERRUPT_CONFIG_REVISION 1
> 
> +extern EFI_GUID gInterruptConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +//
> 
> +// --------------------- Interrupts Config ------------------------------
> 
> +//
> 
> +typedef enum {
> 
> +  PchNoInt,        ///< No Interrupt Pin
> 
> +  PchIntA,
> 
> +  PchIntB,
> 
> +  PchIntC,
> 
> +  PchIntD
> 
> +} PCH_INT_PIN;
> 
> +
> 
> +///
> 
> +/// The PCH_DEVICE_INTERRUPT_CONFIG block describes interrupt pin,
> IRQ and interrupt mode for PCH device.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8        Device;                  ///< Device number
> 
> +  UINT8        Function;                ///< Device function
> 
> +  UINT8        IntX;                    ///< Interrupt pin: INTA-INTD (see PCH_INT_PIN)
> 
> +  UINT8        Irq;                     ///< IRQ to be set for device.
> 
> +} PCH_DEVICE_INTERRUPT_CONFIG;
> 
> +
> 
> +#define PCH_MAX_DEVICE_INTERRUPT_CONFIG 128       ///< Number of all
> PCH devices
> 
> +#define PCH_MAX_PXRC_CONFIG               8       ///< Number of PXRC
> registers in ITSS
> 
> +#define PCH_MAX_ITSS_IPC_REGS             4       ///< Number of IPC registers
> in ITSS
> 
> +#define PCH_MAX_ITSS_IRQ_NUM            120       ///< Maximum number of
> IRQs
> 
> +
> 
> +
> 
> +///
> 
> +/// The PCH_INTERRUPT_CONFIG block describes interrupt settings for
> PCH.
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER          Header;                                          ///< Config
> Block Header
> 
> +  UINT8                        NumOfDevIntConfig;                               ///< Number of
> entries in DevIntConfig table
> 
> +  UINT8                        Rsvd0[3];                                        ///< Reserved bytes, align
> to multiple 4.
> 
> +  PCH_DEVICE_INTERRUPT_CONFIG
> DevIntConfig[PCH_MAX_DEVICE_INTERRUPT_CONFIG];   ///< Array which
> stores PCH devices interrupts settings
> 
> +  UINT8                        GpioIrqRoute;                                    ///< Interrupt routing
> for GPIO. Default is <b>14</b>.
> 
> +  UINT8                        SciIrqSelect;                                    ///< Interrupt select for
> SCI. Default is <b>9</b>.
> 
> +  UINT8                        TcoIrqSelect;                                    ///< Interrupt select for
> TCO. Default is <b>9</b>.
> 
> +  UINT8                        TcoIrqEnable;                                    ///< Enable IRQ
> generation for TCO. <b>0: Disable</b>; 1: Enable.
> 
> +} PCH_INTERRUPT_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _INTERRUPT_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
> new file mode 100644
> index 0000000000..726a27f7a1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Itss/IoApicConfig.h
> @@ -0,0 +1,60 @@
> +/** @file
> 
> +  IoApic policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _IOAPIC_CONFIG_H_
> 
> +#define _IOAPIC_CONFIG_H_
> 
> +
> 
> +#define IOAPIC_CONFIG_REVISION 1
> 
> +extern EFI_GUID gIoApicConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PCH_IOAPIC_CONFIG block describes the expected configuration of
> the PCH
> 
> +  IO APIC, it's optional and PCH code would ignore it if the BdfValid bit is
> 
> +  not TRUE. Bus:device:function fields will be programmed to the register
> 
> +  P2SB IBDF(P2SB PCI offset R6Ch-6Dh), it's using for the following purpose:
> 
> +  As the Requester ID when initiating Interrupt Messages to the processor.
> 
> +  As the Completer ID when responding to the reads targeting the IOxAPI's
> 
> +  Memory-Mapped I/O registers.
> 
> +  This field defaults to Bus 0: Device 31: Function 0 after reset. BIOS can
> 
> +  program this field to provide a unique Bus:Device:Function number for the
> 
> +  internal IOxAPIC.
> 
> +  The address resource range of IOAPIC must be reserved in E820 and ACPI
> as
> 
> +  system resource.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  UINT32  IoApicEntry24_119     :  1;   ///< 0: Disable; <b>1: Enable</b>
> IOAPIC Entry 24-119
> 
> +  /**
> 
> +    Enable 8254 Static Clock Gating during early POST time. 0: Disable, <b>1:
> Enable</b>
> 
> +    Setting 8254CGE is required to support SLP_S0.
> 
> +    Enable this if 8254 timer is not used.
> 
> +    However, set 8254CGE=1 in POST time might fail to boot legacy OS using
> 8254 timer.
> 
> +    Make sure it is disabled to support legacy OS using 8254 timer.
> 
> +    @note:
> 
> +    For some OS environment that it needs to set 8254CGE in late state it
> should
> 
> +    set this policy to FALSE and use ItssSet8254ClockGateState  (TRUE) in
> SMM later.
> 
> +    This is also required during S3 resume.
> 
> +    To avoid SMI requirement in S3 reusme path, it can enable the
> Enable8254ClockGatingOnS3
> 
> +    and RC will do 8254 CGE programming in PEI during S3 resume with
> BOOT_SAI.
> 
> +  **/
> 
> +  UINT32  Enable8254ClockGating :  1;
> 
> +  /**
> 
> +    Enable 8254 Static Clock Gating on S3 resume path. 0: Disable, <b>1:
> Enable</b>
> 
> +    This is only applicable when Enable8254ClockGating is disabled.
> 
> +    If Enable8254ClockGating is enabled, RC will do the 8254 CGE
> programming on
> 
> +    S3 resume path as well.
> 
> +  **/
> 
> +  UINT32  Enable8254ClockGatingOnS3 :  1;
> 
> +  UINT32  RsvdBits1             : 29;   ///< Reserved bits
> 
> +  UINT8   IoApicId;                     ///< This member determines IOAPIC ID.
> Default is <b>0x02</b>.
> 
> +  UINT8   Rsvd0[3];                     ///< Reserved bytes
> 
> +} PCH_IOAPIC_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _IOAPIC_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
> new file mode 100644
> index 0000000000..82786501f0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Me/MePeiConfig.h
> @@ -0,0 +1,117 @@
> +/** @file
> 
> +  ME config block for PEI phase
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _ME_PEI_CONFIG_H_
> 
> +#define _ME_PEI_CONFIG_H_
> 
> +
> 
> +#define ME_PEI_PREMEM_CONFIG_REVISION 2
> 
> +extern EFI_GUID gMePeiPreMemConfigGuid;
> 
> +
> 
> +#ifndef PLATFORM_POR
> 
> +#define PLATFORM_POR  0
> 
> +#endif
> 
> +#ifndef FORCE_ENABLE
> 
> +#define FORCE_ENABLE  1
> 
> +#endif
> 
> +#ifndef FORCE_DISABLE
> 
> +#define FORCE_DISABLE 2
> 
> +#endif
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  ME Pei Pre-Memory Configuration Structure.
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Initial version.
> 
> +  <b>Revision 2:</b>
> 
> +  - Add SkipCpuReplacementCheck Option.
> 
> +  <b>Revision 3:</b>
> 
> +  - Deprecate SendDidMsg.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                 ///< Config Block Header
> 
> +  UINT32 HeciTimeouts                     : 1;  ///< 0: Disable; <b>1: Enable</b> -
> HECI Send/Receive Timeouts.
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    <b>0: Disabled</b>
> 
> +       1: ME DID init stat 0 - Success
> 
> +       2: ME DID init stat 1 - No Memory in Channels
> 
> +       3: ME DID init stat 2 - Memory Init Error
> 
> +  **/
> 
> +  UINT32 DidInitStat                      : 2;
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    <b>0: Set to 0 to enable polling for CPU replacement</b>
> 
> +       1: Set to 1 will disable polling for CPU replacement
> 
> +  **/
> 
> +  UINT32 DisableCpuReplacedPolling        : 1;
> 
> +  UINT32 SendDidMsg                       : 1;  ///< <b>(Deprecated)</b> 0: Disable;
> <b>1: Enable</b> - Enable/Disable to send DID message.
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    <b>0: ME BIOS will check each messages before sending</b>
> 
> +       1: ME BIOS always sends messages without checking
> 
> +  **/
> 
> +  UINT32 DisableMessageCheck              : 1;
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    The SkipMbpHob policy determines whether ME BIOS Payload data will
> be requested during boot
> 
> +    in a MBP message. If set to 1, BIOS will send the MBP message with
> SkipMbp flag
> 
> +    set causing CSME to respond with MKHI header only and no MBP data
> 
> +    <b>0: ME BIOS will keep MBP and create HOB for MBP data</b>
> 
> +       1: ME BIOS will skip MBP data
> 
> +  **/
> 
> +  UINT32 SkipMbpHob                       : 1;
> 
> +  UINT32 HeciCommunication2               : 1;  ///< <b>(Test)</b> <b>0:
> Disable</b>; 1: Enable - Enable/Disable HECI2.
> 
> +  UINT32 KtDeviceEnable                   : 1;  ///< <b>(Test)</b> 0: Disable; <b>1:
> Enable</b> - Enable/Disable Kt Device.
> 
> +  UINT32 SkipCpuReplacementCheck          : 1;  ///< <b>(Test)</b> <b>0:
> Disable</b>; 1: Enable - Enable/Disable to skip CPU replacement check.
> 
> +  UINT32 RsvdBits                         : 22; ///< Reserved for future use & Config
> block alignment
> 
> +  UINT32 Heci1BarAddress;                       ///< HECI1 BAR address.
> 
> +  UINT32 Heci2BarAddress;                       ///< HECI2 BAR address.
> 
> +  UINT32 Heci3BarAddress;                       ///< HECI3 BAR address.
> 
> +} ME_PEI_PREMEM_CONFIG;
> 
> +#pragma pack (pop)
> 
> +
> 
> +
> 
> +#define ME_PEI_CONFIG_REVISION 3
> 
> +extern EFI_GUID gMePeiConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  ME Pei Post-Memory Configuration Structure.
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Deprecated Heci3Enabled.
> 
> +  <b>Revision 3</b>
> 
> +  - Added EnforceEDebugMode.
> 
> +**/
> 
> +
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                 ///< Config Block Header
> 
> +
> 
> +  UINT32 EndOfPostMessage                 : 2;  ///< 0: Disabled; 1: Send in PEI;
> <b>2: Send in DXE</b> - Send EOP at specific phase.
> 
> +  UINT32 Heci3Enabled                     : 1;  ///< @deprecated
> 
> +  UINT32 DisableD0I3SettingForHeci        : 1;  ///< <b>(Test)</b> <b>0:
> Disable</b>; 1: Enable - Enable/Disable D0i3 for HECI.
> 
> +  /**
> 
> +    Enable/Disable Me Unconfig On Rtc Clear. If enabled, BIOS will send
> MeUnconfigOnRtcClearDisable Msg with parameter 0.
> 
> +    It will cause ME to unconfig if RTC is cleared.
> 
> +    -    0: Disable
> 
> +    - <b>1: Enable</b>
> 
> +    -    2: Cmos is clear, status unkonwn
> 
> +    -    3: Reserved
> 
> +  **/
> 
> +  UINT32 MeUnconfigOnRtcClear             : 2;
> 
> +  UINT32 MctpBroadcastCycle               : 1;   ///< <b>(Test)</b> <b>0:
> Disable</b>; 1: Enable - Program registers for MCTP Cycle.
> 
> +  UINT32 EnforceEDebugMode                : 1;   ///< <b>0: Disable</b>; 1:
> Enable - Enforces ME to enter Enhanced Debug Mode
> 
> +  UINT32 RsvdBits                         : 24;  ///< Reserved for future use & Config
> block alignment
> 
> +} ME_PEI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _ME_PEI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/Mem
> oryConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/Mem
> oryConfig.h
> new file mode 100644
> index 0000000000..17c0a10eee
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Memory/Ver2/Mem
> oryConfig.h
> @@ -0,0 +1,478 @@
> +/** @file
> 
> +  Policy definition of Memory Config Block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _MEMORY_CONFIG_H_
> 
> +#define _MEMORY_CONFIG_H_
> 
> +
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +// MEMORY_CONFIG_REVISION 3 adds DDR5 PDA Enumeration training
> within MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 4 adds LPDDR4 Command Mirroring within
> MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 5 adds CpuBclkSpread option within
> MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 6 adds McParity option within
> MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 7 adds VddqVoltageOverride option within
> MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 8 adds ExtendedBankHashing option
> within MEMORY_CONFIGURATION
> 
> +// MEMORY_CONFIG_REVISION 9 adds IbeccErrorInj option within
> MEMORY_CONFIGURATION
> 
> +#define MEMORY_CONFIG_REVISION 9
> 
> +///
> 
> +/// MEMORY_CONFIG interface definitions
> 
> +///
> 
> +#define MRC_MAX_RCOMP_TARGETS  5
> 
> +///
> 
> +/// Memory SubSystem Definitions
> 
> +///
> 
> +#define MEM_CFG_MAX_CONTROLLERS          2
> 
> +#define MEM_CFG_MAX_CHANNELS             4
> 
> +#define MEM_CFG_MAX_CHANNEL_SHARE_REGS   2
> 
> +#define MEM_CFG_MAX_DIMMS                2
> 
> +#define MEM_CFG_MAX_RANKS_PER_DIMM       2
> 
> +#define MEM_CFG_NUM_BYTES_MAPPED         2
> 
> +#define MEM_CFG_MAX_SPD_SIZE             1024
> 
> +#define MEM_CFG_MAX_SOCKETS
> (MEM_CFG_MAX_CONTROLLERS * MEM_CFG_MAX_CHANNELS *
> MEM_CFG_MAX_DIMMS)
> 
> +#define MEM_CFG_MAX_ROWS
> (MEM_CFG_MAX_RANKS_PER_DIMM * MEM_CFG_MAX_SOCKETS)
> 
> +#ifndef MEM_MAX_SAGV_POINTS
> 
> +#define MEM_MAX_SAGV_POINTS                  4
> 
> +#endif
> 
> +#define MEM_MAX_IBECC_REGIONS                8
> 
> +///
> 
> +/// SMRAM Memory Range
> 
> +///
> 
> +#define PEI_MR_SMRAM_ABSEG_MASK     0x01
> 
> +#define PEI_MR_SMRAM_HSEG_MASK      0x02
> 
> +
> 
> +///
> 
> +/// SA SPD profile selections.
> 
> +///
> 
> +typedef enum {
> 
> +  Default,             ///< 0, Default SPD
> 
> +  UserDefined,         ///< 1, User Defined profile
> 
> +  XMPProfile1,         ///< 2, XMP Profile 1
> 
> +  XMPProfile2,         ///< 3, XMP Profile 2
> 
> +  XMPProfileMax = 0xFF ///< Ensures SA_SPD is UINT8
> 
> +} SA_SPD;
> 
> +
> 
> +///
> 
> +/// Define the boot modes used by the SPD read function.
> 
> +///
> 
> +typedef enum {
> 
> +  SpdCold,       ///< Cold boot
> 
> +  SpdWarm,       ///< Warm boot
> 
> +  SpdS3,         ///< S3 resume
> 
> +  SpdFast,       ///< Fast boot
> 
> +  SpdBootModeMax ///< Delimiter
> 
> +} SPD_BOOT_MODE;
> 
> +
> 
> +/**
> 
> +  SPD Data Buffer
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8
> SpdData[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHANNELS][M
> EM_CFG_MAX_DIMMS][MEM_CFG_MAX_SPD_SIZE];  ///< SpdData
> 
> +//Next Field Offset 2048
> 
> +} SPD_DATA_BUFFER;
> 
> +
> 
> +/**
> 
> +  DqDqs Mapping
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8
> DqsMapCpu2Dram[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHA
> NNELS][MEM_CFG_NUM_BYTES_MAPPED];  ///< DqsMapCpu2Dram
> 
> +  UINT8
> DqMapCpu2Dram[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_CHA
> NNELS][MEM_CFG_NUM_BYTES_MAPPED][8];  ///< DqMapCpu2Dram
> 
> +//Next Field Offset 16
> 
> +} SA_MEMORY_DQDQS_MAPPING;
> 
> +
> 
> +/**
> 
> +  Rcomp Policies
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16  RcompResistor;                      ///< Offset 0: Reference RCOMP
> resistors on motherboard ~ 100 ohms
> 
> +  UINT16  RcompTarget[MRC_MAX_RCOMP_TARGETS]; ///< Offset 1:
> RCOMP target values for DqOdt, DqDrv, CmdDrv, CtlDrv, ClkDrv
> 
> +//Next Field Offset 16
> 
> +} SA_MEMORY_RCOMP;
> 
> +
> 
> +/**
> 
> +  SPD Offset Table
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16 Start;           ///< Offset 0
> 
> +  UINT16 End;             ///< Offset 2
> 
> +  UINT8  BootMode;        ///< Offset 4
> 
> +  UINT8  Reserved3[3];    ///< Offset 5 Reserved for future use
> 
> +} SPD_OFFSET_TABLE;
> 
> +
> 
> +///
> 
> +/// SA memory address decode.
> 
> +///
> 
> +typedef struct
> 
> +{
> 
> +  UINT8  Controller; ///< Offset 0 Zero based Controller number
> 
> +  UINT8  Channel;    ///< Offset 1 Zero based Channel number
> 
> +  UINT8  Dimm;       ///< Offset 2 Zero based DIMM number
> 
> +  UINT8  Rank;       ///< Offset 3 Zero based Rank number
> 
> +  UINT8  BankGroup;  ///< Offset 4 Zero based Bank Group number
> 
> +  UINT8  Bank;       ///< Offset 5 Zero based Bank number
> 
> +  UINT16 Cas;        ///< Offset 6 Zero based CAS number
> 
> +  UINT32 Ras;        ///< Offset 8 Zero based RAS number
> 
> +} SA_ADDRESS_DECODE;
> 
> +
> 
> +typedef UINT8      (EFIAPI * SA_IO_READ_8)               (UINTN IoAddress);
> ///< CPU I/O port 8-bit read.
> 
> +typedef UINT16     (EFIAPI * SA_IO_READ_16)              (UINTN IoAddress);
> ///< CPU I/O port 16-bit read.
> 
> +typedef UINT32     (EFIAPI * SA_IO_READ_32)              (UINTN IoAddress);
> ///< CPU I/O port 32-bit read.
> 
> +typedef UINT8      (EFIAPI * SA_IO_WRITE_8)              (UINTN IoAddress,
> UINT8 Value);
> ///< CPU I/O port 8-bit write.
> 
> +typedef UINT16     (EFIAPI * SA_IO_WRITE_16)             (UINTN IoAddress,
> UINT16 Value);
> ///< CPU I/O port 16-bit write.
> 
> +typedef UINT32     (EFIAPI * SA_IO_WRITE_32)             (UINTN IoAddress,
> UINT32 Value);
> ///< CPU I/O port 32-bit write.
> 
> +typedef UINT8      (EFIAPI * SA_MMIO_READ_8)             (UINTN Address);
> ///< Memory Mapped I/O port 8-bit read.
> 
> +typedef UINT16     (EFIAPI * SA_MMIO_READ_16)            (UINTN Address);
> ///< Memory Mapped I/O port 16-bit read.
> 
> +typedef UINT32     (EFIAPI * SA_MMIO_READ_32)            (UINTN Address);
> ///< Memory Mapped I/O port 32-bit read.
> 
> +typedef UINT64     (EFIAPI * SA_MMIO_READ_64)            (UINTN Address);
> ///< Memory Mapped I/O port 64-bit read.
> 
> +typedef UINT8      (EFIAPI * SA_MMIO_WRITE_8)            (UINTN Address,
> UINT8 Value);
> ///< Memory Mapped I/O port 8-bit write.
> 
> +typedef UINT16     (EFIAPI * SA_MMIO_WRITE_16)           (UINTN Address,
> UINT16 Value);
> ///< Memory Mapped I/O port 16-bit write.
> 
> +typedef UINT32     (EFIAPI * SA_MMIO_WRITE_32)           (UINTN Address,
> UINT32 Value);
> ///< Memory Mapped I/O port 32-bit write.
> 
> +typedef UINT64     (EFIAPI * SA_MMIO_WRITE_64)           (UINTN Address,
> UINT64 Value);
> ///< Memory Mapped I/O port 64-bit write.
> 
> +typedef UINT8      (EFIAPI * SA_SMBUS_READ_8)            (UINTN Address,
> RETURN_STATUS *Status);
> ///< Smbus 8-bit read.
> 
> +typedef UINT16     (EFIAPI * SA_SMBUS_READ_16)           (UINTN Address,
> RETURN_STATUS *Status);
> ///< Smbus 16-bit read.
> 
> +typedef UINT8      (EFIAPI * SA_SMBUS_WRITE_8)           (UINTN Address,
> UINT8 Value, RETURN_STATUS *Status);
> ///< Smbus 8-bit write.
> 
> +typedef UINT16     (EFIAPI * SA_SMBUS_WRITE_16)          (UINTN Address,
> UINT16 Value, RETURN_STATUS *Status);
> ///< Smbus 16-bit write.
> 
> +typedef UINT32     (EFIAPI * SA_GET_PCI_DEVICE_ADDRESS)  (UINT8 Bus,
> UINT8 Device, UINT8 Function, UINT8 Offset);
> ///< Get PCI device address.
> 
> +typedef UINT32     (EFIAPI * SA_GET_PCIE_DEVICE_ADDRESS) (UINT8 Bus,
> UINT8 Device, UINT8 Function, UINT8 Offset);
> ///< Get PCI express device address.
> 
> +typedef VOID       (EFIAPI * SA_GET_RTC_TIME)            (UINT8 *Second,
> UINT8 *Minute, UINT8 *Hour, UINT8 *Day, UINT8 *Month, UINT16 *Year);
> ///< Get the current time value.
> 
> +typedef UINT64     (EFIAPI * SA_GET_CPU_TIME)            (VOID);
> ///< The current CPU time in milliseconds.
> 
> +typedef VOID *     (EFIAPI * SA_MEMORY_COPY)             (VOID *Destination,
> CONST VOID *Source, UINTN NumBytes);
> ///< Perform byte copy operation.
> 
> +typedef VOID *     (EFIAPI * SA_MEMORY_SET_BYTE)         (VOID *Buffer,
> UINTN NumBytes, UINT8 Value);
> ///< Perform byte initialization operation.
> 
> +typedef VOID *     (EFIAPI * SA_MEMORY_SET_WORD)         (VOID *Buffer,
> UINTN NumWords, UINT16 Value);
> ///< Perform word initialization operation.
> 
> +typedef VOID *     (EFIAPI * SA_MEMORY_SET_DWORD)        (VOID *Buffer,
> UINTN NumDwords, UINT32 Value);
> ///< Perform dword initialization operation.
> 
> +typedef UINT64     (EFIAPI * SA_LEFT_SHIFT_64)           (UINT64 Data, UINTN
> NumBits);
> ///< Left shift the 64-bit data value by specified number of bits.
> 
> +typedef UINT64     (EFIAPI * SA_RIGHT_SHIFT_64)          (UINT64 Data, UINTN
> NumBits);
> ///< Right shift the 64-bit data value by specified number of bits.
> 
> +typedef UINT64     (EFIAPI * SA_MULT_U64_U32)            (UINT64
> Multiplicand, UINT32 Multiplier);
> ///< Multiply a 64-bit data value by a 32-bit data value.
> 
> +typedef UINT64     (EFIAPI * SA_DIV_U64_U64)             (UINT64 Dividend,
> UINT64 Divisor, UINT64 *Remainder);
> ///< Divide a 64-bit data value by a 64-bit data value.
> 
> +typedef BOOLEAN    (EFIAPI * SA_GET_SPD_DATA)
> (SPD_BOOT_MODE BootMode, UINT8 SpdAddress, UINT8 *Buffer, UINT8
> *Ddr3Table, UINT32 Ddr3TableSize, UINT8 *Ddr4Table, UINT32
> Ddr4TableSize, UINT8 *LpddrTable, UINT32 LpddrTableSize);             ///< Read
> the SPD data over the SMBus, at the given SmBus SPD address and copy the
> data to the data structure.
> 
> +typedef UINT8      (EFIAPI * SA_GET_MC_ADDRESS_DECODE)   (UINT64
> Address, SA_ADDRESS_DECODE *DramAddress);
> 
> +typedef UINT8      (EFIAPI * SA_GET_MC_ADDRESS_ENCODE)
> (SA_ADDRESS_DECODE *DramAddress, UINT64 Address);
> 
> +typedef BOOLEAN    (EFIAPI * SA_GET_RANDOM_NUMBER)       (UINT32
> *Rand);
> ///< Get the next random 32-bit number.
> 
> +typedef EFI_STATUS (EFIAPI * SA_CPU_MAILBOX_READ)        (UINT32 Type,
> UINT32 Command, UINT32 *Value, UINT32 *Status);
> ///< Perform a CPU mailbox read.
> 
> +typedef EFI_STATUS (EFIAPI * SA_CPU_MAILBOX_WRITE)       (UINT32 Type,
> UINT32 Command, UINT32 Value, UINT32 *Status);
> ///< Perform a CPU mailbox write.
> 
> +typedef UINT32     (EFIAPI * SA_GET_MEMORY_VDD)          (VOID
> *GlobalData, UINT32 DefaultVdd);
> ///< Get the current memory voltage (VDD).
> 
> +typedef UINT32     (EFIAPI * SA_SET_MEMORY_VDD)          (VOID
> *GlobalData, UINT32 DefaultVdd, UINT32 Value);
> ///< Set the memory voltage (VDD) to the given value.
> 
> +typedef UINT32     (EFIAPI * SA_CHECKPOINT)              (VOID *GlobalData,
> UINT32 CheckPoint, VOID *Scratch);
> ///< Check point that is called at various points in the MRC.
> 
> +typedef VOID       (EFIAPI * SA_DEBUG_HOOK)              (VOID *GlobalData,
> UINT16 DisplayDebugNumber);
> ///< Typically used to display to the I/O port 80h.
> 
> +typedef UINT8      (EFIAPI * SA_CHANNEL_EXIST)           (VOID *Outputs,
> UINT8 Channel);
> ///< Returns whether Channel is or is not present.
> 
> +typedef INT32      (EFIAPI * SA_PRINTF)                  (VOID *Debug, UINT32
> Level, char *Format, ...);
> ///< Print to output stream/device.
> 
> +typedef VOID       (EFIAPI * SA_DEBUG_PRINT)             (VOID *String);
> ///< Output a string to the debug stream/device.
> 
> +typedef UINT32     (EFIAPI * SA_CHANGE_MARGIN)           (VOID
> *GlobalData, UINT8 Param, INT32 Value0, INT32 Value1, UINT8 EnMultiCast,
> UINT8 Channel, UINT8 RankIn, UINT8 Byte, UINT8 BitIn, UINT8
> UpdateMrcData, UINT8 SkipWait, UINT32 RegFileParam);  ///< Change the
> margin.
> 
> +typedef UINT8      (EFIAPI * SA_SIGN_EXTEND)             (UINT8 Value, UINT8
> OldMsb, UINT8 NewMsb);
> ///< Sign extends OldMSB to NewMSB Bits (Eg: Bit 6 to Bit 7).
> 
> +typedef VOID       (EFIAPI * SA_SHIFT_PI_COMMAND_TRAIN)  (VOID
> *GlobalData, UINT8 Channel, UINT8 Iteration, UINT8 RankMask, UINT8
> GroupMask, INT32 NewValue, UINT8 UpdateHost);
> ///< Move CMD/CTL/CLK/CKE PIs during training.
> 
> +typedef VOID       (EFIAPI * SA_UPDATE_VREF)             (VOID *GlobalData,
> UINT8 Channel, UINT8 RankMask, UINT16 DeviceMask, UINT8 VrefType,
> INT32 Offset, BOOLEAN UpdateMrcData, BOOLEAN PDAmode, BOOLEAN
> SkipWait);                                    ///< Update the Vref value and wait until it is
> stable.
> 
> +typedef UINT8      (EFIAPI * SA_GET_RTC_CMOS)            (UINT8 Location);
> ///< Get the current value of the specified RTC CMOS location.
> 
> +typedef UINT64     (EFIAPI * SA_MSR_READ_64)             (UINT32 Location);
> ///< Get the current value of the specified MSR location.
> 
> +typedef UINT64     (EFIAPI * SA_MSR_WRITE_64)            (UINT32 Location,
> UINT64 Data);
> ///< Set the current value of the specified MSR location.
> 
> +typedef VOID       (EFIAPI * SA_MRC_RETURN_FROM_SMC)     (VOID
> *GlobalData, UINT32 MrcStatus);
> ///< Hook function after returning from MrcStartMemoryConfiguration()
> 
> +typedef VOID       (EFIAPI * SA_MRC_DRAM_RESET)          (UINT32
> PciEBaseAddress, UINT32 ResetValue);
> ///< Assert or deassert DRAM_RESET# pin; this is used in JEDEC Reset.
> 
> +typedef VOID       (EFIAPI * SA_DELAY_NS)                (VOID *GlobalData,
> UINT32 DelayNs);
> ///< Delay (stall) for the given amount of nanoseconds.
> 
> +typedef VOID       (EFIAPI * SA_SET_LOCK_PRMRR)          (UINT64
> PrmrrBaseAddress, UINT32 PrmrrSize);
> 
> +
> 
> +
> 
> +///
> 
> +/// Function calls into the SA.
> 
> +///
> 
> +typedef struct {
> 
> +  SA_IO_READ_8               IoRead8;               ///< Offset 0:   - CPU I/O port 8-bit
> read.
> 
> +  SA_IO_READ_16              IoRead16;              ///< Offset 4:   - CPU I/O port 16-
> bit read.
> 
> +  SA_IO_READ_32              IoRead32;              ///< Offset 8:   - CPU I/O port 32-
> bit read.
> 
> +  SA_IO_WRITE_8              IoWrite8;              ///< Offset 12:  - CPU I/O port 8-bit
> write.
> 
> +  SA_IO_WRITE_16             IoWrite16;             ///< Offset 16:  - CPU I/O port 16-
> bit write.
> 
> +  SA_IO_WRITE_32             IoWrite32;             ///< Offset 20:  - CPU I/O port 32-
> bit write.
> 
> +  SA_MMIO_READ_8             MmioRead8;             ///< Offset 24:  - Memory
> Mapped I/O port 8-bit read.
> 
> +  SA_MMIO_READ_16            MmioRead16;            ///< Offset 28:  - Memory
> Mapped I/O port 16-bit read.
> 
> +  SA_MMIO_READ_32            MmioRead32;            ///< Offset 32:  - Memory
> Mapped I/O port 32-bit read.
> 
> +  SA_MMIO_READ_64            MmioRead64;            ///< Offset 36:  - Memory
> Mapped I/O port 64-bit read.
> 
> +  SA_MMIO_WRITE_8            MmioWrite8;            ///< Offset 40:  - Memory
> Mapped I/O port 8-bit write.
> 
> +  SA_MMIO_WRITE_16           MmioWrite16;           ///< Offset 44:  - Memory
> Mapped I/O port 16-bit write.
> 
> +  SA_MMIO_WRITE_32           MmioWrite32;           ///< Offset 48:  - Memory
> Mapped I/O port 32-bit write.
> 
> +  SA_MMIO_WRITE_64           MmioWrite64;           ///< Offset 52:  - Memory
> Mapped I/O port 64-bit write.
> 
> +  SA_SMBUS_READ_8            SmbusRead8;            ///< Offset 56:  - Smbus 8-bit
> read.
> 
> +  SA_SMBUS_READ_16           SmbusRead16;           ///< Offset 60:  - Smbus 16-
> bit read.
> 
> +  SA_SMBUS_WRITE_8           SmbusWrite8;           ///< Offset 64:  - Smbus 8-
> bit write.
> 
> +  SA_SMBUS_WRITE_16          SmbusWrite16;          ///< Offset 68:  - Smbus
> 16-bit write.
> 
> +  SA_GET_PCI_DEVICE_ADDRESS  GetPciDeviceAddress;   ///< Offset 72:  -
> Get PCI device address.
> 
> +  SA_GET_PCIE_DEVICE_ADDRESS GetPcieDeviceAddress;  ///< Offset 76:  -
> Get PCI express device address.
> 
> +  SA_GET_RTC_TIME            GetRtcTime;            ///< Offset 80:  - Get the
> current time value.
> 
> +  SA_GET_CPU_TIME            GetCpuTime;            ///< Offset 84:  - The current
> CPU time in milliseconds.
> 
> +  SA_MEMORY_COPY             CopyMem;               ///< Offset 88:  - Perform
> byte copy operation.
> 
> +  SA_MEMORY_SET_BYTE         SetMem;                ///< Offset 92:  - Perform
> byte initialization operation.
> 
> +  SA_MEMORY_SET_WORD         SetMemWord;            ///< Offset 96:  -
> Perform word initialization operation.
> 
> +  SA_MEMORY_SET_DWORD        SetMemDword;           ///< Offset 100: -
> Perform dword initialization operation.
> 
> +  SA_LEFT_SHIFT_64           LeftShift64;           ///< Offset 104: - Left shift the
> 64-bit data value by specified number of bits.
> 
> +  SA_RIGHT_SHIFT_64          RightShift64;          ///< Offset 108: - Right shift the
> 64-bit data value by specified number of bits.
> 
> +  SA_MULT_U64_U32            MultU64x32;            ///< Offset 112: - Multiply a
> 64-bit data value by a 32-bit data value.
> 
> +  SA_DIV_U64_U64             DivU64x64;             ///< Offset 116: - Divide a 64-bit
> data value by a 64-bit data value.
> 
> +  SA_GET_SPD_DATA            GetSpdData;            ///< Offset 120: - Read the
> SPD data over the SMBus, at the given SmBus SPD address and copy the data
> to the data structure.
> 
> +  SA_GET_RANDOM_NUMBER       GetRandomNumber;       ///< Offset 124: -
> Get the next random 32-bit number.
> 
> +  SA_CPU_MAILBOX_READ        CpuMailboxRead;        ///< Offset 128: -
> Perform a CPU mailbox read.
> 
> +  SA_CPU_MAILBOX_WRITE       CpuMailboxWrite;       ///< Offset 132: -
> Perform a CPU mailbox write.
> 
> +  SA_GET_MEMORY_VDD          GetMemoryVdd;          ///< Offset 136: - Get
> the current memory voltage (VDD).
> 
> +  SA_SET_MEMORY_VDD          SetMemoryVdd;          ///< Offset 140: - Set
> the memory voltage (VDD) to the given value.
> 
> +  SA_CHECKPOINT              CheckPoint;            ///< Offset 144: - Check point
> that is called at various points in the MRC.
> 
> +  SA_DEBUG_HOOK              DebugHook;             ///< Offset 148: - Typically
> used to display to the I/O port 80h.
> 
> +  SA_DEBUG_PRINT             DebugPrint;            ///< Offset 152: - Output a
> string to the debug stream/device.
> 
> +  SA_GET_RTC_CMOS            GetRtcCmos;            ///< Offset 156: - Get the
> current value of the specified RTC CMOS location.
> 
> +  SA_MSR_READ_64             ReadMsr64;             ///< Offset 160: - Get the
> current value of the specified MSR location.
> 
> +  SA_MSR_WRITE_64            WriteMsr64;            ///< Offset 164  - Set the
> current value of the specified MSR location.
> 
> +  SA_MRC_RETURN_FROM_SMC     MrcReturnFromSmc;      ///< Offset 168  -
> Hook function after returning from MrcStartMemoryConfiguration()
> 
> +  SA_MRC_DRAM_RESET          MrcDramReset;          ///< Offset 172  - Assert
> or deassert DRAM_RESET# pin; this is used in JEDEC Reset.
> 
> +  SA_DELAY_NS                MrcDelayNs;            ///< Offset 176  - Delay (stall) for
> the given amount of nanoseconds.
> 
> +} SA_FUNCTION_CALLS;
> 
> +
> 
> +///
> 
> +/// Function calls into the MRC.
> 
> +///
> 
> +typedef struct {
> 
> +  SA_CHANNEL_EXIST           MrcChannelExist;       ///< Offset 0:  - Returns
> whether Channel is or is not present.
> 
> +  SA_PRINTF                  MrcPrintf;             ///< Offset 4:  - Print to output
> stream/device.
> 
> +  SA_CHANGE_MARGIN           MrcChangeMargin;       ///< Offset 8:  - Change
> the margin.
> 
> +  SA_SIGN_EXTEND             MrcSignExtend;         ///< Offset 12: - Sign extends
> OldMSB to NewMSB Bits (Eg: Bit 6 to Bit 7).
> 
> +  SA_SHIFT_PI_COMMAND_TRAIN  ShiftPiCommandTrain;   ///< Offset 16: -
> Move CMD/CTL/CLK/CKE PIs during training.
> 
> +  SA_UPDATE_VREF             MrcUpdateVref;         ///< Offset 20: - Update the
> Vref value and wait until it is stable.
> 
> +} SA_MEMORY_FUNCTIONS;
> 
> +
> 
> +/**
> 
> + Memory Configuration
> 
> + The contents of this structure are CRC'd by the MRC for option change
> detection.
> 
> + This structure is copied en mass to the MrcInput structure. If you add fields
> here, you must update the MrcInput structure.
> 
> + <b>Revision 1</b>: - Initial version.
> 
> + <b>Revision 2</b>: - Adding ChHashOverride option.
> 
> + <b>Revision 3</b>: - Adding PDA enumeration option.
> 
> + <b>Revision 4</b>: - Adding LPDDR4 Command Mirroring.
> 
> + <b>Revision 5</b>: - Adding CpuBclkSpread option.
> 
> + <b>Revision 6</b>: - Adding McParity option.
> 
> + <b>Revision 7</b>: - Adding VddqVoltageOverride option.
> 
> + <b>Revision 8</b>: - Adding ExtendedBankHashing option.
> 
> + <b>Revision 9</b>: - Adding IbeccErrorInj option
> 
> + **/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;    ///< Offset 0-27 Config Block Header
> 
> +  UINT16  Size;                   ///< Offset 28 The size of this structure, in bytes.
> Must be the first entry in this structure.
> 
> +  UINT8   HobBufferSize;          ///< Offset 30 Size of HOB buffer for MRC
> 
> +
> 
> +  UINT8   SpdProfileSelected;     ///< Offset 31 SPD XMP profile selection - for
> XMP supported DIMM: <b>0=Default DIMM profile</b>, 1=Customized
> profile, 2=XMP profile 1, 3=XMP profile 2.
> 
> +
> 
> +  // The following parameters are used only when SpdProfileSelected is
> UserDefined (CUSTOM PROFILE)
> 
> +  UINT16  tCL;                    ///< Offset 32 User defined Memory Timing tCL
> value,   valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 31=Maximum.
> 
> +  UINT16  tRCDtRP;                ///< Offset 34 User defined Memory Timing tRCD
> value (same as tRP), valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 63=Maximum
> 
> +  UINT16  tRAS;                   ///< Offset 36 User defined Memory Timing tRAS
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 64=Maximum.
> 
> +  UINT16  tWR;                    ///< Offset 38 User defined Memory Timing tWR
> value,   valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, legal values: 5, 6, 7, 8, 10, 12, 14, 16, 18, 20, 24.
> 
> +  UINT16  tRFC;                   ///< Offset 40 User defined Memory Timing tRFC
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 1023=Maximum.
> 
> +  UINT16  tRRD;                   ///< Offset 42 User defined Memory Timing tRRD
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 15=Maximum.
> 
> +  UINT16  tWTR;                   ///< Offset 44 User defined Memory Timing tWTR
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 28=Maximum.
> 
> +  UINT16  tRTP;                   ///< Offset 46 User defined Memory Timing tRTP
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 15=Maximum. DDR4 legal values: 5, 6, 7, 8, 9, 10, 12
> 
> +  UINT16  tFAW;                   ///< Offset 48 User defined Memory Timing tFAW
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 63=Maximum.
> 
> +  UINT16  tCWL;                   ///< Offset 50 User defined Memory Timing tCWL
> value,  valid when SpdProfileSelected is CUSTOM_PROFILE:
> <b>0=AUTO</b>, 20=Maximum.
> 
> +  UINT16  tREFI;                  ///< Offset 52 User defined Memory Timing tREFI
> value, valid when SpdProfileSelected is CUSTOM_PROFILE: <b>0=AUTO</b>,
> 65535=Maximum.
> 
> +  UINT16  PciIndex;               ///< Offset 54 Pci index register address:
> <b>0xCF8=Default</b>
> 
> +  UINT16  PciData;                ///< Offset 56 Pci data register address:
> <b>0xCFC=Default</b>
> 
> +  UINT16  VddVoltage;             ///< Offset 58 DRAM voltage (Vdd) in millivolts:
> <b>0=Platform Default (no override)</b>, 1200=1.2V, 1350=1.35V etc.
> 
> +  UINT16  Idd3n;                  ///< Offset 60 EPG Active standby current (Idd3N)
> in milliamps from DIMM datasheet.
> 
> +  UINT16  Idd3p;                  ///< Offset 62 EPG Active power-down current
> (Idd3P) in milliamps from DIMM datasheet.
> 
> +
> 
> +  UINT32  EccSupport:1;              ///< Offset 64 Bit 0  - DIMM Ecc Support
> option - for Desktop only: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  MrcSafeConfig:1;           ///<           Bit 1  - MRC Safe Mode:
> <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  RemapEnable:1;             ///<           Bit 2  - This option is used to
> control whether to enable/disable memory remap above 4GB: 0=Disable,
> <b>1=Enable</b>.
> 
> +  UINT32  ScramblerSupport:1;        ///<           Bit 3  - Memory scrambler
> support: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  Vc1ReadMeter:1;            ///<           Bit 4  - VC1 Read Metering
> Enable: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  ForceSingleSubchannel:1;   ///<           Bit 5  - TRUE means use
> SubChannel0 only (for LPDDR4): <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  SimicsFlag:1;              ///<           Bit 6  - Option to Enable SIMICS:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  Ddr4DdpSharedClock:1;      ///<           Bit 7  - Select if CLK0 is shared
> between Rank0 and Rank1 in DDR4 DDP package. <b>0=Not shared</b>,
> 1=Shared
> 
> +  UINT32  SharedZqPin:1;             ///<           Bit 8  - Select if the ZQ resistor is
> shared between Ranks in DDR4/LPDDR4 DRAM Packages <b>0=Not
> Shared</b>, 1=Shared
> 
> +  UINT32  LpDqsOscEn:1;              ///<           Bit 9  - LPDDR Write DQ/DQS
> Retraining: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  RmtPerTask:1;              ///<           Bit 10 - Rank Margin Tool Per Task.
> <b>0 = Disabled</b>, 1 = Enabled
> 
> +  UINT32  TrainTrace:1;              ///<           Bit 11 - Trained state tracing debug.
> <b>0 = Disabled</b>, 1 = Enabled
> 
> +  UINT32  SafeMode:1;                ///<           Bit 12 - Define if safe mode is
> enabled for MC/IO
> 
> +  UINT32  MsHashEnable:1;            ///<           Bit 13 - Controller Hash Enable:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  DisPgCloseIdleTimeout:1;   ///<           Bit 14 - Disable Page Close
> Idle Timeout: 0=Enable, <b>1=Disable</b>
> 
> +  UINT32  Ibecc:1;                   ///<           Bit 15 - Inband ECC - for LPDDR4,
> LPDDR5 and DDR4 only: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  IbeccParity:1;             ///<           Bit 16 - Inband ECC Parity Control -
> for LPDDR4, LPDDR5 and DDR4 only: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  IbeccOperationMode:2;      ///<           Bits 17:18 - Inband ECC
> Operation Mode: 0=Functional Mode protects requests based on the
> address range, <b>1=Makes all requests non protected and ignore range
> checks</b>, 2=Makes all requests protected and ignore range checks
> 
> +  UINT32  ChHashOverride:1;          ///<           Bit 19 - Select if Channel Hash
> setting values will be taken from input parameters or automatically taken
> from POR values depending on DRAM type detected.
> 
> +  UINT32  McParity:1;                ///<           Bit 20 - MC Parity Control - Enable
> Parity for CMI/MC: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  IbeccErrorInj:1;           ///<           Bit 21 - In-Band ECC Error Injection:
> 1=Enable, <b>0=Disable</b>
> 
> +  UINT32  RsvdO64B22t31:10;          ///<           Bits 22:31 reserved
> 
> +  /**
> 
> +   Disables a DIMM slot in the channel even if a DIMM is present\n
> 
> +   Array index represents the channel number (0 = channel 0, 1 = channel
> 1)\n
> 
> +     <b>0x0 = DIMM 0 and DIMM 1 enabled</b>\n
> 
> +     0x1 = DIMM 0 disabled, DIMM 1 enabled\n
> 
> +     0x2 = DIMM 0 enabled, DIMM 1 disabled\n
> 
> +     0x3 = DIMM 0 and DIMM 1 disabled (will disable the whole channel)\n
> 
> +  **/
> 
> +  UINT8
> DisableDimmChannel[MEM_CFG_MAX_CONTROLLERS][MEM_CFG_MAX_C
> HANNELS]; ///< Offset 68-75
> 
> +  UINT8   Ratio;                  ///< Offset 76 DDR Frequency ratio, to multiply by
> 133 or 100 MHz depending on RefClk. <b>0 = Auto</b>
> 
> +  UINT8   ProbelessTrace;         ///< Offset 77 Probeless Trace:
> <b>0=Disabled</b>, <b>1=Enabled</b>
> 
> +  /**
> 
> +     - Channel Hash Enable.\n
> 
> +    NOTE: BIT7 will interleave the channels at a 2 cache-line granularity, BIT8
> at 4 and BIT9 at 8\n
> 
> +    0=BIT6, <B>1=BIT7</B>, 2=BIT8, 3=BIT9
> 
> +  **/
> 
> +  UINT8   ChHashInterleaveBit;    ///< Offset 78 Option to select interleave
> Address bit. Valid values are 0 - 3 for BITS 6 - 9 (Valid values for BDW are 0-7
> for BITS 6 - 13)
> 
> +  UINT8   SmramMask;              ///< Offset 79 Reserved memory ranges for
> SMRAM
> 
> +  UINT32  BClkFrequency;          ///< Offset 80 Base reference clock value, in
> Hertz: <b>100000000 = 100Hz</b>, 125000000=125Hz, 167000000=167Hz,
> 250000000=250Hz
> 
> +
> 
> +  /// Training Algorithms 1 Offset 84
> 
> +  UINT32 ECT:1;                   ///< Bit 0 - Enable/Disable Early Command Training.
> Note it is not recommended to change this setting from the default value:
> <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 SOT:1;                   ///< Bit 1 - Enable/Disable Sense Amp Offset
> Training. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 ERDMPRTC2D:1;            ///< Bit 2 - Enable/Disable Early ReadMPR
> Timing Centering 2D. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RDMPRT:1;                ///< Bit 3 - Enable/Disable Read MPR Training.
> Note it is not recommended to change this setting from the default value:
> 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RCVET:1;                 ///< Bit 4 - Enable/Disable Receive Enable
> Training. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 JWRL:1;                  ///< Bit 5 - Enable/Disable JEDEC Write Leveling
> Training. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 EWRTC2D:1;               ///< Bit 6 - Enable/Disable Early Write Time
> Centering 2D Training. Note it is not recommended to change this setting
> from the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 ERDTC2D:1;               ///< Bit 7 - Enable/Disable Early Read Time
> Centering 2D Training. Note it is not recommended to change this setting
> from the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 WRTC1D:1;                ///< Bit 8 - Enable/Disable 1D Write Timing
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 WRVC1D:1;                ///< Bit 9 - Enable/Disable 1D Write Voltage
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RDTC1D:1;                ///< Bit 10 - Enable/Disable 1D Read Timing
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 DIMMODTT:1;              ///< Bit 11 - Enable/Disable DIMM ODT
> Training. Note it is not recommended to change this setting from the default
> value: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 DIMMRONT:1;              ///< Bit 12 - Enable/Disable DIMM RON
> training. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 WRDSEQT:1;               ///< Bit 13 - Enable/Disable Write Drive
> Strength / Equalization Training 2D. Note it is not recommended to change
> this setting from the default value: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 WRSRT:1;                 ///< Bit 14 - Enable/Disable Write Slew Rate
> traning. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable.</b>
> 
> +  UINT32 RDODTT:1;                ///< Bit 15 - Enable/Disable Read ODT Training.
> Note it is not recommended to change this setting from the default value:
> <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 RDEQT:1;                 ///< Bit 16 - Enable/Disable Read Equalization
> Training. Note it is not recommended to change this setting from the default
> value: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 RDAPT:1;                 ///< Bit 17 - Enable/Disable Read Amplifier Power
> Training. Note it is not recommended to change this setting from the default
> value: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 WRTC2D:1;                ///< Bit 18 - Enable/Disable 2D Write Timing
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RDTC2D:1;                ///< Bit 19 - Enable/Disable 2D Read Timing
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 WRVC2D:1;                ///< Bit 20 - Enable/Disable 2D Write Voltage
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RDVC2D:1;                ///< Bit 21 - Enable/Disable 2D Read Voltage
> Centering Training. Note it is not recommended to change this setting from
> the default value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 CMDVC:1;                 ///< Bit 22 - Enable/Disable Command Vref
> Centering Training. Note it is not recommended to change this setting from
> the default value 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 LCT:1;                   ///< Bit 23 - Enable/Disable Late Command Training.
> Note it is not recommended to change this setting from the default value:
> 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 RTL:1;                   ///< Bit 24 - Enable/Disable Round Trip Latency
> function. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 TAT:1;                   ///< Bit 25 - Enable/Disable Turn Around Time
> function. Note it is not recommended to change this setting from the default
> value: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 RMT:1;                   ///< Bit 26 - Enable/Disable Rank Margin Tool
> function: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 MEMTST:1;                ///< Bit 27 - Enable/Disable Memory Test
> function: <b>0=Disable</b>, 1=Enable.
> 
> +  UINT32 ALIASCHK:1;              ///< Bit 28 - Enable/Disable DIMM SPD Alias
> Check: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32 RCVENC1D:1;              ///< Bit 29 - Enable/Disable Receive Enable
> Centering Training (LPDDR Only). Note it is not recommended to change this
> setting from the default value: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32 RMC:1;                   ///< Bit 30 - Enable/Disable Retrain Margin Check.
> Note it is not recommended to change this setting from the default value:
> <b>0=Disable</b>, 1=Enable
> 
> +  UINT32 WRDSUDT:1;               ///< Bit 31 - Enable/Disable Write Drive
> Strength Up/Dn independently. Note it is not recommended to change this
> setting from the default value: <b>0=Disable</b>, 1=Enable
> 
> +  /// Training Algorithms 2 Offset 88
> 
> +  UINT32 DCC       : 1;           ///< Bit 0  - Enable/Disable Duty Cycle Correction:
> 0=Disable, 1=Enable.
> 
> +  UINT32 RDVC1D    : 1;           ///< Bit 1  - Enable/Disable Read Voltage
> Centering 1D: 0=Disable, 1=Enable.
> 
> +  UINT32 TXTCO     : 1;           ///< Bit 2  - Enable/Disable Write TCO Comp
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 CLKTCO    : 1;           ///< Bit 3  - Enable/Disable Clock TCO Comp
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 CMDSR     : 1;           ///< Bit 4  - Enable/Disable CMD Slew Rate
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 CMDDSEQ   : 1;           ///< Bit 5  - Enable/Disable CMD Drive Strength
> and Tx Equalization: 0=Disable, 1=Enable.
> 
> +  UINT32 DIMMODTCA : 1;           ///< Bit 6  - Enable/Disable Dimm ODT CA
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 TXTCODQS  : 1;           ///< Bit 7  - Enable/Disable Write TCO Dqs
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 CMDDRUD   : 1;           ///< Bit 8  - Enable/Disable CMD/CTL Drive
> Strength Up/Dn 2D: 0=Disable, 1=Enable.
> 
> +  UINT32 VCCDLLBP  : 1;           ///< Bit 9  - Enable/Disable VccDLL bypass to
> VccIOG training: 0=Disable, 1=Enable.
> 
> +  UINT32 PVTTDNLP  : 1;           ///< Bit 10 - Enable/Disable PanicVttDnLp
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 RDVREFDC  : 1;           ///< Bit 11 - Enable/Disable Read Vref Decap
> Training: 0=Disable, 1=Enable.
> 
> +  UINT32 VDDQT     : 1;           ///< Bit 12 - Enable/Disable Vddq Training:
> 0=Disable, 1=Enable.
> 
> +  UINT32 RMTBIT    : 1;           ///< Bit 13 - Enable/Disable Rank Margin Tool Per
> Bit: 0=Disable, 1=Enable.
> 
> +  UINT32 PDA       : 1;           ///< BIT 14 - Enable/Disable PDA Enumeration
> Training. Note it is not recommended to change this setting from the default
> value: 0=Disable, <b>1=Enable</b>.
> 
> +  UINT32 WRITE0    : 1;           ///< BIT 15 - Write0 feature enablement
> 
> +  UINT32 ReservedBits2 :16;       ///< Bits 16:31 - Reserved
> 
> +
> 
> +  UINT32  MrcTimeMeasure:1;         ///< Offset 92 Bit 0  - Enables serial debug
> level to display the MRC execution times only: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  MrcFastBoot:1;            ///<           Bit 1  - Enables the MRC fast boot
> path for faster cold boot execution: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  DqPinsInterleaved:1;      ///<           Bit 2  - Interleaving mode of
> DQ/DQS pins which depends on board routing: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  RankInterleave:1;         ///<           Bit 3  - Rank Interleave Mode:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  EnhancedInterleave:1;     ///<           Bit 4  - Enhanced Interleave
> Mode: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  WeaklockEn:1;             ///<           Bit 5  - Weak Lock Enable:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  ChHashEnable:1;           ///<           Bit 6  - Channel Hash Enable:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  EnablePwrDn:1;            ///<           Bit 7  - Enable Power Down control
> for DDR: 0=PCODE control, <b>1=BIOS control</b>
> 
> +  UINT32  EnablePwrDnLpddr:1;       ///<           Bit 8  - Enable Power Down for
> LPDDR: 0=PCODE control, <b>1=BIOS control</b>
> 
> +  UINT32  SrefCfgEna:1;             ///<           Bit 9  - Enable Self Refresh:
> 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  ThrtCkeMinDefeatLpddr:1;  ///<           Bit 10 - Throttler CKE min
> defeature for LPDDR: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  ThrtCkeMinDefeat:1;       ///<           Bit 11 - Throttler CKE min
> defeature: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  AutoSelfRefreshSupport:1; ///<           Bit 12 - FALSE = No auto self
> refresh support, <b>TRUE = auto self refresh support</b>
> 
> +  UINT32  ExtTemperatureSupport:1;  ///<           Bit 13 - FALSE = No extended
> temperature support, <b>TRUE = extended temperature support</b>
> 
> +  UINT32  MobilePlatform:1;         ///<           Bit 14 - Memory controller device
> id indicates: <b>TRUE if mobile</b>, FALSE if not. Note: This will be auto-
> detected and updated.
> 
> +  UINT32  Force1Dpc:1;              ///<           Bit 15 - TRUE means force one DIMM
> per channel, <b>FALSE means no limit</b>
> 
> +  UINT32  ForceSingleRank:1;        ///<           Bit 16 - TRUE means use Rank0
> only (in each DIMM): <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  VttTermination:1;         ///<           Bit 17 - Vtt Termination for Data
> ODT: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  VttCompForVsshi:1;        ///<           Bit 18 - Enable/Disable Vtt
> Comparator For Vsshi: <b>0=Disable</b>, 1=Enable
> 
> +  UINT32  ExitOnFailure:1;          ///<           Bit 19 - MRC option for exit on
> failure or continue on failure: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  NewFeatureEnable1:1;      ///<           Bit 20 - Generic enable knob
> for new feature set 1 <b>0: Disable </b>; 1: Enable
> 
> +  UINT32  NewFeatureEnable2:1;      ///<           Bit 21 - Generic enable knob
> for new feature set 2 <b>0: Disable </b>; 1: Enable
> 
> +  UINT32  RhPrevention:1;           ///<           Bit 22 - RH Prevention
> Enable/Disable: 0=Disable, <b>1=Enable</b>
> 
> +  UINT32  RhSolution:1;             ///<           Bit 23 - Type of solution to be used
> for RHP - 0/1 = HardwareRhp/Refresh2x
> 
> +  UINT32  RefreshPanicWm:4;         ///<           Bit 24-27 - Refresh Panic
> Watermark, Range 1-8, default 8.
> 
> +  UINT32  RefreshHpWm:4;            ///<           Bit 28-31 - Refresh High Profile
> Watermark, Range 1-7, default 7.
> 
> +  UINT32  VddSettleWaitTime;      ///< Offset 96 Amount of time in
> microseconds to wait for Vdd to settle on top of 200us required by JEDEC
> spec: <b>Default=0</b>
> 
> +  UINT16  SrefCfgIdleTmr;         ///< Offset 100 Self Refresh idle timer:
> <b>512=Minimal</b>, 65535=Maximum
> 
> +  UINT16  ChHashMask;             ///< Offset 102 Channel Hash Mask:
> 0x0001=BIT6 set(Minimal), 0x3FFF=BIT[19:6] set(Maximum), <b>0x30CE=
> BIT[19:18, 13:12 ,9:7] set</b>
> 
> +  UINT16  DdrFreqLimit;           ///< Offset 104 Memory Frequency setting:
> 3=1067, 5=1333, 7=1600, 9=1867, 11=2133, 13=2400, <b>15=2667</b>
> 
> +  UINT8   MaxRttWr;               ///< Offset 106 Maximum DIMM RTT_WR to use
> in power training: <b>0=ODT Off</b>, 1 = 120 ohms
> 
> +  UINT8   ThrtCkeMinTmr;          ///< Offset 107 Throttler CKE min timer:
> 0=Minimal, 0xFF=Maximum, <b>0x00=Default</b>
> 
> +  UINT8   ThrtCkeMinTmrLpddr;     ///< Offset 108 Throttler CKE min timer for
> LPDDR: 0=Minimal, 0xFF=Maximum, <b>0x00=Default</b>
> 
> +  BOOLEAN PerBankRefresh;         ///< Offset 109 Enables and Disables the
> per bank refresh.  This only impacts memory technologies that support PBR:
> LPDDR3, LPDDR4.  FALSE=Disabled, <b>TRUE=Enabled</b>
> 
> +  UINT8   SaGv;                   ///< Offset 110 SA GV: <b>0=Disabled</b>,
> 1=Point1, 2=Point2, 3=Point3, 4=Point4, 5=Enabled
> 
> +  UINT8   NModeSupport;           ///< Offset 111 Memory N Mode Support -
> Enable user to select Auto, 1N or 2N: <b>0=AUTO</b>, 1=1N, 2=2N.
> 
> +  UINT8   RefClk;                 ///< Offset 112 Selects the DDR base reference
> clock. 0x01 = 100MHz, <b>0x00 = 133MHz</b>
> 
> +  UINT8   EnCmdRate;              ///< Offset 113 CMD Rate Enable: 0=Disable,
> 5=2 CMDs, <b>7=3 CMDs</b>, 9=4 CMDs, 11=5 CMDs, 13=6 CMDs, 15=7
> CMDs
> 
> +  UINT8   Refresh2X;              ///< Offset 114 Refresh 2x: <b>0=Disable</b>,
> 1=Enable for WARM or HOT, 2=Enable for HOT only
> 
> +  UINT8   EpgEnable;              ///< Offset 115 Enable Energy Performance Gain.
> 
> +  UINT8   UserThresholdEnable;    ///< Offset 116 Flag to manually select the
> DIMM CLTM Thermal Threshold, 0=Disable,  1=Enable, <b>0=Default</b>
> 
> +  UINT8   UserBudgetEnable;       ///< Offset 117 Flag to manually select the
> Budget Registers for CLTM Memory Dimms , 0=Disable,  1=Enable,
> <b>0=Default</b>
> 
> +  UINT8   RetrainOnFastFail;      ///< Offset 118 Restart MRC in Cold mode if
> SW MemTest fails during Fast flow. 0 = Disabled, <b>1 = Enabled</b>
> 
> +  UINT8   PowerDownMode;          ///< Offset 119 CKE Power Down Mode:
> <b>0xFF=AUTO</b>, 0=No Power Down, 1= APD mode, 6=PPD-DLL Off
> mode
> 
> +  UINT8   PwdwnIdleCounter;       ///< Offset 120 CKE Power Down Mode
> Idle Counter: 0=Minimal, 255=Maximum, <b>0x80=0x80 DCLK</b>
> 
> +  UINT8   CmdRanksTerminated;     ///< Offset 121 LPDDR: Bitmask of ranks
> that have CA bus terminated. <b>0x01=Default, Rank0 is terminating and
> Rank1 is non-terminating</b>
> 
> +  UINT16  MsHashMask;             ///< Offset 122 Controller Hash Mask:
> 0x0001=BIT6 set(Minimal), 0x3FFF=BIT[19:6] set(Maximum), <b>0x30CE=
> BIT[19:18, 13:12 ,9:7] set</b>
> 
> +  UINT32  Lp5CccConfig;           ///< Offset 124 BitMask where bits [3:0] are
> controller 0 Channel [3:0] and [7:4] are Controller 1 Channel [3:0].  0 selects
> Ascending mapping and 1 selects Descending mapping.
> 
> +  UINT8   RMTLoopCount;           ///< Offset 128 Indicates the Loop Count to
> be used for Rank Margin Tool Testing: 1=Minimal, 32=Maximum, 0=AUTO,
> <b>0=Default</b>
> 
> +  UINT8   MsHashInterleaveBit;    ///< Offset 129 Option to select interleave
> Address bit. Valid values are 0 - 3 for BITS 6 - 9
> 
> +  UINT8   GearRatio;              ///< Offset 130 This input control's the current
> gear expressed as an integer when SAGV is disabled: <b>0=Default</b>, 1, 2.
> 
> +  UINT8   Ddr4OneDpc;             ///< Offset 131 DDR4 1DPC performance
> feature: 0 - Disabled; 1 - Enabled on DIMM0 only, 2 - Enabled on DIMM1 only;
> 3 - Enabled on both DIMMs. (bit [0] - DIMM0, bit [1] - DIMM1)
> 
> +  UINT32  BclkRfiFreq[MEM_MAX_SAGV_POINTS]; ///< Offset 132 Bclk RFI
> Frequency for each SAGV point in Hz units. 98000000Hz = 98MHz <b>0 - No
> RFI Tuning</b>. Range is 98Mhz-100Mhz.
> 
> +  UINT16  SaGvFreq[MEM_MAX_SAGV_POINTS];    ///< Offset 148
> Frequency per SAGV point.  0 is Auto, otherwise holds the frequency value
> expressed as an integer: <b>0=Default</b>, 1067, 1333, 1600, 1800, 1867,
> etc.
> 
> +  /**
> 
> +    Offset 156 Gear ratio per SAGV point.  0 is Auto, otherwise holds the Gear
> ratio expressed as an integer: <b>0=Default</b>, 1, 2.
> 
> +      Only valid combinations of Gear Ratio per point is:
> 
> +      | point | set1 | set2 | set3
> 
> +      | 0     | 1    | 2    | 2
> 
> +      | 1     | 1    | 2    | 2
> 
> +      | 2     | 1    | 2    | 2
> 
> +      | 3     | 1    | 2    | 1
> 
> +  **/
> 
> +  UINT8   SaGvGear[MEM_MAX_SAGV_POINTS];                      ///< Offset 156
> 
> +  UINT8   IbeccProtectedRegionEnable[MEM_MAX_IBECC_REGIONS];  ///<
> Offset 160 Enable use of address range for ECC Protection:
> <b>0=Default</b>, 1
> 
> +  UINT16  IbeccProtectedRegionBase[MEM_MAX_IBECC_REGIONS];    ///<
> Offset 168 Base address for address range of ECC Protection:
> <b>0=Default</b>, 1
> 
> +  UINT16  IbeccProtectedRegionMask[MEM_MAX_IBECC_REGIONS];    ///<
> Offset 184 Mask address for address range of ECC Protection:
> <b>0=Default</b>, 1
> 
> +  UINT32  CmdMirror;              ///< Offset 200 BitMask where bits [3:0] are
> controller 0 Channel [3:0] and [7:4] are Controller 1 Channel [3:0].  0 = No
> Command Mirror and 1 = Command Mirror.
> 
> +  UINT8   CpuBclkSpread;          ///< Offset 204 CPU BCLK Spread Specturm: 0
> = Disabled; <b>1 = Enabled</b>
> 
> +  UINT8   ExtendedBankHashing;    ///< Offset 205 Enable EBH Extended
> Bank Hashing: 0=Disabled; <b>1 = Enabled</b>.
> 
> +  UINT16  VddqVoltageOverride;    ///< Offset 206 VccddqVoltage override
> in # of 1mV
> 
> +  UINT8   MarginLimitCheck;                                   ///< Offset 208 Margin limit
> check enable: <b>0=Disable</b>, 1=L1 only, 2=L2 only, 3=Both L1 and L2
> 
> +  UINT8   RsvdO209;                                           ///< Offset 209
> 
> +  UINT16  MarginLimitL2;                                      ///< Offset 210 Margin limit
> check L2 threshold: <b>100=Default</b>
> 
> +} MEMORY_CONFIGURATION;
> 
> +
> 
> +/// Memory Configuration
> 
> +/// The contents of this structure are not CRC'd by the MRC for option
> change detection.
> 
> +/// <b>Revision 1</b>:  - Initial version.
> 
> +/// <b>Revision 2</b>:  - Added MemTestOnWarmBoot
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER      Header;              ///< Offset 0-23 Config Block
> Header
> 
> +  SA_FUNCTION_CALLS        SaCall;              ///< Offset 24   Function calls into
> the SA.
> 
> +  SA_MEMORY_FUNCTIONS      MrcCall;             ///< Offset 204  Function calls
> into the MRC.
> 
> +  SPD_DATA_BUFFER          *SpdData;            ///< Offset 240  Memory SPD
> data, will be used by the MRC when SPD SmBus address is zero.
> 
> +  UINT32                   Reserved0;
> 
> +  SA_MEMORY_DQDQS_MAPPING  *DqDqsMap;           ///< Offset 244
> LPDDR DQ bit and DQS byte swizzling between CPU and DRAM.
> 
> +  SA_MEMORY_RCOMP          *RcompData;          ///< Offset 248  DDR RCOMP
> resistors and target values.
> 
> +  UINT64                   PlatformMemorySize;  ///< Offset 252  The minimum
> platform memory size required to pass control into DXE
> 
> +  UINT32                   CleanMemory:1;       ///< Offset 256  Ask MRC to clear
> memory content: <b>FALSE=Do not Clear Memory</b>; TRUE=Clear
> Memory
> 
> +  UINT32                   ReservedBits5:31;
> 
> +  /**
> 
> +   Sets the serial debug message level\n
> 
> +     0x00 = Disabled\n
> 
> +     0x01 = Errors only\n
> 
> +     0x02 = Errors and Warnings\n
> 
> +     <b>0x03 = Errors, Warnings, and Info</b>\n
> 
> +     0x04 = Errors, Warnings, Info, and Events\n
> 
> +     0x05 = Displays Memory Init Execution Time Summary only\n
> 
> +  **/
> 
> +  UINT8   SerialDebugLevel;                     ///< Offset 260
> 
> +  UINT8   MemTestOnWarmBoot;                    ///< Offset 261  Run Base
> Memory Test On WarmBoot:  0=Disabled, <b>1=Enabled</b>
> 
> +  UINT8   Reserved11[2];                        ///< Offset 262 - 263  Reserved
> 
> +} MEMORY_CONFIG_NO_CRC;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _MEMORY_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/Overcl
> ockingConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/Overcl
> ockingConfig.h
> new file mode 100644
> index 0000000000..462c02cef1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Overclocking/Overcl
> ockingConfig.h
> @@ -0,0 +1,236 @@
> +/** @file
> 
> +  Overclocking Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _OVERCLOCKING_PREMEM_CONFIG_H_
> 
> +#define _OVERCLOCKING_PREMEM_CONFIG_H_
> 
> +
> 
> +#define OVERCLOCKING_CONFIG_REVISION 9
> 
> +
> 
> +extern EFI_GUID gOverclockingPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +//
> 
> +// Max number of VF point offset
> 
> +//
> 
> +#ifndef CPU_OC_MAX_VF_POINTS
> 
> +#define CPU_OC_MAX_VF_POINTS   0xF
> 
> +#endif
> 
> +
> 
> +#ifndef CPU_OC_MAX_CORES
> 
> +#define CPU_OC_MAX_CORES   8
> 
> +#endif
> 
> +/**
> 
> +  Overclocking Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>
> 
> +  - Add PerCoreHtDisable
> 
> +  <b>Revision 3</b>
> 
> +  - Add Avx2VoltageScaleFactor and Avx512VoltageScaleFactor
> 
> +  <b>Revision 4</b>
> 
> +  - Add CoreVfPointOffsetMode & CoreVfPointOffset & CoreVfPointRatio &
> CoreVfPointCount
> 
> +  <b>Revision 5</b>
> 
> +  - Change OcLock default to 'Enabled'
> 
> +  <b>Revision 6</b>:
> 
> +  - Add DisableCoreMask.
> 
> +  <b>Revision 7</b>
> 
> +    Add UnlimitedIccMax
> 
> +  <b>Revision 8</b>
> 
> +  - Add PerCoreRatioOverride and PerCoreRatio for Per Core PState
> overclocking.
> 
> +  <b>Revision 9</b>
> 
> +  - Add VccInVoltageOverride.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +  Overclocking support. This controls whether OC mailbox transactions are
> sent.
> 
> +  If disabled, all policies in this config block besides OcSupport and OcLock
> will be ignored.
> 
> +  <b>0: Disable</b>;
> 
> +  1: Enable.
> 
> +  @note If PcdOverclockEnable is disabled, this should also be disabled.
> 
> +  **/
> 
> +  UINT32 OcSupport            :  1;
> 
> +  UINT32 OcLock               :  1;               ///< If enabled, sets OC lock bit in MSR
> 0x194[20], locking the OC mailbox and other OC configuration settings.; 0:
> Disable; <b>1: Enable (Lock)</b>.
> 
> +  /**
> 
> +  Core voltage mode, specifies which voltage mode the processor will be
> operating.
> 
> +  <b>0: Adaptive Mode</b> allows the processor to interpolate a voltage
> curve when beyond fused P0 range;
> 
> +  1: Override, sets one voltage for for the entire frequency range, Pn-P0.
> 
> +  **/
> 
> +  UINT32 CoreVoltageMode      :  1;
> 
> +  UINT32 CorePllVoltageOffset :  6;               ///< Core PLL voltage offset.
> <b>0: No offset</b>. Range 0-63 in 17.5mv units.
> 
> +  UINT32 Avx2RatioOffset      :  5;               ///< AVX2 Ratio Offset. <b>0: No
> offset</b>. Range is 0-31. Used to lower the AVX ratio to maximize possible
> ratio for SSE workload.
> 
> +  UINT32 Avx3RatioOffset      :  5;               ///< AVX3 Ratio Offset. <b>0: No
> offset</b>. Range is 0-31. Used to lower the AVX3 ratio to maximize possible
> ratio for SSE workload.
> 
> +  UINT32 BclkAdaptiveVoltage  :  1;               ///< Bclk Adaptive Voltage
> enable/disable. <b>0: Disabled</b>, 1: Enabled. When enabled, the CPU V/F
> curves are aware of BCLK frequency when calculated.
> 
> +  /**
> 
> +  Ring Downbin enable/disable.
> 
> +  When enabled, the CPU will force the ring ratio to be lower than the core
> ratio.
> 
> +  Disabling will allow the ring and core ratios to run at the same frequency.
> 
> +  Uses OC Mailbox command 0x19.
> 
> +  0: Disables Ring Downbin feature. <b>1: Enables Ring downbin
> feature.</b>
> 
> +  **/
> 
> +  UINT32 RingDownBin          :  1;
> 
> +  /**
> 
> +  Ring voltage mode, specifies which voltage mode the processor will be
> operating.
> 
> +  <b>0: Adaptive Mode</b> allows the processor to interpolate a voltage
> curve when beyond fused P0 range;
> 
> +  1: Override, sets one voltage for for the entire frequency range, Pn-P0.
> 
> +  **/
> 
> +  UINT32 RingVoltageMode      :  1;
> 
> +  UINT32 GtVoltageMode        :  1;    ///< Specifies whether GT voltage is
> operating in Adaptive or Override mode: <b>0=Adaptive</b>, 1=Override
> 
> +  UINT32 RealtimeMemoryTiming :  1;    ///< Enable/Disable the message
> sent to the CPU to allow realtime memory timing changes after MRC_DONE.
> <b>0=Disable</b>, 1=Enable
> 
> +  UINT32 FivrFaults           :  1;    ///< Fivr Faults. Enable or Disable FIVR Faults.
> 0: Disabled, <b>1: Enabled.</b>
> 
> +  UINT32 FivrEfficiency       :  1;    ///< Fivr Efficiency Management. 0:
> Disabled, <b>1: Enabled.</b>
> 
> +  /**
> 
> +  Selects Core Voltage & Frequency Point Offset between Legacy and
> Selection modes.
> 
> +  Need Reset System after enabling OverClocking Feature to Initialize the
> default value.
> 
> +  <b>0: In Legacy Mode, setting a global offset for the entire VF curve.</b>
> 
> +  1: In Selection modes, setting a selected VF point.
> 
> +  **/
> 
> +  UINT32 CoreVfPointOffsetMode : 1;
> 
> +  UINT32 UnlimitedIccMax      :  1;    ///< Support Unlimited ICCMAX more
> than maximum value 255.75A.  <b>0: Disabled</b>, 1: Enabled.
> 
> +  UINT32 PerCoreRatioOverride :  1;              ///< Enable or disable Per Core
> PState OC supported by writing OCMB 0x1D to program new favored core
> ratio to each Core. <b>0: Disable</b>, 1: enable
> 
> +  UINT32 DynamicMemoryChange  :  1;   ///< Dynamic Memory Timings
> Changes; <b>0: Disabled</b>; 1: Enabled.
> 
> +  UINT32 RsvdBits             :  2;    ///< Reserved for future use
> 
> +
> 
> +  /**
> 
> +  Maximum core turbo ratio override allows to increase CPU core frequency
> beyond the fused max turbo ratio limit (P0).
> 
> +  <b>0. no override/HW defaults.</b>. Range 0-85.
> 
> +  **/
> 
> +  UINT8  CoreMaxOcRatio;
> 
> +  UINT8  GtMaxOcRatio;                 ///< Maximum GT turbo ratio override:
> 0=Minimal, 60=Maximum, <b>0=AUTO</b>
> 
> +  /**
> 
> +  Maximum ring ratio override allows to increase CPU ring frequency beyond
> the fused max ring ratio limit.
> 
> +  <b>0. no override/HW defaults.</b>. Range 0-85.
> 
> +  **/
> 
> +  UINT8  RingMaxOcRatio;
> 
> +  UINT8  RsvdByte1;
> 
> +  /**
> 
> +  The core voltage override which is applied to the entire range of cpu core
> frequencies.
> 
> +  Used when CoreVoltageMode = Override.
> 
> +  <b>0. no override</b>. Range 0-2000 mV.
> 
> +  **/
> 
> +  UINT16 CoreVoltageOverride;
> 
> +  /**
> 
> +  Adaptive Turbo voltage target used to define the interpolation voltage
> point when the cpu is operating in turbo mode range.
> 
> +  Used when CoreVoltageMode = Adaptive.
> 
> +  <b>0. no override</b>. Range 0-2000mV.
> 
> +  **/
> 
> +  UINT16 CoreVoltageAdaptive;
> 
> +  /**
> 
> +  The core voltage offset applied on top of all other voltage modes. This
> offset is applied over the entire frequency range.
> 
> +  This is a 2's complement number in mV units. <b>Default: 0</b> Range: -
> 1000 to 1000.
> 
> +  **/
> 
> +  INT16  CoreVoltageOffset;
> 
> +  /**
> 
> +  The ring voltage override which is applied to the entire range of cpu ring
> frequencies.
> 
> +  Used when RingVoltageMode = Override.
> 
> +  <b>0. no override</b>. Range 0-2000 mV.
> 
> +  **/
> 
> +  UINT16 RingVoltageOverride;
> 
> +  /**
> 
> +  Adaptive Turbo voltage target used to define the interpolation voltage
> point when the ring is operating in turbo mode range.
> 
> +  Used when RingVoltageMode = Adaptive.
> 
> +  <b>0. no override</b>. Range 0-2000mV.
> 
> +  **/
> 
> +  UINT16 RingVoltageAdaptive;
> 
> +  /**
> 
> +  The ring voltage offset applied on top of all other voltage modes. This
> offset is applied over the entire frequency range.
> 
> +  This is a 2's complement number in mV units. <b>Default: 0</b> Range: -
> 1000 to 1000.
> 
> +  **/
> 
> +  INT16  RingVoltageOffset;
> 
> +
> 
> +  INT16  GtVoltageOffset;                         ///< The voltage offset applied to GT
> slice. Valid range from -1000mv to 1000mv: <b>0=Minimal</b>,
> 1000=Maximum
> 
> +  UINT16 GtVoltageOverride;                       ///< The GT voltage override which
> is applied to the entire range of GT frequencies <b>0=Default</b>
> 
> +  UINT16 GtExtraTurboVoltage;                     ///< The adaptive voltage applied
> during turbo frequencies. Valid range from 0 to 2000mV: <b>0=Minimal</b>,
> 2000=Maximum
> 
> +  INT16  SaVoltageOffset;                         ///< The voltage offset applied to the
> SA. Valid range from -1000mv to 1000mv: <b>0=Default</b>
> 
> +  UINT32 GtPllVoltageOffset     :  6;             ///< GT PLL voltage offset. <b>0:
> No offset</b>. Range 0-63 in 17.5mv units.
> 
> +  UINT32 RingPllVoltageOffset   :  6;             ///< Ring PLL voltage offset. <b>0:
> No offset</b>. Range 0-63 in 17.5mv units.
> 
> +  UINT32 SaPllVoltageOffset     :  6;             ///< System Agent PLL voltage
> offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
> 
> +  UINT32 McPllVoltageOffset     :  6;             ///< Memory Controller PLL
> voltage offset. <b>0: No offset</b>. Range 0-63 in 17.5mv units.
> 
> +  UINT32 RsvdBits1              :  8;
> 
> +  /**
> 
> +  TjMax Offset. Specified value here is clipped by pCode (125 - TjMax Offset)
> to support TjMax in the range of 62 to 115 deg Celsius.
> 
> +  <b> Default: 0 Hardware Defaults </b> Range 10 to 63. 0 = No offset /
> Keep HW default.
> 
> +  **/
> 
> +  UINT8  TjMaxOffset;
> 
> +  UINT8  RsvdByte2[3];                           //< Reserved for dword alignment
> 
> +  /**
> 
> +  This service controls Core frequency reduction caused by high package
> temperatures for processors that
> 
> +  implement the Intel Thermal Velocity Boost (TVB) feature. It is required to
> be disabled for supporting
> 
> +  overclocking at frequencies higher than the default max turbo frequency.
> 
> +  <b>0: Disables TVB ratio clipping. </b>1: Enables TVB ratio clipping.
> 
> +  **/
> 
> +  UINT32 TvbRatioClipping       :  1;
> 
> +  /**
> 
> +  This service controls thermal based voltage optimizations for processors
> that implement the Intel
> 
> +  Thermal Velocity Boost (TVB) feature.
> 
> +  0: Disables TVB voltage optimization. <b>1: Enables TVB voltage
> optimization.</b>
> 
> +  **/
> 
> +  UINT32 TvbVoltageOptimization :  1;
> 
> +  UINT32 RsvdBits2              : 30;
> 
> +  /**
> 
> +  Defines the per-core HT disable mask where: 1 - Disable selected logical
> core HT, 0 - is ignored.
> 
> +  Input is in HEX and each bit maps to a logical core. Ex. A value of '1F' would
> disable HT for cores 4,3,2,1 and 0.
> 
> +  <b>Default is 0</b>, all cores have HT enabled. Range is 0 - 0x1FF. You can
> only disable up to MAX_CORE_COUNT - 1.
> 
> +  **/
> 
> +  UINT16 PerCoreHtDisable;
> 
> +  /**
> 
> +  Avx2 Voltage Guardband Scale Factor
> 
> +  This controls the AVX2 Voltage Guardband Scale factor applied to AVX2
> workloads.
> 
> +  Valid range is 0-200 in 1/100 units, where a value of 125 would apply a 1.25
> scale factor.
> 
> +  A value of 0 means no scale factor applied (no change to voltage on AVX
> commands)
> 
> +  A value of 100 applies the default voltage guardband values (1.0 factor).
> 
> +  A value > 100 will increase the voltage guardband on AVX2 workloads.
> 
> +  A value < 100 will decrease the voltage guardband on AVX2 workloads.
> 
> +
> 
> +  <b>0. No scale factor applied</b>
> 
> +  **/
> 
> +  UINT8 Avx2VoltageScaleFactor;
> 
> +  /**
> 
> +  Avx512 Voltage Guardband Scale Factor
> 
> +  This controls the AVX512 Voltage Guardband Scale factor applied to
> AVX512 workloads.
> 
> +  Valid range is 0-200 in 1/100 units, where a value of 125 would apply a 1.25
> scale factor.
> 
> +  A value of 0 means no scale factor applied (no change to voltage on AVX
> commands)
> 
> +  A value of 100 applies the default voltage guardband values (1.0 factor).
> 
> +  A value > 100 will increase the voltage guardband on AVX512 workloads.
> 
> +  A value < 100 will decrease the voltage guardband on AVX512 workloads.
> 
> +
> 
> +  <b>0. No scale factor applied</b>
> 
> +  **/
> 
> +  UINT8 Avx512VoltageScaleFactor;
> 
> +  /**
> 
> +  Array used to specifies the Core Voltage Offset applied to the each
> selected VF Point.
> 
> +  This voltage is specified in millivolts.
> 
> +  **/
> 
> +  INT16  CoreVfPointOffset[CPU_OC_MAX_VF_POINTS];
> 
> +  UINT8  RsvdByte3[2];  ///< Just to keep native alignment.
> 
> +  /**
> 
> +  Array for the each selected VF Point to display the Core Ration.
> 
> +  **/
> 
> +  UINT8  CoreVfPointRatio[CPU_OC_MAX_VF_POINTS];
> 
> +  /**
> 
> +  Number of supported Core Voltage & Frequency Point.
> 
> +  **/
> 
> +  UINT8  CoreVfPointCount;
> 
> +  /**
> 
> +  Core mask is a bitwise indication of which core should be disabled. Bit 0 -
> core 0, bit 7 - core 7.
> 
> +  **/
> 
> +  UINT32 DisableCoreMask;
> 
> +  UINT8  PerCoreRatio[CPU_OC_MAX_CORES];
> 
> +  /**
> 
> +  The VcccIn voltage override.
> 
> +  This will override VccIn output voltage level to the voltage value specified.
> 
> +  The voltage level is fixed and will not change except on PKG C-states or
> resets.
> 
> +
> 
> +  <b>0. no override</b>. Range 0-3000 mV.
> 
> +  **/
> 
> +  UINT32 VccInVoltageOverride;
> 
> +} OVERCLOCKING_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_OVERCLOCKING_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
> new file mode 100644
> index 0000000000..69271205b1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/P2sb/P2sbConfig.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  P2sb policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _P2SB_CONFIG_H_
> 
> +#define _P2SB_CONFIG_H_
> 
> +
> 
> +#define P2SB_CONFIG_REVISION 1
> 
> +extern EFI_GUID gP2sbConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure contains the policies which are related to P2SB device.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    The sideband MMIO register access to specific ports will be locked
> 
> +    before 3rd party code execution. Currently it disables PSFx access.
> 
> +    This policy unlocks the sideband MMIO space for those IPs.
> 
> +    <b>0: Lock sideband access </b>; 1: Unlock sideband access.
> 
> +    NOTE: Do not set this policy "SbAccessUnlock" unless its necessary.
> 
> +  **/
> 
> +  UINT32    SbAccessUnlock    :  1;
> 
> +  UINT32    Rsvdbits          : 31;    ///< Reserved bits
> 
> +} PCH_P2SB_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _P2SB_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConfi
> g.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConf
> ig.h
> new file mode 100644
> index 0000000000..b73108bcfd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PchDmi/PchDmiConf
> ig.h
> @@ -0,0 +1,44 @@
> +/** @file
> 
> +  DMI policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_DMI_CONFIG_H_
> 
> +#define _PCH_DMI_CONFIG_H_
> 
> +
> 
> +#define PCH_DMI_CONFIG_REVISION 2
> 
> +extern EFI_GUID gPchDmiConfigGuid;
> 
> +
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +
> 
> +/**
> 
> + The PCH_DMI_CONFIG block describes the expected configuration of the
> PCH for DMI.
> 
> +   <b>Revision 1</b>:  - Initial version.
> 
> +   <b>Revision 2</b>:  - Add OpioRecenter
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +
> 
> +  UINT32     PwrOptEnable      :  1;    ///< <b>0: Disable</b>; 1: Enable DMI
> Power Optimizer on PCH side.
> 
> +  UINT32     DmiAspmCtrl       :  8;    ///< ASPM configuration on the PCH side
> of the DMI/OPI Link. Default is <b>PchPcieAspmAutoConfig</b>
> 
> +  UINT32     CwbEnable         :  1;    ///< 0: Disable; <b>1: Enable</b> Central
> Write Buffer feature configurable and enabled by default
> 
> +  UINT32     L1RpCtl           :  1;    ///< 0: Disable; <b>1: Enable</b> Allow DMI
> enter L1 when all root ports are in L1, L0s or link down. Disabled by default.
> 
> +  /**
> 
> +   When set to TRUE turns on:
> 
> +     - L1 State Controller Power Gating
> 
> +     - L1 State PHY Data Lane Power Gating
> 
> +     - PHY Common Lane Power Gating
> 
> +     - Hardware Autonomous Enable
> 
> +     - PMC Request Enable and Sleep Enable
> 
> +  **/
> 
> +  UINT32     DmiPowerReduction :  1;
> 
> +  UINT32     OpioRecenter      :  1;    ///< 0: Disable; <b>1: Enable</b> Opio
> Recentering Disable for Pcie latency
> 
> +  UINT32     Rsvdbits          : 19;    ///< Reserved bits
> 
> +} PCH_DMI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PCH_DMI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/Pc
> hPcieRpConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/P
> chPcieRpConfig.h
> new file mode 100644
> index 0000000000..de086473a9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PchPcieRp/P
> chPcieRpConfig.h
> @@ -0,0 +1,368 @@
> +/** @file
> 
> +  PCH Pcie root port policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCIERP_CONFIG_H_
> 
> +#define _PCH_PCIERP_CONFIG_H_
> 
> +
> 
> +#include <PchLimits.h>
> 
> +#include <PcieConfig.h>
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define PCIE_RP_CONFIG_REVISION 1
> 
> +#define PCIE_RP_PREMEM_CONFIG_REVISION 1
> 
> +#define PCIE_RP_DXE_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gPchPcieConfigGuid;
> 
> +extern EFI_GUID gPcieRpPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +#define PCIE_LINK_EQ_COEFFICIENTS_MAX 10
> 
> +#define PCIE_LINK_EQ_PRESETS_MAX 11
> 
> +
> 
> +typedef enum {
> 
> +  PchPcieOverrideDisabled             = 0,
> 
> +  PchPcieL1L2Override                 = 0x01,
> 
> +  PchPcieL1SubstatesOverride          = 0x02,
> 
> +  PchPcieL1L2AndL1SubstatesOverride   = 0x03,
> 
> +  PchPcieLtrOverride                  = 0x04
> 
> +} PCH_PCIE_OVERRIDE_CONFIG;
> 
> +
> 
> +/**
> 
> +  PCIe device table entry entry
> 
> +
> 
> +  The PCIe device table is being used to override PCIe device ASPM settings.
> 
> +  To take effect table consisting of such entries must be instelled as PPI
> 
> +  on gPchPcieDeviceTablePpiGuid.
> 
> +  Last entry VendorId must be 0.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16  VendorId;                    ///< The vendor Id of Pci Express card ASPM
> setting override, 0xFFFF means any Vendor ID
> 
> +  UINT16  DeviceId;                    ///< The Device Id of Pci Express card ASPM
> setting override, 0xFFFF means any Device ID
> 
> +  UINT8   RevId;                       ///< The Rev Id of Pci Express card ASPM setting
> override, 0xFF means all steppings
> 
> +  UINT8   BaseClassCode;               ///< The Base Class Code of Pci Express card
> ASPM setting override, 0xFF means all base class
> 
> +  UINT8   SubClassCode;                ///< The Sub Class Code of Pci Express card
> ASPM setting override, 0xFF means all sub class
> 
> +  UINT8   EndPointAspm;                ///< Override device ASPM (see:
> PCH_PCIE_ASPM_CONTROL)
> 
> +                                       ///< Bit 1 must be set in OverrideConfig for this field to
> take effect
> 
> +  UINT16  OverrideConfig;              ///< The override config bitmap (see:
> PCH_PCIE_OVERRIDE_CONFIG).
> 
> +  /**
> 
> +    The L1Substates Capability Offset Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    This field can be zero if only the L1 Substate value is going to be override.
> 
> +  **/
> 
> +  UINT16  L1SubstatesCapOffset;
> 
> +  /**
> 
> +    L1 Substate Capability Mask. (applicable if bit 2 is set in OverrideConfig)
> 
> +    Set to zero then the L1 Substate Capability [3:0] is ignored, and only L1s
> values are override.
> 
> +    Only bit [3:0] are applicable. Other bits are ignored.
> 
> +  **/
> 
> +  UINT8   L1SubstatesCapMask;
> 
> +  /**
> 
> +    L1 Substate Port Common Mode Restore Time Override. (applicable if bit
> 2 is set in OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sCommonModeRestoreTime;
> 
> +  /**
> 
> +    L1 Substate Port Tpower_on Scale Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sTpowerOnScale;
> 
> +  /**
> 
> +    L1 Substate Port Tpower_on Value Override. (applicable if bit 2 is set in
> OverrideConfig)
> 
> +    L1sCommonModeRestoreTime and L1sTpowerOnScale can have a valid
> value of 0, but not the L1sTpowerOnValue.
> 
> +    If L1sTpowerOnValue is zero, all L1sCommonModeRestoreTime,
> L1sTpowerOnScale, and L1sTpowerOnValue are ignored,
> 
> +    and only L1SubstatesCapOffset is override.
> 
> +  **/
> 
> +  UINT8   L1sTpowerOnValue;
> 
> +
> 
> +  /**
> 
> +    SnoopLatency bit definition
> 
> +    Note: All Reserved bits must be set to 0
> 
> +
> 
> +    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                  When clear values in bits 9:0 will be ignored
> 
> +    BITS[14:13] - Reserved
> 
> +    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                  000b - 1 ns
> 
> +                  001b - 32 ns
> 
> +                  010b - 1024 ns
> 
> +                  011b - 32,768 ns
> 
> +                  100b - 1,048,576 ns
> 
> +                  101b - 33,554,432 ns
> 
> +                  110b - Reserved
> 
> +                  111b - Reserved
> 
> +    BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied
> with
> 
> +                  the scale in bits 12:10
> 
> +
> 
> +    This field takes effect only if bit 3 is set in OverrideConfig.
> 
> +  **/
> 
> +  UINT16  SnoopLatency;
> 
> +  /**
> 
> +    NonSnoopLatency bit definition
> 
> +    Note: All Reserved bits must be set to 0
> 
> +
> 
> +    BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                  When clear values in bits 9:0 will be ignored
> 
> +    BITS[14:13] - Reserved
> 
> +    BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                  000b - 1 ns
> 
> +                  001b - 32 ns
> 
> +                  010b - 1024 ns
> 
> +                  011b - 32,768 ns
> 
> +                  100b - 1,048,576 ns
> 
> +                  101b - 33,554,432 ns
> 
> +                  110b - Reserved
> 
> +                  111b - Reserved
> 
> +    BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be
> multiplied with
> 
> +                  the scale in bits 12:10
> 
> +
> 
> +    This field takes effect only if bit 3 is set in OverrideConfig.
> 
> +  **/
> 
> +  UINT16  NonSnoopLatency;
> 
> +
> 
> +  /**
> 
> +    Forces LTR override to be permanent
> 
> +    The default way LTR override works is:
> 
> +      rootport uses LTR override values provided by BIOS until connected
> device sends an LTR message, then it will use values from the message
> 
> +    This settings allows force override of LTR mechanism. If it's enabled, then:
> 
> +      rootport will use LTR override values provided by BIOS forever; LTR
> messages sent from connected device will be ignored
> 
> +  **/
> 
> +  UINT8  ForceLtrOverride;
> 
> +  UINT8  Reserved[3];
> 
> +} PCH_PCIE_DEVICE_OVERRIDE;
> 
> +
> 
> +///
> 
> +/// The values before AutoConfig match the setting of PCI Express Base
> Specification 1.1, please be careful for adding new feature
> 
> +///
> 
> +typedef enum {
> 
> +  PchPcieAspmDisabled,
> 
> +  PchPcieAspmL0s,
> 
> +  PchPcieAspmL1,
> 
> +  PchPcieAspmL0sL1,
> 
> +  PchPcieAspmAutoConfig,
> 
> +  PchPcieAspmMax
> 
> +} PCH_PCIE_ASPM_CONTROL;
> 
> +
> 
> +/**
> 
> +  Refer to PCH EDS for the PCH implementation values corresponding
> 
> +  to below PCI-E spec defined ranges
> 
> +**/
> 
> +typedef enum {
> 
> +  PchPcieL1SubstatesDisabled,
> 
> +  PchPcieL1SubstatesL1_1,
> 
> +  PchPcieL1SubstatesL1_1_2,
> 
> +  PchPcieL1SubstatesMax
> 
> +} PCH_PCIE_L1SUBSTATES_CONTROL;
> 
> +
> 
> +enum PCH_PCIE_MAX_PAYLOAD {
> 
> +  PchPcieMaxPayload128 = 0,
> 
> +  PchPcieMaxPayload256,
> 
> +  PchPcieMaxPayloadMax
> 
> +};
> 
> +
> 
> +typedef enum {
> 
> +  PcieLinkHardwareEq = 0,  ///< Hardware is responsible for performing
> coefficient/preset search.
> 
> +  PcieLinkFixedEq          ///< No coefficient/preset search is performed. Fixed
> values are used.
> 
> +} PCIE_LINK_EQ_METHOD;
> 
> +
> 
> +typedef enum {
> 
> +  PcieLinkEqPresetMode = 0,   ///< Use presets during PCIe link equalization
> 
> +  PcieLinkEqCoefficientMode   ///< Use coefficients during PCIe link
> equalization
> 
> +} PCIE_LINK_EQ_MODE;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  PreCursor;    ///< Pre-cursor coefficient
> 
> +  UINT32  PostCursor;   ///< Post-cursor coefficient
> 
> +} PCIE_LINK_EQ_COEFFICIENTS;
> 
> +
> 
> +/**
> 
> +  PCIe Link EQ Platform Settings
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8                      PcieLinkEqMethod;               ///< Tells BIOS which link EQ
> method should be used for this port. Please refer to
> PCIE_LINK_EQ_METHOD for details of supported methods. Default:
> PcieLinkHardwareEq
> 
> +  UINT8                      PcieLinkEqMode;                 ///< Tells BIOS which mode
> should be used for PCIe link EQ. Please refer to PCIE_LINK_EQ_MODE for
> details of supported modes. Default: depends on SoC
> 
> +  /**
> 
> +    Specifies if BIOS should perform local transmitter override during phase 2
> of EQ process.
> 
> +    If enabled value in Ph2LocalTransmitterOverridePreset must be valid.
> 
> +    <b>0: Disabled</b>; 1: Enabled
> 
> +  **/
> 
> +  UINT8                      LocalTransmitterOverrideEnable;
> 
> +  /**
> 
> +    Tells BIOS how many presets/coefficients should be used during link EQ.
> 
> +    Entries in the Ph3CoefficientsList or Ph3PresetList(depending on chosen
> mode) need to be valid up to the number specified in this field.
> 
> +  **/
> 
> +  UINT8                      Ph3NumberOfPresetsOrCoefficients;
> 
> +
> 
> +  PCIE_LINK_EQ_COEFFICIENTS
> Ph3CoefficientsList[PCIE_LINK_EQ_COEFFICIENTS_MAX];  ///< List of the
> PCIe coefficients to be used during equalization process. Only valid if
> PcieLinkEqMode is PcieLinkEqCoefficientMode
> 
> +  UINT32                     Ph3PresetList[PCIE_LINK_EQ_PRESETS_MAX];             ///<
> List of the PCIe preset values to be used during equalization process. Only
> valid if PcieLinkEqMode is PcieLinkEqPresetMode
> 
> +  UINT32                     Ph1DownstreamPortTransmitterPreset;  ///< Specifies
> the value of the downstream port transmitter preset to be used during
> phase 1 of the equalization process. Will be applied to all lanes
> 
> +  UINT32                     Ph1UpstreamPortTransmitterPreset;    ///< Specifies the
> value of the upstream port transmitter preset to be used during phase 1 of
> the equalization process. Will be applied to all lanes
> 
> +  /**
> 
> +    Specifies the preset that should be used during local transmitter override
> during phase 2 of EQ process.
> 
> +    Used only if LocalTransmitterOverrideEnable is TRUE. Will be applied to all
> PCIe lanes of the root port.
> 
> +    Valid up to the PCIE_LINK_EQ_PRESET_MAX value. <b>Default: 0<\b>
> 
> +  **/
> 
> +  UINT32                     Ph2LocalTransmitterOverridePreset;
> 
> +} PCIE_LINK_EQ_PLATFORM_SETTINGS;
> 
> +
> 
> +#define PCH_PCIE_NO_SUCH_CLOCK 0xFF
> 
> +
> 
> +typedef enum {
> 
> +  PchClockUsagePchPcie0      = 0,
> 
> +  PchClockUsagePchPcie1      = 1,
> 
> +  PchClockUsagePchPcie2      = 2,
> 
> +  PchClockUsagePchPcie3      = 3,
> 
> +  PchClockUsagePchPcie4      = 4,
> 
> +  PchClockUsagePchPcie5      = 5,
> 
> +  PchClockUsagePchPcie6      = 6,
> 
> +  PchClockUsagePchPcie7      = 7,
> 
> +  PchClockUsagePchPcie8      = 8,
> 
> +  PchClockUsagePchPcie9      = 9,
> 
> +  PchClockUsagePchPcie10     = 10,
> 
> +  PchClockUsagePchPcie11     = 11,
> 
> +  PchClockUsagePchPcie12     = 12,
> 
> +  PchClockUsagePchPcie13     = 13,
> 
> +  PchClockUsagePchPcie14     = 14,
> 
> +  PchClockUsagePchPcie15     = 15,
> 
> +  PchClockUsagePchPcie16     = 16,
> 
> +  PchClockUsagePchPcie17     = 17,
> 
> +  PchClockUsagePchPcie18     = 18,
> 
> +  PchClockUsagePchPcie19     = 19,
> 
> +  PchClockUsagePchPcie20     = 20,
> 
> +  PchClockUsagePchPcie21     = 21,
> 
> +  PchClockUsagePchPcie22     = 22,
> 
> +  PchClockUsagePchPcie23     = 23,
> 
> +  /**
> 
> +    Quantity of PCH and CPU PCIe ports, as well as their encoding in this
> enum, may change between
> 
> +    silicon generations and series. Do not assume that PCH port 0 will be
> always encoded by 0.
> 
> +    Instead, it is recommended to use (PchClockUsagePchPcie0 +
> PchPortIndex) style to be forward-compatible
> 
> +  **/
> 
> +  PchClockUsageCpuPcie0      = 0x40,
> 
> +  PchClockUsageCpuPcie1      = 0x41,
> 
> +  PchClockUsageCpuPcie2      = 0x42,
> 
> +  PchClockUsageCpuPcie3      = 0x43,
> 
> +
> 
> +  PchClockUsageLan           = 0x70,
> 
> +  PchClockUsageUnspecified   = 0x80, ///< In use for a purpose not listed
> above
> 
> +  PchClockUsageNotUsed       = 0xFF
> 
> +} PCH_PCIE_CLOCK_USAGE;
> 
> +
> 
> +/**
> 
> +  PCH_PCIE_CLOCK describes PCIe source clock generated by PCH.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8   Usage;        ///< Purpose of given clock (see
> PCH_PCIE_CLOCK_USAGE). Default: Unused, 0xFF
> 
> +  UINT8   ClkReq;       ///< ClkSrc - ClkReq mapping. Default: 1:1 mapping with
> Clock numbers
> 
> +  UINT8   RsvdBytes[2]; ///< Reserved byte
> 
> +} PCH_PCIE_CLOCK;
> 
> +
> 
> +/**
> 
> +  The PCH_PCI_EXPRESS_ROOT_PORT_CONFIG describe the feature and
> capability of each PCH PCIe root port.
> 
> +**/
> 
> +typedef struct {
> 
> +  PCIE_ROOT_PORT_COMMON_CONFIG  PcieRpCommonConfig; ///an
> instance of Pcie Common Config
> 
> +  UINT8  ExtSync;              ///< Indicate whether the extended synch is
> enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  //
> 
> +  // Error handlings
> 
> +  //
> 
> +  UINT8  SystemErrorEnable;    ///< Indicate whether the System Error is
> enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  /**
> 
> +    The Multiple VC (MVC) supports hardware to avoid HoQ block for latency
> sensitive TC.
> 
> +    Currently it is only applicable to Root Ports with 2pX4 port configuration
> with 2 VCs,or
> 
> +    DMI port configuration with 3 VCs. For Root Ports 2pX4 configuration, two
> RPs (RP0,
> 
> +    RP2) shall support two PCIe VCs (VC0 & VC1) and the other RPs (RP1, RP3)
> shall be
> 
> +    disabled.
> 
> +    <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT8  MvcEnabled;
> 
> +  /**
> 
> +    Virtual Pin Port is industry standard introduced to PCIe Hot Plug support in
> systems
> 
> +    when GPIO pins expansion is needed. It is server specific feature.
> 
> +    <b>0x00: Default</b>; 0xFF: Disabled
> 
> +  **/
> 
> +  UINT8   VppPort;
> 
> +  UINT8   VppAddress;                               ///< PCIe Hot Plug VPP SMBus
> Address. Default is zero.
> 
> +  UINT8   RsvdBytes0[3];                            ///< Reserved bytes
> 
> +} PCH_PCIE_ROOT_PORT_CONFIG;
> 
> +
> 
> +/**
> 
> +  The PCH_PCIE_CONFIG block describes the expected configuration of the
> PCH PCI Express controllers
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  ///
> 
> +  /// These members describe the configuration of each PCH PCIe root port.
> 
> +  ///
> 
> +  PCIE_COMMON_CONFIG                PcieCommonConfig;
> 
> +  PCH_PCIE_ROOT_PORT_CONFIG
> RootPort[PCH_MAX_PCIE_ROOT_PORTS];
> 
> +  PCIE_LINK_EQ_PLATFORM_SETTINGS    PcieLinkEqPlatformSettings;  ///<
> Global PCIe link EQ settings that BIOS will use during PCIe link EQ for every
> port.
> 
> +  ///
> 
> +  /// <b>0: Use project default equalization settings</b>; 1: Use
> equalization settings from PcieLinkEqPlatformSettings
> 
> +  ///
> 
> +  UINT8  OverrideEqualizationDefaults;
> 
> +  ///
> 
> +  /// <b>(Test)</b> This member describes whether PCIE root port Port 8xh
> Decode is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  ///
> 
> +  UINT8  EnablePort8xhDecode;
> 
> +  ///
> 
> +  /// <b>(Test)</b> The Index of PCIe Port that is selected for Port8xh
> Decode (0 Based)
> 
> +  ///
> 
> +  UINT8  PchPciePort8xhDecodePortIndex;
> 
> +  UINT8  RsvdBytes0[1];
> 
> +} PCH_PCIE_CONFIG;
> 
> +
> 
> +/**
> 
> +  The PCH_PCIE_RP_PREMEM_CONFIG block describes early configuration
> of the PCH PCI Express controllers
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                                ///< Config Block
> Header
> 
> +  /**
> 
> +    Root Port enabling mask.
> 
> +    Bit0 presents RP1, Bit1 presents RP2, and so on.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                RpEnabledMask;
> 
> +  /// Configuration of PCIe source clocks
> 
> +  ///
> 
> +  PCH_PCIE_CLOCK        PcieClock[PCH_MAX_PCIE_CLOCKS];
> 
> +
> 
> +  /**
> 
> +    Per Controller Bifurcation Configuration
> 
> +    <b>0: Disabled</b>; 1: 4x1; 2: 1x2_2x1; 3: 2x2; 4: 1x4; 5: 4x2; 6: 1x4_2x2; 7:
> 2x2_1x4; 8: 2x4; 9: 1x8 (see: PCIE_BIFURCATION_CONFIG)
> 
> +  **/
> 
> +  UINT8                 Bifurcation[PCH_MAX_PCIE_CONTROLLERS];
> 
> +  UINT8                 Rsvd4[(4 - PCH_MAX_PCIE_CONTROLLERS % 4) % 4];
> 
> +} PCH_PCIE_RP_PREMEM_CONFIG;
> 
> +
> 
> +/**
> 
> +  The PCIE_RP_DXE_CONFIG block describes the expected configuration of
> the PCH PCI Express controllers in DXE phase
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Init version
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER      Header;                     ///< Config Block Header
> 
> +
> 
> +  /**
> 
> +    PCIe device override table
> 
> +    The PCIe device table is being used to override PCIe device ASPM
> settings.
> 
> +    And it's only used in DXE phase.
> 
> +    Please refer to PCH_PCIE_DEVICE_OVERRIDE structure for the table.
> 
> +    Last entry VendorId must be 0.
> 
> +  **/
> 
> +  PCH_PCIE_DEVICE_OVERRIDE    *PcieDeviceOverrideTablePtr;
> 
> +} PCIE_RP_DXE_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PCH_PCIERP_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
> new file mode 100644
> index 0000000000..f5859f50d9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/PcieRp/PcieConfig.h
> @@ -0,0 +1,213 @@
> +/** @file
> 
> +  PCIe Config Block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCIE_CONFIG_H_
> 
> +#define _PCIE_CONFIG_H_
> 
> +#include <CpuPcieInfo.h>
> 
> +
> 
> +#define PCIE_CONFIG_REVISION  3
> 
> +/*
> 
> +<b>Revision 2< / b>:
> 
> +FomsCp - Deprecated
> 
> +<b>Revision 3< / b>:
> 
> +Added PCIE_EQ_PARAM  HwEqGen3CoeffList for all
> CPU_PCIE_MAX_ROOT_PORTS
> 
> +Added PCIE_EQ_PARAM  HwEqGen4CoeffList for all
> CPU_PCIE_MAX_ROOT_PORTS
> 
> +Added PCIE_EQ_PARAM  HwEqGen5CoeffList for all
> CPU_PCIE_MAX_ROOT_PORTS
> 
> +*/
> 
> +
> 
> +extern EFI_GUID gPcieConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +enum PCIE_COMPLETION_TIMEOUT {
> 
> +  PcieCompletionTO_Default,
> 
> +  PcieCompletionTO_50_100us,
> 
> +  PcieCompletionTO_1_10ms,
> 
> +  PcieCompletionTO_16_55ms,
> 
> +  PcieCompletionTO_65_210ms,
> 
> +  PcieCompletionTO_260_900ms,
> 
> +  PcieCompletionTO_1_3P5s,
> 
> +  PcieCompletionTO_4_13s,
> 
> +  PcieCompletionTO_17_64s,
> 
> +  PcieCompletionTO_Disabled
> 
> +};
> 
> +
> 
> +enum PCIE_SPEED {
> 
> +  PcieAuto,
> 
> +  PcieGen1,
> 
> +  PcieGen2,
> 
> +  PcieGen3,
> 
> +  PcieGen4
> 
> +};
> 
> +
> 
> +/**
> 
> +  Represent lane specific PCIe Gen3 equalization parameters.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8   Cm;                 ///< Coefficient C-1
> 
> +  UINT8   Cp;                 ///< Coefficient C+1
> 
> +  UINT8   Rsvd0[2];           ///< Reserved bytes
> 
> +} PCIE_EQ_PARAM;
> 
> +
> 
> +typedef struct {
> 
> +  UINT16  LtrMaxSnoopLatency;                     ///< <b>(Test)</b> Latency
> Tolerance Reporting, Max Snoop Latency.
> 
> +  UINT16  LtrMaxNoSnoopLatency;                   ///< <b>(Test)</b> Latency
> Tolerance Reporting, Max Non-Snoop Latency.
> 
> +  UINT8   SnoopLatencyOverrideMode;               ///< <b>(Test)</b> Latency
> Tolerance Reporting, Snoop Latency Override Mode.
> 
> +  UINT8   SnoopLatencyOverrideMultiplier;         ///< <b>(Test)</b> Latency
> Tolerance Reporting, Snoop Latency Override Multiplier.
> 
> +  UINT16  SnoopLatencyOverrideValue;              ///< <b>(Test)</b> Latency
> Tolerance Reporting, Snoop Latency Override Value.
> 
> +  UINT8   NonSnoopLatencyOverrideMode;            ///< <b>(Test)</b>
> Latency Tolerance Reporting, Non-Snoop Latency Override Mode.
> 
> +  UINT8   NonSnoopLatencyOverrideMultiplier;      ///< <b>(Test)</b>
> Latency Tolerance Reporting, Non-Snoop Latency Override Multiplier.
> 
> +  UINT16  NonSnoopLatencyOverrideValue;           ///< <b>(Test)</b>
> Latency Tolerance Reporting, Non-Snoop Latency Override Value.
> 
> +  UINT8   LtrConfigLock;                          ///< <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   ForceLtrOverride;
> 
> +  UINT16  RsvdByte1;
> 
> +} PCIE_LTR_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  Specifies the form factor that the slot
> 
> +  implements. For custom form factors that
> 
> +  do not require any special handling please
> 
> +  set PcieFormFactorOther.
> 
> +**/
> 
> +typedef enum {
> 
> +  PcieFormFactorOther = 0,
> 
> +  PcieFormFactorCem,
> 
> +  PcieFormFactorMiniPci,
> 
> +  PcieFormFactorM2,
> 
> +  PcieFormFactorOcuLink,
> 
> +  PcieFormFactorExpressModule, // Also known as Server IO module(SIOM)
> 
> +  PcieFormFactorExpressCard,
> 
> +  PcieFormFactorU2 // Also known as SF-8639
> 
> +} PCIE_FORM_FACTOR;
> 
> +
> 
> +//Note: This structure will be expanded to hold all common PCIe policies
> between SA and PCH RootPort
> 
> +typedef struct {
> 
> +  UINT32  HotPlug                         :  1;   ///< Indicate whether the root port is hot
> plug available. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  PmSci                           :  1;   ///< Indicate whether the root port
> power manager SCI is enabled. 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32  TransmitterHalfSwing            :  1;   ///< Indicate whether the
> Transmitter Half Swing is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  AcsEnabled                      :  1;   ///< Indicate whether the ACS is
> enabled. 0: Disable; <b>1: Enable</b>.
> 
> +  //
> 
> +  // Error handlings
> 
> +  //
> 
> +  UINT32  AdvancedErrorReporting          :  1;   ///< Indicate whether the
> Advanced Error Reporting is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  UnsupportedRequestReport        :  1;   ///< Indicate whether the
> Unsupported Request Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  FatalErrorReport                :  1;   ///< Indicate whether the Fatal Error
> Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  NoFatalErrorReport              :  1;   ///< Indicate whether the No Fatal
> Error Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  CorrectableErrorReport          :  1;   ///< Indicate whether the
> Correctable Error Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  SystemErrorOnFatalError         :  1;   ///< Indicate whether the
> System Error on Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  SystemErrorOnNonFatalError      :  1;   ///< Indicate whether the
> System Error on Non Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  SystemErrorOnCorrectableError   :  1;   ///< Indicate whether the
> System Error on Correctable Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  /**
> 
> +    Max Payload Size supported, Default <b>128B</b>, see enum
> CPU_PCIE_MAX_PAYLOAD
> 
> +    Changes Max Payload Size Supported field in Device Capabilities of the
> root port.
> 
> +  **/
> 
> +  UINT32  MaxPayload                      :  2;
> 
> +  UINT32  DpcEnabled                      :  1;   ///< Downstream Port Containment.
> 0: Disable; <b>1: Enable</b>
> 
> +  UINT32  RpDpcExtensionsEnabled          :  1;   ///< RP Extensions for
> Downstream Port Containment. 0: Disable; <b>1: Enable</b>
> 
> +  /**
> 
> +    Indicates how this root port is connected to endpoint. 0: built-in device;
> <b>1: slot</b>
> 
> +    Built-in is incompatible with hotplug-capable ports.
> 
> +  **/
> 
> +  UINT32  SlotImplemented                 :  1;
> 
> +  UINT32  PtmEnabled                      :  1;   ///< Enables PTM capability
> 
> +  UINT32  SlotPowerLimitScale             :  2;   ///< <b>(Test)</b> Specifies scale
> used for slot power limit value. Leave as 0 to set to default. Default is
> <b>zero</b>.
> 
> +  UINT32  SlotPowerLimitValue             : 12;   //< <b>(Test)</b> Specifies
> upper limit on power supplies by slot. Leave as 0 to set to default. Default is
> <b>zero</b>.
> 
> +  /**
> 
> +    Probe CLKREQ# signal before enabling CLKREQ# based power
> management.
> 
> +    Conforming device shall hold CLKREQ# low until CPM is enabled. This
> feature attempts
> 
> +    to verify CLKREQ# signal is connected by testing pad state before enabling
> CPM.
> 
> +    In particular this helps to avoid issues with open-ended PCIe slots.
> 
> +    This is only applicable to non hot-plug ports.
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32  ClkReqDetect                    :  1;
> 
> +  /**
> 
> +    Set if the slot supports manually operated retention latch.
> 
> +  **/
> 
> +  UINT32  MrlSensorPresent                :  1;
> 
> +  UINT32  RelaxedOrder                    :  1;
> 
> +  UINT32  NoSnoop                         :  1;
> 
> +  UINT32  RsvdBits0                       : 28;   ///< Reserved bits.
> 
> +  /**
> 
> +    PCIe Gen3 Equalization Phase 3 Method (see CPU_PCIE_EQ_METHOD).
> 
> +    0: DEPRECATED, hardware equalization; <b>1: hardware
> equalization</b>; 4: Fixed Coefficients
> 
> +  **/
> 
> +  UINT8   Gen3EqPh3Method;
> 
> +  UINT8   PhysicalSlotNumber;                     ///< Indicates the slot number for
> the root port. Default is the value as root port index.
> 
> +  UINT8   CompletionTimeout;                      ///< The completion timeout
> configuration of the root port (see: CPU_PCIE_COMPLETION_TIMEOUT).
> Default is <b>PchPcieCompletionTO_Default</b>.
> 
> +  //
> 
> +  // Power Management
> 
> +  //
> 
> +  UINT8   Aspm;                                   ///< The ASPM configuration of the root
> port (see: CPU_PCIE_ASPM_CONTROL). Default is
> <b>PchPcieAspmAutoConfig</b>.
> 
> +  UINT8   L1Substates;                            ///< The L1 Substates configuration of
> the root port (see: CPU_PCIE_L1SUBSTATES_CONTROL). Default is
> <b>PchPcieL1SubstatesL1_1_2</b>.
> 
> +  UINT8   LtrEnable;                              ///< Latency Tolerance Reporting
> Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   EnableCpm;                              ///< Enables Clock Power Management;
> even if disabled, CLKREQ# signal can still be controlled by L1 PM substates
> mechanism
> 
> +  UINT8   PcieSpeed;                              ///< Contains speed of PCIe bus (see:
> PCIE_SPEED)
> 
> +  /**
> 
> +  <b>(Test)</b>
> 
> +  Forces LTR override to be permanent
> 
> +  The default way LTR override works is:
> 
> +  rootport uses LTR override values provided by BIOS until connected device
> sends an LTR message, then it will use values from the message
> 
> +  This settings allows force override of LTR mechanism. If it's enabled, then:
> 
> +  rootport will use LTR override values provided by BIOS forever; LTR
> messages sent from connected device will be ignored
> 
> +  **/
> 
> +  PCIE_LTR_CONFIG               PcieRpLtrConfig;            ///< <b>(Test)</b>
> Latency Tolerance Reporting Policies including LTR limit and Override
> 
> +    /**
> 
> +    The number of milliseconds reference code will wait for link to exit Detect
> state for enabled ports
> 
> +    before assuming there is no device and potentially disabling the port.
> 
> +    It's assumed that the link will exit detect state before root port
> initialization (sufficient time
> 
> +    elapsed since PLTRST de-assertion) therefore default timeout is zero.
> However this might be useful
> 
> +    if device power-up seqence is controlled by BIOS or a specific device
> requires more time to detect.
> 
> +    In case of non-common clock enabled the default timout is 15ms.
> 
> +    <b>Default: 0</b>
> 
> +  **/
> 
> +  UINT16  DetectTimeoutMs;
> 
> +  UINT8   FormFactor; // Please check PCIE_FORM_FACTOR for supported
> values
> 
> +  UINT8   Reserved;
> 
> +} PCIE_ROOT_PORT_COMMON_CONFIG;
> 
> +
> 
> +/**
> 
> +  PCIe Common Config
> 
> +  @note This structure will be expanded to hold all common PCIe policies
> between SA and PCH
> 
> +**/
> 
> +typedef struct {
> 
> +  ///
> 
> +  /// This member describes whether Peer Memory Writes are enabled on
> the platform. <b>0: Disable</b>; 1: Enable.
> 
> +  ///
> 
> +  UINT32  EnablePeerMemoryWrite          :  1;
> 
> +  /**
> 
> +    RpFunctionSwap allows BIOS to use root port function number swapping
> when root port of function 0 is disabled.
> 
> +    A PCIE device can have higher functions only when Function0 exists. To
> satisfy this requirement,
> 
> +    BIOS will always enable Function0 of a device that contains more than 0
> enabled root ports.
> 
> +    - <b>Enabled: One of enabled root ports get assigned to Function0.</b>
> 
> +      This offers no guarantee that any particular root port will be available at a
> specific DevNr:FuncNr location
> 
> +    - Disabled: Root port that corresponds to Function0 will be kept visible
> even though it might be not used.
> 
> +      That way rootport - to - DevNr:FuncNr assignment is constant. This
> option will impact ports 1, 9, 17.
> 
> +      NOTE: This option will not work if ports 1, 9, 17 are fused or configured
> for RST PCIe storage or disabled through policy
> 
> +            In other words, it only affects ports that would become hidden
> because they have no device connected.
> 
> +      NOTE: Disabling function swap may have adverse impact on power
> management. This option should ONLY
> 
> +            be used when each one of root ports 1, 9, 17:
> 
> +        - is configured as PCIe and has correctly configured ClkReq signal, or
> 
> +        - does not own any mPhy lanes (they are configured as SATA or USB)
> 
> +  **/
> 
> +  UINT32  RpFunctionSwap                   :  1;
> 
> +  /**
> 
> +    Compliance Test Mode shall be enabled when using Compliance Load
> Board.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  **/
> 
> +  UINT32  ComplianceTestMode               :  1;
> 
> +  UINT32  RsvdBits0                        : 29;   ///< Reserved bits
> 
> +  ///
> 
> +  /// List of coefficients used during equalization (applicable to both
> software and hardware EQ)
> 
> +  /// Deprecated Policy
> 
> +  ///
> 
> +  PCIE_EQ_PARAM
> HwEqGen3CoeffList[PCIE_HWEQ_COEFFS_MAX];
> 
> +} PCIE_COMMON_CONFIG;
> 
> +
> 
> +
> 
> +#pragma pack (pop)
> 
> +#endif // _PCIE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
> new file mode 100644
> index 0000000000..5c7811823d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/AdrConfig.h
> @@ -0,0 +1,86 @@
> +/** @file
> 
> +  ADR policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _ADR_CONFIG_H_
> 
> +#define _ADR_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define ADR_CONFIG_REVISION 1
> 
> +extern EFI_GUID gAdrConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +typedef enum {
> 
> +  AdrScale1us,
> 
> +  AdrScale10us,
> 
> +  AdrScale100us,
> 
> +  AdrScale1ms,
> 
> +  AdrScale10ms,
> 
> +  AdrScale100ms,
> 
> +  AdrScale1s,
> 
> +  AdrScale10s
> 
> +} ADR_TIMER_SCALE;
> 
> +
> 
> +/**
> 
> +  ADR Source Enable
> 
> +**/
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32 Reserved1           : 1;
> 
> +    UINT32 AdrSrcPbo           : 1;
> 
> +    UINT32 AdrSrcPmcUncErr     : 1;
> 
> +    UINT32 AdrSrcPchThrm       : 1;
> 
> +    UINT32 AdrSrcMePbo         : 1;
> 
> +    UINT32 AdrSrcCpuThrm       : 1;
> 
> +    UINT32 AdrSrcMegbl         : 1;
> 
> +    UINT32 AdrSrcLtReset       : 1;
> 
> +    UINT32 AdrSrcPmcWdt        : 1;
> 
> +    UINT32 AdrSrcMeWdt         : 1;
> 
> +    UINT32 AdrSrcPmcFw         : 1;
> 
> +    UINT32 AdrSrcPchpwrFlr     : 1;
> 
> +    UINT32 AdrSrcSyspwrFlr     : 1;
> 
> +    UINT32 Reserved2           : 1;
> 
> +    UINT32 AdrSrcMiaUxsErr     : 1;
> 
> +    UINT32 AdrSrcMiaUxErr      : 1;
> 
> +    UINT32 AdrSrcCpuThrmWdt    : 1;
> 
> +    UINT32 AdrSrcMeUncErr      : 1;
> 
> +    UINT32 AdrSrcAdrGpio       : 1;
> 
> +    UINT32 AdrSrcOcwdtNoicc    : 1;
> 
> +    UINT32 AdrSrcOcwdtIcc      : 1;
> 
> +    UINT32 AdrSrcCseHecUncErr  : 1;
> 
> +    UINT32 AdrSrcPmcSramUncErr : 1;
> 
> +    UINT32 AdrSrcPmcIromParity : 1;
> 
> +    UINT32 AdrSrcPmcRfFusaErr  : 1;
> 
> +    UINT32 Reserved3           : 4;
> 
> +    UINT32 AdrSrcPpbrParityErr : 1;
> 
> +    UINT32 Reserved4           : 2;
> 
> +  } Field;
> 
> +  UINT32 Value;
> 
> +} ADR_SOURCE_ENABLE;
> 
> +
> 
> +/**
> 
> +  ADR Configuration
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  UINT32        AdrEn                  : 2; ///< Determine if Adr is enabled - 0:
> PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
> 
> +  UINT32        AdrTimerEn             : 2; ///< Determine if Adr timer options are
> enabled - 0: PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
> 
> +  UINT32        AdrTimer1Val           : 2; ///< Determines the Timeout value used
> for the ADR timer 1. A value of zero bypasses the timer
> 
> +  UINT32        AdrMultiplier1Val      : 8; ///< Specifies the tick frequency upon
> which the timer 1 will increment. ADR_TIMER_SCALE should be used to
> encode values
> 
> +  UINT32        AdrTimer2Val           : 8; ///< Determines the Timeout value used
> for the ADR timer 2. A value of zero bypasses the timer
> 
> +  UINT32        AdrMultiplier2Val      : 8; ///< Specifies the tick frequency upon
> which the timer 2 will increment. ADR_TIMER_SCALE should be used to
> encode values
> 
> +  UINT32        AdrHostPartitionReset  : 2; ///< Determine if Host Partition
> Reset is enabled - 0: PLATFORM_POR, 1: FORCE_ENABLE, 2: FORCE_DISABLE
> 
> +  UINT32        AdrSrcOverride         : 1; ///< Check if default ADR sources will be
> overriten with custom 0: Not overwritten, 1: Overwritten
> 
> +  UINT32        ReservedBits           : 31;
> 
> +  ADR_SOURCE_ENABLE   AdrSrcSel;            ///< Determine which ADR
> sources are enabled - 0: Enabled, 1: Disabled
> 
> +} ADR_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _ADR_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
> new file mode 100644
> index 0000000000..2f8e19b50b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Pmc/PmConfig.h
> @@ -0,0 +1,391 @@
> +/** @file
> 
> +  Power Management policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PM_CONFIG_H_
> 
> +#define _PM_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define PM_CONFIG_REVISION 2
> 
> +extern EFI_GUID gPmConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure allows to customize PCH wake up capability from S5 or
> DeepSx by WOL, LAN, PCIE wake events.
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    Corresponds to the PME_B0_S5_DIS bit in the General PM Configuration
> B (GEN_PMCON_B) register.
> 
> +    When set to 1, this bit blocks wake events from PME_B0_STS in S5,
> regardless of the state of PME_B0_EN.
> 
> +    When cleared (default), wake events from PME_B0_STS are allowed in S5
> if PME_B0_EN = 1. <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32  PmeB0S5Dis         :  1;
> 
> +  UINT32  WolEnableOverride  :  1;      ///< Corresponds to the "WOL Enable
> Override" bit in the General PM Configuration B (GEN_PMCON_B) register.
> 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32  PcieWakeFromDeepSx :  1;      ///< Determine if enable PCIe to
> wake from deep Sx. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  WoWlanEnable       :  1;      ///< Determine if WLAN wake from Sx,
> corresponds to the "HOST_WLAN_PP_EN" bit in the PWRM_CFG3 register.
> <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  WoWlanDeepSxEnable :  1;      ///< Determine if WLAN wake from
> DeepSx, corresponds to the "DSX_WLAN_PP_EN" bit in the PWRM_CFG3
> register. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32  LanWakeFromDeepSx  :  1;      ///< Determine if enable LAN to
> wake from deep Sx. 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32  RsvdBits0          : 26;
> 
> +} PCH_WAKE_CONFIG;
> 
> +
> 
> +typedef enum {
> 
> +  PchDeepSxPolDisable,
> 
> +  PchDpS5BatteryEn,
> 
> +  PchDpS5AlwaysEn,
> 
> +  PchDpS4S5BatteryEn,
> 
> +  PchDpS4S5AlwaysEn,
> 
> +  PchDpS3S4S5BatteryEn,
> 
> +  PchDpS3S4S5AlwaysEn
> 
> +} PCH_DEEP_SX_CONFIG;
> 
> +
> 
> +typedef enum {
> 
> +  PchSlpS360us = 1,
> 
> +  PchSlpS31ms,
> 
> +  PchSlpS350ms,
> 
> +  PchSlpS32s
> 
> +} PCH_SLP_S3_MIN_ASSERT;
> 
> +
> 
> +typedef enum {
> 
> +  PchSlpS4PchTime,     ///< The time defined in PCH EDS Power Sequencing
> and Reset Signal Timings table
> 
> +  PchSlpS41s,
> 
> +  PchSlpS42s,
> 
> +  PchSlpS43s,
> 
> +  PchSlpS44s
> 
> +} PCH_SLP_S4_MIN_ASSERT;
> 
> +
> 
> +typedef enum {
> 
> +  PchSlpSus0ms = 1,
> 
> +  PchSlpSus500ms,
> 
> +  PchSlpSus1s,
> 
> +  PchSlpSus4s,
> 
> +} PCH_SLP_SUS_MIN_ASSERT;
> 
> +
> 
> +typedef enum {
> 
> +  PchSlpA0ms = 1,
> 
> +  PchSlpA4s,
> 
> +  PchSlpA98ms,
> 
> +  PchSlpA2s,
> 
> +} PCH_SLP_A_MIN_ASSERT;
> 
> +
> 
> +typedef enum {
> 
> +  S0ixDisQNoChange,
> 
> +  S0ixDisQDciOob,
> 
> +  S0ixDisQUsb2Dbc,
> 
> +  S0ixDisQMax,
> 
> +} S0IX_DISQ_PROBE_TYPE;
> 
> +
> 
> +/**
> 
> +  Low Power Mode Enable config.
> 
> +  Used to configure if respective S0i2/3 sub-states are to be supported
> 
> +  by the platform. Each bit corresponds to one LPM state - LPMx->BITx.
> 
> +  Some sub-states will require external FETs controlled by
> EXT_PWR_GATE#/EXT_PWR_GATE2# pins
> 
> +  to gate v1p05-PHY or v1p05-IS supplies
> 
> +**/
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32  S0i2p0En     : 1;        ///< LPM0 - S0i2.0 Enable
> 
> +    UINT32  S0i2p1En     : 1;        ///< LPM1 - S0i2.1 Enable
> 
> +    /**
> 
> +      LPM2 - S0i2.2 Enable.
> 
> +      Requires EXT_PWR_GATE# controlled FET to gate v1p05 PHY.
> 
> +      Refer to V1p05PhyExtFetControlEn.
> 
> +    **/
> 
> +    UINT32  S0i2p2En     : 1;
> 
> +    UINT32  S0i3p0En     : 1;        ///< LPM3 - S0i3.0 Enable
> 
> +    UINT32  S0i3p1En     : 1;        ///< LPM4 - S0i3.1 Enable
> 
> +    UINT32  S0i3p2En     : 1;        ///< LPM5 - S0i3.2 Enable
> 
> +    /**
> 
> +      LPM5 - S0i3.3 Enable.
> 
> +      Requires EXT_PWR_GATE# controlled FET to gate v1p05 PHY.
> 
> +      Refer to V1p05PhyExtFetControlEn.
> 
> +    **/
> 
> +    UINT32  S0i3p3En     : 1;
> 
> +    /**
> 
> +      LPM7 - S0i3.4 Enable.
> 
> +      Requires EXT_PWR_GATE2# controlled FET to gate v1p05-SRAM/ISCLK.
> 
> +      Refer to V1p05IsExtFetControlEn.
> 
> +    **/
> 
> +    UINT32  S0i3p4En     : 1;
> 
> +    UINT32  Reserved     : 24;       ///< Reserved
> 
> +  } Field;
> 
> +  UINT32  Val;
> 
> +} PMC_LPM_S0IX_SUB_STATE_EN;
> 
> +
> 
> +/**
> 
> +  Description of Global Reset Trigger/Event Mask register
> 
> +**/
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32 Reserved1     : 1;
> 
> +    UINT32 Pbo           : 1;
> 
> +    UINT32 PmcUncErr     : 1;
> 
> +    UINT32 PchThrm       : 1;
> 
> +    UINT32 MePbo         : 1;
> 
> +    UINT32 CpuThrm       : 1;
> 
> +    UINT32 Megbl         : 1;
> 
> +    UINT32 LtReset       : 1;
> 
> +    UINT32 PmcWdt        : 1;
> 
> +    UINT32 MeWdt         : 1;
> 
> +    UINT32 PmcFw         : 1;
> 
> +    UINT32 PchpwrFlr     : 1;
> 
> +    UINT32 SyspwrFlr     : 1;
> 
> +    UINT32 Reserved2     : 1;
> 
> +    UINT32 MiaUxsErr     : 1;
> 
> +    UINT32 MiaUxErr      : 1;
> 
> +    UINT32 CpuThrmWdt    : 1;
> 
> +    UINT32 MeUncErr      : 1;
> 
> +    UINT32 AdrGpio       : 1;
> 
> +    UINT32 OcwdtNoicc    : 1;
> 
> +    UINT32 OcwdtIcc      : 1;
> 
> +    UINT32 CseHecUncErr  : 1;
> 
> +    UINT32 PmcSramUncErr : 1;
> 
> +    UINT32 PmcIromParity : 1;
> 
> +    UINT32 PmcRfFusaErr  : 1;
> 
> +    UINT32 Reserved3     : 4;
> 
> +    UINT32 PpbrParityErr : 1;
> 
> +    UINT32 Reserved4     : 2;
> 
> +  } Field;
> 
> +  UINT32 Value;
> 
> +} PMC_GLOBAL_RESET_MASK;
> 
> +
> 
> +/**
> 
> +  The PCH_PM_CONFIG block describes expected miscellaneous power
> management settings.
> 
> +  The PowerResetStatusClear field would clear the Power/Reset status bits,
> please
> 
> +  set the bits if you want PCH Init driver to clear it, if you want to check the
> 
> +  status later then clear the bits.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>
> 
> +  - Added C10DynamicThresholdAdjustment
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER     Header;                           ///< Config Block Header
> 
> +
> 
> +  PCH_WAKE_CONFIG         WakeConfig;                       ///< Specify Wake Policy
> 
> +  UINT32                  PchDeepSxPol       :  4;          ///< Deep Sx Policy. Refer to
> PCH_DEEP_SX_CONFIG for each value. Default is
> <b>PchDeepSxPolDisable</b>.
> 
> +  UINT32                  PchSlpS3MinAssert  :  4;          ///< SLP_S3 Minimum
> Assertion Width Policy. Refer to PCH_SLP_S3_MIN_ASSERT for each value.
> Default is <b>PchSlpS350ms</b>.
> 
> +  UINT32                  PchSlpS4MinAssert  :  4;          ///< SLP_S4 Minimum
> Assertion Width Policy. Refer to PCH_SLP_S4_MIN_ASSERT for each value.
> Default is <b>PchSlpS44s</b>.
> 
> +  UINT32                  PchSlpSusMinAssert :  4;          ///< SLP_SUS Minimum
> Assertion Width Policy. Refer to PCH_SLP_SUS_MIN_ASSERT for each value.
> Default is <b>PchSlpSus4s</b>.
> 
> +  UINT32                  PchSlpAMinAssert   :  4;          ///< SLP_A Minimum
> Assertion Width Policy. Refer to PCH_SLP_A_MIN_ASSERT for each value.
> Default is <b>PchSlpA2s</b>.
> 
> +  UINT32                  RsvdBits0          : 12;
> 
> +  /**
> 
> +    This member describes whether or not the LPC ClockRun feature of PCH
> should
> 
> +    be enabled. <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32                  SlpStrchSusUp        :  1;        ///< <b>0: Disable</b>; 1:
> Enable SLP_X Stretching After SUS Well Power Up
> 
> +  /**
> 
> +    Enable/Disable SLP_LAN# Low on DC Power. 0: Disable; <b>1:
> Enable</b>.
> 
> +    Configure On DC PHY Power Diable according to policy SlpLanLowDc.
> 
> +    When this is enabled, SLP_LAN# will be driven low when ACPRESENT is
> low.
> 
> +    This indicates that LAN PHY should be powered off on battery mode.
> 
> +    This will override the DC_PP_DIS setting by WolEnableOverride.
> 
> +  **/
> 
> +  UINT32                  SlpLanLowDc          :  1;
> 
> +  /**
> 
> +    PCH power button override period.
> 
> +    000b-4s, 001b-6s, 010b-8s, 011b-10s, 100b-12s, 101b-14s
> 
> +    <b>Default is 0: 4s</b>
> 
> +  **/
> 
> +  UINT32                  PwrBtnOverridePeriod :  3;
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    Disable/Enable PCH to CPU enery report feature. <b>0: Disable</b>; 1:
> Enable.
> 
> +    Enery Report is must have feature. Wihtout Energy Report, the
> performance report
> 
> +    by workloads/benchmarks will be unrealistic because PCH's energy is not
> being accounted
> 
> +    in power/performance management algorithm.
> 
> +    If for some reason PCH energy report is too high, which forces CPU to try
> to reduce
> 
> +    its power by throttling, then it could try to disable Energy Report to do
> first debug.
> 
> +    This might be due to energy scaling factors are not correct or the LPM
> settings are not
> 
> +    kicking in.
> 
> +  **/
> 
> +  UINT32                  DisableEnergyReport  :  1;
> 
> +  /**
> 
> +    When set to Disable, PCH will internal pull down AC_PRESENT in deep SX
> and during G3 exit.
> 
> +    When set to Enable, PCH will not pull down AC_PRESENT.
> 
> +    This setting is ignored when DeepSx is not supported.
> 
> +    Default is <b>0:Disable</b>
> 
> +  **/
> 
> +  UINT32                  DisableDsxAcPresentPulldown  :  1;
> 
> +  /**
> 
> +    Power button native mode disable.
> 
> +    While FALSE, the PMC's power button logic will act upon the input value
> from the GPIO unit, as normal.
> 
> +    While TRUE, this will result in the PMC logic constantly seeing the power
> button as de-asserted.
> 
> +    <b>Default is FALSE.</b>
> 
> +  **/
> 
> +  UINT32                  DisableNativePowerButton     :  1;
> 
> +  UINT32                  MeWakeSts                    :  1;     ///< Clear the ME_WAKE_STS
> bit in the Power and Reset Status (PRSTS) register. 0: Disable; <b>1:
> Enable</b>.
> 
> +  UINT32                  WolOvrWkSts                  :  1;     ///< Clear the
> WOL_OVR_WK_STS bit in the Power and Reset Status (PRSTS) register. 0:
> Disable; <b>1: Enable</b>.
> 
> +  /*
> 
> +    Set true to enable TCO timer.
> 
> +    When FALSE, it disables PCH ACPI timer, and stops TCO timer.
> 
> +    @note: This will have significant power impact when it's enabled.
> 
> +    If TCO timer is disabled, uCode ACPI timer emulation must be enabled,
> 
> +    and WDAT table must not be exposed to the OS.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  */
> 
> +  UINT32                  EnableTcoTimer               : 1;
> 
> +  /*
> 
> +    When VRAlert# feature pin is enabled and its state is '0',
> 
> +    the PMC requests throttling to a T3 Tstate to the PCH throttling unit.
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  */
> 
> +  UINT32                  VrAlert                      : 1;
> 
> +  /**
> 
> +    Decide if PS_ON is to be enabled. This is available on desktop only.
> 
> +    PS_ON is a new C10 state from the CPU on desktop SKUs that enables a
> 
> +    lower power target that will be required by the California Energy
> 
> +    Commission (CEC). When FALSE, PS_ON is to be disabled.}
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32                  PsOnEnable                   :  1;
> 
> +  /**
> 
> +    Enable/Disable platform support for CPU_C10_GATE# pin to control
> gating
> 
> +    of CPU VccIO and VccSTG rails instead of SLP_S0# pin. This policy needs
> 
> +    to be set if board design includes support for CPU_C10_GATE# pin.
> 
> +    0: Disable; <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32                  CpuC10GatePinEnable          :  1;
> 
> +  /**
> 
> +    Control whether to enable PMC debug messages to Trace Hub.
> 
> +    When Enabled, PMC HW will send debug messages to trace hub;
> 
> +    When Disabled, PMC HW will never send debug meesages to trace hub.
> 
> +    @note: When enabled, system may not enter S0ix
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32                  PmcDbgMsgEn                  :  1;
> 
> +  /**
> 
> +    Enable/Disable ModPHY SUS Power Domain Dynamic Gating.
> 
> +    EXT_PWR_GATE# signal (if supported on platform) can be used to
> 
> +    control external FET for power gating ModPHY
> 
> +    @note: This setting is not supported and ignored on PCH-H
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                  ModPhySusPgEnable            :  1;
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    This policy option enables USB2 PHY SUS Well Power Gating functionality.
> 
> +    @note: This setting is not supported and ignored on PCH-H
> 
> +    0: disable USB2 PHY SUS Well Power Gating
> 
> +    <b>1: enable USB2 PHY SUS Well Power Gating</b>
> 
> +  **/
> 
> +  UINT32                  Usb2PhySusPgEnable           :  1;
> 
> +  /**
> 
> +    Enable Os Idle Mode.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                  OsIdleEnable                 :  1;
> 
> +  /**
> 
> +    Enable control using EXT_PWR_GATE# pin of external FET
> 
> +    to power gate v1p05-PHY
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32                  V1p05PhyExtFetControlEn      :  1;
> 
> +  /**
> 
> +    Enable control using EXT_PWR_GATE2# pin of external FET
> 
> +    to power gate v1p05-IS supply
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32                  V1p05IsExtFetControlEn       :  1;
> 
> +  /**
> 
> +    Enable/Disable the Low Power Mode Host S0ix Auto-Demotion
> 
> +    feature. This feature enables the PMC to autonomously manage
> 
> +    the deepest allowed S0ix substate to combat thrashing between
> 
> +    power management states.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                  S0ixAutoDemotion             :  1;
> 
> +  /**
> 
> +    Enable/Disable Latch Events C10 Exit. When this bit is set to 1,
> 
> +    SLP_S0# entry events in SLP_S0_DEBUG_REGx registers are captured
> 
> +    on C10 exit (instead of C10 entry which is default)
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32                  LatchEventsC10Exit           :  1;
> 
> +  UINT32                  RsvdBits1                    :  10;
> 
> +  /*
> 
> +    Power button debounce configuration
> 
> +    Debounce time can be specified in microseconds. Only certain values
> according
> 
> +    to below formula are supported:
> 
> +     DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(glitch filter clock
> period).
> 
> +    RTC clock with f = 32 KHz is used for glitch filter.
> 
> +     DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(31.25 us).
> 
> +    Supported DebounceTime values are following:
> 
> +     DebounceTime = 0 -> Debounce feature disabled
> 
> +     DebounceTime > 0 && < 250us -> Not supported
> 
> +     DebounceTime = 250us - 1024000us -> Supported range (DebounceTime
> = 250us * 2^n)
> 
> +    For values not supported by HW, they will be rounded down to closest
> supported one
> 
> +    <b>Default is 0</b>
> 
> +  */
> 
> +  UINT32                  PowerButtonDebounce;
> 
> +  /**
> 
> +    Reset Power Cycle Duration could be customized in the unit of second.
> Please refer to EDS
> 
> +    for all support settings. PCH HW default is 4 seconds, and range is 1~4
> seconds, where
> 
> +    <b>0 is default</b>, 1 is 1 second, 2 is 2 seconds, ... 4 is 4 seconds.
> 
> +    And make sure the setting correct, which never less than the following
> register.
> 
> +    - GEN_PMCON_B.SLP_S3_MIN_ASST_WDTH
> 
> +    - GEN_PMCON_B.SLP_S4_MIN_ASST_WDTH
> 
> +    - PWRM_CFG.SLP_A_MIN_ASST_WDTH
> 
> +    - PWRM_CFG.SLP_LAN_MIN_ASST_WDTH
> 
> +  **/
> 
> +  UINT8                   PchPwrCycDur;
> 
> +  /**
> 
> +    Specifies the Pcie Pll Spread Spectrum Percentage
> 
> +    The value of this policy is in 1/10th percent units.
> 
> +    Valid spread range is 0-20. A value of 0xFF is reserved for AUTO.
> 
> +    A value of 0 is SSC of 0.0%. A value of 20 is SSC of 2.0%
> 
> +    The default is <b>0xFF: AUTO - No BIOS override</b>.
> 
> +  **/
> 
> +  UINT8                   PciePllSsc;
> 
> +  /**
> 
> +    Tells BIOS to enable C10 dynamic threshold adjustment mode.
> 
> +    BIOS will only attemt to enable it on PCH SKUs which support it.
> 
> +  **/
> 
> +  UINT8                   C10DynamicThresholdAdjustment;
> 
> +  UINT8                   Rsvd0[1];                             ///< Reserved bytes
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    Low Power Mode Enable/Disable config.
> 
> +    Configure if respective S0i2/3 sub-states are to be supported
> 
> +    by the platform. By default all sub-states are enabled but
> 
> +    for test purpose respective states can be disabled.
> 
> +    <b>Default is 0xFF</b>
> 
> +  **/
> 
> +  PMC_LPM_S0IX_SUB_STATE_EN      LpmS0ixSubStateEnable;
> 
> +  /*
> 
> +    Set true to enable Timed GPIO 0 timer.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  */
> 
> +  UINT32                  EnableTimedGpio0             : 1;
> 
> +  /*
> 
> +    Set true to enable Timed GPIO 1 timer.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  */
> 
> +  UINT32                  EnableTimedGpio1             : 1;
> 
> +  UINT32                  Rsvdbits                     : 30;
> 
> +
> 
> +  /**
> 
> +    Set true to enable override of Global Reset Event/Trigger masks.
> 
> +    Values from GlobalResetTriggerMask and GlobalResetEventMask will
> 
> +    be used as override value.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  **/
> 
> +  UINT8                   GlobalResetMasksOverride;
> 
> +  UINT8                   Rsvd1[3];             ///< Reserved bytes
> 
> +  /*
> 
> +    Mask for enabling Global Reset Trigger prevention
> 
> +  */
> 
> +  PMC_GLOBAL_RESET_MASK   GlobalResetTriggerMask;
> 
> +  /*
> 
> +    Mask for enabling Global Reset Event prevention
> 
> +  */
> 
> +  PMC_GLOBAL_RESET_MASK   GlobalResetEventMask;
> 
> +} PCH_PM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
> new file mode 100644
> index 0000000000..033e416b83
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Psf/PsfConfig.h
> @@ -0,0 +1,32 @@
> +/** @file
> 
> +  Primary Sideband Fabric policy.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PSF_CONFIG_H_
> 
> +#define _PSF_CONFIG_H_
> 
> +
> 
> +#define PSF_CONFIG_REVISION 1
> 
> +extern EFI_GUID gPsfConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PSF_CONFIG block describes the expected configuration of the
> Primary
> 
> +  Sideband Fabric.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
> 
> +  /**
> 
> +    Psf Tcc (Time Coordinated Computing) Enable will decrease psf
> transaction latency by disable
> 
> +    some psf power management features. <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32    TccEnable                :  1;
> 
> +  UINT32    RsvdBits0                : 31;       ///< Reserved bits
> 
> +} PSF_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PSF_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
> new file mode 100644
> index 0000000000..469d46a205
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rst/RstConfig.h
> @@ -0,0 +1,82 @@
> +/** @file
> 
> +  Rst policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _RST_CONFIG_H_
> 
> +#define _RST_CONFIG_H_
> 
> +#include <PchLimits.h>
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define RST_CONFIG_REVISION 1
> 
> +extern EFI_GUID gRstConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +typedef enum {
> 
> +  SataOromDelay2sec,
> 
> +  SataOromDelay4sec,
> 
> +  SataOromDelay6sec,
> 
> +  SataOromDelay8sec
> 
> +} SATA_OROM_DELAY;
> 
> +
> 
> +/**
> 
> +  This structure describes the details of Intel RST for PCIe Storage remapping
> 
> +  Note: In order to use this feature, Intel RST Driver is required
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member describes whether or not the Intel RST for PCIe Storage
> remapping should be enabled. <b>0: Disable</b>; 1: Enable.
> 
> +    Note 1: If Sata Controller is disabled, PCIe Storage Remapping should be
> disabled as well
> 
> +    Note 2: If PCIe Storage remapping is enabled, the PCH integrated AHCI
> controllers Class Code is configured as RAID
> 
> +  **/
> 
> +  UINT32   Enable                 :  1;
> 
> +  /**
> 
> +    Intel RST for PCIe Storage remapping - PCIe Port Selection (1-based, <b>0
> = autodetect</b>)
> 
> +    The supported ports for PCIe Storage remapping is different depend on
> the platform and cycle router
> 
> +  **/
> 
> +  UINT32   RstPcieStoragePort     :  5;
> 
> +  /**
> 
> +    PCIe Storage Device Reset Delay in milliseconds (ms), which it guarantees
> such delay gap is fulfilled
> 
> +    before PCIe Storage Device configuration space is accessed after an reset
> caused by the link disable and enable step.
> 
> +    Default value is <b>100ms</b>.
> 
> +  **/
> 
> +  UINT32   DeviceResetDelay       :  8;
> 
> +  UINT32   RsvdBits0              : 18; ///< Reserved bits
> 
> +
> 
> +} RST_HARDWARE_REMAPPED_STORAGE_CONFIG;
> 
> +
> 
> +/**
> 
> +  Rapid Storage Technology settings.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                             ///< Config Block Header
> 
> +
> 
> +  UINT32  Raid0              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID0
> 
> +  UINT32  Raid1              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID1
> 
> +  UINT32  Raid10             :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID10
> 
> +  UINT32  Raid5              :  1;         ///< 0  : Disable; <b>1  : Enable</b> RAID5
> 
> +  UINT32  Irrt               :  1;         ///< 0  : Disable; <b>1  : Enable</b> Intel Rapid
> Recovery Technology
> 
> +  UINT32  OromUiBanner       :  1;         ///< 0  : Disable; <b>1  : Enable</b>
> OROM UI and BANNER
> 
> +  UINT32  OromUiDelay        :  2;         ///< <b>00b  : 2 secs</b>; 01b  : 4 secs;
> 10b  : 6 secs; 11  : 8 secs (see  : SATA_OROM_DELAY)
> 
> +  UINT32  HddUnlock          :  1;         ///< 0  : Disable; <b>1  : Enable</b>.
> Indicates that the HDD password unlock in the OS is enabled
> 
> +  UINT32  LedLocate          :  1;         ///< 0  : Disable; <b>1  : Enable</b>.
> Indicates that the LED/SGPIO hardware is attached and ping to locate feature
> is enabled on the OS
> 
> +  UINT32  IrrtOnly           :  1;         ///< 0  : Disable; <b>1  : Enable</b>. Allow
> only IRRT drives to span internal and external ports
> 
> +  UINT32  SmartStorage       :  1;         ///< 0  : Disable; <b>1  : Enable</b> RST
> Smart Storage caching Bit
> 
> +  UINT32  LegacyOrom         :  1;         ///< <b>0  : Disable</b>; 1  : Enable RST
> Legacy OROM
> 
> +  UINT32  OptaneMemory       :  1;         ///< 0: Disable; <b>1: Enable</b> RST
> Optane(TM) Memory
> 
> +  UINT32  CpuAttachedStorage :  1;         ///< 0: Disable; <b>1: Enable</b>
> CPU Attached Storage
> 
> +  UINT32  RsvdBits0          : 17;         ///< Reserved Bits
> 
> +  /**
> 
> +    This member describes the details of implementation of Intel RST for PCIe
> Storage remapping (Intel RST Driver is required)
> 
> +    Note: RST for PCIe Sorage remapping is supported only for first SATA
> controller if more controllers are available
> 
> +  **/
> 
> +  RST_HARDWARE_REMAPPED_STORAGE_CONFIG
> HardwareRemappedStorageConfig[PCH_MAX_RST_PCIE_STORAGE_CR];
> 
> +} RST_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
> new file mode 100644
> index 0000000000..1f354c10ae
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Rtc/RtcConfig.h
> @@ -0,0 +1,38 @@
> +/** @file
> 
> +  RTC policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _RTC_CONFIG_H_
> 
> +#define _RTC_CONFIG_H_
> 
> +
> 
> +#define RTC_CONFIG_REVISION 1
> 
> +extern EFI_GUID gRtcConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The RTC_CONFIG block describes the expected configuration of RTC
> configuration.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  /**
> 
> +    When set, prevents RTC TS (BUC.TS) from being changed.
> 
> +    This BILD bit has different function compared to LPC/eSPI, SPI.
> 
> +    0: Disabled; <b>1: Enabled</b>
> 
> +  **/
> 
> +  UINT32  BiosInterfaceLock       :  1;
> 
> +  /**
> 
> +    When set, bytes 38h-3Fh in the upper 128bytes bank of RTC RAM are
> locked
> 
> +    and cannot be accessed.
> 
> +    Writes will be droipped and reads will not return any guaranteed data.
> 
> +    0: Disabled; <b>1: Enabled</b>
> 
> +  **/
> 
> +  UINT32  MemoryLock              :  1;
> 
> +  UINT32  RsvdBits0               : 30;
> 
> +} RTC_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _RTC_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
> new file mode 100644
> index 0000000000..c560fdd3ab
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Sata/SataConfig.h
> @@ -0,0 +1,168 @@
> +/** @file
> 
> +  Sata policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SATA_CONFIG_H_
> 
> +#define _SATA_CONFIG_H_
> 
> +
> 
> +#include <PchLimits.h>
> 
> +
> 
> +#define SATA_CONFIG_REVISION 1
> 
> +extern EFI_GUID gSataConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +typedef enum  {
> 
> +  SataModeAhci,
> 
> +  SataModeRaid,
> 
> +  SataModeMax
> 
> +} SATA_MODE;
> 
> +
> 
> +typedef enum {
> 
> +  SataSpeedDefault,
> 
> +  SataSpeedGen1,
> 
> +  SataSpeedGen2,
> 
> +  SataSpeedGen3
> 
> +} SATA_SPEED;
> 
> +
> 
> +typedef enum {
> 
> +  SataRstMsix,
> 
> +  SataRstMsi,
> 
> +  SataRstLegacy
> 
> +} SATA_RST_INTERRUPT;
> 
> +
> 
> +typedef enum {
> 
> +  SataRaidClient,
> 
> +  SataRaidAlternate,
> 
> +  SataRaidServer
> 
> +} SATA_RAID_DEV_ID;
> 
> +
> 
> +/**
> 
> +  This structure configures the features, property, and capability for each
> SATA port.
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    Enable SATA port.
> 
> +    It is highly recommended to disable unused ports for power savings
> 
> +  **/
> 
> +  UINT32  Enable           :  1;                  ///< 0: Disable; <b>1: Enable</b>
> 
> +  UINT32  HotPlug          :  1;                  ///< <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  InterlockSw      :  1;                  ///< <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  External         :  1;                  ///< <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  SpinUp           :  1;                  ///< <b>0: Disable</b>; 1: Enable the
> COMRESET initialization Sequence to the device
> 
> +  UINT32  SolidStateDrive  :  1;                  ///< <b>0: HDD</b>; 1: SSD
> 
> +  UINT32  DevSlp           :  1;                  ///< <b>0: Disable</b>; 1: Enable DEVSLP
> on the port
> 
> +  UINT32  EnableDitoConfig :  1;                  ///< <b>0: Disable</b>; 1: Enable
> DEVSLP Idle Timeout settings (DmVal, DitoVal)
> 
> +  UINT32  DmVal            :  4;                  ///< DITO multiplier. Default is
> <b>15</b>.
> 
> +  UINT32  DitoVal          : 10;                  ///< DEVSLP Idle Timeout (DITO), Default
> is <b>625</b>.
> 
> +  /**
> 
> +    Support zero power ODD <b>0: Disable</b>, 1: Enable.
> 
> +    This is also used to disable ModPHY dynamic power gate.
> 
> +  **/
> 
> +  UINT32  ZpOdd             :  1;
> 
> +  UINT32  DevSlpResetConfig :  4;                 ///< 0: Hardware default; <b>0x01:
> GpioResumeReset</b>; 0x03: GpioHostDeepReset; 0x05:
> GpioPlatformReset; 0x07: GpioDswReset
> 
> +  UINT32  SataPmPtm         :  1;                 ///< Deprecated
> 
> +  UINT32  RxPolarity        :  1;                 ///< <b>0: Disable</b>; 1: Enable; Rx
> Polarity
> 
> +  UINT32  RsvdBits0         :  3;                 ///< Reserved fields for future
> expansion w/o protocol change
> 
> +} PCH_SATA_PORT_CONFIG;
> 
> +
> 
> +/**
> 
> +  This structure lists PCH supported SATA thermal throttling register setting
> for customization.
> 
> +  The settings is programmed through SATA Index/Data registers.
> 
> +  When the SuggestedSetting is enabled, the customized values are ignored.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  P0T1M                   :  2; ///< Port 0 T1 Multipler
> 
> +  UINT32  P0T2M                   :  2; ///< Port 0 T2 Multipler
> 
> +  UINT32  P0T3M                   :  2; ///< Port 0 T3 Multipler
> 
> +  UINT32  P0TDisp                 :  2; ///< Port 0 Tdispatch
> 
> +
> 
> +  UINT32  P1T1M                   :  2; ///< Port 1 T1 Multipler
> 
> +  UINT32  P1T2M                   :  2; ///< Port 1 T2 Multipler
> 
> +  UINT32  P1T3M                   :  2; ///< Port 1 T3 Multipler
> 
> +  UINT32  P1TDisp                 :  2; ///< Port 1 Tdispatch
> 
> +
> 
> +  UINT32  P0Tinact                :  2; ///< Port 0 Tinactive
> 
> +  UINT32  P0TDispFinit            :  1; ///< Port 0 Alternate Fast Init Tdispatch
> 
> +  UINT32  P1Tinact                :  2; ///< Port 1 Tinactive
> 
> +  UINT32  P1TDispFinit            :  1; ///< Port 1 Alternate Fast Init Tdispatch
> 
> +  UINT32  SuggestedSetting        :  1; ///< 0: Disable; <b>1: Enable</b>
> suggested representative values
> 
> +  UINT32  RsvdBits0               :  9; ///< Reserved bits
> 
> +} SATA_THERMAL_THROTTLING;
> 
> +
> 
> +/**
> 
> +   The SATA_CONFIG block describes the expected configuration of the
> SATA controllers.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                             ///< Config Block Header
> 
> +  ///
> 
> +  /// This member describes whether or not the SATA controllers should be
> enabled. 0: Disable; <b>1: Enable</b>.
> 
> +  ///
> 
> +  UINT8                         Enable;
> 
> +  UINT8                         TestMode;       ///< <b>(Test)</b> <b>0: Disable</b>; 1:
> Allow entrance to the PCH SATA test modes
> 
> +  UINT8                         SalpSupport;    ///< 0: Disable; <b>1: Enable</b>
> Aggressive Link Power Management
> 
> +  UINT8                         PwrOptEnable;   ///< 0: Disable; <b>1: Enable</b> SATA
> Power Optimizer on PCH side.
> 
> +  /**
> 
> +    EsataSpeedLimit
> 
> +    When enabled, BIOS will configure the PxSCTL.SPD to 2 to limit the eSATA
> port speed.
> 
> +    Please be noted, this setting could be cleared by HBA reset, which might
> be issued
> 
> +    by EFI AHCI driver when POST time, or by SATA inbox driver/RST driver
> after POST.
> 
> +    To support the Speed Limitation when POST, the EFI AHCI driver should
> preserve the
> 
> +    setting before and after initialization. For support it after POST, it's
> dependent on
> 
> +    driver's behavior.
> 
> +    <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT8                         EsataSpeedLimit;
> 
> +  UINT8                         LedEnable;       ///< SATA LED indicates SATA controller
> activity. 0: Disable; <b>1: Enable</b> SATA LED.
> 
> +  /**
> 
> +    This option allows to configure SATA controller device ID while in RAID
> mode.
> 
> +    Refer to SATA_RAID_DEV_ID enumeration for supported options.
> 
> +    Choosing Client will allow RST driver loading, RSTe driver will not be able to
> load
> 
> +    Choosing Alternate will not allow RST inbox driver loading in Windows
> 
> +    Choosing Server will allow RSTe driver loading, RST driver will not load
> 
> +    <b>0: Client</b>; 1: Alternate; 2: Server
> 
> +  **/
> 
> +  UINT8                        RaidDeviceId;
> 
> +  /**
> 
> +    Controlls which interrupts will be linked to SATA controller CAP list
> 
> +    This option will take effect only if SATA controller is in RAID mode
> 
> +    Default: <b>PchSataMsix</b>
> 
> +  **/
> 
> +  UINT8                         SataRstInterrupt;
> 
> +
> 
> +  /**
> 
> +    Determines the system will be configured to which SATA mode.
> 
> +    Refer to SATA_MODE enumeration for supported options. Default is
> <b>SataModeAhci</b>.
> 
> +  **/
> 
> +  UINT8                         SataMode;
> 
> +  /**
> 
> +    Indicates the maximum speed the SATA controller can support.
> 
> +    Refer to SATA_SPEED enumeration for supported options.
> 
> +    <b>0h: SataSpeedDefault</b>; 1h: 1.5 Gb/s (Gen 1); 2h: 3 Gb/s(Gen 2);
> 3h: 6 Gb/s (Gen 1)
> 
> +  **/
> 
> +  UINT8                         SpeedLimit;
> 
> +  UINT8                         EnclosureSupport;   ///< Enclosure Management
> Support. 0: Disable; 1: Enable
> 
> +  /**
> 
> +    Controlls whenever Serial GPIO support is enabled for controller
> 
> +    <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT8                         SgpioSupport;
> 
> +  /**
> 
> +    This member configures the features, property, and capability for each
> SATA port.
> 
> +  **/
> 
> +  PCH_SATA_PORT_CONFIG          PortSettings[PCH_MAX_SATA_PORTS];
> 
> +  /**
> 
> +    This field decides the settings of Sata thermal throttling. When the
> Suggested Setting
> 
> +    is enabled, PCH RC will use the suggested representative values.
> 
> +  **/
> 
> +  SATA_THERMAL_THROTTLING       ThermalThrottling;
> 
> +} SATA_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SATA_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
> new file mode 100644
> index 0000000000..2ebc901896
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Scs/ScsConfig.h
> @@ -0,0 +1,139 @@
> +/** @file
> 
> +  Scs policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SCS_CONFIG_H_
> 
> +#define _SCS_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +#define SCS_SDCARD_CONFIG_REVISION     1
> 
> +#define SCS_EMMC_CONFIG_REVISION       1
> 
> +#define SCS_EMMC_DXE_CONFIG_REVISION   1
> 
> +#define SCS_SDCARD_MAX_DATA_GPIOS      4
> 
> +#define SCS_EMMC_MAX_DATA_GPIOS        8
> 
> +extern EFI_GUID gSdCardConfigGuid;
> 
> +extern EFI_GUID gEmmcConfigGuid;
> 
> +extern EFI_GUID gUfsConfigGuid;
> 
> +extern EFI_GUID gEmmcDxeConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structre holds the DLL configuration
> 
> +  register values that will be programmed by RC
> 
> +  if EnableCustomDlls field is set to TRUE. Those
> 
> +  policies should be used by platform if default values
> 
> +  provided by RC are not sufficient to provide stable operation
> 
> +  at all supported spped modes. RC will blindly set the DLL values
> 
> +  as provided in this structre.
> 
> +
> 
> +  For help with obtaining valid DLL values for your platform please
> 
> +  contact enabling support.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  TxCmdDelayControl;      // Offset 820h: Tx CMD Delay Control
> 
> +  UINT32  TxDataDelayControl1;    // Offset 824h: Tx Data Delay Control 1
> 
> +  UINT32  TxDataDelayControl2;    // Offset 828h: Tx Data Delay Control 2
> 
> +  UINT32  RxCmdDataDelayControl1; // Offset 82Ch: Rx CMD + Data Delay
> Control 1
> 
> +  UINT32  RxCmdDataDelayControl2; // Offset 834h: Rx CMD + Data Delay
> Control 2
> 
> +  UINT32  RxStrobeDelayControl;   // Offset 830h: Rx Strobe Delay Control,
> valid only for eMMC
> 
> +} SCS_SD_DLL;
> 
> +
> 
> +/**
> 
> +  SD GPIO settings
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    GPIO signals pin muxing settings. If signal can be enable only on a single
> pin
> 
> +    then this parameter should be set to 0. Refer to
> GPIO_*_MUXING_SDCARD_*x_* in GpioPins*.h
> 
> +    for supported settings on a given platform
> 
> +  **/
> 
> +  UINT32   PinMux;
> 
> +  /**
> 
> +    GPIO Pads Internal Termination.
> 
> +    For more information please see Platform Design Guide.
> 
> +    Check GPIO_ELECTRICAL_CONFIG for reference
> 
> +  **/
> 
> +  UINT32   PadTermination;
> 
> +} MUX_GPIO_PARAM;
> 
> +
> 
> +typedef struct {
> 
> +  MUX_GPIO_PARAM PowerEnable;
> 
> +  MUX_GPIO_PARAM Cmd;
> 
> +  MUX_GPIO_PARAM Data[SCS_SDCARD_MAX_DATA_GPIOS];
> 
> +  MUX_GPIO_PARAM Cdb;
> 
> +  MUX_GPIO_PARAM Clk;
> 
> +  MUX_GPIO_PARAM Wp;
> 
> +} SCS_SDCARD_GPIO_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  MUX_GPIO_PARAM Cmd;
> 
> +  MUX_GPIO_PARAM Data[SCS_EMMC_MAX_DATA_GPIOS];
> 
> +  MUX_GPIO_PARAM Rclk;
> 
> +  MUX_GPIO_PARAM Clk;
> 
> +  MUX_GPIO_PARAM Resetb;
> 
> +} SCS_EMMC_GPIO_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;
> 
> +
> 
> +  UINT32      Enable                : 1;  ///<  Enable/Disable SdCard 0: Disabled, <b>1:
> Enabled</b>
> 
> +  UINT32      PowerEnableActiveHigh : 1;  ///<  Determine SD_PWREN#
> polarity 0: Active low, <b>1: Active high</b>
> 
> +  UINT32      UseCustomDlls         : 1;  ///<  Use tuned DLL values from policy
> <b>0: Use default DLL</b>, 1: Use values from TunedDllValues field
> 
> +  UINT32      Reserved              : 29;
> 
> +  SCS_SD_DLL  CustomDllValues;            ///<  Structure containing custom DLL
> values for SD card
> 
> +  SCS_SDCARD_GPIO_CONFIG GpioConfig;
> 
> +} SCS_SDCARD_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  Hs400RxValue : 7;  ///< Value of the tuned HS400 Rx value
> 
> +  UINT32  Hs400TxValue : 7;  ///< Value of the tuned HS400 Tx value
> 
> +  UINT32  Reserved     : 18;
> 
> +} SCS_EMMC_TUNED_DLL;
> 
> +
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;
> 
> +
> 
> +  UINT32      Enable         : 1;  ///<  Enable/Disable eMMC 0: Disabled, <b>1:
> Enabled</b>
> 
> +  UINT32      Hs400Supported : 1;  ///<  Enable/Disable eMMC HS400 support
> 0: Disabled, <b>1: Enabled</b>
> 
> +  UINT32      UseCustomDlls  : 1;  ///<  Use custom DLL values from policy
> <b>0: Use default DLL</b>, 1: Use values from TunedDllValues field
> 
> +  UINT32      Reserved       : 29;
> 
> +  SCS_SD_DLL  CustomDllValues;     ///<  Structure containing custom DLL
> values for eMMC                    ///< Structure containing tuned DLL settings for
> eMMC
> 
> +  SCS_EMMC_GPIO_CONFIG GpioConfig;
> 
> +} SCS_EMMC_CONFIG;
> 
> +
> 
> +typedef enum {
> 
> +  DriverStrength33Ohm = 0,
> 
> +  DriverStrength40Ohm,
> 
> +  DriverStrength50Ohm
> 
> +} SCS_EMMC_DRIVER_STRENGTH;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  TuningSuccessful  : 1;  ///< Informs software tuning module about
> previous software tuning status.
> 
> +  UINT32  Hs400RxValue      : 7;  ///< Value of the tuned HS400 Rx value
> returned from software tuning module
> 
> +  UINT32  Hs400TxValue      : 7;  ///< Value of the tuned HS400 Tx value
> returned from software tuning module
> 
> +  UINT32  Reserved          : 17;
> 
> +} SCS_EMMC_SOFTWARE_TUNING_RESULTS;
> 
> +
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;
> 
> +
> 
> +  UINT32   EnableSoftwareHs400Tuning         : 1;           ///< Enable/Disable
> software eMMC HS400 tuning: <b>0 - Disable</b>, 1 - Enable
> 
> +  UINT32   DriverStrength                    : 2;           ///< I/O driver strength: 0 - 33
> Ohm, <b>1 - 40 Ohm</b>, 2 - 50 Ohm
> 
> +  UINT32   Reserved                          : 29;
> 
> +  EFI_LBA  TuningLba;                                       ///< Specifies LBA which will be
> used during software tuning process.
> 
> +  SCS_EMMC_SOFTWARE_TUNING_RESULTS  PreviousTuningResults;  ///<
> Informes software tuning module about previous software tuning results.}
> SCS_EMMC_DXE_CONFIG;
> 
> +} SCS_EMMC_DXE_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  Enable   : 1;  ///< Enable/Disable UFS controller 0: Disabled, <b>1:
> Enabled</b>
> 
> +  UINT32  Reserved : 31;
> 
> +} SCS_UFS_CONTROLLER_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SCS_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfi
> g.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfi
> g.h
> new file mode 100644
> index 0000000000..d76937cf59
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SerialIo/SerialIoConfi
> g.h
> @@ -0,0 +1,32 @@
> +/** @file
> 
> +  Serial IO policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_CONFIG_H_
> 
> +#define _SERIAL_IO_CONFIG_H_
> 
> +
> 
> +#define SERIAL_IO_CONFIG_REVISION 1
> 
> +extern EFI_GUID gSerialIoConfigGuid;
> 
> +
> 
> +#include <SerialIoDevices.h>
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The SERIAL_IO_CONFIG block provides the configurations to set the Serial
> IO controllers
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Inital version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                                              ///< Config Block
> Header
> 
> +  SERIAL_IO_SPI_CONFIG
> SpiDeviceConfig[PCH_MAX_SERIALIO_SPI_CONTROLLERS];   ///< SPI
> Configuration
> 
> +  SERIAL_IO_I2C_CONFIG
> I2cDeviceConfig[PCH_MAX_SERIALIO_I2C_CONTROLLERS];   ///< I2C
> Configuration
> 
> +  SERIAL_IO_UART_CONFIG
> UartDeviceConfig[PCH_MAX_SERIALIO_UART_CONTROLLERS]; ///< UART
> Configuration
> 
> +} SERIAL_IO_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SERIAL_IO_CONFIG_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
> new file mode 100644
> index 0000000000..7ee4554b1d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiConfig.h
> @@ -0,0 +1,152 @@
> +/** @file
> 
> +  Si Config Block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_CONFIG_H_
> 
> +#define _SI_CONFIG_H_
> 
> +
> 
> +#define SI_CONFIG_REVISION  2
> 
> +
> 
> +extern EFI_GUID gSiConfigGuid;
> 
> +
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The Silicon Policy allows the platform code to publish a set of configuration
> 
> +  information that the RC drivers will use to configure the silicon hardware.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Added TraceHubMemBase
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;  ///< Offset 0 - 27 Config Block Header
> 
> +  //
> 
> +  // Platform specific common policies that used by several silicon
> components.
> 
> +  //
> 
> +  UINT8  CsmFlag;                ///< CSM status flag.
> 
> +  /**
> 
> +    This is used to skip the SSID programming in silicon code.
> 
> +    When set to TRUE, silicon code will not do any SSID programming and
> platform code
> 
> +    needs to handle that by itself properly.
> 
> +    <b>0: FALSE</b>, 1: TRUE
> 
> +  **/
> 
> +  UINT8  SkipSsidProgramming;
> 
> +  UINT8  RsvdBytes0[2];
> 
> +  /**
> 
> +    When SkipSsidProgramming is FALSE, silicon code will use this as default
> value
> 
> +    to program the SVID for all internal devices.
> 
> +    <b>0: use silicon default SVID 0x8086 </b>, Non-zero: use customized
> SVID.
> 
> +  **/
> 
> +  UINT16 CustomizedSvid;
> 
> +  /**
> 
> +    When SkipSsidProgramming is FALSE, silicon code will use this as default
> value
> 
> +    to program the Sid for all internal devices.
> 
> +    <b>0: use silicon default SSID 0x7270 </b>, Non-zero: use customized
> SSID.
> 
> +  **/
> 
> +  UINT16 CustomizedSsid;
> 
> +  /**
> 
> +    SsidTablePtr contains the SVID_SID_INIT_ENTRY table.
> 
> +    This is valid when SkipSsidProgramming is FALSE;
> 
> +    It doesn't need to contain entries for all Intel internal devices.
> 
> +    It can only contains the SVID_SID_INIT_ENTRY entries for those Dev#
> Func# which needs
> 
> +    to be overridden.
> 
> +    In the enties, only Dev, Function, SubSystemVendorId, and SubSystemId
> are required.
> 
> +    <b>Default is NULL.</b>
> 
> +
> 
> +    E.g. Platform only needs to override BDF 0:31:5 to AAAA:BBBB and BDF
> 0:31:3 to CCCC:DDDD,
> 
> +    it can be done in platform like this:
> 
> +    STATIC SVID_SID_INIT_ENTRY mSsidTablePtr[SI_MAX_DEVICE_COUNT] =
> {0};
> 
> +
> 
> +    VOID SiPolicyUpdate () {
> 
> +      UINT32 EntryCount = 0;
> 
> +      SiPolicy->SkipSsidProgramming = FALSE;
> 
> +      SiPolicy->SsidTablePtr = mSsidTablePtr;
> 
> +
> 
> +      mSsidTablePtr[EntryCount].Address.Bits.Device   = SpiDeviceNumber ();
> 
> +      mSsidTablePtr[EntryCount].Address.Bits.Function = SpiFunctionNumber
> ();
> 
> +      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemVendorId =
> 0xAAAA;
> 
> +      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemId       = 0xBBBB;
> 
> +      EntryCount ++;
> 
> +      mSsidTablePtr[EntryCount].Address.Bits.Device   = HdaDevNumber ();
> 
> +      mSsidTablePtr[EntryCount].Address.Bits.Function = HdaFuncNumber ();
> 
> +      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemVendorId = 0xCCCC;
> 
> +      mSsidTablePtr[EntryCount].SvidSidValue.SubSystemId       = 0xDDDD;
> 
> +      EntryCount ++;
> 
> +      ASSERT (EntryCount < SI_MAX_DEVICE_COUNT);
> 
> +      SiPolicy->NumberOfSsidTableEntry = EntryCount;
> 
> +    }
> 
> +  **/
> 
> +  UINT32 *SsidTablePtr;
> 
> +  /**
> 
> +    Number of valid enties in SsidTablePtr.
> 
> +    This is valid when SkipSsidProgramming is FALSE;
> 
> +    <b>Default is 0.</b>
> 
> +  **/
> 
> +  UINT16 NumberOfSsidTableEntry;
> 
> +  UINT8  RsvdBytes1[2];
> 
> +  /**
> 
> +    If Trace Hub is enabled and trace to memory is desired, Platform code or
> BootLoader needs to allocate trace hub memory
> 
> +    as reserved, and save allocated memory base to TraceHubMemBase to
> ensure Trace Hub memory is configured properly.
> 
> +    To get total trace hub memory size please refer to
> TraceHubCalculateTotalBufferSize ()
> 
> +
> 
> +    Noted: If EDKII memory service is used to allocate memory, it will require
> double memory size to support size-aligned memory allocation,
> 
> +    so Platform code or FSP Wrapper code should ensure enough memory
> available for size-aligned TraceHub memory allocation.
> 
> +  **/
> 
> +  UINT32 TraceHubMemBase;        // Offset 58
> 
> +  /**
> 
> +    This is used to skip setting BIOS_DONE MSR during firmware update boot
> mode.
> 
> +    When set to TRUE and boot mode is BOOT_ON_FLASH_UPDATE,
> 
> +    skip setting BIOS_DONE MSR at EndofPei.
> 
> +    <b>0: FALSE</b>, 1: TRUE
> 
> +  **/
> 
> +  UINT8  SkipBiosDoneWhenFwUpdate;
> 
> +  UINT8  RsvdBytes2[3];
> 
> +} SI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#define DEFAULT_SSVID        0x8086
> 
> +#define DEFAULT_SSDID        0x7270
> 
> +#define SI_MAX_DEVICE_COUNT  70
> 
> +
> 
> +///
> 
> +/// Subsystem Vendor ID / Subsystem ID
> 
> +///
> 
> +typedef struct {
> 
> +  UINT16         SubSystemVendorId;
> 
> +  UINT16         SubSystemId;
> 
> +} SVID_SID_VALUE;
> 
> +
> 
> +//
> 
> +// Below is to match PCI_SEGMENT_LIB_ADDRESS () which can directly send
> to PciSegmentRead/Write functions.
> 
> +//
> 
> +typedef struct {
> 
> +  union {
> 
> +    struct {
> 
> +      UINT32  Register:12;
> 
> +      UINT32  Function:3;
> 
> +      UINT32  Device:5;
> 
> +      UINT32  Bus:8;
> 
> +      UINT32  Reserved1:4;
> 
> +      UINT32  Segment:16;
> 
> +      UINT32  Reserved2:16;
> 
> +    } Bits;
> 
> +    UINT64    SegBusDevFuncRegister;
> 
> +  } Address;
> 
> +  SVID_SID_VALUE SvidSidValue;
> 
> +  UINT32 Reserved;
> 
> +} SVID_SID_INIT_ENTRY;
> 
> +
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  SkipBus;
> 
> +  UINT32  SkipDevice;
> 
> +  UINT32  SkipFunction;
> 
> +} SVID_SID_SKIP_TABLE;
> 
> +
> 
> +#endif // _SI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
> new file mode 100644
> index 0000000000..4bf014e9ba
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/SiPreMemConfig.h
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  Si Config Block PreMem
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_PREMEM_CONFIG_H_
> 
> +#define _SI_PREMEM_CONFIG_H_
> 
> +
> 
> +#define SI_PREMEM_CONFIG_REVISION  1
> 
> +
> 
> +extern EFI_GUID gSiPreMemConfigGuid;
> 
> +
> 
> +typedef enum {
> 
> +  ProbeTypeDisabled    = 0x00,
> 
> +  ProbeTypeDciOob      = 0x02,
> 
> +  ProbeTypeUsb3Dbc     = 0x03,
> 
> +  ProbeTypeXdp3        = 0x04,
> 
> +  ProbeTypeUsb2Dbc     = 0x05,
> 
> +  ProbeType2WireDciOob = 0x06,
> 
> +  ProbeTypeManual      = 0x07,
> 
> +  ProbeTypeMax
> 
> +} PLATFORM_DEBUG_CONSENT_PROBE_TYPE;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +/**
> 
> +  The Silicon PreMem Policy allows the platform code to publish a set of
> configuration
> 
> +  information that the RC drivers will use to configure the silicon hardware.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;  ///< Offset 0 - 27 Config Block Header
> 
> +  /**
> 
> +    Platform Debug Consent
> 
> +    As a master switch to enable platform debug capability and relevant
> settings with specified probe type.
> 
> +    Manual: Do not use Platform Debug Consent to override other debug-
> relevant policies, but the user must set each debug option manually, aimed
> at advanced users.
> 
> +
> 
> +    PDC-dependent policies are listed:
> 
> +    DciPreMemConfig->DciEn
> 
> +    DciPreMemConfig->DciDbcMode
> 
> +    CpuTraceHubConfig->EnableMode
> 
> +    CpuTraceHubConfig->CpuTraceHubMemReg0Size
> 
> +    CpuTraceHubConfig->CpuTraceHubMemReg1Size
> 
> +    PchTraceHubPreMemConfig->EnableMode
> 
> +    PchTraceHubPreMemConfig->MemReg0Size
> 
> +    PchTraceHubPreMemConfig->MemReg1Size
> 
> +
> 
> +    Note: DCI OOB (aka BSSB) uses CCA probe.
> 
> +    Refer to definition of PLATFORM_DEBUG_CONSENT_PROBE_TYPE
> 
> +    <b>0:Disabled</b>; 2:DCI OOB; 3:USB3 DbC; 4:XDP3/MIPI60 5:USB2 DbC;
> 6:2-wire DCI OOB; 7:Manual
> 
> +  **/
> 
> +  UINT32    PlatformDebugConsent  :  4;
> 
> +  UINT32    RsvdBits              : 28;
> 
> +  /**
> 
> +    This is used to skip override boot mode during firmware update boot
> mode.
> 
> +    When set to TRUE and boot mode is BOOT_ON_FLASH_UPDATE,
> 
> +    skip setting boot mode to BOOT_WITH_FULL_CONFIGURATION in PEI
> memory init.
> 
> +    <b>0: FALSE</b>, 1: TRUE
> 
> +  **/
> 
> +  UINT8     SkipOverrideBootModeWhenFwUpdate;
> 
> +  UINT8     RsvdBytes[3];
> 
> +} SI_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +#endif // _SI_PREMEM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig
> .h
> new file mode 100644
> index 0000000000..36f96a4f32
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Smbus/SmbusConfig
> .h
> @@ -0,0 +1,50 @@
> +/** @file
> 
> +  Smbus policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SMBUS_CONFIG_H_
> 
> +#define _SMBUS_CONFIG_H_
> 
> +
> 
> +#define SMBUS_PREMEM_CONFIG_REVISION 1
> 
> +extern EFI_GUID gSmbusPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +#define PCH_MAX_SMBUS_RESERVED_ADDRESS 128
> 
> +
> 
> +///
> 
> +/// The SMBUS_CONFIG block lists the reserved addresses for non-ARP
> capable devices in the platform.
> 
> +///
> 
> +typedef struct {
> 
> +  /**
> 
> +    Revision 1: Init version
> 
> +  **/
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  /**
> 
> +    This member describes whether or not the SMBus controller of PCH
> should be enabled.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32  Enable             :  1;
> 
> +  UINT32  ArpEnable          :  1;      ///< Enable SMBus ARP support, <b>0:
> Disable</b>; 1: Enable.
> 
> +  UINT32  DynamicPowerGating :  1;      ///< <b>(Test)</b> <b>Disable</b>
> or Enable Smbus dynamic power gating.
> 
> +  ///
> 
> +  /// <b>(Test)</b> SPD Write Disable, 0: leave SPD Write Disable bit; <b>1:
> set SPD Write Disable bit.</b>
> 
> +  /// For security recommendations, SPD write disable bit must be set.
> 
> +  ///
> 
> +  UINT32  SpdWriteDisable    :  1;
> 
> +  UINT32  SmbAlertEnable     :  1;      ///< Enable SMBus Alert pin
> (SMBALERT#). 0: <b>Disabled<b>, 1: Enabled.
> 
> +  UINT32  RsvdBits0          : 27;      ///< Reserved bits
> 
> +  UINT16  SmbusIoBase;                  ///< SMBUS Base Address (IO space).
> Default is <b>0xEFA0</b>.
> 
> +  UINT8   Rsvd0;                        ///< Reserved bytes
> 
> +  UINT8   NumRsvdSmbusAddresses;        ///< The number of elements in
> the RsvdSmbusAddressTable.
> 
> +  /**
> 
> +    Array of addresses reserved for non-ARP-capable SMBus devices.
> 
> +  **/
> 
> +  UINT8
> RsvdSmbusAddressTable[PCH_MAX_SMBUS_RESERVED_ADDRESS];
> 
> +} PCH_SMBUS_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SMBUS_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
> new file mode 100644
> index 0000000000..f3e52ff453
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Spi/SpiConfig.h
> @@ -0,0 +1,43 @@
> +/** @file
> 
> +  PCH SPI Flash Controller config block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SPI_CONFIG_H_
> 
> +#define _SPI_CONFIG_H_
> 
> +
> 
> +#define SPI_CONFIG_REVISION 1
> 
> +extern EFI_GUID gSpiConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  Basic configuration for option features of PCH SPI Flash controller
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
> 
> +  /**
> 
> +    Enable extended BIOS Direct Read Region feature
> 
> +    Enabling this will make all memory accesses in a decode range to be
> translated
> 
> +    to BIOS region reads from SPI flash
> 
> +    <b>0: Disabled</b>, 1: Enabled
> 
> +  **/
> 
> +  UINT32    ExtendedBiosDecodeRangeEnable   :  1;
> 
> +  UINT32    RsvdBits0                       : 31;       ///< Reserved bits
> 
> +  /**
> 
> +    Base address that will be used for Extended Decode Range.
> 
> +    This will be ignored when ExtendedBiosDecodeRangeEnable is set to 0.
> 
> +  **/
> 
> +  UINT32    ExtendedBiosDecodeRangeBase;
> 
> +  /**
> 
> +    Limit address that will be used for Extended Decode Range.
> 
> +    This will be ignored when ExtendedBiosDecodeRangeEnable is set to 0.
> 
> +  **/
> 
> +  UINT32    ExtendedBiosDecodeRangeLimit;
> 
> +} SPI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SPI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
> new file mode 100644
> index 0000000000..53af4ccd45
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Tcss/TcssPeiConfig.h
> @@ -0,0 +1,145 @@
> +/** @file
> 
> +  TCSS PEI policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _TCSS_PEI_CONFIG_H_
> 
> +#define _TCSS_PEI_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <UsbConfig.h>
> 
> +#include <TcssInfo.h>
> 
> +
> 
> +#define TCSS_PEI_CONFIG_REVISION 2
> 
> +extern EFI_GUID gTcssPeiConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +
> 
> +#define MAX_IOM_AUX_BIAS_COUNT 4
> 
> +
> 
> +///
> 
> +/// The IOM_AUX_ORI_PAD_CONFIG describes IOM TypeC port map GPIO
> pin.
> 
> +/// Those GPIO setting for DP Aux Orientation Bias Control when the TypeC
> port didn't have re-timer.
> 
> +/// IOM needs know Pull-Up and Pull-Down pin for Bias control
> 
> +///
> 
> +typedef struct {
> 
> +  UINT32     GpioPullN; ///< GPIO Pull Up Ping number that is for IOM
> indecate the pull up pin from TypeC port.
> 
> +  UINT32     GpioPullP; ///< GPIO Pull Down Ping number that is for IOM
> indecate the pull down pin from TypeC port.
> 
> +} IOM_AUX_ORI_PAD_CONFIG;
> 
> +
> 
> +///
> 
> +/// The IOM_EC_INTERFACE_CONFIG block describes interaction between
> BIOS and IOM-EC.
> 
> +///
> 
> +
> 
> +typedef struct {
> 
> +  UINT32     VccSt;         ///< IOM VCCST request. (Not equal to actual VCCST
> value)
> 
> +  UINT32     UsbOverride;   ///< IOM to override USB connection.
> 
> +  UINT32     D3ColdEnable;  ///< Enable/disable D3 Cold support in TCSS
> 
> +  UINT32     D3HotEnable;   ///< Enable/disable D3 Hot support in TCSS
> 
> +} IOM_INTERFACE_CONFIG;
> 
> +
> 
> +///
> 
> +/// The PMC_INTERFACE_CONFIG block describes interaction between
> BIOS and PMC
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8      PmcPdEnable;    ///< PMC PD Solution Enable
> 
> +  UINT8      Rsvd[3];
> 
> +} PMC_INTERFACE_CONFIG;
> 
> +
> 
> +///
> 
> +/// The SA XDCI INT Pin and IRQ number
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8      IntPing;  ///< Int Pin Number
> 
> +  UINT8      Irq;      ///< Irq Number
> 
> +  UINT16     Rsvd;
> 
> +} SA_XDCI_IRQ_INT_CONFIG;
> 
> +
> 
> +///
> 
> +/// The TCSS_PCIE_PORT_POLICY block describes PCIe settings for TCSS.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8   AcsEnabled;                         ///< Indicate whether the ACS is enabled.
> 0: Disable; <b>1: Enable</b>.
> 
> +  UINT8   DpcEnabled;                         ///< Downstream Port Containment. 0:
> Disable; <b>1: Enable</b>
> 
> +  UINT8   RpDpcExtensionsEnabled;             ///< RP Extensions for
> Downstream Port Containment. 0: Disable; <b>1: Enable</b>
> 
> +  UINT8   LtrEnable;                          ///< Latency Tolerance Reporting
> Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   PtmEnabled;                         ///< Enables PTM capability
> 
> +
> 
> +  UINT8   Aspm;                               ///< The ASPM configuration of the root port
> (see: PCH_PCIE_ASPM_CONTROL). Default is <b>
> 
> +  UINT8   SlotNumber;                         ///< Indicates the slot number for the
> root port. Default is the value as root port index.
> 
> +  UINT8   SlotPowerLimitScale;                ///< <b>(Test)</b> Specifies scale
> used for slot power limit value. Leave as 0 to set to default. Default is
> <b>zero</b>.
> 
> +  UINT16  SlotPowerLimitValue;                ///< <b>(Test)</b> Specifies upper
> limit on power supplies by slot. Leave as 0 to set to default. Default is
> <b>zero</b>.
> 
> +
> 
> +  UINT8   AdvancedErrorReporting;             ///< Indicate whether the
> Advanced Error Reporting is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   UnsupportedRequestReport;           ///< Indicate whether the
> Unsupported Request Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   FatalErrorReport;                   ///< Indicate whether the Fatal Error
> Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   NoFatalErrorReport;                 ///< Indicate whether the No Fatal
> Error Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   CorrectableErrorReport;             ///< Indicate whether the
> Correctable Error Report is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   SystemErrorOnFatalError;            ///< Indicate whether the System
> Error on Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   SystemErrorOnNonFatalError;         ///< Indicate whether the
> System Error on Non Fatal Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   SystemErrorOnCorrectableError;      ///< Indicate whether the
> System Error on Correctable Error is enabled. <b>0: Disable</b>; 1: Enable.
> 
> +
> 
> +  UINT16  LtrMaxSnoopLatency;                 ///< Latency Tolerance Reporting,
> Max Snoop Latency.
> 
> +  UINT16  LtrMaxNoSnoopLatency;               ///< Latency Tolerance Reporting,
> Max Non-Snoop Latency.
> 
> +  UINT8   SnoopLatencyOverrideMode;           ///< Latency Tolerance
> Reporting, Snoop Latency Override Mode.
> 
> +  UINT8   SnoopLatencyOverrideMultiplier;     ///< Latency Tolerance
> Reporting, Snoop Latency Override Multiplier.
> 
> +  UINT16  SnoopLatencyOverrideValue;          ///< Latency Tolerance
> Reporting, Snoop Latency Override Value.
> 
> +  UINT8   NonSnoopLatencyOverrideMode;        ///< Latency Tolerance
> Reporting, Non-Snoop Latency Override Mode.
> 
> +  UINT8   NonSnoopLatencyOverrideMultiplier;  ///< Latency Tolerance
> Reporting, Non-Snoop Latency Override Multiplier.
> 
> +  UINT16  NonSnoopLatencyOverrideValue;       ///< Latency Tolerance
> Reporting, Non-Snoop Latency Override Value.
> 
> +  UINT8   ForceLtrOverride;                   ///< <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8   LtrConfigLock;                      ///< <b>0: Disable</b>; 1: Enable.
> 
> +} TCSS_PCIE_PORT_POLICY;
> 
> +
> 
> +///
> 
> +/// TCSS_PCIE_PEI_POLICY describes PCIe port settings for TCSS.
> 
> +///
> 
> +typedef struct {
> 
> +  TCSS_PCIE_PORT_POLICY  PciePortPolicy[MAX_ITBT_PCIE_PORT];
> 
> +} TCSS_PCIE_PEI_POLICY;
> 
> +
> 
> +///
> 
> +/// The TCSS_IOM_PEI_CONFIG block describes IOM Aux/HSL override
> settings for TCSS.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT16    AuxOri;     ///< Bits defining value for IOM Aux Orientation
> Register
> 
> +  UINT16    HslOri;     ///< Bits defining value for IOM HSL Orientation Register
> 
> +} TCSS_IOM_ORI_OVERRIDE;
> 
> +
> 
> +///
> 
> +/// The TCSS_IOM_PEI_CONFIG block describes IOM settings for TCSS.
> 
> +///
> 
> +typedef struct {
> 
> +  IOM_AUX_ORI_PAD_CONFIG
> IomAuxPortPad[MAX_IOM_AUX_BIAS_COUNT]; ///< The
> IOM_AUX_ORI_BIAS_CTRL port config setting.
> 
> +  TCSS_IOM_ORI_OVERRIDE     IomOverrides;
> 
> +  IOM_INTERFACE_CONFIG      IomInterface;                          ///< Config
> settings are BIOS <-> IOM interface.
> 
> +  PMC_INTERFACE_CONFIG      PmcInterface;                          ///< Config
> settings for BIOS <-> PMC interface
> 
> +  UINT8                     TcStateLimit;                          ///< Tcss C-State deep stage
> 
> +  UINT8                     Usb3ComplModeEnable;
> 
> +  UINT8                     Reserved[2];                           ///< Reserved bytes for future
> use
> 
> +} TCSS_IOM_PEI_CONFIG;
> 
> +
> 
> +///
> 
> +/// The TCSS_MISC_PEI_CONFIG block describes MISC settings for TCSS.
> 
> +///
> 
> +typedef struct {
> 
> +  SA_XDCI_IRQ_INT_CONFIG    SaXdci;   ///< System Agent Xdci Int Pin and
> Irq setting
> 
> +  UINT32                    Rsvd;     ///< Reserved bytes for future use, align to
> multiple 4
> 
> +} TCSS_MISC_PEI_CONFIG;
> 
> +
> 
> +///
> 
> +/// The TCSS_PEI_CONFIG block describes TCSS settings for SA.
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER     Header;     ///< Offset 0-27 Config Block Header
> 
> +  TCSS_PCIE_PEI_POLICY    PciePolicy; ///< The PCIe Config
> 
> +  USB_CONFIG              UsbConfig;  ///< USB config is shared between PCH
> and SA.
> 
> +  TCSS_IOM_PEI_CONFIG     IomConfig;  ///< The Iom Config
> 
> +  TCSS_MISC_PEI_CONFIG    MiscConfig; ///< The MISC Config
> 
> +} TCSS_PEI_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif /* _TCSS_PEI_CONFIG_H_ */
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
> new file mode 100644
> index 0000000000..23c3750216
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thc/ThcConfig.h
> @@ -0,0 +1,73 @@
> +/** @file
> 
> +  Touch Host Controller policy.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _THC_CONFIG_H_
> 
> +#define _THC_CONFIG_H_
> 
> +
> 
> +#define THC_CONFIG_REVISION 1
> 
> +extern EFI_GUID gThcConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  Available Port Assignments
> 
> +
> 
> +**/
> 
> +typedef enum {
> 
> +  ThcAssignmentNone, ///< None of the avaialbe controllers assigned
> 
> +  ThcAssignmentThc0, ///< Port assigned to THC0
> 
> +  ThcAssignmentThc1  ///< Port assigned to THC1
> 
> +} THC_PORT_ASSIGNMENT;
> 
> +
> 
> +
> 
> +/**
> 
> +  Port Configuration structure required for each Port that THC might use.
> 
> +
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32 Assignment;         ///< Sets THCx assignment see
> THC_PORT_ASSIGNMENT
> 
> +  UINT32 InterruptPinMuxing; ///< Each GPIO PORTx/SPIx INTB Pin has
> different muxing options refer to GPIO_*_MUXING_THC_SPIx_*
> 
> +} THC_PORT;
> 
> +
> 
> +/**
> 
> +  THC_CONFIG block provides the configurations forTouch Host Controllers
> 
> +
> 
> +  Assignment field in each THC port controlls the THC behavior.
> 
> +
> 
> +  Available scenarios:
> 
> +  1: Single Port 0 used by THC0
> 
> +      - THC0 Enabled
> 
> +      - Port0 assigned to THC0
> 
> +      - Port1 unassigned
> 
> +      - THC1 will be automatically Disabled.
> 
> +  2: Both ports used by THC0
> 
> +      - THC0 Enabled
> 
> +      - Port0 assigned to THC0
> 
> +      - Port1 assigned to THC0
> 
> +      - THC1 will be automatically Disabled.
> 
> +  3: Port 0 used by THC0 and Port 1 used by THC1
> 
> +      - THC0 Enabled
> 
> +      - Port0 assigned to THC0
> 
> +      - THC1 Enabled
> 
> +      - Port1 assigned to THC1.
> 
> +<b>4: Both Ports unassigned.</b>
> 
> +      Both THC Controllers will be disabled in that case.
> 
> +
> 
> +  @note
> 
> +  Invalid scenario that will cause ASSERT.
> 
> +  1. Same port Number assigned to THC0 or THC1.
> 
> +  2. Two Ports assigned to THC1.
> 
> +
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;           ///< Config Block Header
> 
> +  THC_PORT             ThcPort[2];       ///< Port Configuration
> 
> +} THC_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _THC_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalCon
> fig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalCo
> nfig.h
> new file mode 100644
> index 0000000000..a952f74238
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Thermal/ThermalCo
> nfig.h
> @@ -0,0 +1,153 @@
> +/** @file
> 
> +  Thermal policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _THERMAL_CONFIG_H_
> 
> +#define _THERMAL_CONFIG_H_
> 
> +
> 
> +#define THERMAL_CONFIG_REVISION 1
> 
> +extern EFI_GUID gThermalConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure lists PCH supported throttling register setting for
> custimization.
> 
> +  When the SuggestedSetting is enabled, the customized values are ignored.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32 T0Level                  :  9; ///< Custimized T0Level value. If
> SuggestedSetting is used, this setting is ignored.
> 
> +  UINT32 T1Level                  :  9; ///< Custimized T1Level value. If
> SuggestedSetting is used, this setting is ignored.
> 
> +  UINT32 T2Level                  :  9; ///< Custimized T2Level value. If
> SuggestedSetting is used, this setting is ignored.
> 
> +  UINT32 TTEnable                 :  1; ///< Enable the thermal throttle function. If
> SuggestedSetting is used, this settings is ignored.
> 
> +  /**
> 
> +    When set to 1 and the programmed GPIO pin is a 1, then PMSync state 13
> will force at least T2 state.
> 
> +    If SuggestedSetting is used, this setting is ignored.
> 
> +  **/
> 
> +  UINT32 TTState13Enable          :  1;
> 
> +  /**
> 
> +    When set to 1, this entire register (TL) is locked and remains locked until
> the next platform reset.
> 
> +    If SuggestedSetting is used, this setting is ignored.
> 
> +  **/
> 
> +  UINT32 TTLock                   :  1;
> 
> +  UINT32 SuggestedSetting         :  1; ///< 0: Disable; <b>1: Enable</b>
> suggested representative values.
> 
> +  /**
> 
> +    ULT processors support thermal management and cross thermal throttling
> between the processor package
> 
> +    and LP PCH. The PMSYNC message from PCH to CPU includes specific bit
> fields to update the PCH
> 
> +    thermal status to the processor which is factored into the processor
> throttling.
> 
> +    Enable/Disable PCH Cross Throttling; 0: Disabled, 1: <b>Enabled</b>.
> 
> +  **/
> 
> +  UINT32 PchCrossThrottling       :  1;
> 
> +  UINT32 Rsvd0;                      ///< Reserved bytes
> 
> +} THERMAL_THROTTLE_LEVELS;
> 
> +
> 
> +//
> 
> +// Supported Thermal Sensor Target Width
> 
> +//
> 
> +typedef enum {
> 
> +  DmiThermSensWidthX1  = 0,
> 
> +  DmiThermSensWidthX2  = 1,
> 
> +  DmiThermSensWidthX4  = 2,
> 
> +  DmiThermSensWidthX8  = 3,
> 
> +  DmiThermSensWidthX16 = 4
> 
> +} DMI_THERMAL_SENSOR_TARGET_WIDTH;
> 
> +
> 
> +/**
> 
> +  This structure allows to customize DMI HW Autonomous Width Control for
> Thermal and Mechanical spec design.
> 
> +  When the SuggestedSetting is enabled, the customized values are ignored.
> 
> +  Look at DMI_THERMAL_SENSOR_TARGET_WIDTH for possible values
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  DmiTsawEn               :  1; ///< DMI Thermal Sensor Autonomous
> Width Enable
> 
> +  UINT32  SuggestedSetting        :  1; ///< 0: Disable; <b>1: Enable</b>
> suggested representative values
> 
> +  UINT32  RsvdBits0               :  6; ///< Reserved bits
> 
> +  UINT32  TS0TW                   :  3; ///< Thermal Sensor 0 Target Width
> (<b>DmiThermSensWidthx8</b>)
> 
> +  UINT32  TS1TW                   :  3; ///< Thermal Sensor 1 Target Width
> (<b>DmiThermSensWidthx4</b>)
> 
> +  UINT32  TS2TW                   :  3; ///< Thermal Sensor 2 Target Width
> (<b>DmiThermSensWidthx2</b>)
> 
> +  UINT32  TS3TW                   :  3; ///< Thermal Sensor 3 Target Width
> (<b>DmiThermSensWidthx1</b>)
> 
> +  UINT32  RsvdBits1               : 12; ///< Reserved bits
> 
> +} DMI_HW_WIDTH_CONTROL;
> 
> +
> 
> +/**
> 
> +  This structure configures PCH memory throttling thermal sensor GPIO PIN
> settings
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    GPIO PM_SYNC enable, 0:Diabled, 1:<b>Enabled</b>
> 
> +    When enabled, RC will overrides the selected GPIO native mode.
> 
> +    For GPIO_C, PinSelection 0: CPU_GP_0 (default) or 1: CPU_GP_1
> 
> +    For GPIO_D, PinSelection 0: CPU_GP_3 (default) or 1: CPU_GP_2
> 
> +    For CNL: CPU_GP_0 is GPP_E3, CPU_GP_1 is GPP_E7, CPU_GP_2 is
> GPP_B3, CPU_GP_3 is GPP_B4.
> 
> +  **/
> 
> +  UINT32  PmsyncEnable     :  1;
> 
> +  UINT32  C0TransmitEnable :  1;        ///< GPIO Transmit enable in C0 state,
> 0:Disabled, 1:<b>Enabled</b>
> 
> +  UINT32  PinSelection     :  1;        ///< GPIO Pin assignment selection, <b>0:
> default</b>, 1: secondary
> 
> +  UINT32  RsvdBits0        : 29;
> 
> +} TS_GPIO_PIN_SETTING;
> 
> +
> 
> +enum PCH_PMSYNC_GPIO_X_SELECTION {
> 
> +  TsGpioC,
> 
> +  TsGpioD,
> 
> +  MaxTsGpioPin
> 
> +};
> 
> +
> 
> +/**
> 
> +  This structure supports an external memory thermal sensor (TS-on-DIMM
> or TS-on-Board).
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +   This will enable PCH memory throttling.
> 
> +   While this policy is enabled, must also enable EnableExtts in SA policy.
> 
> +   <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32   Enable           :  1;
> 
> +  UINT32   RsvdBits0        : 31;
> 
> +  /**
> 
> +    GPIO_C and GPIO_D selection for memory throttling.
> 
> +    It's strongly recommended to choose GPIO_C and GPIO_D for memory
> throttling feature,
> 
> +    and route EXTTS# accordingly.
> 
> +  **/
> 
> +  TS_GPIO_PIN_SETTING     TsGpioPinSetting[2];
> 
> +} PCH_MEMORY_THROTTLING;
> 
> +
> 
> +/**
> 
> +  The THERMAL_CONFIG block describes the expected configuration of the
> Thermal IP block.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  UINT32  PchHotEnable            :  1; ///< Enable PCHHOT# pin assertion when
> temperature is higher than PchHotLevel. 0: <b>Disabled<b>, 1: Enabled.
> 
> +  UINT32  RsvdBits0               : 31;
> 
> +  /**
> 
> +    This field decides the settings of Thermal throttling. When the Suggested
> Setting
> 
> +    is enabled, PCH RC will use the suggested representative values.
> 
> +  **/
> 
> +  THERMAL_THROTTLE_LEVELS   TTLevels;
> 
> +  /**
> 
> +    This field decides the settings of DMI throttling. When the Suggested
> Setting
> 
> +    is enabled, PCH RC will use the suggested representative values.
> 
> +  **/
> 
> +  DMI_HW_WIDTH_CONTROL      DmiHaAWC;
> 
> +  /**
> 
> +    Memory Thermal Management settings
> 
> +  **/
> 
> +  PCH_MEMORY_THROTTLING     MemoryThrottling;
> 
> +  /**
> 
> +    The recommendation is the same as Cat Trip point.
> 
> +    This field decides the temperature, default is <b>120</b>.
> 
> +    Temperature value used for PCHHOT# pin assertion based on 2s
> complement format
> 
> +    - 0x001 positive 1'C
> 
> +    - 0x000 0'C
> 
> +    - 0x1FF negative 1'C
> 
> +    - 0x1D8 negative 40'C
> 
> +    - and so on
> 
> +  **/
> 
> +  UINT16                    PchHotLevel;
> 
> +  UINT8                     Rsvd0[6];
> 
> +
> 
> +
> 
> +} THERMAL_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _THERMAL_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHubC
> onfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHub
> Config.h
> new file mode 100644
> index 0000000000..9c315fb4a4
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/TraceHub/TraceHub
> Config.h
> @@ -0,0 +1,101 @@
> +/** @file
> 
> +  Configurations for CPU and PCH trace hub
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _TRACE_HUB_CONFIG_H_
> 
> +#define _TRACE_HUB_CONFIG_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#define CPU_TRACEHUB_PREMEM_CONFIG_REVISION 1
> 
> +#define PCH_TRACEHUB_PREMEM_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gPchTraceHubPreMemConfigGuid;
> 
> +extern EFI_GUID gCpuTraceHubPreMemConfigGuid;
> 
> +
> 
> +typedef enum {
> 
> +  CpuTraceHub,
> 
> +  PchTraceHub
> 
> +} TRACE_HUB_DEVICE;
> 
> +///
> 
> +/// The TRACE_HUB_ENABLE_MODE describes TraceHub mode of
> operation
> 
> +///
> 
> +typedef enum {
> 
> +  TraceHubModeDisabled       = 0,
> 
> +  TraceHubModeTargetDebugger = 1,
> 
> +  TraceHubModeHostDebugger   = 2,
> 
> +  TraceHubModeMax
> 
> +} TRACE_HUB_ENABLE_MODE;
> 
> +
> 
> +///
> 
> +/// The TRACE_BUFFER_SIZE describes the desired TraceHub buffer size
> 
> +///
> 
> +typedef enum {
> 
> +  TraceBufferNone,
> 
> +  TraceBuffer1M,
> 
> +  TraceBuffer8M,
> 
> +  TraceBuffer64M,
> 
> +  TraceBuffer128M,
> 
> +  TraceBuffer256M,
> 
> +  TraceBuffer512M,
> 
> +  TraceBufferMax
> 
> +} TRACE_BUFFER_SIZE;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +///
> 
> +/// TRACE_HUB_CONFIG block describes TraceHub settings
> 
> +///
> 
> +typedef struct {
> 
> +  /**
> 
> +  Trace hub mode. Default is disabled.
> 
> +  Target Debugger mode refers to debug tool running on target device itself
> and it works as a conventional PCI device;
> 
> +  Host Debugger mode refers to SUT debugged via probe on host,
> configured as ACPI device with PCI configuration sapce hidden.
> 
> +  <b>0 = Disable</b>; 1 = Target Debugger mode; 2 = Host Debugger mode
> 
> +  Refer to TRACE_HUB_ENABLE_MODE
> 
> +  **/
> 
> +  UINT8                      EnableMode;
> 
> +  /**
> 
> +  Trace hub memory buffer region size policy.
> 
> +  The avaliable memory size options are: 0:0MB (none), 1:1MB,
> <b>2:8MB</b>, 3:64MB, 4:128MB, 5:256MB, 6:512MB.
> 
> +  Note : Limitation of total buffer size (CPU + PCH) is 512MB. If iTbt is
> enabled, the total size limits to 256 MB.
> 
> +  Refer to TRACE_BUFFER_SIZE
> 
> +  **/
> 
> +  UINT8                      MemReg0Size;
> 
> +  UINT8                      MemReg1Size;
> 
> +  /**
> 
> +  AET Trace. AET base address can be set to FW Base either from CPU trace
> hub or PCH one.
> 
> +  AetEnabled must be exclusive, if AetEnabled = 1 for CPU trace hub, must
> AetEnabled = 0 for PCH one.
> 
> +  The default is set to PCH.
> 
> +  CPU Trace Hub
> 
> +  <b>0 = Disabled</b>; 1 = Enabled
> 
> +  PCH Trace Hub
> 
> +  0 = Disabled; <b>1 = Enabled</b>
> 
> +  **/
> 
> +  UINT8                      AetEnabled;
> 
> +} TRACE_HUB_CONFIG;
> 
> +
> 
> +/**
> 
> +  CPU Trace Hub PreMem Configuration
> 
> +  Contains Trace Hub settings for CPU side tracing
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER        Header;           ///< Config Block Header
> 
> +  TRACE_HUB_CONFIG           TraceHub;         ///< Trace Hub Config
> 
> +} CPU_TRACE_HUB_PREMEM_CONFIG;
> 
> +
> 
> +/**
> 
> +  PCH Trace Hub PreMem Configuration
> 
> +  Contains Trace Hub settings for PCH side tracing
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER        Header;           ///< Config Block Header
> 
> +  TRACE_HUB_CONFIG           TraceHub;         ///< Trace Hub Config
> 
> +} PCH_TRACE_HUB_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.
> h
> new file mode 100644
> index 0000000000..99063103c3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb2PhyConfig.
> h
> @@ -0,0 +1,81 @@
> +/** @file
> 
> +  USB2 PHY configuration policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _USB2_PHY_CONFIG_H_
> 
> +#define _USB2_PHY_CONFIG_H_
> 
> +
> 
> +#include <UsbConfig.h>
> 
> +
> 
> +#define USB2_PHY_CONFIG_REVISION 1
> 
> +extern EFI_GUID gUsb2PhyConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure configures per USB2 AFE settings.
> 
> +  It allows to setup the port electrical parameters.
> 
> +**/
> 
> +typedef struct {
> 
> +/** Per Port HS Preemphasis Bias (PERPORTPETXISET)
> 
> +  000b - 0mV
> 
> +  001b - 11.25mV
> 
> +  010b - 16.9mV
> 
> +  011b - 28.15mV
> 
> +  100b - 28.15mV
> 
> +  101b - 39.35mV
> 
> +  110b - 45mV
> 
> +  111b - 56.3mV
> 
> +**/
> 
> +  UINT8   Petxiset;
> 
> +/** Per Port HS Transmitter Bias (PERPORTTXISET)
> 
> +  000b - 0mV
> 
> +  001b - 11.25mV
> 
> +  010b - 16.9mV
> 
> +  011b - 28.15mV
> 
> +  100b - 28.15mV
> 
> +  101b - 39.35mV
> 
> +  110b - 45mV
> 
> +  111b - 56.3mV
> 
> +**/
> 
> +  UINT8   Txiset;
> 
> +/**
> 
> +  Per Port HS Transmitter Emphasis (IUSBTXEMPHASISEN)
> 
> +  00b - Emphasis OFF
> 
> +  01b - De-emphasis ON
> 
> +  10b - Pre-emphasis ON
> 
> +  11b - Pre-emphasis & De-emphasis ON
> 
> +**/
> 
> +  UINT8   Predeemp;
> 
> +/**
> 
> +  Per Port Half Bit Pre-emphasis (PERPORTTXPEHALF)
> 
> +  1b - half-bit pre-emphasis
> 
> +  0b - full-bit pre-emphasis
> 
> +**/
> 
> +  UINT8   Pehalfbit;
> 
> +} USB2_PHY_PARAMETERS;
> 
> +
> 
> +/**
> 
> +  This structure holds info on how to tune electrical parameters of USB2
> ports based on board layout
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    This structure configures per USB2 port physical settings.
> 
> +    It allows to setup the port location and port length, and configures the
> port strength accordingly.
> 
> +    Changing this policy values from default ones may require disabling USB2
> PHY Sus Well Power Gating
> 
> +    through Usb2PhySusPgEnable on PCH-LP
> 
> +  **/
> 
> +  USB2_PHY_PARAMETERS          Port[MAX_USB2_PORTS];
> 
> +} USB2_PHY_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _USB2_PHY_CONFIG_H_
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig
> .h
> new file mode 100644
> index 0000000000..da816b1378
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/Usb3HsioConfig
> .h
> @@ -0,0 +1,138 @@
> +/** @file
> 
> +  USB3 Mod PHY configuration policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _USB3_HSIO_CONFIG_H_
> 
> +#define _USB3_HSIO_CONFIG_H_
> 
> +
> 
> +#include <UsbConfig.h>
> 
> +
> 
> +#define USB3_HSIO_CONFIG_REVISION 2
> 
> +extern EFI_GUID gUsb3HsioConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure describes USB3 Port N configuration parameters
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    USB 3.0 TX Output Downscale Amplitude Adjustment (orate01margin)
> 
> +    HSIO_TX_DWORD8[21:16]
> 
> +    <b>Default = 00h</b>
> 
> +  **/
> 
> +  UINT8  HsioTxDownscaleAmp;
> 
> +  /**
> 
> +    USB 3.0 TX Output -3.5dB De-Emphasis Adjustment Setting
> (ow2tapgen2deemph3p5)
> 
> +    HSIO_TX_DWORD5[21:16]
> 
> +    <b>Default = 29h</b> (approximately -3.5dB De-Emphasis)
> 
> +  **/
> 
> +  UINT8  HsioTxDeEmph;
> 
> +  /**
> 
> +    Signed Magnatude number added to the CTLE
> code.(ctle_adapt_offset_cfg_4_0)
> 
> +    HSIO_RX_DWORD25 [20:16]
> 
> +    Ex: -1 -- 1_0001. +1: 0_0001
> 
> +    <b>Default = 0h</b>
> 
> +  **/
> 
> +  UINT8  HsioCtrlAdaptOffsetCfg;
> 
> +  /**
> 
> +    LFPS filter select for n (filter_sel_n_2_0)
> 
> +    HSIO_RX_DWORD51 [29:27]
> 
> +    0h:1.6ns
> 
> +    1h:2.4ns
> 
> +    2h:3.2ns
> 
> +    3h:4.0ns
> 
> +    4h:4.8ns
> 
> +    5h:5.6ns
> 
> +    6h:6.4ns
> 
> +    <b>Default = 0h</b>
> 
> +  **/
> 
> +  UINT8  HsioFilterSelN;
> 
> +  /**
> 
> +    LFPS filter select for p (filter_sel_p_2_0)
> 
> +    HSIO_RX_DWORD51 [26:24]
> 
> +    0h:1.6ns
> 
> +    1h:2.4ns
> 
> +    2h:3.2ns
> 
> +    3h:4.0ns
> 
> +    4h:4.8ns
> 
> +    5h:5.6ns
> 
> +    6h:6.4ns
> 
> +    <b>Default = 0h</b>
> 
> +  **/
> 
> +  UINT8  HsioFilterSelP;
> 
> +  /**
> 
> +    Controls the input offset (olfpscfgpullupdwnres_sus_usb_2_0)
> 
> +    HSIO_RX_DWORD51 [2:0]
> 
> +    000 Prohibited
> 
> +    001 45K
> 
> +    010 Prohibited
> 
> +    011 31K
> 
> +    100 36K
> 
> +    101 36K
> 
> +    110 36K
> 
> +    111 36K
> 
> +    <b>Default = 3h</b>
> 
> +  **/
> 
> +  UINT8  HsioOlfpsCfgPullUpDwnRes;
> 
> +
> 
> +  UINT8  HsioTxDeEmphEnable;             ///< Enable the write to USB 3.0 TX
> Output -3.5dB De-Emphasis Adjustment, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioTxDownscaleAmpEnable;       ///< Enable the write to USB 3.0
> TX Output Downscale Amplitude Adjustment, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioCtrlAdaptOffsetCfgEnable;   ///< Enable the write to Signed
> Magnatude number added to the CTLE code, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioFilterSelNEnable;           ///< Enable the write to LFPS filter select
> for n, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioFilterSelPEnable;           ///< Enable the write to LFPS filter select
> for p, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioOlfpsCfgPullUpDwnResEnable; ///< Enable the write to
> olfpscfgpullupdwnres, <b>0: Disable</b>; 1: Enable.
> 
> +  /**
> 
> +    USB 3.0 TX Output - Unique Transition Bit Scale for rate 3
> (rate3UniqTranScale)
> 
> +    HSIO_TX_DWORD9[6:0]
> 
> +    <b>Default = 4Ch</b>
> 
> +  **/
> 
> +  UINT8  HsioTxRate3UniqTran;
> 
> +  /**
> 
> +    USB 3.0 TX Output -Unique Transition Bit Scale for rate 2
> (rate2UniqTranScale)
> 
> +    HSIO_TX_DWORD9[14:8]
> 
> +    <b>Default = 4Ch</b>
> 
> +  **/
> 
> +  UINT8  HsioTxRate2UniqTran;
> 
> +  /**
> 
> +    USB 3.0 TX Output - Unique Transition Bit Scale for rate 1
> (rate1UniqTranScale)
> 
> +    HSIO_TX_DWORD9[22:16]
> 
> +    <b>Default = 4Ch</b>
> 
> +  **/
> 
> +  UINT8  HsioTxRate1UniqTran;
> 
> +  /**
> 
> +    USB 3.0 TX Output - Unique Transition Bit Scale for rate 0
> (rate0UniqTranScale)
> 
> +    HSIO_TX_DWORD9[30:24]
> 
> +    <b>Default = 4Ch</b>
> 
> +  **/
> 
> +  UINT8  HsioTxRate0UniqTran;
> 
> +
> 
> +  UINT8  HsioTxRate3UniqTranEnable; ///< Enable the write to USB 3.0 TX
> Unique Transition Bit Mode for rate 3, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioTxRate2UniqTranEnable; ///< Enable the write to USB 3.0 TX
> Unique Transition Bit Mode for rate 2, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioTxRate1UniqTranEnable; ///< Enable the write to USB 3.0 TX
> Unique Transition Bit Mode for rate 1, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  HsioTxRate0UniqTranEnable; ///< Enable the write to USB 3.0 TX
> Unique Transition Bit Mode for rate 0, <b>0: Disable</b>; 1: Enable.
> 
> +} HSIO_PARAMETERS;
> 
> +
> 
> +/**
> 
> +  Structure for holding USB3 tuning parameters
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - USB 3.0 TX Output Unique Transition Bit Scale policies added
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    These members describe whether the USB3 Port N of PCH is enabled by
> platform modules.
> 
> +  **/
> 
> +  HSIO_PARAMETERS         Port[MAX_USB3_PORTS];
> 
> +} USB3_HSIO_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _USB3_HSIO_CONFIG_H_
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
> new file mode 100644
> index 0000000000..a1c7f0bb04
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Usb/UsbConfig.h
> @@ -0,0 +1,149 @@
> +/** @file
> 
> +  Common USB policy shared between PCH and CPU
> 
> +  Contains general features settings for xHCI and xDCI
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _USB_CONFIG_H_
> 
> +#define _USB_CONFIG_H_
> 
> +
> 
> +#define USB_CONFIG_REVISION 2
> 
> +extern EFI_GUID gUsbConfigGuid;
> 
> +
> 
> +#define MAX_USB2_PORTS  16
> 
> +#define MAX_USB3_PORTS  10
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +typedef UINT8                   USB_OVERCURRENT_PIN;
> 
> +#define USB_OC_SKIP             0xFF
> 
> +#define USB_OC_MAX_PINS         16       ///< Total OC pins number (both
> physical and virtual)
> 
> +
> 
> +/**
> 
> +  This structure configures per USB2.0 port settings like enabling and
> overcurrent protection
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    These members describe the specific over current pin number of USB 2.0
> Port N.
> 
> +    It is SW's responsibility to ensure that a given port's bit map is set only for
> 
> +    one OC pin Description. USB2 and USB3 on the same combo Port must
> use the same OC pin.
> 
> +  **/
> 
> +  UINT32     OverCurrentPin          :  8;
> 
> +  UINT32     Enable                  :  1;     ///< 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32     PortResetMessageEnable  :  1;     ///< 0: Disable USB2 Port Reset
> Message; 1: Enable USB2 Port Reset Message
> 
> +  UINT32     RsvdBits0               : 22;     ///< Reserved bits
> 
> +} USB2_PORT_CONFIG;
> 
> +
> 
> +/**
> 
> +  This structure configures per USB3.x port settings like enabling and
> overcurrent protection
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    These members describe the specific over current pin number of USB 3.x
> Port N.
> 
> +    It is SW's responsibility to ensure that a given port's bit map is set only for
> 
> +    one OC pin Description. USB2 and USB3 on the same combo Port must
> use the same OC pin.
> 
> +  **/
> 
> +  UINT32  OverCurrentPin               :  8;
> 
> +  UINT32  Enable                       :  1; ///< 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32  RsvdBits0                    : 23; ///< Reserved bits
> 
> +} USB3_PORT_CONFIG;
> 
> +
> 
> +/**
> 
> +  The XDCI_CONFIG block describes the configurations
> 
> +  of the xDCI Usb Device controller.
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member describes whether or not the xDCI controller should be
> enabled.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32  Enable              :  1;
> 
> +  UINT32  RsvdBits0           : 31;     ///< Reserved bits
> 
> +} XDCI_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  This member describes the expected configuration of the USB controller,
> 
> +  Platform modules may need to refer Setup options, schematic, BIOS
> specification to update this field.
> 
> +  The Usb20OverCurrentPins and Usb30OverCurrentPins field must be
> updated by referring the schematic.
> 
> +
> 
> +  <b>Revision 1</b>: - Initial version.
> 
> +  <b>Revision 2</b>: - Add USB3LinkSpeed
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER     Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    This policy option when set will make BIOS program Port Disable Override
> register during PEI phase.
> 
> +    When disabled BIOS will not program the PDO during PEI phase and leave
> PDO register unlocked for later programming.
> 
> +    If this is disabled, platform code MUST set it before booting into OS.
> 
> +    <b>1: Enable</b>
> 
> +    0: Disable
> 
> +  **/
> 
> +  UINT32                  PdoProgramming               :  1;
> 
> +  /**
> 
> +    This option allows for control whether USB should program the
> Overcurrent Pins mapping into xHCI.
> 
> +    Disabling this feature will disable overcurrent detection functionality.
> 
> +    Overcurrent Pin mapping data is contained in respective port structures
> (i.e. USB30_PORT_CONFIG) in OverCurrentPin field.
> 
> +    By default this Overcurrent functionality should be enabled and disabled
> only for OBS debug usage.
> 
> +    <b>1: Will program USB OC pin mapping in respective xHCI controller
> registers</b>
> 
> +    0: Will clear OC pin mapping allow for OBS usage of OC pins
> 
> +  **/
> 
> +  UINT32                  OverCurrentEnable            :  1;
> 
> +  /**
> 
> +    <b>(Test)</b>
> 
> +    If this policy option is enabled then BIOS will program OCCFDONE bit in
> xHCI meaning that OC mapping data will be
> 
> +    consumed by xHCI and OC mapping registers will be locked. OverCurrent
> mapping data is taken from respective port data
> 
> +    structure from OverCurrentPin field.
> 
> +    If EnableOverCurrent policy is enabled this also should be enabled,
> otherwise xHCI won't consume OC mapping data.
> 
> +    <b>1: Program OCCFDONE bit and make xHCI consume OverCurrent
> mapping data</b>
> 
> +    0: Do not program OCCFDONE bit making it possible to use OBS debug on
> OC pins.
> 
> +  **/
> 
> +  UINT32                  XhciOcLock                   :  1;
> 
> +  /**
> 
> +    Enabling this feature will allow for overriding LTR values for xHCI
> controller.
> 
> +    Values used for programming will be taken from this config block and
> BIOS will disregard recommended ones.
> 
> +    <b>0: disable - do not override recommended LTR values</b>
> 
> +    1: enable - override recommended LTR values
> 
> +  **/
> 
> +  UINT32                  LtrOverrideEnable            :  1;
> 
> +  /**
> 
> +    This setting enable LBPM GEN1 speed
> 
> +    0: GEN2;
> 
> +    1: GEN1;
> 
> +  **/
> 
> +  UINT32                  USB3LinkSpeed                : 1;
> 
> +  UINT32                  RsvdBits0                    : 27;     ///< Reserved bits
> 
> +  /**
> 
> +    High Idle Time Control override value
> 
> +    This setting is used only if LtrOverrideEnable is enabled
> 
> +  **/
> 
> +  UINT32                  LtrHighIdleTimeOverride;
> 
> +  /**
> 
> +    Medium Idle Time Control override value
> 
> +    This setting is used only if LtrOverrideEnable is enabled
> 
> +  **/
> 
> +  UINT32                  LtrMediumIdleTimeOverride;
> 
> +  /**
> 
> +    Low Idle Time Control override value
> 
> +    This setting is used only if LtrOverrideEnable is enabled
> 
> +  **/
> 
> +  UINT32                  LtrLowIdleTimeOverride;
> 
> +  /**
> 
> +    These members describe whether the USB2 Port N of PCH is enabled by
> platform modules.
> 
> +  **/
> 
> +  USB2_PORT_CONFIG        PortUsb20[MAX_USB2_PORTS];
> 
> +  /**
> 
> +    These members describe whether the USB3 Port N of PCH is enabled by
> platform modules.
> 
> +  **/
> 
> +  USB3_PORT_CONFIG        PortUsb30[MAX_USB3_PORTS];
> 
> +  /**
> 
> +    This member describes whether or not the xDCI controller should be
> enabled.
> 
> +  **/
> 
> +  XDCI_CONFIG             XdciConfig;
> 
> +
> 
> +} USB_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _USB_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/Cp
> uPowerMgmtVrConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/Cp
> uPowerMgmtVrConfig.h
> new file mode 100644
> index 0000000000..8b01ecd262
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/VoltageRegulator/Cp
> uPowerMgmtVrConfig.h
> @@ -0,0 +1,114 @@
> +/** @file
> 
> +  CPU Power Management VR Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POWER_MGMT_VR_CONFIG_H_
> 
> +#define _CPU_POWER_MGMT_VR_CONFIG_H_
> 
> +
> 
> +#define CPU_POWER_MGMT_VR_CONFIG_REVISION 7
> 
> +
> 
> +extern EFI_GUID gCpuPowerMgmtVrConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// Defines the maximum number of VR domains supported.
> 
> +/// @warning: Changing this define would cause DWORD alignment issues
> in policy structures.
> 
> +///
> 
> +#define MAX_NUM_VRS         5
> 
> +
> 
> +/**
> 
> +  CPU Power Management VR Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Updated Acoustic Noise Mitigation.
> 
> +  <b>Revision 3</b>:
> 
> +  - Deprecate PsysOffset and added PsysOffset1 for Psys Offset Correction
> 
> +  <b>Revision 4</b>:
> 
> +  - Deprecate TdcTimeWindow and added TdcTimeWindow1 for TDC Time
> 
> +    Added Irms support.
> 
> +  <b>Revision 5</b>:
> 
> +  - Add RfiMitigation.
> 
> +  <b>Revision 6</b>:
> 
> +  - Added an option to Enable/Disable FIVR Spread Spectrum
> 
> +  <b>Revision 7</b>:
> 
> +  - Add Dynamic Periodicity Alteration (DPA) tuning feature
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  UINT32 AcousticNoiseMitigation        : 1;      ///< Enable or Disable Acoustic
> Noise Mitigation feature. <b>0: Disabled</b>; 1: Enabled
> 
> +  /**
> 
> +   VR specific mailbox commands.
> 
> +   <b>00b - no VR specific command sent.</b>
> 
> +   01b - A VR mailbox command specifically for the MPS IMPV8 VR will be
> sent.
> 
> +   10b - VR specific command sent for PS4 exit issue.
> 
> +   11b - Reserved.
> 
> +   **/
> 
> +  UINT32 SendVrMbxCmd                   : 2;
> 
> +  UINT32 EnableMinVoltageOverride       : 1;      ///< Enable or disable
> Minimum Voltage override for minimum voltage runtime and minimum
> voltage C8. <b>0: Disabled</b> 1: Enabled.
> 
> +  UINT32 RfiMitigation                  : 1;      ///< Enable or Disable RFI Mitigation.
> <b>0: Disable - DCM is the IO_N default</b>; 1: Enable - Enable IO_N
> DCM/CCM switching as RFI mitigation.
> 
> +  UINT32 RsvdBits                       : 27;     ///< Reserved for future use.
> 
> +  UINT8  PsysSlope;                               ///< PCODE MMIO Mailbox: Platform
> Psys slope correction. <b>0: Auto</b> Specified in 1/100 increment values.
> Range is 0-200. 125 = 1.25.
> 
> +  UINT8  PsysOffset;                              ///< PCODE MMIO Mailbox: Platform
> Psys offset correction. <b>0: Auto</b> Units 1/4, Range 0-255. Value of 100 =
> 100/4 = 25 offset. Deprecated
> 
> +  UINT8  FivrSpreadSpectrum;                      ///< Set the Spread Spectrum
> Range. <b>1.5%</b>, Range: 0.5%, 1%, 1.5%, 2%, 3%, 4%, 5%, 6%. Each
> Range is translated to internally encoded values. 0.5% = 0, 1% = 3, 1.5% = 8,
> 2% = 18, 3% = 28, 4% = 34, 5% = 39, 6% = 44.
> 
> +  UINT8  RsvdBytes0;
> 
> +  /**
> 
> +   PCODE MMIO Mailbox: Set the desired RFI frequency, in increments of
> 100KHz.
> 
> +   <b>0: Auto</b>
> 
> +   Range varies based on XTAL clock:
> 
> +    - 0-1918 (Up to 191.8HMz) for 24MHz clock.
> 
> +    - 0-1535 (Up to 153.5MHz) for 19MHz clock.
> 
> +  **/
> 
> +  UINT16 FivrRfiFrequency;
> 
> +  UINT8  RsvdBytes1[2];
> 
> +  /** @name VR Settings
> 
> +  The VR related settings are sorted in an array where each index maps to
> the VR domain as defined below:
> 
> +   - 0 = System Agent VR
> 
> +   - 1 = IA Core VR
> 
> +   - 2 = Ring Vr
> 
> +   - 3 = GT VR
> 
> +   - 4 = FIVR VR
> 
> +
> 
> +  The VR settings for a given domain must be populated in the appropriate
> index.
> 
> +  **/
> 
> +  ///@{
> 
> +  UINT16 TdcCurrentLimit[MAX_NUM_VRS];            ///< PCODE MMIO
> Mailbox: Thermal Design Current current limit. Specified in 1/8A units. Range
> is 0-4095. 1000 = 125A. <b>0: 0 Amps</b>
> 
> +  UINT16 AcLoadline[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox:
> AcLoadline in 1/100 mOhms (ie. 1250 = 12.50 mOhm); Range is 0-6249.
> <b>Intel Recommended Defaults vary by domain and SKU.</b>
> 
> +  UINT16 DcLoadline[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox:
> DcLoadline in 1/100 mOhms (ie. 1250 = 12.50 mOhm); Range is 0-
> 6249.<b>Intel Recommended Defaults vary by domain and SKU.</b>
> 
> +  UINT16 Psi1Threshold[MAX_NUM_VRS];              ///< PCODE MMIO
> Mailbox: Power State 1 current cuttof in 1/4 Amp increments. Range is 0-
> 128A.
> 
> +  UINT16 Psi2Threshold[MAX_NUM_VRS];              ///< PCODE MMIO
> Mailbox: Power State 2 current cuttof in 1/4 Amp increments. Range is 0-
> 128A.
> 
> +  UINT16 Psi3Threshold[MAX_NUM_VRS];              ///< PCODE MMIO
> Mailbox: Power State 3 current cuttof in 1/4 Amp increments. Range is 0-
> 128A.
> 
> +  INT16  ImonOffset[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox:
> Imon offset correction. Value is a 2's complement signed integer. Units
> 1/1000, Range 0-63999. For an offset = 12.580, use 12580. <b>0: Auto</b>
> 
> +  UINT16 IccMax[MAX_NUM_VRS];                     ///< PCODE MMIO Mailbox:
> VR Icc Max limit. 0-255A in 1/4 A units. 400 = 100A. <b>Default: 0 - Auto, no
> override</b>
> 
> +  UINT16 VrVoltageLimit[MAX_NUM_VRS];             ///< PCODE MMIO
> Mailbox: VR Voltage Limit. Range is 0-7999mV.
> 
> +  UINT16 ImonSlope[MAX_NUM_VRS];                  ///< PCODE MMIO Mailbox:
> Imon slope correction. Specified in 1/100 increment values. Range is 0-200.
> 125 = 1.25. <b>0: Auto</b>
> 
> +  UINT8  Psi3Enable[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox:
> Power State 3 enable/disable; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT8  Psi4Enable[MAX_NUM_VRS];                 ///< PCODE MMIO Mailbox:
> Power State 4 enable/disable; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT8  VrConfigEnable[MAX_NUM_VRS];             ///< Enable/Disable BIOS
> configuration of VR; 0: Disable; <b>1: Enable.</b>
> 
> +  UINT8  TdcEnable[MAX_NUM_VRS];                  ///< PCODE MMIO Mailbox:
> Thermal Design Current enable/disable; <b>0: Disable; </b>1: Enable
> 
> +  UINT8  TdcTimeWindow[MAX_NUM_VRS];              ///< @deprecated.
> PCODE MMIO Mailbox: Thermal Design Current time window. Defined in milli
> seconds. <b>1ms default</b>
> 
> +  UINT8  TdcLock[MAX_NUM_VRS];                    ///< PCODE MMIO Mailbox:
> Thermal Design Current Lock; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  FastPkgCRampDisable[MAX_NUM_VRS];        ///< Disable Fast Slew
> Rate for Deep Package C States for VR IA,GT,SA,VLCC,FIVR domain based on
> Acoustic Noise Mitigation feature enabled. <b>0: False</b>; 1: True
> 
> +  UINT8  SlowSlewRate[MAX_NUM_VRS];               ///< Slew Rate
> configuration for Deep Package C States for VR VR IA,GT,SA,VLCC,FIVR
> domain based on Acoustic Noise Mitigation feature enabled. <b>0:
> Fast/2</b>; 1: Fast/4; 2: Fast/8; 3: Fast/16
> 
> +  ///@}
> 
> +  UINT16 MinVoltageRuntime;                       ///< PCODE MMIO Mailbox:
> Minimum voltage for runtime. Valid if EnableMinVoltageOverride = 1 .Range
> 0 to 1999mV. <b> 0: 0mV </b>
> 
> +  UINT16 MinVoltageC8;                            ///< PCODE MMIO Mailbox: Minimum
> voltage for C8. Valid if EnableMinVoltageOverride = 1. Range 0 to 1999mV.
> <b> 0: 0mV </b>
> 
> +  UINT16 PsysOffset1;                             ///< PCODE MMIO Mailbox: Platform
> Psys offset correction. <b>0: Auto</b> Units 1/1000, Range 0-63999. For an
> offset of 25.348, enter 25348.
> 
> +  UINT8  RsvdBytes2[2];
> 
> +  UINT32 TdcTimeWindow1[MAX_NUM_VRS];             ///< PCODE MMIO
> Mailbox: Thermal Design Current time window. Defined in milli seconds.
> <b>1ms default</b>
> 
> +  UINT8  Irms[MAX_NUM_VRS];                       ///< PCODE MMIO Mailbox:
> Current root mean square. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT8  FivrSpectrumEnable;                      ///< Enable or Disable FIVR Spread
> Spectrum 0: Disable; <b> 1: Enable.</b>
> 
> +  UINT8  Rsvd1[2];
> 
> +  UINT8  PreWake;                                 ///< PCODE MMIO Mailbox: Acoustic
> Noise Mitigation Range. This can be programmed only if
> AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b>
> Defines the max pre-wake randomization time in micro ticks. Range is 0-255.
> 
> +  UINT8  RampUp;                                  ///< PCODE MMIO Mailbox: Acoustic
> Noise Mitigation Range. This can be programmed only if
> AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b>
> Defines the max ramp up randomization time in micro ticks. Range is 0-255.
> 
> +  UINT8  RampDown;                                ///< PCODE MMIO Mailbox: Acoustic
> Noise Mitigation Range. This can be programmed only if
> AcousticNoiseMitigation is enabled.<b>Default Value = 0 micro ticks</b>
> Defines the max ramp down randomization time in micro ticks. Range is 0-
> 255.
> 
> +  UINT8  Rsvd2[1];
> 
> +} CPU_POWER_MGMT_VR_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_POWER_MGMT_VR_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
> new file mode 100644
> index 0000000000..74ca983a5d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Vtd/VtdConfig.h
> @@ -0,0 +1,64 @@
> +/** @file
> 
> +  VT-d policy definitions.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _VTD_CONFIG_H_
> 
> +#define _VTD_CONFIG_H_
> 
> +
> 
> +#include <Library/VtdInfoLib.h>
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define VTD_CONFIG_REVISION 1
> 
> +#define VTD_DXE_CONFIG_REVISION 2
> 
> +
> 
> +/**
> 
> +  The data elements should be initialized by a Platform Module.
> 
> +  The data structure is for VT-d driver initialization\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;                      ///< Offset 0-27 Config Block
> Header
> 
> +  /**
> 
> +    Offset 28:
> 
> +    VT-D Support can be verified by reading CAP ID register as expalined in
> BIOS Spec.
> 
> +    This policy is for debug purpose only.
> 
> +    If VT-D is not supported, all other policies in this config block will be
> ignored.
> 
> +    <b>0 = To use Vt-d</b>;
> 
> +    1 = Avoids programming Vtd bars, Vtd overrides and DMAR table.
> 
> +  **/
> 
> +  UINT8        VtdDisable;
> 
> +  UINT8        X2ApicOptOut;        ///< Offset 29 :This field is used to enable the
> X2APIC_OPT_OUT bit in the DMAR table. 1=Enable/Set and
> <b>0=Disable/Clear</b>
> 
> +  UINT8        DmaControlGuarantee; ///< Offset 30 :This field is used to
> enable the DMA_CONTROL_GUARANTEE bit in the DMAR table.
> 1=Enable/Set and <b>0=Disable/Clear</b>
> 
> +  UINT8        VtdIgdEnable;        ///< Offset 31 :This field is used to enable the
> VtdIgdEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
> 
> +  UINT8        VtdIpuEnable;        ///< Offset 32 :This field is used to enable the
> VtdIpuEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
> 
> +  UINT8        VtdIopEnable;        ///< Offset 33 :This field is used to enable the
> VtdIopEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
> 
> +  UINT8        VtdItbtEnable;       ///< Offset 34 :This field is used to enable the
> VtdItbtEnable Policy. 1=Enable/Set and <b>0=Disable/Clear</b>
> 
> +  UINT8        PreBootDmaMask;      ///< Offset 35 :Convey
> PcdVTdPolicyPropertyMask value from EDK2 IntelSiliconPkg
> 
> +  /**
> 
> +    Offset 36:
> 
> +    This field is used to describe the base addresses for VT-d function:\n
> 
> +    VTD BAR for Gfx if IGfx is supported : <b>BaseAddress[0]=0xFED90000,\n
> 
> +    VTD BAR for IPU if IPU is supporrted : BaseAddress[1]=0xFED92000,\n
> 
> +    VTD BAR for other DMA Agents (except Igfx and IPU) :
> BaseAddress[2]=0xFED91000,\n
> 
> +    VTD BAR for iTBT if iTBT is supported : BaseAddress[3]=0xFED84000,
> BaseAddress[4]=0xFED85000,
> BaseAddress[5]=0xFED86000,BaseAddress[6]=0xFED87000</b>
> 
> +  **/
> 
> +  UINT32       BaseAddress[VTD_ENGINE_NUMBER];
> 
> +  UINT32       DmaBufferSize;      ///< Offset 64 :Protect Memory Region
> (PMR) DMA buffer size
> 
> +
> 
> +
> 
> +} VTD_CONFIG;
> 
> +
> 
> +/**
> 
> +  The data structure is for VT-d driver initialization in DXE\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                    ///< Offset 0-27 Config Block
> Header
> 
> +} VTD_DXE_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif   //  _VTD_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfi
> g.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfi
> g.h
> new file mode 100644
> index 0000000000..8766762580
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock/Wdt/WatchDogConfi
> g.h
> @@ -0,0 +1,31 @@
> +/** @file
> 
> +  WatchDog policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _WATCH_DOG_CONFIG_H_
> 
> +#define _WATCH_DOG_CONFIG_H_
> 
> +
> 
> +#define WATCH_DOG_PREMEM_CONFIG_REVISION 1
> 
> +extern EFI_GUID gWatchDogPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This policy clears status bits and disable watchdog, then lock the
> 
> +  WDT registers.
> 
> +  while WDT is designed to be disabled and locked by Policy,
> 
> +  bios should not enable WDT by WDT PPI. In such case, bios shows the
> 
> +  warning message but not disable and lock WDT register to make sure
> 
> +  WDT event trigger correctly.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  UINT32    DisableAndLock    :  1;     ///< <b>(Test)</b> Set 1 to clear WDT
> status, then disable and lock WDT registers. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32    RsvdBits          : 31;
> 
> +} PCH_WDT_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _WATCH_DOG_CONFIG_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec
> new file mode 100644
> index 0000000000..0982758b77
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkg.dec
> @@ -0,0 +1,1208 @@
> +## @file
> 
> +#  Component description file for the Silicon Reference Code.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +DEC_SPECIFICATION = 0x00010017
> 
> +PACKAGE_NAME = SiPkg
> 
> +PACKAGE_VERSION = 0.1
> 
> +PACKAGE_GUID = F245E276-44A0-46b3-AEB5-9898BBCF008D
> 
> +
> 
> +[Includes.Common.Private]
> 
> +
> 
> +#
> 
> +# TigerLake Fru
> 
> +#
> 
> +Fru/TglCpu/IncludePrivate
> 
> +Fru/TglPch/IncludePrivate
> 
> +
> 
> +##
> 
> +# IpBlock IncludePrivate
> 
> +#
> 
> +IpBlock/Psf/IncludePrivate
> 
> +IpBlock/Pmc/IncludePrivate
> 
> +IpBlock/Smbus/IncludePrivate
> 
> +IpBlock/Graphics/IncludePrivate
> 
> +IpBlock/CpuPcieRp/IncludePrivate
> 
> +IpBlock/Hda/IncludePrivate
> 
> +IpBlock/PchDmi/IncludePrivate
> 
> +IpBlock/P2sb/IncludePrivate
> 
> +IpBlock/Spi/IncludePrivate
> 
> +IpBlock/Gpio/IncludePrivate
> 
> +IpBlock/Cnvi/IncludePrivate
> 
> +IpBlock/Gbe/IncludePrivate
> 
> +IpBlock/PcieRp/IncludePrivate
> 
> +IpBlock/Vtd/IncludePrivate
> 
> +IpBlock/HostBridge/IncludePrivate
> 
> +IpBlock/SerialIo/IncludePrivate
> 
> +
> 
> +SystemAgent/IncludePrivate
> 
> +
> 
> +Pch/IncludePrivate
> 
> +
> 
> +[Includes]
> 
> +#
> 
> +# TigerLake
> 
> +#
> 
> +Fru/TglCpu/Include
> 
> +Fru/TglPch/Include
> 
> +
> 
> +# CPU PCIe
> 
> +IpBlock/CpuPcieRp/Include
> 
> +
> 
> +IpBlock/Gpio/Include
> 
> +
> 
> +
> 
> +##
> 
> +#
> 
> +# This section is for IP ConfigBlock versions control
> 
> +#
> 
> +# - Memory
> 
> +Include/ConfigBlock/Memory/Ver2
> 
> +#
> 
> +# - Graphics
> 
> +Include/ConfigBlock/Graphics/Gen12
> 
> +#
> 
> +# - CPU PCIe
> 
> +Include/ConfigBlock/CpuPcieRp/Gen4
> 
> +Include/ConfigBlock/CpuDmi
> 
> +
> 
> +# - Hybrid Graphics
> 
> +Include/ConfigBlock/HybridGraphics
> 
> +
> 
> +Include
> 
> +#
> 
> +# SystemAgent
> 
> +#
> 
> +SystemAgent/Include
> 
> +SystemAgent/AcpiTables
> 
> +SystemAgent/AcpiTables/SaSsdt
> 
> +Include/ConfigBlock/Vtd
> 
> +Include/ConfigBlock/PcieRp
> 
> +Include/ConfigBlock/Gna
> 
> +Include/ConfigBlock/CpuPcieRp/Gen4
> 
> +Include/ConfigBlock/CpuPcieRp/Gen3
> 
> +Include/ConfigBlock/CpuDmi
> 
> +Include/ConfigBlock/HybridGraphics
> 
> +Include/ConfigBlock/HostBridge
> 
> +#
> 
> +# Cpu
> 
> +#
> 
> +Cpu/Include
> 
> +Include/ConfigBlock/Overclocking
> 
> +Include/ConfigBlock/VoltageRegulator
> 
> +
> 
> +#
> 
> +# Pch
> 
> +#
> 
> +Pch/Include
> 
> +Include/ConfigBlock/Thermal
> 
> +Include/ConfigBlock/P2sb
> 
> +Include/ConfigBlock/Ish
> 
> +Include/ConfigBlock/Usb
> 
> +Include/ConfigBlock/Espi
> 
> +Include/ConfigBlock/Fivr
> 
> +Include/ConfigBlock/Rtc
> 
> +Include/ConfigBlock/Smbus
> 
> +Include/ConfigBlock/Pmc
> 
> +Include/ConfigBlock/Itss
> 
> +Include/ConfigBlock/Scs
> 
> +Include/ConfigBlock/Hda
> 
> +Include/ConfigBlock/Sata
> 
> +Include/ConfigBlock/Rst
> 
> +Include/ConfigBlock/Ieh
> 
> +Include/ConfigBlock/Me
> 
> +Include/ConfigBlock/PchDmi
> 
> +Include/ConfigBlock/Gpio
> 
> +Include/ConfigBlock/Dci
> 
> +Include/ConfigBlock/Cnvi
> 
> +Include/ConfigBlock/Gbe
> 
> +Include/ConfigBlock/TraceHub
> 
> +Include/ConfigBlock/Thc
> 
> +Include/ConfigBlock/Wdt
> 
> +Include/ConfigBlock/PcieRp/PchPcieRp
> 
> +Include/ConfigBlock/PcieRp
> 
> +Include/ConfigBlock/Psf
> 
> +Include/ConfigBlock/SerialIo
> 
> +Include/ConfigBlock/HybridStorage
> 
> +Include/ConfigBlock/Spi
> 
> +
> 
> +
> 
> +#
> 
> +# - Tcss
> 
> +Include/ConfigBlock/Tcss
> 
> +[Guids.common.Private]
> 
> +#
> 
> +# PCH
> 
> +#
> 
> +gPchDeviceTableHobGuid       = { 0xb3e123d0, 0x7a1e, 0x4db4, { 0xaf, 0x66,
> 0xbe, 0xd4, 0x1e, 0x9c, 0x66, 0x38 }}
> 
> +gWdtHobGuid                  = { 0x65675786, 0xacca, 0x4b11, { 0x8a, 0xb7, 0xf8,
> 0x43, 0xaa, 0x2a, 0x8b, 0xea }}
> 
> +gPchConfigHobGuid            = { 0x524ed3ca, 0xb250, 0x49f5, { 0x94, 0xd9,
> 0xa2, 0xba, 0xff, 0xc7, 0x0e, 0x14 }}
> 
> +gGpioLibUnlockHobGuid        = { 0xA7892E49, 0x0F9F, 0x4166, { 0xB8, 0xD6,
> 0x8A, 0x9B, 0xD9, 0x8B, 0x17, 0x38 }}
> 
> +gSiScheduleResetHobGuid      = { 0xEA0597FF, 0x8858, 0x41CA, { 0xBB, 0xC1,
> 0xFE, 0x18, 0xFC, 0xD2, 0x8E, 0x22 }}
> 
> +gCnviConfigHobGuid           = { 0xa8d6e4d9, 0x94b7, 0x4fc9, { 0x94, 0x3f, 0x7a,
> 0x9c, 0xb2, 0x31, 0x57, 0xce }}
> 
> +
> 
> +#
> 
> +# CPU
> 
> +#
> 
> +gPeiAcpiCpuDataGuid          = { 0x7682bbef, 0xb0b6, 0x4939, { 0xae, 0x66,
> 0x1b, 0x3d, 0xf2, 0xf6, 0xaa, 0xf3 }}
> 
> +gCpuStatusCodeDataTypeExceptionHandlerGuid = { 0x3BC2BD12, 0xAD2E,
> 0x11D5, { 0x87, 0xDD, 0x00, 0x06, 0x29, 0x45, 0xC3, 0xB9 }}
> 
> +
> 
> +#
> 
> +# SA
> 
> +#
> 
> +gSchemaListGuid              = { 0x3047C2AC, 0x5E8E, 0x4C55, { 0xA1, 0xCB, 0xEA,
> 0xAD, 0x0A, 0x88, 0x86, 0x1B }}
> 
> +gEqPhase3SchemaGuid          = { 0x145AC084, 0x340E, 0x4777, { 0xBC, 0x75,
> 0xF8, 0x50, 0x5F, 0xFD, 0x50, 0x9D }}
> 
> +gScoreSchemaGuid             = { 0x8233A1BB, 0x58D5, 0x4F66, { 0xA1, 0x3F,
> 0x8A, 0xA3, 0xED, 0x6A, 0xF5, 0xA0 }}
> 
> +gPortMarginGuid              = { 0xD7154D12, 0x03B2, 0x4054, { 0x8C, 0xD2, 0x9F,
> 0x4B, 0x20, 0x90, 0xBE, 0xF7 }}
> 
> +gJitterTolerenceGuid         = { 0xB52A2E04, 0x45FF, 0x484E, { 0xB5, 0xFE,
> 0xEE, 0x47, 0x8F, 0x5F, 0x6C, 0x9B }}
> 
> +gLaneMarginGuid              = { 0x7AC0996D, 0xA601, 0x4210, { 0x94, 0x4E, 0x93,
> 0x4E, 0x51, 0x7B, 0x6C, 0x57 }}
> 
> +gVocMarginGuid               = { 0x3578349A, 0x9E98, 0x4F70, { 0x91, 0xCB, 0xE2,
> 0x5B, 0x98, 0x99, 0xBC, 0x16 }}
> 
> +
> 
> +[Guids]
> 
> +gSmbiosProcessorInfoHobGuid        =  {0xe6d73d92, 0xff56, 0x4146, {0xaf,
> 0xac, 0x1c, 0x18, 0x81, 0x7d, 0x68, 0x71}}
> 
> +gSmbiosCacheInfoHobGuid            =  {0xd805b74e, 0x1460, 0x4755, {0xbb,
> 0x36, 0x1e, 0x8c, 0x8a, 0xd6, 0x78, 0xd7}}
> 
> +
> 
> +##
> 
> +## IntelFrameworkPkg
> 
> +##
> 
> +# MsegSmramPei.inf
> 
> +gEfiSmmPeiSmramMemoryReserveGuid   =  {0x6dadf1d1, 0xd4cc, 0x4910,
> {0xbb, 0x6e, 0x82, 0xb1, 0xfd, 0x80, 0xff, 0x3d}}
> 
> +##
> 
> +## MdeModulePkg
> 
> +##
> 
> +gEfiMemoryTypeInformationGuid  =  {0x4c19049f, 0x4137, 0x4dd3, {0x9c,
> 0x10, 0x8b, 0x97, 0xa8, 0x3f, 0xfd, 0xfa}}
> 
> +gEfiCapsuleVendorGuid  =  {0x711c703f, 0xc285, 0x4b10, {0xa3, 0xb0, 0x36,
> 0xec, 0xbd, 0x3c, 0x8b, 0xe2}}
> 
> +gEfiConsoleOutDeviceGuid = { 0xd3b36f2c, 0xd551, 0x11d4, { 0x9a, 0x46,
> 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d}}
> 
> +##
> 
> +## Common
> 
> +##
> 
> +## Include/ConfigBlock/SiConfig.h
> 
> +gSiConfigGuid = {0x4ed6d282, 0x22f3, 0x4fe1, {0xa6, 0x61, 0x6, 0x1a, 0x97,
> 0x38, 0x59, 0xd8}}
> 
> +##
> 
> +gSiPreMemConfigGuid = {0xb94c004c, 0xa0ab, 0x40f0, {0x9b, 0x61, 0x0b,
> 0x25, 0x88, 0xbe, 0xfd, 0xc6}}
> 
> +##
> 
> +##
> 
> +gPciePreMemConfigGuid = {0xd0f9c2a9, 0x7332, 0x4733, {0x8d, 0xb1, 0x98,
> 0x79, 0x27, 0x60, 0xda, 0xe6}}
> 
> +##
> 
> +gSiPkgTokenSpaceGuid  =  {0x977c97c1, 0x47e1, 0x4b6b, {0x96, 0x69, 0x43,
> 0x66, 0x99, 0xcb, 0xe4, 0x5b}}
> 
> +## Include/SiConfigHob.h
> 
> +gSiConfigHobGuid = {0xb3903068, 0x7482, 0x4424, {0xba, 0x4b, 0x40, 0x5f,
> 0x8f, 0xd7, 0x65, 0x4e}}
> 
> +gBootMediaHobGuid = {0x8c7340ea, 0xde8b, 0x4e06, {0xa4, 0x78, 0xec,
> 0x8b, 0x62, 0xd7, 0xa, 0x8b}}
> 
> +gEfiPramConfGuid = { 0xecb54cd9, 0xe5ae, 0x4fdc, { 0xa9, 0x71, 0xe8, 0x77,
> 0x75, 0x60, 0x68, 0xf7}}
> 
> +##
> 
> +##
> 
> +## IPU's GUIDs
> 
> +##
> 
> +gIpuDataHobGuid  = {0x61dd66, 0x212b, 0x4dae, {0x9b, 0xc0, 0x30, 0xe0,
> 0x2e, 0x3f, 0x40, 0xfd}}
> 
> +gIpuConfigHobGuid  = {0x446268e5, 0x8c30, 0x4e0a, {0x9b, 0x28, 0xa3, 0xe7,
> 0xf0, 0x4, 0x31, 0xd0}}
> 
> +
> 
> +## Include/FspErrorInfo.h
> 
> +gFspErrorInfoHobGuid = {0x611e6a88, 0xadb7, 0x4301, {0x93, 0xff, 0xe4,
> 0x73, 0x04, 0xb4, 0x3d, 0xa6}}
> 
> +gStatusCodeDataTypeFspErrorGuid = {0x611e6a88, 0xadb7, 0x4301, {0x93,
> 0xff, 0xe4, 0x73, 0x04, 0xb4, 0x3d, 0xa6}}
> 
> +
> 
> +##
> 
> +##
> 
> +## SystemAgent
> 
> +##
> 
> +gSaOverclockingPreMemConfigGuid  =  { 0x09ecc29d, 0xdbbe, 0x49fb, {
> 0xa6, 0x49, 0x4b, 0xf6, 0x40, 0xe2, 0xeb, 0xd6}}
> 
> +gSaAcpiTableStorageGuid  =  {0x3c0ed5e2, 0x91ea, 0x4b94, { 0x82, 0xd,
> 0x9d, 0xaf, 0x9a, 0x3b, 0xb4, 0xa2}}
> 
> +gSaDataHobGuid  =  {0xe07d0bda, 0xbf90, 0x46a9, { 0xb0, 0x0e, 0xb2, 0xc4,
> 0x4a, 0x0e, 0xd6, 0xd0}}
> 
> +gPsmiDataHobGuid  =  {0xa9652bd, 0x6acd, 0x47e5, { 0x80, 0x3a, 0x9, 0x53,
> 0x7b, 0xd2, 0xa8, 0x48 }}
> 
> +gSaConfigHobGuid  = {0x762fa2e6, 0xea3b, 0x41c8, { 0x8c, 0x52, 0x63, 0x76,
> 0x6d, 0x70, 0x39, 0xe0}}
> 
> +gCpuPcieHobGuid  = {0x440ab2e5, 0xa3ea, 0x466f, { 0x84, 0x96, 0xdf, 0xb1,
> 0x3b, 0x75, 0x29, 0x95}}
> 
> +gSaPegHobGuid    = {0x5807c388, 0xfa06, 0x4683, { 0xab, 0xd3, 0x1b, 0x31,
> 0xbb, 0x81, 0x2d, 0x23}}
> 
> +gHgAcpiTableStorageGuid  =  {0x8de8964f, 0x2939, 0x4b49, { 0xa3, 0x48,
> 0xf6, 0xb2, 0xb2, 0xde, 0x4a, 0x42}}
> 
> +gSaSsdtAcpiTableStorageGuid  =  {0xca89914d, 0x2317, 0x452e, { 0xb2, 0x45,
> 0x36, 0xc6, 0xfb, 0x77, 0xa9, 0xc6}}
> 
> +gSegSsdtAcpiTableStorageGuid  =  {0x10c3800d, 0xe225, 0x480e, { 0x85,
> 0xda, 0xbe, 0xed, 0xdb, 0x88, 0xe1, 0xc6}}
> 
> +gHgAcpiTablePchStorageGuid  =  {0xe3164526, 0x690a, 0x4e0d, { 0xb0, 0x28,
> 0xae, 0xa1, 0x6f, 0xe2, 0xbc, 0xf3}}
> 
> +gSaMiscPeiPreMemConfigGuid  =  {0x4a525577, 0x3469, 0x4f11, { 0x99, 0xcf,
> 0xfb, 0xcd, 0x5e, 0xf1, 0x84, 0xe4}}
> 
> +gSaMiscPeiConfigGuid  =  {0x1def8e6, 0xe998, 0x4e27, { 0x89, 0x98, 0x9c,
> 0xfa, 0xb2, 0x92, 0xbc, 0x50}}
> 
> +gCpuPciePeiPreMemConfigGuid  =  { 0x81baf3c9, 0xf295, 0x4572, { 0x8b,
> 0x21, 0x79, 0x3f, 0xa3, 0x1b, 0xa5, 0xdb}}
> 
> +gCpuDmiPreMemConfigGuid  =  { 0x30d12ad5, 0xa3c6, 0x49c7, { 0xa2, 0xfd,
> 0x35, 0x5c, 0xcb, 0x61, 0xcb, 0xcf}}
> 
> +gVmdPeiConfigGuid = { 0x79b52c74, 0xb9ba, 0x4f36, {0xa2, 0x40, 0xf2, 0x41,
> 0x0d, 0x20, 0x84, 0x8a}}
> 
> +gVmdInfoHobGuid            = { 0xccd0306e, 0x7fa1, 0x4df5, {0x99, 0x99, 0xc1,
> 0xf8, 0x9a, 0x1d, 0x1b, 0xa9}}
> 
> +gEfiVmdFeatureVariableGuid = { 0x61a14fe8, 0x4dab, 0x4a19, {0xb1, 0xe3,
> 0x97, 0xfb, 0x23, 0xd0, 0x92, 0x12}}
> 
> +gPramPreMemConfigGuid  =  { 0xcf0b9b31, 0xa1a6, 0x46d9, { 0x8d, 0x14,
> 0xe3, 0xac, 0x69, 0x0f, 0x52, 0x3a}}
> 
> +gHybridGraphicsConfigGuid  =  { 0xc7956998, 0xc065, 0x46c4, { 0x8e, 0x2f,
> 0x58, 0x2b, 0x67, 0xeb, 0xbe, 0x2f}}
> 
> +gHybridGraphicsInfoHobGuid =  { 0x46cbed07, 0x717a, 0x4a75, { 0x85, 0xb3,
> 0xf4, 0xb6, 0xc4, 0xe2, 0x3a, 0x75}}
> 
> +gMemoryConfigGuid  =  { 0x26cf084c, 0xc9db, 0x41bb, { 0x92, 0xc6, 0xd1,
> 0x97, 0xb8, 0xa1, 0xe4, 0xbf}}
> 
> +gMemoryConfigNoCrcGuid  =  { 0xc56c73d0, 0x1cdb, 0x4c0c, { 0xa9, 0x57,
> 0xea, 0x62, 0xa9, 0xe6, 0xf5, 0x0c}}
> 
> +gGnaConfigGuid  =  { 0x53e0ef18, 0xb8a8, 0x4795, { 0xa6, 0x6d, 0xe4, 0x77,
> 0x2c, 0xc3, 0xae, 0x82}}
> 
> +gVtdDxeConfigGuid  =  {0xcbbf1996, 0x4a4c, 0x4dd9, {0xab, 0xbe, 0x83,
> 0x89, 0x73, 0xd, 0x48, 0xb0}}
> 
> +gPcieDxeConfigGuid  =  {0x1ed2d6f1, 0xa9d2, 0x476e, {0x8e, 0x74, 0xad,
> 0xd9, 0x5b, 0x5,  0x10, 0x82}}
> 
> +gMemoryDxeConfigGuid  =  {0xa5c7dda8, 0x686b, 0x404f, {0x86, 0x40, 0xf8,
> 0x2,  0xd,  0x84, 0x4c, 0x94}}
> 
> +gFspReservedMemoryResourceHobTsegGuid  =  { 0xd038747c, 0xd00c,
> 0x4980, { 0xb3, 0x19, 0x49, 0x01, 0x99, 0xa4, 0x7d, 0x55}}
> 
> +gCpuPcieRpPrememConfigGuid = { 0x41aef892, 0xc800, 0x4ac0, {0xa9, 0x30,
> 0x84, 0xac, 0x47, 0xca, 0xca, 0x7e}}
> 
> +gCpuPcieRpConfigGuid = { 0x9749a5fb, 0x9130, 0x44f0, {0x8f, 0x61, 0xdb,
> 0xff, 0x8e, 0xf2, 0xca, 0xc7}}
> 
> +## Include/Guid/AcpiS3Context.h
> 
> +gEfiAcpiVariableGuid  =  {0xaf9ffd67, 0xec10, 0x488a, {0x9d, 0xfc, 0x6c, 0xbf,
> 0x5e, 0xe2, 0x2c, 0x2e}}
> 
> +## IntelFsp2Pkg/IntelFsp2Pkg.dec gSiMemoryS3DataGuid is the same as
> gFspNonVolatileStorageHobGuid
> 
> +gSiMemoryS3DataGuid       = { 0x721acf02, 0x4d77, 0x4c2a, { 0xb3, 0xdc,
> 0x27, 0x0b, 0x7b, 0xa9, 0xe4, 0xb0 } }
> 
> +gSiMemoryInfoDataGuid     = { 0x9b2071d4, 0xb054, 0x4e0c, { 0x8d, 0x09,
> 0x11, 0xcf, 0x8b, 0x9f, 0x03, 0x23 } }
> 
> +gSiMemoryPlatformDataGuid = { 0x6210d62f, 0x418d, 0x4999, { 0xa2, 0x45,
> 0x22, 0x10, 0x0a, 0x5d, 0xea, 0x44 } }
> 
> +## Include/MrcRmtData.h
> 
> +gEfiMemorySchemaGuid  = { 0xCE3F6794, 0x4883, 0x492C, { 0x8D, 0xBA,
> 0x2F, 0xC0, 0x98, 0x44, 0x77, 0x10}}
> 
> +gMrcSchemaListHobGuid = { 0x3047C2AC, 0x5E8E, 0x4C55, { 0xA1, 0xCB,
> 0xEA, 0xAD, 0x0A, 0x88, 0x86, 0x1B}}
> 
> +gRmtResultMetadataGuid = { 0x02CB1552, 0xD659, 0x4232, { 0xB5, 0x1F,
> 0xCA, 0xB1, 0xE1, 0x1F, 0xCA, 0x87}}
> 
> +gRmtResultColumnsGuid  = { 0x0E60A1EB, 0x331F, 0x42A1, { 0x9D, 0xE7,
> 0x45, 0x3E, 0x84, 0x76, 0x11, 0x54}}
> 
> +gMargin2DResultMetadataGuid = { 0x48265582, 0x8E49, 0x4AC7, { 0xAA,
> 0x06, 0xE1, 0xB9, 0xA7, 0x4C, 0x97, 0x16}}
> 
> +gMargin2DResultColumnsGuid  = { 0x91A449EC, 0x8A4A, 0x4736, { 0xAD,
> 0x71, 0xA3, 0xF6, 0xF6, 0xD7, 0x52, 0xD9}}
> 
> +gSaFspErrorTypePeiGopInit = { 0x8106a5cc, 0x30ba, 0x41cf, { 0xa1, 0x78,
> 0x63, 0x38, 0x91, 0x11, 0xae, 0xb2}}
> 
> +gSaFspErrorTypePeiGopGetMode = { 0x348cc7fe, 0x1e9a, 0x4c7a, { 0x86,
> 0x28, 0xae, 0x48, 0x5b, 0x42, 0x10, 0xf0}}
> 
> +gSaFspErrorTypeCallerId = { 0x98230916, 0xe632, 0x49ff, { 0x81, 0x81, 0x55,
> 0xce, 0xe5, 0x10, 0x36, 0x89}}
> 
> +gMrcFspErrorTypeCallerId = { 0x5a47c211, 0x642f, 0x4f92, { 0x9c, 0xb3, 0x7f,
> 0xeb, 0x93, 0xda, 0xdd, 0xba}}
> 
> +gMrcFspErrorTypeMemoryInit = { 0x5de1c071, 0x2c9c, 0x4a53, { 0x80, 0x21,
> 0x4e, 0x80, 0xd2, 0x5d, 0x44, 0xa8}}
> 
> +gSaPciePeiConfigGuid = { 0xdaa929a9, 0x5ec9, 0x486a, { 0xb0, 0xf7, 0x82,
> 0x3a, 0x55, 0xc7, 0xb5, 0xb3}}
> 
> +gSaPciePeiPreMemConfigGuid = { 0xfc5e01a3, 0x69f6, 0x4e35, { 0x9f, 0xcf,
> 0x6, 0x68, 0x7b, 0xab, 0x31, 0xd7}}
> 
> +
> 
> +
> 
> +#
> 
> +# Host Bridge
> 
> +#
> 
> +gHostBridgePeiPreMemConfigGuid  =  {0xbdef6805, 0x2080, 0x44ad, { 0x93,
> 0x2e, 0x00, 0x04, 0xf5, 0x2c, 0xb7, 0xa1}}
> 
> +gHostBridgePeiConfigGuid  =  {0x3b6d998e, 0x8b6e, 0x4f53, { 0xbe, 0x41,
> 0x7, 0x41, 0x95, 0x53, 0x8a, 0xaf}}
> 
> +gHostBridgeDataHobGuid  =  {0x3b682d57, 0xd402, 0x40a6, { 0xb1, 0x34,
> 0xa0, 0xc4, 0xf6, 0x31, 0x1d, 0x9}}
> 
> +
> 
> +#
> 
> +# Graphics
> 
> +#
> 
> +gGraphicsPeiPreMemConfigGuid  =  {0x0319c56b, 0xc43a, 0x42f1, { 0x80,
> 0xbe, 0xca, 0x5b, 0xd1, 0xd5, 0xc9, 0x28}}
> 
> +gGraphicsPeiConfigGuid  =  {0x04249ac0, 0x0088, 0x439f, { 0xa7, 0x4e, 0xa7,
> 0x04, 0x2a, 0x06, 0x2f, 0x5d}}
> 
> +gGraphicsDxeConfigGuid  =  {0x34d93161, 0xf78e, 0x4915, {0xad, 0xc4, 0xdb,
> 0x67, 0x16, 0x42, 0x39, 0x24}}
> 
> +gGraphicsAcpiTableStorageGuid  =  {0xce9caa0e, 0x8248, 0x442c, { 0x9e,
> 0x57, 0x50, 0xf2, 0x12, 0xe2, 0xba, 0xed}}
> 
> +## IpBlock/Graphics/IncludePrivate/GraphicsDataHob.h
> 
> +gGraphicsDataHobGuid = { 0x48e6e20a, 0x9110, 0x4332, { 0x8c, 0x9f, 0x5f,
> 0x7c, 0xae, 0x76, 0xfc, 0xf3}}
> 
> +
> 
> +#
> 
> +# IPU
> 
> +#
> 
> +gIpuPreMemConfigGuid  =  { 0x830a222b, 0x3ff5, 0x432e, { 0x9d, 0xd5,
> 0x4e, 0xe3, 0xfc, 0xa2, 0xaa, 0xa2}}
> 
> +gIpuAcpiTableStorageGuid  =  {0x9b25dba6, 0x45b3, 0x4190, { 0x99, 0x8d,
> 0xaf, 0x31, 0xdc, 0x21, 0x78, 0x21}}
> 
> +
> 
> +## Include/SsaCommonConfig.h
> 
> +gSsaPostcodeHookGuid = {0xADF0A27B, 0x61A6, 0x4F18, {0x9E, 0xAC, 0x46,
> 0x87, 0xE7, 0x9E, 0x6F, 0xBB}}
> 
> +gSsaBiosVariablesGuid = {0x43eeffe8, 0xa978, 0x41dc, {0x9d, 0xb6, 0x54,
> 0xc4, 0x27, 0xf2, 0x7e, 0x2a}}
> 
> +gSsaBiosResultsGuid = {0x8f4e928, 0xf5f, 0x46d4, {0x84, 0x10, 0x47, 0x9f,
> 0xda, 0x27, 0x9d, 0xb6}}
> 
> +gHobUsageDataGuid = {0xc764a821, 0xec41, 0x450d, { 0x9c, 0x99, 0x27,
> 0x20, 0xfc, 0x7c, 0xe1, 0xf6 }}
> 
> +##
> 
> +## TBT
> 
> +##
> 
> +gPeiITbtConfigGuid            =  {0xd7e7e1e6, 0xcbec, 0x4f5f, {0xae, 0xd3, 0xfd,
> 0xc0, 0xa8, 0xb0, 0x7e, 0x25}}
> 
> +gDxeITbtConfigGuid            =  {0x196bf9e3, 0x20d7, 0x4b7b, {0x89, 0xf9, 0x31,
> 0xc2, 0x72, 0x08, 0xc9, 0xb9}}
> 
> +gITbtInfoHobGuid              =  {0x74a81eaa, 0x033c, 0x4783, {0xbe, 0x2b, 0x84,
> 0x85, 0x74, 0xa6, 0x97, 0xb7}}
> 
> +
> 
> +##
> 
> +## TCSS
> 
> +##
> 
> +gTcssHobGuid  = { 0x455702ce, 0x4adb, 0x45d9, { 0x8b, 0x27, 0xf7, 0xb0,
> 0xd9, 0x79, 0x8a, 0xe0}}
> 
> +gTcssSsdtAcpiTableStorageGuid  =  { 0xbd53572c, 0x6486, 0x45e2, { 0x90,
> 0xe, 0xb9, 0x8a, 0xc1, 0xa8, 0x25, 0x45}}
> 
> +gTcssPeiConfigGuid =  { 0xfb631590, 0x79c9, 0x4f0d, { 0xa9, 0x96, 0xee,
> 0xe2, 0x98, 0x66, 0xfa, 0xfd}}
> 
> +gTcssPeiPreMemConfigGuid = { 0x514ed829, 0xb2bb, 0x46be, { 0xa9, 0x78,
> 0x6d, 0xc, 0x91, 0xc1, 0xeb, 0xe4}}
> 
> +gTcssSsidHobGuid  = { 0x8903d47a, 0x8f82, 0x4063, { 0xa8, 0x40, 0x31, 0x68,
> 0x9c, 0x9e, 0x78, 0x20}}
> 
> +##
> 
> +## Telemetry
> 
> +##
> 
> +gTelemetryPeiConfigGuid       =  { 0x8ebf9fee, 0x7496, 0x42b4, { 0xa6, 0xf6,
> 0xcf, 0x2b, 0x33, 0x99, 0x30, 0xd6}}
> 
> +gTelemetryPeiPreMemConfigGuid =  { 0x422de269, 0xb2ef, 0x4829, { 0x93,
> 0x36, 0x0b, 0xe4, 0x98, 0xb5, 0x53, 0xb2}}
> 
> +
> 
> +##
> 
> +## VTD
> 
> +##
> 
> +gVtdDataHobGuid  = {0x1d60dce8, 0x503a, 0x44a8, { 0xb3, 0x2d, 0x56, 0xb3,
> 0x88, 0xf3, 0x4c, 0x55}}
> 
> +gVtdConfigGuid  =  {0x03e5cf63, 0xbebb, 0x4041, { 0xb7, 0xe7, 0xbf, 0x54,
> 0x61, 0x20, 0xf1, 0xc5}}
> 
> +
> 
> +#
> 
> +# TRACEHUB
> 
> +#
> 
> +gCpuTraceHubPreMemConfigGuid =  { 0xf2e17477, 0x93f3, 0x430d, { 0x9e,
> 0x08, 0x3c, 0xcc, 0x6e, 0x2f, 0x6c, 0x4b}}
> 
> +gTraceHubDataHobGuid         =  { 0xf1187e54, 0x995f, 0x49d9, { 0xac, 0xee,
> 0xc5, 0x34, 0xf4, 0x5a, 0x18, 0xc7}}
> 
> +
> 
> +##
> 
> +## Cpu
> 
> +##
> 
> +gSmramCpuDataHeaderGuid  =  {0x5848fd2d, 0xd6af, 0x474b, {0x82, 0x75,
> 0x95, 0xdd, 0xe7, 0x0a, 0xe8, 0x23}}
> 
> +gCpuAcpiTableStorageGuid  =  {0xc38fb0e2, 0x0c43, 0x49c9, {0xb5, 0x44,
> 0x9b, 0x17, 0xaa, 0x4d, 0xcb, 0xa3}}
> 
> +gTxtInfoHobGuid  =  {0x2986883f, 0x88e0, 0x48d0, {0x4b, 0x82, 0x20, 0xc2,
> 0x69, 0x48, 0xdd, 0xac}}
> 
> +gHtBistHobGuid  =  {0xbe644001, 0xe7d4, 0x48b1, {0xb0, 0x96, 0x8b, 0xa0,
> 0x47, 0xbc, 0x7a, 0xe7}}
> 
> +gProcessorProducerGuid  =  {0x1bf06aea, 0x5bec, 0x4a8d, {0x95, 0x76, 0x74,
> 0x9b, 0x09, 0x56, 0x2d, 0x30}}
> 
> +gCpuInitDataHobGuid  =  {0x266e31cc, 0x13c5, 0x4807, {0xb9, 0xdc, 0x39,
> 0xa6, 0xba, 0x88, 0xff, 0x1a}}
> 
> +gBiosGuardHobGuid  =  {0x66f0c42d, 0x0d0e, 0x4c23, {0x93, 0xc0, 0x2d,
> 0x52, 0x95, 0xdc, 0x5e, 0x21}}
> 
> +gCpuSecurityPreMemConfigGuid = {0xfd5c346, 0x8260, 0x4067, {0x94, 0x69,
> 0xcf, 0x91, 0x68, 0xa3, 0x42, 0x90}}
> 
> +gCpuConfigLibPreMemConfigGuid = {0xfc1c0ec2, 0xc6b4, 0x4f05, {0xbb,
> 0x85, 0xc8, 0x0, 0x8d, 0x5b, 0x4a, 0xb7}}
> 
> +gCpuTxtPreMemConfigGuid = {0x20b4db03, 0xd160, 0x4f83, {0xa4, 0x1,
> 0x9a, 0x8a, 0xa8, 0x88, 0x68, 0x14}}
> 
> +gCpuTestConfigGuid = {0xd4dba957, 0xd9c, 0x4af2, {0x9d, 0x40, 0x35, 0xa8,
> 0x44, 0xe4, 0x93, 0xad}}
> 
> +gBiosGuardConfigGuid = {0x762f9ddb, 0x1c89, 0x4612, {0x84, 0x6b, 0xee,
> 0xdc, 0x8f, 0x62, 0x25, 0x45}}
> 
> +gCpuConfigGuid = {0x48c3aac9, 0xd66c, 0x42e4, {0x9b, 0x1d, 0x39, 0x4, 0x5f,
> 0x46, 0x53, 0x41}}
> 
> +gCpuPidTestConfigGuid = {0x2511095f, 0xd49e, 0x4537, {0xa6, 0x60, 0x88,
> 0x71, 0x31, 0xd1, 0x53, 0xda}}
> 
> +gCpuPowerMgmtBasicConfigGuid = {0xa021e31d, 0x7c14, 0x47da, {0xb5,
> 0xec, 0xca, 0xbb, 0x4d, 0x76, 0xed, 0xc8}}
> 
> +gCpuPowerMgmtCustomConfigGuid = {0x562fa1c8, 0x55ee, 0x4e2f, {0x91,
> 0xca, 0x8d, 0x84, 0x50, 0x3, 0x2f, 0xe}}
> 
> +gCpuPowerMgmtPsysConfigGuid = {0x4e7f850, 0x19b5, 0x47ba, {0x9d,
> 0x28, 0xb1, 0xe7, 0x5e, 0x1f, 0x48, 0x53}}
> 
> +gCpuPowerMgmtTestConfigGuid = {0x5161ed3d, 0x90bf, 0x436f, {0xb8,
> 0x33, 0xd7, 0x17, 0x89, 0xb3, 0x48, 0xc1}}
> 
> +gCpuPowerMgmtVrConfigGuid = {0x254766c9, 0x929d, 0x4eac, {0x9e, 0xec,
> 0xdf, 0xa2, 0x2, 0x44, 0xb5, 0xea}}
> 
> +gTxtPrivateBaseHobGuid = {0x651EBDB4, 0x4E1D, 0x422A, {0x82, 0xFB, 0x1E,
> 0xDA, 0x66, 0x71, 0x6C, 0x0B}}
> 
> +gTxtAcmInfoTableGuid = {0x7FC03AAA, 0x46A7, 0x18DB, {0x2E, 0xAC, 0x69,
> 0x8F, 0x8D, 0x41, 0x7F, 0x5A}}
> 
> +gOverclockingPreMemConfigGuid = {0xad151bbc, 0xd5a0, 0x481e, {0x9d,
> 0x19, 0xf6, 0x7b, 0x79, 0xe9, 0x8f, 0x68}}
> 
> +gCpuDataHobGuid = {0x1eec629f, 0xf3cf, 0x4b02, { 0xa9, 0xa5, 0x27, 0xa2,
> 0x33, 0x20, 0xbe, 0x5d}}
> 
> +
> 
> +##
> 
> +## Me
> 
> +##
> 
> +gMePlatformReadyToBootGuid  =  {0x03fdf171, 0x1d67, 0x4ace, {0xa9, 0x04,
> 0x3e, 0x36, 0xd3, 0x38, 0xfa, 0x74}}
> 
> +gMeSsdtAcpiTableStorageGuid  =  {0x9a8f82d5, 0x39b1, 0x48da, {0x92, 0xdc,
> 0xa2, 0x2d, 0xa8, 0x83, 0x4d, 0xf6}}
> 
> +gMeDataHobGuid  =  {0x1e94f097, 0x5acd, 0x4089, {0xb2, 0xe3, 0xb9, 0xa5,
> 0xc8, 0x79, 0xa7, 0x0c}}
> 
> +gMeEDebugHobGuid = {0x5f672ec1, 0xa8f6, 0x47d3, {0x9c, 0xd0, 0x92,
> 0xe9, 0xe9, 0xe0, 0xb3, 0x84}}
> 
> +gPciImrHobGuid  =  {0x49b1eac3, 0x0cd6, 0x451e, {0x96, 0x30, 0x92, 0x4b,
> 0xc2, 0x69, 0x35, 0x86}}
> 
> +gTpm2AcpiTableStorageGuid  =  {0x7d279373, 0xeecc, 0x4d4f, {0xae, 0x2f,
> 0xce, 0xc4, 0xb7, 0x06, 0xb0, 0x6a}}
> 
> +gMeBiosPayloadHobGuid  =  {0x992c52c8, 0xbc01, 0x4ecd, {0x20, 0xbf, 0xf9,
> 0x57, 0x16, 0x0e, 0x9e, 0xf7}}
> 
> +gEfiTouchPanelGuid  =  {0x91b1d27b, 0xe126, 0x48d1, {0x82, 0x34, 0xd2,
> 0x8b, 0x81, 0xc8, 0x83, 0x62}}
> 
> +gMeFwHobGuid  = {0x52885e62, 0x4c4d, 0x9546, {0x2d, 0xba, 0x2a, 0x84,
> 0x89, 0xee, 0xa8, 0xa3 }}
> 
> +gMePeiPreMemConfigGuid  =  {0x67ed113b, 0xd4ab, 0x43f5, {0x9c, 0x3c,
> 0x35, 0x44, 0x15, 0xaa, 0x47, 0x5c}}
> 
> +gMePeiConfigGuid  =  {0x9bad5628, 0x657b, 0x48e3, {0xb1, 0x11, 0xc3, 0xb9,
> 0xeb, 0xea, 0xee, 0x17}}
> 
> +gMeDxeConfigGuid  =  {0xad08bacc, 0x4906, 0x4d9b, {0xbe, 0xd1, 0x81,
> 0xa5, 0x2c, 0x13, 0xdb, 0xf8}}
> 
> +gIvmProtocolGuid  = {0x3C4852D6, 0xD47B, 0x4F46, {0xB0, 0x5E, 0xB5, 0xED,
> 0xC1, 0xAA, 0x44, 0x0E}}
> 
> +gSdmProtocolGuid  = {0xDBA4D603, 0xD7ED, 0x4931, {0x88, 0x23, 0x17,
> 0xAD, 0x58, 0x57, 0x05, 0xD5}}
> 
> +gRtmProtocolGuid  = {0x5565A099, 0x7FE2, 0x45C1, {0xA2, 0x2B, 0xD7, 0xE9,
> 0xDF, 0xEA, 0x9A, 0x2E}}
> 
> +gSvmProtocolGuid  = {0xF47ACC04, 0xD94B, 0x49CA, {0x87, 0xA6, 0x7F,
> 0x7D, 0xC0, 0x3F, 0xBA, 0xF3}}
> 
> +gMeEopDoneHobGuid = {0x247323af, 0xc8f1, 0x4b8c, {0x90, 0x87, 0xaa,
> 0x4b, 0xa7, 0xb7, 0x6d, 0x6a}}
> 
> +gMePreMemPolicyHobGuid = {0xe6de74a5, 0x21b, 0x4f78, {0xa3, 0xcd,
> 0x34, 0xd6, 0x7e, 0xe4, 0x82, 0xbf}}
> 
> +gMePolicyHobGuid =  {0x0341cf17, 0xbc8f, 0x4a20, {0xac, 0x28, 0x6c, 0x3c,
> 0x32, 0x4c, 0xd4, 0x17}}
> 
> +gMeFspErrorTypeEop = {0x948585c4, 0x76a4, 0x45bb, {0xbe, 0x6c, 0x39,
> 0x61, 0xc3, 0xab, 0xde, 0x15}}
> 
> +gMeFspErrorTypeCallerId = {0x1f4dc7e9, 0x26ca, 0x4336, { 0x8c, 0xe3, 0x39,
> 0x31, 0x3, 0xb5, 0xf3, 0xd7}}
> 
> +gMeConfigSpaceGuid = {0xcb405fd3, 0x4404, 0x4ccd, {0x85, 0x18, 0x0d,
> 0x03, 0x07, 0x48, 0xd0, 0xa6}}
> 
> +gMeDidSentHobGuid = {0x4c3d3af1, 0x1720, 0x4c3f, {0xab, 0x7c, 0x36, 0x50,
> 0xbb, 0x5b, 0x85, 0x7e}}
> 
> +gMeDisabledEventHobGuid = {0x1500b6a7, 0xb82f, 0x456b, {0xba, 0x2b,
> 0x4, 0x72, 0x41, 0x6, 0xf, 0x7}}
> 
> +gMeSavedPmconHobGuid = {0xb8baee93, 0xea15, 0x4ddc, {0x90, 0xb8,
> 0x44, 0x12, 0xd2, 0xea, 0xcf, 0x4f}}
> 
> +
> 
> +##
> 
> +## Amt
> 
> +##
> 
> +gAmtForcePushPetPolicyGuid  =  {0xacc8e1e4, 0x9f9f, 0x4e40, {0xa5, 0x7e,
> 0xf9, 0x9e, 0x52, 0xf3, 0x4c, 0xa5}}
> 
> +gAmtForcePushPetVariableGuid  =  {0xd7ac94af, 0xa498, 0x45ec, {0xbf,
> 0xa2, 0xa5, 0x6e, 0x95, 0x34, 0x61, 0x8b}}
> 
> +gMeBiosExtensionSetupGuid  =  {0xaf013532, 0xc828, 0x4fbd, {0x20, 0xae,
> 0xfe, 0xe6, 0xaf, 0xbe, 0xdd, 0x4e}}
> 
> +gAmtPetQueueHobGuid  =  {0xca0801d3, 0xafb1, 0x4dec, {0x9b, 0x65, 0x93,
> 0x65, 0xec, 0xc7, 0x93, 0x6b}}
> 
> +gAmtForcePushPetHobGuid  =  {0x4efa0db6, 0x26dc, 0x4bb1, {0xa7, 0x6f,
> 0x14, 0xbc, 0x63, 0x0c, 0x7b, 0x3c}}
> 
> +gAmtPeiConfigGuid  =  {0x7254546a, 0xace3, 0x4a32, {0x9a, 0xc2, 0xf0, 0xcc,
> 0x28, 0x4e, 0x1e, 0x4d}}
> 
> +gAmtDxeConfigGuid  =  {0x3f12ab6b, 0xb04d, 0x4824, {0xbf, 0xb6, 0x3e,
> 0xe7, 0x5d, 0x02, 0x0b, 0x84}}
> 
> +gAmtPolicyHobGuid = {0x703eb2cd, 0x5ca8, 0x4233, {0x9d, 0xa3, 0x0d, 0x2d,
> 0x57, 0xe6, 0x73, 0x34}}
> 
> +gAmtMebxDataGuid  = { 0x912e1538, 0x371d, 0x4ea6, { 0xa8, 0x41, 0xd7,
> 0x6a, 0x8, 0x93, 0x3a, 0x70}}
> 
> +
> 
> +##
> 
> +## PCH
> 
> +##
> 
> +gEfiSmbusArpMapGuid  =  {0x707be83e, 0x0bf6, 0x40a5, {0xbe, 0x64, 0x34,
> 0xc0, 0x3a, 0xa0, 0xb8, 0xe2}}
> 
> +gIrmtAcpiTableStorageGuid  =  {0x6684d675, 0xee06, 0x49b2, {0x87, 0x6f,
> 0x79, 0xc5, 0x8f, 0xdd, 0xa5, 0xb7}}
> 
> +gPchGlobalResetGuid  =  { 0x9db31b4c, 0xf5ef, 0x48bb, { 0x94, 0x2b, 0x18,
> 0x1f, 0x7e, 0x3a, 0x3e, 0x40 }}
> 
> +gI2c0MasterGuid  =  {0xa121a5db, 0xb0cb, 0x46ec, {0xa0, 0xcb, 0x27, 0xf8,
> 0xda, 0x72, 0xd4, 0x0e}}
> 
> +gI2c1MasterGuid  =  {0x55e3d0f9, 0xc954, 0x422d, {0x9c, 0x4c, 0xcc, 0x46,
> 0x12, 0x7c, 0x5b, 0xa8}}
> 
> +gI2c2MasterGuid  =  {0x9289aa40, 0xdf32, 0x474e, {0xb0, 0x3a, 0xc7, 0x7f,
> 0x76, 0xd3, 0x45, 0x21}}
> 
> +gI2c3MasterGuid  =  {0xd8b2c17f, 0x4117, 0x4166, {0x90, 0x17, 0x01, 0x68,
> 0xb4, 0x81, 0xac, 0x18}}
> 
> +gI2c4MasterGuid  =  {0x513d943d, 0x15d9, 0x4bd0, {0xb1, 0x41, 0x14, 0x50,
> 0x2b, 0xbf, 0xa9, 0xf2}}
> 
> +gI2c5MasterGuid  =  {0x50df382a, 0xb6bf, 0x4435, {0xae, 0xe6, 0x21, 0xf4,
> 0x85, 0x7c, 0xa8, 0xb4}}
> 
> +gChipsetInitHobGuid  =  {0xc1392859, 0x1f75, 0x446e, {0xb3, 0xf5, 0x83,
> 0x35, 0xfc, 0xc8, 0xd1, 0xc4}}
> 
> +
> 
> +gPchGeneralPreMemConfigGuid  = {0xC65F62FA, 0x52B9, 0x4837, {0x86,
> 0xEB, 0x1A, 0xFB, 0xD4, 0xAD, 0xBB, 0x3E}}
> 
> +gDciPreMemConfigGuid  =   {0xAB4AF366, 0x2250, 0x40C3, {0x92, 0xDB,
> 0x36, 0x61, 0xC6, 0x71, 0x3C, 0x5A}}
> 
> +gWatchDogPreMemConfigGuid  =  {0xFBCE08CC, 0x60F2, 0x4BDF, {0xB7,
> 0x88, 0x09, 0xBB, 0x81, 0x65, 0x52, 0x2B}}
> 
> +gPchTraceHubPreMemConfigGuid  = {0x8456c11, 0xdb85, 0x4914, {0x8d,
> 0x1a, 0xe5, 0xac, 0x64, 0x37, 0xe8, 0x96}}
> 
> +gPcieRpPreMemConfigGuid  =  {0x8377AB38, 0xF8B0, 0x476A, { 0x9C, 0xA1,
> 0x68, 0xEA, 0x78, 0x57, 0xD8, 0x2A}}
> 
> +gSmbusPreMemConfigGuid  =  {0x77A6E62C, 0x716B, 0x4386, {0x9E, 0x9C,
> 0x23, 0xA0, 0x2E, 0x13, 0x7B, 0x3A}}
> 
> +gLpcPreMemConfigGuid  =  {0xA6E6032F, 0x1E58, 0x407E, {0x9A, 0xB8, 0xC6,
> 0x30, 0xC6, 0xC4, 0x11, 0x8E}}
> 
> +gHsioPciePreMemConfigGuid  =  {0xE8FB0C12, 0x0DA1, 0x4A20, {0xB3, 0x36,
> 0xFB, 0x75, 0x93, 0x8C, 0xE0, 0x14}}
> 
> +gHsioSataPreMemConfigGuid  =  {0x732260D0, 0xA5C1, 0x4119, {0xAA,
> 0x0C, 0x93, 0xDC, 0xAC, 0x67, 0x0A, 0x31}}
> 
> +
> 
> +gPchGeneralConfigGuid  =  {0x6ED94C8C, 0x25F7, 0x4686, {0xB2, 0x46, 0xCA,
> 0x4D, 0xE2, 0x95, 0x4B, 0x5D}}
> 
> +gPchPcieConfigGuid  =  {0x0A53B507, 0x988B, 0x475C, {0xBF, 0x76, 0x33,
> 0xDE, 0x10, 0x6D, 0x94, 0x84}}
> 
> +gPchPcieRpDxeConfigGuid  =  {0x475530EA, 0xBD72, 0x416F, {0x98,
> 0x9F,0x48, 0x70, 0x5F, 0x14, 0x4E, 0xD9}}
> 
> +gSataConfigGuid  =  {0xF5F87B4F, 0xCC3C, 0x408D, {0x89, 0xE3, 0x61, 0xC5,
> 0x9C, 0x54, 0x07, 0xC4}}
> 
> +gRstConfigGuid = {0x43B6F112, 0x3851, 0x4DDC, {0x81, 0xB9, 0xE4, 0x5A,
> 0x2B, 0xE, 0xB3, 0x25}}
> 
> +gIoApicConfigGuid  =  {0x2873D0F1, 0x00F6, 0x40AB, {0xAC, 0x36, 0x9A,
> 0x68, 0xBA, 0x87, 0x3E, 0x6C}}
> 
> +gPchDmiConfigGuid  =  {0xB3A61210, 0x1CD3, 0x4797, {0x8E, 0xE6, 0xD3,
> 0x42, 0x9C, 0x4F, 0x17, 0xBD}}
> 
> +gFlashProtectionConfigGuid  =  {0xD0F71512, 0x9E32, 0x4CC9, {0xA5, 0xA3,
> 0xAD, 0x67, 0x9A, 0x06, 0x67, 0xB8}}
> 
> +gHdAudioPreMemConfigGuid  =  {0xD38F1E2B, 0x21B3, 0x43D1, {0x9F, 0xA8,
> 0xA5, 0xE1, 0x78, 0x73, 0x1E, 0x88}}
> 
> +gHdAudioConfigGuid  =  {0x7EB3CE7E, 0x82E0, 0x4CD7, {0xBD, 0xE5, 0xB2,
> 0xBF, 0x4E, 0x91, 0xC3, 0x4C}}
> 
> +gHdAudioDxeConfigGuid  =  {0x22EFC2DE, 0x66EB, 0x412D, {0x97, 0x17,
> 0xE7, 0x7A, 0xA1, 0x4E, 0x87, 0x76}}
> 
> +gInterruptConfigGuid  =  {0x09A2B815, 0xBE29, 0x45EF, {0xBF, 0xBF, 0x58,
> 0xEA, 0xAC, 0x5E, 0x29, 0x78}}
> 
> +gIshPreMemConfigGuid  =  {0x7C24E649, 0xC1F0, 0x4CF9, {0x87, 0x96, 0xE7,
> 0xA0, 0xEE, 0x34, 0x43, 0xF8}}
> 
> +gIshConfigGuid  =  {0x433AE2AA, 0xC5A6, 0x46ED, {0x94, 0x19, 0x1E, 0x5D,
> 0xB8, 0x1C, 0x57, 0x40}}
> 
> +gGbeConfigGuid  =  {0x4B2DE99E, 0x7517, 0x4D04, {0x8C, 0x02, 0xF1, 0x1A,
> 0x59, 0x2B, 0x14, 0x2F}}
> 
> +gTsnConfigGuid  =  {0x9E9A93CB, 0x0F4E, 0x4E56, {0x90, 0x2D, 0x6C, 0x76,
> 0xDE, 0x90, 0xF7, 0x71}}
> 
> +gLockDownConfigGuid  =  {0x8A838E0A, 0xA639, 0x46F0, {0xA9, 0xCE, 0x70,
> 0xC4, 0x85, 0xFB, 0xA8, 0x0D}}
> 
> +gP2sbConfigGuid  =  {0x2474DCB8, 0x4BB4, 0x49DA, {0x87, 0x83, 0x7C, 0xD3,
> 0xD3, 0x85, 0xFF, 0x07}}
> 
> +gPmConfigGuid  =  {0x93826157, 0xDC85, 0x4E34, {0xAE, 0xD9, 0x6E, 0xA1,
> 0x0D, 0xF9, 0xE3, 0xA7}}
> 
> +gScsConfigGuid  =  {0xF4DE6D52, 0xB5C9, 0x48C0, {0xA0, 0x4A, 0x68, 0x54,
> 0x20, 0x94, 0x05, 0xD0}}
> 
> +gScsInfoHobGuid = {0x94C5E85B, 0xAA6D, 0x481D, {0x8B, 0xBD, 0x54, 0xAA,
> 0xE2, 0x99, 0x78, 0xB2}}
> 
> +gSdCardConfigGuid = {0xD6A3038E, 0x50AE, 0x44B0, {0x93, 0xE2, 0xF7, 0x93,
> 0xF5, 0x90, 0x50, 0x27}}
> 
> +gEmmcConfigGuid = {0xE0C6FB5D, 0x5696, 0x47F3, {0x84, 0xE8, 0xCC, 0x6C,
> 0x68, 0xA4, 0xB2, 0x1D}}
> 
> +gUfsConfigGuid = {0x3AF25C55, 0x76B4, 0x4367, {0x85, 0xEF, 0x9D, 0x51,
> 0x2F, 0x2F, 0x8F, 0xA7}}
> 
> +gEmmcDxeConfigGuid = {0x59440AA6, 0xEB45, 0x4E36, {0xBC, 0x90, 0xBE,
> 0xF9, 0x0C, 0xB0, 0xC8, 0x18}}
> 
> +gSerialIoConfigGuid  =  {0x6CC06EBF, 0x0D34, 0x4340, {0xBC, 0x16, 0xDA,
> 0x09, 0xE5, 0x78, 0x3A, 0xDB}}
> 
> +gSerialIrqConfigGuid  =  {0x251701E7, 0xE266, 0x4623, {0x99, 0x68, 0x73,
> 0x8C, 0xD2, 0x23, 0x10, 0x96}}
> 
> +gSpiConfigGuid  =  {0x150360EF, 0x99BE, 0x4E43, {0x94, 0xBB, 0xBD, 0x40,
> 0x26, 0xCA, 0x34, 0x57}}
> 
> +gEspiConfigGuid  =  {0x60FBF3B8, 0x96D4, 0x4187, {0x84, 0x9E, 0xAA, 0xF7,
> 0x5C, 0x4B, 0xE1, 0xE3}}
> 
> +gThermalConfigGuid  =  {0x4416506D, 0x1197, 0x4722, {0xA5, 0xB4, 0x46,
> 0x11, 0xF9, 0x23, 0x9E, 0xAE}}
> 
> +gUsbConfigGuid  =  {0xB2DA9CCD, 0x6A8C, 0x4BB6, {0xB3, 0xE6, 0xCD, 0xFB,
> 0xB7, 0x66, 0x8B, 0xDE}}
> 
> +gUsb2PhyConfigGuid  =  {0x576C1134, 0x2E0C, 0xCB7D, {0xCD, 0x3F, 0xAC,
> 0x68, 0x2D, 0xAE, 0xD3, 0xF2}}
> 
> +gUsb3HsioConfigGuid  =  {0xF8AFC238, 0xF176, 0x12CE, {0xBE, 0xF4, 0x69,
> 0xF9, 0xB1, 0xAC, 0x40, 0xD5}}
> 
> +gPchPcieStorageDetectHobGuid = {0xC682F3F4, 0x2F46, 0x495E, {0x98,
> 0xAA, 0x43, 0x14, 0x4B, 0xA5, 0xA4, 0x85}}
> 
> +gCnviConfigGuid = {0xE53EBEF7, 0x103D, 0x4A70, {0x9B, 0x6A, 0x73, 0xEE,
> 0x5F, 0x4C, 0x8D, 0xF5}}
> 
> +gHsioConfigGuid = {0xE53EBEE7, 0x103D, 0x4A71, {0x9B, 0x6A, 0x74, 0xEE,
> 0x5F, 0x4C, 0x8D, 0xF5}}
> 
> +gPchRstHobGuid =  {0x4ECA680C, 0x660D, 0x48F8, {0xAA, 0xD8, 0x94, 0xD6,
> 0x56, 0x10, 0xF9, 0x86}}
> 
> +gPchInfoHobGuid  =  {0x99FD5E18, 0xE262, 0x4E6A, {0x82, 0x66, 0x77, 0xD0,
> 0x36, 0x5F, 0xD6, 0x3E}}
> 
> +gGpioDxeConfigGuid  =  {0x06985984, 0xAFA3, 0x429C, {0x80, 0xCD, 0x69,
> 0x43, 0xF3, 0x38, 0x31, 0x4D}}
> 
> +gFivrConfigGuid  =  {0x68EE8BD4, 0x05F2, 0x4656, {0xAE, 0xE4, 0xAD, 0x10,
> 0xC7, 0x22, 0xC3, 0x4F}}
> 
> +gThcConfigGuid  =  {0x1B318AD1, 0xAA0D, 0x4764, {0x99, 0xFD, 0xBB, 0x2B,
> 0xF4, 0x7F, 0x7E, 0xD6}}
> 
> +gIehConfigGuid  =  {0x42C4D7F3, 0x981D, 0x4475, {0xA2, 0xAE, 0xAD, 0xCD,
> 0xD5, 0xCE, 0x87, 0x1E}}
> 
> +gRtcConfigGuid  =  {0x0E9259B8, 0x3DDE, 0x40C7, {0xAA, 0x5F, 0x94, 0x82,
> 0x9A, 0x86, 0x8F, 0xAF}}
> 
> +gCnviConfigGuid =  {0xa660970e, 0x511b, 0x46bb, {0xa7, 0xb8, 0xec, 0xdd,
> 0xf5, 0xe2, 0x2d, 0x73}}
> 
> +gGpioCheckConflictHobGuid = {0x5603f872, 0xefac, 0x40ae, {0xb9, 0x7e,
> 0x13, 0xb2, 0xf8, 0x07, 0x80, 0x21}}
> 
> +gPsfConfigGuid  =  {0x49B12CF6, 0x0A56, 0x4B9F, {0xA8, 0x4C, 0xF5, 0x7D,
> 0x21, 0x23, 0x8C, 0x77}}
> 
> +gHybridStorageConfigGuid = {0x265CE069, 0xD8CF, 0x48BE, {0xAE, 0x12,
> 0x02, 0x4C, 0x25, 0x12, 0xFA, 0xF8}}
> 
> +gHybridStorageHobGuid = {0xFF91F620, 0x069E, 0x4191, {0x83, 0x73, 0x11,
> 0x60, 0x9F, 0x24, 0x90, 0xEB}}
> 
> +gAdrConfigGuid = {0x5B36A07C, 0x3BBF, 0x4D53, {0x8A, 0x2D, 0xE1, 0xCF,
> 0x97, 0x39, 0x0C, 0x65}}
> 
> +gSpiConfigGuid = {0xD61A6A07, 0xAD25, 0xBFC2, {0x8C, 0x60, 0xD0, 0xD1,
> 0xF4, 0x13, 0x14, 0xBC}}
> 
> +
> 
> +##
> 
> +## Fusa
> 
> +##
> 
> +gFusaConfigGuid =  {0xF9225896, 0xA9C8, 0x4543, {0xBA, 0x9E, 0x53, 0x32,
> 0xD7, 0xBF, 0x8C, 0x2B}}
> 
> +gSiFusaInfoGuid = {0xcc7876ba, 0xee7b, 0x4bd4, {0x99, 0x4b, 0x7e, 0xc9,
> 0x74, 0xc9, 0xd8, 0x43}}
> 
> +
> 
> +##
> 
> +## SecurityPkg
> 
> +##
> 
> +## GUID used to "Tcg2PhysicalPresence" variable and
> "Tcg2PhysicalPresenceFlags" variable for TPM2 request and response.
> 
> +#  Include/Guid/Tcg2PhysicalPresenceData.h
> 
> +gEfiTcg2PhysicalPresenceGuid          = { 0xaeb9c5c1, 0x94f1, 0x4d02, { 0xbf,
> 0xd9, 0x46, 0x2, 0xdb, 0x2d, 0x3c, 0x54 }}
> 
> +gEfiTrEEPhysicalPresenceGuid          =  {0xf24643c2, 0xc622, 0x494e, {0x8a,
> 0x0d, 0x46, 0x32, 0x57, 0x9c, 0x2d, 0x5b}}
> 
> +gTcoWdtHobGuid                        = { 0x3e405418, 0x0d8c, 0x4f1a, { 0xb0, 0x55,
> 0xbe, 0xf9, 0x08, 0x41, 0x46, 0x8d }}
> 
> +
> 
> +##
> 
> +## UEFI Variable Support (Direct SPI and UFS)
> 
> +##
> 
> +gCseVariableStoragePpiInstanceGuid         = { 0x9513730d, 0x06ce, 0x4cf6, {
> 0x9d, 0x95, 0xb0, 0x76, 0x31, 0xbc, 0xd5, 0xa9}}
> 
> +gFvbVariableStoragePpiInstanceGuid         = { 0x5067b88a, 0xaa37, 0x414d, {
> 0xa3, 0xca, 0xc8, 0x37, 0xfc, 0xec, 0xd6, 0xf3}}
> 
> +gCseVariableStorageProtocolInstanceGuid    = { 0x5d5ede0b, 0x5d93,
> 0x4aae, { 0xa8, 0xec, 0x08, 0x41, 0xd0, 0x53, 0x85, 0xc4}}
> 
> +gFvbVariableStorageProtocolInstanceGuid    = { 0xe98252e8, 0xf209, 0x4ef5,
> { 0xab, 0x7e, 0x12, 0x69, 0x45, 0x14, 0x47, 0xbe}}
> 
> +gPeiVariableCacheHobGuid                   = { 0x35212b29, 0x128a, 0x4754, { 0xb9,
> 0x96, 0x62, 0x45, 0xcc, 0xa8, 0xa0, 0x66}}
> 
> +gCseVariableStorageSecurePreMemoryDataGuid = { 0xa1749e1e, 0x8ce1,
> 0x4310, { 0xbd, 0x3f, 0x64, 0xc9, 0x01, 0xc6, 0x13, 0xc2}}
> 
> +gCseVariableStorageGeneralDataAreaGuid     = { 0x6d7a6128, 0x685b,
> 0x4f75, { 0x87, 0x87, 0xba, 0x93, 0x08, 0x60, 0x75, 0x0c}}
> 
> +gCseVariableStorageFileSystemGuid          = { 0xdb798aca, 0x3533, 0x41c7, {
> 0x9a, 0x98, 0x00, 0x31, 0x1b, 0x66, 0x0a, 0x15}}
> 
> +gBugCheckVariableGuid                      = { 0xba57e015, 0x65b3, 0x4c3c, { 0xb2,
> 0x74, 0x65, 0x91, 0x92, 0xf6, 0x99, 0xe3}}
> 
> +
> 
> +##
> 
> +## PreMem Performance
> 
> +##
> 
> +gPerfPchPrePolicyGuid     = {0x3112356F, 0xCC77, 0x4E82, {0x86, 0xD5, 0x3E,
> 0x25, 0xEE, 0x81, 0x92, 0xA4}}
> 
> +gPerfSiValidateGuid       = {0x681F96E6, 0xF9CF, 0x464D, {0x97, 0x9A, 0xB1,
> 0x11, 0x33, 0xDE, 0x37, 0xA9}}
> 
> +gPerfPchValidateGuid      = {0xD0FF37D6, 0xA569, 0x4058, {0xB3, 0xDA, 0x29,
> 0x0B, 0x38, 0xC5, 0x32, 0x25}}
> 
> +gPerfAmtValidateGuid      = {0x9E949422, 0x4A7A, 0x4E41, {0xB0, 0xAB,
> 0x3C, 0x0D, 0x88, 0x0A, 0x00, 0xFF}}
> 
> +gPerfCpuValidateGuid      = {0xB760CFCC, 0xDEEF, 0x4C7E, {0x99, 0x5B, 0xED,
> 0xFE, 0xF2, 0x23, 0xB2, 0x09}}
> 
> +gPerfMeValidateGuid       = {0x8CF7A498, 0x588D, 0x4D39, {0xBD, 0xAC,
> 0x51, 0x0C, 0x31, 0xAF, 0x45, 0xD0}}
> 
> +gPerfSaValidateGuid       = {0xA73B382B, 0x62D4, 0x4A19, {0xBB, 0xF9, 0x09,
> 0x3E, 0xC5, 0xA5, 0x93, 0x11}}
> 
> +gPerfHeciPreMemGuid       = {0xD815D922, 0x4994, 0x40B3, {0x97, 0xCC,
> 0x07, 0xF3, 0x7D, 0x42, 0xE7, 0x97}}
> 
> +gPerfPchPreMemGuid        = {0xBB73E2B1, 0xB9FD, 0x4A80, {0xB8, 0x1A,
> 0x52, 0x39, 0xE9, 0x4D, 0x06, 0x2E}}
> 
> +gPerfCpuPreMemGuid        = {0xAC5FCBC6, 0x084D, 0x445D, {0xB3, 0xF3,
> 0xCA, 0x16, 0xDE, 0xE9, 0xBB, 0x47}}
> 
> +gPerfMePreMemGuid         = {0x6051338E, 0x0FFA, 0x40F7, {0xAF, 0xEF,
> 0xAB, 0x86, 0x7A, 0x38, 0xCC, 0xF3}}
> 
> +gPerfAmtPreMemGuid        = {0xDB732D50, 0x9BB8, 0x489A, {0xA1, 0xD1,
> 0xDD, 0xD2, 0x16, 0x1D, 0x72, 0xB8}}
> 
> +gPerfAmtPostMemGuid       = {0x0329D610, 0x4269, 0xD28F, {0x61, 0xBF,
> 0xB9, 0xA2, 0xD9, 0xFA, 0x96, 0x93}}
> 
> +gPerfSaPreMemGuid         = {0x76F18BDA, 0x2195, 0x4FB6, {0x9A, 0x94,
> 0x0E, 0x0B, 0xAC, 0xDE, 0xEC, 0xAB}}
> 
> +gPerfEvlGuid              = {0x8221518B, 0xAC19, 0x4E32, {0xAB, 0x5F, 0x00, 0x47,
> 0x0A, 0x50, 0x69, 0x40}}
> 
> +gPerfMemGuid              = {0x2B57B316, 0x5CF7, 0x4847, {0xB0, 0x76, 0x6B,
> 0x5D, 0x23, 0xC3, 0xAA, 0x3E}}
> 
> +
> 
> +##
> 
> +## PostMem Performance
> 
> +##
> 
> +gPerfPchPostMemGuid       = {0x70B67A99, 0x5556, 0x4315, {0xB3, 0x05,
> 0xD5, 0xDC, 0x4A, 0x35, 0x63, 0x70}}
> 
> +gPerfSaPostMemGuid        = {0x9FF0CE92, 0x883F, 0x43DC, {0x8A, 0x07,
> 0xE0, 0xCB, 0x6D, 0x56, 0x7D, 0xE0}}
> 
> +gPerfS3CpuInitPostMemGuid = {0x976262C2, 0xD202, 0x4D12, {0x82, 0xAD,
> 0xF4, 0xA9, 0x8F, 0x9B, 0x96, 0x01}}
> 
> +gPerfSaSecLockPostMemGuid = {0x272AC110, 0x0B60, 0x4D07, {0xA5, 0x58,
> 0x6D, 0x73, 0xE2, 0x43, 0x85, 0x95}}
> 
> +gPerfCpuStrapPostMemGuid  = {0x8EF4372B, 0x68F0, 0x4957, {0xBC, 0x4D,
> 0x7E, 0x5C, 0xFE, 0xDA, 0xB6, 0x3E}}
> 
> +gPerfMpPostMemGuid        = {0xA59BAC5B, 0xC6A4, 0x4AEB, {0x84, 0x32,
> 0x7A, 0x8B, 0x6B, 0x68, 0x5F, 0x37}}
> 
> +gPerfCpuPostMemGuid       = {0xE2FE5ED3, 0x1417, 0x451A, {0x95, 0xC9,
> 0xD0, 0xB2, 0xB9, 0x7B, 0xE0, 0x54}}
> 
> +gPerfSaResetPostMemGuid   = {0xBE152BEE, 0xFD19, 0x4274, {0xA8, 0xBA,
> 0xFB, 0x31, 0x42, 0xB5, 0xB5, 0xC3}}
> 
> +gPerfCpuPowerMgmtGuid     = {0x9ED307D6, 0x4AEB, 0x44A9, {0x9B, 0x11,
> 0xD8, 0x21, 0x84, 0x9A, 0xCB, 0xF7}}
> 
> +gPerfMePostMemGuid        = {0x2CC8626D, 0x3387, 0x4817, {0xAB, 0xF6,
> 0x86, 0x9A, 0xF5, 0xF0, 0x51, 0xAA}}
> 
> +gPerfHdaPostMemGuid       = {0xB31883B7, 0x5A05, 0x4040, {0x40, 0x80,
> 0x66, 0x8D, 0x29, 0x13, 0xD7, 0x84}}
> 
> +
> 
> +##
> 
> +## Dp-In Guid
> 
> +##
> 
> +## Include/DpInDataHob.h
> 
> +gDpInHobGuid = {0x3e110a83, 0xb94b, 0x4648, {0xa2, 0x26, 0x50, 0x9b,
> 0xd5, 0x55, 0xe3, 0x6b}}
> 
> +## Include/ConfigBlock/Tcss/DpInPreMemConfig.h
> 
> +gDpInPreMemConfigGuid = {0x80c14ba, 0xcc84, 0x4746, {0xbf, 0x6b, 0xd1,
> 0xf1, 0x8e, 0xaa, 0xe8, 0x35}}
> 
> +
> 
> +[Protocols.common.Private]
> 
> +##
> 
> +## SA
> 
> +##
> 
> +gSaIotrapSmiProtocolGuid    = { 0x1861e089, 0xcaa3, 0x473e, { 0x84, 0x32,
> 0xdc, 0x1f, 0x94, 0xc6, 0xc1, 0xa6 }}
> 
> +gCpuPcieIoTrapProtocolGuid  = { 0xda904080, 0x33ab, 0x48ca, { 0x97, 0x5b,
> 0x5f, 0x2f, 0x23, 0x8a, 0x41, 0xb4 }}
> 
> +
> 
> +gPchPcieIoTrapProtocolGuid      = { 0xd66a1cf,  0x79ad, 0x494b, { 0x97, 0x8b,
> 0xb2, 0x59, 0x81, 0x68, 0x93, 0x34 }}
> 
> +
> 
> +[Protocols]
> 
> +##
> 
> +## MdeModulePkg
> 
> +##
> 
> +gEfiSmmVariableProtocolGuid  =  {0xed32d533, 0x99e6, 0x4209, {0x9c, 0xc0,
> 0x2d, 0x72, 0xcd, 0xd9, 0x98, 0xa7}}
> 
> +gEdkiiPlatformSpecificResetFilterProtocolGuid  = { 0x695d7835, 0x8d47,
> 0x4c11, { 0xab, 0x22, 0xfa, 0x8a, 0xcc, 0xe7, 0xae, 0x7a } }
> 
> +gEdkiiPlatformSpecificResetHandlerProtocolGuid = { 0x2df6ba0b, 0x7092,
> 0x440d, { 0xbd, 0x4, 0xfb, 0x9, 0x1e, 0xc3, 0xf3, 0xc1 } }
> 
> +
> 
> +##
> 
> +## SystemAgent
> 
> +##
> 
> +gBdatAccessGuid                 =  {0x9477482c, 0x8717, 0x4725, {0x98, 0x28, 0x7b,
> 0xd8, 0xc9, 0xa3, 0x75, 0x6a}}
> 
> +gIgdOpRegionProtocolGuid        =  {0x9e67aecf, 0x4fbb, 0x4c84, {0x99, 0xa5,
> 0x10, 0x73, 0x40, 0x7,  0x6d, 0xb4}}
> 
> +gMemInfoProtocolGuid            =  {0xd4d2f201, 0x50e8, 0x4d45, {0x8e, 0x5,
> 0xfd, 0x49, 0xa8, 0x2a, 0x15, 0x69}}
> 
> +gSaPolicyProtocolGuid           =  {0xc6aa1f27, 0x5597, 0x4802, {0x9f, 0x63,
> 0xd6, 0x28, 0x36, 0x59, 0x86, 0x35}}
> 
> +gSaNvsAreaProtocolGuid          =  {0x149a10a5, 0x9d06, 0x4c6b, {0xbe, 0x44,
> 0x08, 0x92, 0xce, 0x20, 0x61, 0xac}}
> 
> +gGopPolicyProtocolGuid          =  {0xec2e931b, 0x3281, 0x48a5, {0x81, 0x07,
> 0xdf, 0x8a, 0x8b, 0xed, 0x3c, 0x5d}}
> 
> +gGen12PolicyProtocolGuid        =  {0x40f60ea0, 0x6c96, 0x4ed3, {0x96, 0xe5,
> 0xba, 0x6f, 0x6d, 0x66, 0x28, 0x9f}}
> 
> +gGen9PolicyProtocolGuid         =  {0xeaaed1ba, 0xf15c, 0x4112, {0xb5, 0x82,
> 0x90, 0x63, 0xac, 0xa0, 0x7f, 0x06}}
> 
> +gGopComponentName2ProtocolGuid  =  {0x651b7ebd, 0xce13, 0x41d0,
> {0x82, 0xe5, 0xa0, 0x63, 0xab, 0xbe, 0x9b, 0xb6}}
> 
> +gGopOverrideProtocolGuid        =  {0x4a89a16e, 0x67b8, 0x4429, {0x8c, 0x47,
> 0x43, 0x67, 0x90, 0xf2, 0xf2, 0x69}}
> 
> +gMemoryAddressEncodeDecodeProtocolGuid = {0x603df7ca, 0x1ba8,
> 0x4c12, {0xa9, 0x8a, 0x49, 0x6d, 0xfe, 0x77, 0xeb, 0xdf}}
> 
> +
> 
> +##
> 
> +## TBT
> 
> +##
> 
> +gITbtPolicyProtocolGuid       =  {0xb0563c42, 0x28ea, 0x40e6, {0x99, 0x84,
> 0xd5, 0xbf, 0xf8, 0xb0, 0x40, 0x56}}
> 
> +gITbtNvsAreaProtocolGuid      =  {0xdabf85bd, 0xfbdc, 0x4ed2, {0xb1, 0x0d,
> 0xc9, 0x08, 0xd0, 0x8c, 0xee, 0xe8}}
> 
> +gDisableITbtBmeProtocolGuid      =  {0x89a9adc3, 0x9b7c, 0x4b53, {0x82,
> 0xbf, 0x78, 0x72, 0x6b, 0x91, 0x4f, 0x9f}}
> 
> +
> 
> +##
> 
> +## Cpu
> 
> +##
> 
> +gCpuInfoProtocolGuid  =  {0xe223cf65, 0xf6ce, 0x4122, {0xb3, 0xaf, 0x4b,
> 0xd1, 0x8a, 0xff, 0x40, 0xa1}}
> 
> +gSmmBiosGuardProtocolGuid  =  {0x17565311, 0x4b71, 0x4340, {0x88, 0xaa,
> 0xdc, 0x9f, 0x44, 0x22, 0xe5, 0x3a}}
> 
> +gCpuNvsAreaProtocolGuid  =  {0xb9cf3f43, 0xbe3e, 0x4e45, {0xa0, 0xbe,
> 0x1a, 0x4, 0x89, 0xdf, 0x1a, 0xc9}}
> 
> +gDxeCpuPolicyProtocolGuid  =  {0x8282b977, 0x22f9, 0x4134, {0x99, 0x43,
> 0x7b, 0xcc, 0x5f, 0x40, 0x33, 0x52}}
> 
> +gBiosGuardNvsAreaProtocolGuid  =  {0x5df588da, 0x991e, 0x4a7f, {0x80,
> 0x51, 0x70, 0xc7, 0x12, 0xb7, 0xba, 0xb0}}
> 
> +gSmmResourceConfigProtocolGuid = {0xA37FC2D2, 0x822D, 0x4A63, {0x9C,
> 0x42, 0xBE, 0xB1, 0xD6, 0xEE, 0x85, 0x39}}
> 
> +
> 
> +##
> 
> +## Me
> 
> +##
> 
> +gActiveManagementProtocolGuid     = {0xd25dc167, 0xeb6a, 0x432d, {0x65,
> 0x91, 0xbf, 0x80, 0x29, 0xb0, 0x05, 0xbb}}
> 
> +gAlertStandardFormatProtocolGuid  = {0x45de9920, 0xcd54, 0x446a, {0xa0,
> 0x3c, 0x22, 0xe6, 0xfb, 0xb4, 0x51, 0xe4}}
> 
> +gHeciProtocolGuid                 = {0x3c7bc880, 0x41f8, 0x4869, {0xae, 0xfc, 0x87,
> 0x0a, 0x3e, 0xd2, 0x82, 0x99}}
> 
> +gHeciFlowProtocolGuid             = {0x1498d127, 0x123c, 0x4e52, {0x84, 0x00,
> 0xcc, 0x3c, 0x9f, 0x79, 0xc4, 0x0e}}
> 
> +gMebxProtocolGuid                 = {0x01ab1829, 0xcecd, 0x4cfa, {0xa1, 0x8c,
> 0xea, 0x75, 0xd6, 0x6f, 0x3e, 0x74}}
> 
> +gDxeMePolicyGuid                  = {0xa0b5dc52, 0x4f34, 0x3990, {0xd4, 0x91,
> 0x10, 0x8b, 0xe8, 0xba, 0x75, 0x42}}
> 
> +gMeInfoProtocolGuid               = {0x7523c8e4, 0x4fbe, 0x9661, {0x29, 0x96,
> 0x14, 0x97, 0xff, 0x36, 0x2f, 0x3b}}
> 
> +gPlatformMeHookProtocolGuid       = {0xbc52476e, 0xf67e, 0x4301, {0xb2,
> 0x62, 0x36, 0x9c, 0x48, 0x78, 0xaa, 0xc2}}
> 
> +gMeNvsAreaProtocolGuid            = {0x3bffecfd, 0xd75f, 0x4975, {0xb8, 0x88,
> 0x39, 0x02, 0xbd, 0x69, 0x00, 0x2b}}
> 
> +gJhiProtocolGuid                  = {0xccba3051, 0xa574, 0x4f9d, {0x96, 0xf4, 0xec,
> 0x0d, 0x4a, 0x87, 0xbc, 0x5a}}
> 
> +gIntegratedTouchHidProtocolGuid   = {0x3d0479c1, 0x6b19, 0x4191, {0xb8,
> 0x09, 0x60, 0x08, 0xdd, 0x07, 0x97, 0x55}}
> 
> +gIntegratedTouchProtocolGuid      = {0x2b12e46f, 0x3c24, 0x47ff, {0x8b,
> 0x89, 0xc0, 0x60, 0x2c, 0x1c, 0x61, 0x42}}
> 
> +gMeEopDoneProtocolGuid            = {0x8d9b3387, 0x73db, 0x456f, {0x88,
> 0x9d, 0x6f, 0xfe, 0x90, 0x82, 0x64, 0x09}}
> 
> +gMeSendEopInFspProtocolGuid       = {0xcecdba92, 0x76c6, 0x4063, {0xaa,
> 0x6b, 0x19, 0xfc, 0x60, 0x5c, 0x70, 0xff}}
> 
> +
> 
> +gHeciAccessProtocolGuid          = {0x3a5aab32, 0xd5a7, 0x4ce8, {0x88, 0xe2,
> 0xed, 0x8f, 0x7b, 0x43, 0x23, 0x9d}}
> 
> +gHeciTransportProtocolGuid       = {0x9fc932b9, 0x8851, 0x43f7, {0x8a, 0x58,
> 0xa8, 0xd9, 0x04, 0x01, 0xcd, 0x78}}
> 
> +gHeciControlProtocolGuid         = {0xd86381d8, 0xff7e, 0x462e, {0x9b, 0x55,
> 0x02, 0x0a, 0x64, 0x1b, 0xe3, 0x4f}}
> 
> +gHeciAccessSmmProtocolGuid       = {0x5da6182c, 0xf679, 0x49eb, {0x96,
> 0xf5, 0xe6, 0x24, 0x9b, 0x54, 0x0b, 0x96}}
> 
> +gHeciTransportSmmProtocolGuid    = {0xf5f7b292, 0xbb38, 0x4e59, {0xa1,
> 0x6e, 0x0f, 0x27, 0x15, 0xd4, 0xb7, 0xf4}}
> 
> +gHeciControlSmmProtocolGuid      = {0x7e1e508d, 0x7def, 0x4d69, {0xa9,
> 0xb3, 0xa5, 0x23, 0xe8, 0x48, 0xc6, 0x98}}
> 
> +
> 
> +##
> 
> +## Amt
> 
> +##
> 
> +gAmtSaveMebxProtocolGuid          = {0x86682c04, 0xea42, 0x49e5, {0x96,
> 0x81, 0xe3, 0x32, 0xaa, 0xb0, 0x9e, 0xd7}}
> 
> +gDxeAmtPolicyGuid                 = {0x6725e645, 0x4a7f, 0x9969, {0x82, 0xec,
> 0xd1, 0x87, 0x21, 0xde, 0x5a, 0x57}}
> 
> +gAmtReadyToBootProtocolGuid       = {0xcc9d5c0b, 0x9010, 0x45f1, {0x99,
> 0x3c, 0x83, 0x27, 0x67, 0xf1, 0x67, 0x77}}
> 
> +gMeSmbiosTablesUpdateProtocolGuid = {0x5054ee06, 0x4ce0, 0x4acc,
> {0x9a, 0x80, 0xdf, 0x73, 0xbf, 0xa5, 0x38, 0xdd}}
> 
> +gOneClickRecoveryProtocolGuid     = {0x93598eac, 0xc62b, 0x4dbb, {0x96,
> 0x76, 0xe0, 0x5e, 0x8c, 0xc3, 0x84, 0x44}}
> 
> +
> 
> +##
> 
> +## PCH
> 
> +##
> 
> +gThcProtocolGuid  = {0x00860921, 0x7B9B, 0x4EA8, {0xAD, 0x23, 0x3C, 0xCA,
> 0x33, 0x9E, 0x7D, 0xFE}}
> 
> +gPchSpiProtocolGuid  =  {0xc7d289, 0x1347, 0x4de0, {0xbf, 0x42, 0xe, 0x26,
> 0x9d, 0xe, 0xf3, 0x4a}}
> 
> +gWdtProtocolGuid  =  {0xb42b8d12, 0x2acb, 0x499a, {0xa9, 0x20, 0xdd, 0x5b,
> 0xe6, 0xcf, 0x09, 0xb1}}
> 
> +gPchSerialIoUartDebugInfoProtocolGuid  =  {0x2fd2b1bd, 0x0387, 0x4ec6,
> {0x94, 0x1f, 0xf1, 0x4b, 0x7f, 0x1c, 0x94, 0xb6}}
> 
> +gEfiSmmSmbusProtocolGuid  =  {0x72e40094, 0x2ee1, 0x497a, {0x8f, 0x33,
> 0x4c, 0x93, 0x4a, 0x9e, 0x9c, 0x0c}}
> 
> +gPchSmmSpiProtocolGuid  =  {0x56521f06, 0xa62, 0x4822, {0x99, 0x63, 0xdf,
> 0x1, 0x9d, 0x72, 0xc7, 0xe1}}
> 
> +gPchSmmIoTrapControlGuid  =  {0x514d2afd, 0x2096, 0x4283, {0x9d, 0xa6,
> 0x70, 0x0c, 0xd2, 0x7d, 0xc7, 0xa5}}
> 
> +gPchTcoSmiDispatchProtocolGuid  =  {0x9e71d609, 0x6d24, 0x47fd, {0xb5,
> 0x72, 0x61, 0x40, 0xf8, 0xd9, 0xc2, 0xa4}}
> 
> +gPchPcieSmiDispatchProtocolGuid  =  {0x3e7d2b56, 0x3f47, 0x42aa, {0x8f,
> 0x6b, 0x22, 0xf5, 0x19, 0x81, 0x8d, 0xab}}
> 
> +gPchAcpiSmiDispatchProtocolGuid  =  {0xd52bb262, 0xf022, 0x49ec, {0x86,
> 0xd2, 0x7a, 0x29, 0x3a, 0x7a, 0x05, 0x4b}}
> 
> +gPchSmiDispatchProtocolGuid  =  {0xE6A81BBF, 0x873D, 0x47FD, {0xB6,
> 0xBE, 0x61, 0xB3, 0xE5, 0x72, 0x09, 0x93}}
> 
> +gPchNvsAreaProtocolGuid  =  {0x2e058b2b, 0xedc1, 0x4431, {0x87, 0xd9,
> 0xc6, 0xc4, 0xea, 0x10, 0x2b, 0xe3}}
> 
> +gPchEspiSmiDispatchProtocolGuid  =  {0xB3C14FF3, 0xBAE8, 0x456C, {0x86,
> 0x31, 0x27, 0xFE, 0x0C, 0xEB, 0x34, 0x0C}}
> 
> +gPchSmmPeriodicTimerControlGuid  =  {0x6906E93B, 0x603B, 0x4A0F, {0x86,
> 0x92, 0x83, 0x20, 0x04, 0xAA, 0xF2, 0xDB}}
> 
> +gIoTrapExDispatchProtocolGuid  =  {0x5B48E913, 0x707B, 0x4F9D, {0xAF,
> 0x2E, 0xEE, 0x03, 0x5B, 0xCE, 0x39, 0x5D}}
> 
> +gPchPolicyProtocolGuid           =  {0x543d5c93, 0x6a28, 0x4513, {0x85, 0x9a,
> 0x82, 0xa7, 0xb9, 0x12, 0xcb, 0xbe}}
> 
> +gScsEmmcSoftwareTuningProtocolGuid = {0x972215b2, 0x9616, 0x4de4,
> {0xa9, 0x75, 0xb0, 0x74, 0x3e, 0xe1, 0x78, 0x54}}
> 
> +
> 
> +##
> 
> +## Hsti
> 
> +##
> 
> +## HstiSiliconDxe Driver Entry Point
> 
> +gHstiProtocolGuid = { 0x1b05de41, 0xc93b, 0x4bb4, { 0xad, 0x47, 0x2a, 0x78,
> 0xac, 0xf, 0xc9, 0xe4 }}
> 
> +## Handler to gather and publish HSTI results on ReadyToBootEvent
> 
> +gHstiPublishCompleteProtocolGuid =  {0x0f500be6, 0xece4, 0x4ed8, { 0x90,
> 0x81, 0x9a, 0xa9, 0xa5, 0x23, 0xfb, 0x7b}}
> 
> +gEfiAdapterInformationProtocolGuid = { 0xE5DD1403, 0xD622, 0xC24E,
> {0x84, 0x88, 0xC7, 0x1B, 0x17, 0xF5, 0xE8, 0x02 }}
> 
> +
> 
> +##
> 
> +## Silicon Policy
> 
> +##
> 
> +## Include/Protocol/SiPolicyProtocol.h
> 
> +gDxeSiPolicyProtocolGuid = { 0xeca27516, 0x306c, 0x4e28, { 0x8c, 0x94,
> 0x4e, 0x52, 0x10, 0x96, 0x69, 0x5e }}
> 
> +
> 
> +##
> 
> +## DGR
> 
> +##
> 
> +gEfiSpaLogOutputProtocolGuid = { 0x1d10d46b, 0x0306, 0x454a, { 0x90,
> 0x8c, 0x93, 0x65, 0xb3, 0x8a, 0x90, 0x26 }}
> 
> +
> 
> +[Ppis.common.Private]
> 
> +gPchHsioChipsetInitSusTblDataPpiGuid = { 0x97ed4e5d, 0x01a5, 0x4a3c, {
> 0xb7, 0xe9, 0x1a, 0x4e, 0xa3, 0xdd, 0x23, 0xce }}
> 
> +gHybridStorageCfgPpiGuid = {0x8557e481, 0xc00e, 0x4929, {0xb4, 0x53,
> 0xf6, 0xc2, 0x53, 0x79, 0xb0, 0x13}}
> 
> +
> 
> +[Ppis]
> 
> +##
> 
> +## MdeModulePkg
> 
> +##
> 
> +gPeiCapsulePpiGuid  =  {0x3acf33ee, 0xd892, 0x40f4, {0xa2, 0xfc, 0x38, 0x54,
> 0xd2, 0xe1, 0x32, 0x3d}}
> 
> +gPeiSmmControlPpiGuid  =  {0x61c68702, 0x4d7e, 0x4f43, {0x8d, 0xef, 0xa7,
> 0x43, 0x05, 0xce, 0x74, 0xc5}}
> 
> +gEdkiiPlatformSpecificResetFilterPpiGuid = { 0x8c9f4de3, 0x7b90, 0x47ef, {
> 0x93, 0x8, 0x28, 0x7c, 0xec, 0xd6, 0x6d, 0xe8 } }
> 
> +gEdkiiPlatformSpecificResetNotificationPpiGuid = { 0xe09f355d, 0xdae8,
> 0x4910, { 0xb1, 0x4a, 0x92, 0x78, 0xf, 0xdc, 0xf7, 0xcb } }
> 
> +gEdkiiPlatformSpecificResetHandlerPpiGuid = { 0x75cf14ae, 0x3441, 0x49dc,
> { 0xaa, 0x10, 0xbb, 0x35, 0xa7, 0xba, 0x8b, 0xab } }
> 
> +
> 
> +##
> 
> +## SecurityPkg
> 
> +##
> 
> +gPeiTpmInitializedPpiGuid  =  {0xe9db0d58, 0xd48d, 0x47f6, {0x9c, 0x6e,
> 0x6f, 0x40, 0xe8, 0x6c, 0x7b, 0x41}}
> 
> +gPeiTpmInitializationDonePpiGuid = {0xa030d115, 0x54dd, 0x447b, { 0x90,
> 0x64, 0xf2, 0x6, 0x88, 0x3d, 0x7c, 0xcc}}
> 
> +##
> 
> +## Common
> 
> +##
> 
> +## Include/Ppi/SiPolicy.h
> 
> +gSiPolicyPpiGuid  =  {0xaebffa01, 0x7edc, 0x49ff, {0x8d, 0x88, 0xcb, 0x84,
> 0x8c, 0x5e, 0x86, 0x70}}
> 
> +## Include/Ppi/SiPolicy.h
> 
> +gSiPreMemPolicyPpiGuid = {0xc133fe57, 0x17c7, 0x4b09, {0x8b, 0x3c, 0x97,
> 0xc1, 0x89, 0xd0, 0xab, 0x8d}}
> 
> +gFspApiModePpiGuid          = {0xa1eeab87, 0xc859, 0x479d, {0x89, 0xb5,
> 0x14, 0x61, 0xf4, 0x06, 0x1a, 0x3e}}
> 
> +## Silicon Initialization PPI is used to export End of Silicon init.
> 
> +gEndOfSiInitPpiGuid         = {0xE2E3D5D1, 0x8356, 0x4F96, {0x9C, 0x9E, 0x2E,
> 0xC3, 0x48, 0x1D, 0xEA, 0x88}}
> 
> +gEfiEndOfPeiSignal2PpiGuid  = {0x22918381, 0xd018, 0x4d7c, {0x9d, 0x62,
> 0xf5, 0xa5, 0x70, 0x1c, 0x66, 0x80}}
> 
> +gFspTempRamExitPpiGuid      = {0xbc1cfbdb, 0x7e50, 0x42be, {0xb4, 0x87,
> 0x22, 0xe0, 0xa9, 0x0c, 0xb0, 0x52}}
> 
> +gFspmArchConfigPpiGuid      = {0x824d5a3a, 0xaf92, 0x4c0c, {0x9f, 0x19,
> 0x19, 0x52, 0x6d, 0xca, 0x4a, 0xbb}}
> 
> +gSiPreMemDefaultPolicyInitPpiGuid =  {0xfec36242, 0xf8d8, 0x4b43, {0x87,
> 0x94, 0x4f, 0x1f, 0x9f, 0x63, 0x8d, 0xdc}}
> 
> +gSiPreMemPolicyReadyPpiGuid = {0x85270bef, 0x6984, 0x4375, {0xa6, 0xea,
> 0xb5, 0xaa, 0x90, 0x6e, 0xdd, 0x4a}}
> 
> +gSiDefaultPolicyInitPpiGuid = {0xf69abf86, 0x4048, 0x44ef, { 0xa8, 0xef,
> 0x6c, 0x7f, 0x20, 0x4a, 0xc8, 0xda}}
> 
> +gSiPolicyReadyPpiGuid       = {0xd570de8c, 0xb9c4, 0x4ffa, {0xad, 0xee, 0xa5,
> 0x82, 0x7c, 0xe3, 0x17, 0x79}}
> 
> +
> 
> +##
> 
> +## UEFI Variable Support (Override Until BP1.5)
> 
> +##
> 
> +gEdkiiVariableStoragePpiGuid  =  { 0x90d915c5, 0xe4c1, 0x4da8, {0xa7, 0x6f,
> 0x9,  0xe5, 0x78, 0x91, 0x65, 0x48}}
> 
> +gEdkiiVariableStorageSelectorPpiGuid  =  { 0x782546d1, 0x03ab, 0x41e4,
> {0xa0, 0x1d, 0x7a, 0x9b, 0x22, 0xba, 0x2e, 0x1e}}
> 
> +gReadOnlyVariablePreMemoryDescriptorPpiGuid  =  { 0xbe136fc9, 0xc277,
> 0x4dd1, {0xbe, 0x42, 0xce, 0xf0, 0x9f, 0xf4, 0x3f, 0x55}}
> 
> +gEfiReadyToInstallEndOfPei2PpiGuid = {0xeef72924, 0x2db2, 0x4569, { 0x86,
> 0x3f, 0xd4, 0x86, 0xae, 0x7a, 0xe4, 0x12}}
> 
> +
> 
> +##
> 
> +## SystemAgent
> 
> +##
> 
> +gSsaBiosCallBacksPpiGuid  =  {0x99b56126, 0xe16c, 0x4d9b, {0xbb, 0x71,
> 0xaa, 0x35, 0x46, 0x1a, 0x70, 0x2f}}
> 
> +gSsaBiosServicesPpiGuid   =  {0x55750d10, 0x6d3d, 0x4bf5, {0x89, 0xd8,
> 0xe3, 0x5e, 0xf0, 0xb0, 0x90, 0xf4}}
> 
> +gEnablePeiGraphicsPpiGuid =  {0x8e3bb474, 0x545,  0x4902, {0x86, 0xb0,
> 0x6c, 0xb5, 0xe2, 0x64, 0xb4, 0xa5}}
> 
> +gPeiGraphicsFramebufferReadyPpiGuid = {0x590ad868, 0xb0b1, 0x4d20,
> {0x91, 0xff, 0xc2, 0xa9, 0xd6, 0x88, 0x81, 0x94}}
> 
> +gMrcMemoryInitDonePpiGuid =  {0x0ff07255, 0x67c2, 0x456d, {0x9a, 0x95,
> 0xc9, 0x16, 0x2c, 0x23, 0x86, 0x8d}}
> 
> +## X Compatibility support PPI
> 
> +gCompatibleMemoryInitPpiGuid = {0xca311f82, 0xf490, 0x4b12, {0x9e, 0xe1,
> 0x2b, 0x66, 0xa3, 0x6c, 0x3e, 0xa}}
> 
> +gVmdInitDonePpiGuid =          {0x42a187c8, 0xca0a, 0x4750, {0x82, 0xfd, 0xc9,
> 0xa0, 0xd5, 0x9, 0xfe, 0xd1}}
> 
> +
> 
> +##
> 
> +## TwoLm
> 
> +##
> 
> +gMrcMemoryInitDonePpiGuid  = { 0x598907f5, 0xd5fc, 0x435c, { 0x8a, 0x7f,
> 0x53, 0xc5, 0xa4, 0xb5, 0x31, 0xc4}}
> 
> +
> 
> +##
> 
> +## Nvdimm Cache Info
> 
> +##
> 
> +gNvdimmCachePpiGuid  = { 0x1bbc5601, 0xe571, 0x4ae0, { 0xbc, 0x38, 0xb8,
> 0x65, 0x0d, 0x50, 0x6f, 0x5b}}
> 
> +
> 
> +##
> 
> +## Cpu
> 
> +##
> 
> +gPeiCachePpiGuid  =  {0x09be4bc2, 0x790e, 0x4dea, {0x8b, 0xdc, 0x38, 0x05,
> 0x16, 0x98, 0x39, 0x44}}
> 
> +gPeiTxtMemoryUnlockedPpiGuid  =  {0x38cdd10b, 0x767d, 0x4f6e, {0xa7,
> 0x44, 0x67, 0xee, 0x1d, 0xfe, 0x2f, 0xa5}}
> 
> +gPeiTxtReadyToRunMemoryInitPpiGuid = {0x9ecafd30, 0x29e2, 0x42f6,
> {0xba, 0xf3, 0x8b, 0x7d, 0xb8, 0xfe, 0x1f, 0x22}}
> 
> +gPeiReadyToInstallMpPpiGuid = { 0x1a266768, 0xfd43, 0x4e18, { 0xa8, 0x8a,
> 0x35, 0xc7, 0x94, 0xc3, 0x91, 0x0e }}
> 
> +##
> 
> +## Me
> 
> +##
> 
> +gHeciPpiGuid  =  {0xd14319e2, 0x407a, 0x9580, {0x8d, 0xe5, 0x51, 0xa8, 0xff,
> 0xc6, 0xd7, 0xd7}}
> 
> +gMbpSensitivePpiGuid  =  {0xed7c9ce9, 0x5912, 0x4807, {0xec, 0x90, 0x22,
> 0x18, 0xbc, 0x7b, 0xfc, 0x6c}}
> 
> +gHeci3IntegratedTouchControllerGuid  =  {0x3e8d0870, 0x271a, 0x4208,
> {0x8e, 0xb5, 0x9a, 0xcb, 0x94, 0x02, 0xae, 0x04}}
> 
> +gSiNvmOwnershipAcquiredPpiGuid = {0xe5db3d8c, 0xefa4, 0x4308, {0x9a,
> 0xab, 0x6b, 0x97, 0x81, 0x09, 0x98, 0xa0}}
> 
> +gHeciAccessPpiGuid = {0x3a5aab32, 0xd5a7, 0x4ce8, {0x88, 0xe2, 0xed, 0x8f,
> 0x7b, 0x43, 0x23, 0x9d}}
> 
> +gHeciTransportPpiGuid = {0x9fc932b9, 0x8851, 0x43f7, {0x8a, 0x58, 0xa8,
> 0xd9, 0x04, 0x01, 0xcd, 0x78}}
> 
> +gHeciControlPpiGuid  = {0xd86381d8, 0xff7e, 0x462e, {0x9b, 0x55, 0x02,
> 0x0a, 0x64, 0x1b, 0xe3, 0x4f}}
> 
> +gMeBeforeDidSentPpiGuid = {0xd497b143, 0xf3ef, 0x4192, {0xa8, 0xc5,
> 0x5e, 0xf6, 0xcd, 0x6e, 0x4c, 0x87}}
> 
> +
> 
> +##
> 
> +## PCH
> 
> +##
> 
> +gWdtPpiGuid  =  {0xf38d1338, 0xaf7a, 0x4fb6, {0x91, 0xdb, 0x1a, 0x9c, 0x21,
> 0x83, 0x57, 0x0d}}
> 
> +gPchSpiPpiGuid  =  {0xdade7ce3, 0x6971, 0x4b75, {0x82, 0x5e, 0xe, 0xe0,
> 0xeb, 0x17, 0x72, 0x2d}}
> 
> +gPeiSmbusPolicyPpiGuid  =  {0x63b6e435, 0x32bc, 0x49c6, {0x81, 0xbd, 0xb7,
> 0xa1, 0xa0, 0xfe, 0x1a, 0x6c}}
> 
> +
> 
> +##
> 
> +## TCSS
> 
> +##
> 
> +gTcssPeiInitDonePpiGuid = {0x5ad291b8, 0xace4, 0x416a, {0xb7, 0x50, 0x7,
> 0x63, 0x59, 0xfc, 0xc1, 0x5b}}
> 
> +
> 
> +[LibraryClasses]
> 
> +## @libraryclass
> 
> +## Common
> 
> +##
> 
> +MmPciLib|Include/Library/MmPciLib.h
> 
> +
> 
> +## @libraryclass
> 
> +## SampleCode
> 
> +##
> 
> +## CPU
> 
> +##
> 
> +CpuPolicyLib|Cpu/Include/Library/CpuPolicyLib.h
> 
> +
> 
> +## @libraryclass
> 
> +## Me
> 
> +##
> 
> +
> 
> +MeChipsetLib|Me/Include/Library/MeChipsetLib.h
> 
> +
> 
> +PeiMePolicyLib|Me/Include/Library/PeiMePolicyLib.h
> 
> +PttHciLib|Me/Include/Library/PttHciLib.h
> 
> +PttHeciLib|Me/Include/Library/PttHeciLib.h
> 
> +## @libraryclass
> 
> +## Pch
> 
> +##
> 
> +GpioLib|Include/Library/GpioLib.h
> 
> +GpioLib|Include/Library/GpioNativeLib.h
> 
> +PchCycleDecodingLib|Pch/Include/Library/PchCycleDecodingLib.h
> 
> +EspiLib|Include/Library/PchEspiLib.h
> 
> +GbeLib|Include/Library/GbeLib.h
> 
> +GbeMdiLib|IpBlock/Gbe/IncludePrivate/Library/GbeMdiLib.h
> 
> +PchHsioLib|Pch/IncludePrivate/PchHsio.h
> 
> +PchInfoLib|Pch/Include/Library/PchInfoLib.h
> 
> +PchP2sbLib|Pch/Include/Library/PchP2sbLib.h
> 
> +PchPcieRpLib|Pch/Include/Library/PchPcieRpLib.h
> 
> +PchPcrLib|Pch/Include/Library/PchPcrLib.h
> 
> +PchPolicyLib|Pch/Include/Library/PchPolicyLib.h
> 
> +PchSbiAccessLib|Pch/IncludePrivate/Library/PchSbiAccessLib.h
> 
> +SerialIoAccessLib|Include/Library/SerialIoAccessLib.h
> 
> +DxePchPolicyLib|Pch/Include/Library/DxePchPolicyLib.h
> 
> +
> 
> +## @libraryclass
> 
> +## Sa
> 
> +##
> 
> +DxeSaPolicyLib|SystemAgent/Include/Library/DxeSaPolicyLib.h
> 
> +SaPlatformLib|SystemAgent/Include/Library/SaPlatformLib.h
> 
> +Include/Library/VoltageRegulatorCommands.h
> 
> +
> 
> +[PcdsFixedAtBuild]
> 
> +## From MdeModulePkg.dec
> 
> +## Progress Code for S3 Suspend start.
> 
> +## PROGRESS_CODE_S3_SUSPEND_START   =
> (EFI_SOFTWARE_SMM_DRIVER | (EFI_OEM_SPECIFIC | 0x00000000))    =
> 0x03078000
> 
> +gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendStart|0x03078000|UIN
> T32|0x30001032
> 
> +## Progress Code for S3 Suspend end.
> 
> +## PROGRESS_CODE_S3_SUSPEND_END   = (EFI_SOFTWARE_SMM_DRIVER
> | (EFI_OEM_SPECIFIC | 0x00000001))    = 0x03078001
> 
> +gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendEnd|0x03078001|UINT
> 32|0x30001033
> 
> +##
> 
> +## PcdNemCodeCacheBase is usally the same as PEI FV Base address,
> 
> +## FLASH_BASE+FLASH_REGION_FV_RECOVERY_OFFSET from
> PlatformPkg.fdf.
> 
> +##
> 
> +## Restriction:
> 
> +## 1) PcdNemCodeCacheBase - (PcdTemporaryRamBase +
> PcdTemporaryRamSize) >= 4K
> 
> +## 2) PcdTemporaryRamBase >= 4G - 64M
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdNemCodeCacheBase|0xFFF80000|UINT32|0x20
> 000009
> 
> +##
> 
> +## NemCodeCacheSize is usally the same as PEI FV Size,
> 
> +## FLASH_REGION_FV_RECOVERY_SIZE from PlatformPkg.fdf.
> 
> +##
> 
> +## Restriction:
> 
> +## 1) PcdNemTotalCacheSize = NemCodeCacheSize +
> PcdTemporaryRamSize
> 
> +## <= Maximun CPU NEM total size (Code + Data)
> 
> +## = LLC size - 0.5M
> 
> +## 2) PcdTemporaryRamSize  <= Maximum CPU NEM data size
> 
> +## =  MLC size
> 
> +## NOTE: The size restriction may be changed in next generation processor.
> 
> +## Please refer to Processor BWG for detail.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdBiosAreaBaseAddress|0xFF800000|UINT32|0x1
> 0000001
> 
> +gSiPkgTokenSpaceGuid.PcdBiosSize|0x00800000|UINT32|0x10000002
> 
> +gSiPkgTokenSpaceGuid.PcdTemporaryRamBase|0xfef00000|UINT32|0x000
> 10028
> 
> +gSiPkgTokenSpaceGuid.PcdTemporaryRamSize|0x2000|UINT32|0x0001002
> 9
> 
> +gSiPkgTokenSpaceGuid.PcdTopMemoryCacheSize|0x0|UINT32|0x0001002
> A
> 
> +gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvBase|0xFFE60000|UINT32|0x
> 30000004
> 
> +gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvSize|0x000A0000|UINT32|0x3
> 0000005
> 
> +gSiPkgTokenSpaceGuid.PcdFlashMicrocodeOffset|0x00000060|UINT32|0x3
> 0000013
> 
> +gSiPkgTokenSpaceGuid.PcdFlashMicrocodeFvOffset|0x00660000|UINT32|0
> x30000006
> 
> +##
> 
> +## The CPU Trace Hub's BARs base and size
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubMtbBarBase|0xfad00000|UINT32|
> 0x30000007
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubMtbBarSize|0x100000|UINT32|0x
> 30000008
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubSwBarBase|0xfc000000|UINT32|0
> x30000009
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubSwBarSize|0x800000|UINT32|0x30
> 00000A
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubRtitBarBase|0xfacfc000|UINT32|0
> x3000000B
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubRtitBarSize|0x4000|UINT32|0x300
> 0000C
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubFwBarBase|0xfae00000|UINT32|0
> x3000000D
> 
> +gSiPkgTokenSpaceGuid.PcdCpuTraceHubFwBarSize|0x200000|UINT32|0x30
> 00000E
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdFspWrapperEnable
> |FALSE|BOOLEAN|0x3000000F
> 
> +gSiPkgTokenSpaceGuid.PcdFspBinaryEnable|FALSE|BOOLEAN|0x30000010
> 
> +gSiPkgTokenSpaceGuid.PcdEmbeddedEnable|0x0|UINT8|0x30000012
> 
> +
> 
> +##
> 
> +## PcdEfiGcdAllocateType is using for EFI_GCD_ALLOCATE_TYPE selection
> 
> +## value of the struct
> 
> +##  0x00 EfiGcdAllocateAnySearchBottomUp
> 
> +##  0x01 EfiGcdAllocateMaxAddressSearchBottomUp
> 
> +##  0x03 EfiGcdAllocateAnySearchTopDown
> 
> +##  0x04 EfiGcdAllocateMaxAddressSearchTopDown
> 
> +##
> 
> +##  below value should not using in this situation
> 
> +##  0x05 EfiGcdMaxAllocateType : design for max value of struct
> 
> +##  0x02 EfiGcdAllocateAddress : design for speccification address allocate
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdEfiGcdAllocateType|0x01|UINT8|0x40000000
> 
> +
> 
> +##
> 
> +##  Handshake register value driven to DMA controller PCIE venodr specific
> configuration register from FW
> 
> +##  (LC/CM to host)
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdITbtToPcieRegister|0xEC|UINT8|0x40000003
> 
> +##
> 
> +##  Handshake register value driven from DMA controller PCIE venodr
> specific configuration register to FW
> 
> +##  (HOST to LC/CM)
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdPcieToITbtRegister|0xF0|UINT8|0x40000004
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdAbove4GBMmioBase|0x0000004000000000|UIN
> T64|0x40000005
> 
> +gSiPkgTokenSpaceGuid.PcdAbove4GBMmioSize|0x0000004000000000|UIN
> T64|0x40000006
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdSmmEntryPointBinFile|{ 0x52, 0xce, 0xc8, 0xe0,
> 0x51, 0x2b, 0xc2, 0x4c, 0xb3, 0xc7, 0xd2, 0x11, 0xa6, 0x25, 0xc1, 0xba
> }|VOID*|0x40000007
> 
> +gSiPkgTokenSpaceGuid.PcdSpsBinFile|{ 0xEE, 0xE3, 0x34, 0x71, 0xA6, 0x7F,
> 0x89, 0x44, 0x87, 0xA7, 0xAE, 0x38, 0x98, 0x4E, 0xAE, 0xD8
> }|VOID*|0x40000008
> 
> +gSiPkgTokenSpaceGuid.PcdSpsSmmEntryPointBinFile|{ 0x5B, 0x63, 0x7D,
> 0x7C, 0x9C, 0x8B, 0x3C, 0x46, 0x9F, 0x7F, 0x91, 0xF6, 0x09, 0x06, 0x84, 0x8F
> }|VOID*|0x40000009
> 
> +gSiPkgTokenSpaceGuid.PcdSpaBinFile|{ 0xE1, 0x19, 0xB7, 0x7B, 0x2A, 0x53,
> 0x40, 0x7B, 0xA3, 0x4C, 0xC4, 0xF9, 0xE2, 0x6C, 0x27, 0x74
> }|VOID*|0x4000000A
> 
> +gSiPkgTokenSpaceGuid.PcdSpaSmmEntryPointBinFile|{ 0xD7, 0xAD, 0xB2,
> 0x9F, 0x4D, 0x53, 0x4B, 0xA6, 0x8D, 0x55, 0x5D, 0x28, 0x91, 0x60, 0x10, 0x19
> }|VOID*|0x4000000B
> 
> +
> 
> +##
> 
> +## - DpIn Silicon Feature
> 
> +##
> 
> +#  Note: PcdDpInEnable is Default Disable. Override it based on Platform/
> CPU
> 
> +gSiPkgTokenSpaceGuid.PcdDpInEnable|FALSE|BOOLEAN|0x4000000C
> 
> +#  Note: For PcdMaxDpInExtPortSupported, we can have Maximum value
> of 0x08.
> 
> +#    Please Don't exceed beyond that. As it will cause boundary overflow.
> 
> +#    Currently hadrware wise maximum Dp-In External Port supported is 4.
> 
> +#    And it will never exceed the value of 0x08. That's why we don't support
> 
> +#    PcdMaxDpInExtPortSupported value more than 0x08
> 
> +gSiPkgTokenSpaceGuid.PcdMaxDpInExtPortSupported|0x4|UINT8|0x4000
> 000D
> 
> +
> 
> +gSiPkgTokenSpaceGuid.VtdEngine1BaseAddeess|0xFED90000|UINT32|0x5
> 0000001
> 
> +gSiPkgTokenSpaceGuid.VtdEngine2BaseAddeess|0xFED92000|UINT32|0x5
> 0000002
> 
> +gSiPkgTokenSpaceGuid.VtdEngine3BaseAddeess|0xFED91000|UINT32|0x5
> 0000003
> 
> +gSiPkgTokenSpaceGuid.VtdEngine4BaseAddeess|0xFED84000|UINT32|0x5
> 0000004
> 
> +gSiPkgTokenSpaceGuid.VtdEngine5BaseAddeess|0xFED85000|UINT32|0x5
> 0000005
> 
> +gSiPkgTokenSpaceGuid.VtdEngine6BaseAddeess|0xFED86000|UINT32|0x5
> 0000006
> 
> +gSiPkgTokenSpaceGuid.VtdEngine7BaseAddeess|0xFED87000|UINT32|0x5
> 0000007
> 
> +##
> 
> +## Those PCDs are used to control build process.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdTraceHubEnable
> |FALSE|BOOLEAN|0xF0000001
> 
> +gSiPkgTokenSpaceGuid.PcdSmmVariableEnable
> |FALSE|BOOLEAN|0xF0000002
> 
> +gSiPkgTokenSpaceGuid.PcdAtaEnable
> |FALSE|BOOLEAN|0xF0000004
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiEnable                   |TRUE
> |BOOLEAN|0xF0000009
> 
> +gSiPkgTokenSpaceGuid.PcdSourceDebugEnable
> |FALSE|BOOLEAN|0xF000000B
> 
> +gSiPkgTokenSpaceGuid.PcdPpmEnable                    |TRUE
> |BOOLEAN|0xF000000C
> 
> +gSiPkgTokenSpaceGuid.PcdIntegratedTouchEnable
> |FALSE|BOOLEAN|0xF000000F
> 
> +gSiPkgTokenSpaceGuid.PcdPttEnable
> |FALSE|BOOLEAN|0xF0000011
> 
> +gSiPkgTokenSpaceGuid.PcdJhiEnable
> |FALSE|BOOLEAN|0xF0000012
> 
> +gSiPkgTokenSpaceGuid.PcdSoftwareGuardEnable
> |FALSE|BOOLEAN|0xF0000013
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosEnable                 |TRUE
> |BOOLEAN|0xF0000014
> 
> +gSiPkgTokenSpaceGuid.PcdS3Enable                     |TRUE
> |BOOLEAN|0xF0000015
> 
> +gSiPkgTokenSpaceGuid.PcdOverclockEnable
> |FALSE|BOOLEAN|0xF0000016
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPowerOnConfigEnable
> |FALSE|BOOLEAN|0xF0000017
> 
> +gSiPkgTokenSpaceGuid.PcdSsaFlagEnable
> |FALSE|BOOLEAN|0xF0000018
> 
> +gSiPkgTokenSpaceGuid.PcdEvLoaderEnable
> |FALSE|BOOLEAN|0xF0000019
> 
> +gSiPkgTokenSpaceGuid.PcdIgdEnable                    |TRUE
> |BOOLEAN|0xF000001A
> 
> +gSiPkgTokenSpaceGuid.PcdPegEnable                    |TRUE
> |BOOLEAN|0xF000001B
> 
> +gSiPkgTokenSpaceGuid.PcdSaDmiEnable                  |TRUE
> |BOOLEAN|0xF000001C
> 
> +gSiPkgTokenSpaceGuid.PcdGnaEnable                    |FALSE
> |BOOLEAN|0xF000001E
> 
> +gSiPkgTokenSpaceGuid.PcdVtdEnable                    |TRUE
> |BOOLEAN|0xF0000020
> 
> +gSiPkgTokenSpaceGuid.PcdBiosGuardEnable
> |FALSE|BOOLEAN|0xF0000021
> 
> +gSiPkgTokenSpaceGuid.PcdSimicsEnable
> |FALSE|BOOLEAN|0xF0000022
> 
> +gSiPkgTokenSpaceGuid.PcdBdatEnable
> |FALSE|BOOLEAN|0xF0000023
> 
> +gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable       |TRUE
> |BOOLEAN|0xF0000024
> 
> +gSiPkgTokenSpaceGuid.PcdPeiDisplayEnable             |TRUE
> |BOOLEAN|0xF0000025
> 
> +gSiPkgTokenSpaceGuid.PcdOcWdtEnable
> |FALSE|BOOLEAN|0xF0000029
> 
> +gSiPkgTokenSpaceGuid.PcdMinTreeEnable
> |FALSE|BOOLEAN|0xF000002A  # To separate modules used in mininal
> source tree and advanced features
> 
> +gSiPkgTokenSpaceGuid.PcdBootGuardEnable
> |FALSE|BOOLEAN|0xF0000030
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartEnable
> |FALSE|BOOLEAN|0xF0000033
> 
> +gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable
> |FALSE|BOOLEAN|0xF0000037
> 
> +gSiPkgTokenSpaceGuid.PcdBfxEnable
> |FALSE|BOOLEAN|0xF000003A
> 
> +gSiPkgTokenSpaceGuid.PcdThcEnable
> |FALSE|BOOLEAN|0xF000003B
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdPpamEnable
> |FALSE|BOOLEAN|0xF000003F
> 
> +gSiPkgTokenSpaceGuid.PcdPsmiEnable
> |FALSE|BOOLEAN|0xF0000042
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                |TRUE
> |BOOLEAN|0xF0000043
> 
> +gSiPkgTokenSpaceGuid.PcdHybridStorageSupport
> |FALSE|BOOLEAN|0xF0000044
> 
> +gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported     |TRUE
> |BOOLEAN|0xF0000045
> 
> +gSiPkgTokenSpaceGuid.PcdTmeLibSupported
> |FALSE|BOOLEAN|0xF0000046
> 
> +gSiPkgTokenSpaceGuid.PcdAdlLpSupport
> |FALSE|BOOLEAN|0xF0000047
> 
> +gSiPkgTokenSpaceGuid.PcdSpsStateSaveEnable
> |FALSE|BOOLEAN|0xF0000048
> 
> +gSiPkgTokenSpaceGuid.PcdSpaEnable
> |FALSE|BOOLEAN|0xF0000049
> 
> +
> 
> +## PCD for TraceHub
> 
> +[PcdsDynamic, PcdsPatchableInModule]
> 
> +## From MdeModulePkg.dec
> 
> +## Default OEM ID for ACPI table creation, its length must be 0x6 bytes to
> follow ACPI specification.
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemId|"INTEL "|VOID*|0x30001034
> 
> +## Default OEM Table ID for ACPI table creation, it is "EDK2    ".
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemTableId|0x20202020324B4445|
> UINT64|0x30001035
> 
> +## Default OEM Revision for ACPI table creation.
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemRevision|0x00000002|UINT32|
> 0x30001036
> 
> +## Default Creator ID for ACPI table creation.
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorId|0x20202020|UINT32|0x30
> 001037
> 
> +## Default Creator Revision for ACPI table creation.
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision|0x01000013|UINT3
> 2|0x30001038
> 
> +## ME HECI interface configuration
> 
> +gMeConfigSpaceGuid.PcdHeciDumpsEnabled|TRUE|BOOLEAN|0x50000001
> 
> +gMeConfigSpaceGuid.PcdHeciTimeoutsEnabled|TRUE|BOOLEAN|0x500000
> 02
> 
> +
> 
> +
> 
> +[PcdsFixedAtBuild, PcdsPatchableInModule]
> 
> +## This value is used to set the base address of PCH devices
> 
> +gSiPkgTokenSpaceGuid.PcdSmbusBaseAddress|0x0000EFA0|UINT16|0x000
> 10031
> 
> +gSiPkgTokenSpaceGuid.PcdTcoBaseAddress|0x0400|UINT16|0x00010033
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress|0x1800|UINT16|0x00010035
> 
> +
> 
> +
> 
> +## Stack size in the temporary RAM.
> 
> +## 0 means half of TemporaryRamSize.
> 
> +gSiPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize|0|UINT32|0x00010
> 036
> 
> +##
> 
> +## PcdFviSmbiosType determines the SMBIOS OEM type (0x80 to 0xFF)
> defined in SMBIOS,
> 
> +## values 0-0x7F will be treated as disable FVI reporting.
> 
> +## FVI structure uses it as SMBIOS OEM type to provide version
> information.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdFviSmbiosType|0xDD|UINT8|0x00010037
> 
> +gSiPkgTokenSpaceGuid.PcdSaPciPrint|FALSE|BOOLEAN|0x00010039
> 
> +##
> 
> +## SMBIOS defaults
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosDefaultSocketDesignation|"U3E1"|VOID
> *|0x0001003a
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosDefaultSerialNumber|"To Be Filled By
> O.E.M."|VOID*|0x0001003b
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosDefaultAssetTag|"To Be Filled By
> O.E.M."|VOID*|0x0001003c
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosDefaultPartNumber|"To Be Filled By
> O.E.M."|VOID*|0x0001003d
> 
> +
> 
> +##
> 
> +## Allocate 56 KB [0x2000..0xFFFF] of I/O space for Pci Devices
> 
> +## If PcdPciReservedMemLimit =0  Pci Reserved default  MMIO Limit is
> 0xE0000000 else use PcdPciReservedMemLimit .
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdPciReservedIobase       |0x2000
> |UINT16|0x00010041
> 
> +gSiPkgTokenSpaceGuid.PcdPciReservedIoLimit      |0xFFFF
> |UINT16|0x00010042
> 
> +gSiPkgTokenSpaceGuid.PcdPciReservedMemLimit     |0x0000
> |UINT32|0x00010043
> 
> +gSiPkgTokenSpaceGuid.PcdPciDmaAbove4G           |FALSE
> |BOOLEAN|0x00010044
> 
> +gSiPkgTokenSpaceGuid.PcdPciNoExtendedConfigSpace|FALSE
> |BOOLEAN|0x00010045
> 
> +
> 
> +##
> 
> +## Default 8MB TSEG for Release build BIOS when IED disabled (Also a
> default)
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdTsegSize|0x00800000|UINT32|0x00010046
> 
> +##
> 
> +## gSiPkgTokenSpaceGuid.PcdFwStsSmbiosType determines the SMBIOS
> OEM type (0x80 to 0xFF) defined
> 
> +## in SMBIOS, values 0-0x7F will be treated as disable FWSTS SMBIOS
> reporting.
> 
> +## FWSTS structure uses it as SMBIOS OEM type to provide FWSTS
> information.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdFwStsSmbiosType|0xDB|UINT8|0x00010047
> 
> +
> 
> +##
> 
> +## Maximum Address the AP Wakeup Buffer can start.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdCpuApWakeupBufferMaxAddr|0x58000|UINT3
> 2|0x00010048
> 
> +
> 
> +##
> 
> +## Silicon Reference Code versions
> 
> +##
> 
> +##Revision:Weekly build number
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitVersionRevision|0x33|UINT8|0x00010
> 051
> 
> +
> 
> +##Build[7:4]:Daily build number.
> 
> +##Build[3:0]:Patch build number.
> 
> +
> 
> +##
> 
> +## Temp MEM IO resource
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin    |2         |UINT8
> |0x00010053
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax    |10        |UINT8
> |0x00010054
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr
> |0xFE600000|UINT32|0x00010055
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemSize
> |0x00200000|UINT32|0x00010056
> 
> +
> 
> +##
> 
> +## This PCD specifies the base address of the HPET timer.
> 
> +## The acceptable values are 0xFED00000, 0xFED01000, 0xFED02000, and
> 0xFED03000
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSiHpetBaseAddress
> |0xFED00000|UINT32|0x00010057
> 
> +##
> 
> +## This PCD specifies the base address of the IO APIC.
> 
> +## The acceptable values are 0xFECxx000.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress
> |0xFEC00000|UINT32|0x00010058
> 
> +
> 
> +
> 
> +##
> 
> +## VTD Base Addresses
> 
> +##
> 
> +
> 
> +## Null-terminated string of the Version of Physical Presence interface
> supported by platform.
> 
> +# @Prompt Version of Physical Presence interface supported by platform.
> 
> +gSiPkgTokenSpaceGuid.PcdTcgPhysicalPresenceInterfaceVer|"1.3"|VOID*|
> 0x00000008
> 
> +
> 
> +## This PCD specifies Master of TraceHub device
> 
> +gSiPkgTokenSpaceGuid.PcdTraceHubDebugLibMaster|0x0|UINT32|0x0001
> 1000
> 
> +## This PCD specifies Channel of TraceHub device
> 
> +gSiPkgTokenSpaceGuid.PcdTraceHubDebugLibChannel|0x0|UINT32|0x0001
> 1001
> 
> +
> 
> +
> 
> +[PcdsPatchableInModule, PcdsFixedAtBuild]
> 
> +## This value is used to set the base address of MCH
> 
> +gSiPkgTokenSpaceGuid.PcdMchBaseAddress|0xFEDC0000|UINT64|0x00010
> 030
> 
> +## 128KB window
> 
> +gSiPkgTokenSpaceGuid.PcdMchMmioSize|0x20000|UINT32|0x50000000
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitVersionMajor
> |0x0A|UINT8|0x00010049
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitVersionValue
> |0x0000000800260020|UINT64|0x00010077
> 
> +
> 
> +##Minor:the program that supported by same core generation.
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitVersionMinor
> |0x00|UINT8|0x00010050
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitVersionBuild
> |0x10|UINT8|0x00010052
> 
> +gSiPkgTokenSpaceGuid.PcdRegBarBaseAddress|0xFB000000|UINT32|0x000
> 10059
> 
> +[PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
> 
> +##
> 
> +## SerialIo Uart Configuration
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartDebugEnable   |0          |UINT8
> |0x00210001 # 0:Disable, 1:Enable and Initialize, 2:Enable without Initializing
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartNumber        |2          |UINT8
> |0x00210002
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartMode          |2          |UINT8
> |0x00210003 # 0:Disabled, 1:Enabled, 2:Hidden, 3:COM, 4:SkipInit
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartBaudRate      |115200
> |UINT32|0x00210004 # 0:Default, Max:6000000
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartParity        |1          |UINT8
> |0x00210008 # 0:DefaultParity, 1:NoParity, 2:EvenParity, 3:OddParity
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartDataBits      |8          |UINT8
> |0x00210009 # 0:Default, 5,6,7,8
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartStopBits      |1          |UINT8
> |0x0021000A # 0:DefaultStopBits, 1:OneStopBit, 2:OneFiveStopBits,
> 3:TwoStopBits
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartAutoFlow      |0          |UINT8
> |0x0021000B # 0:No HW flow control, Only RX/TX Enabled; 1:HW Flow Control
> On, Rts/Cts lines enabled;
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartRxPinMux      |0x0
> |UINT32|0x0021000C # Pin muxing config for UART Rx pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartTxPinMux      |0x0
> |UINT32|0x00210010 # Pin muxing config for UART Tx pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartRtsPinMux     |0x0
> |UINT32|0x00210014 # Pin muxing config for UART Rts pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartCtsPinMux     |0x0
> |UINT32|0x00210018 # Pin muxing config for UART Cts pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartDebugMmioBase |0xFE036000
> |UINT32|0x0021001C # PcdSerialIoUartMode = Enabled, need to assign
> MMIO Resource in SEC/PEI Phase
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdLpcUartDebugEnable        |0x1        |UINT8
> |0x00210026 # 0:Disable, 1:Enable
> 
> +gSiPkgTokenSpaceGuid.PcdDebugInterfaceFlags       |0x12       |UINT8
> |0x00210027 # BIT0-RAM, BIT1-UART, BIT3-USB3, BIT4-Serial IO, BIT5-
> TraceHub, BIT2 - Not used.
> 
> +gSiPkgTokenSpaceGuid.PcdSerialDebugLevel          |0x3        |UINT8
> |0x00210028 # {0:Disable, 1:Error Only, 2:Error and Warnings, 3:Load Error
> Warnings and Info, 4:Load Error Warnings and Info, 5:Load Error Warnings
> Info and Verbose
> 
> +gSiPkgTokenSpaceGuid.PcdIsaSerialUartBase         |0x0        |UINT8
> |0x00210029 # 0:0x3F8, 1:0x2F8
> 
> +
> 
> +## UART Lib TimeOut
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartTimeOut             |1000000 |UINT32
> |0x00210020 # Write TimeOut in Micro Seconds - 0 = disabbled, default 1
> second,
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartLibSkipMmioCheck    |FALSE
> |BOOLEAN|0x00210024 # If TRUE MMIO sanity checks are skipped
> 
> +
> 
> +## UART Dxe Driver IgnoreBaudRateSet
> 
> +## TRUE - Blocks changing BaudRate, so that driver will not override UART's
> initial configuration.
> 
> +##        Required to support redirection on higher BaudRates.
> 
> +## FALSE - Allows for UART settings to be changed through the Serial Io
> Protocol
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartDriverIgnoreBaudRateSet|FALSE|B
> OOLEAN|0x00210025
> 
> +
> 
> +##
> 
> +## SerialIo 2nd Uart Configuration
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartEnable    |0          |UINT8
> |0x0021002A # 0:Disable, 1:Enable and Initialize, 2:Enable without Initializing
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartNumber    |2          |UINT8
> |0x0021002B
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartMode      |2          |UINT8
> |0x0021002C # 0:Disabled, 1:Enabled, 2:Hidden, 3:COM, 4:SkipInit
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartBaudRate  |115200
> |UINT32|0x0021002D # 0:Default, Max:6000000
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartParity    |1          |UINT8
> |0x00210031 # 0:DefaultParity, 1:NoParity, 2:EvenParity, 3:OddParity
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartDataBits  |8          |UINT8
> |0x00210032 # 0:Default, 5,6,7,8
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartStopBits  |1          |UINT8
> |0x00210033 # 0:DefaultStopBits, 1:OneStopBit, 2:OneFiveStopBits,
> 3:TwoStopBits
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartAutoFlow  |0          |UINT8
> |0x00210034 # 0:No HW flow control, Only RX/TX Enabled; 1:HW Flow Control
> On, Rts/Cts lines enabled;
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartRxPinMux  |0x0
> |UINT32|0x00210035 # Pin muxing config for UART Rx pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartTxPinMux  |0x0
> |UINT32|0x00210039 # Pin muxing config for UART Tx pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartRtsPinMux |0x0
> |UINT32|0x0021003D # Pin muxing config for UART Rts pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartCtsPinMux |0x0
> |UINT32|0x00210041 # Pin muxing config for UART Cts pin
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIo2ndUartMmioBase  |0xFE034000
> |UINT32|0x00210045 # PcdSerialIoUartMode = Enabled, need to assign
> MMIO Resource in SEC/PEI Phase
> 
> +
> 
> +##
> 
> +## PCI Express MMIO region length
> 
> +## Valid settings: 0x20000000/512MB, 0x10000000/256MB,
> 0x8000000/128MB, 0x4000000/64MB
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdPciExpressRegionLength|0x10000000|UINT32|0
> x00200001
> 
> +##
> 
> +## Typically this should be the same with
> gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress.
> 
> +## This PCD is added for supporting different PCD type in different phases.
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> |0xC0000000|UINT64|0x00200002
> 
> +##
> 
> +## PCI Express MMIO temporary region length in SEC phase.
> 
> +## Valid settings: 0x20000000/512MB, 0x10000000/256MB,
> 0x8000000/128MB, 0x4000000/64MB
> 
> +##
> 
> +gSiPkgTokenSpaceGuid.PcdTemporaryPciExpressRegionLength|0x10000000
> |UINT32|0x00200005
> 
> +
> 
> +## Specifies the SMRR2 base address.<BR><BR>
> 
> +# @Prompt SMRR2 base address.
> 
> +# @Expression  0x80000001 |
> (gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Base & 0xfff) == 0
> 
> +gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Base|0|UINT32|0x20000002
> 
> +
> 
> +## Specifies the SMRR2 range size.<BR><BR>
> 
> +# @Prompt SMRR2 range size.
> 
> +# @Expression  0x80000001 |
> (gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Size & 0xfff) == 0
> 
> +gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2Size|0|UINT32|0x20000003
> 
> +
> 
> +## Specifies the SMRR2 range cache type.
> 
> +#  If SMRR2 is used to map a flash/ROM based handler, it would be
> configured as WP.<BR><BR>
> 
> +#  5: WP(Write Protect).<BR>
> 
> +#  6: WB(Write Back).<BR>
> 
> +# @Prompt SMRR2 range cache type.
> 
> +gSiPkgTokenSpaceGuid.PcdCpuSmmSmrr2CacheType|5|UINT8|0x20000004
> 
> +
> 
> +## Indidates if SMM PROT MODE feature is supported.<BR><BR>
> 
> +#   TRUE  - SMM PROT MODE feature is supported.<BR>
> 
> +#   FALSE - SMM PROT MODE feature is not supported.<BR>
> 
> +# @Prompt  SMM PROT MODE feature.
> 
> +gSiPkgTokenSpaceGuid.PcdCpuSmmProtectedModeEnable|FALSE|BOOLEA
> N|0x20000008
> 
> +
> 
> +## Specifies the a size of memory region to reserve in SMM for testing only.
> 
> +#  One can look in BIOS serial log for PCD to get region base address.
> 
> +#  Note: A different region may be allocated in release build than debug
> build.
> 
> +# @Prompt SMM test region size.\r
> 
> +gSiPkgTokenSpaceGuid.PcdSmmTestRsvMemorySize|0x0|UINT32|0x20000
> 00E
> 
> +
> 
> +[PcdsDynamic]
> 
> +
> 
> +## Indidates if SMM Code Access Check feature is supported.<BR><BR>
> 
> +#   TRUE  - SMM Code Access Check feature is supported.<BR>
> 
> +#   FALSE - SMM Code Access Check feature is not supported.<BR>
> 
> +# @Prompt  SMM Code Access Check feature.
> 
> +gSiPkgTokenSpaceGuid.PcdCpuSmmCodeAccessCheckEnable|TRUE|BOOLE
> AN|0x001000D
> 
> +
> 
> +## Causes all UEFI variables to be treated as volatile and hence never
> written to non-volatile
> 
> +## storage.
> 
> +## This is useful in cases such as a simulation environment that does not
> emulate a non-volatile
> 
> +## storage device or in recovery scenarios where system errors prevent
> non-volatile storage from being accessed
> 
> +gSiPkgTokenSpaceGuid.PcdNvVariableEmulationMode|FALSE|BOOLEAN|0
> x0010000E
> 
> +
> 
> +## Enables or disables storage of UEFI variables using the CSE Variable
> Storage drivers
> 
> +##   If disabled at runtime, it must be set before the CSE Variable Storage
> driver loads.
> 
> +gSiPkgTokenSpaceGuid.PcdEnableCseVariableStorage|FALSE|BOOLEAN|0x
> 0010000F
> 
> +
> 
> +## Enables or disables storage of UEFI variables using the FVB Variable
> Storage drivers
> 
> +##  If disabled at runtime, it must be set before the FVB Variable Storage
> driver loads.
> 
> +gSiPkgTokenSpaceGuid.PcdEnableFvbVariableStorage|TRUE|BOOLEAN|0x0
> 0100010
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers
  2021-02-01  1:36 ` [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers Heng Luo
@ 2021-02-04  3:51   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:51 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

FspmArchConfigPpi.h is a duplicate of a header file in IntelFsp2Pkg, please remove this duplicate. Please also remove the #include for CpuPcieConfigGen3.h from SiPolicy.h, please see inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and
> Protocol include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Include/Library
>   * Include/Ppi
>   * Include/Protocol
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h       |  64
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h   |
> 332
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h        | 153
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h              | 140
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h               |  63
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h           | 342
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h              | 720
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h        | 149
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h             |  27
> +++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h         | 123
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h            | 256
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h        | 173
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h               | 355
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h       |  79
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h              | 112
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h    | 113
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h     |  56
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h         | 290
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h           |  53
> +++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h        |  32
> ++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h |
> 34 ++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h       |  33
> +++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h                 |  79
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.h
> |  61
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h           |  73
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h         |  22
> ++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h                 | 301
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++
>  27 files changed, 4235 insertions(+)
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h
> new file mode 100644
> index 0000000000..dbf786ec9a
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ConfigBlockLib.h
> @@ -0,0 +1,64 @@
> +/** @file
> 
> +  Header file for Config Block Lib implementation
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _CONFIG_BLOCK_LIB_H_
> 
> +#define _CONFIG_BLOCK_LIB_H_
> 
> +
> 
> +/**
> 
> +  Create config block table
> 
> +
> 
> +  @param[in]     TotalSize                    - Max size to be allocated for the Config
> Block Table
> 
> +  @param[out]    ConfigBlockTableAddress      - On return, points to a pointer
> to the beginning of Config Block Table Address
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER - Invalid Parameter
> 
> +  @retval EFI_OUT_OF_RESOURCES  - Out of resources
> 
> +  @retval EFI_SUCCESS           - Successfully created Config Block Table at
> ConfigBlockTableAddress
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +CreateConfigBlockTable (
> 
> +  IN     UINT16    TotalSize,
> 
> +  OUT    VOID      **ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Add config block into config block table structure
> 
> +
> 
> +  @param[in]     ConfigBlockTableAddress      - A pointer to the beginning of
> Config Block Table Address
> 
> +  @param[out]    ConfigBlockAddress           - On return, points to a pointer to
> the beginning of Config Block Address
> 
> +
> 
> +  @retval EFI_OUT_OF_RESOURCES - Config Block Table is full and cannot
> add new Config Block or
> 
> +                                 Config Block Offset Table is full and cannot add new Config
> Block.
> 
> +  @retval EFI_SUCCESS          - Successfully added Config Block
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +AddConfigBlock (
> 
> +  IN     VOID      *ConfigBlockTableAddress,
> 
> +  OUT    VOID      **ConfigBlockAddress
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Retrieve a specific Config Block data by GUID
> 
> +
> 
> +  @param[in]      ConfigBlockTableAddress      - A pointer to the beginning of
> Config Block Table Address
> 
> +  @param[in]      ConfigBlockGuid              - A pointer to the GUID uses to
> search specific Config Block
> 
> +  @param[out]     ConfigBlockAddress           - On return, points to a pointer to
> the beginning of Config Block Address
> 
> +
> 
> +  @retval EFI_NOT_FOUND         - Could not find the Config Block
> 
> +  @retval EFI_SUCCESS           - Config Block found and return
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetConfigBlock (
> 
> +  IN     VOID      *ConfigBlockTableAddress,
> 
> +  IN     EFI_GUID  *ConfigBlockGuid,
> 
> +  OUT    VOID      **ConfigBlockAddress
> 
> +  );
> 
> +
> 
> +#endif // _CONFIG_BLOCK_LIB_H_
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h
> new file mode 100644
> index 0000000000..564fcccb43
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/CpuRegbarAccessLib.h
> @@ -0,0 +1,332 @@
> +/** @file
> 
> +  Header file for CPU REGBAR ACCESS library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_REGBAR_ACCESS_LIB_H_
> 
> +#define _CPU_REGBAR_ACCESS_LIB_H_
> 
> +
> 
> +#define INVALID_DATA_64  0xFFFFFFFFFFFFFFFF
> 
> +#define INVALID_DATA_32  0xFFFFFFFF
> 
> +#define INVALID_DATA_16  0xFFFF
> 
> +#define INVALID_DATA_8   0xFF
> 
> +#define INVALID_PID      0xFF
> 
> +
> 
> +typedef UINT8    CPU_SB_DEVICE_PID;
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 8bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT64           REGBAR register value.
> 
> +**/
> 
> +UINT64
> 
> +CpuRegbarRead64 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT32           REGBAR register value.
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarRead32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT16           REGBAR register value.
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarRead16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT8            REGBAR regsiter value
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarRead8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 8bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT64           Value written to register
> 
> +**/
> 
> +UINT64
> 
> +CpuRegbarWrite64 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT64                            Data
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarWrite32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            Data
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarWrite16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            Data
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarWrite8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             Data
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarOr32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarOr16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarOr8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit data.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevice      CPU SB Device
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarAnd32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            AndData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit data.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevice      CPU SB Device
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarAnd16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            AndData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 8-bit data.
> 
> +  It programs REGBAR register and size in 1byte.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevice      CPU SB Device
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarAnd8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             AndData
> 
> +  );
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarAndThenOr32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarAndThenOr16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            AndData,
> 
> +  IN  UINT16                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid      CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarAndThenOr8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             AndData,
> 
> +  IN  UINT8                             OrData
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h
> new file mode 100644
> index 0000000000..c48ea3667f
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/DxeHdaNhltLib.h
> @@ -0,0 +1,153 @@
> +/** @file
> 
> +  Prototype of the DxePchHdaNhltLib library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _DXE_HDA_NHLT_LIB_H_
> 
> +#define _DXE_HDA_NHLT_LIB_H_
> 
> +
> 
> +#include <DxeHdaNhlt.h>
> 
> +
> 
> +/**
> 
> +  Returns pointer to Endpoint ENDPOINT_DESCRIPTOR structure.
> 
> +
> 
> +  @param[in] *NhltTable    Endpoint for which Format address is retrieved
> 
> +  @param[in] FormatIndex   Index of Format to be retrieved
> 
> +
> 
> +  @retval                  Pointer to ENDPOINT_DESCRIPTOR structure with given
> index
> 
> +**/
> 
> +ENDPOINT_DESCRIPTOR *
> 
> +GetNhltEndpoint (
> 
> +  IN CONST NHLT_ACPI_TABLE      *NhltTable,
> 
> +  IN CONST UINT8                EndpointIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pointer to Endpoint Specific Configuration SPECIFIC_CONFIG
> structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which config address is retrieved
> 
> +
> 
> +  @retval                  Pointer to SPECIFIC_CONFIG structure with endpoint's
> capabilities
> 
> +**/
> 
> +SPECIFIC_CONFIG *
> 
> +GetNhltEndpointDeviceCapabilities (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pointer to all Formats Configuration FORMATS_CONFIG structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which Formats address is retrieved
> 
> +
> 
> +  @retval                  Pointer to FORMATS_CONFIG structure
> 
> +**/
> 
> +FORMATS_CONFIG *
> 
> +GetNhltEndpointFormatsConfig (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pointer to Format Configuration FORMAT_CONFIG structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which Format address is retrieved
> 
> +  @param[in] FormatIndex   Index of Format to be retrieved
> 
> +
> 
> +  @retval                  Pointer to FORMAT_CONFIG structure with given index
> 
> +**/
> 
> +FORMAT_CONFIG *
> 
> +GetNhltEndpointFormat (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
> 
> +  IN CONST UINT8                FormatIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pointer to all Device Information DEVICES_INFO structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which DevicesInfo address is
> retrieved
> 
> +
> 
> +  @retval                  Pointer to DEVICES_INFO structure
> 
> +**/
> 
> +DEVICES_INFO *
> 
> +GetNhltEndpointDevicesInfo (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pointer to Device Information DEVICES_INFO structure.
> 
> +
> 
> +  @param[in] *Endpoint       Endpoint for which Device Info address is
> retrieved
> 
> +  @param[in] DeviceInfoIndex Index of Device Info to be retrieved
> 
> +
> 
> +  @retval                    Pointer to DEVICE_INFO structure with given index
> 
> +**/
> 
> +DEVICE_INFO *
> 
> +GetNhltEndpointDeviceInfo (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
> 
> +  IN CONST UINT8                DeviceInfoIndex
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Returns pointer to OED Configuration SPECIFIC_CONFIG structure.
> 
> +
> 
> +  @param[in] *NhltTable    NHLT table for which OED address is retrieved
> 
> +
> 
> +  @retval                  Pointer to SPECIFIC_CONFIG structure with NHLT
> capabilities
> 
> +**/
> 
> +SPECIFIC_CONFIG *
> 
> +GetNhltOedConfig (
> 
> +  IN CONST NHLT_ACPI_TABLE      *NhltTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Prints Format configuration.
> 
> +
> 
> +  @param[in] *Format       Format to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltFormatDump (
> 
> +  IN CONST FORMAT_CONFIG        *Format
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Prints Endpoint configuration.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltEndpointDump (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Prints OED (Offload Engine Driver) configuration.
> 
> +
> 
> +  @param[in] *OedConfig   OED to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltOedConfigDump (
> 
> +  IN CONST SPECIFIC_CONFIG      *OedConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Prints NHLT (Non HDA-Link Table) to be exposed via ACPI (aka. OED
> (Offload Engine Driver) Configuration Table).
> 
> +
> 
> +  @param[in] *NhltTable    The NHLT table to print
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltAcpiTableDump (
> 
> +  IN NHLT_ACPI_TABLE            *NhltTable
> 
> +  );
> 
> +
> 
> +#endif // _DXE_HDA_NHLT_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h
> new file mode 100644
> index 0000000000..6d8466ab7a
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/EspiLib.h
> @@ -0,0 +1,140 @@
> +/** @file
> 
> +  Header file for PchEspiLib.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _ESPI_LIB_H_
> 
> +#define _ESPI_LIB_H_
> 
> +
> 
> +/**
> 
> +  Checks if there's second slave connected under CS#1
> 
> +
> 
> +  @retval TRUE      There's second slave
> 
> +  @retval FALSE     There's no second slave
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiSecondSlaveSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks in slave General Capabilities register if it supports channel with
> requested number
> 
> +
> 
> +  @param[in]  SlaveId         Id of slave to check
> 
> +  @param[in]  ChannelNumber   Number of channel of which to check
> 
> +
> 
> +  @retval TRUE      Channel with requested number is supported by slave
> device
> 
> +  @retval FALSE     Channel with requested number is not supported by slave
> device
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiSlaveChannelSupported (
> 
> +  UINT8   SlaveId,
> 
> +  UINT8   ChannelNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Is eSPI enabled in strap.
> 
> +
> 
> +  @retval TRUE          Espi is enabled in strap
> 
> +  @retval FALSE         Espi is disabled in strap
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get configuration from eSPI slave
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[in]  SlaveAddress  Slave Configuration Register Address
> 
> +  @param[out] OutData       Configuration data read
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PchLp
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address
> exceed maximum allowed
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address is
> not DWord aligned
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveGetConfig (
> 
> +  IN  UINT32 SlaveId,
> 
> +  IN  UINT32 SlaveAddress,
> 
> +  OUT UINT32 *OutData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set eSPI slave configuration
> 
> +
> 
> +  Note: A Set_Configuration must always be followed by a
> Get_Configuration in order to ensure
> 
> +  that the internal state of the eSPI-MC is consistent with the Slave's register
> settings.
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[in]  SlaveAddress  Slave Configuration Register Address
> 
> +  @param[in]  InData        Configuration data to write
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PchLp
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address
> exceed maximum allowed
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address is
> not DWord aligned
> 
> +  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to
> 0x7FF has been locked
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveSetConfig (
> 
> +  IN  UINT32 SlaveId,
> 
> +  IN  UINT32 SlaveAddress,
> 
> +  IN  UINT32 InData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get status from eSPI slave
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[out] OutData       Configuration data read
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PchLp
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveGetStatus (
> 
> +  IN  UINT32 SlaveId,
> 
> +  OUT UINT16 *OutData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI slave in-band reset
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PchLp
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveInBandReset (
> 
> +  IN  UINT32 SlaveId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI Slave channel reset helper function
> 
> +
> 
> +  @param[in]  SlaveId           eSPI slave ID
> 
> +  @param[in]  ChannelNumber     Number of channel to reset
> 
> +
> 
> +  @retval     EFI_SUCCESS       Operation succeeded
> 
> +  @retval     EFI_UNSUPPORTED   Slave doesn't support that channel or
> invalid number specified
> 
> +  @retval     EFI_TIMEOUT       Operation has timeouted
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveChannelReset (
> 
> +  IN  UINT8   SlaveId,
> 
> +  IN  UINT8   ChannelNumber
> 
> +  );
> 
> +
> 
> +#endif // _ESPI_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h
> new file mode 100644
> index 0000000000..9d72b9ac7c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GbeLib.h
> @@ -0,0 +1,63 @@
> +/** @file
> 
> +  Header file for GbeLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GBE_LIB_H_
> 
> +#define _GBE_LIB_H_
> 
> +
> 
> +/**
> 
> +  Check whether GbE region is valid
> 
> +  Check SPI region directly since GbE might be disabled in SW.
> 
> +
> 
> +  @retval TRUE                    Gbe Region is valid
> 
> +  @retval FALSE                   Gbe Region is invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbeRegionValid (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether GBE controller is enabled in the platform.
> 
> +
> 
> +  @retval TRUE                    GbE is enabled
> 
> +  @retval FALSE                   GbE is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbePresent (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Gbe is Enabled or Disabled
> 
> +
> 
> +  @retval  BOOLEAN    TRUE if device is enabled, FALSE otherwise.
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbeEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Device Number
> 
> +
> 
> +  @retval  GbE device number
> 
> +**/
> 
> +UINT8
> 
> +GbeDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Function Number
> 
> +
> 
> +  @retval  GbE function number
> 
> +**/
> 
> +UINT8
> 
> +GbeFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _GBE_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h
> new file mode 100644
> index 0000000000..88a21efb32
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioConfig.h
> @@ -0,0 +1,342 @@
> +/** @file
> 
> +  Header file for GpioConfig structure used by GPIO library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_CONFIG_H_
> 
> +#define _GPIO_CONFIG_H_
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +///
> 
> +/// For any GpioPad usage in code use GPIO_PAD type
> 
> +///
> 
> +typedef UINT32 GPIO_PAD;
> 
> +
> 
> +///
> 
> +/// GpioPad with additional native function information.
> 
> +/// This type is used to represent signal muxing alternatives. Platform will
> provide such value to
> 
> +/// identify muxing selection for given signal on a specific SOC.
> 
> +/// Please refer to the board layout
> 
> +///
> 
> +typedef UINT32 GPIO_NATIVE_PAD;
> 
> +
> 
> +
> 
> +///
> 
> +/// For any GpioGroup usage in code use GPIO_GROUP type
> 
> +///
> 
> +typedef UINT32 GPIO_GROUP;
> 
> +
> 
> +/**
> 
> +  GPIO configuration structure used for pin programming.
> 
> +  Structure contains fields that can be used to configure pad.
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +  Pad Mode
> 
> +  Pad can be set as GPIO or one of its native functions.
> 
> +  When in native mode setting Direction (except Inversion), OutputState,
> 
> +  InterruptConfig, Host Software Pad Ownership and OutputStateLock are
> unnecessary.
> 
> +  Refer to definition of GPIO_PAD_MODE.
> 
> +  Refer to EDS for each native mode according to the pad.
> 
> +  **/
> 
> +  UINT32 PadMode            : 5;
> 
> +  /**
> 
> +  Host Software Pad Ownership
> 
> +  Set pad to ACPI mode or GPIO Driver Mode.
> 
> +  Refer to definition of GPIO_HOSTSW_OWN.
> 
> +  **/
> 
> +  UINT32 HostSoftPadOwn     : 2;
> 
> +  /**
> 
> +  GPIO Direction
> 
> +  Can choose between In, In with inversion, Out, both In and Out, both In
> with inversion and out or disabling both.
> 
> +  Refer to definition of GPIO_DIRECTION for supported settings.
> 
> +  **/
> 
> +  UINT32 Direction           : 6;
> 
> +  /**
> 
> +  Output State
> 
> +  Set Pad output value.
> 
> +  Refer to definition of GPIO_OUTPUT_STATE for supported settings.
> 
> +  This setting takes place when output is enabled.
> 
> +  **/
> 
> +  UINT32 OutputState         : 2;
> 
> +  /**
> 
> +  GPIO Interrupt Configuration
> 
> +  Set Pad to cause one of interrupts (IOxAPIC/SCI/SMI/NMI).
> 
> +  This setting is applicable only if GPIO is in GpioMode with input enabled.
> 
> +  Refer to definition of GPIO_INT_CONFIG for supported settings.
> 
> +  **/
> 
> +  UINT32 InterruptConfig     : 9;
> 
> +  /**
> 
> +  GPIO Power Configuration.
> 
> +  This setting controls Pad Reset Configuration.
> 
> +  Refer to definition of GPIO_RESET_CONFIG for supported settings.
> 
> +  **/
> 
> +  UINT32 PowerConfig        : 8;
> 
> +  /**
> 
> +  GPIO Electrical Configuration
> 
> +  This setting controls pads termination.
> 
> +  Refer to definition of GPIO_ELECTRICAL_CONFIG for supported settings.
> 
> +  **/
> 
> +  UINT32 ElectricalConfig   : 9;
> 
> +  /**
> 
> +  GPIO Lock Configuration
> 
> +  This setting controls pads lock.
> 
> +  Refer to definition of GPIO_LOCK_CONFIG for supported settings.
> 
> +  **/
> 
> +  UINT32 LockConfig         : 4;
> 
> +  /**
> 
> +  Additional GPIO configuration
> 
> +  Refer to definition of GPIO_OTHER_CONFIG for supported settings.
> 
> +  **/
> 
> +  UINT32 OtherSettings      : 9;
> 
> +
> 
> +  UINT32 RsvdBits           : 10;    ///< Reserved bits for future extension
> 
> +} GPIO_CONFIG;
> 
> +
> 
> +
> 
> +typedef enum {
> 
> +  GpioHardwareDefault        = 0x0    ///< Leave setting unmodified
> 
> +} GPIO_HARDWARE_DEFAULT;
> 
> +
> 
> +/**
> 
> +  GPIO Pad Mode
> 
> +  Refer to GPIO documentation on native functions available for certain pad.
> 
> +  If GPIO is set to one of NativeX modes then following settings are not
> applicable
> 
> +  and can be skipped:
> 
> +  - Interrupt related settings
> 
> +  - Host Software Ownership
> 
> +  - Output/Input enabling/disabling
> 
> +  - Output lock
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioPadModeHwDefault  = 0x0,
> 
> +  GpioPadModeGpio       = 0x1,
> 
> +  GpioPadModeNative1    = 0x3,
> 
> +  GpioPadModeNative2    = 0x5,
> 
> +  GpioPadModeNative3    = 0x7,
> 
> +  GpioPadModeNative4    = 0x9,
> 
> +  GpioPadModeNative5    = 0xB,
> 
> +  GpioPadModeNative6    = 0xD,
> 
> +  GpioPadModeNative7    = 0xF
> 
> +} GPIO_PAD_MODE;
> 
> +
> 
> +/**
> 
> +  Host Software Pad Ownership modes
> 
> +  This setting affects GPIO interrupt status registers. Depending on chosen
> ownership
> 
> +  some GPIO Interrupt status register get updated and other masked.
> 
> +  Please refer to EDS for HOSTSW_OWN register description.
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioHostOwnDefault = 0x0,   ///< Leave ownership value unmodified
> 
> +  /**
> 
> +  Set HOST ownership to ACPI.
> 
> +  Use this setting if pad is not going to be used by GPIO OS driver.
> 
> +  If GPIO is configured to generate SCI/SMI/NMI then this setting must be
> 
> +  used for interrupts to work
> 
> +  **/
> 
> +  GpioHostOwnAcpi    = 0x1,
> 
> +  /**
> 
> +  Set HOST ownership to GPIO Driver mode.
> 
> +  Use this setting only if GPIO pad should be controlled by GPIO OS Driver.
> 
> +  GPIO OS Driver will be able to control the pad if appropriate entry in
> 
> +  ACPI exists (refer to ACPI specification for GpioIo and GpioInt descriptors)
> 
> +  **/
> 
> +  GpioHostOwnGpio    = 0x3
> 
> +} GPIO_HOSTSW_OWN;
> 
> +
> 
> +///
> 
> +/// GPIO Direction
> 
> +///
> 
> +typedef enum {
> 
> +  GpioDirDefault         = 0x0,                ///< Leave pad direction setting
> unmodified
> 
> +  GpioDirInOut           = (0x1 | (0x1 << 3)), ///< Set pad for both output and
> input
> 
> +  GpioDirInInvOut        = (0x1 | (0x3 << 3)), ///< Set pad for both output and
> input with inversion
> 
> +  GpioDirIn              = (0x3 | (0x1 << 3)), ///< Set pad for input only
> 
> +  GpioDirInInv           = (0x3 | (0x3 << 3)), ///< Set pad for input with inversion
> 
> +  GpioDirOut             = 0x5,                ///< Set pad for output only
> 
> +  GpioDirNone            = 0x7                 ///< Disable both output and input
> 
> +} GPIO_DIRECTION;
> 
> +
> 
> +/**
> 
> +  GPIO Output State
> 
> +  This field is relevant only if output is enabled
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioOutDefault         = 0x0,  ///< Leave output value unmodified
> 
> +  GpioOutLow             = 0x1,  ///< Set output to low
> 
> +  GpioOutHigh            = 0x3   ///< Set output to high
> 
> +} GPIO_OUTPUT_STATE;
> 
> +
> 
> +/**
> 
> +  GPIO interrupt configuration
> 
> +  This setting is applicable only if pad is in GPIO mode and has input enabled.
> 
> +  GPIO_INT_CONFIG allows to choose which interrupt is generated
> (IOxAPIC/SCI/SMI/NMI)
> 
> +  and how it is triggered (edge or level). Refer to PADCFG_DW0 register
> description in
> 
> +  EDS for details on this settings.
> 
> +  Field from GpioIntNmi to GpioIntApic can be OR'ed with GpioIntLevel to
> GpioIntBothEdge
> 
> +  to describe an interrupt e.g. GpioIntApic | GpioIntLevel
> 
> +  If GPIO is set to cause an SCI then also GPI_GPE_EN is enabled for this pad.
> 
> +  If GPIO is set to cause an NMI then also GPI_NMI_EN is enabled for this
> pad.
> 
> +  Not all GPIO are capable of generating an SMI or NMI interrupt.
> 
> +  When routing GPIO to cause an IOxAPIC interrupt care must be taken, as
> this
> 
> +  interrupt cannot be shared and its IRQn number is not configurable.
> 
> +  Refer to EDS for GPIO pads IRQ numbers (PADCFG_DW1.IntSel)
> 
> +  If GPIO is under GPIO OS driver control and appropriate ACPI GpioInt
> descriptor
> 
> +  exist then use only trigger type setting (from GpioIntLevel to
> GpioIntBothEdge).
> 
> +  This type of GPIO Driver interrupt doesn't have any additional routing
> setting
> 
> +  required to be set by BIOS. Interrupt is handled by GPIO OS Driver.
> 
> +**/
> 
> +
> 
> +typedef enum {
> 
> +  GpioIntDefault           = 0x0,  ///< Leave value of interrupt routing
> unmodified
> 
> +  GpioIntDis               = 0x1,  ///< Disable IOxAPIC/SCI/SMI/NMI interrupt
> generation
> 
> +  GpioIntNmi               = 0x3,  ///< Enable NMI interrupt only
> 
> +  GpioIntSmi               = 0x5,  ///< Enable SMI interrupt only
> 
> +  GpioIntSci               = 0x9,  ///< Enable SCI interrupt only
> 
> +  GpioIntApic              = 0x11, ///< Enable IOxAPIC interrupt only
> 
> +  GpioIntLevel       = (0x1 << 5), ///< Set interrupt as level triggered
> 
> +  GpioIntEdge        = (0x3 << 5), ///< Set interrupt as edge triggered (type of
> edge depends on input inversion)
> 
> +  GpioIntLvlEdgDis   = (0x5 << 5), ///< Disable interrupt trigger
> 
> +  GpioIntBothEdge    = (0x7 << 5)  ///< Set interrupt as both edge triggered
> 
> +} GPIO_INT_CONFIG;
> 
> +
> 
> +#define B_GPIO_INT_CONFIG_INT_SOURCE_MASK  0x1F ///< Mask for
> GPIO_INT_CONFIG for interrupt source
> 
> +#define B_GPIO_INT_CONFIG_INT_TYPE_MASK    0xE0 ///< Mask for
> GPIO_INT_CONFIG for interrupt type
> 
> +
> 
> +/**
> 
> +  GPIO Power Configuration
> 
> +  GPIO_RESET_CONFIG allows to set GPIO Reset type
> (PADCFG_DW0.PadRstCfg) which will
> 
> +  be used to reset certain GPIO settings.
> 
> +  Refer to EDS for settings that are controllable by PadRstCfg.
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioResetDefault   = 0x00,        ///< Leave value of pad reset unmodified
> 
> +  /**
> 
> +  Resume Reset (RSMRST)
> 
> +    GPP: PadRstCfg = 00b = "Powergood"
> 
> +    GPD: PadRstCfg = 11b = "Resume Reset"
> 
> +  Pad setting will reset on:
> 
> +  - DeepSx transition
> 
> +  - G3
> 
> +  Pad settings will not reset on:
> 
> +  - S3/S4/S5 transition
> 
> +  - Warm/Cold/Global reset
> 
> +  **/
> 
> +  GpioResumeReset      = 0x01,
> 
> +  /**
> 
> +  Host Deep Reset
> 
> +    PadRstCfg = 01b = "Deep GPIO Reset"
> 
> +  Pad settings will reset on:
> 
> +  - Warm/Cold/Global reset
> 
> +  - DeepSx transition
> 
> +  - G3
> 
> +  Pad settings will not reset on:
> 
> +  - S3/S4/S5 transition
> 
> +  **/
> 
> +  GpioHostDeepReset    = 0x03,
> 
> +  /**
> 
> +  Platform Reset (PLTRST)
> 
> +    PadRstCfg = 10b = "GPIO Reset"
> 
> +  Pad settings will reset on:
> 
> +  - S3/S4/S5 transition
> 
> +  - Warm/Cold/Global reset
> 
> +  - DeepSx transition
> 
> +  - G3
> 
> +  **/
> 
> +  GpioPlatformReset    = 0x05,
> 
> +  /**
> 
> +  Deep Sleep Well Reset (DSW_PWROK)
> 
> +    GPP: not applicable
> 
> +    GPD: PadRstCfg = 00b = "Powergood"
> 
> +  Pad settings will reset on:
> 
> +  - G3
> 
> +  Pad settings will not reset on:
> 
> +  - S3/S4/S5 transition
> 
> +  - Warm/Cold/Global reset
> 
> +  - DeepSx transition
> 
> +  **/
> 
> +  GpioDswReset         = 0x07
> 
> +} GPIO_RESET_CONFIG;
> 
> +
> 
> +/**
> 
> +  GPIO Electrical Configuration
> 
> +  Configuration options for GPIO termination setting
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioTermDefault          = 0x0,  ///< Leave termination setting unmodified
> 
> +  GpioTermNone             = 0x1,  ///< none
> 
> +  GpioTermWpd5K            = 0x5,  ///< 5kOhm weak pull-down
> 
> +  GpioTermWpd20K           = 0x9,  ///< 20kOhm weak pull-down
> 
> +  GpioTermWpu1K            = 0x13, ///< 1kOhm weak pull-up
> 
> +  GpioTermWpu2K            = 0x17, ///< 2kOhm weak pull-up
> 
> +  GpioTermWpu5K            = 0x15, ///< 5kOhm weak pull-up
> 
> +  GpioTermWpu20K           = 0x19, ///< 20kOhm weak pull-up
> 
> +  GpioTermWpu1K2K          = 0x1B, ///< 1kOhm & 2kOhm weak pull-up
> 
> +  /**
> 
> +  Native function controls pads termination
> 
> +  This setting is applicable only to some native modes.
> 
> +  Please check EDS to determine which native functionality
> 
> +  can control pads termination
> 
> +  **/
> 
> +  GpioTermNative           = 0x1F
> 
> +} GPIO_ELECTRICAL_CONFIG;
> 
> +
> 
> +#define B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK    0x1F   ///<
> Mask for GPIO_ELECTRICAL_CONFIG for termination value
> 
> +
> 
> +/**
> 
> +  GPIO LockConfiguration
> 
> +  Set GPIO configuration lock and output state lock.
> 
> +  GpioPadConfigUnlock/Lock and GpioOutputStateUnlock can be OR'ed.
> 
> +  By default GPIO pads will be locked unless GPIO lib is explicitly
> 
> +  informed that certain pad is to be left unlocked.
> 
> +  Lock settings reset is in Powergood domain. Care must be taken when
> using this setting
> 
> +  as fields it locks may be reset by a different signal and can be controlled
> 
> +  by what is in GPIO_RESET_CONFIG (PADCFG_DW0.PadRstCfg). GPIO
> library provides
> 
> +  functions which allow to unlock a GPIO pad. If possible each GPIO lib
> function will try to unlock
> 
> +  an already locked pad upon request for reconfiguration
> 
> +**/
> 
> +typedef enum {
> 
> +  /**
> 
> +  Perform default action
> 
> +   - if pad is an GPO, lock configuration but leave output unlocked
> 
> +   - if pad is an GPI, lock everything
> 
> +   - if pad is in native, lock everything
> 
> +**/
> 
> +  GpioLockDefault         = 0x0,
> 
> +  GpioPadConfigUnlock     = 0x3,  ///< Leave Pad configuration unlocked
> 
> +  GpioPadConfigLock       = 0x1,  ///< Lock Pad configuration
> 
> +  GpioOutputStateUnlock   = 0xC,  ///< Leave Pad output control unlocked
> 
> +  GpioPadUnlock           = 0xF,  ///< Leave both Pad configuration and output
> control unlocked
> 
> +  GpioPadLock             = 0x5,  ///< Lock both Pad configuration and output
> control
> 
> +  /**
> 
> +    Below statuses are used for
> 
> +    return from GpioGetPadConfig function
> 
> +  **/
> 
> +  GpioLockTxLockCfgUnLock = 0x7,  ///< Tx State locked, Pad Configuration
> unlocked
> 
> +  GpioLockTxUnLockCfgLock = 0xD   ///< Tx State unlocked, Pad
> Configuration locked
> 
> +} GPIO_LOCK_CONFIG;
> 
> +
> 
> +#define B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK  0x3  ///< Mask
> for GPIO_LOCK_CONFIG for Pad Configuration Lock
> 
> +#define B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK    0xC  ///< Mask
> for GPIO_LOCK_CONFIG for Pad Output Lock
> 
> +
> 
> +/**
> 
> +  Other GPIO Configuration
> 
> +  GPIO_OTHER_CONFIG is used for less often settings and for future
> extensions
> 
> +  Supported settings:
> 
> +   - RX raw override to '1' - allows to override input value to '1'
> 
> +      This setting is applicable only if in input mode (both in GPIO and native
> usage).
> 
> +      The override takes place at the internal pad state directly from buffer
> and before the RXINV.
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioRxRaw1Default           = 0x0,  ///< Use default input override value
> 
> +  GpioRxRaw1Dis               = 0x1,  ///< Don't override input
> 
> +  GpioRxRaw1En                = 0x3   ///< Override input to '1'
> 
> +} GPIO_OTHER_CONFIG;
> 
> +
> 
> +#define B_GPIO_OTHER_CONFIG_RXRAW_MASK           0x3   ///< Mask for
> GPIO_OTHER_CONFIG for RxRaw1 setting
> 
> +
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif //_GPIO_CONFIG_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h
> new file mode 100644
> index 0000000000..5b3cf502a0
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioLib.h
> @@ -0,0 +1,720 @@
> +/** @file
> 
> +  Header file for GpioLib.
> 
> +  All function in this library is available for PEI, DXE, and SMM
> 
> +
> 
> +  @note: When GPIO pads are owned by ME Firmware, BIOS/host should
> not
> 
> +         attempt to access these GPIO Pads registers, registers value
> 
> +         returned in this case will be 0xFF.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_LIB_H_
> 
> +#define _GPIO_LIB_H_
> 
> +
> 
> +#include <Library/GpioConfig.h>
> 
> +
> 
> +#define GPIO_NAME_LENGTH_MAX  32
> 
> +
> 
> +typedef struct {
> 
> +  GPIO_PAD           GpioPad;
> 
> +  GPIO_CONFIG        GpioConfig;
> 
> +} GPIO_INIT_CONFIG;
> 
> +
> 
> +/**
> 
> +  This procedure will initialize multiple GPIO pins. Use GPIO_INIT_CONFIG
> structure.
> 
> +  Structure contains fields that can be used to configure each pad.
> 
> +  Pad not configured using GPIO_INIT_CONFIG will be left with hardware
> default values.
> 
> +  Separate fields could be set to hardware default if it does not matter,
> except
> 
> +  GpioPad and PadMode.
> 
> +  Function will work in most efficient way if pads which belong to the same
> group are
> 
> +  placed in adjacent records of the table.
> 
> +  Although function can enable pads for Native mode, such programming is
> done
> 
> +  by reference code when enabling related silicon feature.
> 
> +
> 
> +  @param[in] NumberofItem               Number of GPIO pads to be updated
> 
> +  @param[in] GpioInitTableAddress       GPIO initialization table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioConfigurePads (
> 
> +  IN UINT32                    NumberOfItems,
> 
> +  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
> 
> +  );
> 
> +
> 
> +//
> 
> +// Functions for setting/getting multiple GpioPad settings
> 
> +//
> 
> +
> 
> +/**
> 
> +  This procedure will read multiple GPIO settings
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[out] GpioData                  GPIO data structure
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadConfig (
> 
> +  IN  GPIO_PAD               GpioPad,
> 
> +  OUT GPIO_CONFIG            *GpioData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will configure multiple GPIO settings
> 
> +
> 
> +  @param[in] GpioPad                    GPIO Pad
> 
> +  @param[in] GpioData                   GPIO data structure
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_CONFIG               *GpioData
> 
> +  );
> 
> +
> 
> +//
> 
> +// Functions for setting/getting single GpioPad properties
> 
> +//
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO output level
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Output value
> 
> +                                  0: OutputLow, 1: OutputHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetOutputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO output level
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] OutputVal           GPIO Output value
> 
> +                                  0: OutputLow, 1: OutputHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetOutputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *OutputVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO input level
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] InputVal            GPIO Input value
> 
> +                                  0: InputLow, 1: InputHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetInputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *InputVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO IOxAPIC interrupt number
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] IrqNum              IRQ number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadIoApicIrqNumber (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *IrqNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will configure GPIO input inversion
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value for GPIO input inversion
> 
> +                                  0: No input inversion, 1: Invert input
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetInputInversion (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO pad input inversion value
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] InvertState         GPIO inversion state
> 
> +                                  0: No input inversion, 1: Inverted input
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetInputInversion (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *InvertState
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO interrupt settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of Level/Edge
> 
> +                                  use GPIO_INT_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadInterruptConfig (
> 
> +  IN GPIO_PAD                 GpioPad,
> 
> +  IN GPIO_INT_CONFIG          Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO electrical settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of termination
> 
> +                                  use GPIO_ELECTRICAL_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadElectricalConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_ELECTRICAL_CONFIG    Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO Reset settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value for Pad Reset Configuration
> 
> +                                  use GPIO_RESET_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadResetConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_RESET_CONFIG         Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO Reset settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of Pad Reset Configuration
> 
> +                                  based on GPIO_RESET_CONFIG
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadResetConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_RESET_CONFIG         *Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get Gpio Pad Host Software Ownership
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] PadHostSwOwn        Value of Host Software Pad Owner
> 
> +                                  0: ACPI Mode, 1: GPIO Driver mode
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetHostSwOwnershipForPad (
> 
> +  IN GPIO_PAD                 GpioPad,
> 
> +  OUT UINT32                  *PadHostSwOwn
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set Gpio Pad Host Software Ownership
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in]  PadHostSwOwn        Pad Host Software Owner
> 
> +                                  0: ACPI Mode, 1: GPIO Driver mode
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetHostSwOwnershipForPad (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    PadHostSwOwn
> 
> +  );
> 
> +
> 
> +///
> 
> +/// Possible values of Pad Ownership
> 
> +/// If Pad is not under Host ownership then GPIO registers
> 
> +/// are not accessible by host (e.g. BIOS) and reading them
> 
> +/// will return 0xFFs.
> 
> +///
> 
> +typedef enum {
> 
> +  GpioPadOwnHost = 0x0,
> 
> +  GpioPadOwnCsme = 0x1,
> 
> +  GpioPadOwnIsh  = 0x2,
> 
> +} GPIO_PAD_OWN;
> 
> +
> 
> +/**
> 
> +  This procedure will get Gpio Pad Ownership
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] PadOwnVal           Value of Pad Ownership
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadOwnership (
> 
> +  IN  GPIO_PAD                GpioPad,
> 
> +  OUT GPIO_PAD_OWN            *PadOwnVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Lock for pads within one
> group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] PadCfgLockRegVal    Value of PadCfgLock register
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: NotLocked, 1: Locked
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockForGroupDw (
> 
> +  IN  GPIO_GROUP                  Group,
> 
> +  IN  UINT32                      DwNum,
> 
> +  OUT UINT32                      *PadCfgLockRegVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Lock for selected pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] PadCfgLock          PadCfgLock for selected pad
> 
> +                                  0: NotLocked, 1: Locked
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLock (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT UINT32                    *PadCfgLock
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Tx Lock for pads within one
> group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLockTx register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] PadCfgLockTxRegVal  Value of PadCfgLockTx register
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: NotLockedTx, 1: LockedTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockTxForGroupDw (
> 
> +  IN  GPIO_GROUP                  Group,
> 
> +  IN  UINT32                      DwNum,
> 
> +  OUT UINT32                      *PadCfgLockTxRegVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Tx Lock for selected pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] PadCfgLock          PadCfgLockTx for selected pad
> 
> +                                  0: NotLockedTx, 1: LockedTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockTx (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT UINT32                    *PadCfgLockTx
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLock for selected pads within one group.
> 
> +  Unlocking a pad will cause an SMI (if enabled)
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToUnlock        Bitmask for pads which are going to be
> unlocked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotUnlock, 1: Unlock
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgForGroupDw (
> 
> +  IN GPIO_GROUP                Group,
> 
> +  IN UINT32                    DwNum,
> 
> +  IN UINT32                    PadsToUnlock
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLock for selected pad.
> 
> +  Unlocking a pad will cause an SMI (if enabled)
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfg (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLock for selected pads within one group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLock          Bitmask for pads which are going to be
> locked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotLock, 1: Lock
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgForGroupDw (
> 
> +  IN GPIO_GROUP                   Group,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       PadsToLock
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLock for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfg (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLockTx for selected pads within one group.
> 
> +  Unlocking a pad will cause an SMI (if enabled)
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLockTx register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToUnlockTx      Bitmask for pads which are going to be
> unlocked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotUnLockTx, 1: LockTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgTxForGroupDw (
> 
> +  IN GPIO_GROUP                Group,
> 
> +  IN UINT32                    DwNum,
> 
> +  IN UINT32                    PadsToUnlockTx
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLockTx for selected pad.
> 
> +  Unlocking a pad will cause an SMI (if enabled)
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgTx (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLockTx for selected pads within one group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLockTx        Bitmask for pads which are going to be
> locked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotLockTx, 1: LockTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgTxForGroupDw (
> 
> +  IN GPIO_GROUP                   Group,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       PadsToLockTx
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLockTx for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgTx (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get Group to GPE mapping.
> 
> +  It will assume that only first 32 pads can be mapped to GPE.
> 
> +  To handle cases where groups have more than 32 pads and higher part of
> group
> 
> +  can be mapped please refer to GpioGetGroupDwToGpeDwX()
> 
> +
> 
> +  @param[out] GroupToGpeDw0       GPIO group to be mapped to GPE_DW0
> 
> +  @param[out] GroupToGpeDw1       GPIO group to be mapped to GPE_DW1
> 
> +  @param[out] GroupToGpeDw2       GPIO group to be mapped to GPE_DW2
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGroupToGpeDwX (
> 
> +  IN GPIO_GROUP               *GroupToGpeDw0,
> 
> +  IN GPIO_GROUP               *GroupToGpeDw1,
> 
> +  IN GPIO_GROUP               *GroupToGpeDw2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get Group to GPE mapping. If group has more than 32
> bits
> 
> +  it is possible to map only single DW of pins (e.g. 0-31, 32-63) because
> 
> +  ACPI GPE_DWx register is 32 bits large.
> 
> +
> 
> +  @param[out]  GroupToGpeDw0       GPIO group mapped to GPE_DW0
> 
> +  @param[out]  GroupDwForGpeDw0    DW of pins mapped to GPE_DW0
> 
> +  @param[out]  GroupToGpeDw1       GPIO group mapped to GPE_DW1
> 
> +  @param[out]  GroupDwForGpeDw1    DW of pins mapped to GPE_DW1
> 
> +  @param[out]  GroupToGpeDw2       GPIO group mapped to GPE_DW2
> 
> +  @param[out]  GroupDwForGpeDw2    DW of pins mapped to GPE_DW2
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGroupDwToGpeDwX (
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw0,
> 
> +  OUT UINT32                    *GroupDwForGpeDw0,
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw1,
> 
> +  OUT UINT32                    *GroupDwForGpeDw1,
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw2,
> 
> +  OUT UINT32                    *GroupDwForGpeDw2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPE number for provided GpioPad.
> 
> +  PCH allows to configure mapping between GPIO groups and related GPE
> (GpioSetGroupToGpeDwX())
> 
> +  what results in the fact that certain Pad can cause different General
> Purpose Event. Only three
> 
> +  GPIO groups can be mapped to cause unique GPE (1-tier), all others groups
> will be under one common
> 
> +  event (GPE_111 for 2-tier).
> 
> +
> 
> +  1-tier:
> 
> +  Returned GpeNumber is in range <0,95>. GpioGetGpeNumber() can be
> used
> 
> +  to determine what _LXX ACPI method would be called on event on
> selected GPIO pad
> 
> +
> 
> +  2-tier:
> 
> +  Returned GpeNumber is 0x6F (111). All GPIO pads which are not mapped
> to 1-tier GPE
> 
> +  will be under one master GPE_111 which is linked to _L6F ACPI method. If
> it is needed to determine
> 
> +  what Pad from 2-tier has caused the event, _L6F method should check
> GPI_GPE_STS and GPI_GPE_EN
> 
> +  registers for all GPIO groups not mapped to 1-tier GPE.
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpeNumber           GPE number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpeNumber (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT UINT32                    *GpeNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to clear SMI STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearGpiSmiSts (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used by Smi Dispatcher and will clear
> 
> +  all GPI SMI Status bits
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearAllGpiSmiSts (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to disable all GPI SMI
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioDisableAllGpiSmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to register GPI SMI dispatch function.
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpiNum              GPI number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiSmiNum (
> 
> +  IN GPIO_PAD          GpioPad,
> 
> +  OUT UINTN            *GpiNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to check GPIO inputs belongs to 2 tier or 1 tier
> architecture
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval     Data                0 means 1-tier, 1 means 2-tier
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioCheckFor2Tier (
> 
> +  IN GPIO_PAD                  GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to clear GPE STS for a specified GpioPad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearGpiGpeSts (
> 
> +  IN GPIO_PAD                  GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to read GPE STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpeSts              Gpe status for given pad
> 
> +                                  The GpeSts is true if the status register is set for given Pad
> number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiGpeSts (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT BOOLEAN                  *GpeSts
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to get SMI STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] SmiSts              Smi status for given pad
> 
> +                                  The SmiSts is true if the status register is set for given Pad
> number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiSmiSts (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT BOOLEAN                   *SmiSts
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generates GPIO name from GpioPad
> 
> +
> 
> +  @param[in]  GpioPad             GpioPad
> 
> +  @param[out] GpioNameBuffer      Caller allocated buffer for GPIO name of
> GPIO_NAME_LENGTH_MAX size
> 
> +  @param[in]  GpioNameBufferSize  Size of the buffer
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO name
> 
> +**/
> 
> +CHAR8*
> 
> +GpioGetPadName (
> 
> +  IN  GPIO_PAD  GpioPad,
> 
> +  OUT CHAR8*    GpioNameBuffer,
> 
> +  IN  UINT32    GpioNameBufferSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generates GPIO group name from GroupIndex
> 
> +
> 
> +  @param[in] GroupIndex  Gpio GroupIndex
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO group name
> 
> +**/
> 
> +CONST
> 
> +CHAR8*
> 
> +GpioGetGroupName (
> 
> +  IN UINT32  GroupIndex
> 
> +  );
> 
> +
> 
> +#endif // _GPIO_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h
> new file mode 100644
> index 0000000000..b09600dd30
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/GpioNativeLib.h
> @@ -0,0 +1,149 @@
> +/** @file
> 
> +  Header file for GpioLib for native and Si specific usage.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_NATIVE_LIB_H_
> 
> +#define _GPIO_NATIVE_LIB_H_
> 
> +
> 
> +#include <Library/GpioConfig.h>
> 
> +
> 
> +/**
> 
> +  This procedure will get number of pads for certain GPIO group
> 
> +
> 
> +  @param[in] Group            GPIO group number
> 
> +
> 
> +  @retval Value               Pad number for group
> 
> +                              If illegal group number then return 0
> 
> +**/
> 
> +UINT32
> 
> +GpioGetPadPerGroup (
> 
> +  IN GPIO_GROUP        Group
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get number of groups
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Group number
> 
> +**/
> 
> +UINT32
> 
> +GpioGetNumberOfGroups (
> 
> +  VOID
> 
> +  );
> 
> +/**
> 
> +  This procedure will get lowest group
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Lowest Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetLowestGroup (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get highest group
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Highest Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetHighestGroup (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get group
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetGroupFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get group index (0 based) from GpioPad
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Group Index
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupIndexFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get group index (0 based) from group
> 
> +
> 
> +  @param[in] GpioGroup        Gpio Group
> 
> +
> 
> +  @retval Value               Group Index
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupIndexFromGroup (
> 
> +  IN GPIO_GROUP        GpioGroup
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get group from group index (0 based)
> 
> +
> 
> +  @param[in] GroupIndex        Group Index
> 
> +
> 
> +  @retval GpioGroup            Gpio Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetGroupFromGroupIndex (
> 
> +  IN UINT32        GroupIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get pad number (0 based) from Gpio Pad
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Pad Number
> 
> +**/
> 
> +UINT32
> 
> +GpioGetPadNumberFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return GpioPad from Group and PadNumber
> 
> +
> 
> +  @param[in] Group              GPIO group
> 
> +  @param[in] PadNumber          GPIO PadNumber
> 
> +
> 
> +  @retval GpioPad               GpioPad
> 
> +**/
> 
> +GPIO_PAD
> 
> +GpioGetGpioPadFromGroupAndPadNumber (
> 
> +  IN GPIO_GROUP      Group,
> 
> +  IN UINT32          PadNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return GpioPad from GroupIndex and PadNumber
> 
> +
> 
> +  @param[in] GroupIndex         GPIO GroupIndex
> 
> +  @param[in] PadNumber          GPIO PadNumber
> 
> +
> 
> +  @retval GpioPad               GpioPad
> 
> +**/
> 
> +GPIO_PAD
> 
> +GpioGetGpioPadFromGroupIndexAndPadNumber (
> 
> +  IN UINT32          GroupIndex,
> 
> +  IN UINT32          PadNumber
> 
> +  );
> 
> +
> 
> +#endif // _GPIO_NATIVE_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h
> new file mode 100644
> index 0000000000..a53887ffcb
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/MmPciLib.h
> @@ -0,0 +1,27 @@
> +/** @file
> 
> +  Get Pci Express address library implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _MM_PCI_LIB_H_
> 
> +#define _MM_PCI_LIB_H_
> 
> +
> 
> +/**
> 
> +  This procedure will get PCIE address
> 
> +
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +
> 
> +  @retval PCIE address
> 
> +**/
> 
> +UINTN
> 
> +EFIAPI
> 
> +MmPciBase (
> 
> +  IN UINT32                       Bus,
> 
> +  IN UINT32                       Device,
> 
> +  IN UINT32                       Function
> 
> +);
> 
> +
> 
> +#endif // _PEI_DXE_SMM_MM_PCI_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h
> new file mode 100644
> index 0000000000..3c46029b7f
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcieRpLib.h
> @@ -0,0 +1,123 @@
> +/** @file
> 
> +  Header file for PchPcieRpLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCIERP_LIB_H_
> 
> +#define _PCH_PCIERP_LIB_H_
> 
> +
> 
> +#include <Library/PchPcrLib.h>
> 
> +
> 
> +/**
> 
> +  PCIe controller bifurcation configuration.
> 
> +**/
> 
> +typedef enum {
> 
> +  PcieBifurcationDefault = 0,
> 
> +  PcieBifurcation4x1,
> 
> +  PcieBifurcation1x2_2x1,
> 
> +  PcieBifurcation2x2,
> 
> +  PcieBifurcation1x4,
> 
> +  PcieBifurcation4x2,
> 
> +  PcieBifurcation1x4_2x2,
> 
> +  PcieBifurcation2x2_1x4,
> 
> +  PcieBifurcation2x4,
> 
> +  PcieBifurcation1x8,
> 
> +  PcieBifurcationUnknown,
> 
> +  PcieBifurcationMax
> 
> +} PCIE_BIFURCATION_CONFIG;
> 
> +
> 
> +/**
> 
> +  This function returns PID according to PCIe controller index
> 
> +
> 
> +  @param[in] ControllerIndex     PCIe controller index
> 
> +
> 
> +  @retval PCH_SBI_PID    Returns PID for SBI Access
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PchGetPcieControllerSbiPid (
> 
> +  IN UINT32  ControllerIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function returns PID according to Root Port Number
> 
> +
> 
> +  @param[in] RpIndex     Root Port Index (0-based)
> 
> +
> 
> +  @retval PCH_SBI_PID    Returns PID for SBI Access
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +GetRpSbiPid (
> 
> +  IN UINTN  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Pcie Root Port Device and Function Number by Root Port physical
> Number
> 
> +
> 
> +  @param[in]  RpNumber            Root port physical number. (0-based)
> 
> +  @param[out] RpDev               Return corresponding root port device
> number.
> 
> +  @param[out] RpFun               Return corresponding root port function
> number.
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetPchPcieRpDevFun (
> 
> +  IN  UINTN   RpNumber,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Root Port physical Number by Pch Pcie Root Port Device and Function
> Number
> 
> +
> 
> +  @param[in]  RpDev                 Root port device number.
> 
> +  @param[in]  RpFun                 Root port function number.
> 
> +  @param[out] RpNumber              Return corresponding physical Root Port
> index (0-based)
> 
> +
> 
> +  @retval     EFI_SUCCESS           Physical root port is retrieved
> 
> +  @retval     EFI_INVALID_PARAMETER RpDev and/or RpFun are invalid
> 
> +  @retval     EFI_UNSUPPORTED       Root port device and function is not
> assigned to any physical root port
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetPchPcieRpNumber (
> 
> +  IN  UINTN   RpDev,
> 
> +  IN  UINTN   RpFun,
> 
> +  OUT UINTN   *RpNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets pci segment base address of PCIe root port.
> 
> +
> 
> +  @param RpIndex    Root Port Index (0 based)
> 
> +  @return PCIe port base address.
> 
> +**/
> 
> +UINT64
> 
> +PchPcieBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Determines whether L0s is supported on current stepping.
> 
> +
> 
> +  @return TRUE if L0s is supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsPcieL0sSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Some early PCH steppings require Native ASPM to be disabled due to
> hardware issues:
> 
> +   - RxL0s exit causes recovery
> 
> +   - Disabling PCIe L0s capability disables L1
> 
> +  Use this function to determine affected steppings.
> 
> +
> 
> +  @return TRUE if Native ASPM is supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsPcieNativeAspmSupported (
> 
> +  VOID
> 
> +  );
> 
> +#endif // _PCH_PCIERP_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h
> new file mode 100644
> index 0000000000..f46c3da0e1
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PchPcrLib.h
> @@ -0,0 +1,256 @@
> +/** @file
> 
> +  Header file for PchPcrLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCR_LIB_H_
> 
> +#define _PCH_PCR_LIB_H_
> 
> +
> 
> +#include <PchReservedResources.h>
> 
> +
> 
> +/**
> 
> +  Definition for PCR address
> 
> +  The PCR address is used to the PCR MMIO programming
> 
> +
> 
> +  SBREG_BAR_20BITADDRESS is configured by SoC
> 
> +
> 
> +  SBREG_BAR_20BITADDRESS=1, the format has included 16b addressing.
> 
> +  +-----------------------------------------------------------------------------------------
> ----+
> 
> +  | Addr[63:28]    | Addr[27:24]           | Addr[23:16]     | Addr[15:2]           |
> Addr[1:0] |
> 
> +  +----------------+-----------------------+-----------------+----------------------------
> ------+
> 
> +  | REG_BAR[63:28] | TargetRegister[19:16] | TargetPort[7:0] |
> TargetRegister[15:2]             |
> 
> +  +-----------------------------------------------------------------------------------------
> ----+
> 
> +
> 
> +  SBREG_BAR_20BITADDRESS=0
> 
> +  +-----------------------------------------------------------------------------------------
> ----+
> 
> +  | Addr[63:24]    | Addr[27:24]           | Addr[23:16]     | Addr[15:2]           |
> Addr[1:0] |
> 
> +  +----------------+-----------------------+-----------------+----------------------------
> ------+
> 
> +  | REG_BAR[63:24] | REG_BAR[27:24]        | TargetPort[7:0] |
> TargetRegister[15:2]             |
> 
> +  +-----------------------------------------------------------------------------------------
> ----+
> 
> +**/
> 
> +#define PCH_PCR_ADDRESS(Pid, Offset)    (PCH_PCR_BASE_ADDRESS |
> (UINT32) (((Offset) & 0x0F0000) << 8) | ((UINT8)(Pid) << 16) | (UINT16)
> ((Offset) & 0xFFFF))
> 
> +
> 
> +/**
> 
> +  PCH PCR boot script accessing macro
> 
> +  Those macros are only available for DXE phase.
> 
> +**/
> 
> +#define PCH_PCR_BOOT_SCRIPT_WRITE(Width, Pid, Offset, Count, Buffer)
> \
> 
> +          S3BootScriptSaveMemWrite (Width, PCH_PCR_ADDRESS (Pid, Offset),
> Count, Buffer); \
> 
> +
> 
> +#define PCH_PCR_BOOT_SCRIPT_READ_WRITE(Width, Pid, Offset, DataOr,
> DataAnd) \
> 
> +          S3BootScriptSaveMemReadWrite (Width, PCH_PCR_ADDRESS (Pid,
> Offset), DataOr, DataAnd); \
> 
> +
> 
> +#define PCH_PCR_BOOT_SCRIPT_READ(Width, Pid, Offset, BitMask,
> BitValue) \
> 
> +          S3BootScriptSaveMemPoll (Width, PCH_PCR_ADDRESS (Pid, Offset),
> BitMask, BitValue, 1, 1);
> 
> +
> 
> +typedef UINT8          PCH_SBI_PID;
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT32       PCR register value.
> 
> +**/
> 
> +UINT32
> 
> +PchPcrRead32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT16       PCR register value.
> 
> +**/
> 
> +UINT16
> 
> +PchPcrRead16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT8        PCR register value
> 
> +**/
> 
> +UINT8
> 
> +PchPcrRead8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval UINT32       Value written to register
> 
> +**/
> 
> +UINT32
> 
> +PchPcrWrite32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            InData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT16      Value written to register
> 
> +**/
> 
> +UINT16
> 
> +PchPcrWrite16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT16                            InData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT8       Value written to register
> 
> +**/
> 
> +UINT8
> 
> +PchPcrWrite8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT8                             InData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT32      Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +PchPcrAndThenOr32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register and read back.
> 
> +  The read back ensures the PCR cycle is completed before next operation.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT32      Value read back from the register
> 
> +**/
> 
> +UINT32
> 
> +PchPcrAndThenOr32WithReadback (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval UINT16       Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +PchPcrAndThenOr16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT16                            AndData,
> 
> +  IN  UINT16                            OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT8       Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +PchPcrAndThenOr8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT8                             AndData,
> 
> +  IN  UINT8                             OrData
> 
> +  );
> 
> +
> 
> +
> 
> +typedef enum {
> 
> +  PchIpDmi = 1,
> 
> +  PchIpIclk,
> 
> +} PCH_IP_PID_ENUM;
> 
> +
> 
> +#define PCH_INVALID_PID 0
> 
> +
> 
> +/**
> 
> +  Get PCH IP PID number
> 
> +
> 
> +  @param[in]  IpEnum   PCH IP in PCH_IP_PID_ENUM
> 
> +
> 
> +  @retval     0        PID of this IP is not supported
> 
> +              !0       PID of the IP.
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PchPcrGetPid (
> 
> +  PCH_IP_PID_ENUM  IpEnum
> 
> +  );
> 
> +
> 
> +#endif // _PCH_PCR_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h
> new file mode 100644
> index 0000000000..8ab20f0db7
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PcieHelperLib.h
> @@ -0,0 +1,173 @@
> +/** @file
> 
> +  Header file for PCI Express helpers base library
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCIE_HELPER_LIB_H_
> 
> +#define _PCIE_HELPER_LIB_H_
> 
> +
> 
> +#include <PcieRegs.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +
> 
> +/**
> 
> +  Find the Offset to a given Capabilities ID
> 
> +  CAPID list:
> 
> +    0x01 = PCI Power Management Interface
> 
> +    0x04 = Slot Identification
> 
> +    0x05 = MSI Capability
> 
> +    0x10 = PCI Express Capability
> 
> +
> 
> +  @param[in] DeviceBase           device's base address
> 
> +  @param[in] CapId                CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PcieBaseFindCapId (
> 
> +  IN UINT64  DeviceBase,
> 
> +  IN UINT8   CapId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Find the Offset to a given Capabilities ID
> 
> +  CAPID list:
> 
> +    0x01 = PCI Power Management Interface
> 
> +    0x04 = Slot Identification
> 
> +    0x05 = MSI Capability
> 
> +    0x10 = PCI Express Capability
> 
> +
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PcieFindCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT8   CapId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Search and return the offset of desired Pci Express Capability ID
> 
> +  CAPID list:
> 
> +    0x0001 = Advanced Error Reporting Capability
> 
> +    0x0002 = Virtual Channel Capability
> 
> +    0x0003 = Device Serial Number Capability
> 
> +    0x0004 = Power Budgeting Capability
> 
> +
> 
> +  @param[in] DeviceBase           device base address
> 
> +  @param[in] CapId                Extended CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found, this includes situation where device
> doesn't exist
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT16
> 
> +PcieBaseFindExtendedCapId (
> 
> +  IN UINT64  DeviceBase,
> 
> +  IN UINT16  CapId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Search and return the offset of desired Pci Express Capability ID
> 
> +  CAPID list:
> 
> +    0x0001 = Advanced Error Rreporting Capability
> 
> +    0x0002 = Virtual Channel Capability
> 
> +    0x0003 = Device Serial Number Capability
> 
> +    0x0004 = Power Budgeting Capability
> 
> +
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                Extended CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT16
> 
> +PcieFindExtendedCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT16  CapId
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Checks device's Slot Clock Configuration
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +  @param[in] PcieCapOffset   devices Pci express capability list register
> offset
> 
> +
> 
> +  @retval TRUE when device device uses slot clock, FALSE otherwise
> 
> +*/
> 
> +BOOLEAN
> 
> +GetScc (
> 
> +  UINT64    Base,
> 
> +  UINT8     PcieCapOffset
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Sets Common Clock Configuration bit for given device.
> 
> +  @param[in] PcieCapOffset   devices Pci express capability list register
> offset
> 
> +  @param[in] Base            device's base address
> 
> +*/
> 
> +VOID
> 
> +EnableCcc (
> 
> +  UINT64    Base,
> 
> +  UINT8     PcieCapOffset
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Retrains link behind given device.
> 
> +  It only makes sense to call it for downstream ports.
> 
> +  If called for upstream port nothing will happen, it won't enter infinite loop.
> 
> +
> 
> +  @param[in] Base                 device's base address
> 
> +  @param[in] PcieCapOffset        devices Pci express capability list register
> offset
> 
> +  @param[boolean] WaitUnitlDone   when TRUE, function waits until link has
> retrained
> 
> +*/
> 
> +VOID
> 
> +RetrainLink (
> 
> +  UINT64  Base,
> 
> +  UINT8   PcieCapOffset,
> 
> +  BOOLEAN WaitUntilDone
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Checks if device at given address exists
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +
> 
> +  @retval TRUE when device exists; FALSE otherwise
> 
> +*/
> 
> +BOOLEAN
> 
> +IsDevicePresent (
> 
> +  UINT64 Base
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Checks if device is a multifunction device
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +
> 
> +  @retval TRUE if multifunction; FALSE otherwise
> 
> +*/
> 
> +BOOLEAN
> 
> +IsMultifunctionDevice (
> 
> +  UINT64 Base
> 
> +  );
> 
> +#endif // _PCIE_HELPER_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h
> new file mode 100644
> index 0000000000..0b8ad7a182
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/PmcLib.h
> @@ -0,0 +1,355 @@
> +/** @file
> 
> +  Header file for PmcLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PMC_LIB_H_
> 
> +#define _PMC_LIB_H_
> 
> +
> 
> +#pragma pack(1)
> 
> +
> 
> +typedef enum {
> 
> +  PmcTPch25_10us = 0,
> 
> +  PmcTPch25_100us,
> 
> +  PmcTPch25_1ms,
> 
> +  PmcTPch25_10ms,
> 
> +} PMC_TPCH25_TIMING;
> 
> +
> 
> +typedef enum {
> 
> +  PmcNotASleepState,
> 
> +  PmcInS0State,
> 
> +  PmcS1SleepState,
> 
> +  PmcS2SleepState,
> 
> +  PmcS3SleepState,
> 
> +  PmcS4SleepState,
> 
> +  PmcS5SleepState,
> 
> +  PmcUndefinedState,
> 
> +} PMC_SLEEP_STATE;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32    Buf0;
> 
> +  UINT32    Buf1;
> 
> +  UINT32    Buf2;
> 
> +  UINT32    Buf3;
> 
> +} PMC_IPC_COMMAND_BUFFER;
> 
> +
> 
> +//
> 
> +// Structure to Check different attributes for CrashLog supported by PMC.
> 
> +//
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32  Avail      : 1;        ///< CrashLog feature availability bit
> 
> +    UINT32  Dis        : 1;        ///< CrasLog Disable bit
> 
> +    UINT32  Rsvd       : 2;        ///< Reserved
> 
> +    UINT32  Size       : 12;       ///< CrasLog data size. (If it is zero, use default size
> 0xC00)
> 
> +    UINT32  BaseOffset : 16;       ///< Start offset of CrashLog in PMC SSRAM
> 
> +  } Bits;
> 
> +  struct {
> 
> +    UINT32  Avail      : 1;        ///< CrashLog feature availability bit
> 
> +    UINT32  Dis        : 1;        ///< CrasLog Disable bit
> 
> +    UINT32  Mech       : 2;        ///< CrashLog mechanism
> 
> +    UINT32  ManuTri    : 1;        ///< Manul trigger command.
> 
> +    UINT32  Clr        : 1;        ///< Clear Command
> 
> +    UINT32  AllReset   : 1;        ///< Trigger on all reset command
> 
> +    UINT32  ReArm      : 1;        ///< Re-arm command
> 
> +    UINT32  Rsvd       : 20;       ///< Pch Specific reserved
> 
> +    UINT32  CrashLogReq: 1;        ///< Crash log requestor flow
> 
> +    UINT32  TriArmedSts: 1;        ///< Trigger armed status, re-arm indication
> bit.
> 
> +    UINT32  TriAllReset: 1;        ///< Trigger on all resets status
> 
> +    UINT32  CrashDisSts: 1;        ///< Crash log disabled status
> 
> +    UINT32  PchRsvd    : 16;       ///< Pch Specific reserved
> 
> +    UINT32  DesTableOffset: 16;    ///< Descriptor Table offset
> 
> +  } Bits64;
> 
> +  UINT32  Uint32;
> 
> +  UINT64  Uint64;
> 
> +} PMC_IPC_DISCOVERY_BUF;
> 
> +
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32 Offset   : 16;
> 
> +    UINT32 Size     : 16;
> 
> +  } Info;
> 
> +  UINT32 Uint32;
> 
> +} PMC_CRASHLOG_RECORDS;
> 
> +
> 
> +typedef struct PmcCrashLogLink {
> 
> +  PMC_CRASHLOG_RECORDS      Record;
> 
> +  UINT64                    AllocateAddress;
> 
> +  struct PmcCrashLogLink    *Next;
> 
> +} PMC_CRASHLOG_LINK;
> 
> +
> 
> +#pragma pack()
> 
> +
> 
> +/**
> 
> +  Get PCH ACPI base address.
> 
> +
> 
> +  @retval Address                   Address of PWRM base address.
> 
> +**/
> 
> +UINT16
> 
> +PmcGetAcpiBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH PWRM base address.
> 
> +
> 
> +  @retval Address                   Address of PWRM base address.
> 
> +**/
> 
> +UINT32
> 
> +PmcGetPwrmBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets tPCH25 timing
> 
> +
> 
> +  @param[in] TimingValue       tPCH25 timing value (10us, 100us, 1ms, 10ms)
> 
> +**/
> 
> +VOID
> 
> +PmcSetTPch25Timing (
> 
> +  IN PMC_TPCH25_TIMING    TimingValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if RTC Power Failure occurred by
> 
> +  reading RTC_PWR_FLR bit
> 
> +
> 
> +  @retval RTC Power Failure state: TRUE  - Battery is always present.
> 
> +                                   FALSE - CMOS is cleared.
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsRtcBatteryGood (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if Power Failure occurred by
> 
> +  reading PWR_FLR bit
> 
> +
> 
> +  @retval Power Failure state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsPowerFailureDetected (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if Power Failure occurred by
> 
> +  reading SUS_PWR_FLR bit
> 
> +
> 
> +  @retval SUS Power Failure state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsSusPowerFailureDetected (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function clears Power Failure status (PWR_FLR)
> 
> +**/
> 
> +VOID
> 
> +PmcClearPowerFailureStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function clears Global Reset status (GBL_RST_STS)
> 
> +**/
> 
> +VOID
> 
> +PmcClearGlobalResetStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function clears Host Reset status (HOST_RST_STS)
> 
> +**/
> 
> +VOID
> 
> +PmcClearHostResetStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function clears SUS Power Failure status (SUS_PWR_FLR)
> 
> +**/
> 
> +VOID
> 
> +PmcClearSusPowerFailureStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets state to which platform will get after power is reapplied
> 
> +
> 
> +  @param[in] PowerStateAfterG3          0: S0 state (boot)
> 
> +                                        1: S5/S4 State
> 
> +**/
> 
> +VOID
> 
> +PmcSetPlatformStateAfterPowerFailure (
> 
> +  IN UINT8 PowerStateAfterG3
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables Power Button SMI
> 
> +**/
> 
> +VOID
> 
> +PmcEnablePowerButtonSmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function disables Power Button SMI
> 
> +**/
> 
> +VOID
> 
> +PmcDisablePowerButtonSmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function reads PM Timer Count driven by 3.579545 MHz clock
> 
> +
> 
> +  @retval PM Timer Count
> 
> +**/
> 
> +UINT32
> 
> +PmcGetTimerCount (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Sleep Type that platform has waken from
> 
> +
> 
> +  @retval SleepType                Sleep Type
> 
> +**/
> 
> +PMC_SLEEP_STATE
> 
> +PmcGetSleepTypeAfterWake (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clear PMC Wake Status
> 
> +**/
> 
> +VOID
> 
> +PmcClearWakeStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configure sleep state
> 
> +
> 
> +  @param[in] SleepState         S0/S1/S3/S4/S5, refer to PMC_SLEEP_STATE
> 
> +**/
> 
> +VOID
> 
> +PmcSetSleepState (
> 
> +  PMC_SLEEP_STATE  SleepState
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if platform boots after shutdown caused by power button override
> event
> 
> +
> 
> +  @retval  TRUE   Power Button Override occurred in last system boot
> 
> +  @retval  FALSE  Power Button Override didn't occur
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsPowerButtonOverrideDetected (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function will set the DISB - DRAM Initialization Scratchpad Bit.
> 
> +**/
> 
> +VOID
> 
> +PmcSetDramInitScratchpad (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check global SMI enable is set
> 
> +
> 
> +  @retval TRUE  Global SMI enable is set
> 
> +          FALSE Global SMI enable is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsGblSmiEn (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if SMI Lock is set
> 
> +
> 
> +  @retval SMI Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsSmiLockSet (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if Debug Mode is locked
> 
> +
> 
> +  @retval Debug Mode Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsDebugModeLocked (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check TCO second timeout status.
> 
> +
> 
> +  @retval  TRUE   TCO reboot happened.
> 
> +  @retval  FALSE  TCO reboot didn't happen.
> 
> +**/
> 
> +BOOLEAN
> 
> +TcoSecondToHappened (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function clears the Second TO status bit
> 
> +**/
> 
> +VOID
> 
> +TcoClearSecondToStatus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check TCO SMI ENABLE is locked
> 
> +
> 
> +  @retval TRUE  TCO SMI ENABLE is locked
> 
> +          FALSE TCO SMI ENABLE is not locked
> 
> +**/
> 
> +BOOLEAN
> 
> +TcoIsSmiLock (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if user wants to turn off in PEI phase
> 
> +
> 
> +**/
> 
> +VOID
> 
> +CheckPowerOffNow(
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Clear any SMI status or wake status left from boot.
> 
> +**/
> 
> +VOID
> 
> +ClearSmiAndWake (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Function to check if Dirty Warm Reset occurs
> 
> +  (Global Reset has been converted to Host Reset)
> 
> +
> 
> +  @reval TRUE DWR occurs
> 
> +  @reval FALSE Normal boot flow
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsDwrBootMode (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _PMC_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h
> new file mode 100644
> index 0000000000..9ab55ad9d0
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/ResetSystemLib.h
> @@ -0,0 +1,79 @@
> +/** @file
> 
> +  System reset Library Services.  This library class defines a set of
> 
> +  methods that reset the whole system.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef __RESET_SYSTEM_LIB_H__
> 
> +#define __RESET_SYSTEM_LIB_H__
> 
> +
> 
> +/**
> 
> +  This function causes a system-wide reset (cold reset), in which
> 
> +  all circuitry within the system returns to its initial state. This type of reset
> 
> +  is asynchronous to system operation and operates without regard to
> 
> +  cycle boundaries.
> 
> +
> 
> +  If this function returns, it means that the system does not support cold
> reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetCold (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function causes a system-wide initialization (warm reset), in which all
> processors
> 
> +  are set to their initial state. Pending cycles are not corrupted.
> 
> +
> 
> +  If this function returns, it means that the system does not support warm
> reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetWarm (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function causes the system to enter a power state equivalent
> 
> +  to the ACPI G2/S5 or G3 states.
> 
> +
> 
> +  If this function returns, it means that the system does not support
> shutdown reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetShutdown (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function causes the system to enter S3 and then wake up
> immediately.
> 
> +
> 
> +  If this function returns, it means that the system does not support S3
> feature.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +EnterS3WithImmediateWake (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function causes a systemwide reset. The exact type of the reset is
> 
> +  defined by the EFI_GUID that follows the Null-terminated Unicode string
> passed
> 
> +  into ResetData. If the platform does not recognize the EFI_GUID in
> ResetData
> 
> +  the platform must pick a supported reset type to perform.The platform
> may
> 
> +  optionally log the parameters from any non-normal reset that occurs.
> 
> +
> 
> +  @param[in]  DataSize   The size, in bytes, of ResetData.
> 
> +  @param[in]  ResetData  The data buffer starts with a Null-terminated
> string,
> 
> +                         followed by the EFI_GUID.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetPlatformSpecific (
> 
> +  IN UINTN   DataSize,
> 
> +  IN VOID    *ResetData
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h
> new file mode 100644
> index 0000000000..bc1555ed19
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SataLib.h
> @@ -0,0 +1,112 @@
> +/** @file
> 
> +  Header file for SataLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SATA_LIB_H_
> 
> +#define _SATA_LIB_H_
> 
> +
> 
> +#define SATA_1_CONTROLLER_INDEX             0
> 
> +#define SATA_2_CONTROLLER_INDEX             1
> 
> +#define SATA_3_CONTROLLER_INDEX             2
> 
> +
> 
> +/**
> 
> +  Get Maximum Sata Port Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     Maximum Sata Port Number
> 
> +**/
> 
> +UINT8
> 
> +MaxSataPortNum (
> 
> +  IN UINT32     SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Maximum Sata Controller Number
> 
> +
> 
> +  @retval Maximum Sata Controller Number
> 
> +**/
> 
> +UINT8
> 
> +MaxSataControllerNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get SATA controller's Port Present Status
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     Port Present Status
> 
> +**/
> 
> +UINT8
> 
> +GetSataPortPresentStatus (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get SATA controller Function Disable Status
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval 0 SATA Controller is not Function Disabled
> 
> +  @retval 1 SATA Controller is Function Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SataControllerFunctionDisableStatus (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get SATA controller ABAR size
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller ABAR size
> 
> +**/
> 
> +UINT32
> 
> +GetSataAbarSize (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get SATA controller AHCI base address
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller AHCI base address
> 
> +**/
> 
> +UINT32
> 
> +GetSataAhciBase (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if SATA controller supports RST remapping
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     TRUE                Controller supports remapping
> 
> +  @retval     FALSE               Controller does not support remapping
> 
> +**/
> 
> +BOOLEAN
> 
> +IsRemappingSupportedOnSata (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if SoC supports the SATA PGD power down on given
> 
> +  SATA controller.
> 
> +
> 
> +  @param[in] SataCtrlIndex  SATA controller index
> 
> +
> 
> +  @retval TRUE   SATA PGD power down supported
> 
> +  @retval FALSE  SATA PGD power down not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSataPowerGatingSupported (
> 
> +  IN UINT32 SataCtrlIndex
> 
> +  );
> 
> +
> 
> +#endif // _SATA_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h
> new file mode 100644
> index 0000000000..3c8aae6ac2
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SerialIoAccessLib.h
> @@ -0,0 +1,113 @@
> +/** @file
> 
> +  Header file for Serial Io Common Lib
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_ACCESS_LIB_H_
> 
> +#define _SERIAL_IO_ACCESS_LIB_H_
> 
> +
> 
> +/**
> 
> +  Returns BAR0
> 
> +
> 
> +  @param[in] PciCfgBase         Pci Config Base
> 
> +
> 
> +  @retval    64bit MMIO BAR Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoBar (
> 
> +  IN UINT64        PciCfgBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns I2C Pci Config Space
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +
> 
> +  @retval    I2C Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoI2cPciCfg (
> 
> +  IN UINT8        I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI Pci Config Space
> 
> +
> 
> +  @param[in] SpiNumber         SPI Number
> 
> +
> 
> +  @retval    SPI Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoSpiPciCfg (
> 
> +  IN UINT8        SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns UART Pci Config Space
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    UART Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoUartPciCfg (
> 
> +  IN UINT8        UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Device with given PciDeviceId is one of SerialIo I2C controllers
> 
> +  If yes, its number is returned through I2cIndex parameter, otherwise
> I2cIndex is not updated
> 
> +
> 
> +  @param[in]  PciDevId                  Device ID
> 
> +  @param[out] I2cNumber                 Number of SerialIo I2C controller
> 
> +
> 
> +  @retval TRUE                          yes it is a SerialIo I2C controller
> 
> +  @retval FALSE                         no it isn't a SerialIo I2C controller
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cDeviceId (
> 
> +  IN  UINT16    PciDevId,
> 
> +  OUT UINT8     *I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if I2c is Function 0 Enabled
> 
> +
> 
> +  @param[in] I2cIndex                   Number of the SerialIo I2C controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cFunction0Enabled (
> 
> +  IN UINT8    I2cIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Uart is Function 0 Enabled
> 
> +
> 
> +  @param[in] UartIndex                   Number of the SerialIo Uart controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoUartFunction0Enabled (
> 
> +  IN UINT8    UartIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Spi is Function 0 Enabled
> 
> +
> 
> +  @param[in] SpiIndex                   Number of the SerialIo Spi controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoSpiFunction0Enabled (
> 
> +  IN UINT8    SpiIndex
> 
> +  );
> 
> +
> 
> +#endif // _SERIAL_IO_ACCESS_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h
> new file mode 100644
> index 0000000000..7732ccf59e
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SiConfigBlockLib.h
> @@ -0,0 +1,56 @@
> +/** @file
> 
> +  Prototype of the SiConfigBlockLib library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_CONFIG_BLOCK_LIB_H_
> 
> +#define _SI_CONFIG_BLOCK_LIB_H_
> 
> +
> 
> +
> 
> +typedef
> 
> +VOID
> 
> +(*LOAD_DEFAULT_FUNCTION) (
> 
> +  IN VOID   *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +typedef struct {
> 
> +  EFI_GUID               *Guid;
> 
> +  UINT16                 Size;
> 
> +  UINT8                  Revision;
> 
> +  LOAD_DEFAULT_FUNCTION  LoadDefault;
> 
> +} COMPONENT_BLOCK_ENTRY;
> 
> +
> 
> +/**
> 
> +  GetComponentConfigBlockTotalSize get config block table total size.
> 
> +
> 
> +  @param[in] ComponentBlocks    Component blocks array
> 
> +  @param[in] TotalBlockCount    Number of blocks
> 
> +
> 
> +  @retval                       Size of config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +GetComponentConfigBlockTotalSize (
> 
> +  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
> 
> +  IN UINT16                TotalBlockCount
> 
> +  );
> 
> +
> 
> +/**
> 
> +  AddComponentConfigBlocks add all config blocks.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add config blocks
> 
> +  @param[in] ComponentBlocks            Config blocks array
> 
> +  @param[in] TotalBlockCount            Number of blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +AddComponentConfigBlocks (
> 
> +  IN VOID                  *ConfigBlockTableAddress,
> 
> +  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
> 
> +  IN UINT16                TotalBlockCount
> 
> +  );
> 
> +#endif // _SI_CONFIG_BLOCK_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h
> new file mode 100644
> index 0000000000..50f9e048b3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/SpiAccessLib.h
> @@ -0,0 +1,290 @@
> +/** @file
> 
> +  SPI library header for abstraction of SPI HW registers accesses
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SPI_ACCESS_LIB_H_
> 
> +#define _SPI_ACCESS_LIB_H_
> 
> +
> 
> +/**
> 
> +  Returns SPI PCI Config Space base address
> 
> +
> 
> +  @retval  UINT64  SPI Config Space base address
> 
> +**/
> 
> +UINT64
> 
> +SpiGetPciCfgAddress (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI BAR0 value
> 
> +
> 
> +  @retval  UINT32  PCH SPI BAR0 value
> 
> +**/
> 
> +UINT32
> 
> +SpiGetBar0 (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI Device number
> 
> +
> 
> +  @retval UINT8   PCH SPI Device number
> 
> +**/
> 
> +UINT8
> 
> +SpiDeviceNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI Function number
> 
> +
> 
> +  @retval UINT8   PCH SPI Function number
> 
> +**/
> 
> +UINT8
> 
> +SpiFunctionNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns descriptor signature
> 
> +
> 
> +  @retval UINT32    Descriptor signature
> 
> +**/
> 
> +UINT32
> 
> +SpiGetDescriptorSignature (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns supported features and R/W frequencies of Flash Component
> 
> +
> 
> +  @retval UINT32    Flash Component features descriptor
> 
> +**/
> 
> +UINT32
> 
> +SpiGetFlashComponentDescription (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns number of Flash Components
> 
> +
> 
> +  @retval UINT32    Flash components number
> 
> +**/
> 
> +UINT32
> 
> +SpiGetFlashComponentsNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns total Flash size with regards to number of flash components
> 
> +
> 
> +  @retval UINT32    Total Flash Memory size
> 
> +**/
> 
> +UINT32
> 
> +SpiGetTotalFlashSize (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if PCH SPI Controler is present and available
> 
> +
> 
> +  @retval TRUE    PCH SPI controller is avaialable
> 
> +  @retval FALSE   PCH SPI controller is not available
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsControllerAvailable (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks BIOS lock bits for proper value and checks if write protection is
> enabled
> 
> +  Expected vales are: LE bit set, EISS bit set and WPD bit cleared
> 
> +
> 
> +  @retval  TRUE    All protection bits are set correctly
> 
> +  @retval  FALSE   Not all protection bits had exepcted values
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsWriteProtectionEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Flash Descriptor Override Pin Strap status
> 
> +
> 
> +  @retval TRUE     Flash Descriptor override is enabled
> 
> +  @retval FALSE    Flash Descriptor override is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashDescriptorOverrideEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Flash Configuration Lock Down bit status
> 
> +
> 
> +  @retval TRUE    Flash Configuration Lock Down bit is set
> 
> +  @retval FALSE   Flash Configuration Lock Down bit is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashConfigurationLockDownEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Top Swap functionality enable state
> 
> +
> 
> +  @retval TRUE    Top Swap is enabled
> 
> +  @retval FALSE   Top Swap is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsTopSwapEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return Component Property Parameter Table for a given component
> number
> 
> +
> 
> +  @param[in]  ComponentNumber   SPI Component number
> 
> +  @param[out] CppTable          Component Poperty Parameter Table value
> 
> +
> 
> +  @retval TRUE  Vendor Specific Component Capabilities Register value was
> read
> 
> +  @reval  FALSE Vendor Specific Component Capabilities Register value was
> not present
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiGetComponentPropertyParameterTable (
> 
> +  IN  UINT8  ComponentNumber,
> 
> +  OUT UINT32 *CppTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns valid bit status in given Component Property Parameter Table
> 
> +
> 
> +  @param[in] CppTable          Component Poperty Parameter Table value
> 
> +
> 
> +  @retval TRUE    Valid bit is set
> 
> +  @reval  FALSE   Valid bit is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsCppValidBitSet (
> 
> +  IN UINT32  CppTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Flash Descriptor is valid
> 
> +
> 
> +  @retval TRUE  Flash Descriptor is valid
> 
> +  @retval FALSE Flash Descriptor is invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashDescriptorValid (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns masked BIOS Master Read Access
> 
> +
> 
> +  @retval UINT32    Already masked BIOS Master Read Access
> 
> +**/
> 
> +UINT32
> 
> +SpiGetMasterReadAccess (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns masked BIOS Master Write Access
> 
> +
> 
> +  @retval UINT32    Already masked BIOS Master Write Access
> 
> +**/
> 
> +UINT32
> 
> +SpiGetMasterWriteAccess (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns GbE Region Access rights
> 
> +
> 
> +  @retval UINT32    GbE Region access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetGbeRegionAccess (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns CSME region access rights
> 
> +
> 
> +  @retval UINT32    CSME Region Access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetCsmeRegionAccess (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns EC region access right
> 
> +
> 
> +  @retval UINT32     EC Region access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetEcRegionAccess (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if Slave Attached Flash (SAF) mode is active
> 
> +
> 
> +  @retval TRUE    SAF mode is active
> 
> +  @retval FALSE   SAF mode is not active
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsSafModeActive (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks validity of GbE region
> 
> +
> 
> +  @retval TRUE    GbE region is valid
> 
> +  @retval FALSE   GbE regios in invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsGbeRegionValid (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns status of BIOS Interface Lockdown
> 
> +
> 
> +  @retval TRUE  BIOS Interface Lockdown is enabled
> 
> +  @retval FALSE BIOS Interface Lockdown is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsBiosInterfaceLockdownEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns TRUE if BIOS Boot Strap is set to SPI
> 
> +
> 
> +  @retval TRUE    BIOS Boot strap is set to SPI
> 
> +  @retval FALSE   BIOS Boot strap is set to LPC/eSPI
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsBiosBootFromSpi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check SPI write status disable is set
> 
> +
> 
> +  @retval TRUE    Write status disable is set
> 
> +  @retval FALSE   Write status disable is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsWriteStatusDisable (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _SPI_ACCESS_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h
> new file mode 100644
> index 0000000000..69eed8d32d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Library/VtdInfoLib.h
> @@ -0,0 +1,53 @@
> +/** @file
> 
> +  Header file for VtdInfoLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _VTD_INFO_LIB_H_
> 
> +#define _VTD_INFO_LIB_H_
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/HobLib.h>
> 
> +
> 
> +#define VTD_ENGINE_NUMBER             7
> 
> +
> 
> +#pragma pack(1)
> 
> +
> 
> +/**
> 
> +  Get VTD Engine Base Address from PCD values.
> 
> +
> 
> +  @param[in]  VtdEngineNumber        - Engine number for which VTD Base
> Adderess is required.
> 
> +
> 
> +  @retval   VTD Engine Base Address
> 
> +**/
> 
> +UINT32
> 
> +GetVtdBaseAddress (
> 
> +  IN UINT8        VtdEngineNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read VTD Engine Base Address from VTD BAR Offsets.
> 
> +
> 
> +  @param[in]  VtdEngineNumber        - Engine number for which VTD Base
> Adderess is required.
> 
> +
> 
> +  @retval   VTD Engine Base Address
> 
> +**/
> 
> +UINT32
> 
> +ReadVtdBaseAddress (
> 
> +  IN UINT8        VtdEngineNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  GetMaxVtdEngineNumber: Get Maximum Vtd Engine Number
> 
> +
> 
> +  @retval Vtd Engine Number
> 
> +**/
> 
> +UINT8
> 
> +GetMaxVtdEngineNumber(
> 
> +  VOID
> 
> +);
> 
> +
> 
> +#pragma pack()
> 
> +#endif // _VTD_INFO_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h
> new file mode 100644
> index 0000000000..f296c780f5
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/FspmArchConfigPpi.h
> @@ -0,0 +1,32 @@
> +/** @file
> 
> +  Header file for FSP-M Arch Config PPI
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _FSPM_ARCH_CONFIG_PPI_H_
> 
> +#define _FSPM_ARCH_CONFIG_PPI_H_
> 
> +
> 
> +///
> 
> +/// Global ID for the FSPM_ARCH_CONFIG_PPI.
> 
> +///
> 
> +#define FSPM_ARCH_CONFIG_GUID \
> 
> +  { \
> 
> +    0x824d5a3a, 0xaf92, 0x4c0c, { 0x9f, 0x19, 0x19, 0x52, 0x6d, 0xca, 0x4a,
> 0xbb } \
> 
> +  }
> 
> +
> 
> +///
> 
> +/// This PPI provides FSP-M Arch Config PPI.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8         Revision;
> 
> +  UINT8         Reserved[3];
> 
> +  VOID          *NvsBufferPtr;
> 
> +  UINT32        BootLoaderTolumSize;
> 
> +  UINT8         Reserved1[4];
> 
> +} FSPM_ARCH_CONFIG_PPI;
> 
> +
> 
> +extern EFI_GUID gFspmArchConfigPpiGuid;
> 
> +
> 
> +#endif // _FSPM_ARCH_CONFIG_PPI_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h
> new file mode 100644
> index 0000000000..3fd917c2b9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiPreMemSiDefaultPolicy.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  This file defines the function to initialize default silicon policy PPI.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> +#define _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> +
> 
> +//
> 
> +// Forward declaration for the
> PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI.
> 
> +//
> 
> +typedef struct _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI
> PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI;
> 
> +
> 
> +/**
> 
> +  Initialize and install default silicon policy PPI
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PEI_PREMEM_POLICY_INIT) (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +///
> 
> +/// This PPI provides function to install default silicon policy
> 
> +///
> 
> +struct _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI {
> 
> +  PEI_PREMEM_POLICY_INIT   PeiPreMemPolicyInit;   ///<
> PeiPreMemPolicyInit()
> 
> +};
> 
> +
> 
> +extern EFI_GUID gSiPreMemDefaultPolicyInitPpiGuid;
> 
> +
> 
> +#endif // _PEI_PREMEM_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h
> new file mode 100644
> index 0000000000..9cb34728cc
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/PeiSiDefaultPolicy.h
> @@ -0,0 +1,33 @@
> +/** @file
> 
> +  This file defines the function to initialize default silicon policy PPI.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> +#define _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> +
> 
> +//
> 
> +// Forward declaration for the PEI_SI_DEFAULT_POLICY_INIT_PPI.
> 
> +//
> 
> +typedef struct _PEI_SI_DEFAULT_POLICY_INIT_PPI
> PEI_SI_DEFAULT_POLICY_INIT_PPI;
> 
> +
> 
> +/**
> 
> +  Initialize and install default silicon policy PPI
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PEI_POLICY_INIT) (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +///
> 
> +/// This PPI provides function to install default silicon policy
> 
> +///
> 
> +struct _PEI_SI_DEFAULT_POLICY_INIT_PPI {
> 
> +  PEI_POLICY_INIT   PeiPolicyInit;    ///< PeiPolicyInit()
> 
> +};
> 
> +
> 
> +extern EFI_GUID gSiDefaultPolicyInitPpiGuid;
> 
> +
> 
> +#endif // _PEI_SI_DEFAULT_POLICY_INIT_PPI_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h
> new file mode 100644
> index 0000000000..eb75c4cc4d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Ppi/SiPolicy.h
> @@ -0,0 +1,79 @@
> +/** @file
> 
> +  Silicon Policy PPI is used for specifying platform
> 
> +  related Intel silicon information and policy setting.
> 
> +  This PPI is consumed by the silicon PEI modules and carried
> 
> +  over to silicon DXE modules.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SI_POLICY_PPI_H_
> 
> +#define _SI_POLICY_PPI_H_
> 
> +
> 
> +#include <SiPolicyStruct.h>
> 
> +#include <PchPolicyCommon.h>
> 
> +#include <PchPreMemPolicyCommon.h>
> 
> +#include <MePolicyCommon.h>
> 
> +#include <CpuPolicyCommon.h>
> 
> +#include <Uefi.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +
> 
> +#ifndef DISABLED
> 
> +#define DISABLED  0
> 
> +#endif
> 
> +#ifndef ENABLED
> 
> +#define ENABLED   1
> 
> +#endif
> 
> +
> 
> +extern EFI_GUID gSiPreMemPolicyPpiGuid;
> 
> +extern EFI_GUID gSiPolicyPpiGuid;
> 
> +
> 
> +
> 
> +#include <GraphicsConfig.h>
> 
> +extern EFI_GUID gGraphicsPeiPreMemConfigGuid;
> 
> +extern EFI_GUID gGraphicsPeiConfigGuid;
> 
> +
> 
> +#include <VtdConfig.h>
> 
> +extern EFI_GUID gVtdConfigGuid;
> 
> +
> 
> +#include <GnaConfig.h>
> 
> +extern EFI_GUID gGnaConfigGuid;
> 
> +
> 
> +
> 
> +
> 
> +#include <CpuPcieConfigGen3.h>

Remove this line.

> 
> +#include <CpuPcieConfig.h>
> 
> +extern EFI_GUID gCpuPciePeiPreMemConfigGuid;
> 
> +extern EFI_GUID gCpuPcieRpConfigGuid;
> 
> +
> 
> +
> 
> +#include <HybridGraphicsConfig.h>
> 
> +extern EFI_GUID gHybridGraphicsConfigGuid;
> 
> +
> 
> +#include <ConfigBlock/PramPreMemConfig.h>
> 
> +#include <MemoryConfig.h>
> 
> +extern EFI_GUID gMemoryConfigGuid;
> 
> +extern EFI_GUID gMemoryConfigNoCrcGuid;
> 
> +
> 
> +#include <ConfigBlock/SaMiscPeiPreMemConfig.h>
> 
> +extern EFI_GUID gSaMiscPeiPreMemConfigGuid;
> 
> +
> 
> +#include <ConfigBlock/SaMiscPeiConfig.h>
> 
> +extern EFI_GUID gSaMiscPeiConfigGuid;
> 
> +
> 
> +
> 
> +#include <TraceHubConfig.h>
> 
> +extern EFI_GUID gCpuTraceHubConfigGuid;
> 
> +
> 
> +#include <HostBridgeConfig.h>
> 
> +extern EFI_GUID gHostBridgePeiPreMemConfigGuid;
> 
> +extern EFI_GUID gHostBridgePeiConfigGuid;
> 
> +
> 
> +#include <CpuDmiPreMemConfig.h>
> 
> +extern EFI_GUID gCpuDmiPreMemConfigGuid;
> 
> +
> 
> +typedef struct _SI_PREMEM_POLICY_STRUCT SI_PREMEM_POLICY_PPI;
> 
> +typedef struct _SI_POLICY_STRUCT SI_POLICY_PPI;
> 
> +
> 
> +#endif // _SI_POLICY_PPI_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.
> h
> new file mode 100644
> index 0000000000..1d69ee0e8d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopComponentName2.
> h
> @@ -0,0 +1,61 @@
> +/** @file
> 
> +  Protocol to retrieve the GOP driver version
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GOP_COMPONENT_NAME2_H_
> 
> +#define _GOP_COMPONENT_NAME2_H_
> 
> +
> 
> +
> 
> +typedef struct _GOP_COMPONENT_NAME2_PROTOCOL
> GOP_COMPONENT_NAME2_PROTOCOL;
> 
> +
> 
> +///
> 
> +/// GOP Component protocol for retrieving driver name
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GOP_COMPONENT_NAME2_GET_DRIVER_NAME) (
> 
> +  IN  GOP_COMPONENT_NAME2_PROTOCOL * This,
> 
> +  IN  CHAR8                           *Language,
> 
> +  OUT CHAR16                          **DriverName
> 
> +  );
> 
> +
> 
> +///
> 
> +/// GOP Component protocol for retrieving controller name
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GOP_COMPONENT_NAME2_GET_CONTROLLER_NAME) (
> 
> +  IN  GOP_COMPONENT_NAME2_PROTOCOL          * This,
> 
> +  IN  EFI_HANDLE                               ControllerHandle,
> 
> +  IN  EFI_HANDLE                               ChildHandle OPTIONAL,
> 
> +  IN  CHAR8                                    *Language,
> 
> +  OUT CHAR16                                   **ControllerName
> 
> +  );
> 
> +
> 
> +///
> 
> +/// GOP Component protocol for retrieving driver version
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GOP_COMPONENT_NAME2_GET_DRIVER_VERSION) (
> 
> +  IN  GOP_COMPONENT_NAME2_PROTOCOL          * This,
> 
> +  IN  CHAR8                                    *Language,
> 
> +  OUT CHAR16                                   **DriverVersion
> 
> +  );
> 
> +
> 
> +/**
> 
> +  GOP Component protocol\n
> 
> +  This protocol will be installed by GOP driver and can be used to retrieve
> GOP information.
> 
> +**/
> 
> +struct _GOP_COMPONENT_NAME2_PROTOCOL {
> 
> +  GOP_COMPONENT_NAME2_GET_DRIVER_NAME      GetDriverName;
> ///< Protocol function to get driver name
> 
> +  GOP_COMPONENT_NAME2_GET_DRIVER_VERSION   GetDriverVersion;
> ///< Protocol function to get driver version
> 
> +  GOP_COMPONENT_NAME2_GET_CONTROLLER_NAME
> GetControllerName;      ///< Protocol function to get controller name
> 
> +  CHAR8                                    *SupportedLanguages;    ///< Number of
> Supported languages.
> 
> +};
> 
> +
> 
> +extern EFI_GUID gGopComponentName2ProtocolGuid;
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h
> new file mode 100644
> index 0000000000..c8dc17008e
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/GopPolicy.h
> @@ -0,0 +1,73 @@
> +/** @file
> 
> +  Interface definition for GopPolicy Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GOP_POLICY_PROTOCOL_H_
> 
> +#define _GOP_POLICY_PROTOCOL_H_
> 
> +
> 
> +
> 
> +#define GOP_POLICY_PROTOCOL_REVISION_01  0x01
> 
> +#define GOP_POLICY_PROTOCOL_REVISION_03  0x03
> 
> +
> 
> +typedef enum {
> 
> +  LidClosed,
> 
> +  LidOpen,
> 
> +  LidStatusMax
> 
> +} LID_STATUS;
> 
> +
> 
> +typedef enum {
> 
> +  Docked,
> 
> +  UnDocked,
> 
> +  DockStatusMax
> 
> +} DOCK_STATUS;
> 
> +
> 
> +///
> 
> +/// Function to retrieve LID status
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GET_PLATFORM_LID_STATUS) (
> 
> +  OUT LID_STATUS * CurrentLidStatus
> 
> +  );
> 
> +
> 
> +///
> 
> +/// Function to retrieve Dock status
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GET_PLATFORM_DOCK_STATUS) (
> 
> + OUT DOCK_STATUS  CurrentDockStatus
> 
> +);
> 
> +
> 
> +///
> 
> +/// Function to retrieve VBT table address and size
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *GET_VBT_DATA) (
> 
> +  OUT EFI_PHYSICAL_ADDRESS * VbtAddress,
> 
> +  OUT UINT32               *VbtSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  System Agent Graphics Output Protocol (GOP) - Policy Protocol\n
> 
> +  Graphics Output Protocol (GOP) is a UEFI API replacing legacy Video ROMs
> for EFI boot\n
> 
> +  When GOP Driver is used this protocol can be consumed by GOP driver or
> platform code for GOP relevant initialization\n
> 
> +  All functions in this protocol should be initialized by platform code basing
> on platform implementation\n
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32                    Revision;              ///< Protocol revision
> 
> +  GET_PLATFORM_LID_STATUS   GetPlatformLidStatus;  ///< Protocol
> function to get Lid Status. Platform code should provide this function basing
> on design.
> 
> +  GET_VBT_DATA              GetVbtData;            ///< Protocol function to get Vbt
> Data address and size. Platform code should provide this function basing on
> design.
> 
> +  GET_PLATFORM_DOCK_STATUS  GetPlatformDockStatus;  ///< Function
> pointer for get platform dock status.
> 
> +  EFI_GUID                  GopOverrideGuid;        ///< A GUID provided by BIOS in
> case GOP is to be overridden.
> 
> +} GOP_POLICY_PROTOCOL;
> 
> +
> 
> +extern EFI_GUID gGopPolicyProtocolGuid;
> 
> +extern EFI_GUID gGen12PolicyProtocolGuid;
> 
> +extern EFI_GUID gGen9PolicyProtocolGuid;
> 
> +extern EFI_GUID gIntelGraphicsVbtGuid;
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h
> new file mode 100644
> index 0000000000..c030f771e3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/IgdOpRegion.h
> @@ -0,0 +1,22 @@
> +/** @file
> 
> +  This file is part of the IGD OpRegion Implementation.  The IGD OpRegion is
> 
> +  an interface between system BIOS, ASL code, and Graphics drivers.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _IGD_OPREGION_PROTOCOL_H_
> 
> +#define _IGD_OPREGION_PROTOCOL_H_
> 
> +
> 
> +#include <IndustryStandard/IgdOpRegion.h>
> 
> +
> 
> +extern EFI_GUID gIgdOpRegionProtocolGuid;
> 
> +
> 
> +///
> 
> +/// IGD OpRegion Protocol
> 
> +///
> 
> +typedef struct {
> 
> +  IGD_OPREGION_STRUCTURE  *OpRegion; ///< IGD Operation Region
> Structure
> 
> +} IGD_OPREGION_PROTOCOL;
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h
> new file mode 100644
> index 0000000000..c13dc5a5f5
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Protocol/Spi.h
> @@ -0,0 +1,301 @@
> +/** @file
> 
> +  This file defines the PCH SPI Protocol which implements the
> 
> +  Intel(R) PCH SPI Host Controller Compatibility Interface.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SPI_PROTOCOL_H_
> 
> +#define _PCH_SPI_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                   gPchSpiProtocolGuid;
> 
> +extern EFI_GUID                   gPchSmmSpiProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_SPI_PROTOCOL  PCH_SPI_PROTOCOL;
> 
> +
> 
> +//
> 
> +// SPI protocol data structures and definitions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Flash Region Type
> 
> +**/
> 
> +typedef enum {
> 
> +  FlashRegionDescriptor,
> 
> +  FlashRegionBios,
> 
> +  FlashRegionMe,
> 
> +  FlashRegionGbE,
> 
> +  FlashRegionPlatformData,
> 
> +  FlashRegionDer,
> 
> +  FlashRegionSecondaryBios,
> 
> +  FlashRegionuCodePatch,
> 
> +  FlashRegionEC,
> 
> +  FlashRegionDeviceExpansion2,
> 
> +  FlashRegionIE,
> 
> +  FlashRegion10Gbe_A,
> 
> +  FlashRegion10Gbe_B,
> 
> +  FlashRegion13,
> 
> +  FlashRegion14,
> 
> +  FlashRegion15,
> 
> +  FlashRegionAll,
> 
> +  FlashRegionMax
> 
> +} FLASH_REGION_TYPE;
> 
> +//
> 
> +// Protocol member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Read data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[out] Buffer              The Pointer to caller-allocated buffer
> containing the dada received.
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_READ) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *Buffer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write data to the flash part. Remark: Erase may be needed before write to
> the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[in] Buffer               Pointer to caller-allocated buffer containing the
> data sent during the SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_WRITE) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *Buffer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Erase some area on the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_ERASE) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read SFDP data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] Address              The starting byte address for SFDP data read.
> 
> +  @param[in] ByteCount            Number of bytes in SFDP data portion of the
> SPI cycle
> 
> +  @param[out] SfdpData            The Pointer to caller-allocated buffer
> containing the SFDP data received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_READ_SFDP) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *SfdpData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read Jedec Id from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] ByteCount            Number of bytes in JedecId data portion of
> the SPI cycle, the data size is 3 typically
> 
> +  @param[out] JedecId             The Pointer to caller-allocated buffer
> containing JEDEC ID received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_READ_JEDEC_ID) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *JedecId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write the status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[in] StatusValue          The Pointer to caller-allocated buffer
> containing the value of Status register writing
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_WRITE_STATUS) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *StatusValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[out] StatusValue         The Pointer to caller-allocated buffer
> containing the value of Status register received.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_FLASH_READ_STATUS) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *StatusValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get the SPI region base and size, based on the enum type
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for for the base
> address which is listed in the Descriptor.
> 
> +  @param[out] BaseAddress         The Flash Linear Address for the Region 'n'
> Base
> 
> +  @param[out] RegionSize          The size for the Region 'n'
> 
> +
> 
> +  @retval EFI_SUCCESS             Read success
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid region type given
> 
> +  @retval EFI_DEVICE_ERROR        The region is not used
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_GET_REGION_ADDRESS) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  OUT    UINT32             *BaseAddress,
> 
> +  OUT    UINT32             *RegionSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read PCH Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing PCH Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_READ_PCH_SOFTSTRAP) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read CPU Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        CPU Soft Strap address offset from
> FCPUSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle.
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing CPU Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SPI_READ_CPU_SOFTSTRAP) (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  These protocols/PPI allows a platform module to perform SPI operations
> through the
> 
> +  Intel PCH SPI Host Controller Interface.
> 
> +**/
> 
> +struct _PCH_SPI_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                             Revision;
> 
> +  PCH_SPI_FLASH_READ                FlashRead;          ///< Read data from the
> flash part.
> 
> +  PCH_SPI_FLASH_WRITE               FlashWrite;         ///< Write data to the flash
> part. Remark: Erase may be needed before write to the flash part.
> 
> +  PCH_SPI_FLASH_ERASE               FlashErase;         ///< Erase some area on the
> flash part.
> 
> +  PCH_SPI_FLASH_READ_SFDP           FlashReadSfdp;      ///< Read SFDP data
> from the flash part.
> 
> +  PCH_SPI_FLASH_READ_JEDEC_ID       FlashReadJedecId;   ///< Read Jedec
> Id from the flash part.
> 
> +  PCH_SPI_FLASH_WRITE_STATUS        FlashWriteStatus;   ///< Write the
> status register in the flash part.
> 
> +  PCH_SPI_FLASH_READ_STATUS         FlashReadStatus;    ///< Read status
> register in the flash part.
> 
> +  PCH_SPI_GET_REGION_ADDRESS        GetRegionAddress;   ///< Get the SPI
> region base and size
> 
> +  PCH_SPI_READ_PCH_SOFTSTRAP        ReadPchSoftStrap;   ///< Read PCH
> Soft Strap Values
> 
> +  PCH_SPI_READ_CPU_SOFTSTRAP        ReadCpuSoftStrap;   ///< Read CPU
> Soft Strap Values
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH SPI PPI/PROTOCOL revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +**/
> 
> +#define PCH_SPI_SERVICES_REVISION       1
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other include headers
  2021-02-01  1:36 ` [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other " Heng Luo
@ 2021-02-04  3:52   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:52 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and
> other include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Include/Pins
>   * Include/Register
>   * Include/*.h
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h            |  53
> +++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h             |  38
> ++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h      |  75
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h             | 138
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h                    |  57
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h         |  24
> ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h               | 155
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h    | 110
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h     |  72
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h      | 121
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h  | 226
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h  |  16
> ++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h    |  36
> ++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h |  93
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h       | 258
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h       |  45
> +++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h      |  56
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h  |  47
> +++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h       |  51
> +++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h        | 213
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h            |  17
> +++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h         |  64
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
>  22 files changed, 1965 insertions(+)
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h
> new file mode 100644
> index 0000000000..ad34e4ea42
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/ConfigBlock.h
> @@ -0,0 +1,53 @@
> +/** @file
> 
> +  Header file for Config Block Lib implementation
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _CONFIG_BLOCK_H_
> 
> +#define _CONFIG_BLOCK_H_
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Uefi/UefiMultiPhase.h>
> 
> +#include <Pi/PiBootMode.h>
> 
> +#include <Pi/PiHob.h>
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// Config Block Header
> 
> +///
> 
> +typedef struct _CONFIG_BLOCK_HEADER {
> 
> +  EFI_HOB_GUID_TYPE GuidHob;                      ///< Offset 0-23  GUID
> extension HOB header
> 
> +  UINT8             Revision;                     ///< Offset 24    Revision of this config
> block
> 
> +  UINT8             Attributes;                   ///< Offset 25    The main revision for
> config block
> 
> +  UINT8             Reserved[2];                  ///< Offset 26-27 Reserved for future
> use
> 
> +} CONFIG_BLOCK_HEADER;
> 
> +
> 
> +///
> 
> +/// Config Block
> 
> +///
> 
> +typedef struct _CONFIG_BLOCK {
> 
> +  CONFIG_BLOCK_HEADER            Header;          ///< Offset 0-27  Header of
> config block
> 
> +  //
> 
> +  // Config Block Data
> 
> +  //
> 
> +} CONFIG_BLOCK;
> 
> +
> 
> +///
> 
> +/// Config Block Table Header
> 
> +///
> 
> +typedef struct _CONFIG_BLOCK_TABLE_STRUCT {
> 
> +  CONFIG_BLOCK_HEADER            Header;          ///< Offset 0-27  GUID
> number for main entry of config block
> 
> +  UINT8                          Rsvd0[2];        ///< Offset 28-29 Reserved for future use
> 
> +  UINT16                         NumberOfBlocks;  ///< Offset 30-31 Number of config
> blocks (N)
> 
> +  UINT32                         AvailableSize;   ///< Offset 32-35 Current config block
> table size
> 
> +///
> 
> +/// Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +///
> 
> +} CONFIG_BLOCK_TABLE_HEADER;
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CONFIG_BLOCK_H_
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h
> new file mode 100644
> index 0000000000..23a408e8dc
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/CpuPcieHob.h
> @@ -0,0 +1,38 @@
> +/** @file
> 
> +  The GUID definition for CpuPcieHob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PCIE_HOB_H_
> 
> +#define _CPU_PCIE_HOB_H_
> 
> +
> 
> +#include <Base.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <CpuPcieConfig.h>
> 
> +
> 
> +extern EFI_GUID gCpuPcieHobGuid;
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The CPU_PCIE_HOB block describes the expected configuration of the
> CpuPcie controllers
> 
> +**/
> 
> +typedef struct {
> 
> +  ///
> 
> +  /// These members describe the configuration of each CPU PCIe root port.
> 
> +  ///
> 
> +  EFI_HOB_GUID_TYPE           EfiHobGuidType;                           ///< Offset 0 - 23:
> GUID Hob type structure for gCpuPcieHobGuid
> 
> +  CPU_PCIE_ROOT_PORT_CONFIG
> RootPort[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +  UINT8                       L1SubStates[CPU_PCIE_MAX_ROOT_PORTS];  ///< The
> L1 Substates configuration of the root port
> 
> +
> 
> +  UINT32                      DekelFwVersionMinor;                      ///< Dekel Firmware
> Minor Version
> 
> +  UINT32                      DekelFwVersionMajor;                      ///< Dekel Firmware
> Major Version
> 
> +  BOOLEAN                     InitPcieAspmAfterOprom;                   ///< 1=initialize
> PCIe ASPM after Oprom; 0=before (This will be set basing on policy)
> 
> +  UINT32                      RpEnabledMask;                            ///< Rootport enabled
> mask based on DEVEN register
> 
> +  UINT32                      RpEnMaskFromDevEn;                        ///< Rootport
> enabled mask based on Device Id
> 
> +  UINT8                       DisableClkReqMsg[CPU_PCIE_MAX_ROOT_PORTS];
> ///< 1=ClkReqMsg disabled, 0=ClkReqMsg enabled
> 
> +  UINT8                       SlotSelection;                            ///< 1=M2 slot, 0=CEMx4 slot
> 
> +  BOOLEAN                     ComplianceTest;                           ///< Compliance Test
> based on policy
> 
> +} CPU_PCIE_HOB;
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h
> new file mode 100644
> index 0000000000..5b058c7a45
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/DmaRemappingTable.h
> @@ -0,0 +1,75 @@
> +/** @file
> 
> +  This code defines ACPI DMA Remapping table related definitions.
> 
> +  See the System Agent BIOS specification for definition of the table.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DMA_REMAPPING_TABLE_H_
> 
> +#define _DMA_REMAPPING_TABLE_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Base.h>
> 
> +#include <IndustryStandard/DmaRemappingReportingTable.h>
> 
> +#include <IndustryStandard/Acpi.h>
> 
> +#include <TcssInfo.h>
> 
> +
> 
> +#pragma pack(1)
> 
> +///
> 
> +/// DMAR table signature
> 
> +///
> 
> +#define EFI_ACPI_VTD_DMAR_TABLE_SIGNATURE   0x52414D44  ///<
> "DMAR"
> 
> +#define EFI_ACPI_DMAR_TABLE_REVISION        2
> 
> +#define EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH  0x10
> 
> +#define EFI_ACPI_RMRR_HEADER_LENGTH         0x18
> 
> +#define MAX_PCI_DEPTH                       5
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_DEVICE_SCOPE_STRUCTURE_HEADER
> DeviceScopeStructureHeader;
> 
> +  EFI_ACPI_DMAR_PCI_PATH                      PciPath;     // device, function
> 
> +} EFI_ACPI_DEV_SCOPE_STRUCTURE;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_DRHD_HEADER     DrhdHeader;
> 
> +  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];
> 
> +} EFI_ACPI_DRHD_ENGINE1_STRUCT;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_DRHD_HEADER     DrhdHeader;
> 
> +  //
> 
> +  // @todo use PCD
> 
> +  //
> 
> +  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[2];
> 
> +} EFI_ACPI_DRHD_ENGINE3_STRUCT;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
> 
> +  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[2];
> 
> +} EFI_ACPI_RMRR_USB_STRUC;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
> 
> +  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];    // IGD
> 
> +} EFI_ACPI_RMRR_IGD_STRUC;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_RMRR_HEADER     RmrrHeader;
> 
> +  EFI_ACPI_DEV_SCOPE_STRUCTURE  DeviceScope[1];    // IGD - DiSM
> 
> +} EFI_ACPI_RMRR_IGD_DISM_STRUC;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_ANDD_HEADER     AnddHeader;
> 
> +  UINT8                         AcpiObjectName[20];
> 
> +} EFI_ACPI_ANDD_STRUC;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_ACPI_DMAR_HEADER          DmarHeader;
> 
> +  EFI_ACPI_DRHD_ENGINE1_STRUCT  DrhdEngine1;
> 
> +  EFI_ACPI_DRHD_ENGINE3_STRUCT  DrhdEngine3;
> 
> +  EFI_ACPI_RMRR_IGD_STRUC       RmrrIgd;
> 
> +  EFI_ACPI_RMRR_IGD_DISM_STRUC  RmrrIgdDism;
> 
> +} EFI_ACPI_DMAR_TABLE;
> 
> +
> 
> +#pragma pack()
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h
> new file mode 100644
> index 0000000000..edb3855b68
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/DxeHdaNhlt.h
> @@ -0,0 +1,138 @@
> +/** @file
> 
> +  Header file for DxePchHdaNhltLib - NHLT structure definitions.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _DXE_HDA_NHLT_H_
> 
> +#define _DXE_HDA_NHLT_H_
> 
> +
> 
> +#include <IndustryStandard/Acpi.h>
> 
> +
> 
> +//
> 
> +// ACPI support protocol instance signature definition.
> 
> +//
> 
> +#define NHLT_ACPI_TABLE_SIGNATURE  SIGNATURE_32 ('N', 'H', 'L', 'T')
> 
> +
> 
> +// MSFT defined structures
> 
> +#define SPEAKER_FRONT_LEFT      0x1
> 
> +#define SPEAKER_FRONT_RIGHT     0x2
> 
> +#define SPEAKER_FRONT_CENTER    0x4
> 
> +#define SPEAKER_BACK_LEFT       0x10
> 
> +#define SPEAKER_BACK_RIGHT      0x20
> 
> +
> 
> +#define KSAUDIO_SPEAKER_MONO   (SPEAKER_FRONT_CENTER)
> 
> +#define KSAUDIO_SPEAKER_STEREO (SPEAKER_FRONT_LEFT |
> SPEAKER_FRONT_RIGHT)
> 
> +#define KSAUDIO_SPEAKER_QUAD   (SPEAKER_FRONT_LEFT |
> SPEAKER_FRONT_RIGHT | SPEAKER_BACK_LEFT | SPEAKER_BACK_RIGHT)
> 
> +
> 
> +#define WAVE_FORMAT_EXTENSIBLE    0xFFFE /* Microsoft */
> 
> +#define KSDATAFORMAT_SUBTYPE_PCM \
> 
> +        {0x00000001, 0x0000, 0x0010, {0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b,
> 0x71}}
> 
> +
> 
> +#pragma pack (push, 1)
> 
> +
> 
> +typedef struct {
> 
> +  UINT16  wFormatTag;
> 
> +  UINT16  nChannels;
> 
> +  UINT32  nSamplesPerSec;
> 
> +  UINT32  nAvgBytesPerSec;
> 
> +  UINT16  nBlockAlign;
> 
> +  UINT16  wBitsPerSample;
> 
> +  UINT16  cbSize;
> 
> +} WAVEFORMATEX;
> 
> +
> 
> +typedef struct {
> 
> +  WAVEFORMATEX Format;
> 
> +  union {
> 
> +    UINT16 wValidBitsPerSample;
> 
> +    UINT16 wSamplesPerBlock;
> 
> +    UINT16 wReserved;
> 
> +  } Samples;
> 
> +  UINT32       dwChannelMask;
> 
> +  GUID         SubFormat;
> 
> +} WAVEFORMATEXTENSIBLE;
> 
> +
> 
> +//
> 
> +// List of supported link type.
> 
> +//
> 
> +enum NHLT_LINK_TYPE
> 
> +{
> 
> +  HdaNhltLinkHd   = 0,
> 
> +  HdaNhltLinkDsp  = 1,
> 
> +  HdaNhltLinkDmic = 2,
> 
> +  HdaNhltLinkSsp  = 3,
> 
> +  HdaNhltLinkInvalid
> 
> +};
> 
> +
> 
> +//
> 
> +// List of supported device type.
> 
> +//
> 
> +enum NHLT_SSP_DEVICE_TYPE
> 
> +{
> 
> +  HdaNhltSspDeviceBt   = 0,
> 
> +  HdaNhltSspDeviceI2s  = 4,
> 
> +  HdaNhltSspDeviceInvalid
> 
> +};
> 
> +
> 
> +enum NHLT_PDM_DEVICE_TYPE
> 
> +{
> 
> +  HdaNhltPdmDeviceDmic = 0,
> 
> +  HdaNhltPdmDeviceInvalid
> 
> +};
> 
> +
> 
> +typedef struct {
> 
> +  UINT32    CapabilitiesSize;
> 
> +  UINT8     Capabilities[1];
> 
> +} SPECIFIC_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  WAVEFORMATEXTENSIBLE Format;
> 
> +  SPECIFIC_CONFIG      FormatConfiguration;
> 
> +} FORMAT_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8           FormatsCount;
> 
> +  FORMAT_CONFIG   FormatsConfiguration[1];
> 
> +} FORMATS_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8           DeviceId[16];
> 
> +  UINT8           DeviceInstanceId;
> 
> +  UINT8           DevicePortId;
> 
> +} DEVICE_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8           DeviceInfoCount;
> 
> +  DEVICE_INFO     DeviceInformation[1];
> 
> +} DEVICES_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32          EndpointDescriptorLength;
> 
> +  UINT8           LinkType;
> 
> +  UINT8           InstanceId;
> 
> +  UINT16          HwVendorId;
> 
> +  UINT16          HwDeviceId;
> 
> +  UINT16          HwRevisionId;
> 
> +  UINT32          HwSubsystemId;
> 
> +  UINT8           DeviceType;
> 
> +  UINT8           Direction;
> 
> +  UINT8           VirtualBusId;
> 
> +  SPECIFIC_CONFIG EndpointConfig;
> 
> +  FORMATS_CONFIG  FormatsConfig;
> 
> +  DEVICES_INFO    DevicesInformation;
> 
> +} ENDPOINT_DESCRIPTOR;
> 
> +
> 
> +//
> 
> +// High Level Table structure
> 
> +//
> 
> +typedef struct {
> 
> +  EFI_ACPI_DESCRIPTION_HEADER Header; //{'N', 'H', 'L', 'T'}
> 
> +  UINT8                       EndpointCount;   // Actual number of endpoints
> 
> +  ENDPOINT_DESCRIPTOR         EndpointDescriptors[1];
> 
> +  SPECIFIC_CONFIG             OedConfiguration;
> 
> +} NHLT_ACPI_TABLE;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _DXE_PCH_HDA_NHLT_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h
> new file mode 100644
> index 0000000000..ab3f2c9cd0
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Hda.h
> @@ -0,0 +1,57 @@
> +/** @file
> 
> +  Header file for HD Audio configuration.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _HDA_H_
> 
> +#define _HDA_H_
> 
> +
> 
> +typedef enum {
> 
> +  HdaVc0 = 0,
> 
> +  HdaVc1 = 1
> 
> +} HDAUDIO_VC_TYPE;
> 
> +
> 
> +typedef enum {
> 
> +  HdaDmicDisabled = 0,
> 
> +  HdaDmic2chArray = 1,
> 
> +  HdaDmic4chArray = 2,
> 
> +  HdaDmic1chArray = 3
> 
> +} HDAUDIO_DMIC_TYPE;
> 
> +
> 
> +typedef enum {
> 
> +  HdaLinkFreq6MHz  = 0,
> 
> +  HdaLinkFreq12MHz = 1,
> 
> +  HdaLinkFreq24MHz = 2,
> 
> +  HdaLinkFreq48MHz = 3,
> 
> +  HdaLinkFreq96MHz = 4,
> 
> +  HdaLinkFreqInvalid
> 
> +} HDAUDIO_LINK_FREQUENCY;
> 
> +
> 
> +typedef enum  {
> 
> +  HdaIDispMode2T  = 0,
> 
> +  HdaIDispMode1T  = 1,
> 
> +  HdaIDispMode4T  = 2,
> 
> +  HdaIDispMode8T  = 3,
> 
> +  HdaIDispMode16T = 4,
> 
> +  HdaIDispTModeInvalid
> 
> +} HDAUDIO_IDISP_TMODE;
> 
> +
> 
> +typedef enum {
> 
> +  HdaLink      = 0,
> 
> +  HdaIDispLink = 1,
> 
> +  HdaDmic      = 2,
> 
> +  HdaSsp       = 3,
> 
> +  HdaSndw      = 4,
> 
> +  HdaLinkUnsupported
> 
> +} HDAUDIO_LINK_TYPE;
> 
> +
> 
> +typedef enum {
> 
> +  HdaDmicClockSelectBoth = 0,
> 
> +  HdaDmicClockSelectClkA = 1,
> 
> +  HdaDmicClockSelectClkB = 2,
> 
> +  HdaDmicClockSelectInvalid
> 
> +} HDAUDIO_DMIC_CLOCK_SELECT;
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h
> new file mode 100644
> index 0000000000..023ba12daa
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/MePolicyCommon.h
> @@ -0,0 +1,24 @@
> +/** @file
> 
> +  Definition for ME common policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _ME_POLICY_COMMON_H_
> 
> +#define _ME_POLICY_COMMON_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#include <MePeiConfig.h>
> 
> +
> 
> +#ifndef PLATFORM_POR
> 
> +#define PLATFORM_POR  0
> 
> +#endif
> 
> +#ifndef FORCE_ENABLE
> 
> +#define FORCE_ENABLE  1
> 
> +#endif
> 
> +#ifndef FORCE_DISABLE
> 
> +#define FORCE_DISABLE 2
> 
> +#endif
> 
> +
> 
> +#endif // _ME_POLICY_COMMON_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h
> new file mode 100644
> index 0000000000..d98019d1b4
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/PcieRegs.h
> @@ -0,0 +1,155 @@
> +/** @file
> 
> +  Register names for PCIE standard register
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Prefixes:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register sizes
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCIE_REGS_H_
> 
> +#define _PCIE_REGS_H_
> 
> +
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +
> 
> +//
> 
> +// PCI type 0 Header
> 
> +//
> 
> +#define R_PCI_BCC_OFFSET                          0x0B
> 
> +
> 
> +//
> 
> +// PCI type 1 Header
> 
> +//
> 
> +#define R_PCI_BRIDGE_BNUM                         0x18 ///< Bus Number Register
> 
> +#define B_PCI_BRIDGE_BNUM_SBBN                    0x00FF0000 ///<
> Subordinate Bus Number
> 
> +#define B_PCI_BRIDGE_BNUM_SCBN                    0x0000FF00 ///< Secondary
> Bus Number
> 
> +
> 
> +//
> 
> +// PCI Express Capability List Register (CAPID:10h)
> 
> +//
> 
> +#define R_PCIE_XCAP_OFFSET                        0x02 ///< PCI Express Capabilities
> Register (Offset 02h)
> 
> +#define B_PCIE_XCAP_DT                            (BIT7 | BIT6 | BIT5 | BIT4) ///<
> Device/Port Type
> 
> +#define N_PCIE_XCAP_DT                            4
> 
> +
> 
> +#define R_PCIE_DCAP_OFFSET                        0x04 ///< Device Capabilities
> Register (Offset 04h)
> 
> +#define B_PCIE_DCAP_RBER                          BIT15 ///< Role-Based Error
> Reporting
> 
> +#define B_PCIE_DCAP_E1AL                          (BIT11 | BIT10 | BIT9) ///<
> Endpoint L1 Acceptable Latency
> 
> +#define N_PCIE_DCAP_E1AL                          9
> 
> +#define B_PCIE_DCAP_E0AL                          (BIT8 | BIT7 | BIT6) ///< Endpoint
> L0s Acceptable Latency
> 
> +#define N_PCIE_DCAP_E0AL                          6
> 
> +#define B_PCIE_DCAP_MPS                           (BIT2 | BIT1 | BIT0) ///<
> Max_Payload_Size Supported
> 
> +
> 
> +#define R_PCIE_DCTL_OFFSET                        0x08 ///< Device Control Register
> (Offset 08h)
> 
> +#define B_PCIE_DCTL_MPS                           (BIT7 | BIT6 | BIT5) ///<
> Max_Payload_Size
> 
> +#define N_PCIE_DCTL_MPS                           5
> 
> +
> 
> +#define R_PCIE_LCAP_OFFSET                        0x0C ///< Link Capabilities
> Register (Offset 0Ch)
> 
> +#define B_PCIE_LCAP_CPM                           BIT18 ///< Clock Power
> Management
> 
> +#define B_PCIE_LCAP_EL1                           (BIT17 | BIT16 | BIT15) ///< L1 Exit
> Latency
> 
> +#define N_PCIE_LCAP_EL1                           15
> 
> +#define B_PCIE_LCAP_EL0                           (BIT14 | BIT13 | BIT12) ///< L0s Exit
> Latency
> 
> +#define N_PCIE_LCAP_EL0                           12
> 
> +#define B_PCIE_LCAP_APMS_L0S                      BIT10
> 
> +#define B_PCIE_LCAP_APMS_L1                       BIT11
> 
> +#define B_PCIE_LCAP_MLS                           (BIT3 | BIT2 | BIT1 | BIT0) ///< Max
> Link Speed
> 
> +#define V_PCIE_LCAP_MLS_GEN3                      3
> 
> +#define V_PCIE_LCAP_MLS_GEN4                      4
> 
> +
> 
> +#define R_PCIE_LCTL_OFFSET                        0x10 ///< Link Control Register
> (Offset 10h)
> 
> +#define B_PCIE_LCTL_ECPM                          BIT8 ///< Enable Clock Power
> Management
> 
> +#define B_PCIE_LCTL_CCC                           BIT6 ///< Common Clock
> Configuration
> 
> +#define B_PCIE_LCTL_RL                            BIT5 ///< Retrain Link
> 
> +#define B_PCIE_LCTL_ASPM                          (BIT1 | BIT0) ///< Active State
> Power Management (ASPM) Control
> 
> +#define V_PCIE_LCTL_ASPM_L0S                      1
> 
> +#define V_PCIE_LCTL_ASPM_L1                       2
> 
> +#define V_PCIE_LCTL_ASPM_L0S_L1                   3
> 
> +
> 
> +#define R_PCIE_LSTS_OFFSET                        0x12 ///< Link Status Register
> (Offset 12h)
> 
> +#define B_PCIE_LSTS_LA                            BIT13 ///< Data Link Layer Link Active
> 
> +#define B_PCIE_LSTS_SCC                           BIT12 ///< Slot Clock Configuration
> 
> +#define B_PCIE_LSTS_LT                            BIT11 ///< Link Training
> 
> +#define B_PCIE_LSTS_NLW                           0x03F0 ///< Negotiated Link Width
> 
> +#define N_PCIE_LSTS_NLW                           4
> 
> +#define B_PCIE_LSTS_CLS                           0x000F ///< Current Link Speed
> 
> +
> 
> +#define R_PCIE_SLCAP_OFFSET                       0x14 ///< Slot Capabilities
> Register (Offset 14h)
> 
> +#define B_PCIE_SLCAP_HPC                          BIT6       ///< Hot-Plug Capable
> 
> +
> 
> +#define R_PCIE_SLSTS_OFFSET                       0x1A ///< Slot Status Register
> (Offset 1Ah)
> 
> +#define B_PCIE_SLSTS_PDS                          BIT6 ///< Presence Detect State
> 
> +
> 
> +#define R_PCIE_DCAP2_OFFSET                       0x24 ///< Device Capabilities 2
> Register (Offset 24h)
> 
> +#define B_PCIE_DCAP2_LTRMS                        BIT11 ///< LTR Mechanism
> Supported
> 
> +
> 
> +#define R_PCIE_DCTL2_OFFSET                       0x28 ///< Device Control 2
> Register (Offset 28h)
> 
> +#define B_PCIE_DCTL2_LTREN                        BIT10 ///< LTR Mechanism Enable
> 
> +
> 
> +#define B_PCIE_LCTL2_TLS                          (BIT3 | BIT2 | BIT1 | BIT0) ///<
> Target Link Speed
> 
> +
> 
> +//
> 
> +// Latency Tolerance Reporting Extended Capability Registers (CAPID:0018h)
> 
> +//
> 
> +#define R_PCIE_LTRECH_CID                         0x0018
> 
> +
> 
> +#define R_PCIE_LTRECH_MSLR_OFFSET                 0x04
> 
> +#define N_PCIE_LTRECH_MSLR_VALUE                  0
> 
> +#define N_PCIE_LTRECH_MSLR_SCALE                  10
> 
> +
> 
> +#define R_PCIE_LTRECH_MNSLR_OFFSET                0x06
> 
> +#define N_PCIE_LTRECH_MNSLR_VALUE                 0
> 
> +#define N_PCIE_LTRECH_MNSLR_SCALE                 10
> 
> +
> 
> +//
> 
> +// Secondary PCI Express Extended Capability Header (CAPID:0019h)
> 
> +//
> 
> +#define R_PCIE_EX_LCTL3_OFFSET                    0x04 ///< Link Control 3
> Register
> 
> +#define B_PCIE_EX_LCTL3_PE                        BIT0 ///< Perform Equalization
> 
> +
> 
> +//
> 
> +// L1 Sub-States Extended Capability Register (CAPID:001Eh)
> 
> +//
> 
> +#define V_PCIE_EX_L1S_CID                        0x001E ///< Capability ID
> 
> +#define R_PCIE_EX_L1SCAP_OFFSET                  0x04 ///< L1 Sub-States
> Capabilities
> 
> +#define B_PCIE_EX_L1SCAP_PTV                     0x00F80000 //< Port Tpower_on
> value
> 
> +#define N_PCIE_EX_L1SCAP_PTV                     19
> 
> +#define B_PCIE_EX_L1SCAP_PTPOS                   0x00030000 //< Port
> Tpower_on scale
> 
> +#define N_PCIE_EX_L1SCAP_PTPOS                   16
> 
> +#define B_PCIE_EX_L1SCAP_CMRT                    0x0000FF00 //< Common
> Mode Restore time
> 
> +#define N_PCIE_EX_L1SCAP_CMRT                    8
> 
> +#define B_PCIE_EX_L1SCAP_L1PSS                   BIT4 ///< L1 PM substates
> supported
> 
> +#define B_PCIE_EX_L1SCAP_AL1SS                   BIT3 ///< ASPM L1.1 supported
> 
> +#define B_PCIE_EX_L1SCAP_AL12S                   BIT2 ///< ASPM L1.2 supported
> 
> +#define B_PCIE_EX_L1SCAP_PPL11S                  BIT1 ///< PCI-PM L1.1
> supported
> 
> +#define B_PCIE_EX_L1SCAP_PPL12S                  BIT0 ///< PCI-PM L1.2
> supported
> 
> +#define R_PCIE_EX_L1SCTL1_OFFSET                 0x08 ///< L1 Sub-States
> Control 1
> 
> +#define B_PCIE_EX_L1SCTL1_L1SSEIE                BIT4
> 
> +#define N_PCIE_EX_L1SCTL1_L12LTRTLSV             29
> 
> +#define N_PCIE_EX_L1SCTL1_L12LTRTLV              16
> 
> +#define R_PCIE_EX_L1SCTL2_OFFSET                 0x0C ///< L1 Sub-States
> Control 2
> 
> +#define N_PCIE_EX_L1SCTL2_POWT                   3
> 
> +
> 
> +//
> 
> +// PTM Extended Capability Register (CAPID:001Fh)
> 
> +//
> 
> +#define V_PCIE_EX_PTM_CID                         0x001F ///< Capability ID
> 
> +#define R_PCIE_EX_PTMCAP_OFFSET                   0x04 ///< PTM Capabilities
> 
> +#define R_PCIE_EX_PTMCTL_OFFSET                   0x08 ///< PTM Control
> Register
> 
> +
> 
> +//
> 
> +// Base Address Offset
> 
> +//
> 
> +#define B_PCI_BAR_MEMORY_TYPE_MASK                (BIT1 | BIT2)
> 
> +#define B_PCI_BAR_MEMORY_TYPE_64                  BIT2
> 
> +
> 
> +//
> 
> +// PCI Express Extended Capability Header
> 
> +//
> 
> +#define R_PCIE_CFG_EXCAP_OFFSET                   0x100
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h
> new file mode 100644
> index 0000000000..ef94790985
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Pins/GpioPinsVer2Lp.h
> @@ -0,0 +1,110 @@
> +/** @file
> 
> +  GPIO pins for TGL-PCH-LP,
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_PINS_VER2_LP_H_
> 
> +#define _GPIO_PINS_VER2_LP_H_
> 
> +///
> 
> +/// This header file should be used together with
> 
> +/// PCH GPIO lib in C and ASL. All defines used
> 
> +/// must match both ASL/C syntax
> 
> +///
> 
> +
> 
> +///
> 
> +/// Unique ID used in GpioPad defines
> 
> +///
> 
> +#define GPIO_VER2_LP_CHIPSET_ID     0x9
> 
> +
> 
> +///
> 
> +/// TGL LP GPIO Groups
> 
> +/// Use below for functions from PCH GPIO Lib which
> 
> +/// require GpioGroup as argument
> 
> +///
> 
> +#define GPIO_VER2_LP_GROUP_GPP_B    0x0900
> 
> +#define GPIO_VER2_LP_GROUP_GPP_A    0x0902
> 
> +#define GPIO_VER2_LP_GROUP_GPP_R    0x0903
> 
> +#define GPIO_VER2_LP_GROUP_GPD      0x0905
> 
> +#define GPIO_VER2_LP_GROUP_GPP_S    0x0906
> 
> +#define GPIO_VER2_LP_GROUP_GPP_H    0x0907
> 
> +#define GPIO_VER2_LP_GROUP_GPP_D    0x0908
> 
> +#define GPIO_VER2_LP_GROUP_GPP_C    0x090B
> 
> +#define GPIO_VER2_LP_GROUP_GPP_F    0x090C
> 
> +#define GPIO_VER2_LP_GROUP_GPP_E    0x090E
> 
> +
> 
> +
> 
> +///
> 
> +/// TGL LP GPIO pins
> 
> +/// Use below for functions from PCH GPIO Lib which
> 
> +/// require GpioPad as argument. Encoding used here
> 
> +/// has all information required by library functions
> 
> +///
> 
> +#define GPIO_VER2_LP_GPP_B2                  0x09000002
> 
> +#define GPIO_VER2_LP_GPP_B4                  0x09000004
> 
> +#define GPIO_VER2_LP_GPP_B14                 0x0900000E
> 
> +#define GPIO_VER2_LP_GPP_B15                 0x0900000F
> 
> +#define GPIO_VER2_LP_GPP_B16                 0x09000010
> 
> +#define GPIO_VER2_LP_GPP_B18                 0x09000012
> 
> +#define GPIO_VER2_LP_GPP_B23                 0x09000017
> 
> +#define GPIO_VER2_LP_GSPI0_CLK_LOOPBK        0x09000018
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_A10                 0x0902000A
> 
> +#define GPIO_VER2_LP_GPP_A11                 0x0902000B
> 
> +#define GPIO_VER2_LP_GPP_A13                 0x0902000D
> 
> +#define GPIO_VER2_LP_GPP_A14                 0x0902000E
> 
> +#define GPIO_VER2_LP_GPP_A23                 0x09020017
> 
> +#define GPIO_VER2_LP_ESPI_CLK_LOOPBK         0x09020018
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_R5                  0x09030005
> 
> +#define GPIO_VER2_LP_GPP_R6                  0x09030006
> 
> +
> 
> +#define GPIO_VER2_LP_GPD7                    0x09050007
> 
> +
> 
> +#define GPIO_VER2_LP_INPUT3VSEL              0x0905000C
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_H0                  0x09070000
> 
> +#define GPIO_VER2_LP_GPP_H1                  0x09070001
> 
> +#define GPIO_VER2_LP_GPP_H12                 0x0907000C
> 
> +#define GPIO_VER2_LP_GPP_H13                 0x0907000D
> 
> +#define GPIO_VER2_LP_GPP_H15                 0x0907000F
> 
> +#define GPIO_VER2_LP_GPP_H19                 0x09070013
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_D16                 0x09080010
> 
> +#define GPIO_VER2_LP_GSPI2_CLK_LOOPBK        0x09080014
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_C2                  0x090B0002
> 
> +#define GPIO_VER2_LP_GPP_C5                  0x090B0005
> 
> +#define GPIO_VER2_LP_GPP_C8                  0x090B0008
> 
> +#define GPIO_VER2_LP_GPP_C12                 0x090B000C
> 
> +#define GPIO_VER2_LP_GPP_C13                 0x090B000D
> 
> +#define GPIO_VER2_LP_GPP_C14                 0x090B000E
> 
> +#define GPIO_VER2_LP_GPP_C15                 0x090B000F
> 
> +#define GPIO_VER2_LP_GPP_C22                 0x090B0016
> 
> +#define GPIO_VER2_LP_GPP_C23                 0x090B0017
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_F4                  0x090C0004
> 
> +#define GPIO_VER2_LP_GPP_F5                  0x090C0005
> 
> +#define GPIO_VER2_LP_GPP_F9                  0x090C0009
> 
> +#define GPIO_VER2_LP_GPP_F10                 0x090C000A
> 
> +#define GPIO_VER2_LP_GPP_F20                 0x090C0014
> 
> +#define GPIO_VER2_LP_GPP_F21                 0x090C0015
> 
> +#define GPIO_VER2_LP_GPPF_CLK_LOOPBK         0x090C0018
> 
> +
> 
> +#define GPIO_VER2_LP_GPP_E3                  0x090E0003
> 
> +#define GPIO_VER2_LP_GPP_E7                  0x090E0007
> 
> +#define GPIO_VER2_LP_GPP_E8                  0x090E0008
> 
> +#define GPIO_VER2_LP_GPP_E22                 0x090E0016
> 
> +#define GPIO_VER2_LP_GPP_E23                 0x090E0017
> 
> +#define GPIO_VER2_LP_GPPE_CLK_LOOPBK         0x090E0018
> 
> +
> 
> +//
> 
> +// GPIO Pin Muxing
> 
> +// Determines a selection of physical pad for a given signal.
> 
> +// Please refer to GPIO_NATIVE_PAD type.
> 
> +// If certain signal is not listed below it means that it can be enabled
> 
> +// only on a single pad and muxing setting is not needed.
> 
> +//
> 
> +#define GPIO_VER2_LP_MUXING_SERIALIO_I2C4_SDA_GPP_H8
> 0x1947CC08
> 
> +#define GPIO_VER2_LP_MUXING_SERIALIO_I2C4_SCL_GPP_H9
> 0x1947AC09
> 
> +#endif // _GPIO_PINS_VER2_LP_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h
> new file mode 100644
> index 0000000000..215fd0407e
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/FlashRegs.h
> @@ -0,0 +1,72 @@
> +/** @file
> 
> +  Register names for Flash registers
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _FLASH_REGS_H_
> 
> +#define _FLASH_REGS_H_
> 
> +
> 
> +//
> 
> +// Flash Descriptor Base Address Region (FDBAR) from Flash Region 0
> 
> +//
> 
> +#define R_FLASH_FDBAR_FLASH_MAP0          0x04
> 
> +#define B_FLASH_FDBAR_NC                  0x00000300                    ///< Number Of
> Components
> 
> +#define N_FLASH_FDBAR_NC                  8                             ///< Number Of
> Components
> 
> +#define R_FLASH_FDBAR_FLASH_MAP1          0x08
> 
> +#define B_FLASH_FDBAR_FPSBA               0x00FF0000                    ///< PCH
> Strap Base Address, [23:16] represents [11:4]
> 
> +#define N_FLASH_FDBAR_FPSBA               16                            ///< PCH Strap
> base Address bit position
> 
> +#define N_FLASH_FDBAR_FPSBA_REPR          4                             ///< PCH Strap
> base Address bit represents position
> 
> +#define B_FLASH_FDBAR_PCHSL               0xFF000000                    ///< PCH
> Strap Length, [31:24] represents number of Dwords
> 
> +#define N_FLASH_FDBAR_PCHSL               24                            ///< PCH Strap
> Length bit position
> 
> +#define R_FLASH_FDBAR_FLASH_MAP2          0x0C
> 
> +#define B_FLASH_FDBAR_FCPUSBA             0x00000FFC                    ///< CPU
> Strap Base Address [11:2]
> 
> +#define N_FLASH_FDBAR_FCPUSBA             2                             ///< CPU Strap
> Base Address bit position
> 
> +#define B_FLASH_FDBAR_CPUSL               0x00FF0000                    ///< CPU
> Strap Length, [23:16] represents number of Dwords
> 
> +#define N_FLASH_FDBAR_CPUSL               16                            ///< CPU Strap
> Length bit position
> 
> +
> 
> +//
> 
> +// Flash Component Base Address (FCBA) from Flash Region 0
> 
> +//
> 
> +#define R_FLASH_FCBA_FLCOMP               0x00                          ///< Flash
> Components Register
> 
> +#define B_FLASH_FLCOMP_COMP1_MASK         0xF0                          ///< Flash
> Component 1 Size MASK
> 
> +#define N_FLASH_FLCOMP_COMP1              4                             ///< Flash
> Component 1 Size bit position
> 
> +#define B_FLASH_FLCOMP_COMP0_MASK         0x0F                          ///< Flash
> Component 0 Size MASK
> 
> +#define V_FLASH_FLCOMP_COMP_512KB         0x80000
> 
> +//
> 
> +// Descriptor Upper Map Section from Flash Region 0
> 
> +//
> 
> +#define R_FLASH_UMAP1                     0xEFC                         ///< Flash Upper
> Map 1
> 
> +#define B_FLASH_UMAP1_MDTBA               0xFF000000                    ///< MIP
> Descriptor Table Base Address
> 
> +#define N_FLASH_UMAP1_MDTBA               24                            ///< MDTBA bits
> position
> 
> +#define N_FLASH_UMAP1_MDTBA_REPR          4                             ///< MDTBA
> address representation position
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h
> new file mode 100644
> index 0000000000..e4bf2018b7
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegs.h
> @@ -0,0 +1,121 @@
> +/** @file
> 
> +  Register names for PCH GPIO
> 
> +
> 
> +Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_REGS_H_
> 
> +#define _GPIO_REGS_H_
> 
> +
> 
> +//
> 
> +// PADCFG register is split into multiple DW registers
> 
> +// S_GPIO_PCR_PADCFG refers to number of bytes used by all those
> registers for one pad
> 
> +//
> 
> +#define S_GPIO_PCR_PADCFG               0x10
> 
> +
> 
> +//
> 
> +// Pad Configuration Register DW0
> 
> +//
> 
> +
> 
> +//Pad Reset Config
> 
> +#define B_GPIO_PCR_RST_CONF             (BIT31 | BIT30)
> 
> +#define N_GPIO_PCR_RST_CONF             30
> 
> +#define V_GPIO_PCR_RST_CONF_POW_GOOD    0x00
> 
> +#define V_GPIO_PCR_RST_CONF_DEEP_RST    0x01
> 
> +#define V_GPIO_PCR_RST_CONF_GPIO_RST    0x02
> 
> +#define V_GPIO_PCR_RST_CONF_RESUME_RST  0x03  // Only for GPD
> Group
> 
> +
> 
> +//RX Raw Override to 1
> 
> +#define B_GPIO_PCR_RX_RAW1              BIT28
> 
> +#define N_GPIO_PCR_RX_RAW1              28
> 
> +
> 
> +//RX Level/Edge Configuration
> 
> +#define B_GPIO_PCR_RX_LVL_EDG           (BIT26 | BIT25)
> 
> +#define N_GPIO_PCR_RX_LVL_EDG           25
> 
> +
> 
> +//RX Invert
> 
> +#define B_GPIO_PCR_RXINV                BIT23
> 
> +#define N_GPIO_PCR_RXINV                23
> 
> +
> 
> +//GPIO Input Route IOxAPIC
> 
> +#define B_GPIO_PCR_RX_APIC_ROUTE        BIT20
> 
> +
> 
> +//GPIO Input Route SCI
> 
> +#define B_GPIO_PCR_RX_SCI_ROUTE         BIT19
> 
> +
> 
> +//GPIO Input Route SMI
> 
> +#define B_GPIO_PCR_RX_SMI_ROUTE         BIT18
> 
> +
> 
> +//GPIO Input Route NMI
> 
> +#define B_GPIO_PCR_RX_NMI_ROUTE         BIT17
> 
> +#define N_GPIO_PCR_RX_NMI_ROUTE         17
> 
> +
> 
> +//GPIO Pad Mode
> 
> +#define B_GPIO_PCR_PAD_MODE             (BIT12 | BIT11 | BIT10)
> 
> +#define N_GPIO_PCR_PAD_MODE             10
> 
> +
> 
> +//GPIO RX Disable
> 
> +#define B_GPIO_PCR_RXDIS                BIT9
> 
> +
> 
> +//GPIO TX Disable
> 
> +#define B_GPIO_PCR_TXDIS                BIT8
> 
> +#define N_GPIO_PCR_TXDIS                8
> 
> +
> 
> +//GPIO RX State
> 
> +#define B_GPIO_PCR_RX_STATE             BIT1
> 
> +#define N_GPIO_PCR_RX_STATE             1
> 
> +
> 
> +//GPIO TX State
> 
> +#define B_GPIO_PCR_TX_STATE             BIT0
> 
> +#define N_GPIO_PCR_TX_STATE             0
> 
> +
> 
> +//Termination
> 
> +#define B_GPIO_PCR_TERM                (BIT13 | BIT12 | BIT11 | BIT10)
> 
> +#define N_GPIO_PCR_TERM                 10
> 
> +
> 
> +//Interrupt number
> 
> +#define B_GPIO_PCR_INTSEL               0x7F
> 
> +#define N_GPIO_PCR_INTSEL               0
> 
> +
> 
> +///
> 
> +/// GPIO SMI data used for EFI_SMM_GPI_DISPATCH2_PROTOCOL
> 
> +/// Below defines are to be used internally by PCH SMI dispatcher only
> 
> +///
> 
> +#define PCH_GPIO_NUM_SUPPORTED_GPIS       512
> 
> +#define S_GPIO_PCR_GP_SMI_STS               4
> 
> +
> 
> +///
> 
> +/// Groups mapped to 2-tier General Purpose Event will all be under
> 
> +/// one master GPE_111 (0x6F)
> 
> +///
> 
> +#define PCH_GPIO_2_TIER_MASTER_GPE_NUMBER  0x6F
> 
> +
> 
> +#endif // _GPIO_REGS_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h
> new file mode 100644
> index 0000000000..1dc05869dd
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/GpioRegsVer2.h
> @@ -0,0 +1,226 @@
> +/** @file
> 
> +  Register names for VER2 GPIO
> 
> +
> 
> +Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_REGS_VER2_H_
> 
> +#define _GPIO_REGS_VER2_H_
> 
> +
> 
> +//
> 
> +// PCH-LP GPIO
> 
> +//
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_B_PAD_MAX    26
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_A_PAD_MAX    25
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_R_PAD_MAX    8
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPD_PAD_MAX      17
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_S_PAD_MAX    8
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_H_PAD_MAX    24
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_D_PAD_MAX    21
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_F_PAD_MAX    25
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_C_PAD_MAX    24
> 
> +#define GPIO_VER2_PCH_LP_GPIO_GPP_E_PAD_MAX    25
> 
> +#define GPIO_VER2_PCH_LP_GPIO_CPU_PAD_MAX      15
> 
> +
> 
> +//
> 
> +// PCH-LP GPIO registers
> 
> +//
> 
> +
> 
> +//
> 
> +// GPIO Community 0 Private Configuration Registers
> 
> +//
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PAD_OWN        0x20
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PAD_OWN        0x38
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCK     0x80
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCKTX   0x84
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCK     0x90
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCKTX   0x94
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_HOSTSW_OWN     0xB0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_HOSTSW_OWN     0xB8
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IS         0x0100
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IS         0x0108
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IE         0x0120
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IE         0x0128
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_STS    0x0140
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_STS    0x0148
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_EN     0x0160
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_EN     0x0168
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_STS        0x0180
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_EN         0x01A0
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_STS        0x01C0
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_EN         0x01E0
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFG_OFFSET
> 0x700
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFG_OFFSET
> 0x9A0
> 
> +
> 
> +//
> 
> +// GPIO Community 1 Private Configuration Registers
> 
> +//
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PAD_OWN        0x20
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PAD_OWN        0x24
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PAD_OWN        0x30
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCK     0x80
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCKTX   0x84
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCK     0x88
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCKTX   0x8C
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCK     0x90
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCKTX   0x94
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_HOSTSW_OWN     0xB0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_HOSTSW_OWN     0xB4
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_HOSTSW_OWN     0xB8
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IS         0x0100
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IS         0x0104
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IS         0x0108
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IE         0x0120
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IE         0x0124
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IE         0x0128
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_STS    0x0140
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_STS    0x0144
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_STS    0x0148
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_EN     0x0160
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_EN     0x0164
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_EN     0x0168
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_STS        0x0188
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_EN         0x01A8
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_STS        0x01C8
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_EN         0x01E8
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFG_OFFSET
> 0x700
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFG_OFFSET
> 0x780
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFG_OFFSET
> 0x900
> 
> +
> 
> +//
> 
> +// GPIO Community 2 Private Configuration Registers
> 
> +//
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PAD_OWN          0x20
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCK       0x80
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCKTX     0x84
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_HOSTSW_OWN       0xB0
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IS           0x0100
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IE           0x0120
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_STS      0x0140
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_EN       0x0160
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFG_OFFSET    0x700
> 
> +
> 
> +//
> 
> +// GPIO Community 4 Private Configuration Registers
> 
> +//
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PAD_OWN        0x20
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PAD_OWN        0x2C
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PAD_OWN        0x40
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCK     0x80
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCKTX   0x84
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCK     0x88
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCKTX   0x8C
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCK     0x98
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCKTX   0x9C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_HOSTSW_OWN     0xB0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_HOSTSW_OWN     0xB4
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_HOSTSW_OWN     0xBC
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IS         0x0100
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IS         0x0104
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IS         0x010C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IE         0x0120
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IE         0x0124
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IE         0x012C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_STS    0x0140
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_STS    0x0144
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_STS    0x014C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_EN     0x0160
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_EN     0x0164
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_EN     0x016C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_STS        0x0180
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_STS        0x018C
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_EN         0x01A0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_EN         0x01AC
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_STS        0x01C0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_STS        0x01CC
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_EN         0x01E0
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_EN         0x01EC
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFG_OFFSET
> 0x700
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFG_OFFSET
> 0x880
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFG_OFFSET
> 0xA70
> 
> +
> 
> +//
> 
> +// GPIO Community 5 Private Configuration Registers
> 
> +//
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PAD_OWN        0x20
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCK     0x80
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCKTX   0x84
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_HOSTSW_OWN     0xB0
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IS         0x0100
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IE         0x0120
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_STS    0x0140
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_EN     0x0160
> 
> +
> 
> +#define R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFG_OFFSET
> 0x700
> 
> +
> 
> +#endif // _GPIO_REGS_VER2_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h
> new file mode 100644
> index 0000000000..5447fabccf
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmi14Regs.h
> @@ -0,0 +1,16 @@
> +/** @file
> 
> +  Register names for PCH DMI SIP14
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_DMI14_REGS_H_
> 
> +#define _PCH_DMI14_REGS_H_
> 
> +
> 
> +//
> 
> +// DMI Control
> 
> +//
> 
> +#define R_PCH_DMI14_PCR_DMIC                       0x2234                              ///<
> DMI Control
> 
> +#define B_PCH_DMI14_PCR_DMIC_SRL                   BIT31                               ///<
> Secured register lock
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h
> new file mode 100644
> index 0000000000..e9e6f80327
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchDmiRegs.h
> @@ -0,0 +1,36 @@
> +/** @file
> 
> +  Register names for PCH DMI and OP-DMI
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_DMI_REGS_H_
> 
> +#define _PCH_DMI_REGS_H_
> 
> +
> 
> +//
> 
> +// PCH DMI Chipset Configuration Registers (PID:DMI)
> 
> +//
> 
> +
> 
> +//
> 
> +// PCH DMI Source Decode PCRs (Common)
> 
> +//
> 
> +#define R_PCH_DMI_PCR_LPCLGIR1                   0x2730                       ///< LPC
> Generic I/O Range 1
> 
> +#define R_PCH_DMI_PCR_LPCGMR                     0x2740                       ///< LPC
> Generic Memory Range
> 
> +#define R_PCH_DMI_PCR_SEGIR                      0x27BC                       ///< Second
> ESPI Generic I/O Range
> 
> +#define R_PCH_DMI_PCR_SEGMR                      0x27C0                       ///<
> Second ESPI Generic Memory Range
> 
> +#define R_PCH_DMI_PCR_LPCBDE                     0x2744                       ///< LPC
> BIOS Decode Enable
> 
> +#define R_PCH_DMI_PCR_UCPR                       0x2748                       ///< uCode
> Patch Region
> 
> +#define B_PCH_DMI_PCR_UCPR_UPRE                  BIT0                         ///<
> uCode Patch Region Enable
> 
> +#define R_PCH_DMI_PCR_GCS                        0x274C                       ///< Generic
> Control and Status
> 
> +#define B_PCH_DMI_PCR_BBS                        BIT10                        ///< Boot BIOS
> Strap
> 
> +#define B_PCH_DMI_PCR_RPR                        BIT11                        ///< Reserved
> Page Route
> 
> +#define B_PCH_DMI_PCR_BILD                       BIT0                         ///< BIOS
> Interface Lock-Down
> 
> +#define R_PCH_DMI_PCR_IOT1                       0x2750                       ///< I/O Trap
> Register 1
> 
> +#define R_PCH_DMI_PCR_LPCIOD                     0x2770                       ///< LPC I/O
> Decode Ranges
> 
> +#define R_PCH_DMI_PCR_LPCIOE                     0x2774                       ///< LPC I/O
> Enables
> 
> +#define R_PCH_DMI_PCR_TCOBASE                    0x2778                       ///< TCO
> Base Address
> 
> +#define B_PCH_DMI_PCR_TCOBASE_TCOBA              0xFFE0                       ///<
> TCO Base Address Mask
> 
> +#define R_PCH_DMI_PCR_GPMR1                      0x277C                       ///<
> General Purpose Memory Range 1
> 
> +#define R_PCH_DMI_PCR_GPMR1DID                   0x2780                       ///<
> General Purpose Memory Range 1 Destination ID
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h
> new file mode 100644
> index 0000000000..c3497b1013
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PchPcieRpRegs.h
> @@ -0,0 +1,93 @@
> +/** @file
> 
> +  Register names for PCH PCI-E root port devices
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PCIE_H_
> 
> +#define _PCH_REGS_PCIE_H_
> 
> +
> 
> +#define R_PCH_PCIE_CFG_CLIST                          0x40
> 
> +#define R_PCH_PCIE_CFG_LCAP                           (R_PCH_PCIE_CFG_CLIST +
> R_PCIE_LCAP_OFFSET)
> 
> +#define N_PCH_PCIE_CFG_LCAP_PN                        24
> 
> +#define R_PCH_PCIE_CFG_LCTL                           (R_PCH_PCIE_CFG_CLIST +
> R_PCIE_LCTL_OFFSET)
> 
> +#define R_PCH_PCIE_CFG_LSTS                           (R_PCH_PCIE_CFG_CLIST +
> R_PCIE_LSTS_OFFSET)
> 
> +#define R_PCH_PCIE_CFG_SLCAP                          (R_PCH_PCIE_CFG_CLIST +
> R_PCIE_SLCAP_OFFSET)
> 
> +#define R_PCH_PCIE_CFG_SLSTS                          (R_PCH_PCIE_CFG_CLIST +
> R_PCIE_SLSTS_OFFSET)
> 
> +
> 
> +#define R_PCH_PCIE_CFG_MPC2                           0xD4
> 
> +#define B_PCH_PCIE_CFG_MPC2_EOIFD                     BIT1
> 
> +
> 
> +#define R_PCH_PCIE_CFG_MPC                            0xD8
> 
> +#define S_PCH_PCIE_CFG_MPC                            4
> 
> +#define B_PCH_PCIE_CFG_MPC_PMCE                       BIT31
> 
> +#define B_PCH_PCIE_CFG_MPC_HPME                       BIT1
> 
> +#define N_PCH_PCIE_CFG_MPC_HPME                       1
> 
> +
> 
> +#define R_PCH_PCIE_CFG_SMSCS                          0xDC
> 
> +#define S_PCH_PCIE_CFG_SMSCS                          4
> 
> +#define B_PCH_PCIE_CFG_SMSCS_PMCS                     BIT31
> 
> +#define N_PCH_PCIE_CFG_SMSCS_LERSMIS                  5
> 
> +#define N_PCH_PCIE_CFG_SMSCS_HPLAS                    4
> 
> +#define N_PCH_PCIE_CFG_SMSCS_HPPDM                    1
> 
> +
> 
> +//CES.RE, CES.BT, CES.BD
> 
> +
> 
> +#define R_PCH_PCIE_CFG_EX_SPEECH                      0xA30 ///< Secondary PCI
> Express Extended Capability Header
> 
> +#define R_PCH_PCIE_CFG_EX_LCTL3
> (R_PCH_PCIE_CFG_EX_SPEECH + R_PCIE_EX_LCTL3_OFFSET)
> 
> +
> 
> +#define R_PCH_PCIE_CFG_LTROVR                         0x400
> 
> +#define B_PCH_PCIE_CFG_LTROVR_LTRNSROVR               BIT31 ///< LTR Non-
> Snoop Requirement Bit Override
> 
> +#define B_PCH_PCIE_CFG_LTROVR_LTRSROVR                BIT15 ///< LTR
> Snoop Requirement Bit Override
> 
> +
> 
> +#define R_PCH_PCIE_CFG_LTROVR2                        0x404
> 
> +#define B_PCH_PCIE_CFG_LTROVR2_FORCE_OVERRIDE         BIT3 ///< LTR
> Force Override Enable
> 
> +#define B_PCH_PCIE_CFG_LTROVR2_LOCK                   BIT2 ///< LTR Override
> Lock
> 
> +#define B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN             BIT1 ///< LTR
> Non-Snoop Override Enable
> 
> +#define B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN              BIT0 ///< LTR
> Snoop Override Enable
> 
> +
> 
> +#define R_PCH_PCIE_CFG_PCIEPMECTL                     0x420
> 
> +#define B_PCH_PCIE_CFG_PCIEPMECTL_DLSULPPGE           BIT30
> 
> +#define B_PCH_PCIE_CFG_PCIEPMECTL_L1LE                BIT17
> 
> +#define B_PCH_PCIE_CFG_PCIEPMECTL_L1FSOE              BIT0
> 
> +
> 
> +#define R_PCH_PCIE_CFG_EQCFG1                         0x450
> 
> +#define S_PCH_PCIE_CFG_EQCFG1                         4
> 
> +#define N_PCH_PCIE_CFG_EQCFG1_LERSMIE                 21
> 
> +
> 
> +//
> 
> +// PCIE PCRs (PID:SPA SPB SPC SPD SPE SPF)
> 
> +//
> 
> +#define R_SPX_PCR_PCD                         0                       ///< Port configuration
> and disable
> 
> +#define B_SPX_PCR_PCD_RP1FN                   (BIT2 | BIT1 | BIT0)    ///< Port 1
> Function Number
> 
> +#define S_SPX_PCR_PCD_RP_FIELD                4                       ///< 4 bits for each
> RP FN
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h
> new file mode 100644
> index 0000000000..fac1497773
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/PmcRegs.h
> @@ -0,0 +1,258 @@
> +/** @file
> 
> +  Register names for PCH PMC device
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PMC_H_
> 
> +#define _PCH_REGS_PMC_H_
> 
> +
> 
> +//
> 
> +// ACPI and legacy I/O register offsets from ACPIBASE
> 
> +//
> 
> +#define R_ACPI_IO_PM1_STS                        0x00
> 
> +#define S_ACPI_IO_PM1_STS                        2
> 
> +#define B_ACPI_IO_PM1_STS_WAK                    BIT15
> 
> +#define B_ACPI_IO_PM1_STS_PCIEXP_WAKE_STS        BIT14
> 
> +#define B_ACPI_IO_PM1_STS_PRBTNOR                BIT11
> 
> +#define B_ACPI_IO_PM1_STS_RTC                    BIT10
> 
> +#define B_ACPI_IO_PM1_STS_PWRBTN                 BIT8
> 
> +#define B_ACPI_IO_PM1_STS_GBL                    BIT5
> 
> +#define B_ACPI_IO_PM1_STS_TMROF                  BIT0
> 
> +#define N_ACPI_IO_PM1_STS_RTC                    10
> 
> +#define N_ACPI_IO_PM1_STS_PWRBTN                 8
> 
> +#define N_ACPI_IO_PM1_STS_TMROF                  0
> 
> +
> 
> +#define R_ACPI_IO_PM1_EN                         0x02
> 
> +#define S_ACPI_IO_PM1_EN                         2
> 
> +#define B_ACPI_IO_PM1_EN_PWRBTN                  BIT8
> 
> +#define N_ACPI_IO_PM1_EN_RTC                     10
> 
> +#define N_ACPI_IO_PM1_EN_PWRBTN                  8
> 
> +#define N_ACPI_IO_PM1_EN_TMROF                   0
> 
> +
> 
> +#define R_ACPI_IO_PM1_CNT                        0x04
> 
> +#define B_ACPI_IO_PM1_CNT_SLP_EN                 BIT13
> 
> +#define B_ACPI_IO_PM1_CNT_SLP_TYP                (BIT12 | BIT11 | BIT10)
> 
> +#define V_ACPI_IO_PM1_CNT_S0                     0
> 
> +#define V_ACPI_IO_PM1_CNT_S1                     BIT10
> 
> +#define V_ACPI_IO_PM1_CNT_S3                     (BIT12 | BIT10)
> 
> +#define V_ACPI_IO_PM1_CNT_S4                     (BIT12 | BIT11)
> 
> +#define V_ACPI_IO_PM1_CNT_S5                     (BIT12 | BIT11 | BIT10)
> 
> +#define B_ACPI_IO_PM1_CNT_SCI_EN                 BIT0
> 
> +
> 
> +#define R_ACPI_IO_PM1_TMR                        0x08
> 
> +#define B_ACPI_IO_PM1_TMR_VAL                    0xFFFFFF
> 
> +#define V_ACPI_IO_PM1_TMR_MAX_VAL                0x1000000       ///< The
> timer is 24 bit overflow
> 
> +
> 
> +#define R_ACPI_IO_SMI_EN                              0x30
> 
> +#define S_ACPI_IO_SMI_EN                              4
> 
> +#define B_ACPI_IO_SMI_EN_LEGACY_USB2                  BIT17
> 
> +#define B_ACPI_IO_SMI_EN_TCO                          BIT13
> 
> +#define B_ACPI_IO_SMI_EN_BIOS_RLS                     BIT7
> 
> +#define B_ACPI_IO_SMI_EN_SWSMI_TMR                    BIT6
> 
> +#define B_ACPI_IO_SMI_EN_APMC                         BIT5
> 
> +#define B_ACPI_IO_SMI_EN_LEGACY_USB                   BIT3
> 
> +#define B_ACPI_IO_SMI_EN_BIOS                         BIT2
> 
> +#define B_ACPI_IO_SMI_EN_EOS                          BIT1
> 
> +#define B_ACPI_IO_SMI_EN_GBL_SMI                      BIT0
> 
> +#define N_ACPI_IO_SMI_EN_LEGACY_USB3                  31
> 
> +#define N_ACPI_IO_SMI_EN_ESPI                         28
> 
> +#define N_ACPI_IO_SMI_EN_PERIODIC                     14
> 
> +#define N_ACPI_IO_SMI_EN_TCO                          13
> 
> +#define N_ACPI_IO_SMI_EN_MCSMI                        11
> 
> +#define N_ACPI_IO_SMI_EN_SWSMI_TMR                    6
> 
> +#define N_ACPI_IO_SMI_EN_APMC                         5
> 
> +#define N_ACPI_IO_SMI_EN_ON_SLP_EN                    4
> 
> +#define N_ACPI_IO_SMI_EN_LEGACY_USB                   3
> 
> +
> 
> +#define R_ACPI_IO_SMI_STS                             0x34
> 
> +#define S_ACPI_IO_SMI_STS                             4
> 
> +#define B_ACPI_IO_SMI_STS_GPIO_UNLOCK                 BIT27
> 
> +#define B_ACPI_IO_SMI_STS_SMBUS                       BIT16
> 
> +#define B_ACPI_IO_SMI_STS_PERIODIC                    BIT14
> 
> +#define B_ACPI_IO_SMI_STS_TCO                         BIT13
> 
> +#define B_ACPI_IO_SMI_STS_MCSMI                       BIT11
> 
> +#define B_ACPI_IO_SMI_STS_SWSMI_TMR                   BIT6
> 
> +#define B_ACPI_IO_SMI_STS_APM                         BIT5
> 
> +#define B_ACPI_IO_SMI_STS_ON_SLP_EN                   BIT4
> 
> +#define B_ACPI_IO_SMI_STS_BIOS                        BIT2
> 
> +#define N_ACPI_IO_SMI_STS_LEGACY_USB3                 31
> 
> +#define N_ACPI_IO_SMI_STS_ESPI                        28
> 
> +#define N_ACPI_IO_SMI_STS_SPI                         26
> 
> +#define N_ACPI_IO_SMI_STS_MONITOR                     21
> 
> +#define N_ACPI_IO_SMI_STS_PCI_EXP                     20
> 
> +#define N_ACPI_IO_SMI_STS_SMBUS                       16
> 
> +#define N_ACPI_IO_SMI_STS_SERIRQ                      15
> 
> +#define N_ACPI_IO_SMI_STS_PERIODIC                    14
> 
> +#define N_ACPI_IO_SMI_STS_TCO                         13
> 
> +#define N_ACPI_IO_SMI_STS_MCSMI                       11
> 
> +#define N_ACPI_IO_SMI_STS_GPIO_SMI                    10
> 
> +#define N_ACPI_IO_SMI_STS_GPE0                        9
> 
> +#define N_ACPI_IO_SMI_STS_PM1_STS_REG                 8
> 
> +#define N_ACPI_IO_SMI_STS_SWSMI_TMR                   6
> 
> +#define N_ACPI_IO_SMI_STS_APM                         5
> 
> +#define N_ACPI_IO_SMI_STS_ON_SLP_EN                   4
> 
> +#define N_ACPI_IO_SMI_STS_LEGACY_USB                  3
> 
> +
> 
> +#define R_ACPI_IO_DEVACT_STS                          0x44
> 
> +#define B_ACPI_IO_DEVACT_STS_KBC                      BIT12
> 
> +#define B_ACPI_IO_DEVACT_STS_PIRQDH                   BIT9
> 
> +#define B_ACPI_IO_DEVACT_STS_PIRQCG                   BIT8
> 
> +#define B_ACPI_IO_DEVACT_STS_PIRQBF                   BIT7
> 
> +#define B_ACPI_IO_DEVACT_STS_PIRQAE                   BIT6
> 
> +
> 
> +#define R_ACPI_IO_GPE0_STS_127_96                  0x6C
> 
> +#define S_ACPI_IO_GPE0_STS_127_96                  4
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_WADT             BIT18
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS  BIT17
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE         BIT16
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_PME_B0           BIT13
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_PME              BIT11
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_BATLOW           BIT10
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_RI               BIT8
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_SMB_WAK          BIT7
> 
> +#define B_ACPI_IO_GPE0_STS_127_96_SWGPE            BIT2
> 
> +#define N_ACPI_IO_GPE0_STS_127_96_PME_B0           13
> 
> +#define N_ACPI_IO_GPE0_STS_127_96_PME              11
> 
> +
> 
> +#define R_ACPI_IO_GPE0_EN_127_96                   0x7C
> 
> +#define S_ACPI_IO_GPE0_EN_127_96                   4
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_WADT              BIT18
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_LAN_WAKE          BIT16
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_PME_B0            BIT13
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_ME_SCI            BIT12
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_PME               BIT11
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_BATLOW            BIT10
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_RI                BIT8
> 
> +#define B_ACPI_IO_GPE0_EN_127_96_SWGPE             BIT2
> 
> +#define N_ACPI_IO_GPE0_EN_127_96_PME_B0            13
> 
> +#define N_ACPI_IO_GPE0_EN_127_96_PME               11
> 
> +
> 
> +//
> 
> +// TCO register I/O map
> 
> +//
> 
> +#define R_TCO_IO_TCO1_STS                            0x04
> 
> +#define S_TCO_IO_TCO1_STS                            2
> 
> +#define B_TCO_IO_TCO1_STS_DMISERR                    BIT12
> 
> +#define B_TCO_IO_TCO1_STS_DMISMI                     BIT10
> 
> +#define B_TCO_IO_TCO1_STS_DMISCI                     BIT9
> 
> +#define B_TCO_IO_TCO1_STS_BIOSWR                     BIT8
> 
> +#define B_TCO_IO_TCO1_STS_NEWCENTURY                 BIT7
> 
> +#define B_TCO_IO_TCO1_STS_TIMEOUT                    BIT3
> 
> +#define B_TCO_IO_TCO1_STS_TCO_INT                    BIT2
> 
> +#define B_TCO_IO_TCO1_STS_SW_TCO_SMI                 BIT1
> 
> +#define N_TCO_IO_TCO1_STS_DMISMI                     10
> 
> +#define N_TCO_IO_TCO1_STS_BIOSWR                     8
> 
> +#define N_TCO_IO_TCO1_STS_NEWCENTURY                 7
> 
> +#define N_TCO_IO_TCO1_STS_TIMEOUT                    3
> 
> +#define N_TCO_IO_TCO1_STS_SW_TCO_SMI                 1
> 
> +#define N_TCO_IO_TCO1_STS_NMI2SMI                    0
> 
> +
> 
> +#define R_TCO_IO_TCO2_STS                            0x06
> 
> +#define S_TCO_IO_TCO2_STS                            2
> 
> +#define B_TCO_IO_TCO2_STS_SECOND_TO                  BIT1
> 
> +#define B_TCO_IO_TCO2_STS_INTRD_DET                  BIT0
> 
> +#define N_TCO_IO_TCO2_STS_INTRD_DET                  0
> 
> +
> 
> +#define R_TCO_IO_TCO1_CNT                            0x08
> 
> +#define S_TCO_IO_TCO1_CNT                            2
> 
> +#define B_TCO_IO_TCO1_CNT_LOCK                       BIT12
> 
> +#define N_TCO_IO_TCO1_CNT_NMI2SMI_EN                 9
> 
> +
> 
> +#define R_TCO_IO_TCO2_CNT                            0x0A
> 
> +#define S_TCO_IO_TCO2_CNT                            2
> 
> +#define N_TCO_IO_TCO2_CNT_INTRD_SEL                  2
> 
> +
> 
> +//
> 
> +// PWRM Registers
> 
> +//
> 
> +#define R_PMC_PWRM_GEN_PMCON_A                              0x1020
> ///< in CNL located in PWRM
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS                  BIT24
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_DISB                         BIT23
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_ALLOW_L1LOW_C0               BIT19
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_MS4V                         BIT18
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR                  BIT16
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_PWR_FLR                      BIT14
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS                 BIT9
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK                BIT8
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN                   BIT0
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL                   0xC0
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_64MS              0xC0
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_32MS              0x80
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_16MS              0x40
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_1_5MS             0x00
> 
> +#define B_PMC_PWRM_GEN_PMCON_A_PER_SMI_SEL                  0x6
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_64S                  0x0000
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_32S                  0x0002
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_16S                  0x0004
> 
> +#define V_PMC_PWRM_GEN_PMCON_A_PER_SMI_8S                   0x0006
> 
> +
> 
> +#define R_PMC_PWRM_GEN_PMCON_B                              0x1024
> 
> +#define B_PMC_PWRM_GEN_PMCON_B_SLPSX_STR_POL_LOCK
> BIT18            ///< Lock down SLP_S3/SLP_S4 Minimum Assertion width
> 
> +#define B_PMC_PWRM_GEN_PMCON_B_PWRBTN_LVL                   BIT9
> 
> +#define B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK                     BIT4
> 
> +#define B_PMC_PWRM_GEN_PMCON_B_RTC_PWR_STS                  BIT2
> 
> +
> 
> +#define R_PMC_PWRM_CRID                                     0x1030           ///<
> Configured Revision ID
> 
> +#define V_PMC_PWRM_CRID_RID_SEL_CRID0                       1
> 
> +#define B_PMC_PWRM_CRID_CRID_LK                             BIT31            ///< CRID
> Lock
> 
> +
> 
> +#define R_PMC_PWRM_ETR3                                     0x1048          ///< in CNL this
> is PWRM register
> 
> +#define B_PMC_PWRM_ETR3_CF9LOCK                             BIT31           ///< CF9h
> Lockdown
> 
> +#define B_PMC_PWRM_ETR3_CF9GR                               BIT20           ///< CF9h
> Global Reset
> 
> +#define B_PMC_PWRM_ETR3_CWORWRE                             BIT18
> 
> +
> 
> +#define R_PMC_PWRM_CFG                                      0x1818                      ///<
> Power Management Configuration
> 
> +#define B_PMC_PWRM_CFG_DBG_MODE_LOCK                        BIT27
> ///< Debug Mode Lock
> 
> +#define B_PMC_PWRM_CFG_PMCREAD_DISABLE                      BIT22
> ///< Disable Reads to PMC
> 
> +#define B_PMC_PWRM_CFG_TIMING_TPCH25                        (BIT1 | BIT0)
> ///< tPCH25 timing
> 
> +
> 
> +#define R_PMC_PWRM_DSX_CFG                                  0x1834                      ///<
> Deep SX Configuration
> 
> +#define B_PMC_PWRM_DSX_CFG_LAN_WAKE_EN                      BIT0
> ///< LAN_WAKE Pin DeepSx Enable
> 
> +
> 
> +#define R_PMC_PWRM_GPIO_CFG                                 0x1920
> 
> +#define B_PMC_PWRM_GPIO_CFG_GPE0_DW2                        (BIT11 | BIT10 |
> BIT9 | BIT8)
> 
> +#define N_PMC_PWRM_GPIO_CFG_GPE0_DW2                        8
> 
> +#define B_PMC_PWRM_GPIO_CFG_GPE0_DW1                        (BIT7 | BIT6 |
> BIT5 | BIT4)
> 
> +#define N_PMC_PWRM_GPIO_CFG_GPE0_DW1                        4
> 
> +#define B_PMC_PWRM_GPIO_CFG_GPE0_DW0                        (BIT3 | BIT2 |
> BIT1 | BIT0)
> 
> +#define N_PMC_PWRM_GPIO_CFG_GPE0_DW0                        0
> 
> +
> 
> +#define R_PMC_PWRM_HPR_CAUSE0                               0x192C   ///< Host
> partition reset causes
> 
> +#define B_PMC_PWRM_HPR_CAUSE0_GBL_TO_HOST                   BIT15    ///<
> Global reset converted to Host reset
> 
> +
> 
> +#define R_PMC_PWRM_ST_PG_FDIS_PMC_1                         0x1E20 ///<
> Static PG Related Function Disable Register 1
> 
> +#define B_PMC_PWRM_ST_PG_FDIS_PMC_1_ST_FDIS_LK              BIT31
> ///< Static Function Disable Lock (ST_FDIS_LK)
> 
> +
> 
> +#define R_PMC_PWRM_FUSE_DIS_RD_2                            0x1E44 ///< Fuse
> Disable Read 2 Register
> 
> +#define B_PMC_PWRM_FUSE_DIS_RD_2_GBE_FUSE_SS_DIS            BIT0
> ///< GBE Fuse or Soft Strap Disable
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h
> new file mode 100644
> index 0000000000..5824663d22
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/RtcRegs.h
> @@ -0,0 +1,45 @@
> +/** @file
> 
> +  Register names for RTC device
> 
> +
> 
> +Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _REGS_RTC_H_
> 
> +#define _REGS_RTC_H_
> 
> +
> 
> +#define R_RTC_IO_INDEX                           0x70
> 
> +#define R_RTC_IO_TARGET                          0x71
> 
> +#define R_RTC_IO_INDEX_ALT                       0x74
> 
> +#define R_RTC_IO_TARGET_ALT                      0x75
> 
> +#define R_RTC_IO_EXT_INDEX_ALT                   0x76
> 
> +#define R_RTC_IO_REGD                            0x0D
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h
> new file mode 100644
> index 0000000000..2037bb003d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SataRegs.h
> @@ -0,0 +1,56 @@
> +/** @file
> 
> +  Register names for SATA controllers
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SATA_REGS_H_
> 
> +#define _SATA_REGS_H_
> 
> +
> 
> +//
> 
> +//  SATA Controller Common Registers
> 
> +//
> 
> +#define R_SATA_CFG_AHCI_BAR                 0x24
> 
> +#define R_SATA_CFG_MAP                      0x90
> 
> +#define N_SATA_CFG_MAP_SPD                  16
> 
> +#define R_SATA_CFG_PCS                      0x94
> 
> +#define B_SATA_CFG_PCS_P0P                  BIT16
> 
> +#define R_SATA_CFG_SATAGC                   0x9C
> 
> +#define B_SATA_CFG_SATAGC_ASSEL             (BIT2 | BIT1 | BIT0)
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_2K          0x0
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_16K         0x1
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_32K         0x2
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_64K         0x3
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_128K        0x4
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_256K        0x5
> 
> +#define V_SATA_CFG_SATAGC_ASSEL_512K        0x6
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h
> new file mode 100644
> index 0000000000..9864dd872d
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/SerialIoRegs.h
> @@ -0,0 +1,47 @@
> +/** @file
> 
> +  Register names for Serial IO Controllers
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_REGS_H_
> 
> +#define _SERIAL_IO_REGS_H_
> 
> +
> 
> +//
> 
> +// Serial IO Controllers PCI Configuration Registers
> 
> +// registers accessed using PciD21FxRegBase + offset
> 
> +//
> 
> +#define R_SERIAL_IO_CFG_BAR0_LOW                            0x10
> 
> +#define R_SERIAL_IO_CFG_BAR0_HIGH                           0x14
> 
> +
> 
> +#define R_SERIAL_IO_CFG_PME_CTRL_STS                        0x84
> 
> +
> 
> +#endif //_SERIAL_IO_REGS_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h
> new file mode 100644
> index 0000000000..ea832873bf
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/Register/UsbRegs.h
> @@ -0,0 +1,51 @@
> +/** @file
> 
> +  Register names for USB Host and device controller
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _USB_REGS_H_
> 
> +#define _USB_REGS_H_
> 
> +
> 
> +//
> 
> +// XHCI PCI Config Space registers
> 
> +//
> 
> +#define R_XHCI_CFG_PWR_CNTL_STS             0x74
> 
> +#define B_XHCI_CFG_PWR_CNTL_STS_PWR_STS     (BIT1 | BIT0)
> 
> +#define V_XHCI_CFG_PWR_CNTL_STS_PWR_STS_D3  (BIT1 | BIT0)
> 
> +
> 
> +//
> 
> +// xDCI (OTG) MMIO registers
> 
> +//
> 
> +#define R_XDCI_MEM_GCTL                       0xC110  ///< Xdci Global Ctrl
> 
> +
> 
> +#endif // _USB_REGS_H_
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h
> new file mode 100644
> index 0000000000..e2e1cf2ad2
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SerialIoDevices.h
> @@ -0,0 +1,213 @@
> +/** @file
> 
> +  Serial IO policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_DEVICES_H_
> 
> +#define _SERIAL_IO_DEVICES_H_
> 
> +
> 
> +#include <Protocol/SerialIo.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  Available working modes for SerialIo SPI Host Controller
> 
> +
> 
> +       0: SerialIoSpiDisabled;
> 
> +          - Device is placed in D3
> 
> +          - Gpio configuration is skipped
> 
> +          - PSF:
> 
> +          !important! If given device is Function 0 and other higher functions on
> given device
> 
> +                      are enabled, PSF disabling is skipped. PSF default will remain and
> device PCI CFG Space will still be visible.
> 
> +                      This is needed to allow PCI enumerator access functions above 0
> in a multifunction device.
> 
> +    <b>1: SerialIoSpiPci;</b>
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device will be enabled in PSF
> 
> +          - Only BAR0 will be enabled
> 
> +       2: SerialIoSpiHidden;
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device disabled in the PSF
> 
> +          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
> 
> +          - BAR0 assigned from the global PCH reserved memory range,
> reported as motherboard resource by SIRC
> 
> +       @note
> 
> +           If this controller is located at function 0 and it's mode is set to hidden it
> will not be visible in the PCI space.
> 
> +**/
> 
> +typedef enum {
> 
> +  SerialIoSpiDisabled,
> 
> +  SerialIoSpiPci,
> 
> +  SerialIoSpiHidden
> 
> +} SERIAL_IO_SPI_MODE;
> 
> +
> 
> +/**
> 
> +  Used to set Inactive/Idle polarity of Spi Chip Select
> 
> +**/
> 
> +typedef enum {
> 
> +  SerialIoSpiCsActiveLow  = 0,
> 
> +  SerialIoSpiCsActiveHigh = 1
> 
> +} SERIAL_IO_CS_POLARITY;
> 
> +
> 
> +/**
> 
> +  The SERIAL_IO_SPI_CONFIG provides the configurations to set the Serial
> IO SPI controller
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8 Mode;                                          ///< <b>SerialIoSpiPci </b> see
> SERIAL_IO_SPI_MODE
> 
> +  UINT8 DefaultCsOutput;                               ///< <b>0 = CS0</b> CS1, CS2, CS3.
> Default CS used by the SPI HC
> 
> +  UINT8 CsPolarity[PCH_MAX_SERIALIO_SPI_CHIP_SELECTS]; ///< Selects
> SPI ChipSelect signal polarity, 0 = low <b>1 = High</b>
> 
> +  UINT8 CsEnable[PCH_MAX_SERIALIO_SPI_CHIP_SELECTS];   ///< <b>0 =
> Enable</b> 1 = Disable. Based on this setting GPIO for given SPIx CSx will be
> configured in Native mode
> 
> +  UINT8 CsMode;                                        ///< <b>0 = HW Control</b> 1 = SW
> Control. Sets Chip Select Control mode Hardware or Software.
> 
> +  UINT8 CsState;                                       ///< <b>0 = CS is set to low</b> 1 = CS is
> set to high
> 
> +} SERIAL_IO_SPI_CONFIG;
> 
> +
> 
> +/**
> 
> +  Available working modes for SerialIo UART Host Controller
> 
> +
> 
> +       0: SerialIoUartDisabled;
> 
> +          - Device is placed in D3
> 
> +          - Gpio configuration is skipped
> 
> +          - PSF:
> 
> +          !important! If given device is Function 0 and other higher functions on
> given device
> 
> +                      are enabled, PSF disabling is skipped. PSF default will remain and
> device PCI CFG Space will still be visible.
> 
> +                      This is needed to allow PCI enumerator access functions above 0
> in a multifunction device.
> 
> +    <b>1: SerialIoUartPci;</b>
> 
> +          - Designated for Serial IO UART OS driver usage
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device will be enabled in PSF
> 
> +          - Only BAR0 will be enabled
> 
> +       2: SerialIoUartHidden;
> 
> +          - Designated for BIOS and/or DBG2 OS kernel debug
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device disabled in the PSF
> 
> +          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
> 
> +          - BAR0 assigned from the global PCH reserved memory range,
> reported as motherboard resource by SIRC
> 
> +       @note
> 
> +           If this controller is located at function 0 and it's mode is set to hidden it
> will not be visible in the PCI space.
> 
> +       3: SerialIoUartCom;
> 
> +          - Designated for 16550/PNP0501 compatible COM device
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device disabled in the PSF
> 
> +          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
> 
> +          - BAR0 assigned from the global PCH reserved memory range,
> reported as motherboard resource by SIRC
> 
> +       4: SerialIoUartSkipInit;
> 
> +          - Gpio configuration is skipped
> 
> +          - PSF configuration is skipped
> 
> +          - BAR assignemnt is skipped
> 
> +          - D-satate setting is skipped
> 
> +
> 
> +**/
> 
> +typedef enum {
> 
> +  SerialIoUartDisabled,
> 
> +  SerialIoUartPci,
> 
> +  SerialIoUartHidden,
> 
> +  SerialIoUartCom,
> 
> +  SerialIoUartSkipInit
> 
> +} SERIAL_IO_UART_MODE;
> 
> +
> 
> +/**
> 
> +  UART Settings
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32      BaudRate;    ///< <b> 115200 </b> Max 6000000  MdePkg.dec
> PcdUartDefaultBaudRate
> 
> +  UINT8       Parity;      ///< <b> 1 - No Parity</b> see EFI_PARITY_TYPE
> MdePkg.dec PcdUartDefaultParity
> 
> +  UINT8       DataBits;    ///< <b>8</b> MdePkg.dec PcdUartDefaultDataBits
> 
> +  UINT8       StopBits;    ///< <b>1 - One Stop Bit</b> see
> EFI_STOP_BITS_TYPE  MdePkg.dec  PcdUartDefaultStopBits
> 
> +  UINT8       AutoFlow;    ///< <b>FALSE</b>  IntelFrameworkModulePkg.dsc
> PcdIsaBusSerialUseHalfHandshake
> 
> +} SERIAL_IO_UART_ATTRIBUTES;
> 
> +
> 
> +/**
> 
> +  UART signals pin muxing settings. If signal can be enable only on a single
> pin
> 
> +  then this parameter is ignored by RC. Refer to
> GPIO_*_MUXING_SERIALIO_UARTx_* in GpioPins*.h
> 
> +  for supported settings on a given platform
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32 Rx;  ///< RXD Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_UARTx_RXD_*
> 
> +  UINT32 Tx;  ///< TXD Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_UARTx_TXD_*
> 
> +  UINT32 Rts; ///< RTS Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_UARTx_RTS_*
> 
> +  UINT32 Cts; ///< CTS Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_UARTx_CTS_*
> 
> +} UART_PIN_MUX;
> 
> +
> 
> +/**
> 
> +  Serial IO UART Controller Configuration
> 
> +**/
> 
> +typedef struct {
> 
> +  SERIAL_IO_UART_ATTRIBUTES Attributes;  ///< see
> SERIAL_IO_UART_ATTRIBUTES
> 
> +  UART_PIN_MUX              PinMux;      ///< UART pin mux configuration
> 
> +  UINT8                     Mode;        ///< <b> SerialIoUartPci </b> see
> SERIAL_IO_UART_MODE
> 
> +  UINT8                     DBG2;        ///< <b> FALSE </b> If TRUE adds UART to
> DBG2 table and overrides UartPg to SerialIoUartPgDisabled
> 
> +  UINT8                     PowerGating; ///< <b> SerialIoUartPgAuto </b> Applies
> to Hidden/COM/SkipInit see SERIAL_IO_UART_PG
> 
> +  UINT8                     DmaEnable;   ///< <b> TRUE </b> Applies to
> SerialIoUartPci only. Informs OS driver to use DMA, if false it will run in PIO
> mode
> 
> +} SERIAL_IO_UART_CONFIG;
> 
> +
> 
> +typedef enum {
> 
> +  SerialIoUartPgDisabled,  ///< No _PS0/_PS3 support, device left in D0,
> after initialization
> 
> +/**
> 
> +  In mode: SerialIoUartCom;
> 
> +           _PS0/_PS3  that supports getting device out of reset
> 
> +  In mode: SerialIoUartPci
> 
> +           Keeps UART in D0 and assigns Fixed MMIO for SEC/PEI usage only
> 
> +**/
> 
> +  SerialIoUartPgEnabled,
> 
> +  SerialIoUartPgAuto       ///< _PS0 and _PS3, detection through ACPI if
> device was initialized prior to first PG. If it was used (DBG2) PG is disabled,
> 
> +} SERIAL_IO_UART_PG;
> 
> +
> 
> +/**
> 
> +  Available working modes for SerialIo I2C Host Controller
> 
> +
> 
> +       0: SerialIoI2cDisabled;
> 
> +          - Device is placed in D3
> 
> +          - Gpio configuration is skipped
> 
> +          - PSF:
> 
> +          !important! If given device is Function 0 and other higher functions on
> given device
> 
> +                      are enabled, PSF disabling is skipped. PSF default will remain and
> device PCI CFG Space will still be visible.
> 
> +                      This is needed to allow PCI enumerator access functions above 0
> in a multifunction device.
> 
> +    <b>1: SerialIoI2cPci;</b>
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device will be enabled in PSF
> 
> +          - Only BAR0 will be enabled
> 
> +       2: SerialIoI2cHidden;
> 
> +          - Gpio pin configuration in native mode for each assigned pin
> 
> +          - Device disabled in the PSF
> 
> +          - Both BARs are enabled, BAR1 becomes devices Pci Config Space
> 
> +          - BAR0 assigned from the global PCH reserved memory range,
> reported as motherboard resource by SIRC
> 
> +       @note
> 
> +           If this controller is located at function 0 and it's mode is set to hidden it
> will not be visible in the PCI space.
> 
> +**/
> 
> +typedef enum {
> 
> +  SerialIoI2cDisabled,
> 
> +  SerialIoI2cPci,
> 
> +  SerialIoI2cHidden
> 
> +} SERIAL_IO_I2C_MODE;
> 
> +
> 
> +/**
> 
> +  I2C signals pin muxing settings. If signal can be enable only on a single pin
> 
> +  then this parameter is ignored by RC. Refer to
> GPIO_*_MUXING_SERIALIO_I2Cx_* in GpioPins*.h
> 
> +  for supported settings on a given platform
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32   Sda;   ///< SDA Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_I2Cx_SDA_*
> 
> +  UINT32   Scl;   ///< SCL Pin mux configuration. Refer to
> GPIO_*_MUXING_SERIALIO_I2Cx_SCL_*
> 
> +} I2C_PIN_MUX;
> 
> +
> 
> +/**
> 
> +  Serial IO I2C Controller Configuration
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8        Mode;        /// <b>SerialIoI2cPci <b> see SERIAL_IO_I2C_MODE
> 
> +  /**
> 
> +    I2C Pads Internal Termination.
> 
> +    For more information please see Platform Design Guide.
> 
> +    Supported values (check GPIO_ELECTRICAL_CONFIG for reference):
> 
> +    <b>GpioTermNone: No termination</b>,
> 
> +    GpioTermWpu1K: 1kOhm weak pull-up,
> 
> +    GpioTermWpu5K: 5kOhm weak pull-up,
> 
> +    GpioTermWpu20K: 20kOhm weak pull-up
> 
> +  **/
> 
> +  UINT8        PadTermination;
> 
> +  UINT8        Reserved[2];
> 
> +  I2C_PIN_MUX  PinMux;      ///< I2C pin mux configuration
> 
> +} SERIAL_IO_I2C_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _SERIAL_IO_DEVICES_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h
> new file mode 100644
> index 0000000000..191bd815a1
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiConfigHob.h
> @@ -0,0 +1,17 @@
> +/** @file
> 
> +  Silicon Config HOB is used for gathering platform
> 
> +  related Intel silicon information and config setting.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_CONFIG_HOB_H_
> 
> +#define _SI_CONFIG_HOB_H_
> 
> +
> 
> +#include <SiPolicyStruct.h>
> 
> +
> 
> +extern EFI_GUID gSiConfigHobGuid;
> 
> +
> 
> +// Rename SI_CONFIG_HOB into SI_CONFIG_HOB_DATA for it does not
> follow HOB structure.
> 
> +typedef CONST SI_CONFIG SI_CONFIG_HOB_DATA;
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h
> new file mode 100644
> index 0000000000..7b646d8972
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Include/SiPolicyStruct.h
> @@ -0,0 +1,64 @@
> +/** @file
> 
> +  Intel reference code configuration policies.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_POLICY_STRUCT_H_
> 
> +#define _SI_POLICY_STRUCT_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <ConfigBlock/SiPreMemConfig.h>
> 
> +#include <ConfigBlock/SiConfig.h>
> 
> +
> 
> +/**
> 
> +  Silicon Policy revision number
> 
> +  Any change to this structure will result in an update in the revision number
> 
> +
> 
> +  This member specifies the revision of the Silicon Policy. This field is used to
> indicate change
> 
> +  to the policy structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +   - Initial version.
> 
> +**/
> 
> +#define SI_POLICY_REVISION  1
> 
> +
> 
> +/**
> 
> +  Silicon pre-memory Policy revision number
> 
> +  Any change to this structure will result in an update in the revision number
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +   - Initial version.
> 
> +**/
> 
> +#define SI_PREMEM_POLICY_REVISION  1
> 
> +
> 
> +
> 
> +/**
> 
> +  SI Policy PPI in Pre-Mem\n
> 
> +  All SI config block change history will be listed here\n\n
> 
> +
> 
> +  - <b>Revision 1</b>:
> 
> +    - Initial version.\n
> 
> +**/
> 
> +struct _SI_PREMEM_POLICY_STRUCT {
> 
> +  CONFIG_BLOCK_TABLE_HEADER      TableHeader;   ///< Config Block Table
> Header
> 
> +/*
> 
> +  Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +*/
> 
> +};
> 
> +
> 
> +/**
> 
> +  SI Policy PPI\n
> 
> +  All SI config block change history will be listed here\n\n
> 
> +
> 
> +  - <b>Revision 1</b>:
> 
> +    - Initial version.\n
> 
> +**/
> 
> +struct _SI_POLICY_STRUCT {
> 
> +  CONFIG_BLOCK_TABLE_HEADER      TableHeader;   ///< Config Block Table
> Header
> 
> +/*
> 
> +  Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +*/
> 
> +};
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers
  2021-02-01  1:36 ` [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds header files common to CPU modules.
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
> |  83
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPre
> MemConfig.h | 148
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConfig.
> h         |  52
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtB
> asicConfig.h  | 226
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtC
> ustomConfig.h |  76
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtP
> sysConfig.h   |  36 ++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgmtT
> estConfig.h   | 150
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPreM
> emConfig.h  |  63
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.h
> |  51 +++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h                            |
> 12 ++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h                        |
> 21 +++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
> |  23 +++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
> |  18 ++++++++++++++++++
>  13 files changed, 959 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
> new file mode 100644
> index 0000000000..d837500a38
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfig.h
> @@ -0,0 +1,83 @@
> +/** @file
> 
> +  CPU Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_CONFIG_H_
> 
> +#define _CPU_CONFIG_H_
> 
> +
> 
> +#define CPU_CONFIG_REVISION 3
> 
> +
> 
> +extern EFI_GUID gCpuConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Add SmbiosType4MaxSpeedOverride.
> 
> +  <b>Revision 3</b>:
> 
> +  - Add AvxDisable & Avx3Disable.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  UINT32                MicrocodePatchRegionSize;
> 
> +  EFI_PHYSICAL_ADDRESS  MicrocodePatchAddress;    ///< Pointer to
> microcode patch that is suitable for this processor.
> 
> +  /**
> 
> +    Enable or Disable Advanced Encryption Standard (AES) feature.
> 
> +    For some countries, this should be disabled for legal reasons.
> 
> +    -    0: Disable
> 
> +    - <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32 AesEnable           : 1;
> 
> +  /**
> 
> +    Enable or Disable Trusted Execution Technology (TXT) feature.
> 
> +    -    0: Disable
> 
> +    - <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32 TxtEnable           : 1;
> 
> +  UINT32 SkipMpInit          : 1;                 ///< For Fsp only, Silicon Initialization
> will skip MP Initialization (including BSP) if enabled. For non-FSP, this should
> always be 0.
> 
> +  /**
> 
> +    Enable or Disable or Auto for PPIN Support to view Protected Processor
> Inventory Number.
> 
> +    - <b>0: Disable</b>
> 
> +    -    1: Enable
> 
> +    -    2: Auto : Feature is based on End Of Manufacturing (EOM) flag. If EOM
> is set, it is disabled.
> 
> +  **/
> 
> +  UINT32 PpinSupport         : 2;
> 
> +  /**
> 
> +    Enable or Disable #AC machine check on split lock.
> 
> +    - <b>0: Disable</b>
> 
> +    -    1: Enable
> 
> +  **/
> 
> +  UINT32 AcSplitLock         : 1;
> 
> +  /**
> 
> +  Enable or Disable Avx.
> 
> +  -      1: Disable
> 
> +  -  <b> 0: Enable</b>
> 
> +  **/
> 
> +  UINT32 AvxDisable          : 1;
> 
> +  /**
> 
> +  Enable or Disable Avx3.
> 
> +  -      1: Disable
> 
> +  -  <b> 0: Enable</b>
> 
> +  **/
> 
> +  UINT32 Avx3Disable         : 1;
> 
> +  UINT32 RsvdBits            : 24;                ///< Reserved for future use
> 
> +  /**
> 
> +    Provide the option for platform to override the MaxSpeed field of Smbios
> Type 4.
> 
> +    Value 4000 means 4000MHz.
> 
> +    If this value is not zero, it dominates the field.
> 
> +    If this value is zero, CPU RC will update the field according to the max
> radio.
> 
> +    <b>default is 0.</b>
> 
> +  **/
> 
> +  UINT16 SmbiosType4MaxSpeedOverride;
> 
> +  UINT8  Reserved0[2];                            ///< Reserved for future use
> 
> +} CPU_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPr
> eMemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPr
> eMemConfig.h
> new file mode 100644
> index 0000000000..bf3f436ddd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuConfigLibPr
> eMemConfig.h
> @@ -0,0 +1,148 @@
> +/** @file
> 
> +  CPU Security PreMemory Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
> 
> +#define _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
> 
> +
> 
> +#define CPU_CONFIG_LIB_PREMEM_CONFIG_REVISION 6
> 
> +
> 
> +extern EFI_GUID gCpuConfigLibPreMemConfigGuid;
> 
> +
> 
> +#define BOOT_FREQUENCY_MAX_BATTERY_PERF   0
> 
> +#define BOOT_FREQUENCY_MAX_NON_TURBO_PERF 1
> 
> +#define BOOT_FREQUENCY_TURBO_PERF         2
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Config Library PreMemory Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Expand the supported number of processor cores (ActiveCoreCount1).
> 
> +  <b>Revision  3</b>:
> 
> +  - Added PECI Sx and C10 Reset.
> 
> +  <b>Revision  4</b>:
> 
> +  - Added ActiveSmallCoreCount.
> 
> +  <b>Revision  5</b>:
> 
> +  - Added CrashLogGprs
> 
> +  <b>Revision  6</b>:
> 
> +  - Added ConfigTdpLevel
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER Header;            ///< Config Block Header
> 
> +  UINT32 HyperThreading             : 1; ///< Enable or Disable Hyper Threading;
> 0: Disable; <b>1: Enable</b>.
> 
> +  /**
> 
> +  Sets the boot frequency starting from reset vector.
> 
> +   - 0: Maximum battery performance.
> 
> +   - 1: Maximum non-turbo performance
> 
> +   -<b>2: Turbo performance</b>.
> 
> +  @note If Turbo is selected BIOS will start in max non-turbo mode and
> switch to Turbo mode.
> 
> +  **/
> 
> +  UINT32 BootFrequency              : 2;
> 
> +  /**
> 
> +    Number of processor cores to enable.
> 
> +    - <b> 0: All cores</b>
> 
> +    -     1: 1 core
> 
> +    -     2: 2 cores
> 
> +    -     3: 3 cores
> 
> +  **/
> 
> +  UINT32 ActiveCoreCount            : 3; ///< @deprecated due to core active
> number limitaion.
> 
> +  UINT32 JtagC10PowerGateDisable    : 1; ///< False: JTAG is power gated in
> C10 state. True: keeps the JTAG power up during C10 and deeper power
> states for debug purpose. <b>0: False<\b>; 1: True.
> 
> +  UINT32 BistOnReset                : 1; ///< <b>(Test)</b> Enable or Disable BIST
> on Reset; <b>0: Disable</b>; 1: Enable.
> 
> +  /**
> 
> +    Enable or Disable Virtual Machine Extensions (VMX) feature.
> 
> +    -    0: Disable
> 
> +    - <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32 VmxEnable                  : 1;
> 
> +  /**
> 
> +  Processor Early Power On Configuration FCLK setting.
> 
> +   - <b>0: 800 MHz (ULT/ULX)</b>.
> 
> +   - <b>1: 1 GHz (DT/Halo)</b>. Not supported on ULT/ULX.
> 
> +   - 2: 400 MHz.
> 
> +   - 3: Reserved.
> 
> +  **/
> 
> +  UINT32 FClkFrequency              : 2;
> 
> +  /**
> 
> +  Enable or Disable CrashLog feature
> 
> +    -    0: Disable
> 
> +    - <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32 CrashLogEnable              : 1;
> 
> +
> 
> +  /**
> 
> +  Enable or Disable Total Memory Encryption (TME) feature.
> 
> +    - <b>0: Disable</b>
> 
> +    -    1: Enable
> 
> +  **/
> 
> +  UINT32 TmeEnable                  : 1;
> 
> +
> 
> +  UINT32 DebugInterfaceEnable       : 2; ///< Enable or Disable processor
> debug features; 0: Disable; 1: Enable; <b>2: No Change</b>.
> 
> +  UINT32 DebugInterfaceLockEnable   : 1; ///< Lock or Unlock debug
> interface features; 0: Disable; <b>1: Enable</b>.
> 
> +
> 
> +  /**
> 
> +    Number of big cores in processor to enable. And support up to 16 cores.
> 
> +    - <b> 0: All cores</b>
> 
> +    -     1: 1 core
> 
> +    -     2: 2 cores
> 
> +    -     3: 3 cores
> 
> +  **/
> 
> +  UINT32 ActiveCoreCount1           : 4;
> 
> +
> 
> +  /**
> 
> +  Enables a mailbox command to resolve rare PECI related Sx issues.
> 
> +  @note This should only be used on systems that observe PECI Sx issues.
> 
> +  - <b>0: Disable</b>
> 
> +  -    1: Enable
> 
> +  **/
> 
> +  UINT32 PeciSxReset                : 1;
> 
> +
> 
> +  /**
> 
> +  Enables the mailbox command to resolve PECI reset issues during Pkg-C10
> exit.
> 
> +  If Enabled, BIOS will send the CPU message to disable peci reset on C10
> exit.
> 
> +  The default value is <b>1: Enable</b> for CML, and <b>0: Disable</b> for
> all other CPU's
> 
> +  - 0: Disable
> 
> +  - 1: Enable
> 
> +  **/
> 
> +  UINT32 PeciC10Reset               : 1;
> 
> +
> 
> +  /**
> 
> +    Number of small cores in processor to enable. And support the enabling
> of up to 63 cores.
> 
> +    - <b> 0: All cores</b>
> 
> +    -     1: 1 core
> 
> +    -     2: 2 cores
> 
> +    -     3: 3 cores
> 
> +  **/
> 
> +  UINT32 ActiveSmallCoreCount       : 6;
> 
> +
> 
> +  /**
> 
> +  Enable or Disable CrashLog GPRs dump
> 
> +    - <b>0: Disable</b>
> 
> +    -    1: Gprs Enabled, Smm Gprs Enabled
> 
> +         2: Gprs Enabled, Smm Gprs Disabled
> 
> +  **/
> 
> +  UINT32 CrashLogGprs               : 2;
> 
> +
> 
> +  UINT32 RsvdBits                   : 2;
> 
> +
> 
> +  /**
> 
> +    CpuRatio - Max non-turbo ratio (Flexible Ratio Boot) is set to CpuRatio.
> <b>0: Disabled</b> If disabled, doesn't override max-non turbo ratio.
> 
> +  **/
> 
> +  UINT8  CpuRatio;
> 
> +  /**
> 
> +    Configuration for boot TDP selection; <b>0: TDP Nominal</b>; 1: TDP
> Down; 2: TDP Up.
> 
> +  **/
> 
> +  UINT8  ConfigTdpLevel;
> 
> +  UINT8  Reserved[2];                    ///< Reserved for alignment
> 
> +  UINT32 ElixirSpringsPatchAddr;         ///< Address of Elixir Springs Patch(es)
> 
> +  UINT32 ElixirSpringsPatchSize;         ///< Elixir Springs Patch(es) Size.
> 
> +} CPU_CONFIG_LIB_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_CONFIG_LIB_PREMEM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConf
> ig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConf
> ig.h
> new file mode 100644
> index 0000000000..4fcb92cb27
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPidTestConf
> ig.h
> @@ -0,0 +1,52 @@
> +/** @file
> 
> +  CPU PID Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PID_TEST_CONFIG_H_
> 
> +#define _CPU_PID_TEST_CONFIG_H_
> 
> +
> 
> +#define CPU_PID_TEST_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gCpuPidTestConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  PID Tuning Configuration Structure.
> 
> +  Domain is mapped to Kp = 0, Ki = 1, Kd = 2.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  UINT16  Ratl[3];                                ///< RATL setting, in 1/256 units. Range is 0
> - 65280
> 
> +  UINT16  VrTdcVr0[3];                            ///< VR Thermal Design Current for
> VR0. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  VrTdcVr1[3];                            ///< VR Thermal Design Current for
> VR1. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  VrTdcVr2[3];                            ///< VR Thermal Design Current for
> VR2. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  VrTdcVr3[3];                            ///< VR Thermal Design Current for
> VR3. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPsysPl1Msr[3];                       ///< Power Budget Management
> Psys PL1 MSR. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPsysPl1MmioPcs[3];                   ///< Power Budget
> Management Psys PL1 MMIO/PCS. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPsysPl2Msr[3];                       ///< Power Budget Management
> Psys PL2 MSR. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPsysPl2MmioPcs[3];                   ///< Power Budget
> Management Psys PL2 MMIO/PCS. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPkgPl1Msr[3];                        ///< Power Budget Management
> Package PL1 MSR. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPkgPl1MmioPcs[3];                    ///< Power Budget
> Management Package PL1 MMIO/PCS. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPkgPl2Msr[3];                        ///< Power Budget Management
> Package PL2 MSR. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  PbmPkgPl2MmioPcs[3];                    ///< Power Budget
> Management Package PL2 MMIO/PCS. In 1/256 units. Range is 0 - 65280
> 
> +  UINT16  DdrPl1Msr[3];                           ///< DDR PL1 MSR. In 1/256 units.
> Range is 0 - 65280
> 
> +  UINT16  DdrPl1MmioPcs[3];                       ///< DDR PL1 MMIO/PCS. In 1/256
> units. Range is 0 - 65280
> 
> +  UINT16  DdrPl2Msr[3];                           ///< DDR PL2 MSR. In 1/256 units.
> Range is 0 - 65280
> 
> +  UINT16  DdrPl2MmioPcs[3];                       ///< DDR PL2 MMIO/PCS. In 1/256
> units. Range is 0 - 65280
> 
> +  /**
> 
> +  Enable or Disable PID Tuning programming flow.
> 
> +  If disabled, all other policies in this config block are ignored.
> 
> +  **/
> 
> +  UINT8   PidTuning;
> 
> +  UINT8   Rsvd;                                   ///< Reserved for DWORD alignment.
> 
> +} CPU_PID_TEST_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_PID_TEST_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tBasicConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tBasicConfig.h
> new file mode 100644
> index 0000000000..0255d49bdf
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tBasicConfig.h
> @@ -0,0 +1,226 @@
> +/** @file
> 
> +  CPU Power Management Basic Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POWER_MGMT_BASIC_CONFIG_H_
> 
> +#define _CPU_POWER_MGMT_BASIC_CONFIG_H_
> 
> +
> 
> +#define CPU_POWER_MGMT_BASIC_CONFIG_REVISION 5
> 
> +
> 
> +extern EFI_GUID gCpuPowerMgmtBasicConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Power Management Basic Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Changed EnableItbm default to be disable
> 
> +  - Deprecated EnableItbmDriver due to Platform doesn't have ITBMT OS
> driver
> 
> +  <b>Revision 3</b>:
> 
> +  - Add ApplyConfigTdp for TDP initialization settings based on non-cTDP or
> cTDP
> 
> +  <b>Revision 4</b>:
> 
> +  - Add Hwp Lock support
> 
> +  <b>Revision 5</b>:
> 
> +  - Add VccInDemotionOverride and VccInDemotionMs
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +  Sets the boot frequency starting from reset vector.
> 
> +   - 0: Maximum battery performance.
> 
> +   - 1: Maximum non-turbo performance.
> 
> +   - <b>2: Turbo performance.</b>
> 
> +  @note If Turbo is selected BIOS will start in max non-turbo mode and
> switch to Turbo mode.
> 
> +  **/
> 
> +  UINT32 BootFrequency                  : 2;       //@deprecated
> 
> +  UINT32 SkipSetBootPState              : 1;      ///< Choose whether to skip
> SetBootPState function for all APs; <b>0: Do not skip</b>; 1: Skip.
> 
> +  /**
> 
> +  Enable or Disable Intel Speed Shift Technology.
> 
> +  Enabling allows for processor control of P-state transitions.
> 
> +  0: Disable; <b>1: Enable;</b> Bit 1 is ignored.
> 
> +  @note Currently this feature is recommended to be enabled only on
> win10
> 
> +  **/
> 
> +  UINT32 Hwp                            : 2;
> 
> +  /**
> 
> +  Hardware Duty Cycle Control configuration. 0: Disabled; <b>1: Enabled</b>
> 2-3:Reserved
> 
> +  HDC enables the processor to autonomously force components to enter
> into an idle state to lower effective frequency.
> 
> +  This allows for increased package level C6 residency.
> 
> +  @note Currently this feature is recommended to be enabled only on
> win10
> 
> +  **/
> 
> +  UINT32 HdcControl                     : 2;
> 
> +  UINT32 PowerLimit2                    : 1;      ///< Enable or Disable short duration
> Power Limit (PL2). 0: Disable; <b>1: Enable</b>
> 
> +  UINT32 TurboPowerLimitLock            : 1;      ///< MSR 0x610[63] and
> 0x618[63]: Locks all Turbo power limit settings to read-only; <b>0:
> Disable</b>; 1: Enable (Lock).
> 
> +  UINT32 PowerLimit3DutyCycle           : 8;      ///< Package PL3 Duty Cycle.
> Specifies the PL3 duty cycle percentage, Range 0-100. <b>Default: 0</b>.
> 
> +  UINT32 PowerLimit3Lock                : 1;      ///< Package PL3 MSR 615h lock;
> <b>0: Disable</b>; 1: Enable (Lock).
> 
> +  UINT32 PowerLimit4Lock                : 1;      ///< Package PL4 MSR 601h lock;
> <b>0: Disable</b>; 1: Enable (Lock).
> 
> +  /**
> 
> +  Tcc Offset Clamp for Runtime Average Temperature Limit (RATL) allows
> CPU to throttle below P1.
> 
> +  For Y SKU, the recommended default for this policy is <b>1: Enabled</b>,
> which indicates throttling below P1 is allowed.
> 
> +  For all other SKUs the recommended default are  <b>0: Disabled</b>.
> 
> +  **/
> 
> +  UINT32 TccOffsetClamp                 : 1;
> 
> +  UINT32 TccOffsetLock                  : 1;      ///< Tcc Offset Lock for Runtime
> Average Temperature Limit (RATL) to lock temperature target MSR 1A2h; 0:
> Disabled; <b>1: Enabled (Lock)</b>.
> 
> +  UINT32 TurboMode                      : 1;      ///< Enable or Disable Turbo Mode.
> Disable; <b>1: Enable</b>
> 
> +  UINT32 HwpInterruptControl            : 1;      ///< Set HW P-State Interrupts
> Enabled  for MISC_PWR_MGMT MSR 0x1AA[7]; <b>0: Disable</b>; 1:
> Enable.
> 
> +  UINT32 ApplyConfigTdp                 : 1;      ///< Switch TDP applied setting
> based on non-cTDP or TDP; 0: non-cTDP; <b>1: cTDP</b>.
> 
> +  UINT32 HwpLock                        : 1;      ///< HWP Lock in MISC PWR MGMT
> MSR 1AAh; <b>0: Disable</b>; 1: Enable (Lock).
> 
> +  UINT32 VccInDemotionOverride          : 1;      ///< Enable VccIn Demotion
> Override configuration. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 RsvdBits                       : 6;      ///< Reserved for future use.
> 
> +
> 
> +  /**
> 
> +   1-Core Ratio Limit: LFM to Fused 1-Core Ratio Limit. For overclocking parts:
> LFM to Fused 1-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 1-Core Ratio Limit Must be greater than or equal to 2-Core Ratio
> Limit, 3-Core Ratio Limit, 4-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  OneCoreRatioLimit;
> 
> +  /**
> 
> +   2-Core Ratio Limit: LFM to Fused 2-Core Ratio Limit, For overclocking part:
> LFM to Fused 2-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 2-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  TwoCoreRatioLimit;
> 
> +  /**
> 
> +   3-Core Ratio Limit: LFM to Fused 3-Core Ratio Limit, For overclocking part:
> LFM to Fused 3-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 3-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  ThreeCoreRatioLimit;
> 
> +  /**
> 
> +   4-Core Ratio Limit: LFM to Fused 4-Core Ratio Limit, For overclocking part:
> LFM to Fused 4-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 4-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  FourCoreRatioLimit;
> 
> +  /**
> 
> +   5-Core Ratio Limit: LFM to Fused 5-Core Ratio Limit, For overclocking part:
> LFM to Fused 5-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 5-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  FiveCoreRatioLimit;
> 
> +  /**
> 
> +   6-Core Ratio Limit: LFM to Fused 6-Core Ratio Limit, For overclocking part:
> LFM to Fused 6-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 6-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  SixCoreRatioLimit;
> 
> +  /**
> 
> +   7-Core Ratio Limit: LFM to Fused 7-Core Ratio Limit, For overclocking part:
> LFM to Fused 7-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 7-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  SevenCoreRatioLimit;
> 
> +  /**
> 
> +   8-Core Ratio Limit: LFM to Fused 8-Core Ratio Limit, For overclocking part:
> LFM to Fused 8-Core Ratio Limit + OC Bins.
> 
> +   Note: OC Bins = 7 means fully unlocked, so range is LFM to 83.
> 
> +     - This 8-Core Ratio Limit Must be Less than or equal to 1-Core Ratio Limit.
> 
> +  **/
> 
> +  UINT8  EightCoreRatioLimit;
> 
> +  /**
> 
> +  TCC Activation Offset. Offset from factory set TCC activation temperature
> at which the Thermal Control Circuit must be activated.
> 
> +  TCC will be activated at (TCC Activation Temperature - TCC Activation
> Offset), in degrees Celcius.
> 
> +  For Y SKU, the recommended default for this policy is  <b>10</b>
> 
> +  For all other SKUs the recommended default are <b>0</b>, causing TCC to
> activate at TCC Activation temperature.
> 
> +  @note The policy is recommended for validation purpose only.
> 
> +  **/
> 
> +  UINT8  TccActivationOffset;
> 
> +  /**
> 
> +  Intel Turbo Boost Max Technology 3.0
> 
> +  Enabling it on processors with OS support will allow OS to exploit the
> diversity in max turbo frequency of the cores.
> 
> +  <b>0: Disable</b>; 1: Enable;
> 
> +  **/
> 
> +  UINT8  EnableItbm                     : 1;
> 
> +  /**
> 
> +  @deprecated: Platform doesn't have Intel Turbo Boost Max Technology
> 3.0 Driver
> 
> +  Enabling it will load the driver upon ACPI device with HID = INT3510.
> 
> +  <b> 0: Disable;</b> 1: Enable;
> 
> +  **/
> 
> +  UINT8  EnableItbmDriver               : 1;
> 
> +  /**
> 
> +  Per Core P State OS control mode
> 
> +  Disabling will set PCU_MISC_CONFIG (Command 0x06) Bit 31 = 1. When
> set, the highest core request is used for all other core requests.
> 
> +  0: Disable;<b> 1: Enable;</b>
> 
> +  **/
> 
> +  UINT8  EnablePerCorePState            : 1;
> 
> +  /**
> 
> +  HwP Autonomous Per Core P State
> 
> +  Disabling will set Bit 30 = 1, command 0x11. When set, autonomous will
> request the same value
> 
> +  for all cores all the time.
> 
> +  0: Disable;<b> 1: Enable;</b>
> 
> +  **/
> 
> +  UINT8  EnableHwpAutoPerCorePstate     : 1;
> 
> +  /**
> 
> +  HwP Autonomous EPP grouping.
> 
> +  Disabling will set Bit 29 = 1, command 0x11. When set, autonomous will not
> necesarrily request the same value
> 
> +  for all cores with same EPP.
> 
> +  Enabling will clean Bit 29 = 0, command 0x11. Autonomous will request
> same values for all cores with same EPP.
> 
> +  0: Disable;<b> 1: Enable;</b>
> 
> +  **/
> 
> +  UINT8  EnableHwpAutoEppGrouping       : 1;
> 
> +  /**
> 
> +  EPB override over PECI
> 
> +  Enable by sending pcode command 0x2b , subcommand 0x3 to 1.
> 
> +  This will allow OOB EPB PECI override control.
> 
> +  <b>0: Disable;</b> 1: Enable;
> 
> +  **/
> 
> +  UINT8  EnableEpbPeciOverride          : 1;
> 
> +  /**
> 
> +  Support for Fast MSR for IA32_HWP_REQUEST.
> 
> +  On systems with HwP enabled, if this feature is available as indicated by
> MSR 0x65F[0] = 1,
> 
> +  set MSR 0x657[0] = 1.
> 
> +  0: Disable; <b> 1: Enable;</b>
> 
> +  **/
> 
> +  UINT8  EnableFastMsrHwpReq            : 1;
> 
> +  UINT8  ReservedBits1                  : 1;      ///< Reserved for future use.
> 
> +  UINT8  MinRingRatioLimit;                       ///< Minimum Ring Ratio Limit. Range
> from 0 to Max Turbo Ratio. 0 = AUTO/HW Default
> 
> +  UINT8  MaxRingRatioLimit;                       ///< Maximum Ring Ratio Limit.
> Range from 0 to Max Turbo Ratio. 0 = AUTO/HW Default
> 
> +  /**
> 
> +  Package Long duration turbo mode power limit (PL1).
> 
> +  Default is the TDP power limit of processor. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  **/
> 
> +  UINT16 PowerLimit1;
> 
> +  /**
> 
> +  Package Short duration turbo mode power limit (PL2). Allows for short
> excursions above TDP power limit.
> 
> +  Default = 1.25 * TDP Power Limit. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  **/
> 
> +  UINT16 PowerLimit2Power;
> 
> +  /**
> 
> +  Package PL3 power limit. PL3 is the CPU Peak Power Occurences Limit.
> 
> +  <b>Default: 0</b>. Range 0-65535. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  **/
> 
> +  UINT16 PowerLimit3;
> 
> +  /**
> 
> +  Package PL4 power limit. PL4 is a Preemptive CPU Package Peak Power
> Limit, it will never be exceeded.
> 
> +  Power is premptively lowered before limit is reached. <b>Default: 0</b>.
> Range 0-65535.
> 
> +  Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  **/
> 
> +  UINT16 PowerLimit4;
> 
> +  /**
> 
> +  Package Long duration turbo mode power limit (PL1) time window in
> seconds.
> 
> +  Used in calculating the average power over time.
> 
> +  Mobile: <b> 28s</b>
> 
> +  Desktop: <b> 8s</b>
> 
> +  Range: 0 - 128s
> 
> +  **/
> 
> +  UINT32 PowerLimit1Time;
> 
> +  UINT32 PowerLimit3Time;                         ///< Package PL3 time window.
> Range from 3ms to 64ms.
> 
> +  /**
> 
> +  Tcc Offset Time Window can range from 5ms to 448000ms for Runtime
> Average Temperature Limit (RATL).
> 
> +  For Y SKU, the recommended default for this policy is <b>5000: 5
> seconds</b>, For all other SKUs the recommended default are <b>0:
> Disabled</b>
> 
> +  **/
> 
> +  UINT32 TccOffsetTimeWindowForRatl;
> 
> +  /**
> 
> +  Customize the VccIn Demotion in ms accordingly. Values used by OEM
> expected to be in lower end of 1-30 ms range.
> 
> +  Value 1 means 1ms, value 2 means 2ms, and so on. Value 0 will disable
> VccIn Demotion knob.
> 
> +  <b> It's 30ms by silicon default</b>.
> 
> +  **/
> 
> +  UINT32 VccInDemotionMs;
> 
> +} CPU_POWER_MGMT_BASIC_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_POWER_MGMT_BASIC_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tCustomConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tCustomConfig.h
> new file mode 100644
> index 0000000000..e1a5bcc684
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tCustomConfig.h
> @@ -0,0 +1,76 @@
> +/** @file
> 
> +  CPU Power Managment Custom Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
> 
> +#define _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
> 
> +
> 
> +#define CPU_POWER_MGMT_CUSTOM_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gCpuPowerMgmtCustomConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// Defines the maximum number of custom ratio states supported.
> 
> +///
> 
> +#define MAX_CUSTOM_RATIO_TABLE_ENTRIES    40
> 
> +#define MAX_16_CUSTOM_RATIO_TABLE_ENTRIES 16
> 
> +
> 
> +///
> 
> +/// Defines the maximum number of custom ConfigTdp entries supported.
> 
> +/// @warning: Changing this define would cause DWORD alignment issues
> in policy structures.
> 
> +///
> 
> +#define MAX_CUSTOM_CTDP_ENTRIES 3
> 
> +
> 
> +///
> 
> +/// This structure is used to describe the custom processor ratio table
> desired by the platform.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8  MaxRatio;                                           ///< The maximum ratio of the
> custom ratio table.
> 
> +  UINT8  NumberOfEntries;                                    ///< The number of custom
> ratio state entries, ranges from 2 to 40 for a valid custom ratio table.
> 
> +  UINT8  Rsvd0[2];                                           ///< Reserved for DWORD
> alignment.
> 
> +  UINT32 Cpuid;                                              ///< The CPU ID for which this custom
> ratio table applies.
> 
> +  UINT8  StateRatio[MAX_CUSTOM_RATIO_TABLE_ENTRIES];         ///< The
> processor ratios in the custom ratio table.
> 
> +  ///
> 
> +  /// If there are more than 16 total entries in the StateRatio table, then use
> these 16 entries to fill max 16 table.
> 
> +  /// @note If NumberOfEntries is 16 or less, or the first entry of this table is
> 0, then this table is ignored,
> 
> +  /// and up to the top 16 values from the StateRatio table is used instead.
> 
> +  ///
> 
> +  UINT8  StateRatioMax16[MAX_16_CUSTOM_RATIO_TABLE_ENTRIES];
> 
> +#if ((MAX_CUSTOM_RATIO_TABLE_ENTRIES +
> MAX_16_CUSTOM_RATIO_TABLE_ENTRIES) % 4)
> 
> +  UINT8  Rsvd1[4 - ((MAX_CUSTOM_RATIO_TABLE_ENTRIES +
> MAX_16_CUSTOM_RATIO_TABLE_ENTRIES) % 4)];  ///< If needed, add
> padding for dword alignment.
> 
> +#endif
> 
> +} PPM_CUSTOM_RATIO_TABLE;
> 
> +
> 
> +///
> 
> +/// PPM Custom ConfigTdp Settings
> 
> +///
> 
> +typedef struct _PPM_CUSTOM_CTDP_TABLE {
> 
> +  UINT32 CustomPowerLimit1Time      :  8;            ///< Short term Power Limit
> time window value for custom cTDP level.
> 
> +  UINT32 CustomTurboActivationRatio :  8;            ///< Turbo Activation Ratio
> for custom cTDP level.
> 
> +  UINT32 RsvdBits                   : 16;            ///< Bits reserved for DWORD
> alignment.
> 
> +  UINT16 CustomPowerLimit1;                          ///< Short term Power Limit
> value for custom cTDP level. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  UINT16 CustomPowerLimit2;                          ///< Long term Power Limit value
> for custom cTDP level. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +} PPM_CUSTOM_CTDP_TABLE;
> 
> +
> 
> +/**
> 
> +  CPU Power Management Custom Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER    Header;                                                ///< Config
> Block Header
> 
> +  PPM_CUSTOM_RATIO_TABLE CustomRatioTable;                                      ///<
> Custom Processor Ratio Table Instance
> 
> +  PPM_CUSTOM_CTDP_TABLE
> CustomConfigTdpTable[MAX_CUSTOM_CTDP_ENTRIES];         ///< Custom
> ConfigTdp Settings Instance
> 
> +  UINT32                 ConfigTdpLock  : 1;                                    ///< Lock the
> ConfigTdp mode settings from runtime changes; <b>0: Disable</b>; 1:
> Enable.
> 
> +  UINT32                 ConfigTdpBios  : 1;                                    ///< Configure
> whether to load Configurable TDP SSDT; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32                 RsvdBits       : 30;                                   ///< Reserved for future
> use
> 
> +} CPU_POWER_MGMT_CUSTOM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_POWER_MGMT_CUSTOM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tPsysConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tPsysConfig.h
> new file mode 100644
> index 0000000000..f1ceb8f43b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tPsysConfig.h
> @@ -0,0 +1,36 @@
> +/** @file
> 
> +  CPU Power Management Psys(Platform) Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POWER_MGMT_PSYS_CONFIG_H_
> 
> +#define _CPU_POWER_MGMT_PSYS_CONFIG_H_
> 
> +
> 
> +#define CPU_POWER_MGMT_PSYS_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gCpuPowerMgmtPsysConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Power Management Psys(Platform) Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  UINT32 PsysPowerLimit1       : 1;               ///< MSR 0x65C[15]: PL1 Enable
> activates the PL1 value to limit average platform power
> 
> +  UINT32 PsysPowerLimit1Time   : 8;               ///< MSR 0x65C[23:17]: PL1
> timewindow in seconds.
> 
> +  UINT32 PsysPowerLimit2       : 1;               ///< MSR 0x65C[47]: PL2 Enable
> activates the PL2 value to limit average platform power
> 
> +  UINT32 RsvdBits              : 22;              ///< Reserved for future use.
> 
> +  UINT16 PsysPowerLimit1Power;                    ///< MSR 0x65C[14:0]: Platform
> PL1 power. Units are based on POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  UINT16 PsysPowerLimit2Power;                    ///< MSR 0x65C[46:32]]:
> Platform PL2 power. Units are based on
> POWER_MGMT_CONFIG.CustomPowerUnit.
> 
> +  UINT16 PsysPmax;                                ///< PCODE MMIO Mailbox: Platform
> Power Pmax. <b>0 - Auto</b> Specified in 1/8 Watt increments. 0-1024
> Watts. Value of 800 = 100W.
> 
> +  UINT8  Rsvd[2];                                 ///< Reserved for future use and config
> block alignment
> 
> +} CPU_POWER_MGMT_PSYS_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_POWER_MGMT_PSYS_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tTestConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tTestConfig.h
> new file mode 100644
> index 0000000000..bd641f27c5
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuPowerMgm
> tTestConfig.h
> @@ -0,0 +1,150 @@
> +/** @file
> 
> +  CPU Power Management Test Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POWER_MGMT_TEST_CONFIG_H_
> 
> +#define _CPU_POWER_MGMT_TEST_CONFIG_H_
> 
> +
> 
> +#define CPU_POWER_MGMT_TEST_CONFIG_REVISION 4
> 
> +
> 
> +extern EFI_GUID gCpuPowerMgmtTestConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// PPM Package C State Limit
> 
> +///
> 
> +typedef enum {
> 
> +  PkgC0C1                 = 0,
> 
> +  PkgC2,
> 
> +  PkgC3,
> 
> +  PkgC6,
> 
> +  PkgC7,
> 
> +  PkgC7s,
> 
> +  PkgC8,
> 
> +  PkgC9,
> 
> +  PkgC10,
> 
> +  PkgCMax,
> 
> +  PkgCpuDefault = 254,
> 
> +  PkgAuto = 255
> 
> +} MAX_PKG_C_STATE;
> 
> +
> 
> +///
> 
> +/// PPM Package C State Time Limit
> 
> +///
> 
> +typedef enum {
> 
> +  TimeUnit1ns             = 0,
> 
> +  TimeUnit32ns,
> 
> +  TimeUnit1024ns,
> 
> +  TimeUnit32768ns,
> 
> +  TimeUnit1048576ns,
> 
> +  TimeUnit33554432ns,
> 
> +  TimeUnitMax
> 
> +} C_STATE_TIME_UNIT;
> 
> +
> 
> +///
> 
> +/// Custom Power Units. User can choose to enter in watts or 125 milliwatt
> increments.
> 
> +///
> 
> +typedef enum {
> 
> +  PowerUnitWatts = 0,     ///< in Watts.
> 
> +  PowerUnit125MilliWatts, ///< in 125 milliwatt increments. Example: 90
> power units times 125 mW equals 11.250 W.
> 
> +  PowerUnitMax
> 
> +} CUSTOM_POWER_UNIT;
> 
> +
> 
> +///
> 
> +/// PPM Interrupt Redirection Mode Selection
> 
> +///
> 
> +typedef enum {
> 
> +  PpmIrmFixedPriority     = 0,
> 
> +  PpmIrmRoundRobin,
> 
> +  PpmIrmHashVector,
> 
> +  PpmIrmReserved1,
> 
> +  PpmIrmReserved2,
> 
> +  PpmIrmReserved3,
> 
> +  PpmIrmReserved4,
> 
> +  PpmIrmNoChange
> 
> +} PPM_IRM_SETTING;
> 
> +
> 
> +/**
> 
> +  CPU Power Management Test Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Add  CstateLatencyControl0TimeUnit for WHL only
> 
> +  - Add  CstateLatencyControl0Irtl for WHL only
> 
> +  <b>Revision 3</b>:
> 
> +  - Change C State LatencyContol to Auto as default.
> 
> +  <b>Revision 4</b>:
> 
> +  - Deprecate ConfigTdpLevel. Move to premem.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                    ///< Offset 0-27  Config Block
> Header
> 
> +  UINT32 Eist                          : 1;        ///< Offset 28-31 Enable or Disable Intel
> SpeedStep Technology. 0: Disable; <b>1: Enable</b>
> 
> +  UINT32 EnergyEfficientPState         : 1;        ///<              Enable or Disable
> Energy Efficient P-state will be applied in Turbo mode. Disable; <b>1:
> Enable</b>
> 
> +  UINT32 EnergyEfficientTurbo          : 1;        ///<              Enable or Disable
> Energy Efficient Turbo, will be applied in Turbo mode. Disable; <b>1:
> Enable</b>
> 
> +  UINT32 TStates                       : 1;        ///<              Enable or Disable T states;
> <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 BiProcHot                     : 1;        ///<              Enable or Disable Bi-
> Directional PROCHOT#; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32 DisableProcHotOut             : 1;        ///<              Enable or Disable
> PROCHOT# signal being driven externally; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32 ProcHotResponse               : 1;        ///<              Enable or Disable
> PROCHOT# Response; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 DisableVrThermalAlert         : 1;        ///<              Enable or Disable VR
> Thermal Alert; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 EnableAllThermalFunctions     : 1;        ///<              Enable or Disable
> Thermal Reporting through ACPI tables; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32 ThermalMonitor                : 1;        ///<              Enable or Disable
> Thermal Monitor; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32 Cx                            : 1;        ///<              Enable or Disable CPU power
> states (C-states). 0: Disable; <b>1: Enable</b>
> 
> +  UINT32 PmgCstCfgCtrlLock             : 1;        ///<              If enabled, sets MSR
> 0xE2[15]; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32 C1e                           : 1;        ///<              Enable or Disable Enhanced C-
> states. 0: Disable; <b>1: Enable</b>
> 
> +  UINT32 C1AutoDemotion                : 1;        ///<              Enable or Disable C6/C7
> auto demotion to C1. 0: Disabled; <b>1: C1 Auto demotion</b>
> 
> +  UINT32 C1UnDemotion                  : 1;        ///<              Enable or Disable
> C1UnDemotion. 0: Disabled; <b>1: C1 Auto undemotion</b>
> 
> +  UINT32 C3AutoDemotion                : 1;        ///<              [CoffeeLake Only]
> Enable or Disable C6/C7 auto demotion to C3  0: Disabled; <b>1: C3 Auto
> demotion</b>
> 
> +  UINT32 C3UnDemotion                  : 1;        ///<              [CoffeeLake Only]
> Enable or Disable C3UnDemotion. 0: Disabled; <b>1: C3 Auto
> undemotion</b>
> 
> +  UINT32 PkgCStateDemotion             : 1;        ///<              Enable or Disable
> Package Cstate Demotion. Disable; <b>1: Enable</b> [WhiskeyLake]
> <b>Disable</b>; 1: Enable
> 
> +  UINT32 PkgCStateUnDemotion           : 1;        ///<              Enable or Disable
> Package Cstate UnDemotion. Disable; <b>1: Enable</b> [WhiskeyLake]
> <b>Disable</b>; 1: Enable
> 
> +  UINT32 CStatePreWake                 : 1;        ///<              Enable or Disable
> CState-Pre wake. Disable; <b>1: Enable</b>
> 
> +  UINT32 TimedMwait                    : 1;        ///<              Enable or Disable
> TimedMwait Support. <b>Disable</b>; 1: Enable
> 
> +  UINT32 CstCfgCtrIoMwaitRedirection   : 1;        ///<              Enable or Disable
> IO to MWAIT redirection; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 ProcHotLock                   : 1;        ///<              If enabled, sets MSR
> 0x1FC[23]; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 RaceToHalt                    : 1;        ///<              Enable or Disable Race To
> Halt feature; 0: Disable; <b>1: Enable </b>. RTH will dynamically increase CPU
> frequency in order to enter pkg C-State faster to reduce overall power. (RTH
> is controlled through MSR 1FC bit 20)
> 
> +  UINT32 ConfigTdpLevel                : 8;        ///<              @deprecated. Move to
> premem phase.
> 
> +  UINT16 CstateLatencyControl1Irtl;                ///< Offset 32-33 Interrupt
> Response Time Limit of LatencyContol1 MSR 0x60B[9:0].<b>0 is Auto</b>.
> 
> +  UINT16 CstateLatencyControl2Irtl;                ///< Offset 34-35 Interrupt
> Response Time Limit of LatencyContol2 MSR 0x60C[9:0].<b>0 is Auto</b>.
> 
> +  UINT16 CstateLatencyControl3Irtl;                ///< Offset 36-37 Interrupt
> Response Time Limit of LatencyContol3 MSR 0x633[9:0].<b>0 is Auto</b>.
> 
> +  UINT16 CstateLatencyControl4Irtl;                ///< Offset 38-39 Interrupt
> Response Time Limit of LatencyContol4 MSR 0x634[9:0].<b>0 is Auto</b>.
> 
> +  UINT16 CstateLatencyControl5Irtl;                ///< Offset 40-41 Interrupt
> Response Time Limit of LatencyContol5 MSR 0x635[9:0].<b>0 is Auto</b>.
> 
> +  // Due to the removal of CstateLatencyControl0Irtl, PkgCStateLimit is not
> aligned to 32-bit address.
> 
> +  UINT8  Rsvd1[2];                                 ///< Offset 42-43 Reserved for config
> block alignment.
> 
> +  MAX_PKG_C_STATE   PkgCStateLimit;                ///< Offset 44    This field is
> used to set the Max Pkg Cstate. Default set to Auto which limits the Max Pkg
> Cstate to deep C-state.
> 
> +  /**
> 
> +     @todo: The following enums have to be replaced with policies.
> 
> +  **/
> 
> +  C_STATE_TIME_UNIT Reserved;                      ///< Offset 45    Reserved for
> config block alignment.
> 
> +  C_STATE_TIME_UNIT CstateLatencyControl1TimeUnit; ///< Offset 46
> TimeUnit for Latency Control1 MSR 0x60B[12:10]; <b>2: 1024ns</b>.
> 
> +  C_STATE_TIME_UNIT CstateLatencyControl2TimeUnit; ///< Offset 47
> TimeUnit for Latency Control2 MSR 0x60C[12:10]; <b>2: 1024ns</b>.
> 
> +  C_STATE_TIME_UNIT CstateLatencyControl3TimeUnit; ///< Offset 48
> TimeUnit for Latency Control3 MSR 0x633[12:10]; <b>2: 1024ns</b>.
> 
> +  C_STATE_TIME_UNIT CstateLatencyControl4TimeUnit; ///< Offset 49
> TimeUnit for Latency Control4 MSR 0x634[12:10]; <b>2: 1024ns</b>.
> 
> +  C_STATE_TIME_UNIT CstateLatencyControl5TimeUnit; ///< Offset 50
> TimeUnit for Latency Control5 MSR 0x635[12:10]; <b>2: 1024ns</b>.
> 
> +  /**
> 
> +  Offset 51  Default power unit in watts or in 125 milliwatt increments.
> 
> +  - 0: PowerUnitWatts.
> 
> +  - <b>1: PowerUnit125MilliWatts</b>.
> 
> +  **/
> 
> +  CUSTOM_POWER_UNIT CustomPowerUnit;
> 
> +  /**
> 
> +  Offset 52  Interrupt Redirection Mode Select.
> 
> +   - 0: Fixed priority.             //Default under CNL.
> 
> +   - 1: Round robin.
> 
> +   - 2: Hash vector.
> 
> +   - 4: PAIR with fixed priority.   //Default under KBL, not available under CNL.
> 
> +   - 5: PAIR with round robin.      //Not available under CNL.
> 
> +   - 6: PAIR with hash vector.      //Not available under CNL.
> 
> +   - 7: No change.
> 
> +  **/
> 
> +  PPM_IRM_SETTING      PpmIrmSetting;
> 
> +  // Move the padding to previous offset to align the structure at 32-bit
> address.
> 
> +  UINT8  Rsvd[4];                                 ///< Offset 53-56 Reserved for future use
> and config block alignment
> 
> +} CPU_POWER_MGMT_TEST_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_POWER_MGMT_TEST_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPre
> MemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPre
> MemConfig.h
> new file mode 100644
> index 0000000000..24614fe497
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuSecurityPre
> MemConfig.h
> @@ -0,0 +1,63 @@
> +/** @file
> 
> +  CPU Security PreMemory Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_SECURITY_PREMEM_CONFIG_H_
> 
> +#define _CPU_SECURITY_PREMEM_CONFIG_H_
> 
> +
> 
> +#define CPU_SECURITY_PREMEM_CONFIG_REVISION 1
> 
> +
> 
> +extern EFI_GUID gCpuSecurityPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Security PreMemory Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER Header;                      ///< Config Block Header
> 
> +  UINT32              PrmrrSize;                   ///< PRMRR Size.<b>Software Control:
> 0x0</b>  32MB: 0x2000000, 64MB: 0x4000000, 128 MB: 0x8000000, 256 MB:
> 0x10000000, 512 MB: 0x20000000
> 
> +  UINT16              BiosSize;                    ///< Flash information for BIOS Guard:
> BIOS Size in KB.
> 
> +  UINT8               Reserved[2];                 ///< Reserved for future use
> 
> +/**
> 
> +   Enable or Disable BIOS Guard; 0: Disable; <b>1: Enable</b>.
> 
> +    - This is an optional feature and can be opted out.
> 
> +    - If this policy is set to Disabled, the policies in the BIOS_GUARD_CONFIG
> will be ignored.
> 
> +    - If PeiBiosGuardLibNull is used, this policy will have no effect.
> 
> +**/
> 
> +  UINT32              BiosGuard               :  1;
> 
> +  UINT32              BiosGuardToolsInterface :  1; ///< BIOS Guard Tools
> Interface; <b>0: Disable</b>, 1:Enable
> 
> +/**
> 
> +   Enable or Disable Software Guard Extensions; <b>0: Disable</b>; 1:
> Enable.
> 
> +    - This is an optional feature and can be opted out.
> 
> +    - If this policy is set to Disabled, the policies in the CPU_SGX_CONFIG will
> be ignored.
> 
> +    - If BaseSoftwareGuardLibNull is used, this policy will have no effect.
> 
> +**/
> 
> +  UINT32              EnableSgx               :  1;
> 
> +/**
> 
> +   Enable or Disable Trusted Execution Technology; <b>0: Disable</b>; 1:
> Enable.
> 
> +    - This is an optional feature and can be opted out.
> 
> +    - If this policy is set to Disabled, the policies in the
> CPU_TXT_PREMEM_CONFIG will be ignored.
> 
> +    - If PeiTxtLibNull is used, this policy will have no effect.
> 
> +**/
> 
> +  UINT32              Txt                     :  1;
> 
> +  UINT32              SkipStopPbet            :  1; ///< <b>(Test)</b> Skip Stop PBET
> Timer; <b>0: Disable</b>; 1: Enable.
> 
> +  ///
> 
> +  /// <b>(Test)</b> This policy indicates whether or not BIOS should allocate
> PRMRR memory for C6DRAM power gating feature.
> 
> +  ///  - 0: Don't allocate any PRMRR memory for C6DRAM power gating
> feature.
> 
> +  ///  - <b>1: Allocate PRMRR memory for C6DRAM power gating
> feature</b>.
> 
> +  ///
> 
> +  UINT32              EnableC6Dram            :  1;
> 
> +  UINT32              ResetAux                :  1; ///< <b>(Test)</b> Reset Auxiliary
> content, <b>0: Disabled</b>, 1: Enabled
> 
> +  UINT32              TxtAcheckRequest        :  1; ///< <b>(Test)</b>
> AcheckRequest <b>0: Disabled</b>, 1: Enabled. When Enabled, it will call
> Acheck regardless of crashcode value
> 
> +  UINT32              RsvdBits                : 24; ///< Reserved for future use
> 
> +} CPU_SECURITY_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_SECURITY_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.
> h
> new file mode 100644
> index 0000000000..ee946290e0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/ConfigBlock/CpuTestConfig.
> h
> @@ -0,0 +1,51 @@
> +/** @file
> 
> +  CPU Test Config Block.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_TEST_CONFIG_H_
> 
> +#define _CPU_TEST_CONFIG_H_
> 
> +
> 
> +#define CPU_TEST_CONFIG_REVISION 2
> 
> +
> 
> +extern EFI_GUID gCpuTestConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  CPU Test Configuration Structure.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Removed Voltage Optimization feature.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  UINT32                MlcStreamerPrefetcher           : 1;     ///< Enable or Disable
> MLC Streamer Prefetcher; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32                MlcSpatialPrefetcher            : 1;     ///< Enable or Disable MLC
> Spatial Prefetcher; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32                MonitorMwaitEnable              : 1;     ///< Enable or Disable
> Monitor /MWAIT instructions; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32                MachineCheckEnable              : 1;     ///< Enable or Disable
> initialization of machine check registers; 0: Disable; <b>1: Enable</b>.
> 
> +  UINT32                ProcessorTraceOutputScheme      : 1;     ///< Control on
> Processor Trace output scheme; <b>0: Single Range Output</b>; 1: ToPA
> Output.
> 
> +  UINT32                ProcessorTraceEnable            : 1;     ///< Enable or Disable
> Processor Trace feature; <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32                ThreeStrikeCounterDisable       : 1;     ///< Disable Three
> strike counter; <b>0: FALSE</b>; 1: TRUE.
> 
> +  UINT32                RsvdBits                        : 25;     ///< Reserved for future use
> 
> +  /**
> 
> +     Base address of memory region allocated for Processor Trace.
> 
> +     Processor Trace requires 2^N alignment and size in bytes per thread,
> from 4KB to 128MB.
> 
> +     - <b>NULL: Disable</b>
> 
> +  **/
> 
> +  EFI_PHYSICAL_ADDRESS  ProcessorTraceMemBase;
> 
> +  /**
> 
> +     Length in bytes of memory region allocated for Processor Trace.
> 
> +     Processor Trace requires 2^N alignment and size in bytes per thread,
> from 4KB to 128MB.
> 
> +     - <b>0: Disable</b>
> 
> +  **/
> 
> +  UINT32                ProcessorTraceMemLength;
> 
> +  UINT8                 Reserved0[4];
> 
> +} CPU_TEST_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CPU_TEST_CONFIG_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h
> new file mode 100644
> index 0000000000..5d5e4df071
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuAccess.h
> @@ -0,0 +1,12 @@
> +/** @file
> 
> +  Macros to simplify and abstract the interface to CPU configuration.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPUACCESS_H_
> 
> +#define _CPUACCESS_H_
> 
> +
> 
> +#include "CpuDataStruct.h"
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h
> new file mode 100644
> index 0000000000..ba9a840e54
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuDataStruct.h
> @@ -0,0 +1,21 @@
> +/** @file
> 
> +  This file declares various data structures used in CPU reference code.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _CPU_DATA_STRUCT_H
> 
> +#define _CPU_DATA_STRUCT_H
> 
> +
> 
> +///
> 
> +/// Structure to hold the return value of AsmCpuid instruction
> 
> +///
> 
> +typedef struct {
> 
> +  UINT32 RegEax; ///< Value of EAX.
> 
> +  UINT32 RegEbx; ///< Value of EBX.
> 
> +  UINT32 RegEcx; ///< Value of ECX.
> 
> +  UINT32 RegEdx; ///< Value of EDX.
> 
> +} EFI_CPUID_REGISTER;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
> new file mode 100644
> index 0000000000..1178f68d0c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/CpuPolicyCommon.h
> @@ -0,0 +1,23 @@
> +/** @file
> 
> +  CPU Policy Structure definition which will contain several config blocks
> during runtime.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_POLICY_COMMON_H_
> 
> +#define _CPU_POLICY_COMMON_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <ConfigBlock/CpuConfig.h>
> 
> +#include <ConfigBlock/CpuPidTestConfig.h>
> 
> +#include <ConfigBlock/CpuPowerMgmtBasicConfig.h>
> 
> +#include <ConfigBlock/CpuPowerMgmtCustomConfig.h>
> 
> +#include <ConfigBlock/CpuPowerMgmtPsysConfig.h>
> 
> +#include <ConfigBlock/CpuPowerMgmtTestConfig.h>
> 
> +#include <ConfigBlock/VoltageRegulator/CpuPowerMgmtVrConfig.h>
> 
> +#include <ConfigBlock/CpuTestConfig.h>
> 
> +#include <ConfigBlock/CpuSecurityPreMemConfig.h>
> 
> +#include <ConfigBlock/CpuConfigLibPreMemConfig.h>
> 
> +#include <OverclockingConfig.h>
> 
> +
> 
> +#endif // _CPU_POLICY_COMMON_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
> new file mode 100644
> index 0000000000..a2cd1db1d6
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Cpu/Include/Register/CommonMsr.h
> @@ -0,0 +1,18 @@
> +
> 
> +/** @file
> 
> +  CommonMsr.h
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _COMMONMSR_h
> 
> +#define _COMMONMSR_h
> 
> +#include <Base.h>
> 
> +
> 
> +/**
> 
> +  Special Chipset Usage MSR
> 
> +**/
> 
> +#define MSR_SPCL_CHIPSET_USAGE 0x000001FE
> 
> +
> 
> +#endif /* _COMMONMSR_h */
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers
  2021-02-01  1:36 ` [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Pch/Include
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtectionCo
> nfig.h   |  55
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
> |  57
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h
> |  58
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.h
> |  64
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig.h
> |  61
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
> |  38 ++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConfig.
> h        |  72
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.h
> | 258
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h                  |
> 590
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
> | 552
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h                          |  70
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h                           |  67
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
> |  55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h
> |  56
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
> |  21 +++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
> | 184
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch.h
> | 134
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch.h
> | 144
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch.h
> | 166
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h                  |
> 40 ++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
> | 132
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapContro
> l.h        |  65
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTime
> rControl.h |  65
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.h
> | 150
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h                    |
> 16 ++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
> | 145
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
> |  50 ++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
> |  66
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++
>  28 files changed, 3431 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtection
> Config.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtection
> Config.h
> new file mode 100644
> index 0000000000..d1e10c3422
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/FlashProtection
> Config.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  FlashProtection policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _FLASH_PROTECTION_CONFIG_H_
> 
> +#define _FLASH_PROTECTION_CONFIG_H_
> 
> +
> 
> +#define FLASH_PROTECTION_CONFIG_REVISION 1
> 
> +extern EFI_GUID gFlashProtectionConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +//
> 
> +// Flash Protection Range Register
> 
> +//
> 
> +#define PCH_FLASH_PROTECTED_RANGES         5
> 
> +
> 
> +/**
> 
> +  Protected Flash Range
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32                WriteProtectionEnable     :  1;     ///< Write or erase is
> blocked by hardware. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32                ReadProtectionEnable      :  1;     ///< Read is blocked by
> hardware. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32                RsvdBits                  :  30;    ///< Reserved
> 
> +  /**
> 
> +    The address of the upper limit of protection
> 
> +    This is a left shifted address by 12 bits with address bits 11:0 are assumed
> to be FFFh for limit comparison
> 
> +  **/
> 
> +  UINT16                ProtectedRangeLimit;
> 
> +  /**
> 
> +    The address of the upper limit of protection
> 
> +    This is a left shifted address by 12 bits with address bits 11:0 are assumed
> to be 0
> 
> +  **/
> 
> +  UINT16                ProtectedRangeBase;
> 
> +} PROTECTED_RANGE;
> 
> +
> 
> +/**
> 
> +  The PCH provides a method for blocking writes and reads to specific ranges
> 
> +  in the SPI flash when the Protected Ranges are enabled.
> 
> +  PROTECTED_RANGE is used to specify if flash protection are enabled,
> 
> +  the write protection enable bit and the read protection enable bit,
> 
> +  and to specify the upper limit and lower base for each register
> 
> +  Platform code is responsible to get the range base by
> PchGetSpiRegionAddresses routine,
> 
> +  and set the limit and base accordingly.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                                     ///< Config Block
> Header
> 
> +  PROTECTED_RANGE       ProtectRange[PCH_FLASH_PROTECTED_RANGES];
> ///< Protected Flash Ranges
> 
> +} PCH_FLASH_PROTECTION_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _FLASH_PROTECTION_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
> new file mode 100644
> index 0000000000..ec27845a48
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioConfig.h
> @@ -0,0 +1,57 @@
> +/** @file
> 
> +  HSIO policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HSIO_CONFIG_H_
> 
> +#define _HSIO_CONFIG_H_
> 
> +#define HSIO_PREMEM_CONFIG_REVISION 1 //@deprecated
> 
> +extern EFI_GUID gHsioPreMemConfigGuid; //@deprecated
> 
> +
> 
> +#define HSIO_CONFIG_REVISION 1
> 
> +extern EFI_GUID gHsioConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PCH_HSIO_PREMEM_CONFIG block provides HSIO message related
> settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +
> 
> +  /**
> 
> +  <b>(Test)</b>
> 
> +  0- Disable, disable will prevent the HSIO version check and ChipsetInit HECI
> message from being sent
> 
> +  <b>1- Enable</b> ChipsetInit HECI message
> 
> +  **/
> 
> +  UINT8     ChipsetInitMessage;
> 
> +  /**
> 
> +  <b>(Test)</b>
> 
> +  <b>0- Disable</b>
> 
> +  1- Enable When enabled, this is used to bypass the reset after ChipsetInit
> HECI message.
> 
> +  **/
> 
> +  UINT8     BypassPhySyncReset;
> 
> +  UINT8     RsvdBytes[2];
> 
> +
> 
> +} PCH_HSIO_PREMEM_CONFIG;
> 
> +
> 
> +
> 
> +/**
> 
> +  The PCH_HSIO_CONFIG block provides HSIO message related settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;         ///< Config Block Header
> 
> +  /**
> 
> +    Policy used to point to the Base (+ OEM) ChipsetInit binary used to sync
> between BIOS and CSME
> 
> +  **/
> 
> +  UINT32    ChipsetInitBinPtr;
> 
> +  /**
> 
> +    Policy used to indicate the size of the Base (+ OEM) ChipsetInit binary
> used to sync between BIOS and CSME
> 
> +  **/
> 
> +  UINT32    ChipsetInitBinLen;
> 
> +} PCH_HSIO_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _HSIO_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.
> h
> new file mode 100644
> index 0000000000..bc23f3e1a6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioPcieConfig.
> h
> @@ -0,0 +1,58 @@
> +/** @file
> 
> +  HSIO pcie policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HSIO_PCIE_CONFIG_H_
> 
> +#define _HSIO_PCIE_CONFIG_H_
> 
> +
> 
> +#include <PchLimits.h>
> 
> +
> 
> +#define HSIO_PCIE_PREMEM_CONFIG_REVISION 1
> 
> +extern EFI_GUID gHsioPciePreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PCH_HSIO_PCIE_LANE_CONFIG describes HSIO settings for PCIe lane
> 
> +**/
> 
> +typedef struct {
> 
> +  //
> 
> +  // HSIO Rx Eq
> 
> +  // Refer to the EDS for recommended values.
> 
> +  // Note that these setting are per-lane and not per-port
> 
> +  //
> 
> +  UINT32  HsioRxSetCtleEnable           : 1;      ///< <b>0: Disable</b>; 1: Enable
> PCH PCIe Gen 3 Set CTLE Value
> 
> +  UINT32  HsioRxSetCtle                 : 6;      ///< PCH PCIe Gen 3 Set CTLE Value
> 
> +  UINT32  HsioTxGen1DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>;
> 1: Enable PCH PCIe Gen 1 TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen1DownscaleAmp        : 6;      ///< PCH PCIe Gen 1 TX
> Output Downscale Amplitude Adjustment value
> 
> +  UINT32  HsioTxGen2DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>;
> 1: Enable PCH PCIe Gen 2 TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen2DownscaleAmp        : 6;      ///< PCH PCIe Gen 2 TX
> Output Downscale Amplitude Adjustment value
> 
> +  UINT32  HsioTxGen3DownscaleAmpEnable  : 1;      ///< <b>0: Disable</b>;
> 1: Enable PCH PCIe Gen 3 TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen3DownscaleAmp        : 6;      ///< PCH PCIe Gen 3 TX
> Output Downscale Amplitude Adjustment value
> 
> +  UINT32  RsvdBits0                     : 4;      ///< Reserved Bits
> 
> +
> 
> +  UINT32  HsioTxGen1DeEmphEnable        : 1;      ///< <b>0: Disable</b>; 1:
> Enable PCH PCIe Gen 1 TX Output De-Emphasis Adjustment Setting value
> override
> 
> +  UINT32  HsioTxGen1DeEmph              : 6;      ///< PCH PCIe Gen 1 TX Output
> De-Emphasis Adjustment Setting
> 
> +  UINT32  HsioTxGen2DeEmph3p5Enable     : 1;      ///< <b>0: Disable</b>; 1:
> Enable PCH PCIe Gen 2 TX Output -3.5dB Mode De-Emphasis Adjustment
> Setting value override
> 
> +  UINT32  HsioTxGen2DeEmph3p5           : 6;      ///< PCH PCIe Gen 2 TX Output
> -3.5dB Mode De-Emphasis Adjustment Setting
> 
> +  UINT32  HsioTxGen2DeEmph6p0Enable     : 1;      ///< <b>0: Disable</b>; 1:
> Enable PCH PCIe Gen 2 TX Output -6.0dB Mode De-Emphasis Adjustment
> Setting value override
> 
> +  UINT32  HsioTxGen2DeEmph6p0           : 6;      ///< PCH PCIe Gen 2 TX Output
> -6.0dB Mode De-Emphasis Adjustment Setting
> 
> +  UINT32  RsvdBits1                     : 11;     ///< Reserved Bits
> 
> +} PCH_HSIO_PCIE_LANE_CONFIG;
> 
> +
> 
> +///
> 
> +/// The PCH_HSIO_PCIE_CONFIG block describes the configuration of the
> HSIO for PCIe lanes
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  ///
> 
> +  /// These members describe the configuration of HSIO for PCIe lanes.
> 
> +  ///
> 
> +  PCH_HSIO_PCIE_LANE_CONFIG         Lane[PCH_MAX_PCIE_ROOT_PORTS];
> 
> +} PCH_HSIO_PCIE_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _HSIO_PCIE_LANE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.
> h
> new file mode 100644
> index 0000000000..21b0d7ff63
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/HsioSataConfig.
> h
> @@ -0,0 +1,64 @@
> +/** @file
> 
> +  Hsio Sata policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HSIO_SATA_CONFIG_H_
> 
> +#define _HSIO_SATA_CONFIG_H_
> 
> +
> 
> +#define HSIO_SATA_PREMEM_CONFIG_REVISION 1
> 
> +extern EFI_GUID gHsioSataPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PCH_HSIO_SATA_PORT_LANE describes HSIO settings for SATA Port
> lane
> 
> +**/
> 
> +typedef struct {
> 
> +  //
> 
> +  // HSIO Rx Eq
> 
> +  //
> 
> +  UINT32  HsioRxGen1EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1:
> Enable Receiver Equalization Boost Magnitude Adjustment Value override
> 
> +  UINT32  HsioRxGen1EqBoostMag         : 6;       ///< SATA 1.5 Gb/sReceiver
> Equalization Boost Magnitude Adjustment value
> 
> +  UINT32  HsioRxGen2EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1:
> Enable Receiver Equalization Boost Magnitude Adjustment Value override
> 
> +  UINT32  HsioRxGen2EqBoostMag         : 6;       ///< SATA 3.0 Gb/sReceiver
> Equalization Boost Magnitude Adjustment value
> 
> +  UINT32  HsioRxGen3EqBoostMagEnable   : 1;       ///< <b>0: Disable</b>; 1:
> Enable Receiver Equalization Boost Magnitude Adjustment Value override
> 
> +  UINT32  HsioRxGen3EqBoostMag         : 6;       ///< SATA 6.0 Gb/sReceiver
> Equalization Boost Magnitude Adjustment value
> 
> +  //
> 
> +  // HSIO Tx Eq
> 
> +  //
> 
> +  UINT32  HsioTxGen1DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>;
> 1: Enable SATA 1.5 Gb/s TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen1DownscaleAmp       : 6;       ///< SATA 1.5 Gb/s TX
> Output Downscale Amplitude Adjustment value
> 
> +  UINT32  RsvdBits0                    : 4;       ///< Reserved bits
> 
> +
> 
> +  UINT32  HsioTxGen2DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>;
> 1: Enable SATA 3.0 Gb/s TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen2DownscaleAmp       : 6;       ///< SATA 3.0 Gb/s TX
> Output Downscale Amplitude Adjustment
> 
> +  UINT32  HsioTxGen3DownscaleAmpEnable : 1;       ///< <b>0: Disable</b>;
> 1: Enable SATA 6.0 Gb/s TX Output Downscale Amplitude Adjustment value
> override
> 
> +  UINT32  HsioTxGen3DownscaleAmp       : 6;       ///< SATA 6.0 Gb/s TX
> Output Downscale Amplitude Adjustment
> 
> +  UINT32  HsioTxGen1DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1:
> Enable SATA 1.5 Gb/s TX Output De-Emphasis Adjustment Setting value
> override
> 
> +  UINT32  HsioTxGen1DeEmph             : 6;       ///< SATA 1.5 Gb/s TX Output
> De-Emphasis Adjustment Setting
> 
> +
> 
> +  UINT32  HsioTxGen2DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1:
> Enable SATA 3.0 Gb/s TX Output De-Emphasis Adjustment Setting value
> override
> 
> +  UINT32  HsioTxGen2DeEmph             : 6;       ///< SATA 3.0 Gb/s TX Output
> De-Emphasis Adjustment Setting
> 
> +  UINT32  RsvdBits1                    : 4;       ///< Reserved bits
> 
> +
> 
> +  UINT32  HsioTxGen3DeEmphEnable       : 1;       ///< <b>0: Disable</b>; 1:
> Enable SATA 6.0 Gb/s TX Output De-Emphasis Adjustment Setting value
> override
> 
> +  UINT32  HsioTxGen3DeEmph             : 6;       ///< SATA 6.0 Gb/s TX Output
> De-Emphasis Adjustment Setting value override
> 
> +  UINT32  RsvdBits2                    : 25;      ///< Reserved bits
> 
> +} PCH_HSIO_SATA_PORT_LANE;
> 
> +
> 
> +///
> 
> +/// The PCH_HSIO_SATA_CONFIG block describes the HSIO configuration of
> the SATA controller.
> 
> +///
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  ///
> 
> +  /// These members describe the configuration of HSIO for SATA lanes.
> 
> +  ///
> 
> +  PCH_HSIO_SATA_PORT_LANE        PortLane[PCH_MAX_SATA_PORTS];
> 
> +} PCH_HSIO_SATA_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _HSIO_SATA_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfig
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfi
> g.h
> new file mode 100644
> index 0000000000..23f116cf3d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LockDownConfi
> g.h
> @@ -0,0 +1,61 @@
> +/** @file
> 
> +  Lock down policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _LOCK_DOWN_CONFIG_H_
> 
> +#define _LOCK_DOWN_CONFIG_H_
> 
> +
> 
> +#define LOCK_DOWN_CONFIG_REVISION 1
> 
> +extern EFI_GUID gLockDownConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  The PCH_LOCK_DOWN_CONFIG block describes the expected
> configuration of the PCH
> 
> +  for security requirement.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    <b>(Test)</b> Enable SMI_LOCK bit to prevent writes to the Global SMI
> Enable bit. 0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32  GlobalSmi      :  1;
> 
> +  /**
> 
> +    <b>(Test)</b> Enable BIOS Interface Lock Down bit to prevent writes to
> the Backup Control Register
> 
> +    Top Swap bit and the General Control and Status Registers Boot BIOS
> Straps.
> 
> +    Intel strongly recommends that BIOS sets the BIOS Interface Lock Down
> bit. Enabling this bit
> 
> +    will mitigate malicious software attempts to replace the system BIOS with
> its own code.
> 
> +    0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32  BiosInterface  :  1;
> 
> +  /**
> 
> +    Enable the BIOS Lock Enable (BLE) feature and set EISS bit
> (D31:F5:RegDCh[5])
> 
> +    for the BIOS region protection. When it is enabled, the BIOS Region can
> only be
> 
> +    modified from SMM.
> 
> +    If this EISS bit is set, then WPD must be a '1' and InSMM.STS must be '1'
> also
> 
> +    in order to write to BIOS regions of SPI Flash. If this EISS bit is clear,
> 
> +    then the InSMM.STS is a don't care.
> 
> +    The BIOS must set the EISS bit while BIOS Guard support is enabled.
> 
> +    In recovery path, platform can temporary disable EISS for SPI
> programming in
> 
> +    PEI phase or early DXE phase.
> 
> +    When PcdSmmVariableEnable is FALSE, to support BIOS regions update
> outside of SMM,
> 
> +    the BiosLock must be set to Disabled by platform.
> 
> +    0: Disable; <b>1: Enable.</b>
> 
> +  **/
> 
> +  UINT32  BiosLock       :  1;
> 
> +  /**
> 
> +    <b>(Test)</b> This test option when set will force all GPIO pads to be
> unlocked
> 
> +    before BIOS transitions to POSTBOOT_SAI. This option should not be
> enabled in production
> 
> +    configuration and used only for debug purpose when free runtime
> reconfiguration of
> 
> +    GPIO pads is needed.
> 
> +    <b>0: Disable</b>; 1: Enable.
> 
> +  **/
> 
> +  UINT32  UnlockGpioPads :  1;
> 
> +  UINT32  RsvdBits0      : 28;             ///< Reserved bits
> 
> +} PCH_LOCK_DOWN_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _LOCK_DOWN_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
> new file mode 100644
> index 0000000000..3fc64aa056
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/LpcConfig.h
> @@ -0,0 +1,38 @@
> +/** @file
> 
> +  Lpc policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _LPC_CONFIG_H_
> 
> +#define _LPC_CONFIG_H_
> 
> +
> 
> +#define LPC_PREMEM_CONFIG_REVISION 1
> 
> +extern EFI_GUID gLpcPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure contains the policies which are related to LPC.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    Enhance the port 8xh decoding.
> 
> +    Original LPC only decodes one byte of port 80h, with this enhancement
> LPC can decode word or dword of port 80h-83h.
> 
> +    @note: this will occupy one LPC generic IO range register. While this is
> enabled, read from port 80h always return 0x00.
> 
> +    0: Disable, <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32    EnhancePort8xhDecoding      :  1;
> 
> +  /**
> 
> +   Hardware Autonomous Enable.
> 
> +   When enabled, LPC will automatically engage power gating when it has
> reached its idle condition.
> 
> +   0: Disable, <b>1: Enable</b>
> 
> +  **/
> 
> +  UINT32    LpcPmHAE                    :  1;
> 
> +  UINT32    RsvdBits                    : 30;     ///< Reserved bits
> 
> +} PCH_LPC_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _LPC_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConf
> ig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConf
> ig.h
> new file mode 100644
> index 0000000000..da77abc1b3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/ConfigBlock/PchGeneralConf
> ig.h
> @@ -0,0 +1,72 @@
> +/** @file
> 
> +  PCH General policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_GENERAL_CONFIG_H_
> 
> +#define _PCH_GENERAL_CONFIG_H_
> 
> +
> 
> +#define PCH_GENERAL_CONFIG_REVISION 1
> 
> +#define PCH_GENERAL_PREMEM_CONFIG_REVISION 2
> 
> +
> 
> +extern EFI_GUID gPchGeneralConfigGuid;
> 
> +extern EFI_GUID gPchGeneralPreMemConfigGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +enum PCH_RESERVED_PAGE_ROUTE {
> 
> +  PchReservedPageToLpc,                   ///< Port 80h cycles are sent to LPC.
> 
> +  PchReservedPageToPcie                   ///< Port 80h cycles are sent to PCIe.
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH General Configuration
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    This member describes whether or not the Compatibility Revision ID
> (CRID) feature
> 
> +    of PCH should be enabled. <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32    Crid            :  1;
> 
> +  /**
> 
> +    Set to enable low latency of legacy IO.
> 
> +    Some systems require lower IO latency irrespective of power.
> 
> +    This is a tradeoff between power and IO latency.
> 
> +    @note: Once this is enabled, DmiAspm, Pcie DmiAspm in SystemAgent
> 
> +    and ITSS Clock Gating are forced to disabled.
> 
> +    <b>0: Disable</b>, 1: Enable
> 
> +  **/
> 
> +  UINT32    LegacyIoLowLatency  :  1;
> 
> +  UINT32    RsvdBits0           : 30;       ///< Reserved bits
> 
> +} PCH_GENERAL_CONFIG;
> 
> +
> 
> +/**
> 
> +  PCH General Pre-Memory Configuration
> 
> +  <b>Revision 1</b>:  - Initial version.
> 
> +  <b>Revision 2</b>:  - Added GpioOverride.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Config Block Header
> 
> +  /**
> 
> +    Control where the Port 80h cycles are sent, <b>0: LPC</b>; 1: PCI.
> 
> +  **/
> 
> +  UINT32    Port80Route     :  1;
> 
> +  UINT32    IotgPllSscEn    :  1;       ///< Need to disable CPU Side SSC for A0 PO
> 
> +  /**
> 
> +    Gpio override Level
> 
> +    -- <b>0: Disable</b>;
> 
> +    -  1: Override Level 1 - only skips GpioSetNativePadByFunction
> 
> +    -  2: Override Level 2 - skips GpioSetNativePadByFunction and
> GpioSetPadMode
> 
> +    Additional policy that allows GPIO configuration to be done by external
> means.
> 
> +    If equal to 1  PCH will skip every Pad configuration.
> 
> +  **/
> 
> +  UINT32    GpioOverride    :  3;
> 
> +  UINT32    RsvdBits0       : 27;       ///< Reserved bits
> 
> +} PCH_GENERAL_PREMEM_CONFIG;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PCH_GENERAL_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib
> .h
> new file mode 100644
> index 0000000000..94509a80fe
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchCycleDecodingLib
> .h
> @@ -0,0 +1,258 @@
> +/** @file
> 
> +  Header file for PchCycleDecodingLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_CYCLE_DECODING_LIB_H_
> 
> +#define _PCH_CYCLE_DECODING_LIB_H_
> 
> +
> 
> +
> 
> +/**
> 
> +  Get PCH TCO base address.
> 
> +
> 
> +  @param[out] Address                   Address of TCO base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid pointer passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchTcoBaseGet (
> 
> +  OUT UINT16                            *Address
> 
> +  );
> 
> +
> 
> +///
> 
> +/// structure of LPC general IO range register
> 
> +/// It contains base address, address mask, and enable status.
> 
> +///
> 
> +typedef struct {
> 
> +  UINT32                                BaseAddr :16;
> 
> +  UINT32                                Length   :15;
> 
> +  UINT32                                Enable   : 1;
> 
> +} PCH_LPC_GEN_IO_RANGE;
> 
> +
> 
> +#define PCH_LPC_GEN_IO_RANGE_MAX        4
> 
> +#define ESPI_CS1_GEN_IO_RANGE_MAX       1
> 
> +
> 
> +///
> 
> +/// structure of LPC general IO range register list
> 
> +/// It lists all LPC general IO ran registers supported by PCH.
> 
> +///
> 
> +typedef struct {
> 
> +  PCH_LPC_GEN_IO_RANGE
> Range[PCH_LPC_GEN_IO_RANGE_MAX];
> 
> +} PCH_LPC_GEN_IO_RANGE_LIST;
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI generic IO range.
> 
> +  For generic IO range, the base address must align to 4 and less than
> 0xFFFF, and the length must be power of 2
> 
> +  and less than or equal to 256. Moreover, the address must be length
> aligned.
> 
> +  This function basically checks the address and length, which should not
> overlap with all other generic ranges.
> 
> +  If no more generic range register available, it returns out of resource error.
> 
> +  This cycle decoding is also required on DMI side.
> 
> +  Some IO ranges below 0x100 have fixed target. The target might be
> ITSS,RTC,LPC,PMC or terminated inside P2SB
> 
> +  but all predefined and can't be changed. IO range below 0x100 will be
> rejected in this function except below ranges:
> 
> +    0x00-0x1F,
> 
> +    0x44-0x4B,
> 
> +    0x54-0x5F,
> 
> +    0x68-0x6F,
> 
> +    0x80-0x8F,
> 
> +    0xC0-0xFF
> 
> +  Steps of programming generic IO range:
> 
> +  1. Program LPC/eSPI PCI Offset 84h ~ 93h of Mask, Address, and Enable.
> 
> +  2. Program LPC/eSPI Generic IO Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcGenIoRangeSet (
> 
> +  IN  UINT16                            Address,
> 
> +  IN  UINTN                             Length
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI memory range decoding.
> 
> +  This cycle decoding is required to be set on DMI side
> 
> +  Programming steps:
> 
> +  1. Program LPC PCI Offset 98h [0] to [0] to disable memory decoding first
> before changing base address.
> 
> +  2. Program LPC PCI Offset 98h [31:16, 0] to [Address, 1].
> 
> +  3. Program LPC Memory Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcMemRangeSet (
> 
> +  IN  UINT32                            Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# memory range decoding.
> 
> +  This cycle decoding is required to be set on DMI side
> 
> +  Programming steps:
> 
> +  1. Program eSPI PCI Offset A8h (eSPI CS1#) [0] to [0] to disable memory
> decoding first before changing base address.
> 
> +  2. Program eSPI PCI Offset A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
> 
> +  3. Program eSPI Memory Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory for decoding.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1MemRangeSet (
> 
> +  IN  UINT32                            Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH LPC/eSPI memory range decoding address.
> 
> +
> 
> +  @param[out] Address                   Address of LPC/eSPI memory decoding
> base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcMemRangeGet (
> 
> +  OUT UINT32                            *Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH eSPI CS1# memory range decoding address.
> 
> +
> 
> +  @param[out] Address                   Address of eSPI CS1# memory decoding
> base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
> 
> +  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1MemRangeGet (
> 
> +  OUT UINT32                            *Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH BIOS range deocding.
> 
> +  This will check General Control and Status bit 10 (GCS.BBS) to identify SPI
> or LPC/eSPI and program BDE register accordingly.
> 
> +  Please check EDS for detail of BiosDecodeEnable bit definition.
> 
> +    bit 15: F8-FF Enable
> 
> +    bit 14: F0-F8 Enable
> 
> +    bit 13: E8-EF Enable
> 
> +    bit 12: E0-E8 Enable
> 
> +    bit 11: D8-DF Enable
> 
> +    bit 10: D0-D7 Enable
> 
> +    bit  9: C8-CF Enable
> 
> +    bit  8: C0-C7 Enable
> 
> +    bit  7: Legacy F Segment Enable
> 
> +    bit  6: Legacy E Segment Enable
> 
> +    bit  5: Reserved
> 
> +    bit  4: Reserved
> 
> +    bit  3: 70-7F Enable
> 
> +    bit  2: 60-6F Enable
> 
> +    bit  1: 50-5F Enable
> 
> +    bit  0: 40-4F Enable
> 
> +  This cycle decoding is allowed to set when DMIC.SRL is 0.
> 
> +  Programming steps:
> 
> +  1. if GCS.BBS is 0 (SPI), program SPI PCI offset D8h to BiosDecodeEnable.
> 
> +     if GCS.BBS is 1 (LPC/eSPi), program LPC/eSPI PCI offset D8h to
> BiosDecodeEnable.
> 
> +  2. program LPC/eSPI/SPI BIOS Decode Enable, PCR[DMI] + 2744h to the
> same value programmed in LPC/eSPI or SPI PCI Offset D8h.
> 
> +
> 
> +  @param[in] BiosDecodeEnable           Bios decode enable setting.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchBiosDecodeEnableSet (
> 
> +  IN  UINT16                            BiosDecodeEnable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC IO decode ranges.
> 
> +  Program LPC I/O Decode Ranges, PCR[DMI] + 2770h[15:0] to the same
> value programmed in LPC offset 80h.
> 
> +  Please check EDS for detail of Lpc IO decode ranges bit definition.
> 
> +  Bit  12: FDD range
> 
> +  Bit 9:8: LPT range
> 
> +  Bit 6:4: ComB range
> 
> +  Bit 2:0: ComA range
> 
> +
> 
> +  @param[in] LpcIoDecodeRanges          Lpc IO decode ranges bit settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcIoDecodeRangesSet (
> 
> +  IN  UINT16                            LpcIoDecodeRanges
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC and eSPI CS0# IO enable decoding.
> 
> +  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset
> 82h.
> 
> +  Note: Bit[15:10] of the source decode register is Read-Only. The IO range
> indicated by the Enables field
> 
> +  in LPC/eSPI PCI offset 82h[13:10] is always forwarded by DMI to
> subtractive agent for handling.
> 
> +  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
> 
> +
> 
> +  @param[in] LpcIoEnableDecoding        LPC IO enable decoding bit settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcIoEnableDecodingSet (
> 
> +  IN  UINT16                            LpcIoEnableDecoding
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# IO enable decoding.
> 
> +  Setup I/O Enables in DMI to the same value program in eSPI PCI offset A0h
> (eSPI CS1#).
> 
> +  Note: Bit[15:10] of the source decode register is Read-Only. The IO range
> indicated by the Enables field
> 
> +  in eSPI PCI offset A0h[13:10] is always forwarded by DMI to subtractive
> agent for handling.
> 
> +  Please check EDS for detail of eSPI IO decode ranges bit definition.
> 
> +
> 
> +  @param[in] IoEnableDecoding           eSPI IO enable decoding bit settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMI configuration is locked
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1IoEnableDecodingSet (
> 
> +  IN  UINT16                            IoEnableDecoding
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get IO APIC regsiters base address.
> 
> +
> 
> +  @param[out] IoApicBase                Buffer of IO APIC regsiter address
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchIoApicBaseGet (
> 
> +  OUT UINT32                            *IoApicBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HPET base address.
> 
> +  This function will be unavailable after P2SB is hidden by PSF.
> 
> +
> 
> +  @param[out] HpetBase                  Buffer of HPET base address
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid offset passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchHpetBaseGet (
> 
> +  OUT UINT32                            *HpetBase
> 
> +  );
> 
> +
> 
> +#endif // _PCH_CYCLE_DECODING_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h
> new file mode 100644
> index 0000000000..c8aee81a8b
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchInfoLib.h
> @@ -0,0 +1,590 @@
> +/** @file
> 
> +  Header file for PchInfoLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_INFO_LIB_H_
> 
> +#define _PCH_INFO_LIB_H_
> 
> +
> 
> +#include <Hda.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +
> 
> +typedef UINT8 PCH_STEPPING;
> 
> +
> 
> +typedef UINT8 PCH_SERIES;
> 
> +#define PCH_LP                  2
> 
> +
> 
> +typedef UINT8 PCH_GENERATION;
> 
> +#define TGL_PCH                 5
> 
> +
> 
> +typedef enum {
> 
> +  RstUnsupported  = 0,
> 
> +  RstPremium,
> 
> +  RstOptane,
> 
> +  RstMaxMode
> 
> +} RST_MODE;
> 
> +
> 
> +/**
> 
> +  Return Pch stepping type
> 
> +
> 
> +  @retval PCH_STEPPING            Pch stepping type
> 
> +**/
> 
> +PCH_STEPPING
> 
> +PchStepping (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return Pch Series
> 
> +
> 
> +  @retval PCH_SERIES                Pch Series
> 
> +**/
> 
> +PCH_SERIES
> 
> +PchSeries (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return Pch Generation
> 
> +
> 
> +  @retval PCH_GENERATION            Pch Generation
> 
> +**/
> 
> +PCH_GENERATION
> 
> +PchGeneration (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if this is TGL PCH generation
> 
> +
> 
> +  @retval TRUE                It's TGL PCH
> 
> +  @retval FALSE               It's not TGL PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +IsTglPch (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Root Port Number
> 
> +
> 
> +  @retval PcieMaxRootPort         Pch Maximum Pcie Root Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPciePortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Controller Number
> 
> +
> 
> +  @retval Pch Maximum Pcie Controller Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieControllerNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Clock Number
> 
> +
> 
> +  @retval Pch Maximum Pcie Clock Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieClockNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie ClockReq Number
> 
> +
> 
> +  @retval Pch Maximum Pcie ClockReq Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieClockReqNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Usb2 Maximum Physical Port Number
> 
> +
> 
> +  @retval Pch Usb2 Maximum Physical Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchUsb2MaxPhysicalPortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Usb2 Port Number of XHCI Controller
> 
> +
> 
> +  @retval Pch Maximum Usb2 Port Number of XHCI Controller
> 
> +**/
> 
> +UINT8
> 
> +GetPchXhciMaxUsb2PortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Usb3 Maximum Physical Port Number
> 
> +
> 
> +  @retval Pch Usb3 Maximum Physical Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchUsb3MaxPhysicalPortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Usb3 Port Number of XHCI Controller
> 
> +
> 
> +  @retval Pch Maximum Usb3 Port Number of XHCI Controller
> 
> +**/
> 
> +UINT8
> 
> +GetPchXhciMaxUsb3PortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO I2C controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO I2C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoI2cControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO SPI controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO SPI controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoSpiControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO UART controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO UART controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoUartControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO SPI Chip Selects count
> 
> +
> 
> +  @retval Pch Maximum Serial IO SPI Chip Selects nu,ber
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoSpiChipSelectsNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH UART Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH UART controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshUartControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH I2C Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH I2C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshI2cControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH I3C Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH I3C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshI3cControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH SPI Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH SPI controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshSpiControllersNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH SPI Controller Cs pins number
> 
> +
> 
> +  @retval Pch Maximum ISH SPI controller Cs pins number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshSpiControllerCsPinsNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH GP number
> 
> +
> 
> +  @retval Pch Maximum ISH GP number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshGpNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ME Applet count
> 
> +
> 
> +  @retval Pch Maximum ME Applet number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxMeAppletCount (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +Get Pch Maximum ME Session count
> 
> +
> 
> +@retval Pch Maximum ME Sesion number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxMeSessionCount(
> 
> +  VOID
> 
> +);
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Type C Port Number
> 
> +
> 
> +  @retval Pch Maximum Type C Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxTypeCPortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#define PCH_STEPPING_STR_LENGTH_MAX 3
> 
> +
> 
> +/**
> 
> +  Get PCH stepping ASCII string.
> 
> +  Function determines major and minor stepping versions and writes them
> into a buffer.
> 
> +  The return string is zero terminated
> 
> +
> 
> +  @param [out]     Buffer               Output buffer of string
> 
> +  @param [in]      BufferSize           Buffer size.
> 
> +                                        Must not be less then
> PCH_STEPPING_STR_LENGTH_MAX
> 
> +
> 
> +  @retval EFI_SUCCESS                   String copied successfully
> 
> +  @retval EFI_INVALID_PARAMETER         The stepping is not supported, or
> parameters are NULL
> 
> +  @retval EFI_BUFFER_TOO_SMALL          Input buffer size is too small
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchGetSteppingStr (
> 
> +  OUT    CHAR8                          *Buffer,
> 
> +  IN     UINT32                         BufferSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH series ASCII string.
> 
> +  The return string is zero terminated.
> 
> +
> 
> +  @retval Static ASCII string of PCH Series
> 
> +**/
> 
> +CHAR8*
> 
> +PchGetSeriesStr (
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports eMMC controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchEmmcSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports SD controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchSdCardSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports THC controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchThcSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports HSIO BIOS Sync
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchChipsetInitSyncSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets the maximum number of UFS controller supported by this chipset.
> 
> +
> 
> +  @return Number of supported UFS controllers
> 
> +**/
> 
> +UINT8
> 
> +PchGetMaxUfsNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether integrated LAN controller is supported.
> 
> +
> 
> +  @retval TRUE                    GbE is supported in PCH
> 
> +  @retval FALSE                   GbE is not supported by PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsGbeSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether integrated TSN is supported.
> 
> +
> 
> +  @retval TRUE                    TSN is supported in current PCH
> 
> +  @retval FALSE                   TSN is not supported on current PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsTsnSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether ISH is supported.
> 
> +
> 
> +  @retval TRUE                    ISH is supported in PCH
> 
> +  @retval FALSE                   ISH is not supported by PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsIshSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether ATX Shutdown (PS_ON) is supported.
> 
> +
> 
> +  @retval    TRUE           ATX Shutdown (PS_ON) is supported in PCH
> 
> +  @retval    FALSE          ATX Shutdown (PS_ON) is not supported by PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchPSOnSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Sndw Link
> 
> +
> 
> +  @retval Pch Maximum Hda Sndw Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxSndwLinkNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Ssp Link
> 
> +
> 
> +  @retval Pch Maximum Hda Ssp Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxSspLinkNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Dmic Link
> 
> +
> 
> +  @retval Pch Maximum Hda Dmic Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxDmicLinkNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if given Audio Interface is supported
> 
> +
> 
> +  @param[in] AudioLinkType   Link type support to be checked
> 
> +  @param[in] AudioLinkIndex  Link number
> 
> +
> 
> +  @retval    TRUE           Link supported
> 
> +  @retval    FALSE          Link not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsAudioInterfaceSupported (
> 
> +  IN HDAUDIO_LINK_TYPE     AudioLinkType,
> 
> +  IN UINT32                AudioLinkIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if given Display Audio Link T-Mode is supported
> 
> +
> 
> +  @param[in] Tmode          T-mode support to be checked
> 
> +
> 
> +  @retval    TRUE           T-mode supported
> 
> +  @retval    FALSE          T-mode not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsAudioIDispTmodeSupported (
> 
> +  IN HDAUDIO_IDISP_TMODE Tmode
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an P-DMI
> 
> +
> 
> +  @retval    TRUE           P-DMI link
> 
> +  @retval    FALSE          Not an P-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithPdmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an OP-DMI
> 
> +
> 
> +  @retval    TRUE           OP-DMI link
> 
> +  @retval    FALSE          Not an OP-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithOpdmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an F-DMI
> 
> +
> 
> +  @retval    TRUE           F-DMI link
> 
> +  @retval    FALSE          Not an F-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithFdmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum THC count
> 
> +
> 
> +  @retval Pch Maximum THC count number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxThcCount (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +typedef enum {
> 
> +  SataSosc125Mhz = 0,
> 
> +  SataSosc120Mhz,
> 
> +  SataSosc100Mhz,
> 
> +  SataSosc25Mhz,
> 
> +  SataSosc19p2Mhz,
> 
> +  SataSoscUnsupported
> 
> +} SATA_SOSC_CLK_FREQ;
> 
> +
> 
> +/**
> 
> +  Returns a frequency of the sosc_clk signal.
> 
> +  All SATA controllers on the system are assumed to
> 
> +  work on the same sosc_clk frequency.
> 
> +
> 
> +  @retval Frequency of the sosc_clk signal.
> 
> +**/
> 
> +SATA_SOSC_CLK_FREQ
> 
> +GetSataSoscClkFreq (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if SATA support should be awake after function disable
> 
> +
> 
> +  @retval    TRUE
> 
> +  @retval    FALSE
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSataSupportWakeAfterFunctionDisable (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +//
> 
> +// USB2 PHY reference frequencies values (MHz)
> 
> +//
> 
> +typedef enum {
> 
> +  FREQ_19_2 = 0u,
> 
> +  FREQ_24_0,
> 
> +  FREQ_96_0,
> 
> +  FREQ_MAX
> 
> +} USB2_PHY_REF_FREQ;
> 
> +
> 
> +/**
> 
> +  Returns USB2 PHY Reference Clock frequency value used by PCH
> 
> +  This defines what electrical tuning parameters shall be used
> 
> +  during USB2 PHY initialization programming
> 
> +
> 
> +  @retval Frequency reference clock for USB2 PHY
> 
> +**/
> 
> +USB2_PHY_REF_FREQ
> 
> +GetUsb2PhyRefFreq (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  return support status for P2SB PCR 20-bit addressing
> 
> +
> 
> +  @retval    TRUE
> 
> +  @retval    FALSE
> 
> +**/
> 
> +BOOLEAN
> 
> +IsP2sb20bPcrSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if SPI in a given PCH generation supports an Extended BIOS Range
> Decode
> 
> +
> 
> +  @retval TRUE or FALSE if PCH supports Extended BIOS Range Decode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsExtendedBiosRangeDecodeSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns DMI target for current PCH SPI
> 
> +
> 
> +  @retval PCH SPI DMI target
> 
> +**/
> 
> +UINT16
> 
> +GetPchSpiDmiTarget (
> 
> +  VOID
> 
> +  );
> 
> +#endif // _PCH_INFO_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
> new file mode 100644
> index 0000000000..85456653de
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Library/PchPciBdfLib.h
> @@ -0,0 +1,552 @@
> +/** @file
> 
> +  Header file for PchPciBdfLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCI_BDF_LIB_H_
> 
> +#define _PCH_PCI_BDF_LIB_H_
> 
> +
> 
> +
> 
> +/**
> 
> +  Get eSPI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval eSPI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +EspiPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get GbE controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval GbE controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +GbePciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Device Number
> 
> +
> 
> +  @retval  GbE device number
> 
> +**/
> 
> +UINT8
> 
> +GbeDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Function Number
> 
> +
> 
> +  @retval  GbE function number
> 
> +**/
> 
> +UINT8
> 
> +GbeFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HDA controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HDA controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +HdaPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HDA PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +HdaDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HDA PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +HdaFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Get P2SB controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval P2SB controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +P2sbPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get P2SB PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +P2sbDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI PCI Config Space base address
> 
> +
> 
> +  @retval  UINT64  SPI Config Space base address
> 
> +**/
> 
> +UINT64
> 
> +SpiPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI Device number
> 
> +
> 
> +  @retval UINT8   PCH SPI Device number
> 
> +**/
> 
> +UINT8
> 
> +SpiDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI Function number
> 
> +
> 
> +  @retval UINT8   PCH SPI Function number
> 
> +**/
> 
> +UINT8
> 
> +SpiFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XHCI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval XHCI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchXhciPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XHCI controller PCIe Device Number
> 
> +
> 
> +  @retval XHCI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchXhciDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XHCI controller PCIe Function Number
> 
> +
> 
> +  @retval XHCI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchXhciFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XDCI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval XDCI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchXdciPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XDCI controller PCIe Device Number
> 
> +
> 
> +  @retval XDCI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchXdciDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get XDCI controller PCIe Function Number
> 
> +
> 
> +  @retval XDCI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchXdciFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get SMBUS controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @retval SMBUS controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +SmbusPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return DMA Smbus Device Number
> 
> +
> 
> +  @retval DMA Smbus Device Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDmaDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return DMA Smbus Function Number
> 
> +
> 
> +  @retval  DMA Smbus Function Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDmaFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get DMA SMBUS controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @retval DMA SMBUS controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SmbusDmaPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return Smbus Device Number
> 
> +
> 
> +  @retval Smbus Device Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return Smbus Function Number
> 
> +
> 
> +  @retval  Smbus Function Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets SATA controller PCIe config space base address
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller PCIe config space base address
> 
> +**/
> 
> +UINT64
> 
> +SataPciCfgBase (
> 
> +  IN UINT32 SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets SATA controller PCIe Device Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SataDevNumber (
> 
> +  IN UINT32 SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets SATA controller PCIe Function Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SataFuncNumber (
> 
> +  IN UINT32 SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns PCH LPC device PCI base address.
> 
> +
> 
> +  @retval                   PCH LPC PCI base address.
> 
> +**/
> 
> +UINT64
> 
> +LpcPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get LPC controller PCIe Device Number
> 
> +
> 
> +  @retval LPC controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +LpcDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Thermal Device PCIe Device Number
> 
> +
> 
> +  @retval Thermal Device PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +ThermalDevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Thermal Device PCIe Function Number
> 
> +
> 
> +  @retval Thermal Device PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +ThermalFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Thermal Device PCI base address.
> 
> +
> 
> +  @retval                   Thermal Device PCI base address.
> 
> +**/
> 
> +UINT64
> 
> +ThermalPciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get LPC controller PCIe Function Number
> 
> +
> 
> +  @retval LPC controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +LpcFuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller PCIe Device Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoI2cDevNumber (
> 
> +  IN UINT8       I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller PCIe Function Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoI2cFuncNumber (
> 
> +  IN UINT8       I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoI2cPciCfgBase (
> 
> +  IN UINT8        I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller PCIe Device Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoSpiDevNumber (
> 
> +  IN UINT8       SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller PCIe Function Number
> 
> +
> 
> +  @param[in]  SpiNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoSpiFuncNumber (
> 
> +  IN UINT8       SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  SpiNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoSpiPciCfgBase (
> 
> +  IN UINT8        SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller PCIe Device Number
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoUartDevNumber (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller PCIe Function Number
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoUartFuncNumber (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller address that can be passed to the PCI
> Segment Library functions.
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoUartPciCfgBase (
> 
> +  IN UINT8        UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller PCIe Device Number
> 
> +
> 
> +  @param[in]  RpIndex       Root port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchPcieRpDevNumber (
> 
> +  IN  UINTN   RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller PCIe Function Number
> 
> +
> 
> +  @param[in]  RpIndex       Root port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchPcieRpFuncNumber (
> 
> +  IN  UINTN   RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  RpIndex       PCH PCIe Root Port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchPcieRpPciCfgBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI1 PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci1DevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI1 PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci1FuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI1 controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HECI1 controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchHeci1PciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI3 PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci3DevNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI3 PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci3FuncNumber (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get HECI3 controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HECI3 controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchHeci3PciCfgBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif //_PCH_PCI_BDF_LIB_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h
> new file mode 100644
> index 0000000000..845bb19a65
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchInfoHob.h
> @@ -0,0 +1,70 @@
> +/** @file
> 
> +  This file contains definitions of PCH Info HOB.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_INFO_HOB_H_
> 
> +#define _PCH_INFO_HOB_H_
> 
> +
> 
> +extern EFI_GUID gPchInfoHobGuid;
> 
> +
> 
> +#define PCH_INFO_HOB_REVISION  4
> 
> +
> 
> +#pragma pack (push,1)
> 
> +/**
> 
> +  This structure is used to provide the information of PCH controller.
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Add CridSupport, CridOrgRid, and CridNewRid.
> 
> +  <b>Revision 3</b>:
> 
> +  - Add Thc0Strap.
> 
> +  <b>Revision 4</b>
> 
> +  - Removed GbePciePortNumber
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member specifies the revision of the PCH Info HOB. This field is used
> 
> +    to indicate backwards compatible changes to the protocol. Platform code
> that
> 
> +    consumes this protocol must read the correct revision value to correctly
> interpret
> 
> +    the content of the protocol fields.
> 
> +  **/
> 
> +  UINT8        Revision;
> 
> +  UINT8        PcieControllerCfg[6];
> 
> +  /**
> 
> +    THC strap disable/enable status
> 
> +  **/
> 
> +  UINT8       Thc0Strap;
> 
> +  UINT32       PciePortFuses;
> 
> +  /**
> 
> +    Bit map for PCIe Root Port Lane setting. If bit is set it means that
> 
> +    corresponding Root Port has its lane enabled.
> 
> +    BIT0 - RP0, BIT1 - RP1, ...
> 
> +    This information needs to be passed through HOB as FIA registers
> 
> +    are not accessible with POSTBOOT_SAI
> 
> +  **/
> 
> +  UINT32       PciePortLaneEnabled;
> 
> +  /**
> 
> +    Publish Hpet BDF and IoApic BDF information for VTD.
> 
> +  **/
> 
> +  UINT32       HpetBusNum    :  8;
> 
> +  UINT32       HpetDevNum    :  5;
> 
> +  UINT32       HpetFuncNum   :  3;
> 
> +  UINT32       IoApicBusNum  :  8;
> 
> +  UINT32       IoApicDevNum  :  5;
> 
> +  UINT32       IoApicFuncNum :  3;
> 
> +  /**
> 
> +    Publish the CRID information.
> 
> +  **/
> 
> +  UINT32       CridOrgRid    :  8;
> 
> +  UINT32       CridNewRid    :  8;
> 
> +  UINT32       CridSupport   :  1;
> 
> +  UINT32       Rsvdbits      : 15;
> 
> +} PCH_INFO_HOB;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PCH_INFO_HOB_H_
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h
> new file mode 100644
> index 0000000000..04ad17c8bd
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchLimits.h
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  Build time limits of PCH resources.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_LIMITS_H_
> 
> +#define _PCH_LIMITS_H_
> 
> +/*
> 
> + * Defines povided in this file are indended to be used only where static
> value
> 
> + * is needed. They are set to values which allow to accomodate multiple
> projects
> 
> + * needs. Where runtime usage is possible please used dedicated functions
> from
> 
> + * PchInfoLib to retrieve accurate values
> 
> + */
> 
> +
> 
> +//
> 
> +// PCIe limits
> 
> +//
> 
> +#define PCH_MAX_PCIE_ROOT_PORTS             24
> 
> +#define PCH_MAX_PCIE_CONTROLLERS            6
> 
> +
> 
> +//
> 
> +// PCIe clocks limits
> 
> +//
> 
> +#define PCH_MAX_PCIE_CLOCKS                 16
> 
> +
> 
> +//
> 
> +// RST PCIe Storage Cycle Router limits
> 
> +//
> 
> +#define PCH_MAX_RST_PCIE_STORAGE_CR         3
> 
> +
> 
> +//
> 
> +// SATA limits
> 
> +//
> 
> +#define PCH_MAX_SATA_CONTROLLERS            3
> 
> +#define PCH_MAX_SATA_PORTS                  8
> 
> +
> 
> +//
> 
> +// SerialIo limits
> 
> +//
> 
> +#define PCH_MAX_SERIALIO_I2C_CONTROLLERS      8
> 
> +#define PCH_MAX_SERIALIO_SPI_CONTROLLERS      7
> 
> +#define PCH_MAX_SERIALIO_SPI_CHIP_SELECTS     2
> 
> +#define PCH_MAX_SERIALIO_UART_CONTROLLERS     7
> 
> +
> 
> +//
> 
> +// ISH limits
> 
> +//
> 
> +#define PCH_MAX_ISH_GP_PINS                   8
> 
> +#define PCH_MAX_ISH_UART_CONTROLLERS          2
> 
> +#define PCH_MAX_ISH_I2C_CONTROLLERS           3
> 
> +#define PCH_MAX_ISH_SPI_CONTROLLERS           1
> 
> +#define PCH_MAX_ISH_SPI_CS_PINS               1
> 
> +//
> 
> +// HDA limits
> 
> +//
> 
> +#define PCH_MAX_HDA_SDI                       2
> 
> +#define PCH_MAX_HDA_SSP_LINK_NUM              6
> 
> +#define PCH_MAX_HDA_SNDW_LINK_NUM             4
> 
> +
> 
> +//
> 
> +// Number of eSPI slaves
> 
> +//
> 
> +#define PCH_MAX_ESPI_SLAVES                  2
> 
> +
> 
> +#endif // _PCH_LIMITS_H_
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
> new file mode 100644
> index 0000000000..7b749818fa
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPolicyCommon.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  PCH configuration based on PCH policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_POLICY_COMMON_H_
> 
> +#define _PCH_POLICY_COMMON_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <UsbConfig.h>
> 
> +#include <Usb2PhyConfig.h>
> 
> +#include <Usb3HsioConfig.h>
> 
> +
> 
> +#include "PchLimits.h"
> 
> +#include "ConfigBlock/PchGeneralConfig.h"
> 
> +#include <PchPcieRpConfig.h>
> 
> +#include <IoApicConfig.h>
> 
> +#include <SataConfig.h>
> 
> +#include <RstConfig.h>
> 
> +#include <PchDmiConfig.h>
> 
> +#include "ConfigBlock/FlashProtectionConfig.h"
> 
> +#include <InterruptConfig.h>
> 
> +#include <HdAudioConfig.h>
> 
> +#include <IshConfig.h>
> 
> +#include <GbeConfig.h>
> 
> +#include "ConfigBlock/LockDownConfig.h"
> 
> +#include "P2sbConfig.h"
> 
> +#include <PmConfig.h>
> 
> +#include <ScsConfig.h>
> 
> +#include <SerialIoConfig.h>
> 
> +#include <ThcConfig.h>
> 
> +#include <ThermalConfig.h>
> 
> +#include <EspiConfig.h>
> 
> +#include <CnviConfig.h>
> 
> +#include <IehConfig.h>
> 
> +#include <PsfConfig.h>
> 
> +#include <FivrConfig.h>
> 
> +#include <AdrConfig.h>
> 
> +#include <RtcConfig.h>
> 
> +#include <HybridStorageConfig.h>
> 
> +#include <SpiConfig.h>
> 
> +
> 
> +#ifndef FORCE_ENABLE
> 
> +#define FORCE_ENABLE  1
> 
> +#endif
> 
> +#ifndef FORCE_DISABLE
> 
> +#define FORCE_DISABLE 2
> 
> +#endif
> 
> +#ifndef PLATFORM_POR
> 
> +#define PLATFORM_POR  0
> 
> +#endif
> 
> +
> 
> +
> 
> +#endif // _PCH_POLICY_COMMON_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.
> h
> new file mode 100644
> index 0000000000..25e99d3a68
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchPreMemPolicyCommon.
> h
> @@ -0,0 +1,56 @@
> +/** @file
> 
> +  PCH configuration based on PCH policy
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PREMEM_POLICY_COMMON_H_
> 
> +#define _PCH_PREMEM_POLICY_COMMON_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +
> 
> +#include "PchLimits.h"
> 
> +#include "ConfigBlock/PchGeneralConfig.h"
> 
> +#include <DciConfig.h>
> 
> +#include <WatchDogConfig.h>
> 
> +#include <SmbusConfig.h>
> 
> +#include "ConfigBlock/LpcConfig.h"
> 
> +#include "ConfigBlock/HsioPcieConfig.h"
> 
> +#include "ConfigBlock/HsioSataConfig.h"
> 
> +#include "ConfigBlock/HsioConfig.h"
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +#ifndef FORCE_ENABLE
> 
> +#define FORCE_ENABLE  1
> 
> +#endif
> 
> +#ifndef FORCE_DISABLE
> 
> +#define FORCE_DISABLE 2
> 
> +#endif
> 
> +#ifndef PLATFORM_POR
> 
> +#define PLATFORM_POR  0
> 
> +#endif
> 
> +
> 
> +/**
> 
> +  PCH Policy revision number
> 
> +  Any backwards compatible changes to this structure will result in an update
> in the revision number
> 
> +**/
> 
> +#define PCH_PREMEM_POLICY_REVISION  1
> 
> +
> 
> +/**
> 
> +  PCH Policy PPI\n
> 
> +  All PCH config block change history will be listed here\n\n
> 
> +
> 
> +  - <b>Revision 1</b>:
> 
> +    - Initial version.\n
> 
> +**/
> 
> +typedef struct _PCH_PREMEM_POLICY {
> 
> +  CONFIG_BLOCK_TABLE_HEADER      TableHeader;
> 
> +/*
> 
> +  Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +*/
> 
> +} PCH_PREMEM_POLICY;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _PCH_PREMEM_POLICY_COMMON_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
> new file mode 100644
> index 0000000000..4573a11520
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/PchResetPlatformSpecific.h
> @@ -0,0 +1,21 @@
> +/** @file
> 
> +  PCH Reset Platform Specific definitions.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_RESET_PLATFORM_SPECIFIC_H_
> 
> +#define _PCH_RESET_PLATFORM_SPECIFIC_H_
> 
> +
> 
> +#define PCH_PLATFORM_SPECIFIC_RESET_STRING   L"PCH_RESET"
> 
> +#define PCH_RESET_DATA_STRING_MAX_LENGTH     (sizeof
> (PCH_PLATFORM_SPECIFIC_RESET_STRING) / sizeof (UINT16))
> 
> +
> 
> +extern EFI_GUID gPchGlobalResetGuid;
> 
> +
> 
> +typedef struct _RESET_DATA {
> 
> +  CHAR16   Description[PCH_RESET_DATA_STRING_MAX_LENGTH];
> 
> +  EFI_GUID Guid;
> 
> +} PCH_RESET_DATA;
> 
> +
> 
> +#endif // _PCH_RESET_PLATFORM_SPECIFIC_H_
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
> new file mode 100644
> index 0000000000..4d6241c32b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/IoTrapExDispatch.h
> @@ -0,0 +1,184 @@
> +/** @file
> 
> +  PCH IO TrapEx Dispatch Protocol
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _IO_TRAP_EX_DISPATCH_H_
> 
> +#define _IO_TRAP_EX_DISPATCH_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                                       gIoTrapExDispatchProtocolGuid;
> 
> +
> 
> +typedef struct _IO_TRAP_EX_DISPATCH_PROTOCOL
> IO_TRAP_EX_DISPATCH_PROTOCOL;
> 
> +
> 
> +/**
> 
> +  IO Trap Ex valid types
> 
> +**/
> 
> +typedef enum {
> 
> +  IoTrapExTypeWrite,
> 
> +  IoTrapExTypeRead,
> 
> +  IoTrapExTypeReadWrite,
> 
> +  IoTrapExTypeMaximum
> 
> +} IO_TRAP_EX_DISPATCH_TYPE;
> 
> +
> 
> +/**
> 
> +  IO Trap Ex context structure containing information about the
> 
> +  IO trap Ex event that should invoke the handler.
> 
> +  ByteEnableMask bitwise to ignore the ByteEnable setting. E.g. 1111b for
> any byte access.
> 
> +
> 
> +  Here are some examples for the usage.
> 
> +  1.  To trigger the TRAP for the IO address from 0x2000 to 0x20FF with
> BYTE/WORD/DWORD read/write access:
> 
> +      Address        = 0x2000
> 
> +      Length         = 0x100
> 
> +      Type           = IoTrapExTypeReadWrite
> 
> +      ByteEnable     = 0x00 (BE is not matter)
> 
> +      ByteEnableMask = 0x0F (BEM 0xF for any BYTE/WORD/DWORD access)
> 
> +  2.  To trigger the TRAP for port 0x61 with BYTE read access:
> 
> +      Address        = 0x60
> 
> +      Length         = 4
> 
> +      Type           = IoTrapExTypeRead
> 
> +      ByteEnable     = 0x02 (BE is 0010b to trap only second byte of every
> DWORD)
> 
> +      ByteEnableMask = 0x00 (BEM doesn't mask any BE bit)
> 
> +  3.  To trigger the TRAP for port 0x60 and 0x64 with BYTE write access:
> 
> +      Address        = 0x60
> 
> +      Length         = 8
> 
> +      Type           = IoTrapExTypeWrite
> 
> +      ByteEnable     = 0x01 (BE is 0001b to trap only first byte of every DWORD)
> 
> +      ByteEnableMask = 0x00 (BEM doesn't mask any BE bit)
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    The Address must be dword alignment.
> 
> +  **/
> 
> +  UINT16                                Address;
> 
> +  UINT16                                Length;
> 
> +  IO_TRAP_EX_DISPATCH_TYPE              Type;
> 
> +  /**
> 
> +    Bitmap to enable trap for each byte of every dword alignment address.
> 
> +    The Io Trap Address must be dword alignment for ByteEnable.
> 
> +    E.g. 0001b for first byte, 0010b for second byte, 1100b for third and fourth
> byte.
> 
> +  **/
> 
> +  UINT8                                 ByteEnable;
> 
> +  /**
> 
> +    ByteEnableMask bitwise to ignore the ByteEnable setting. E.g. 1111b for
> any byte access.
> 
> +    The Io Trap Address must be dword alignment for ByteEnableMask.
> 
> +  **/
> 
> +  UINT8                                 ByteEnableMask;
> 
> +} IO_TRAP_EX_REGISTER_CONTEXT;
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH IO TRAP EX handler dispatch.
> 
> +
> 
> +  @param[in] Address                    DWord-aligned address of the trapped
> cycle.
> 
> +  @param[in] ByteEnable                 This is the DWord-aligned byte enables
> associated with the trapped cycle.
> 
> +                                        A 1 in any bit location indicates that the corresponding
> byte is enabled in the cycle.
> 
> +  @param[in] WriteCycle                 TRUE = Write cycle; FALSE = Read cycle
> 
> +  @param[in] WriteData                  DWord of I/O write data. This field is
> undefined after trapping a read cycle.
> 
> +                                        The byte of WriteData is only valid if the corresponding
> bits in ByteEnable is 1.
> 
> +                                        E.g.
> 
> +                                        If ByteEnable is 0001b, then only first byte of WriteData
> is valid.
> 
> +                                        If ByteEnable is 0010b, then only second byte of
> WriteData is valid.
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *IO_TRAP_EX_DISPATCH_CALLBACK) (
> 
> +  IN UINT16                             Address,
> 
> +  IN UINT8                              ByteEnable,
> 
> +  IN BOOLEAN                            WriteCycle,
> 
> +  IN UINT32                             WriteData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a new IO Trap Ex SMI dispatch function.
> 
> +  The caller will provide information of IO trap setting via the context.
> 
> +  Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
> 
> +  This is the function to extend the IoTrap capability, and it's expected
> 
> +  to handle the special ByteEnable and ByteEnableMask setting.
> 
> +  This register function will occupy one IoTrap register if possible.
> 
> +  And it only support one handler for one IoTrap event.
> 
> +  The Address of context MUST NOT be 0, and MUST be dword alignment.
> 
> +  The Length of context MUST not less than 4, and MUST be power of 2.
> 
> +  The ByteEnable and ByteEnableMask MUST not be zero at the same time.
> 
> +  if the IO Trap handler is not used. It also enable the IO Trap Range to
> generate
> 
> +  SMI.
> 
> +  Caller must take care of reserving the IO addresses in ACPI.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> IO_TRAP_EX_DISPATCH_PROTOCOL instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for
> 
> +                                  this SMI source.
> 
> +  @param[in] RegisterContext      Pointer to the dispatch function's context.
> 
> +                                  The caller fills this context in before calling
> 
> +                                  the register function to indicate to the register
> 
> +                                  function the IO trap Ex SMI source for which the dispatch
> 
> +                                  function should be invoked.  This MUST not be NULL.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
> 
> +  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *IO_TRAP_EX_DISPATCH_REGISTER) (
> 
> +  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
> 
> +  IN  IO_TRAP_EX_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  IN  IO_TRAP_EX_REGISTER_CONTEXT   *RegisterContext,
> 
> +  OUT EFI_HANDLE                    *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a SMI source dispatch function.
> 
> +  This function is unsupported.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> IO_TRAP_EX_DISPATCH_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_UNSUPPORTED         The function is unsupported.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *IO_TRAP_EX_DISPATCH_UNREGISTER) (
> 
> +  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
> 
> +  IN  EFI_HANDLE                    DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for the IO trap Extention protocol.
> 
> +  This protocol exposes full IO TRAP capability for ByteEnable and
> ByteEnableMask setting.
> 
> +  Platform code should fully control the ByteEnable and ByteEnableMake
> while using this protocol.
> 
> +
> 
> +  Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
> 
> +  This is the function to extend the IoTrap capability, and it's expected
> 
> +  to handle the special ByteEnable and ByteEnableMask setting.
> 
> +
> 
> +  The protocol is low level, It returns PSTH trapped cycle. This might not be
> safe for multithread
> 
> +  if more than one thread triggers the same IOTRAP at the same time.
> 
> +**/
> 
> +struct _IO_TRAP_EX_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    Register function for PCH IO TRAP EX DISPATCH PROTOCOL.
> 
> +    The caller will provide information of IO trap setting via the context.
> 
> +    Please consider to use EfiSmmIoTrapDispatch2Protocol as possible.
> 
> +    This is the function to extend the IoTrap capability, and it's expected
> 
> +    to handle the special ByteEnable and ByteEnableMask setting.
> 
> +    This register function will occupy one IoTrap register if possible.
> 
> +    And it only support one handler for one IoTrap event.
> 
> +    The Address of context MUST NOT be 0, and MUST be dword alignment.
> 
> +    The Length of context MUST not less than 4, and MUST be power of 2.
> 
> +    The ByteEnable and ByteEnableMask MUST not be zero at the same time.
> 
> +    if the IO Trap handler is not used. It also enable the IO Trap Range to
> 
> +    generate SMI.
> 
> +  **/
> 
> +  IO_TRAP_EX_DISPATCH_REGISTER      Register;
> 
> +  /**
> 
> +    Unregister function for PCH IO TRAP EX DISPATCH PROTOCOL.
> 
> +  **/
> 
> +  IO_TRAP_EX_DISPATCH_UNREGISTER    UnRegister;
> 
> +};
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatch
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatc
> h.h
> new file mode 100644
> index 0000000000..136734d9ff
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchAcpiSmiDispatc
> h.h
> @@ -0,0 +1,134 @@
> +/** @file
> 
> +  APIs of PCH ACPI SMI Dispatch Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_ACPI_SMI_DISPATCH_PROTOCOL_H_
> 
> +#define _PCH_ACPI_SMI_DISPATCH_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                         gPchAcpiSmiDispatchProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_ACPI_SMI_DISPATCH_PROTOCOL
> PCH_ACPI_SMI_DISPATCH_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH ACPI SMI handler dispatch.
> 
> +
> 
> +  @param[in] DispatchHandle             The unique handle assigned to this
> handler by register function.
> 
> +
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_ACPI_SMI_DISPATCH_CALLBACK) (
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for PCH ACPI SMI events.
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchFunction           Pointer to dispatch function to be
> invoked for
> 
> +                                        this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function, for when
> interfacing
> 
> +                                        with the parent SMM driver.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR              The driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or
> SMM) to manage this child.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_ACPI_SMI_DISPATCH_REGISTER) (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent ACPI SMM
> driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_ACPI_SMI_DISPATCH_UNREGISTER) (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for PCH ACPI SMIs Dispatch Protocol
> 
> +  The PCH ACPI SMI DISPATCH PROTOCOL provides the ability to dispatch
> function for PCH ACPI related SMIs.
> 
> +  It contains SMI types of Pme, RtcAlarm, PmeB0, and Time overflow.
> 
> +**/
> 
> +struct _PCH_ACPI_SMI_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                                 Revision;
> 
> +  /**
> 
> +    Smi unregister function for PCH ACPI SMI DISPATCH PROTOCOL.
> 
> +  **/
> 
> +  PCH_ACPI_SMI_DISPATCH_UNREGISTER      UnRegister;
> 
> +  /**
> 
> +    Pme
> 
> +    The event is triggered by hardware when the PME# signal goes active.
> 
> +    Additionally, the event is only triggered when SCI_EN is not set.
> 
> +  **/
> 
> +  PCH_ACPI_SMI_DISPATCH_REGISTER        PmeRegister;
> 
> +  /**
> 
> +    PmeB0
> 
> +    The event is triggered PCH when any internal device with PCI Power
> Management
> 
> +    capabilities on bus 0 asserts the equivalent of the PME# signal.
> 
> +    Additionally, the event is only triggered when SCI_EN is not set.
> 
> +    The following are internal devices which can set this bit:
> 
> +    Intel HD Audio, Intel Management Engine "maskable" wake events,
> Integrated LAN,
> 
> +    SATA, xHCI, Intel SST
> 
> +  **/
> 
> +  PCH_ACPI_SMI_DISPATCH_REGISTER        PmeB0Register;
> 
> +  /**
> 
> +    RtcAlarm
> 
> +    The event is triggered by hardware when the RTC generates an alarm
> 
> +    (assertion of the IRQ8# signal).
> 
> +  **/
> 
> +  PCH_ACPI_SMI_DISPATCH_REGISTER        RtcAlarmRegister;
> 
> +  /**
> 
> +    TmrOverflow
> 
> +    The event is triggered any time bit 22 of the 24-bit timer goes high
> 
> +    (bits are numbered from 0 to 23).
> 
> +    This will occur every 2.3435 seconds. When the TMROF_EN bit (ABASE +
> 02h, bit 0) is set,
> 
> +    then the setting of the TMROF_STS bit will additionally generate an SMI#
> 
> +    Additionally, the event is only triggered when SCI_EN is not set.
> 
> +  **/
> 
> +  PCH_ACPI_SMI_DISPATCH_REGISTER        TmrOverflowRegister;
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH ACPI SMI dispatch revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +**/
> 
> +#define PCH_ACPI_SMI_DISPATCH_REVISION            1
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch
> .h
> new file mode 100644
> index 0000000000..4ea48c3fcd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchEspiSmiDispatch
> .h
> @@ -0,0 +1,144 @@
> +/** @file
> 
> +  SmmEspiDispatch Protocol
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_ESPI_SMI_DISPATCH_PROTOCOL_H_
> 
> +#define _PCH_ESPI_SMI_DISPATCH_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID gPchEspiSmiDispatchProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_ESPI_SMI_DISPATCH_PROTOCOL
> PCH_ESPI_SMI_DISPATCH_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH eSPI SMI handler dispatch.
> 
> +
> 
> +  @param[in] DispatchHandle             The unique handle assigned to this
> handler by register function.
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_ESPI_SMI_DISPATCH_CALLBACK) (
> 
> +  IN EFI_HANDLE DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generic function to register different types of eSPI SMI types
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration successful
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the EndOfDxe
> event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_ESPI_SMI_REGISTER) (
> 
> +  IN PCH_ESPI_SMI_DISPATCH_PROTOCOL *This,
> 
> +  IN PCH_ESPI_SMI_DISPATCH_CALLBACK DispatchFunction,
> 
> +  OUT EFI_HANDLE                    *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to unregister a callback based on
> handle
> 
> +
> 
> +  @param[in]  This                    Not used
> 
> +  @param[in]  DispatchHandle          Handle acquired during registration
> 
> +
> 
> +  @retval     EFI_SUCCESS             Unregister successful
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has
> bad pointer
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in
> database
> 
> +  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
> 
> +**/
> 
> +
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_ESPI_SMI_UNREGISTER) (
> 
> +  IN PCH_ESPI_SMI_DISPATCH_PROTOCOL *This,
> 
> +  IN EFI_HANDLE                     DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for PCH eSPI SMIs Dispatch Protocol
> 
> +  The PCH ESPI SMI DISPATCH PROTOCOL provides the ability to dispatch
> function for PCH eSPI related SMIs.
> 
> +  It contains SMI types of BiosWr, EcAssertedVw, and eSPI Master asserted
> SMIs
> 
> +**/
> 
> +struct _PCH_ESPI_SMI_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                   Revision;
> 
> +  /**
> 
> +    Unregister eSPI SMI events
> 
> +  **/
> 
> +  PCH_ESPI_SMI_UNREGISTER UnRegister;
> 
> +  /**
> 
> +    Register a BIOS Write Protect event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   BiosWrProtectRegister;
> 
> +  /**
> 
> +    Register a BIOS Write Report event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   BiosWrReportRegister;
> 
> +  /**
> 
> +    Register a Peripheral Channel Non Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   PcErrNonFatalRegister;
> 
> +  /**
> 
> +    Register a Peripheral Channel Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   PcErrFatalRegister;
> 
> +  /**
> 
> +    Register a Virtual Wire Non Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   VwErrNonFatalRegister;
> 
> +  /**
> 
> +    Register a Virtual Wire Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   VwErrFatalRegister;
> 
> +  /**
> 
> +    Register a Flash Channel Non Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   FlashErrNonFatalRegister;
> 
> +  /**
> 
> +    Register a Flash Channel Fatal Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   FlashErrFatalRegister;
> 
> +  /**
> 
> +    Register a Link Error event
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   LnkErrType1Register;
> 
> +  /**
> 
> +    Register a SMI handler for Espi slaver
> 
> +    This routine will also lock down ESPI_SMI_LOCK bit after registration and
> prevent
> 
> +    this handler from unregistration.
> 
> +    On platform that supports more than 1 device through another chip select
> (SPT-H),
> 
> +    the SMI handler itself needs to inspect both the eSPI devices' interrupt
> status registers
> 
> +    (implementation specific for each Slave) in order to identify and service
> the cause.
> 
> +    After servicing it, it has to clear the Slaves' internal SMI# status registers
> 
> +  **/
> 
> +  PCH_ESPI_SMI_REGISTER   EspiSlaveSmiRegister;
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH ESPI SMI dispatch revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +**/
> 
> +#define PCH_ESPI_SMI_DISPATCH_REVISION            1
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch
> .h
> new file mode 100644
> index 0000000000..b75b9ab45d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPcieSmiDispatch
> .h
> @@ -0,0 +1,166 @@
> +/** @file
> 
> +  APIs of PCH PCIE SMI Dispatch Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCIE_SMI_DISPATCH_PROTOCOL_H_
> 
> +#define _PCH_PCIE_SMI_DISPATCH_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                         gPchPcieSmiDispatchProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_PCIE_SMI_DISPATCH_PROTOCOL
> PCH_PCIE_SMI_DISPATCH_PROTOCOL;
> 
> +
> 
> +typedef enum {
> 
> +  PchRpIndex0      = 0,
> 
> +  PchRpIndex1      = 1,
> 
> +  PchRpIndex2      = 2,
> 
> +  PchRpIndex3      = 3,
> 
> +  PchRpIndex4      = 4,
> 
> +  PchRpIndex5      = 5,
> 
> +  PchRpIndex6      = 6,
> 
> +  PchRpIndex7      = 7,
> 
> +  PchRpIndex8      = 8,
> 
> +  PchRpIndex9      = 9,
> 
> +  PchRpIndex10     = 10,
> 
> +  PchRpIndex11     = 11,
> 
> +  PchRpIndex12     = 12,
> 
> +  PchRpIndex13     = 13,
> 
> +  PchRpIndex14     = 14,
> 
> +  PchRpIndex15     = 15,
> 
> +  PchRpIndex16     = 16,
> 
> +  PchRpIndex17     = 17,
> 
> +  PchRpIndex18     = 18,
> 
> +  PchRpIndex19     = 19,
> 
> +  PchRpIndex20     = 20,
> 
> +  PchRpIndex21     = 21,
> 
> +  PchRpIndex22     = 22,
> 
> +  PchRpIndex23     = 23,
> 
> +  /**
> 
> +    Quantity of PCH and CPU PCIe ports, as well as their encoding in this
> enum, may change between
> 
> +    silicon generations and series. Do not assume that PCH port 0 will be
> always encoded by 0.
> 
> +    Instead, it is recommended to use (PchRpIndex0 + PchPortIndex) style to
> be forward-compatible
> 
> +  **/
> 
> +  CpuRpIndex0      = 0x40,
> 
> +  CpuRpIndex1      = 0x41,
> 
> +  CpuRpIndex2      = 0x42,
> 
> +  CpuRpIndex3      = 0x43
> 
> +} PCIE_COMBINED_RPINDEX;
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +typedef struct {
> 
> +  UINT8                                 RpIndex; ///< Root port index (0-based), 0: RP1, 1:
> RP2, n: RP(N+1)
> 
> +  UINT8                                 BusNum;  ///< Root port pci bus number
> 
> +  UINT8                                 DevNum;  ///< Root port pci device number
> 
> +  UINT8                                 FuncNum; ///< Root port pci function number
> 
> +} PCH_PCIE_SMI_RP_CONTEXT;
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH PCIE RP SMI handler dispatch.
> 
> +
> 
> +  @param[in] DispatchHandle             The unique handle assigned to this
> handler by register function.
> 
> +  @param[in] RpContext                  Pointer of PCH PCIE Root Port context.
> 
> +
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_PCIE_SMI_RP_DISPATCH_CALLBACK) (
> 
> +  IN EFI_HANDLE                         DispatchHandle,
> 
> +  IN PCH_PCIE_SMI_RP_CONTEXT            *RpContext
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for PCH PCIERP SMI events.
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchFunction           Pointer to dispatch function to be
> invoked for
> 
> +                                        this SMI source
> 
> +  @param[in] RpIndex                    Refer PCIE_COMBINED_RPINDEX for PCH
> RP index and CPU RP index.
> 
> +                                        0: RP1, 1: RP2, n: RP(N+1)
> 
> +  @param[out] DispatchHandle            Handle of dispatch function, for when
> interfacing
> 
> +                                        with the parent SMM driver.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR              The driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or
> SMM) to manage this child.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_PCIE_SMI_RP_DISPATCH_REGISTER) (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
> 
> +  IN  UINTN                             RpIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent PCIE SMM
> driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_PCIE_SMI_DISPATCH_UNREGISTER) (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for PCH PCIE SMIs Dispatch Protocol
> 
> +  The PCH PCIE SMI DISPATCH PROTOCOL provides the ability to dispatch
> function for PCH PCIE related SMIs.
> 
> +  It contains SMI types of HotPlug, LinkActive, and Link EQ.
> 
> +**/
> 
> +struct _PCH_PCIE_SMI_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                                 Revision;
> 
> +  /**
> 
> +    Smi unregister function for PCH PCIE SMI DISPATCH PROTOCOL.
> 
> +  **/
> 
> +  PCH_PCIE_SMI_DISPATCH_UNREGISTER      UnRegister;
> 
> +  /**
> 
> +    PcieRpXHotPlug
> 
> +    The event is triggered when PCIE root port Hot-Plug Presence Detect.
> 
> +  **/
> 
> +  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     HotPlugRegister;
> 
> +  /**
> 
> +    PcieRpXLinkActive
> 
> +    The event is triggered when Hot-Plug Link Active State Changed.
> 
> +  **/
> 
> +  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     LinkActiveRegister;
> 
> +  /**
> 
> +    PcieRpXLinkEq
> 
> +    The event is triggered when Device Requests Software Link Equalization.
> 
> +  **/
> 
> +  PCH_PCIE_SMI_RP_DISPATCH_REGISTER     LinkEqRegister;
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH PCIE SMI dispatch revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +**/
> 
> +#define PCH_PCIE_SMI_DISPATCH_REVISION            1
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h
> new file mode 100644
> index 0000000000..ba7cbdb23e
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchPolicy.h
> @@ -0,0 +1,40 @@
> +/** @file
> 
> +  Interface definition details between Pch and platform drivers during DXE
> phase.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_POLICY_H_
> 
> +#define _PCH_POLICY_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include "../IncludePrivate/PchConfigHob.h"    // To Be corrected
> 
> +#include <Library/HobLib.h>
> 
> +
> 
> +extern EFI_GUID gPchPolicyProtocolGuid;
> 
> +
> 
> +#define PCH_POLICY_PROTOCOL_REVISION  1
> 
> +
> 
> +
> 
> +/**
> 
> +  PCH DXE Policy
> 
> +
> 
> +  The PCH_POLICY_PROTOCOL producer drvier is recommended to
> 
> +  set all the PCH_POLICY_PROTOCOL size buffer zero before init any
> member parameter,
> 
> +  this clear step can make sure no random value for those unknown new
> version parameters.
> 
> +
> 
> +  Make sure to update the Revision if any change to the protocol, including
> the existing
> 
> +  internal structure definations.\n
> 
> +  Note: Here revision will be bumped up when adding/removing any config
> block under this structure.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_TABLE_HEADER      TableHeader;
> 
> +/*
> 
> +  Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +*/
> 
> +} PCH_POLICY_PROTOCOL;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
> new file mode 100644
> index 0000000000..12b5f8117b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmiDispatch.h
> @@ -0,0 +1,132 @@
> +/** @file
> 
> +  APIs of PCH SMI Dispatch Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SMI_DISPATCH_PROTOCOL_H_
> 
> +#define _PCH_SMI_DISPATCH_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                         gPchSmiDispatchProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_SMI_DISPATCH_PROTOCOL
> PCH_SMI_DISPATCH_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH SMI handler dispatch.
> 
> +
> 
> +  @param[in] DispatchHandle             The unique handle assigned to this
> handler by register function.
> 
> +
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_SMI_DISPATCH_CALLBACK) (
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for specific PCH SMI dispatch
> event.
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchFunction           Pointer to dispatch function to be
> invoked for
> 
> +                                        this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function, for when
> interfacing
> 
> +                                        with the parent SMM driver.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR              The driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or
> SMM) to manage this child.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMI_DISPATCH_REGISTER) (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMI_DISPATCH_UNREGISTER) (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for PCH specific SMIs Dispatch Protocol
> 
> +  The PCH SMI DISPATCH PROTOCOL provides the ability to dispatch function
> for PCH misc SMIs.
> 
> +  It contains legacy SMIs and new PCH SMI types like:
> 
> +  SerialIrq, McSmi, Smbus, ...
> 
> +**/
> 
> +struct _PCH_SMI_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                                 Revision;
> 
> +  /**
> 
> +    Smi unregister function for PCH SMI DISPATCH PROTOCOL.
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_UNREGISTER           UnRegister;
> 
> +  /**
> 
> +    SerialIrq
> 
> +    The event is triggered while the SMI# was caused by the SERIRQ decoder.
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_REGISTER             SerialIrqRegister;
> 
> +  /**
> 
> +    McSmi
> 
> +    The event is triggered if there has been an access to the power
> management
> 
> +    microcontroller range (62h or 66h) and the Microcontroller Decode Enable
> #1 bit
> 
> +    in the LPC Bridge I/O Enables configuration register is 1 .
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_REGISTER             McSmiRegister;
> 
> +  /**
> 
> +    SmBus
> 
> +    The event is triggered while the SMI# was caused by:
> 
> +    1. The SMBus Slave receiving a message that an SMI# should be caused,
> or
> 
> +    2. The SMBALERT# signal goes active and the SMB_SMI_EN bit is set and
> the
> 
> +       SMBALERT_DIS bit is cleared, or
> 
> +    3. The SMBus Slave receiving a Host Notify message and the
> HOST_NOTIFY_INTREN and
> 
> +       the SMB_SMI_EN bits are set, or
> 
> +    4. The PCH detecting the SMLINK_SLAVE_SMI command while in the S0
> state.
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_REGISTER             SmbusRegister;
> 
> +  /**
> 
> +    SPI Asynchronous
> 
> +    When registered, the flash controller will generate an SMI when it blocks
> a BIOS write or erase.
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_REGISTER             SpiAsyncRegister;
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH SMI dispatch revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +**/
> 
> +#define PCH_SMI_DISPATCH_REVISION                 1
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapCont
> rol.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapCont
> rol.h
> new file mode 100644
> index 0000000000..9f2793634e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmIoTrapCont
> rol.h
> @@ -0,0 +1,65 @@
> +/** @file
> 
> +  PCH SMM IO Trap Control Protocol
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SMM_IO_TRAP_CONTROL_H_
> 
> +#define _PCH_SMM_IO_TRAP_CONTROL_H_
> 
> +
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                                   gPchSmmIoTrapControlGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Related Definitions
> 
> +//
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  The Prototype of Pause and Resume IoTrap callback function.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of the child service to change state.
> 
> +
> 
> +  @retval EFI_SUCCESS             This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       The SMI status is alrady
> PAUSED/RESUMED.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMM_IO_TRAP_CONTROL_FUNCTION) (
> 
> +  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL           * This,
> 
> +  IN EFI_HANDLE                                 DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for the SMM IO trap pause and resume protocol
> 
> +  This protocol provides the functions to runtime control the IoTrap SMI
> enabled/disable.
> 
> +  This applys the capability to the DispatchHandle which returned by IoTrap
> callback
> 
> +  registration, and the DispatchHandle which must be MergeDisable = TRUE
> and Address != 0.
> 
> +  Besides, when S3 resuem, it only restores the state of IoTrap callback
> registration.
> 
> +  The Paused/Resume state won't be restored after S3 resume.
> 
> +**/
> 
> +struct _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL {
> 
> +  /**
> 
> +    This runtime pauses a registered IoTrap handler.
> 
> +  **/
> 
> +  PCH_SMM_IO_TRAP_CONTROL_FUNCTION      Pause;
> 
> +  /**
> 
> +    This runtime resumes a registered IoTrap handler.
> 
> +  **/
> 
> +  PCH_SMM_IO_TRAP_CONTROL_FUNCTION      Resume;
> 
> +};
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTi
> merControl.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTi
> merControl.h
> new file mode 100644
> index 0000000000..a7b44c5f7e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchSmmPeriodicTi
> merControl.h
> @@ -0,0 +1,65 @@
> +/** @file
> 
> +  PCH SMM Periodic Timer Control Protocol
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
> 
> +#define _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
> 
> +
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                                             gPchSmmPeriodicTimerControlGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL
> PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Related Definitions
> 
> +//
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  The Prototype of Pause and Resume SMM PERIODIC TIMER function.
> 
> +
> 
> +  @param[in] This                       Pointer to the
> PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle             Handle of the child service to change
> state.
> 
> +
> 
> +  @retval EFI_SUCCESS                   This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             The SMI status is alrady
> PAUSED/RESUMED.
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION) (
> 
> +  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
> 
> +  IN EFI_HANDLE                                   DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for the SMM PERIODIC TIMER pause and resume
> protocol
> 
> +  This protocol provides the functions to runtime control the SM periodic
> timer enabled/disable.
> 
> +  This applies the capability to the DispatchHandle which returned by SMM
> periodic timer callback
> 
> +  registration.
> 
> +  Besides, when S3 resume, it only restores the state of callback registration.
> 
> +  The Paused/Resume state won't be restored after S3 resume.
> 
> +**/
> 
> +struct _PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL {
> 
> +  /**
> 
> +    This runtime pauses the registered periodic timer handler.
> 
> +  **/
> 
> +  PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION         Pause;
> 
> +  /**
> 
> +    This runtime resumes the registered periodic timer handler.
> 
> +  **/
> 
> +  PCH_SMM_PERIODIC_TIMER_CONTROL_FUNCTION         Resume;
> 
> +};
> 
> +
> 
> +#endif // _PCH_SMM_PERIODIC_TIMER_CONTROL_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.
> h
> new file mode 100644
> index 0000000000..b443484f39
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Protocol/PchTcoSmiDispatch.
> h
> @@ -0,0 +1,150 @@
> +/** @file
> 
> +  APIs of PCH TCO SMI Dispatch Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_TCO_SMI_DISPATCH_PROTOCOL_H_
> 
> +#define _PCH_TCO_SMI_DISPATCH_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                         gPchTcoSmiDispatchProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_TCO_SMI_DISPATCH_PROTOCOL
> PCH_TCO_SMI_DISPATCH_PROTOCOL;
> 
> +
> 
> +//
> 
> +// Member functions
> 
> +//
> 
> +
> 
> +/**
> 
> +  Callback function for an PCH TCO SMI handler dispatch.
> 
> +
> 
> +  @param[in] DispatchHandle             The unique handle assigned to this
> handler by register function.
> 
> +
> 
> +**/
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_TCO_SMI_DISPATCH_CALLBACK) (
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for PCH TCO SMI events.
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchFunction           Pointer to dispatch function to be
> invoked for
> 
> +                                        this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function, for when
> interfacing
> 
> +                                        with the parent SMM driver.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR              The driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Not enough memory (system or
> SMM) to manage this child.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_TCO_SMI_DISPATCH_REGISTER) (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent TCO SMM
> driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the EndOfDxe
> event has been triggered
> 
> +**/
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_TCO_SMI_DISPATCH_UNREGISTER) (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Interface structure for PCH TCO SMIs Dispatch Protocol
> 
> +  The PCH TCO SMI DISPATCH PROTOCOL provides the ability to dispatch
> function for PCH TCO related SMIs.
> 
> +  It contains SMI types of Mch, TcoTimeout, OsTco, Nmi, IntruderDectect,
> and BiowWp.
> 
> +**/
> 
> +struct _PCH_TCO_SMI_DISPATCH_PROTOCOL {
> 
> +  /**
> 
> +    This member specifies the revision of this structure. This field is used to
> 
> +    indicate backwards compatible changes to the protocol.
> 
> +  **/
> 
> +  UINT8                                 Revision;
> 
> +  /**
> 
> +    Smi unregister function for PCH TCO SMI DISPATCH PROTOCOL.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_UNREGISTER       UnRegister;
> 
> +  /**
> 
> +    Mch
> 
> +    The event is triggered when PCH received a DMI special cycle message
> using DMI indicating that
> 
> +    it wants to cause an SMI.
> 
> +    The software must read the processor to determine the reason for the
> SMI.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         MchRegister;
> 
> +  /**
> 
> +    TcoTimeout
> 
> +    The event is triggered by PCH to indicate that the SMI was caused by the
> TCO timer reaching 0.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         TcoTimeoutRegister;
> 
> +  /**
> 
> +    OsTco
> 
> +    The event is triggered when software caused an SMI# by writing to the
> TCO_DAT_IN register (TCOBASE + 02h).
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         OsTcoRegister;
> 
> +  /**
> 
> +    Nmi
> 
> +    The event is triggered by the PCH when an SMI# occurs because an event
> occurred that would otherwise have
> 
> +    caused an NMI (because NMI2SMI_EN is set)
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         NmiRegister;
> 
> +  /**
> 
> +    IntruderDectect
> 
> +    The event is triggered by PCH to indicate that an intrusion was detected.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         IntruderDetRegister;
> 
> +  /**
> 
> +    SpiBiosWp
> 
> +    This event is triggered when SMI# was caused by the TCO logic and
> 
> +    SPI flash controller asserted Synchronous SMI by BIOS lock enable set.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         SpiBiosWpRegister;
> 
> +  /**
> 
> +    LpcBiosWp
> 
> +    This event is triggered when SMI# was caused by the TCO logic and
> 
> +    LPC/eSPI BIOS lock enable set.
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         LpcBiosWpRegister;
> 
> +  /**
> 
> +    NewCentury
> 
> +    This event is triggered when SMI# was caused by the TCO logic and
> 
> +    year of RTC date rolls over a century (99 to 00).
> 
> +  **/
> 
> +  PCH_TCO_SMI_DISPATCH_REGISTER         NewCenturyRegister;
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCH TCO SMI dispatch revision number
> 
> +
> 
> +  Revision 1:   Initial version
> 
> +  Revision 2:   Add NEWCENTURY support
> 
> +**/
> 
> +#define PCH_TCO_SMI_DISPATCH_REVISION             2
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h
> new file mode 100644
> index 0000000000..679cb17f6c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegs.h
> @@ -0,0 +1,16 @@
> +/** @file
> 
> +  Generic register definitions for PCH.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_H_
> 
> +#define _PCH_REGS_H_
> 
> +
> 
> +///
> 
> +/// The default PCH PCI segment and bus number
> 
> +///
> 
> +#define DEFAULT_PCI_SEGMENT_NUMBER_PCH  0
> 
> +#define DEFAULT_PCI_BUS_NUMBER_PCH      0
> 
> +
> 
> +#endif //_PCH_REGS_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
> new file mode 100644
> index 0000000000..32dd88be0e
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsLpc.h
> @@ -0,0 +1,145 @@
> +/** @file
> 
> +  Register names for PCH LPC/eSPI device
> 
> +
> 
> +Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_LPC_H_
> 
> +#define _PCH_REGS_LPC_H_
> 
> +
> 
> +#define B_LPC_CFG_DID         0xFFE0
> 
> +
> 
> +//
> 
> +// PCI to LPC Bridge Registers
> 
> +//
> 
> +
> 
> +#define R_LPC_CFG_IOD                             0x80
> 
> +#define V_LPC_CFG_IOD_COMB_2F8                    1
> 
> +#define V_LPC_CFG_IOD_COMA_3F8                    0
> 
> +#define V_LPC_CFG_IOD_COMA_2F8                    1
> 
> +#define R_LPC_CFG_IOE                             0x82
> 
> +#define B_LPC_CFG_IOE_SE                          BIT12           ///< Super I/O Enable,
> Enables decoding of I/O locations 2Eh and 2Fh to LPC.
> 
> +#define B_LPC_CFG_IOE_KE                          BIT10           ///< Keyboard Enable,
> Enables decoding of the keyboard I/O locations 60h and 64h to LPC.
> 
> +#define B_LPC_CFG_IOE_PPE                         BIT2            ///< Parallel Port
> Enable, Enables decoding of the LPT range to LPC. Range is selected by
> LIOD.LPT.
> 
> +#define B_LPC_CFG_IOE_CBE                         BIT1            ///< Com Port B
> Enable, Enables decoding of the COMB range to LPC. Range is selected
> LIOD.CB.
> 
> +#define B_LPC_CFG_IOE_CAE                         BIT0            ///< Com Port A
> Enable, Enables decoding of the COMA range to LPC. Range is selected
> LIOD.CA.
> 
> +#define R_LPC_CFG_ULKMC                           0x94
> 
> +#define B_LPC_CFG_ULKMC_A20PASSEN                 BIT5
> 
> +#define B_LPC_CFG_ULKMC_64WEN                     BIT3
> 
> +#define B_LPC_CFG_ULKMC_64REN                     BIT2
> 
> +#define B_LPC_CFG_ULKMC_60WEN                     BIT1
> 
> +#define B_LPC_CFG_ULKMC_60REN                     BIT0
> 
> +#define R_LPC_CFG_LGMR                            0x98
> 
> +#define B_LPC_CFG_LGMR_MA                         0xFFFF0000
> 
> +#define B_LPC_CFG_LGMR_LMRD_EN                    BIT0
> 
> +#define R_ESPI_CFG_CS1IORE                        0xA0
> 
> +#define R_ESPI_CFG_CS1GMR1                        0xA8
> 
> +
> 
> +#define R_LPC_CFG_BDE                             0xD8                          ///< BIOS decode
> enable
> 
> +
> 
> +//
> 
> +// APM Registers
> 
> +//
> 
> +#define R_PCH_IO_APM_CNT                             0xB2
> 
> +#define R_PCH_IO_APM_STS                             0xB3
> 
> +
> 
> +#define R_LPC_CFG_BC                              0xDC            ///< Bios Control
> 
> +#define S_LPC_CFG_BC                              1
> 
> +#define N_LPC_CFG_BC_LE                           1
> 
> +#define B_LPC_CFG_BC_WPD                          BIT0            ///< Write Protect
> Disable
> 
> +
> 
> +#define R_ESPI_CFG_PCBC                           0xDC            ///< Peripheral Channel
> BIOS Control
> 
> +#define S_ESPI_CFG_PCBC                           4               ///< Peripheral Channel
> BIOS Control register size
> 
> +#define B_ESPI_CFG_PCBC_BWRE                      BIT11           ///< BIOS Write
> Report Enable
> 
> +#define B_ESPI_CFG_PCBC_BWRS                      BIT10           ///< BIOS Write
> Report Status
> 
> +#define B_ESPI_CFG_PCBC_BWPDS                     BIT8            ///< BIOS Write
> Protect Disable Status
> 
> +#define N_ESPI_CFG_PCBC_BWPDS                     8               ///< BIOS Write
> Protect Disable Status bit position
> 
> +#define B_ESPI_CFG_PCBC_ESPI_EN                   BIT2            ///< eSPI Enable
> Pin Strap
> 
> +#define B_ESPI_CFG_PCBC_LE                        BIT1            ///< Lock Enable
> 
> +#define N_ESPI_CFG_PCBC_LE                        1
> 
> +
> 
> +//
> 
> +// eSPI slave registers
> 
> +//
> 
> +#define B_ESPI_SLAVE_BME                          BIT2            ///< Bus Master Enable
> 
> +
> 
> +//
> 
> +// Reset Generator I/O Port
> 
> +//
> 
> +#define R_PCH_IO_RST_CNT                             0xCF9
> 
> +#define V_PCH_IO_RST_CNT_FULLRESET                   0x0E
> 
> +#define V_PCH_IO_RST_CNT_HARDRESET                   0x06
> 
> +
> 
> +//
> 
> +// eSPI PCR Registers
> 
> +//
> 
> +#define R_ESPI_PCR_SLV_CFG_REG_CTL            0x4000                  ///< Slave
> Configuration Register and Link Control
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE       BIT31                   ///< Slave
> Configuration Register Access Enable
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS       (BIT30 | BIT29 | BIT28)
> ///< Slave Configuration Register Access Status
> 
> +#define N_ESPI_PCR_SLV_CFG_REG_CTL_SCRS       28                      ///< Slave
> Configuration Register Access Status bit position
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SBLCL      BIT27                   ///<
> IOSF-SB eSPI Link Configuration Lock
> 
> +#define V_ESPI_PCR_SLV_CFG_REG_CTL_SCRS_NOERR 7                       ///<
> No errors (transaction completed successfully)
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SID        (BIT20 | BIT19)         ///<
> Slave ID
> 
> +#define N_ESPI_PCR_SLV_CFG_REG_CTL_SID        19                      ///< Slave ID
> bit position
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRT       (BIT17 | BIT16)         ///<
> Slave Configuration Register Access Type
> 
> +#define N_ESPI_PCR_SLV_CFG_REG_CTL_SCRT       16                      ///< Slave
> Configuration Register Access Type bit position
> 
> +#define B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA       0x00000FFF              ///<
> Slave Configuration Register Address
> 
> +#define R_ESPI_PCR_SLV_CFG_REG_DATA           0x4004                  ///< Slave
> Configuration Register Data
> 
> +
> 
> +#define R_ESPI_PCR_PCERR_SLV0                 0x4020          ///< Peripheral
> Channel Error for Slave 0
> 
> +#define B_ESPI_PCR_PCERR_PCURD                BIT24           ///< Peripheral
> Channel Unsupported Request Detected
> 
> +#define R_ESPI_PCR_VWERR_SLV0                 0x4030          ///< Virtual Wire
> Channel Error for Slave 0
> 
> +#define R_ESPI_PCR_FCERR_SLV0                 0x4040          ///< Flash Access
> Channel Error for Slave 0
> 
> +#define B_ESPI_PCR_FCERR_SAFBLK               BIT17           ///< SAF Blocked
> (SAFBLK)
> 
> +#define B_ESPI_PCR_XERR_XNFEE                 (BIT14 | BIT13) ///< Non-Fatal
> Error Reporting Enable bits
> 
> +#define N_ESPI_PCR_XERR_XNFEE                 13              ///< Non-Fatal Error
> Reporting Enable bit position
> 
> +#define V_ESPI_PCR_XERR_XNFEE_SMI             3               ///< Enable Non-
> Fatal Error Reporting as SMI
> 
> +#define B_ESPI_PCR_XERR_XNFES                 BIT12           ///< Fatal Error Status
> 
> +#define B_ESPI_PCR_XERR_XFEE                  (BIT6 | BIT5)   ///< Fatal Error
> Reporting Enable bits
> 
> +#define N_ESPI_PCR_XERR_XFEE                  5               ///< Fatal Error
> Reporting Enable bit position
> 
> +#define V_ESPI_PCR_XERR_XFEE_SMI              3               ///< Enable Fatal
> Error Reporting as SMI
> 
> +#define B_ESPI_PCR_XERR_XFES                  BIT4            ///< Fatal Error Status
> 
> +#define S_ESPI_PCR_XERR                       4               ///< Channel register sizes
> 
> +#define B_ESPI_PCR_PCERR_SLV0_PCURD           BIT24           ///< Peripheral
> Channel Unsupported Request Detected
> 
> +#define R_ESPI_PCR_LNKERR_SLV0                0x4050          ///< Link Error for
> Slave 0
> 
> +#define S_ESPI_PCR_LNKERR_SLV0                4               ///< Link Error for Slave
> 0 register size
> 
> +#define B_ESPI_PCR_LNKERR_SLV0_SLCRR          BIT31           ///< eSPI Link
> and Slave Channel Recovery Required
> 
> +#define B_ESPI_PCR_LNKERR_SLV0_LFET1E         (BIT22 | BIT21) ///< Fatal
> Error Type 1 Reporting Enable
> 
> +#define N_ESPI_PCR_LNKERR_SLV0_LFET1E         21              ///< Fatal Error
> Type 1 Reporting Enable bit position
> 
> +#define V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI     3               ///< Enable
> Fatal Error Type 1 Reporting as SMI
> 
> +#define B_ESPI_PCR_LNKERR_SLV0_LFET1S         BIT20           ///< Link Fatal
> Error Type 1 Status
> 
> +#define R_ESPI_PCR_LNKERR_SLV1                0x4054          ///< Link Error for
> Slave 1
> 
> +#define R_ESPI_PCR_CFG_VAL                    0xC00C          ///< ESPI Enabled
> Strap
> 
> +#define B_ESPI_PCR_CFG_VAL_ESPI_EN            BIT0            ///< ESPI Enabled
> Strap bit position
> 
> +#define R_ESPI_PCR_SOFTSTRAPS                 0xC210          ///< eSPI Sofstraps
> Register 0
> 
> +#define B_ESPI_PCR_SOFTSTRAPS_CS1_EN          BIT12           ///< CS1#
> Enable
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
> new file mode 100644
> index 0000000000..dc32f1e5b3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsf.h
> @@ -0,0 +1,50 @@
> +/** @file
> 
> +  Register definition for PSF component
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PSF_H_
> 
> +#define _PCH_REGS_PSF_H_
> 
> +//
> 
> +// PSFx segment registers
> 
> +//
> 
> +
> 
> +#define N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC          1
> 
> +#define B_PCH_PSFX_PCR_MC_CONTROL_MCASTX_MULTCEN        BIT0
> 
> +
> 
> +//
> 
> +// PSFx PCRs definitions
> 
> +//
> 
> +#define B_PCH_PSFX_PCR_TARGET_PSFID                     0xFF0000
> 
> +#define N_PCH_PSFX_PCR_TARGET_PSFID                     16
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
> new file mode 100644
> index 0000000000..2007eae44f
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Include/Register/PchRegsPsth.h
> @@ -0,0 +1,66 @@
> +/** @file
> 
> +  Register definition for PSTH component
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PSTH_H_
> 
> +#define _PCH_REGS_PSTH_H_
> 
> +
> 
> +//
> 
> +// Private chipset regsiter (Memory space) offset definition
> 
> +// The PCR register defines is used for PCR MMIO programming and PCH SBI
> programming as well.
> 
> +//
> 
> +
> 
> +//
> 
> +// PSTH and IO Trap PCRs (PID:PSTH)
> 
> +//
> 
> +#define R_PSTH_PCR_PSTHCTL          0x1D00                ///< PSTH control
> register
> 
> +#define B_PSTH_PCR_PSTHIOSFPTCGE    BIT2                  ///< PSTH IOSF
> primary trunk clock gating enable
> 
> +#define R_PSTH_PCR_TRPST            0x1E00                ///< Trap status regsiter
> 
> +#define R_PSTH_PCR_TRPC             0x1E10                ///< Trapped cycle
> 
> +#define B_PSTH_PCR_TRPC_RW          BIT24                 ///< Read/Write#:
> 1=Read, 0=Write
> 
> +#define B_PSTH_PCR_TRPC_AHBE        0x00000000000F0000    ///< Active
> high byte enables
> 
> +#define B_PSTH_PCR_TRPC_IOA         0x000000000000FFFC    ///< Trap cycle
> I/O address
> 
> +#define R_PSTH_PCR_TRPD             0x1E18                ///< Trapped write data
> 
> +#define R_PSTH_PCR_TRPREG0          0x1E80                ///< IO Tarp 0 register
> 
> +#define R_PSTH_PCR_TRPREG1          0x1E88                ///< IO Tarp 1 register
> 
> +#define R_PSTH_PCR_TRPREG2          0x1E90                ///< IO Tarp 2 register
> 
> +#define R_PSTH_PCR_TRPREG3          0x1E98                ///< IO Tarp 3 register
> 
> +#define B_PSTH_PCR_TRPREG_RWM       BIT17                 ///< 49 - 32 for 32 bit
> access, Read/Write mask
> 
> +#define B_PSTH_PCR_TRPREG_RWIO      BIT16                 ///< 48 - 32 for 32 bit
> access, Read/Write#, 1=Read, 0=Write
> 
> +#define N_PSTH_PCR_TRPREG_RWIO      16                    ///< 48 - 32 for 32 bit
> access, 16bit shift for Read/Write field
> 
> +#define N_PSTH_PCR_TRPREG_BEM       36
> 
> +#define N_PSTH_PCR_TRPREG_BE        32
> 
> +#define B_PSTH_PCR_TRPREG_AD        0x000000000000FFFC    ///< IO
> Address
> 
> +#define B_PSTH_PCR_TRPREG_TSE       BIT0                  ///< Trap and SMI#
> Enable
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers
  2021-02-01  1:36 ` [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Pch/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleReset
> Lib.h |  47 +++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivateL
> ib.h   |  26 ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
> | 269
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob.h
> |  21 +++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
> | 319
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h                  |
> 58
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.h
> |  30 ++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
> |  35 +++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.h
> |  21 +++++++++++++++++++++
>  9 files changed, 826 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleRes
> etLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleRes
> etLib.h
> new file mode 100644
> index 0000000000..2ad80a0269
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SiScheduleRes
> etLib.h
> @@ -0,0 +1,47 @@
> +/** @file
> 
> +  Reset scheduling library services
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SI_SCHEDULE_RESET_LIB_H_
> 
> +#define _SI_SCHEDULE_RESET_LIB_H_
> 
> +
> 
> +#include <Uefi/UefiMultiPhase.h>
> 
> +#include <PchResetPlatformSpecific.h>
> 
> +
> 
> +/**
> 
> +  This function updates the reset information in SiScheduleResetHob
> 
> +  @param[in] ResetType        UEFI defined reset type.
> 
> +  @param[in] ResetData        Optional element used to introduce a platform
> specific reset.
> 
> +                               The exact type of the reset is defined by the EFI_GUID that
> follows
> 
> +                               the Null-terminated Unicode string.
> 
> +**/
> 
> +VOID
> 
> +SiScheduleResetSetType (
> 
> +  IN EFI_RESET_TYPE     ResetType,
> 
> +  IN PCH_RESET_DATA     *ResetData OPTIONAL
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function returns TRUE or FALSE depending on whether a reset is
> required based on SiScheduleResetHob
> 
> +
> 
> +  @retval     BOOLEAN       The function returns FALSE if no reset is required
> 
> +**/
> 
> +BOOLEAN
> 
> +SiScheduleResetIsRequired (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function performs reset based on SiScheduleResetHob
> 
> +
> 
> +  @retval     BOOLEAN       The function returns FALSE if no reset is required
> 
> +**/
> 
> +BOOLEAN
> 
> +SiScheduleResetPerformReset (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif //_SI_SCHEDULE_RESET_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivat
> eLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivat
> eLib.h
> new file mode 100644
> index 0000000000..955dac5a82
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Library/SmmPchPrivat
> eLib.h
> @@ -0,0 +1,26 @@
> +/** @file
> 
> +  Header file for private PCH SMM Lib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SMM_PCH_PRIVATE_LIB_H_
> 
> +#define _SMM_PCH_PRIVATE_LIB_H_
> 
> +
> 
> +/**
> 
> +  Set InSmm.Sts bit
> 
> +**/
> 
> +VOID
> 
> +PchSetInSmmSts (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clear InSmm.Sts bit
> 
> +**/
> 
> +VOID
> 
> +PchClearInSmmSts (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _SMM_PCH_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
> new file mode 100644
> index 0000000000..13a41f8d04
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchConfigHob.h
> @@ -0,0 +1,269 @@
> +/** @file
> 
> +  The GUID definition for PchConfigHob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_CONFIG_HOB_H_
> 
> +#define _PCH_CONFIG_HOB_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <SmbusConfig.h>
> 
> +#include <InterruptConfig.h>
> 
> +#include <PchPcieRpConfig.h>
> 
> +#include <SataConfig.h>
> 
> +#include <RstConfig.h>
> 
> +#include <ConfigBlock/FlashProtectionConfig.h>
> 
> +#include <FivrConfig.h>
> 
> +#include <ThcConfig.h>
> 
> +#include <SerialIoConfig.h>
> 
> +
> 
> +
> 
> +extern EFI_GUID gPchConfigHobGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This structure contains the HOB which are related to PCH general config.
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member describes whether or not the Compatibility Revision ID
> (CRID) feature
> 
> +    of PCH should be enabled. <b>0: Disable</b>; 1: Enable
> 
> +  **/
> 
> +  UINT32 Crid      :  1;
> 
> +  UINT32 RsvdBits0 : 31; ///< Reserved bits
> 
> +} GENERAL_HOB;
> 
> +
> 
> +/**
> 
> +  The SMBUS_CONFIG block lists the reserved addresses for non-ARP
> capable devices in the platform.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8 RsvdBytes[3];          ///< Reserved bytes
> 
> +  UINT8 NumRsvdSmbusAddresses; ///< The number of elements in the
> RsvdSmbusAddressTable.
> 
> +  /**
> 
> +    Array of addresses reserved for non-ARP-capable SMBus devices.
> 
> +  **/
> 
> +  UINT8
> RsvdSmbusAddressTable[PCH_MAX_SMBUS_RESERVED_ADDRESS];
> 
> +} SMBUS_HOB;
> 
> +
> 
> +/**
> 
> +  The INTERRUPT_HOB describes interrupt settings for PCH.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8                        NumOfDevIntConfig;                             ///< Number of
> entries in DevIntConfig table
> 
> +  UINT8                        GpioIrqRoute;                                  ///< Interrupt routing for
> GPIO. Default is <b>14</b>.
> 
> +  UINT8                        Rsvd0[2];                                      ///< Reserved bytes, align to
> multiple 4.
> 
> +  PCH_DEVICE_INTERRUPT_CONFIG
> DevIntConfig[PCH_MAX_DEVICE_INTERRUPT_CONFIG]; ///< Array which
> stores PCH devices interrupts settings
> 
> +} INTERRUPT_HOB;
> 
> +
> 
> +/**
> 
> +  The SERIAL_IO block provides the configurations to set the Serial IO
> controllers
> 
> +**/
> 
> +typedef struct {
> 
> +  SERIAL_IO_SPI_CONFIG
> SpiDeviceConfig[PCH_MAX_SERIALIO_SPI_CONTROLLERS];   ///< SPI
> Configuration
> 
> +  SERIAL_IO_I2C_CONFIG
> I2cDeviceConfig[PCH_MAX_SERIALIO_I2C_CONTROLLERS];   ///< I2C
> Configuration
> 
> +  SERIAL_IO_UART_CONFIG
> UartDeviceConfig[PCH_MAX_SERIALIO_UART_CONTROLLERS]; ///< UART
> Configuration
> 
> +} SERIAL_IO_HOB;
> 
> +
> 
> +/**
> 
> +  The PCIERP_HOB block describes the expected configuration of the PCH
> PCI Express controllers
> 
> +**/
> 
> +typedef struct {
> 
> +  ///
> 
> +  /// These members describe the configuration of each PCH PCIe root port.
> 
> +  ///
> 
> +  PCH_PCIE_ROOT_PORT_CONFIG
> RootPort[PCH_MAX_PCIE_ROOT_PORTS];
> 
> +  PCH_PCIE_CLOCK               PcieClock[PCH_MAX_PCIE_CLOCKS];
> 
> +  /**
> 
> +    This member allows BIOS to control ICC PLL Shutdown by determining
> PCIe devices are LTR capable
> 
> +    or leaving untouched.
> 
> +    - <b>0: Disable, ICC PLL Shutdown is determined by PCIe device LTR
> capablility.</b>
> 
> +      - To allow ICC PLL shutdown if all present PCIe devices are LTR capable or
> if no PCIe devices are
> 
> +        presented for maximum power savings where possible.
> 
> +      - To disable ICC PLL shutdown when BIOS detects any non-LTR capable
> PCIe device for ensuring device
> 
> +        functionality.
> 
> +    - 1: Enable, To allow ICC PLL shutdown even if some devices do not
> support LTR capability.
> 
> +  **/
> 
> +  UINT32  AllowNoLtrIccPllShutdown :  1;
> 
> +  UINT32  RsvdBits0                : 31; ///< Reserved bits
> 
> +} PCIERP_HOB;
> 
> +
> 
> +/**
> 
> +  The HDAUDIO_HOB block describes the configuration of the PCH cAVS
> controller
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  DspEnable             :  1; ///< DSP enablement: 0: Disable; <b>1:
> Enable</b>
> 
> +  UINT32  DspUaaCompliance      :  1; ///< UAA-mode Select: <b>0: Non-
> Uaa</b>; 1: UAA
> 
> +  UINT32  CodecSxWakeCapability :  1; ///< Capability to detect wake
> initiated by a codec in Sx, <b>0: Disable</b>; 1: Enable
> 
> +  UINT32  AudioLinkSndw1        :  1; ///< SoundWire1 link enablement: <b>0:
> Disable</b>; 1: Enable. Muxed with HDA
> 
> +  UINT32  AudioLinkSndw2        :  1; ///< SoundWire2 link enablement: <b>0:
> Disable</b>; 1: Enable. Muxed with SSP1
> 
> +  UINT32  AudioLinkSndw3        :  1; ///< SoundWire3 link enablement: <b>0:
> Disable</b>; 1: Enable. Muxed with DMIC1
> 
> +  UINT32  AudioLinkSndw4        :  1; ///< SoundWire4 link enablement: <b>0:
> Disable</b>; 1: Enable. Muxed with DMIC0
> 
> +  UINT32  Pme                   :  1; ///< Azalia wake-on-ring, <b>0: Disable</b>; 1:
> Enable
> 
> +  UINT32  RsvdBits0             : 24; ///< Reserved bits
> 
> +} HDAUDIO_HOB;
> 
> +
> 
> +/**
> 
> +  The SATA_HOB block describes the configuration of the PCH SATA
> controllers
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member describes whether or not the SATA controllers should be
> enabled. 0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32                        Enable          :  1;
> 
> +  UINT32                        TestMode        :  1; ///< <b>(Test)</b> <b>0:
> Disable</b>; 1: Allow entrance to the PCH SATA test modes
> 
> +  UINT32                        RsvdBits0       : 30; ///< Reserved bits
> 
> +  /**
> 
> +    This member configures the features, property, and capability for each
> SATA port.
> 
> +  **/
> 
> +  PCH_SATA_PORT_CONFIG          PortSettings[PCH_MAX_SATA_PORTS];
> 
> +} SATA_HOB;
> 
> +
> 
> +/**
> 
> +  The RST block describes the configuration of the RST PCIE Cycle Routers
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    This member describes the details of implementation of Intel RST for PCIe
> Storage remapping (Intel RST Driver is required)
> 
> +  **/
> 
> +  RST_HARDWARE_REMAPPED_STORAGE_CONFIG
> RstHardwareRemappedStorageConfig[PCH_MAX_RST_PCIE_STORAGE_CR];
> 
> +} RST_HOB;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  Enabled  : 1; ///< Indicates that SD card has been enabled
> 
> +  UINT32  Reserved : 31;
> 
> +} SD_CARD_HOB;
> 
> +
> 
> +/**
> 
> +  The EMMC_HOB block describes integrated eMMC settings for PCH.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  Enabled                      :  1;  ///< Determine if eMMC is enabled - 0:
> Disabled, <b>1: Enabled</b>.
> 
> +  UINT32  Hs400Enabled                 :  1;  ///< Determine eMMC HS400 Mode if
> EmmcEnabled - <b>0: Disabled</b>, 1: Enabled
> 
> +  /**
> 
> +    Determine if HS400 Training is required, set to FALSE if Hs400 Data is valid.
> <b>0: Disabled</b>, 1: Enabled.
> 
> +    First Boot or CMOS clear, system boot with Default settings, set tuning
> required.
> 
> +    Subsequent Boots, Get Variable 'Hs400TuningData'
> 
> +      - if failed to get variable, set tuning required
> 
> +      - if passed, retrieve Hs400DataValid, Hs400RxStrobe1Dll and
> Hs400TxDataDll from variable. Set tuning not required.
> 
> +  **/
> 
> +  UINT32  Hs400DllDataValid            :  1;  ///< Set if HS400 Tuning Data Valid
> 
> +  UINT32  RsvdBits                     : 29;
> 
> +} EMMC_HOB;
> 
> +
> 
> +/**
> 
> +  The PCH_LOCK_DOWN_CONFIG block describes the expected
> configuration of the PCH
> 
> +  for security requirement.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  GlobalSmi      :  1;
> 
> +  /**
> 
> +    <b>(Test)</b> Enable BIOS Interface Lock Down bit to prevent writes to
> the Backup Control Register
> 
> +    Top Swap bit and the General Control and Status Registers Boot BIOS
> Straps. 0: Disable; <b>1: Enable</b>.
> 
> +  **/
> 
> +  UINT32  BiosInterface  :  1;
> 
> +  /**
> 
> +    Enable the BIOS Lock Enable (BLE) feature and set EISS bit
> (D31:F5:RegDCh[5])
> 
> +    for the BIOS region protection. When it is enabled, the BIOS Region can
> only be
> 
> +    modified from SMM after EndOfDxe protocol is installed.
> 
> +    Note: When BiosLock is enabled, platform code also needs to update to
> take care
> 
> +    of BIOS modification (including SetVariable) in DXE or runtime phase after
> 
> +    EndOfDxe protocol is installed.
> 
> +    Enable InSMM.STS (EISS) in SPI
> 
> +    If this EISS bit is set, then WPD must be a '1' and InSMM.STS must be '1'
> also
> 
> +    in order to write to BIOS regions of SPI Flash. If this EISS bit is clear,
> 
> +    then the InSMM.STS is a don't care.
> 
> +    The BIOS must set the EISS bit while BIOS Guard support is enabled.
> 
> +    In recovery path, platform can temporary disable EISS for SPI
> programming in
> 
> +    PEI phase or early DXE phase.
> 
> +    0: Disable; <b>1: Enable.</b>
> 
> +  **/
> 
> +  UINT32  BiosLock        :  1;
> 
> +  UINT32  RsvdBits        : 29;
> 
> +} LOCK_DOWN_HOB;
> 
> +
> 
> +/**
> 
> +  The PM_HOB block describes expected miscellaneous power management
> settings.
> 
> +  The PowerResetStatusClear field would clear the Power/Reset status bits,
> please
> 
> +  set the bits if you want PCH Init driver to clear it, if you want to check the
> 
> +  status later then clear the bits.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32 PsOnEnable             :  1; ///< Indicates if PS_ON support has been
> enabled, <b>0: Disable</b>; 1: Enable.
> 
> +  UINT32 EnableTimedGpio0       :  1; ///< Enable Bit for Timed GPIO 0 <b>0 =
> disable</b>; 1 = enable
> 
> +  UINT32 EnableTimedGpio1       :  1; ///< Enable Bit for Timed GPIO 1 <b>0 =
> disable</b>; 1 = enable
> 
> +  UINT32 RsvdBits1              : 29;
> 
> +} PM_HOB;
> 
> +
> 
> +/**
> 
> +  FIVR_HOB block
> 
> +**/
> 
> +typedef struct {
> 
> +  /**
> 
> +    Additional External Vnn VR rail configuration dedicated for Sx.
> 
> +    Required only if External Vnn VR needs different settings for Sx than
> 
> +    those specified in ExtVnnRail (refer to PCH_FIVR_CONFIG.ExtVnnRail)
> 
> +  **/
> 
> +  FIVR_EXT_RAIL_CONFIG     ExtVnnRailSx;
> 
> +} FIVR_HOB;
> 
> +
> 
> +/**
> 
> +  PCH Trace Hub HOB settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  PchTraceHubMode       :  2; ///< <b>0 = Disable</b>; 1 = Target
> Debugger mode; 2 = Host Debugger mode
> 
> +  UINT32  Rsvd1                 : 30; ///< Reserved bits
> 
> +  /**
> 
> +    Trace hub memory buffer region size policy.
> 
> +    The avaliable memory size options are: 0:0MB (none), 1:1MB,
> <b>2:8MB</b>, 3:64MB, 4:128MB, 5:256MB, 6:512MB.
> 
> +    Note : Limitation of total buffer size (CPU + PCH) is 512MB. If iTbt is
> enabled, the total size limits to 256 MB.
> 
> +    Refer to TRACE_BUFFER_SIZE
> 
> +  **/
> 
> +  UINT32  MemReg0Size;
> 
> +  UINT32  MemReg1Size;
> 
> +} PCH_TRACEHUB_HOB;
> 
> +
> 
> +/**
> 
> +  PCH eSPI HOB settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT32  BmeMasterSlaveEnabled :  1; ///< <b>0 = BME disable</b>; 1 =
> BME enable
> 
> +  UINT32  RsvdBits              : 31; ///< Reserved bits
> 
> +} PCH_ESPI_HOB;
> 
> +
> 
> +/**
> 
> +  THC HOB settings.
> 
> +**/
> 
> +typedef struct {
> 
> +  THC_PORT  ThcPort[2]; ///< Port Configuration
> 
> +} THC_HOB;
> 
> +
> 
> +
> 
> +/**
> 
> +  This structure contains the HOBs which are related to PCH controllers
> 
> +**/
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE  EfiHobGuidType;     ///< GUID HOB type structure
> for gPchConfigHobGuid
> 
> +  GENERAL_HOB        General;            ///< Pch general HOB definition
> 
> +  INTERRUPT_HOB      Interrupt;          ///< Interrupt HOB definition
> 
> +  SERIAL_IO_HOB      SerialIo;           ///< Serial io HOB definition
> 
> +  PCIERP_HOB         PcieRp;             ///< PCIE root port HOB definition
> 
> +  SD_CARD_HOB        SdCard;             ///< SD card HOB definition
> 
> +  EMMC_HOB           Emmc;               ///< eMMC HOB definition
> 
> +  LOCK_DOWN_HOB      LockDown;           ///< Lock down HOB definition
> 
> +  PM_HOB             Pm;                 ///< PM HOB definition
> 
> +  HDAUDIO_HOB        HdAudio;            ///< HD audio definition
> 
> +  SATA_HOB           Sata[PCH_MAX_SATA_CONTROLLERS]; ///< SATA
> definition
> 
> +  RST_HOB            Rst;                ///< RST definition
> 
> +  PROTECTED_RANGE    ProtectRange[PCH_FLASH_PROTECTED_RANGES];
> 
> +  SMBUS_HOB          Smbus;
> 
> +  PCH_TRACEHUB_HOB   PchTraceHub;        ///< PCH Trace Hub definition
> 
> +  PCH_ESPI_HOB       Espi;               ///< PCH eSPI definition
> 
> +  THC_HOB            Thc;                ///< PCH Tocuh Host Controller definition
> 
> +  FIVR_HOB           Fivr;               ///< PCH FIVR HOB definition
> 
> +
> 
> +
> 
> +} PCH_CONFIG_HOB;
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob
> .h
> new file mode 100644
> index 0000000000..040bc270e6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchHybridStorageHob
> .h
> @@ -0,0 +1,21 @@
> +/** @file
> 
> +
> 
> +  Definitions required to create HybridStorageHob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_HYBRIDSTORAGE_HOB_
> 
> +#define _PCH_HYBRIDSTORAGE_HOB_
> 
> +
> 
> +extern EFI_GUID  gHybridStorageHobGuid;
> 
> +
> 
> +//
> 
> +//  Passes to DXE Hybrid Storage location
> 
> +//
> 
> +typedef struct {
> 
> +  UINT32 HybridStorageLocation;
> 
> +} PCH_HYBRIDSTORAGE_HOB;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
> new file mode 100644
> index 0000000000..200f3ca8fa
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchNvsAreaDef.h
> @@ -0,0 +1,319 @@
> +//
> 
> +// Automatically generated by GenNvs ver 2.4.6
> 
> +// Please DO NOT modify !!!
> 
> +//
> 
> +
> 
> +/** @file
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +  //
> 
> +  // Define PCH NVS Area operatino region.
> 
> +  //
> 
> +#ifndef _PCH_NVS_AREA_DEF_H_
> 
> +#define _PCH_NVS_AREA_DEF_H_
> 
> +
> 
> +#pragma pack (push,1)
> 
> +typedef struct {
> 
> +  UINT16   PchSeries;                               ///< Offset 0       PCH Series
> 
> +  UINT16   PchGeneration;                           ///< Offset 2       PCH Generation
> 
> +  UINT16   PchStepping;                             ///< Offset 4       PCH Stepping
> 
> +  UINT32   RpAddress[28];                           ///< Offset 6       Root Port address 1
> 
> +                                                    ///< Offset 10      Root Port address 2
> 
> +                                                    ///< Offset 14      Root Port address 3
> 
> +                                                    ///< Offset 18      Root Port address 4
> 
> +                                                    ///< Offset 22      Root Port address 5
> 
> +                                                    ///< Offset 26      Root Port address 6
> 
> +                                                    ///< Offset 30      Root Port address 7
> 
> +                                                    ///< Offset 34      Root Port address 8
> 
> +                                                    ///< Offset 38      Root Port address 9
> 
> +                                                    ///< Offset 42      Root Port address 10
> 
> +                                                    ///< Offset 46      Root Port address 11
> 
> +                                                    ///< Offset 50      Root Port address 12
> 
> +                                                    ///< Offset 54      Root Port address 13
> 
> +                                                    ///< Offset 58      Root Port address 14
> 
> +                                                    ///< Offset 62      Root Port address 15
> 
> +                                                    ///< Offset 66      Root Port address 16
> 
> +                                                    ///< Offset 70      Root Port address 17
> 
> +                                                    ///< Offset 74      Root Port address 18
> 
> +                                                    ///< Offset 78      Root Port address 19
> 
> +                                                    ///< Offset 82      Root Port address 20
> 
> +                                                    ///< Offset 86      Root Port address 21
> 
> +                                                    ///< Offset 90      Root Port address 22
> 
> +                                                    ///< Offset 94      Root Port address 23
> 
> +                                                    ///< Offset 98      Root Port address 24
> 
> +                                                    ///< Offset 102     Root Port address 25
> 
> +                                                    ///< Offset 106     Root Port address 26
> 
> +                                                    ///< Offset 110     Root Port address 27
> 
> +                                                    ///< Offset 114     Root Port address 28
> 
> +  UINT64   NHLA;                                    ///< Offset 118     HD-Audio NHLT ACPI
> address
> 
> +  UINT32   NHLL;                                    ///< Offset 126     HD-Audio NHLT ACPI
> length
> 
> +  UINT32   ADFM;                                    ///< Offset 130     HD-Audio DSP Feature
> Mask
> 
> +  UINT8    SWQ0;                                    ///< Offset 134     HD-Audio SoundWire
> Link #1 quirk mask
> 
> +  UINT8    SWQ1;                                    ///< Offset 135     HD-Audio SoundWire
> Link #2 quirk mask
> 
> +  UINT8    SWQ2;                                    ///< Offset 136     HD-Audio SoundWire
> Link #3 quirk mask
> 
> +  UINT8    SWQ3;                                    ///< Offset 137     HD-Audio SoundWire
> Link #4 quirk mask
> 
> +  UINT8    ACS0;                                    ///< Offset 138     HD-Audio SoundWire
> Link #1 Autonomous Clock Stop
> 
> +  UINT8    ACS1;                                    ///< Offset 139     HD-Audio SoundWire
> Link #2 Autonomous Clock Stop
> 
> +  UINT8    ACS2;                                    ///< Offset 140     HD-Audio SoundWire
> Link #3 Autonomous Clock Stop
> 
> +  UINT8    ACS3;                                    ///< Offset 141     HD-Audio SoundWire
> Link #4 Autonomous Clock Stop
> 
> +  UINT8    DAI0;                                    ///< Offset 142     HD-Audio SoundWire Link
> #1 Data On Active Interval Select
> 
> +  UINT8    DAI1;                                    ///< Offset 143     HD-Audio SoundWire Link
> #2 Data On Active Interval Select
> 
> +  UINT8    DAI2;                                    ///< Offset 144     HD-Audio SoundWire Link
> #3 Data On Active Interval Select
> 
> +  UINT8    DAI3;                                    ///< Offset 145     HD-Audio SoundWire Link
> #4 Data On Active Interval Select
> 
> +  UINT8    DOD0;                                    ///< Offset 146     HD-Audio SoundWire
> Link #1 Data On Delay Select
> 
> +  UINT8    DOD1;                                    ///< Offset 147     HD-Audio SoundWire
> Link #2 Data On Delay Select
> 
> +  UINT8    DOD2;                                    ///< Offset 148     HD-Audio SoundWire
> Link #3 Data On Delay Select
> 
> +  UINT8    DOD3;                                    ///< Offset 149     HD-Audio SoundWire
> Link #4 Data On Delay Select
> 
> +  UINT8    SWMC;                                    ///< Offset 150     HD-Audio SoundWire
> Master Count
> 
> +  UINT8    XTAL;                                    ///< Offset 151     XTAL frequency: 0:
> 24MHz; 1: 38.4MHz; 2: Unsupported
> 
> +  UINT32   DSPM;                                    ///< Offset 152     HD-Audio DSP Stolen
> Memory Base Address (@todo: Remove after CNL-LP B0)
> 
> +  UINT32   SBRG;                                    ///< Offset 156     SBREG_BAR
> 
> +  UINT8    GEI0;                                    ///< Offset 160     GPIO GroupIndex
> mapped to GPE_DW0
> 
> +  UINT8    GEI1;                                    ///< Offset 161     GPIO GroupIndex
> mapped to GPE_DW1
> 
> +  UINT8    GEI2;                                    ///< Offset 162     GPIO GroupIndex
> mapped to GPE_DW2
> 
> +  UINT8    GED0;                                    ///< Offset 163     GPIO DW part of group
> mapped to GPE_DW0
> 
> +  UINT8    GED1;                                    ///< Offset 164     GPIO DW part of group
> mapped to GPE_DW1
> 
> +  UINT8    GED2;                                    ///< Offset 165     GPIO DW part of group
> mapped to GPE_DW2
> 
> +  UINT16   PcieLtrMaxSnoopLatency[28];              ///< Offset 166     PCIE LTR
> max snoop Latency 1
> 
> +                                                    ///< Offset 168     PCIE LTR max snoop Latency 2
> 
> +                                                    ///< Offset 170     PCIE LTR max snoop Latency 3
> 
> +                                                    ///< Offset 172     PCIE LTR max snoop Latency 4
> 
> +                                                    ///< Offset 174     PCIE LTR max snoop Latency 5
> 
> +                                                    ///< Offset 176     PCIE LTR max snoop Latency 6
> 
> +                                                    ///< Offset 178     PCIE LTR max snoop Latency 7
> 
> +                                                    ///< Offset 180     PCIE LTR max snoop Latency 8
> 
> +                                                    ///< Offset 182     PCIE LTR max snoop Latency 9
> 
> +                                                    ///< Offset 184     PCIE LTR max snoop Latency 10
> 
> +                                                    ///< Offset 186     PCIE LTR max snoop Latency 11
> 
> +                                                    ///< Offset 188     PCIE LTR max snoop Latency 12
> 
> +                                                    ///< Offset 190     PCIE LTR max snoop Latency 13
> 
> +                                                    ///< Offset 192     PCIE LTR max snoop Latency 14
> 
> +                                                    ///< Offset 194     PCIE LTR max snoop Latency 15
> 
> +                                                    ///< Offset 196     PCIE LTR max snoop Latency 16
> 
> +                                                    ///< Offset 198     PCIE LTR max snoop Latency 17
> 
> +                                                    ///< Offset 200     PCIE LTR max snoop Latency 18
> 
> +                                                    ///< Offset 202     PCIE LTR max snoop Latency 19
> 
> +                                                    ///< Offset 204     PCIE LTR max snoop Latency 20
> 
> +                                                    ///< Offset 206     PCIE LTR max snoop Latency 21
> 
> +                                                    ///< Offset 208     PCIE LTR max snoop Latency 22
> 
> +                                                    ///< Offset 210     PCIE LTR max snoop Latency 23
> 
> +                                                    ///< Offset 212     PCIE LTR max snoop Latency 24
> 
> +                                                    ///< Offset 214     PCIE LTR max snoop Latency 25
> 
> +                                                    ///< Offset 216     PCIE LTR max snoop Latency 26
> 
> +                                                    ///< Offset 218     PCIE LTR max snoop Latency 27
> 
> +                                                    ///< Offset 220     PCIE LTR max snoop Latency 28
> 
> +  UINT16   PcieLtrMaxNoSnoopLatency[28];            ///< Offset 222     PCIE LTR
> max no snoop Latency 1
> 
> +                                                    ///< Offset 224     PCIE LTR max no snoop Latency
> 2
> 
> +                                                    ///< Offset 226     PCIE LTR max no snoop Latency
> 3
> 
> +                                                    ///< Offset 228     PCIE LTR max no snoop Latency
> 4
> 
> +                                                    ///< Offset 230     PCIE LTR max no snoop Latency
> 5
> 
> +                                                    ///< Offset 232     PCIE LTR max no snoop Latency
> 6
> 
> +                                                    ///< Offset 234     PCIE LTR max no snoop Latency
> 7
> 
> +                                                    ///< Offset 236     PCIE LTR max no snoop Latency
> 8
> 
> +                                                    ///< Offset 238     PCIE LTR max no snoop Latency
> 9
> 
> +                                                    ///< Offset 240     PCIE LTR max no snoop Latency
> 10
> 
> +                                                    ///< Offset 242     PCIE LTR max no snoop Latency
> 11
> 
> +                                                    ///< Offset 244     PCIE LTR max no snoop Latency
> 12
> 
> +                                                    ///< Offset 246     PCIE LTR max no snoop Latency
> 13
> 
> +                                                    ///< Offset 248     PCIE LTR max no snoop Latency
> 14
> 
> +                                                    ///< Offset 250     PCIE LTR max no snoop Latency
> 15
> 
> +                                                    ///< Offset 252     PCIE LTR max no snoop Latency
> 16
> 
> +                                                    ///< Offset 254     PCIE LTR max no snoop Latency
> 17
> 
> +                                                    ///< Offset 256     PCIE LTR max no snoop Latency
> 18
> 
> +                                                    ///< Offset 258     PCIE LTR max no snoop Latency
> 19
> 
> +                                                    ///< Offset 260     PCIE LTR max no snoop Latency
> 20
> 
> +                                                    ///< Offset 262     PCIE LTR max no snoop Latency
> 21
> 
> +                                                    ///< Offset 264     PCIE LTR max no snoop Latency
> 22
> 
> +                                                    ///< Offset 266     PCIE LTR max no snoop Latency
> 23
> 
> +                                                    ///< Offset 268     PCIE LTR max no snoop Latency
> 24
> 
> +                                                    ///< Offset 270     PCIE LTR max no snoop Latency
> 25
> 
> +                                                    ///< Offset 272     PCIE LTR max no snoop Latency
> 26
> 
> +                                                    ///< Offset 274     PCIE LTR max no snoop Latency
> 27
> 
> +                                                    ///< Offset 276     PCIE LTR max no snoop Latency
> 28
> 
> +  UINT8    XHPC;                                    ///< Offset 278     Number of HighSpeed
> ports implemented in XHCI controller
> 
> +  UINT8    XRPC;                                    ///< Offset 279     Number of USBR ports
> implemented in XHCI controller
> 
> +  UINT8    XSPC;                                    ///< Offset 280     Number of SuperSpeed
> ports implemented in XHCI controller
> 
> +  UINT8    XSPA;                                    ///< Offset 281     Address of 1st
> SuperSpeed port
> 
> +  UINT32   HPTB;                                    ///< Offset 282     HPET base address
> 
> +  UINT8    HPTE;                                    ///< Offset 286     HPET enable
> 
> +  //SerialIo block
> 
> +  UINT8    SM0[7];                                  ///< Offset 287     SerialIo SPI Controller 0
> Mode
> 
> +                                                    ///< Offset 288     SerialIo SPI Controller 1 Mode
> 
> +                                                    ///< Offset 289     SerialIo SPI Controller 2 Mode
> 
> +                                                    ///< Offset 290     SerialIo SPI Controller 3 Mode
> 
> +                                                    ///< Offset 291     SerialIo SPI Controller 4 Mode
> 
> +                                                    ///< Offset 292     SerialIo SPI Controller 5 Mode
> 
> +                                                    ///< Offset 293     SerialIo SPI Controller 6 Mode
> 
> +  UINT64   SC0[7];                                  ///< Offset 294     SerialIo SPI Controller 0
> Pci Config
> 
> +                                                    ///< Offset 302     SerialIo SPI Controller 1 Pci
> Config
> 
> +                                                    ///< Offset 310     SerialIo SPI Controller 2 Pci
> Config
> 
> +                                                    ///< Offset 318     SerialIo SPI Controller 3 Pci
> Config
> 
> +                                                    ///< Offset 326     SerialIo SPI Controller 4 Pci
> Config
> 
> +                                                    ///< Offset 334     SerialIo SPI Controller 5 Pci
> Config
> 
> +                                                    ///< Offset 342     SerialIo SPI Controller 6 Pci
> Config
> 
> +  UINT8    IM0[8];                                  ///< Offset 350     SerialIo I2C Controller 0
> Mode
> 
> +                                                    ///< Offset 351     SerialIo I2C Controller 1 Mode
> 
> +                                                    ///< Offset 352     SerialIo I2C Controller 2 Mode
> 
> +                                                    ///< Offset 353     SerialIo I2C Controller 3 Mode
> 
> +                                                    ///< Offset 354     SerialIo I2C Controller 4 Mode
> 
> +                                                    ///< Offset 355     SerialIo I2C Controller 5 Mode
> 
> +                                                    ///< Offset 356     SerialIo I2C Controller 6 Mode
> 
> +                                                    ///< Offset 357     SerialIo I2C Controller 7 Mode
> 
> +  UINT64   IC0[8];                                  ///< Offset 358     SerialIo I2C Controller 0
> Pci Config
> 
> +                                                    ///< Offset 366     SerialIo I2C Controller 1 Pci
> Config
> 
> +                                                    ///< Offset 374     SerialIo I2C Controller 2 Pci
> Config
> 
> +                                                    ///< Offset 382     SerialIo I2C Controller 3 Pci
> Config
> 
> +                                                    ///< Offset 390     SerialIo I2C Controller 4 Pci
> Config
> 
> +                                                    ///< Offset 398     SerialIo I2C Controller 5 Pci
> Config
> 
> +                                                    ///< Offset 406     SerialIo I2C Controller 6 Pci
> Config
> 
> +                                                    ///< Offset 414     SerialIo I2C Controller 7 Pci
> Config
> 
> +  UINT8    UM0[7];                                  ///< Offset 422     SerialIo UART Controller
> 0 Mode
> 
> +                                                    ///< Offset 423     SerialIo UART Controller 1 Mode
> 
> +                                                    ///< Offset 424     SerialIo UART Controller 2 Mode
> 
> +                                                    ///< Offset 425     SerialIo UART Controller 3 Mode
> 
> +                                                    ///< Offset 426     SerialIo UART Controller 4 Mode
> 
> +                                                    ///< Offset 427     SerialIo UART Controller 5 Mode
> 
> +                                                    ///< Offset 428     SerialIo UART Controller 6 Mode
> 
> +  UINT64   UC0[7];                                  ///< Offset 429     SerialIo UART Controller
> 0 Pci Config
> 
> +                                                    ///< Offset 437     SerialIo UART Controller 1 Pci
> Config
> 
> +                                                    ///< Offset 445     SerialIo UART Controller 2 Pci
> Config
> 
> +                                                    ///< Offset 453     SerialIo UART Controller 3 Pci
> Config
> 
> +                                                    ///< Offset 461     SerialIo UART Controller 4 Pci
> Config
> 
> +                                                    ///< Offset 469     SerialIo UART Controller 5 Pci
> Config
> 
> +                                                    ///< Offset 477     SerialIo UART Controller 6 Pci
> Config
> 
> +  UINT8    UD0[7];                                  ///< Offset 485     SerialIo UART Controller
> 0 DmaEnable
> 
> +                                                    ///< Offset 486     SerialIo UART Controller 1
> DmaEnable
> 
> +                                                    ///< Offset 487     SerialIo UART Controller 2
> DmaEnable
> 
> +                                                    ///< Offset 488     SerialIo UART Controller 3
> DmaEnable
> 
> +                                                    ///< Offset 489     SerialIo UART Controller 4
> DmaEnable
> 
> +                                                    ///< Offset 490     SerialIo UART Controller 5
> DmaEnable
> 
> +                                                    ///< Offset 491     SerialIo UART Controller 6
> DmaEnable
> 
> +  UINT8    UP0[7];                                  ///< Offset 492     SerialIo UART Controller
> 0 Power Gating
> 
> +                                                    ///< Offset 493     SerialIo UART Controller 1 Power
> Gating
> 
> +                                                    ///< Offset 494     SerialIo UART Controller 2 Power
> Gating
> 
> +                                                    ///< Offset 495     SerialIo UART Controller 3 Power
> Gating
> 
> +                                                    ///< Offset 496     SerialIo UART Controller 4 Power
> Gating
> 
> +                                                    ///< Offset 497     SerialIo UART Controller 5 Power
> Gating
> 
> +                                                    ///< Offset 498     SerialIo UART Controller 6 Power
> Gating
> 
> +  UINT8    UI0[7];                                  ///< Offset 499     SerialIo UART Controller
> 0 Irq
> 
> +                                                    ///< Offset 500     SerialIo UART Controller 1 Irq
> 
> +                                                    ///< Offset 501     SerialIo UART Controller 2 Irq
> 
> +                                                    ///< Offset 502     SerialIo UART Controller 3 Irq
> 
> +                                                    ///< Offset 503     SerialIo UART Controller 4 Irq
> 
> +                                                    ///< Offset 504     SerialIo UART Controller 5 Irq
> 
> +                                                    ///< Offset 505     SerialIo UART Controller 6 Irq
> 
> +  //end of SerialIo block
> 
> +  UINT8    SGIR;                                    ///< Offset 506     GPIO IRQ
> 
> +  UINT8    GPHD;                                    ///< Offset 507     Hide GPIO ACPI device
> 
> +  UINT8    RstPcieStorageInterfaceType[3];          ///< Offset 508     RST PCIe
> Storage Cycle Router#1 Interface Type
> 
> +                                                    ///< Offset 509     RST PCIe Storage Cycle Router#2
> Interface Type
> 
> +                                                    ///< Offset 510     RST PCIe Storage Cycle Router#3
> Interface Type
> 
> +  UINT8    RstPcieStoragePmCapPtr[3];               ///< Offset 511     RST PCIe
> Storage Cycle Router#1 Power Management Capability Pointer
> 
> +                                                    ///< Offset 512     RST PCIe Storage Cycle Router#2
> Power Management Capability Pointer
> 
> +                                                    ///< Offset 513     RST PCIe Storage Cycle Router#3
> Power Management Capability Pointer
> 
> +  UINT8    RstPcieStoragePcieCapPtr[3];             ///< Offset 514     RST PCIe
> Storage Cycle Router#1 PCIe Capabilities Pointer
> 
> +                                                    ///< Offset 515     RST PCIe Storage Cycle Router#2
> PCIe Capabilities Pointer
> 
> +                                                    ///< Offset 516     RST PCIe Storage Cycle Router#3
> PCIe Capabilities Pointer
> 
> +  UINT16   RstPcieStorageL1ssCapPtr[3];             ///< Offset 517     RST PCIe
> Storage Cycle Router#1 L1SS Capability Pointer
> 
> +                                                    ///< Offset 519     RST PCIe Storage Cycle Router#2
> L1SS Capability Pointer
> 
> +                                                    ///< Offset 521     RST PCIe Storage Cycle Router#3
> L1SS Capability Pointer
> 
> +  UINT8    RstPcieStorageEpL1ssControl2[3];         ///< Offset 523     RST PCIe
> Storage Cycle Router#1 Endpoint L1SS Control Data2
> 
> +                                                    ///< Offset 524     RST PCIe Storage Cycle Router#2
> Endpoint L1SS Control Data2
> 
> +                                                    ///< Offset 525     RST PCIe Storage Cycle Router#3
> Endpoint L1SS Control Data2
> 
> +  UINT32   RstPcieStorageEpL1ssControl1[3];         ///< Offset 526     RST PCIe
> Storage Cycle Router#1 Endpoint L1SS Control Data1
> 
> +                                                    ///< Offset 530     RST PCIe Storage Cycle Router#2
> Endpoint L1SS Control Data1
> 
> +                                                    ///< Offset 534     RST PCIe Storage Cycle Router#3
> Endpoint L1SS Control Data1
> 
> +  UINT16   RstPcieStorageLtrCapPtr[3];              ///< Offset 538     RST PCIe
> Storage Cycle Router#1 LTR Capability Pointer
> 
> +                                                    ///< Offset 540     RST PCIe Storage Cycle Router#2
> LTR Capability Pointer
> 
> +                                                    ///< Offset 542     RST PCIe Storage Cycle Router#3
> LTR Capability Pointer
> 
> +  UINT32   RstPcieStorageEpLtrData[3];              ///< Offset 544     RST PCIe
> Storage Cycle Router#1 Endpoint LTR Data
> 
> +                                                    ///< Offset 548     RST PCIe Storage Cycle Router#2
> Endpoint LTR Data
> 
> +                                                    ///< Offset 552     RST PCIe Storage Cycle Router#3
> Endpoint LTR Data
> 
> +  UINT16   RstPcieStorageEpLctlData16[3];           ///< Offset 556     RST PCIe
> Storage Cycle Router#1 Endpoint LCTL Data
> 
> +                                                    ///< Offset 558     RST PCIe Storage Cycle Router#2
> Endpoint LCTL Data
> 
> +                                                    ///< Offset 560     RST PCIe Storage Cycle Router#3
> Endpoint LCTL Data
> 
> +  UINT16   RstPcieStorageEpDctlData16[3];           ///< Offset 562     RST PCIe
> Storage Cycle Router#1 Endpoint DCTL Data
> 
> +                                                    ///< Offset 564     RST PCIe Storage Cycle Router#2
> Endpoint DCTL Data
> 
> +                                                    ///< Offset 566     RST PCIe Storage Cycle Router#3
> Endpoint DCTL Data
> 
> +  UINT16   RstPcieStorageEpDctl2Data16[3];          ///< Offset 568     RST PCIe
> Storage Cycle Router#1 Endpoint DCTL2 Data
> 
> +                                                    ///< Offset 570     RST PCIe Storage Cycle Router#2
> Endpoint DCTL2 Data
> 
> +                                                    ///< Offset 572     RST PCIe Storage Cycle Router#3
> Endpoint DCTL2 Data
> 
> +  UINT16   RstPcieStorageRpDctl2Data16[3];          ///< Offset 574     RST PCIe
> Storage Cycle Router#1 RootPort DCTL2 Data
> 
> +                                                    ///< Offset 576     RST PCIe Storage Cycle Router#2
> RootPort DCTL2 Data
> 
> +                                                    ///< Offset 578     RST PCIe Storage Cycle Router#3
> RootPort DCTL2 Data
> 
> +  UINT32   RstPcieStorageUniqueTableBar[3];         ///< Offset 580     RST PCIe
> Storage Cycle Router#1 Endpoint unique MSI-X Table BAR
> 
> +                                                    ///< Offset 584     RST PCIe Storage Cycle Router#2
> Endpoint unique MSI-X Table BAR
> 
> +                                                    ///< Offset 588     RST PCIe Storage Cycle Router#3
> Endpoint unique MSI-X Table BAR
> 
> +  UINT32   RstPcieStorageUniqueTableBarValue[3];    ///< Offset 592     RST
> PCIe Storage Cycle Router#1 Endpoint unique MSI-X Table BAR value
> 
> +                                                    ///< Offset 596     RST PCIe Storage Cycle Router#2
> Endpoint unique MSI-X Table BAR value
> 
> +                                                    ///< Offset 600     RST PCIe Storage Cycle Router#3
> Endpoint unique MSI-X Table BAR value
> 
> +  UINT32   RstPcieStorageUniquePbaBar[3];           ///< Offset 604     RST PCIe
> Storage Cycle Router#1 Endpoint unique MSI-X PBA BAR
> 
> +                                                    ///< Offset 608     RST PCIe Storage Cycle Router#2
> Endpoint unique MSI-X PBA BAR
> 
> +                                                    ///< Offset 612     RST PCIe Storage Cycle Router#3
> Endpoint unique MSI-X PBA BAR
> 
> +  UINT32   RstPcieStorageUniquePbaBarValue[3];      ///< Offset 616     RST
> PCIe Storage Cycle Router#1 Endpoint unique MSI-X PBA BAR value
> 
> +                                                    ///< Offset 620     RST PCIe Storage Cycle Router#2
> Endpoint unique MSI-X PBA BAR value
> 
> +                                                    ///< Offset 624     RST PCIe Storage Cycle Router#3
> Endpoint unique MSI-X PBA BAR value
> 
> +  UINT32   RstPcieStorageRootPortNum[3];            ///< Offset 628     RST PCIe
> Storage Cycle Router#1 Root Port number
> 
> +                                                    ///< Offset 632     RST PCIe Storage Cycle Router#2
> Root Port number
> 
> +                                                    ///< Offset 636     RST PCIe Storage Cycle Router#3
> Root Port number
> 
> +  UINT8    EMH4;                                    ///< Offset 640     eMMC HS400 mode
> enabled
> 
> +  UINT8    EMDS;                                    ///< Offset 641     eMMC Driver Strength
> 
> +  UINT8    CpuSku;                                  ///< Offset 642     CPU SKU
> 
> +  UINT16   IoTrapAddress[4];                        ///< Offset 643
> 
> +  UINT8    IoTrapStatus[4];                         ///< Offset 651
> 
> +  UINT16   PMBS;                                    ///< Offset 655     ACPI IO BASE address
> 
> +  UINT32   PWRM;                                    ///< Offset 657     PWRM MEM BASE
> address
> 
> +  // CNVi specific
> 
> +  UINT8    CnviMode;                                ///< Offset 661     CNVi mode
> 
> +  UINT8    CnviBtCore;                              ///< Offset 662     CNVi BT Core
> 
> +  UINT8    CnviBtAudioOffload;                      ///< Offset 663     CNVi BT Audio
> Offload
> 
> +  // PCH Trace Hub
> 
> +  UINT8    PchTraceHubMode;                         ///< Offset 664     PCH Trace Hub
> Mode
> 
> +  // PCH PS_ON support
> 
> +  UINT8    PsOnEnable;                              ///< Offset 665     PCH PS_ON enable
> 
> +  //
> 
> +  // These are for PchApciTablesSelfTest use
> 
> +  //
> 
> +  UINT8    LtrEnable[24];                           ///< Offset 666     Latency Tolerance
> Reporting Enable
> 
> +                                                    ///< Offset 667     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 668     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 669     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 670     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 671     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 672     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 673     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 674     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 675     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 676     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 677     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 678     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 679     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 680     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 681     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 682     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 683     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 684     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 685     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 686     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 687     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 688     Latency Tolerance Reporting
> Enable
> 
> +                                                    ///< Offset 689     Latency Tolerance Reporting
> Enable
> 
> +  UINT8    GBES;                                    ///< Offset 690     GbE Support
> 
> +  UINT32   PchxDCIPwrDnScale;                       ///< Offset 691     PCH xDCI Power
> Down Scale Value, DWC_USB3_GCTL_INIT[31:19]
> 
> +  UINT8    EmmcEnabled;                             ///< Offset 695     Set to indicate that
> eMMC is enabled
> 
> +  UINT8    SdCardEnabled;                           ///< Offset 696     Set to indicate that
> SD card is enabled
> 
> +  UINT8    EnableTimedGpio0;                        ///< Offset 697     Set to indicate
> that Timed GPIO 0 is enabled
> 
> +  UINT8    EnableTimedGpio1;                        ///< Offset 698     Set to indicate
> that Timed GPIO 1 is enabled
> 
> +  UINT8    ClockToRootPortMap[18];                  ///< Offset 699     CLOCK index
> to root port index map. Used during PCIe D3Cold flows
> 
> +  UINT16   TcoBase;                                 ///< Offset 717     TCO base address
> 
> +  UINT16   IclkPid;                                 ///< Offset 719     Iclk PID number
> 
> +  UINT16   CnviPortId;                              ///< Offset 721     CNVi sideband port id
> 
> +  UINT32   HybridStorageLocation;                   ///< Offset 723
> 
> +  UINT8    SataPortPresence;                        ///< Offset 727     Holds information
> from SATA PCS register about SATA ports which recieved COMINIT from
> connected devices.
> 
> +} PCH_NVS_AREA;
> 
> +
> 
> +#pragma pack(pop)
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h
> new file mode 100644
> index 0000000000..428858afcf
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/PchRstHob.h
> @@ -0,0 +1,58 @@
> +/** @file
> 
> +
> 
> +  Definitions required to create RstHob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_RST_HOB_
> 
> +#define _PCH_RST_HOB_
> 
> +
> 
> +extern EFI_GUID  gPchRstHobGuid;
> 
> +
> 
> +//
> 
> +// This struct is used to record the fields that should be restored during
> device wake up
> 
> +//
> 
> +typedef struct {
> 
> +  UINT8     PmCapPtr;
> 
> +  UINT8     PcieCapPtr;
> 
> +  UINT16    L1ssCapPtr;
> 
> +  UINT8     EndpointL1ssControl2;
> 
> +  UINT32    EndpointL1ssControl1;
> 
> +  UINT16    LtrCapPtr;
> 
> +  UINT32    EndpointLtrData;
> 
> +  UINT16    EndpointLctlData16;
> 
> +  UINT16    EndpointDctlData16;
> 
> +  UINT16    EndpointDctl2Data16;
> 
> +  UINT16    RootPortDctl2Data16;
> 
> +} SAVED_DEVICE_CONFIG_SPACE;
> 
> +
> 
> +//
> 
> +// This structure is used to record the result of PCIe storageremapping for
> each cycle router
> 
> +//
> 
> +typedef struct {
> 
> +  UINT8                                 RootPortNum;                      // Indicates the root port
> number with RST PCIe Storage Remapping remapping supported and PCIe
> storage device plugged on, numbering is 0-based
> 
> +  UINT8                                 DeviceInterface;                  // Indicates the interface
> of the PCIe storage device (AHCI or NVMe)
> 
> +  UINT32                                EndPointUniqueMsixTableBar;       // Records the
> PCIe storage device's MSI-X Table BAR if it supports unique MSI-X Table BAR
> 
> +  UINT32                                EndPointUniqueMsixTableBarValue;  // Records the
> PCIe storage device's MSI-X Table BAR value if it supports unique MSI-X Table
> BAR
> 
> +  UINT32                                EndPointUniqueMsixPbaBar;         // Records the
> PCIe storage device's MSI-X PBA BAR if it supports unique MSI-X PBA BAR
> 
> +  UINT32                                EndPointUniqueMsixPbaBarValue;    // Records the
> PCIe storage device's MSI-X PBA BAR value if it supports unique MSI-X PBA
> BAR
> 
> +} RST_CR_CONFIGURATION;
> 
> +
> 
> +//
> 
> +//  Passes to DXE results of PCIe storage remapping
> 
> +//
> 
> +typedef struct {
> 
> +  //
> 
> +  // Stores configuration information about cycle router
> 
> +  //
> 
> +  RST_CR_CONFIGURATION
> RstCrConfiguration[PCH_MAX_RST_PCIE_STORAGE_CR];
> 
> +
> 
> +  //
> 
> +  // Saved fields from hidden device config space to be used later by RST
> driver
> 
> +  //
> 
> +  SAVED_DEVICE_CONFIG_SPACE
> SavedRemapedDeviceConfigSpace[PCH_MAX_RST_PCIE_STORAGE_CR];
> 
> +} PCH_RST_HOB;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.
> h
> new file mode 100644
> index 0000000000..1c45d89225
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PchNvsArea.
> h
> @@ -0,0 +1,30 @@
> +/** @file
> 
> +  This file defines the PCH NVS Area Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_NVS_AREA_H_
> 
> +#define _PCH_NVS_AREA_H_
> 
> +
> 
> +//
> 
> +// PCH NVS Area definition
> 
> +//
> 
> +#include <Pch/IncludePrivate/PchNvsAreaDef.h>
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                         gPchNvsAreaProtocolGuid;
> 
> +
> 
> +/**
> 
> +  This protocol is used to sync PCH information from POST to runtime ASL.
> 
> +  This protocol exposes the pointer of PCH NVS Area only. Please refer to
> 
> +  ASL definition for PCH NVS AREA.
> 
> +**/
> 
> +typedef struct {
> 
> +  PCH_NVS_AREA                          *Area;
> 
> +} PCH_NVS_AREA_PROTOCOL;
> 
> +
> 
> +#endif // _PCH_NVS_AREA_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
> new file mode 100644
> index 0000000000..ecea5db4fc
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/Protocol/PcieIoTrap.h
> @@ -0,0 +1,35 @@
> +/** @file
> 
> +  This file defines the PCH PCIE IoTrap Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PCIE_IOTRAP_H_
> 
> +#define _PCH_PCIE_IOTRAP_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                       gPchPcieIoTrapProtocolGuid;
> 
> +
> 
> +//
> 
> +// Forward reference for ANSI C compatibility
> 
> +//
> 
> +typedef struct _PCH_PCIE_IOTRAP_PROTOCOL
> PCH_PCIE_IOTRAP_PROTOCOL;
> 
> +
> 
> +///
> 
> +/// Pcie Trap valid types
> 
> +///
> 
> +typedef enum {
> 
> +  PchPciePmTrap,
> 
> +  PcieTrapTypeMaximum
> 
> +} PCH_PCIE_TRAP_TYPE;
> 
> +
> 
> +/**
> 
> + This protocol is used to provide the IoTrap address to trigger PCH PCIE call
> back events
> 
> +**/
> 
> +struct _PCH_PCIE_IOTRAP_PROTOCOL {
> 
> +  UINT16      PcieTrapAddress;
> 
> +};
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.
> h
> new file mode 100644
> index 0000000000..0d9b167588
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/IncludePrivate/SiScheduleResetHob.
> h
> @@ -0,0 +1,21 @@
> +/** @file
> 
> +  This file contains definitions of Si Schedule Reset HOB.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SI_SCHEDULE_RESET_HOB_H_
> 
> +#define _SI_SCHEDULE_RESET_HOB_H_
> 
> +
> 
> +/**
> 
> +  This structure is used to provide information about PCH Resets
> 
> +**/
> 
> +typedef struct {
> 
> +  EFI_RESET_TYPE             ResetType;
> 
> +  PCH_RESET_DATA             ResetData;
> 
> +} SI_SCHEDULE_RESET_HOB;
> 
> +
> 
> +extern EFI_GUID gSiScheduleResetHobGuid;
> 
> +
> 
> +#endif // _SI_SCHEDULE_RESET_HOB_H_
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers
  2021-02-01  1:36 ` [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include
> headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * SystemAgent/Include
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/Memory
> DxeConfig.h       | 123
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDxe
> Config.h         | 114
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramPre
> MemConfig.h      |  34 ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscP
> eiConfig.h       |  24 ++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMiscP
> eiPreMemConfig.h | 104
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatformLib
> .h             |  48 ++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
> | 264
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
> |  61
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
>  8 files changed, 772 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/Memo
> ryDxeConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/Memo
> ryDxeConfig.h
> new file mode 100644
> index 0000000000..451e295b49
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/Memo
> ryDxeConfig.h
> @@ -0,0 +1,123 @@
> +/** @file
> 
> +  Memory DXE Policy definitions
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _MEMORY_DXE_CONFIG_H_
> 
> +#define _MEMORY_DXE_CONFIG_H_
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define MEMORY_DXE_CONFIG_REVISION 1
> 
> +
> 
> +typedef struct _MEMORY_DXE_CONFIG  MEMORY_DXE_CONFIG;
> 
> +
> 
> +/**
> 
> +  Retrieves the OEM custom string for the SMBIOS Type 17 Table
> DeviceLocator field.
> 
> +  Implementation of this function is optional, if this function pointer is NULL
> then
> 
> +  the reference implementation of DeviceLocator will be used.
> 
> +
> 
> +  @param[in]  This                          A pointer to this instance of
> MEMORY_DXE_CONFIG.
> 
> +  @param[in]  Controller                    Desired Controller to get a DeviceLocator
> string for.
> 
> +  @param[in]  Dimm                          Desired DIMM to get a DeviceLocator
> string for.
> 
> +  @param[in]  MdSocket                      0 = Memory Down, 1 = Socketed.
> 
> +
> 
> +  @retval                                   The DeviceLocator string
> 
> +  @retval     NULL                          If the return value is NULL, the default value
> will be used.
> 
> +**/
> 
> +typedef
> 
> +CHAR8*
> 
> +(EFIAPI *MEMORY_DXE_CONFIG_GET_DEVICE_LOCATOR_STRING)(
> 
> +  IN CONST    MEMORY_DXE_CONFIG   *This,
> 
> +  IN          UINT8               Controller,
> 
> +  IN          UINT8               Dimm,
> 
> +  IN          UINT8               MdSocket
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Retrieves the OEM custom string for the SMBIOS Type 17 Table
> BankLocator field.
> 
> +  Implementation of this function is optional, if this function pointer is NULL
> then
> 
> +  the reference implementation of DeviceLocator will be used.
> 
> +
> 
> +  @param[in]  This                          A pointer to this instance of
> MEMORY_DXE_CONFIG.
> 
> +  @param[in]  Controller                    Desired Controller to get a BankLocator
> string for.
> 
> +  @param[in]  Dimm                          Desired DIMM to get a BankLocator string
> for.
> 
> +  @param[in]  MdSocket                      0 = Memory Down, 1 = Socketed.
> 
> +
> 
> +  @retval                                   The BankLocator string
> 
> +  @retval     NULL                          If the return value is NULL, the default value
> will be used.
> 
> +**/
> 
> +typedef
> 
> +CHAR8*
> 
> +(EFIAPI *MEMORY_DXE_CONFIG_GET_BANK_LOCATOR_STRING)(
> 
> +  IN CONST    MEMORY_DXE_CONFIG   *This,
> 
> +  IN          UINT8               Controller,
> 
> +  IN          UINT8               Dimm,
> 
> +  IN          UINT8               MdSocket
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The Memory Configuration includes DIMM SPD address Map and DIMM
> Slot Mechanical present bit map.
> 
> +  The data elements should be initialized by a Platform Module.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +struct _MEMORY_DXE_CONFIG {
> 
> +  CONFIG_BLOCK_HEADER   Header;                   ///< Offset 0-27: Config Block
> Header
> 
> +/**
> 
> +  Offset 28:
> 
> +  Dimm SPD address
> 
> +  Only Server support 2 channels * 3 slots per channel = 6 sockets totally
> 
> +  The Desktop and mobile only support 2 channels * 2 slots per channel = 4
> sockets totally
> 
> +  So there is mapping rule here for Desktop and mobile that there are no
> more 4 DIMMS totally in a system:
> 
> +    Channel A/ Slot 0 --> Dimm 0 --> SpdAddressTable[0]
> 
> +    Channel A/ Slot 1 --> Dimm 1 --> SpdAddressTable[1]
> 
> +    Channel B/ Slot 0 --> Dimm 2 --> SpdAddressTable[2]
> 
> +    Channel B/ Slot 1 --> Dimm 3 --> SpdAddressTable[3]
> 
> +  Refer to SmbiosMemory.c for use
> 
> +  If change the mapping rule, please update the Revision number.
> 
> +**/
> 
> +  UINT8                                           *SpdAddressTable;
> 
> +/**
> 
> +  Offset 36:
> 
> +  Channel A DIMM Slot Mechanical present bit map, bit 0 -> DIMM 0, bit 1 ->
> DIMM1, ...
> 
> +  if the bit is 1, the related DIMM slot is present.
> 
> +  E.g. if channel A has 2 DIMMs,  ChannelASlotMap = 0x03;
> 
> +  E.g. if channel A has only 1 DIMMs,  ChannelASlotMap = 0x01;
> 
> +  Refer to SmbiosMemory.c
> 
> +**/
> 
> +  UINT8                                           ChannelASlotMap;
> 
> +/**
> 
> +  Offset 37:
> 
> +  Channel B DIMM Slot Mechanical present bit map, bit 0 -> DIMM 0, bit 1 ->
> DIMM1, ...
> 
> +  if the bit is 1, the related DIMM slot is present.
> 
> +  E.g. if channel B has 2 DIMMs,  ChannelBSlotMap = 0x03;
> 
> +  E.g. if channel B has only 1 DIMMs,  ChannelBSlotMap = 0x01;
> 
> +  Refer to SmbiosMemory.c
> 
> +**/
> 
> +  UINT8                                           ChannelBSlotMap;
> 
> +/**
> 
> +  Offset 38:
> 
> +  MRC execution time measurement: <b>0=Disable</b>, 1=Enable
> 
> +**/
> 
> +  UINT8                                           MrcTimeMeasure;
> 
> +/**
> 
> +  Offset 39:
> 
> +  Fast boot: 0=Disable, <b>1=Enable</b>
> 
> +**/
> 
> +  UINT8                                           MrcFastBoot;
> 
> +/**
> 
> +  Offset 40:
> 
> +  Retrieves the OEM custom string for the SMBIOS Type 17 Table
> DeviceLocator field.
> 
> +**/
> 
> +  MEMORY_DXE_CONFIG_GET_DEVICE_LOCATOR_STRING
> GetDeviceLocatorString;
> 
> +/**
> 
> +  Offset 48:
> 
> +  Retrieves the OEM custom string for the SMBIOS Type 17 Table
> BankLocator field.
> 
> +**/
> 
> +  MEMORY_DXE_CONFIG_GET_BANK_LOCATOR_STRING
> GetBankLocatorString;
> 
> +};
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _MEMORY_DXE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDx
> eConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDx
> eConfig.h
> new file mode 100644
> index 0000000000..799121f1ab
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PcieDx
> eConfig.h
> @@ -0,0 +1,114 @@
> +/** @file
> 
> +  PCIE DXE policy definitions
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCIE_DXE_CONFIG_H_
> 
> +#define _PCIE_DXE_CONFIG_H_
> 
> +
> 
> +#include "CpuPcieInfo.h"
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define PCIE_DXE_CONFIG_REVISION 2
> 
> +
> 
> +typedef struct {
> 
> +  UINT16  VendorId; ///< Offset 0 PCI Config space offset 0
> 
> +  UINT16  DeviceId; ///< Offset 2 PCI Config space offset 2
> 
> +/**
> 
> +  Offset 4:
> 
> +  SnoopLatency bit definition
> 
> +  Note: All Reserved bits must be set to 0
> 
> +
> 
> +  BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                When clear values in bits 9:0 will be ignored
> 
> +  BIT[14]     - Should be set to 0b
> 
> +  BIT[13]     - Reserved
> 
> +  BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                000b - 1 ns
> 
> +                001b - 32 ns
> 
> +                010b - 1024 ns
> 
> +                011b - 32,768 ns
> 
> +                100b - 1,048,576 ns
> 
> +                101b - 33,554,432 ns
> 
> +                110b - Reserved
> 
> +                111b - Reserved
> 
> +  BITS[9:0]   - Snoop Latency Value. The value in these bits will be multiplied
> with
> 
> +                the scale in bits 12:10
> 
> +**/
> 
> +  UINT16  SnoopLatency;
> 
> +/**
> 
> +  Offset 6:
> 
> +  NonSnoopLatency bit definition
> 
> +  Note: All Reserved bits must be set to 0
> 
> +
> 
> +  BIT[15]     - When set to 1b, indicates that the values in bits 9:0 are valid
> 
> +                When clear values in bits 9:0 will be ignored
> 
> +  BIT[14]     - Should be set to 0b
> 
> +  BIT[13]     - Reserved
> 
> +  BITS[12:10] - Value in bits 9:0 will be multiplied with the scale in these bits
> 
> +                000b - 1 ns
> 
> +                001b - 32 ns
> 
> +                010b - 1024 ns
> 
> +                011b - 32,768 ns
> 
> +                100b - 1,048,576 ns
> 
> +                101b - 33,554,432 ns
> 
> +                110b - Reserved
> 
> +                111b - Reserved
> 
> +  BITS[9:0]   - Non Snoop Latency Value. The value in these bits will be
> multiplied with
> 
> +                the scale in bits 12:10
> 
> +**/
> 
> +  UINT16  NonSnoopLatency;
> 
> +  UINT8   RevId;    ///<   Offset 8 PCI Config space offset 8; 0xFF means all
> steppings
> 
> +  UINT8   Rsvd0[3]; ///<   Offset 9
> 
> +} PCIE_LTR_DEV_INFO;
> 
> +
> 
> +///
> 
> +/// PCIE Power Optimizer config
> 
> +///
> 
> +typedef struct {
> 
> +  UINT16  LtrMaxSnoopLatency;   ///< Offset 0 LTR Maximum Snoop Latency:
> <b>0x0846=70us</b>
> 
> +  UINT16  LtrMaxNoSnoopLatency; ///< Offset 2 LTR Maximum Non-Snoop
> Latency: <b>0x0846=70us</b>
> 
> +  UINT8   ObffEnable;           ///< Offset 4 LTR enable/disable: 0=Disable,
> <b>1=Enable</b>
> 
> +  UINT8   LtrEnable;            ///< Offset 5 LTR enable/disable: 0=Disable,
> <b>1=Enable</b>
> 
> +  UINT8   Rsvd0[2];             ///< Offset 6 Reserved
> 
> +} CPU_PCIE_PWR_OPT;
> 
> +
> 
> +
> 
> +/**
> 
> +  The PCI Express Configuration info includes PCI Resources Range Base and
> Limits and the control
> 
> +  for PEG ASPM.
> 
> +  The data elements should be initialized by a Platform Module.\n
> 
> +  @note <b>Optional.</b> These policies will be ignored if there is no PEG
> port present on board.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  -  Adding PEG RTD3 Support Setup Variable
> 
> +  <b>Revision 3</b>:
> 
> +  -  Adding CPU PCIE RTD3 Support Setup Variable
> 
> +  -  Deprecating PEG RTD3 Support Setup Variable
> 
> +  <b>Revision 4</b>:
> 
> +  -  Deprecating CPU PCIE RTD3 Support Setup Variable
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER      Header;                         ///< Offset 0-27 Config
> Block Header
> 
> +/**
> 
> +  Offset 28: This field is used to describe the ASPM control for PEG Ports\n
> 
> +  0=ASPM Disabled, 1=ASPM L0s Enabled, 2=ASPM L1 Enabled, 3=ASPM
> L0sL1 Enabled, <b>4=ASPM AUTO</b>
> 
> +**/
> 
> +  UINT8                    PegAspm[SA_PEG_MAX_FUN];
> 
> +/**
> 
> +  Offset 32: PCIe Hot Plug Enable/Disable. It has 2 policies.
> 
> +   - <b>Disabled (0x0)</b>     : No hotplug.
> 
> +   - Enabled (0x1)      : Bios assist hotplug.
> 
> +**/
> 
> +  UINT8                    PegRootPortHPE[SA_PEG_MAX_FUN];
> 
> +  CPU_PCIE_PWR_OPT          PegPwrOpt[SA_PEG_MAX_FUN];     ///< Offset
> 36: This field is used to describe the PCIe LTR/OBFF relevant settings
> 
> +  UINT32                   PegRtd3;                       ///  Deprecated Policy
> 
> +  UINT8                    CpuPcieRtd3;                   ///< Enable/Disable RTD3 Support
> for CPU PCIE. 0=Disable and 1=Enable (default)  // Deprecated Policy
> 
> +  UINT8                    Rsvd3[3];
> 
> +} PCIE_DXE_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _PCIE_DXE_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramP
> reMemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramP
> reMemConfig.h
> new file mode 100644
> index 0000000000..8947e80b22
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/PramP
> reMemConfig.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  Policy definition for Persisted Ram (Pram) Config Block
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PRAM_PREMEM_CONFIG__H_
> 
> +#define _PRAM_PREMEM_CONFIG__H_
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define PRAM_PREMEM_CONFIG_REVISION 1
> 
> +
> 
> +/**
> 
> + Defines Pram configuration parameters.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;    ///< Offset 0-27 Config Block Header
> 
> +  /**
> 
> +  Offset 28:
> 
> +  Size of Pram
> 
> +  If disabled, or if PcdSaOcEnable is disabled, all other policies in this config
> block are ignored.
> 
> +  <b>0=Disable</b>,
> 
> +  1=4MB,
> 
> +  2=16MB,
> 
> +  3=64MB
> 
> +  **/
> 
> +  UINT8   Pram;
> 
> +  UINT8   Rsvd[3];                ///< Offset 29 Reserved for DWORD alignment
> 
> +} PRAM_PREMEM_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _PRAM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMisc
> PeiConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMis
> cPeiConfig.h
> new file mode 100644
> index 0000000000..203d894df9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMis
> cPeiConfig.h
> @@ -0,0 +1,24 @@
> +/** @file
> 
> +  Policy details for miscellaneous configuration in System Agent
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_MISC_PEI_CONFIG_H_
> 
> +#define _SA_MISC_PEI_CONFIG_H_
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#define SA_MISC_PEI_CONFIG_REVISION 1
> 
> +
> 
> +/**
> 
> +  This configuration block is to configure SA Miscellaneous variables during
> PEI Post-Mem.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block
> Header
> 
> +} SA_MISC_PEI_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _SA_MISC_PEI_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMisc
> PeiPreMemConfig.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMis
> cPeiPreMemConfig.h
> new file mode 100644
> index 0000000000..8c660b31a9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/ConfigBlock/SaMis
> cPeiPreMemConfig.h
> @@ -0,0 +1,104 @@
> +/** @file
> 
> +  Policy details for miscellaneous configuration in System Agent
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_MISC_PEI_PREMEM_CONFIG_H_
> 
> +#define _SA_MISC_PEI_PREMEM_CONFIG_H_
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +
> 
> +#ifndef MEM_CFG_MAX_SOCKETS
> 
> +#define MEM_CFG_MAX_SOCKETS 16
> 
> +#endif
> 
> +
> 
> +#define SA_MISC_PEI_PREMEM_CONFIG_REVISION 2
> 
> +
> 
> +/**
> 
> +  This configuration block is to configure SA Miscellaneous variables during
> PEI Pre-Mem phase like programming
> 
> +  different System Agent BARs, TsegSize, MmioSize required etc.
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +  <b>Revision 2</b>:
> 
> +  - Deprecate IedSize.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_HEADER  Header;               ///< Offset 0-27 Config Block
> Header
> 
> +  /**
> 
> +    Offset 28 Memory DIMMs' SPD address for reading SPD data.
> 
> +    TGL Mapping
> 
> +      0 - Controller 0 Channel 0 Dimm 0 - DDR4 - DDR5 - LPDDR4 - LPDDR5
> 
> +      1 - Controller 0 Channel 0 Dimm 1 - DDR4
> 
> +      2 - Controller 0 Channel 1 Dimm 0 -------- DDR5 - LPDDR4 - LPDDR5
> 
> +      3 - Controller 0 Channel 1 Dimm 1 -------- DDR5 2DPC
> 
> +      4 - Controller 0 Channel 2 Dimm 0 --------------- LPDDR4 - LPDDR5
> 
> +      6 - Controller 0 Channel 3 Dimm 0 --------------- LPDDR4 - LPDDR5
> 
> +      8 - Controller 1 Channel 0 Dimm 0 - DDR4 - DDR5 - LPDDR4 - LPDDR5
> 
> +      9 - Controller 1 Channel 0 Dimm 1 - DDR4
> 
> +     10 - Controller 1 Channel 1 Dimm 0 -------- DDR5 - LPDDR4 - LPDDR5
> 
> +     11 - Controller 1 Channel 1 Dimm 1 -------- DDR5 2DPC
> 
> +     12 - Controller 1 Channel 2 Dimm 0 --------------- LPDDR4 - LPDDR5
> 
> +     14 - Controller 1 Channel 3 Dimm 0 --------------- LPDDR4 - LPDDR5
> 
> +  **/
> 
> +  UINT8   SpdAddressTable[MEM_CFG_MAX_SOCKETS];
> 
> +  VOID    *S3DataPtr;                        ///< Offset 44 Memory data save pointer
> for S3 resume. The memory space should be allocated and filled with proper
> S3 resume data on a resume path
> 
> +  UINT32  SmbusBar;                          ///< Offset 48 Address of System Agent
> SMBUS BAR: <b>0xEFA0</b>
> 
> +  /**
> 
> +    Offset 52 Size of TSEG in bytes. (Must be power of 2)
> 
> +    <b>0x400000</b>: 4MB for Release build (When IED enabled, it will be
> 8MB)
> 
> +    0x1000000      : 16MB for Debug build (Regardless IED enabled or disabled)
> 
> +  **/
> 
> +  UINT32  TsegSize;
> 
> +  /**
> 
> +    Offset 56
> 
> +    <b>(Test)</b> Size of IED region in bytes.
> 
> +    <b>0</b> : IED Disabled (no memory occupied)
> 
> +    0x400000 : 4MB SMM memory occupied by IED (Part of TSEG)
> 
> +    <b>Note: Enabling IED may also enlarge TsegSize together.</b>
> 
> +    @deprecated
> 
> +  **/
> 
> +  UINT32  IedSize;
> 
> +  UINT32  SkipExtGfxScan:1;                  ///< <b>(Test)</b> OFfset 60:0 :1=Skip
> External Gfx Device Scan; <b>0=Scan for external graphics devices</b>. Set
> this policy to skip External Graphics card scanning if the platform uses Internal
> Graphics only.
> 
> +  UINT32  BdatEnable:1;                      ///< Offset 60:1 :This field enables the
> generation of the BIOS DATA ACPI Tables: <b>0=FALSE</b>, 1=TRUE.
> 
> +  UINT32  TxtImplemented:1;                  ///< OFfset 60:2 :This field currently is
> used to tell MRC if it should run after TXT initializatoin completed: <b>0=Run
> without waiting for TXT</b>, 1=Run after TXT initialization by callback
> 
> +  /**
> 
> +   Offset 60:3 :
> 
> +   <b>(Test)</b> Scan External Discrete Graphics Devices for Legacy Only
> VGA OpROMs
> 
> +
> 
> +   When enabled, if the primary graphics device is an external discrete
> graphics device, Si will scan the
> 
> +   graphics device for legacy only VGA OpROMs.
> 
> +
> 
> +   This is intended to ease the implementation of a BIOS feature to
> automatically enable CSM if the Primary Gfx device
> 
> +   only supports Legacy VBIOS (No UEFI GOP Present).  Otherwise disabling
> CSM won't result in no video being displayed.
> 
> +   This is useful for platforms that implement PCIe slots that allow the end
> user to install an arbitrary Gfx device.
> 
> +
> 
> +   This setting will only take effect if SkipExtGfxScan == 0.  It is ignored
> otherwise.
> 
> +
> 
> +  - Disabled (0x0)         : Don't Scan for Legacy Only VGA OpROMs (Default)
> 
> +  - <b>Enabled</b>  (0x1)  : Scan External Gfx for Legacy Only VGA OpROM
> 
> +  **/
> 
> +  UINT32  ScanExtGfxForLegacyOpRom:1;
> 
> +  UINT32  RsvdBits0  :28;                    ///< Offset 60:4 :Reserved for future use
> 
> +  UINT8   UserBd;                            ///< Offset 64 <b>0=Mobile/Mobile
> Halo</b>, 1=Desktop/DT Halo, 5=ULT/ULX/Mobile Halo, 7=UP Server
> 
> +  UINT8   LockPTMregs;                       ///< <b>(Test)</b> Offset 65 Lock PCU
> Thermal Management registers: 0=FALSE, <b>1=TRUE</b>
> 
> +  UINT8   BdatTestType;                      ///< Offset 66 When BdatEnable is set to
> TRUE, this option selects the type of data which will be populated in the BIOS
> Data ACPI Tables: <b>0=RMT</b>, 1=RMT Per Bit, 2=Margin 2D.
> 
> +  UINT8   CridEnable;                        ///< Offset 67 For Platforms supporting
> Intel(R) SIPP, this policy is use control enable/disable Compatibility Revision
> ID (CRID) feature: <b>0=FALSE</b>, 1=TRUE
> 
> +  UINT32  AcpiReservedMemorySize;            ///< Offset 68 The Size of a
> Reserved memory buffer allocated in previous boot for S3 resume used.
> Originally it is retrieved from AcpiVariableCompatibility variable.
> 
> +  UINT32  OpRomScanTempMmioBar;              ///< <b>(Test)</b> Offset 72
> Temporary address to MMIO map OpROMs during VGA scanning.  Used for
> ScanExtGfxForLegacyOpRom feature.  MUST BE 16MB ALIGNED!
> 
> +  UINT32  OpRomScanTempMmioLimit;            ///< <b>(Test)</b> Offset 76
> Limit address for OpROM MMIO range.  Used for
> ScanExtGfxForLegacyOpRom feature. (OpROMScanTempMmioLimit -
> OpRomScanTempMmioBar) MUST BE >= 16MB!
> 
> +  UINT64  AcpiReservedMemoryBase;            ///< Offset 80 The Base address
> of a Reserved memory buffer allocated in previous boot for S3 resume used.
> Originally it is retrieved from AcpiVariableCompatibility variable.
> 
> +  UINT64  SystemMemoryLength;                ///< Offset 88 Total system
> memory length from previous boot, this is required for S3 resume. Originally
> it is retrieved from AcpiVariableCompatibility variable.
> 
> +
> 
> +  UINT8   WrcFeatureEnable;                   ///< Offset 96: Enable/Disable WRC
> (Write Cache) feature of IOP. When enabled, supports IO devices allocating
> onto the ring and into LLC.
> 
> +  UINT8   Reserved1[3];                       ///< Reserved for config block alignment.
> 
> +
> 
> +
> 
> +  // Since the biggest element is UINT64, this structure should be aligned
> with 64 bits.
> 
> +  UINT8   Rsvd[4];                           ///< Reserved for config block alignment.
> 
> +
> 
> +
> 
> +} SA_MISC_PEI_PREMEM_CONFIG;
> 
> +#pragma pack(pop)
> 
> +
> 
> +#endif // _SA_MISC_PEI_PREMEM_CONFIG_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatform
> Lib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatform
> Lib.h
> new file mode 100644
> index 0000000000..daf3746605
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Library/SaPlatform
> Lib.h
> @@ -0,0 +1,48 @@
> +/** @file
> 
> +  Header file for SaPlatformLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SA_PLATFORM_LIB_H_
> 
> +#define _SA_PLATFORM_LIB_H_
> 
> +
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Mobile
> 
> +
> 
> +  @retval FALSE  SKU is not Mobile
> 
> +  @retval TRUE   SKU is Mobile
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsMobileSku (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Desktop
> 
> +
> 
> +  @retval FALSE  SKU is not Desktop
> 
> +  @retval TRUE   SKU is Desktop
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsDesktopSku (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Server
> 
> +
> 
> +  @retval FALSE  SKU is not Server
> 
> +  @retval TRUE   SKU is Server
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsServerSku (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
> new file mode 100644
> index 0000000000..b50d7e5188
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/MemInfoHob.h
> @@ -0,0 +1,264 @@
> +/** @file
> 
> +  This file contains definitions required for creation of
> 
> +  Memory S3 Save data, Memory Info data and Memory Platform
> 
> +  data hobs.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _MEM_INFO_HOB_H_
> 
> +#define _MEM_INFO_HOB_H_
> 
> +
> 
> +#pragma pack (push, 1)
> 
> +
> 
> +extern EFI_GUID gSiMemoryS3DataGuid;
> 
> +extern EFI_GUID gSiMemoryInfoDataGuid;
> 
> +extern EFI_GUID gSiMemoryPlatformDataGuid;
> 
> +
> 
> +#define MAX_TRACE_CACHE_TYPE  3
> 
> +
> 
> +#define MAX_NODE        2
> 
> +#define MAX_CH          4
> 
> +#define MAX_DIMM        2
> 
> +
> 
> +///
> 
> +/// Host reset states from MRC.
> 
> +///
> 
> +#define  WARM_BOOT        2
> 
> +
> 
> +#define R_MC_CHNL_RANK_PRESENT  0x7C
> 
> +#define   B_RANK0_PRS           BIT0
> 
> +#define   B_RANK1_PRS           BIT1
> 
> +#define   B_RANK2_PRS           BIT4
> 
> +#define   B_RANK3_PRS           BIT5
> 
> +
> 
> +// @todo remove and use the MdePkg\Include\Pi\PiHob.h
> 
> +#if !defined(_PEI_HOB_H_) && !defined(__PI_HOB_H__)
> 
> +#ifndef __HOB__H__
> 
> +typedef struct _EFI_HOB_GENERIC_HEADER {
> 
> +  UINT16  HobType;
> 
> +  UINT16  HobLength;
> 
> +  UINT32  Reserved;
> 
> +} EFI_HOB_GENERIC_HEADER;
> 
> +
> 
> +typedef struct _EFI_HOB_GUID_TYPE {
> 
> +  EFI_HOB_GENERIC_HEADER  Header;
> 
> +  EFI_GUID                Name;
> 
> +  ///
> 
> +  /// Guid specific data goes here
> 
> +  ///
> 
> +} EFI_HOB_GUID_TYPE;
> 
> +#endif
> 
> +#endif
> 
> +
> 
> +///
> 
> +/// Defines taken from MRC so avoid having to include MrcInterface.h
> 
> +///
> 
> +
> 
> +//
> 
> +// Matches MAX_SPD_SAVE define in MRC
> 
> +//
> 
> +#ifndef MAX_SPD_SAVE
> 
> +#define MAX_SPD_SAVE 29
> 
> +#endif
> 
> +
> 
> +//
> 
> +// MRC version description.
> 
> +//
> 
> +typedef struct {
> 
> +  UINT8  Major;     ///< Major version number
> 
> +  UINT8  Minor;     ///< Minor version number
> 
> +  UINT8  Rev;       ///< Revision number
> 
> +  UINT8  Build;     ///< Build number
> 
> +} SiMrcVersion;
> 
> +
> 
> +//
> 
> +// Matches MrcDimmSts enum in MRC
> 
> +//
> 
> +#ifndef DIMM_ENABLED
> 
> +#define DIMM_ENABLED     0  // DIMM/rank Pair is enabled, presence will
> be detected.
> 
> +#endif
> 
> +#ifndef DIMM_DISABLED
> 
> +#define DIMM_DISABLED    1  // DIMM/rank Pair is disabled, regardless of
> presence.
> 
> +#endif
> 
> +#ifndef DIMM_PRESENT
> 
> +#define DIMM_PRESENT     2  // There is a DIMM present in the slot/rank
> pair and it will be used.
> 
> +#endif
> 
> +#ifndef DIMM_NOT_PRESENT
> 
> +#define DIMM_NOT_PRESENT 3  // There is no DIMM present in the
> slot/rank pair.
> 
> +#endif
> 
> +
> 
> +//
> 
> +// Matches MrcBootMode enum in MRC
> 
> +//
> 
> +#ifndef __MRC_BOOT_MODE__
> 
> +#define __MRC_BOOT_MODE__                 //The below values are originated
> from MrcCommonTypes.h
> 
> +  #ifndef INT32_MAX
> 
> +  #define INT32_MAX                       (0x7FFFFFFF)
> 
> +  #endif  //INT32_MAX
> 
> +typedef enum {
> 
> +  bmCold,                                 ///< Cold boot
> 
> +  bmWarm,                                 ///< Warm boot
> 
> +  bmS3,                                   ///< S3 resume
> 
> +  bmFast,                                 ///< Fast boot
> 
> +  MrcBootModeMax,                         ///< MRC_BOOT_MODE enumeration
> maximum value.
> 
> +  MrcBootModeDelim = INT32_MAX            ///< This value ensures the enum
> size is consistent on both sides of the PPI.
> 
> +} MRC_BOOT_MODE;
> 
> +#endif  //__MRC_BOOT_MODE__
> 
> +
> 
> +//
> 
> +// Matches MrcDdrType enum in MRC
> 
> +//
> 
> +#ifndef MRC_DDR_TYPE_DDR4
> 
> +#define MRC_DDR_TYPE_DDR4     0
> 
> +#endif
> 
> +#ifndef MRC_DDR_TYPE_DDR3
> 
> +#define MRC_DDR_TYPE_DDR3     1
> 
> +#endif
> 
> +#ifndef MRC_DDR_TYPE_LPDDR3
> 
> +#define MRC_DDR_TYPE_LPDDR3   2
> 
> +#endif
> 
> +#ifndef MRC_DDR_TYPE_LPDDR4
> 
> +#define MRC_DDR_TYPE_LPDDR4   3
> 
> +#endif
> 
> +#ifndef MRC_DDR_TYPE_WIO2
> 
> +#define MRC_DDR_TYPE_WIO2     4
> 
> +#endif
> 
> +#ifndef MRC_DDR_TYPE_UNKNOWN
> 
> +#define MRC_DDR_TYPE_UNKNOWN  5
> 
> +#endif
> 
> +
> 
> +#define MAX_PROFILE_NUM     4 // number of memory profiles supported
> 
> +#define MAX_XMP_PROFILE_NUM 2 // number of XMP profiles supported
> 
> +
> 
> +//
> 
> +// DIMM timings
> 
> +//
> 
> +typedef struct {
> 
> +  UINT32 tCK;       ///< Memory cycle time, in femtoseconds.
> 
> +  UINT16 NMode;     ///< Number of tCK cycles for the channel DIMM's
> command rate mode.
> 
> +  UINT16 tCL;       ///< Number of tCK cycles for the channel DIMM's CAS
> latency.
> 
> +  UINT16 tCWL;      ///< Number of tCK cycles for the channel DIMM's
> minimum CAS write latency time.
> 
> +  UINT16 tFAW;      ///< Number of tCK cycles for the channel DIMM's
> minimum four activate window delay time.
> 
> +  UINT16 tRAS;      ///< Number of tCK cycles for the channel DIMM's
> minimum active to precharge delay time.
> 
> +  UINT16 tRCDtRP;   ///< Number of tCK cycles for the channel DIMM's
> minimum RAS# to CAS# delay time and Row Precharge delay time.
> 
> +  UINT16 tREFI;     ///< Number of tCK cycles for the channel DIMM's
> minimum Average Periodic Refresh Interval.
> 
> +  UINT16 tRFC;      ///< Number of tCK cycles for the channel DIMM's
> minimum refresh recovery delay time.
> 
> +  UINT16 tRFCpb;    ///< Number of tCK cycles for the channel DIMM's
> minimum per bank refresh recovery delay time.
> 
> +  UINT16 tRFC2;     ///< Number of tCK cycles for the channel DIMM's
> minimum refresh recovery delay time.
> 
> +  UINT16 tRFC4;     ///< Number of tCK cycles for the channel DIMM's
> minimum refresh recovery delay time.
> 
> +  UINT16 tRPab;     ///< Number of tCK cycles for the channel DIMM's
> minimum row precharge delay time for all banks.
> 
> +  UINT16 tRRD;      ///< Number of tCK cycles for the channel DIMM's
> minimum row active to row active delay time.
> 
> +  UINT16 tRRD_L;    ///< Number of tCK cycles for the channel DIMM's
> minimum row active to row active delay time for same bank groups.
> 
> +  UINT16 tRRD_S;    ///< Number of tCK cycles for the channel DIMM's
> minimum row active to row active delay time for different bank groups.
> 
> +  UINT16 tRTP;      ///< Number of tCK cycles for the channel DIMM's
> minimum internal read to precharge command delay time.
> 
> +  UINT16 tWR;       ///< Number of tCK cycles for the channel DIMM's
> minimum write recovery time.
> 
> +  UINT16 tWTR;      ///< Number of tCK cycles for the channel DIMM's
> minimum internal write to read command delay time.
> 
> +  UINT16 tWTR_L;    ///< Number of tCK cycles for the channel DIMM's
> minimum internal write to read command delay time for same bank groups.
> 
> +  UINT16 tWTR_S;    ///< Number of tCK cycles for the channel DIMM's
> minimum internal write to read command delay time for different bank
> groups.
> 
> +  UINT16 tCCD_L;  ///< Number of tCK cycles for the channel DIMM's
> minimum CAS-to-CAS delay for same bank group.
> 
> +} MRC_CH_TIMING;
> 
> +
> 
> +///
> 
> +/// Memory SMBIOS & OC Memory Data Hob
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8            Status;                  ///< See MrcDimmStatus for the definition of
> this field.
> 
> +  UINT8            DimmId;
> 
> +  UINT32           DimmCapacity;            ///< DIMM size in MBytes.
> 
> +  UINT16           MfgId;
> 
> +  UINT8            ModulePartNum[20];       ///< Module part number for DDR3 is
> 18 bytes however for DRR4 20 bytes as per JEDEC Spec, so reserving 20 bytes
> 
> +  UINT8            RankInDimm;              ///< The number of ranks in this DIMM.
> 
> +  UINT8            SpdDramDeviceType;       ///< Save SPD DramDeviceType
> information needed for SMBIOS structure creation.
> 
> +  UINT8            SpdModuleType;           ///< Save SPD ModuleType information
> needed for SMBIOS structure creation.
> 
> +  UINT8            SpdModuleMemoryBusWidth; ///< Save SPD
> ModuleMemoryBusWidth information needed for SMBIOS structure
> creation.
> 
> +  UINT8            SpdSave[MAX_SPD_SAVE];   ///< Save SPD Manufacturing
> information needed for SMBIOS structure creation.
> 
> +  UINT16           Speed;                   ///< The maximum capable speed of the
> device, in MHz
> 
> +  UINT8            MdSocket;                ///< MdSocket: 0 = Memory Down, 1 =
> Socketed. Needed for SMBIOS structure creation.
> 
> +} DIMM_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8            Status;                  ///< Indicates whether this channel should be
> used.
> 
> +  UINT8            ChannelId;
> 
> +  UINT8            DimmCount;               ///< Number of valid DIMMs that exist in
> the channel.
> 
> +  MRC_CH_TIMING    Timing[MAX_PROFILE_NUM]; ///< The channel timing
> values.
> 
> +  DIMM_INFO        DimmInfo[MAX_DIMM];      ///< Save the DIMM output
> characteristics.
> 
> +} CHANNEL_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8            Status;                  ///< Indicates whether this controller should
> be used.
> 
> +  UINT16           DeviceId;                ///< The PCI device id of this memory
> controller.
> 
> +  UINT8            RevisionId;              ///< The PCI revision id of this memory
> controller.
> 
> +  UINT8            ChannelCount;            ///< Number of valid channels that exist
> on the controller.
> 
> +  CHANNEL_INFO     ChannelInfo[MAX_CH];     ///< The following are
> channel level definitions.
> 
> +} CONTROLLER_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT64   BaseAddress;   ///< Trace Base Address
> 
> +  UINT64   TotalSize;     ///< Total Trace Region of Same Cache type
> 
> +  UINT8    CacheType;     ///< Trace Cache Type
> 
> +  UINT8    ErrorCode;     ///< Trace Region Allocation Fail Error code
> 
> +  UINT8    Rsvd[2];
> 
> +} PSMI_MEM_INFO;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8             Revision;
> 
> +  UINT16            DataWidth;              ///< Data width, in bits, of this memory
> device
> 
> +  /** As defined in SMBIOS 3.0 spec
> 
> +    Section 7.18.2 and Table 75
> 
> +  **/
> 
> +  UINT8             MemoryType;             ///< DDR type: DDR3, DDR4, or LPDDR3
> 
> +  UINT16            MaximumMemoryClockSpeed;///< The maximum capable
> speed of the device, in megahertz (MHz)
> 
> +  UINT16            ConfiguredMemoryClockSpeed; ///< The configured clock
> speed to the memory device, in megahertz (MHz)
> 
> +  /** As defined in SMBIOS 3.0 spec
> 
> +    Section 7.17.3 and Table 72
> 
> +  **/
> 
> +  UINT8             ErrorCorrectionType;
> 
> +
> 
> +  SiMrcVersion      Version;
> 
> +  BOOLEAN           EccSupport;
> 
> +  UINT8             MemoryProfile;
> 
> +  UINT32            TotalPhysicalMemorySize;
> 
> +  UINT32            DefaultXmptCK[MAX_XMP_PROFILE_NUM];///< Stores the
> tCK value read from SPD XMP profiles if they exist.
> 
> +  UINT8             XmpProfileEnable;                  ///< If XMP capable DIMMs are
> detected, this will indicate which XMP Profiles are common among all
> DIMMs.
> 
> +  UINT8             Ratio;
> 
> +  UINT8             RefClk;
> 
> +  UINT32            VddVoltage[MAX_PROFILE_NUM];
> 
> +  CONTROLLER_INFO   Controller[MAX_NODE];
> 
> +} MEMORY_INFO_DATA_HOB;
> 
> +
> 
> +/**
> 
> +  Memory Platform Data Hob
> 
> +
> 
> +  <b>Revision 1:</b>
> 
> +  - Initial version.
> 
> +  <b>Revision 2:</b>
> 
> +  - Added TsegBase, PrmrrSize, PrmrrBase, Gttbase, MmioSize,
> PciEBaseAddress fields
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT8             Revision;
> 
> +  UINT8             Reserved[3];
> 
> +  UINT32            BootMode;
> 
> +  UINT32            TsegSize;
> 
> +  UINT32            TsegBase;
> 
> +  UINT32            PrmrrSize;
> 
> +  UINT64            PrmrrBase;
> 
> +  UINT32            PramSize;
> 
> +  UINT64            PramBase;
> 
> +  UINT64            DismLimit;
> 
> +  UINT64            DismBase;
> 
> +  UINT32            GttBase;
> 
> +  UINT32            MmioSize;
> 
> +  UINT32            PciEBaseAddress;
> 
> +  PSMI_MEM_INFO     PsmiInfo[MAX_TRACE_CACHE_TYPE];
> 
> +} MEMORY_PLATFORM_DATA;
> 
> +
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE    EfiHobGuidType;
> 
> +  MEMORY_PLATFORM_DATA Data;
> 
> +  UINT8                *Buffer;
> 
> +} MEMORY_PLATFORM_DATA_HOB;
> 
> +
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _MEM_INFO_HOB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
> new file mode 100644
> index 0000000000..4ff2578038
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Include/Protocol/SaPolicy.h
> @@ -0,0 +1,61 @@
> +/** @file
> 
> +  Interface definition details between System Agent and platform drivers
> during DXE phase.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_POLICY_H_
> 
> +#define _SA_POLICY_H_
> 
> +
> 
> +#include <ConfigBlock.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <GraphicsConfig.h>
> 
> +#include <ConfigBlock/MemoryDxeConfig.h>
> 
> +#include <ConfigBlock/PcieDxeConfig.h>
> 
> +#include <VtdConfig.h>
> 
> +
> 
> +///
> 
> +/// Extern the GUID for protocol users.
> 
> +///
> 
> +extern EFI_GUID gSaPolicyProtocolGuid;
> 
> +extern EFI_GUID gGraphicsDxeConfigGuid;
> 
> +extern EFI_GUID gPcieDxeConfigGuid;
> 
> +extern EFI_GUID gMemoryDxeConfigGuid;
> 
> +extern EFI_GUID gVtdDxeConfigGuid;
> 
> +
> 
> +/**
> 
> +  Don't change the original SA_POLICY_PROTOCOL_REVISION macro,
> external
> 
> +  modules maybe have consumed this macro in their source code.  Directly
> 
> +  update the SA_POLICY_PROTOCOL_REVISION version number may cause
> those
> 
> +  external modules to auto mark themselves wrong version info.
> 
> +  Always create new version macro for new Policy protocol interface.
> 
> +**/
> 
> +#define SA_POLICY_PROTOCOL_REVISION  1
> 
> +
> 
> +#define CPU_PCIE_DEV_END_OF_TABLE                0xFFFF
> 
> +
> 
> +#define LTR_MAX_SNOOP_LATENCY_VALUE             0x0846    ///< Intel
> recommended maximum value for Snoop Latency
> 
> +#define LTR_MAX_NON_SNOOP_LATENCY_VALUE         0x0846    ///< Intel
> recommended maximum value for Non-Snoop Latency
> 
> +
> 
> +
> 
> +/**
> 
> +  SA DXE Policy
> 
> +
> 
> + The SA_POLICY_PROTOCOL producer drvier is recommended to
> 
> + set all the SA_POLICY_PROTOCOL size buffer zero before init any member
> parameter,
> 
> + this clear step can make sure no random value for those unknow new
> version parameters.
> 
> +
> 
> + Make sure to update the Revision if any change to the protocol, including
> the existing
> 
> + internal structure definations.\n
> 
> +  Note: Here revision will be bumped up when adding/removing any config
> block under this structure.\n
> 
> +  <b>Revision 1</b>:
> 
> +  - Initial version.
> 
> +**/
> 
> +typedef struct {
> 
> +  CONFIG_BLOCK_TABLE_HEADER      TableHeader;    ///< Offset 0-31
> 
> +/*
> 
> +  Individual Config Block Structures are added here in memory as part of
> AddConfigBlock()
> 
> +*/
> 
> +} SA_POLICY_PROTOCOL;
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers
  2021-02-01  1:36 ` [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate
> headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * SystemAgent/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaIot
> rapSmi.h |  42 ++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaNv
> sArea.h   |  30 ++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHob.
> h          |  50 ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaDef
> .h         | 222
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++
>  4 files changed, 344 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaI
> otrapSmi.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaI
> otrapSmi.h
> new file mode 100644
> index 0000000000..2e86d497f9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/SaI
> otrapSmi.h
> @@ -0,0 +1,42 @@
> +/** @file
> 
> +  This file defines the SA Iotrap SMI Protocol to provide the
> 
> +  I/O address for registered Iotrap SMI.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_IOTRAP_SMI_PROTOCOL_H_
> 
> +#define _SA_IOTRAP_SMI_PROTOCOL_H_
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID                       gSaIotrapSmiProtocolGuid;
> 
> +
> 
> +#define SA_IOTRAP_SMI_PROTOCOL_REVISION_1 1
> 
> +
> 
> +//
> 
> +// SA IO Trap SMI Protocol definition (Private protocol for RC internal use
> only)
> 
> +//
> 
> +typedef struct {
> 
> +/*
> 
> + Protocol revision number
> 
> + Any backwards compatible changes to this protocol will result in an update
> in the revision number
> 
> + Major changes will require publication of a new protocol
> 
> +
> 
> +  <b>Revision 1</b>:
> 
> +    - First version
> 
> +*/
> 
> +  UINT8   Revision;
> 
> +  UINT16  SaIotrapSmiAddress;
> 
> +} SA_IOTRAP_SMI_PROTOCOL;
> 
> +
> 
> +///
> 
> +/// Pcie Trap valid types
> 
> +///
> 
> +typedef enum {
> 
> +  CpuPciePmTrap,
> 
> +  CpuPcieTrapTypeMaximum
> 
> +} CPU_PCIE_TRAP_TYPE;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/Sa
> NvsArea.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/Sa
> NvsArea.h
> new file mode 100644
> index 0000000000..785a808cf4
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/Protocol/Sa
> NvsArea.h
> @@ -0,0 +1,30 @@
> +/** @file
> 
> +  Definition of the System Agent global NVS area protocol.
> 
> +  This protocol publishes the address and format of a global ACPI NVS buffer
> 
> +  used as a communications buffer between SMM/DXE/PEI code and ASL
> code.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SYSTEM_AGENT_NVS_AREA_H_
> 
> +#define _SYSTEM_AGENT_NVS_AREA_H_
> 
> +
> 
> +//
> 
> +// SA NVS Area definition
> 
> +//
> 
> +#include <SaNvsAreaDef.h>
> 
> +
> 
> +//
> 
> +// Extern the GUID for protocol users.
> 
> +//
> 
> +extern EFI_GUID gSaNvsAreaProtocolGuid;
> 
> +
> 
> +///
> 
> +/// System Agent Global NVS Area Protocol
> 
> +///
> 
> +typedef struct {
> 
> +  SYSTEM_AGENT_NVS_AREA *Area;        ///< System Agent Global NVS
> Area Structure
> 
> +} SYSTEM_AGENT_NVS_AREA_PROTOCOL;
> 
> +
> 
> +#endif // _SYSTEM_AGENT_NVS_AREA_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHo
> b.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHo
> b.h
> new file mode 100644
> index 0000000000..65622069e6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaConfigHo
> b.h
> @@ -0,0 +1,50 @@
> +/** @file
> 
> +  The GUID definition for SaConfigHob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_CONFIG_HOB_H_
> 
> +#define _SA_CONFIG_HOB_H_
> 
> +
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +#include <Base.h>
> 
> +#include "CpuPcieInfo.h"
> 
> +#include <Library/PcdLib.h>
> 
> +
> 
> +extern EFI_GUID gSaConfigHobGuid;
> 
> +#define SA_VTD_ENGINE_NUMBER        3
> 
> +
> 
> +#pragma pack (push,1)
> 
> +///
> 
> +/// DPR Directory Types
> 
> +///
> 
> +typedef enum {
> 
> +  EnumDprDirectoryTxt   = 0,
> 
> +} DPR_DIRECTORY_ELEMENT;
> 
> +
> 
> +#define DPR_DIRECTORY_TYPE_TXT          0x01      ///< DPR directory type -
> TXT
> 
> +#define DPR_DIRECTORY_TYPE_BIOSGUARD    0x02      ///< DPR directory
> type - BIOS Guard
> 
> +#define DPR_DIRECTORY_MAX               1         ///< DPR Maximum Size
> 
> +
> 
> +///
> 
> +/// DPR directory entry definition
> 
> +///
> 
> +typedef struct {
> 
> +  UINT8   Type;          ///< DPR Directory Type
> 
> +  UINT8   Size;          ///< DPR Size in MB
> 
> +  UINT32  PhysBase;      ///< Must be 4K aligned (bits 11..0 must be clear)
> 
> +  UINT16  Reserved;      ///< Must be 0
> 
> +} DPR_DIRECTORY_ENTRY;
> 
> +
> 
> +///
> 
> +/// System Agent Config Hob
> 
> +///
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE        EfiHobGuidType;                           ///< GUID Hob
> type structure for gSaConfigHobGuid
> 
> +  DPR_DIRECTORY_ENTRY      DprDirectory[DPR_DIRECTORY_MAX];          ///<
> DPR directory entry definition
> 
> +  UINT8                    ApertureSize;                             ///< Aperture size value
> 
> +  BOOLEAN                  CridEnable;                               ///< This field inidicates if
> CRID is enabled or disabled (to support Intel(R) SIPP)
> 
> +} SA_CONFIG_HOB;
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaD
> ef.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaD
> ef.h
> new file mode 100644
> index 0000000000..6ee2343363
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/IncludePrivate/SaNvsAreaD
> ef.h
> @@ -0,0 +1,222 @@
> +//
> 
> +// Automatically generated by GenNvs ver 2.4.6
> 
> +// Please DO NOT modify !!!
> 
> +//
> 
> +
> 
> +/** @file
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +  //
> 
> +  // Define SA NVS Area operation region.
> 
> +  //
> 
> +#ifndef _SA_NVS_AREA_DEF_H_
> 
> +#define _SA_NVS_AREA_DEF_H_
> 
> +
> 
> +#pragma pack (push,1)
> 
> +typedef struct {
> 
> +  UINT32   IgdOpRegionAddress;                      ///< Offset 0       IGD OpRegion
> base address
> 
> +  UINT8    GfxTurboIMON;                            ///< Offset 4       IMON Current
> Value
> 
> +  UINT8    IgdState;                                ///< Offset 5       IGD State (Primary
> Display = 1)
> 
> +  UINT8    IgdBootType;                             ///< Offset 6       IGD Boot Display
> Device
> 
> +  UINT8    IgdPanelType;                            ///< Offset 7       IGD Panel Type CMOS
> option
> 
> +  UINT8    IgdPanelScaling;                         ///< Offset 8       IGD Panel Scaling
> 
> +  UINT8    IgdBiaConfig;                            ///< Offset 9       IGD BIA Configuration
> 
> +  UINT8    IgdSscConfig;                            ///< Offset 10      IGD SSC Configuration
> 
> +  UINT8    IgdDvmtMemSize;                          ///< Offset 11      IGD DVMT
> Memory Size
> 
> +  UINT8    IgdFunc1Enable;                          ///< Offset 12      IGD Function 1
> Enable
> 
> +  UINT8    IgdHpllVco;                              ///< Offset 13      HPLL VCO
> 
> +  UINT8    IgdSciSmiMode;                           ///< Offset 14      GMCH SMI/SCI
> mode (0=SCI)
> 
> +  UINT8    IgdPAVP;                                 ///< Offset 15      IGD PAVP data
> 
> +  UINT8    CurrentDeviceList;                       ///< Offset 16      Current Attached
> Device List
> 
> +  UINT16   CurrentDisplayState;                     ///< Offset 17      Current Display
> State
> 
> +  UINT16   NextDisplayState;                        ///< Offset 19      Next Display State
> 
> +  UINT8    NumberOfValidDeviceId;                   ///< Offset 21      Number of
> Valid Device IDs
> 
> +  UINT32   DeviceId1;                               ///< Offset 22      Device ID 1
> 
> +  UINT32   DeviceId2;                               ///< Offset 26      Device ID 2
> 
> +  UINT32   DeviceId3;                               ///< Offset 30      Device ID 3
> 
> +  UINT32   DeviceId4;                               ///< Offset 34      Device ID 4
> 
> +  UINT32   DeviceId5;                               ///< Offset 38      Device ID 5
> 
> +  UINT32   DeviceId6;                               ///< Offset 42      Device ID 6
> 
> +  UINT32   DeviceId7;                               ///< Offset 46      Device ID 7
> 
> +  UINT32   DeviceId8;                               ///< Offset 50      Device ID 8
> 
> +  UINT32   DeviceId9;                               ///< Offset 54      Device ID 9
> 
> +  UINT32   DeviceId10;                              ///< Offset 58      Device ID 10
> 
> +  UINT32   DeviceId11;                              ///< Offset 62      Device ID 11
> 
> +  UINT32   DeviceId12;                              ///< Offset 66      Device ID 12
> 
> +  UINT32   DeviceId13;                              ///< Offset 70      Device ID 13
> 
> +  UINT32   DeviceId14;                              ///< Offset 74      Device ID 14
> 
> +  UINT32   DeviceId15;                              ///< Offset 78      Device ID 15
> 
> +  UINT32   DeviceIdX;                               ///< Offset 82      Device ID for eDP
> device
> 
> +  UINT32   NextStateDid1;                           ///< Offset 86      Next state DID1 for
> _DGS
> 
> +  UINT32   NextStateDid2;                           ///< Offset 90      Next state DID2 for
> _DGS
> 
> +  UINT32   NextStateDid3;                           ///< Offset 94      Next state DID3 for
> _DGS
> 
> +  UINT32   NextStateDid4;                           ///< Offset 98      Next state DID4 for
> _DGS
> 
> +  UINT32   NextStateDid5;                           ///< Offset 102     Next state DID5 for
> _DGS
> 
> +  UINT32   NextStateDid6;                           ///< Offset 106     Next state DID6 for
> _DGS
> 
> +  UINT32   NextStateDid7;                           ///< Offset 110     Next state DID7 for
> _DGS
> 
> +  UINT32   NextStateDid8;                           ///< Offset 114     Next state DID8 for
> _DGS
> 
> +  UINT32   NextStateDidEdp;                         ///< Offset 118     Next state DID for
> eDP
> 
> +  UINT8    LidState;                                ///< Offset 122     Lid State (Lid Open = 1)
> 
> +  UINT32   AKsv0;                                   ///< Offset 123     First four bytes of AKSV
> (manufacturing mode)
> 
> +  UINT8    AKsv1;                                   ///< Offset 127     Fifth byte of AKSV
> (manufacturing mode)
> 
> +  UINT8    BrightnessPercentage;                    ///< Offset 128     Brightness Level
> Percentage
> 
> +  UINT8    AlsEnable;                               ///< Offset 129     Ambient Light Sensor
> Enable
> 
> +  UINT8    AlsAdjustmentFactor;                     ///< Offset 130     Ambient Light
> Adjusment Factor
> 
> +  UINT8    LuxLowValue;                             ///< Offset 131     LUX Low Value
> 
> +  UINT8    LuxHighValue;                            ///< Offset 132     LUX High Value
> 
> +  UINT8    ActiveLFP;                               ///< Offset 133     Active LFP
> 
> +  UINT8    IpuAcpiMode;                             ///< Offset 134     IPU ACPI device
> type (0=Disabled, 1=AVStream virtual device as child of GFX)
> 
> +  UINT8    EdpValid;                                ///< Offset 135     Check for eDP display
> device
> 
> +  UINT8    HgMode;                                  ///< Offset 136     SG Mode (0=Disabled,
> 1=HG Muxed, 2=HG Muxless, 3=DGPU Only)
> 
> +  UINT8    HgFeatureList;                           ///< Offset 137     HG Feature List
> 
> +  UINT8    Pcie0GpioSupport;                        ///< Offset 138     PCIe0 GPIO
> Support (0=Disabled, 1=PCH Based, 2=I2C Based)
> 
> +  UINT8    Pcie0HoldRstExpanderNo;                  ///< Offset 139     PCIe0 HLD
> RST IO Expander Number
> 
> +  UINT32   Pcie0HoldRstGpioNo;                      ///< Offset 140     PCIe0 HLD RST
> GPIO Number
> 
> +  UINT8    Pcie0HoldRstActiveInfo;                  ///< Offset 144     PCIe0 HLD RST
> GPIO Active Information
> 
> +  UINT8    Pcie0PwrEnExpanderNo;                    ///< Offset 145     PCIe0 PWR
> Enable IO Expander Number
> 
> +  UINT32   Pcie0PwrEnGpioNo;                        ///< Offset 146     PCIe0 PWR
> Enable GPIO Number
> 
> +  UINT8    Pcie0PwrEnActiveInfo;                    ///< Offset 150     PCIe0 PWR
> Enable GPIO Active Information
> 
> +  UINT8    Pcie1GpioSupport;                        ///< Offset 151     PCIe1 GPIO
> Support (0=Disabled, 1=PCH Based, 2=I2C Based)
> 
> +  UINT8    Pcie1HoldRstExpanderNo;                  ///< Offset 152     PCIe1 HLD
> RST IO Expander Number
> 
> +  UINT32   Pcie1HoldRstGpioNo;                      ///< Offset 153     PCIe1 HLD RST
> GPIO Number
> 
> +  UINT8    Pcie1HoldRstActiveInfo;                  ///< Offset 157     PCIe1 HLD RST
> GPIO Active Information
> 
> +  UINT8    Pcie1PwrEnExpanderNo;                    ///< Offset 158     PCIe1 PWR
> Enable IO Expander Number
> 
> +  UINT32   Pcie1PwrEnGpioNo;                        ///< Offset 159     PCIe1 PWR
> Enable GPIO Number
> 
> +  UINT8    Pcie1PwrEnActiveInfo;                    ///< Offset 163     PCIe1 PWR
> Enable GPIO Active Information
> 
> +  UINT8    Pcie2GpioSupport;                        ///< Offset 164     PCIe2 GPIO
> Support (0=Disabled, 1=PCH Based, 2=I2C Based)
> 
> +  UINT8    Pcie2HoldRstExpanderNo;                  ///< Offset 165     PCIe2 HLD
> RST IO Expander Number
> 
> +  UINT32   Pcie2HoldRstGpioNo;                      ///< Offset 166     PCIe2 HLD RST
> GPIO Number
> 
> +  UINT8    Pcie2HoldRstActiveInfo;                  ///< Offset 170     PCIe2 HLD RST
> GPIO Active Information
> 
> +  UINT8    Pcie2PwrEnExpanderNo;                    ///< Offset 171     PCIe2 PWR
> Enable IO Expander Number
> 
> +  UINT32   Pcie2PwrEnGpioNo;                        ///< Offset 172     PCIe2 PWR
> Enable GPIO Number
> 
> +  UINT8    Pcie2PwrEnActiveInfo;                    ///< Offset 176     PCIe2 PWR
> Enable GPIO Active Information
> 
> +  UINT8    Pcie3GpioSupport;                        ///< Offset 177     PCIe3 GPIO
> Support (0=Disabled, 1=PCH Based, 2=I2C Based)
> 
> +  UINT8    Pcie3HoldRstExpanderNo;                  ///< Offset 178     PCIe3 HLD
> RST IO Expander Number
> 
> +  UINT32   Pcie3HoldRstGpioNo;                      ///< Offset 179     PCIe3 HLD RST
> GPIO Number
> 
> +  UINT8    Pcie3HoldRstActiveInfo;                  ///< Offset 183     PCIe3 HLD RST
> GPIO Active Information
> 
> +  UINT8    Pcie3PwrEnExpanderNo;                    ///< Offset 184     PCIe3 PWR
> Enable IO Expander Number
> 
> +  UINT32   Pcie3PwrEnGpioNo;                        ///< Offset 185     PCIe3 PWR
> Enable GPIO Number
> 
> +  UINT8    Pcie3PwrEnActiveInfo;                    ///< Offset 189     PCIe3 PWR
> Enable GPIO Active Information
> 
> +  UINT32   Pcie3WakeGpioNo;                         ///< Offset 190     PCIe3 RTD3
> Device Wake GPIO Number
> 
> +  UINT16   DelayAfterPwrEn;                         ///< Offset 194     Delay after power
> enable for PCIe
> 
> +  UINT16   DelayAfterHoldReset;                     ///< Offset 196     Delay after Hold
> Reset for PCIe
> 
> +  UINT8    Pcie0EpCapOffset;                        ///< Offset 198     PCIe0 Endpoint
> Capability Structure Offset
> 
> +  UINT32   XPcieCfgBaseAddress;                     ///< Offset 199     Any Device's
> PCIe Config Space Base Address
> 
> +  UINT16   GpioBaseAddress;                         ///< Offset 203     GPIO Base
> Address
> 
> +  UINT32   NvIgOpRegionAddress;                     ///< Offset 205     NVIG
> opregion address
> 
> +  UINT32   NvHmOpRegionAddress;                     ///< Offset 209     NVHM
> opregion address
> 
> +  UINT32   ApXmOpRegionAddress;                     ///< Offset 213     AMDA
> opregion address
> 
> +  UINT8    Peg0LtrEnable;                           ///< Offset 217     Latency Tolerance
> Reporting Enable
> 
> +  UINT8    Peg0ObffEnable;                          ///< Offset 218     Optimized Buffer
> Flush and Fill
> 
> +  UINT8    Peg1LtrEnable;                           ///< Offset 219     Latency Tolerance
> Reporting Enable
> 
> +  UINT8    Peg1ObffEnable;                          ///< Offset 220     Optimized Buffer
> Flush and Fill
> 
> +  UINT8    Peg2LtrEnable;                           ///< Offset 221     Latency Tolerance
> Reporting Enable
> 
> +  UINT8    Peg2ObffEnable;                          ///< Offset 222     Optimized Buffer
> Flush and Fill
> 
> +  UINT8    Peg3LtrEnable;                           ///< Offset 223     Latency Tolerance
> Reporting Enable
> 
> +  UINT8    Peg3ObffEnable;                          ///< Offset 224     Optimized Buffer
> Flush and Fill
> 
> +  UINT16   PegLtrMaxSnoopLatency;                   ///< Offset 225     SA Peg
> Latency Tolerance Reporting Max Snoop Latency
> 
> +  UINT16   PegLtrMaxNoSnoopLatency;                 ///< Offset 227     SA Peg
> Latency Tolerance Reporting Max No Snoop Latency
> 
> +  UINT64   Mmio64Base;                              ///< Offset 229     Base of above 4GB
> MMIO resource
> 
> +  UINT64   Mmio64Length;                            ///< Offset 237     Length of above
> 4GB MMIO resource
> 
> +  UINT32   CpuIdInfo;                               ///< Offset 245     CPU ID info to get
> Family Id or Stepping
> 
> +  UINT32   Mmio32Base;                              ///< Offset 249     Base of below 4GB
> MMIO resource
> 
> +  UINT32   Mmio32Length;                            ///< Offset 253     Length of below
> 4GB MMIO resource
> 
> +  UINT32   Pcie0WakeGpioNo;                         ///< Offset 257     PCIe0 RTD3
> Device Wake GPIO Number
> 
> +  UINT32   Pcie1WakeGpioNo;                         ///< Offset 261     PCIe1 RTD3
> Device Wake GPIO Number
> 
> +  UINT32   Pcie2WakeGpioNo;                         ///< Offset 265     PCIe2 RTD3
> Device Wake GPIO Number
> 
> +  UINT8    VtdDisable;                              ///< Offset 269     VT-d Enable/Disable
> 
> +  UINT32   VtdBaseAddress[7];                       ///< Offset 270     VT-d Base
> Address 1
> 
> +                                                    ///< Offset 274     VT-d Base Address 2
> 
> +                                                    ///< Offset 278     VT-d Base Address 3
> 
> +                                                    ///< Offset 282     VT-d Base Address 4 (iTBT PCIE0)
> 
> +                                                    ///< Offset 286     VT-d Base Address 5 (iTBT PCIE1)
> 
> +                                                    ///< Offset 290     VT-d Base Address 6 (iTBT PCIE2)
> 
> +                                                    ///< Offset 294     VT-d Base Address 7 (iTBT PCIE3)
> 
> +  UINT16   VtdEngine1Vid;                           ///< Offset 298     VT-d Engine#1
> Vendor ID
> 
> +  UINT16   VtdEngine2Vid;                           ///< Offset 300     VT-d Engine#2
> Vendor ID
> 
> +  UINT8    RootPortIndex;                           ///< Offset 302     RootPort Number
> 
> +  UINT32   RootPortAddress;                         ///< Offset 303     RootPortAddress
> 
> +  UINT8    CpuTraceHubMode;                         ///< Offset 307     CPU Trace Hub
> Mode
> 
> +  UINT8    SimicsEnvironment;                       ///< Offset 308     Simics
> Environment information
> 
> +  UINT8    ItbtXhciEn;                              ///< Offset 309     TCSS XHCI Device
> Enable
> 
> +  UINT8    ItbtXdciEn;                              ///< Offset 310     TCSS XDCI Device
> Enable
> 
> +  UINT8    ItbtDmaEn[2];                            ///< Offset 311     TCSS DMA 0 Device
> Enable
> 
> +                                                    ///< Offset 312     TCSS DMA 1 Device Enable
> 
> +  UINT8    ItbtPcieRpEn[4];                         ///< Offset 313     TCSS ItbtPcieRp PCIE
> RP 0 Device Enable
> 
> +                                                    ///< Offset 314     TCSS ItbtPcieRp PCIE RP 1 Device
> Enable
> 
> +                                                    ///< Offset 315     TCSS ItbtPcieRp PCIE RP 2 Device
> Enable
> 
> +                                                    ///< Offset 316     TCSS ItbtPcieRp PCIE RP 3 Device
> Enable
> 
> +  UINT32   ItbtPcieRpAddress[4];                    ///< Offset 317     TCSS ItbtPcie
> Root Port address 0
> 
> +                                                    ///< Offset 321     TCSS ItbtPcie Root Port address
> 1
> 
> +                                                    ///< Offset 325     TCSS ItbtPcie Root Port address
> 2
> 
> +                                                    ///< Offset 329     TCSS ItbtPcie Root Port address
> 3
> 
> +  UINT32   TcssxDCIPwrDnScale;                      ///< Offset 333     TCSS xDCI
> Power Down Scale Value, DWC_USB3_GCTL_INIT[31:19]
> 
> +  UINT8    TcssxDCIInt;                             ///< Offset 337     TCSS xDCI Int Pin
> 
> +  UINT8    TcssxDCIIrq;                             ///< Offset 338     TCSS xDCI Irq Number
> 
> +  UINT8    TcssRtd3;                                ///< Offset 339     TCSS RTD3
> 
> +  UINT32   TcssDma0RmrrAddr;                        ///< Offset 340     TCSS DMA0
> RMRR address
> 
> +  UINT32   TcssDma1RmrrAddr;                        ///< Offset 344     TCSS DMA1
> RMRR address
> 
> +  UINT8    LtrEnable[4];                            ///< Offset 348     Latency Tolerance
> Reporting Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +                                                    ///< Offset 349     Latency Tolerance Reporting
> Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +                                                    ///< Offset 350     Latency Tolerance Reporting
> Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +                                                    ///< Offset 351     Latency Tolerance Reporting
> Mechanism. <b>0: Disable</b>; 1: Enable.
> 
> +  UINT16   PcieLtrMaxSnoopLatency[4];               ///< Offset 352     PCIE LTR
> max snoop Latency 0
> 
> +                                                    ///< Offset 354     PCIE LTR max snoop Latency 1
> 
> +                                                    ///< Offset 356     PCIE LTR max snoop Latency 2
> 
> +                                                    ///< Offset 358     PCIE LTR max snoop Latency 3
> 
> +  UINT16   PcieLtrMaxNoSnoopLatency[4];             ///< Offset 360     PCIE LTR
> max no snoop Latency 0
> 
> +                                                    ///< Offset 362     PCIE LTR max no snoop Latency
> 1
> 
> +                                                    ///< Offset 364     PCIE LTR max no snoop Latency
> 2
> 
> +                                                    ///< Offset 366     PCIE LTR max no snoop Latency
> 3
> 
> +  UINT8    IomReady;                                ///< Offset 368     IOM Ready
> 
> +  UINT8    TcssIomVccSt;                            ///< Offset 369     TCSS IOM VccSt
> 
> +  UINT8    CpuPcieRp0Enable;                        ///< Offset 370     <0:Disabled,
> 1:Enabled>
> 
> +  UINT8    CpuPcieRp1Enable;                        ///< Offset 371     <0:Disabled,
> 1:Enabled>
> 
> +  UINT8    CpuPcieRp2Enable;                        ///< Offset 372     <0:Disabled,
> 1:Enabled>
> 
> +  UINT8    CpuPcieRp3Enable;                        ///< Offset 373     <0:Disabled,
> 1:Enabled>
> 
> +  UINT8    VmdEnable;                               ///< Offset 374     VMD Device Enable
> 
> +  UINT32   DeviceIdY;                               ///< Offset 375     Device ID for second
> LFP device
> 
> +  UINT32   NextStateDidEdp2;                        ///< Offset 379     Next state DID
> for Second Display
> 
> +  UINT8    SlotSelection;                           ///< Offset 383     PCIe slot selection
> 
> +  UINT8    VmdRp1to8;                               ///< Offset 384     VMD PCH RP 1 to 8
> <0:Disabled, 1:Enabled>
> 
> +  UINT8    VmdRp9to16;                              ///< Offset 385     VMD PCH RP 9 to 16
> <0:Disabled, 1:Enabled>
> 
> +  UINT8    VmdRp17to24;                             ///< Offset 386     VMD PCH RP 17 to
> 24 <0:Disabled, 1:Enabled>
> 
> +  UINT8    VmdSataPort[8];                          ///< Offset 387     VMD SATA PORT 0
> <0:Disabled, 1:Enabled>
> 
> +                                                    ///< Offset 388     VMD SATA PORT 1 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 389     VMD SATA PORT 2 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 390     VMD SATA PORT 3 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 391     VMD SATA PORT 4 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 392     VMD SATA PORT 5 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 393     VMD SATA PORT 6 <0:Disabled,
> 1:Enabled>
> 
> +                                                    ///< Offset 394     VMD SATA PORT 7 <0:Disabled,
> 1:Enabled>
> 
> +  UINT8    VmdCpuRp;                                ///< Offset 395     VMD CPU RP
> <0:Disabled, 1:Enabled>
> 
> +  UINT8    CpuPcieRtd3;                             ///< Offset 396     RTD3 Support for
> CPU PCIE.
> 
> +  UINT32   LaneUsed;                                ///< Offset 397     Lane Used of each CSI
> Port <0:Not Configured, 1:x1, 2:x2, 3:x3 4:x4>
> 
> +  UINT32   CsiSpeed;                                ///< Offset 401     Speed of each CSI Port
> <0:Not configured, 1:<416GMbps, 2:<1.5Gbps, 3:<2.0Gbps, 4:<2.5Gbps,
> 5:<4Gbps, 6:>4Gbps>
> 
> +  UINT8    MaxPegPortNumber;                        ///< Offset 405     Max PEG port
> number
> 
> +  UINT8    MemBootMode;                             ///< Offset 406     Current Memory
> Boot Mode <0: BOOT_MODE_1LM(Default), 1: BOOT_MODE_2LM, 2:
> BOOT_MODE_PROVISION>
> 
> +  UINT8    DpmemSupport;                            ///< Offset 407     Dynamic PMem
> Support <0: Disabled, 1:Enabled>
> 
> +  UINT64   PmemStartingAddress;                     ///< Offset 408     Private Pmem
> Starting address
> 
> +  UINT64   PmemRangeLength;                         ///< Offset 416     Private Pmem
> Range Length
> 
> +  UINT8    Pcie3EpCapOffset;                        ///< Offset 424     PCIe3 Endpoint
> Capability Structure Offset
> 
> +  UINT8    Pcie0SrcClkNo;                           ///< Offset 425     PCIe0 RTD3 Device
> Source Clock Number
> 
> +  UINT8    Pcie1SrcClkNo;                           ///< Offset 426     PCIe1 RTD3 Device
> Source Clock Number
> 
> +  UINT8    Pcie2SrcClkNo;                           ///< Offset 427     PCIe2 RTD3 Device
> Source Clock Number
> 
> +  UINT8    Pcie3SrcClkNo;                           ///< Offset 428     PCIe2 RTD3 Device
> Source Clock Number
> 
> +  UINT8    Pcie0SecBusNum;                          ///< Offset 429     PCIe0 Secondary
> Bus Number (PCIe0 Endpoint Bus Number)
> 
> +  UINT8    Pcie1SecBusNum;                          ///< Offset 430     PCIe1 Secondary
> Bus Number (PCIe0 Endpoint Bus Number)
> 
> +  UINT8    Pcie2SecBusNum;                          ///< Offset 431     PCIe2 Secondary
> Bus Number (PCIe0 Endpoint Bus Number)
> 
> +  UINT8    Pcie3SecBusNum;                          ///< Offset 432     PCIe2 Secondary
> Bus Number (PCIe0 Endpoint Bus Number)
> 
> +  UINT8    Pcie1EpCapOffset;                        ///< Offset 433     PCIe1 Endpoint
> Capability Structure Offset
> 
> +  UINT8    Pcie2EpCapOffset;                        ///< Offset 434     PCIe2 Endpoint
> Capability Structure Offset
> 
> +  UINT8    IsBridgeDeviceBehindPeg1;                ///< Offset 435     Is bridge
> device behind PEG1
> 
> +  UINT8    IsBridgeDeviceBehindPeg2;                ///< Offset 436     Is bridge
> device behind PEG2
> 
> +  UINT8    IsBridgeDeviceBehindPeg3;                ///< Offset 437     Is bridge
> device behind PEG3
> 
> +  UINT8    HgSlot;                                  ///< Offset 438     Slot selection between
> PCH/PEG
> 
> +} SYSTEM_AGENT_NVS_AREA;
> 
> +
> 
> +#pragma pack(pop)
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers
  2021-02-01  1:36 ` [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Fru/TglCpu/Include
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFruL
> ib.h |  57
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHostBri
> dge.h | 145
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h                  |  12
> ++++++++++++
>  3 files changed, 214 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFr
> uLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFr
> uLib.h
> new file mode 100644
> index 0000000000..89cf952717
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Library/CpuPcieInfoFr
> uLib.h
> @@ -0,0 +1,57 @@
> +/** @file
> 
> +  Header file for CpuPcieInfoFruLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PCIE_INFO_FRU_LIB_H_
> 
> +#define _CPU_PCIE_INFO_FRU_LIB_H_
> 
> +
> 
> +#include <CpuPcieInfo.h>
> 
> +
> 
> +#define CPU_PCIE_MAX_ROOT_PORTS       4
> 
> +
> 
> +#define CPU_PCIE_ULT_ULX_MAX_ROOT_PORT     1
> 
> +
> 
> +#include <Library/CpuRegbarAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Get CPU Maximum Pcie Root Port Number
> 
> +
> 
> +  @retval PcieMaxRootPort         Pch Maximum Pcie Root Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetMaxCpuPciePortNum (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get CPU Pcie Root Port Device and Function Number by Root Port physical
> Number
> 
> +
> 
> +  @param[in]  RpNumber              Root port physical number. (0-based)
> 
> +  @param[out] RpDev                 Return corresponding root port device
> number.
> 
> +  @param[out] RpFun                 Return corresponding root port function
> number.
> 
> +
> 
> +  @retval     EFI_SUCCESS           Root port device and function is retrieved
> 
> +  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetCpuPcieRpDevFun (
> 
> +  IN  UINTN   RpNumber,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets pci segment base address of PCIe root port.
> 
> +
> 
> +  @param  RpIndex    Root Port Index (0 based)
> 
> +  @return PCIe port  base address.
> 
> +**/
> 
> +UINT64
> 
> +CpuPcieBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  );
> 
> +
> 
> +#endif // _CPU_PCIE_INFO_FRU_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHost
> Bridge.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHost
> Bridge.h
> new file mode 100644
> index 0000000000..32e38fa072
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/Register/SaRegsHost
> Bridge.h
> @@ -0,0 +1,145 @@
> +/** @file
> 
> +  Register names for Host Bridge block
> 
> +  <b>Conventions</b>:
> 
> +  - Prefixes:
> 
> +    - Definitions beginning with "R_" are registers
> 
> +    - Definitions beginning with "B_" are bits within registers
> 
> +    - Definitions beginning with "V_" are meaningful values of bits within the
> registers
> 
> +    - Definitions beginning with "S_" are register sizes
> 
> +    - Definitions beginning with "N_" are the bit position
> 
> +  - In general, SA registers are denoted by "_SA_" in register names
> 
> +  - Registers / bits that are different between SA generations are denoted
> by
> 
> +    "_SA_[generation_name]_" in register/bit names. e.g., "_SA_HSW_"
> 
> +  - Registers / bits that are different between SKUs are denoted by
> "_[SKU_name]"
> 
> +    at the end of the register/bit names
> 
> +  - Registers / bits of new devices introduced in a SA generation will be just
> named
> 
> +    as "_SA_" without [generation_name] inserted.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_REGS_HOST_BRIDGE_H_
> 
> +#define _SA_REGS_HOST_BRIDGE_H_
> 
> +
> 
> +#define SA_SEG_NUM              0x00
> 
> +#define V_SA_DEVICE_ID_INVALID  0xFFFF
> 
> +//
> 
> +// DEVICE 0 (Memory Controller Hub)
> 
> +//
> 
> +#define SA_MC_BUS          0x00
> 
> +#define SA_MC_DEV          0x00
> 
> +#define SA_MC_FUN          0x00
> 
> +#define V_SA_MC_VID        0x8086
> 
> +#define R_SA_MC_DEVICE_ID  0x02
> 
> +#define R_SA_MC_CAPID0_B   0xE8
> 
> +
> 
> +//
> 
> +// SA DMI configuration
> 
> +//
> 
> +
> 
> +//
> 
> +// Maximum DMI lanes and bundles supported (x8 and 4 lanes)
> 
> +//
> 
> +#define SA_DMI_MAX_LANE                      0x08
> 
> +#define SA_DMI_MAX_BUNDLE                    0x04
> 
> +#define SA_DMI_MAX_LANE_VER1                 0x04
> 
> +#define SA_DMI_MAX_BUNDLE_VER1               0x02
> 
> +
> 
> +
> 
> +//
> 
> +// TigerLake Mobile SA Device IDs B0:D0:F0
> 
> +//
> 
> +#define V_SA_DEVICE_ID_MB_ULT_1 0x9A14   ///< TigerLake Ult (TGL-U
> 4+2)
> 
> +#define V_SA_DEVICE_ID_MB_ULT_2 0x9A04   ///< TigerLake Ult (TGL-U
> 2+2)
> 
> +
> 
> +#define V_SA_DEVICE_ID_MB_ULX_1 0x9A12   ///< TigerLake Ulx (TGL-Y
> 4+2)
> 
> +#define V_SA_DEVICE_ID_MB_ULX_2 0x9A02   ///< TigerLake Ulx (TGL-Y
> 2+2)
> 
> +
> 
> +/**
> 
> + <b>Description</b>:
> 
> + - This is the base address for the Host Memory Mapped Configuration
> space.  There is no physical memory within this 32KB window that can be
> addressed.  The 32KB reserved by this register does not alias to any PCI 2.3
> compliant memory mapped space.  On reset, the Host MMIO Memory
> Mapped Configuation space is disabled and must be enabled by writing a 1 to
> MCHBAREN [Dev 0, offset48h, bit 0].
> 
> + - All the bits in this register are locked in LT mode.
> 
> + - The register space contains memory control, initialization, timing, and
> buffer strength registers; clocking registers; and power and thermal
> management registers.
> 
> +**/
> 
> +#define R_SA_MCHBAR  (0x48)
> 
> +
> 
> +/**
> 
> + <b>Description</b>:
> 
> + - All the bits in this register are LT lockable.
> 
> +**/
> 
> +#define R_SA_GGC (0x50)
> 
> +
> 
> +/**
> 
> + Description of GMS (8:15)
> 
> + - This field is used to select the amount of Main Memory that is pre-
> allocated to support the Internal Graphics device in VGA (non-linear) and
> Native (linear) modes.  The BIOS ensures that memory is pre-allocated only
> when Internal graphics is enabled.
> 
> + - This register is also LT lockable.
> 
> + - Valid options are 0 (0x0) to 2048MB (0x40) in multiples of 32 MB
> 
> + - All other values are reserved
> 
> + - Hardware does not clear or set any of these bits automatically based on
> IGD being disabled/enabled.
> 
> + - BIOS Requirement: BIOS must not set this field to 0h if IVD (bit 1 of this
> register) is 0.
> 
> +**/
> 
> +#define N_SA_GGC_GMS_OFFSET  (0x8)
> 
> +#define B_SA_GGC_GMS_MASK    (0xff00)
> 
> +
> 
> +/**
> 
> + Description of GGMS (6:7)
> 
> + - This field is used to select the amount of Main Memory that is pre-
> allocated to support the Internal Graphics Translation Table.  The BIOS
> ensures that memory is pre-allocated only when Internal graphics is enabled.
> 
> + - GSM is assumed to be a contiguous physical DRAM space with DSM, and
> BIOS needs to allocate a contiguous memory chunk.  Hardware will derive the
> base of GSM from DSM only using the GSM size programmed in the register.
> 
> + - Valid options:
> 
> + - 0h: 0 MB of memory pre-allocated for GTT.
> 
> + - 1h: 2 MB of memory pre-allocated for GTT.
> 
> + - 2h: 4 MB of memory pre-allocated for GTT.
> 
> + - 3h: 8 MB of memory pre-allocated for GTT.
> 
> + - Others: Reserved
> 
> + - Hardware functionality in case of programming this value to Reserved is
> not guaranteed.
> 
> +**/
> 
> +#define N_SA_GGC_GGMS_OFFSET  (0x6)
> 
> +#define B_SA_GGC_GGMS_MASK    (0xc0)
> 
> +#define V_SA_GGC_GGMS_8MB     3
> 
> +
> 
> +/**
> 
> + Description:
> 
> + - Allows for enabling/disabling of PCI devices and functions that are within
> the CPU package. The table below the bit definitions describes the behavior
> of all combinations of transactions to devices controlled by this register.
> 
> +  All the bits in this register are LT Lockable.
> 
> +**/
> 
> +#define R_SA_DEVEN (0x54)
> 
> +
> 
> +/**
> 
> + Description of D2EN (4:4)
> 
> + - 0:  Bus 0 Device 2 is disabled and hidden
> 
> + - 1:  Bus 0 Device 2 is enabled and visible
> 
> + - This bit will remain 0 if Device 2 capability is disabled.
> 
> +**/
> 
> +#define B_SA_DEVEN_D2EN_MASK     (0x10)
> 
> +
> 
> +
> 
> +///
> 
> +/// Description:
> 
> +///  The SMRAMC register controls how accesses to Compatible SMRAM
> spaces are treated.  The Open, Close and Lock bits function only when
> G_SMRAME bit is set to 1.  Also, the Open bit must be reset before the Lock
> bit is set.
> 
> +///
> 
> +#define R_SA_SMRAMC  (0x88)
> 
> +
> 
> +///
> 
> +/// Description:
> 
> +///  This register contains the base address of stolen DRAM memory for the
> GTT. BIOS determines the base of GTT stolen memory by subtracting the GTT
> graphics stolen memory size (PCI Device 0 offset 52 bits 9:8) from the
> Graphics Base of  Data Stolen Memory (PCI Device 0 offset B0 bits 31:20).
> 
> +///
> 
> +#define R_SA_BGSM  (0xb4)
> 
> +
> 
> +
> 
> +///
> 
> +/// Description:
> 
> +///  This register contains the Top of low memory address.
> 
> +///
> 
> +#define R_SA_TOLUD (0xbc)
> 
> +
> 
> +///
> 
> +/// Description of TOLUD (20:31)
> 
> +///  This register contains bits 31 to 20 of an address one byte above the
> maximum DRAM memory below 4G that is usable by the operating system.
> Address bits 31 down to 20 programmed to 01h implies a minimum memory
> size of 1MB. Configuration software must set this value to the smaller of the
> following 2 choices: maximum amount memory in the system minus ME
> stolen memory plus one byte or the minimum address allocated for PCI
> memory. Address bits 19:0 are assumed to be 0_0000h for the purposes of
> address comparison. The Host interface positively decodes an address
> towards DRAM if the incoming address is less than the value programmed in
> this register.
> 
> +///  The Top of Low Usable DRAM is the lowest address above both
> Graphics Stolen memory and Tseg. BIOS determines the base of Graphics
> Stolen Memory by subtracting the Graphics Stolen Memory Size from TOLUD
> and further decrements by Tseg size to determine base of Tseg. All the Bits in
> this register are locked in LT mode.
> 
> +///  This register must be 1MB aligned when reclaim is enabled.
> 
> +///
> 
> +#define B_SA_TOLUD_TOLUD_MASK      (0xfff00000)
> 
> +#define R_SA_MC_CAPID0_A_OFFSET    0xE4
> 
> +#define V_SA_LTR_MAX_SNOOP_LATENCY_VALUE           0x0846  ///< Intel
> recommended maximum value for Snoop Latency (70us)
> 
> +#define V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE       0x0846  ///<
> Intel recommended maximum value for Non-Snoop Latency (70us)
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h
> new file mode 100644
> index 0000000000..cd8d57d948
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Include/TcssInfo.h
> @@ -0,0 +1,12 @@
> +/** @file
> 
> +  Register names for TCSS USB devices
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _TCSS_INFO_H_
> 
> +#define _TCSS_INFO_H_
> 
> +
> 
> +#define MAX_ITBT_PCIE_PORT        4
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers
  2021-02-01  1:36 ` [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate
> headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Fru/TglCpu/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInitFr
> uLib.h | 18 ++++++++++++++++++
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuPci
> eRegs.h  | 24 ++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRegs
> .h      | 42 ++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuReg
> s.h      | 31 +++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdReg
> s.h      | 22 ++++++++++++++++++++++
>  5 files changed, 137 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInit
> FruLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Library/VtdInit
> FruLib.h
> new file mode 100644
> index 0000000000..a46b29cbbe
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Librar
> +++ y/VtdInitFruLib.h
> @@ -0,0 +1,18 @@
> +/** @file+  Vtd Initialization Fru Library header file++  Copyright (c) 2021,
> Intel Corporation. All rights reserved.<BR>+  SPDX-License-Identifier: BSD-2-
> Clause-Patent+**/+#ifndef _VTD_INIT_FRU_LIB_H_+#define
> _VTD_INIT_FRU_LIB_H_++///+/// TCSS DMA controller RMRR buffer 4MB
> for each DMA controller+///+#define RMRR_TCSS_DMA_SIZE
> 0x400000++extern UINT16  mDevEnMap[][2];+extern UINTN
> mDevEnMapSize;++#endif // _VTD_INIT_FRU_LIB_H_diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuP
> cieRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/CpuP
> cieRegs.h
> new file mode 100644
> index 0000000000..a571381202
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Regist
> +++ er/CpuPcieRegs.h
> @@ -0,0 +1,24 @@
> +/** @file+  This file contains definitions of  PCIe Configuration++  Copyright
> (c) 2021, Intel Corporation. All rights reserved.<BR>+  SPDX-License-
> Identifier: BSD-2-Clause-Patent+**/++#ifndef
> _CPU_PCIE_REGS_H_+#define _CPU_PCIE_REGS_H_++#define
> R_PCIE_LCAP                              0x4C+#define  R_PCIE_LCTL
> 0x50+#define  R_PCIE_LSTS                              0x52+#define  R_PCIE_SLCAP
> 0x54+#define  R_PCIE_SLSTS                             0x5A+#define  R_PCIE_LCTL2
> 0x70+#define  R_PCIE_MPC                               0xD8+#define
> B_PCIE_MPC_HPME                          BIT1+#define  R_PCIE_PGTHRES
> 0x5C0+#define  B_PCIE_PGTHRES_L1PGLTREN                 BIT0+#define
> R_PCIE_LCTL3                             0xA34+#define  B_PCIE_LCTL3_PE
> BIT0++#endifdiff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdRe
> gs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IgdR
> egs.h
> new file mode 100644
> index 0000000000..f0b30107f4
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Regist
> +++ er/IgdRegs.h
> @@ -0,0 +1,42 @@
> +/** @file+  Register names for IGD block+  <b>Conventions</b>:+  -
> Prefixes:+    - Definitions beginning with "R_" are registers+    - Definitions
> beginning with "B_" are bits within registers+    - Definitions beginning with
> "V_" are meaningful values of bits within the registers+    - Definitions
> beginning with "S_" are register sizes+    - Definitions beginning with "N_" are
> the bit position+  - In general, SA registers are denoted by "_SA_" in register
> names+  - Registers / bits that are different between SA generations are
> denoted by+    "_SA_[generation_name]_" in register/bit names. e.g.,
> "_SA_HSW_"+  - Registers / bits that are different between SKUs are
> denoted by "_[SKU_name]"+    at the end of the register/bit names+  -
> Registers / bits of new devices introduced in a SA generation will be just
> named+    as "_SA_" without [generation_name] inserted.++  Copyright (c)
> 2021, Intel Corporation. All rights reserved.<BR>+  SPDX-License-Identifier:
> BSD-2-Clause-Patent+**/+#ifndef _IGD_REGS_H_+#define
> _IGD_REGS_H_++///+/// Device 2 Register Equates+///+//+// The following
> equates must be reviewed and revised when the specification is
> ready.+//+#define IGD_BUS_NUM          0x00+#define IGD_DEV_NUM
> 0x02+#define IGD_FUN_NUM          0x00++///+/// GTTMMADR aligned to
> 16MB (Base address = [38:24])+///+#define R_SA_IGD_GTTMMADR
> 0x10++#define R_SA_IGD_SWSCI_OFFSET      0x00E8+#define
> R_SA_IGD_ASLS_OFFSET       0x00FC  ///< ASL Storage++#endifdiff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuR
> egs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/IpuR
> egs.h
> new file mode 100644
> index 0000000000..afc72e8db0
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Regist
> +++ er/IpuRegs.h
> @@ -0,0 +1,31 @@
> +/** @file+  Register names for IPU block+  <b>Conventions</b>:+  -
> Prefixes:+    - Definitions beginning with "R_" are registers+    - Definitions
> beginning with "B_" are bits within registers+    - Definitions beginning with
> "V_" are meaningful values of bits within the registers+    - Definitions
> beginning with "S_" are register sizes+    - Definitions beginning with "N_" are
> the bit position+  - IPU registers are denoted by "_IPU_" in register names+  -
> Registers / bits that are different between IPU generations are denoted by+
> "_IPU_[generation_name]_" in register/bit names. e.g., "_IPU_TGL_"+  -
> Registers / bits that are different between SKUs are denoted by
> "_[SKU_name]"+    at the end of the register/bit names+  - Registers / bits of
> new devices introduced in a IPU generation will be just named+    as "_IPU_"
> without [generation_name] inserted.++  Copyright (c) 2021, Intel
> Corporation. All rights reserved.<BR>+  SPDX-License-Identifier: BSD-2-
> Clause-Patent+**/+#ifndef _IPU_REGS_H_+#define _IPU_REGS_H_++//+//
> Device 5 Equates+//+#define IPU_BUS_NUM    0x00+#define
> IPU_DEV_NUM    0x05+#define IPU_FUN_NUM    0x00++#endif  //
> _IPU_REGS_H_diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdR
> egs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Register/VtdR
> egs.h
> new file mode 100644
> index 0000000000..d796a44afc
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/IncludePrivate/Regist
> +++ er/VtdRegs.h
> @@ -0,0 +1,22 @@
> +/** @file+  Register names for VTD block+  <b>Conventions</b>:+  -
> Prefixes:+    - Definitions beginning with "R_" are registers+    - Definitions
> beginning with "B_" are bits within registers+    - Definitions beginning with
> "V_" are meaningful values of bits within the registers+    - Definitions
> beginning with "S_" are register sizes+    - Definitions beginning with "N_" are
> the bit position+  Copyright (c) 2021, Intel Corporation. All rights
> reserved.<BR>+  SPDX-License-Identifier: BSD-2-Clause-Patent+**/+#ifndef
> _VTD_REGS_H_+#define _VTD_REGS_H_++///+/// Vt-d Engine base
> address.+///+#define R_MCHBAR_VTD1_OFFSET                 0x5400  ///< HW
> UNIT1 for IGD+#define R_MCHBAR_VTD3_OFFSET                 0x5410  ///< HW
> UNIT3 for all other - PEG, USB, SATA etc++#endif--
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers
  2021-02-01  1:36 ` [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Fru/TglPch/Include
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
> | 326
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h        |
> 16 ++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResources.
> h |  55
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  3 files changed, 397 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
> new file mode 100644
> index 0000000000..0d00f25d5e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchBdfAssignment.h
> @@ -0,0 +1,326 @@
> +/** @file
> 
> +  Header file for TigerLake PCH devices PCI Bus Device Function map.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_BDF_ASSIGNMENT_H_
> 
> +#define _PCH_BDF_ASSIGNMENT_H_
> 
> +
> 
> +#define NOT_PRESENT                     0xFF
> 
> +
> 
> +#define MAX_SATA_CONTROLLER             1
> 
> +
> 
> +//
> 
> +// PCH PCIe Controllers
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_2          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_3          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_4          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_6          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_7          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_8          28
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9          29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_10         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_11         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_12         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_14         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_15         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_16         29
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_18         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_19         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_20         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_22         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_23         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_24         27
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_25
> NOT_PRESENT
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_26
> NOT_PRESENT
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_27
> NOT_PRESENT
> 
> +#define PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_28
> NOT_PRESENT
> 
> +
> 
> +//
> 
> +// USB3 (XHCI) Controller PCI config
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_XHCI                    20
> 
> +#define PCI_FUNCTION_NUMBER_PCH_XHCI                  0
> 
> +
> 
> +//
> 
> +// xDCI (OTG) USB Device Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_XDCI                    20
> 
> +#define PCI_FUNCTION_NUMBER_PCH_XDCI                  1
> 
> +
> 
> +//
> 
> +//  Thermal Device
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_THERMAL                 NOT_PRESENT
> 
> +#define PCI_FUNCTION_NUMBER_PCH_THERMAL               NOT_PRESENT
> 
> +
> 
> +//
> 
> +// CSME HECI #1
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_HECI1                   22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_HECI1                 0
> 
> +
> 
> +//
> 
> +// CSME HECI #2
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_HECI2                   22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_HECI2                 1
> 
> +
> 
> +//
> 
> +// CSME IDE-Redirection (IDE-R)
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_IDER                    22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_IDER                  2
> 
> +
> 
> +//
> 
> +// CSME Keyboard and Text (KT) Redirection
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_KTR                     22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_KTR                   3
> 
> +
> 
> +//
> 
> +// CSME HECI #3
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_HECI3                   22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_HECI3                 4
> 
> +
> 
> +//
> 
> +// CSME HECI #4
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_HECI4                   22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_HECI4                 5
> 
> +
> 
> +//
> 
> +// CSME MROM
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_MROM                    NOT_PRESENT
> 
> +#define PCI_FUNCTION_NUMBER_PCH_MROM                  NOT_PRESENT
> 
> +
> 
> +//
> 
> +// CSME WLAN
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_WLAN                    22
> 
> +#define PCI_FUNCTION_NUMBER_PCH_WLAN                  7
> 
> +
> 
> +//
> 
> +// SATA Controllers
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SATA_1                  23
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SATA_1                0
> 
> +#define PCI_DEVICE_NUMBER_PCH_SATA_2                  NOT_PRESENT
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SATA_2                NOT_PRESENT
> 
> +#define PCI_DEVICE_NUMBER_PCH_SATA_3                  NOT_PRESENT
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SATA_3                NOT_PRESENT
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #0 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C0          21
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C0        0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #1 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C1          21
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C1        1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #2 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C2          21
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C2        2
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #3 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C3          21
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C3        3
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #4 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C4          25
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C4        0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #5 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C5          25
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C5        1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #6 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C6          16
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C6        0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO I2C #7 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C7          16
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C7        1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #0 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI0          30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI0        2
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #1 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI1          30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI1        3
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #2 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI2          18
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI2        6
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #3 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI3          19
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI3        0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #4 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI4          19
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI4        1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #5 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI5          19
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI5        2
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO SPI #6 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI6          19
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI6        3
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #0 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART0         30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART0       0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #1 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART1         30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART1       1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #2 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART2         25
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART2       2
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #3 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART3         17
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART3       0
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #4 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART4         17
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART4       1
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #5 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART5         17
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART5       2
> 
> +
> 
> +//
> 
> +//  PCH LP Serial IO UART #6 Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART6         17
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART6       3
> 
> +
> 
> +//
> 
> +// DMA-SMBus Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_DMA_SMBUS               30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_DMA_SMBUS             4
> 
> +
> 
> +//
> 
> +// TSN GbE Controller #1
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_TSN0                    30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_TSN0                  4
> 
> +
> 
> +//
> 
> +// TSN GbE Controller #2
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_TSN1                    30
> 
> +#define PCI_FUNCTION_NUMBER_PCH_TSN1                  5
> 
> +
> 
> +//
> 
> +// LPC Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_LPC                     31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_LPC                   0
> 
> +
> 
> +//
> 
> +// eSPI Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_ESPI                    31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_ESPI                  0
> 
> +
> 
> +//
> 
> +// Primary to Sideband (P2SB) Bridge
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_P2SB                    31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_P2SB                  1
> 
> +
> 
> +//
> 
> +// PMC (D31:F2)
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_PMC                     31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_PMC                   2
> 
> +
> 
> +//
> 
> +// PMC SSRAM Registers
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_PMC_SSRAM               20
> 
> +#define PCI_FUNCTION_NUMBER_PCH_PMC_SSRAM             2
> 
> +
> 
> +//
> 
> +// HD-A Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_HDA                     31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_HDA                   3
> 
> +
> 
> +//
> 
> +// SMBus Controller
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SMBUS                   31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SMBUS                 4
> 
> +
> 
> +//
> 
> +// SPI Controller (D31:F5)
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_PCH_SPI                     31
> 
> +#define PCI_FUNCTION_NUMBER_PCH_SPI                   5
> 
> +
> 
> +//
> 
> +// Gigabit Ethernet LAN Controller (D31:F6)
> 
> +//
> 
> +#define PCI_DEVICE_NUMBER_GBE                         31
> 
> +#define PCI_FUNCTION_NUMBER_GBE                       6
> 
> +
> 
> +#endif // _PCH_BDF_ASSIGNMENT_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h
> new file mode 100644
> index 0000000000..d3548796a3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchPcieRpInfo.h
> @@ -0,0 +1,16 @@
> +/** @file
> 
> +  Pcie Root Port info header
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_PCIERP_INFO_H_
> 
> +#define _PCH_PCIERP_INFO_H_
> 
> +
> 
> +//
> 
> +// Number of PCIe ports per PCIe controller
> 
> +//
> 
> +#define PCH_PCIE_CONTROLLER_PORTS                     4u
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResourc
> es.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResourc
> es.h
> new file mode 100644
> index 0000000000..283246692f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Include/PchReservedResourc
> es.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  PCH preserved MMIO resource definitions.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PRESERVED_RESOURCES_H_
> 
> +#define _PCH_PRESERVED_RESOURCES_H_
> 
> +
> 
> +/**
> 
> +  Detailed recommended static allocation
> 
> +  +-------------------------------------------------------------------------+
> 
> +  | PCH preserved MMIO range, 32 MB, from 0xFC800000 to 0xFE7FFFFF
> |
> 
> +  +-------------------------------------------------------------------------+
> 
> +  | Size        | Start       | End         | Usage                         |
> 
> +  | 8 MB        | 0xFC800000  | 0xFCFFFFFF  | TraceHub SW BAR               |
> 
> +  | 16 MB       | 0xFD000000  | 0xFDFFFFFF  | SBREG                         |
> 
> +  | 64 KB       | 0xFE000000  | 0xFE00FFFF  | PMC MBAR                      |
> 
> +  | 4 KB        | 0xFE010000  | 0xFE010FFF  | SPI BAR0                      |
> 
> +  | 176 KB      | 0xFE020000  | 0xFE04BFFF  | SerialIo BAR in ACPI mode     |
> 
> +  | 400 KB      | 0xFE04C000  | 0xFE0AFFFF  | Unused                        |
> 
> +  | 64 KB       | 0xFE0B0000  | 0xFE0BFFFF  | eSPI LGMR BAR                 |
> 
> +  | 64 KB       | 0xFE0C0000  | 0xFE0CFFFF  | eSPI2 SEGMR BAR               |
> 
> +  | 192 KB      | 0xFE0D0000  | 0xFE0FFFFF  | Unused                        |
> 
> +  | 1 MB        | 0xFE100000  | 0xFE1FFFFF  | TraceHub MTB BAR              |
> 
> +  | 2 MB        | 0xFE200000  | 0xFE3FFFFF  | TraceHub FW BAR               |
> 
> +  | 2 MB        | 0xFE400000  | 0xFE5FFFFF  | Unused                        |
> 
> +  | 2 MB        | 0xFE600000  | 0xFE7FFFFF  | Temp address                  |
> 
> +  +-------------------------------------------------------------------------+
> 
> +**/
> 
> +#define PCH_PRESERVED_BASE_ADDRESS      0xFC800000     ///< Pch
> preserved MMIO base address
> 
> +#define PCH_PRESERVED_MMIO_SIZE         0x02000000     ///< 32MB
> 
> +#define PCH_TRACE_HUB_SW_BASE_ADDRESS   0xFC800000     ///<
> TraceHub SW MMIO base address
> 
> +#define PCH_TRACE_HUB_SW_MMIO_SIZE      0x00800000     ///< 8MB
> 
> +#define PCH_PCR_BASE_ADDRESS            0xFD000000     ///< SBREG MMIO
> base address
> 
> +#define PCH_PCR_MMIO_SIZE               0x01000000     ///< 16MB
> 
> +#define PCH_PWRM_BASE_ADDRESS           0xFE000000     ///< PMC MBAR
> MMIO base address
> 
> +#define PCH_PWRM_MMIO_SIZE              0x00010000     ///< 64KB
> 
> +#define PCH_SPI_BASE_ADDRESS            0xFE010000     ///< SPI BAR0 MMIO
> base address
> 
> +#define PCH_SPI_MMIO_SIZE               0x00001000     ///< 4KB
> 
> +#define PCH_SERIAL_IO_BASE_ADDRESS      0xFE020000     ///< SerialIo
> MMIO base address
> 
> +#define PCH_SERIAL_IO_MMIO_SIZE         0x0002C000     ///< 176KB
> 
> +#define PCH_ESPI_LGMR_BASE_ADDRESS      0xFE0B0000     ///< eSPI LGMR
> MMIO base address
> 
> +#define PCH_ESPI_LGMR_MMIO_SIZE         0x00010000     ///< 64KB
> 
> +#define PCH_ESPI_SEGMR_BASE_ADDRESS     0xFE0C0000     ///< Second
> eSPI GMR MMIO base address
> 
> +#define PCH_ESPI_SEGMR_MMIO_SIZE        0x00010000     ///< 64KB
> 
> +#define PCH_TRACE_HUB_MTB_BASE_ADDRESS  0xFE100000     ///<
> TraceHub MTB MMIO base address
> 
> +#define PCH_TRACE_HUB_MTB_MMIO_SIZE     0x00100000     ///< 1MB
> 
> +#define PCH_TRACE_HUB_FW_BASE_ADDRESS   0xFE200000     ///<
> TraceHub FW MMIO base address
> 
> +#define PCH_TRACE_HUB_FW_MMIO_SIZE      0x00200000     ///< 2MB
> 
> +#define PCH_TEMP_BASE_ADDRESS           0xFE600000     ///< preserved
> temp address for misc usage,
> 
> +#define PCH_TEMP_MMIO_SIZE              0x00200000     ///< 2MB
> 
> +
> 
> +#endif // _PCH_PRESERVED_RESOURCES_H_
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers
  2021-02-01  1:36 ` [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:36 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate
> headers
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following header files:
>   * Fru/TglPch/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPcrR
> egs.h | 66
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++
>  1 file changed, 66 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPc
> rRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPc
> rRegs.h
> new file mode 100644
> index 0000000000..4987d21f09
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/IncludePrivate/Register/PchPc
> rRegs.h
> @@ -0,0 +1,66 @@
> +/** @file
> 
> +  Register names for PCH private chipset register
> 
> +
> 
> +Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PCR_H_
> 
> +#define _PCH_REGS_PCR_H_
> 
> +
> 
> +/**
> 
> +  Definition for SBI PID
> 
> +  The PCH_SBI_PID defines the PID for PCR MMIO programming and PCH SBI
> programming as well.
> 
> +**/
> 
> +#define PID_CNVI       0x73
> 
> +#define PID_ICLK       0xAD
> 
> +#define PID_DMI        0x88
> 
> +#define PID_PSTH       0x89
> 
> +#define PID_ESPISPI    0x72
> 
> +#define PID_SPF        0x85
> 
> +#define PID_SPE        0x84
> 
> +#define PID_SPD        0x83
> 
> +#define PID_SPC        0x82
> 
> +#define PID_SPB        0x81
> 
> +#define PID_SPA        0x80
> 
> +#define PID_PSF6       0x7F
> 
> +#define PID_PSF4       0xBD
> 
> +#define PID_PSF3       0xBC
> 
> +#define PID_PSF2       0xBB
> 
> +#define PID_PSF1       0xBA
> 
> +#define PID_GPIOCOM0   0x6E
> 
> +#define PID_GPIOCOM1   0x6D
> 
> +#define PID_GPIOCOM2   0x6C
> 
> +#define PID_GPIOCOM3   0x6B
> 
> +#define PID_GPIOCOM4   0x6A
> 
> +#define PID_GPIOCOM5   0x69
> 
> +#define PID_CSME_PSF   0x8F
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component
  2021-02-01  1:36 ` [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Cnvi/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHob.
> h | 27 +++++++++++++++++++++++++++
>  1 file changed, 27 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigHo
> b.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigH
> ob.h
> new file mode 100644
> index 0000000000..e881e49d62
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Cnvi/IncludePrivate/CnviConfigH
> ob.h
> @@ -0,0 +1,27 @@
> +/** @file
> 
> +  This file defines the CNVi CONFIG HOB
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CNVI_CONFIG_HOB_H_
> 
> +#define _CNVI_CONFIG_HOB_H_
> 
> +
> 
> +#include <Base.h>
> 
> +
> 
> +extern EFI_GUID gCnviConfigHobGuid;
> 
> +#pragma pack (push,1)
> 
> +
> 
> +/**
> 
> +  This HOB is used to pass CNVi related private information to DXE phase
> 
> +**/
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE EfiHobGuidType; ///< GUID HOB type structure for
> gCnviConfigHobGuid
> 
> +  UINT32 Mode           :  1; ///< 0: Disabled, <b>1: Auto</b>
> 
> +  UINT32 BtCore         :  1; ///< 0: Disabled, <b>1: Enabled</b>
> 
> +  UINT32 BtAudioOffload :  1; ///< <b>0: Disabled</b>, 1: Enabled
> 
> +  UINT32 RsvdBits0      : 29; ///< Reserved bits
> 
> +} CNVI_CONFIG_HOB;
> 
> +#pragma pack (pop)
> 
> +
> 
> +#endif // _CNVI_CONFIG_HOB_H_
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component
  2021-02-01  1:36 ` [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component Heng Luo
@ 2021-02-04  3:53   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:53 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp
> component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/CpuPcieRp/Include
>   * IpBlock/CpuPcieRp/IncludePrivate
>   * IpBlock/CpuPcieRp/Library
>   * IpBlock/CpuPcieRp/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h
> |  31 +++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcie
> InitCommon.h                                     | 353
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPcie
> RpLib.h                                          |  47
> +++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library/D
> xeCpuPcieRpLib.h                                |  18 ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpu
> PcieInitCommonLib/CpuPcieInitCommon.c               | 445
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpu
> PcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf |  33
> +++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpu
> PcieRpLib/CpuPcieRpLib.c                            |  48
> ++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCpu
> PcieRpLib/PeiDxeSmmCpuPcieRpLib.inf                 |  32
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuP
> cieRpLib/DxeCpuPcieRpLib.c                        |  62
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCpuP
> cieRpLib/DxeCpuPcieRpLib.inf                      |  40
> ++++++++++++++++++++++++++++++++++++++++
>  10 files changed, 1109 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.
> h
> new file mode 100644
> index 0000000000..15eeab0ecf
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/CpuPcieInfo.
> h
> @@ -0,0 +1,31 @@
> +/** @file
> 
> +  This file contains definitions of PCIe controller information
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PCIE_INFO_H_
> 
> +#define _CPU_PCIE_INFO_H_
> 
> +
> 
> +#define PCIE_HWEQ_COEFFS_MAX    5
> 
> +
> 
> +//
> 
> +// Device 1 Memory Mapped IO Register Offset Equates
> 
> +//
> 
> +#define SA_PEG_DEV_NUM     0x01
> 
> +#define SA_PEG0_DEV_NUM    SA_PEG_DEV_NUM
> 
> +#define SA_PEG3_DEV_NUM    0x06
> 
> +
> 
> +//
> 
> +// SA PCI Express* Port configuration
> 
> +//
> 
> +
> 
> +#define CPU_PCIE_MAX_ROOT_PORTS            4
> 
> +
> 
> +#define SA_PEG_MAX_FUN           0x04
> 
> +#define SA_PEG_MAX_LANE          0x14
> 
> +#define SA_PEG_MAX_FUN_GEN3      0x03
> 
> +#define SA_PEG_MAX_LANE_GEN3     0x10
> 
> +#define SA_PEG_MAX_BUNDLE_GEN3   0x08
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieInitCommon.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieInitCommon.h
> new file mode 100644
> index 0000000000..79b255c273
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieInitCommon.h
> @@ -0,0 +1,353 @@
> +/** @file
> 
> +Header file for CpuPcieInitCommonLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PCIE_INIT_COMMON_H_
> 
> +#define _CPU_PCIE_INIT_COMMON_H_
> 
> +
> 
> +#include <Library/CpuRegbarAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Print registers value
> 
> +
> 
> +  @param[in] PrintMmioBase       Mmio base address
> 
> +  @param[in] PrintSize           Number of registers
> 
> +  @param[in] OffsetFromBase      Offset from mmio base address
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +SaPrintRegisters (
> 
> +  IN  UINTN        PrintMmioBase,
> 
> +  IN  UINT32       PrintSize,
> 
> +  IN  UINT32       OffsetFromBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Print registers value
> 
> +
> 
> +  @param[in] PrintPciSegmentBase Pci segment base address
> 
> +  @param[in] PrintSize           Number of registers
> 
> +  @param[in] OffsetFromBase      Offset from mmio base address
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +SaPrintPciRegisters (
> 
> +  IN  UINT64       PrintPciSegmentBase,
> 
> +  IN  UINT32       PrintSize,
> 
> +  IN  UINT32       OffsetFromBase
> 
> +  );
> 
> +
> 
> +//
> 
> +// 2LM: PegPcie APIs for Sideband Access Mechanism in 2LM mode
> 
> +//
> 
> +/**
> 
> +Reads an 8-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentRead8
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +@return The 8-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentRead8 (
> 
> +  IN UINT64                    Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +Writes an 8-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentWrite8
> function.
> 
> +
> 
> +@param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  Value       The value to write.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentWrite8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +Reads a 16-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentRead16
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +@return The 16-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentRead16 (
> 
> +  IN UINT64                    Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +Writes a 16-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentWrite16
> function.
> 
> +
> 
> +@param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  Value       The value to write.
> 
> +
> 
> +@return The parameter of Value.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentWrite16  (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +Reads a 32-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentRead32
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +@return The 32-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentRead32 (
> 
> +  IN UINT64                    Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +Writes a 32-bit PCI configuration register.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentWrite32
> function.
> 
> +
> 
> +@param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  Value       The value to write.
> 
> +
> 
> +@return The parameter of Value.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentWrite32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise OR of a 16-bit PCI configuration register with a 16-bit
> value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentOr16 function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAnd32
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentAnd16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit
> value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAnd8 function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentAnd8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentOr32 function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise OR of a 8-bit PCI configuration register with a 8-bit value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentOr8 function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAnd32
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentAnd32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value,
> 
> +followed a  bitwise OR with another 32-bit value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAndThenOr32
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData,
> 
> +  IN UINT32                    OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value,
> 
> +followed a  bitwise OR with another 16-bit value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAndThenOr16
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData,
> 
> +  IN UINT16                    OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit
> value,
> 
> +followed a  bitwise OR with another 8-bit value.
> 
> +
> 
> +Its a wrapper library function. This function uses side band access for PEG60
> when 2LM mode is enabled.
> 
> +Other calls to this function will be routed to core PciSegmentAndThenOr8
> function.
> 
> +
> 
> +@param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +@param  AndData   The value to AND with the PCI configuration register.
> 
> +@param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +@return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData,
> 
> +  IN UINT8                     OrData
> 
> +  );
> 
> +
> 
> +/**
> 
> +Find the Offset to a Capabilities ID
> 
> +@param[in] Segment              Pci Segment Number
> 
> +@param[in] Bus                  Pci Bus Number
> 
> +@param[in] Device               Pci Device Number
> 
> +@param[in] Function             Pci Function Number
> 
> +@param[in] CapId                CAPID to search for
> 
> +
> 
> +@retval 0                       CAPID not found
> 
> +@retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PegPcieFindCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT8   CapId
> 
> +  );
> 
> +#endif // _CPU_PCIE_INIT_COMMON_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieRpLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieRpLib.h
> new file mode 100644
> index 0000000000..ebb568193a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Include/Library/CpuPc
> ieRpLib.h
> @@ -0,0 +1,47 @@
> +/** @file
> 
> +  Header file for CpuPcieRpLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _CPU_PCIERP_LIB_H_
> 
> +#define _CPU_PCIERP_LIB_H_
> 
> +
> 
> +#include <Ppi/SiPolicy.h>
> 
> +#include <Library/HobLib.h>
> 
> +
> 
> +#pragma pack(1)
> 
> +
> 
> +typedef struct {
> 
> +  UINT8   Segment;
> 
> +  UINT8   Bus;
> 
> +  UINT8   Device;
> 
> +  UINT8   Function;
> 
> +  BOOLEAN Enable;
> 
> +} CPU_PCIE_RP_INFO;
> 
> +
> 
> +#pragma pack()
> 
> +
> 
> +/**
> 
> +  Determines whether PCIe link is active
> 
> +
> 
> +  @param[in] RpBase    Root Port base address
> 
> +  @retval Link Active state
> 
> +**/
> 
> +BOOLEAN
> 
> +CpuPcieIsLinkActive (
> 
> +  UINT64  RpBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get max PCIe link speed supported by the root port.
> 
> +
> 
> +  @param[in] RpBase    Root Port pci segment base address
> 
> +  @return    Max link speed
> 
> +**/
> 
> +UINT32
> 
> +CpuPcieGetMaxLinkSpeed (
> 
> +  UINT64 RpBase
> 
> +  );
> 
> +
> 
> +#endif // _CPU_PCIERP_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library
> /DxeCpuPcieRpLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library
> /DxeCpuPcieRpLib.h
> new file mode 100644
> index 0000000000..593e1893bb
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/IncludePrivate/Library
> /DxeCpuPcieRpLib.h
> @@ -0,0 +1,18 @@
> +/** @file
> 
> +  Header file for private DxeCpuPcieRpLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_PCIE_RP_INIT_LIB_H_
> 
> +#define _DXE_PCIE_RP_INIT_LIB_H_
> 
> +
> 
> +/**
> 
> +  Update CPU PCIE RP NVS AREA tables
> 
> +
> 
> +**/
> 
> +VOID
> 
> +UpdateCpuPcieNVS (
> 
> +  VOID
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCp
> uPcieInitCommonLib/CpuPcieInitCommon.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieInitCommonLib/CpuPcieInitCommon.c
> new file mode 100644
> index 0000000000..28032e5b24
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieInitCommonLib/CpuPcieInitCommon.c
> @@ -0,0 +1,445 @@
> +/** @file
> 
> + common library for CPU PCIe INIT PEI/DXE/SMM modules
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/CpuPcieRpLib.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <Library/CpuPcieInitCommon.h>
> 
> +#include <Library/CpuRegbarAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Print registers value
> 
> +
> 
> +  @param[in] PrintMmioBase       Mmio base address
> 
> +  @param[in] PrintSize           Number of registers
> 
> +  @param[in] OffsetFromBase      Offset from mmio base address
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +SaPrintRegisters (
> 
> +  IN  UINTN        PrintMmioBase,
> 
> +  IN  UINT32       PrintSize,
> 
> +  IN  UINT32       OffsetFromBase
> 
> +  )
> 
> +{
> 
> +  UINT32  Offset;
> 
> +  DEBUG ((DEBUG_VERBOSE, "       00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D
> 0E 0F"));
> 
> +  for (Offset = 0; Offset < PrintSize; Offset++) {
> 
> +    if ((Offset % 16) == 0) {
> 
> +      DEBUG ((DEBUG_VERBOSE, "\n %04X: ", (Offset + OffsetFromBase) &
> 0xFFF0));
> 
> +    }
> 
> +    DEBUG ((DEBUG_VERBOSE, "%02X ", MmioRead8 (PrintMmioBase +
> Offset)));
> 
> +  }
> 
> +  DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Print registers value
> 
> +
> 
> +  @param[in] PrintPciSegmentBase Pci segment base address
> 
> +  @param[in] PrintSize           Number of registers
> 
> +  @param[in] OffsetFromBase      Offset from mmio base address
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +SaPrintPciRegisters (
> 
> +  IN  UINT64       PrintPciSegmentBase,
> 
> +  IN  UINT32       PrintSize,
> 
> +  IN  UINT32       OffsetFromBase
> 
> +  )
> 
> +{
> 
> +  UINT32  Offset;
> 
> +  DEBUG ((DEBUG_VERBOSE, "       00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D
> 0E 0F"));
> 
> +  for (Offset = 0; Offset < PrintSize; Offset++) {
> 
> +    if ((Offset % 16) == 0) {
> 
> +      DEBUG ((DEBUG_VERBOSE, "\n %04X: ", (Offset + OffsetFromBase) &
> 0xFFF0));
> 
> +    }
> 
> +    DEBUG ((DEBUG_VERBOSE, "%02X ", PciSegmentRead8
> (PrintPciSegmentBase + Offset)));
> 
> +  }
> 
> +  DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +}
> 
> +
> 
> +//
> 
> +// 2LM: PegPcie APIs using the Sideband Access Mechanism
> 
> +//
> 
> +/**
> 
> +  Reads an 8-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentRead8
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +  @return The 8-bit PCI configuration register specified by Address.
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentRead8 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  return PciSegmentRead8 (Address);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes an 8-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentWrite8
> function.
> 
> +
> 
> +  @param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentWrite8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (Address, Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a 16-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentRead16
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +  @return The 16-bit PCI configuration register specified by Address.
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentRead16 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  return PciSegmentRead16 (Address);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a 16-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentWrite16
> function.
> 
> +
> 
> +  @param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The parameter of Value.
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentWrite16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                     Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (Address, Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a 32-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentRead32
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +
> 
> +  @return The 32-bit PCI configuration register specified by Address.
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentRead32 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  return PciSegmentRead32 (Address);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a 32-bit PCI configuration register.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentWrite32
> function.
> 
> +
> 
> +  @param  Address     Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The parameter of Value.
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentWrite32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                     Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (Address, Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of a 16-bit PCI configuration register with a 16-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentOr16 function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentOr16 (Address, OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAnd32
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentAnd16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAnd16 (Address, AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAnd8
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentAnd8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAnd8 (Address, AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentOr32 function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentOr32 (Address, OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of a 8-bit PCI configuration register with a 8-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentOr8 function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentOr8 (Address, OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAnd32
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentAnd32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAnd32 (Address, AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value,
> 
> +  followed a  bitwise OR with another 32-bit value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAndThenOr32
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAndThenOr32 (Address, AndData, OrData);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value,
> 
> +  followed a  bitwise OR with another 16-bit value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAndThenOr16
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAndThenOr16 (Address, AndData, OrData);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 8-bit PCI configuration register with a 8-bit
> value,
> 
> +  followed a  bitwise OR with another 8-bit value.
> 
> +
> 
> +  Its a wrapper library function. This function uses side band access for
> PEG60 when 2LM mode is enabled.
> 
> +  Other calls to this function will be routed to core PciSegmentAndThenOr8
> function.
> 
> +
> 
> +  @param  Address   Address that encodes the PCI Segment, Bus, Device,
> Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PegPciSegmentAndThenOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentAndThenOr8 (Address, AndData, OrData);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Find the Offset to a Capabilities ID
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PegPcieFindCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT8   CapId
> 
> +  )
> 
> +{
> 
> +  return PcieFindCapId (Segment, Bus, Device, Function, CapId);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Search and return the offset of desired Pci Express extended Capability ID
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                Extended CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT16
> 
> +PegPcieFindExtendedCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT16  CapId
> 
> +  )
> 
> +{
> 
> +  return PcieFindExtendedCapId (Segment, Bus, Device, Function, CapId);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCp
> uPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
> new file mode 100644
> index 0000000000..2ad30ab7c9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.inf
> @@ -0,0 +1,33 @@
> +## @file
> 
> +#  Component description file for the CpuPcieInitCommonLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION                    = 0x00010017
> 
> +  BASE_NAME                      = PeiDxeSmmCpuPcieInitCommonLib
> 
> +  FILE_GUID                      = 68992CB0-A3A5-4f73-9370-93A3559F84C8
> 
> +  MODULE_TYPE                    = BASE
> 
> +  VERSION_STRING                 = 1.0
> 
> +  LIBRARY_CLASS                  = CpuPcieInitCommonLib
> 
> +
> 
> +[Sources]
> 
> +  CpuPcieInitCommon.c
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[LibraryClasses]
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PciSegmentLib
> 
> +  CpuPcieRpLib
> 
> +  CpuRegbarAccessLib
> 
> +  BasePcieHelperLib
> 
> +
> 
> +[Pcd]
> 
> +  gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                  ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCp
> uPcieRpLib/CpuPcieRpLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieRpLib/CpuPcieRpLib.c
> new file mode 100644
> index 0000000000..02cd482b55
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieRpLib/CpuPcieRpLib.c
> @@ -0,0 +1,48 @@
> +/** @file
> 
> +  CPU PCIe root port library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include "CpuPcieInfo.h"
> 
> +#include <Library/CpuPcieInitCommon.h>
> 
> +#include <Library/PciLib.h>
> 
> +#include <IndustryStandard/Pci22.h>
> 
> +
> 
> +/**
> 
> +  Determines whether PCIe link is active
> 
> +
> 
> +  @param[in] RpBase    Root Port base address
> 
> +  @retval Link Active state
> 
> +**/
> 
> +BOOLEAN
> 
> +CpuPcieIsLinkActive (
> 
> +  UINT64  RpBase
> 
> +  )
> 
> +{
> 
> +  return !! (PegPciSegmentRead16 (RpBase + R_PCIE_LSTS) &
> B_PCIE_LSTS_LA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get max PCIe link speed supported by the root port.
> 
> +
> 
> +  @param[in] RpBase    Root Port base address
> 
> +  @return    Max link speed
> 
> +**/
> 
> +UINT32
> 
> +CpuPcieGetMaxLinkSpeed (
> 
> +  UINT64 RpBase
> 
> +  )
> 
> +{
> 
> +  return PegPciSegmentRead32 (RpBase + R_PCIE_LCAP) &
> B_PCIE_LCAP_MLS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmCp
> uPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
> new file mode 100644
> index 0000000000..cea8bcbecd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/Library/PeiDxeSmmC
> puPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
> @@ -0,0 +1,32 @@
> +## @file
> 
> +# CPU PCIE root port Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmCpuPcieRpLib
> 
> +FILE_GUID = 00199A03-41F4-43c7-B6D5-5A3AA1EE78D0
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = CpuPcieRpLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +CpuPcieRpLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.c
> new file mode 100644
> index 0000000000..48ef8165de
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.c
> @@ -0,0 +1,62 @@
> +/** @file
> 
> +  The DXE CPU PCIE RP Library Implements After Memory PEIM
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Ppi/SiPolicy.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <IndustryStandard/Pci22.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Protocol/SaNvsArea.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <Library/PciExpressHelpersLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <ConfigBlock/PcieDxeConfig.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +/**
> 
> +Update CPU PCIE RP NVS AREA tables
> 
> +
> 
> +**/
> 
> +VOID
> 
> +UpdateCpuPcieNVS (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                       Status;
> 
> +  PCIE_DXE_CONFIG                  *PcieDxeConfig;
> 
> +  SA_POLICY_PROTOCOL               *SaPolicy;
> 
> +  SYSTEM_AGENT_NVS_AREA_PROTOCOL   *SaNvsAreaProtocol;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Update Cpu Pcie NVS Area.\n"));
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **)
> &SaPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *)SaPolicy, &gPcieDxeConfigGuid, (VOID
> *)&PcieDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gSaNvsAreaProtocolGuid, NULL, (VOID **)
> &SaNvsAreaProtocol);
> 
> +  if (Status != EFI_SUCCESS) {
> 
> +    DEBUG ((DEBUG_ERROR, "Locate SA NVS Area failed.\n"));
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  SaNvsAreaProtocol->Area->Peg0LtrEnable  = PcieDxeConfig-
> >PegPwrOpt[0].LtrEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg0ObffEnable = PcieDxeConfig-
> >PegPwrOpt[0].ObffEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg1LtrEnable  = PcieDxeConfig-
> >PegPwrOpt[1].LtrEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg1ObffEnable = PcieDxeConfig-
> >PegPwrOpt[1].ObffEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg2LtrEnable  = PcieDxeConfig-
> >PegPwrOpt[2].LtrEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg2ObffEnable = PcieDxeConfig-
> >PegPwrOpt[2].ObffEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg3LtrEnable  = PcieDxeConfig-
> >PegPwrOpt[3].LtrEnable;
> 
> +  SaNvsAreaProtocol->Area->Peg3ObffEnable = PcieDxeConfig-
> >PegPwrOpt[3].ObffEnable;
> 
> +  SaNvsAreaProtocol->Area->PegLtrMaxSnoopLatency =
> V_SA_LTR_MAX_SNOOP_LATENCY_VALUE;
> 
> +  SaNvsAreaProtocol->Area->PegLtrMaxNoSnoopLatency =
> V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.inf
> new file mode 100644
> index 0000000000..dc9b893be3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/CpuPcieRp/LibraryPrivate/DxeCp
> uPcieRpLib/DxeCpuPcieRpLib.inf
> @@ -0,0 +1,40 @@
> +## @file
> 
> +#   The DXE CPU PCIE RP Library Implements After Memory PEIM
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeCpuPcieRpLib
> 
> +FILE_GUID = D563A22E-6A01-4EF7-84D1-78B6717E3402
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +UEFI_SPECIFICATION_VERSION = 2.00
> 
> +LIBRARY_CLASS = DxeCpuPcieRpLib
> 
> +
> 
> +[LibraryClasses]
> 
> +IoLib
> 
> +BaseLib
> 
> +DebugLib
> 
> +BaseMemoryLib
> 
> +UefiBootServicesTableLib
> 
> +UefiLib
> 
> +HobLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeCpuPcieRpLib.c
> 
> +
> 
> +[Guids]
> 
> +gPcieDxeConfigGuid
> 
> +
> 
> +[Protocols]
> 
> +gSaPolicyProtocolGuid                  ## CONSUMES
> 
> +gSaNvsAreaProtocolGuid                 ## CONSUMES
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component
  2021-02-01  1:36 ` [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Espi/Library
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/Esp
> iLib.c            | 469
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/Pei
> DxeSmmEspiLib.inf |  38 ++++++++++++++++++++++++++++++++++++++
>  2 files changed, 507 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/E
> spiLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/E
> spiLib.c
> new file mode 100644
> index 0000000000..2d1928ce18
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/E
> spiLib.c
> @@ -0,0 +1,469 @@
> +/** @file
> 
> +  This file contains routines for eSPI
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/EspiLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/TimerLib.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +
> 
> +#define CHANNEL_RESET_TIMEOUT     100   ///< Channel reset timeout in us
> after which to report error
> 
> +#define SLAVE_CHANNELS_MAX        7     ///< Max number of channels
> 
> +
> 
> +//
> 
> +// eSPI Slave registers
> 
> +//
> 
> +#define R_ESPI_SLAVE_GENCAP               0x08      ///< General Capabilities
> and Configurations
> 
> +#define B_ESPI_SLAVE_GENCAP_SUPPCHAN      0xFF      ///< Channels
> supported bit mask
> 
> +#define R_ESPI_SLAVE_CHACAP_BASE          0x10      ///< Base address from
> which channel Cap and Conf registers start on slave
> 
> +#define S_ESPI_SLAVE_CHACAP_OFFSET        0x10      ///< Offset for each
> channel from base
> 
> +#define B_ESPI_SLAVE_CHACAP_CHEN          BIT0      ///< Slave Channel
> enable bit
> 
> +#define B_ESPI_SLAVE_CHACAP_CHRDY         BIT1      ///< Slave Channel
> ready bit
> 
> +
> 
> +/**
> 
> +  Checks if second slave capability is enabled
> 
> +
> 
> +  @retval TRUE      There's second slave
> 
> +  @retval FALSE     There's no second slave
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiSecondSlaveSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks in slave General Capabilities register if it supports channel with
> requested number
> 
> +
> 
> +  @param[in]  SlaveId         Id of slave to check
> 
> +  @param[in]  ChannelNumber   Number of channel of which to check
> 
> +
> 
> +  @retval TRUE      Channel with requested number is supported by slave
> device
> 
> +  @retval FALSE     Channel with requested number is not supported by slave
> device
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiSlaveChannelSupported (
> 
> +  UINT8   SlaveId,
> 
> +  UINT8   ChannelNumber
> 
> +  )
> 
> +{
> 
> +  UINT32  Data32;
> 
> +  UINT8   SupportedChannels;
> 
> +
> 
> +  PchEspiSlaveGetConfig (SlaveId, R_ESPI_SLAVE_GENCAP, &Data32);
> 
> +  SupportedChannels = (UINT8) (Data32 &
> B_ESPI_SLAVE_GENCAP_SUPPCHAN);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Slave %d supported channels 0x%4X\n", SlaveId,
> SupportedChannels));
> 
> +
> 
> +  if (ChannelNumber > SLAVE_CHANNELS_MAX || !(SupportedChannels &
> (BIT0 << ChannelNumber))) {
> 
> +    // Incorrect channel number was specified. Either exceeded max or Slave
> doesn't support that channel.
> 
> +    return FALSE;
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Is eSPI enabled in strap.
> 
> +
> 
> +  @retval TRUE          Espi is enabled in strap
> 
> +  @retval FALSE         Espi is disabled in strap
> 
> +**/
> 
> +BOOLEAN
> 
> +IsEspiEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return (PchPcrRead32 (PID_ESPISPI, R_ESPI_PCR_CFG_VAL) &
> B_ESPI_PCR_CFG_VAL_ESPI_EN) != 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI helper function to clear slave configuration register status
> 
> +
> 
> +  @retval EFI_SUCCESS Write to private config space succeed
> 
> +  @retval others      Read / Write failed
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EspiClearScrs (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  PchPcrAndThenOr32 (
> 
> +    PID_ESPISPI,
> 
> +    R_ESPI_PCR_SLV_CFG_REG_CTL,
> 
> +    (UINT32) ~0,
> 
> +     B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS
> 
> +     );
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI helper function to poll slave configuration register enable for 0
> 
> +  and to check for slave configuration register status
> 
> +
> 
> +  @retval EFI_SUCCESS       Enable bit is zero and no error in status bits
> 
> +  @retval EFI_DEVICE_ERROR  Error in SCRS
> 
> +  @retval others            Read / Write to private config space failed
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +EspiPollScreAndCheckScrs (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32     ScrStat;
> 
> +
> 
> +  do {
> 
> +    ScrStat = PchPcrRead32 (PID_ESPISPI, R_ESPI_PCR_SLV_CFG_REG_CTL);
> 
> +  } while ((ScrStat & B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE) != 0);
> 
> +
> 
> +  ScrStat = (ScrStat & B_ESPI_PCR_SLV_CFG_REG_CTL_SCRS) >>
> N_ESPI_PCR_SLV_CFG_REG_CTL_SCRS;
> 
> +  if (ScrStat != V_ESPI_PCR_SLV_CFG_REG_CTL_SCRS_NOERR) {
> 
> +    DEBUG ((DEBUG_ERROR, "eSPI slave config register status (error) is %x
> \n", ScrStat));
> 
> +    return EFI_DEVICE_ERROR;
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +typedef enum {
> 
> +  EspiSlaveOperationConfigRead,
> 
> +  EspiSlaveOperationConfigWrite,
> 
> +  EspiSlaveOperationStatusRead,
> 
> +  EspiSlaveOperationInBandReset
> 
> +} ESPI_SLAVE_OPERATION;
> 
> +
> 
> +/**
> 
> +  Helper library to do all the operations regards to eSPI slave
> 
> +
> 
> +  @param[in]      SlaveId         eSPI Slave ID
> 
> +  @param[in]      SlaveAddress    Slave address to be put in
> R_ESPI_PCR_SLV_CFG_REG_CTL[11:0]
> 
> +  @param[in]      SlaveOperation  Based on ESPI_SLAVE_OPERATION
> 
> +  @param[in,out]  Data
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PCH_LP
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address
> exceed maximum allowed
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address is
> not DWord aligned
> 
> +  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to
> 0x7FF has been locked
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +EspiSlaveOperationHelper (
> 
> +  IN     UINT32               SlaveId,
> 
> +  IN     UINT32               SlaveAddress,
> 
> +  IN     ESPI_SLAVE_OPERATION SlaveOperation,
> 
> +  IN OUT UINT32               *Data
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT32      Data32;
> 
> +
> 
> +  //
> 
> +  // Check the SlaveId is 0 or 1
> 
> +  //
> 
> +  if (SlaveId >= PCH_MAX_ESPI_SLAVES) {
> 
> +    DEBUG ((DEBUG_ERROR, "eSPI Slave ID of %d or more is not accepted
> \n", PCH_MAX_ESPI_SLAVES));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Check if SlaveId 1 is used, it is not a PCH_LP
> 
> +  //
> 
> +  if (SlaveId == 1) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Check the address is not more then 0xFFF
> 
> +  //
> 
> +  if (SlaveAddress > B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA) {
> 
> +    DEBUG ((DEBUG_ERROR, "eSPI Slave address must be less than 0x%x \n",
> (B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA + 1)));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Check the address is DWord aligned
> 
> +  //
> 
> +  if ((SlaveAddress & 0x3) != 0) {
> 
> +    DEBUG ((DEBUG_ERROR, "eSPI Slave address must be DWord aligned
> \n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if write is allowed
> 
> +  //
> 
> +  if ((SlaveOperation == EspiSlaveOperationConfigWrite) &&
> 
> +      (SlaveAddress <= 0x7FF)) {
> 
> +
> 
> +    //
> 
> +    // If the SLCRR is not set in corresponding slave, we will check the lock bit
> 
> +    //
> 
> +    Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16)
> (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_LNKERR_SLV0)));
> 
> +    if ((Data32 & B_ESPI_PCR_LNKERR_SLV0_SLCRR) == 0) {
> 
> +
> 
> +      Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16)
> R_ESPI_PCR_SLV_CFG_REG_CTL);
> 
> +      if ((Data32 & B_ESPI_PCR_SLV_CFG_REG_CTL_SBLCL) != 0) {
> 
> +        DEBUG ((DEBUG_ERROR, "eSPI Slave write to address range 0 to 0x7FF
> has been locked \n"));
> 
> +        return EFI_ACCESS_DENIED;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Input check done, now go through all the processes
> 
> +  //
> 
> +   EspiClearScrs ();
> 
> +
> 
> +  if (SlaveOperation == EspiSlaveOperationConfigWrite) {
> 
> +    PchPcrWrite32 (
> 
> +      PID_ESPISPI,
> 
> +      (UINT16) R_ESPI_PCR_SLV_CFG_REG_DATA,
> 
> +      *Data
> 
> +      );
> 
> +  }
> 
> +
> 
> +  PchPcrAndThenOr32 (
> 
> +    PID_ESPISPI,
> 
> +    (UINT16) R_ESPI_PCR_SLV_CFG_REG_CTL,
> 
> +    (UINT32) ~(B_ESPI_PCR_SLV_CFG_REG_CTL_SID |
> B_ESPI_PCR_SLV_CFG_REG_CTL_SCRT |
> B_ESPI_PCR_SLV_CFG_REG_CTL_SCRA),
> 
> +    (B_ESPI_PCR_SLV_CFG_REG_CTL_SCRE |
> 
> +     (SlaveId << N_ESPI_PCR_SLV_CFG_REG_CTL_SID) |
> 
> +     (((UINT32) SlaveOperation) << N_ESPI_PCR_SLV_CFG_REG_CTL_SCRT) |
> 
> +     SlaveAddress
> 
> +     )
> 
> +    );
> 
> +
> 
> +  Status = EspiPollScreAndCheckScrs ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  if ((SlaveOperation == EspiSlaveOperationConfigRead) || (SlaveOperation
> == EspiSlaveOperationStatusRead)) {
> 
> +    Data32 = PchPcrRead32 (
> 
> +               PID_ESPISPI,
> 
> +               (UINT16) R_ESPI_PCR_SLV_CFG_REG_DATA
> 
> +               );
> 
> +    if (SlaveOperation == EspiSlaveOperationStatusRead) {
> 
> +      *Data = Data32 & 0xFFFF;
> 
> +    } else {
> 
> +      *Data = Data32;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get configuration from eSPI slave
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[in]  SlaveAddress  Slave Configuration Register Address
> 
> +  @param[out] OutData       Configuration data read
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PCH_LP
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address
> exceed maximum allowed
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address is
> not DWord aligned
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveGetConfig (
> 
> +  IN  UINT32 SlaveId,
> 
> +  IN  UINT32 SlaveAddress,
> 
> +  OUT UINT32 *OutData
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // 1. Clear status from previous transaction by writing 111b to status in
> SCRS, PCR[eSPI] + 4000h [30:28]
> 
> +  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit
> [20:19]=<SlvID>, Bit [17:16] = 00b, Bit[11:0] = <addr_xxx>.
> 
> +  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
> 
> +  // 4. Check the transaction status in SCRS (bits [30:28])
> 
> +  // 5. Read SLV_CFG_REG_DATA.
> 
> +  //
> 
> +  return EspiSlaveOperationHelper (SlaveId, SlaveAddress,
> EspiSlaveOperationConfigRead, OutData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set eSPI slave configuration
> 
> +
> 
> +  Note: A Set_Configuration must always be followed by a
> Get_Configuration in order to ensure
> 
> +  that the internal state of the eSPI-MC is consistent with the Slave's register
> settings.
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[in]  SlaveAddress  Slave Configuration Register Address
> 
> +  @param[in]  InData        Configuration data to write
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PCH_LP
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address
> exceed maximum allowed
> 
> +  @retval EFI_INVALID_PARAMETER Slave configuration register address is
> not DWord aligned
> 
> +  @retval EFI_ACCESS_DENIED     eSPI Slave write to address range 0 to
> 0x7FF has been locked
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveSetConfig (
> 
> +  IN  UINT32 SlaveId,
> 
> +  IN  UINT32 SlaveAddress,
> 
> +  IN  UINT32 InData
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT32      Data32;
> 
> +
> 
> +  //
> 
> +  // 1. Clear status from previous transaction by writing 111b to status in
> SCRS, PCR[eSPI] + 4000h [30:28]
> 
> +  // 2. Program SLV_CFG_REG_DATA with the write value.
> 
> +  // 3. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit
> [20:19]=<SlvID>, Bit [17:16] = 01b, Bit[11:0] = <addr_xxx>.
> 
> +  // 4. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
> 
> +  // 5. Check the transaction status in SCRS (bits [30:28])
> 
> +  //
> 
> +  Status = EspiSlaveOperationHelper (SlaveId, SlaveAddress,
> EspiSlaveOperationConfigWrite, &InData);
> 
> +  PchEspiSlaveGetConfig (SlaveId, SlaveAddress, &Data32);
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get status from eSPI slave
> 
> +
> 
> +  @param[in]  SlaveId       eSPI slave ID
> 
> +  @param[out] OutData       Configuration data read
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PCH_LP
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveGetStatus (
> 
> +  IN  UINT32 SlaveId,
> 
> +  OUT UINT16 *OutData
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT32      TempOutData;
> 
> +
> 
> +  TempOutData = 0;
> 
> +
> 
> +  //
> 
> +  // 1. Clear status from previous transaction by writing 111b to status in
> SCRS, PCR[eSPI] + 4000h [30:28]
> 
> +  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit
> [20:19]=<SlvID>, Bit [17:16] = 10b, Bit[11:0] = <addr_xxx>.
> 
> +  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
> 
> +  // 4. Check the transaction status in SCRS (bits [30:28])
> 
> +  // 5. Read SLV_CFG_REG_DATA [15:0].
> 
> +  //
> 
> +  Status = EspiSlaveOperationHelper (SlaveId, 0,
> EspiSlaveOperationStatusRead, &TempOutData);
> 
> +  *OutData = (UINT16) TempOutData;
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI slave in-band reset
> 
> +
> 
> +  @param[in]  SlaveId           eSPI slave ID
> 
> +
> 
> +  @retval EFI_SUCCESS           Operation succeed
> 
> +  @retval EFI_INVALID_PARAMETER Slave ID is not supported or SlaveId 1 is
> used in PCH_LP
> 
> +  @retval EFI_DEVICE_ERROR      Error in SCRS during polling stage of
> operation
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveInBandReset (
> 
> +  IN  UINT32 SlaveId
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // 1. Clear status from previous transaction by writing 111b to status in
> SCRS, PCR[eSPI] + 4000h [30:28]
> 
> +  // 2. Program SLV_CFG_REG_CTL with the right value (Bit[31]=01, Bit
> [20:19]=<SlvID>, Bit [17:16] = 11b).
> 
> +  // 3. Poll the SCRE (PCR[eSPI] +4000h [31]) to be set back to 0
> 
> +  // 4. Check the transaction status in SCRS (bits [30:28])
> 
> +  //
> 
> +  return EspiSlaveOperationHelper (SlaveId, 0,
> EspiSlaveOperationInBandReset, NULL);
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI Slave channel reset helper function
> 
> +
> 
> +  @param[in]  SlaveId           eSPI slave ID
> 
> +  @param[in]  ChannelNumber     Number of channel to reset
> 
> +
> 
> +  @retval     EFI_SUCCESS       Operation succeeded
> 
> +  @retval     EFI_UNSUPPORTED   Slave doesn't support that channel or
> invalid number specified
> 
> +  @retval     EFI_TIMEOUT       Operation has timeouted
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiSlaveChannelReset (
> 
> +  IN  UINT8   SlaveId,
> 
> +  IN  UINT8   ChannelNumber
> 
> +  )
> 
> +{
> 
> +  UINT8       Timeout;
> 
> +  UINT32      Data32;
> 
> +  UINT32      SlaveChannelAddress;
> 
> +  BOOLEAN     SlaveBmeSet;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "eSPI slave %d channel %d reset\n", SlaveId,
> ChannelNumber));
> 
> +
> 
> +  Timeout = CHANNEL_RESET_TIMEOUT;
> 
> +  SlaveBmeSet = FALSE;
> 
> +
> 
> +  if (!IsEspiSlaveChannelSupported (SlaveId, ChannelNumber)) {
> 
> +    // Incorrect channel number was specified. Either exceeded max or Slave
> doesn't support that channel.
> 
> +    DEBUG ((DEBUG_ERROR, "Channel %d is not valid channel number for
> slave %d!\n", ChannelNumber, SlaveId));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  // Calculating slave channel address
> 
> +  SlaveChannelAddress = R_ESPI_SLAVE_CHACAP_BASE +
> (S_ESPI_SLAVE_CHACAP_OFFSET * ChannelNumber);
> 
> +
> 
> +  // If we're resetting Peripheral Channel then we need to disable Bus
> Mastering first and reenable after reset
> 
> +  if (ChannelNumber == 0) {
> 
> +    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
> 
> +    if ((Data32 & B_ESPI_SLAVE_BME) != 0) {
> 
> +      Data32 &= ~(B_ESPI_SLAVE_BME);
> 
> +      PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
> 
> +      SlaveBmeSet = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  // Disable channel
> 
> +  PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
> 
> +  Data32 &= ~(B_ESPI_SLAVE_CHACAP_CHEN);
> 
> +  PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
> 
> +
> 
> +  // Enable channel
> 
> +  PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
> 
> +  Data32 |= B_ESPI_SLAVE_CHACAP_CHEN;
> 
> +  PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Waiting for Channel Ready bit\n"));
> 
> +  // Wait until channel is ready by polling Channel Ready bit
> 
> +  while (((Data32 & B_ESPI_SLAVE_CHACAP_CHRDY) == 0) && (Timeout >
> 0)) {
> 
> +    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
> 
> +    MicroSecondDelay (1);
> 
> +    --Timeout;
> 
> +  }
> 
> +
> 
> +  if (Timeout == 0) {
> 
> +    // The waiting for channel to be ready has timed out
> 
> +    DEBUG ((DEBUG_ERROR, "The operation of channel %d reset for slave %d
> has timed out!\n", ChannelNumber, SlaveId));
> 
> +    return EFI_TIMEOUT;
> 
> +  }
> 
> +
> 
> +  if (ChannelNumber == 0 && SlaveBmeSet) {
> 
> +    PchEspiSlaveGetConfig (SlaveId, SlaveChannelAddress, &Data32);
> 
> +    Data32 |= B_ESPI_SLAVE_BME;
> 
> +    PchEspiSlaveSetConfig (SlaveId, SlaveChannelAddress, Data32);
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/P
> eiDxeSmmEspiLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/P
> eiDxeSmmEspiLib.inf
> new file mode 100644
> index 0000000000..440051432f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Espi/Library/PeiDxeSmmEspiLib/P
> eiDxeSmmEspiLib.inf
> @@ -0,0 +1,38 @@
> +## @file
> 
> +# Component description file for the PeiDxeSmmPchEspiLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmEspiLib
> 
> +FILE_GUID = 7F25F990-7989-4413-B414-1EDE557E9389
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = EspiLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PchPcrLib
> 
> +TimerLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +EspiLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component
  2021-02-01  1:36 ` [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Gbe/IncludePrivate
>   * IpBlock/Gbe/Library
>   * IpBlock/Gbe/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/GbeMd
> iLib.h                       | 324
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/GbeR
> egs.h                        |  68
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/Gb
> eLib.c                         | 121
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/Pei
> DxeSmmGbeLib.inf              |  43
> +++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGb
> eMdiLib/GbeMdiLib.c            | 388
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmGb
> eMdiLib/PeiDxeSmmGbeMdiLib.inf |  34
> ++++++++++++++++++++++++++++++++++
>  6 files changed, 978 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/Gbe
> MdiLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/Gbe
> MdiLib.h
> new file mode 100644
> index 0000000000..b8274ed3dc
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Library/Gbe
> MdiLib.h
> @@ -0,0 +1,324 @@
> +/** @file
> 
> +  Header file for GbeMdiLib.
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Prefixes:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register sizes
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - In general, PCH registers are denoted by "_PCH_" in register names
> 
> +  - Registers / bits that are different between PCH generations are denoted
> by
> 
> +    "_PCH_[generation_name]_" in register/bit names.
> 
> +  - Registers / bits that are specific to PCH-H denoted by "_H_" in register/bit
> names.
> 
> +    Registers / bits that are specific to PCH-LP denoted by "_LP_" in
> register/bit names.
> 
> +    e.g., "_PCH_LP_"
> 
> +    Registers / bits names without or _LP_ apply for LP.
> 
> +  - Registers / bits that are different between SKUs are denoted by
> "_[SKU_name]"
> 
> +    at the end of the register/bit names
> 
> +  - Registers / bits of new devices introduced in a PCH generation will be just
> named
> 
> +    as "_PCH_" without [generation_name] inserted.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GBE_MDI_LIB_H_
> 
> +#define _GBE_MDI_LIB_H_
> 
> +
> 
> +//
> 
> +// Maximum loop time for GbE status check
> 
> +// 4000 * 50 = 200 mSec in total
> 
> +//
> 
> +#define GBE_MAX_LOOP_TIME       4000
> 
> +#define GBE_ACQUIRE_MDIO_DELAY  50
> 
> +#define GBE_MDI_SET_PAGE_DELAY  4000 // 4 mSec delay after setting
> page
> 
> +
> 
> +//
> 
> +// LAN PHY MDI settings
> 
> +//
> 
> +// MDI Control Register Bits
> 
> +// 31:30 Reserved
> 
> +//       This field is reserved and returns 0.
> 
> +// 29    Interrupt Enable.
> 
> +//       When this bit is set to 1 by software, it causes the device to assert
> 
> +//       an interrupt indicating the end of an MDI cycle.
> 
> +// 28    Ready.
> 
> +//       Set to 1 by the device at the end of MDI transaction (i.e., indicates a
> Read or
> 
> +//       Write has been completed. It should be reset to 0 by software at the
> same time the
> 
> +//       command is written.
> 
> +// 27:26 Opcode
> 
> +//       For an MDI write, the opcode equals 01b, and for MDI read, 10b. 00b
> and
> 
> +//       11b are reserved and should not be used.
> 
> +// 25:21 PHYAdd
> 
> +//       PHY Address
> 
> +// 20:16 RegAdd
> 
> +//       PHY Register Address
> 
> +// 15:0  Data
> 
> +
> 
> +#define B_PHY_MDI_READY                BIT28
> 
> +#define B_PHY_MDI_READ                 BIT27
> 
> +#define B_PHY_MDI_WRITE                BIT26
> 
> +//
> 
> +//      PHY SPECIFIC registers
> 
> +//
> 
> +#define B_PHY_MDI_PHY_ADDRESS_02       BIT22
> 
> +//
> 
> +//      PHY GENERAL registers
> 
> +//      Registers 0 to 15 are defined by the specification
> 
> +//      Registers 16 to 31 are left available to the vendor
> 
> +//
> 
> +#define B_PHY_MDI_PHY_ADDRESS_01       BIT21
> 
> +#define B_PHY_MDI_PHY_ADDRESS_MASK    (BIT25 | BIT24 | BIT23 | BIT22
> | BIT21)
> 
> +//
> 
> +//  PHY Identifier Register 2
> 
> +//  Bits [15:10] - PHY ID Number   - The PHY identifier composed of bits 3
> through 18
> 
> +//                                   of the Organizationally Unique Identifier (OUI)
> 
> +//  Bits [9:4]   - Device Model Number
> 
> +//  Bits [3:0]   - Device Revision Number
> 
> +//
> 
> +#define R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2
> 0x00030000
> 
> +
> 
> +#define MDI_REG_SHIFT(x)                              (x << 16)
> 
> +#define B_PHY_MDI_PHY_REGISTER_MASK                   (BIT20 | BIT19 | BIT18
> | BIT17 | BIT16)
> 
> +#define R_PHY_MDI_PHY_REG_SET_ADDRESS                 0x00110000 // Used
> after new page setting
> 
> +#define R_PHY_MDI_PHY_REG_DATA_READ_WRITE             0x00120000
> 
> +#define R_PHY_MDI_PHY_REG_SET_PAGE                    0x001F0000
> 
> +
> 
> +//
> 
> +// LAN PHY MDI registers and bits
> 
> +//
> 
> +
> 
> +//
> 
> +// Page 769 Port Control Registers
> 
> +// 6020h (769 * 32)
> 
> +//
> 
> +#define PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS        769
> 
> +//
> 
> +// Custom Mode Control PHY Address 01, Page 769, Register 16
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_769_REGISETER_16_CMC            0x0010
> 
> +//
> 
> +// Custom Mode Control
> 
> +// Page 769, Register 16, BIT 10
> 
> +// 0 - normal MDIO frequency access
> 
> +// 1 - reduced MDIO frequency access (slow mdio)
> 
> +//     required for read during cable disconnect
> 
> +//
> 
> +#define
> B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS
> BIT10
> 
> +//
> 
> +//  Port General Configuration PHY Address 01, Page 769, Register 17
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_769_REGISETER_17_PGC            0x0011
> 
> +//
> 
> +// Page 769, Register 17, BIT 4
> 
> +// Enables host wake up
> 
> +//
> 
> +#define B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP
> BIT4
> 
> +//
> 
> +// Page 769, Register 17, BIT 2
> 
> +// Globally enable the MAC power down feature while the
> 
> +// GbE supports WoL. When set to 1b,
> 
> +// pages 800 and 801 are enabled for
> 
> +// configuration and Host_WU_Active is not blocked for writes.
> 
> +//
> 
> +#define B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE
> BIT2
> 
> +
> 
> +//
> 
> +// Page 800 Wake Up Registers
> 
> +// 6400h (800 * 32)
> 
> +//
> 
> +#define PHY_MDI_PAGE_800_WAKE_UP_REGISTERS             800
> 
> +//
> 
> +// Wake Up Control - WUC PHY Address 01, Page 800, Register 1
> 
> +// 1h (Register 1)
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_800_REGISETER_1_WUC             0x0001
> 
> +//
> 
> +// Wake Up Control - (WUC)
> 
> +// Page 800, Register 1, BIT 0
> 
> +// Advance Power Management Enable (APME)
> 
> +// If set to 1b, APM wake up is enabled.
> 
> +//
> 
> +#define B_PHY_MDI_PAGE_800_REGISETER_1_WUC_APME                     BIT0
> 
> +//
> 
> +// Receive Address Low - RAL PHY Address 01, Page 800, Register 16
> 
> +// 10h (Register 16)
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_800_REGISETER_16_RAL0           0x0010
> 
> +//
> 
> +// Receive Address Low - RAL PHY Address 01, Page 800, Register 17
> 
> +// 11h (Register 17)
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_800_REGISETER_17_RAL1           0x0011
> 
> +//
> 
> +// Receive Address High - RAH PHY Address 01, Page 800, Register 18
> 
> +// 12h (Register 18)
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_800_REGISETER_18_RAH0           0x0012
> 
> +//
> 
> +// Receive Address High - RAH PHY Address 01, Page 800, Register 19
> 
> +// 13h (Register 19)
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_800_REGISETER_19_RAH1           0x0013
> 
> +//
> 
> +// Setting AV (BIT15 RAH is divided on two registers)
> 
> +// RAH Register 19, Page 800, BIT 31
> 
> +//
> 
> +// Address valid (AV)
> 
> +// When this bit is set, the relevant RAL and RAH are valid
> 
> +//
> 
> +#define B_PHY_MDI_PAGE_800_REGISETER_19_RAH1_ADDRESS_VALID
> BIT15
> 
> +//
> 
> +// Page 803 Host WoL Packet
> 
> +// 6460h (803 * 32)
> 
> +//
> 
> +#define PHY_MDI_PAGE_803_HOST_WOL_PACKET               803
> 
> +//
> 
> +// Host WoL Packet Clear - HWPC PHY Address 01, Page 803, Register 66
> 
> +//
> 
> +#define R_PHY_MDI_PAGE_803_REGISETER_66_HWPC           0x0042
> 
> +
> 
> +
> 
> +/**
> 
> +  Change Extended Device Control Register BIT 11 to 1 which
> 
> +  forces the interface between the MAC and the Phy to be on SMBus.
> 
> +  Cleared on the assertion of PCI reset.
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +
> 
> +**/
> 
> +VOID
> 
> +GbeMdiForceMACtoSMB (
> 
> +  IN      UINT32  GbeBar
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Test for MDIO operation complete.
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +  @retval EFI_TIMEOUT
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiWaitReady (
> 
> +  IN      UINT32  GbeBar
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Acquire MDIO software semaphore.
> 
> +
> 
> +  1. Ensure that MBARA offset F00h [5] = 1b
> 
> +  2. Poll MBARA offset F00h [5] up to 200ms
> 
> +
> 
> +  @param [in] GbeBar   GbE MMIO space
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +  @retval EFI_TIMEOUT
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiAcquireMdio (
> 
> +  IN      UINT32  GbeBar
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Release MDIO software semaphore by clearing MBARA offset F00h [5]
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +**/
> 
> +VOID
> 
> +GbeMdiReleaseMdio (
> 
> +  IN      UINT32  GbeBar
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets page on MDI
> 
> +  Page setting is attempted twice.
> 
> +  If first attempt failes MAC and the Phy are force to be on SMBus
> 
> +
> 
> +  @param [in]  GbeBar  GbE MMIO space
> 
> +  @param [in]  Data    Value to write in lower 16bits.
> 
> +
> 
> +  @retval EFI_SUCCESS       Page setting was successfull
> 
> +  @retval EFI_DEVICE_ERROR  Returned if both attermps of setting page
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiSetPage (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  Page
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets Register in current page.
> 
> +
> 
> +  @param [in]  GbeBar      GbE MMIO space
> 
> +  @param [in]  register    Register number
> 
> +
> 
> +  @return EFI_STATUS
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiSetRegister (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  Register
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Perform MDI read.
> 
> +
> 
> +  @param [in]  GbeBar       GbE MMIO space
> 
> +  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
> 
> +  @param [in]  PhyRegister  Phy Register
> 
> +  @param [out] ReadData     Return Value
> 
> +
> 
> +  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiRead (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  PhyAddress,
> 
> +  IN      UINT32  PhyRegister,
> 
> +  OUT     UINT16  *ReadData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Perform MDI write.
> 
> +
> 
> +  @param [in]  GbeBar       GbE MMIO space
> 
> +  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
> 
> +  @param [in]  PhyRegister  Phy Register
> 
> +  @param [in]  WriteData    Value to write in lower 16bits.
> 
> +
> 
> +  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiWrite (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  PhyAddress,
> 
> +  IN      UINT32  PhyRegister,
> 
> +  IN      UINT32  WriteData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Phy Revision and Model Number
> 
> +  from PHY IDENTIFIER register 2 (offset 3)
> 
> +
> 
> +  @param [in]  GbeBar           GbE MMIO space
> 
> +  @param [out] LanPhyRevision   Return Value
> 
> +
> 
> +  @return EFI_STATUS
> 
> +  @return EFI_INVALID_PARAMETER When GbeBar is incorrect
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiGetLanPhyRevision (
> 
> +  IN      UINT32  GbeBar,
> 
> +  OUT     UINT16  *LanPhyRevision
> 
> +  );
> 
> +
> 
> +#endif // _GBE_MDI_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/Gbe
> Regs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/Gb
> eRegs.h
> new file mode 100644
> index 0000000000..307f1e159e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/IncludePrivate/Register/Gb
> eRegs.h
> @@ -0,0 +1,68 @@
> +/** @file
> 
> +  Register names for GbE device
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GBE_REGS_H_
> 
> +#define _GBE_REGS_H_
> 
> +
> 
> +#define R_GBE_CFG_MBARA               0x10
> 
> +#define N_GBE_CFG_MBARA_ALIGN         17
> 
> +#define R_GBE_CFG_PMCS                0xCC
> 
> +#define B_GBE_CFG_PMCS_PS             (BIT1 | BIT0)
> 
> +#define V_GBE_CFG_PMCS_PS0            0x00
> 
> +//
> 
> +// Gigabit Ethernet LAN Capabilities and Status Registers (Memory space)
> 
> +//
> 
> +#define R_GBE_MEM_CSR_CTRL                    0
> 
> +//
> 
> +// LANPHYPC:
> 
> +// Connects to the LCD DEVICE_OFF# signal in the
> 
> +// LAN Connected Device
> 
> +//
> 
> +#define B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE  BIT16 // When set
> to 1 SW driver has the ability to control the LANPHYPC pin value.
> 
> +#define B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL       BIT17 // When set to
> 1 this bit will define the value of the LANPHYPC pin.
> 
> +#define R_GBE_MEM_CSR_CTRL_EXT             0x0018
> 
> +#define B_GBE_MEM_CSR_CTRL_EXT_LPCD        BIT2  //LCD Power Cycle
> Done (LPCD). This bit indicates whether LCD power cycle is done
> 
> +                                                 //- the bit is set 50/100mSec after LANPHYPC pin
> assertion.
> 
> +#define B_GBE_MEM_CSR_CTRL_EXT_FORCE_SMB   BIT11
> 
> +#define R_GBE_MEM_CSR_MDIC                 0x0020
> 
> +#define B_GBE_MEM_CSR_MDIC_RB              BIT28
> 
> +#define R_GBE_MEM_CSR_EXTCNF_CTRL          0x0F00
> 
> +#define B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG   BIT5
> 
> +#define R_GBE_MEM_CSR_RAL                  0x5400
> 
> +#define R_GBE_MEM_CSR_RAH                  0x5404
> 
> +#define B_GBE_MEM_CSR_RAH_RAH              0x0000FFFF
> 
> +#define R_GBE_MEM_CSR_WUC                  0x5800
> 
> +#define B_GBE_MEM_CSR_WUC_APME             BIT0
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> GbeLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> GbeLib.c
> new file mode 100644
> index 0000000000..3b51b9eb62
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> GbeLib.c
> @@ -0,0 +1,121 @@
> +/** @file
> 
> +  Gbe Library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/SpiAccessLib.h>
> 
> +#include <Library/GbeMdiLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/GbeRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Check whether GbE region is valid
> 
> +  Check SPI region directly since GbE might be disabled in SW.
> 
> +
> 
> +  @retval TRUE                    Gbe Region is valid
> 
> +  @retval FALSE                   Gbe Region is invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbeRegionValid (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return SpiIsGbeRegionValid ();
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether GBE controller is enabled in the platform.
> 
> +
> 
> +  @retval TRUE                    GbE is enabled
> 
> +  @retval FALSE                   GbE is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbePresent (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Check PCH Support
> 
> +  //
> 
> +  if (!PchIsGbeSupported ()) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  //
> 
> +  // Check PMC strap/fuse
> 
> +  //
> 
> +  if (!PmcIsGbeSupported ()) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  //
> 
> +  // Check GbE NVM
> 
> +  //
> 
> +  if (IsGbeRegionValid () == FALSE) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Verifies Gigabit Ethernet PCI Class Code
> 
> +
> 
> +  @param [in]  GbePciCfgBase      GbE PCI Config Space Address
> 
> +
> 
> +  @retval TRUE                    GbE Class Code match
> 
> +  @retval FALSE                   GbE Class Code does not match
> 
> +**/
> 
> +BOOLEAN
> 
> +STATIC
> 
> +GbeCheckClassCode (
> 
> +  UINT64 GbePciCfgBase
> 
> +  )
> 
> +{
> 
> +  UINT8 BaseCode;
> 
> +  UINT8 SubClassCode;
> 
> +
> 
> +  SubClassCode  = PciSegmentRead8 (GbePciCfgBase +
> PCI_CLASSCODE_OFFSET + 1);
> 
> +  BaseCode      = PciSegmentRead8 (GbePciCfgBase +
> PCI_CLASSCODE_OFFSET + 2);
> 
> +
> 
> +  if ((BaseCode != PCI_CLASS_NETWORK) || (SubClassCode !=
> PCI_CLASS_NETWORK_ETHERNET)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeCheckClassCode : BaseCode(0x%x) or
> ClassCode(0x%x) is not supported\n", BaseCode, SubClassCode));
> 
> +    ASSERT (FALSE);
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Gbe is Enabled or Disabled
> 
> +
> 
> +  @retval  BOOLEAN    TRUE if device is enabled, FALSE otherwise.
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGbeEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64  GbePciBase;
> 
> +
> 
> +  GbePciBase = GbePciCfgBase ();
> 
> +
> 
> +  if (PciSegmentRead32 (GbePciBase) != 0xFFFFFFFF) {
> 
> +    return GbeCheckClassCode (GbePciBase);
> 
> +  }
> 
> +
> 
> +  return FALSE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> PeiDxeSmmGbeLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> PeiDxeSmmGbeLib.inf
> new file mode 100644
> index 0000000000..4fef1288af
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/Library/PeiDxeSmmGbeLib/
> PeiDxeSmmGbeLib.inf
> @@ -0,0 +1,43 @@
> +## @file
> 
> +# Gbe Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmGbeLib
> 
> +FILE_GUID = FC022ED0-6EB3-43E1-A740-0BA27CBBD010
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = GbeLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchInfoLib
> 
> +PchPcrLib
> 
> +PchCycleDecodingLib
> 
> +PmcPrivateLib
> 
> +SpiAccessLib
> 
> +GbeMdiLib
> 
> +PchPciBdfLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +GbeLib.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/GbeMdiLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/GbeMdiLib.c
> new file mode 100644
> index 0000000000..7917474406
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/GbeMdiLib.c
> @@ -0,0 +1,388 @@
> +/** @file
> 
> +  Gbe MDI Library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/TimerLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/GbeMdiLib.h>
> 
> +#include <Register/GbeRegs.h>
> 
> +
> 
> +
> 
> +/**
> 
> +  Validates both Phy Address and Regster.
> 
> +
> 
> +  @param [in]  PhyAddress
> 
> +  @param [in]  PhyRegister
> 
> +
> 
> +  @retval BOOLEAN   TRUE  Validation passed
> 
> +                    FALSE If the data is not within its range
> 
> +
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPhyAddressRegisterValid (
> 
> +  IN      UINT32  PhyAddress,
> 
> +  IN      UINT32  PhyRegister
> 
> +  )
> 
> +{
> 
> +  if (((PhyAddress & (~B_PHY_MDI_PHY_ADDRESS_MASK)) != 0) ||
> ((PhyRegister & (~B_PHY_MDI_PHY_REGISTER_MASK)) != 0)) {
> 
> +    DEBUG ((DEBUG_ERROR, "IsPhyAddressRegisterValid validation failed!
> PhyAddress: 0x%08X PhyRegister: 0x%08X \n", PhyAddress, PhyRegister));
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Change Extended Device Control Register BIT 11 to 1 which
> 
> +  forces the interface between the MAC and the Phy to be on SMBus.
> 
> +  Cleared on the assertion of PCI reset.
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +
> 
> +**/
> 
> +VOID
> 
> +GbeMdiForceMacToSmb (
> 
> +  IN      UINT32  GbeBar
> 
> +  )
> 
> +{
> 
> +  MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL_EXT,
> B_GBE_MEM_CSR_CTRL_EXT_FORCE_SMB);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Test for MDIO operation complete.
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +  @retval EFI_TIMEOUT
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiWaitReady (
> 
> +  IN      UINT32  GbeBar
> 
> +  )
> 
> +{
> 
> +  UINT32  Count;
> 
> +
> 
> +  for (Count = 0; Count < GBE_MAX_LOOP_TIME; ++Count) {
> 
> +    if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_MDIC) &
> B_GBE_MEM_CSR_MDIC_RB) {
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +    MicroSecondDelay (GBE_ACQUIRE_MDIO_DELAY);
> 
> +  }
> 
> +  DEBUG ((DEBUG_ERROR, "GbeMdiWaitReady Timeout reached. MDIO
> operation failed to complete in %d micro seconds\n",
> GBE_MAX_LOOP_TIME * GBE_ACQUIRE_MDIO_DELAY));
> 
> +  return EFI_TIMEOUT;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Acquire MDIO software semaphore.
> 
> +
> 
> +  1. Ensure that MBARA offset F00h [5] = 1b
> 
> +  2. Poll MBARA offset F00h [5] up to 200ms
> 
> +
> 
> +  @param [in] GbeBar   GbE MMIO space
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +  @retval EFI_TIMEOUT
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiAcquireMdio (
> 
> +  IN      UINT32  GbeBar
> 
> +  )
> 
> +{
> 
> +  UINT32  ExtCnfCtrl;
> 
> +  UINT32  Count;
> 
> +
> 
> +  MmioOr32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL,
> B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
> 
> +  for (Count = 0; Count < GBE_MAX_LOOP_TIME; ++Count) {
> 
> +    ExtCnfCtrl = MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL);
> 
> +    if (ExtCnfCtrl & B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG) {
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +    MicroSecondDelay (GBE_ACQUIRE_MDIO_DELAY);
> 
> +  }
> 
> +  DEBUG ((DEBUG_ERROR, "GbeMdiAcquireMdio Timeout. Unable to
> acquire MDIO Semaphore in %d micro seconds\n", GBE_MAX_LOOP_TIME *
> GBE_ACQUIRE_MDIO_DELAY));
> 
> +  return EFI_TIMEOUT;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Release MDIO software semaphore by clearing MBARA offset F00h [5]
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +**/
> 
> +VOID
> 
> +GbeMdiReleaseMdio (
> 
> +  IN      UINT32  GbeBar
> 
> +  )
> 
> +{
> 
> +  ASSERT (MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL) &
> B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
> 
> +  MmioAnd32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL, (UINT32)
> ~B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG);
> 
> +  ASSERT ((MmioRead32 (GbeBar + R_GBE_MEM_CSR_EXTCNF_CTRL) &
> B_GBE_MEM_CSR_EXTCNF_CTRL_SWFLAG) == 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets page on MDI
> 
> +  Page setting is attempted twice.
> 
> +  If first attempt failes MAC and the Phy are force to be on SMBus.
> 
> +
> 
> +  Waits 4 mSec after page setting
> 
> +
> 
> +  @param [in]  GbeBar  GbE MMIO space
> 
> +  @param [in]  Data    Value to write in lower 16bits.
> 
> +
> 
> +  @retval EFI_SUCCESS       Page setting was successfull
> 
> +  @retval EFI_DEVICE_ERROR  Returned if both attermps of setting page
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiSetPage (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  Page
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY)
> & (B_PHY_MDI_WRITE | B_PHY_MDI_PHY_ADDRESS_01 |
> R_PHY_MDI_PHY_REG_SET_PAGE | ((Page * 32) & 0xFFFF)));
> 
> +
> 
> +  Status = GbeMdiWaitReady (GbeBar);
> 
> +
> 
> +  if (Status == EFI_TIMEOUT) {
> 
> +    DEBUG ((DEBUG_INFO, "GbeMdiSetPage Timeout reached. Forcing the
> interface between the MAC and the Phy to be on SMBus\n"));
> 
> +    GbeMdiForceMacToSmb (GbeBar);
> 
> +    //
> 
> +    // Retry page setting
> 
> +    //
> 
> +    MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC,
> (~B_PHY_MDI_READY) & (B_PHY_MDI_WRITE |
> B_PHY_MDI_PHY_ADDRESS_01 | R_PHY_MDI_PHY_REG_SET_PAGE | ((Page
> * 32) & 0xFFFF)));
> 
> +    Status = GbeMdiWaitReady (GbeBar);
> 
> +    if (Status == EFI_TIMEOUT) {
> 
> +      DEBUG ((DEBUG_ERROR, "GbeMdiSetPage retry page setting
> failed!\n"));
> 
> +      return EFI_DEVICE_ERROR;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Delay required for page to set properly
> 
> +  //
> 
> +  MicroSecondDelay (GBE_MDI_SET_PAGE_DELAY);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Register in current page.
> 
> +
> 
> +  @param [in]  GbeBar      GbE MMIO space
> 
> +  @param [in]  register    Register number valid only in lower 16 Bits
> 
> +
> 
> +  @return EFI_STATUS
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiSetRegister (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  Register
> 
> +  )
> 
> +{
> 
> +  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY)
> & (B_PHY_MDI_WRITE | B_PHY_MDI_PHY_ADDRESS_01 |
> R_PHY_MDI_PHY_REG_SET_ADDRESS | (Register & 0xFFFF)));
> 
> +  return GbeMdiWaitReady (GbeBar);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Perform MDI write.
> 
> +
> 
> +  @param [in]  GbeBar       GbE MMIO space
> 
> +  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
> 
> +  @param [in]  PhyRegister  Phy Register
> 
> +  @param [in]  WriteData    Value to write in lower 16bits.
> 
> +
> 
> +  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiWrite (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  PhyAddress,
> 
> +  IN      UINT32  PhyRegister,
> 
> +  IN      UINT32  WriteData
> 
> +  )
> 
> +{
> 
> +  if(!IsPhyAddressRegisterValid (PhyAddress, PhyRegister)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiWrite PhyAddressRegister validaton
> failed!\n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY)
> & (B_PHY_MDI_WRITE | PhyAddress | PhyRegister | (WriteData & 0xFFFF)));
> 
> +  return GbeMdiWaitReady (GbeBar);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Perform MDI read.
> 
> +
> 
> +  @param [in]  GbeBar       GbE MMIO space
> 
> +  @param [in]  PhyAddress   Phy Address General - 02 or Specific - 01
> 
> +  @param [in]  PhyRegister  Phy Register
> 
> +  @param [out] ReadData     Return Value
> 
> +
> 
> +  @retval EFI_SUCCESS            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_TIMEOUT            Based on response from GbeMdiWaitReady
> 
> +  @retval EFI_INVALID_PARAMETER  If Phy Address or Register validaton
> failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiRead (
> 
> +  IN      UINT32  GbeBar,
> 
> +  IN      UINT32  PhyAddress,
> 
> +  IN      UINT32  PhyRegister,
> 
> +  OUT     UINT16  *ReadData
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS    Status;
> 
> +
> 
> +  if(!IsPhyAddressRegisterValid (PhyAddress, PhyRegister)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiRead PhyAddressRegister validaton
> failed!\n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  MmioWrite32 (GbeBar + R_GBE_MEM_CSR_MDIC, (~B_PHY_MDI_READY)
> & (B_PHY_MDI_READ | PhyAddress | PhyRegister));
> 
> +  Status = GbeMdiWaitReady (GbeBar);
> 
> +  if (EFI_SUCCESS == Status) {
> 
> +    *ReadData = (UINT16) MmioRead32 (GbeBar +
> R_GBE_MEM_CSR_MDIC);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets Phy Revision and Model Number
> 
> +  from PHY IDENTIFIER register 2 (offset 3)
> 
> +
> 
> +  @param [in]  GbeBar           GbE MMIO space
> 
> +  @param [out] LanPhyRevision   Return Value
> 
> +
> 
> +  @return EFI_STATUS
> 
> +  @return EFI_INVALID_PARAMETER When GbeBar is incorrect
> 
> +                                When Phy register or address is out of bounds
> 
> +**/
> 
> +EFI_STATUS
> 
> +GbeMdiGetLanPhyRevision (
> 
> +  IN      UINT32  GbeBar,
> 
> +  OUT     UINT16  *LanPhyRevision
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS    Status;
> 
> +  UINT8         LpcdLoop;
> 
> +  UINT8         Delay;
> 
> +
> 
> +  if (!((GbeBar & 0xFFFFF000) > 0)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision GbeBar validation
> failed! Bar: 0x%08X \n", GbeBar));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Status = GbeMdiAcquireMdio (GbeBar);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to aquire
> MDIO semaphore. Status: %r\n", Status));
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  Status = GbeMdiSetPage (GbeBar,
> PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to Set Page
> 769. Status: %r\n", Status));
> 
> +    GbeMdiReleaseMdio (GbeBar);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  //  Set register to: Custom Mode Control
> 
> +  //   Reduced MDIO frequency access (slow mdio)
> 
> +  //   BIT 10 set to 1
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_16_CMC), BIT13 |
> B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS | BIT8 |
> BIT7);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to enable
> slow MDIO mode. Status: %r\n", Status));
> 
> +    GbeMdiReleaseMdio (GbeBar);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Read register PHY Version from PHY IDENTIFIER 2 (offset 0x3)
> 
> +  //  Bits [9:4]   - Device Model Number
> 
> +  //  Bits [3:0]   - Device Revision Number
> 
> +  //
> 
> +  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02,
> R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
> 
> +
> 
> +  //
> 
> +  // Failed to obtain PHY REV
> 
> +  //
> 
> +  if (*LanPhyRevision == 0x0) {
> 
> +    if ((MmioRead32 (GbeBar + R_GBE_MEM_CSR_CTRL) &
> (B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE |
> B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL))) {
> 
> +      DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to read Phy
> Revision. Other component tried to initialize GbE and failed.\n"));
> 
> +      Status = EFI_DEVICE_ERROR;
> 
> +      goto phy_exit;
> 
> +    }
> 
> +    DEBUG ((DEBUG_INFO, "GbeMdiGetLanPhyRevision failed to read
> Revision. Overriding LANPHYPC\n", Status));
> 
> +    //
> 
> +    // Taking over LANPHYPC
> 
> +    // 1. SW signal override - 1st cycle.
> 
> +    // 2. Turn LCD on - 2nd cycle.
> 
> +    //
> 
> +    MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL,
> B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE);
> 
> +    MmioOr32 (GbeBar + R_GBE_MEM_CSR_CTRL,
> B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL);
> 
> +
> 
> +    //
> 
> +    // Poll on LPCD for 100mSec
> 
> +    //
> 
> +    LpcdLoop = 101;
> 
> +    while (LpcdLoop > 0) {
> 
> +      if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_CTRL_EXT) &
> B_GBE_MEM_CSR_CTRL_EXT_LPCD) {
> 
> +        break;
> 
> +      } else {
> 
> +        LpcdLoop--;
> 
> +        MicroSecondDelay (1000);
> 
> +      }
> 
> +    }
> 
> +
> 
> +    if (LpcdLoop > 0) {
> 
> +      Delay = 100;
> 
> +      Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02,
> R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
> 
> +      while (*LanPhyRevision == 0 && Delay > 0) {
> 
> +        Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_02,
> R_PHY_MDI_GENEREAL_REGISTER_03_PHY_IDENTIFIER_2, LanPhyRevision);
> 
> +        if (EFI_ERROR(Status)) {
> 
> +          break;
> 
> +        }
> 
> +        MicroSecondDelay (1000);
> 
> +        Delay --;
> 
> +      }
> 
> +    }
> 
> +    //
> 
> +    // Restore LANPHYPC
> 
> +    // 1. Turn LCD off - 1st cycle.
> 
> +    // 2. Remove SW signal override - 2nd cycle.
> 
> +    //
> 
> +    MmioAnd32 (GbeBar + R_GBE_MEM_CSR_CTRL, (UINT32)
> ~B_GBE_MEM_CSR_CTRL_LANPHYPC_VAL);
> 
> +    MmioAnd32 (GbeBar + R_GBE_MEM_CSR_CTRL, (UINT32)
> ~B_GBE_MEM_CSR_CTRL_LANPHYPC_OVERRIDE);
> 
> +  }
> 
> +
> 
> +phy_exit:
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to read
> Revision and Model Number from PHY Identifier 2. Status: %r\n", Status));
> 
> +    GbeMdiReleaseMdio (GbeBar);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  //  Switch back to normal MDIO frequency access
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_16_CMC),
> (~B_PHY_MDI_PAGE_769_REGISETER_16_CMC_MDIO_FREQ_ACCESS) &
> (BIT13 | BIT8 | BIT7));
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GbeMdiGetLanPhyRevision failed to disable
> slow MDIO mode. Status: %r\n", Status));
> 
> +  }
> 
> +
> 
> +  GbeMdiReleaseMdio (GbeBar);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/PeiDxeSmmGbeMdiLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/PeiDxeSmmGbeMdiLib.inf
> new file mode 100644
> index 0000000000..99a01177f6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gbe/LibraryPrivate/PeiDxeSmmG
> beMdiLib/PeiDxeSmmGbeMdiLib.inf
> @@ -0,0 +1,34 @@
> +## @file
> 
> +# Gbe MDI Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmGbeMdiLib
> 
> +FILE_GUID = 0360E6F6-892A-4852-BF98-15C0D30D8A48
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = GbeMdiLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +TimerLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +GbeMdiLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component
  2021-02-01  1:36 ` [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Gpio/Include
>   * IpBlock/Gpio/IncludePrivate
>   * IpBlock/Gpio/Library
>   * IpBlock/Gpio/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckCo
> nflictLib.h                                 |   43 ++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/DxeGpi
> oPolicyLib.h                              |   55 +++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioH
> elpersLib.h                                |  105
> +++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioN
> ameBufferLib.h                             |   23 +++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/GpioPri
> vateLib.h                                | 1197
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflic
> tLib/BaseGpioCheckConflictLib.c            |  140
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflic
> tLib/BaseGpioCheckConflictLib.inf          |   29 +++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflic
> tLibNull/BaseGpioCheckConflictLibNull.c    |   35 +++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConflic
> tLibNull/BaseGpioCheckConflictLibNull.inf  |   26 ++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/G
> pioInit.c                                    |  558
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/G
> pioLib.c                                     | 2387
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/G
> pioLibrary.h                                 |   82 ++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/G
> pioNames.c                                   |   86 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/G
> pioNativeLib.c                               |  193
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/P
> eiDxeSmmGpioLib.inf                          |   49 ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpe
> rsLibNull/BaseGpioHelpersLibNull.c         |  119
> ++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHelpe
> rsLibNull/BaseGpioHelpersLibNull.inf       |   26 ++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioName
> BufferLib/DxeGpioNameBufferLib.inf           |   32 ++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioName
> BufferLib/GpioNameBufferDxe.c                |   19 +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyL
> ib/DxeGpioPolicyLib.c                     |   87
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolicyL
> ib/DxeGpioPolicyLib.inf                   |   31 ++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpi
> oPrivateLib/GpioNamesVer2.c                 |   88
> +++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpi
> oPrivateLib/GpioPrivateLib.c                |  395
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpi
> oPrivateLib/GpioPrivateLibVer2.c            |  131
> ++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmmGpi
> oPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf |   46 +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpers
> Lib/PeiGpioHelpersLib.c                   |  413
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelpers
> Lib/PeiGpioHelpersLib.inf                 |   48 ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameB
> ufferLib/GpioNameBufferPei.c                |   67 +++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNameB
> ufferLib/PeiGpioNameBufferLib.inf           |   35 +++++++++++++
>  29 files changed, 6545 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckC
> onflictLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckC
> onflictLib.h
> new file mode 100644
> index 0000000000..5e3dd90ae6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Include/Library/GpioCheckC
> onflictLib.h
> @@ -0,0 +1,43 @@
> +/** @file
> 
> +  Header file for checking Gpio PadMode conflict.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_CHECK_CONFLICT_LIB_H_
> 
> +#define _GPIO_CHECK_CONFLICT_LIB_H_
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/GpioConfig.h>
> 
> +#include <Library/GpioLib.h>
> 
> +
> 
> +extern EFI_GUID gGpioCheckConflictHobGuid;
> 
> +
> 
> +typedef struct {
> 
> +  GPIO_PAD  GpioPad;
> 
> +  UINT32    GpioPadMode:5;
> 
> +  UINT32    Reserved:27;
> 
> +} GPIO_PAD_MODE_INFO;
> 
> +
> 
> +/**
> 
> +  Check Gpio PadMode conflict and report it.
> 
> +**/
> 
> +VOID
> 
> +GpioCheckConflict (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This library will create one Hob for each Gpio config table
> 
> +  without PadMode is GpioHardwareDefault
> 
> +
> 
> +  @param[in]  GpioDefinition    Point to Platform Gpio table
> 
> +  @param[in]  GpioTableCount    Number of Gpio table entries
> 
> +**/
> 
> +VOID
> 
> +CreateGpioCheckConflictHob (
> 
> +  IN GPIO_INIT_CONFIG          *GpioDefinition,
> 
> +  IN UINT32                    GpioTableCount
> 
> +  );
> 
> +
> 
> +#endif // _GPIO_CHECK_CONFLICT_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Dxe
> GpioPolicyLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Dxe
> GpioPolicyLib.h
> new file mode 100644
> index 0000000000..d86e6624b7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Dxe
> GpioPolicyLib.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  DXE Gpio policy library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_GPIO_POLICY_LIB_H_
> 
> +#define _DXE_GPIO_POLICY_LIB_H_
> 
> +
> 
> +#include <Protocol/PchPolicy.h>
> 
> +
> 
> +/**
> 
> +  Print GPIO_DXE_CONFIG and serial out.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +GpioDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for GPIO
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +GpioDxeLoadConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Gpio config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +GpioDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Add Gpio ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +#endif // _DXE_GPIO_POLICY_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> HelpersLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> HelpersLib.h
> new file mode 100644
> index 0000000000..d2a8d24c8a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> HelpersLib.h
> @@ -0,0 +1,105 @@
> +/** @file
> 
> +  Header file for GPIO Helpers Lib implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_HELPERS_LIB_H_
> 
> +#define _GPIO_HELPERS_LIB_H_
> 
> +
> 
> +#include <Library/GpioConfig.h>
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO pad unlock information
> 
> +
> 
> +  @param[in] GpioPad         GPIO pad
> 
> +  @param[in] GpioLockConfig  GPIO Lock Configuration
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreUnlockData (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN GPIO_LOCK_CONFIG     GpioLockConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which PadConfig needs
> to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLock          DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockPadConfigData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which Output state
> needs to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLock          DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockOutputData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which PadConfig is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockPadConfigMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which Output is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockOutputMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns Gpio Override Level1 Information
> 
> +
> 
> +  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioOverrideLevel1Enabled (
> 
> +  VOID
> 
> +  );
> 
> +#endif // _GPIO_HELPERS_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> NameBufferLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> NameBufferLib.h
> new file mode 100644
> index 0000000000..c60709c637
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> NameBufferLib.h
> @@ -0,0 +1,23 @@
> +/** @file
> 
> +  Header file for GpioMemLib. This library provides GpioLib with static
> memory to hold GpioName.
> 
> +  Static memory is handled differently in PEI and DXE phase. For PEI pre
> mem we use private HOB to store
> 
> +  gpio name since .data section is read only. For PEI post mem and DXE
> simple static buffer is used.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_NAME_BUFFER_LIB_H_
> 
> +#define _GPIO_NAME_BUFFER_LIB_H_
> 
> +
> 
> +#define GPIO_NAME_LENGTH_MAX  32
> 
> +
> 
> +/**
> 
> +  Returns pointer to the global buffer to be used by GpioNamesLib
> 
> +
> 
> +  @retval CHAR8*  Pointer to the buffer
> 
> +**/
> 
> +CHAR8*
> 
> +GpioGetStaticNameBuffer (
> 
> +  VOID
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> PrivateLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> PrivateLib.h
> new file mode 100644
> index 0000000000..be41f80c24
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/IncludePrivate/Library/Gpio
> PrivateLib.h
> @@ -0,0 +1,1197 @@
> +/** @file
> 
> +  Header file for GpioPrivateLib.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_PRIVATE_LIB_H_
> 
> +#define _GPIO_PRIVATE_LIB_H_
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/GpioConfig.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <TcssPeiConfig.h>
> 
> +
> 
> +/**
> 
> +  GPIO Standby State configuration
> 
> +  Standby State options for GPIO Pads
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioIosStateDefault         = 0x0,
> 
> +  GpioIosStateLatchLastValue  = (0x0 << 1) | 0x01,  ///< Latch last value
> driven on TX, TX Enable and RX Enable
> 
> +  GpioIosStateTx0Rx0RxDis     = (0x1 << 1) | 0x01,  ///< TX: 0, RX: 0
> (internally), RX disabled
> 
> +  GpioIosStateTx0Rx1RxDis     = (0x2 << 1) | 0x01,  ///< TX: 0, RX: 1
> (internally), RX disabled
> 
> +  GpioIosStateTx1Rx0RxDis     = (0x3 << 1) | 0x01,  ///< TX: 1, RX: 0
> (internally), RX disabled
> 
> +  GpioIosStateTx1Rx1RxDis     = (0x4 << 1) | 0x01,  ///< TX: 1, RX: 1
> (internally), RX disabled
> 
> +  GpioIosStateTx0RxEn         = (0x5 << 1) | 0x01,  ///< TX: 0, RX enabled
> 
> +  GpioIosStateTx1RxEn         = (0x6 << 1) | 0x01,  ///< TX: 1, RX enabled
> 
> +  GpioIosStateHizRx0          = (0x7 << 1) | 0x01,  ///< Hi-Z, RX: 0 (internally)
> 
> +  GpioIosStateHizRx1          = (0x8 << 1) | 0x01,  ///< Hi-Z, RX: 1 (internally)
> 
> +  GpioIosStateTxDisRxEn       = (0x9 << 1) | 0x01,  ///< TX Disabled and RX
> Enabled (i.e. wake or interrupt)
> 
> +  GpioIosStateMasked          = (0xF << 1) | 0x01   ///< IO Standby signal is
> masked for this pad. In this mode, a pad operates as if IOStandby has not
> been asserted.
> 
> +} GPIO_IOSTANDBY_STATE;
> 
> +
> 
> +/**
> 
> +  GPIO Standby Term configuration
> 
> +  Standby Termination options for GPIO Pads
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioIosTermDefault         = 0x00,
> 
> +  GpioIosTermSame            = (0x00 << 1) | 0x01, ///< Same as state specified
> in Term
> 
> +  GpioIosTermPuDisPdDis      = (0x01 << 1) | 0x01, ///< Disable Pullup and
> Pulldown
> 
> +  GpioIosTermPuDisPdEn       = (0x02 << 1) | 0x01, ///< Enable Pulldown
> 
> +  GpioIosTermPuEnPdDis       = (0x03 << 1) | 0x01  ///< Enable Pullup
> 
> +} GPIO_IOSTANDBY_TERM;
> 
> +
> 
> +//
> 
> +// Structure for native pin data
> 
> +//
> 
> +typedef struct {
> 
> +  GPIO_PAD              Pad;
> 
> +  GPIO_PAD_MODE         Mode;
> 
> +  GPIO_IOSTANDBY_STATE  IosState;
> 
> +  GPIO_IOSTANDBY_TERM   IosTerm;
> 
> +} GPIO_PAD_NATIVE_FUNCTION;
> 
> +
> 
> +//
> 
> +// Structure for Serial GPIO pin definition
> 
> +//
> 
> +typedef struct {
> 
> +  GPIO_PAD_NATIVE_FUNCTION  Sclock;
> 
> +  GPIO_PAD_NATIVE_FUNCTION  Sload;
> 
> +  GPIO_PAD_NATIVE_FUNCTION  Sdataout;
> 
> +} SGPIO_PINS;
> 
> +
> 
> +//
> 
> +// Structure for USB Virtual Wire OverCurrent Pad Mode group
> 
> +//
> 
> +typedef struct {
> 
> +  GPIO_PAD       OcRxPad;
> 
> +  GPIO_PAD       OcTxPad;
> 
> +} GPIO_VWOC_FUNCTION;
> 
> +
> 
> +//
> 
> +// Below defines are based on GPIO_CONFIG structure fields
> 
> +//
> 
> +#define B_GPIO_PAD_MODE_MASK                            0xF
> 
> +#define N_GPIO_PAD_MODE_BIT_POS                         0
> 
> +#define B_GPIO_HOSTSW_OWN_MASK                          0x3
> 
> +#define N_GPIO_HOSTSW_OWN_BIT_POS                       0
> 
> +#define B_GPIO_DIRECTION_MASK                           0x1F
> 
> +#define B_GPIO_DIRECTION_DIR_MASK                       0x7
> 
> +#define N_GPIO_DIRECTION_DIR_BIT_POS                    0
> 
> +#define B_GPIO_DIRECTION_INV_MASK                       0x18
> 
> +#define N_GPIO_DIRECTION_INV_BIT_POS                    3
> 
> +#define B_GPIO_OUTPUT_MASK                              0x3
> 
> +#define N_GPIO_OUTPUT_BIT_POS                           0
> 
> +#define N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS            0
> 
> +#define N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS              5
> 
> +#define B_GPIO_RESET_CONFIG_RESET_MASK                  0x3F
> 
> +#define N_GPIO_RESET_CONFIG_OLD_RESET_TYPE              BIT1
> 
> +#define B_GPIO_RESET_CONFIG_OLD_RESET_MASK              0xF
> 
> +#define N_GPIO_RESET_CONFIG_RESET_BIT_POS               0
> 
> +#define B_GPIO_RESET_CONFIG_GPD_RESET_MASK              (BIT5 | BIT4)
> 
> +#define B_GPIO_RESET_CONFIG_GPP_RESET_MASK              (BIT3 | BIT2)
> 
> +#define N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS    0
> 
> +#define N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS               0
> 
> +#define B_GPIO_GPIO_IOSTANDBY_STATE_MASK                ((0xF << 1) |
> 0x01)
> 
> +#define B_GPIO_GPIO_IOSTANDBY_STATE_POS                 0
> 
> +#define B_GPIO_GPIO_IOSTANDBY_TERM_MASK                 ((0x2 << 1) |
> 0x01)
> 
> +#define B_GPIO_GPIO_IOSTANDBY_TERM_POS                  0
> 
> +
> 
> +//
> 
> +// Structure for storing information about registers offset, community,
> 
> +// maximal pad number for available groups
> 
> +//
> 
> +typedef struct {
> 
> +  PCH_SBI_PID  Community;
> 
> +  UINT16       PadOwnOffset;
> 
> +  UINT16       HostOwnOffset;
> 
> +  UINT16       GpiIsOffset;
> 
> +  UINT16       GpiIeOffset;
> 
> +  UINT16       GpiGpeStsOffset;
> 
> +  UINT16       GpiGpeEnOffset;
> 
> +  UINT16       SmiStsOffset;
> 
> +  UINT16       SmiEnOffset;
> 
> +  UINT16       NmiStsOffset;
> 
> +  UINT16       NmiEnOffset;
> 
> +  UINT16       PadCfgLockOffset;
> 
> +  UINT16       PadCfgLockTxOffset;
> 
> +  UINT16       PadCfgOffset;
> 
> +  UINT16       PadPerGroup;
> 
> +} GPIO_GROUP_INFO;
> 
> +
> 
> +//
> 
> +// If in GPIO_GROUP_INFO structure certain register doesn't exist
> 
> +// it will have value equal to NO_REGISTER_FOR_PROPERTY
> 
> +//
> 
> +#define NO_REGISTER_FOR_PROPERTY 0xFFFF
> 
> +
> 
> +#define GPIO_PAD_DEF(Group,Pad)                (UINT32)(((Group) << 16) +
> (Pad))
> 
> +#define GPIO_GROUP_DEF(GroupIndex,ChipsetId)   ((GroupIndex) |
> ((ChipsetId) << 8))
> 
> +#define GPIO_GET_GROUP_INDEX(Group)            ((Group) & 0x1F)
> 
> +#define GPIO_GET_GROUP_FROM_PAD(GpioPad)       (((GpioPad) &
> 0x0F1F0000) >> 16)
> 
> +#define GPIO_GET_GROUP_INDEX_FROM_PAD(GpioPad)
> GPIO_GET_GROUP_INDEX (GPIO_GET_GROUP_FROM_PAD(GpioPad))
> 
> +#define GPIO_GET_PAD_NUMBER(GpioPad)           ((GpioPad) & 0x1FF)
> 
> +#define GPIO_GET_CHIPSET_ID(GpioPad)           (((GpioPad) >> 24) & 0xF)
> 
> +
> 
> +#define GPIO_GET_PAD_POSITION(PadNumber)       ((PadNumber) % 32)
> 
> +#define GPIO_GET_DW_NUM(PadNumber)             ((PadNumber) / 32u)
> 
> +
> 
> +/**
> 
> +  This procedure will retrieve address and length of GPIO info table
> 
> +
> 
> +  @param[out]  GpioGroupInfoTableLength   Length of GPIO group table
> 
> +
> 
> +  @retval Pointer to GPIO group table
> 
> +**/
> 
> +CONST GPIO_GROUP_INFO*
> 
> +GpioGetGroupInfoTable (
> 
> +  OUT UINT32              *GpioGroupInfoTableLength
> 
> +  );
> 
> +
> 
> +typedef struct {
> 
> +  CONST CHAR8*    GpioGroupPrefix;
> 
> +  CONST GPIO_PAD  FirstUniqueGpio;
> 
> +  CONST CHAR8**   GroupUniqueNames;
> 
> +  CONST UINT32    UniqueNamesTableSize;
> 
> +} GPIO_GROUP_NAME_INFO;
> 
> +
> 
> +//
> 
> +// Helper macros for initializing GPIO_GROUP_NAME_INFO structures
> 
> +//
> 
> +#define
> GPIO_GROUP_NAME(GroupName,FirstUniqueGpio,GroupUniqueNamesTa
> ble) \
> 
> +  {GroupName, FirstUniqueGpio, GroupUniqueNamesTable, ARRAY_SIZE
> (GroupUniqueNamesTable)}
> 
> +
> 
> +#define GPIO_GROUP_NAME_BASIC(GroupName) \
> 
> +  {GroupName, 0, NULL, 0}
> 
> +
> 
> +/**
> 
> +  Returns GPIO_GROUP_NAME_INFO corresponding to the give GpioPad
> 
> +
> 
> +  @param[in]  GroupIndex  Group index
> 
> +
> 
> +  @retval  GPIO_GROUP_NAME_INFO*  Pointer to the
> GPIO_GROUP_NAME_INFO
> 
> +  @retval  NULL                   If no group descriptor was found
> 
> +**/
> 
> +CONST
> 
> +GPIO_GROUP_NAME_INFO*
> 
> +GpioGetGroupNameInfo (
> 
> +  IN UINT32  GroupIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get GPIO Chipset ID specific to PCH generation and series
> 
> +**/
> 
> +UINT32
> 
> +GpioGetThisChipsetId (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to check if GpioPad is valid for certain chipset
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval TRUE                    This pin is valid on this chipset
> 
> +          FALSE                   Incorrect pin
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsCorrectPadForThisChipset (
> 
> +  IN  GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generates GPIO name from GpioPad
> 
> +  This function returns pointer to the static buffer.
> 
> +
> 
> +  @param[in] GpioPad  GpioPad
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO name
> 
> +**/
> 
> +CHAR8*
> 
> +GpioName (
> 
> +  IN GPIO_PAD  GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generates GPIO name from GpioNativePad
> 
> +  This function returns pointer to the static buffer.
> 
> +
> 
> +  @param[in] GpioNativePad  GpioNativePad
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO name
> 
> +**/
> 
> +CHAR8*
> 
> +GpioPinMuxName (
> 
> +  IN GPIO_NATIVE_PAD  GpioNativePad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Generates GPIO Pad Termination string
> 
> +  This function returns pointer to the static buffer.
> 
> +
> 
> +  @param[in] GpioPadTermination  GPIO Pad Termination
> 
> +
> 
> +  @retval CHAR8*  Painter to the pad termianation string
> 
> +**/
> 
> +CHAR8*
> 
> +GpioGetPadTerminationString (
> 
> +  IN GPIO_ELECTRICAL_CONFIG PadTermination
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get value of selected gpio register
> 
> +
> 
> +  @param[in]  Group               GPIO group number
> 
> +  @param[in]  Offset              GPIO register offset
> 
> +  @param[out] RegVal              Value of gpio register
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetReg (
> 
> +  IN  GPIO_GROUP              Group,
> 
> +  IN  UINT32                  Offset,
> 
> +  OUT UINT32                  *RegVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set value of selected gpio register
> 
> +
> 
> +  @param[in] Group               GPIO group number
> 
> +  @param[in] Offset              GPIO register offset
> 
> +  @param[in] RegVal              Value of gpio register
> 
> +
> 
> +  @retval EFI_SUCCESS            The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER  Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetReg (
> 
> +  IN GPIO_GROUP              Group,
> 
> +  IN UINT32                  Offset,
> 
> +  IN UINT32                  RegVal
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used by PchSmiDispatcher and will return information
> 
> +  needed to register GPI SMI.
> 
> +
> 
> +  @param[in]  Index                   GPI SMI number
> 
> +  @param[out] GpioPin                 GPIO pin
> 
> +  @param[out] GpiSmiBitOffset         GPI SMI bit position within GpiSmi
> Registers
> 
> +  @param[out] GpiHostSwOwnRegAddress  Address of HOSTSW_OWN
> register
> 
> +  @param[out] GpiSmiStsRegAddress     Address of GPI SMI status register
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadAndSmiRegs (
> 
> +  IN UINT32            Index,
> 
> +  OUT GPIO_PAD         *GpioPin,
> 
> +  OUT UINT8            *GpiSmiBitOffset,
> 
> +  OUT UINT32           *GpiHostSwOwnRegAddress,
> 
> +  OUT UINT32           *GpiSmiStsRegAddress
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO Driver IRQ number
> 
> +
> 
> +  @param[in]  Irq                 Irq number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid IRQ number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetIrq (
> 
> +  IN  UINT8          Irq
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides GPIO Community PortIDs
> 
> +
> 
> +  @param[out] NativePinsTable                Table with GPIO COMMx SBI PortIDs
> 
> +
> 
> +  @retval      Number of communities
> 
> +**/
> 
> +UINT32
> 
> +GpioGetComSbiPortIds (
> 
> +  OUT PCH_SBI_PID    **GpioComSbiIds
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides list of GPIO for which IO Standby State configuration
> 
> +  has to be set as 'Masked'
> 
> +
> 
> +  @param[out] GpioPadsList                Table with pads
> 
> +
> 
> +  @retval      Number of pads
> 
> +**/
> 
> +UINT32
> 
> +GpioGetIoStandbyStateConfigurationPadsList (
> 
> +  OUT GPIO_PAD_NATIVE_FUNCTION    **GpioPadsList
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  This procedure will perform special handling of GPP_A_12.
> 
> +
> 
> +  @param[in]  None
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +GpioA12SpecialHandling (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +//
> 
> +// Structure which stores information needed to map GPIO Group
> 
> +// to 1-Tier GPE. Configuration is needed both in PMC and GPIO IP.
> 
> +// Because GPE_DWx can handle only 32 pins only single double word can
> 
> +// be mapped at a time. Each DW for a group has different configuration in
> PMC and GPIO
> 
> +//
> 
> +typedef struct {
> 
> +  GPIO_GROUP  Group;
> 
> +  UINT8       GroupDw;
> 
> +  UINT8       PmcGpeDwxVal;
> 
> +} GPIO_GROUP_TO_GPE_MAPPING;
> 
> +
> 
> +/**
> 
> +  Get information for GPIO Group required to program GPIO and PMC for
> desired 1-Tier GPE mapping
> 
> +
> 
> +  @param[out] GpioGroupToGpeMapping        Table with GPIO Group to
> GPE mapping
> 
> +  @param[out] GpioGroupToGpeMappingLength  GPIO Group to GPE
> mapping table length
> 
> +**/
> 
> +VOID
> 
> +GpioGetGroupToGpeMapping (
> 
> +  OUT GPIO_GROUP_TO_GPE_MAPPING  **GpioGroupToGpeMapping,
> 
> +  OUT UINT32                     *GpioGroupToGpeMappingLength
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return Port ID of GPIO Community from GpioPad
> 
> +
> 
> +  @param[in] GpioPad            GpioPad
> 
> +
> 
> +  @retval GpioCommunityPortId   Port ID of GPIO Community
> 
> +**/
> 
> +UINT8
> 
> +GpioGetGpioCommunityPortIdFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return PadCfg address from GpioPad
> 
> +
> 
> +  @param[in] GpioPad            GpioPad
> 
> +
> 
> +  @retval GpioPadCfgAddress     PadCfg Address of GpioPad
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGpioPadCfgAddressFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure is used to unlock all GPIO pads.
> 
> +  This function can only be called when platform is still in HOSTIA_BOOT_SAI.
> 
> +**/
> 
> +VOID
> 
> +GpioUnlockAllPads (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check if GpioPad is owned by host.
> 
> +
> 
> +  @param[in] GpioPad       GPIO pad
> 
> +
> 
> +  @retval TRUE             GPIO pad is owned by host
> 
> +  @retval FALSE            GPIO pad is not owned by host and should not be
> used with GPIO lib API
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsPadHostOwned (
> 
> +  IN GPIO_PAD             GpioPad
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  This procedure will check if GpioPad argument is valid.
> 
> +  Function will check below conditions:
> 
> +   - GpioPad represents a pad for current PCH
> 
> +   - GpioPad belongs to valid GpioGroup
> 
> +   - GPIO PadNumber is not greater than number of pads for this group
> 
> +
> 
> +  @param[in] GpioPad       GPIO pad
> 
> +
> 
> +  @retval TRUE             GPIO pad is valid and can be used with GPIO lib API
> 
> +  @retval FALSE            GPIO pad is invalid and cannot be used with GPIO lib
> API
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsPadValid (
> 
> +  IN GPIO_PAD             GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will read GPIO Pad Configuration register
> 
> +
> 
> +  @param[in] GpioPad          GPIO pad
> 
> +  @param[in] DwReg            Choose PADCFG register: 0:DW0, 1:DW1
> 
> +
> 
> +  @retval PadCfgRegValue      PADCFG_DWx value
> 
> +**/
> 
> +UINT32
> 
> +GpioReadPadCfgReg (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN UINT8                DwReg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will write or read GPIO Pad Configuration register
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] DwReg                Choose PADCFG register: 0:DW0, 1:DW1
> 
> +  @param[in] PadCfgAndMask        Mask to be AND'ed with PADCFG reg
> value
> 
> +  @param[in] PadCfgOrMask         Mask to be OR'ed with PADCFG reg value
> 
> +
> 
> +  @retval none
> 
> +**/
> 
> +VOID
> 
> +GpioWritePadCfgReg (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN UINT8                DwReg,
> 
> +  IN UINT32               PadCfgAndMask,
> 
> +  IN UINT32               PadCfgOrMask
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will Enable USB Virtual Wire Overcurrent pin
> 
> +
> 
> +  @param[in] GpioPad             GPIO Pad
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetVwOverCurrentPin (
> 
> +  IN GPIO_VWOC_FUNCTION GpioPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set Native Function IOSF-SB Virtual Wire Message
> Generation bit
> 
> +  in DW0 of requested GPIO Pad
> 
> +
> 
> +  @param[in] GPIO_PAD   GpioPad
> 
> +**/
> 
> +VOID
> 
> +GpioSetNafVweBit (
> 
> +  IN CONST GPIO_PAD PadCfg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO mode
> 
> +
> 
> +  @param[in] GpioPad             GPIO pad
> 
> +  @param[in] PadModeValue        GPIO pad mode value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadMode (
> 
> +  IN GPIO_PAD                GpioPad,
> 
> +  IN GPIO_PAD_MODE           PadModeValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO pad to native mode.
> 
> +  To be used if no other settings are to be configured when enabling native
> mode.
> 
> +
> 
> +  @param[in]  GpioNativePad       GPIO Pad with native mode information
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetNativePad (
> 
> +  IN GPIO_NATIVE_PAD  GpioNativePad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO pad to native function based on provided
> native function
> 
> +  and platform muxing selection (if needed).
> 
> +
> 
> +  @param[in]  PadFunction         PadMode for a specific native signal. Please
> refer to GpioNativePads.h
> 
> +  @param[in]  PinMux              GPIO Native pin mux platform config.
> 
> +                                  This argument is optional and needs to be
> 
> +                                  provided only if feature can be enabled
> 
> +                                  on multiple pads
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetNativePadByFunction (
> 
> +  IN UINT32  PadFunction,
> 
> +  IN UINT32  PinMux
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO mode
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] PadModeValue        GPIO pad mode value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadMode (
> 
> +  IN  GPIO_PAD                 GpioPad,
> 
> +  OUT GPIO_PAD_MODE            *PadModeValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will check if group is within DeepSleepWell.
> 
> +
> 
> +  @param[in]  Group               GPIO Group
> 
> +
> 
> +  @retval GroupWell               TRUE:  This is DSW Group
> 
> +                                  FALSE: This is not DSW Group
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsDswGroup (
> 
> +  IN  GPIO_GROUP         Group
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The function performs GPIO Power Management programming.
> 
> +**/
> 
> +VOID
> 
> +GpioConfigurePm (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function performs initial IO Standby State related configurations
> 
> +**/
> 
> +VOID
> 
> +GpioConfigureIoStandbyState (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables SCS SD Card controller card detect pin
> 
> +
> 
> +  @param[in]  none
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableScsSdCardDetect (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets HDA SSP interface pins into native mode
> 
> +
> 
> +  @param[in]  SspInterfaceNumber   SSPx interface number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableHdaSsp (
> 
> +  IN  UINT32            SspInterfaceNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets HDA SSP Master Clock into native mode
> 
> +
> 
> +  @param[in]  MclkIndex       MCLK index
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableHdaSspMasterClock (
> 
> +  IN UINT32  MclkIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets HDA SoundWire interface pins into native mode
> 
> +
> 
> +  @param[in]  SndwInterfaceNumber   SNDWx interface number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableHdaSndw (
> 
> +  IN  UINT32            SndwInterfaceNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides SPI IO pin for Touch Host Controller
> 
> +
> 
> +  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
> 
> +  @param[in]  IoIndex                   IoIndex Valid from 0 (SPI_IO_0) to 3
> (SPI_IO_3)
> 
> +
> 
> +  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex or
> IoIndex is invalid
> 
> +**/
> 
> +GPIO_PAD_NATIVE_FUNCTION
> 
> +GpioGetThcSpiIo (
> 
> +  IN  UINT32                      SpiIndex,
> 
> +  IN  UINT32                      IoIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides SPI ChipSelect pin for Touch Host Controller
> 
> +
> 
> +  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
> 
> +
> 
> +  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
> 
> +**/
> 
> +GPIO_PAD_NATIVE_FUNCTION
> 
> +GpioGetThcSpiCs (
> 
> +  IN  UINT32                      SpiIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides SPI Clock pin for Touch Host Controller
> 
> +
> 
> +  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
> 
> +
> 
> +  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
> 
> +**/
> 
> +GPIO_PAD_NATIVE_FUNCTION
> 
> +GpioGetThcSpiClk (
> 
> +  IN  UINT32                      SpiIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides SPI Reset pin for Touch Host Controller
> 
> +
> 
> +  @param[in]  SpiIndex                  SPI1 or SPI2 - 0 or 1
> 
> +
> 
> +  @retval     NativePin                 Native Pin Configuration, 0 if SpiIndex is invalid
> 
> +**/
> 
> +GPIO_PAD_NATIVE_FUNCTION
> 
> +GpioGetThcSpiReset (
> 
> +  IN  UINT32                      SpiIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SMBUS controller pins into native mode
> 
> +
> 
> +  @param[in]  none
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSmbus (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SMBUS ALERT pins into native mode
> 
> +
> 
> +  @param[in]  none
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSmbusAlert (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides Serial GPIO pins
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[out] SgpioPins           SATA Serial GPIO pins
> 
> +**/
> 
> +VOID
> 
> +GpioGetSataSgpioPins (
> 
> +  IN  UINT32        SataCtrlIndex,
> 
> +  OUT SGPIO_PINS    *SgpioPins
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets Serial GPIO pins into native mode
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[in]  SataPort            SATA port number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSataSgpio (
> 
> +  IN  UINT32  SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables USB OverCurrent pins by setting
> 
> +  USB2 OCB pins into native mode
> 
> +
> 
> +  @param[in]  OcPinNumber            USB OC pin number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableUsbOverCurrent (
> 
> +  IN  UINTN   OcPinNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables USB Virtual Wire OverCurrent pins by OcPinNumber.
> 
> +
> 
> +  @param[in]  OcPinNumber            USB OC pin number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableUsbVwOverCurrent (
> 
> +  IN  UINTN   OcPinNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SATA DevSlp pins into native mode
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[in]  SataPort            SATA port number
> 
> +  @param[in]  ResetType           GPIO reset type (see GPIO_RESET_CONFIG in
> GpioConfig.h)
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSataDevSlpPin (
> 
> +  IN  UINT32  SataCtrlIndex,
> 
> +  IN  UINTN   SataPort,
> 
> +  IN  UINT32  ResetType
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if SataDevSlp pin is in native mode
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[in]  SataPort            SATA port
> 
> +  @param[out] DevSlpPad           DevSlpPad
> 
> +                                  This is an optional parameter and may be NULL.
> 
> +
> 
> +  @retval TRUE                    DevSlp is in native mode
> 
> +          FALSE                   DevSlp is not in native mode
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsSataDevSlpPinEnabled (
> 
> +  IN  UINT32          SataCtrlIndex,
> 
> +  IN  UINTN           SataPort,
> 
> +  OUT GPIO_PAD        *DevSlpPad  OPTIONAL
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SATAGPx pin into native mode
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[in]  SataPort            SATA port number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSataGpPin (
> 
> +  IN  UINT32  SataCtrlIndex,
> 
> +  IN  UINTN   SataPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function provides SATA GP pin data
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @param[in]  SataPort            SATA port number
> 
> +  @param[out] NativePin           SATA GP pin
> 
> +**/
> 
> +VOID
> 
> +GpioGetSataGpPin (
> 
> +  IN  UINT32                    SataCtrlIndex,
> 
> +  IN  UINTN                     SataPort,
> 
> +  OUT GPIO_PAD_NATIVE_FUNCTION  *NativePin
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SATA LED pin into native mode. SATA LED indicates
> 
> +  SATA controller activity
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +  @retval     Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableSataLed (
> 
> +  IN  UINT32                    SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns pad for given CLKREQ# index.
> 
> +
> 
> +  @param[in]  ClkreqIndex       CLKREQ# number
> 
> +
> 
> +  @return CLKREQ# pad.
> 
> +**/
> 
> +GPIO_PAD
> 
> +GpioGetClkreqPad (
> 
> +  IN     UINT32   ClkreqIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enables CLKREQ# pad in native mode.
> 
> +
> 
> +  @param[in]  ClkreqIndex       CLKREQ# number
> 
> +
> 
> +  @return none
> 
> +**/
> 
> +VOID
> 
> +GpioEnableClkreq (
> 
> +  IN     UINT32   ClkreqIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets PCHHOT pin into native mode
> 
> +
> 
> +  @param[in]  none
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnablePchHot (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets VRALERTB pin into native mode
> 
> +
> 
> +  @param[in]  none
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableVrAlert (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets CPU GP pins into native mode
> 
> +
> 
> +  @param[in]  CpuGpPinNum               CPU GP pin number
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableCpuGpPin (
> 
> +  IN  UINT32                            CpuGpPinNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +This function sets CPU C10 Gate pins into native mode
> 
> +
> 
> +@retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableCpuC10GatePin (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +//
> 
> +// DDPx pins
> 
> +//
> 
> +typedef enum {
> 
> +  GpioDdp1 = 0x01,
> 
> +  GpioDdp2 = 0x02,
> 
> +  GpioDdp3 = 0x03,
> 
> +  GpioDdp4 = 0x04,
> 
> +  GpioDdpA = 0x10,
> 
> +  GpioDdpB = 0x11,
> 
> +  GpioDdpC = 0x12,
> 
> +  GpioDdpD = 0x13,
> 
> +  GpioDdpF = 0x15,
> 
> +} GPIO_DDP;
> 
> +
> 
> +/**
> 
> +  This function sets DDP pins into native mode
> 
> +
> 
> +  @param[in]  DdpInterface   DDPx interface
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableDpInterface (
> 
> +  IN  GPIO_DDP            DdpInterface
> 
> +  );
> 
> +
> 
> +//
> 
> +// DDI Port TBT_LSX interface
> 
> +//
> 
> +typedef enum {
> 
> +  GpioTbtLsxDdi1,
> 
> +  GpioTbtLsxDdi2,
> 
> +  GpioTbtLsxDdi3,
> 
> +  GpioTbtLsxDdi4,
> 
> +  GpioTbtLsxDdi5,
> 
> +  GpioTbtLsxDdi6
> 
> +} GPIO_TBT_LSX;
> 
> +
> 
> +/**
> 
> +  This function sets TBT_LSx pin into native mode
> 
> +
> 
> +  @param[in]  TbtLsxDdiPort     TBT_LSx DDI Port Number
> 
> +
> 
> +  @retval     Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableTbtLsxInterface (
> 
> +  IN GPIO_TBT_LSX  TbtLsxDdiPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function configures GPIO connection between CNVi and CRF
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioConfigureCnviCrfConnection (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets CNVi Bluetooth Enable value
> 
> +
> 
> +  @param[in] Value                CNVi BT enable value
> 
> +                                  0: Disable, 1: Enable
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetCnviBtEnState (
> 
> +   IN  UINT32  Value
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets CNVi Bluetooth Wireless Charging support
> 
> +
> 
> +  @param[in] BtWirelessCharging   CNVi BT Wireless Charging support
> 
> +                                  0: Normal BT operation (no Wireless Charging support)
> 
> +                                  1: Enable BT Wireless Charging
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetCnviBtWirelessCharging (
> 
> +  IN  UINT32  BtWirelessCharging
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables and configures CNVi Bluetooth Host wake-up
> interrupt
> 
> +
> 
> +  @param[in] None
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioConfigureCnviBtHostWakeInt (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables IMGU CLKOUT native pin
> 
> +
> 
> +  @param[in] ImguClkOutPinIndex    The index of IMGU CLKOUT natine pin
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableImguClkOut (
> 
> +  IN UINT8 ImguClkOutPinIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Power button debounce configuration
> 
> +  Debounce time can be specified in microseconds. Only certain values
> according
> 
> +  to below formula are supported:
> 
> +   DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(glitch filter clock
> period).
> 
> +  RTC clock with f = 32 KHz is used for glitch filter.
> 
> +   DebounceTime = (2 ^ PADCFG_DW2.DEBOUNCE)*(31.25 us).
> 
> +  Supported DebounceTime values are following:
> 
> +   DebounceTime = 0 -> Debounce feature disabled
> 
> +   DebounceTime > 0 && < 250us -> Not supported
> 
> +   DebounceTime = 250us - 1024000us -> Supported range (DebounceTime =
> 250us * 2^n)
> 
> +  For values not supported by HW, they will be rounded down to closest
> supported one
> 
> +
> 
> +  @param[in] DebounceTime    Debounce Time in microseconds
> 
> +                             If Debounce Time = 0, Debouncer feature will be disabled
> 
> +                             Function will set DebounceTime argument to rounded
> supported value
> 
> +**/
> 
> +VOID
> 
> +GpioSetPwrBtnDebounceTimer (
> 
> +  IN UINT32                DebounceTime
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  VCCIO level selection
> 
> +**/
> 
> +typedef enum {
> 
> +  GpioVcc3v3,
> 
> +  GpioVcc1v8,
> 
> +  MaxVccioSel
> 
> +} GPIO_VCCIO_SEL;
> 
> +/**
> 
> +  The function sets VCCIOSEL
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[in]  VccioSel            Pad voltage
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         The Pin is owned by others
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or parameter
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetVccLevel (
> 
> +  IN  GPIO_PAD        GpioPad,
> 
> +  IN  GPIO_VCCIO_SEL  VccioSel
> 
> +  );
> 
> +
> 
> +/**
> 
> +  SBU (Sideband use) pins are used as auxiliary signals for Type C connector,
> 
> +  which are hard-wired to BSSB_LS natively for debug function.
> 
> +  when USB-C is enablde and debug not needed, disable pins (BSSB) used
> for debug through TypeC connector,
> 
> +  program SBU pins to high-Z/open circuit per USB-C spec.
> 
> +
> 
> +  @param[in]  UsbTcPortEnBitmap   USB Type C port enabled bitmap
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         SBU pads are not supported
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid input parameter
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioDisableTypeCSbuDebug (
> 
> +  IN UINT32           UsbTcPortEnBitmap
> 
> +  );
> 
> +
> 
> +/**
> 
> +  When 2-wire DCI OOB is connected via SBU from Type C port, need set IO
> Standby state to masked (to operate as if no standby signal asserted)
> 
> +  to remain connection in low power state.
> 
> +
> 
> +  @param[in] DciPortId            DCI connection port ID
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         SBU pads are not supported
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid input parameter
> 
> +**/
> 
> +EFI_STATUS
> 
> +Gpio2WireDciOobSetting (
> 
> +  IN UINT8                        DciPortId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables the virtual wire msg bus from GPIO controller
> 
> +  to FIA. The virtual wire is used to transfer CLKREQ assert/de-assert
> 
> +  msg for CPU PCIe ports. Each of the PCIe ports has its dedicated VW
> 
> +  msg.
> 
> +
> 
> +  @param[in] PortIndex            Index of the CPU PCIe port for which VW
> 
> +                                  should be enabled.
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         Failed to set native mode.
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableCpuPcieVwClkReqMsgBus (
> 
> +  IN UINT32  PortIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets Time Sync Gpio into native mode
> 
> +
> 
> +  @param[in]  Index       index
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableTimeSync (
> 
> +  IN UINT32  Index
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets Tsn into native mode
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioEnableTsn (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function is to be used In GpioLockPads() to override a lock request by
> SOC code.
> 
> +
> 
> +  @param[in]  Group          GPIO group
> 
> +  @param[in]  DwNum          Register number for current group (parameter
> applicable in accessing whole register).
> 
> +                             For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] *UnlockCfgPad  DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                             Bit position - PadNumber
> 
> +                             Bit value - 0: to be locked, 1: Leave unlocked
> 
> +  @param[out] *UnlockTxPad   DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                             Bit position - PadNumber
> 
> +                             Bit value - 0: to be locked, 1: Leave unlocked
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid input parameter
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockOverride (
> 
> +  IN  GPIO_GROUP  Group,
> 
> +  IN  UINT32      DwNum,
> 
> +  OUT UINT32      *UnlockCfgPad,
> 
> +  OUT UINT32      *UnlockTxPad
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if 0x13 opcode supported for writing to GPIO lock unlock register
> 
> +
> 
> +  @retval TRUE                It's supported
> 
> +  @retval FALSE               It's not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGpioLockOpcodeSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures IO standby related settings for the GPIO pad.
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[in]  IoStandbyState      GPIO pad IO Standby state
> 
> +  @param[in]  IoStandbyTerm       GPIO pad IO Standby termination
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioConfigurePadIoStandby (
> 
> +  IN GPIO_PAD              GpioPad,
> 
> +  IN GPIO_IOSTANDBY_STATE  IoStandbyState,
> 
> +  IN GPIO_IOSTANDBY_TERM   IoStandbyTerm
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if GPIO PinMux corresponds to I2C4 B
> 
> +
> 
> +  @param[in] SdaPinMux    GPIO pad pinmux for SDA
> 
> +  @param[in] SclPinMux    GPIO pad pinmux for SCL
> 
> +
> 
> +  @retval TRUE         PinMux corresponds to I2C4 B
> 
> +          FALSE        PinMux equals to I2C4 A
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioIsSerialIoI2c4bMuxed (
> 
> +  IN UINT32  SdaPinMux,
> 
> +  IN UINT32  SclPinMux
> 
> +  );
> 
> +
> 
> +#endif // _GPIO_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.c
> new file mode 100644
> index 0000000000..5a6360931b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.c
> @@ -0,0 +1,140 @@
> +/** @file
> 
> +  Implementation of BaseGpioCheckConflictLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/GpioCheckConflictLib.h>
> 
> +#include <Uefi/UefiMultiPhase.h>
> 
> +#include <Pi/PiBootMode.h>
> 
> +#include <Pi/PiHob.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +
> 
> +/**
> 
> +  Check Gpio PadMode conflict and report it.
> 
> +
> 
> +  @retval     none.
> 
> +**/
> 
> +VOID
> 
> +GpioCheckConflict (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_HOB_GUID_TYPE              *GpioCheckConflictHob;
> 
> +  GPIO_PAD_MODE_INFO             *GpioCheckConflictHobData;
> 
> +  UINT32                          HobDataSize;
> 
> +  UINT32                          GpioCount;
> 
> +  UINT32                          GpioIndex;
> 
> +  GPIO_CONFIG                     GpioActualConfig;
> 
> +
> 
> +  GpioCheckConflictHob = NULL;
> 
> +  GpioCheckConflictHobData = NULL;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "GpioCheckConflict Start..\n"));
> 
> +
> 
> +  //
> 
> +  // Use Guid to find HOB.
> 
> +  //
> 
> +  GpioCheckConflictHob = (EFI_HOB_GUID_TYPE *) GetFirstGuidHob
> (&gGpioCheckConflictHobGuid);
> 
> +  if (GpioCheckConflictHob == NULL) {
> 
> +    DEBUG ((DEBUG_INFO, "[GPIO Conflict Check] No GPIO HOB found.\n"));
> 
> +  } else {
> 
> +    while (GpioCheckConflictHob != NULL) {
> 
> +      //
> 
> +      // Find the Data area pointer and Data size from the Hob
> 
> +      //
> 
> +      GpioCheckConflictHobData = (GPIO_PAD_MODE_INFO *)
> GET_GUID_HOB_DATA (GpioCheckConflictHob);
> 
> +      HobDataSize = GET_GUID_HOB_DATA_SIZE (GpioCheckConflictHob);
> 
> +
> 
> +      GpioCount = HobDataSize / sizeof (GPIO_PAD_MODE_INFO);
> 
> +      DEBUG ((DEBUG_INFO, "[GPIO Conflict Check] Hob : GpioCount =
> %d\n", GpioCount));
> 
> +
> 
> +      //
> 
> +      // Probe Gpio entries in Hob and compare which are conflicted
> 
> +      //
> 
> +      for (GpioIndex = 0; GpioIndex < GpioCount ; GpioIndex++) {
> 
> +        GpioGetPadConfig (GpioCheckConflictHobData[GpioIndex].GpioPad,
> &GpioActualConfig);
> 
> +        if (GpioCheckConflictHobData[GpioIndex].GpioPadMode !=
> GpioActualConfig.PadMode) {
> 
> +          DEBUG ((DEBUG_ERROR, "[GPIO Conflict Check] Identified conflict on
> pad %a (actual: 0x%X, expected: 0x%X)\n",
> 
> +                  GpioName (GpioCheckConflictHobData[GpioIndex].GpioPad),
> 
> +                  GpioActualConfig.PadMode,
> 
> +                  GpioCheckConflictHobData[GpioIndex].GpioPadMode));
> 
> +        }
> 
> +      }
> 
> +      //
> 
> +      // Find next Hob and return the Hob pointer by the specific Hob Guid
> 
> +      //
> 
> +      GpioCheckConflictHob = GET_NEXT_HOB (GpioCheckConflictHob);
> 
> +      GpioCheckConflictHob = GetNextGuidHob
> (&gGpioCheckConflictHobGuid, GpioCheckConflictHob);
> 
> +    }
> 
> +
> 
> +    DEBUG ((DEBUG_INFO, "GpioCheckConflict End.\n"));
> 
> +  }
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This libaray will create one Hob for each Gpio config table
> 
> +  without PadMode is GpioHardwareDefault
> 
> +
> 
> +  @param[in]  GpioDefinition    Point to Platform Gpio table
> 
> +  @param[in]  GpioTableCount    Number of Gpio table entries
> 
> +
> 
> +  @retval     none.
> 
> +**/
> 
> +VOID
> 
> +CreateGpioCheckConflictHob (
> 
> +  IN GPIO_INIT_CONFIG          *GpioDefinition,
> 
> +  IN UINT32                    GpioTableCount
> 
> +  )
> 
> +{
> 
> +
> 
> +  UINT32                   Index;
> 
> +  UINT32                   GpioIndex;
> 
> +  GPIO_PAD_MODE_INFO       *GpioCheckConflictHobData;
> 
> +  UINT16                   GpioCount;
> 
> +
> 
> +  GpioCount = 0;
> 
> +  GpioIndex = 0;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "CreateGpioCheckConflictHob Start \n"));
> 
> +
> 
> +  for (Index = 0; Index < GpioTableCount ; Index++) {
> 
> +    if (GpioDefinition[Index].GpioConfig.PadMode == GpioHardwareDefault)
> {
> 
> +      continue;
> 
> +    } else {
> 
> +      //
> 
> +      // Calculate non-default GPIO number
> 
> +      //
> 
> +      GpioCount++;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Build a HOB tagged with a GUID for identification and returns
> 
> +  // the start address of GUID HOB data.
> 
> +  //
> 
> +  GpioCheckConflictHobData = (GPIO_PAD_MODE_INFO *) BuildGuidHob
> (&gGpioCheckConflictHobGuid , GpioCount * sizeof
> (GPIO_PAD_MODE_INFO));
> 
> +
> 
> +  //
> 
> +  // Record Non Default Gpio entries to the Hob
> 
> +  //
> 
> +  for (Index = 0; Index < GpioTableCount; Index++) {
> 
> +    if (GpioDefinition[Index].GpioConfig.PadMode == GpioHardwareDefault)
> {
> 
> +      continue;
> 
> +    } else {
> 
> +      if (GpioCheckConflictHobData != NULL) {
> 
> +        GpioCheckConflictHobData[GpioIndex].GpioPad =
> GpioDefinition[Index].GpioPad;
> 
> +        GpioCheckConflictHobData[GpioIndex].GpioPadMode =
> GpioDefinition[Index].GpioConfig.PadMode;
> 
> +        GpioIndex++;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "CreateGpioCheckConflictHob End \n"));
> 
> +  return;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.inf
> new file mode 100644
> index 0000000000..f7e1de774d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLib/BaseGpioCheckConflictLib.inf
> @@ -0,0 +1,29 @@
> +## @file
> 
> +#  Component information file for BaseGpioCheckConflictLib.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +[Defines]
> 
> +  INF_VERSION                    = 0x00010017
> 
> +  BASE_NAME                      = BaseGpioCheckConflictLib
> 
> +  FILE_GUID                      = C19A848A-F013-4DBF-9C23-F0F74DEA6F14
> 
> +  MODULE_TYPE                    = BASE
> 
> +  VERSION_STRING                 = 1.0
> 
> +  LIBRARY_CLASS                  = GpioCheckConflictLib
> 
> +
> 
> +[LibraryClasses]
> 
> +  DebugLib
> 
> +  HobLib
> 
> +  GpioLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +  BaseGpioCheckConflictLib.c
> 
> +
> 
> +[Guids]
> 
> +  gGpioCheckConflictHobGuid
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.c
> new file mode 100644
> index 0000000000..2f83f95b27
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.c
> @@ -0,0 +1,35 @@
> +/** @file
> 
> +  Implementation of BaseGpioCheckConflicLibNull.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/GpioCheckConflictLib.h>
> 
> +
> 
> +/**
> 
> +  Check Gpio PadMode conflict and report it.
> 
> +**/
> 
> +VOID
> 
> +GpioCheckConflict (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This libaray will create one Hob for each Gpio config table
> 
> +  without PadMode is GpioHardwareDefault
> 
> +
> 
> +  @param[in]  GpioDefinition    Point to Platform Gpio table
> 
> +  @param[in]  GpioTableCount    Number of Gpio table entries
> 
> +**/
> 
> +VOID
> 
> +CreateGpioCheckConflictHob (
> 
> +  IN GPIO_INIT_CONFIG          *GpioDefinition,
> 
> +  IN UINT32                    GpioTableCount
> 
> +  )
> 
> +{
> 
> +  return;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.inf
> new file mode 100644
> index 0000000000..1c226d7c16
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/BaseGpioCheckConf
> lictLibNull/BaseGpioCheckConflictLibNull.inf
> @@ -0,0 +1,26 @@
> +## @file
> 
> +#  Component information file for BaseGpioCheckConflictLib.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +[Defines]
> 
> +  INF_VERSION                    = 0x00010017
> 
> +  BASE_NAME                      = BaseGpioCheckConflictLibNull
> 
> +  FILE_GUID                      = C19A848A-F013-4DBF-9C23-F0F74DEA6F14
> 
> +  MODULE_TYPE                    = BASE
> 
> +  VERSION_STRING                 = 1.0
> 
> +  LIBRARY_CLASS                  = GpioCheckConflictLib
> 
> +
> 
> +[LibraryClasses]
> 
> +  DebugLib
> 
> +  HobLib
> 
> +  GpioLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +  BaseGpioCheckConflictLibNull.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> GpioInit.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioInit.c
> new file mode 100644
> index 0000000000..99dbbf0ca6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioInit.c
> @@ -0,0 +1,558 @@
> +/** @file
> 
> +  This file contains routines for GPIO initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "GpioLibrary.h"
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Library/GpioCheckConflictLib.h>
> 
> +
> 
> +//
> 
> +// GPIO_GROUP_DW_DATA structure is used by GpioConfigurePch
> function
> 
> +// to cache values which will be programmed into respective GPIO registers
> 
> +// after all GpioPads are processed. This way MMIO accesses are decreased
> 
> +// and instead of doing one programming for one GpioPad there is only
> 
> +// one access for whole register.
> 
> +//
> 
> +typedef struct {
> 
> +  UINT32             HostSoftOwnReg;
> 
> +  UINT32             HostSoftOwnRegMask;
> 
> +  UINT32             GpiGpeEnReg;
> 
> +  UINT32             GpiGpeEnRegMask;
> 
> +  UINT32             GpiNmiEnReg;
> 
> +  UINT32             GpiNmiEnRegMask;
> 
> +  UINT32             GpiSmiEnReg;
> 
> +  UINT32             GpiSmiEnRegMask;
> 
> +  UINT32             ConfigUnlockMask;
> 
> +  UINT32             OutputUnlockMask;
> 
> +} GPIO_GROUP_DW_DATA;
> 
> +
> 
> +//
> 
> +// GPIO_GROUP_DW_NUMBER contains number of DWords required to
> 
> +// store Pad data for all groups. Each pad uses one bit.
> 
> +//
> 
> +#define GPIO_GROUP_DW_NUMBER  1
> 
> +
> 
> +/**
> 
> +  Get GPIO DW Register values (HOSTSW_OWN, GPE_EN, NMI_EN, Lock).
> 
> +
> 
> +  @param[in]     PadNumber      GPIO pad number
> 
> +  @param[in]     GpioConfig     GPIO Config data
> 
> +  @param[in out] DwRegsValues   Values for GPIO DW Registers
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +GpioDwRegValueFromGpioConfig (
> 
> +  IN UINT32                 PadNumber,
> 
> +  IN CONST GPIO_CONFIG      *GpioConfig,
> 
> +  IN OUT GPIO_GROUP_DW_DATA *GroupDwData
> 
> +  )
> 
> +{
> 
> +  UINT32  PadBitPosition;
> 
> +  UINT32  DwNum;
> 
> +
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +
> 
> +  if (DwNum >= GPIO_GROUP_DW_NUMBER) {
> 
> +    ASSERT (FALSE);
> 
> +    return;
> 
> +  }
> 
> +  //
> 
> +  // Update value to be programmed in HOSTSW_OWN register
> 
> +  //
> 
> +  GroupDwData[DwNum].HostSoftOwnRegMask |= (GpioConfig-
> >HostSoftPadOwn & 0x1) << PadBitPosition;
> 
> +  GroupDwData[DwNum].HostSoftOwnReg |= (GpioConfig-
> >HostSoftPadOwn >> 0x1) << PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_GPE_EN register
> 
> +  //
> 
> +  GroupDwData[DwNum].GpiGpeEnRegMask |= (GpioConfig-
> >InterruptConfig & 0x1) << PadBitPosition;
> 
> +  GroupDwData[DwNum].GpiGpeEnReg |= ((GpioConfig->InterruptConfig &
> GpioIntSci) >> 3) << PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_NMI_EN register
> 
> +  //
> 
> +  GroupDwData[DwNum].GpiNmiEnRegMask |= (GpioConfig-
> >InterruptConfig & 0x1) << PadBitPosition;
> 
> +  GroupDwData[DwNum].GpiNmiEnReg |= ((GpioConfig->InterruptConfig &
> GpioIntNmi) >> 1) << PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_SMI_EN register
> 
> +  GroupDwData[DwNum].GpiSmiEnRegMask |= (GpioConfig-
> >InterruptConfig & 0x1) << PadBitPosition;
> 
> +  GroupDwData[DwNum].GpiSmiEnReg |= ((GpioConfig->InterruptConfig &
> GpioIntSmi) >> 2) << PadBitPosition;
> 
> +  if ((GpioConfig->InterruptConfig & GpioIntSmi) == GpioIntSmi) {
> 
> +    GroupDwData[DwNum].HostSoftOwnRegMask |= 1 << PadBitPosition;
> 
> +    GroupDwData[DwNum].HostSoftOwnReg |= 1 << PadBitPosition;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Update information on Pad Configuration Lock
> 
> +  //
> 
> +  GroupDwData[DwNum].ConfigUnlockMask |= ((GpioConfig->LockConfig
> >> 1) & 0x1) << PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // Update information on Pad Configuration Lock Tx
> 
> +  //
> 
> +  GroupDwData[DwNum].OutputUnlockMask |= ((GpioConfig->LockConfig
> >> 3) & 0x1) << PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // if pad in GpioMode is an output default action should be to leave output
> unlocked
> 
> +  //
> 
> +  if ((GpioConfig->PadMode == GpioPadModeGpio) &&
> 
> +      (GpioConfig->Direction == GpioDirOut) &&
> 
> +      ((GpioConfig->LockConfig &
> B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) == GpioLockDefault)) {
> 
> +    GroupDwData[DwNum].OutputUnlockMask |= 0x1 << PadBitPosition;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This internal procedure will scan GPIO initialization table and unlock
> 
> +  all pads present in it
> 
> +
> 
> +  @param[in] NumberOfItem               Number of GPIO pad records in table
> 
> +  @param[in] GpioInitTableAddress       GPIO initialization table
> 
> +  @param[in] Index                      Index of GPIO Initialization table record
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioUnlockPadsForAGroup (
> 
> +  IN UINT32                    NumberOfItems,
> 
> +  IN GPIO_INIT_CONFIG          *GpioInitTableAddress,
> 
> +  IN UINT32                    Index
> 
> +  )
> 
> +{
> 
> +  UINT32                 PadsToUnlock[GPIO_GROUP_DW_NUMBER];
> 
> +  UINT32                 DwNum;
> 
> +  UINT32                 PadBitPosition;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  CONST GPIO_INIT_CONFIG *GpioData;
> 
> +  GPIO_GROUP             Group;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  GpioData   = &GpioInitTableAddress[Index];
> 
> +  Group      = GpioGetGroupFromGpioPad (GpioData->GpioPad);
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioData->GpioPad);
> 
> +
> 
> +  ZeroMem (PadsToUnlock, sizeof (PadsToUnlock));
> 
> +  //
> 
> +  // Loop through pads for one group. If pad belongs to a different group
> then
> 
> +  // break and move to register programming.
> 
> +  //
> 
> +  while (Index < NumberOfItems) {
> 
> +
> 
> +    GpioData   = &GpioInitTableAddress[Index];
> 
> +    if (GroupIndex != GpioGetGroupIndexFromGpioPad (GpioData-
> >GpioPad)) {
> 
> +      //if next pad is from different group then break loop
> 
> +      break;
> 
> +    }
> 
> +
> 
> +    PadNumber  = GpioGetPadNumberFromGpioPad (GpioData->GpioPad);
> 
> +    //
> 
> +    // Check if legal pin number
> 
> +    //
> 
> +    if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
> 
> +      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds
> possible range for group %d\n", PadNumber, GroupIndex));
> 
> +      return EFI_INVALID_PARAMETER;
> 
> +    }
> 
> +
> 
> +    PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +    DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +
> 
> +    if (DwNum >= GPIO_GROUP_DW_NUMBER) {
> 
> +      ASSERT (FALSE);
> 
> +      return EFI_UNSUPPORTED;
> 
> +    }
> 
> +    //
> 
> +    // Update pads which need to be unlocked
> 
> +    //
> 
> +    PadsToUnlock[DwNum] |= 0x1 << PadBitPosition;
> 
> +
> 
> +    //Move to next item
> 
> +    Index++;
> 
> +  }
> 
> +
> 
> +  for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +    //
> 
> +    // Unlock pads
> 
> +    //
> 
> +    if (PadsToUnlock[DwNum] != 0) {
> 
> +      GpioUnlockPadCfgForGroupDw (Group, DwNum,
> PadsToUnlock[DwNum]);
> 
> +      GpioUnlockPadCfgTxForGroupDw (Group, DwNum,
> PadsToUnlock[DwNum]);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will initialize multiple PCH GPIO pins
> 
> +
> 
> +  @param[in] NumberofItem               Number of GPIO pads to be updated
> 
> +  @param[in] GpioInitTableAddress       GPIO initialization table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioConfigurePch (
> 
> +  IN UINT32                    NumberOfItems,
> 
> +  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
> 
> +  )
> 
> +{
> 
> +  UINT32                 Index;
> 
> +  UINT32                 PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
> 
> +  UINT32                 PadCfgDwRegMask[GPIO_PADCFG_DW_REG_NUMBER];
> 
> +  UINT32                 PadCfgReg;
> 
> +  GPIO_GROUP_DW_DATA     GroupDwData[GPIO_GROUP_DW_NUMBER];
> 
> +  UINT32                 DwNum;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  GPIO_PAD_OWN           PadOwnVal;
> 
> +  CONST GPIO_INIT_CONFIG *GpioData;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +  PCH_SBI_PID            GpioCom;
> 
> +
> 
> +  PadOwnVal = GpioPadOwnHost;
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  Index = 0;
> 
> +  while (Index < NumberOfItems) {
> 
> +
> 
> +    GpioData   = &GpioInitTableAddress[Index];
> 
> +    GroupIndex = GpioGetGroupIndexFromGpioPad (GpioData->GpioPad);
> 
> +    GpioCom    = GpioGroupInfo[GroupIndex].Community;
> 
> +
> 
> +    DEBUG_CODE_BEGIN();
> 
> +    if (!GpioIsCorrectPadForThisChipset (GpioData->GpioPad)) {
> 
> +      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Incorrect GpioPad (0x%08x)
> used on this chipset!\n", GpioData->GpioPad));
> 
> +      ASSERT (FALSE);
> 
> +      return EFI_UNSUPPORTED;
> 
> +    }
> 
> +    DEBUG_CODE_END ();
> 
> +
> 
> +    //
> 
> +    // Unlock pads for a given group which are going to be reconfigured
> 
> +    //
> 
> +    //
> 
> +    // Because PADCFGLOCK/LOCKTX register reset domain is Powergood,
> lock settings
> 
> +    // will get back to default only after G3 or DeepSx transition. On the other
> hand GpioPads
> 
> +    // configuration is controlled by a configurable type of reset - PadRstCfg.
> This means that if
> 
> +    // PadRstCfg != Powergood GpioPad will have its configuration locked
> despite it being not the
> 
> +    // one desired by BIOS. Before reconfiguring all pads they will get
> unlocked.
> 
> +    //
> 
> +    GpioUnlockPadsForAGroup (NumberOfItems, GpioInitTableAddress,
> Index);
> 
> +
> 
> +    ZeroMem (GroupDwData, sizeof (GroupDwData));
> 
> +    //
> 
> +    // Loop through pads for one group. If pad belongs to a different group
> then
> 
> +    // break and move to register programming.
> 
> +    //
> 
> +    while (Index < NumberOfItems) {
> 
> +
> 
> +      GpioData   = &GpioInitTableAddress[Index];
> 
> +      if (GroupIndex != GpioGetGroupIndexFromGpioPad (GpioData-
> >GpioPad)) {
> 
> +        //if next pad is from different group then break loop
> 
> +        break;
> 
> +      }
> 
> +
> 
> +      PadNumber  = GpioGetPadNumberFromGpioPad (GpioData->GpioPad);
> 
> +
> 
> +      DEBUG_CODE_BEGIN ();
> 
> +      //
> 
> +      // Check if legal pin number
> 
> +      //
> 
> +      if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds
> possible range for group %d\n", PadNumber, GroupIndex));
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Check if selected GPIO Pad is not owned by CSME/ISH
> 
> +      //
> 
> +      GpioGetPadOwnership (GpioData->GpioPad, &PadOwnVal);
> 
> +
> 
> +      if (PadOwnVal != GpioPadOwnHost) {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Accessing pad not owned by
> host (Group=%d, Pad=%d)!\n", GroupIndex, PadNumber));
> 
> +        DEBUG ((DEBUG_ERROR, "** Please make sure the GPIO usage in sync
> between CSME and BIOS configuration. \n"));
> 
> +        DEBUG ((DEBUG_ERROR, "** All the GPIO occupied by CSME should not
> do any configuration by BIOS.\n"));
> 
> +        //Move to next item
> 
> +        Index++;
> 
> +        continue;
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Check if Pad enabled for SCI is to be in unlocked state
> 
> +      //
> 
> +      if (((GpioData->GpioConfig.InterruptConfig & GpioIntSci) == GpioIntSci)
> &&
> 
> +          ((GpioData->GpioConfig.LockConfig &
> B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK) !=
> GpioPadConfigUnlock)){
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a used for SCI is not
> unlocked!\n", GpioName (GpioData->GpioPad)));
> 
> +        ASSERT (FALSE);
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +      DEBUG_CODE_END ();
> 
> +
> 
> +      ZeroMem (PadCfgDwReg, sizeof (PadCfgDwReg));
> 
> +      ZeroMem (PadCfgDwRegMask, sizeof (PadCfgDwRegMask));
> 
> +      //
> 
> +      // Get GPIO PADCFG register value from GPIO config data
> 
> +      //
> 
> +      GpioPadCfgRegValueFromGpioConfig (
> 
> +        GpioData->GpioPad,
> 
> +        &GpioData->GpioConfig,
> 
> +        PadCfgDwReg,
> 
> +        PadCfgDwRegMask
> 
> +        );
> 
> +
> 
> +      //
> 
> +      // Create PADCFG register offset using group and pad number
> 
> +      //
> 
> +      PadCfgReg = S_GPIO_PCR_PADCFG * PadNumber +
> GpioGroupInfo[GroupIndex].PadCfgOffset;
> 
> +
> 
> +      //
> 
> +      // Write PADCFG DW0 register
> 
> +      //
> 
> +      MmioAndThenOr32 (
> 
> +        PCH_PCR_ADDRESS (GpioCom, PadCfgReg),
> 
> +        ~PadCfgDwRegMask[0],
> 
> +        PadCfgDwReg[0]
> 
> +        );
> 
> +      //
> 
> +      // Write PADCFG DW1 register
> 
> +      //
> 
> +      MmioAndThenOr32 (
> 
> +        PCH_PCR_ADDRESS (GpioCom, PadCfgReg + 0x4),
> 
> +        ~PadCfgDwRegMask[1],
> 
> +        PadCfgDwReg[1]
> 
> +        );
> 
> +
> 
> +      //
> 
> +      // Write PADCFG DW2 register
> 
> +      //
> 
> +      MmioAndThenOr32 (
> 
> +        PCH_PCR_ADDRESS (GpioCom, PadCfgReg + 0x8),
> 
> +        ~PadCfgDwRegMask[2],
> 
> +        PadCfgDwReg[2]
> 
> +        );
> 
> +
> 
> +      //
> 
> +      // Get GPIO DW register values from GPIO config data
> 
> +      //
> 
> +      GpioDwRegValueFromGpioConfig (
> 
> +        PadNumber,
> 
> +        &GpioData->GpioConfig,
> 
> +        GroupDwData
> 
> +        );
> 
> +
> 
> +      //Move to next item
> 
> +      Index++;
> 
> +    }
> 
> +
> 
> +    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +      //
> 
> +      // Write HOSTSW_OWN registers
> 
> +      //
> 
> +      if (GpioGroupInfo[GroupIndex].HostOwnOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +        MmioAndThenOr32 (
> 
> +          PCH_PCR_ADDRESS (GpioCom,
> GpioGroupInfo[GroupIndex].HostOwnOffset + DwNum * 0x4),
> 
> +          ~GroupDwData[DwNum].HostSoftOwnRegMask,
> 
> +          GroupDwData[DwNum].HostSoftOwnReg
> 
> +          );
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Write GPI_GPE_EN registers
> 
> +      //
> 
> +      if (GpioGroupInfo[GroupIndex].GpiGpeEnOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +        MmioAndThenOr32 (
> 
> +          PCH_PCR_ADDRESS (GpioCom,
> GpioGroupInfo[GroupIndex].GpiGpeEnOffset + DwNum * 0x4),
> 
> +          ~GroupDwData[DwNum].GpiGpeEnRegMask,
> 
> +          GroupDwData[DwNum].GpiGpeEnReg
> 
> +          );
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Write GPI_NMI_EN registers
> 
> +      //
> 
> +      if (GpioGroupInfo[GroupIndex].NmiEnOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +        MmioAndThenOr32 (
> 
> +          PCH_PCR_ADDRESS (GpioCom,
> GpioGroupInfo[GroupIndex].NmiEnOffset + DwNum * 0x4),
> 
> +          ~GroupDwData[DwNum].GpiNmiEnRegMask,
> 
> +          GroupDwData[DwNum].GpiNmiEnReg
> 
> +          );
> 
> +      } else if (GroupDwData[DwNum].GpiNmiEnReg != 0x0) {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %d has no pads
> supporting NMI\n", GroupIndex));
> 
> +        ASSERT_EFI_ERROR (EFI_UNSUPPORTED);
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Write GPI_SMI_EN registers
> 
> +      //
> 
> +      if (GpioGroupInfo[GroupIndex].SmiEnOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +        MmioAndThenOr32 (
> 
> +          PCH_PCR_ADDRESS (GpioCom,
> GpioGroupInfo[GroupIndex].SmiEnOffset + DwNum * 0x4),
> 
> +          ~GroupDwData[DwNum].GpiSmiEnRegMask,
> 
> +          GroupDwData[DwNum].GpiSmiEnReg
> 
> +          );
> 
> +      } else if (GroupDwData[DwNum].GpiSmiEnReg != 0x0) {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %d has no pads
> supporting SMI\n", GroupIndex));
> 
> +        ASSERT_EFI_ERROR (EFI_UNSUPPORTED);
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Update Pad Configuration unlock data
> 
> +      //
> 
> +      if (GroupDwData[DwNum].ConfigUnlockMask) {
> 
> +        GpioStoreGroupDwUnlockPadConfigData (GroupIndex, DwNum,
> GroupDwData[DwNum].ConfigUnlockMask);
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Update Pad Output unlock data
> 
> +      //
> 
> +      if (GroupDwData[DwNum].OutputUnlockMask) {
> 
> +        GpioStoreGroupDwUnlockOutputData (GroupIndex, DwNum,
> GroupDwData[DwNum].OutputUnlockMask);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will clear all status bits of any GPIO interrupts.
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioClearAllGpioInterrupts (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP             Group;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  GPIO_GROUP             GpioGroupLowest;
> 
> +  GPIO_GROUP             GpioGroupHighest;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 DwNum;
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  GpioGroupLowest = GpioGetLowestGroup ();
> 
> +  GpioGroupHighest = GpioGetHighestGroup ();
> 
> +
> 
> +  for (Group = GpioGroupLowest; Group <= GpioGroupHighest; Group++) {
> 
> +    GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +    //
> 
> +    // Check if group has GPI IS register
> 
> +    //
> 
> +    if (GpioGroupInfo[GroupIndex].GpiIsOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +      //
> 
> +      // Clear all GPI_IS Status bits by writing '1'
> 
> +      //
> 
> +      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +        MmioWrite32 (
> 
> +          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> GpioGroupInfo[GroupIndex].GpiIsOffset + DwNum * 0x4),
> 
> +          0xFFFFFFFF
> 
> +          );
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Check if group has GPI_GPE_STS register
> 
> +    //
> 
> +    if (GpioGroupInfo[GroupIndex].GpiGpeStsOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +      //
> 
> +      // Clear all GPI_GPE_STS Status bits by writing '1'
> 
> +      //
> 
> +      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +        MmioWrite32 (
> 
> +          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> GpioGroupInfo[GroupIndex].GpiGpeStsOffset + DwNum * 0x4),
> 
> +          0xFFFFFFFF
> 
> +          );
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Check if group has SMI_STS register
> 
> +    //
> 
> +    if (GpioGroupInfo[GroupIndex].SmiStsOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +      //
> 
> +      // Clear all SMI_STS Status bits by writing '1'
> 
> +      //
> 
> +      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +        MmioWrite32 (
> 
> +          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> GpioGroupInfo[GroupIndex].SmiStsOffset + DwNum * 4),
> 
> +          0xFFFFFFFF
> 
> +          );
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Check if group has NMI_STS register
> 
> +    //
> 
> +    if (GpioGroupInfo[GroupIndex].NmiStsOffset !=
> NO_REGISTER_FOR_PROPERTY) {
> 
> +      //
> 
> +      // Clear all NMI_STS Status bits by writing '1'
> 
> +      //
> 
> +      for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup); DwNum++) {
> 
> +        MmioWrite32 (
> 
> +          PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> GpioGroupInfo[GroupIndex].NmiStsOffset + DwNum * 4),
> 
> +          0xFFFFFFFF
> 
> +          );
> 
> +      }
> 
> +    }
> 
> +
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will initialize multiple GPIO pins. Use GPIO_INIT_CONFIG
> structure.
> 
> +  Structure contains fields that can be used to configure each pad.
> 
> +  Pad not configured using GPIO_INIT_CONFIG will be left with hardware
> default values.
> 
> +  Separate fields could be set to hardware default if it does not matter,
> except
> 
> +  GpioPad and PadMode.
> 
> +  Function will work in most efficient way if pads which belong to the same
> group are
> 
> +  placed in adjacent records of the table.
> 
> +  Although function can enable pads for Native mode, such programming is
> done
> 
> +  by reference code when enabling related silicon feature.
> 
> +
> 
> +  @param[in] NumberofItem               Number of GPIO pads to be updated
> 
> +  @param[in] GpioInitTableAddress       GPIO initialization table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioConfigurePads (
> 
> +  IN UINT32                    NumberOfItems,
> 
> +  IN GPIO_INIT_CONFIG          *GpioInitTableAddress
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS   Status;
> 
> +
> 
> +  Status =  GpioConfigurePch (NumberOfItems, GpioInitTableAddress);
> 
> +
> 
> +  CreateGpioCheckConflictHob (GpioInitTableAddress, NumberOfItems);
> 
> +
> 
> +  GpioClearAllGpioInterrupts ();
> 
> +  return Status;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> GpioLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioLib.c
> new file mode 100644
> index 0000000000..d6c13fe581
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioLib.c
> @@ -0,0 +1,2387 @@
> +/** @file
> 
> +  This file contains routines for GPIO
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "GpioLibrary.h"
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +/**
> 
> +  This procedure will check if GpioGroup argument is correct and
> 
> +  supplied DW reg number can be used for this group to access DW registers.
> 
> +  Function will check below conditions:
> 
> +   - Valid GpioGroup
> 
> +   - DwNum is has valid value for this group
> 
> +
> 
> +  @param[in] Group        GPIO group
> 
> +  @param[in] DwNum        Register number for current group (parameter
> applicable in accessing whole register).
> 
> +                          For group which has less then 32 pads per group DwNum must
> be 0.
> 
> +
> 
> +  @retval TRUE             DW Reg number and GpioGroup is valid
> 
> +  @retval FALSE            DW Reg number and GpioGroup is invalid
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +GpioIsGroupAndDwNumValid (
> 
> +  IN GPIO_GROUP             Group,
> 
> +  IN UINT32                 DwNum
> 
> +  )
> 
> +{
> 
> +  UINT32                 GroupIndex;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +
> 
> +  if ((Group < GpioGetLowestGroup ()) || (Group > GpioGetHighestGroup
> ()) || (GroupIndex >= GpioGroupInfoLength)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group argument (%d) is not
> within range of possible groups for this PCH\n", GroupIndex));
> 
> +    goto Error;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if DwNum argument does not exceed number of DWord registers
> 
> +  // resulting from available pads for certain group
> 
> +  //
> 
> +  if (DwNum > GPIO_GET_DW_NUM
> (GpioGroupInfo[GroupIndex].PadPerGroup - 1)){
> 
> +    goto Error;
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +Error:
> 
> +  ASSERT (FALSE);
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +//
> 
> +// Possible registers to be accessed using GpioReadReg()/GpioWriteReg()
> functions
> 
> +//
> 
> +typedef enum {
> 
> +  GpioHostOwnershipRegister = 0,
> 
> +  GpioGpeEnableRegister,
> 
> +  GpioGpeStatusRegister,
> 
> +  GpioSmiEnableRegister,
> 
> +  GpioSmiStatusRegister,
> 
> +  GpioNmiEnableRegister,
> 
> +  GpioPadConfigLockRegister,
> 
> +  GpioPadLockOutputRegister
> 
> +} GPIO_REG;
> 
> +
> 
> +/**
> 
> +  This procedure will read GPIO register
> 
> +
> 
> +  @param[in] RegType              GPIO register type
> 
> +  @param[in] Group                GPIO group
> 
> +  @param[in] DwNum                Register number for current group
> (parameter applicable in accessing whole register).
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] ReadVal             Read data
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         Feature is not supported for this group or
> pad
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioReadReg (
> 
> +  IN GPIO_REG               RegType,
> 
> +  IN GPIO_GROUP             Group,
> 
> +  IN UINT32                 DwNum,
> 
> +  OUT UINT32                *ReadVal
> 
> +  )
> 
> +{
> 
> +  UINT32                 RegOffset;
> 
> +  UINT32                 GroupIndex;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +
> 
> +  RegOffset = NO_REGISTER_FOR_PROPERTY;
> 
> +  GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  switch (RegType) {
> 
> +    case GpioHostOwnershipRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset;
> 
> +      break;
> 
> +    case GpioGpeEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeEnOffset;
> 
> +      break;
> 
> +    case GpioGpeStatusRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeStsOffset;
> 
> +      break;
> 
> +    case GpioSmiEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].SmiEnOffset;
> 
> +      break;
> 
> +    case GpioSmiStatusRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset;
> 
> +      break;
> 
> +    case GpioNmiEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].NmiEnOffset;
> 
> +      break;
> 
> +    case GpioPadConfigLockRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockOffset;
> 
> +      break;
> 
> +    case GpioPadLockOutputRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockTxOffset;
> 
> +      break;
> 
> +    default:
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if selected register exists
> 
> +  //
> 
> +  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If there are more then 32 pads per group then certain
> 
> +  // group information would be split into more then one DWord register.
> 
> +  //
> 
> +  if ((RegType == GpioPadConfigLockRegister) || (RegType ==
> GpioPadLockOutputRegister)) {
> 
> +    //
> 
> +    // PadConfigLock and OutputLock registers when used for group
> containing more than 32 pads
> 
> +    // are not placed in a continuous way, e.g:
> 
> +    // 0x0 - PadConfigLock_DW0
> 
> +    // 0x4 - OutputLock_DW0
> 
> +    // 0x8 - PadConfigLock_DW1
> 
> +    // 0xC - OutputLock_DW1
> 
> +    //
> 
> +    RegOffset += DwNum * 0x8;
> 
> +  } else {
> 
> +    RegOffset += DwNum * 0x4;
> 
> +  }
> 
> +
> 
> +  *ReadVal = MmioRead32 (PCH_PCR_ADDRESS
> (GpioGroupInfo[GroupIndex].Community, RegOffset));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will write GPIO register
> 
> +
> 
> +  @param[in] RegType              GPIO register type
> 
> +  @param[in] Group                GPIO group
> 
> +  @param[in] DwNum                Register number for current group
> (parameter applicable in accessing whole register).
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in] RegAndMask           Mask which will be AND'ed with register
> value
> 
> +  @param[in] RegOrMask            Mask which will be OR'ed with register value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         Feature is not supported for this group or
> pad
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioWriteReg (
> 
> +  IN GPIO_REG               RegType,
> 
> +  IN GPIO_GROUP             Group,
> 
> +  IN UINT32                 DwNum,
> 
> +  IN UINT32                 RegAndMask,
> 
> +  IN UINT32                 RegOrMask
> 
> +  )
> 
> +{
> 
> +  UINT32                 RegOffset;
> 
> +  UINT32                 GroupIndex;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 PadCfgLock;
> 
> +  BOOLEAN                Lockable;
> 
> +
> 
> +  Lockable = FALSE;
> 
> +  PadCfgLock = 0;
> 
> +  RegOffset = NO_REGISTER_FOR_PROPERTY;
> 
> +  GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  switch (RegType) {
> 
> +    case GpioHostOwnershipRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset;
> 
> +      break;
> 
> +    case GpioGpeEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeEnOffset;
> 
> +      Lockable = TRUE;
> 
> +      break;
> 
> +    case GpioGpeStatusRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].GpiGpeStsOffset;
> 
> +      break;
> 
> +    case GpioSmiEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].SmiEnOffset;
> 
> +      Lockable = TRUE;
> 
> +      break;
> 
> +    case GpioSmiStatusRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset;
> 
> +      break;
> 
> +    case GpioNmiEnableRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].NmiEnOffset;
> 
> +      Lockable = TRUE;
> 
> +      break;
> 
> +    case GpioPadConfigLockRegister:
> 
> +    case GpioPadLockOutputRegister:
> 
> +    default:
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if selected register exists
> 
> +  //
> 
> +  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (Lockable) {
> 
> +    GpioGetPadCfgLockForGroupDw (Group, DwNum, &PadCfgLock);
> 
> +    if (PadCfgLock) {
> 
> +      //
> 
> +      // Check if for pads which are going to be reconfigured lock is set.
> 
> +      //
> 
> +      if ((~RegAndMask | RegOrMask) & PadCfgLock) {
> 
> +        //
> 
> +        // Unlock all pads for this Group DW reg for simplicity
> 
> +        // even if not all of those pads will have their settings reprogrammed
> 
> +        //
> 
> +        GpioUnlockPadCfgForGroupDw (Group, DwNum, PadCfgLock);
> 
> +      } else {
> 
> +        //
> 
> +        // No need to perform an unlock as pads which are going to be
> reconfigured
> 
> +        // are not in locked state
> 
> +        //
> 
> +        PadCfgLock = 0;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If there are more then 32 pads per group then certain
> 
> +  // group information would be split into more then one DWord register.
> 
> +  //
> 
> +  RegOffset += DwNum * 0x4;
> 
> +
> 
> +  MmioAndThenOr32 (
> 
> +    PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> RegOffset),
> 
> +    RegAndMask,
> 
> +    RegOrMask
> 
> +    );
> 
> +
> 
> +  if (Lockable && PadCfgLock) {
> 
> +    //
> 
> +    // Lock previously unlocked pads
> 
> +    //
> 
> +    GpioLockPadCfgForGroupDw (Group, DwNum, PadCfgLock);
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will write GPIO Lock/LockTx register using SBI.
> 
> +
> 
> +  @param[in] RegType              GPIO register (Lock or LockTx)
> 
> +  @param[in] Group                GPIO group number
> 
> +  @param[in] DwNum                Register number for current group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in] LockRegAndMask       Mask which will be AND'ed with Lock
> register value
> 
> +  @param[in] LockRegOrMask        Mask which will be Or'ed with Lock
> register value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_UNSUPPORTED         Feature is not supported for this group or
> pad
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +GpioWriteLockReg (
> 
> +  IN GPIO_REG                  RegType,
> 
> +  IN GPIO_GROUP                Group,
> 
> +  IN UINT32                    DwNum,
> 
> +  IN UINT32                    LockRegAndMask,
> 
> +  IN UINT32                    LockRegOrMask
> 
> +  )
> 
> +{
> 
> +  UINT8                  Response;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 RegOffset;
> 
> +  UINT32                 OldLockVal;
> 
> +  UINT32                 NewLockVal;
> 
> +  UINT32                 GroupIndex;
> 
> +  EFI_STATUS             Status;
> 
> +  PCH_SBI_OPCODE         Opcode;
> 
> +
> 
> +  OldLockVal = 0;
> 
> +  NewLockVal = 0;
> 
> +
> 
> +  RegOffset = NO_REGISTER_FOR_PROPERTY;
> 
> +  GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  switch (RegType) {
> 
> +    case GpioPadConfigLockRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockOffset;
> 
> +      GpioGetPadCfgLockForGroupDw (Group, DwNum, &OldLockVal);
> 
> +      break;
> 
> +    case GpioPadLockOutputRegister:
> 
> +      RegOffset = GpioGroupInfo[GroupIndex].PadCfgLockTxOffset;
> 
> +      GpioGetPadCfgLockTxForGroupDw (Group, DwNum, &OldLockVal);
> 
> +      break;
> 
> +    default:
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if selected register exists
> 
> +  //
> 
> +  if (RegOffset == NO_REGISTER_FOR_PROPERTY) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If there are more then 32 pads per group then certain
> 
> +  // group information would be split into more then one DWord register.
> 
> +  // PadConfigLock and OutputLock registers when used for group
> containing more than 32 pads
> 
> +  // are not placed in a continuous way, e.g:
> 
> +  // 0x0 - PadConfigLock_DW0
> 
> +  // 0x4 - OutputLock_DW0
> 
> +  // 0x8 - PadConfigLock_DW1
> 
> +  // 0xC - OutputLock_DW1
> 
> +  //
> 
> +  RegOffset += DwNum *0x8;
> 
> +
> 
> +  NewLockVal = (OldLockVal & LockRegAndMask) | LockRegOrMask;
> 
> +
> 
> +  if (IsGpioLockOpcodeSupported ()) {
> 
> +    Opcode = GpioLockUnlock;
> 
> +  } else {
> 
> +    Opcode = PrivateControlWrite;
> 
> +  }
> 
> +
> 
> +  Status = PchSbiExecutionEx (
> 
> +             GpioGroupInfo[GroupIndex].Community,
> 
> +             RegOffset,
> 
> +             Opcode,
> 
> +             FALSE,
> 
> +             0x000F,
> 
> +             0x0000,
> 
> +             0x0000,
> 
> +             &NewLockVal,
> 
> +             &Response
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This internal procedure will calculate GPIO_RESET_CONFIG value  (new
> type)
> 
> +  based on provided PadRstCfg for a specific GPIO Pad.
> 
> +
> 
> +  @param[in]  GpioPad               GPIO Pad
> 
> +  @param[in]  PadRstCfg             GPIO PadRstCfg value
> 
> +
> 
> +  @retval GpioResetConfig           GPIO Reset configuration (new type)
> 
> +**/
> 
> +GPIO_RESET_CONFIG
> 
> +GpioResetConfigFromPadRstCfg (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  UINT32             PadRstCfg
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           Group;
> 
> +
> 
> +  static GPIO_RESET_CONFIG  PadRstCfgToGpioResetConfigMap[] = {
> 
> +                              GpioDswReset,
> 
> +                              GpioHostDeepReset,
> 
> +                              GpioPlatformReset,
> 
> +                              GpioResumeReset};
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +
> 
> +  if (PadRstCfg < 4) {
> 
> +    if (!GpioIsDswGroup(Group) && PadRstCfg == 3) {
> 
> +      DEBUG ((DEBUG_ERROR, "ERROR: Pad %a is configured to be reset by
> Global Reset without being part of DSW group\n", GpioName (GpioPad)));
> 
> +    }
> 
> +    return PadRstCfgToGpioResetConfigMap[PadRstCfg];
> 
> +  }
> 
> +  return GpioResetDefault;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This internal procedure will calculate PadRstCfg register value based
> 
> +  on provided GPIO Reset configuration for a certain pad.
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[in]  GpioResetConfig           GPIO Reset configuration
> 
> +  @param[out] PadRstCfg                 GPIO PadRstCfg value
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid configuration
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioPadRstCfgFromResetConfig (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  GPIO_RESET_CONFIG  GpioResetConfig,
> 
> +  OUT UINT32             *PadRstCfg
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           Group;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +
> 
> +  switch (GpioResetConfig) {
> 
> +    case GpioResetDefault:
> 
> +      *PadRstCfg = 0x0;
> 
> +      break;
> 
> +    case GpioHostDeepReset:
> 
> +      *PadRstCfg = V_GPIO_PCR_RST_CONF_DEEP_RST;
> 
> +      break;
> 
> +    case GpioPlatformReset:
> 
> +      *PadRstCfg = V_GPIO_PCR_RST_CONF_GPIO_RST;
> 
> +      break;
> 
> +    case GpioResumeReset:
> 
> +      if (GpioIsDswGroup (Group)) {
> 
> +        *PadRstCfg = V_GPIO_PCR_RST_CONF_RESUME_RST;
> 
> +      } else {
> 
> +        *PadRstCfg = V_GPIO_PCR_RST_CONF_POW_GOOD;
> 
> +      }
> 
> +      break;
> 
> +    case GpioDswReset:
> 
> +      if (GpioIsDswGroup (Group)) {
> 
> +        *PadRstCfg = V_GPIO_PCR_RST_CONF_POW_GOOD;
> 
> +      } else {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Only GPD group pads can use
> GpioDswReset: %a\n", GpioName (GpioPad)));
> 
> +        goto Error;
> 
> +      }
> 
> +      break;
> 
> +    default:
> 
> +      goto Error;
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +Error:
> 
> +  ASSERT (FALSE);
> 
> +  return EFI_INVALID_PARAMETER;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This internal procedure will get GPIO_CONFIG data from PADCFG registers
> value
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[in]  PadCfgDwReg               PADCFG DWx register values
> 
> +  @param[out] GpioData                  GPIO Configuration data
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +GpioConfigFromPadCfgRegValue (
> 
> +  IN GPIO_PAD      GpioPad,
> 
> +  IN CONST UINT32  *PadCfgDwReg,
> 
> +  OUT GPIO_CONFIG  *GpioConfig
> 
> +  )
> 
> +{
> 
> +  UINT32               PadRstCfg;
> 
> +
> 
> +  //
> 
> +  // Get Reset Type (PadRstCfg)
> 
> +  //
> 
> +  PadRstCfg = (PadCfgDwReg[0] & B_GPIO_PCR_RST_CONF) >>
> N_GPIO_PCR_RST_CONF;
> 
> +
> 
> +  GpioConfig->PowerConfig = GpioResetConfigFromPadRstCfg (
> 
> +                              GpioPad,
> 
> +                              PadRstCfg
> 
> +                              );
> 
> +
> 
> +  //
> 
> +  // Get how interrupt is triggered (RxEvCfg)
> 
> +  //
> 
> +  GpioConfig->InterruptConfig = ((PadCfgDwReg[0] &
> B_GPIO_PCR_RX_LVL_EDG) >> (N_GPIO_PCR_RX_LVL_EDG -
> (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1))) | (0x1 <<
> N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Get interrupt generation (GPIRoutIOxAPIC/SCI/SMI/NMI)
> 
> +  //
> 
> +  GpioConfig->InterruptConfig |= ((PadCfgDwReg[0] &
> (B_GPIO_PCR_RX_NMI_ROUTE | B_GPIO_PCR_RX_SCI_ROUTE |
> B_GPIO_PCR_RX_SMI_ROUTE | B_GPIO_PCR_RX_APIC_ROUTE)) >>
> (N_GPIO_PCR_RX_NMI_ROUTE -
> (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1))) | (0x1 <<
> N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Get GPIO direction (GPIORxDis and GPIOTxDis)
> 
> +  //
> 
> +  GpioConfig->Direction = ((PadCfgDwReg[0] & (B_GPIO_PCR_RXDIS |
> B_GPIO_PCR_TXDIS)) >> (N_GPIO_PCR_TXDIS -
> (N_GPIO_DIRECTION_DIR_BIT_POS + 1))) | (0x1 <<
> N_GPIO_DIRECTION_DIR_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Get GPIO input inversion (RXINV)
> 
> +  // (Only meaningful if input enabled)
> 
> +  //
> 
> +  if((PadCfgDwReg[0] & B_GPIO_PCR_RXDIS) == 0) {
> 
> +    GpioConfig->Direction |= ((PadCfgDwReg[0] & B_GPIO_PCR_RXINV) >>
> (N_GPIO_PCR_RXINV - (N_GPIO_DIRECTION_INV_BIT_POS + 1))) | (0x1 <<
> N_GPIO_DIRECTION_INV_BIT_POS);
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Get GPIO output state (GPIOTxState)
> 
> +  //
> 
> +  GpioConfig->OutputState = ((PadCfgDwReg[0] & B_GPIO_PCR_TX_STATE)
> << (N_GPIO_PCR_TX_STATE + (N_GPIO_OUTPUT_BIT_POS + 1))) | (0x1 <<
> N_GPIO_OUTPUT_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO RX raw override to '1' (RXRAW1)
> 
> +  //
> 
> +  GpioConfig->OtherSettings = ((PadCfgDwReg[0] &
> B_GPIO_PCR_RX_RAW1) >> (N_GPIO_PCR_RX_RAW1 -
> (N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS + 1))) | (0x1 <<
> N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Get GPIO Pad Mode (PMode)
> 
> +  //
> 
> +  GpioConfig->PadMode = ((PadCfgDwReg[0] & B_GPIO_PCR_PAD_MODE)
> >> (N_GPIO_PCR_PAD_MODE - (N_GPIO_PAD_MODE_BIT_POS + 1))) | (0x1
> << N_GPIO_PAD_MODE_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Get GPIO termination (Term)
> 
> +  //
> 
> +  GpioConfig->ElectricalConfig = ((PadCfgDwReg[1] & B_GPIO_PCR_TERM)
> >> (N_GPIO_PCR_TERM -
> (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1))) | (0x1 <<
> N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will read multiple GPIO settings
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[out] GpioData                  GPIO data structure
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadConfig (
> 
> +  IN  GPIO_PAD               GpioPad,
> 
> +  OUT GPIO_CONFIG            *GpioData
> 
> +  )
> 
> +{
> 
> +  UINT32               PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
> 
> +  UINT32               RegVal;
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               PadBitPosition;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Read PADCFG DW0 register
> 
> +  //
> 
> +  PadCfgDwReg[0] = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  //
> 
> +  // Read PADCFG DW1 register
> 
> +  //
> 
> +  PadCfgDwReg[1] = GpioReadPadCfgReg (GpioPad, 1);
> 
> +
> 
> +  //
> 
> +  // Read PADCFG DW2 register
> 
> +  //
> 
> +  PadCfgDwReg[2] = GpioReadPadCfgReg (GpioPad, 2);
> 
> +
> 
> +  GpioConfigFromPadCfgRegValue (
> 
> +    GpioPad,
> 
> +    PadCfgDwReg,
> 
> +    GpioData
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Read HOSTSW_OWN registers
> 
> +  //
> 
> +  GpioReadReg (
> 
> +    GpioHostOwnershipRegister,
> 
> +    Group,
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &RegVal
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Get Host Software Ownership
> 
> +  //
> 
> +  GpioData->HostSoftPadOwn = (((RegVal >> PadBitPosition) & 0x1) <<
> (N_GPIO_HOSTSW_OWN_BIT_POS + 1)) | (0x1 <<
> N_GPIO_HOSTSW_OWN_BIT_POS);
> 
> +
> 
> +  //
> 
> +  // Read PADCFGLOCK register
> 
> +  //
> 
> +  GpioReadReg (
> 
> +    GpioPadConfigLockRegister,
> 
> +    Group,
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &RegVal
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Get Pad Configuration Lock state
> 
> +  //
> 
> +  GpioData->LockConfig = ((!((RegVal >> PadBitPosition) & 0x1)) << 1) | BIT0;
> 
> +
> 
> +  //
> 
> +  // Read PADCFGLOCKTX register
> 
> +  //
> 
> +  GpioReadReg (
> 
> +    GpioPadLockOutputRegister,
> 
> +    Group,
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &RegVal
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Get Pad Configuration Lock Tx state
> 
> +  //
> 
> +  GpioData->LockConfig |= ((!((RegVal >> PadBitPosition) & 0x1)) << 3) |
> BIT2;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will calculate PADCFG register value based on GpioConfig
> data
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[in]  GpioConfig                GPIO Configuration data
> 
> +  @param[out] PadCfgDwReg               PADCFG DWx register value
> 
> +  @param[out] PadCfgDwRegMask           Mask with PADCFG DWx register
> bits to be modified
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioPadCfgRegValueFromGpioConfig (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  CONST GPIO_CONFIG  *GpioConfig,
> 
> +  OUT UINT32             *PadCfgDwReg,
> 
> +  OUT UINT32             *PadCfgDwRegMask
> 
> +  )
> 
> +{
> 
> +  UINT32               PadRstCfg;
> 
> +
> 
> +  //
> 
> +  // Configure Reset Type (PadRstCfg)
> 
> +  // Reset configuration depends on group type.
> 
> +  // This field requires support for new and deprecated settings.
> 
> +  //
> 
> +  GpioPadRstCfgFromResetConfig (
> 
> +    GpioPad,
> 
> +    GpioConfig->PowerConfig,
> 
> +    &PadRstCfg
> 
> +    );
> 
> +
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->PowerConfig &
> B_GPIO_RESET_CONFIG_RESET_MASK) >>
> N_GPIO_RESET_CONFIG_RESET_BIT_POS) == GpioHardwareDefault) ? 0x0 :
> B_GPIO_PCR_RST_CONF);
> 
> +  PadCfgDwReg[0] |= PadRstCfg << N_GPIO_PCR_RST_CONF;
> 
> +
> 
> +  //
> 
> +  // Configure how interrupt is triggered (RxEvCfg)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->InterruptConfig &
> B_GPIO_INT_CONFIG_INT_TYPE_MASK) >>
> N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS) == GpioHardwareDefault) ? 0x0 :
> B_GPIO_PCR_RX_LVL_EDG);
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->InterruptConfig &
> B_GPIO_INT_CONFIG_INT_TYPE_MASK) >>
> (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1)) <<
> N_GPIO_PCR_RX_LVL_EDG);
> 
> +
> 
> +  //
> 
> +  // Configure interrupt generation (GPIRoutIOxAPIC/SCI/SMI/NMI)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->InterruptConfig &
> B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >>
> N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS) == GpioHardwareDefault)  ?
> 0x0 : (B_GPIO_PCR_RX_NMI_ROUTE | B_GPIO_PCR_RX_SCI_ROUTE |
> B_GPIO_PCR_RX_SMI_ROUTE | B_GPIO_PCR_RX_APIC_ROUTE));
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->InterruptConfig &
> B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >>
> (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1)) <<
> N_GPIO_PCR_RX_NMI_ROUTE);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO direction (GPIORxDis and GPIOTxDis)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->Direction &
> B_GPIO_DIRECTION_DIR_MASK) >> N_GPIO_DIRECTION_DIR_BIT_POS) ==
> GpioHardwareDefault) ? 0x0 : (B_GPIO_PCR_RXDIS | B_GPIO_PCR_TXDIS));
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->Direction &
> B_GPIO_DIRECTION_DIR_MASK) >> (N_GPIO_DIRECTION_DIR_BIT_POS +
> 1)) << N_GPIO_PCR_TXDIS);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO input inversion (RXINV)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->Direction &
> B_GPIO_DIRECTION_INV_MASK) >> N_GPIO_DIRECTION_INV_BIT_POS) ==
> GpioHardwareDefault) ?  0x0 : B_GPIO_PCR_RXINV);
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->Direction &
> B_GPIO_DIRECTION_INV_MASK) >> (N_GPIO_DIRECTION_INV_BIT_POS +
> 1)) << N_GPIO_PCR_RXINV);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO output state (GPIOTxState)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->OutputState &
> B_GPIO_OUTPUT_MASK) >> N_GPIO_OUTPUT_BIT_POS) ==
> GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_TX_STATE);
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->OutputState &
> B_GPIO_OUTPUT_MASK) >> (N_GPIO_OUTPUT_BIT_POS + 1)) <<
> N_GPIO_PCR_TX_STATE);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO RX raw override to '1' (RXRAW1)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->OtherSettings &
> B_GPIO_OTHER_CONFIG_RXRAW_MASK) >>
> N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS) == GpioHardwareDefault) ? 0x0
> : B_GPIO_PCR_RX_RAW1);
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->OtherSettings &
> B_GPIO_OTHER_CONFIG_RXRAW_MASK) >>
> (N_GPIO_OTHER_CONFIG_RXRAW_BIT_POS + 1)) <<
> N_GPIO_PCR_RX_RAW1);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO Pad Mode (PMode)
> 
> +  //
> 
> +  PadCfgDwRegMask[0] |= ((((GpioConfig->PadMode &
> B_GPIO_PAD_MODE_MASK) >> N_GPIO_PAD_MODE_BIT_POS) ==
> GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_PAD_MODE);
> 
> +  PadCfgDwReg[0] |= (((GpioConfig->PadMode &
> B_GPIO_PAD_MODE_MASK) >> (N_GPIO_PAD_MODE_BIT_POS + 1)) <<
> N_GPIO_PCR_PAD_MODE);
> 
> +
> 
> +  //
> 
> +  // Configure GPIO termination (Term)
> 
> +  //
> 
> +  PadCfgDwRegMask[1] |= ((((GpioConfig->ElectricalConfig &
> B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >>
> N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS) ==
> GpioHardwareDefault) ? 0x0 : B_GPIO_PCR_TERM);
> 
> +  PadCfgDwReg[1] |= (((GpioConfig->ElectricalConfig &
> B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >>
> (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1)) <<
> N_GPIO_PCR_TERM);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will configure multiple GPIO settings
> 
> +
> 
> +  @param[in] GpioPad                    GPIO Pad
> 
> +  @param[in] GpioData                   GPIO data structure
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_CONFIG               *GpioData
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS           Status;
> 
> +  UINT32               PadCfgDwReg[GPIO_PADCFG_DW_REG_NUMBER];
> 
> +  UINT32               PadCfgDwRegMask[GPIO_PADCFG_DW_REG_NUMBER];
> 
> +  UINT32               HostSoftOwnReg;
> 
> +  UINT32               HostSoftOwnRegMask;
> 
> +  UINT32               GpiGpeEnReg;
> 
> +  UINT32               GpiGpeEnRegMask;
> 
> +  UINT32               GpiNmiEnReg;
> 
> +  UINT32               GpiNmiEnRegMask;
> 
> +  UINT32               GpiSmiEnReg;
> 
> +  UINT32               GpiSmiEnRegMask;
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               GroupIndex;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               PadBitPosition;
> 
> +  UINT32               DwNum;
> 
> +  GPIO_LOCK_CONFIG     LockConfig;
> 
> +
> 
> +  ZeroMem (PadCfgDwReg, sizeof (PadCfgDwReg));
> 
> +  ZeroMem (PadCfgDwRegMask, sizeof (PadCfgDwRegMask));
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if Pad enabled for SCI is to be in unlocked state
> 
> +  //
> 
> +  if (((GpioData->InterruptConfig & GpioIntSci) == GpioIntSci) &&
> 
> +      ((GpioData->LockConfig &
> B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK) !=
> GpioPadConfigUnlock)){
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a for SCI is not unlocked!\n",
> GpioName (GpioPad)));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Get GPIO PADCFG register value from GPIO config data
> 
> +  //
> 
> +  GpioPadCfgRegValueFromGpioConfig (
> 
> +    GpioPad,
> 
> +    GpioData,
> 
> +    PadCfgDwReg,
> 
> +    PadCfgDwRegMask
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Write PADCFG DW0 register
> 
> +  //
> 
> +  GpioWritePadCfgReg (
> 
> +    GpioPad,
> 
> +    0,
> 
> +    ~PadCfgDwRegMask[0],
> 
> +    PadCfgDwReg[0]
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Write PADCFG DW1 register
> 
> +  //
> 
> +  GpioWritePadCfgReg (
> 
> +    GpioPad,
> 
> +    1,
> 
> +    ~PadCfgDwRegMask[1],
> 
> +    PadCfgDwReg[1]
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Write PADCFG DW2 register
> 
> +  //
> 
> +  GpioWritePadCfgReg (
> 
> +    GpioPad,
> 
> +    2,
> 
> +    ~PadCfgDwRegMask[2],
> 
> +    PadCfgDwReg[2]
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in HOSTSW_OWN register
> 
> +  //
> 
> +  if ((GpioData->InterruptConfig & GpioIntSmi) == GpioIntSmi) {
> 
> +    HostSoftOwnRegMask = 1 << PadBitPosition;
> 
> +    HostSoftOwnReg = 1 << PadBitPosition;
> 
> +  } else {
> 
> +    HostSoftOwnRegMask = (GpioData->HostSoftPadOwn & 0x1) <<
> PadBitPosition;
> 
> +    HostSoftOwnReg = (GpioData->HostSoftPadOwn >> 0x1) <<
> PadBitPosition;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Write HOSTSW_OWN registers
> 
> +  //
> 
> +  GpioWriteReg (
> 
> +    GpioHostOwnershipRegister,
> 
> +    Group,
> 
> +    DwNum,
> 
> +    ~HostSoftOwnRegMask,
> 
> +    HostSoftOwnReg
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_GPE_EN register
> 
> +  //
> 
> +  GpiGpeEnRegMask = (GpioData->InterruptConfig & 0x1) <<
> PadBitPosition;
> 
> +  GpiGpeEnReg = ((GpioData->InterruptConfig & GpioIntSci) >> 3) <<
> PadBitPosition;
> 
> +
> 
> +  //
> 
> +  // Write GPI_GPE_EN registers
> 
> +  //
> 
> +  GpioWriteReg (
> 
> +    GpioGpeEnableRegister,
> 
> +    Group,
> 
> +    DwNum,
> 
> +    ~GpiGpeEnRegMask,
> 
> +    GpiGpeEnReg
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_NMI_EN register
> 
> +  //
> 
> +  GpiNmiEnRegMask = (GpioData->InterruptConfig & 0x1) <<
> PadBitPosition;
> 
> +  GpiNmiEnReg = ((GpioData->InterruptConfig & GpioIntNmi) >> 1) <<
> PadBitPosition;
> 
> +
> 
> +  Status = GpioWriteReg (
> 
> +             GpioNmiEnableRegister,
> 
> +             Group,
> 
> +             DwNum,
> 
> +             ~GpiNmiEnRegMask,
> 
> +             GpiNmiEnReg
> 
> +             );
> 
> +  if (Status == EFI_UNSUPPORTED) {
> 
> +    if (GpiNmiEnReg == 0) {
> 
> +      //
> 
> +      // Not all GPIO have NMI capabilities. Since we always try to program this
> register,
> 
> +      // even when not enabling NMI for a pad so do not report such access as
> an error
> 
> +      //
> 
> +      Status = EFI_SUCCESS;
> 
> +    } else {
> 
> +      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads
> supporting NMI\n", GpioGetGroupName (GroupIndex)));
> 
> +      ASSERT (FALSE);
> 
> +      return Status;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Update value to be programmed in GPI_SMI_EN register
> 
> +  //
> 
> +  GpiSmiEnRegMask = (GpioData->InterruptConfig & 0x1) << PadBitPosition;
> 
> +  GpiSmiEnReg = ((GpioData->InterruptConfig & GpioIntSmi) >> 2) <<
> PadBitPosition;
> 
> +
> 
> +  Status = GpioWriteReg (
> 
> +             GpioSmiEnableRegister,
> 
> +             Group,
> 
> +             DwNum,
> 
> +             ~GpiSmiEnRegMask,
> 
> +             GpiSmiEnReg
> 
> +             );
> 
> +  if (Status == EFI_UNSUPPORTED) {
> 
> +    if (GpiSmiEnReg == 0) {
> 
> +      //
> 
> +      // Not all GPIO have SMI capabilities. Since we always try to program this
> register,
> 
> +      // even when not enabling SMI for a pad so do not report such access as
> an error
> 
> +      //
> 
> +      Status = EFI_SUCCESS;
> 
> +    } else {
> 
> +      DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads
> supporting SMI\n", GpioGetGroupName (GroupIndex)));
> 
> +      ASSERT (FALSE);
> 
> +      return Status;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Store unlock data
> 
> +  //
> 
> +  if (GpioData->LockConfig != GpioLockDefault) {
> 
> +    LockConfig = GpioData->LockConfig &
> B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK;
> 
> +    //
> 
> +    // If pad in GpioMode is an output default action should be to leave
> output unlocked
> 
> +    //
> 
> +    if ((GpioData->PadMode == GpioPadModeGpio) &&
> 
> +      (GpioData->Direction == GpioDirOut) &&
> 
> +      ((GpioData->LockConfig &
> B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) == GpioLockDefault)) {
> 
> +      LockConfig |= GpioOutputStateUnlock;
> 
> +    } else {
> 
> +      LockConfig |= GpioData->LockConfig &
> B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK;
> 
> +    }
> 
> +    Status = GpioStoreUnlockData (GpioPad, LockConfig);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO output level
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Output value
> 
> +                                  0: OutputLow, 1: OutputHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetOutputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    Value
> 
> +  )
> 
> +{
> 
> +  if (Value > 1) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  GpioWritePadCfgReg (
> 
> +    GpioPad,
> 
> +    0,
> 
> +    (UINT32)~B_GPIO_PCR_TX_STATE,
> 
> +    Value << N_GPIO_PCR_TX_STATE
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO output level
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] OutputVal           GPIO Output value
> 
> +                                  0: OutputLow, 1: OutputHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetOutputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *OutputVal
> 
> +  )
> 
> +{
> 
> +  UINT32      PadCfgReg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  *OutputVal = (PadCfgReg & B_GPIO_PCR_TX_STATE) >>
> N_GPIO_PCR_TX_STATE;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO input level
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] InputVal            GPIO Input value
> 
> +                                  0: InputLow, 1: InpuHigh
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetInputValue (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *InputVal
> 
> +  )
> 
> +{
> 
> +  UINT32      PadCfgReg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  *InputVal = (PadCfgReg & B_GPIO_PCR_RX_STATE) >>
> N_GPIO_PCR_RX_STATE;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO IOxAPIC interrupt number
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] IrqNum              IRQ number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadIoApicIrqNumber (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                   *IrqNum
> 
> +  )
> 
> +{
> 
> +  UINT32      PadCfgReg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgReg = GpioReadPadCfgReg (GpioPad, 1);
> 
> +
> 
> +  *IrqNum = (PadCfgReg & B_GPIO_PCR_INTSEL) >> N_GPIO_PCR_INTSEL;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will configure GPIO input inversion
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value for GPIO input inversion
> 
> +                                  0: No input inversion, 1: Invert input
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetInputInversion (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    Value
> 
> +  )
> 
> +{
> 
> +  if (Value > 1) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  GpioWritePadCfgReg (
> 
> +    GpioPad,
> 
> +    0,
> 
> +    (UINT32)~B_GPIO_PCR_RXINV,
> 
> +    Value << N_GPIO_PCR_RXINV
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO pad input inversion value
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] InvertState         GPIO inversion state
> 
> +                                  0: No input inversion, 1: Inverted input
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetInputInversion (
> 
> +  IN  GPIO_PAD                 GpioPad,
> 
> +  OUT UINT32                   *InvertState
> 
> +  )
> 
> +{
> 
> +  UINT32      PadCfgReg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgReg = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  *InvertState = (PadCfgReg & B_GPIO_PCR_RXINV) >>
> N_GPIO_PCR_RXINV;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO interrupt settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of Level/Edge
> 
> +                                  use GPIO_INT_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadInterruptConfig (
> 
> +  IN GPIO_PAD                 GpioPad,
> 
> +  IN GPIO_INT_CONFIG          Value
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT32      RxLvlEdgeValue;
> 
> +  UINT32      IntRouteValue;
> 
> +  UINT32      PadNumber;
> 
> +  UINT32      GpeEnable;
> 
> +  UINT32      NmiEnable;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  Status = EFI_SUCCESS;
> 
> +
> 
> +  if (((Value & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >>
> N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS) != GpioHardwareDefault) {
> 
> +    RxLvlEdgeValue = ((Value & B_GPIO_INT_CONFIG_INT_TYPE_MASK) >>
> (N_GPIO_INT_CONFIG_INT_TYPE_BIT_POS + 1)) <<
> N_GPIO_PCR_RX_LVL_EDG;
> 
> +
> 
> +    GpioWritePadCfgReg (
> 
> +      GpioPad,
> 
> +      0,
> 
> +      (UINT32)~B_GPIO_PCR_RX_LVL_EDG,
> 
> +      RxLvlEdgeValue
> 
> +      );
> 
> +  }
> 
> +
> 
> +  if (((Value & B_GPIO_INT_CONFIG_INT_SOURCE_MASK) >>
> N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS) != GpioHardwareDefault) {
> 
> +
> 
> +    IntRouteValue = ((Value & B_GPIO_INT_CONFIG_INT_SOURCE_MASK)
> >> (N_GPIO_INT_CONFIG_INT_SOURCE_BIT_POS + 1)) <<
> N_GPIO_PCR_RX_NMI_ROUTE;
> 
> +
> 
> +    GpioWritePadCfgReg (
> 
> +      GpioPad,
> 
> +      0,
> 
> +      (UINT32)~(B_GPIO_PCR_RX_NMI_ROUTE |
> B_GPIO_PCR_RX_SCI_ROUTE | B_GPIO_PCR_RX_SMI_ROUTE |
> B_GPIO_PCR_RX_APIC_ROUTE),
> 
> +      IntRouteValue
> 
> +      );
> 
> +
> 
> +    if ((Value & GpioIntSci) == GpioIntSci) {
> 
> +      GpeEnable = 0x1;
> 
> +    } else {
> 
> +      GpeEnable = 0x0;
> 
> +    }
> 
> +
> 
> +    PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +    GpioWriteReg (
> 
> +      GpioGpeEnableRegister,
> 
> +      GpioGetGroupFromGpioPad (GpioPad),
> 
> +      GPIO_GET_DW_NUM (PadNumber),
> 
> +      ~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
> 
> +      GpeEnable << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +      );
> 
> +
> 
> +    if ((Value & GpioIntNmi) == GpioIntNmi) {
> 
> +      NmiEnable = 0x1;
> 
> +    } else {
> 
> +      NmiEnable = 0x0;
> 
> +    }
> 
> +
> 
> +    Status = GpioWriteReg (
> 
> +               GpioNmiEnableRegister,
> 
> +               GpioGetGroupFromGpioPad (GpioPad),
> 
> +               GPIO_GET_DW_NUM (PadNumber),
> 
> +               ~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
> 
> +               NmiEnable << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +               );
> 
> +    if (Status == EFI_UNSUPPORTED) {
> 
> +      if (NmiEnable == 0) {
> 
> +        //
> 
> +        // Not all GPIO have NMI capabilities. Since we always try to program
> this register,
> 
> +        // even when not enabling NMI for a pad so do not report such access
> as an error
> 
> +        //
> 
> +        return EFI_SUCCESS;
> 
> +      } else {
> 
> +        DEBUG ((DEBUG_ERROR, "GPIO ERROR: Group %a has no pads
> supporting NMI\n", GpioGetGroupName (GpioGetGroupIndexFromGpioPad
> (GpioPad))));
> 
> +      }
> 
> +    }
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO electrical settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of termination
> 
> +                                  use GPIO_ELECTRICAL_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadElectricalConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_ELECTRICAL_CONFIG    Value
> 
> +  )
> 
> +{
> 
> +  UINT32      TermValue;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (((Value & B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >>
> N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS) !=
> GpioHardwareDefault) {
> 
> +    TermValue = ((Value &
> B_GPIO_ELECTRICAL_CONFIG_TERMINATION_MASK) >>
> (N_GPIO_ELECTRICAL_CONFIG_TERMINATION_BIT_POS + 1)) <<
> N_GPIO_PCR_TERM;
> 
> +
> 
> +    GpioWritePadCfgReg (
> 
> +      GpioPad,
> 
> +      1,
> 
> +      (UINT32)~B_GPIO_PCR_TERM,
> 
> +      TermValue
> 
> +      );
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO Reset settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value for Pad Reset Configuration
> 
> +                                  use GPIO_RESET_CONFIG as argument
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadResetConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_RESET_CONFIG         Value
> 
> +  )
> 
> +{
> 
> +  UINT32      PadRstCfg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (((Value & B_GPIO_RESET_CONFIG_RESET_MASK) >>
> N_GPIO_RESET_CONFIG_RESET_BIT_POS) != GpioHardwareDefault) {
> 
> +
> 
> +    //
> 
> +    // Reset configuration depends on group type.
> 
> +    // This field requires support for new and deprecated settings.
> 
> +    //
> 
> +    GpioPadRstCfgFromResetConfig (
> 
> +      GpioPad,
> 
> +      Value,
> 
> +      &PadRstCfg
> 
> +      );
> 
> +
> 
> +    GpioWritePadCfgReg (
> 
> +      GpioPad,
> 
> +      0,
> 
> +      (UINT32)~B_GPIO_PCR_RST_CONF,
> 
> +      PadRstCfg << N_GPIO_PCR_RST_CONF
> 
> +      );
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO Reset settings
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] Value                Value of Pad Reset Configuration
> 
> +                                  based on GPIO_RESET_CONFIG
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadResetConfig (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN GPIO_RESET_CONFIG         *Value
> 
> +  )
> 
> +{
> 
> +  UINT32      PadRstCfg;
> 
> +  UINT32      PadCfgDw0Reg;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgDw0Reg = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  //
> 
> +  // Get Reset Type (PadRstCfg)
> 
> +  //
> 
> +  PadRstCfg = (PadCfgDw0Reg & B_GPIO_PCR_RST_CONF) >>
> N_GPIO_PCR_RST_CONF;
> 
> +
> 
> +  *Value = GpioResetConfigFromPadRstCfg (
> 
> +             GpioPad,
> 
> +             PadRstCfg
> 
> +             );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  This procedure will get Gpio Pad Host Software Ownership
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] PadHostSwOwn        Value of Host Software Pad Owner
> 
> +                                  0: ACPI Mode, 1: GPIO Driver mode
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetHostSwOwnershipForPad (
> 
> +  IN GPIO_PAD                 GpioPad,
> 
> +  OUT UINT32                  *PadHostSwOwn
> 
> +  )
> 
> +{
> 
> +  UINT32      PadNumber;
> 
> +  UINT32      HostSwRegVal;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioReadReg (
> 
> +    GpioHostOwnershipRegister,
> 
> +    GpioGetGroupFromGpioPad (GpioPad),
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &HostSwRegVal
> 
> +    );
> 
> +
> 
> +  *PadHostSwOwn = (HostSwRegVal >> GPIO_GET_PAD_POSITION
> (PadNumber)) & 0x1;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set Gpio Pad Host Software Ownership
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] PadHostSwOwn         Pad Host Software Owner
> 
> +                                  0: ACPI Mode, 1: GPIO Driver mode
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetHostSwOwnershipForPad (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  IN UINT32                    PadHostSwOwn
> 
> +  )
> 
> +{
> 
> +  UINT32      PadNumber;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad) || (PadHostSwOwn > 1)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  return GpioWriteReg (
> 
> +           GpioHostOwnershipRegister,
> 
> +           GpioGetGroupFromGpioPad (GpioPad),
> 
> +           GPIO_GET_DW_NUM (PadNumber),
> 
> +           (UINT32)~(1 << GPIO_GET_PAD_POSITION (PadNumber)),
> 
> +           PadHostSwOwn << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get Gpio Pad Ownership
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] PadOwnVal           Value of Pad Ownership
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadOwnership (
> 
> +  IN  GPIO_PAD                GpioPad,
> 
> +  OUT GPIO_PAD_OWN            *PadOwnVal
> 
> +  )
> 
> +{
> 
> +  UINT32                 Mask;
> 
> +  UINT32                 RegOffset;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 PadOwnRegValue;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  //
> 
> +  // Calculate RegOffset using Pad Ownership offset and GPIO Pad number.
> 
> +  // One DWord register contains information for 8 pads.
> 
> +  //
> 
> +  RegOffset = GpioGroupInfo[GroupIndex].PadOwnOffset + (PadNumber
> >> 3) * 0x4;
> 
> +
> 
> +  //
> 
> +  // Calculate pad bit position within DWord register
> 
> +  //
> 
> +  PadNumber %= 8;
> 
> +  Mask = (BIT1 | BIT0) << (PadNumber * 4);
> 
> +
> 
> +  PadOwnRegValue = MmioRead32 (PCH_PCR_ADDRESS
> (GpioGroupInfo[GroupIndex].Community, RegOffset));
> 
> +
> 
> +  *PadOwnVal = (GPIO_PAD_OWN) ((PadOwnRegValue & Mask) >>
> (PadNumber * 4));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Lock for pads within one
> group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] PadCfgLockRegVal    Value of PadCfgLock register
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: NotLocked, 1: Locked
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockForGroupDw (
> 
> +  IN  GPIO_GROUP                  Group,
> 
> +  IN  UINT32                      DwNum,
> 
> +  OUT UINT32                      *PadCfgLockRegVal
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioReadReg (
> 
> +           GpioPadConfigLockRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           PadCfgLockRegVal
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Lock for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] PadCfgLock          PadCfgLock for selected pad
> 
> +                                  0: NotLocked, 1: Locked
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLock (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT UINT32                    *PadCfgLock
> 
> +  )
> 
> +{
> 
> +  UINT32      PadNumber;
> 
> +  UINT32      PadCfgLockRegVal;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioReadReg (
> 
> +    GpioPadConfigLockRegister,
> 
> +    GpioGetGroupFromGpioPad (GpioPad),
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &PadCfgLockRegVal
> 
> +    );
> 
> +
> 
> +  *PadCfgLock = (PadCfgLockRegVal >> GPIO_GET_PAD_POSITION
> (PadNumber)) & 0x1;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Tx Lock for pads within one
> group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLockTx register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[out] PadCfgLockTxRegVal  Value of PadCfgLockTx register
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: NotLockedTx, 1: LockedTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockTxForGroupDw (
> 
> +  IN  GPIO_GROUP                  Group,
> 
> +  IN  UINT32                      DwNum,
> 
> +  OUT UINT32                      *PadCfgLockTxRegVal
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioReadReg (
> 
> +           GpioPadLockOutputRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           PadCfgLockTxRegVal
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check state of Pad Config Tx Lock for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[out] PadCfgLock          PadCfgLockTx for selected pad
> 
> +                                  0: NotLockedTx, 1: LockedTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadCfgLockTx (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT UINT32                    *PadCfgLockTx
> 
> +  )
> 
> +{
> 
> +  UINT32      PadNumber;
> 
> +  UINT32      PadCfgLockTxRegVal;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioReadReg (
> 
> +    GpioPadLockOutputRegister,
> 
> +    GpioGetGroupFromGpioPad (GpioPad),
> 
> +    GPIO_GET_DW_NUM (PadNumber),
> 
> +    &PadCfgLockTxRegVal
> 
> +    );
> 
> +
> 
> +  *PadCfgLockTx = (PadCfgLockTxRegVal >> GPIO_GET_PAD_POSITION
> (PadNumber)) & 0x1;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLock for selected pads within one group.
> 
> +  This function should be used only inside SMI.
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToUnlock        Bitmask for pads which are going to be
> unlocked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotUnlock, 1: Unlock
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgForGroupDw (
> 
> +  IN GPIO_GROUP                Group,
> 
> +  IN UINT32                    DwNum,
> 
> +  IN UINT32                    PadsToUnlock
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioWriteLockReg (
> 
> +           GpioPadConfigLockRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           ~PadsToUnlock,
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLock for selected pad.
> 
> +  This function should be used only inside SMI.
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfg (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP   Group;
> 
> +  UINT32       PadNumber;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  return GpioUnlockPadCfgForGroupDw (
> 
> +           Group,
> 
> +           GPIO_GET_DW_NUM (PadNumber),
> 
> +           1 << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLock for selected pads within one group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLock          Bitmask for pads which are going to be
> locked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotLock, 1: Lock
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgForGroupDw (
> 
> +  IN GPIO_GROUP                   Group,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       PadsToLock
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioWriteLockReg (
> 
> +           GpioPadConfigLockRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           ~0u,
> 
> +           PadsToLock
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLock for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfg (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP   Group;
> 
> +  UINT32       PadNumber;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  return GpioLockPadCfgForGroupDw (
> 
> +           Group,
> 
> +           GPIO_GET_DW_NUM (PadNumber),
> 
> +           1 << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLockTx for selected pads within one group.
> 
> +  This function should be used only inside SMI.
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLockTx register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToUnlockTx      Bitmask for pads which are going to be
> unlocked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotUnLockTx, 1: LockTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgTxForGroupDw (
> 
> +  IN GPIO_GROUP                Group,
> 
> +  IN UINT32                    DwNum,
> 
> +  IN UINT32                    PadsToUnlockTx
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioWriteLockReg (
> 
> +           GpioPadLockOutputRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           ~PadsToUnlockTx,
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will clear PadCfgLockTx for selected pad.
> 
> +  This function should be used only inside SMI.
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioUnlockPadCfgTx (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP   Group;
> 
> +  UINT32       PadNumber;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  return GpioUnlockPadCfgTxForGroupDw (
> 
> +           Group,
> 
> +           GPIO_GET_DW_NUM (PadNumber),
> 
> +           1 << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLockTx for selected pads within one group
> 
> +
> 
> +  @param[in]  Group               GPIO group
> 
> +  @param[in]  DwNum               PadCfgLock register number for current
> group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  PadsToLockTx        Bitmask for pads which are going to be
> locked,
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: DoNotLockTx, 1: LockTx
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or DwNum parameter
> number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgTxForGroupDw (
> 
> +  IN GPIO_GROUP                   Group,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       PadsToLockTx
> 
> +  )
> 
> +{
> 
> +  if (!GpioIsGroupAndDwNumValid (Group, DwNum)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return GpioWriteLockReg (
> 
> +           GpioPadLockOutputRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           ~0u,
> 
> +           PadsToLockTx
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set PadCfgLockTx for selected pad
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioLockPadCfgTx (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP   Group;
> 
> +  UINT32       PadNumber;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  return GpioLockPadCfgTxForGroupDw (
> 
> +           Group,
> 
> +           GPIO_GET_DW_NUM (PadNumber),
> 
> +           1 << GPIO_GET_PAD_POSITION (PadNumber)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get Group to GPE mapping.
> 
> +  It will assume that only first 32 pads can be mapped to GPE.
> 
> +  To handle cases where groups have more than 32 pads and higher part of
> group
> 
> +  can be mapped please refer to GpioGetGroupDwToGpeDwX()
> 
> +
> 
> +  @param[out] GroupToGpeDw0       GPIO group to be mapped to GPE_DW0
> 
> +  @param[out] GroupToGpeDw1       GPIO group to be mapped to GPE_DW1
> 
> +  @param[out] GroupToGpeDw2       GPIO group to be mapped to GPE_DW2
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGroupToGpeDwX (
> 
> +  IN GPIO_GROUP               *GroupToGpeDw0,
> 
> +  IN GPIO_GROUP               *GroupToGpeDw1,
> 
> +  IN GPIO_GROUP               *GroupToGpeDw2
> 
> +  )
> 
> +{
> 
> +  UINT32     GroupDw[3];
> 
> +  UINT32     Index;
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  Status = GpioGetGroupDwToGpeDwX (
> 
> +             GroupToGpeDw0,
> 
> +             &GroupDw[0],
> 
> +             GroupToGpeDw1,
> 
> +             &GroupDw[1],
> 
> +             GroupToGpeDw2,
> 
> +             &GroupDw[2]
> 
> +             );
> 
> +
> 
> +  for (Index = 0; Index < ARRAY_SIZE (GroupDw); Index++) {
> 
> +    if (GroupDw[Index] != 0) {
> 
> +      Status = EFI_UNSUPPORTED;
> 
> +      ASSERT (FALSE);
> 
> +    }
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get Group to GPE mapping. If group has more than 32
> bits
> 
> +  it is possible to map only single DW of pins (e.g. 0-31, 32-63) because
> 
> +  ACPI GPE_DWx register is 32 bits large.
> 
> +
> 
> +  @param[out]  GroupToGpeDw0       GPIO group mapped to GPE_DW0
> 
> +  @param[out]  GroupDwForGpeDw0    DW of pins mapped to GPE_DW0
> 
> +  @param[out]  GroupToGpeDw1       GPIO group mapped to GPE_DW1
> 
> +  @param[out]  GroupDwForGpeDw1    DW of pins mapped to GPE_DW1
> 
> +  @param[out]  GroupToGpeDw2       GPIO group mapped to GPE_DW2
> 
> +  @param[out]  GroupDwForGpeDw2    DW of pins mapped to GPE_DW2
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGroupDwToGpeDwX (
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw0,
> 
> +  OUT UINT32                    *GroupDwForGpeDw0,
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw1,
> 
> +  OUT UINT32                    *GroupDwForGpeDw1,
> 
> +  OUT GPIO_GROUP                *GroupToGpeDw2,
> 
> +  OUT UINT32                    *GroupDwForGpeDw2
> 
> +  )
> 
> +{
> 
> +  UINT32                     PmcGpeDwXValue[3];
> 
> +  GPIO_GROUP                 GroupToGpeDwX[3];
> 
> +  UINT32                     GroupDwForGpeDwX[3];
> 
> +  UINT8                      GpeDwXIndex;
> 
> +  UINT32                     Index;
> 
> +  GPIO_GROUP_TO_GPE_MAPPING  *GpioGpeMap;
> 
> +  UINT32                     GpioGpeMapLength;
> 
> +
> 
> +  ZeroMem (GroupToGpeDwX, sizeof (GroupToGpeDwX));
> 
> +  ZeroMem (GroupDwForGpeDwX, sizeof (GroupDwForGpeDwX));
> 
> +
> 
> +  PmcGetGpioGpe (&PmcGpeDwXValue[0], &PmcGpeDwXValue[1],
> &PmcGpeDwXValue[2]);
> 
> +  GpioGetGroupToGpeMapping (&GpioGpeMap, &GpioGpeMapLength);
> 
> +  for (GpeDwXIndex = 0; GpeDwXIndex < 3; GpeDwXIndex++) {
> 
> +    for (Index = 0; Index < GpioGpeMapLength; Index++) {
> 
> +
> 
> +      if (GpioGpeMap[Index].PmcGpeDwxVal ==
> PmcGpeDwXValue[GpeDwXIndex]) {
> 
> +        GroupToGpeDwX[GpeDwXIndex] = GpioGpeMap[Index].Group;
> 
> +        GroupDwForGpeDwX[GpeDwXIndex] =
> GpioGpeMap[Index].GroupDw;
> 
> +        break;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if ((GroupToGpeDwX[0] == 0) ||
> 
> +      (GroupToGpeDwX[1] == 0) ||
> 
> +      (GroupToGpeDwX[2] == 0)) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  *GroupToGpeDw0 = GroupToGpeDwX[0];
> 
> +  *GroupDwForGpeDw0 = GroupDwForGpeDwX[0];
> 
> +  *GroupToGpeDw1 = GroupToGpeDwX[1];
> 
> +  *GroupDwForGpeDw1 = GroupDwForGpeDwX[1];
> 
> +  *GroupToGpeDw2 = GroupToGpeDwX[2];
> 
> +  *GroupDwForGpeDw2 = GroupDwForGpeDwX[2];
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPE number for provided GpioPad.
> 
> +  PCH allows to configure mapping between GPIO groups and related GPE
> (GpioSetGroupToGpeDwX())
> 
> +  what results in the fact that certain Pad can cause different General
> Purpose Event. Only three
> 
> +  GPIO groups can be mapped to cause unique GPE (1-tier), all others groups
> will be under one common
> 
> +  event (GPE_111 for 2-tier).
> 
> +
> 
> +  1-tier:
> 
> +  Returned GpeNumber is in range <0,95>. GpioGetGpeNumber() can be
> used
> 
> +  to determine what _LXX ACPI method would be called on event on
> selected GPIO pad
> 
> +
> 
> +  2-tier:
> 
> +  Returned GpeNumber is 0x6F (111). All GPIO pads which are not mapped
> to 1-tier GPE
> 
> +  will be under one master GPE_111 which is linked to _L6F ACPI method. If
> it is needed to determine
> 
> +  what Pad from 2-tier has caused the event, _L6F method should check
> GPI_GPE_STS and GPI_GPE_EN
> 
> +  registers for all GPIO groups not mapped to 1-tier GPE.
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpeNumber           GPE number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpeNumber (
> 
> +  IN  GPIO_PAD                  GpioPad,
> 
> +  OUT UINT32                    *GpeNumber
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           GroupToGpeDwX[3];
> 
> +  UINT32               GroupDw[3];
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               Index;
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Get GPIO groups mapping to 1-tier GPE
> 
> +  // This mapping is dependent on GPIO IP implementation
> 
> +  // and may change between chipset generations
> 
> +  //
> 
> +  GpioGetGroupDwToGpeDwX (
> 
> +    &GroupToGpeDwX[0], &GroupDw[0],
> 
> +    &GroupToGpeDwX[1], &GroupDw[1],
> 
> +    &GroupToGpeDwX[2], &GroupDw[2]
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Check if pad is routed to 1-Tier GPE
> 
> +  //
> 
> +  for (Index = 0; Index < 3; Index++) {
> 
> +    if ((Group == GroupToGpeDwX[Index]) && (PadNumber >= (32 *
> GroupDw[Index])) && (PadNumber < (32 * (GroupDw[Index] + 1)))) {
> 
> +      *GpeNumber = PadNumber + (32 * Index) - (32 * GroupDw[Index]);
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If Group number doesn't match any of above then
> 
> +  // it means that the pad is routed to 2-tier GPE
> 
> +  // which corresponds to  GPE_111 (0x6F)
> 
> +  //
> 
> +  *GpeNumber = PCH_GPIO_2_TIER_MASTER_GPE_NUMBER;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to clear SMI STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearGpiSmiSts (
> 
> +  IN GPIO_PAD                   GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               DwNum;
> 
> +  UINT32               PadBitPosition;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +
> 
> +  //
> 
> +  // Clear GPI SMI Status bit by writing '1'
> 
> +  //
> 
> +  return GpioWriteReg (
> 
> +           GpioSmiStatusRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           0u,
> 
> +           (UINT32) (BIT0 << PadBitPosition)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used by PchSmiDispatcher and will clear
> 
> +  all GPI SMI Status bits
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearAllGpiSmiSts (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32         DwNum;
> 
> +  GPIO_GROUP     Group;
> 
> +  GPIO_GROUP     GroupMin;
> 
> +  GPIO_GROUP     GroupMax;
> 
> +
> 
> +  GroupMin = GpioGetLowestGroup ();
> 
> +  GroupMax = GpioGetHighestGroup ();
> 
> +
> 
> +  for (Group = GroupMin; Group <= GroupMax; Group++) {
> 
> +    //
> 
> +    // Clear all GPI SMI STS
> 
> +    //
> 
> +    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGetPadPerGroup (Group)); DwNum++) {
> 
> +      GpioWriteReg (
> 
> +        GpioSmiStatusRegister,
> 
> +        Group,
> 
> +        DwNum,
> 
> +        0u,
> 
> +        0xFFFFFFFF
> 
> +        );
> 
> +    }
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to disable all GPI SMI
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioDisableAllGpiSmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32         DwNum;
> 
> +  GPIO_GROUP     Group;
> 
> +  GPIO_GROUP     GroupMin;
> 
> +  GPIO_GROUP     GroupMax;
> 
> +  UINT32         SmiEnRegVal;
> 
> +
> 
> +  GroupMin = GpioGetLowestGroup ();
> 
> +  GroupMax = GpioGetHighestGroup ();
> 
> +
> 
> +  for (Group = GroupMin; Group <= GroupMax; Group++) {
> 
> +    //
> 
> +    // Disable all GPI SMI
> 
> +    //
> 
> +    for (DwNum = 0; DwNum <= GPIO_GET_DW_NUM
> (GpioGetPadPerGroup (Group)); DwNum++) {
> 
> +      //
> 
> +      // Check which pins have SMI_EN set
> 
> +      //
> 
> +      GpioReadReg (
> 
> +        GpioSmiEnableRegister,
> 
> +        Group,
> 
> +        DwNum,
> 
> +        &SmiEnRegVal
> 
> +        );
> 
> +      //
> 
> +      // Set HOSTSW_OWN to GPIO mode (1) for those pins to disable SMI
> capability
> 
> +      //
> 
> +      GpioWriteReg (
> 
> +        GpioHostOwnershipRegister,
> 
> +        Group,
> 
> +        DwNum,
> 
> +        ~0u,
> 
> +        SmiEnRegVal
> 
> +        );
> 
> +    }
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to register GPI SMI dispatch function.
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpiNum              GPI number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiSmiNum (
> 
> +  IN GPIO_PAD          GpioPad,
> 
> +  OUT UINTN            *GpiNum
> 
> +  )
> 
> +{
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 Index;
> 
> +  UINT32                 PadNumber;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  *GpiNum = 0;
> 
> +
> 
> +  for (Index = 0; Index < GroupIndex; Index++) {
> 
> +    *GpiNum += (UINTN) (GpioGroupInfo[Index].PadPerGroup);
> 
> +  }
> 
> +  *GpiNum += (UINTN) PadNumber;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to check GPIO inputs belongs to 2 tier or 1 tier
> architecture
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval     Data                0 means 1-tier, 1 means 2-tier
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioCheckFor2Tier (
> 
> +  IN GPIO_PAD                  GpioPad
> 
> +  )
> 
> +{
> 
> +  UINT32               Data32;
> 
> +
> 
> +  GpioGetGpeNumber (GpioPad, &Data32);
> 
> +  if (Data32 == PCH_GPIO_2_TIER_MASTER_GPE_NUMBER) {
> 
> +    return TRUE;
> 
> +  }
> 
> +
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to clear GPE STS for a specified GpioPad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioClearGpiGpeSts (
> 
> +  IN GPIO_PAD                  GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               DwNum;
> 
> +  UINT32               PadBitPosition;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check for 2-tier
> 
> +  //
> 
> +  if (!(GpioCheckFor2Tier (GpioPad))) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +
> 
> +  //
> 
> +  // Clear GPI GPE Status bit by writing '1'
> 
> +  //
> 
> +  return GpioWriteReg (
> 
> +           GpioGpeStatusRegister,
> 
> +           Group,
> 
> +           DwNum,
> 
> +           0u,
> 
> +           (UINT32) (BIT0 << PadBitPosition)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to read GPE STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] GpeSts              Gpe status for given pad
> 
> +                                  The GpeSts is true if the status register is set for given Pad
> number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiGpeSts (
> 
> +  IN GPIO_PAD                  GpioPad,
> 
> +  OUT BOOLEAN                  *GpeSts
> 
> +  )
> 
> +{
> 
> +  UINT32               GpeStsRegVal;
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               DwNum;
> 
> +  UINT32               PadBitPosition;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check for 2-tier
> 
> +  //
> 
> +  if (!(GpioCheckFor2Tier (GpioPad))) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +
> 
> +  //
> 
> +  // Read GPI GPE Status bits
> 
> +  //
> 
> +  GpioReadReg (
> 
> +    GpioGpeStatusRegister,
> 
> +    Group,
> 
> +    DwNum,
> 
> +    &GpeStsRegVal
> 
> +    );
> 
> +
> 
> +  *GpeSts = ((GpeStsRegVal >> PadBitPosition) & 0x1) != 0;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used to get SMI STS for a specified Pad
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] SmiSts              Smi status for given pad
> 
> +                                  The SmiSts is true if the status register is set for given Pad
> number
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetGpiSmiSts (
> 
> +  IN GPIO_PAD                   GpioPad,
> 
> +  OUT BOOLEAN                   *SmiSts
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP           Group;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               DwNum;
> 
> +  UINT32               PadBitPosition;
> 
> +  UINT32               SmiStsRegister;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  Group = GpioGetGroupFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  DwNum = GPIO_GET_DW_NUM (PadNumber);
> 
> +  PadBitPosition = GPIO_GET_PAD_POSITION (PadNumber);
> 
> +
> 
> +  //
> 
> +  // Read the SMI Register
> 
> +  //
> 
> +  GpioReadReg (
> 
> +    GpioSmiStatusRegister,
> 
> +    Group,
> 
> +    DwNum,
> 
> +    &SmiStsRegister
> 
> +    );
> 
> +
> 
> +  *SmiSts = (SmiStsRegister & (BIT0 << PadBitPosition)) != 0;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> GpioLibrary.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioLibrary.h
> new file mode 100644
> index 0000000000..d197ee4898
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioLibrary.h
> @@ -0,0 +1,82 @@
> +/** @file
> 
> +  Header file for GPIO Lib implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _GPIO_LIBRARY_H_
> 
> +#define _GPIO_LIBRARY_H_
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SataLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PchSbiAccessLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/GpioHelpersLib.h>
> 
> +#include <Register/GpioRegs.h>
> 
> +
> 
> +//
> 
> +// Number of PADCFG_DW registers
> 
> +//
> 
> +#define GPIO_PADCFG_DW_REG_NUMBER  4
> 
> +
> 
> +/**
> 
> +  This internal procedure will calculate GPIO_RESET_CONFIG value  (new
> type)
> 
> +  based on provided PadRstCfg for a specific GPIO Pad.
> 
> +
> 
> +  @param[in]  GpioPad               GPIO Pad
> 
> +  @param[in]  PadRstCfg             GPIO PadRstCfg value
> 
> +
> 
> +  @retval GpioResetConfig           GPIO Reset configuration (new type)
> 
> +**/
> 
> +GPIO_RESET_CONFIG
> 
> +GpioResetConfigFromPadRstCfg (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  UINT32             PadRstCfg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This internal procedure will calculate PadRstCfg register value based
> 
> +  on provided GPIO Reset configuration for a certain pad.
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[in]  GpioResetConfig           GPIO Reset configuration
> 
> +  @param[out] PadRstCfg                 GPIO PadRstCfg value
> 
> +
> 
> +  @retval EFI_SUCCESS                   The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid configuration
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioPadRstCfgFromResetConfig (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  GPIO_RESET_CONFIG  GpioResetConfig,
> 
> +  OUT UINT32             *PadRstCfg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will calculate PADCFG register value based on GpioConfig
> data
> 
> +
> 
> +  @param[in]  GpioPad                   GPIO Pad
> 
> +  @param[in]  GpioConfig                GPIO Configuration data
> 
> +  @param[out] PadCfgDwReg               PADCFG DWx register value
> 
> +  @param[out] PadCfgDwRegMask           Mask with PADCFG DWx register
> bits to be modified
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioPadCfgRegValueFromGpioConfig (
> 
> +  IN  GPIO_PAD           GpioPad,
> 
> +  IN  CONST GPIO_CONFIG  *GpioConfig,
> 
> +  OUT UINT32             *PadCfgDwReg,
> 
> +  OUT UINT32             *PadCfgDwRegMask
> 
> +  );
> 
> +
> 
> +#endif // _GPIO_LIBRARY_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> GpioNames.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioNames.c
> new file mode 100644
> index 0000000000..d21e77ba60
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioNames.c
> @@ -0,0 +1,86 @@
> +/** @file
> 
> +  This file contains GPIO name library implementation
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include "GpioLibrary.h"
> 
> +#include <Library/PrintLib.h>
> 
> +
> 
> +/**
> 
> +  Generates GPIO group name from GpioPad
> 
> +
> 
> +  @param[in] GpioPad  GpioPad
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO group name
> 
> +**/
> 
> +CONST
> 
> +CHAR8*
> 
> +GpioGetGroupName (
> 
> +  IN UINT32  GroupIndex
> 
> +  )
> 
> +{
> 
> +  CONST GPIO_GROUP_NAME_INFO*  GroupNameInfo;
> 
> +
> 
> +  GroupNameInfo = GpioGetGroupNameInfo (GroupIndex);
> 
> +  if (GroupNameInfo == NULL) {
> 
> +    return NULL;
> 
> +  } else {
> 
> +    return GroupNameInfo->GpioGroupPrefix;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Generates GPIO name from GpioPad
> 
> +
> 
> +  @param[in]  GpioPad             GpioPad
> 
> +  @param[out] GpioNameBuffer      Caller allocated buffer of
> GPIO_NAME_LENGTH_MAX size
> 
> +  @param[in]  GpioNameBufferSize  Size of the buffer
> 
> +
> 
> +  @retval CHAR8*  Pointer to the GPIO name
> 
> +**/
> 
> +CHAR8*
> 
> +GpioGetPadName (
> 
> +  IN GPIO_PAD  GpioPad,
> 
> +  OUT CHAR8*   GpioNameBuffer,
> 
> +  IN UINT32    GpioNameBufferSize
> 
> +  )
> 
> +{
> 
> +  UINT32                       GroupIndex;
> 
> +  UINT32                       PadNumber;
> 
> +  UINT32                       FirstUniquePadNumber;
> 
> +  CONST GPIO_GROUP_NAME_INFO*  GroupNameInfo;
> 
> +
> 
> +  if (GpioNameBuffer == NULL) {
> 
> +    ASSERT (FALSE);
> 
> +    return NULL;
> 
> +  }
> 
> +  if ((GpioNameBufferSize < GPIO_NAME_LENGTH_MAX) ||
> !GpioIsPadValid (GpioPad)) {
> 
> +    ASSERT (FALSE);
> 
> +    *GpioNameBuffer = 0;
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  GroupNameInfo = GpioGetGroupNameInfo (GroupIndex);
> 
> +  if (GroupNameInfo == NULL) {
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  FirstUniquePadNumber = GpioGetPadNumberFromGpioPad
> (GroupNameInfo->FirstUniqueGpio);
> 
> +  if ((PadNumber < FirstUniquePadNumber) || (GroupNameInfo-
> >GroupUniqueNames == NULL)) {
> 
> +    AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX,
> "GPIO_%a%d", GpioGetGroupName (GroupIndex), PadNumber);
> 
> +  } else {
> 
> +    if ((PadNumber - FirstUniquePadNumber) < GroupNameInfo-
> >UniqueNamesTableSize) {
> 
> +      AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX, "GPIO_%a",
> GroupNameInfo->GroupUniqueNames[PadNumber -
> FirstUniquePadNumber]);
> 
> +    } else {
> 
> +      AsciiSPrint (GpioNameBuffer, GPIO_NAME_LENGTH_MAX,
> "GPIO_%08X", GpioPad);
> 
> +      ASSERT (FALSE);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return GpioNameBuffer;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> GpioNativeLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioNativeLib.c
> new file mode 100644
> index 0000000000..97244c665b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /GpioNativeLib.c
> @@ -0,0 +1,193 @@
> +/** @file
> 
> +  This file contains routines for GPIO native and chipset specific usage
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "GpioLibrary.h"
> 
> +
> 
> +/**
> 
> +  This procedure will get number of pads for certain GPIO group
> 
> +
> 
> +  @param[in] Group            GPIO group number
> 
> +
> 
> +  @retval Value               Pad number for group
> 
> +                              If illegal group number then return 0
> 
> +**/
> 
> +UINT32
> 
> +GpioGetPadPerGroup (
> 
> +  IN GPIO_GROUP      Group
> 
> +  )
> 
> +{
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 GroupIndex;
> 
> +  //
> 
> +  // Check if group argument exceeds GPIO GROUP INFO array
> 
> +  //
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +  GroupIndex = GpioGetGroupIndexFromGroup (Group);
> 
> +
> 
> +  if ((UINTN) GroupIndex >= GpioGroupInfoLength) {
> 
> +    return 0;
> 
> +  } else {
> 
> +    return GpioGroupInfo[GroupIndex].PadPerGroup;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get number of groups
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Group number
> 
> +**/
> 
> +UINT32
> 
> +GpioGetNumberOfGroups (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +
> 
> +  GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +  return GpioGroupInfoLength;
> 
> +}
> 
> +/**
> 
> +  This procedure will get lowest group
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Lowest Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetLowestGroup (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return GpioGetGroupFromGroupIndex (0);
> 
> +}
> 
> +/**
> 
> +  This procedure will get highest group
> 
> +
> 
> +  @param[in] none
> 
> +
> 
> +  @retval Value               Highest Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetHighestGroup (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return GpioGetGroupFromGroupIndex (GpioGetNumberOfGroups () - 1);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get group number
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Group number
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetGroupFromGpioPad (
> 
> +  IN GPIO_PAD         GpioPad
> 
> +  )
> 
> +{
> 
> +  return GPIO_GET_GROUP_FROM_PAD (GpioPad);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get group index (0 based)
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Group Index
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupIndexFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  )
> 
> +{
> 
> +  return (UINT32) GPIO_GET_GROUP_INDEX_FROM_PAD (GpioPad);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get group index (0 based) from group
> 
> +
> 
> +  @param[in] GpioGroup        Gpio Group
> 
> +
> 
> +  @retval Value               Group Index
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupIndexFromGroup (
> 
> +  IN GPIO_GROUP        GpioGroup
> 
> +  )
> 
> +{
> 
> +  return (UINT32) GPIO_GET_GROUP_INDEX (GpioGroup);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get group from group index (0 based)
> 
> +
> 
> +  @param[in] GroupIndex        Group Index
> 
> +
> 
> +  @retval GpioGroup            Gpio Group
> 
> +**/
> 
> +GPIO_GROUP
> 
> +GpioGetGroupFromGroupIndex (
> 
> +  IN UINT32        GroupIndex
> 
> +  )
> 
> +{
> 
> +  return GPIO_GROUP_DEF (GroupIndex, GpioGetThisChipsetId ());
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get pad number (0 based) from Gpio Pad
> 
> +
> 
> +  @param[in] GpioPad          Gpio Pad
> 
> +
> 
> +  @retval Value               Pad Number
> 
> +**/
> 
> +UINT32
> 
> +GpioGetPadNumberFromGpioPad (
> 
> +  IN GPIO_PAD        GpioPad
> 
> +  )
> 
> +{
> 
> +  return (UINT32) GPIO_GET_PAD_NUMBER (GpioPad);
> 
> +}
> 
> +/**
> 
> +  This procedure will return GpioPad from Group and PadNumber
> 
> +
> 
> +  @param[in] Group              GPIO group
> 
> +  @param[in] PadNumber          GPIO PadNumber
> 
> +
> 
> +  @retval GpioPad               GpioPad
> 
> +**/
> 
> +GPIO_PAD
> 
> +GpioGetGpioPadFromGroupAndPadNumber (
> 
> +  IN GPIO_GROUP      Group,
> 
> +  IN UINT32          PadNumber
> 
> +  )
> 
> +{
> 
> +  return GPIO_PAD_DEF (Group,PadNumber);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will return GpioPad from GroupIndex and PadNumber
> 
> +
> 
> +  @param[in] GroupIndex         GPIO GroupIndex
> 
> +  @param[in] PadNumber          GPIO PadNumber
> 
> +
> 
> +  @retval GpioPad               GpioPad
> 
> +**/
> 
> +GPIO_PAD
> 
> +GpioGetGpioPadFromGroupIndexAndPadNumber (
> 
> +  IN UINT32          GroupIndex,
> 
> +  IN UINT32          PadNumber
> 
> +  )
> 
> +{
> 
> +  GPIO_GROUP Group;
> 
> +
> 
> +  Group = GPIO_GROUP_DEF (GroupIndex, GpioGetThisChipsetId ());
> 
> +  return GPIO_PAD_DEF (Group, PadNumber);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib/
> PeiDxeSmmGpioLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /PeiDxeSmmGpioLib.inf
> new file mode 100644
> index 0000000000..0a888a38ba
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/Library/PeiDxeSmmGpioLib
> /PeiDxeSmmGpioLib.inf
> @@ -0,0 +1,49 @@
> +## @file
> 
> +# Component description file for the PeiDxeSmmGpioLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmGpioLib
> 
> +FILE_GUID = 16EC5CA8-8195-4847-B6CB-662BD7B763F2
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = GpioLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PrintLib
> 
> +PchCycleDecodingLib
> 
> +PchSbiAccessLib
> 
> +PmcPrivateLib
> 
> +GpioPrivateLib
> 
> +SataLib
> 
> +GpioHelpersLib
> 
> +GpioCheckConflictLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Pcd]
> 
> +
> 
> +[Sources]
> 
> +GpioLib.c
> 
> +GpioNativeLib.c
> 
> +GpioInit.c
> 
> +GpioNames.c
> 
> +GpioLibrary.h
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.c
> new file mode 100644
> index 0000000000..2c7a1987d9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.c
> @@ -0,0 +1,119 @@
> +/** @file
> 
> +  This file contains NULL implementation for GPIO Helpers Lib
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/GpioConfig.h>
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO pad unlock information
> 
> +
> 
> +  @param[in] GpioPad         GPIO pad
> 
> +  @param[in] GpioLockConfig  GPIO Lock Configuration
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreUnlockData (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN GPIO_LOCK_CONFIG     GpioLockConfig
> 
> +  )
> 
> +{
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which PadConfig needs
> to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  UnlockedPads        DWORD bitmask for pads which are going
> to be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockPadConfigData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  )
> 
> +{
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which Output state
> needs to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  UnlockedPads        DWORD bitmask for pads which are going
> to be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockOutputData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  )
> 
> +{
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which PadConfig is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockPadConfigMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  )
> 
> +{
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which Output is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockOutputMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  )
> 
> +{
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Gpio Override Level1 Information
> 
> +
> 
> +  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioOverrideLevel1Enabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.inf
> new file mode 100644
> index 0000000000..756359d1e3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/BaseGpioHel
> persLibNull/BaseGpioHelpersLibNull.inf
> @@ -0,0 +1,26 @@
> +## @file
> 
> +# Component description file for the NULL GpioHelpersLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = BaseGpioHelpersLib
> 
> +FILE_GUID = AB282608-2A50-4AE3-9242-64064ECF40D4
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = GpioHelpersLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +BaseGpioHelpersLibNull.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/DxeGpioNameBufferLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/DxeGpioNameBufferLib.inf
> new file mode 100644
> index 0000000000..43860b7d20
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/DxeGpioNameBufferLib.inf
> @@ -0,0 +1,32 @@
> +## @file
> 
> +# Component description file for the DxeGpioMemLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeGpioNameBufferLib
> 
> +FILE_GUID = 16EC6AA8-81D5-4847-B6CB-662CDAB863F2
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +LIBRARY_CLASS = GpioNameBufferLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +GpioNameBufferDxe.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/GpioNameBufferDxe.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/GpioNameBufferDxe.c
> new file mode 100644
> index 0000000000..87dc9a2cd5
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioNam
> eBufferLib/GpioNameBufferDxe.c
> @@ -0,0 +1,19 @@
> +/** @file
> 
> +  This file contains implementation of the GpioMemLib for DXE phase
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/GpioNameBufferLib.h>
> 
> +
> 
> +STATIC CHAR8 mGpioNameBuffer[GPIO_NAME_LENGTH_MAX];
> 
> +
> 
> +CHAR8*
> 
> +GpioGetStaticNameBuffer (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mGpioNameBuffer;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.c
> new file mode 100644
> index 0000000000..e9fe6f04e0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.c
> @@ -0,0 +1,87 @@
> +/** @file
> 
> +  This file provides services for Gpio policy function
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <ConfigBlock/Gpio/GpioDevConfig.h>
> 
> +
> 
> +/**
> 
> +  Print GPIO_DXE_CONFIG and serial out.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +GpioDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +  GPIO_DXE_CONFIG   *GpioDxeConfig;
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) PchPolicy, &gGpioDxeConfigGuid, (VOID
> *) &GpioDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------ GPIO DXE Config ------------------
> \n"));
> 
> +  DEBUG ((DEBUG_INFO, " HideGpioAcpiDevice : %d\n", GpioDxeConfig-
> >HideGpioAcpiDevice));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for GPIO
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +GpioDxeLoadConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  GPIO_DXE_CONFIG  *GpioDxeConfig;
> 
> +  GpioDxeConfig = ConfigBlockPointer;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "GpioDxeConfig->Header.GuidHob.Name =
> %g\n", &GpioDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "GpioDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", GpioDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +
> 
> +  GpioDxeConfig->HideGpioAcpiDevice = 0;
> 
> +}
> 
> +
> 
> +STATIC COMPONENT_BLOCK_ENTRY  mGpioBlocks = {
> 
> +  &gGpioDxeConfigGuid,
> 
> +  sizeof (GPIO_DXE_CONFIG),
> 
> +  GPIO_DXE_CONFIG_REVISION,
> 
> +  GpioDxeLoadConfigDefault
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get Gpio config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +GpioDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mGpioBlocks.Size;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Add Gpio ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  )
> 
> +{
> 
> +  return AddComponentConfigBlocks (ConfigBlockTableAddress,
> &mGpioBlocks, 1);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.inf
> new file mode 100644
> index 0000000000..1b9d53f40c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/DxeGpioPolic
> yLib/DxeGpioPolicyLib.inf
> @@ -0,0 +1,31 @@
> +## @file
> 
> +# Component description file for the Gpio policy library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeGpioPolicyLib
> 
> +FILE_GUID = 2D2B8ECA-E343-4036-A289-3F39545AEA06
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeGpioPolicyLib
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +ConfigBlockLib
> 
> +SiConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeGpioPolicyLib.c
> 
> +
> 
> +[Guids]
> 
> +gGpioDxeConfigGuid  ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioNamesVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioNamesVer2.c
> new file mode 100644
> index 0000000000..4084583122
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioNamesVer2.c
> @@ -0,0 +1,88 @@
> +/** @file
> 
> +  This file contains GPIO name library implementation specific to Ver2
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Pins/GpioPinsVer2Lp.h>
> 
> +
> 
> +STATIC CONST CHAR8*  mGpioGppbNames[] = {
> 
> +  "GSPI0_CLK_LOOPBK",
> 
> +  "GSPI1_CLK_LOOPBK"
> 
> +};
> 
> +
> 
> +STATIC CONST CHAR8*  mGpioGppaNames[] = {
> 
> +  "SPI0_CLK_LOOPBK",
> 
> +  "ESPI_CLK_LOOPBK"
> 
> +};
> 
> +
> 
> +STATIC CONST CHAR8*  mPchLpGpioGpdNames[] = {
> 
> +  "INPUT3VSEL",
> 
> +  "SLP_LANB",
> 
> +  "SLP_SUSB",
> 
> +  "SLP_WAKEB",
> 
> +  "SLP_DRAM_RESETB"
> 
> +};
> 
> +
> 
> +STATIC CONST CHAR8*  mPchLpGpioGppdNames[] = {
> 
> +  "GSPI2_CLK_LOOPBK"
> 
> +};
> 
> +
> 
> +STATIC CONST CHAR8*  mGpioGppfNames[] = {
> 
> +  "GPPF_CLK_LOOPBK"
> 
> +};
> 
> +
> 
> +STATIC CONST CHAR8*  mGpioGppeNames[] = {
> 
> +  "GPPE_CLK_LOOPBK"
> 
> +};
> 
> +
> 
> +
> 
> +STATIC CONST GPIO_GROUP_NAME_INFO  mPchLpGroupDescriptors[] = {
> 
> +  GPIO_GROUP_NAME("GPP_B", GPIO_VER2_LP_GSPI0_CLK_LOOPBK,
> mGpioGppbNames),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME("GPP_A", GPIO_VER2_LP_ESPI_CLK_LOOPBK,
> mGpioGppaNames),
> 
> +  GPIO_GROUP_NAME_BASIC("GPP_R"),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME("GPD", GPIO_VER2_LP_INPUT3VSEL,
> mPchLpGpioGpdNames),
> 
> +  GPIO_GROUP_NAME_BASIC("GPP_S"),
> 
> +  GPIO_GROUP_NAME_BASIC("GPP_H"),
> 
> +  GPIO_GROUP_NAME("GPP_D", GPIO_VER2_LP_GSPI2_CLK_LOOPBK,
> mPchLpGpioGppdNames),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME_BASIC("GPP_C"),
> 
> +  GPIO_GROUP_NAME("GPP_F", GPIO_VER2_LP_GPPF_CLK_LOOPBK,
> mGpioGppfNames),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME("GPP_E", GPIO_VER2_LP_GPPE_CLK_LOOPBK,
> mGpioGppeNames),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME_BASIC(""),
> 
> +  GPIO_GROUP_NAME_BASIC("")
> 
> +};
> 
> +
> 
> +/**
> 
> +  Returns GPIO_GROUP_NAME_INFO corresponding to the given GpioPad
> 
> +
> 
> +  @param[in] GroupIndex  Group index
> 
> +
> 
> +  @retval GPIO_GROUP_NAME_INFO*  Pointer to the
> GPIO_GROUP_NAME_INFO
> 
> +  @reval  NULL                   If no group descriptor was found
> 
> +**/
> 
> +CONST
> 
> +GPIO_GROUP_NAME_INFO*
> 
> +GpioGetGroupNameInfo (
> 
> +  IN UINT32  GroupIndex
> 
> +  )
> 
> +{
> 
> +  if (GroupIndex < ARRAY_SIZE (mPchLpGroupDescriptors)) {
> 
> +    return &mPchLpGroupDescriptors[GroupIndex];
> 
> +  }
> 
> +
> 
> +  ASSERT (FALSE);
> 
> +  return NULL;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLib.c
> new file mode 100644
> index 0000000000..f750d77e9a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLib.c
> @@ -0,0 +1,395 @@
> +/** @file
> 
> +  This file contains GPIO routines for RC usage
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Library/GpioNameBufferLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/GpioRegs.h>
> 
> +
> 
> +/**
> 
> +  This procedure is used to check if GpioPad is valid for certain chipset
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +
> 
> +  @retval TRUE                    This pin is valid on this chipset
> 
> +          FALSE                   Incorrect pin
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsCorrectPadForThisChipset (
> 
> +  IN  GPIO_PAD        GpioPad
> 
> +  )
> 
> +{
> 
> +  return ((GPIO_GET_CHIPSET_ID (GpioPad) == GpioGetThisChipsetId ())
> &&
> 
> +         (GpioGetGroupIndexFromGpioPad (GpioPad) <
> GpioGetNumberOfGroups ()));
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure is used by PchSmiDispatcher and will return information
> 
> +  needed to register GPI SMI.
> 
> +
> 
> +  @param[in]  Index                   GPI SMI number
> 
> +  @param[out] GpioPin                 GPIO pin
> 
> +  @param[out] GpiSmiBitOffset         GPI SMI bit position within GpiSmi
> Registers
> 
> +  @param[out] GpiHostSwOwnRegAddress  Address of HOSTSW_OWN
> register
> 
> +  @param[out] GpiSmiStsRegAddress     Address of GPI SMI status register
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadAndSmiRegs (
> 
> +  IN UINT32            Index,
> 
> +  OUT GPIO_PAD         *GpioPin,
> 
> +  OUT UINT8            *GpiSmiBitOffset,
> 
> +  OUT UINT32           *GpiHostSwOwnRegAddress,
> 
> +  OUT UINT32           *GpiSmiStsRegAddress
> 
> +  )
> 
> +{
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  GPIO_GROUP             GpioGroup;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 SmiStsRegOffset;
> 
> +  UINT32                 HostSwOwnRegOffset;
> 
> +  GPIO_PAD_OWN           PadOwnVal;
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  PadNumber = 0;
> 
> +  GroupIndex = 0;
> 
> +  for (GroupIndex = 0; GroupIndex < GpioGroupInfoLength; GroupIndex++)
> {
> 
> +    PadNumber = Index;
> 
> +    if (PadNumber < GpioGroupInfo[GroupIndex].PadPerGroup) {
> 
> +      //
> 
> +      // Found group and pad number
> 
> +      //
> 
> +      break;
> 
> +    }
> 
> +    Index = Index - GpioGroupInfo[GroupIndex].PadPerGroup;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if legal pad number
> 
> +  //
> 
> +  if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup){
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if selected group has GPI SMI Enable and Status registers
> 
> +  //
> 
> +  if (GpioGroupInfo[GroupIndex].SmiEnOffset ==
> NO_REGISTER_FOR_PROPERTY) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  GpioGroup = GpioGetGroupFromGroupIndex (GroupIndex);
> 
> +  *GpioPin = GpioGetGpioPadFromGroupAndPadNumber (GpioGroup,
> PadNumber);
> 
> +
> 
> +  DEBUG_CODE_BEGIN ();
> 
> +  //
> 
> +  // Check if selected GPIO Pad is not owned by CSME/ISH/IE
> 
> +  //
> 
> +  GpioGetPadOwnership (*GpioPin, &PadOwnVal);
> 
> +  if (PadOwnVal != GpioPadOwnHost) {
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a not owned by host!\n",
> GpioName (*GpioPin)));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  DEBUG_CODE_END ();
> 
> +
> 
> +  *GpiSmiBitOffset = (UINT8)(PadNumber % 32);
> 
> +
> 
> +  HostSwOwnRegOffset = GpioGroupInfo[GroupIndex].HostOwnOffset +
> (PadNumber / 32) * 0x4;
> 
> +  *GpiHostSwOwnRegAddress = PCH_PCR_ADDRESS
> (GpioGroupInfo[GroupIndex].Community, HostSwOwnRegOffset);
> 
> +
> 
> +  SmiStsRegOffset = GpioGroupInfo[GroupIndex].SmiStsOffset +
> (PadNumber / 32) * 0x4;
> 
> +  *GpiSmiStsRegAddress = PCH_PCR_ADDRESS
> (GpioGroupInfo[GroupIndex].Community, SmiStsRegOffset);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check if GpioPad is owned by host.
> 
> +
> 
> +  @param[in] GpioPad       GPIO pad
> 
> +
> 
> +  @retval TRUE             GPIO pad is owned by host
> 
> +  @retval FALSE            GPIO pad is not owned by host and should not be
> used with GPIO lib API
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsPadHostOwned (
> 
> +  IN GPIO_PAD             GpioPad
> 
> +  )
> 
> +{
> 
> +  GPIO_PAD_OWN         PadOwnVal;
> 
> +
> 
> +  //
> 
> +  // Check if selected GPIO Pad is not owned by CSME/ISH
> 
> +  // If GPIO is not owned by Host all access to PadCfg will be dropped
> 
> +  //
> 
> +  GpioGetPadOwnership (GpioPad, &PadOwnVal);
> 
> +  if (PadOwnVal != GpioPadOwnHost) {
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: %a is not owned by host!\n",
> GpioName (GpioPad)));
> 
> +    return FALSE;
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will check if GpioPad argument is valid.
> 
> +  Function will check below conditions:
> 
> +   - GpioPad represents a pad for current PCH
> 
> +   - GpioPad belongs to valid GpioGroup
> 
> +   - GPIO PadNumber is not greater than number of pads for this group
> 
> +
> 
> +  @param[in] GpioPad       GPIO pad
> 
> +
> 
> +  @retval TRUE             GPIO pad is valid and can be used with GPIO lib API
> 
> +  @retval FALSE            GPIO pad is invalid and cannot be used with GPIO lib
> API
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsPadValid (
> 
> +  IN GPIO_PAD             GpioPad
> 
> +  )
> 
> +{
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 PadNumber;
> 
> +  UINT32                 GroupIndex;
> 
> +
> 
> +  if (!GpioIsCorrectPadForThisChipset (GpioPad)) {
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Incorrect GpioPad (0x%08x) used
> on this chipset!\n", GpioPad));
> 
> +    goto Error;
> 
> +  }
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  //
> 
> +  // Check if legal pin number
> 
> +  //
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  if (PadNumber >= GpioGroupInfo[GroupIndex].PadPerGroup) {
> 
> +    DEBUG ((DEBUG_ERROR, "GPIO ERROR: Pin number (%d) exceeds range
> of %a group (max: %d)\n",
> 
> +                                                                                   PadNumber,
> 
> +                                                                                   GpioGetGroupName
> (GroupIndex),
> 
> +
> GpioGroupInfo[GroupIndex].PadPerGroup));
> 
> +    goto Error;
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +Error:
> 
> +  ASSERT (FALSE);
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will read GPIO Pad Configuration register
> 
> +
> 
> +  @param[in] GpioPad          GPIO pad
> 
> +  @param[in] DwReg            Choose PADCFG register: 0:DW0, 1:DW1
> 
> +
> 
> +  @retval PadCfgRegValue      PADCFG_DWx value
> 
> +**/
> 
> +UINT32
> 
> +GpioReadPadCfgReg (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN UINT8                DwReg
> 
> +  )
> 
> +{
> 
> +  UINT32                 PadCfgReg;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  //
> 
> +  // Create Pad Configuration register offset
> 
> +  //
> 
> +  PadCfgReg = GpioGroupInfo[GroupIndex].PadCfgOffset +
> S_GPIO_PCR_PADCFG * PadNumber + 0x4 * DwReg;
> 
> +
> 
> +  return MmioRead32 (PCH_PCR_ADDRESS
> (GpioGroupInfo[GroupIndex].Community, PadCfgReg));
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will write or read GPIO Pad Configuration register
> 
> +
> 
> +  @param[in] GpioPad              GPIO pad
> 
> +  @param[in] DwReg                Choose PADCFG register: 0:DW0, 1:DW1
> 
> +  @param[in] PadCfgAndMask        Mask to be AND'ed with PADCFG reg
> value
> 
> +  @param[in] PadCfgOrMask         Mask to be OR'ed with PADCFG reg value
> 
> +
> 
> +  @retval none
> 
> +**/
> 
> +VOID
> 
> +GpioWritePadCfgReg (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN UINT8                DwReg,
> 
> +  IN UINT32               PadCfgAndMask,
> 
> +  IN UINT32               PadCfgOrMask
> 
> +  )
> 
> +{
> 
> +  UINT32                 PadCfgReg;
> 
> +  CONST GPIO_GROUP_INFO  *GpioGroupInfo;
> 
> +  UINT32                 GpioGroupInfoLength;
> 
> +  UINT32                 GroupIndex;
> 
> +  UINT32                 PadNumber;
> 
> +  UINT32                 PadCfgLock;
> 
> +  UINT32                 PadCfgLockTx;
> 
> +
> 
> +  PadCfgLock = 0;
> 
> +  PadCfgLockTx = 0;
> 
> +
> 
> +  //
> 
> +  // Check if Pad Configuration (except output state) is to be changed.
> 
> +  // If AND and OR masks will indicate that configuration fields (other than
> output control)
> 
> +  // are to be modified it means that there is a need to perform an unlock (if
> set)
> 
> +  //
> 
> +  if ((~PadCfgAndMask | PadCfgOrMask) &
> (UINT32)~B_GPIO_PCR_TX_STATE) {
> 
> +    GpioGetPadCfgLock (GpioPad, &PadCfgLock);
> 
> +    if (PadCfgLock) {
> 
> +      GpioUnlockPadCfg (GpioPad);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if Pad Output state is to be changed
> 
> +  // If AND and OR masks will indicate that output control
> 
> +  // is to be modified it means that there is a need to perform an unlock (if
> set)
> 
> +  //
> 
> +  if ((~PadCfgAndMask | PadCfgOrMask) & B_GPIO_PCR_TX_STATE) {
> 
> +    GpioGetPadCfgLockTx (GpioPad, &PadCfgLockTx);
> 
> +    if (PadCfgLockTx) {
> 
> +      GpioUnlockPadCfgTx (GpioPad);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +
> 
> +  GpioGroupInfo = GpioGetGroupInfoTable (&GpioGroupInfoLength);
> 
> +
> 
> +  //
> 
> +  // Create Pad Configuration register offset
> 
> +  //
> 
> +  PadCfgReg = GpioGroupInfo[GroupIndex].PadCfgOffset +
> S_GPIO_PCR_PADCFG * PadNumber + 0x4 * DwReg;
> 
> +
> 
> +  MmioAndThenOr32 (
> 
> +    PCH_PCR_ADDRESS (GpioGroupInfo[GroupIndex].Community,
> PadCfgReg),
> 
> +    PadCfgAndMask,
> 
> +    PadCfgOrMask
> 
> +    );
> 
> +
> 
> +  if (PadCfgLock) {
> 
> +    GpioLockPadCfg (GpioPad);
> 
> +  }
> 
> +  if (PadCfgLockTx) {
> 
> +    GpioLockPadCfgTx (GpioPad);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will set GPIO mode
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[in]  PadModeValue        GPIO pad mode value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid group or pad number
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioSetPadMode (
> 
> +  IN GPIO_PAD                GpioPad,
> 
> +  IN GPIO_PAD_MODE           PadModeValue
> 
> +  )
> 
> +{
> 
> +  UINT32               PadCfgOrMask;
> 
> +
> 
> +  PadCfgOrMask = 0;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  if (PadModeValue != (GPIO_PAD_MODE)GpioHardwareDefault) {
> 
> +
> 
> +    PadCfgOrMask = (((PadModeValue & B_GPIO_PAD_MODE_MASK) >>
> (N_GPIO_PAD_MODE_BIT_POS + 1)) << N_GPIO_PCR_PAD_MODE);
> 
> +
> 
> +    GpioWritePadCfgReg (
> 
> +      GpioPad,
> 
> +      0,
> 
> +      (UINT32)~B_GPIO_PCR_PAD_MODE,
> 
> +      PadCfgOrMask
> 
> +      );
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO mode
> 
> +
> 
> +  @param[in]  GpioPad             GPIO pad
> 
> +  @param[out] PadModeValue        GPIO pad mode value
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid GpioPad
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioGetPadMode (
> 
> +  IN  GPIO_PAD                 GpioPad,
> 
> +  OUT GPIO_PAD_MODE            *PadModeValue
> 
> +  )
> 
> +{
> 
> +  UINT32        PadCfgRegValue;
> 
> +
> 
> +  if (!GpioIsPadValid (GpioPad)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (!GpioIsPadHostOwned (GpioPad)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  PadCfgRegValue = GpioReadPadCfgReg (GpioPad, 0);
> 
> +
> 
> +  *PadModeValue = (GPIO_PAD_MODE)(((PadCfgRegValue &
> B_GPIO_PCR_PAD_MODE) >> (N_GPIO_PCR_PAD_MODE -
> (N_GPIO_PAD_MODE_BIT_POS + 1))) | (0x1 <<
> N_GPIO_PAD_MODE_BIT_POS));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Generates GPIO name from GpioPad
> 
> +  This function returns pointer to the static buffer
> 
> +
> 
> +  @param[in] GpioPad  GpioPad
> 
> +
> 
> +  @retval CHAR8*  Pointer to the gpio name string
> 
> +**/
> 
> +CHAR8*
> 
> +GpioName (
> 
> +  IN GPIO_PAD  GpioPad
> 
> +  )
> 
> +{
> 
> +  return GpioGetPadName (GpioPad, GpioGetStaticNameBuffer (),
> GPIO_NAME_LENGTH_MAX);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLibVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLibVer2.c
> new file mode 100644
> index 0000000000..9fea5daa28
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/GpioPrivateLibVer2.c
> @@ -0,0 +1,131 @@
> +/** @file
> 
> +  This file contains VER2 specific GPIO information
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Library/GpioHelpersLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/CpuRegbarAccessLib.h>
> 
> +#include <Register/GpioRegsVer2.h>
> 
> +#include <Register/PmcRegsVer2.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Pins/GpioPinsVer2Lp.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED GPIO_GROUP_INFO
> mPchLpGpioGroupInfo[] = {
> 
> +  {PID_GPIOCOM0, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_GPI_GPE_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_SMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_NMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_B_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_B_PAD_MAX}, //TGL PCH-LP GPP_B
> 
> +  {PID_GPIOCOM0, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM0, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_A_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_A_PAD_MAX}, //TGL PCH-LP GPP_A
> 
> +  {PID_GPIOCOM5, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_R_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_R_PAD_MAX}, //TGL PCH-LP GPP_R
> 
> +  {PID_GPIOCOM5, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM2, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPD_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPD_PAD_MAX},   //TGL PCH-LP GPD
> 
> +  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_S_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_S_PAD_MAX}, //TGL PCH-LP GPP_S
> 
> +  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_H_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_H_PAD_MAX}, //TGL PCH-LP GPP_H
> 
> +  {PID_GPIOCOM1, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_GPI_GPE_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_SMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_NMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_D_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_D_PAD_MAX}, //TGL PCH-LP GPP_D
> 
> +  {PID_GPIOCOM1, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM1, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_GPI_GPE_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_SMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_NMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_C_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_C_PAD_MAX}, //TGL PCH-LP GPP_C
> 
> +  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_GPI_GPE_EN,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,            NO_REGISTER_FOR_PROPERTY,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_F_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_F_PAD_MAX}, //TGL PCH-LP GPP_F
> 
> +  {PID_GPIOCOM4, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM4, R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PAD_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_HOSTSW_OWN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_IE,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_GPI_GPE_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_SMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_STS,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_NMI_EN,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCK,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFGLOCKTX,
> R_GPIO_VER2_PCH_LP_GPIO_PCR_GPP_E_PADCFG_OFFSET,
> GPIO_VER2_PCH_LP_GPIO_GPP_E_PAD_MAX}, //TGL PCH-LP GPP_E
> 
> +  {PID_GPIOCOM4, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM3, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0},
> 
> +  {PID_GPIOCOM3, NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                      NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                 NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                     NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,           NO_REGISTER_FOR_PROPERTY,
> NO_REGISTER_FOR_PROPERTY,                         NO_REGISTER_FOR_PROPERTY,
> 0}
> 
> +};
> 
> +
> 
> +/**
> 
> +  This procedure will retrieve address and length of GPIO info table
> 
> +
> 
> +  @param[out]  GpioGroupInfoTableLength   Length of GPIO group table
> 
> +
> 
> +  @retval Pointer to GPIO group table
> 
> +
> 
> +**/
> 
> +CONST GPIO_GROUP_INFO*
> 
> +GpioGetGroupInfoTable (
> 
> +  OUT UINT32              *GpioGroupInfoTableLength
> 
> +  )
> 
> +{
> 
> +  *GpioGroupInfoTableLength = ARRAY_SIZE (mPchLpGpioGroupInfo);
> 
> +  return mPchLpGpioGroupInfo;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get GPIO Chipset ID specific to PCH generation and series
> 
> +**/
> 
> +UINT32
> 
> +GpioGetThisChipsetId (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return GPIO_VER2_LP_CHIPSET_ID;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This internal procedure will check if group is within DeepSleepWell.
> 
> +
> 
> +  @param[in]  Group               GPIO Group
> 
> +
> 
> +  @retval GroupWell               TRUE:  This is DSW Group
> 
> +                                  FALSE: This is not DSW Group
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioIsDswGroup (
> 
> +  IN  GPIO_GROUP         Group
> 
> +  )
> 
> +{
> 
> +  if (Group == GPIO_VER2_LP_GROUP_GPD) {
> 
> +    return TRUE;
> 
> +  } else {
> 
> +    return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED GPIO_GROUP_TO_GPE_MAPPING
> mPchLpGpioGroupToGpeMapping[] = {
> 
> +    {GPIO_VER2_LP_GROUP_GPP_B,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_B},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_A,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_A},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_R,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_R},
> 
> +    {GPIO_VER2_LP_GROUP_GPD,     0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPD  },
> 
> +    {GPIO_VER2_LP_GROUP_GPP_S,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_S},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_H,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_H},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_D,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_D},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_C,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_C},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_F,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_F},
> 
> +    {GPIO_VER2_LP_GROUP_GPP_E,   0,
> V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_E}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get information for GPIO Group required to program GPIO and PMC for
> desired 1-Tier GPE mapping
> 
> +
> 
> +  @param[out] GpioGroupToGpeMapping        Table with GPIO Group to
> GPE mapping
> 
> +  @param[out] GpioGroupToGpeMappingLength  GPIO Group to GPE
> mapping table length
> 
> +**/
> 
> +VOID
> 
> +GpioGetGroupToGpeMapping (
> 
> +  OUT GPIO_GROUP_TO_GPE_MAPPING  **GpioGroupToGpeMapping,
> 
> +  OUT UINT32                     *GpioGroupToGpeMappingLength
> 
> +  )
> 
> +{
> 
> +  *GpioGroupToGpeMapping = mPchLpGpioGroupToGpeMapping;
> 
> +  *GpioGroupToGpeMappingLength = ARRAY_SIZE
> (mPchLpGpioGroupToGpeMapping);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if 0x13 opcode supported for writing to GPIO lock unlock register
> 
> +
> 
> +  @retval TRUE                It's supported
> 
> +  @retval FALSE               It's not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsGpioLockOpcodeSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
> new file mode 100644
> index 0000000000..a355f407f8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiDxeSmm
> GpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
> @@ -0,0 +1,46 @@
> +## @file
> 
> +#  Component description file for the PeiDxeSmmGpioPrivateLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION                    = 0x00010017
> 
> +BASE_NAME                      = PeiDxeSmmGpioPrivateLibVer2
> 
> +FILE_GUID                      = 680A81B0-A087-4687-B5B4-146DA30042D6
> 
> +VERSION_STRING                 = 1.0
> 
> +MODULE_TYPE                    = BASE
> 
> +LIBRARY_CLASS                  = GpioPrivateLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PmcLib
> 
> +  PchInfoLib
> 
> +  GpioLib
> 
> +  GpioNameBufferLib
> 
> +  SataLib
> 
> +  GpioHelpersLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  GpioPrivateLib.c
> 
> +  GpioPrivateLibVer2.c
> 
> +  GpioNamesVer2.c
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdEmbeddedEnable                          ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.c
> new file mode 100644
> index 0000000000..84bf655ab9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.c
> @@ -0,0 +1,413 @@
> +/** @file
> 
> +  This file contains routines for PEI GPIO Helpers Lib
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/HobLib.h>
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Library/GpioHelpersLib.h>
> 
> +#include <Library/PeiServicesLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <ConfigBlock/PchGeneralConfig.h>
> 
> +#include <Ppi/SiPolicy.h>
> 
> +
> 
> +extern EFI_GUID gGpioLibUnlockHobGuid;
> 
> +
> 
> +//
> 
> +//  GPIO Lock HOB
> 
> +//  Stores information on GPIO pads that should be left unlocked
> 
> +//
> 
> +typedef struct {
> 
> +  //
> 
> +  // GPIO PadConfig unlock data
> 
> +  //
> 
> +  UINT32  PadConfig;
> 
> +  //
> 
> +  // GPIO Output unlock data
> 
> +  //
> 
> +  UINT32  OutputState;
> 
> +} GPIO_UNLOCK_HOB_DATA;
> 
> +
> 
> +/**
> 
> +  This procedure will get index of GPIO Unlock HOB structure for selected
> GroupIndex and DwNum.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +
> 
> +  @retval GpioUnlockHobIndex
> 
> +**/
> 
> +STATIC
> 
> +UINT32
> 
> +GpioUnlockDataIndex (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  )
> 
> +{
> 
> +  UINT32         GpioUnlockDataIndex;
> 
> +  UINT32         Index;
> 
> +
> 
> +  GpioUnlockDataIndex = 0;
> 
> +
> 
> +  for (Index = 0; Index < GroupIndex; Index++) {
> 
> +    GpioUnlockDataIndex += GPIO_GET_DW_NUM (GpioGetPadPerGroup
> (GpioGetGroupFromGroupIndex (Index))) + 1;
> 
> +  }
> 
> +
> 
> +  GpioUnlockDataIndex += DwNum;
> 
> +  return GpioUnlockDataIndex;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will create GPIO HOB for storing unlock data
> 
> +
> 
> +  @retval Pointer to GPIO Unlock data structure
> 
> +**/
> 
> +STATIC
> 
> +GPIO_UNLOCK_HOB_DATA*
> 
> +GpioCreateUnlockData (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  VOID           *HobData;
> 
> +  GPIO_GROUP     Group;
> 
> +  GPIO_GROUP     GroupMin;
> 
> +  GPIO_GROUP     GroupMax;
> 
> +  UINT32         GpioUnlockDataRecords;
> 
> +
> 
> +  GroupMin = GpioGetLowestGroup ();
> 
> +  GroupMax = GpioGetHighestGroup ();
> 
> +  GpioUnlockDataRecords = 0;
> 
> +
> 
> +  for (Group = GroupMin; Group <= GroupMax; Group++) {
> 
> +    GpioUnlockDataRecords += GPIO_GET_DW_NUM (GpioGetPadPerGroup
> (Group)) + 1;
> 
> +  }
> 
> +
> 
> +  HobData = BuildGuidHob (&gGpioLibUnlockHobGuid,
> GpioUnlockDataRecords * sizeof (GPIO_UNLOCK_HOB_DATA));
> 
> +  if (HobData == NULL) {
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  ZeroMem (HobData, GpioUnlockDataRecords * sizeof
> (GPIO_UNLOCK_HOB_DATA));
> 
> +
> 
> +  return (GPIO_UNLOCK_HOB_DATA*)HobData;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will Get GPIO Unlock data structure for storing unlock data.
> 
> +  If HOB doesn't exist it will be created.
> 
> +
> 
> +  @param[out] GpioUnlockData          pointer to GPIO Unlock data structure
> 
> +
> 
> +  @retval Length                      number of GPIO unlock data records
> 
> +**/
> 
> +STATIC
> 
> +UINT32
> 
> +GpioGetUnlockData (
> 
> +  GPIO_UNLOCK_HOB_DATA  **GpioUnlockData
> 
> +  )
> 
> +{
> 
> +  VOID  *Hob;
> 
> +
> 
> +  Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
> 
> +  if (Hob == NULL) {
> 
> +    //
> 
> +    // It is the first time this function is used so create the HOB
> 
> +    //
> 
> +    *GpioUnlockData = GpioCreateUnlockData ();
> 
> +    if (*GpioUnlockData == NULL) {
> 
> +      return 0;
> 
> +    }
> 
> +    Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
> 
> +  } else {
> 
> +    *GpioUnlockData = (GPIO_UNLOCK_HOB_DATA*)
> GET_GUID_HOB_DATA (Hob);
> 
> +  }
> 
> +  return GET_GUID_HOB_DATA_SIZE (Hob) / sizeof
> (GPIO_UNLOCK_HOB_DATA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get pointer to GPIO Unlock data structure.
> 
> +
> 
> +  @param[out] GpioUnlockData          pointer to GPIO Unlock data structure
> 
> +
> 
> +  @retval Length                      number of GPIO unlock data records
> 
> +**/
> 
> +STATIC
> 
> +UINT32
> 
> +GpioLocateUnlockData (
> 
> +  GPIO_UNLOCK_HOB_DATA  **GpioUnlockData
> 
> +  )
> 
> +{
> 
> +  VOID  *Hob;
> 
> +
> 
> +  Hob = GetFirstGuidHob (&gGpioLibUnlockHobGuid);
> 
> +  if (Hob == NULL) {
> 
> +    *GpioUnlockData = NULL;
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  *GpioUnlockData = (GPIO_UNLOCK_HOB_DATA*) GET_GUID_HOB_DATA
> (Hob);
> 
> +  return GET_GUID_HOB_DATA_SIZE (Hob) / sizeof
> (GPIO_UNLOCK_HOB_DATA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO pad unlock information
> 
> +
> 
> +  @param[in] GpioPad         GPIO pad
> 
> +  @param[in] GpioLockConfig  GPIO Lock Configuration
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreUnlockData (
> 
> +  IN GPIO_PAD             GpioPad,
> 
> +  IN GPIO_LOCK_CONFIG     GpioLockConfig
> 
> +  )
> 
> +{
> 
> +  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
> 
> +  UINT32               Length;
> 
> +  UINT32               GroupIndex;
> 
> +  UINT32               PadNumber;
> 
> +  UINT32               Index;
> 
> +
> 
> +  if (GpioLockConfig == GpioLockDefault) {
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  Length = GpioGetUnlockData (&GpioUnlockData);
> 
> +  if (Length == 0) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +
> 
> +  GroupIndex = GpioGetGroupIndexFromGpioPad (GpioPad);
> 
> +  PadNumber = GpioGetPadNumberFromGpioPad (GpioPad);
> 
> +  Index = GpioUnlockDataIndex (GroupIndex, GPIO_GET_DW_NUM
> (PadNumber));
> 
> +
> 
> +  if (Index >= Length) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if ((GpioLockConfig & B_GPIO_LOCK_CONFIG_PAD_CONF_LOCK_MASK)
> == GpioPadConfigUnlock) {
> 
> +    GpioUnlockData[Index].PadConfig |= 1 <<
> (GpioGetPadNumberFromGpioPad (GpioPad) % 32);
> 
> +  }
> 
> +
> 
> +  if ((GpioLockConfig & B_GPIO_LOCK_CONFIG_OUTPUT_LOCK_MASK) ==
> GpioOutputStateUnlock) {
> 
> +    GpioUnlockData[Index].OutputState |= 1 <<
> (GpioGetPadNumberFromGpioPad (GpioPad) % 32);
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which PadConfig needs
> to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  UnlockedPads        DWORD bitmask for pads which are going
> to be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockPadConfigData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  )
> 
> +{
> 
> +  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
> 
> +  UINT32               Length;
> 
> +  UINT32               Index;
> 
> +
> 
> +  if (UnlockedPads == 0) {
> 
> +    //
> 
> +    // No pads to be left unlocked
> 
> +    //
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  Length = GpioGetUnlockData (&GpioUnlockData);
> 
> +  if (Length == 0) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +
> 
> +  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
> 
> +  if (Index >= Length) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  GpioUnlockData[Index].PadConfig |= UnlockedPads;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure stores GPIO group data about pads which Output state
> needs to be unlocked.
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @param[in]  UnlockedPads        DWORD bitmask for pads which are going
> to be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: Skip, 1: Leave unlocked
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +GpioStoreGroupDwUnlockOutputData (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum,
> 
> +  IN UINT32                       UnlockedPads
> 
> +  )
> 
> +{
> 
> +  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
> 
> +  UINT32               Length;
> 
> +  UINT32               Index;
> 
> +
> 
> +  if (UnlockedPads == 0) {
> 
> +    //
> 
> +    // No pads to be left unlocked
> 
> +    //
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  Length = GpioGetUnlockData (&GpioUnlockData);
> 
> +  if (Length == 0) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +
> 
> +  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
> 
> +  if (Index >= Length) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  GpioUnlockData[Index].OutputState |= UnlockedPads;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which PadConfig is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockPadConfigMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  )
> 
> +{
> 
> +  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
> 
> +  UINT32               Length;
> 
> +  UINT32               Index;
> 
> +
> 
> +  Length = GpioLocateUnlockData (&GpioUnlockData);
> 
> +  if (Length == 0) {
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
> 
> +  if (Index >= Length) {
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  return GpioUnlockData[Index].PadConfig;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This procedure will get GPIO group data with pads, which Output is
> supposed to be left unlock
> 
> +
> 
> +  @param[in]  GroupIndex          GPIO group index
> 
> +  @param[in]  DwNum               DWORD index for a group.
> 
> +                                  For group which has less then 32 pads per group DwNum
> must be 0.
> 
> +  @retval     UnlockedPads        DWORD bitmask for pads which are going to
> be left unlocked
> 
> +                                  Bit position - PadNumber
> 
> +                                  Bit value - 0: to be locked, 1: Leave unlocked
> 
> +**/
> 
> +UINT32
> 
> +GpioGetGroupDwUnlockOutputMask (
> 
> +  IN UINT32                       GroupIndex,
> 
> +  IN UINT32                       DwNum
> 
> +  )
> 
> +{
> 
> +  GPIO_UNLOCK_HOB_DATA *GpioUnlockData;
> 
> +  UINT32               Length;
> 
> +  UINT32               Index;
> 
> +
> 
> +  Length = GpioLocateUnlockData (&GpioUnlockData);
> 
> +  if (Length == 0) {
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  Index = GpioUnlockDataIndex (GroupIndex, DwNum);
> 
> +  if (Index >= Length) {
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  return GpioUnlockData[Index].OutputState;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Obtains GpioOverride Information from PreMem config
> 
> +
> 
> +  @retval  TRUE    GPIO Override obtained successfully
> 
> +           FALSE   Unable to obtain GPIO Override data
> 
> +**/
> 
> +BOOLEAN
> 
> +STATIC
> 
> +GetGpioOverrideFromConfigBlock (
> 
> +  IN OUT  UINT8 *GpioOverride
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                   Status;
> 
> +  SI_PREMEM_POLICY_PPI         *SiPreMemPolicyPpi;
> 
> +  PCH_GENERAL_PREMEM_CONFIG    *PchGeneralPreMemConfig;
> 
> +
> 
> +  Status = PeiServicesLocatePpi (
> 
> +             &gSiPreMemPolicyPpiGuid,
> 
> +             0,
> 
> +             NULL,
> 
> +             (VOID **) &SiPreMemPolicyPpi
> 
> +             );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  Status = GetConfigBlock ((VOID *) SiPreMemPolicyPpi,
> &gPchGeneralPreMemConfigGuid, (VOID *) &PchGeneralPreMemConfig);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  *GpioOverride = (UINT8) PchGeneralPreMemConfig->GpioOverride;
> 
> +
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Gpio Override Level1 Information
> 
> +
> 
> +  @retval  TRUE/FALSE GPIO Override Level 1 Enabled/Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +GpioOverrideLevel1Enabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8           GpioOverride;
> 
> +
> 
> +  GpioOverride = 0;
> 
> +
> 
> +  if (GetGpioOverrideFromConfigBlock (&GpioOverride)) {
> 
> +    if (GpioOverride == 1) { return TRUE; }
> 
> +  }
> 
> +
> 
> +  return FALSE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.inf
> new file mode 100644
> index 0000000000..d70c2a1352
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioHelp
> ersLib/PeiGpioHelpersLib.inf
> @@ -0,0 +1,48 @@
> +## @file
> 
> +# Component description file for the PeiGpioHelpersLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiGpioHelpersLib
> 
> +FILE_GUID = 1838E1E7-3CC4-4A74-90D9-B421EF2A579F
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = PEIM
> 
> +LIBRARY_CLASS = GpioHelpersLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +HobLib
> 
> +GpioLib
> 
> +PeiServicesLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PeiGpioHelpersLib.c
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gGpioLibUnlockHobGuid
> 
> +gPchGeneralPreMemConfigGuid        ## CONSUMES
> 
> +
> 
> +[Ppis]
> 
> +gSiPreMemPolicyPpiGuid
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/GpioNameBufferPei.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/GpioNameBufferPei.c
> new file mode 100644
> index 0000000000..920d9a2cbc
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/GpioNameBufferPei.c
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  This file contains GpioMemLib implementation for PEI phase
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/GpioNameBufferLib.h>
> 
> +
> 
> +STATIC CONST EFI_GUID mGpioNamesPrivateHobGuid = {0x9AE3138D,
> 0x4EBF, 0x4E90, {0x87, 0x96, 0x11, 0xD3, 0x10, 0x04, 0x60, 0x0A}};
> 
> +
> 
> +STATIC volatile BOOLEAN mGlobalMemoryWorking = FALSE;
> 
> +
> 
> +STATIC CHAR8 mGpioNameBuffer[GPIO_NAME_LENGTH_MAX];
> 
> +
> 
> +/**
> 
> +  Returns pointer to the buffer taken from GpioLib private HOB
> 
> +
> 
> +  @retval CHAR8*  Pointer to the buffer
> 
> +**/
> 
> +STATIC
> 
> +CHAR8*
> 
> +GetBufferFromHob (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  VOID  *Hob;
> 
> +  CHAR8 *GpioNameBuffer;
> 
> +
> 
> +  Hob = NULL;
> 
> +  GpioNameBuffer = NULL;
> 
> +
> 
> +  Hob = GetFirstGuidHob (&mGpioNamesPrivateHobGuid);
> 
> +  if (Hob != NULL){
> 
> +    GpioNameBuffer = (CHAR8*) GET_GUID_HOB_DATA (Hob);
> 
> +  } else {
> 
> +    GpioNameBuffer = (CHAR8*) BuildGuidHob
> (&mGpioNamesPrivateHobGuid, GPIO_NAME_LENGTH_MAX);
> 
> +    if (GpioNameBuffer == NULL){
> 
> +      DEBUG ((DEBUG_ERROR, "Failed to setup HOB for GPIO names lib\n"));
> 
> +      ASSERT (FALSE);
> 
> +    }
> 
> +  }
> 
> +  return GpioNameBuffer;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to the global buffer to be used by GpioNamesLib
> 
> +
> 
> +  @retval CHAR8*  Pointer to the buffer
> 
> +**/
> 
> +CHAR8*
> 
> +GpioGetStaticNameBuffer (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  mGlobalMemoryWorking = TRUE;
> 
> +
> 
> +  if (mGlobalMemoryWorking) {
> 
> +    return mGpioNameBuffer;
> 
> +  } else {
> 
> +    return GetBufferFromHob ();
> 
> +  }
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/PeiGpioNameBufferLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/PeiGpioNameBufferLib.inf
> new file mode 100644
> index 0000000000..0525a42a8d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Gpio/LibraryPrivate/PeiGpioNam
> eBufferLib/PeiGpioNameBufferLib.inf
> @@ -0,0 +1,35 @@
> +## @file
> 
> +# Component description file for the PeiGpioMemLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiGpioNameBufferLib
> 
> +FILE_GUID = 16EC5CA8-8195-4847-B6CB-662CDAB863F2
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = PEIM
> 
> +LIBRARY_CLASS = GpioNameBufferLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +HobLib
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +GpioNameBufferPei.c
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component
  2021-02-01  1:36 ` [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics
> component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Graphics/AcpiTables
>   * IpBlock/Graphics/IncludePrivate
>   * IpBlock/Graphics/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
> | 1955
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommon.a
> sl                                      |  480
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
> |  398
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.as
> l                                      |  127
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
> |  314
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.asl
> |  261
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
> |   73 +++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
> |   23 +++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/Dx
> eGraphicsInitLib.h                    |   53 ++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/Dx
> eGraphicsPolicyLib.h                  |   71 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/Dx
> eIgdOpRegionInitLib.h                 |  177
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphic
> sInitLib/DxeGraphicsInitLib.c         |  135
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphic
> sInitLib/DxeGraphicsInitLib.inf       |   45 +++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphic
> sPolicyLib/DxeGraphicsPolicyLib.c     |  118
> +++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGraphic
> sPolicyLib/DxeGraphicsPolicyLib.inf   |   37 +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpR
> egionInitLib/DxeIgdOpRegionInit.c      |  541
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdOpR
> egionInitLib/DxeIgdOpRegionInitLib.inf |   49 ++++++++++++++++++++++
>  17 files changed, 4857 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
> new file mode 100644
> index 0000000000..d00a1d8f58
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/Igfx.asl
> @@ -0,0 +1,1955 @@
> +/** @file
> 
> +  This file contains the IGD OpRegion/Software ACPI Reference
> 
> +  Code.
> 
> +  It defines the methods to enable/disable output switching,
> 
> +  store display switching and LCD brightness BIOS control
> 
> +  and return valid addresses for all display device encoders
> 
> +  present in the system, etc.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +External(\PLD1, MethodObj)
> 
> +External(\PLD2, MethodObj)
> 
> +External(\ECST, MethodObj)
> 
> +External(\PBCL, MethodObj)
> 
> +External(HDOS, MethodObj)
> 
> +External(\ECON, IntObj)
> 
> +External(\PNHM, IntObj)
> 
> +External(OSYS, IntObj)
> 
> +External(CPSC)
> 
> +External(\GUAM, MethodObj)
> 
> +External(DSEN)
> 
> +External(S0ID)
> 
> +
> 
> +//
> 
> +// Default Physical Location of Device
> 
> +//
> 
> +Name (DPLD, Package (0x1) {
> 
> +             ToPLD (
> 
> +               PLD_Revision         = 0x2,
> 
> +               PLD_IgnoreColor      = 0x1,
> 
> +               PLD_Red              = 0x0,
> 
> +               PLD_Green            = 0x0,
> 
> +               PLD_Blue             = 0x0,
> 
> +               PLD_Width            = 0x320, //800 mm
> 
> +               PLD_Height           = 0x7D0, //2000 mm
> 
> +               PLD_UserVisible      = 0x1, //Set if the device connection point can be
> seen by the user without disassembly.
> 
> +               PLD_Dock             = 0x0, // Set if the device connection point resides
> in a docking station or port replicator.
> 
> +               PLD_Lid              = 0x0, // Set if this device connection point resides on
> the lid of laptop system.
> 
> +               PLD_Panel              = "TOP",    // Describes which panel surface of the
> systems housing the device connection point resides on.
> 
> +               PLD_VerticalPosition   = "CENTER", // Vertical Position on the panel
> where the device connection point resides.
> 
> +               PLD_HorizontalPosition = "RIGHT",  // Horizontal Position on the
> panel where the device connection point resides.
> 
> +               PLD_Shape              = "VERTICALRECTANGLE",
> 
> +               PLD_GroupOrientation = 0x0, // if Set, indicates vertical grouping,
> otherwise horizontal is assumed.
> 
> +               PLD_GroupToken       = 0x0, // Unique numerical value identifying a
> group.
> 
> +               PLD_GroupPosition    = 0x0, // Identifies this device connection
> points position in the group (i.e. 1st, 2nd)
> 
> +               PLD_Bay              = 0x0, // Set if describing a device in a bay or if device
> connection point is a bay.
> 
> +               PLD_Ejectable        = 0x0, // Set if the device is ejectable. Indicates
> ejectability in the absence of _EJx objects
> 
> +               PLD_EjectRequired    = 0x0, // OSPM Ejection required: Set if OSPM
> needs to be involved with ejection process. User-operated physical
> hardware ejection is not possible.
> 
> +               PLD_CabinetNumber    = 0x0, // For single cabinet system, this field
> is always 0.
> 
> +               PLD_CardCageNumber   = 0x0, // For single card cage system, this
> field is always 0.
> 
> +               PLD_Reference        = 0x0, // if Set, this _PLD defines a reference
> shape that is used to help orient the user with respect to the other shapes
> when rendering _PLDs.
> 
> +               PLD_Rotation         = 0x0, // 0 - 0deg, 1 - 45deg, 2 - 90deg, 3 - 135deg,
> 4 - 180deg, 5 - 225deg, 6 - 270deg, 7 - 315deg
> 
> +               PLD_Order            = 0x3, // Identifies the drawing order of the
> connection point described by a _PLD
> 
> +               PLD_VerticalOffset   = 0x0,
> 
> +               PLD_HorizontalOffset = 0x0
> 
> +              )
> 
> +            } // Package
> 
> +) //DPLD
> 
> +
> 
> +// Enable/Disable Output Switching.  In WIN2K/WINXP, _DOS = 0 will
> 
> +// get called during initialization to prepare for an ACPI Display
> 
> +// Switch Event.  During an ACPI Display Switch, the OS will call
> 
> +// _DOS = 2 immediately after a Notify=0x80 to temporarily disable
> 
> +// all Display Switching.  After ACPI Display Switching is complete,
> 
> +// the OS will call _DOS = 0 to re-enable ACPI Display Switching.
> 
> +Method(_DOS,1)
> 
> +{
> 
> +  //
> 
> +  // Store Display Switching and LCD brightness BIOS control bit
> 
> +  //
> 
> +  Store(And(Arg0,7),DSEN)
> 
> +
> 
> +  If(LEqual(And(Arg0,  0x3), 0))     // If _DOS[1:0]=0
> 
> +  {
> 
> +    If(CondRefOf(HDOS))
> 
> +    {
> 
> +      HDOS()
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +// Enumerate the Display Environment.  This method will return
> 
> +// valid addresses for all display device encoders present in the
> 
> +// system.  The Miniport Driver will reject the addresses for every
> 
> +// encoder that does not have an attached display device.  After
> 
> +// enumeration is complete, the OS will call the _DGS methods
> 
> +// during a display switch only for the addresses accepted by the
> 
> +// Miniport Driver.  For hot-insertion and removal of display
> 
> +// devices, a re-enumeration notification will be required so the
> 
> +// address of the newly present display device will be accepted by
> 
> +// the Miniport Driver.
> 
> +//
> 
> +Method(_DOD,0)
> 
> +{
> 
> +  //
> 
> +  // Two LFP devices are supporte by default
> 
> +  //
> 
> +  Store(2, NDID)
> 
> +  If(LNotEqual(DIDL, Zero))
> 
> +  {
> 
> +    Store(SDDL(DIDL),DID1)
> 
> +  }
> 
> +  If(LNotEqual(DDL2, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL2),DID2)
> 
> +  }
> 
> +  If(LNotEqual(DDL3, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL3),DID3)
> 
> +  }
> 
> +  If(LNotEqual(DDL4, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL4),DID4)
> 
> +  }
> 
> +  If(LNotEqual(DDL5, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL5),DID5)
> 
> +  }
> 
> +  If(LNotEqual(DDL6, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL6),DID6)
> 
> +  }
> 
> +  If(LNotEqual(DDL7, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL7),DID7)
> 
> +  }
> 
> +  If(LNotEqual(DDL8, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL8),DID8)
> 
> +  }
> 
> +  If(LNotEqual(DDL9, Zero))
> 
> +  {
> 
> +    Store(SDDL(DDL9),DID9)
> 
> +  }
> 
> +  If(LNotEqual(DD10, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD10),DIDA)
> 
> +  }
> 
> +  If(LNotEqual(DD11, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD11),DIDB)
> 
> +  }
> 
> +  If(LNotEqual(DD12, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD12),DIDC)
> 
> +  }
> 
> +  If(LNotEqual(DD13, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD13),DIDD)
> 
> +  }
> 
> +  If(LNotEqual(DD14, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD14),DIDE)
> 
> +  }
> 
> +  If(LNotEqual(DD15, Zero))
> 
> +  {
> 
> +    Store(SDDL(DD15),DIDF)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Enumerate the encoders. Note that for
> 
> +  // current silicon, the maximum number of encoders
> 
> +  // possible is 15.
> 
> +  //
> 
> +  If(LEqual(NDID,1))
> 
> +  {
> 
> +    Name(TMP1,Package() {
> 
> +          0xFFFFFFFF})
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP1,0))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID1),Index(TMP1,0))
> 
> +    }
> 
> +    Return(TMP1)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,2))
> 
> +  {
> 
> +    Name(TMP2,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP2,0))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP2,1))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID2),Index(TMP2,1))
> 
> +    }
> 
> +    Return(TMP2)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,3))
> 
> +  {
> 
> +    Name(TMP3,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP3,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP3,1))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP3,2))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID3),Index(TMP3,2))
> 
> +    }
> 
> +    Return(TMP3)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,4))
> 
> +  {
> 
> +    Name(TMP4,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP4,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP4,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP4,2))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP4,3))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID4),Index(TMP4,3))
> 
> +    }
> 
> +    Return(TMP4)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,5))
> 
> +  {
> 
> +    Name(TMP5,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP5,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP5,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP5,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMP5,3))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP5,4))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID5),Index(TMP5,4))
> 
> +    }
> 
> +    Return(TMP5)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,6))
> 
> +  {
> 
> +    Name(TMP6,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP6,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP6,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP6,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMP6,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMP6,4))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP6,5))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID6),Index(TMP6,5))
> 
> +    }
> 
> +    Return(TMP6)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,7))
> 
> +  {
> 
> +    Name(TMP7,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP7,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP7,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP7,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMP7,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMP7,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMP7,5))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP7,6))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID7),Index(TMP7,6))
> 
> +    }
> 
> +    Return(TMP7)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,8))
> 
> +  {
> 
> +    Name(TMP8,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP8,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP8,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP8,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMP8,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMP8,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMP8,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMP8,6))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP8,7))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID8),Index(TMP8,7))
> 
> +    }
> 
> +    Return(TMP8)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,9))
> 
> +  {
> 
> +    Name(TMP9,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMP9,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMP9,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMP9,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMP9,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMP9,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMP9,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMP9,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMP9,7))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMP9,8))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DID9),Index(TMP9,8))
> 
> +    }
> 
> +    Return(TMP9)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0A))
> 
> +  {
> 
> +    Name(TMPA,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPA,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPA,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPA,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPA,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPA,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPA,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPA,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPA,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPA,8))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPA,9))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDA),Index(TMPA,9))
> 
> +    }
> 
> +    Return(TMPA)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0B))
> 
> +  {
> 
> +    Name(TMPB,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPB,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPB,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPB,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPB,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPB,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPB,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPB,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPB,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPB,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPB,9))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPB,10))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDB),Index(TMPB,10))
> 
> +    }
> 
> +    Return(TMPB)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0C))
> 
> +  {
> 
> +    Name(TMPC,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPC,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPC,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPC,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPC,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPC,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPC,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPC,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPC,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPC,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPC,9))
> 
> +    Store(Or(0x10000,DIDB),Index(TMPC,10))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPC,11))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDC),Index(TMPC,11))
> 
> +    }
> 
> +    Return(TMPC)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0D))
> 
> +  {
> 
> +    Name(TMPD,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPD,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPD,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPD,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPD,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPD,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPD,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPD,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPD,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPD,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPD,9))
> 
> +    Store(Or(0x10000,DIDB),Index(TMPD,10))
> 
> +    Store(Or(0x10000,DIDC),Index(TMPD,11))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPD,12))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDD),Index(TMPD,12))
> 
> +    }
> 
> +    Return(TMPD)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0E))
> 
> +  {
> 
> +    Name(TMPE,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPE,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPE,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPE,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPE,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPE,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPE,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPE,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPE,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPE,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPE,9))
> 
> +    Store(Or(0x10000,DIDB),Index(TMPE,10))
> 
> +    Store(Or(0x10000,DIDC),Index(TMPE,11))
> 
> +    Store(Or(0x10000,DIDD),Index(TMPE,12))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPE,13))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDE),Index(TMPE,13))
> 
> +    }
> 
> +    Return(TMPE)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x0F))
> 
> +  {
> 
> +    Name(TMPF,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPF,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPF,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPF,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPF,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPF,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPF,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPF,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPF,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPF,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPF,9))
> 
> +    Store(Or(0x10000,DIDB),Index(TMPF,10))
> 
> +    Store(Or(0x10000,DIDC),Index(TMPF,11))
> 
> +    Store(Or(0x10000,DIDD),Index(TMPF,12))
> 
> +    Store(Or(0x10000,DIDE),Index(TMPF,13))
> 
> +    If (LEqual(IPTP,1)) {
> 
> +      //
> 
> +      // IGFX need report IPUA as GFX0 child
> 
> +      //
> 
> +      Store(0x00023480,Index(TMPF,14))
> 
> +    } Else {
> 
> +      Store(Or(0x10000,DIDF),Index(TMPF,14))
> 
> +    }
> 
> +    Return(TMPF)
> 
> +  }
> 
> +
> 
> +  If(LEqual(NDID,0x10))
> 
> +  {
> 
> +    Name(TMPG,Package() {
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF,
> 
> +          0xFFFFFFFF})
> 
> +    Store(Or(0x10000,DID1),Index(TMPG,0))
> 
> +    Store(Or(0x10000,DID2),Index(TMPG,1))
> 
> +    Store(Or(0x10000,DID3),Index(TMPG,2))
> 
> +    Store(Or(0x10000,DID4),Index(TMPG,3))
> 
> +    Store(Or(0x10000,DID5),Index(TMPG,4))
> 
> +    Store(Or(0x10000,DID6),Index(TMPG,5))
> 
> +    Store(Or(0x10000,DID7),Index(TMPG,6))
> 
> +    Store(Or(0x10000,DID8),Index(TMPG,7))
> 
> +    Store(Or(0x10000,DID9),Index(TMPG,8))
> 
> +    Store(Or(0x10000,DIDA),Index(TMPG,9))
> 
> +    Store(Or(0x10000,DIDB),Index(TMPG,10))
> 
> +    Store(Or(0x10000,DIDC),Index(TMPG,11))
> 
> +    Store(Or(0x10000,DIDD),Index(TMPG,12))
> 
> +    Store(Or(0x10000,DIDE),Index(TMPG,13))
> 
> +    Store(Or(0x10000,DIDF),Index(TMPG,14))
> 
> +    //
> 
> +    // IGFX need report IPUA as GFX0 child
> 
> +    // NDID can only be 0x10 if IPU is enabled
> 
> +    //
> 
> +    Store(0x00023480,Index(TMPG,15))
> 
> +    Return(TMPG)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If nothing else, return Unknown LFP.
> 
> +  // (Prevents compiler warning.)
> 
> +  //
> 
> +  Return(Package() {0x00000400})
> 
> +}
> 
> +
> 
> +Device(DD01)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID1),0x400))
> 
> +    {
> 
> +      Store(0x1, EDPV)
> 
> +      Store(NXD1, NXDX)
> 
> +      Store(DID1, DIDX)
> 
> +      Return(1)
> 
> +    }
> 
> +    If(LEqual(DID1,0))
> 
> +    {
> 
> +      Return(1)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID1))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    Return(CDDS(DID1))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD1)
> 
> +    }
> 
> +    Return(NDDS(DID1))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD02)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID2),0x400))
> 
> +    {
> 
> +      If(LEqual(And(0xF,DID2),0x1))
> 
> +      {
> 
> +        Store(0x2, EDPV)
> 
> +        Store(NXD2, NXDY)
> 
> +        Store(DID2, DIDY)
> 
> +        Return(2)
> 
> +      }
> 
> +      Store(0x2, EDPV)
> 
> +      Store(NXD2, NXDX)
> 
> +      Store(DID2, DIDX)
> 
> +      Return(2)
> 
> +    }
> 
> +    If(LEqual(DID2,0))
> 
> +    {
> 
> +      Return(2)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID2))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(LIDS,0))
> 
> +    {
> 
> +      Return(0x0)
> 
> +    }
> 
> +    Return(CDDS(DID2))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    //
> 
> +    // Return the Next State.
> 
> +    //
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD2)
> 
> +    }
> 
> +    Return(NDDS(DID2))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD03)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID3),0x400))
> 
> +    {
> 
> +      Store(0x3, EDPV)
> 
> +      Store(NXD3, NXDX)
> 
> +      Store(DID3, DIDX)
> 
> +      Return(3)
> 
> +    }
> 
> +    If(LEqual(DID3,0))
> 
> +    {
> 
> +      Return(3)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +    Return(And(0xFFFF,DID3))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID3,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID3))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD3)
> 
> +    }
> 
> +    Return(NDDS(DID3))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD04)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID4),0x400))
> 
> +    {
> 
> +      Store(0x4, EDPV)
> 
> +      Store(NXD4, NXDX)
> 
> +      Store(DID4, DIDX)
> 
> +      Return(4)
> 
> +    }
> 
> +    If(LEqual(DID4,0))
> 
> +    {
> 
> +      Return(4)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID4))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID4,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID4))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD4)
> 
> +    }
> 
> +    Return(NDDS(DID4))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State. (See table above.)
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD05)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID5),0x400))
> 
> +    {
> 
> +      Store(0x5, EDPV)
> 
> +      Store(NXD5, NXDX)
> 
> +      Store(DID5, DIDX)
> 
> +      Return(5)
> 
> +    }
> 
> +    If(LEqual(DID5,0))
> 
> +    {
> 
> +      Return(5)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID5))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID5,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID5))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD5)
> 
> +    }
> 
> +    Return(NDDS(DID5))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD06)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID6),0x400))
> 
> +    {
> 
> +      Store(0x6, EDPV)
> 
> +      Store(NXD6, NXDX)
> 
> +      Store(DID6, DIDX)
> 
> +      Return(6)
> 
> +    }
> 
> +    If(LEqual(DID6,0))
> 
> +    {
> 
> +      Return(6)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID6))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID6,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID6))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD6)
> 
> +    }
> 
> +    Return(NDDS(DID6))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD07)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID7),0x400))
> 
> +    {
> 
> +      Store(0x7, EDPV)
> 
> +      Store(NXD7, NXDX)
> 
> +      Store(DID7, DIDX)
> 
> +      Return(7)
> 
> +    }
> 
> +    If(LEqual(DID7,0))
> 
> +    {
> 
> +      Return(7)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID7))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID7,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID7))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD7)
> 
> +    }
> 
> +    Return(NDDS(DID7))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD08)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID8),0x400))
> 
> +    {
> 
> +      Store(0x8, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DID8, DIDX)
> 
> +      Return(8)
> 
> +    }
> 
> +    If(LEqual(DID8,0))
> 
> +    {
> 
> +      Return(8)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID8))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID8,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID8))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DID8))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD09)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DID9),0x400))
> 
> +    {
> 
> +      Store(0x9, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DID9, DIDX)
> 
> +      Return(9)
> 
> +    }
> 
> +    If(LEqual(DID9,0))
> 
> +    {
> 
> +      Return(9)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DID9))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DID9,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DID9))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DID9))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0A)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDA),0x400))
> 
> +    {
> 
> +      Store(0xA, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDA, DIDX)
> 
> +      Return(0x0A)
> 
> +    }
> 
> +    If(LEqual(DIDA,0))
> 
> +    {
> 
> +      Return(0x0A)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDA))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDA,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDA))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDA))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0B)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDB),0x400))
> 
> +    {
> 
> +      Store(0xB, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDB, DIDX)
> 
> +      Return(0X0B)
> 
> +    }
> 
> +    If(LEqual(DIDB,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDB))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDB,0))
> 
> +    {
> 
> +      Return(0x0B)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDB))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDB))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0C)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDC),0x400))
> 
> +    {
> 
> +      Store(0xC, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDC, DIDX)
> 
> +      Return(0X0C)
> 
> +    }
> 
> +    If(LEqual(DIDC,0))
> 
> +    {
> 
> +      Return(0x0C)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDC))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDC,0))
> 
> +    {
> 
> +      Return(0x0C)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDC))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDC))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0D)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDD),0x400))
> 
> +    {
> 
> +      Store(0xD, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDD, DIDX)
> 
> +      Return(0X0D)
> 
> +    }
> 
> +    If(LEqual(DIDD,0))
> 
> +    {
> 
> +      Return(0x0D)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDD))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDD,0))
> 
> +    {
> 
> +      Return(0x0D)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDD))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDD))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0E)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDE),0x400))
> 
> +    {
> 
> +      Store(0xE, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDE, DIDX)
> 
> +      Return(0X0E)
> 
> +    }
> 
> +    If(LEqual(DIDE,0))
> 
> +    {
> 
> +      Return(0x0E)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDE))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDE,0))
> 
> +    {
> 
> +      Return(0x0E)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDE))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDE))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +Device(DD0F)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(And(0x0F00,DIDF),0x400))
> 
> +    {
> 
> +      Store(0xF, EDPV)
> 
> +      Store(NXD8, NXDX)
> 
> +      Store(DIDF, DIDX)
> 
> +      Return(0X0F)
> 
> +    }
> 
> +    If(LEqual(DIDF,0))
> 
> +    {
> 
> +      Return(0x0F)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDF))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(DIDC,0))
> 
> +    {
> 
> +      Return(0x0F)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDF))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXD8)
> 
> +    }
> 
> +    Return(NDDS(DIDF))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +//Device for eDP
> 
> +//
> 
> +Device(DD1F)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(EDPV, 0x0))
> 
> +    {
> 
> +      Return(0x1F)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDX))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(EDPV, 0x0))
> 
> +    {
> 
> +      Return(0x00)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDX))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXDX)
> 
> +    }
> 
> +    Return(NDDS(DIDX))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query List of Brightness Control Levels Supported.
> 
> +  //
> 
> +  Method(_BCL,0)
> 
> +  {
> 
> +    //
> 
> +    // List of supported brightness levels in the following sequence.
> 
> +    // Level when machine has full power.
> 
> +    // Level when machine is on batteries.
> 
> +    // Other supported levels.
> 
> +    //
> 
> +    If(CondRefOf(\PBCL)) {
> 
> +      Return (PBCL())
> 
> +    } Else {
> 
> +      Return(Package(){80, 50, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16,
> 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38,
> 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60,
> 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82,
> 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100})
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Set the Brightness Level.
> 
> +  //
> 
> +  Method (_BCM,1)
> 
> +  {
> 
> +    //
> 
> +    // Set the requested level if it is between 0 and 100%.
> 
> +    //
> 
> +    If(LAnd(LGreaterEqual(Arg0,0),LLessEqual(Arg0,100)))
> 
> +    {
> 
> +      \_SB.PC00.GFX0.AINT(1, Arg0)
> 
> +      Store(Arg0,BRTL)  // Store Brightness Level.
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Brightness Query Current level.
> 
> +  //
> 
> +  Method (_BQC,0)
> 
> +  {
> 
> +    Return(BRTL)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Physical Location of Device
> 
> +  //
> 
> +  Method (_PLD,0)
> 
> +  {
> 
> +    If(CondRefOf(\PLD1)) {
> 
> +      Return (PLD1())
> 
> +    } Else {
> 
> +      Return (DPLD)
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +// Second Display
> 
> +//
> 
> +Device(DD2F)
> 
> +{
> 
> +  //
> 
> +  // Return Unique ID.
> 
> +  //
> 
> +  Method(_ADR,0,Serialized)
> 
> +  {
> 
> +    If(LEqual(EDPV, 0x0))
> 
> +    {
> 
> +      Return(0x1F)
> 
> +    }
> 
> +    If(LEqual(EDPV, 0x1))
> 
> +    {
> 
> +      Return(0x1F)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(And(0xFFFF,DIDY))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return the Current Status.
> 
> +  //
> 
> +  Method(_DCS,0)
> 
> +  {
> 
> +    If(LEqual(EDPV, 0x0))
> 
> +    {
> 
> +      Return(0x00)
> 
> +    }
> 
> +    If(LEqual(EDPV, 0x1))
> 
> +    {
> 
> +      Return(0x0)
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Return(CDDS(DIDY))
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query Graphics State (active or inactive).
> 
> +  //
> 
> +  Method(_DGS,0)
> 
> +  {
> 
> +    If(LAnd(LEqual(And(HGMD,0x7F),0x01),CondRefOf(SNXD)))
> 
> +    {
> 
> +      Return (NXDY)
> 
> +    }
> 
> +    Return(NDDS(DIDY))
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Device Set State.
> 
> +  //
> 
> +  Method(_DSS,1)
> 
> +  {
> 
> +    DSST(Arg0)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Query List of Brightness Control Levels Supported.
> 
> +  //
> 
> +  Method(_BCL,0)
> 
> +  {
> 
> +    //
> 
> +    // List of supported brightness levels in the following sequence.
> 
> +    // Level when machine has full power.
> 
> +    // Level when machine is on batteries.
> 
> +    // Other supported levels.
> 
> +    //
> 
> +    If(CondRefOf(\PBCL)) {
> 
> +      Return (PBCL())
> 
> +    } Else {
> 
> +      Return(Package(){80, 50, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16,
> 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38,
> 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60,
> 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82,
> 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100})
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Set the Brightness Level.
> 
> +  //
> 
> +  Method (_BCM,1)
> 
> +  {
> 
> +    //
> 
> +    // Set the requested level if it is between 0 and 100%.
> 
> +    //
> 
> +    If(LAnd(LGreaterEqual(Arg0,0),LLessEqual(Arg0,100)))
> 
> +    {
> 
> +      \_SB.PC00.GFX0.AINT(1, Arg0)
> 
> +      Store(Arg0,BRTL)  // Store Brightness Level.
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Brightness Query Current level.
> 
> +  //
> 
> +  Method (_BQC,0)
> 
> +  {
> 
> +    Return(BRTL)
> 
> +  }
> 
> +
> 
> +  Method (_PLD,0)
> 
> +  {
> 
> +    If(CondRefOf(\PLD2)) {
> 
> +      Return (PLD2())
> 
> +    } Else {
> 
> +      Return (DPLD)
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +Method(SDDL,1)
> 
> +{
> 
> +  Increment(NDID)
> 
> +  Store(And(Arg0,0xF0F),Local0)
> 
> +  Or(0x80000000,Local0, Local1)
> 
> +  If(LEqual(DIDL,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL2,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL3,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL4,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL5,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL6,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL7,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL8,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DDL9,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD10,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD11,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD12,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD13,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD14,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  If(LEqual(DD15,Local0))
> 
> +  {
> 
> +    Return(Local1)
> 
> +  }
> 
> +  Return(0)
> 
> +}
> 
> +
> 
> +Method(CDDS,1)
> 
> +{
> 
> +  Store(And(Arg0,0xF0F),Local0)
> 
> +
> 
> +  If(LEqual(0, Local0))
> 
> +  {
> 
> +    Return(0x1D)
> 
> +  }
> 
> +  If(LEqual(CADL, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL2, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL3, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL4, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL5, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL6, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL7, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  If(LEqual(CAL8, Local0))
> 
> +  {
> 
> +    Return(0x1F)
> 
> +  }
> 
> +  Return(0x1D)
> 
> +}
> 
> +
> 
> +Method(NDDS,1)
> 
> +{
> 
> +  Store(And(Arg0,0xF0F),Local0)
> 
> +
> 
> +  If(LEqual(0, Local0))
> 
> +  {
> 
> +    Return(0)
> 
> +  }
> 
> +  If(LEqual(NADL, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL2, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL3, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL4, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL5, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL6, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL7, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  If(LEqual(NDL8, Local0))
> 
> +  {
> 
> +    Return(1)
> 
> +  }
> 
> +  Return(0)
> 
> +}
> 
> +
> 
> +//
> 
> +// Device Set State Table
> 
> +//  BIT31  BIT30  Execution
> 
> +//  0  0  Don't implement.
> 
> +//  0  1  Cache change.  Nothing to Implement.
> 
> +//  1  0  Don't Implement.
> 
> +//  1  1  Display Switch Complete.  Implement.
> 
> +//
> 
> +Method(DSST,1)
> 
> +{
> 
> +  If(LEqual(And(Arg0,0xC0000000),0xC0000000))
> 
> +  {
> 
> +    //
> 
> +    // State change was performed by the
> 
> +    // Video Drivers.  Simply update the
> 
> +    // New State.
> 
> +    //
> 
> +    Store(NSTE,CSTE)
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +// Include IGD OpRegion/Software SCI interrupt handler/DSM which is used
> by
> 
> +// the graphics drivers to request data from system BIOS.
> 
> +//
> 
> +include ("IgfxOpRn.asl")
> 
> +include ("IgfxDsm.asl")
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommo
> n.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommo
> n.asl
> new file mode 100644
> index 0000000000..7325b9fdea
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxCommo
> n.asl
> @@ -0,0 +1,480 @@
> +/** @file
> 
> +  IGD OpRegion/Software SCI Reference Code.
> 
> +  This file contains ASL code with the purpose of handling events
> 
> +  i.e. hotkeys and other system interrupts.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +//
> 
> +// Notes:
> 
> +// 1. The following routines are to be called from the appropriate event
> 
> +//    handlers.
> 
> +// 2. This code cannot comprehend the exact implementation in the OEM's
> BIOS.
> 
> +//    Therefore, an OEM must call these methods from the existing event
> 
> +//    handler infrastructure.  Details on when/why to call each method is
> 
> +//    included in the method header under the "usage" section.
> 
> +//
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;* ACPI Notification Methods
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        PDRD
> 
> +;*
> 
> +;* Description: Check if the graphics driver is ready to process
> 
> +;*              notifications and video extensions.
> 
> +;*
> 
> +;* Usage:       This method is to be called prior to performing any
> 
> +;*              notifications or handling video extensions.
> 
> +;*              Ex: If (PDRD()) {Return (FAIL)}
> 
> +;*
> 
> +;* Input:       None
> 
> +;*
> 
> +;* Output:      None
> 
> +;*
> 
> +;* References:  DRDY (Driver ready status), ASLP (Driver recommended
> 
> +;*              sleep timeout value).
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +External(HNOT, MethodObj)
> 
> +
> 
> +Method(PDRD)
> 
> +{
> 
> +  //
> 
> +  // If DRDY is clear, the driver is not ready.  If the return value is
> 
> +  // !=0, do not perform any notifications or video extension handling.
> 
> +  //
> 
> +  Return(LNot(DRDY))
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        PSTS
> 
> +;*
> 
> +;* Description: Check if the graphics driver has completed the previous
> 
> +;*              "notify" command.
> 
> +;*
> 
> +;* Usage:       This method is called before every "notify" command.  A
> 
> +;*              "notify" should only be set if the driver has completed the
> 
> +;*              previous command.  Else, ignore the event and exit the parent
> 
> +;*              method.
> 
> +;*              Ex: If (PSTS()) {Return (FAIL)}
> 
> +;*
> 
> +;* Input:       None
> 
> +;*
> 
> +;* Output:      None
> 
> +;*
> 
> +;* References:  CSTS (Notification status), ASLP (Driver recommended sleep
> 
> +;*              timeout value).
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(PSTS)
> 
> +{
> 
> +  If(LGreater(CSTS, 2))
> 
> +  {
> 
> +    //
> 
> +    // Sleep for ASLP milliseconds if the status is not "success,
> 
> +    // failure, or pending"
> 
> +    //
> 
> +    Sleep(ASLP)
> 
> +  }
> 
> +
> 
> +  Return(LEqual(CSTS, 3)) // Return True if still Dispatched
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:  GNOT
> 
> +;*
> 
> +;* Description: Call the appropriate methods to query the graphics driver
> 
> +;*              status.  If all methods return success, do a notification of
> 
> +;*              the graphics device.
> 
> +;*
> 
> +;* Usage:       This method is to be called when a graphics device
> 
> +;*              notification is required (display switch hotkey, etc).
> 
> +;*
> 
> +;* Input:       Arg0 = Current event type:
> 
> +;*                1 = display switch
> 
> +;*                2 = lid
> 
> +;*                3 = dock
> 
> +;*              Arg1 = Notification type:
> 
> +;*                0 = Re-enumeration
> 
> +;*                0x80 = Display switch
> 
> +;*
> 
> +;* Output:      Returns 0 = success, 1 = failure
> 
> +;*
> 
> +;* References:  PDRD and PSTS methods.  OSYS (OS version)
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(GNOT, 2)
> 
> +{
> 
> +  //
> 
> +  // Check for 1. Driver loaded, 2. Driver ready.
> 
> +  // If any of these cases is not met, skip this event and return failure.
> 
> +  //
> 
> +  If(PDRD())
> 
> +  {
> 
> +    Return(0x1) // Return failure if driver not loaded.
> 
> +  }
> 
> +
> 
> +  Store(Arg0, CEVT) // Set up the current event value
> 
> +  Store(3, CSTS) // CSTS=BIOS dispatched an event
> 
> +
> 
> +  If(LAnd(LEqual(CHPD, 0), LEqual(Arg1, 0))) // Do not re-enum if driver
> supports hotplug
> 
> +  {
> 
> +    //
> 
> +    // Re-enumerate the Graphics Device for non-XP operating systems.
> 
> +    //
> 
> +    Notify(\_SB.PC00.GFX0, Arg1)
> 
> +  }
> 
> +
> 
> +  If(CondRefOf(HNOT))
> 
> +  {
> 
> +    HNOT(Arg0)  //Notification handler for Hybrid graphics
> 
> +  }
> 
> +  Else
> 
> +  {
> 
> +    Notify(\_SB.PC00.GFX0,0x80)
> 
> +  }
> 
> +
> 
> +  Return(0x0) // Return success
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        GHDS
> 
> +;*
> 
> +;* Description: Handle a hotkey display switching event (performs a
> 
> +;*              Notify(GFX0, 0).
> 
> +;*
> 
> +;* Usage:       This method must be called when a hotkey event occurs and
> the
> 
> +;*              purpose of that hotkey is to do a display switch.
> 
> +;*
> 
> +;* Input:       Arg0 = Toggle table number.
> 
> +;*
> 
> +;* Output:      Returns 0 = success, 1 = failure.
> 
> +;*              CEVT and TIDX are indirect outputs.
> 
> +;*
> 
> +;* References:  TIDX, GNOT
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(GHDS, 1)
> 
> +{
> 
> +  Store(Arg0, TIDX) // Store the table number
> 
> +  //
> 
> +  // Call GNOT for CEVT = 1 = hotkey, notify value = 0
> 
> +  //
> 
> +  Return(GNOT(1, 0)) // Return stats from GNOT
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        GLID
> 
> +;*
> 
> +;* Description: Handle a lid event (performs the Notify(GFX0, 0), but not the
> 
> +;*              lid notify).
> 
> +;*
> 
> +;* Usage:       This method must be called when a lid event occurs.  A
> 
> +;*              Notify(LID0, 0x80) must follow the call to this method.
> 
> +;*
> 
> +;* Input:       Arg0 = Lid state:
> 
> +;*                0 = All closed
> 
> +;*                1 = internal LFP lid open
> 
> +;*                2 = external lid open
> 
> +;*                3 = both external and internal open
> 
> +;*
> 
> +;* Output:      Returns 0=success, 1=failure.
> 
> +;*              CLID and CEVT are indirect outputs.
> 
> +;*
> 
> +;* References:  CLID, GNOT
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(GLID, 1)
> 
> +{
> 
> +
> 
> +  If (LEqual(Arg0,1))
> 
> +  {
> 
> +    Store(3,CLID)
> 
> +  }
> 
> +  Else
> 
> +  {
> 
> +    Store(Arg0, CLID)
> 
> +  }
> 
> +  //
> 
> +  //Store(Arg0, CLID) // Store the current lid state
> 
> +  // Call GNOT for CEVT=2=Lid, notify value = 0
> 
> +  //
> 
> +  if (GNOT(2, 0)) {
> 
> +    Or (CLID, 0x80000000, CLID)
> 
> +    Return (1) // Return Fail
> 
> +  }
> 
> +
> 
> +  Return (0) // Return Pass
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:  GDCK
> 
> +;*
> 
> +;* Description: Handle a docking event by updating the current docking
> status
> 
> +;*              and doing a notification.
> 
> +;*
> 
> +;* Usage:       This method must be called when a docking event occurs.
> 
> +;*
> 
> +;* Input:       Arg0 = Docking state:
> 
> +;*                0 = Undocked
> 
> +;*                1 = Docked
> 
> +;*
> 
> +;* Output:      Returns 0=success, 1=failure.
> 
> +;*              CDCK and CEVT are indirect outputs.
> 
> +;*
> 
> +;* References:  CDCK, GNOT
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(GDCK, 1)
> 
> +{
> 
> +  Store(Arg0, CDCK) // Store the current dock state
> 
> +  //
> 
> +  // Call GNOT for CEVT=4=Dock, notify value = 0
> 
> +  //
> 
> +  Return(GNOT(4, 0)) // Return stats from GNOT
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;* ASLE Interrupt Methods
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        PARD
> 
> +;*
> 
> +;* Description: Check if the driver is ready to handle ASLE interrupts
> 
> +;*              generate by the system BIOS.
> 
> +;*
> 
> +;* Usage:       This method must be called before generating each ASLE
> 
> +;*              interrupt.
> 
> +;*
> 
> +;* Input:       None
> 
> +;*
> 
> +;* Output:      Returns 0 = success, 1 = failure.
> 
> +;*
> 
> +;* References:  ARDY (Driver readiness), ASLP (Driver recommended sleep
> 
> +;*              timeout value)
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(PARD)
> 
> +{
> 
> +  If(LNot(ARDY))
> 
> +  {
> 
> +    //
> 
> +    // Sleep for ASLP milliseconds if the driver is not ready.
> 
> +    //
> 
> +    Sleep(ASLP)
> 
> +  }
> 
> +  //
> 
> +  // If ARDY is clear, the driver is not ready.  If the return value is
> 
> +  // !=0, do not generate the ASLE interrupt.
> 
> +  //
> 
> +  Return(LNot(ARDY))
> 
> +}
> 
> +
> 
> +//
> 
> +// Intel Ultrabook Event Handler.  Arg0 represents the Ultrabook Event Bit #
> to pass
> 
> +// to the Intel Graphics Driver.  Note that this is a serialized method,
> meaning
> 
> +// sumultaneous events are not allowed.
> 
> +//
> 
> +Method(IUEH,1,Serialized)
> 
> +{
> 
> +  And(IUER,0xC0,IUER) // Clear all button events on entry.
> 
> +  XOr(IUER,Shiftleft(1,Arg0),IUER) // Toggle status.
> 
> +
> 
> +  If(LLessEqual(Arg0,4)) // Button Event?
> 
> +  {
> 
> +    Return(AINT(5,0)) // Generate event and return status.
> 
> +
> 
> +  }
> 
> +  Else // Indicator Event.
> 
> +  {
> 
> +    Return(AINT(Arg0,0)) // Generate event and return status.
> 
> +  }
> 
> +}
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name:        AINT
> 
> +;*
> 
> +;* Description: Call the appropriate methods to generate an ASLE interrupt.
> 
> +;*              This process includes ensuring the graphics driver is ready
> 
> +;*              to process the interrupt, ensuring the driver supports the
> 
> +;*              interrupt of interest, and passing information about the event
> 
> +;*              to the graphics driver.
> 
> +;*
> 
> +;* Usage:       This method must called to generate an ASLE interrupt.
> 
> +;*
> 
> +;* Input:       Arg0 = ASLE command function code:
> 
> +;*                0 = Set ALS illuminance
> 
> +;*                1 = Set backlight brightness
> 
> +;*                2 = Do Panel Fitting
> 
> +;*                4 = Reserved
> 
> +;*                5 = Button Indicator Event
> 
> +;*                6 = Convertible Indicator Event
> 
> +;*                7 = Docking Indicator Event
> 
> +;*              Arg1 = If Arg0 = 0, current ALS reading:
> 
> +;*                0 = Reading below sensor range
> 
> +;*                1-0xFFFE = Current sensor reading
> 
> +;*                0xFFFF = Reading above sensor range
> 
> +;*              Arg1 = If Arg0 = 1, requested backlight percentage
> 
> +;*
> 
> +;* Output:      Returns 0 = success, 1 = failure
> 
> +;*
> 
> +;* References:  PARD method.
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method(AINT, 2)
> 
> +{
> 
> +  //
> 
> +  // Return failure if the requested feature is not supported by the
> 
> +  // driver.
> 
> +  //
> 
> +  If(LNot(And(TCHE, ShiftLeft(1, Arg0))))
> 
> +  {
> 
> +    Return(0x1)
> 
> +  }
> 
> +  //
> 
> +  // Return failure if the driver is not ready to handle an ASLE
> 
> +  // interrupt.
> 
> +  //
> 
> +  If(PARD())
> 
> +  {
> 
> +    Return(0x1)
> 
> +  }
> 
> +  //
> 
> +  // Handle Intel Ultrabook Events.
> 
> +  //
> 
> +  If(LAnd(LGreaterEqual(Arg0,5),LLessEqual(Arg0,7)))
> 
> +  {
> 
> +    Store(ShiftLeft(1,Arg0), ASLC) // Set Ultrbook Event [6:4].
> 
> +    Store(0x01, ASLE) // Generate ASLE interrupt
> 
> +
> 
> +    Store(0,Local2) // Use Local2 as a timeout counter.  Intialize to zero.
> 
> +
> 
> +    While(LAnd(LLess(Local2,250),LNotEqual(ASLC,0))) // Wait 1 second or
> until Driver ACKs a success.
> 
> +    {
> 
> +      Sleep(4) // Delay 4 ms.
> 
> +      Increment(Local2) // Increment Timeout.
> 
> +    }
> 
> +
> 
> +    Return(0) // Return success
> 
> +  }
> 
> +  //
> 
> +  // Evaluate the first argument (Panel fitting, backlight brightness, or ALS).
> 
> +  //
> 
> +  If(LEqual(Arg0, 2))         // Arg0 = 2, so request a panel fitting mode change.
> 
> +  {
> 
> +    If(CPFM)                  // If current mode field is non-zero use it.
> 
> +    {
> 
> +      And(CPFM, 0x0F, Local0) // Create variables without reserved
> 
> +      And(EPFM, 0x0F, Local1) // or valid bits.
> 
> +
> 
> +      If(LEqual(Local0, 1))   // If current mode is centered,
> 
> +      {
> 
> +        If(And(Local1, 6))    // and if stretched is enabled,
> 
> +        {
> 
> +          Store(6, PFIT)      // request stretched.
> 
> +        }
> 
> +        Else                  // Otherwise,
> 
> +        {
> 
> +          If(And(Local1, 8))  // if aspect ratio is enabled,
> 
> +          {
> 
> +            Store(8, PFIT)    // request aspect ratio.
> 
> +          }
> 
> +          Else                // Only centered mode is enabled
> 
> +          {
> 
> +            Store(1, PFIT)    // so request centered. (No change.)
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +      If(LEqual(Local0, 6))   // If current mode is stretched,
> 
> +      {
> 
> +        If(And(Local1, 8))    // and if aspect ratio is enabled,
> 
> +        {
> 
> +          Store(8, PFIT)      // request aspect ratio.
> 
> +        }
> 
> +        Else                  // Otherwise,
> 
> +        {
> 
> +          If(And(Local1, 1))  // if centered is enabled,
> 
> +          {
> 
> +            Store(1, PFIT)    // request centered.
> 
> +          }
> 
> +          Else                // Only stretched mode is enabled
> 
> +          {
> 
> +            Store(6, PFIT)    // so request stretched. (No change.)
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +      If(LEqual(Local0, 8))   // If current mode is aspect ratio,
> 
> +      {
> 
> +        If(And(Local1, 1))    // and if centered is enabled,
> 
> +        {
> 
> +          Store(1, PFIT)      // request centered.
> 
> +        }
> 
> +        Else                  // Otherwise,
> 
> +        {
> 
> +          If(And(Local1, 6))  // if stretched is enabled,
> 
> +          {
> 
> +            Store(6, PFIT)    // request stretched.
> 
> +          }
> 
> +          Else                // Only aspect ratio mode is enabled
> 
> +          {
> 
> +            Store(8, PFIT)    // so request aspect ratio. (No change.)
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +    //
> 
> +    // The following code for panel fitting (within the Else condition) is
> retained for backward compatiblity.
> 
> +    //
> 
> +    Else                      // If CFPM field is zero use PFIT and toggle the
> 
> +    {
> 
> +      Xor(PFIT,7,PFIT)        // mode setting between stretched and centered
> only.
> 
> +    }
> 
> +    Or(PFIT,0x80000000,PFIT)  // Set the valid bit for all cases.
> 
> +    Store(4, ASLC)            // Store "Panel fitting event" to ASLC[31:1]
> 
> +  }
> 
> +  Else
> 
> +  {
> 
> +    If(LEqual(Arg0, 1)) // Arg0=1, so set the backlight brightness.
> 
> +    {
> 
> +      Store(Divide(Multiply(Arg1, 255), 100), BCLP) // Convert from percent to
> 0-255.
> 
> +      Or(BCLP, 0x80000000, BCLP) // Set the valid bit.
> 
> +      Store(2, ASLC) // Store "Backlight control event" to ASLC[31:1]
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      If(LEqual(Arg0, 0)) // Arg0=0, so set the ALS illuminace
> 
> +      {
> 
> +        Store(Arg1, ALSI)
> 
> +        Store(1, ASLC) // Store "ALS event" to ASLC[31:1]
> 
> +      }
> 
> +      Else
> 
> +      {
> 
> +        Return(0x1) // Unsupported function
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Store(0x01, ASLE) // Generate ASLE interrupt
> 
> +  Return(0x0) // Return success
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
> new file mode 100644
> index 0000000000..ecd87e8c1f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxDsm.asl
> @@ -0,0 +1,398 @@
> +/** @file
> 
> +  IGD OpRegion/_DSM Reference Code.
> 
> +  This file contains Get BIOS Data and Callback functions for
> 
> +  the Integrated Graphics Device (IGD) OpRegion/DSM mechanism
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +External(\_SB.PC00.IMMC, MethodObj)
> 
> +External(\_SB.PC00.IMMD, MethodObj)
> 
> +
> 
> +//
> 
> +// _DSM Device Specific Method
> 
> +//
> 
> +// Arg0: UUID Unique function identifier
> 
> +// Arg1: Integer Revision Level
> 
> +// Arg2: Integer Function Index (1 = Return Supported Functions)
> 
> +// Arg3: Additional Inputs/Package Parameters Bits [31:0] input as {Byte0,
> Byte1, Byte2, Byte3} to BIOS which is passed as 32 bit DWORD by Driver
> 
> +//
> 
> +Method (_DSM, 4, Serialized, 0, UnknownObj, {BuffObj, IntObj, IntObj,
> PkgObj}) {
> 
> +
> 
> +  If (LEqual(Arg0, ToUUID ("3E5B41C6-EB1D-4260-9D15-C71FBADAE414"))) {
> 
> +    //
> 
> +    // _DSM Definition for Igd functions
> 
> +    // Arguments:
> 
> +    // Arg0: UUID: 3E5B41C6-EB1D-4260-9D15-C71FBADAE414
> 
> +    // Arg1: Revision ID: 1
> 
> +    // Arg2: Function Index: 16
> 
> +    // Arg3: Additional Inputs Bits[31:0] Arg3 {Byte0, Byte1, Byte2, Byte3}
> 
> +    //
> 
> +    // Return:
> 
> +    // Success for simple notification, Opregion update for some routines and
> a Package for AKSV
> 
> +    //
> 
> +    If (Lor(LEqual(Arg2,18),LEqual(Arg2,19))) {
> 
> +      CreateDwordField(Arg3, 0x0, DDIN)
> 
> +      CreateDwordField(Arg3, 0x4, BUF1)
> 
> +      //
> 
> +      // OPTS is return buffer from IOM mailbox -
> 
> +      // Byte[0] is Status field.
> 
> +      // BYTE[1] is HDP Count.
> 
> +      //
> 
> +      Name(OPTS, Buffer(4){0,0,0,0})
> 
> +      CreateByteField(OPTS, 0x00, CMST) // Command Status field
> 
> +                                        //         Success - 0
> 
> +                                        //         Fail    - 1
> 
> +      CreateByteField(OPTS, 0x01, RTB1) // Return Buffer 1
> 
> +
> 
> +      //
> 
> +      // Gfx Empty Dongle Buffer is data for return DSM fun#
> 
> +      // with below buffer format
> 
> +      // Byte[0-3] is Data field.
> 
> +      // Byte[4] is Status field.
> 
> +      //
> 
> +      Name(GEDB, Buffer(5){0,0,0,0,0})
> 
> +      CreateDwordField(GEDB, 0x00, GEDF) // Gfx Empty Dongle Data Field
> 
> +      CreateByteField(GEDB, 0x04, GESF)  // Gfx Empty Dongle Status Field
> 
> +                                         //         Success - 0
> 
> +                                         //         Fail    - None 0
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Switch by function index
> 
> +    //
> 
> +    Switch(ToInteger(Arg2)) {
> 
> +      //
> 
> +      // Function Index: 0
> 
> +      // Standard query - A bitmask of functions supported
> 
> +      //
> 
> +      // Return: A bitmask of functions supported
> 
> +      //
> 
> +      Case (0)
> 
> +      {
> 
> +        If (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +          Store("iGfx Supported Functions Bitmap ", Debug)
> 
> +
> 
> +          Return(0xDE7FF)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 1
> 
> +      // Adapter Power State Notification
> 
> +      // Arg3 Bits [7:0]: Adapter Power State bits [7:0] from Driver 00h = D0;
> 01h = D1; 02h = D2; 04h = D3 (Cold/Hot); 08h = D4 (Hibernate Notification)
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(1) {
> 
> +        If (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +          Store(" Adapter Power State Notification ", Debug)
> 
> +
> 
> +          //
> 
> +          // Handle Low Power S0 Idle Capability if enabled
> 
> +          //
> 
> +          If(LAnd(LEqual(S0ID, 1),LLess(OSYS, 2015))) {
> 
> +            //
> 
> +            // Call GUAM to trigger CS Entry
> 
> +            //   If Adapter Power State Notification = D1 (Arg3[0]=0x01)
> 
> +            //
> 
> +            If (LEqual (And(DerefOf (Index (Arg3,0)), 0xFF), 0x01)) {
> 
> +              // GUAM - Global User Absent Mode Notification Method
> 
> +              \GUAM(One) // 0x01 - Power State Standby (CS Entry)
> 
> +            }
> 
> +            Store(And(DerefOf (Index (Arg3,1)), 0xFF), Local0)
> 
> +            //
> 
> +            // Call GUAM
> 
> +            // If Display Turn ON Notification (Arg3 [1] == 0) for CS Exit
> 
> +            //
> 
> +            If (LEqual (Local0, 0)) {
> 
> +              // GUAM - Global User Absent Mode Notification Method
> 
> +              \GUAM(0)
> 
> +            }
> 
> +          }
> 
> +
> 
> +          // Upon notification from driver that the Adapter Power State = D0,
> 
> +          // check if previous lid event failed.  If it did, retry the lid
> 
> +          // event here.
> 
> +          If(LEqual(DerefOf (Index (Arg3,0)), 0)) {
> 
> +            Store(CLID, Local0)
> 
> +            If(And(0x80000000,Local0)) {
> 
> +              And(CLID, 0x0000000F, CLID)
> 
> +              GLID(CLID)
> 
> +            }
> 
> +          }
> 
> +          Return(0x01)
> 
> +        }
> 
> +      }
> 
> +      //
> 
> +      // Function Index: 2
> 
> +      // Display Power State Notification
> 
> +      // Arg3: Display Power State Bits [15:8]
> 
> +      // 00h = On
> 
> +      // 01h = Standby
> 
> +      // 02h = Suspend
> 
> +      // 04h = Off
> 
> +      // 08h = Reduced On
> 
> +      // Return: Success
> 
> +      //
> 
> +     Case(2) {
> 
> +        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +
> 
> +          Store("Display Power State Notification ", Debug)
> 
> +          Return(0x01)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 3
> 
> +      // BIOS POST Completion Notification
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(3) {
> 
> +        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +          Store("BIOS POST Completion Notification ", Debug)
> 
> +          Return(0x01)      // Not supported, but no failure
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 4
> 
> +      // Pre-Hires Set Mode
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(4) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("Pre-Hires Set Mode ", Debug)
> 
> +          Return(0x01)      // Not supported, but no failure
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 5
> 
> +      // Post-Hires Set Mode
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(5) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("Post-Hires Set Mode ", Debug)
> 
> +          Return(0x01)      // Not supported, but no failure
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 6
> 
> +      // SetDisplayDeviceNotification (Display Switch)
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(6) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("SetDisplayDeviceNotification", Debug)
> 
> +          Return(0x01)      // Not supported, but no failure
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 7
> 
> +      // SetBootDevicePreference
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(7) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          //<TODO> An OEM may elect to implement this method.  In that case,
> 
> +          // the input values must be saved into non-volatile storage for
> 
> +          // parsing during the next boot.  The following Sample code is Intel
> 
> +          // validated implementation.
> 
> +
> 
> +          Store("SetBootDevicePreference ", Debug)
> 
> +          And(DerefOf (Index (Arg3,0)), 0xFF, IBTT) // Save the boot display to
> NVS
> 
> +          Return(0x01)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 8
> 
> +      // SetPanelPreference
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(8) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          // An OEM may elect to implement this method.  In that case,
> 
> +          // the input values must be saved into non-volatile storage for
> 
> +          // parsing during the next boot.  The following Sample code is Intel
> 
> +          // validated implementation.
> 
> +
> 
> +          Store("SetPanelPreference ", Debug)
> 
> +
> 
> +          // Set the panel-related NVRAM variables based the input from the
> driver.
> 
> +          And(DerefOf (Index (Arg3,0)), 0xFF, IPSC)
> 
> +
> 
> +          // Change panel type if a change is requested by the driver (Change if
> 
> +          // panel type input is non-zero).  Zero=No change requested.
> 
> +          If(And(DerefOf (Index (Arg3,1)), 0xFF)) {
> 
> +            And(DerefOf (Index (Arg3,1)), 0xFF, IPAT)
> 
> +            Decrement(IPAT)    // 0 = no change, so fit to CMOS map
> 
> +          }
> 
> +          And(ShiftRight(DerefOf (Index (Arg3,2)), 4), 0x7, IBIA)
> 
> +          Return(0x01)         // Success
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 9
> 
> +      // FullScreenDOS
> 
> +      // Return: Success
> 
> +      //
> 
> +      Case(9) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("FullScreenDOS ", Debug)
> 
> +          Return(0x01)      // Not supported, but no failure
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 10
> 
> +      // APM Complete
> 
> +      // Return: Adjusted Lid State
> 
> +      //
> 
> +     Case(10) {
> 
> +        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +
> 
> +          Store("APM Complete ", Debug)
> 
> +          Store(ShiftLeft(LIDS, 8), Local0) // Report the lid state
> 
> +          Add(Local0, 0x100, Local0)        // Adjust the lid state, 0 = Unknown
> 
> +          Return(Local0)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      //
> 
> +      // Function Index: 13
> 
> +      // GetBootDisplayPreference
> 
> +      // Arg3 Bits [30:16] : Boot Device Ports
> 
> +      // Arg3 Bits [7:0] : Boot Device Type
> 
> +      // Return: Boot device port and Boot device type from saved
> configuration
> 
> +      //
> 
> +     Case(13) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +
> 
> +          Store("GetBootDisplayPreference ", Debug)
> 
> +          Or(ShiftLeft(DerefOf (Index (Arg3,3)), 24), ShiftLeft(DerefOf (Index
> (Arg3,2)), 16), Local0) // Combine Arg3 Bits [31:16]
> 
> +          And(Local0, 0xEFFF0000, Local0)
> 
> +          And(Local0, ShiftLeft(DeRefOf(Index(DBTB, IBTT)), 16), Local0)
> 
> +          Or(IBTT, Local0, Local0) // Arg3 Bits [7:0] = Boot device type
> 
> +          Return(Local0)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 14
> 
> +      // GetPanelDetails
> 
> +      // Return: Different Panel Settings
> 
> +      //
> 
> +      Case(14) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("GetPanelDetails ", Debug)
> 
> +
> 
> +          // Report the scaling setting
> 
> +          // Bits [7:0] - Panel Scaling
> 
> +          // Bits contain the panel scaling user setting from CMOS
> 
> +          // 00h = On: Auto
> 
> +          // 01h = On: Force Scaling
> 
> +          // 02h = Off
> 
> +          // 03h = Maintain Aspect Ratio
> 
> +
> 
> +          Store(IPSC, Local0)
> 
> +          Or(Local0, ShiftLeft(IPAT, 8), Local0)
> 
> +
> 
> +          // Adjust panel type, 0 = VBT default
> 
> +          // Bits [15:8] - Panel Type
> 
> +          // Bits contain the panel type user setting from CMOS
> 
> +          // 00h = Not Valid, use default Panel Type & Timings from VBT
> 
> +          // 01h - 0Fh = Panel Number
> 
> +
> 
> +          Add(Local0, 0x100, Local0)
> 
> +
> 
> +          // Report the lid state and Adjust it
> 
> +          // Bits [16] - Lid State
> 
> +          // Bits contain the current panel lid state
> 
> +          // 0 = Lid Open
> 
> +          // 1 = Lid Closed
> 
> +
> 
> +          Or(Local0, ShiftLeft(LIDS, 16), Local0)
> 
> +          Add(Local0, 0x10000, Local0)
> 
> +
> 
> +         // Report the BIA setting
> 
> +         // Bits [22:20] - Backlight Image Adaptation (BIA) Control
> 
> +         // Bits contain the backlight image adaptation control user setting from
> CMOS
> 
> +         // 000 = VBT Default
> 
> +         // 001 = BIA Disabled (BLC may still be enabled)
> 
> +         // 010 - 110 = BIA Enabled at Aggressiveness Level [1 - 5]
> 
> +
> 
> +          Or(Local0, ShiftLeft(IBIA, 20), Local0)
> 
> +          Return(Local0)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 15
> 
> +      // GetInternalGraphics
> 
> +      // Return: Different Internal Grahics Settings
> 
> +      //
> 
> +
> 
> +      Case(15) {
> 
> +        if (LEqual(Arg1, 1)){ // test Arg1 for Revision ID: 1
> 
> +          Store("GetInternalGraphics ", Debug)
> 
> +
> 
> +          Store(GIVD, Local0)                    // Local0[0]      - VGA mode(1=VGA)
> 
> +          Xor(Local0, 1, Local0)                 // Invert the VGA mode polarity
> 
> +
> 
> +          Or(Local0, ShiftLeft(GMFN, 1), Local0) // Local0[1]      - # IGD PCI
> functions-1
> 
> +                                                 // Local0[3:2]    - Reserved
> 
> +                                                 // Local0[4]      - IGD D3 support(0=cold)
> 
> +                                                 // Local0[10:5]   - Reserved
> 
> +          Or(Local0, ShiftLeft(3, 11), Local0)   // Local0[12:11]  - DVMT version
> (11b = 5.0)
> 
> +
> 
> +          //
> 
> +          // Report DVMT 5.0 Total Graphics memory size.
> 
> +          //
> 
> +          Or(Local0, ShiftLeft(IDMS, 17), Local0) // Bits 20:17 are for Gfx total
> memory size
> 
> +
> 
> +          // If the "Set Internal Graphics" call is supported, the modified
> 
> +          // settings flag must be programmed per the specification.  This means
> 
> +          // that the flag must be set to indicate that system BIOS requests
> 
> +          // these settings.  Once "Set Internal Graphics" is called, the
> 
> +          //  modified settings flag must be cleared on all subsequent calls to
> 
> +          // this function.
> 
> +
> 
> +          // Report the graphics frequency based on B0:D2:F0:RF0h[12].  Must
> 
> +          // take into account the current VCO.
> 
> +
> 
> +          Or(ShiftLeft(DeRefOf(Index(DeRefOf(Index(CDCT, HVCO)), CDVL)),
> 21),Local0, Local0)
> 
> +          Return(Local0)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //
> 
> +      // Function Index: 16
> 
> +      // GetAKSV
> 
> +      // Retrun: 5 bytes of AKSV
> 
> +      //
> 
> +      Case(16) {
> 
> +        if (LEqual(Arg1, 1)) { // test Arg1 for Revision ID: 1
> 
> +
> 
> +          Store("GetAKSV ", Debug)
> 
> +          Name (KSVP, Package()
> 
> +          {
> 
> +             0x80000000,
> 
> +             0x8000
> 
> +          })
> 
> +          Store(KSV0, Index(KSVP,0)) // First four bytes of AKSV
> 
> +          Store(KSV1, Index(KSVP,1)) // Fifth byte of AKSV
> 
> +          Return(KSVP) // Success
> 
> +        }
> 
> +      }
> 
> +    } // End of switch(Arg2)
> 
> +  } // End of if (ToUUID("3E5B41C6-EB1D-4260-9D15-C71FBADAE414D"))
> 
> +
> 
> +  Return (Buffer () {0x00})
> 
> +} // End of _DSM
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda.
> asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda
> .asl
> new file mode 100644
> index 0000000000..2b5f2393b0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpGbda
> .asl
> @@ -0,0 +1,127 @@
> +/** @file
> 
> +  IGD OpRegion/Software SCI Reference Code.
> 
> +  This file contains Get BIOS Data Area funciton support for
> 
> +  the Integrated Graphics Device (IGD) OpRegion/Software SCI mechanism
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +Method (GBDA, 0, Serialized)
> 
> +{
> 
> +  //
> 
> +  // Supported calls: Sub-function 0
> 
> +  //
> 
> +  If (LEqual(GESF, 0))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> Reference code is set to Intel's validated implementation.
> 
> +    //
> 
> +    Store(0x0000659, PARM)
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Return(SUCC) // Success
> 
> +  }
> 
> +  //
> 
> +  // Requested callbacks: Sub-function 1
> 
> +  //
> 
> +  If (LEqual(GESF, 1))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> Call back functions are where the driver calls the
> 
> +    // system BIOS at function indicated event.
> 
> +    //
> 
> +    Store(0x300482, PARM)
> 
> +    If(LEqual(S0ID, One)){
> 
> +      Or(PARM, 0x100, PARM) //Request Fn 8 callback in CS systems
> 
> +    }
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Return(SUCC) // Success
> 
> +  }
> 
> +  //
> 
> +  // Get Boot display Preferences: Sub-function 4
> 
> +  //
> 
> +  If (LEqual(GESF, 4))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> Get Boot Display Preferences function.
> 
> +    //
> 
> +    And(PARM, 0xEFFF0000, PARM) // PARM[30:16] = Boot device ports
> 
> +    And(PARM, ShiftLeft(DeRefOf(Index(DBTB, IBTT)), 16), PARM)
> 
> +    Or(IBTT, PARM, PARM) // PARM[7:0] = Boot device type
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Return(SUCC) // Success
> 
> +  }
> 
> +  //
> 
> +  // Panel details: Sub-function 5
> 
> +  //
> 
> +  If (LEqual(GESF, 5))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> Get Panel Details function.
> 
> +    //
> 
> +    Store(IPSC, PARM) // Report the scaling setting
> 
> +    Or(PARM, ShiftLeft(IPAT, 8), PARM)
> 
> +    Add(PARM, 0x100, PARM) // Adjust panel type, 0 = VBT default
> 
> +    Or(PARM, ShiftLeft(LIDS, 16), PARM) // Report the lid state
> 
> +    Add(PARM, 0x10000, PARM) // Adjust the lid state, 0 = Unknown
> 
> +    Or(PARM, ShiftLeft(IBIA, 20), PARM) // Report the BIA setting
> 
> +    Store(Zero, GESF)
> 
> +    Return(SUCC)
> 
> +  }
> 
> +  //
> 
> +  // Internal graphics: Sub-function 7
> 
> +  //
> 
> +  If (LEqual(GESF, 7))
> 
> +  {
> 
> +    Store(GIVD, PARM) // PARM[0]      - VGA mode(1=VGA)
> 
> +    Xor(PARM, 1, PARM) // Invert the VGA mode polarity
> 
> +    Or(PARM, ShiftLeft(GMFN, 1), PARM) // PARM[1]   - # IGD PCI functions-1
> 
> +                                       // PARM[3:2]    - Reserved
> 
> +                                       // PARM[4]      - IGD D3 support(0=cold)
> 
> +                                       // PARM[10:5]   - Reserved
> 
> +    Or(PARM, ShiftLeft(3, 11), PARM) // PARM[12:11] - DVMT mode(11b =
> 5.0)
> 
> +
> 
> +    //
> 
> +    // Report DVMT 5.0 Total Graphics memory size.
> 
> +    //
> 
> +    Or(PARM, ShiftLeft(IDMS, 17), PARM) // Bits 20:17 are for Gfx total
> memory size
> 
> +    //
> 
> +    // If the "Set Internal Graphics" call is supported, the modified
> 
> +    // settings flag must be programmed per the specification.  This means
> 
> +    // that the flag must be set to indicate that system BIOS requests
> 
> +    // these settings.  Once "Set Internal Graphics" is called, the
> 
> +    //  modified settings flag must be cleared on all subsequent calls to
> 
> +    // this function.
> 
> +    // Report the graphics frequency based on B0:D2:F0:RF0h[12].  Must
> 
> +    // take into account the current VCO.
> 
> +    //
> 
> +    Or(ShiftLeft(Derefof(Index(Derefof(Index(CDCT, HVCO)), CDVL)),
> 21),PARM, PARM)
> 
> +    Store(1, GESF) // Set the modified settings flag
> 
> +    Return(SUCC)
> 
> +  }
> 
> +  //
> 
> +  // Spread spectrum clocks: Sub-function 10
> 
> +  //
> 
> +  If (LEqual(GESF, 10))
> 
> +  {
> 
> +    Store(0, PARM) // Assume SSC is disabled
> 
> +    If(ISSC)
> 
> +    {
> 
> +      Or(PARM, 3, PARM) // If SSC enabled, return SSC1+Enabled
> 
> +    }
> 
> +    Store(0, GESF) // Set the modified settings flag
> 
> +    Return(SUCC) // Success
> 
> +  }
> 
> +
> 
> +  If (LEqual(GESF, 11))
> 
> +  {
> 
> +    Store(KSV0, PARM) // First four bytes of AKSV
> 
> +    Store(KSV1, GESF) // Fifth byte of AKSV
> 
> +
> 
> +    Return(SUCC) // Success
> 
> +  }
> 
> +  //
> 
> +  // A call to a reserved "Get BIOS data" function was received.
> 
> +  //
> 
> +  Store(Zero, GESF) // Clear the exit parameter
> 
> +  Return(CRIT) // Reserved, "Critical failure"
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
> new file mode 100644
> index 0000000000..410524b324
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpRn.asl
> @@ -0,0 +1,314 @@
> +/** @file
> 
> +  IGD OpRegion/Software SCI Reference Code.
> 
> +  This file contains the interrupt handler code for the Integrated
> 
> +  Graphics Device (IGD) OpRegion/Software SCI mechanism.
> 
> +  It defines OperationRegions to cover the IGD PCI configuration space
> 
> +  as described in the IGD OpRegion specification.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +//
> 
> +//NOTES:
> 
> +//
> 
> +// (1) The code contained in this file inherits the scope in which it
> 
> +//     was included.  So BIOS developers must be sure to include this
> 
> +//     file in the scope associated with the graphics device
> 
> +//     (ex. \_SB.PC00.GFX0).
> 
> +// (2) Create a _L06 method under the GPE scope to handle the event
> 
> +//     generated by the graphics driver.  The _L06 method must call
> 
> +//     the GSCI method in this file.
> 
> +// (3) The MCHP operation region assumes that _ADR and _BBN names
> 
> +//     corresponding to bus 0, device0, function 0 have been declared
> 
> +//     under the PC00 scope.
> 
> +// (4) Before the first execution of the GSCI method, the base address
> 
> +//     of the GMCH SCI OpRegion must be programmed where the driver can
> 
> +//     access it. A 32bit scratch register at 0xFC in the IGD PCI
> 
> +//     configuration space (B0/D2/F0/R0FCh) is used for this purpose.
> 
> +
> 
> +//  Define an OperationRegion to cover the GMCH PCI configuration space
> as
> 
> +//  described in the IGD OpRegion specificiation.
> 
> +//
> 
> +Scope(\_SB.PC00)
> 
> +{
> 
> +  OperationRegion(MCHP, PCI_Config, 0x40, 0xC0)
> 
> +  Field(MCHP, AnyAcc, NoLock, Preserve)
> 
> +  {
> 
> +    Offset(0x14),
> 
> +    AUDE, 8,
> 
> +
> 
> +    Offset(0x60), // Top of Memory register
> 
> +    TASM, 10,     // Total system memory (64MB gran)
> 
> +        , 6,
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +//  Define an OperationRegion to cover the IGD PCI configuration space as
> 
> +//  described in the IGD OpRegion specificiation.
> 
> +//
> 
> +OperationRegion(IGDP, PCI_Config, 0x40, 0xC0)
> 
> +Field(IGDP, AnyAcc, NoLock, Preserve)
> 
> +{
> 
> +  Offset(0x10), // Mirror of gfx control reg
> 
> +      , 1,
> 
> +  GIVD, 1,      // IGD VGA disable bit
> 
> +      , 2,
> 
> +  GUMA, 3,      // Stolen memory size
> 
> +      , 9,
> 
> +  Offset(0x14),
> 
> +      , 4,
> 
> +  GMFN, 1,      // Gfx function 1 enable
> 
> +      , 27,
> 
> +  Offset(0xA4),
> 
> +  ASLE, 8,      // Reg 0xE4, ASLE interrupt register
> 
> +      , 24,     // Only use first byte of ASLE reg
> 
> +  Offset(0xA8), // Reg 0xE8, SWSCI control register
> 
> +  GSSE, 1,      // Graphics SCI event (1=event pending)
> 
> +  GSSB, 14,     // Graphics SCI scratchpad bits
> 
> +  GSES, 1,      // Graphics event select (1=SCI)
> 
> +  Offset(0xB0), // Gfx Clk Frequency and Gating Control
> 
> +      , 12,
> 
> +  CDVL, 1,      // Core display clock value
> 
> +      , 3,      // Graphics Core Display Clock Select
> 
> +  Offset(0xB5),
> 
> +  LBPC, 8,      // Legacy brightness control
> 
> +  Offset(0xBC),
> 
> +  ASLS, 32,     // Reg 0xFC, Address of the IGD OpRegion
> 
> +}
> 
> +
> 
> +//
> 
> +//  Define an OperationRegion to cover the IGD OpRegion layout.
> 
> +//
> 
> +OperationRegion(IGDM, SystemMemory, ASLB, 0x2000)
> 
> +Field(IGDM, AnyAcc, NoLock, Preserve)
> 
> +{
> 
> +  //
> 
> +  // OpRegion Header
> 
> +  //
> 
> +  SIGN, 128,     // Signature-"IntelGraphicsMem"
> 
> +  SIZE, 32,      // OpRegion Size
> 
> +  OVER, 32,      // OpRegion Version
> 
> +  SVER, 256,     // System BIOS Version
> 
> +  VVER, 128,     // VBIOS Version
> 
> +  GVER, 128,     // Driver version
> 
> +  MBOX, 32,      // Mailboxes supported
> 
> +  DMOD, 32,      // Driver Model
> 
> +  PCON, 32,      // Platform Configuration
> 
> +  DVER, 64,      // GOP Version
> 
> +  //
> 
> +  // OpRegion Mailbox 1 (Public ACPI Methods)
> 
> +  // Note: Mailbox 1 is normally reserved for desktop platforms.
> 
> +  //
> 
> +  Offset(0x100),
> 
> +  DRDY, 32,      // Driver readiness (ACPI notification)
> 
> +  CSTS, 32,      // Notification status
> 
> +  CEVT, 32,      // Current event
> 
> +  Offset(0x120),
> 
> +  DIDL, 32,      // Supported display device ID list
> 
> +  DDL2, 32,      // Allows for 8 devices
> 
> +  DDL3, 32,
> 
> +  DDL4, 32,
> 
> +  DDL5, 32,
> 
> +  DDL6, 32,
> 
> +  DDL7, 32,
> 
> +  DDL8, 32,
> 
> +  CPDL, 32,      // Currently present display list
> 
> +  CPL2, 32,      // Allows for 8 devices
> 
> +  CPL3, 32,
> 
> +  CPL4, 32,
> 
> +  CPL5, 32,
> 
> +  CPL6, 32,
> 
> +  CPL7, 32,
> 
> +  CPL8, 32,
> 
> +  CADL, 32,      // Currently active display list
> 
> +  CAL2, 32,      // Allows for 8 devices
> 
> +  CAL3, 32,
> 
> +  CAL4, 32,
> 
> +  CAL5, 32,
> 
> +  CAL6, 32,
> 
> +  CAL7, 32,
> 
> +  CAL8, 32,
> 
> +  NADL, 32,      // Next active display list
> 
> +  NDL2, 32,      // Allows for 8 devices
> 
> +  NDL3, 32,
> 
> +  NDL4, 32,
> 
> +  NDL5, 32,
> 
> +  NDL6, 32,
> 
> +  NDL7, 32,
> 
> +  NDL8, 32,
> 
> +  ASLP, 32,      // ASL sleep timeout
> 
> +  TIDX, 32,      // Toggle table index
> 
> +  CHPD, 32,      // Current hot plug enable indicator
> 
> +  CLID, 32,      // Current lid state indicator
> 
> +  CDCK, 32,      // Current docking state indicator
> 
> +  SXSW, 32,      // Display switch notify on resume
> 
> +  EVTS, 32,      // Events supported by ASL (diag only)
> 
> +  CNOT, 32,      // Current OS notifications (diag only)
> 
> +  NRDY, 32,
> 
> +  //
> 
> +  //Extended DIDL list
> 
> +  //
> 
> +  DDL9, 32,
> 
> +  DD10, 32,
> 
> +  DD11, 32,
> 
> +  DD12, 32,
> 
> +  DD13, 32,
> 
> +  DD14, 32,
> 
> +  DD15, 32,
> 
> +  //
> 
> +  //Extended Currently attached Display Device List  CPD2
> 
> +  //
> 
> +  CPL9, 32,
> 
> +  CP10, 32,
> 
> +  CP11, 32,
> 
> +  CP12, 32,
> 
> +  CP13, 32,
> 
> +  CP14, 32,
> 
> +  CP15, 32,
> 
> +  //
> 
> +  // OpRegion Mailbox 2 (Software SCI Interface)
> 
> +  //
> 
> +  Offset(0x200), // SCIC
> 
> +  SCIE, 1,       // SCI entry bit (1=call unserviced)
> 
> +  GEFC, 4,       // Entry function code
> 
> +  GXFC, 3,       // Exit result
> 
> +  GESF, 8,       // Entry/exit sub-function/parameter
> 
> +      , 16,      // SCIC[31:16] reserved
> 
> +  Offset(0x204), // PARM
> 
> +  PARM, 32,      // PARM register (extra parameters)
> 
> +  DSLP,  32,     // Driver sleep time out
> 
> +  //
> 
> +  // OpRegion Mailbox 3 (BIOS to Driver Notification)
> 
> +  // Note: Mailbox 3 is normally reserved for desktop platforms.
> 
> +  //
> 
> +  Offset(0x300),
> 
> +  ARDY, 32,      // Driver readiness (power conservation)
> 
> +  ASLC, 32,      // ASLE interrupt command/status
> 
> +  TCHE, 32,      // Technology enabled indicator
> 
> +  ALSI, 32,      // Current ALS illuminance reading
> 
> +  BCLP, 32,      // Backlight brightness
> 
> +  PFIT, 32,      // Panel fitting state or request
> 
> +  CBLV, 32,      // Current brightness level
> 
> +  BCLM, 320,     // Backlight brightness level duty cycle mapping table
> 
> +  CPFM, 32,      // Current panel fitting mode
> 
> +  EPFM, 32,      // Enabled panel fitting modes
> 
> +  PLUT, 592,     // Optional. 74-byte Panel LUT Table
> 
> +  PFMB, 32,      // Optional. PWM Frequency and Minimum Brightness
> 
> +  CCDV, 32,      // Optional. Gamma, Brightness, Contrast values.
> 
> +  PCFT, 32,      // Optional. Power Conservation Features
> 
> +  SROT, 32,      // Supported rotation angle.
> 
> +  IUER, 32,      // Optional. Intel Ultrabook Event Register.
> 
> +  FDSS, 64,      // Optional. FFS Display Physical address
> 
> +  FDSP, 32,      // Optional. FFS Display Size
> 
> +  STAT, 32,      // State Indicator
> 
> +  RVDA, 64,      // Physical address of Raw VBT data
> 
> +  RVDS, 32,      // Size of Raw VBT data
> 
> +  //
> 
> +  // OpRegion Mailbox 4 (VBT)
> 
> +  //
> 
> +  Offset(0x400),
> 
> +  RVBT, 0xC000,  // 6K bytes maximum VBT image
> 
> +  //
> 
> +  // OpRegion Mailbox 5 (BIOS to Driver Notification Extension)
> 
> +  //
> 
> +  Offset(0x1C00),
> 
> +  PHED, 32,      // Panel Header
> 
> +  BDDC, 2048,    // Panel EDID (Max 256 bytes)
> 
> +
> 
> +}
> 
> +
> 
> +//
> 
> +// Convert boot display type into a port mask.
> 
> +//
> 
> +Name (DBTB, Package()
> 
> +{
> 
> +  0x0000,        // Automatic
> 
> +  0x0007,        // Port-0 : Integrated CRT
> 
> +  0x0038,        // Port-1 : DVO-A, or Integrated LVDS
> 
> +  0x01C0,        // Port-2 : SDVO-B, or SDVO-B/C
> 
> +  0x0E00,        // Port-3 : SDVO-C
> 
> +  0x003F,        // [CRT + DVO-A / Integrated LVDS]
> 
> +  0x01C7,        // [CRT + SDVO-B] or [CRT + SDVO-B/C]
> 
> +  0x0E07,        // [CRT + SDVO-C]
> 
> +  0x01F8,        // [DVO-A / Integrated LVDS + SDVO-B]
> 
> +  0x0E38,        // [DVO-A / Integrated LVDS + SDVO-C]
> 
> +  0x0FC0,        // [SDVO-B + SDVO-C]
> 
> +  0x0000,        // Reserved
> 
> +  0x0000,        // Reserved
> 
> +  0x0000,        // Reserved
> 
> +  0x0000,        // Reserved
> 
> +  0x0000,        // Reserved
> 
> +  0x7000,        // Port-4: Integrated TV
> 
> +  0x7007,        // [Integrated TV + CRT]
> 
> +  0x7038,        // [Integrated TV + LVDS]
> 
> +  0x71C0,        // [Integrated TV + DVOB]
> 
> +  0x7E00         // [Integrated TV + DVOC]
> 
> +})
> 
> +
> 
> +//
> 
> +// Core display clock value table.
> 
> +//
> 
> +Name (CDCT, Package()
> 
> +{
> 
> +  Package() {228, 320},
> 
> +  Package() {222, 333},
> 
> +  Package() {222, 333},
> 
> +  Package() {  0,   0},
> 
> +  Package() {222, 333},
> 
> +})
> 
> +
> 
> +//
> 
> +// Defined exit result values:
> 
> +//
> 
> +Name (SUCC, 1)   // Exit result: Success
> 
> +Name (NVLD, 2)   // Exit result: Invalid parameter
> 
> +Name (CRIT, 4)   // Exit result: Critical failure
> 
> +Name (NCRT, 6)   // Exit result: Non-critical failure
> 
> +
> 
> +/*********************************************************
> ***************;
> 
> +;*
> 
> +;* Name: GSCI
> 
> +;*
> 
> +;* Description: Handles an SCI generated by the graphics driver.  The
> 
> +;*              PARM and SCIC input fields are parsed to determine the
> 
> +;*              functionality requested by the driver.  GBDA or SBCB
> 
> +;*              is called based on the input data in SCIC.
> 
> +;*
> 
> +;* Usage:       The method must be called in response to a GPE 06 event
> 
> +;*              which will be generated by the graphics driver.
> 
> +;*              Ex: Method(\_GPE._L06) {Return(\_SB.PC00.GFX0.GSCI())}
> 
> +;*
> 
> +;* Input:       PARM and SCIC are indirect inputs
> 
> +;*
> 
> +;* Output:      PARM and SIC are indirect outputs
> 
> +;*
> 
> +;* References:  GBDA (Get BIOS Data method), SBCB (System BIOS Callback
> 
> +;*              method)
> 
> +;*
> 
> +;*********************************************************
> ***************/
> 
> +
> 
> +Method (GSCI, 0, Serialized)
> 
> +{
> 
> +  Include("IgfxOpGbda.asl")  // "Get BIOS Data" Functions
> 
> +  Include("IgfxOpSbcb.asl")  // "System BIOS CallBacks"
> 
> +
> 
> +  If (LEqual(GEFC, 4))
> 
> +  {
> 
> +    Store(GBDA(), GXFC)    // Process Get BIOS Data functions
> 
> +  }
> 
> +
> 
> +  If (LEqual(GEFC, 6))
> 
> +  {
> 
> +    Store(SBCB(), GXFC)    // Process BIOS Callback functions
> 
> +  }
> 
> +
> 
> +  Store(0, GEFC)           // Wipe out the entry function code
> 
> +  Store(1, CPSC)           // Clear CPUSCI_STS to clear the PCH TCO SCI status
> 
> +  Store(0, GSSE)           // Clear the SCI generation bit in PCI space.
> 
> +  Store(0, SCIE)           // Clr SCI serviced bit to signal completion
> 
> +
> 
> +  Return(Zero)
> 
> +}
> 
> +
> 
> +Include("IgfxCommon.asl")    // IGD SCI mobile features
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.
> asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.
> asl
> new file mode 100644
> index 0000000000..3c5d4d9862
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxOpSbcb.
> asl
> @@ -0,0 +1,261 @@
> +/** @file
> 
> +  This file contains the system BIOS call back functionality for the
> 
> +  OpRegion/Software SCI mechanism.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +Method (SBCB, 0, Serialized)
> 
> +{
> 
> +  //
> 
> +  // Supported Callbacks: Sub-function 0
> 
> +  //
> 
> +  If (LEqual(GESF, 0x0))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> An OEM may support the driver->SBIOS status callbacks, but
> 
> +    // the supported callbacks value must be modified.  The code that is
> 
> +    // executed upon reception of the callbacks must be also be updated
> 
> +    // to perform the desired functionality.
> 
> +    //
> 
> +    Store(0x00000000, PARM)   // No callbacks supported
> 
> +    //Store(0x000787FD, PARM) // Used for Intel test implementaion
> 
> +    Store(0x000F87DD, PARM)
> 
> +    Store(Zero, GESF)         // Clear the exit parameter
> 
> +    Return(SUCC)              // "Success"
> 
> +  }
> 
> +  //
> 
> +  // BIOS POST Completion: Sub-function 1
> 
> +  //
> 
> +  If (LEqual(GESF, 1))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Pre-Hires Set Mode: Sub-function 3
> 
> +  //
> 
> +  If (LEqual(GESF, 3))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Post-Hires Set Mode: Sub-function 4
> 
> +  //
> 
> +  If (LEqual(GESF, 4))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Display Switch: Sub-function 5
> 
> +  //
> 
> +  If (LEqual(GESF, 5))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Adapter Power State: Sub-function 7
> 
> +  //
> 
> +  If (LEqual(GESF, 7))
> 
> +  {
> 
> +    //
> 
> +    // Handle Low Power S0 Idle Capability if enabled
> 
> +    //
> 
> +    If(LAnd(LEqual(S0ID, 1),LLess(OSYS, 2015))) {
> 
> +      //
> 
> +      // Call GUAM to trigger CS Entry
> 
> +      //   If Adapter Power State Notification = D1 (PARM[7:0]=0x01)
> 
> +      //
> 
> +      If (LEqual (And(PARM,0xFF), 0x01)) {
> 
> +        // GUAM - Global User Absent Mode Notification Method
> 
> +        \GUAM(One) // 0x01 - Power State Standby (CS Entry)
> 
> +      }
> 
> +      If (LEqual (And(PARM,0xFF), 0x00)) {
> 
> +        // GUAM - Global User Absent Mode Notification Method
> 
> +        \GUAM(0)
> 
> +      }
> 
> +    }
> 
> +    //
> 
> +    // Upon notification from driver that the Adapter Power State = D0,
> 
> +    // check if previous lid event failed.  If it did, retry the lid
> 
> +    // event here.
> 
> +    //
> 
> +    If(LEqual(PARM, 0))
> 
> +    {
> 
> +      Store(CLID, Local0)
> 
> +      If(And(0x80000000,Local0))
> 
> +      {
> 
> +        And(CLID, 0x0000000F, CLID)
> 
> +        GLID(CLID)
> 
> +      }
> 
> +    }
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Display Power State: Sub-function 8
> 
> +  //
> 
> +  If (LEqual(GESF, 8))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Set Boot Display: Sub-function 9
> 
> +  //
> 
> +  If (LEqual(GESF, 9))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> An OEM may elect to implement this method.  In that case,
> 
> +    // the input values must be saved into non-volatile storage for
> 
> +    // parsing during the next boot.  The following Sample code is Intel
> 
> +    // validated implementation.
> 
> +    //
> 
> +    And(PARM, 0xFF, IBTT) // Save the boot display to NVS
> 
> +    Store(Zero, GESF)     // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)          // Reserved, "Critical failure"
> 
> +  }
> 
> +  //
> 
> +  // Set Panel Details: Sub-function 10 (0Ah)
> 
> +  //
> 
> +  If (LEqual(GESF, 10))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> An OEM may elect to implement this method.  In that case,
> 
> +    // the input values must be saved into non-volatile storage for
> 
> +    // parsing during the next boot.  The following Sample code is Intel
> 
> +    // validated implementation.
> 
> +    // Set the panel-related NVRAM variables based the input from the
> driver.
> 
> +    //
> 
> +    And(PARM, 0xFF, IPSC)
> 
> +    //
> 
> +    // Change panel type if a change is requested by the driver (Change if
> 
> +    // panel type input is non-zero).  Zero=No change requested.
> 
> +    //
> 
> +    If(And(ShiftRight(PARM, 8), 0xFF))
> 
> +    {
> 
> +      And(ShiftRight(PARM, 8), 0xFF, IPAT)
> 
> +      Decrement(IPAT)    // 0 = no change, so fit to CMOS map
> 
> +    }
> 
> +    And(ShiftRight(PARM, 20), 0x7, IBIA)
> 
> +    Store(Zero, GESF)    // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)         // Success
> 
> +  }
> 
> +  //
> 
> +  // Set Internal Graphics: Sub-function 11 (0Bh)
> 
> +  //
> 
> +  If (LEqual(GESF, 11))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> An OEM may elect to implement this method.  In that case,
> 
> +    // the input values must be saved into non-volatile storage for
> 
> +    // parsing during the next boot.  The following Sample code is Intel
> 
> +    // validated implementation.
> 
> +    //
> 
> +    And(ShiftRight(PARM, 1), 1, IF1E)      // Program the function 1 option
> 
> +    If(And(PARM, ShiftLeft(0xF, 13)))      // Use fixed memory if fixed size != 0
> 
> +    {
> 
> +      //
> 
> +      // Fixed memory
> 
> +      //
> 
> +      And(ShiftRight(PARM, 13), 0xF, IDMS) // Program fixed memory size
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      //
> 
> +      // DVMT memory
> 
> +      //
> 
> +      And(ShiftRight(PARM, 17), 0xF, IDMS) // Program fixed memory size
> 
> +    }
> 
> +    Store(Zero, GESF)                      // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)                           // Success
> 
> +  }
> 
> +  //
> 
> +  // Post-Hires to DOS FS: Sub-function 16 (10h)
> 
> +  //
> 
> +  If (LEqual(GESF, 16))
> 
> +  {
> 
> +    Store(Zero, GESF) // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)      // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // APM Complete:  Sub-function 17 (11h)
> 
> +  //
> 
> +  If (LEqual(GESF, 17))
> 
> +  {
> 
> +    Store(ShiftLeft(LIDS, 8), PARM) // Report the lid state
> 
> +    Add(PARM, 0x100, PARM)          // Adjust the lid state, 0 = Unknown
> 
> +    Store(Zero, GESF)               // Clear the exit parameter
> 
> +    Return(SUCC)                    // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Set Spread Spectrum Clocks: Sub-function 18 (12h)
> 
> +  //
> 
> +  If (LEqual(GESF, 18))
> 
> +  {
> 
> +    //
> 
> +    //<NOTE> An OEM may elect to implement this method.  In that case,
> 
> +    // the input values must be saved into non-volatile storage for
> 
> +    // parsing during the next boot.  The following Sample code is Intel
> 
> +    // validated implementation.
> 
> +    //
> 
> +    If(And(PARM, 1))
> 
> +    {
> 
> +      If(LEqual(ShiftRight(PARM, 1), 1))
> 
> +      {
> 
> +        Store(1, ISSC)  // Enable HW SSC, only for clock 1
> 
> +      }
> 
> +      Else
> 
> +      {
> 
> +        Store(Zero, GESF)
> 
> +        Return(CRIT)    // Failure, as the SSC clock must be 1
> 
> +      }
> 
> +    }
> 
> +    Else
> 
> +    {
> 
> +      Store(0, ISSC)    // Disable SSC
> 
> +    }
> 
> +    Store(Zero, GESF)   // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)        // Success
> 
> +  }
> 
> +  //
> 
> +  // Post VBE/PM Callback: Sub-function 19 (13h)
> 
> +  //
> 
> +  If (LEqual(GESF, 19))
> 
> +  {
> 
> +    Store(Zero, GESF)  // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)       // Not supported, but no failure
> 
> +  }
> 
> +  //
> 
> +  // Set PAVP Data: Sub-function 20 (14h)
> 
> +  //
> 
> +  If (LEqual(GESF, 20))
> 
> +  {
> 
> +    And(PARM, 0xF, PAVP) // Store PAVP info
> 
> +    Store(Zero, GESF)    // Clear the exit parameter
> 
> +    Store(Zero, PARM)
> 
> +    Return(SUCC)         // Success
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // A call to a reserved "System BIOS callbacks" function was received
> 
> +  //
> 
> +  Store(Zero, GESF) // Clear the exit parameter
> 
> +  Return(SUCC)      // Reserved, "Critical failure"
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
> new file mode 100644
> index 0000000000..99130a853d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.asl
> @@ -0,0 +1,73 @@
> +/** @file
> 
> +  This file contains the Intel Graphics SSDT Table ASL code.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +DefinitionBlock (
> 
> +  "IgfxSsdt.aml",
> 
> +  "SSDT",
> 
> +  2,
> 
> +  "INTEL ",
> 
> +  "IgfxSsdt",
> 
> +  0x3000
> 
> +  )
> 
> +{
> 
> +  External(\_SB.PC00, DeviceObj)
> 
> +  External(\_SB.PC00.GFX0, DeviceObj)
> 
> +  External(\NDID)
> 
> +  External(\DID1)
> 
> +  External(\DID2)
> 
> +  External(\DID3)
> 
> +  External(\DID4)
> 
> +  External(\DID5)
> 
> +  External(\DID6)
> 
> +  External(\DID7)
> 
> +  External(\DID8)
> 
> +  External(\DID9)
> 
> +  External(\DIDA)
> 
> +  External(\DIDB)
> 
> +  External(\DIDC)
> 
> +  External(\DIDD)
> 
> +  External(\DIDE)
> 
> +  External(\DIDF)
> 
> +  External(\DIDX)
> 
> +  External(\DIDY)
> 
> +
> 
> +  External(\NXD1)
> 
> +  External(\NXD2)
> 
> +  External(\NXD3)
> 
> +  External(\NXD4)
> 
> +  External(\NXD5)
> 
> +  External(\NXD6)
> 
> +  External(\NXD7)
> 
> +  External(\NXD8)
> 
> +  External(\NXDY)
> 
> +
> 
> +  External(\IPTP)
> 
> +  External(\EDPV)
> 
> +  External(\NXDX)
> 
> +  External(\HGMD)
> 
> +  External(\LIDS)
> 
> +  External(\BRTL)
> 
> +  External(\NSTE)
> 
> +  External(\CSTE)
> 
> +  External(\ASLB)
> 
> +  External(\IBTT)
> 
> +  External(\IPSC)
> 
> +  External(\IPAT)
> 
> +  External(\IBIA)
> 
> +  External(\IDMS)
> 
> +  External(\HVCO)
> 
> +  External(\ISSC)
> 
> +  External(\KSV0)
> 
> +  External(\KSV1)
> 
> +  External(\IF1E)
> 
> +  External(\PAVP)
> 
> +
> 
> +  Scope (\_SB.PC00.GFX0)
> 
> +  {
> 
> +    include("Igfx.asl")
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
> new file mode 100644
> index 0000000000..be28157cef
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
> @@ -0,0 +1,23 @@
> +## @file
> 
> +#  Component description file for the Igfx ACPI tables
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION          = 0x00010005
> 
> +BASE_NAME            = IgfxSsdt
> 
> +FILE_GUID            = CE9CAA0E-8248-442C-9E57-50F212E2BAED
> 
> +MODULE_TYPE          = USER_DEFINED
> 
> +VERSION_STRING       = 1.0
> 
> +
> 
> +[Sources]
> 
> +  IgfxSsdt.asl
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[FixedPcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsInitLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsInitLib.h
> new file mode 100644
> index 0000000000..0e9f119763
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsInitLib.h
> @@ -0,0 +1,53 @@
> +/** @file
> 
> +  Header file for DXE Graphics Init Lib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_GRAPHICS_INIT_LIB_H_
> 
> +#define _DXE_GRAPHICS_INIT_LIB_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <IndustryStandard/Acpi.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Protocol/SaNvsArea.h>
> 
> +#include <Protocol/GopComponentName2.h>
> 
> +#include <SiConfigHob.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +/**
> 
> +  Initialize GT ACPI tables
> 
> +
> 
> +  @param[in] ImageHandle - Handle for the image of this driver
> 
> +  @param[in] SaPolicy    - SA DXE Policy protocol
> 
> +
> 
> +  @retval EFI_SUCCESS          - GT ACPI initialization complete
> 
> +  @retval EFI_NOT_FOUND        - Dxe System Table not found.
> 
> +  @retval EFI_OUT_OF_RESOURCES - Mmio not allocated successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +GraphicsInit (
> 
> +  IN EFI_HANDLE             ImageHandle,
> 
> +  IN SA_POLICY_PROTOCOL     *SaPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Do Post GT PM Init Steps after VBIOS Initialization.
> 
> +
> 
> +  @retval EFI_SUCCESS          Succeed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PostPmInitEndOfDxe (
> 
> +  VOID
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsPolicyLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsPolicyLib.h
> new file mode 100644
> index 0000000000..abb5dffc45
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeGraphicsPolicyLib.h
> @@ -0,0 +1,71 @@
> +/** @file
> 
> +  Header file for the DXE Graphics Policy Init library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_GRAPHICS_POLICY_LIB_H_
> 
> +#define _DXE_GRAPHICS_POLICY_LIB_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <GraphicsConfig.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +
> 
> +#define WORD_FIELD_VALID_BIT  BIT15
> 
> +
> 
> +extern EFI_GUID gGraphicsDxeConfigGuid;
> 
> +
> 
> +/**
> 
> +  This function prints the Graphics DXE phase policy.
> 
> +
> 
> +  @param[in] SaPolicy - SA DXE Policy protocol
> 
> +**/
> 
> +VOID
> 
> +GraphicsDxePolicyPrint (
> 
> +  IN  SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function Load default Graphics DXE policy.
> 
> +
> 
> +  @param[in] ConfigBlockPointer    The pointer to add Graphics config block
> 
> +**/
> 
> +VOID
> 
> +LoadIgdDxeDefault (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Get DXE Graphics config block table total size.
> 
> +
> 
> +  @retval     Size of DXE Graphics config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +GraphicsGetConfigBlockTotalSizeDxe (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  GraphicsAddConfigBlocksDxe add all DXE Graphics config block.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add SA config blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GraphicsAddConfigBlocksDxe (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +#endif // _DXE_GRAPHICs_POLICY_LIBRARY_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeIgdOpRegionInitLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeIgdOpRegionInitLib.h
> new file mode 100644
> index 0000000000..683893f940
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/IncludePrivate/Library/
> DxeIgdOpRegionInitLib.h
> @@ -0,0 +1,177 @@
> +/** @file
> 
> +  This is part of the implementation of an Intel Graphics drivers OpRegion /
> 
> +  Software SCI interface between system BIOS, ASL code, and Graphics
> drivers.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_IGD_OPREGION_INIT_LIB_H_
> 
> +#define _DXE_IGD_OPREGION_INIT_LIB_H_
> 
> +
> 
> +///
> 
> +/// Statements that include other header files.
> 
> +///
> 
> +#include <Uefi.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Register/IgdRegs.h>
> 
> +#include <SiConfigHob.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +///
> 
> +/// Driver Consumed Protocol Prototypes
> 
> +///
> 
> +#include <Protocol/PciIo.h>
> 
> +#include <Protocol/PciRootBridgeIo.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Protocol/SaNvsArea.h>
> 
> +///
> 
> +/// Driver Produced Protocol Prototypes
> 
> +///
> 
> +#include <Protocol/IgdOpRegion.h>
> 
> +
> 
> +#pragma pack(push, 1)
> 
> +///
> 
> +///
> 
> +/// OpRegion (Miscellaneous) defines.
> 
> +///
> 
> +/// OpRegion Header defines.
> 
> +///
> 
> +typedef UINT16  STRING_REF;
> 
> +#define HEADER_SIGNATURE            "IntelGraphicsMem"
> 
> +#define HEADER_SIZE                 0x2000
> 
> +#define HEADER_OPREGION_REV         0x00
> 
> +#define HEADER_MBOX_SUPPORT         (HD_MBOX5 + HD_MBOX4 +
> HD_MBOX3 + HD_MBOX2 + HD_MBOX1)
> 
> +#define HD_MBOX1                    BIT0
> 
> +#define HD_MBOX2                    BIT1
> 
> +#define HD_MBOX3                    BIT2
> 
> +#define HD_MBOX4                    BIT3
> 
> +#define HD_MBOX5                    BIT4
> 
> +#define SVER_SIZE                   32
> 
> +
> 
> +///
> 
> +/// OpRegion Mailbox 1 EQUates.
> 
> +///
> 
> +/// OpRegion Mailbox 3 EQUates.
> 
> +///
> 
> +#define ALS_ENABLE            BIT0
> 
> +#define BACKLIGHT_BRIGHTNESS  0xFF
> 
> +#define FIELD_VALID_BIT       BIT31
> 
> +#define PFIT_ENABLE           BIT2
> 
> +#define PFIT_OPRN_AUTO        0x00000000
> 
> +#define PFIT_OPRN_SCALING     0x00000007
> 
> +#define PFIT_OPRN_OFF         0x00000000
> 
> +#define PFIT_SETUP_AUTO       0
> 
> +#define PFIT_SETUP_SCALING    1
> 
> +#define PFIT_SETUP_OFF        2
> 
> +#define INIT_BRIGHT_LEVEL     0x64
> 
> +#define PFIT_STRETCH          6
> 
> +
> 
> +///
> 
> +/// Video BIOS / VBT defines
> 
> +///
> 
> +#define OPTION_ROM_SIGNATURE    0xAA55
> 
> +#define VBIOS_LOCATION_PRIMARY  0xC0000
> 
> +
> 
> +#define VBT_SIGNATURE           SIGNATURE_32 ('$', 'V', 'B', 'T')
> 
> +///
> 
> +/// Typedef stuctures
> 
> +///
> 
> +typedef struct {
> 
> +  UINT16  Signature;  /// 0xAA55
> 
> +  UINT8   Size512;
> 
> +  UINT8   Reserved[21];
> 
> +  UINT16  PcirOffset;
> 
> +  UINT16  VbtOffset;
> 
> +} INTEL_VBIOS_OPTION_ROM_HEADER;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32  Signature;  /// "PCIR"
> 
> +  UINT16  VendorId;   /// 0x8086
> 
> +  UINT16  DeviceId;
> 
> +  UINT16  Reserved0;
> 
> +  UINT16  Length;
> 
> +  UINT8   Revision;
> 
> +  UINT8   ClassCode[3];
> 
> +  UINT16  ImageLength;
> 
> +  UINT16  CodeRevision;
> 
> +  UINT8   CodeType;
> 
> +  UINT8   Indicator;
> 
> +  UINT16  Reserved1;
> 
> +} INTEL_VBIOS_PCIR_STRUCTURE;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8   HeaderSignature[20];
> 
> +  UINT16  HeaderVersion;
> 
> +  UINT16  HeaderSize;
> 
> +  UINT16  HeaderVbtSize;
> 
> +  UINT8   HeaderVbtCheckSum;
> 
> +  UINT8   HeaderReserved;
> 
> +  UINT32  HeaderOffsetVbtDataBlock;
> 
> +  UINT32  HeaderOffsetAim1;
> 
> +  UINT32  HeaderOffsetAim2;
> 
> +  UINT32  HeaderOffsetAim3;
> 
> +  UINT32  HeaderOffsetAim4;
> 
> +  UINT8   DataHeaderSignature[16];
> 
> +  UINT16  DataHeaderVersion;
> 
> +  UINT16  DataHeaderSize;
> 
> +  UINT16  DataHeaderDataBlockSize;
> 
> +  UINT8   CoreBlockId;
> 
> +  UINT16  CoreBlockSize;
> 
> +  UINT16  CoreBlockBiosSize;
> 
> +  UINT8   CoreBlockBiosType;
> 
> +  UINT8   CoreBlockReleaseStatus;
> 
> +  UINT8   CoreBlockHWSupported;
> 
> +  UINT8   CoreBlockIntegratedHW;
> 
> +  UINT8   CoreBlockBiosBuild[4];
> 
> +  UINT8   CoreBlockBiosSignOn[155];
> 
> +} VBIOS_VBT_STRUCTURE;
> 
> +#pragma pack(pop)
> 
> +///
> 
> +/// Driver Private Function definitions
> 
> +///
> 
> +
> 
> +/**
> 
> +  Graphics OpRegion / Software SCI driver installation function.
> 
> +
> 
> +  @retval EFI_SUCCESS     - The driver installed without error.
> 
> +  @retval EFI_ABORTED     - The driver encountered an error and could not
> complete
> 
> +                            installation of the ACPI tables.
> 
> +**/
> 
> +EFI_STATUS
> 
> +IgdOpRegionInit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Intel video BIOS VBT information (i.e. Pointer to VBT and VBT size).
> 
> +  The VBT (Video BIOS Table) is a block of customizable data that is built
> 
> +  within the video BIOS and edited by customers.
> 
> +
> 
> +  @retval EFI_SUCCESS            - Video BIOS VBT information returned.
> 
> +  @exception EFI_UNSUPPORTED     - Could not find VBT information
> (*VBiosVbtPtr = NULL).
> 
> +**/
> 
> +EFI_STATUS
> 
> +GetVBiosVbtEndOfDxe (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Update Graphics OpRegion after PCI enumeration.
> 
> +
> 
> +  @retval EFI_SUCCESS     - The function completed successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +UpdateIgdOpRegionEndOfDxe (
> 
> +  VOID
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.c
> new file mode 100644
> index 0000000000..8769f34021
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.c
> @@ -0,0 +1,135 @@
> +/** @file
> 
> +  DXE Library for Initializing SystemAgent Graphics ACPI table initialization.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DxeGraphicsInitLib.h>
> 
> +
> 
> +
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32  Low;
> 
> +    UINT32  High;
> 
> +  } Data32;
> 
> +  UINT64 Data;
> 
> +} UINT64_STRUCT;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT64_STRUCT
> mMchBarBase;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> GOP_COMPONENT_NAME2_PROTOCOL  *GopComponentName2Protocol =
> NULL;
> 
> +
> 
> +/**
> 
> +    Do Post GT PM Init Steps after VBIOS Initialization.
> 
> +
> 
> +  @retval EFI_SUCCESS          Succeed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PostPmInitEndOfDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  CHAR16                    *DriverVersion;
> 
> +  UINTN                     Index;
> 
> +  EFI_STATUS                Status;
> 
> +  GRAPHICS_DXE_CONFIG       *GraphicsDxeConfig;
> 
> +  SA_POLICY_PROTOCOL        *SaPolicy;
> 
> +
> 
> +  ///
> 
> +  /// Get the platform setup policy.
> 
> +  ///
> 
> +  DriverVersion = NULL;
> 
> +  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **)
> &SaPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gGopComponentName2ProtocolGuid,
> NULL, (VOID **)&GopComponentName2Protocol);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Status = GopComponentName2Protocol->GetDriverVersion (
> 
> +                                          GopComponentName2Protocol,
> 
> +                                          "en-US",
> 
> +                                          &DriverVersion
> 
> +                                          );
> 
> +    if (!EFI_ERROR (Status)) {
> 
> +      for (Index = 0; (DriverVersion[Index] != '\0'); Index++) {
> 
> +      }
> 
> +      Index = (Index+1)*2;
> 
> +      CopyMem (GraphicsDxeConfig->GopVersion, DriverVersion, Index);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Return final status
> 
> +  ///
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +Initialize GT ACPI tables
> 
> +
> 
> +  @param[in] ImageHandle -     Handle for the image of this driver
> 
> +  @param[in] SaPolicy -        SA DXE Policy protocol
> 
> +
> 
> +  @retval EFI_SUCCESS          - GT ACPI initialization complete
> 
> +  @retval EFI_NOT_FOUND        - Dxe System Table not found.
> 
> +  @retval EFI_OUT_OF_RESOURCES - Mmio not allocated successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +GraphicsInit (
> 
> +  IN EFI_HANDLE              ImageHandle,
> 
> +  IN SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                      Status;
> 
> +  GRAPHICS_DXE_CONFIG             *GraphicsDxeConfig;
> 
> +  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
> 
> +
> 
> +  Status                  = EFI_SUCCESS;
> 
> +  mMchBarBase.Data32.High = PciSegmentRead32
> (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0,
> R_SA_MCHBAR + 4));
> 
> +  mMchBarBase.Data32.Low  = PciSegmentRead32
> (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0,
> R_SA_MCHBAR));
> 
> +  mMchBarBase.Data       &= (UINT64) ~BIT0;
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  ///  Locate the SA Global NVS Protocol.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gSaNvsAreaProtocolGuid, NULL, (VOID **)
> &SaNvsAreaProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Update IGD SA Global NVS
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, " Update Igd SA Global NVS Area.\n"));
> 
> +
> 
> +  SaNvsAreaProtocol->Area->AlsEnable                    = GraphicsDxeConfig-
> >AlsEnable;
> 
> +  ///
> 
> +  /// Initialize IGD state by checking if IGD Device 2 Function 0 is enabled in
> the chipset
> 
> +  ///
> 
> +  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> SA_MC_BUS, 0, 0, R_SA_DEVEN)) & B_SA_DEVEN_D2EN_MASK) {
> 
> +    SaNvsAreaProtocol->Area->IgdState = 1;
> 
> +  } else {
> 
> +    SaNvsAreaProtocol->Area->IgdState = 0;
> 
> +  }
> 
> +
> 
> +  SaNvsAreaProtocol->Area->BrightnessPercentage         = 100;
> 
> +  SaNvsAreaProtocol->Area->IgdBootType                  = GraphicsDxeConfig-
> >IgdBootType;
> 
> +  SaNvsAreaProtocol->Area->IgdPanelType                 = GraphicsDxeConfig-
> >IgdPanelType;
> 
> +  SaNvsAreaProtocol->Area->IgdPanelScaling              = GraphicsDxeConfig-
> >IgdPanelScaling;
> 
> +  ///
> 
> +  /// Get SFF power mode platform data for the IGD driver.  Flip the bit
> (bitwise xor)
> 
> +  /// since Setup value is opposite of NVS and IGD OpRegion value.
> 
> +  ///
> 
> +  SaNvsAreaProtocol->Area->IgdDvmtMemSize               =
> GraphicsDxeConfig->IgdDvmtMemSize;
> 
> +  SaNvsAreaProtocol->Area->IgdFunc1Enable               = 0;
> 
> +  SaNvsAreaProtocol->Area->IgdHpllVco                   = MmioRead8
> (mMchBarBase.Data + 0xC0F) & 0x07;
> 
> +  SaNvsAreaProtocol->Area->IgdSciSmiMode                = 0;
> 
> +  SaNvsAreaProtocol->Area->GfxTurboIMON                 = GraphicsDxeConfig-
> >GfxTurboIMON;
> 
> +  SaNvsAreaProtocol->Area->EdpValid                     = 0;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.inf
> new file mode 100644
> index 0000000000..78c115eb3c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsInitLib/DxeGraphicsInitLib.inf
> @@ -0,0 +1,45 @@
> +## @file
> 
> +# Component description file for the Dxe Graphics Init library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeGraphicsInitLib
> 
> +FILE_GUID = 2E889319-7361-4F6C-B181-EBD7AEF1DE6A
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +LIBRARY_CLASS = DxeGraphicsInitLib
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +IoLib
> 
> +PciSegmentLib
> 
> +BaseMemoryLib
> 
> +MemoryAllocationLib
> 
> +MmPciLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeGraphicsInitLib.c
> 
> +
> 
> +[Guids]
> 
> +gGraphicsDxeConfigGuid   ## CONSUMES
> 
> +
> 
> +[Pcd]
> 
> +
> 
> +[Protocols]
> 
> +gSaPolicyProtocolGuid                  ## CONSUMES
> 
> +gSaNvsAreaProtocolGuid                 ## CONSUMES
> 
> +gGopComponentName2ProtocolGuid         ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.c
> new file mode 100644
> index 0000000000..fd284d5f42
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.c
> @@ -0,0 +1,118 @@
> +/** @file
> 
> +  This file provide services for DXE phase Graphics policy default initialization.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DxeGraphicsPolicyLib.h>
> 
> +
> 
> +/**
> 
> +  This function prints the Graphics DXE phase policy.
> 
> +
> 
> +  @param[in] SaPolicy - SA DXE Policy protocol
> 
> +**/
> 
> +VOID
> 
> +GraphicsDxePolicyPrint (
> 
> +  IN  SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                  Status;
> 
> +  GRAPHICS_DXE_CONFIG         *GraphicsDxeConfig;
> 
> +
> 
> +  //
> 
> +  // Get requisite IP Config Blocks which needs to be used here
> 
> +  //
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +
> 
> +  DEBUG_CODE_BEGIN ();
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ Graphics Policy (DXE) print
> BEGIN -----------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Revision : %d\n", GraphicsDxeConfig-
> >Header.Revision));
> 
> +  ASSERT (GraphicsDxeConfig->Header.Revision ==
> GRAPHICS_DXE_CONFIG_REVISION);
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ Graphics Policy (DXE) print
> END -----------------\n"));
> 
> +  DEBUG_CODE_END ();
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  This function Load default Graphics DXE policy.
> 
> +
> 
> +  @param[in] ConfigBlockPointer    The pointer to add Graphics config block
> 
> +**/
> 
> +VOID
> 
> +LoadIgdDxeDefault (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  GRAPHICS_DXE_CONFIG        *GraphicsDxeConfig;
> 
> +
> 
> +  GraphicsDxeConfig = ConfigBlockPointer;
> 
> +  DEBUG ((DEBUG_INFO, "GraphicsDxeConfig->Header.GuidHob.Name =
> %g\n", &GraphicsDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "GraphicsDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", GraphicsDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +  ///
> 
> +  /// Initialize the Graphics configuration
> 
> +  ///
> 
> +  GraphicsDxeConfig->PlatformConfig           = 1;
> 
> +  GraphicsDxeConfig->AlsEnable                = 2;
> 
> +  GraphicsDxeConfig->BacklightControlSupport  = 2;
> 
> +  GraphicsDxeConfig->IgdBlcConfig             = 2;
> 
> +  GraphicsDxeConfig->IgdDvmtMemSize           = 1;
> 
> +  GraphicsDxeConfig->GfxTurboIMON             = 31;
> 
> +  ///
> 
> +  /// <EXAMPLE> Create a static Backlight Brightness Level Duty cycle
> Mapping Table
> 
> +  /// Possible 20 entries (example used 11), each 16 bits as follows:
> 
> +  /// [15] = Field Valid bit, [14:08] = Level in Percentage (0-64h), [07:00] =
> Desired duty cycle (0 - FFh).
> 
> +  ///
> 
> +  GraphicsDxeConfig->BCLM[0] = (0x0000 + WORD_FIELD_VALID_BIT);  ///<
> 0%
> 
> +  GraphicsDxeConfig->BCLM[1] = (0x0A19 + WORD_FIELD_VALID_BIT);  ///<
> 10%
> 
> +  GraphicsDxeConfig->BCLM[2] = (0x1433 + WORD_FIELD_VALID_BIT);  ///<
> 20%
> 
> +  GraphicsDxeConfig->BCLM[3] = (0x1E4C + WORD_FIELD_VALID_BIT);  ///<
> 30%
> 
> +  GraphicsDxeConfig->BCLM[4] = (0x2866 + WORD_FIELD_VALID_BIT);  ///<
> 40%
> 
> +  GraphicsDxeConfig->BCLM[5] = (0x327F + WORD_FIELD_VALID_BIT);  ///<
> 50%
> 
> +  GraphicsDxeConfig->BCLM[6] = (0x3C99 + WORD_FIELD_VALID_BIT);  ///<
> 60%
> 
> +  GraphicsDxeConfig->BCLM[7] = (0x46B2 + WORD_FIELD_VALID_BIT);  ///<
> 70%
> 
> +  GraphicsDxeConfig->BCLM[8] = (0x50CC + WORD_FIELD_VALID_BIT);  ///<
> 80%
> 
> +  GraphicsDxeConfig->BCLM[9] = (0x5AE5 + WORD_FIELD_VALID_BIT);  ///<
> 90%
> 
> +  GraphicsDxeConfig->BCLM[10] = (0x64FF + WORD_FIELD_VALID_BIT);
> ///< 100%
> 
> +}
> 
> +
> 
> +static COMPONENT_BLOCK_ENTRY  mGraphicsDxeIpBlocks = {
> 
> +  &gGraphicsDxeConfigGuid, sizeof (GRAPHICS_DXE_CONFIG),
> GRAPHICS_DXE_CONFIG_REVISION, LoadIgdDxeDefault};
> 
> +
> 
> +
> 
> +/**
> 
> +  Get DXE Graphics config block table total size.
> 
> +
> 
> +  @retval     Size of DXE Graphics config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +GraphicsGetConfigBlockTotalSizeDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mGraphicsDxeIpBlocks.Size;
> 
> +}
> 
> +
> 
> +/**
> 
> +  GraphicsAddConfigBlocksDxe add all DXE Graphics config block.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add SA config blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GraphicsAddConfigBlocksDxe (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  Status = AddComponentConfigBlocks (ConfigBlockTableAddress,
> &mGraphicsDxeIpBlocks, 1);
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.inf
> new file mode 100644
> index 0000000000..d3ac3c24a1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeGrap
> hicsPolicyLib/DxeGraphicsPolicyLib.inf
> @@ -0,0 +1,37 @@
> +## @file
> 
> +# Component description file for the DXE Graphics Policy Init library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeGraphicsPolicyLib
> 
> +FILE_GUID = C6190599-287E-40F9-9B46-EE112A322EBF
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeGraphicsPolicyLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseMemoryLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +HobLib
> 
> +SiConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeGraphicsPolicyLib.c
> 
> +
> 
> +[Guids]
> 
> +gGraphicsDxeConfigGuid
> 
> +
> 
> +[Pcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInit.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInit.c
> new file mode 100644
> index 0000000000..0e12f62f4e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInit.c
> @@ -0,0 +1,541 @@
> +/** @file
> 
> +  This is part of the implementation of an Intel Graphics drivers OpRegion /
> 
> +  Software SCI interface between system BIOS, ASL code, and Graphics
> drivers.
> 
> +  The code in this file will load the driver and initialize the interface
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DxeIgdOpRegionInitLib.h>
> 
> +
> 
> +#define HEADER_OPREGION_VER_GEN9          0x0200
> 
> +#define HEADER_OPREGION_VER_GEN12         0x0201
> 
> +
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED IGD_OPREGION_PROTOCOL
> mIgdOpRegion;
> 
> +
> 
> +/**
> 
> +  Get VBT data using SaPlaformPolicy
> 
> +
> 
> +  @param[out] VbtFileBuffer    Pointer to VBT data buffer.
> 
> +
> 
> +  @retval EFI_SUCCESS      VBT data was returned.
> 
> +  @retval EFI_NOT_FOUND    VBT data not found.
> 
> +  @exception EFI_UNSUPPORTED  Invalid signature in VBT data.
> 
> +**/
> 
> +EFI_STATUS
> 
> +GetIntegratedIntelVbtPtr (
> 
> +  OUT VBIOS_VBT_STRUCTURE **VbtFileBuffer
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                    Status;
> 
> +  EFI_PHYSICAL_ADDRESS          VbtAddress;
> 
> +  UINT32                        Size;
> 
> +  GRAPHICS_DXE_CONFIG           *GraphicsDxeConfig;
> 
> +  SA_POLICY_PROTOCOL            *SaPolicy;
> 
> +
> 
> +  ///
> 
> +  /// Get the SA policy.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (
> 
> +                  &gSaPolicyProtocolGuid,
> 
> +                  NULL,
> 
> +                  (VOID **) &SaPolicy
> 
> +                  );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  VbtAddress = GraphicsDxeConfig->VbtAddress;
> 
> +  Size       = GraphicsDxeConfig->Size;
> 
> +
> 
> +  if (VbtAddress == 0x00000000) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  } else {
> 
> +    ///
> 
> +    /// Check VBT signature
> 
> +    ///
> 
> +    *VbtFileBuffer  = NULL;
> 
> +    *VbtFileBuffer = (VBIOS_VBT_STRUCTURE *) (UINTN) VbtAddress;
> 
> +    if ((*((UINT32 *) ((*VbtFileBuffer)->HeaderSignature))) !=
> VBT_SIGNATURE) {
> 
> +      FreePool (*VbtFileBuffer);
> 
> +      *VbtFileBuffer = NULL;
> 
> +      return EFI_UNSUPPORTED;
> 
> +    }
> 
> +  }
> 
> +  if (Size == 0) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  } else {
> 
> +    ///
> 
> +    /// Check VBT size
> 
> +    ///
> 
> +    if ((*VbtFileBuffer)->HeaderVbtSize > Size) {
> 
> +      (*VbtFileBuffer)->HeaderVbtSize = (UINT16) Size;
> 
> +    }
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get a pointer to an uncompressed image of the Intel video BIOS.
> 
> +
> 
> +  @Note: This function would only be called if the video BIOS at 0xC000 is
> 
> +         missing or not an Intel video BIOS.  It may not be an Intel video BIOS
> 
> +         if the Intel graphic contoller is considered a secondary adapter.
> 
> +
> 
> +  @param[out] VBiosImage     - Pointer to an uncompressed Intel video
> BIOS.  This pointer must
> 
> +                               be set to NULL if an uncompressed image of the Intel Video
> BIOS
> 
> +                               is not obtainable.
> 
> +
> 
> +  @retval EFI_SUCCESS        - VBiosPtr is updated.
> 
> +  @exception EFI_UNSUPPORTED - No Intel video BIOS found.
> 
> +**/
> 
> +EFI_STATUS
> 
> +GetIntegratedIntelVBiosPtr (
> 
> +  OUT INTEL_VBIOS_OPTION_ROM_HEADER **VBiosImage
> 
> +  )
> 
> +{
> 
> +  EFI_HANDLE                    *HandleBuffer;
> 
> +  UINTN                         HandleCount;
> 
> +  UINTN                         Index;
> 
> +  INTEL_VBIOS_PCIR_STRUCTURE    *PcirBlockPtr;
> 
> +  EFI_STATUS                    Status;
> 
> +  EFI_PCI_IO_PROTOCOL           *PciIo;
> 
> +  INTEL_VBIOS_OPTION_ROM_HEADER *VBiosRomImage;
> 
> +
> 
> +  ///
> 
> +  /// Set as if an umcompressed Intel video BIOS image was not obtainable.
> 
> +  ///
> 
> +  VBiosRomImage = NULL;
> 
> +
> 
> +  ///
> 
> +  /// Get all PCI IO protocols
> 
> +  ///
> 
> +  Status = gBS->LocateHandleBuffer (
> 
> +                  ByProtocol,
> 
> +                  &gEfiPciIoProtocolGuid,
> 
> +                  NULL,
> 
> +                  &HandleCount,
> 
> +                  &HandleBuffer
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Find the video BIOS by checking each PCI IO handle for an Intel video
> 
> +  /// BIOS OPROM.
> 
> +  ///
> 
> +  for (Index = 0; Index < HandleCount; Index++) {
> 
> +    Status = gBS->HandleProtocol (
> 
> +                    HandleBuffer[Index],
> 
> +                    &gEfiPciIoProtocolGuid,
> 
> +                    (VOID **) &PciIo
> 
> +                    );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +    VBiosRomImage = PciIo->RomImage;
> 
> +
> 
> +    ///
> 
> +    /// If this PCI device doesn't have a ROM image, skip to the next device.
> 
> +    ///
> 
> +    if (!VBiosRomImage) {
> 
> +      continue;
> 
> +    }
> 
> +    ///
> 
> +    /// Get pointer to PCIR structure
> 
> +    ///
> 
> +    PcirBlockPtr = (INTEL_VBIOS_PCIR_STRUCTURE *) ((UINT8 *)
> VBiosRomImage + VBiosRomImage->PcirOffset);
> 
> +
> 
> +    ///
> 
> +    /// Check if we have an Intel video BIOS OPROM.
> 
> +    ///
> 
> +    if ((VBiosRomImage->Signature == OPTION_ROM_SIGNATURE) &&
> 
> +        (PcirBlockPtr->VendorId == V_SA_MC_VID) &&
> 
> +        (PcirBlockPtr->ClassCode[0] == 0x00) &&
> 
> +        (PcirBlockPtr->ClassCode[1] == 0x00) &&
> 
> +        (PcirBlockPtr->ClassCode[2] == 0x03)
> 
> +        ) {
> 
> +      ///
> 
> +      /// Found Intel video BIOS.
> 
> +      ///
> 
> +      *VBiosImage = VBiosRomImage;
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// No Intel video BIOS found.
> 
> +  ///
> 
> +  ///
> 
> +  /// Free any allocated buffers
> 
> +  ///
> 
> +  FreePool (HandleBuffer);
> 
> +  return EFI_UNSUPPORTED;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Intel video BIOS VBT information (i.e. Pointer to VBT and VBT size).
> 
> +  The VBT (Video BIOS Table) is a block of customizable data that is built
> 
> +  within the video BIOS and edited by customers.
> 
> +
> 
> +  @retval EFI_SUCCESS            - Video BIOS VBT information returned.
> 
> +  @exception EFI_UNSUPPORTED     - Could not find VBT information
> (*VBiosVbtPtr = NULL).
> 
> +**/
> 
> +EFI_STATUS
> 
> +GetVBiosVbtEndOfDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  INTEL_VBIOS_OPTION_ROM_HEADER *VBiosPtr;
> 
> +  VBIOS_VBT_STRUCTURE           *VBiosVbtPtr;
> 
> +  EFI_STATUS                    Status;
> 
> +  VBIOS_VBT_STRUCTURE           *VbtFileBuffer;
> 
> +  GRAPHICS_DXE_CONFIG           *GraphicsDxeConfig;
> 
> +  SA_POLICY_PROTOCOL            *SaPolicy;
> 
> +
> 
> +  VbtFileBuffer = NULL;
> 
> +
> 
> +  ///
> 
> +  /// Get the SA policy.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (
> 
> +                  &gSaPolicyProtocolGuid,
> 
> +                  NULL,
> 
> +                  (VOID **) &SaPolicy
> 
> +                  );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  VBiosPtr = NULL;
> 
> +  ///
> 
> +  /// Try to get VBT from FV.
> 
> +  ///
> 
> +  GetIntegratedIntelVbtPtr (&VbtFileBuffer);
> 
> +  if (VbtFileBuffer != NULL) {
> 
> +    ///
> 
> +    /// Video BIOS not found, use VBT from SaPolicy
> 
> +    ///
> 
> +    DEBUG ((DEBUG_INFO, "VBT data found\n"));
> 
> +    CopyMem (mIgdOpRegion.OpRegion->Header.DVER, GraphicsDxeConfig-
> >GopVersion, sizeof(GraphicsDxeConfig->GopVersion));
> 
> +    mIgdOpRegion.OpRegion->MBox3.RVDA = 0;
> 
> +    mIgdOpRegion.OpRegion->MBox3.RVDS = 0;
> 
> +    if ((VbtFileBuffer->HeaderVbtSize > 0x1800)) {  // VBT > 6KB
> 
> +      DEBUG ((DEBUG_INFO, "Extended VBT supported\n"));
> 
> +      mIgdOpRegion.OpRegion->MBox3.RVDA = sizeof
> (IGD_OPREGION_STRUCTURE); // Relative offset at the end of Op-region.
> 
> +      mIgdOpRegion.OpRegion->MBox3.RVDS = ((VbtFileBuffer-
> >HeaderVbtSize) & (UINT32)~(0x1FF)) + 0x200; // Aligned VBT Data Size to
> 512 bytes.
> 
> +      CopyMem ((CHAR8 *)(UINTN)(mIgdOpRegion.OpRegion) + sizeof
> (IGD_OPREGION_STRUCTURE), VbtFileBuffer, mIgdOpRegion.OpRegion-
> >MBox3.RVDS);
> 
> +    } else {
> 
> +      CopyMem (mIgdOpRegion.OpRegion->MBox4.RVBT, VbtFileBuffer,
> VbtFileBuffer->HeaderVbtSize);
> 
> +    }
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  if (VBiosPtr == NULL) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "VBIOS found at 0x%X\n", VBiosPtr));
> 
> +  VBiosVbtPtr = (VBIOS_VBT_STRUCTURE *) ((UINT8 *) VBiosPtr + VBiosPtr-
> >VbtOffset);
> 
> +
> 
> +  if ((*((UINT32 *) (VBiosVbtPtr->HeaderSignature))) != VBT_SIGNATURE) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Initialize Video BIOS version with its build number.
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->Header.VVER[0] = VBiosVbtPtr-
> >CoreBlockBiosBuild[0];
> 
> +  mIgdOpRegion.OpRegion->Header.VVER[1] = VBiosVbtPtr-
> >CoreBlockBiosBuild[1];
> 
> +  mIgdOpRegion.OpRegion->Header.VVER[2] = VBiosVbtPtr-
> >CoreBlockBiosBuild[2];
> 
> +  mIgdOpRegion.OpRegion->Header.VVER[3] = VBiosVbtPtr-
> >CoreBlockBiosBuild[3];
> 
> +  CopyMem (mIgdOpRegion.OpRegion->MBox4.RVBT, VBiosVbtPtr,
> VBiosVbtPtr->HeaderVbtSize);
> 
> +
> 
> +  ///
> 
> +  /// Return final status
> 
> +  ///
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Graphics OpRegion / Software SCI driver installation function.
> 
> +
> 
> +  @param[in] void         - None
> 
> +  @retval EFI_SUCCESS     - The driver installed without error.
> 
> +  @retval EFI_ABORTED     - The driver encountered an error and could not
> complete
> 
> +                            installation of the ACPI tables.
> 
> +**/
> 
> +EFI_STATUS
> 
> +IgdOpRegionInit (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_HANDLE                      Handle;
> 
> +  EFI_STATUS                      Status;
> 
> +  UINT32                          DwordData;
> 
> +  UINT64                          IgdBaseAddress;
> 
> +  SA_POLICY_PROTOCOL              *SaPolicy;
> 
> +  GRAPHICS_DXE_CONFIG             *GraphicsDxeConfig;
> 
> +  UINT8                           Index;
> 
> +  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
> 
> +  VBIOS_VBT_STRUCTURE             *VbtFileBuffer;
> 
> +  UINT16                          ExtendedVbtSize;
> 
> +
> 
> +  ///
> 
> +  /// Get the SA policy.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID
> **)&SaPolicy);
> 
> +
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gGraphicsDxeConfigGuid,
> (VOID *)&GraphicsDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  VbtFileBuffer = NULL;
> 
> +  ExtendedVbtSize = 0;
> 
> +
> 
> +  GetIntegratedIntelVbtPtr (&VbtFileBuffer);
> 
> +  ///
> 
> +  ///  Locate the SA Global NVS Protocol.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (
> 
> +                  &gSaNvsAreaProtocolGuid,
> 
> +                  NULL,
> 
> +                  (VOID **) &SaNvsAreaProtocol
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Check if VBT size is >6KB then allocate an ACPI NVS memory buffer as
> the IGD OpRegion + extended VBT size,
> 
> +  /// zero initialize it, and set the IGD OpRegion pointer in the Global NVS
> area structure.
> 
> +  ///
> 
> +  if ((VbtFileBuffer != NULL) && (VbtFileBuffer->HeaderVbtSize > 0x1800)) {
> 
> +    ExtendedVbtSize = ((VbtFileBuffer->HeaderVbtSize) & (UINT32)~(0x1FF))
> + 0x200;
> 
> +  }
> 
> +
> 
> +  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof
> (IGD_OPREGION_STRUCTURE) + ExtendedVbtSize, (VOID **)
> &mIgdOpRegion.OpRegion);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  SetMem (mIgdOpRegion.OpRegion, sizeof (IGD_OPREGION_STRUCTURE)
> + ExtendedVbtSize, 0);
> 
> +  SaNvsAreaProtocol->Area->IgdOpRegionAddress = (UINT32) (UINTN)
> (mIgdOpRegion.OpRegion);
> 
> +
> 
> +  ///
> 
> +  /// If IGD is disabled return
> 
> +  ///
> 
> +  IgdBaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
> 
> +  if (PciSegmentRead32 (IgdBaseAddress + 0) == 0xFFFFFFFF) {
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +  ///
> 
> +  /// Initialize OpRegion Header
> 
> +  ///
> 
> +  CopyMem (mIgdOpRegion.OpRegion->Header.SIGN,
> HEADER_SIGNATURE, sizeof (HEADER_SIGNATURE));
> 
> +  ///
> 
> +  /// Set OpRegion Size in KBs
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->Header.SIZE = HEADER_SIZE / 1024;
> 
> +  mIgdOpRegion.OpRegion->Header.OVER = (UINT32) (LShiftU64
> (HEADER_OPREGION_VER_GEN12, 16) + LShiftU64
> (HEADER_OPREGION_REV, 8));
> 
> +
> 
> +  ///
> 
> +  /// All Mailboxes are supported.
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->Header.MBOX = HEADER_MBOX_SUPPORT;
> 
> +
> 
> +  ///
> 
> +  /// Initialize OpRegion Mailbox 1 (Public ACPI Methods).
> 
> +  ///
> 
> +  /// Note - The initial setting of mailbox 1 fields is implementation specific.
> 
> +  /// Adjust them as needed many even coming from user setting in setup.
> 
> +  ///
> 
> +  ///
> 
> +  /// Initialize OpRegion Mailbox 3 (ASLE Interrupt and Power Conservation).
> 
> +  ///
> 
> +  /// Note - The initial setting of mailbox 3 fields is implementation specific.
> 
> +  /// Adjust them as needed many even coming from user setting in setup.
> 
> +  ///
> 
> +  ///
> 
> +  /// Do not initialize TCHE. This field is written by the graphics driver only.
> 
> +  ///
> 
> +  ///
> 
> +  /// The ALSI field is generally initialized by ASL code by reading the
> embedded controller.
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->Header.PCON = GraphicsDxeConfig-
> >PlatformConfig;
> 
> +  mIgdOpRegion.OpRegion->Header.PCON = mIgdOpRegion.OpRegion-
> >Header.PCON | 0x2;
> 
> +
> 
> +  mIgdOpRegion.OpRegion->MBox3.BCLP = BACKLIGHT_BRIGHTNESS;
> 
> +
> 
> +  mIgdOpRegion.OpRegion->MBox3.PFIT = (FIELD_VALID_BIT |
> PFIT_STRETCH);
> 
> +
> 
> +  ///
> 
> +  /// Reporting to driver for VR IMON Calibration. Bits [5-1] values supported
> 14A to 31A.
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->MBox3.PCFT = (SaNvsAreaProtocol->Area-
> >GfxTurboIMON << 1) & 0x003E;
> 
> +
> 
> +  ///
> 
> +  /// Set Initial current Brightness
> 
> +  ///
> 
> +  mIgdOpRegion.OpRegion->MBox3.CBLV = (INIT_BRIGHT_LEVEL |
> FIELD_VALID_BIT);
> 
> +
> 
> +  ///
> 
> +  /// Static Backlight Brightness Level Duty cycle Mapping Table
> 
> +  ///
> 
> +  for (Index = 0; Index < MAX_BCLM_ENTRIES; Index++) {
> 
> +    mIgdOpRegion.OpRegion->MBox3.BCLM[Index] = GraphicsDxeConfig-
> >BCLM[Index];
> 
> +  }
> 
> +
> 
> +  mIgdOpRegion.OpRegion->MBox3.IUER = 0x00;
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    mIgdOpRegion.OpRegion->MBox3.IUER =  GraphicsDxeConfig-
> >IuerStatusVal;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Initialize hardware state:
> 
> +  ///   Set ASLS Register to the OpRegion physical memory address.
> 
> +  ///   Set SWSCI register bit 15 to a "1" to activate SCI interrupts.
> 
> +  ///
> 
> +  PciSegmentWrite32 (IgdBaseAddress + R_SA_IGD_ASLS_OFFSET, (UINT32)
> (UINTN) (mIgdOpRegion.OpRegion));
> 
> +  PciSegmentAndThenOr16 (IgdBaseAddress + R_SA_IGD_SWSCI_OFFSET,
> (UINT16) ~(BIT0), BIT15);
> 
> +
> 
> +  DwordData = PciSegmentRead32 (IgdBaseAddress +
> R_SA_IGD_ASLS_OFFSET);
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) PcdGet64 (PcdPciExpressBaseAddress) + (IgdBaseAddress +
> R_SA_IGD_ASLS_OFFSET),
> 
> +    1,
> 
> +    &DwordData
> 
> +    );
> 
> +  DwordData = PciSegmentRead32 (IgdBaseAddress +
> R_SA_IGD_SWSCI_OFFSET);
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) PcdGet64 (PcdPciExpressBaseAddress) + (IgdBaseAddress +
> R_SA_IGD_SWSCI_OFFSET),
> 
> +    1,
> 
> +    &DwordData
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// Install OpRegion / Software SCI protocol
> 
> +  ///
> 
> +  Handle = NULL;
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &Handle,
> 
> +                  &gIgdOpRegionProtocolGuid,
> 
> +                  &mIgdOpRegion,
> 
> +                  NULL
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Return final status
> 
> +  ///
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update Graphics OpRegion after PCI enumeration.
> 
> +
> 
> +  @param[in] void         - None
> 
> +  @retval EFI_SUCCESS     - The function completed successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +UpdateIgdOpRegionEndOfDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                    Status;
> 
> +  UINTN                         HandleCount;
> 
> +  EFI_HANDLE                    *HandleBuffer;
> 
> +  UINTN                         Index;
> 
> +  EFI_PCI_IO_PROTOCOL           *PciIo;
> 
> +  PCI_TYPE00                    Pci;
> 
> +  UINTN                         Segment;
> 
> +  UINTN                         Bus;
> 
> +  UINTN                         Device;
> 
> +  UINTN                         Function;
> 
> +
> 
> +  Bus      = 0;
> 
> +  Device   = 0;
> 
> +  Function = 0;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "UpdateIgdOpRegionEndOfDxe\n"));
> 
> +
> 
> +  mIgdOpRegion.OpRegion->Header.PCON |= BIT8; //Set External Gfx
> Adapter field is valid
> 
> +  mIgdOpRegion.OpRegion->Header.PCON &= (UINT32) (~BIT7); //Assume
> No External Gfx Adapter
> 
> +
> 
> +  ///
> 
> +  /// Get all PCI IO protocols handles
> 
> +  ///
> 
> +  Status = gBS->LocateHandleBuffer (
> 
> +                  ByProtocol,
> 
> +                  &gEfiPciIoProtocolGuid,
> 
> +                  NULL,
> 
> +                  &HandleCount,
> 
> +                  &HandleBuffer
> 
> +                  );
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    for (Index = 0; Index < HandleCount; Index++) {
> 
> +      ///
> 
> +      /// Get the PCI IO Protocol Interface corresponding to each handle
> 
> +      ///
> 
> +      Status = gBS->HandleProtocol (
> 
> +                      HandleBuffer[Index],
> 
> +                      &gEfiPciIoProtocolGuid,
> 
> +                      (VOID **) &PciIo
> 
> +                      );
> 
> +
> 
> +      if (!EFI_ERROR (Status)) {
> 
> +        ///
> 
> +        /// Read the PCI configuration space
> 
> +        ///
> 
> +        Status = PciIo->Pci.Read (
> 
> +                              PciIo,
> 
> +                              EfiPciIoWidthUint32,
> 
> +                              0,
> 
> +                              sizeof (Pci) / sizeof (UINT32),
> 
> +                              &Pci
> 
> +                              );
> 
> +
> 
> +        ///
> 
> +        /// Find the display controllers devices
> 
> +        ///
> 
> +        if (!EFI_ERROR (Status) && IS_PCI_DISPLAY (&Pci)) {
> 
> +          Status = PciIo->GetLocation (
> 
> +                            PciIo,
> 
> +                            &Segment,
> 
> +                            &Bus,
> 
> +                            &Device,
> 
> +                            &Function
> 
> +                            );
> 
> +
> 
> +          //
> 
> +          // Assumption: Onboard devices will be sits on Bus no 0, while external
> devices will be sits on Bus no > 0
> 
> +          //
> 
> +          if (!EFI_ERROR (Status) && (Bus > 0)) {
> 
> +            //External Gfx Adapter Detected and Available
> 
> +            DEBUG ((DEBUG_INFO, "PCON - External Gfx Adapter Detected and
> Available\n"));
> 
> +            mIgdOpRegion.OpRegion->Header.PCON |= BIT7;
> 
> +            break;
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Free any allocated buffers
> 
> +  ///
> 
> +  if (HandleBuffer != NULL) {
> 
> +    FreePool (HandleBuffer);
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Return final status
> 
> +  ///
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInitLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInitLib.inf
> new file mode 100644
> index 0000000000..20c6265d8f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Graphics/LibraryPrivate/DxeIgdO
> pRegionInitLib/DxeIgdOpRegionInitLib.inf
> @@ -0,0 +1,49 @@
> +## @file
> 
> +# Component description file for the Dxe IGD OpRegion library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeIgdOpRegionInitLib
> 
> +FILE_GUID = 18D47D72-555E-475B-A4E4-AD20C3BD8B15
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +UEFI_SPECIFICATION_VERSION = 2.00
> 
> +LIBRARY_CLASS = DxeIgdOpRegionInitLib
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +PciSegmentLib
> 
> +BaseMemoryLib
> 
> +MemoryAllocationLib
> 
> +IoLib
> 
> +S3BootScriptLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +IntelSiliconPkg/IntelSiliconPkg.dec
> 
> +
> 
> +[Pcd]
> 
> +gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
> 
> +
> 
> +[Sources]
> 
> +DxeIgdOpRegionInit.c
> 
> +
> 
> +[Guids]
> 
> +gGraphicsDxeConfigGuid        ## CONSUMES
> 
> +
> 
> +[Protocols]
> 
> +gIgdOpRegionProtocolGuid               ## PRODUCES
> 
> +gSaPolicyProtocolGuid                  ## CONSUMES
> 
> +gEfiPciIoProtocolGuid                  ## CONSUMES
> 
> +gSaNvsAreaProtocolGuid                 ## CONSUMES
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component
  2021-02-01  1:36 ` [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Hda/IncludePrivate
>   * IpBlock/Hda/Library
>   * IpBlock/Hda/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeHda
> PolicyLib.h           |  55
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/HdaRe
> gs.h                  |  46
> ++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHd
> aNhltLib.c              | 383
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeHd
> aNhltLib.inf            |  31 +++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib
> /DxeHdaPolicyLib.c   |  92
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicyLib
> /DxeHdaPolicyLib.inf |  31 +++++++++++++++++++++++++++++++
>  6 files changed, 638 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeH
> daPolicyLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeH
> daPolicyLib.h
> new file mode 100644
> index 0000000000..9c42bf5611
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Library/DxeH
> daPolicyLib.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  DXE Hda policy library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_HDA_POLICY_LIB_H_
> 
> +#define _DXE_HDA_POLICY_LIB_H_
> 
> +
> 
> +#include <Protocol/PchPolicy.h>
> 
> +
> 
> +/**
> 
> +  Print HDAUDIO_DXE_CONFIG and serial out.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +HdaDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Load Config block default
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +HdaDxeLoadConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Hda config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +HdaDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Add Hda ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +HdaDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +#endif // _DXE_HDA_POLICY_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/Hda
> Regs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/Hda
> Regs.h
> new file mode 100644
> index 0000000000..b165e7bb22
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/IncludePrivate/Register/Hda
> Regs.h
> @@ -0,0 +1,46 @@
> +/** @file
> 
> +  Register names for High Definition Audio device.
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HDA_REGS_H_
> 
> +#define _HDA_REGS_H_
> 
> +
> 
> +//
> 
> +// HD-A Controller Registers
> 
> +//
> 
> +// PCI Configuration Space Registers
> 
> +//
> 
> +#define R_HDA_CFG_PCS                           0x54
> 
> +#define B_HDA_CFG_PCS_PMEE                      BIT8
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.c
> new file mode 100644
> index 0000000000..71388934e6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.c
> @@ -0,0 +1,383 @@
> +/** @file
> 
> +  HD Audio NHLT Library implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <DxeHdaNhlt.h>
> 
> +
> 
> +/**
> 
> +  Returns pointer to Endpoint ENDPOINT_DESCRIPTOR structure.
> 
> +
> 
> +  @param[in] *NhltTable    Endpoint for which Format address is retrieved
> 
> +  @param[in] FormatIndex   Index of Format to be retrieved
> 
> +
> 
> +  @retval                  Pointer to ENDPOINT_DESCRIPTOR structure with given
> index
> 
> +**/
> 
> +ENDPOINT_DESCRIPTOR *
> 
> +GetNhltEndpoint (
> 
> +  IN CONST NHLT_ACPI_TABLE      *NhltTable,
> 
> +  IN CONST UINT8                EndpointIndex
> 
> +  )
> 
> +{
> 
> +  UINT8               Index;
> 
> +  ENDPOINT_DESCRIPTOR *Endpoint;
> 
> +  Endpoint = (ENDPOINT_DESCRIPTOR*) (NhltTable->EndpointDescriptors);
> 
> +
> 
> +  if (EndpointIndex > NhltTable->EndpointCount) {
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < EndpointIndex; Index++) {
> 
> +    Endpoint = (ENDPOINT_DESCRIPTOR*) ((UINT8*) (Endpoint) + Endpoint-
> >EndpointDescriptorLength);
> 
> +  }
> 
> +
> 
> +  return Endpoint;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to Endpoint Specific Configuration SPECIFIC_CONFIG
> structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which config address is retrieved
> 
> +
> 
> +  @retval                  Pointer to SPECIFIC_CONFIG structure with endpoint's
> capabilities
> 
> +**/
> 
> +SPECIFIC_CONFIG *
> 
> +GetNhltEndpointDeviceCapabilities (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  )
> 
> +{
> 
> +  return (SPECIFIC_CONFIG*) (&Endpoint->EndpointConfig);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to all Formats Configuration FORMATS_CONFIG structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which Formats address is retrieved
> 
> +
> 
> +  @retval                  Pointer to FORMATS_CONFIG structure
> 
> +**/
> 
> +FORMATS_CONFIG *
> 
> +GetNhltEndpointFormatsConfig (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  )
> 
> +{
> 
> +  FORMATS_CONFIG *FormatsConfig;
> 
> +  FormatsConfig = (FORMATS_CONFIG*) ((UINT8*) (&Endpoint-
> >EndpointConfig)
> 
> +                                     + sizeof (Endpoint->EndpointConfig.CapabilitiesSize)
> 
> +                                     + Endpoint->EndpointConfig.CapabilitiesSize);
> 
> +
> 
> +  return FormatsConfig;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to Format Configuration FORMAT_CONFIG structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which Format address is retrieved
> 
> +  @param[in] FormatIndex   Index of Format to be retrieved
> 
> +
> 
> +  @retval                  Pointer to FORMAT_CONFIG structure with given index
> 
> +**/
> 
> +FORMAT_CONFIG *
> 
> +GetNhltEndpointFormat (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
> 
> +  IN CONST UINT8                FormatIndex
> 
> +  )
> 
> +{
> 
> +  UINT8          Index;
> 
> +  UINT32         Length;
> 
> +  FORMATS_CONFIG *FormatsConfig;
> 
> +  FORMAT_CONFIG  *Format;
> 
> +
> 
> +  Length = 0;
> 
> +  FormatsConfig = GetNhltEndpointFormatsConfig (Endpoint);
> 
> +  Format = FormatsConfig->FormatsConfiguration;
> 
> +
> 
> +  if (FormatIndex > FormatsConfig->FormatsCount) {
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < FormatIndex; Index++) {
> 
> +    Length = sizeof (Format->Format) + Format-
> >FormatConfiguration.CapabilitiesSize
> 
> +      + sizeof (Format->FormatConfiguration.CapabilitiesSize);
> 
> +    Format = (FORMAT_CONFIG*) ((UINT8*) (Format) + Length);
> 
> +  }
> 
> +
> 
> +  return Format;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to all Device Information DEVICES_INFO structure.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint for which DevicesInfo address is
> retrieved
> 
> +
> 
> +  @retval                  Pointer to DEVICES_INFO structure
> 
> +**/
> 
> +DEVICES_INFO *
> 
> +GetNhltEndpointDevicesInfo (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  )
> 
> +{
> 
> +  DEVICES_INFO   *DevicesInfo;
> 
> +  FORMATS_CONFIG *FormatsConfig;
> 
> +  FORMAT_CONFIG  *Format;
> 
> +
> 
> +  FormatsConfig = GetNhltEndpointFormatsConfig (Endpoint);
> 
> +  Format = GetNhltEndpointFormat (Endpoint, FormatsConfig-
> >FormatsCount);
> 
> +  DevicesInfo = (DEVICES_INFO*) ((UINT8*) Format);
> 
> +
> 
> +  return DevicesInfo;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to Device Information DEVICES_INFO structure.
> 
> +
> 
> +  @param[in] *Endpoint       Endpoint for which Device Info address is
> retrieved
> 
> +  @param[in] DeviceInfoIndex Index of Device Info to be retrieved
> 
> +
> 
> +  @retval                    Pointer to DEVICE_INFO structure with given index
> 
> +**/
> 
> +DEVICE_INFO *
> 
> +GetNhltEndpointDeviceInfo (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint,
> 
> +  IN CONST UINT8                DeviceInfoIndex
> 
> +  )
> 
> +{
> 
> +  DEVICES_INFO  *DevicesInfo;
> 
> +  DEVICE_INFO   *DeviceInfo;
> 
> +
> 
> +  DevicesInfo = GetNhltEndpointDevicesInfo (Endpoint);
> 
> +  DeviceInfo = DevicesInfo->DeviceInformation;
> 
> +
> 
> +  if (DevicesInfo == NULL || DeviceInfoIndex >= DevicesInfo-
> >DeviceInfoCount) {
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  DeviceInfo = (DEVICE_INFO*) ((UINT8*) (DeviceInfo) + sizeof
> (*DeviceInfo) * DeviceInfoIndex);
> 
> +
> 
> +  return DeviceInfo;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns pointer to OED Configuration SPECIFIC_CONFIG structure.
> 
> +
> 
> +  @param[in] *NhltTable    NHLT table for which OED address is retrieved
> 
> +
> 
> +  @retval                  Pointer to SPECIFIC_CONFIG structure with NHLT
> capabilities
> 
> +**/
> 
> +SPECIFIC_CONFIG *
> 
> +GetNhltOedConfig (
> 
> +  IN CONST NHLT_ACPI_TABLE      *NhltTable
> 
> +  )
> 
> +{
> 
> +  ENDPOINT_DESCRIPTOR *Endpoint;
> 
> +  SPECIFIC_CONFIG     *OedConfig;
> 
> +
> 
> +  Endpoint = GetNhltEndpoint (NhltTable, (NhltTable->EndpointCount));
> 
> +  OedConfig = (SPECIFIC_CONFIG*) ((UINT8*) (Endpoint));
> 
> +
> 
> +  return OedConfig;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Prints Format configuration.
> 
> +
> 
> +  @param[in] *Format       Format to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltFormatDump (
> 
> +  IN CONST FORMAT_CONFIG        *Format
> 
> +  )
> 
> +{
> 
> +  UINT32 Index;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------------- FORMAT -----------------
> --------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.wFormatTag      =
> 0x%x\n", Format->Format.Format.wFormatTag));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.nChannels       = %d\n",
> Format->Format.Format.nChannels));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.nSamplesPerSec  =
> %d\n", Format->Format.Format.nSamplesPerSec));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.nAvgBytesPerSec =
> %d\n", Format->Format.Format.nAvgBytesPerSec));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.nBlockAlign     = %d\n",
> Format->Format.Format.nBlockAlign));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.wBitsPerSample  =
> %d\n", Format->Format.Format.wBitsPerSample));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Format.cbSize          = %d\n",
> Format->Format.Format.cbSize));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.Samples                = %d\n",
> Format->Format.Samples));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.dwChannelMask          =
> 0x%x\n", Format->Format.dwChannelMask));
> 
> +  DEBUG ((DEBUG_INFO, " Format->Format.SubFormat              = %g\n",
> Format->Format.SubFormat));
> 
> +
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " Format->FormatConfiguration.CapabilitiesSize =
> %d B\n", Format->FormatConfiguration.CapabilitiesSize));
> 
> +  DEBUG ((DEBUG_VERBOSE, " Format-
> >FormatConfiguration.Capabilities:"));
> 
> +  for (Index = 0; Index < (  Format->FormatConfiguration.CapabilitiesSize ) ;
> Index++) {
> 
> +    if (Index % 16 == 0) {
> 
> +      DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +    }
> 
> +    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", Format-
> >FormatConfiguration.Capabilities[Index]));
> 
> +  }
> 
> +  DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Prints Device Information.
> 
> +
> 
> +  @param[in] *DeviceInfo       DeviceInfo to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltDeviceInfoDump (
> 
> +  IN CONST DEVICE_INFO          *DeviceInfo
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "----------------------------- DEVICE INFO --------------
> --------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " DeviceInfo->DeviceId         = %a\n",   DeviceInfo-
> >DeviceId));
> 
> +  DEBUG ((DEBUG_INFO, " DeviceInfo->DeviceInstanceId = 0x%x\n",
> DeviceInfo->DeviceInstanceId));
> 
> +  DEBUG ((DEBUG_INFO, " DeviceInfo->DevicePortId     = 0x%x\n",
> DeviceInfo->DevicePortId));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Prints Endpoint configuration.
> 
> +
> 
> +  @param[in] *Endpoint     Endpoint to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltEndpointDump (
> 
> +  IN CONST ENDPOINT_DESCRIPTOR  *Endpoint
> 
> +  )
> 
> +{
> 
> +  UINT8 Index;
> 
> +  FORMATS_CONFIG *FormatsConfigs;
> 
> +  FORMAT_CONFIG  *Format;
> 
> +  DEVICES_INFO   *DevicesInfo;
> 
> +  DEVICE_INFO    *DeviceInfo;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------------ ENDPOINT ----------------
> --------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->DeviceDescriptorLength = %d B\n",
> Endpoint->EndpointDescriptorLength));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->LinkType               = 0x%x\n", Endpoint-
> >LinkType));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->InstanceId             = 0x%x\n",
> Endpoint->InstanceId));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->HwVendorId             = 0x%x\n",
> Endpoint->HwVendorId));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->HwDeviceId             = 0x%x\n",
> Endpoint->HwDeviceId));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->HwRevisionId           = 0x%x\n",
> Endpoint->HwRevisionId));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->HwSubsystemId          = 0x%x\n",
> Endpoint->HwSubsystemId));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->DeviceType             = 0x%x\n",
> Endpoint->DeviceType));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->Direction              = 0x%x\n", Endpoint-
> >Direction));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->VirtualBusId           = 0x%x\n",
> Endpoint->VirtualBusId));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->EndpointConfig.CapabilitiesSize = %d
> B\n", Endpoint->EndpointConfig.CapabilitiesSize));
> 
> +  DEBUG ((DEBUG_VERBOSE, " Endpoint->EndpointConfig.Capabilities:"));
> 
> +  for (Index = 0; Index < (Endpoint->EndpointConfig.CapabilitiesSize ) ;
> Index++) {
> 
> +    if (Index % 16 == 0) DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", Endpoint-
> >EndpointConfig.Capabilities[Index]));
> 
> +  }
> 
> +
> 
> +  FormatsConfigs = GetNhltEndpointFormatsConfig (Endpoint);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Endpoint->FormatsConfig.FormatsCount =
> %d\n", FormatsConfigs->FormatsCount));
> 
> +  for (Index = 0; Index < FormatsConfigs->FormatsCount; Index++) {
> 
> +    Format = GetNhltEndpointFormat (Endpoint, Index);
> 
> +    if (Format != NULL) {
> 
> +      NhltFormatDump (Format);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  DevicesInfo = GetNhltEndpointDevicesInfo (Endpoint);
> 
> +  if (DevicesInfo != NULL) {
> 
> +    DEBUG ((DEBUG_INFO, "\n"));
> 
> +    DEBUG ((DEBUG_INFO, " Endpoint->DevicesInfo.DeviceInfoCount =
> %d\n", DevicesInfo->DeviceInfoCount));
> 
> +    for (Index = 0; Index < DevicesInfo->DeviceInfoCount; Index++) {
> 
> +      DeviceInfo = GetNhltEndpointDeviceInfo (Endpoint, Index);
> 
> +      if (DeviceInfo != NULL) {
> 
> +        NhltDeviceInfoDump (DeviceInfo);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Prints OED (Offload Engine Driver) configuration.
> 
> +
> 
> +  @param[in] *OedConfig   OED to be printed
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltOedConfigDump (
> 
> +  IN CONST SPECIFIC_CONFIG      *OedConfig
> 
> +  )
> 
> +{
> 
> +  UINT8 Index;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "-------------------------- OED CONFIGURATION ------
> -------------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " OedConfig->CapabilitiesSize = %d B\n",
> OedConfig->CapabilitiesSize));
> 
> +  DEBUG ((DEBUG_VERBOSE, " OedConfig->Capabilities:"));
> 
> +  for (Index = 0; Index < (OedConfig->CapabilitiesSize) ; Index++) {
> 
> +    if (Index % 16 == 0) DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +    DEBUG ((DEBUG_VERBOSE, "0x%02x, ", OedConfig->Capabilities[Index]));
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_VERBOSE, "\n"));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Prints NHLT (Non HDA-Link Table) to be exposed via ACPI (aka. OED
> (Offload Engine Driver) Configuration Table).
> 
> +
> 
> +  @param[in] *NhltTable    The NHLT table to print
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +NhltAcpiTableDump (
> 
> +  IN NHLT_ACPI_TABLE            *NhltTable
> 
> +  )
> 
> +{
> 
> +  DEBUG_CODE_BEGIN ();
> 
> +  UINT8 Index;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +  DEBUG ((DEBUG_INFO, "--- NHLT ACPI Table Dump [OED (Offload Engine
> Driver) Configuration] ---\n"));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "sizeof NHLT_ACPI_TABLE = %d B\n", sizeof
> (NHLT_ACPI_TABLE)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof EFI_ACPI_DESCRIPTION_HEADER = %d
> B\n", sizeof (EFI_ACPI_DESCRIPTION_HEADER)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof ENDPOINT_DESCRIPTOR = %d B\n", sizeof
> (ENDPOINT_DESCRIPTOR)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof SPECIFIC_CONFIG = %d B\n", sizeof
> (SPECIFIC_CONFIG)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof FORMATS_CONFIG = %d B\n", sizeof
> (FORMATS_CONFIG)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof FORMAT_CONFIG = %d B\n", sizeof
> (FORMAT_CONFIG)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof WAVEFORMATEXTENSIBLE = %d B\n",
> sizeof (WAVEFORMATEXTENSIBLE)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof DEVICES_INFO = %d B\n", sizeof
> (DEVICES_INFO)));
> 
> +  DEBUG ((DEBUG_INFO, "sizeof DEVICE_INFO = %d B\n", sizeof
> (DEVICE_INFO)));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Signature       =
> 0x%08x\n", NhltTable->Header.Signature));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Length          =
> 0x%08x\n", NhltTable->Header.Length));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Revision        =
> 0x%02x\n", NhltTable->Header.Revision));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.Checksum        =
> 0x%02x\n", NhltTable->Header.Checksum));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemId           = %a\n",
> NhltTable->Header.OemId));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemTableId      =
> 0x%lx\n",  NhltTable->Header.OemTableId));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.OemRevision     =
> 0x%08x\n", NhltTable->Header.OemRevision));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.CreatorId       =
> 0x%08x\n", NhltTable->Header.CreatorId));
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE Header.CreatorRevision =
> 0x%08x\n", NhltTable->Header.CreatorRevision));
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " NHLT_ACPI_TABLE EndpointCount = %d\n",
> NhltTable->EndpointCount));
> 
> +  for (Index = 0; Index < NhltTable->EndpointCount; Index++) {
> 
> +    NhltEndpointDump (GetNhltEndpoint (NhltTable, Index));
> 
> +  }
> 
> +
> 
> +  NhltOedConfigDump (GetNhltOedConfig (NhltTable));
> 
> +  DEBUG ((DEBUG_INFO, "------------------------------------------------------------
> ----------\n"));
> 
> +
> 
> +  DEBUG_CODE_END ();
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.inf
> new file mode 100644
> index 0000000000..a1574c3ab1
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/Library/DxeHdaNhltLib/DxeH
> daNhltLib.inf
> @@ -0,0 +1,31 @@
> +## @file
> 
> +# Component information file for HD Audio NHLT Library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeHdaNhltLib
> 
> +FILE_GUID = DA915B7F-EE08-4C1D-B3D0-DE7C52AB155A
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeHdaNhltLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +DebugLib
> 
> +MemoryAllocationLib
> 
> +BaseMemoryLib
> 
> +PchInfoLib
> 
> +ConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeHdaNhltLib.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.c
> new file mode 100644
> index 0000000000..30843fab39
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.c
> @@ -0,0 +1,92 @@
> +/** @file
> 
> +  This file provides services for Hda policy function
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <HdAudioConfig.h>
> 
> +
> 
> +/**
> 
> +  Print HDAUDIO_DXE_CONFIG and serial out.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +HdaDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  HDAUDIO_DXE_CONFIG    *HdaDxeConfig;
> 
> +  UINT32                Index;
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) PchPolicy, &gHdAudioDxeConfigGuid,
> (VOID *) &HdaDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------ HD-Audio DXE Config ---------------
> ---\n"));
> 
> +
> 
> +  for (Index = 0; Index < PCH_MAX_HDA_SNDW_LINK_NUM; Index++) {
> 
> +    DEBUG ((DEBUG_INFO, " SNDW%d AutonomousClockStop  : %d\n",
> Index, HdaDxeConfig->SndwConfig[Index].AutonomousClockStop));
> 
> +    DEBUG ((DEBUG_INFO, " SNDW%d DODS                 : %d\n", Index,
> HdaDxeConfig->SndwConfig[Index].DataOnDelaySelect));
> 
> +    DEBUG ((DEBUG_INFO, " SNDW%d DOAS                 : %d\n", Index,
> HdaDxeConfig->SndwConfig[Index].DataOnActiveIntervalSelect));
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, " DSP Feature Mask              : 0x%x\n",
> HdaDxeConfig->DspFeatureMask));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Load Config block default
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +HdaDxeLoadConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  HDAUDIO_DXE_CONFIG  *HdAudioDxeConfig;
> 
> +  HdAudioDxeConfig = ConfigBlockPointer;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "HdaDxeConfig->Header.GuidHob.Name = %g\n",
> &HdAudioDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "HdaDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", HdAudioDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +}
> 
> +
> 
> +STATIC COMPONENT_BLOCK_ENTRY  mHdaBlocks = {
> 
> +  &gHdAudioDxeConfigGuid,
> 
> +  sizeof (HDAUDIO_DXE_CONFIG),
> 
> +  HDAUDIO_DXE_CONFIG_REVISION,
> 
> +  HdaDxeLoadConfigDefault
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get Hda config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +HdaDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mHdaBlocks.Size;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Add Hda ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +HdaDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  )
> 
> +{
> 
> +  return AddComponentConfigBlocks (ConfigBlockTableAddress,
> &mHdaBlocks, 1);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.inf
> new file mode 100644
> index 0000000000..758499b95e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Hda/LibraryPrivate/DxeHdaPolicy
> Lib/DxeHdaPolicyLib.inf
> @@ -0,0 +1,31 @@
> +## @file
> 
> +# Component description file for the Hda policy library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeHdaPolicyLib
> 
> +FILE_GUID = B053EFE4-0868-4510-A71D-96A85CD16C77
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeHdaPolicyLib
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +ConfigBlockLib
> 
> +SiConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeHdaPolicyLib.c
> 
> +
> 
> +[Guids]
> 
> +gHdAudioDxeConfigGuid  ## CONSUMES
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component
  2021-02-01  1:36 ` [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge
> component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/HostBridge/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBrid
> geDataHob.h | 25 +++++++++++++++++++++++++
>  1 file changed, 25 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostBr
> idgeDataHob.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostB
> ridgeDataHob.h
> new file mode 100644
> index 0000000000..41e92da4df
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/HostBridge/IncludePrivate/HostB
> ridgeDataHob.h
> @@ -0,0 +1,25 @@
> +/** @file
> 
> +  The GUID definition for Host Bridge Data Hob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _HOST_BRIDGE_DATA_HOB_H_
> 
> +#define _HOST_BRIDGE_DATA_HOB_H_
> 
> +
> 
> +#include <Base.h>
> 
> +
> 
> +extern EFI_GUID gHostBridgeDataHobGuid;
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// Host Bridge Data Hob
> 
> +///
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE        EfiHobGuidType;                       ///< GUID Hob type
> structure for gSaDataHobGuid
> 
> +  UINT8                    EnableAbove4GBMmio;                   ///< 0=Disable above
> 4GB MMIO resource support, 1=Enable above 4GB MMIO resource support
> 
> +  BOOLEAN                  SkipPamLock;                          ///< 0=All PAM registers will
> be locked in System Agent code, 1=Do not lock PAM registers in System
> Agent code.
> 
> +  UINT8                    Rsvd1[2];                             ///< Reserved for future use
> 
> +} HOST_BRIDGE_DATA_HOB;
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component
  2021-02-01  1:36 ` [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/P2sb/IncludePrivate
>   * IpBlock/P2sb/Library
>   * IpBlock/P2sb/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchSbi
> AccessLib.h                             | 112
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2sb
> Regs.h                                   |  65
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegba
> rAccessLib/CpuRegbarAccessLib.c             | 494
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuRegba
> rAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf  |  35
> +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/
> PchPcrLib.c                               | 313
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLib/
> PeiDxeSmmPchPcrLib.inf                    |  35
> +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPch
> SbiAccessLib/PchSbiAccessLib.c            | 253
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmPch
> SbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf |  36
> ++++++++++++++++++++++++++++++++++++
>  8 files changed, 1343 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchS
> biAccessLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchS
> biAccessLib.h
> new file mode 100644
> index 0000000000..3fab933bbd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Library/PchS
> biAccessLib.h
> @@ -0,0 +1,112 @@
> +/** @file
> 
> +  Header file for PchSbiAccessLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SBI_ACCESS_LIB_H_
> 
> +#define _PCH_SBI_ACCESS_LIB_H_
> 
> +
> 
> +#include <Library/PchPcrLib.h>
> 
> +
> 
> +/**
> 
> +  PCH SBI opcode definitions
> 
> +**/
> 
> +typedef enum {
> 
> +  MemoryRead             = 0x0,
> 
> +  MemoryWrite            = 0x1,
> 
> +  PciConfigRead          = 0x4,
> 
> +  PciConfigWrite         = 0x5,
> 
> +  PrivateControlRead     = 0x6,
> 
> +  PrivateControlWrite    = 0x7,
> 
> +  GpioLockUnlock         = 0x13
> 
> +} PCH_SBI_OPCODE;
> 
> +
> 
> +/**
> 
> +  PCH SBI response status definitions
> 
> +**/
> 
> +typedef enum {
> 
> +  SBI_SUCCESSFUL          = 0,
> 
> +  SBI_UNSUCCESSFUL        = 1,
> 
> +  SBI_POWERDOWN           = 2,
> 
> +  SBI_MIXED               = 3,
> 
> +  SBI_INVALID_RESPONSE
> 
> +} PCH_SBI_RESPONSE;
> 
> +
> 
> +/**
> 
> +  Execute PCH SBI message
> 
> +  Take care of that there is no lock protection when using SBI programming
> in both POST time and SMI.
> 
> +  It will clash with POST time SBI programming when SMI happen.
> 
> +  Programmer MUST do the save and restore opration while using the
> PchSbiExecution inside SMI
> 
> +  to prevent from racing condition.
> 
> +  This function will reveal P2SB and hide P2SB if it's originally hidden. If more
> than one SBI access
> 
> +  needed, it's better to unhide the P2SB before calling and hide it back after
> done.
> 
> +
> 
> +  When the return value is "EFI_SUCCESS", the "Response" do not need to
> be checked as it would have been
> 
> +  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would
> provide additional information
> 
> +  when needed.
> 
> +
> 
> +  @param[in] Pid                        Port ID of the SBI message
> 
> +  @param[in] Offset                     Offset of the SBI message
> 
> +  @param[in] Opcode                     Opcode
> 
> +  @param[in] Posted                     Posted message
> 
> +  @param[in, out] Data32                Read/Write data
> 
> +  @param[out] Response                  Response
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_DEVICE_ERROR              Transaction fail
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid parameter
> 
> +  @retval EFI_TIMEOUT                   Timeout while waiting for response
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSbiExecution (
> 
> +  IN     PCH_SBI_PID                    Pid,
> 
> +  IN     UINT64                         Offset,
> 
> +  IN     PCH_SBI_OPCODE                 Opcode,
> 
> +  IN     BOOLEAN                        Posted,
> 
> +  IN OUT UINT32                         *Data32,
> 
> +  OUT    UINT8                          *Response
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Full function for executing PCH SBI message
> 
> +  Take care of that there is no lock protection when using SBI programming
> in both POST time and SMI.
> 
> +  It will clash with POST time SBI programming when SMI happen.
> 
> +  Programmer MUST do the save and restore opration while using the
> PchSbiExecution inside SMI
> 
> +  to prevent from racing condition.
> 
> +  This function will reveal P2SB and hide P2SB if it's originally hidden. If more
> than one SBI access
> 
> +  needed, it's better to unhide the P2SB before calling and hide it back after
> done.
> 
> +
> 
> +  When the return value is "EFI_SUCCESS", the "Response" do not need to
> be checked as it would have been
> 
> +  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would
> provide additional information
> 
> +  when needed.
> 
> +
> 
> +  @param[in] Pid                        Port ID of the SBI message
> 
> +  @param[in] Offset                     Offset of the SBI message
> 
> +  @param[in] Opcode                     Opcode
> 
> +  @param[in] Posted                     Posted message
> 
> +  @param[in] Fbe                        First byte enable
> 
> +  @param[in] Bar                        Bar
> 
> +  @param[in] Fid                        Function ID
> 
> +  @param[in, out] Data32                Read/Write data
> 
> +  @param[out] Response                  Response
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_DEVICE_ERROR              Transaction fail
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid parameter
> 
> +  @retval EFI_TIMEOUT                   Timeout while waiting for response
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSbiExecutionEx (
> 
> +  IN     PCH_SBI_PID                    Pid,
> 
> +  IN     UINT64                         Offset,
> 
> +  IN     PCH_SBI_OPCODE                 Opcode,
> 
> +  IN     BOOLEAN                        Posted,
> 
> +  IN     UINT16                         Fbe,
> 
> +  IN     UINT16                         Bar,
> 
> +  IN     UINT16                         Fid,
> 
> +  IN OUT UINT32                         *Data32,
> 
> +  OUT    UINT8                          *Response
> 
> +  );
> 
> +
> 
> +#endif // _PCH_SBI_ACCESS_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2s
> bRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2s
> bRegs.h
> new file mode 100644
> index 0000000000..44c71af719
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/IncludePrivate/Register/P2s
> bRegs.h
> @@ -0,0 +1,65 @@
> +/** @file
> 
> +  Register names for PCH P2SB device
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _P2SB_REGS_H_
> 
> +#define _P2SB_REGS_H_
> 
> +
> 
> +//
> 
> +// PCI to P2SB Bridge Registers
> 
> +//
> 
> +
> 
> +#define R_IO_APIC_MEM_INDEX_OFFSET                 0x00
> 
> +#define R_IO_APIC_MEM_DATA_OFFSET                  0x10
> 
> +#define V_P2SB_CFG_IBDF_BUS                        0
> 
> +#define V_P2SB_CFG_IBDF_DEV                        30
> 
> +#define V_P2SB_CFG_IBDF_FUNC                       7
> 
> +#define V_P2SB_CFG_HBDF_BUS                        0
> 
> +#define V_P2SB_CFG_HBDF_DEV                        30
> 
> +#define V_P2SB_CFG_HBDF_FUNC                       6
> 
> +
> 
> +//
> 
> +// Definition for SBI
> 
> +//
> 
> +#define R_P2SB_CFG_SBIADDR                         0xD0
> 
> +#define R_P2SB_CFG_SBIDATA                         0xD4
> 
> +#define R_P2SB_CFG_SBISTAT                         0xD8
> 
> +#define B_P2SB_CFG_SBISTAT_OPCODE                  0xFF00
> 
> +#define B_P2SB_CFG_SBISTAT_POSTED                  BIT7
> 
> +#define B_P2SB_CFG_SBISTAT_RESPONSE                0x0006
> 
> +#define N_P2SB_CFG_SBISTAT_RESPONSE                1
> 
> +#define B_P2SB_CFG_SBISTAT_INITRDY                 BIT0
> 
> +#define R_P2SB_CFG_SBIRID                          0xDA
> 
> +#define R_P2SB_CFG_SBIEXTADDR                      0xDC
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/CpuRegbarAccessLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/CpuRegbarAccessLib.c
> new file mode 100644
> index 0000000000..9d8851ac37
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/CpuRegbarAccessLib.c
> @@ -0,0 +1,494 @@
> +/** @file
> 
> +  CPU REGBAR ACCESS library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/CpuRegbarAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Definition for REGBAR address
> 
> +  The REGBAR address is used for the CPU IP's SB register access
> 
> +**/
> 
> +#define CPU_REGBAR_ADDRESS(Pid, Offset)
> (PcdGet32(PcdRegBarBaseAddress) | ((UINT8)(Pid) << 16) |
> (UINT16)(Offset))
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 8bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT64           REGBAR register value.
> 
> +**/
> 
> +UINT64
> 
> +CpuRegbarRead64 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  )
> 
> +{
> 
> +  UINT8    Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID)
> 
> +    return ((UINT64) MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset)) +
> LShiftU64 ((UINT64) MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset+4)),
> 32));
> 
> +  else
> 
> +    return INVALID_DATA_64;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset              Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT32           REGBAR register value.
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarRead32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  )
> 
> +{
> 
> +  UINT8    Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID)
> 
> +    return MmioRead32 (CPU_REGBAR_ADDRESS (Pid, Offset));
> 
> +  else
> 
> +    return INVALID_DATA_32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT16           REGBAR register value.
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarRead16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  )
> 
> +{
> 
> +  UINT16   DwOffset;
> 
> +  UINT32   Data32;
> 
> +  UINT16   Data16;
> 
> +
> 
> +  Data16 = 0;
> 
> +  Data32 = 0;
> 
> +  DwOffset = 0;
> 
> +
> 
> +  if (CpuSbDevicePid == INVALID_PID) {
> 
> +    return INVALID_DATA_16;
> 
> +  }
> 
> +  switch (Offset & 0x0003) {
> 
> +    case 0:
> 
> +      DwOffset = Offset;
> 
> +      break;
> 
> +    case 2:
> 
> +      DwOffset = Offset - 0x2;
> 
> +      break;
> 
> +  }
> 
> +  Data32 = MmioRead32 (CPU_REGBAR_ADDRESS (CpuSbDevicePid,
> DwOffset));
> 
> +  switch (Offset & 0x0003) {
> 
> +    case 0:
> 
> +      Data16 = (UINT16) Data32;
> 
> +      break;
> 
> +    case 2:
> 
> +      Data16 = (UINT16) (Data32 >> 16);
> 
> +      break;
> 
> +  }
> 
> +  return Data16;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read REGBAR register.
> 
> +  It returns REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of this Port ID
> 
> +
> 
> +  @retval     UINT8            REGBAR regsiter value
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarRead8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset
> 
> +  )
> 
> +{
> 
> +  UINT16   DwOffset;
> 
> +  UINT32   Data32;
> 
> +  UINT8    Data8;
> 
> +
> 
> +  DwOffset = 0;
> 
> +  Data32 = 0;
> 
> +  Data8 = 0;
> 
> +
> 
> +  if (CpuSbDevicePid == INVALID_PID)
> 
> +    return INVALID_DATA_8;
> 
> +  switch (Offset & 0x0003) {
> 
> +    case 0:
> 
> +      DwOffset = Offset;
> 
> +      break;
> 
> +    case 1:
> 
> +      DwOffset = Offset - 0x1;
> 
> +      break;
> 
> +    case 2:
> 
> +      DwOffset = Offset - 0x2;
> 
> +      break;
> 
> +    case 3:
> 
> +      DwOffset = Offset - 0x3;
> 
> +      break;
> 
> +  }
> 
> +  Data32 = MmioRead32 (CPU_REGBAR_ADDRESS (CpuSbDevicePid,
> DwOffset));
> 
> +  switch (Offset & 0x0003) {
> 
> +    case 0:
> 
> +      Data8 = (UINT8) Data32;
> 
> +      break;
> 
> +    case 1:
> 
> +      Data8 = (UINT8) (Data32 >> 8);
> 
> +      break;
> 
> +    case 2:
> 
> +      Data8 = (UINT8) (Data32 >> 16);
> 
> +      break;
> 
> +    case 3:
> 
> +      Data8 = (UINT8) (Data32 >> 24);
> 
> +      break;
> 
> +  }
> 
> +  return Data8;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 8bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT64           Value written to register
> 
> +**/
> 
> +UINT64
> 
> +CpuRegbarWrite64 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT64                            Data
> 
> +  )
> 
> +{
> 
> +  UINT8       Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID) {
> 
> +    MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset) + 4, (UINT32)
> RShiftU64 (Data, 32));
> 
> +    MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset), (UINT32) Data);
> 
> +    return Data;
> 
> +  }
> 
> +  else
> 
> +    return INVALID_DATA_64;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarWrite32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            Data
> 
> +  )
> 
> +{
> 
> +  UINT8    Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID)
> 
> +    return MmioWrite32 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
> 
> +  else
> 
> +    return INVALID_DATA_32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarWrite16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            Data
> 
> +  )
> 
> +{
> 
> +  UINT8    Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID)
> 
> +    return MmioWrite16 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
> 
> +  else
> 
> +    return INVALID_DATA_16;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  Data             Input Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarWrite8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             Data
> 
> +  )
> 
> +{
> 
> +  UINT8    Pid;
> 
> +
> 
> +  Pid = CpuSbDevicePid;
> 
> +  if (Pid != INVALID_PID)
> 
> +    return MmioWrite8 (CPU_REGBAR_ADDRESS (Pid, Offset), Data);
> 
> +  else
> 
> +    return INVALID_DATA_8;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarOr32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite32 (CpuSbDevicePid, Offset,
> CpuRegbarRead32(CpuSbDevicePid, Offset) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarOr16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite16 (CpuSbDevicePid, Offset,
> CpuRegbarRead16(CpuSbDevicePid, Offset) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarOr8(
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite8 (CpuSbDevicePid, Offset,
> CpuRegbarRead8(CpuSbDevicePid, Offset) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit data.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevice      CPU SB Device
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarAnd32 (
> 
> +  IN  CPU_SB_DEVICE_PID                     CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            AndData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite32 (CpuSbDevicePid, Offset, CpuRegbarRead32
> (CpuSbDevicePid, Offset) & AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit data.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevice      CPU SB Device
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarAnd16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            AndData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite16 (CpuSbDevicePid, Offset, CpuRegbarRead16
> (CpuSbDevicePid, Offset) & AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +Performs a bitwise AND of a 8-bit data.
> 
> +It programs REGBAR register and size in 1byte.
> 
> +The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +@param[in]  CpuSbDevice      CPU SB Device
> 
> +@param[in]  Offset           Register offset of Port ID.
> 
> +@param[in]  AndData          And Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +@retval     UINT8           Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarAnd8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             AndData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite8 (CpuSbDevicePid, Offset, CpuRegbarRead8
> (CpuSbDevicePid, Offset) & AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT32           Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +CpuRegbarAndThenOr32 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite32 (CpuSbDevicePid, Offset, (CpuRegbarRead32
> (CpuSbDevicePid, Offset) & AndData) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT16           Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +CpuRegbarAndThenOr16 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT16                            AndData,
> 
> +  IN  UINT16                            OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite16 (CpuSbDevicePid, Offset, (CpuRegbarRead16
> (CpuSbDevicePid, Offset) & AndData) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write REGBAR register.
> 
> +  It programs REGBAR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  CpuSbDevicePid   CPU SB Device Port ID
> 
> +  @param[in]  Offset           Register offset of Port ID.
> 
> +  @param[in]  AndData          AND Data. Must be the same size as Size
> parameter.
> 
> +  @param[in]  OrData           OR Data. Must be the same size as Size
> parameter.
> 
> +
> 
> +  @retval     UINT8            Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +CpuRegbarAndThenOr8 (
> 
> +  IN  CPU_SB_DEVICE_PID                 CpuSbDevicePid,
> 
> +  IN  UINT16                            Offset,
> 
> +  IN  UINT8                             AndData,
> 
> +  IN  UINT8                             OrData
> 
> +  )
> 
> +{
> 
> +  return CpuRegbarWrite8 (CpuSbDevicePid, Offset, (CpuRegbarRead8
> (CpuSbDevicePid, Offset) & AndData) | OrData);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
> new file mode 100644
> index 0000000000..596543f34f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmCpuReg
> barAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
> @@ -0,0 +1,35 @@
> +## @file
> 
> +# CPU REGBAR ACCESS Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmCpuRegbarAccessLib
> 
> +FILE_GUID = CA92B911-528D-4FBB-9A5A-7BC22AA1A6D0
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = CpuRegbarAccessLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdRegBarBaseAddress
> 
> +
> 
> +[Sources]
> 
> +CpuRegbarAccessLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PchPcrLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PchPcrLib.c
> new file mode 100644
> index 0000000000..c4f3740c86
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PchPcrLib.c
> @@ -0,0 +1,313 @@
> +/** @file
> 
> +  PCH PCR library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +#ifndef MDEPKG_NDEBUG
> 
> +/**
> 
> +  Checks if the offset is valid for a given memory access width. Offset must
> align to width size.
> 
> +
> 
> +  @param[in]  Offset  Offset of a register
> 
> +  @param[in]  Size    Size of memory access in bytes
> 
> +
> 
> +  @retval FALSE  Offset is not valid for a given memory access
> 
> +  @retval TRUE   Offset is valid
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +PchIsPcrOffsetValid (
> 
> +  IN UINT32  Offset,
> 
> +  IN UINTN   Size
> 
> +  )
> 
> +{
> 
> +  if (!IsP2sb20bPcrSupported ()) {
> 
> +    if (((Offset & (Size - 1)) != 0) || (Offset > 0xFFFF)) {
> 
> +      DEBUG ((DEBUG_ERROR, "PCR offset error. Invalid Offset: %x Size: %x",
> Offset, Size));
> 
> +      return FALSE;
> 
> +    } else {
> 
> +      return TRUE;
> 
> +    }
> 
> +  } else {
> 
> +    if (((Offset & (Size - 1)) != 0) || (Offset > 0xFFFFF)) {
> 
> +      DEBUG ((DEBUG_ERROR, "PCR offset error. Invalid Offset: %x Size: %x",
> Offset, Size));
> 
> +      return FALSE;
> 
> +    } else {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +}
> 
> +#endif
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT32       PCR register value.
> 
> +**/
> 
> +UINT32
> 
> +PchPcrRead32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  )
> 
> +{
> 
> +#ifndef MDEPKG_NDEBUG
> 
> +  ASSERT (PchIsPcrOffsetValid (Offset, 4));
> 
> +#endif
> 
> +  return MmioRead32 (PCH_PCR_ADDRESS (Pid, Offset));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT16       PCR register value.
> 
> +**/
> 
> +UINT16
> 
> +PchPcrRead16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  )
> 
> +{
> 
> +#ifndef MDEPKG_NDEBUG
> 
> +  ASSERT (PchIsPcrOffsetValid (Offset, 2));
> 
> +#endif
> 
> +  return MmioRead16 (PCH_PCR_ADDRESS (Pid, Offset));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read PCR register.
> 
> +  It returns PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of this Port ID
> 
> +
> 
> +  @retval UINT8        PCR register value
> 
> +**/
> 
> +UINT8
> 
> +PchPcrRead8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset
> 
> +  )
> 
> +{
> 
> +  return MmioRead8 (PCH_PCR_ADDRESS (Pid, Offset));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval UINT32       Value written to register
> 
> +**/
> 
> +UINT32
> 
> +PchPcrWrite32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            Data
> 
> +  )
> 
> +{
> 
> +#ifndef MDEPKG_NDEBUG
> 
> +  ASSERT (PchIsPcrOffsetValid (Offset, 4));
> 
> +#endif
> 
> +  MmioWrite32 (PCH_PCR_ADDRESS (Pid, Offset), Data);
> 
> +
> 
> +  return Data;
> 
> +
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT16      Value written to register
> 
> +**/
> 
> +UINT16
> 
> +PchPcrWrite16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT16                            Data
> 
> +  )
> 
> +{
> 
> +#ifndef MDEPKG_NDEBUG
> 
> +  ASSERT (PchIsPcrOffsetValid (Offset, 2));
> 
> +#endif
> 
> +  MmioWrite16 (PCH_PCR_ADDRESS (Pid, Offset), Data);
> 
> +
> 
> +  return Data;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  Data     Input Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT8       Value written to register
> 
> +**/
> 
> +UINT8
> 
> +PchPcrWrite8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT8                             Data
> 
> +  )
> 
> +{
> 
> +
> 
> +  MmioWrite8 (PCH_PCR_ADDRESS (Pid, Offset), Data);
> 
> +
> 
> +  return Data;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT32      Value written to register
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +PchPcrAndThenOr32 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  )
> 
> +{
> 
> +  return PchPcrWrite32 (Pid, Offset, (PchPcrRead32 (Pid, Offset) & AndData)
> | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register and read back.
> 
> +  The read back ensures the PCR cycle is completed before next operation.
> 
> +  It programs PCR register and size in 4bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT32      Value read back from the register
> 
> +**/
> 
> +UINT32
> 
> +PchPcrAndThenOr32WithReadback (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT32                            AndData,
> 
> +  IN  UINT32                            OrData
> 
> +  )
> 
> +{
> 
> +  PchPcrWrite32 (Pid, Offset, (PchPcrRead32 (Pid, Offset) & AndData) |
> OrData);
> 
> +  return PchPcrRead32 (Pid, Offset);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 2bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval UINT16       Value written to register
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +PchPcrAndThenOr16 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT16                            AndData,
> 
> +  IN  UINT16                            OrData
> 
> +  )
> 
> +{
> 
> +  return PchPcrWrite16 (Pid, Offset, (PchPcrRead16 (Pid, Offset) & AndData)
> | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write PCR register.
> 
> +  It programs PCR register and size in 1bytes.
> 
> +  The Offset should not exceed 0xFFFF and must be aligned with size.
> 
> +
> 
> +  @param[in]  Pid      Port ID
> 
> +  @param[in]  Offset   Register offset of Port ID.
> 
> +  @param[in]  AndData  AND Data. Must be the same size as Size parameter.
> 
> +  @param[in]  OrData   OR Data. Must be the same size as Size parameter.
> 
> +
> 
> +  @retval  UINT8       Value written to register
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +PchPcrAndThenOr8 (
> 
> +  IN  PCH_SBI_PID                       Pid,
> 
> +  IN  UINT32                            Offset,
> 
> +  IN  UINT8                             AndData,
> 
> +  IN  UINT8                             OrData
> 
> +  )
> 
> +{
> 
> +  return PchPcrWrite8 (Pid, Offset, (PchPcrRead8 (Pid, Offset) & AndData) |
> OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH IP PID number
> 
> +
> 
> +  @param[in]  IpEnum   PCH IP in PCH_IP_PID_ENUM
> 
> +
> 
> +  @retval     0        PID of this IP is not supported
> 
> +              !0       PID of the IP.
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PchPcrGetPid (
> 
> +  PCH_IP_PID_ENUM  IpEnum
> 
> +  )
> 
> +{
> 
> +  switch (IpEnum) {
> 
> +    case PchIpDmi:
> 
> +      return PID_DMI;
> 
> +    case PchIpIclk:
> 
> +      return PID_ICLK;
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return PCH_INVALID_PID;
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PeiDxeSmmPchPcrLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PeiDxeSmmPchPcrLib.inf
> new file mode 100644
> index 0000000000..2efeba374f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/Library/PeiDxeSmmPchPcrLi
> b/PeiDxeSmmPchPcrLib.inf
> @@ -0,0 +1,35 @@
> +## @file
> 
> +# PCH PCR Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchPcrLib
> 
> +FILE_GUID = 117C8D19-445B-46BF-B624-109F63709375
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchPcrLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PchInfoLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchPcrLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PchSbiAccessLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PchSbiAccessLib.c
> new file mode 100644
> index 0000000000..8017dee3aa
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PchSbiAccessLib.c
> @@ -0,0 +1,253 @@
> +/** @file
> 
> +  PCH SBI access library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchSbiAccessLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/P2sbRegs.h>
> 
> +
> 
> +/**
> 
> +  Execute PCH SBI message
> 
> +  Take care of that there is no lock protection when using SBI programming
> in both POST time and SMI.
> 
> +  It will clash with POST time SBI programming when SMI happen.
> 
> +  Programmer MUST do the save and restore opration while using the
> PchSbiExecution inside SMI
> 
> +  to prevent from racing condition.
> 
> +  This function will reveal P2SB and hide P2SB if it's originally hidden. If more
> than one SBI access
> 
> +  needed, it's better to unhide the P2SB before calling and hide it back after
> done.
> 
> +
> 
> +  When the return value is "EFI_SUCCESS", the "Response" do not need to
> be checked as it would have been
> 
> +  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would
> provide additional information
> 
> +  when needed.
> 
> +
> 
> +  @param[in] Pid                        Port ID of the SBI message
> 
> +  @param[in] Offset                     Offset of the SBI message
> 
> +  @param[in] Opcode                     Opcode
> 
> +  @param[in] Posted                     Posted message
> 
> +  @param[in, out] Data32                Read/Write data
> 
> +  @param[out] Response                  Response
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_DEVICE_ERROR              Transaction fail
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid parameter
> 
> +  @retval EFI_TIMEOUT                   Timeout while waiting for response
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSbiExecution (
> 
> +  IN     PCH_SBI_PID                    Pid,
> 
> +  IN     UINT64                         Offset,
> 
> +  IN     PCH_SBI_OPCODE                 Opcode,
> 
> +  IN     BOOLEAN                        Posted,
> 
> +  IN OUT UINT32                         *Data32,
> 
> +  OUT    UINT8                          *Response
> 
> +  )
> 
> +{
> 
> +  return PchSbiExecutionEx ( Pid,
> 
> +           Offset,
> 
> +           Opcode,
> 
> +           Posted,
> 
> +           0x000F,
> 
> +           0x0000,
> 
> +           0x0000,
> 
> +           Data32,
> 
> +           Response
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Full function for executing PCH SBI message
> 
> +  Take care of that there is no lock protection when using SBI programming
> in both POST time and SMI.
> 
> +  It will clash with POST time SBI programming when SMI happen.
> 
> +  Programmer MUST do the save and restore opration while using the
> PchSbiExecution inside SMI
> 
> +  to prevent from racing condition.
> 
> +  This function will reveal P2SB and hide P2SB if it's originally hidden. If more
> than one SBI access
> 
> +  needed, it's better to unhide the P2SB before calling and hide it back after
> done.
> 
> +
> 
> +  When the return value is "EFI_SUCCESS", the "Response" do not need to
> be checked as it would have been
> 
> +  SBI_SUCCESS. If the return value is "EFI_DEVICE_ERROR", then this would
> provide additional information
> 
> +  when needed.
> 
> +
> 
> +  @param[in] Pid                        Port ID of the SBI message
> 
> +  @param[in] Offset                     Offset of the SBI message
> 
> +  @param[in] Opcode                     Opcode
> 
> +  @param[in] Posted                     Posted message
> 
> +  @param[in] Fbe                        First byte enable
> 
> +  @param[in] Bar                        Bar
> 
> +  @param[in] Fid                        Function ID
> 
> +  @param[in, out] Data32                Read/Write data
> 
> +  @param[out] Response                  Response
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_DEVICE_ERROR              Transaction fail
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid parameter
> 
> +  @retval EFI_TIMEOUT                   Timeout while waiting for response
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSbiExecutionEx (
> 
> +  IN     PCH_SBI_PID                    Pid,
> 
> +  IN     UINT64                         Offset,
> 
> +  IN     PCH_SBI_OPCODE                 Opcode,
> 
> +  IN     BOOLEAN                        Posted,
> 
> +  IN     UINT16                         Fbe,
> 
> +  IN     UINT16                         Bar,
> 
> +  IN     UINT16                         Fid,
> 
> +  IN OUT UINT32                         *Data32,
> 
> +  OUT    UINT8                          *Response
> 
> +  )
> 
> +{
> 
> +  UINT64                                P2sbBase;
> 
> +  UINTN                                 Timeout;
> 
> +  UINT16                                SbiStat;
> 
> +
> 
> +  //
> 
> +  // Check opcode valid
> 
> +  //
> 
> +  switch (Opcode) {
> 
> +    case MemoryRead:
> 
> +    case MemoryWrite:
> 
> +    case PciConfigRead:
> 
> +    case PciConfigWrite:
> 
> +    case PrivateControlRead:
> 
> +    case PrivateControlWrite:
> 
> +    case GpioLockUnlock:
> 
> +      break;
> 
> +    default:
> 
> +      return EFI_INVALID_PARAMETER;
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  P2sbBase = P2sbPciCfgBase ();
> 
> +  if (PciSegmentRead16 (P2sbBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_DEVICE_ERROR;
> 
> +  }
> 
> +  ///
> 
> +  /// BWG Section 2.2.1
> 
> +  /// 1. Poll P2SB PCI offset D8h[0] = 0b
> 
> +  /// Make sure the previous opeartion is completed.
> 
> +  ///
> 
> +  Timeout = 0xFFFFFFF;
> 
> +  while (Timeout > 0) {
> 
> +    SbiStat = PciSegmentRead16 (P2sbBase + R_P2SB_CFG_SBISTAT);
> 
> +    if ((SbiStat & B_P2SB_CFG_SBISTAT_INITRDY) == 0) {
> 
> +      break;
> 
> +    }
> 
> +    Timeout--;
> 
> +  }
> 
> +  if (Timeout == 0) {
> 
> +    return EFI_TIMEOUT;
> 
> +  }
> 
> +  //
> 
> +  // Initial Response status
> 
> +  //
> 
> +  *Response = SBI_INVALID_RESPONSE;
> 
> +  SbiStat   = 0;
> 
> +  ///
> 
> +  /// 2. Write P2SB PCI offset D0h[31:0] with Address and Destination Port ID
> 
> +  ///
> 
> +  PciSegmentWrite32 (P2sbBase + R_P2SB_CFG_SBIADDR, (UINT32) ((Pid <<
> 24) | (UINT16) Offset));
> 
> +  ///
> 
> +  /// 3. Write P2SB PCI offset DCh[31:0] with extended address, which is
> expected to be 0 in CNL PCH.
> 
> +  ///
> 
> +  PciSegmentWrite32 (P2sbBase + R_P2SB_CFG_SBIEXTADDR, (UINT32)
> RShiftU64 (Offset, 16));
> 
> +  ///
> 
> +  /// 5. Set P2SB PCI offset D8h[15:8] = 00000110b for read
> 
> +  ///    Set P2SB PCI offset D8h[15:8] = 00000111b for write
> 
> +  //
> 
> +  // Set SBISTAT[15:8] to the opcode passed in
> 
> +  // Set SBISTAT[7] to the posted passed in
> 
> +  //
> 
> +  PciSegmentAndThenOr16 (
> 
> +    (P2sbBase + R_P2SB_CFG_SBISTAT),
> 
> +    (UINT16) ~(B_P2SB_CFG_SBISTAT_OPCODE |
> B_P2SB_CFG_SBISTAT_POSTED),
> 
> +    (UINT16) ((Opcode << 8) | (Posted << 7))
> 
> +    );
> 
> +  ///
> 
> +  /// 6. Write P2SB PCI offset DAh[15:0] = F000h
> 
> +  ///
> 
> +  //
> 
> +  // Set RID[15:0] = Fbe << 12 | Bar << 8 | Fid
> 
> +  //
> 
> +  PciSegmentWrite16 (
> 
> +    (P2sbBase + R_P2SB_CFG_SBIRID),
> 
> +    (((Fbe & 0x000F) << 12) | ((Bar & 0x0007) << 8) | (Fid & 0x00FF))
> 
> +    );
> 
> +
> 
> +  switch (Opcode) {
> 
> +    case MemoryWrite:
> 
> +    case PciConfigWrite:
> 
> +    case PrivateControlWrite:
> 
> +    case GpioLockUnlock:
> 
> +      ///
> 
> +      /// 4. Write P2SB PCI offset D4h[31:0] with the intended data accordingly
> 
> +      ///
> 
> +      PciSegmentWrite32 ((P2sbBase + R_P2SB_CFG_SBIDATA), *Data32);
> 
> +      break;
> 
> +    default:
> 
> +      ///
> 
> +      /// 4. Write P2SB PCI offset D4h[31:0] with dummy data such as 0,
> 
> +      /// because all D0-DFh register range must be touched in CNL PCH
> 
> +      /// for a successful SBI transaction.
> 
> +      ///
> 
> +      PciSegmentWrite32 ((P2sbBase + R_P2SB_CFG_SBIDATA), 0);
> 
> +      break;
> 
> +  }
> 
> +  ///
> 
> +  /// 7. Set P2SB PCI offset D8h[0] = 1b, Poll P2SB PCI offset D8h[0] = 0b
> 
> +  ///
> 
> +  //
> 
> +  // Set SBISTAT[0] = 1b, trigger the SBI operation
> 
> +  //
> 
> +  PciSegmentOr16 (P2sbBase + R_P2SB_CFG_SBISTAT, (UINT16)
> B_P2SB_CFG_SBISTAT_INITRDY);
> 
> +  //
> 
> +  // Poll SBISTAT[0] = 0b, Polling for Busy bit
> 
> +  //
> 
> +  Timeout = 0xFFFFFFF;
> 
> +  while (Timeout > 0) {
> 
> +    SbiStat = PciSegmentRead16 (P2sbBase + R_P2SB_CFG_SBISTAT);
> 
> +    if ((SbiStat & B_P2SB_CFG_SBISTAT_INITRDY) == 0) {
> 
> +      break;
> 
> +    }
> 
> +    Timeout--;
> 
> +  }
> 
> +  if (Timeout == 0) {
> 
> +    //
> 
> +    // If timeout, it's fatal error.
> 
> +    //
> 
> +    return EFI_TIMEOUT;
> 
> +  } else {
> 
> +    ///
> 
> +    /// 8. Check if P2SB PCI offset D8h[2:1] = 00b for successful transaction
> 
> +    ///
> 
> +    *Response = (UINT8) ((SbiStat & B_P2SB_CFG_SBISTAT_RESPONSE) >>
> N_P2SB_CFG_SBISTAT_RESPONSE);
> 
> +    if (*Response == SBI_SUCCESSFUL) {
> 
> +      switch (Opcode) {
> 
> +        case MemoryRead:
> 
> +        case PciConfigRead:
> 
> +        case PrivateControlRead:
> 
> +          ///
> 
> +          /// 9. Read P2SB PCI offset D4h[31:0] for SBI data
> 
> +          ///
> 
> +          *Data32 = PciSegmentRead32 (P2sbBase + R_P2SB_CFG_SBIDATA);
> 
> +          break;
> 
> +        default:
> 
> +          break;
> 
> +      }
> 
> +      return EFI_SUCCESS;
> 
> +    } else if (*Response == SBI_POWERDOWN) {
> 
> +      return EFI_NO_RESPONSE;
> 
> +    } else {
> 
> +      return EFI_DEVICE_ERROR;
> 
> +    }
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
> new file mode 100644
> index 0000000000..4199a0a6c7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/P2sb/LibraryPrivate/PeiDxeSmmP
> chSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
> @@ -0,0 +1,36 @@
> +## @file
> 
> +# PCH SBI access library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchSbiAccessLib
> 
> +FILE_GUID = 96ECB0FB-A975-4DC8-B88A-D90C3378CE87
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchSbiAccessLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchPciBdfLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchSbiAccessLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component
  2021-02-01  1:36 ` [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component Heng Luo
@ 2021-02-04  3:54   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:54 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/PchDmi/IncludePrivate
>   * IpBlock/PchDmi/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/Pch
> DmiLib.h                             | 175
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PchDmi14.c                   |  50
> ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PchDmi14.h                   |  34
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PchDmiLib.c                  | 269
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PchDmiWithS3Lib.c            |  73
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PeiDxeSmmPchDmiLib.inf       |  42
> ++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSmm
> PchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf |  41
> +++++++++++++++++++++++++++++++++++++++++
>  7 files changed, 684 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/Pc
> hDmiLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/Pc
> hDmiLib.h
> new file mode 100644
> index 0000000000..77db69c75a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/IncludePrivate/Library/Pc
> hDmiLib.h
> @@ -0,0 +1,175 @@
> +/** @file
> 
> +  Header file for PchDmiLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_DMI_LIB_H_
> 
> +#define _PCH_DMI_LIB_H_
> 
> +
> 
> +/**
> 
> +  This function checks if DMI Secured Register Lock (SRL) is set
> 
> +
> 
> +  @retval SRL state
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchDmiLocked (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCH TCO base address.
> 
> +
> 
> +  @retval Address                   Address of TCO base address.
> 
> +**/
> 
> +UINT16
> 
> +PchDmiGetTcoBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI generic IO range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +  @param[in] RangeIndex                 Index of choosen range
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcGenIoRange (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  UINT32                            Length,
> 
> +  IN  UINT32                            RangeIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI eSPI CS1# generic IO range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetEspiCs1GenIoRange (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  UINT32                            Length
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI memory range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcMemRange (
> 
> +  IN  UINT32                            Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# memory range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetEspiCs1MemRange (
> 
> +  IN  UINT32                            Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if Boot BIOS Strap is set for SPI.
> 
> +
> 
> +  @retval TRUE                Boot BIOS Strap set for SPI
> 
> +  @retval FALSE               Boot BIOS Strap set for LPC/eSPI
> 
> +**/
> 
> +BOOLEAN
> 
> +PchDmiIsBootBiosStrapSetForSpi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH BIOS range decoding in DMI
> 
> +  Please check EDS for detail of BiosDecodeEnable bit definition.
> 
> +    bit 15: F8-FF Enable
> 
> +    bit 14: F0-F8 Enable
> 
> +    bit 13: E8-EF Enable
> 
> +    bit 12: E0-E8 Enable
> 
> +    bit 11: D8-DF Enable
> 
> +    bit 10: D0-D7 Enable
> 
> +    bit  9: C8-CF Enable
> 
> +    bit  8: C0-C7 Enable
> 
> +    bit  7: Legacy F Segment Enable
> 
> +    bit  6: Legacy E Segment Enable
> 
> +    bit  5: Reserved
> 
> +    bit  4: Reserved
> 
> +    bit  3: 70-7F Enable
> 
> +    bit  2: 60-6F Enable
> 
> +    bit  1: 50-5F Enable
> 
> +    bit  0: 40-4F Enable
> 
> +
> 
> +  @param[in] BiosDecodeEnable           Bios decode enable setting.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetBiosDecodeEnable (
> 
> +  IN  UINT16                            BiosDecodeEnable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI IO decode ranges in DMI
> 
> +  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
> 
> +  Bit  12: FDD range
> 
> +  Bit 9:8: LPT range
> 
> +  Bit 6:4: ComB range
> 
> +  Bit 2:0: ComA range
> 
> +
> 
> +  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit
> settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcIoDecodeRanges (
> 
> +  IN  UINT16                            LpcIoDecodeRanges
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI IO enable decoding in DMI
> 
> +
> 
> +  @param[in] LpcIoEnableDecoding        LPC/eSPI IO enable decoding bit
> settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcIoEnable (
> 
> +  IN  UINT16                            LpcIoEnableDecoding
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configure PCH DMI Lock
> 
> +**/
> 
> +VOID
> 
> +PchDmiSetLockWithS3BootScript (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set BIOS interface Lock-Down
> 
> +**/
> 
> +VOID
> 
> +PchDmiSetBiosLockDownWithS3BootScript (
> 
> +  VOID
> 
> +  );
> 
> +#endif // _PCH_DMI_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.c
> new file mode 100644
> index 0000000000..60bc29c431
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.c
> @@ -0,0 +1,50 @@
> +/** @file
> 
> +  This file contains functions for PCH DMI SIP14
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchDmiLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Register/PchDmiRegs.h>
> 
> +#include <Register/PchDmi14Regs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +/**
> 
> +  This function checks if DMI SIP14 Secured Register Lock (SRL) is set
> 
> +
> 
> +  @retval SRL state
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchDmi14Locked (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((PchPcrRead32 (PID_DMI, R_PCH_DMI14_PCR_DMIC) &
> B_PCH_DMI14_PCR_DMIC_SRL) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> + Secure Register Lock data
> 
> +
> 
> + @param[out] SrlRegOffset        Register offset holding Secure Register Lock
> setting
> 
> + @param[out] SrlRegMask          Mask for Secure Register Lock setting
> 
> +**/
> 
> +VOID
> 
> +PchDmi14SrlRegData (
> 
> +  OUT UINT16  *SrlRegOffset,
> 
> +  OUT UINT32  *SrlRegMask
> 
> +  )
> 
> +{
> 
> +  *SrlRegMask = B_PCH_DMI14_PCR_DMIC_SRL;
> 
> +  *SrlRegOffset = R_PCH_DMI14_PCR_DMIC;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.h
> new file mode 100644
> index 0000000000..4c19ad82d7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmi14.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  Internal header file for PCH DMI library for SIP14
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef __PCH_DMI_14_H__
> 
> +#define __PCH_DMI_14_H__
> 
> +
> 
> +#include <Library/PchDmiLib.h>
> 
> +
> 
> +/**
> 
> +  This function checks if DMI SIP14 Secured Register Lock (SRL) is set
> 
> +
> 
> +  @retval SRL state
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchDmi14Locked (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> + Secure Register Lock data
> 
> +
> 
> + @param[out] SrlRegOffset        Register offset holding Secure Register Lock
> setting
> 
> + @param[out] SrlRegMask          Mask for Secure Register Lock setting
> 
> +**/
> 
> +VOID
> 
> +PchDmi14SrlRegData (
> 
> +  OUT UINT16  *SrlRegOffset,
> 
> +  OUT UINT32  *SrlRegMask
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiLib.c
> new file mode 100644
> index 0000000000..972e5145aa
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiLib.c
> @@ -0,0 +1,269 @@
> +/** @file
> 
> +  PCH DMI library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchDmiLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchDmiRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +
> 
> +#include "PchDmi14.h"
> 
> +
> 
> +/**
> 
> +  This function checks if DMI Secured Register Lock (SRL) is set
> 
> +
> 
> +  @retval SRL state
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchDmiLocked (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return IsPchDmi14Locked ();
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH TCO base address.
> 
> +
> 
> +  @retval Address                   Address of TCO base address.
> 
> +**/
> 
> +UINT16
> 
> +PchDmiGetTcoBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Read "TCO Base Address" PCR[DMI] + 2778h[15:5]
> 
> +  //
> 
> +  return (PchPcrRead16 (PID_DMI, R_PCH_DMI_PCR_TCOBASE) &
> B_PCH_DMI_PCR_TCOBASE_TCOBA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI generic IO range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +  @param[in] RangeIndex                 Index of choosen range
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcGenIoRange (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  UINT32                            Length,
> 
> +  IN  UINT32                            RangeIndex
> 
> +  )
> 
> +{
> 
> +  return EFI_UNSUPPORTED;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI eSPI CS1# generic IO range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetEspiCs1GenIoRange (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  UINT32                            Length
> 
> +  )
> 
> +{
> 
> +  return EFI_UNSUPPORTED;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI memory range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcMemRange (
> 
> +  IN  UINT32                            Address
> 
> +  )
> 
> +{
> 
> +  if (IsPchDmiLocked ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "%a Error. DMI is locked.\n", __FUNCTION__));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Program LPC Memory Range, PCR[DMI] + 2740h to the same value
> programmed in LPC/eSPI PCI Offset 98h.
> 
> +  //
> 
> +  PchPcrWrite32 (
> 
> +    PID_DMI, R_PCH_DMI_PCR_LPCGMR,
> 
> +    (Address | B_LPC_CFG_LGMR_LMRD_EN)
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# memory range decoding in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetEspiCs1MemRange (
> 
> +  IN  UINT32                            Address
> 
> +  )
> 
> +{
> 
> +  if (IsPchDmiLocked ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "%a Error. DMI is locked.\n", __FUNCTION__));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Program LPC Memory Range, PCR[DMI] + 27C0h to the same value
> programmed in eSPI PCI Offset A8h.
> 
> +  //
> 
> +  PchPcrWrite32 (
> 
> +    PID_DMI, R_PCH_DMI_PCR_SEGMR,
> 
> +    (Address | B_LPC_CFG_LGMR_LMRD_EN)
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if Boot BIOS Strap is set for SPI.
> 
> +
> 
> +  @retval TRUE                Boot BIOS Strap set for SPI
> 
> +  @retval FALSE               Boot BIOS Strap set for LPC/eSPI
> 
> +**/
> 
> +BOOLEAN
> 
> +PchDmiIsBootBiosStrapSetForSpi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Check General Control and Status (GCS) [10]
> 
> +  // '0': SPI
> 
> +  // '1': LPC/eSPI
> 
> +  //
> 
> +  return ((PchPcrRead32 (PID_DMI, R_PCH_DMI_PCR_GCS) &
> B_PCH_DMI_PCR_BBS) != B_PCH_DMI_PCR_BBS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH BIOS range decoding in DMI
> 
> +  Please check EDS for detail of BiosDecodeEnable bit definition.
> 
> +    bit 15: F8-FF Enable
> 
> +    bit 14: F0-F8 Enable
> 
> +    bit 13: E8-EF Enable
> 
> +    bit 12: E0-E8 Enable
> 
> +    bit 11: D8-DF Enable
> 
> +    bit 10: D0-D7 Enable
> 
> +    bit  9: C8-CF Enable
> 
> +    bit  8: C0-C7 Enable
> 
> +    bit  7: Legacy F Segment Enable
> 
> +    bit  6: Legacy E Segment Enable
> 
> +    bit  5: Reserved
> 
> +    bit  4: Reserved
> 
> +    bit  3: 70-7F Enable
> 
> +    bit  2: 60-6F Enable
> 
> +    bit  1: 50-5F Enable
> 
> +    bit  0: 40-4F Enable
> 
> +
> 
> +  @param[in] BiosDecodeEnable           Bios decode enable setting.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetBiosDecodeEnable (
> 
> +  IN  UINT16                            BiosDecodeEnable
> 
> +  )
> 
> +{
> 
> +  if (IsPchDmiLocked ()) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // program LPC BIOS Decode Enable, PCR[DMI] + 2744h to the same value
> programmed in LPC or SPI Offset D8h.
> 
> +  //
> 
> +  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCBDE, BiosDecodeEnable);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI IO decode ranges in DMI
> 
> +  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
> 
> +  Bit  12: FDD range
> 
> +  Bit 9:8: LPT range
> 
> +  Bit 6:4: ComB range
> 
> +  Bit 2:0: ComA range
> 
> +
> 
> +  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit
> settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcIoDecodeRanges (
> 
> +  IN  UINT16                            LpcIoDecodeRanges
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // This cycle decoding is only allowed to set when DMI is not locked.
> 
> +  //
> 
> +  if (IsPchDmiLocked ()) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // program LPC I/O Decode Ranges, PCR[DMI] + 2770h[15:0] to the same
> value programmed in LPC/eSPI PCI offset 80h.
> 
> +  //
> 
> +  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCIOD,
> LpcIoDecodeRanges);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI IO enable decoding in DMI
> 
> +
> 
> +  @param[in] LpcIoEnableDecoding        LPC/eSPI IO enable decoding bit
> settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchDmiSetLpcIoEnable (
> 
> +  IN  UINT16                            LpcIoEnableDecoding
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // This cycle decoding is only allowed to set when DMI is not locked.
> 
> +  //
> 
> +  if (IsPchDmiLocked ()) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // program LPC I/O Decode Ranges, PCR[DMI] + 2774h[15:0] to the same
> value programmed in LPC/eSPI PCI offset 82h.
> 
> +  //
> 
> +  PchPcrWrite16 (PID_DMI, R_PCH_DMI_PCR_LPCIOE,
> LpcIoEnableDecoding);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiWithS3Lib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiWithS3Lib.c
> new file mode 100644
> index 0000000000..7d6801ee57
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PchDmiWithS3Lib.c
> @@ -0,0 +1,73 @@
> +/** @file
> 
> +  PCH DMI library with S3 boot script support.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchDmiRegs.h>
> 
> +
> 
> +#include "PchDmi14.h"
> 
> +
> 
> +/**
> 
> +  Configure DMI Lock
> 
> +**/
> 
> +VOID
> 
> +PchDmiSetLockWithS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  Data32Or;
> 
> +  UINT32  Data32And;
> 
> +  UINT16  Address;
> 
> +
> 
> +  Data32And = 0xFFFFFFFF;
> 
> +
> 
> +  PchDmi14SrlRegData (&Address, &Data32Or);
> 
> +
> 
> +  PchPcrAndThenOr32 (
> 
> +    PID_DMI, Address,
> 
> +    Data32And,
> 
> +    Data32Or
> 
> +    );
> 
> +  PCH_PCR_BOOT_SCRIPT_READ_WRITE (
> 
> +    S3BootScriptWidthUint32,
> 
> +    PID_DMI, Address,
> 
> +    &Data32Or,
> 
> +    &Data32And
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set BIOS interface Lock-Down
> 
> +**/
> 
> +VOID
> 
> +PchDmiSetBiosLockDownWithS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  Data32Or;
> 
> +  UINT32  Data32And;
> 
> +
> 
> +  //
> 
> +  // Set BIOS Lock-Down (BILD)
> 
> +  // When set, prevents GCS.BBS from being changed
> 
> +  //
> 
> +  Data32And = 0xFFFFFFFF;
> 
> +  Data32Or = B_PCH_DMI_PCR_BILD;
> 
> +  PchPcrAndThenOr32 (PID_DMI, R_PCH_DMI_PCR_GCS, Data32And,
> Data32Or);
> 
> +  PCH_PCR_BOOT_SCRIPT_READ_WRITE (
> 
> +    S3BootScriptWidthUint32,
> 
> +    PID_DMI, R_PCH_DMI_PCR_GCS,
> 
> +    &Data32Or,
> 
> +    &Data32And
> 
> +    );
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiLib.inf
> new file mode 100644
> index 0000000000..d33310dd76
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiLib.inf
> @@ -0,0 +1,42 @@
> +## @file
> 
> +#  Component description file for the PeiDxeSmmPchDmiLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION                    = 0x00010017
> 
> +BASE_NAME                      = PeiDxeSmmPchDmiLib
> 
> +FILE_GUID                      = 067DC1C4-2668-4F06-9921-307514B66B34
> 
> +VERSION_STRING                 = 1.0
> 
> +MODULE_TYPE                    = BASE
> 
> +LIBRARY_CLASS                  = PchDmiLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +#  VALID_ARCHITECTURES           = IA32 X64
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PchInfoLib
> 
> +  PchPcrLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  PchDmiLib.c
> 
> +  PchDmi14.c
> 
> +  PchDmi14.h
> 
> +
> 
> +[Guids]
> 
> +  gPchDmiConfigGuid         ## CONSUMES
> 
> +
> 
> +[Pcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
> new file mode 100644
> index 0000000000..9381a7b5fd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PchDmi/LibraryPrivate/PeiDxeSm
> mPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
> @@ -0,0 +1,41 @@
> +## @file
> 
> +#  Component description file for the PeiDxeSmmPchDmiWithS3Lib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION                    = 0x00010017
> 
> +BASE_NAME                      = PeiDxeSmmPchDmiWithS3Lib
> 
> +FILE_GUID                      = 32CCA047-6AF0-46FF-83DA-32BA62484075
> 
> +VERSION_STRING                 = 1.0
> 
> +MODULE_TYPE                    = BASE
> 
> +LIBRARY_CLASS                  = PchDmiWithS3Lib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +#  VALID_ARCHITECTURES           = IA32 X64
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PchPcrLib
> 
> +  PchInfoLib
> 
> +  S3BootScriptLib
> 
> +  PchDmiLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  PchDmiWithS3Lib.c
> 
> +  PchDmi14.h
> 
> +
> 
> +[pcd]
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component
  2021-02-01  1:36 ` [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component Heng Luo
@ 2021-02-04  3:55   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:55 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/PcieRp/IncludePrivate
>   * IpBlock/PcieRp/Library
>   * IpBlock/PcieRp/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/DxeP
> chPcieRpPolicyLib.h                            |   55 ++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PciEx
> pressHelpersLib.h                             |  173
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/PcieR
> pLib.h                                        |  109
> ++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/Pci
> eSipRegs.h                                     |   45 ++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/B
> asePcieHelperLib.c                             |  315
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib/B
> asePcieHelperLib.inf                           |   37 +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcie
> RpLib/PchPcieRpLib.c                              |   69
> ++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcie
> RpLib/PchPcieRpLibInternal.h                      |   20 +++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcie
> RpLib/PchPcieRpLibVer2.c                          |  128
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPcie
> RpLib/PeiDxeSmmPchPcieRpLibVer2.inf               |   39 +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieR
> pPolicyLib/DxePchPcieRpPolicyLib.c              |  179
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcieR
> pPolicyLib/DxePchPcieRpPolicyLib.inf            |   30 ++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHel
> persLibrary/PciExpressHelpersLibrary.c        | 1997
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHel
> persLibrary/PciExpressHelpersLibrary.h        |   40 ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpressHel
> persLibrary/PeiDxeSmmPciExpressHelpersLib.inf |   49
> ++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpL
> ib/PcieClientRpLib.c                          |  247
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientRpL
> ib/PcieClientRpLib.inf                        |   43 +++++++++++++++++++
>  17 files changed, 3575 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Dx
> ePchPcieRpPolicyLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Dx
> ePchPcieRpPolicyLib.h
> new file mode 100644
> index 0000000000..1dea61388e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Dx
> ePchPcieRpPolicyLib.h
> @@ -0,0 +1,55 @@
> +/** @file
> 
> +  DXE PcieRp policy library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_PCH_PCIERP_POLICY_LIB_H_
> 
> +#define _DXE_PCH_PCIERP_POLICY_LIB_H_
> 
> +
> 
> +#include <Protocol/PchPolicy.h>
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for Pch PCIE RP
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +LoadPchPcieRpDxeConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Print PCIE_RP_DXE_CONFIG.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +PchPcieRpDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PchPcieRp config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +PchPcieRpDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Add PchPcieRp ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchPcieRpDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> ExpressHelpersLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> ExpressHelpersLib.h
> new file mode 100644
> index 0000000000..d7ca34dc38
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> ExpressHelpersLib.h
> @@ -0,0 +1,173 @@
> +/** @file
> 
> +  Header file for PCI Express helpers library
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCI_EXPRESS_HELPERS_LIB_H_
> 
> +#define _PCI_EXPRESS_HELPERS_LIB_H_
> 
> +
> 
> +#include <PchPolicyCommon.h>
> 
> +#include <Library/PcieRpLib.h>
> 
> +
> 
> +typedef enum {
> 
> +  TpoScale2us,
> 
> +  TpoScale10us,
> 
> +  TpoScale100us,
> 
> +  TpoScaleMax
> 
> +} T_PO_SCALE;
> 
> +//
> 
> +// This structure keeps segment:bus:device:function coordinates of a PCIe
> device
> 
> +// in a single variable. PcieCap is offset to PCI Express capabilities.
> 
> +//
> 
> +typedef struct {
> 
> +  UINT32 Seg : 8;
> 
> +  UINT32 Bus : 8;
> 
> +  UINT32 Dev : 5;
> 
> +  UINT32 Func : 3;
> 
> +  UINT32 PcieCap : 8;
> 
> +} SBDF;
> 
> +
> 
> +/*
> 
> +  Converts Tpower_on from value:scale notation to microseconds
> 
> +
> 
> +  @param[in] TpoScale   T power on scale
> 
> +  @param[in] TpoValue   T power on value
> 
> +
> 
> +  @retval    number of microseconds
> 
> +*/
> 
> +UINT32
> 
> +TpoToUs (
> 
> +  UINT32 TpoScale,
> 
> +  UINT32 TpoValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +PCIe controller Sku.
> 
> +**/
> 
> +
> 
> +typedef enum {
> 
> +  EnumPchPcie = 0,
> 
> +  EnumiTbtPcie = 1,
> 
> +  EnumCpuPcie = 2,
> 
> +  EnumPciSkuMax = 3
> 
> +} PCI_SKU;
> 
> +
> 
> +/*
> 
> +  Initializes the following features in rootport and devices behind it:
> 
> +  Maximum Payload Size (generic)
> 
> +  Rootport packet split (proprietary)
> 
> +  EonOfInterrupt forwarding (proprietary)
> 
> +  Common Clock Configuration (generic)
> 
> +
> 
> +  Generic: any code written according to PCIE Express base specification can
> do that.
> 
> +  Proprietary: code uses registers and features that are specific to Intel
> silicon
> 
> +  and probably only this Reference Code knows how to handle that.
> 
> +
> 
> +  If OEM implemented generic feature enabling in his platform code or
> trusts Operating System
> 
> +  to do it, then those features can be deleted from here.
> 
> +
> 
> +  CCC requires link retrain, which takes a while. CCC must happen before
> L0s/L1 programming.
> 
> +  If there was guarantee no code would access PCI while links retrain, it
> would be possible to skip this waiting
> 
> +
> 
> +  @param[in] RpSegment  address of rootport on PCIe
> 
> +  @param[in] RpBus      address of rootport on PCIe
> 
> +  @param[in] RpDevice   address of rootport on PCIe
> 
> +  @param[in] RpFunction address of rootport on PCIe
> 
> +  @param[in] BusMin     minimum Bus number that can be assigned below
> this rootport
> 
> +  @param[in] BusMax     maximum Bus number that can be assigned below
> this rootport
> 
> +*/
> 
> +VOID
> 
> +RootportDownstreamConfiguration (
> 
> +  UINT8                     RpSegment,
> 
> +  UINT8                     RpBus,
> 
> +  UINT8                     RpDevice,
> 
> +  UINT8                     RpFunction,
> 
> +  UINT8                     BusMin,
> 
> +  UINT8                     BusMax,
> 
> +  PCI_SKU                   PciSku
> 
> +  );
> 
> +
> 
> +/*
> 
> +  Configures the following power-management related features in rootport
> and devices behind it:
> 
> +  LTR limit (generic)
> 
> +  LTR override (proprietary)
> 
> +  Clock Power Management (generic)
> 
> +  L1 substates (generic except for the override table)
> 
> +  L1.LOW substate (proprietary)
> 
> +  L0s and L1 (generic)
> 
> +
> 
> +  Generic: any code written according to PCIE Express base specification can
> do that.
> 
> +  Proprietary: code uses registers and features that are specific to Intel
> silicon
> 
> +  and probably only this Reference Code knows how to handle that.
> 
> +
> 
> +  If OEM implemented generic feature enabling in his platform code or
> trusts Operating System
> 
> +  to do it, then those features can be deleted from here.
> 
> +
> 
> +  @param[in] RpSegment                address of rootport on PCIe
> 
> +  @param[in] RpBus                    address of rootport on PCIe
> 
> +  @param[in] RpDevice                 address of rootport on PCIe
> 
> +  @param[in] RpFunction               address of rootport on PCIe
> 
> +  @param[in] BusMin                   minimal Bus number that can be assigned
> below this rootport
> 
> +  @param[in] BusMax                   maximum Bus number that can be assigned
> below this rootport
> 
> +  @param[in] PcieRpCommonConfig       a pointer to Pcie Root Port Common
> Config
> 
> +  @param[in] AspmOverrideTableSize    size of override array
> 
> +  @param[in] AspmOverrideTable        array of device that need exceptions
> in configuration
> 
> +*/
> 
> +VOID
> 
> +RootportDownstreamPmConfiguration (
> 
> +  UINT8                               RpSegment,
> 
> +  UINT8                               RpBus,
> 
> +  UINT8                               RpDevice,
> 
> +  UINT8                               RpFunction,
> 
> +  UINT8                               BusMin,
> 
> +  UINT8                               BusMax,
> 
> +  PCIE_ROOT_PORT_COMMON_CONFIG        *PcieRpCommonConfig,
> 
> +  UINT32                              AspmOverrideTableSize,
> 
> +  PCH_PCIE_DEVICE_OVERRIDE            *AspmOverrideTable
> 
> +  );
> 
> +
> 
> +typedef struct {
> 
> +  UINT32 MaxSnoopLatencyValue         : 10;
> 
> +  UINT32 MaxSnoopLatencyScale         : 3;
> 
> +  UINT32 MaxNoSnoopLatencyValue       : 10;
> 
> +  UINT32 MaxNoSnoopLatencyScale       : 3;
> 
> +  UINT32 Reserved                     : 6;
> 
> +} LTR_LIMIT;
> 
> +
> 
> +/**
> 
> +  Checks if given PCI device is capable of Latency Tolerance Reporting
> 
> +
> 
> +  @param[in] Sbdf            device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval TRUE if yes
> 
> +**/
> 
> +BOOLEAN
> 
> +IsLtrCapable (
> 
> +  SBDF Sbdf
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns combination of two LTR override values
> 
> +  The resulting LTR override separately chooses stricter limits for snoop and
> nosnoop
> 
> +
> 
> +  @param[in] LtrA      LTR override values to be combined
> 
> +  @param[in] LtrB      LTR override values to be combined
> 
> +
> 
> +  @retval LTR override value
> 
> +**/
> 
> +LTR_OVERRIDE
> 
> +CombineLtr (
> 
> +  LTR_OVERRIDE LtrA,
> 
> +  LTR_OVERRIDE LtrB
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Extended Virtual Channel Configuration
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT16 CapOffset;
> 
> +  UINT8  ExtVcCount;
> 
> +} MULTI_VC_SUPPORT;
> 
> +
> 
> +#endif // _PCI_EXPRESS_HELPERS_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> eRpLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> eRpLib.h
> new file mode 100644
> index 0000000000..ed75e438c7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Library/Pci
> eRpLib.h
> @@ -0,0 +1,109 @@
> +/** @file
> 
> +  Header file for PCH PCI Express helpers library
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCIE_RP_LIB_
> 
> +#define _PCIE_RP_LIB_
> 
> +
> 
> +#include <PchPolicyCommon.h>
> 
> +
> 
> +typedef struct {
> 
> +  UINT32 MaxSnoopLatencyValue         : 10;
> 
> +  UINT32 MaxSnoopLatencyScale         : 3;
> 
> +  UINT32 MaxSnoopLatencyRequirement   : 1;
> 
> +  UINT32 MaxNoSnoopLatencyValue       : 10;
> 
> +  UINT32 MaxNoSnoopLatencyScale       : 3;
> 
> +  UINT32 MaxNoSnoopLatencyRequirement : 1;
> 
> +  UINT32 ForceOverride                : 1;
> 
> +} LTR_OVERRIDE;
> 
> +
> 
> +/**
> 
> +  Get PCIe port number for enabled Root Port.
> 
> +
> 
> +  @param[in] RpBase    Root Port pci segment base address
> 
> +
> 
> +  @retval Root Port number (1 based)
> 
> +**/
> 
> +UINT32
> 
> +PciePortNum (
> 
> +  IN     UINT64  RpBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PCIe root port index
> 
> +  @param[in] RpBase    Root Port pci segment base address
> 
> +  @return Root Port index (0 based)
> 
> +**/
> 
> +UINT32
> 
> +PciePortIndex (
> 
> +  IN     UINT64  RpBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks whether PHY lane power gating is enabled on the
> port.
> 
> +
> 
> +  @param[in] RpBase                 Root Port base address
> 
> +
> 
> +  @retval TRUE                      PHY power gating is enabled
> 
> +  @retval FALSE                     PHY power gating disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +PcieIsPhyLanePgEnabled (
> 
> +  IN     UINT64  RpBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures Root Port packet split.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] Mps                            maximum packet size
> 
> +**/
> 
> +VOID
> 
> +ConfigureRpPacketSplit (
> 
> +  UINT64 RpBase,
> 
> +  UINT8  Mps
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures LTR override in Root Port's proprietary registers.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] LtrConfig                      Root Port LTR configuration
> 
> +  @param[in] AspmOverride                   combination of LTR override values
> from all devices under this Root Port
> 
> +**/
> 
> +VOID
> 
> +ConfigureRpLtrOverride (
> 
> +  UINT64           RpBase,
> 
> +  UINT32           DevNum,
> 
> +  LTR_OVERRIDE     *TreeLtr,
> 
> +  PCIE_LTR_CONFIG  *LtrConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function configures EOI message forwarding for PCIe port.
> 
> +  If there's an IoAPIC behind this port, forwarding will be enabled
> 
> +  Otherwise it will be disabled to minimize bus traffic
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] IoApicPresent  TRUE if there's IoAPIC behind this Root Port
> 
> +**/
> 
> +VOID
> 
> +ConfigureEoiForwarding (
> 
> +  UINT64   RpBase,
> 
> +  BOOLEAN  IoApicPresent
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures proprietary parts of L1 substates configuration in Root Port
> 
> +
> 
> +  @param[in] RpSbdf       segment:bus:device:function coordinates of Root
> Port
> 
> +  @param[in] LtrCapable   TRUE if Root Port is LTR capable
> 
> +**/
> 
> +VOID
> 
> +L1ssProprietaryConfiguration (
> 
> +  UINT64  RpBase,
> 
> +  BOOLEAN LtrCapable
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/P
> cieSipRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/P
> cieSipRegs.h
> new file mode 100644
> index 0000000000..1fc470b8ba
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/IncludePrivate/Register/P
> cieSipRegs.h
> @@ -0,0 +1,45 @@
> +/** @file
> 
> +  Register names for PCIe SIP specific registers
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +  Definitions beginning with "R_" are registers
> 
> +  Definitions beginning with "B_" are bits within registers
> 
> +  Definitions beginning with "V_" are meaningful values within the bits
> 
> +  Definitions beginning with "S_" are register size
> 
> +  Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +  Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +  Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +  This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +  Register name without ComponentName applies to all components.
> 
> +  Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +  This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +  MEM - MMIO space register of subsystem.
> 
> +  IO  - IO space register of subsystem.
> 
> +  PCR - Private configuration register of subsystem.
> 
> +  CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +  Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCIE_SIP_RP_REGS_H_
> 
> +#define _PCIE_SIP_RP_REGS_H_
> 
> +
> 
> +#include <PcieRegs.h>
> 
> +
> 
> +#define R_PCIE_CFG_CCFG                               0xD0
> 
> +#define B_PCIE_CFG_CCFG_UNRS                          (BIT6 | BIT5 | BIT4)
> 
> +#define N_PCIE_CFG_CCFG_UNRS                          4
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.c
> new file mode 100644
> index 0000000000..1b3e629431
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.c
> @@ -0,0 +1,315 @@
> +/** @file
> 
> +  This file contains routines that support PCI Express initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <PcieRegs.h>
> 
> +
> 
> +#define ASPM_L1_NO_LIMIT 0xFF
> 
> +#define LINK_RETRAIN_WAIT_TIME 1000 // microseconds
> 
> +
> 
> +/**
> 
> +  Finds the Offset to a given Capabilities ID
> 
> +  Each capability has an ID and a pointer to next Capability, so they form a
> linked list.
> 
> +  This function walks the list of Capabilities present in device's pci cfg. If
> requested capability
> 
> +  can be found, its offset is returned.
> 
> +  If the capability can't be found or if device doesn't exist, function returns 0
> 
> +  CAPID list:
> 
> +    0x01 = PCI Power Management Interface
> 
> +    0x04 = Slot Identification
> 
> +    0x05 = MSI Capability
> 
> +    0x10 = PCI Express Capability
> 
> +
> 
> +  @param[in] DeviceBase           device's base address
> 
> +  @param[in] CapId                CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found (this includes situation where device
> doesn't exit)
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PcieBaseFindCapId (
> 
> +  IN UINT64  DeviceBase,
> 
> +  IN UINT8   CapId
> 
> +  )
> 
> +{
> 
> +  UINT8  CapHeaderOffset;
> 
> +  UINT8  CapHeaderId;
> 
> +  UINT16 Data16;
> 
> +  //
> 
> +  // We do not explicitly check if device exists to save time and avoid
> unnecessary PCI access
> 
> +  // If the device doesn't exist, check for CapHeaderId != 0xFF will fail and
> function will return offset 0
> 
> +  //
> 
> +  if ((PciSegmentRead8 (DeviceBase + PCI_PRIMARY_STATUS_OFFSET) &
> EFI_PCI_STATUS_CAPABILITY) == 0x00) {
> 
> +    ///
> 
> +    /// Function has no capability pointer
> 
> +    ///
> 
> +    return 0;
> 
> +  } else {
> 
> +    ///
> 
> +    /// Check the header layout to determine the Offset of Capabilities
> Pointer Register
> 
> +    ///
> 
> +    if ((PciSegmentRead8 (DeviceBase + PCI_HEADER_TYPE_OFFSET) &
> HEADER_LAYOUT_CODE) == (HEADER_TYPE_CARDBUS_BRIDGE)) {
> 
> +      ///
> 
> +      /// If CardBus bridge, start at Offset 0x14
> 
> +      ///
> 
> +      CapHeaderOffset = EFI_PCI_CARDBUS_BRIDGE_CAPABILITY_PTR;
> 
> +    } else {
> 
> +      ///
> 
> +      /// Otherwise, start at Offset 0x34
> 
> +      ///
> 
> +      CapHeaderOffset = PCI_CAPBILITY_POINTER_OFFSET;
> 
> +    }
> 
> +    ///
> 
> +    /// Get Capability Header, A pointer value of 00h is used to indicate the
> last capability in the list.
> 
> +    ///
> 
> +    CapHeaderId     = 0;
> 
> +    CapHeaderOffset = PciSegmentRead8 (DeviceBase + CapHeaderOffset) &
> ((UINT8) ~(BIT0 | BIT1));
> 
> +    while (CapHeaderOffset != 0 && CapHeaderId != 0xFF) {
> 
> +      Data16 = PciSegmentRead16 (DeviceBase + CapHeaderOffset);
> 
> +      CapHeaderId = (UINT8)(Data16 & 0xFF);
> 
> +      if (CapHeaderId == CapId) {
> 
> +        if (CapHeaderOffset > PCI_MAXLAT_OFFSET) {
> 
> +          ///
> 
> +          /// Return valid capability offset
> 
> +          ///
> 
> +          return CapHeaderOffset;
> 
> +        } else {
> 
> +          ASSERT ((FALSE));
> 
> +          return 0;
> 
> +        }
> 
> +      }
> 
> +      ///
> 
> +      /// Each capability must be DWORD aligned.
> 
> +      /// The bottom two bits of all pointers (including the initial pointer at
> 34h) are reserved
> 
> +      /// and must be implemented as 00b although software must mask them
> to allow for future uses of these bits.
> 
> +      ///
> 
> +      CapHeaderOffset = (UINT8)(Data16 >> 8);
> 
> +    }
> 
> +    return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Find the Offset to a given Capabilities ID
> 
> +  CAPID list:
> 
> +    0x01 = PCI Power Management Interface
> 
> +    0x04 = Slot Identification
> 
> +    0x05 = MSI Capability
> 
> +    0x10 = PCI Express Capability
> 
> +
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT8
> 
> +PcieFindCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT8   CapId
> 
> +  )
> 
> +{
> 
> +  UINT64 DeviceBase;
> 
> +
> 
> +  DeviceBase = PCI_SEGMENT_LIB_ADDRESS (Segment, Bus, Device,
> Function, 0);
> 
> +  return PcieBaseFindCapId (DeviceBase, CapId);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Search and return the offset of desired Pci Express Capability ID
> 
> +  CAPID list:
> 
> +    0x0001 = Advanced Error Reporting Capability
> 
> +    0x0002 = Virtual Channel Capability
> 
> +    0x0003 = Device Serial Number Capability
> 
> +    0x0004 = Power Budgeting Capability
> 
> +
> 
> +  @param[in] DeviceBase           device base address
> 
> +  @param[in] CapId                Extended CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found, this includes situation where device
> doesn't exist
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT16
> 
> +PcieBaseFindExtendedCapId (
> 
> +  IN UINT64  DeviceBase,
> 
> +  IN UINT16  CapId
> 
> +  )
> 
> +{
> 
> +  UINT16  CapHeaderOffset;
> 
> +  UINT16  CapHeaderId;
> 
> +  ///
> 
> +  /// Start to search at Offset 0x100
> 
> +  /// Get Capability Header, A pointer value of 00h is used to indicate the last
> capability in the list.
> 
> +  ///
> 
> +  CapHeaderId     = 0;
> 
> +  CapHeaderOffset = R_PCIE_CFG_EXCAP_OFFSET;
> 
> +  while (CapHeaderOffset != 0 && CapHeaderId != MAX_UINT16) {
> 
> +    CapHeaderId = PciSegmentRead16 (DeviceBase + CapHeaderOffset);
> 
> +    if (CapHeaderId == CapId) {
> 
> +      return CapHeaderOffset;
> 
> +    }
> 
> +    ///
> 
> +    /// Each capability must be DWORD aligned.
> 
> +    /// The bottom two bits of all pointers are reserved and must be
> implemented as 00b
> 
> +    /// although software must mask them to allow for future uses of these
> bits.
> 
> +    ///
> 
> +    CapHeaderOffset = (PciSegmentRead16 (DeviceBase + CapHeaderOffset
> + 2) >> 4) & ((UINT16) ~(BIT0 | BIT1));
> 
> +  }
> 
> +
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Search and return the offset of desired Pci Express Capability ID
> 
> +  CAPID list:
> 
> +    0x0001 = Advanced Error Reporting Capability
> 
> +    0x0002 = Virtual Channel Capability
> 
> +    0x0003 = Device Serial Number Capability
> 
> +    0x0004 = Power Budgeting Capability
> 
> +
> 
> +  @param[in] Segment              Pci Segment Number
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +  @param[in] CapId                Extended CAPID to search for
> 
> +
> 
> +  @retval 0                       CAPID not found, this includes situation where device
> doesn't exist
> 
> +  @retval Other                   CAPID found, Offset of desired CAPID
> 
> +**/
> 
> +UINT16
> 
> +PcieFindExtendedCapId (
> 
> +  IN UINT8   Segment,
> 
> +  IN UINT8   Bus,
> 
> +  IN UINT8   Device,
> 
> +  IN UINT8   Function,
> 
> +  IN UINT16  CapId
> 
> +  )
> 
> +{
> 
> +  UINT64  DeviceBase;
> 
> +
> 
> +  DeviceBase = PCI_SEGMENT_LIB_ADDRESS (Segment, Bus, Device,
> Function, 0);
> 
> +  return PcieBaseFindExtendedCapId (DeviceBase, CapId);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if PCI device at given address exists
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +
> 
> +  @retval TRUE if exists
> 
> +**/
> 
> +BOOLEAN
> 
> +IsDevicePresent (
> 
> +  UINT64 Base
> 
> +  )
> 
> +{
> 
> +  if (PciSegmentRead16 (Base) == 0xFFFF) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if device is a multifunction device
> 
> +  Besides comparing Multifunction bit (BIT7) it checks if contents of
> HEADER_TYPE register
> 
> +  make sense (header != 0xFF) to prevent false positives when called on
> devices which do not exist
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +
> 
> +  @retval TRUE if multifunction; FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsMultifunctionDevice (
> 
> +  UINT64 Base
> 
> +  )
> 
> +{
> 
> +  UINT8 HeaderType;
> 
> +  HeaderType = PciSegmentRead8(Base + PCI_HEADER_TYPE_OFFSET);
> 
> +  if ((HeaderType == 0xFF) || ((HeaderType &
> HEADER_TYPE_MULTI_FUNCTION) == 0)) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks device's Slot Clock Configuration
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +  @param[in] PcieCapOffset   devices Pci express capability list register
> offset
> 
> +
> 
> +  @retval TRUE when device uses slot clock, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +GetScc (
> 
> +  UINT64    Base,
> 
> +  UINT8     PcieCapOffset
> 
> +  )
> 
> +{
> 
> +  return !!(PciSegmentRead16 (Base + PcieCapOffset +
> R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_SCC);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Common Clock Configuration bit for given device.
> 
> +
> 
> +  @param[in] PcieCapOffset   devices Pci express capability list register
> offset
> 
> +  @param[in] Base            device's base address
> 
> +**/
> 
> +VOID
> 
> +EnableCcc (
> 
> +  UINT64    Base,
> 
> +  UINT8     PcieCapOffset
> 
> +  )
> 
> +{
> 
> +  PciSegmentOr8 (Base + PcieCapOffset + R_PCIE_LCTL_OFFSET,
> B_PCIE_LCTL_CCC);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Retrains link behind given device.
> 
> +  It only makes sense to call it for downstream ports. If called for upstream
> port nothing will happen.
> 
> +  If WaitUntilDone is TRUE function will wait until link retrain had finished,
> otherwise it will return immediately.
> 
> +  Link must finish retrain before software can access the device on the other
> side. If it's not going to access it
> 
> +  then considerable time can be saved by not waiting here.
> 
> +
> 
> +  @param[in] Base             device's base address
> 
> +  @param[in] PcieCapOffset    devices Pci express capability list register
> offset
> 
> +  @param[in] WaitUntilDone    when TRUE, function waits until link has
> retrained
> 
> +**/
> 
> +VOID
> 
> +RetrainLink (
> 
> +  UINT64  Base,
> 
> +  UINT8   PcieCapOffset,
> 
> +  BOOLEAN WaitUntilDone
> 
> +  )
> 
> +{
> 
> +  UINT16 LinkTraining;
> 
> +  UINT32 TimeoutUs;
> 
> +
> 
> +  TimeoutUs = LINK_RETRAIN_WAIT_TIME;
> 
> +  //
> 
> +  // Before triggering link retrain make sure it's not already retraining.
> Otherwise
> 
> +  // settings recently entered in LCTL register might go unnoticed
> 
> +  //
> 
> +  do {
> 
> +    LinkTraining = (PciSegmentRead16 (Base + PcieCapOffset +
> R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_LT);
> 
> +    TimeoutUs--;
> 
> +  } while (LinkTraining && (TimeoutUs != 0));
> 
> +
> 
> +  PciSegmentOr8 (Base + PcieCapOffset + R_PCIE_LCTL_OFFSET,
> B_PCIE_LCTL_RL);
> 
> +
> 
> +  TimeoutUs = LINK_RETRAIN_WAIT_TIME;
> 
> +  if (WaitUntilDone) {
> 
> +    do {
> 
> +      LinkTraining = (PciSegmentRead16 (Base + PcieCapOffset +
> R_PCIE_LSTS_OFFSET) & B_PCIE_LSTS_LT);
> 
> +      TimeoutUs--;
> 
> +    } while (LinkTraining && (TimeoutUs != 0));
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.inf
> new file mode 100644
> index 0000000000..458a540859
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/BasePcieHelperLib
> /BasePcieHelperLib.inf
> @@ -0,0 +1,37 @@
> +## @file
> 
> +# Component description file for the BasePcieHelperLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = BasePcieHelperLib
> 
> +FILE_GUID = 568F5812-A9A8-4A4A-AD4D-471DD5F0BC11
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = BasePcieHelperLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +BasePcieHelperLib.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLib.c
> new file mode 100644
> index 0000000000..153c073093
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLib.c
> @@ -0,0 +1,69 @@
> +/** @file
> 
> +  PCIE root port library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +#include "PchPcieRpLibInternal.h"
> 
> +
> 
> +/**
> 
> +  Gets pci segment base address of PCIe root port.
> 
> +
> 
> +  @param RpIndex    Root Port Index (0 based)
> 
> +  @return PCIe port base address.
> 
> +**/
> 
> +UINT64
> 
> +PchPcieBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  )
> 
> +{
> 
> +  return PchPcieRpPciCfgBase (RpIndex);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Determines whether L0s is supported on current stepping.
> 
> +
> 
> +  @return TRUE if L0s is supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsPcieL0sSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Some early PCH steppings require Native ASPM to be disabled due to
> hardware issues:
> 
> +   - RxL0s exit causes recovery
> 
> +   - Disabling PCIe L0s capability disables L1
> 
> +  Use this function to determine affected steppings.
> 
> +
> 
> +  @return TRUE if Native ASPM is supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsPcieNativeAspmSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PchIsPcieL0sSupported ();
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibInternal.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibInternal.h
> new file mode 100644
> index 0000000000..1766cff618
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibInternal.h
> @@ -0,0 +1,20 @@
> +/** @file
> 
> +  PCIE root port library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_PCIE_RP_LIB_INTERNAL_H_
> 
> +#define _PCH_PCIE_RP_LIB_INTERNAL_H_
> 
> +
> 
> +typedef struct {
> 
> +  UINT8 DevNum;
> 
> +  UINT8 Pid;
> 
> +  UINT8 RpNumBase;
> 
> +} PCH_PCIE_CONTROLLER_INFO;
> 
> +
> 
> +#endif
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibVer2.c
> new file mode 100644
> index 0000000000..df90a87df7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PchPcieRpLibVer2.c
> @@ -0,0 +1,128 @@
> +/** @file
> 
> +  PCIE root port library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <PchBdfAssignment.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +#include "PchPcieRpLibInternal.h"
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_CONTROLLER_INFO
> mPchPcieControllerInfo[] = {
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1,  PID_SPA,  0 },
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5,  PID_SPB,  4 },
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9,  PID_SPC,  8 },
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13, PID_SPD, 12 },
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17, PID_SPE, 16 }, //
> PCH-H only
> 
> +  { PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21, PID_SPF, 20 }  // PCH-
> H only
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get Pch Pcie Root Port Device and Function Number by Root Port physical
> Number
> 
> +
> 
> +  @param[in]  RpNumber              Root port physical number. (0-based)
> 
> +  @param[out] RpDev                 Return corresponding root port device
> number.
> 
> +  @param[out] RpFun                 Return corresponding root port function
> number.
> 
> +
> 
> +  @retval     EFI_SUCCESS           Root port device and function is retrieved
> 
> +  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetPchPcieRpDevFun (
> 
> +  IN  UINTN   RpNumber,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  )
> 
> +{
> 
> +  UINTN       Index;
> 
> +  UINTN       FuncIndex;
> 
> +  UINT32      PciePcd;
> 
> +
> 
> +  if (RpNumber >= GetPchMaxPciePortNum ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "GetPchPcieRpDevFun invalid RpNumber %x",
> RpNumber));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Index = RpNumber / PCH_PCIE_CONTROLLER_PORTS;
> 
> +  FuncIndex = RpNumber - mPchPcieControllerInfo[Index].RpNumBase;
> 
> +  *RpDev = mPchPcieControllerInfo[Index].DevNum;
> 
> +  PciePcd = PchPcrRead32 (mPchPcieControllerInfo[Index].Pid,
> R_SPX_PCR_PCD);
> 
> +  *RpFun = (PciePcd >> (FuncIndex * S_SPX_PCR_PCD_RP_FIELD)) &
> B_SPX_PCR_PCD_RP1FN;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Root Port physical Number by Pch Pcie Root Port Device and Function
> Number
> 
> +
> 
> +  @param[in]  RpDev                 Root port device number.
> 
> +  @param[in]  RpFun                 Root port function number.
> 
> +  @param[out] RpNumber              Return corresponding physical Root Port
> index (0-based)
> 
> +
> 
> +  @retval     EFI_SUCCESS           Physical root port is retrieved
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetPchPcieRpNumber (
> 
> +  IN  UINTN   RpDev,
> 
> +  IN  UINTN   RpFun,
> 
> +  OUT UINTN   *RpNumber
> 
> +  )
> 
> +{
> 
> +  UINT64 RpBase;
> 
> +
> 
> +  RpBase = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> DEFAULT_PCI_BUS_NUMBER_PCH, RpDev, RpFun, 0);
> 
> +  *RpNumber = (PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LCAP) >>
> N_PCH_PCIE_CFG_LCAP_PN) -1;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function returns PID according to PCIe controller index
> 
> +
> 
> +  @param[in] ControllerIndex     PCIe controller index
> 
> +
> 
> +  @retval PCH_SBI_PID    Returns PID for SBI Access
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PchGetPcieControllerSbiPid (
> 
> +  IN UINT32  ControllerIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (ControllerIndex < ARRAY_SIZE (mPchPcieControllerInfo));
> 
> +  return mPchPcieControllerInfo[ControllerIndex].Pid;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function returns PID according to Root Port Number
> 
> +
> 
> +  @param[in] RpIndex     Root Port Index (0-based)
> 
> +
> 
> +  @retval PCH_SBI_PID    Returns PID for SBI Access
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +GetRpSbiPid (
> 
> +  IN UINTN  RpIndex
> 
> +  )
> 
> +{
> 
> +  return PchGetPcieControllerSbiPid ((UINT32) (RpIndex /
> PCH_PCIE_CONTROLLER_PORTS));
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
> new file mode 100644
> index 0000000000..4fc217581b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/Library/PeiDxeSmmPchPci
> eRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
> @@ -0,0 +1,39 @@
> +## @file
> 
> +# PCIE root port Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchPcieRpLib
> 
> +FILE_GUID = B522981C-E0C5-4E04-A82A-C61D4F0B2C75
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchPcieRpLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchInfoLib
> 
> +PchPcrLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchPcieRpLib.c
> 
> +PchPcieRpLibVer2.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcie
> RpPolicyLib/DxePchPcieRpPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPci
> eRpPolicyLib/DxePchPcieRpPolicyLib.c
> new file mode 100644
> index 0000000000..577e436e32
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPci
> eRpPolicyLib/DxePchPcieRpPolicyLib.c
> @@ -0,0 +1,179 @@
> +/** @file
> 
> +  This file provides services for PcieRp policy function
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <PchPcieRpConfig.h>
> 
> +
> 
> +#define PCI_CLASS_NETWORK             0x02
> 
> +#define PCI_CLASS_NETWORK_ETHERNET    0x00
> 
> +#define PCI_CLASS_NETWORK_OTHER       0x80
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE
> mPcieDeviceTable[] = {
> 
> +  //
> 
> +  // Intel PRO/Wireless
> 
> +  //
> 
> +  { 0x8086, 0x422b, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x422c, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x4238, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x4239, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel WiMAX/WiFi Link
> 
> +  //
> 
> +  { 0x8086, 0x0082, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0085, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0083, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0084, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0086, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0087, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0088, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0089, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x008F, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0090, 0xff, 0xff, 0xff, PchPcieAspmL1, PchPcieL1L2Override, 0,
> 0, 0, 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Crane Peak WLAN NIC
> 
> +  //
> 
> +  { 0x8086, 0x08AE, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x08AF, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Crane Peak w/BT WLAN NIC
> 
> +  //
> 
> +  { 0x8086, 0x0896, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0897, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Kelsey Peak WiFi, WiMax
> 
> +  //
> 
> +  { 0x8086, 0x0885, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0886, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Centrino Wireless-N 105
> 
> +  //
> 
> +  { 0x8086, 0x0894, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0895, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Centrino Wireless-N 135
> 
> +  //
> 
> +  { 0x8086, 0x0892, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0893, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Centrino Wireless-N 2200
> 
> +  //
> 
> +  { 0x8086, 0x0890, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0891, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Centrino Wireless-N 2230
> 
> +  //
> 
> +  { 0x8086, 0x0887, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x0888, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Centrino Wireless-N 6235
> 
> +  //
> 
> +  { 0x8086, 0x088E, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x088F, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel CampPeak 2 Wifi
> 
> +  //
> 
> +  { 0x8086, 0x08B5, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x08B6, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel WilkinsPeak 1 Wifi
> 
> +  //
> 
> +  { 0x8086, 0x08B3, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1,
> PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x08B4, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1,
> PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Wilkins Peak 2 Wifi
> 
> +  //
> 
> +  { 0x8086, 0x08B1, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1,
> PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
> 
> +  { 0x8086, 0x08B2, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1,
> PchPcieL1L2AndL1SubstatesOverride, 0x0158, 0x0000000F, 0, 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Intel Wilkins Peak PF Wifi
> 
> +  //
> 
> +  { 0x8086, 0x08B0, 0xff, PCI_CLASS_NETWORK,
> PCI_CLASS_NETWORK_OTHER, PchPcieAspmL1, PchPcieL1L2Override, 0, 0, 0,
> 0, 0, 0, 0 },
> 
> +  //
> 
> +  // Teton Glacier Endpoint
> 
> +  //
> 
> +  { 0x8086, 0x0975, 0xff, 0, 0, 0, PchPcieL1SubstatesOverride, 0, 0xff, 0x3C, 0,
> 5, 0, 0, 0, 0 },
> 
> +
> 
> +  //
> 
> +  // End of Table
> 
> +  //
> 
> +  { 0 }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Print PCIE_RP_DXE_CONFIG.
> 
> +
> 
> +  @param[in] PchPolicy            Pointer to a PCH_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +PchPcieRpDxePrintConfig (
> 
> +  IN PCH_POLICY_PROTOCOL    *PchPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  PCIE_RP_DXE_CONFIG    *PchPcieRpDxeConfig;
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) PchPolicy, &gPchPcieRpDxeConfigGuid,
> (VOID *) &PchPcieRpDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------ PCH PCIE DXE CONFIG --------------
> ----\n"));
> 
> +  DEBUG ((DEBUG_INFO, " PcieDeviceOverrideTablePtr :
> 0x%x\n",PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for Pch PCIE RP
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +LoadPchPcieRpDxeConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  PCIE_RP_DXE_CONFIG  *PchPcieRpDxeConfig;
> 
> +
> 
> +  PchPcieRpDxeConfig = ConfigBlockPointer;
> 
> +  PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr = mPcieDeviceTable;
> 
> +}
> 
> +
> 
> +STATIC COMPONENT_BLOCK_ENTRY  mPchPcieRpBlocks = {
> 
> +  &gPchPcieRpDxeConfigGuid,
> 
> +  sizeof (PCIE_RP_DXE_CONFIG),
> 
> +  PCIE_RP_DXE_CONFIG_REVISION,
> 
> +  LoadPchPcieRpDxeConfigDefault
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get PchPcieRp config block table size.
> 
> +
> 
> +  @retval      Size of config block
> 
> +**/
> 
> +UINT16
> 
> +PchPcieRpDxeGetConfigBlockTotalSize (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mPchPcieRpBlocks.Size;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Add PchPcieRp ConfigBlock.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to config block table
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchPcieRpDxeAddConfigBlock (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  )
> 
> +{
> 
> +  return AddComponentConfigBlocks (ConfigBlockTableAddress,
> &mPchPcieRpBlocks, 1);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPcie
> RpPolicyLib/DxePchPcieRpPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPci
> eRpPolicyLib/DxePchPcieRpPolicyLib.inf
> new file mode 100644
> index 0000000000..6158e77a35
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/DxePchPci
> eRpPolicyLib/DxePchPcieRpPolicyLib.inf
> @@ -0,0 +1,30 @@
> +## @file
> 
> +# Component description file for the PchPcieRp policy library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxePchPcieRpPolicyLib
> 
> +FILE_GUID = 328B0DE5-189A-4DB0-BFE1-557F4F89010B
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxePchPcieRpPolicyLib
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +ConfigBlockLib
> 
> +SiConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxePchPcieRpPolicyLib.c
> 
> +
> 
> +[Guids]
> 
> +gPchPcieRpDxeConfigGuid  ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.c
> new file mode 100644
> index 0000000000..401a9fbe7b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.c
> @@ -0,0 +1,1997 @@
> +/** @file
> 
> +  This file contains routines that support PCI Express initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PciExpressHelpersLibrary.h"
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/PcieRpLib.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <CpuPcieHob.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +
> 
> +#define ASPM_L1_NO_LIMIT 0xFF
> 
> +#define ASPM_L0s_NO_LIMIT 0x7
> 
> +#define LINK_RETRAIN_WAIT_TIME 1000 // microseconds
> 
> +
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32  RequesterCapable       : 1;
> 
> +    UINT32  ResponderCapable       : 1;
> 
> +    UINT32  RootCapable            : 1;
> 
> +    UINT32  Reserved               : 5;
> 
> +    UINT32  LocalClockGranularity  : 8;
> 
> +    UINT32  Reserved2              : 16;
> 
> +  } Bits;
> 
> +  UINT32  Uint32;
> 
> +} PTM_CAPS;
> 
> +
> 
> +typedef union {
> 
> +  struct {
> 
> +    UINT32 Enable                 : 1;
> 
> +    UINT32 RootSelect             : 1;
> 
> +    UINT32 Reserved               : 6;
> 
> +    UINT32 EffectiveGranularity   : 8;
> 
> +    UINT32 Reserved2              : 16;
> 
> +  } Bits;
> 
> +  UINT32  Uint32;
> 
> +} PTM_CTRL;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32                          Size;
> 
> +  const PCH_PCIE_DEVICE_OVERRIDE* Table;
> 
> +} OVERRIDE_TABLE;
> 
> +
> 
> +typedef enum {
> 
> +  DevTypePci,
> 
> +  DevTypePcieEndpoint,
> 
> +  DevTypePcieUpstream,
> 
> +  DevTypePcieDownstream,
> 
> +  DevTypeMax
> 
> +} PCI_DEV_TYPE;
> 
> +
> 
> +//
> 
> +// This structure keeps in one place all data relevant to enabling L0s and L1.
> 
> +// L0s latencies are encoded in the same way as in hardware registers. The
> only operation
> 
> +// that will be performed on them is comparison
> 
> +// L1 latencies are decoded to microseconds, because they will be used in
> subtractions and additions
> 
> +//
> 
> +typedef struct {
> 
> +  UINT32  L0sSupported          : 1;
> 
> +  UINT32  L1Supported           : 1;
> 
> +  UINT32  L0sAcceptableLatency  : 3; // encoded as in hardware register
> 
> +  UINT32  L1AcceptableLatencyUs : 8; // decoded to microseconds
> 
> +  UINT32  LinkL0sExitLatency    : 3; // encoded as in hardware register
> 
> +  UINT32  LinkL1ExitLatencyUs   : 8; // decoded to microseconds
> 
> +} ASPM_CAPS;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32     AspmL11  : 1;
> 
> +  UINT32     AspmL12  : 1;
> 
> +  UINT32     PmL11    : 1;
> 
> +  UINT32     PmL12    : 1;
> 
> +  UINT32     Cmrt     : 8; // Common Mode Restore Time
> 
> +  UINT32     TpoScale : 2; // T power_on scale
> 
> +  UINT32     TpoValue : 6; // T power_on value
> 
> +} L1SS_CAPS;
> 
> +
> 
> +#define MAX_SBDF_TABLE_SIZE 50 //arbitrary table size; big enough to
> accomodate even full length TBT chain.
> 
> +
> 
> +typedef struct {
> 
> +  UINT32 Count;
> 
> +  SBDF   Entry [MAX_SBDF_TABLE_SIZE];
> 
> +} SBDF_TABLE;
> 
> +
> 
> +/**
> 
> +  Converts device's segment:bus:device:function coordinates to flat address
> 
> +
> 
> +  @param[in] Sbdf   device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval    address of device's PCI cfg space
> 
> +**/
> 
> +STATIC
> 
> +UINT64
> 
> +SbdfToBase (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (Sbdf.Seg, Sbdf.Bus, Sbdf.Dev,
> Sbdf.Func, 0);
> 
> +}
> 
> +
> 
> +/*
> 
> +  Converts Tpower_on from value:scale notation to microseconds
> 
> +
> 
> +  @param[in] TpoScale   T power on scale
> 
> +  @param[in] TpoValue   T power on value
> 
> +
> 
> +  @retval    number of microseconds
> 
> +*/
> 
> +UINT32
> 
> +TpoToUs (
> 
> +  UINT32 TpoScale,
> 
> +  UINT32 TpoValue
> 
> +  )
> 
> +{
> 
> +  static const UINT8 TpoScaleMultiplier[] = {2, 10, 100};
> 
> +
> 
> +  ASSERT (TpoScale < TpoScaleMax);
> 
> +  if (TpoScale >= TpoScaleMax) {
> 
> +    return 0;
> 
> +  }
> 
> +  return (TpoScaleMultiplier[TpoScale] * TpoValue);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get max payload size supported by device.
> 
> +
> 
> +  @param[in] Sbdf   device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval    Max payload size, encoded in the same way as in register
> (0=128b, 1=256b, etc)
> 
> +**/
> 
> +STATIC
> 
> +UINT8
> 
> +GetMps (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  return (PciSegmentRead16 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_DCAP_OFFSET) & B_PCIE_DCAP_MPS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Maximum Payload Size to be used by device
> 
> +
> 
> +  @param[in] Sbdf   device's segment:bus:device:function coordinates
> 
> +  @param[in] Mps    Max payload size, encoded in the same way as in
> register (0=128b, 1=256b, etc)
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetMps (
> 
> +  SBDF  Sbdf,
> 
> +  UINT8  Mps
> 
> +  )
> 
> +{
> 
> +  PciSegmentAndThenOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_DCTL_OFFSET, (UINT16) ~B_PCIE_DCTL_MPS, Mps <<
> N_PCIE_DCTL_MPS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enables LTR feature in given device
> 
> +
> 
> +  @param[in] Sbdf            device's segment:bus:device:function coordinates
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EnableLtr (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  if (Sbdf.PcieCap == 0) {
> 
> +    return;
> 
> +  }
> 
> +  PciSegmentOr32 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_DCTL2_OFFSET, B_PCIE_DCTL2_LTREN);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns information about type of device.
> 
> +
> 
> +  @param[out] Sbdf            device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval     one of: not a PCIe device (legacy PCI), PCIe endpoint, PCIe
> upstream port or PCIe downstream port (including rootport)
> 
> +**/
> 
> +STATIC
> 
> +PCI_DEV_TYPE
> 
> +GetDeviceType (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  UINT8 DeviceType;
> 
> +
> 
> +  if (Sbdf.PcieCap == 0) {
> 
> +    return DevTypePci;
> 
> +  }
> 
> +  DeviceType = (UINT8) ((PciSegmentRead16 (SbdfToBase (Sbdf) +
> Sbdf.PcieCap + R_PCIE_XCAP_OFFSET) & B_PCIE_XCAP_DT) >>
> N_PCIE_XCAP_DT);
> 
> +  if (DeviceType == PCIE_DEVICE_PORT_TYPE_UPSTREAM_PORT) {
> 
> +    return DevTypePcieUpstream;
> 
> +  } else if (DeviceType == PCIE_DEVICE_PORT_TYPE_DOWNSTREAM_PORT
> || DeviceType == PCIE_DEVICE_PORT_TYPE_ROOT_PORT) {
> 
> +    return DevTypePcieDownstream;
> 
> +  } else {
> 
> +    return DevTypePcieEndpoint;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initializes Dev:Func numbers for use in FindNextPcieChild or
> FindNextLegalSbdf functions.
> 
> +
> 
> +  @param[out] Sbdf            device's segment:bus:device:function coordinates
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +InitChildFinder (
> 
> +  OUT SBDF *Sbdf
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Initialize Dev/Func to maximum values, so that when FindNextLegalSbdf
> ()
> 
> +  // is called on those input parameters, it will return 1st legal address (Dev 0
> Func 0).
> 
> +  //
> 
> +  Sbdf->Dev = PCI_MAX_DEVICE;
> 
> +  Sbdf->Func = PCI_MAX_FUNC;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks the device is a bridge and has non-zero secondary bus number
> assigned.
> 
> +  If so, it returns TRUE and initializes ChildSbdf with such values that
> 
> +  allow searching for devices on the secondary bus.
> 
> +  ChildSbdf will be mangled even if this function returns FALSE.
> 
> +
> 
> +  Legal bus assignment is assumed. This function doesn't check subordinate
> bus numbers of
> 
> +  the the device it was called on or any bridges between it and root complex
> 
> +
> 
> +  @param[in]  Sbdf       device's segment:bus:device:function coordinates
> 
> +  @param[out] ChildSbdf  SBDF initialized in such way that calling
> FindNextPcieChild( ) on it will find all children devices
> 
> +
> 
> +  @retval TRUE if device is a bridge and has a bus behind it; FALSE otherwise
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +HasChildBus (
> 
> +  SBDF   Sbdf,
> 
> +  SBDF   *ChildSbdf
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +  UINT64 Base;
> 
> +  UINT8  SecondaryBus;
> 
> +
> 
> +  ChildSbdf->Seg = Sbdf.Seg;
> 
> +  InitChildFinder (ChildSbdf);
> 
> +
> 
> +  Base = SbdfToBase (Sbdf);
> 
> +
> 
> +  if (PciSegmentRead8 (Base + R_PCI_BCC_OFFSET) != PCI_CLASS_BRIDGE) {
> 
> +    DEBUG ((DEBUG_INFO, "HasChildBus%02:%02:%02: no\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +    return FALSE;
> 
> +  }
> 
> +  Data32 = PciSegmentRead32 (Base +
> PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET);
> 
> +  SecondaryBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SCBN) >> 8);
> 
> +  ChildSbdf->Bus = SecondaryBus;
> 
> +  if (SecondaryBus == 0) {
> 
> +    DEBUG ((DEBUG_INFO, "HasChildBus%02x:%02x:%02x: no\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +    return FALSE;
> 
> +  } else {
> 
> +    DEBUG ((DEBUG_INFO, "HasChildBus%02x:%02x:%02x: yes, %x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func, SecondaryBus));
> 
> +    return TRUE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets LTR limit in a device.
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +  @param[in] Ltr             LTR limit
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetLtrLimit (
> 
> +  UINT64    Base,
> 
> +  LTR_LIMIT Ltr
> 
> +  )
> 
> +{
> 
> +  UINT16 LtrCapOffset;
> 
> +  UINT16 Data16;
> 
> +
> 
> +  LtrCapOffset = PcieBaseFindExtendedCapId (Base, R_PCIE_LTRECH_CID);
> 
> +  if (LtrCapOffset == 0) {
> 
> +    return;
> 
> +  }
> 
> +  Data16 = (UINT16)((Ltr.MaxSnoopLatencyValue <<
> N_PCIE_LTRECH_MSLR_VALUE) | (Ltr.MaxSnoopLatencyScale <<
> N_PCIE_LTRECH_MSLR_SCALE));
> 
> +  PciSegmentWrite16(Base + LtrCapOffset + R_PCIE_LTRECH_MSLR_OFFSET,
> Data16);
> 
> +
> 
> +  Data16 = (UINT16)((Ltr.MaxNoSnoopLatencyValue <<
> N_PCIE_LTRECH_MNSLR_VALUE) | (Ltr.MaxNoSnoopLatencyScale <<
> N_PCIE_LTRECH_MNSLR_SCALE));
> 
> +  PciSegmentWrite16(Base + LtrCapOffset +
> R_PCIE_LTRECH_MNSLR_OFFSET, Data16);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if device at given address exists and is a PCI Express device.
> 
> +  PCI express devices are distinguished from PCI by having Capability ID 0x10
> 
> +  If the device is PCI express then its SDBF structure gets updated with
> pointer to
> 
> +  the PCIe Capability. This is an optimization feature. It greatly decreases the
> number
> 
> +  of bus accesses, since most features configured by this library depend on
> registers
> 
> +  whose location is relative to PCIe capability.
> 
> +
> 
> +  @param[in,out] Sbdf   on entry, segment:bus:device:function coordinates
> 
> +                        on exit, PcieCap offset is updated
> 
> +
> 
> +  @retval               TRUE when PCIe device exists; FALSE if it's not PCIe or
> there's no device at all
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsPcieDevice (
> 
> +  SBDF *Sbdf
> 
> +  )
> 
> +{
> 
> +  UINT8 PcieCapOffset;
> 
> +  UINT64         Base;
> 
> +
> 
> +  Base = SbdfToBase(*Sbdf);
> 
> +
> 
> +  if (PciSegmentRead16 (Base) == 0xFFFF) {
> 
> +    return FALSE;
> 
> +  }
> 
> +
> 
> +
> 
> +  PcieCapOffset = PcieBaseFindCapId (Base,
> EFI_PCI_CAPABILITY_ID_PCIEXP);
> 
> +  if (PcieCapOffset == 0) {
> 
> +    DEBUG ((DEBUG_INFO, "IsPcieDevice %02x:%02x:%02x - legacy\n", Sbdf-
> >Bus, Sbdf->Dev, Sbdf->Func));
> 
> +    return FALSE;
> 
> +  } else {
> 
> +    Sbdf->PcieCap = PcieCapOffset;
> 
> +    DEBUG ((DEBUG_INFO, "IsPcieDevice %02x:%02x:%02x - yes\n", Sbdf-
> >Bus, Sbdf->Dev, Sbdf->Func));
> 
> +    return TRUE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns TRUE and Dev:Func numbers where a PCIe device could legally be
> located, or FALSE if there
> 
> +  no such coordinates left.
> 
> +
> 
> +  Segment and Bus fields of SBDF structure are input only and determine
> which bus will be scanned.
> 
> +  This function should be called in a while() loop. It replaces the less efficient
> method of
> 
> +  using nested FOR loops that iterate over all device and function numbers.
> It is optimized for
> 
> +  the amount of bus access. If function0 doesn't exist or doesn't have
> Multifunction bit set,
> 
> +  then higher function numbers are skipped. If parent of this bus is a
> downstream port, then
> 
> +  Device numbers 1-31 get skipped too (there can be only Dev0 behind
> downstream ports)
> 
> +  If device/function number == 0x1F/0x7, this function returns first possible
> address, that is 0:0
> 
> +  Any other device number means Dev:Func contain address of last found
> child device
> 
> +  and this function should search for next one
> 
> +
> 
> +  @param[in]     ParentDevType  type of bridge who's partent of this bus
> 
> +  @param[in,out] Sbdf           On entry: location returned previously from this
> function
> 
> +                                          Dev:Func value of 1F:07 means search should start
> from the beginning
> 
> +                                On exit:  if legal Dev:Func combination was found, that
> Dev:Func is returned
> 
> +                                          otherwise, Dev:Func are initialized to 1F:07 for
> convenience
> 
> +
> 
> +  @retval TRUE when next legal Dev:Func address was found; FALSE
> otherwise
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +FindNextLegalSbdf (
> 
> +  IN     PCI_DEV_TYPE ParentDevType,
> 
> +  IN OUT SBDF         *Sbdf
> 
> +  )
> 
> +{
> 
> +  UINT8  MaxDev;
> 
> +  UINT64 Func0Base;
> 
> +
> 
> +  if (ParentDevType == DevTypePcieEndpoint) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  if (ParentDevType == DevTypePcieUpstream) {
> 
> +    MaxDev = PCI_MAX_DEVICE;
> 
> +  } else {
> 
> +    MaxDev = 0;
> 
> +  }
> 
> +  Func0Base = PCI_SEGMENT_LIB_ADDRESS (Sbdf->Seg, Sbdf->Bus, Sbdf-
> >Dev, 0, 0);
> 
> +  if ((Sbdf->Dev == PCI_MAX_DEVICE) && Sbdf->Func == PCI_MAX_FUNC) {
> 
> +    Sbdf->Dev = 0;
> 
> +    Sbdf->Func = 0;
> 
> +    return TRUE;
> 
> +  } else if ((Sbdf->Func == PCI_MAX_FUNC) || (Sbdf->Func == 0 &&
> !IsMultifunctionDevice (Func0Base))) {
> 
> +  //
> 
> +  // if it's the last function of a device, then return Func0 of new device or
> FALSE in case there are no more devices
> 
> +  //
> 
> +    if (Sbdf->Dev == MaxDev) {
> 
> +      InitChildFinder (Sbdf);
> 
> +      return FALSE;
> 
> +    }
> 
> +    (Sbdf->Dev)++;
> 
> +    Sbdf->Func = 0;
> 
> +    return TRUE;
> 
> +  } else {
> 
> +    (Sbdf->Func)++;
> 
> +    return TRUE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Finds next PCIe (not legacy PCI) device behind given device
> 
> +  If device/function number == 0x1F/0x7, this function searches for children
> from scratch
> 
> +  Any other device number means Dev:Func contain address of last found
> child device
> 
> +  and this function should search for next one
> 
> +
> 
> +  @param[in]     ParentDevType  type of bridge who's partent of this bus
> 
> +  @param[in,out] Sbdf           On entry: location returned previously from this
> function
> 
> +                                          Dev:Func value of 0x1F:0x07 means search should start
> from the beginning
> 
> +                                On exit:  if PCIe device was found, its SBDF coordinates are
> returned
> 
> +                                          otherwise, Dev:Func are initialized to 0x1F:0x07 for
> convenience
> 
> +  @retval TRUE when next PCIe device was found; FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +FindNextPcieChild (
> 
> +  IN     PCI_DEV_TYPE ParentDevType,
> 
> +  IN OUT SBDF   *Sbdf
> 
> +  )
> 
> +{
> 
> +  while ( FindNextLegalSbdf (ParentDevType, Sbdf)) {
> 
> +    if (IsPcieDevice (Sbdf)) {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if given device supports Clock Power Management
> 
> +
> 
> +  @param[in] Sbdf     segment:bus:device:function coordinates of a device
> 
> +
> 
> +  @retval TRUE when device supports it, FALSE otherwise
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsCpmSupported (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  return !!(PciSegmentRead32 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_CPM);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Enable Clock Power Management bit for given device
> 
> +
> 
> +  @param[in] Sbdf            segment:bus:device:function coordinates of a
> device
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EnableCpm (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  PciSegmentOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_LCTL_OFFSET, B_PCIE_LCTL_ECPM);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if given device is an IoAPIC
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +
> 
> +  @retval TRUE if it's an IoAPIC
> 
> +**/
> 
> +BOOLEAN
> 
> +IsIoApicDevice (
> 
> +  UINT64 Base
> 
> +  )
> 
> +{
> 
> +  UINT8 BaseClassCode;
> 
> +  UINT8 SubClassCode;
> 
> +  UINT8 ProgInterface;
> 
> +
> 
> +  BaseClassCode = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET + 2);
> 
> +  SubClassCode  = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET + 1);
> 
> +  ProgInterface = PciSegmentRead8 (Base + PCI_CLASSCODE_OFFSET);
> 
> +  if ((BaseClassCode == PCI_CLASS_SYSTEM_PERIPHERAL) &&
> 
> +      (SubClassCode == PCI_SUBCLASS_PIC) &&
> 
> +      ((ProgInterface == PCI_IF_APIC_CONTROLLER) ||
> 
> +       (ProgInterface == PCI_IF_APIC_CONTROLLER2))) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  There are some devices which support L1 substates, but due to silicon bugs
> the corresponding register
> 
> +  cannot be found by scanning PCIe capabilities. This function checks list of
> such devices and if one
> 
> +  is found, returns its L1ss capability register offset
> 
> +
> 
> +  @param[in] Base       base address of device
> 
> +  @param[in] Override   table of devices that need override
> 
> +
> 
> +  @retval               offset to L1ss capability register
> 
> +**/
> 
> +UINT16
> 
> +GetOverrideL1ssCapsOffset (
> 
> +  UINT64         Base,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  UINT16 DeviceId;
> 
> +  UINT16 VendorId;
> 
> +  UINT8  Revision;
> 
> +  UINT32 Index;
> 
> +
> 
> +  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
> 
> +  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
> 
> +  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
> 
> +
> 
> +  for (Index = 0; Index < Override->Size; Index++) {
> 
> +    if (((Override->Table[Index].OverrideConfig &
> PchPcieL1SubstatesOverride) == PchPcieL1SubstatesOverride) &&
> 
> +        (Override->Table[Index].VendorId == VendorId) &&
> 
> +        (Override->Table[Index].DeviceId == DeviceId) &&
> 
> +        (Override->Table[Index].RevId == Revision || Override-
> >Table[Index].RevId == 0xFFFF)) {
> 
> +      return Override->Table[Index].L1SubstatesCapOffset;
> 
> +    }
> 
> +  }
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  There are some devices whose implementation of L1 substates is partially
> broken. This function checks
> 
> +  list of such devices and if one is found, overrides their L1ss-related
> capabilities
> 
> +
> 
> +  @param[in]     Base       base address of device
> 
> +  @param[in]     Override   table of devices that need override
> 
> +  @param[in,out] L1ss       on entry, capabilities read from register; on exit,
> capabilities modified according ot override table
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +OverrideL1ssCaps (
> 
> +  UINT64         Base,
> 
> +  OVERRIDE_TABLE *Override,
> 
> +  L1SS_CAPS      *L1ss
> 
> +  )
> 
> +{
> 
> +  UINT16 DeviceId;
> 
> +  UINT16 VendorId;
> 
> +  UINT8  Revision;
> 
> +  UINT32 Index;
> 
> +
> 
> +  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
> 
> +  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
> 
> +  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
> 
> +
> 
> +  for (Index = 0; Index < Override->Size; Index++) {
> 
> +    if (((Override->Table[Index].OverrideConfig &
> PchPcieL1SubstatesOverride) == PchPcieL1SubstatesOverride) &&
> 
> +        (Override->Table[Index].VendorId == VendorId) &&
> 
> +        (Override->Table[Index].DeviceId == DeviceId) &&
> 
> +        (Override->Table[Index].RevId == Revision || Override-
> >Table[Index].RevId == 0xFF)) {
> 
> +
> 
> +      L1ss->PmL12   &= !!(Override->Table[Index].L1SubstatesCapMask &
> B_PCIE_EX_L1SCAP_PPL12S);
> 
> +      L1ss->PmL11   &= !!(Override->Table[Index].L1SubstatesCapMask &
> B_PCIE_EX_L1SCAP_PPL11S);
> 
> +      L1ss->AspmL12 &= !!(Override->Table[Index].L1SubstatesCapMask &
> B_PCIE_EX_L1SCAP_AL12S);
> 
> +      L1ss->AspmL11 &= !!(Override->Table[Index].L1SubstatesCapMask &
> B_PCIE_EX_L1SCAP_AL1SS);
> 
> +      if (Override->Table[Index].L1sTpowerOnValue != 0) {
> 
> +        L1ss->Cmrt = Override->Table[Index].L1sCommonModeRestoreTime;
> 
> +        L1ss->TpoScale = Override->Table[Index].L1sTpowerOnScale;
> 
> +        L1ss->TpoValue = Override->Table[Index].L1sTpowerOnValue;
> 
> +      }
> 
> +      return;
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns L1 sub states capabilities of a device
> 
> +
> 
> +  @param[in] Base   base address of a device
> 
> +
> 
> +  @retval L1SS_CAPS structure filled with device's capabilities
> 
> +**/
> 
> +STATIC
> 
> +L1SS_CAPS
> 
> +GetL1ssCaps (
> 
> +  UINT64         Base,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  L1SS_CAPS Capabilities = {0};
> 
> +  UINT16    PcieCapOffset;
> 
> +  UINT32    CapsRegister;
> 
> +
> 
> +  PcieCapOffset = GetOverrideL1ssCapsOffset (Base, Override);
> 
> +  if (PcieCapOffset == 0) {
> 
> +    PcieCapOffset = PcieBaseFindExtendedCapId (Base,
> V_PCIE_EX_L1S_CID);
> 
> +  }
> 
> +  if (PcieCapOffset == 0) {
> 
> +    return Capabilities;
> 
> +  }
> 
> +  CapsRegister = PciSegmentRead32 (Base + PcieCapOffset +
> R_PCIE_EX_L1SCAP_OFFSET);
> 
> +  if (CapsRegister & B_PCIE_EX_L1SCAP_L1PSS) {
> 
> +    //
> 
> +    // Skip L1.1 checking since some device only indecate L1.2 support.
> 
> +    // [1604452805]
> 
> +    //
> 
> +    Capabilities.PmL11 = !!(CapsRegister & B_PCIE_EX_L1SCAP_PPL11S);
> 
> +    Capabilities.PmL12 = !!(CapsRegister & B_PCIE_EX_L1SCAP_PPL12S);
> 
> +    Capabilities.AspmL12 = !!(CapsRegister & B_PCIE_EX_L1SCAP_AL12S);
> 
> +    Capabilities.AspmL11 = !!(CapsRegister & B_PCIE_EX_L1SCAP_AL1SS);
> 
> +    Capabilities.Cmrt = (CapsRegister & B_PCIE_EX_L1SCAP_CMRT) >>
> N_PCIE_EX_L1SCAP_CMRT;
> 
> +    Capabilities.TpoValue = (CapsRegister & B_PCIE_EX_L1SCAP_PTV) >>
> N_PCIE_EX_L1SCAP_PTV;
> 
> +    Capabilities.TpoScale = (CapsRegister & B_PCIE_EX_L1SCAP_PTPOS) >>
> N_PCIE_EX_L1SCAP_PTPOS;
> 
> +  }
> 
> +  OverrideL1ssCaps (Base, Override, &Capabilities);
> 
> +  return Capabilities;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns combination of two sets of L1 substate capabilities
> 
> +  Given feature is supported by the link only if both sides support it
> 
> +  Time parameters for link (Cmrt and Tpo) depend on the bigger value
> between two sides
> 
> +
> 
> +  @param[in] L1ssA      L1 substate capabilities of first device
> 
> +  @param[in] L1ssB      L1 substate capabilities of second device
> 
> +
> 
> +  @retval Link's L1 substate capabilities
> 
> +**/
> 
> +STATIC
> 
> +L1SS_CAPS
> 
> +CombineL1ss (
> 
> +  L1SS_CAPS L1ssA,
> 
> +  L1SS_CAPS L1ssB
> 
> +  )
> 
> +{
> 
> +  L1SS_CAPS Combined;
> 
> +
> 
> +  Combined.PmL12 = L1ssA.PmL12 && L1ssB.PmL12;
> 
> +  Combined.PmL11 = L1ssA.PmL11 && L1ssB.PmL11;
> 
> +  Combined.AspmL12 = L1ssA.AspmL12 && L1ssB.AspmL12;
> 
> +  Combined.AspmL11 = L1ssA.AspmL11 && L1ssB.AspmL11;
> 
> +  Combined.Cmrt = MAX (L1ssA.Cmrt, L1ssB.Cmrt);
> 
> +  if (TpoToUs (L1ssA.TpoScale, L1ssA.TpoValue) > TpoToUs (L1ssB.TpoScale,
> L1ssB.TpoValue)) {
> 
> +    Combined.TpoScale = L1ssA.TpoScale;
> 
> +    Combined.TpoValue = L1ssA.TpoValue;
> 
> +  } else {
> 
> +    Combined.TpoScale = L1ssB.TpoScale;
> 
> +    Combined.TpoValue = L1ssB.TpoValue;
> 
> +  }
> 
> +  return Combined;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures L1 substate feature in a device
> 
> +
> 
> +  @param[in] Sbdf     segment:bus:device:function coordinates of a device
> 
> +  @param[in] L1ss     configuration to be programmed
> 
> +  @param[in] Override table of devices that require special handling
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetL1ss (
> 
> +  SBDF           Sbdf,
> 
> +  L1SS_CAPS      L1ss,
> 
> +  OVERRIDE_TABLE *Override,
> 
> +  BOOLEAN   IsCpuPcie
> 
> +
> 
> +  )
> 
> +{
> 
> +  UINT16    PcieCapOffset;
> 
> +  UINT32    Ctrl1Register;
> 
> +  UINT32    Ctrl2Register;
> 
> +  UINT64    Base;
> 
> +
> 
> +  Base = SbdfToBase(Sbdf);
> 
> +  Ctrl1Register = 0;
> 
> +  Ctrl2Register = 0;
> 
> +
> 
> +  PcieCapOffset = GetOverrideL1ssCapsOffset (Base, Override);
> 
> +  if (PcieCapOffset == 0) {
> 
> +    PcieCapOffset = PcieBaseFindExtendedCapId (Base,
> V_PCIE_EX_L1S_CID);
> 
> +  }
> 
> +  if (PcieCapOffset == 0) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  Ctrl1Register |= (L1ss.PmL12 ? B_PCIE_EX_L1SCAP_PPL12S : 0);
> 
> +  Ctrl1Register |= (L1ss.PmL11 ? B_PCIE_EX_L1SCAP_PPL11S : 0);
> 
> +  Ctrl1Register |= (L1ss.AspmL12 ? B_PCIE_EX_L1SCAP_AL12S : 0);
> 
> +  Ctrl1Register |= (L1ss.AspmL11 ? B_PCIE_EX_L1SCAP_AL1SS : 0);
> 
> +  if ((GetDeviceType (Sbdf) == DevTypePcieDownstream)) {
> 
> +    Ctrl1Register |= (L1ss.Cmrt << N_PCIE_EX_L1SCAP_CMRT);
> 
> +  }
> 
> +  ///
> 
> +  /// BWG 1.3 Section 5.5.7.6 LTR Threshold Latency
> 
> +  /// Set L1.2 LTR threshold using formula (TpoToUs (L1ss.TpoScale,
> L1ss.TpoValue) + L1ss.Cmrt + 10)
> 
> +  ///
> 
> +  Ctrl1Register |= ((TpoToUs (L1ss.TpoScale, L1ss.TpoValue) + L1ss.Cmrt +
> 10) << N_PCIE_EX_L1SCTL1_L12LTRTLV);
> 
> +  Ctrl1Register |= (2 << N_PCIE_EX_L1SCTL1_L12LTRTLSV);
> 
> +
> 
> +  Ctrl2Register |= (L1ss.TpoScale);
> 
> +  Ctrl2Register |= (L1ss.TpoValue << N_PCIE_EX_L1SCTL2_POWT);
> 
> +  //
> 
> +  // Set CLKREQ Acceleration Interrupt Enable
> 
> +  //
> 
> +  Ctrl1Register |= B_PCIE_EX_L1SCTL1_L1SSEIE;
> 
> +  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL1_OFFSET,
> 0);
> 
> +  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL2_OFFSET,
> Ctrl2Register);
> 
> +  PciSegmentWrite32 (Base + PcieCapOffset + R_PCIE_EX_L1SCTL1_OFFSET,
> Ctrl1Register);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Converts L1 latency from enumerated register value to microseconds
> 
> +
> 
> +  @param[in] L1Latency     latency value retrieved from register; see PCIE
> specification for encoding
> 
> +
> 
> +  @retval    L1 latency converted to microseconds
> 
> +**/
> 
> +UINT32
> 
> +L1LatencyToUs (
> 
> +  UINT32 L1Latency
> 
> +  )
> 
> +{
> 
> +  if (L1Latency < 7) {
> 
> +    return 1 * (BIT0 << L1Latency);
> 
> +  } else {
> 
> +    return ASPM_L1_NO_LIMIT;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Modifies L1 latency by provided value
> 
> +
> 
> +  @param[in] Aspm     Structure that contains ASPM capabilities of a link,
> including L1 acceptable latency
> 
> +  @param[in] Value    Value, in microseconds, to be added to L1 acceptable
> latency. Can be negative.
> 
> +
> 
> +  @retval             Aspm structure with modified L1 acceptable latency
> 
> +**/
> 
> +STATIC
> 
> +ASPM_CAPS
> 
> +PatchL1AcceptableLatency (
> 
> +  ASPM_CAPS Aspm,
> 
> +  INT8      Value
> 
> +  )
> 
> +{
> 
> +  if (Aspm.L1AcceptableLatencyUs != ASPM_L1_NO_LIMIT) {
> 
> +    if (Value > 0) {
> 
> +      Aspm.L1AcceptableLatencyUs += Value;
> 
> +    } else {
> 
> +      if (Aspm.L1AcceptableLatencyUs > (UINT32)(-1*Value)) {
> 
> +        Aspm.L1AcceptableLatencyUs = Aspm.L1AcceptableLatencyUs + Value;
> 
> +      } else {
> 
> +        Aspm.L1AcceptableLatencyUs = 0;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  return Aspm;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads ASPM capabilities of a device
> 
> +
> 
> +  @param[in] Sbdf segment:bus:device:function coordinates of a device
> 
> +
> 
> +  @retval           structure containing device's ASPM capabilities
> 
> +**/
> 
> +STATIC
> 
> +ASPM_CAPS
> 
> +GetAspmCaps (
> 
> +  SBDF   Sbdf
> 
> +  )
> 
> +{
> 
> +
> 
> +  UINT32    LinkCapRegister;
> 
> +  UINT32    DevCapRegister;
> 
> +  UINT64    Base;
> 
> +  ASPM_CAPS Aspm = {0};
> 
> +
> 
> +  Base = SbdfToBase (Sbdf);
> 
> +
> 
> +  LinkCapRegister = PciSegmentRead32 (Base + Sbdf.PcieCap +
> R_PCIE_LCAP_OFFSET);
> 
> +  DevCapRegister = PciSegmentRead32 (Base + Sbdf.PcieCap +
> R_PCIE_DCAP_OFFSET);
> 
> +
> 
> +  ///
> 
> +  /// Check endpoint for pre-1.1 devices based on the Role based Error
> Reporting Capability bit. Don't report L0s support for old devices
> 
> +  ///
> 
> +  if (DevCapRegister & B_PCIE_DCAP_RBER) {
> 
> +    Aspm.L0sSupported = !!(LinkCapRegister & B_PCIE_LCAP_APMS_L0S);
> 
> +  }
> 
> +  Aspm.L1Supported = !!(LinkCapRegister & B_PCIE_LCAP_APMS_L1);
> 
> +
> 
> +  Aspm.LinkL0sExitLatency = (LinkCapRegister & B_PCIE_LCAP_EL0) >>
> N_PCIE_LCAP_EL0;
> 
> +  Aspm.LinkL1ExitLatencyUs = L1LatencyToUs( (LinkCapRegister &
> B_PCIE_LCAP_EL1) >> N_PCIE_LCAP_EL1);
> 
> +
> 
> +  if (GetDeviceType (Sbdf) == DevTypePcieEndpoint) {
> 
> +    Aspm.L0sAcceptableLatency = (DevCapRegister & B_PCIE_DCAP_E0AL)
> >> N_PCIE_DCAP_E0AL;
> 
> +    Aspm.L1AcceptableLatencyUs = L1LatencyToUs( (DevCapRegister &
> B_PCIE_DCAP_E1AL) >> N_PCIE_DCAP_E1AL);
> 
> +    DEBUG ((DEBUG_INFO, "GetAspmCaps %02x:%02x:%02x L0s%c %d:%d
> L1%c %d:%d\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func,
> 
> +                                                                           Aspm.L0sSupported?'+':'-',
> Aspm.LinkL0sExitLatency, Aspm.L0sAcceptableLatency,
> 
> +                                                                           Aspm.L1Supported?'+':'-',
> Aspm.LinkL1ExitLatencyUs, Aspm.L1AcceptableLatencyUs));
> 
> +  } else {
> 
> +    Aspm.L0sAcceptableLatency = ASPM_L0s_NO_LIMIT;
> 
> +    Aspm.L1AcceptableLatencyUs = ASPM_L1_NO_LIMIT;
> 
> +    DEBUG ((DEBUG_INFO, "GetAspmCaps %02x:%02x:%02x L0s%c %d:x
> L1%c %d:x\n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func,
> 
> +                                                                           Aspm.L0sSupported?'+':'-',
> Aspm.LinkL0sExitLatency,
> 
> +                                                                           Aspm.L1Supported?'+':'-',
> Aspm.LinkL1ExitLatencyUs));
> 
> +  }
> 
> +  return Aspm;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get ASPM L0s and L1 override of given device.
> 
> +
> 
> +  @param[in] Sbdf                Segment,Bus,Device,Function address of
> currently visited PCIe device
> 
> +  @param[in,out] MyAspm          Current device's ASPM capabilities structure
> 
> +  @param[in] Override            Pch Pcie devices OverrideTable
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +GetOverrideAspm (
> 
> +  SBDF           Sbdf,
> 
> +  ASPM_CAPS      *MyAspm,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  UINT16      DeviceId;
> 
> +  UINT16      VendorId;
> 
> +  UINT8       Revision;
> 
> +  UINT32      Index;
> 
> +  UINT64      Base;
> 
> +
> 
> +  Base = SbdfToBase (Sbdf);
> 
> +
> 
> +  VendorId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
> 
> +  DeviceId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
> 
> +  Revision = PciSegmentRead8  (Base + PCI_REVISION_ID_OFFSET);
> 
> +
> 
> +  for (Index = 0; Index < Override->Size; Index++) {
> 
> +    if (((Override->Table[Index].OverrideConfig & PchPcieL1L2Override) ==
> PchPcieL1L2Override) &&
> 
> +        (Override->Table[Index].VendorId == VendorId) &&
> 
> +        (Override->Table[Index].DeviceId == DeviceId) &&
> 
> +        (Override->Table[Index].RevId == Revision || Override-
> >Table[Index].RevId == 0xFF)) {
> 
> +      DEBUG ((DEBUG_INFO, "GetOverrideAspm %02x:%02x:%02x, original
> L0sSupported = 0x%x, L1Supported = 0x%x\n",
> 
> +              Sbdf.Bus, Sbdf.Dev, Sbdf.Func, MyAspm->L0sSupported, MyAspm-
> >L1Supported));
> 
> +      if (MyAspm->L0sSupported) {
> 
> +        //
> 
> +        // If L0s is supported in capability, apply platform override.
> 
> +        //
> 
> +        MyAspm->L0sSupported = Override->Table[Index].EndPointAspm &
> BIT0;
> 
> +      }
> 
> +      if (MyAspm->L1Supported) {
> 
> +        //
> 
> +        // If L1 is supported in capability, apply platform override.
> 
> +        //
> 
> +        MyAspm->L1Supported = (Override->Table[Index].EndPointAspm &
> BIT1) >> 1;
> 
> +      }
> 
> +      DEBUG ((DEBUG_INFO, "GetOverrideAspm %02x:%02x:%02x, override
> L0sSupported = 0x%x, L1Supported = 0x%x\n",
> 
> +              Sbdf.Bus, Sbdf.Dev, Sbdf.Func, MyAspm->L0sSupported, MyAspm-
> >L1Supported));
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Combines ASPM capabilities of two devices on both ends of a link to
> determine link's ASPM capabilities
> 
> +
> 
> +  @param[in] AspmA, AspmB  ASPM capabilities of two devices
> 
> +
> 
> +  @retval    ASPM_CAPS structure containing combined ASPM capabilities
> 
> +**/
> 
> +STATIC
> 
> +ASPM_CAPS
> 
> +CombineAspm (
> 
> +  ASPM_CAPS AspmA,
> 
> +  ASPM_CAPS AspmB,
> 
> +  BOOLEAN   DownstreamPort
> 
> +  )
> 
> +{
> 
> +  ASPM_CAPS Combined;
> 
> +
> 
> +  if (DownstreamPort) {
> 
> +    //
> 
> +    // When combining ASPM in downstream ports, combination must reflect
> state of link just below
> 
> +    // and consider all acceptable latencies of all endpoints anywhere down
> below that port
> 
> +    //
> 
> +    Combined.L0sSupported = AspmA.L0sSupported & AspmB.L0sSupported;
> 
> +    Combined.L1Supported = AspmA.L1Supported & AspmB.L1Supported;
> 
> +    Combined.LinkL0sExitLatency = MAX (AspmA.LinkL0sExitLatency,
> AspmB.LinkL0sExitLatency);
> 
> +    Combined.LinkL1ExitLatencyUs = MAX (AspmA.LinkL1ExitLatencyUs,
> AspmB.LinkL1ExitLatencyUs);
> 
> +    Combined.L0sAcceptableLatency = MIN (AspmA.L0sAcceptableLatency,
> AspmB.L0sAcceptableLatency);
> 
> +    Combined.L1AcceptableLatencyUs = MIN
> (AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs);
> 
> +  } else {
> 
> +    //
> 
> +    // When combining ASPM in switch upstream ports,
> 
> +    // Supported and ExitLatency must only reflect capabilities of upstream
> port itself
> 
> +    // But acceptable latencies must consider all endpoints anywhere below
> 
> +    //
> 
> +    Combined.L0sSupported = AspmA.L0sSupported;
> 
> +    Combined.L1Supported = AspmA.L1Supported;
> 
> +    Combined.LinkL0sExitLatency = AspmA.LinkL0sExitLatency;
> 
> +    Combined.LinkL1ExitLatencyUs = AspmA.LinkL1ExitLatencyUs;
> 
> +    Combined.L0sAcceptableLatency = MIN (AspmA.L0sAcceptableLatency,
> AspmB.L0sAcceptableLatency);
> 
> +    Combined.L1AcceptableLatencyUs = MIN
> (AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs);
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "CombineAspm %x:%x -> %x\n",
> AspmA.L1AcceptableLatencyUs, AspmB.L1AcceptableLatencyUs,
> Combined.L1AcceptableLatencyUs));
> 
> +  return Combined;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if L1 can be enabled on given link, according to ASPM parameters of
> that link
> 
> +
> 
> +  @param[in] Aspm            set of parameters describing this link and endpoint
> devices below it
> 
> +
> 
> +  @retval    TRUE if L1 can be enabled
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsL1Allowed (
> 
> +  ASPM_CAPS Aspm
> 
> +  )
> 
> +{
> 
> +  return (Aspm.L1Supported && (Aspm.L1AcceptableLatencyUs >=
> Aspm.LinkL1ExitLatencyUs));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if L0s can be enabled on given link, according to ASPM parameters
> of that link
> 
> +
> 
> +  @param[in] Aspm            set of parameters describing this link and endpoint
> devices below it
> 
> +
> 
> +  @retval    TRUE if L0s can be enabled
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsL0sAllowed (
> 
> +  ASPM_CAPS Aspm
> 
> +  )
> 
> +{
> 
> +  return (Aspm.L0sSupported && (Aspm.L0sAcceptableLatency >=
> Aspm.LinkL0sExitLatency));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enables L0s and L1 for given port, if possible.
> 
> +  L0s/L1 can be enabled if it's supported on both sides of a link and if link's
> latency doesn't exceed
> 
> +  acceptable latency of any endpoint below this link
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +  @param[in] Aspm            set of parameters describing this link and endpoint
> devices below it
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetAspm (
> 
> +  SBDF      Sbdf,
> 
> +  ASPM_CAPS Aspm
> 
> +  )
> 
> +{
> 
> +  UINT16 DataOr;
> 
> +
> 
> +  DataOr = 0;
> 
> +  if (IsL0sAllowed (Aspm)) {
> 
> +    DataOr |= V_PCIE_LCTL_ASPM_L0S;
> 
> +  }
> 
> +  if (IsL1Allowed (Aspm)) {
> 
> +    DataOr |= V_PCIE_LCTL_ASPM_L1;
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "SetAspm on %02x:%02x:%02x to %d\n",
> Sbdf.Bus,Sbdf.Dev,Sbdf.Func, DataOr));
> 
> +  PciSegmentAndThenOr16 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_LCTL_OFFSET, (UINT16)~B_PCIE_LCTL_ASPM, DataOr);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Adds device entry to a list of devices.
> 
> +
> 
> +  @param[in,out] Table    array of devices
> 
> +  @param[in]     Sbdf     segment:bus:device:function coordinates of device
> to be added to table
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +AddToDeviceTable (
> 
> +  SBDF_TABLE *Table,
> 
> +  SBDF       Sbdf
> 
> +  )
> 
> +{
> 
> +  if (Table->Count < MAX_SBDF_TABLE_SIZE) {
> 
> +    Table->Entry[Table->Count++] = Sbdf;
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Remove device entry from a list and clear its bus assignment
> 
> +
> 
> +  @param[in,out] Table    array of devices
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +ClearBusFromTable (
> 
> +  SBDF_TABLE *Table
> 
> +  )
> 
> +{
> 
> +  while (Table->Count > 0) {
> 
> +    PciSegmentWrite32 (SbdfToBase (Table->Entry[Table->Count - 1]) +
> PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, 0);
> 
> +    Table->Count--;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Attempts to assign secondary and subordinate bus numbers to
> uninitialized bridges in PCIe tree
> 
> +  If the device is a bridge and already has bus numbers assigned, they won't
> be changed
> 
> +  Otherwise new bus number will be assigned below this bridge.
> 
> +  This function can be called from SMM, where BIOS must not modify bus
> numbers to prevent
> 
> +  conflict with OS enumerator. To prevent this, this function returns list of
> bridges whose
> 
> +  bus numbers were changed. All devices from that list must have buses
> cleared afterwards.
> 
> +
> 
> +  @param[in] Sbdf                segment:bus:device:function coordinates of
> device to be added to table
> 
> +  @param[in] MinBus              minimum Bus number that can be assigned
> below this port
> 
> +  @param[in] MaxBus              maximum Bus number that can be assigned
> below this port
> 
> +  @param[in] BridgeCleanupList   list of bridges where bus numbers were
> modified
> 
> +
> 
> +  @retval    maximum bus number assigned anywhere below this device
> 
> +**/
> 
> +STATIC
> 
> +UINT8
> 
> +RecursiveBusAssignment (
> 
> +  SBDF       Sbdf,
> 
> +  UINT8      MinBus,
> 
> +  UINT8      MaxBus,
> 
> +  SBDF_TABLE *BridgeCleanupList
> 
> +  )
> 
> +{
> 
> +  UINT64  Base;
> 
> +  SBDF    ChildSbdf;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +  UINT32  Data32;
> 
> +  UINT8   BelowBus;
> 
> +  UINT8   SecondaryBus;
> 
> +  UINT8   SubordinateBus;
> 
> +
> 
> +  ChildSbdf.Seg = Sbdf.Seg;
> 
> +  InitChildFinder (&ChildSbdf);
> 
> +  Base = SbdfToBase (Sbdf);
> 
> +
> 
> +  //
> 
> +  // On way down:
> 
> +  //   assign secondary bus, then increase it by one before stepping down;
> temporarily assign max subordinate bus
> 
> +  // On way up:
> 
> +  //   fix subordinate bus assignment to equal max bus number assigned
> anywhere below; return that number
> 
> +  //
> 
> +  DevType = GetDeviceType (Sbdf);
> 
> +  if ((Sbdf.Bus >= MaxBus) || (DevType == DevTypePcieEndpoint) ||
> (DevType == DevTypePci)) {
> 
> +    return (UINT8) Sbdf.Bus;
> 
> +  } else  {
> 
> +    Data32 = PciSegmentRead32 (Base +
> PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET);
> 
> +    SecondaryBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SCBN) >> 8);
> 
> +    SubordinateBus = (UINT8)((Data32 & B_PCI_BRIDGE_BNUM_SBBN) >>
> 16);
> 
> +    if (SecondaryBus != 0) {
> 
> +      ChildSbdf.Bus = SecondaryBus;
> 
> +      MinBus = SecondaryBus + 1;
> 
> +      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentP %x:%x:%x ->
> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus, MinBus,
> SubordinateBus));
> 
> +      while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +        BelowBus = RecursiveBusAssignment (ChildSbdf, MinBus,
> SubordinateBus, BridgeCleanupList);
> 
> +        MinBus = BelowBus + 1;
> 
> +      }
> 
> +      return SubordinateBus;
> 
> +    } else {
> 
> +      Data32 = Sbdf.Bus + (MinBus << 8) + (MaxBus << 16);
> 
> +      PciSegmentWrite32(Base +
> PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, Data32);
> 
> +      AddToDeviceTable (BridgeCleanupList, Sbdf);
> 
> +      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentE %x:%x:%x ->
> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus, MinBus, MaxBus));
> 
> +      BelowBus = MinBus;
> 
> +      ChildSbdf.Bus = MinBus;
> 
> +      MinBus++;
> 
> +      while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +        BelowBus = RecursiveBusAssignment (ChildSbdf, MinBus, MaxBus,
> BridgeCleanupList);
> 
> +        MinBus = BelowBus + 1;
> 
> +      }
> 
> +      Data32  &= ~B_PCI_BRIDGE_BNUM_SBBN;
> 
> +      Data32 |= (BelowBus << 16);
> 
> +      PciSegmentWrite32 (Base +
> PCI_BRIDGE_PRIMARY_BUS_REGISTER_OFFSET, Data32);
> 
> +      DEBUG ((DEBUG_INFO, "RecursiveBusAssignmentL %x:%x:%x ->
> %x,%x,%x \n", Sbdf.Bus, Sbdf.Dev, Sbdf.Func, Sbdf.Bus,
> (Data32&0xFF00)>>8, BelowBus));
> 
> +      return BelowBus;
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enables L0s and/or L1 for PCIE links in the hierarchy below
> 
> +  L0s/L1 can be enabled when both sides of a link support it and link latency
> is smaller than acceptable latency
> 
> +  ASPM of a given link is independend from any other link (except 1ms L1
> adjustment, read below), so it's possible to
> 
> +  have a hierarchy when RP link has no ASPM but links below do.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] Depth                          How many links there are between this
> port and root complex
> 
> +  @param[in] Override                       Pch Pcie devices OverrideTable
> 
> +
> 
> +  @retval structure that describes acceptable latencies of all endpoints
> below plus ASPM parameters of last link
> 
> +**/
> 
> +STATIC
> 
> +ASPM_CAPS
> 
> +RecursiveAspmConfiguration (
> 
> +  SBDF           Sbdf,
> 
> +  UINT8          Depth,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  SBDF         ChildSbdf;
> 
> +  ASPM_CAPS    MyAspm;
> 
> +  ASPM_CAPS    ChildAspm;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveAspmConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  //
> 
> +  // On way down:
> 
> +  //   pass number of links traversed; increase it per upstream port visited
> (not endpoint)
> 
> +  // On way up:
> 
> +  //   EndPoint: read Acceptable Latencies; subtract Depth From
> L1AcceptableLat to account for "1us per switch additional delay"
> 
> +  //   Downstreamport: AND L0s/L1 caps; calculate LinkLatency; enable L0s/L1
> if supported and if acceptable latency is bigger than link latency;
> 
> +  //     if L1 not enabled, add back 1us to Acceptable Latency to cancel earlier
> Depth subtraction
> 
> +  //   UpstreamPort: calculate minimum of below Acceptable Latencies;
> return that, with upper link's Latency and L0s/L1 support
> 
> +  //
> 
> +  DevType = GetDeviceType(Sbdf);
> 
> +  if (DevType == DevTypePcieUpstream) {
> 
> +    Depth++;
> 
> +  }
> 
> +  MyAspm = GetAspmCaps (Sbdf);
> 
> +  //
> 
> +  // Get ASPM L0s and L1 override
> 
> +  //
> 
> +  if (Override != NULL) {
> 
> +    GetOverrideAspm (Sbdf, &MyAspm, Override);
> 
> +  }
> 
> +  if (DevType == DevTypePcieEndpoint) {
> 
> +    //
> 
> +    // Every switch between endpoint and CPU introduces 1us additional
> latency on L1 exit. This is reflected by
> 
> +    // subtracting 1us per switch from endpoint's acceptable L1 latency.
> 
> +    // In case L1 doesn't get enabled in one of switches, that 1us will be
> added back.
> 
> +    // This calculation is not precise. It ignores that some switches' added
> delay may be shadowed by
> 
> +    // other links' exit latency. But it guarantees that acceptable latency won't
> be exceeded and is simple
> 
> +    // enough to perform in a single iteration without backtracking.
> 
> +    //
> 
> +    return PatchL1AcceptableLatency (MyAspm, (-1 * Depth));
> 
> +  }
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      ChildAspm = RecursiveAspmConfiguration (ChildSbdf, Depth, Override);
> 
> +      MyAspm = CombineAspm (MyAspm, ChildAspm, (DevType ==
> DevTypePcieDownstream));
> 
> +    }
> 
> +    if (DevType == DevTypePcieDownstream) {
> 
> +      SetAspm (Sbdf, MyAspm);
> 
> +      //
> 
> +      // ASPM config must be consistent across all functions of a device. That's
> why there's while loop.
> 
> +      //
> 
> +      while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +        SetAspm (ChildSbdf, MyAspm);
> 
> +      }
> 
> +      if (!IsL1Allowed (MyAspm)) {
> 
> +        MyAspm = PatchL1AcceptableLatency (MyAspm, 1);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  return MyAspm;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enables L1 substates for PCIE links in the hierarchy below
> 
> +  L1.1 / L1.2 can be enabled if both sides of a link support it.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +
> 
> +  @retval  structure that describes L1ss capabilities of the device
> 
> +**/
> 
> +STATIC
> 
> +L1SS_CAPS
> 
> +RecursiveL1ssConfiguration (
> 
> +  SBDF           Sbdf,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  UINT64  Base;
> 
> +  SBDF    ChildSbdf;
> 
> +  L1SS_CAPS CombinedCaps;
> 
> +  L1SS_CAPS ChildCaps;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +  BOOLEAN   IsCpuPcie;
> 
> +  UINT32    DevNum;
> 
> +
> 
> +  IsCpuPcie = FALSE;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveL1ssConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  Base = SbdfToBase (Sbdf);
> 
> +  DevNum = Sbdf.Dev;
> 
> +  if (DevNum == SA_PEG0_DEV_NUM || DevNum == SA_PEG3_DEV_NUM)
> {
> 
> +    IsCpuPcie = TRUE;
> 
> +  }
> 
> +  //
> 
> +  // On way down:
> 
> +  //   do nothing
> 
> +  // On way up:
> 
> +  //   In downstream ports, combine L1ss capabilities of that port and device
> behind it, then enable L1.1 and/or L1.2 if possible
> 
> +  //   Return L1ss capabilities
> 
> +  //
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      ChildCaps = RecursiveL1ssConfiguration (ChildSbdf, Override);
> 
> +      if (DevType == DevTypePcieDownstream && ChildSbdf.Func == 0) {
> 
> +        CombinedCaps = CombineL1ss (GetL1ssCaps (Base, Override),
> ChildCaps);
> 
> +        SetL1ss (Sbdf, CombinedCaps, Override, IsCpuPcie);
> 
> +        SetL1ss (ChildSbdf, CombinedCaps, Override, IsCpuPcie);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  return GetL1ssCaps (Base, Override);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if there is an IoAPIC device in the PCIe hierarchy.
> 
> +  If one is found, this function doesn't check for more and returns
> 
> +
> 
> +  @param[in] BusLimit                       maximum Bus number that can be
> assigned below this port
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +
> 
> +  @retval  TRUE if IoAPIC device was found
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +RecursiveIoApicCheck (
> 
> +  SBDF       Sbdf
> 
> +  )
> 
> +{
> 
> +  SBDF         ChildSbdf;
> 
> +  UINT8        IoApicPresent;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveIoApicCheck %x:%x:%x\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  IoApicPresent = FALSE;
> 
> +
> 
> +  if (IsIoApicDevice (SbdfToBase (Sbdf))) {
> 
> +    DEBUG ((DEBUG_INFO, "IoApicFound @%x:%x:%x:%x\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +    return TRUE;
> 
> +  }
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      IoApicPresent = RecursiveIoApicCheck (ChildSbdf);
> 
> +      if (IoApicPresent) {
> 
> +        break;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "IoApic status %d @%x:%x:%x:%x\n",
> IoApicPresent, Sbdf.Seg, Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +  return IoApicPresent;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Calculates Maximum Payload Size supported by PCIe hierarchy.
> 
> +  Starting from a device, it finds the minimum MPS supported by devices
> below it.
> 
> +  There are many valid strategies for setting MPS. This implementation
> chooses
> 
> +  one that is safest, but doesn't guarantee maximum performance:
> 
> +    Find minimum MPS under given rootport, then program that minimum
> value everywhere below that rootport
> 
> +
> 
> +  @param[in] BusLimit                       maximum Bus number that can be
> assigned below this port
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +
> 
> +  @retval  MPS supported by PCIe hierarchy, calculated as MIN(MPS of all
> devices below)
> 
> +**/
> 
> +STATIC
> 
> +UINT8
> 
> +RecursiveMpsCheck (
> 
> +  SBDF       Sbdf
> 
> +  )
> 
> +{
> 
> +  SBDF         ChildSbdf;
> 
> +  UINT8        MyMps;
> 
> +  UINT8        SubtreeMps;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveMpsCheck %x:%x:%x\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  MyMps = GetMps (Sbdf);
> 
> +  if (MyMps == 0) {
> 
> +    return MyMps;
> 
> +  }
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      SubtreeMps = RecursiveMpsCheck (ChildSbdf);
> 
> +      MyMps = MIN(MyMps, SubtreeMps);
> 
> +    }
> 
> +  }
> 
> +  return MyMps;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Maximum Payload Size in PCIe hierarchy.
> 
> +  Starting from a device, it programs the same MPS value to it and all devices
> below it.
> 
> +  There are many valid strategies for setting MPS. This implementation
> chooses
> 
> +  one that is safest, but doesn't guarantee maximum performance:
> 
> +    Find minimum MPS under given rootport, then program that minimum
> value everywhere below that rootport
> 
> +
> 
> +  @param[in] BusLimit                       maximum Bus number that can be
> assigned below this port
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] Mps                            Maximum Payload Size to be programmed
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +RecursiveMpsConfiguration (
> 
> +  SBDF       Sbdf,
> 
> +  UINT8      Mps
> 
> +  )
> 
> +{
> 
> +  SBDF    ChildSbdf;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveMpsConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      RecursiveMpsConfiguration (ChildSbdf, Mps);
> 
> +    }
> 
> +  }
> 
> +  SetMps (Sbdf, Mps);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Enable Clock Power Management bit for devices that support it.
> 
> +  A device supports CPM only if all function of this device report CPM
> support.
> 
> +  Downstream ports never report CPM capability, so it's only relevant for
> upstream ports.
> 
> +  When this function executes on upstream component, it will check CPM &
> set ECPM of downstream component
> 
> +  When this function executes on downstream component, all devices
> below it are guaranteed to
> 
> +  return CPM=0 so it will do nothing
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +
> 
> +  @retval TRUE = this device supports CPM, FALSE = it doesn't
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +RecursiveCpmConfiguration (
> 
> +  SBDF       Sbdf
> 
> +  )
> 
> +{
> 
> +  SBDF         ChildSbdf;
> 
> +  BOOLEAN      ChildCpm;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveCpmConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  ChildCpm = FALSE;
> 
> +
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    ChildCpm = TRUE;
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      ChildCpm &= RecursiveCpmConfiguration (ChildSbdf);
> 
> +    }
> 
> +    if (ChildCpm) {
> 
> +      while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +        EnableCpm (ChildSbdf);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  return IsCpmSupported (Sbdf);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Common Clock Configuration bit for devices that share common clock
> across link
> 
> +  Devices on both sides of a PCIE link share common clock if both upstream
> component
> 
> +  and function 0 of downstream component report Slot Clock Configuration
> bit = 1.
> 
> +  When this function executes on upstream component, it checks SCC of
> both sides of the link
> 
> +  If they both support it, sets CCC for both sides (this means all functions of
> downstream component)
> 
> +  When this function executes on downstream component, it only returns
> SCC capability
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] WaitForRetrain                 decides if this function should busy-
> wait for link retrain
> 
> +
> 
> +  @retval TRUE = this device supports SCC, FALSE = it doesn't
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +RecursiveCccConfiguration (
> 
> +  SBDF       Sbdf,
> 
> +  BOOLEAN    WaitForRetrain
> 
> +  )
> 
> +{
> 
> +  UINT64       Base;
> 
> +  SBDF         ChildSbdf;
> 
> +  BOOLEAN      MyScc;
> 
> +  BOOLEAN      ChildScc;
> 
> +  BOOLEAN      LinkScc;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveCccConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  ChildScc = 0;
> 
> +  Base = SbdfToBase(Sbdf);
> 
> +  MyScc = GetScc (SbdfToBase(Sbdf), (UINT8)Sbdf.PcieCap);
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      ChildScc |= RecursiveCccConfiguration (ChildSbdf, WaitForRetrain);
> 
> +    }
> 
> +    if (DevType == DevTypePcieDownstream) {
> 
> +      LinkScc = MyScc & ChildScc;
> 
> +      if (LinkScc) {
> 
> +        EnableCcc (SbdfToBase(Sbdf), (UINT8)Sbdf.PcieCap);
> 
> +        while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +          EnableCcc (SbdfToBase(ChildSbdf), (UINT8)ChildSbdf.PcieCap);
> 
> +        }
> 
> +        RetrainLink(Base, (UINT8)Sbdf.PcieCap, WaitForRetrain);
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  return MyScc;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures Latency Tolerance Reporting in given device and in PCIe tree
> below it.
> 
> +  This function configures Maximum LTR and enables LTR mechanism. It
> visits devices using depth-first search
> 
> +  and skips branches behind devices which do not support LTR.
> 
> +  Maximum LTR:
> 
> +    This function will set LTR's upper bound for every visited device. Max LTR
> value is provided as a parameter
> 
> +  Enable LTR:
> 
> +    LTR should be enabled top-to-bottom in every visited device that
> supports LTR. This function does not
> 
> +    iterate down behind devices with no LTR support. In effect, LTR will be
> enabled in given device if that device
> 
> +    and all devices above it on the way to RootComplex do support LTR.
> 
> +
> 
> +  This function expects that bridges have bus numbers already configured
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] LtrLimit                       Ltr to be programmed to every endpoint
> 
> +
> 
> +  @retval MaxLTR programmed in this device
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +RecursiveLtrConfiguration (
> 
> +  SBDF       Sbdf,
> 
> +  LTR_LIMIT  LtrLimit
> 
> +  )
> 
> +{
> 
> +  UINT64  Base;
> 
> +  SBDF    ChildSbdf;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveLtrConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  Base = SbdfToBase(Sbdf);
> 
> +
> 
> +  if (!IsLtrCapable (Sbdf)) {
> 
> +    DEBUG ((DEBUG_INFO, "Not LtrCapable %02x:%02x:%02x\n", Sbdf.Bus,
> Sbdf.Dev, Sbdf.Func));
> 
> +    return;
> 
> +  }
> 
> +  EnableLtr (Sbdf);
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      RecursiveLtrConfiguration (ChildSbdf, LtrLimit);
> 
> +    }
> 
> +  }
> 
> +  SetLtrLimit (Base, LtrLimit);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks to see device is PTM Capable
> 
> +
> 
> +  @param[in] Sbdf    device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval TRUE = PTM Capability found, FALSE = Not PTM capable
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsPtmCapable (
> 
> +  SBDF       Sbdf
> 
> +  )
> 
> +{
> 
> +  UINT16     CapHeaderOffset;
> 
> +
> 
> +  CapHeaderOffset = PcieFindExtendedCapId ((UINT8) Sbdf.Seg, (UINT8)
> Sbdf.Bus, (UINT8) Sbdf.Dev, (UINT8) Sbdf.Func, V_PCIE_EX_PTM_CID);
> 
> +
> 
> +  return (CapHeaderOffset != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PTM Capability register from PCIe Extended Capability Space.
> 
> +
> 
> +  @param[in] Sbdf                device's segment:bus:device:function
> coordinates
> 
> +  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
> 
> +
> 
> +  @retval LocalPtm       Returns PTM Capability.
> 
> +                         If Device is not PTM capable then PTM Capability is zeroed out.
> 
> +**/
> 
> +STATIC
> 
> +PTM_CAPS
> 
> +GetPtmCapability (
> 
> +  SBDF      Sbdf,
> 
> +  UINT16    PtmCapHeaderOffset
> 
> +  )
> 
> +{
> 
> +  PTM_CAPS PtmCaps;
> 
> +
> 
> +  PtmCaps.Uint32 = 0;
> 
> +
> 
> +  if (PtmCapHeaderOffset != 0) {
> 
> +    PtmCaps.Uint32 = PciSegmentRead32 (SbdfToBase (Sbdf) +
> PtmCapHeaderOffset + R_PCIE_EX_PTMCAP_OFFSET);
> 
> +  }
> 
> +
> 
> +  return PtmCaps;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PTM Control register from PCIe Extended Capability Space.
> 
> +
> 
> +  @param[in] Sbdf                device's segment:bus:device:function
> coordinates
> 
> +  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
> 
> +
> 
> +  @retval LocalPtm       Returns PTM Control.
> 
> +                         If Device is not PTM capable then PTM Control is zeroed out.
> 
> +**/
> 
> +STATIC
> 
> +PTM_CTRL
> 
> +GetPtmControl (
> 
> +  SBDF      Sbdf,
> 
> +  UINT16    PtmCapHeaderOffset
> 
> +  )
> 
> +{
> 
> +  PTM_CTRL PtmCtrl;
> 
> +
> 
> +  PtmCtrl.Uint32 = 0;
> 
> +
> 
> +  if (PtmCapHeaderOffset != 0) {
> 
> +    PtmCtrl.Uint32 = PciSegmentRead32 (SbdfToBase (Sbdf) +
> PtmCapHeaderOffset + R_PCIE_EX_PTMCTL_OFFSET);
> 
> +  }
> 
> +
> 
> +  return PtmCtrl;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PTM Control register in the PCIe Extended Capability Space.
> 
> +
> 
> +  @param[in] Sbdf                device's segment:bus:device:function
> coordinates
> 
> +  @param[in] PtmCapHeaderOffset  PTM Capability Header Offset
> 
> +  @param[in] PtmCtrl             PTM Control Register
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetPtmControl (
> 
> +  SBDF      Sbdf,
> 
> +  UINT16    PtmCapHeaderOffset,
> 
> +  PTM_CTRL  PtmCtrl
> 
> +  )
> 
> +{
> 
> +  if (PtmCapHeaderOffset != 0) {
> 
> +    PciSegmentWrite32 (SbdfToBase (Sbdf) + PtmCapHeaderOffset +
> R_PCIE_EX_PTMCTL_OFFSET, PtmCtrl.Uint32);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enable PTM on device's control register. Set the Effective Clock
> Granularity.
> 
> +
> 
> +  @param[in]     Sbdf                 device's segment:bus:device:function
> coordinates
> 
> +  @param[in out] EffectiveGranularity Effective Clock Granularity of the PTM
> hierarchy
> 
> +  @param[in out] PtmHierarchy         Indicates if the current device is within a
> PTM hierarchy
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +SetPtm (
> 
> +  IN     SBDF       Sbdf,
> 
> +  IN OUT UINT8      *EffectiveGranularity,
> 
> +  IN OUT BOOLEAN    *PtmHierarchy
> 
> +  )
> 
> +{
> 
> +  PTM_CTRL CurrentPtmCtrl;
> 
> +  PTM_CAPS CurrentPtmCaps;
> 
> +  PTM_CTRL OrigPtmCtrl;
> 
> +  UINT16   PtmCapHeaderOffset;
> 
> +
> 
> +  PtmCapHeaderOffset = PcieFindExtendedCapId ((UINT8) Sbdf.Seg,
> (UINT8) Sbdf.Bus, (UINT8) Sbdf.Dev, (UINT8) Sbdf.Func,
> V_PCIE_EX_PTM_CID);
> 
> +  CurrentPtmCtrl = GetPtmControl (Sbdf, PtmCapHeaderOffset);
> 
> +  CurrentPtmCaps = GetPtmCapability (Sbdf, PtmCapHeaderOffset);
> 
> +
> 
> +  OrigPtmCtrl.Uint32 = CurrentPtmCtrl.Uint32;
> 
> +
> 
> +  if ( (*PtmHierarchy == FALSE) && CurrentPtmCaps.Bits.RootCapable) {
> 
> +    // Select device as PTM Root if PTM Root is not selected.
> 
> +    CurrentPtmCtrl.Bits.RootSelect = TRUE;
> 
> +    *EffectiveGranularity = (UINT8)
> CurrentPtmCaps.Bits.LocalClockGranularity;
> 
> +    *PtmHierarchy = TRUE;
> 
> +  }
> 
> +
> 
> +  if (*PtmHierarchy == TRUE) {
> 
> +    // Enable PTM if device is part of a ptm hierarchy
> 
> +    CurrentPtmCtrl.Bits.Enable = TRUE;
> 
> +
> 
> +    if (CurrentPtmCaps.Bits.RequesterCapable) {
> 
> +      // Set Effective Granularity if PTM device is Requester roles.
> 
> +      CurrentPtmCtrl.Bits.EffectiveGranularity = *EffectiveGranularity;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (OrigPtmCtrl.Uint32 != CurrentPtmCtrl.Uint32) {
> 
> +    SetPtmControl (Sbdf, PtmCapHeaderOffset, CurrentPtmCtrl);
> 
> +  }
> 
> +
> 
> +  // Update EffectiveGranularity.
> 
> +  // Set to zero if 1 or more switches between the root and endpoint report
> local granularity = 0.
> 
> +  // Otherwise set to the max local granularity of the hierarchy.
> 
> +  if ( ((CurrentPtmCaps.Bits.LocalClockGranularity == 0) &&
> CurrentPtmCaps.Bits.RequesterCapable) ||
> 
> +       (*EffectiveGranularity  == 0) ) {
> 
> +    *EffectiveGranularity = 0;
> 
> +  } else {
> 
> +    *EffectiveGranularity = MAX (*EffectiveGranularity, (UINT8)
> CurrentPtmCaps.Bits.LocalClockGranularity);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures PTM hierarchies by searching for Endpoints and Upstream
> Switches
> 
> +  that are PTM capable. Each PTM device role is identified and configured
> accordingly.
> 
> +  PTM root capable devices are selected as PTM root if the device is not
> already in a
> 
> +  PTM hierarchy.
> 
> +  PTM capable Root Ports must be configured before calling this function.
> 
> +  @note: This function has not been tested with switches.
> 
> +
> 
> +  @param[in] Sbdf                 Address of curretly visited Pcie device
> 
> +  @param[in] EffectiveGranularity The largest Clock Granularity from
> Upstream Devices
> 
> +  @param[in] PtmHierarchy         TRUE = Device in a PTM Hierarchy, FALSE =
> Not in PTM Hierarchy
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +RecursivePtmConfiguration (
> 
> +  SBDF          Sbdf,
> 
> +  UINT8         EffectiveGranularity,
> 
> +  BOOLEAN       PtmHierarchy
> 
> +  )
> 
> +{
> 
> +  SBDF         ChildSbdf;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursivePtmConfiguration %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  DevType = GetDeviceType (Sbdf);
> 
> +
> 
> +  if (IsPtmCapable (Sbdf)) {
> 
> +    //
> 
> +    // Enable PTM for PTM Capable devices (Endpoints, Upstream Switch, and
> Root Ports).
> 
> +    // @Note: Switches have not been tested.
> 
> +    //
> 
> +    SetPtm (Sbdf, &EffectiveGranularity, &PtmHierarchy);
> 
> +  } else if (!IsPtmCapable (Sbdf) && (DevType == DevTypePcieUpstream) ) {
> 
> +    //
> 
> +    // Non-PTM UpStream Switch Ports breaks the PTM Hierarchy.
> 
> +    // No other downstream PTM devices should be PTM enabled until a PTM
> Root capable device is selected.
> 
> +    //
> 
> +    PtmHierarchy = FALSE;
> 
> +    EffectiveGranularity = 0;
> 
> +  }
> 
> +
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      RecursivePtmConfiguration (ChildSbdf, EffectiveGranularity,
> PtmHierarchy);
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initializes the following features in rootport and devices behind it:
> 
> +  Maximum Payload Size (generic)
> 
> +  Rootport packet split (proprietary)
> 
> +  EonOfInterrupt forwarding (proprietary)
> 
> +  Common Clock Configuration (generic)
> 
> +
> 
> +  Generic: any code written according to PCIE Express base specification can
> do that.
> 
> +  Proprietary: code uses registers and features that are specific to Intel
> silicon
> 
> +  and probably only this Reference Code knows how to handle that.
> 
> +
> 
> +  If OEM implemented generic feature enabling in his platform code or
> trusts Operating System
> 
> +  to do it, then those features can be deleted from here.
> 
> +
> 
> +  CCC requires link retrain, which takes a while. CCC must happen before
> L0s/L1 programming.
> 
> +  If there was guarantee no code would access PCI while links retrain, it
> would be possible to skip this waiting
> 
> +
> 
> +  @param[in] RpSegment  address of rootport on PCIe
> 
> +  @param[in] RpBus      address of rootport on PCIe
> 
> +  @param[in] RpDevice   address of rootport on PCIe
> 
> +  @param[in] RpFunction address of rootport on PCIe
> 
> +  @param[in] BusMin     minimum Bus number that can be assigned below
> this rootport
> 
> +  @param[in] BusMax     maximum Bus number that can be assigned below
> this rootport
> 
> +**/
> 
> +VOID
> 
> +RootportDownstreamConfiguration (
> 
> +  UINT8                     RpSegment,
> 
> +  UINT8                     RpBus,
> 
> +  UINT8                     RpDevice,
> 
> +  UINT8                     RpFunction,
> 
> +  UINT8                     BusMin,
> 
> +  UINT8                     BusMax,
> 
> +  PCI_SKU                   PciSku
> 
> +  )
> 
> +{
> 
> +  UINT8           Mps;
> 
> +  BOOLEAN         IoApicPresent;
> 
> +  UINT64          RpBase;
> 
> +  SBDF            RpSbdf;
> 
> +  SBDF_TABLE      BridgeCleanupList;
> 
> +
> 
> +  IoApicPresent = FALSE;
> 
> +  RpBase = PCI_SEGMENT_LIB_ADDRESS (RpSegment, RpBus, RpDevice,
> RpFunction, 0);
> 
> +  if (!(IsDevicePresent (RpBase))) {
> 
> +    return;
> 
> +  }
> 
> +  RpSbdf.Seg = RpSegment;
> 
> +  RpSbdf.Bus = RpBus;
> 
> +  RpSbdf.Dev = RpDevice;
> 
> +  RpSbdf.Func = RpFunction;
> 
> +  RpSbdf.PcieCap = PcieBaseFindCapId (RpBase,
> EFI_PCI_CAPABILITY_ID_PCIEXP);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RootportDownstreamConfiguration %x:%x\n",
> RpDevice, RpFunction));
> 
> +  BridgeCleanupList.Count = 0;
> 
> +  RecursiveBusAssignment (RpSbdf, BusMin, BusMax, &BridgeCleanupList);
> 
> +
> 
> +  Mps = RecursiveMpsCheck (RpSbdf);
> 
> +  RecursiveMpsConfiguration (RpSbdf, Mps);
> 
> +  if (PciSku == EnumPchPcie) {
> 
> +    RpBase = SbdfToBase (RpSbdf);
> 
> +    ConfigureRpPacketSplit(RpBase, Mps);
> 
> +    IoApicPresent = RecursiveIoApicCheck(RpSbdf);
> 
> +  }
> 
> +  if ((PciSku == EnumPchPcie) || (PciSku == EnumCpuPcie)) {
> 
> +    ConfigureEoiForwarding (RpBase, IoApicPresent);
> 
> +  }
> 
> +  RecursiveCccConfiguration (RpSbdf, TRUE);
> 
> +
> 
> +  if (IsPtmCapable (RpSbdf)) {
> 
> +    RecursivePtmConfiguration (RpSbdf, 0, FALSE);
> 
> +  }
> 
> +
> 
> +  ClearBusFromTable (&BridgeCleanupList);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if given PCI device is capable of Latency Tolerance Reporting
> 
> +
> 
> +  @param[in] Sbdf            device's segment:bus:device:function coordinates
> 
> +
> 
> +  @retval TRUE if yes
> 
> +**/
> 
> +BOOLEAN
> 
> +IsLtrCapable (
> 
> +  SBDF Sbdf
> 
> +  )
> 
> +{
> 
> +  if (Sbdf.PcieCap == 0) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  return !!(PciSegmentRead32 (SbdfToBase (Sbdf) + Sbdf.PcieCap +
> R_PCIE_DCAP2_OFFSET) & B_PCIE_DCAP2_LTRMS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns combination of two LTR override values
> 
> +  The resulting LTR override separately chooses stricter limits for snoop and
> nosnoop
> 
> +
> 
> +  @param[in] LtrA      LTR override values to be combined
> 
> +  @param[in] LtrB      LTR override values to be combined
> 
> +
> 
> +  @retval LTR override value
> 
> +**/
> 
> +LTR_OVERRIDE
> 
> +CombineLtr (
> 
> +  LTR_OVERRIDE LtrA,
> 
> +  LTR_OVERRIDE LtrB
> 
> +  )
> 
> +{
> 
> +  UINT64        DecodedLatencyA;
> 
> +  UINT64        DecodedLatencyB;
> 
> +  LTR_OVERRIDE  Result;
> 
> +  static UINT32 ScaleEncoding [8] = {1, 32, 1024, 32768, 1048576, 33554432, 0,
> 0};
> 
> +
> 
> +  ZeroMem (&Result, sizeof (LTR_OVERRIDE));
> 
> +  DecodedLatencyA = ScaleEncoding[LtrA.MaxSnoopLatencyScale] *
> LtrA.MaxSnoopLatencyValue;
> 
> +  DecodedLatencyB = ScaleEncoding[LtrB.MaxSnoopLatencyScale] *
> LtrB.MaxSnoopLatencyValue;
> 
> +  if ((!LtrB.MaxSnoopLatencyRequirement) || ((DecodedLatencyA <
> DecodedLatencyB) && LtrA.MaxSnoopLatencyRequirement)) {
> 
> +    Result.MaxSnoopLatencyValue       = LtrA.MaxSnoopLatencyValue;
> 
> +    Result.MaxSnoopLatencyScale       = LtrA.MaxSnoopLatencyScale;
> 
> +    Result.MaxSnoopLatencyRequirement =
> LtrA.MaxSnoopLatencyRequirement;
> 
> +  } else {
> 
> +    Result.MaxSnoopLatencyValue       = LtrB.MaxSnoopLatencyValue;
> 
> +    Result.MaxSnoopLatencyScale       = LtrB.MaxSnoopLatencyScale;
> 
> +    Result.MaxSnoopLatencyRequirement =
> LtrB.MaxSnoopLatencyRequirement;
> 
> +  }
> 
> +  DecodedLatencyA = ScaleEncoding[LtrA.MaxNoSnoopLatencyScale] *
> LtrA.MaxNoSnoopLatencyValue;
> 
> +  DecodedLatencyB = ScaleEncoding[LtrB.MaxNoSnoopLatencyScale] *
> LtrB.MaxNoSnoopLatencyValue;
> 
> +  if ((!LtrB.MaxNoSnoopLatencyRequirement) || ((DecodedLatencyA <
> DecodedLatencyB) && LtrA.MaxNoSnoopLatencyRequirement)) {
> 
> +    Result.MaxNoSnoopLatencyValue       = LtrA.MaxNoSnoopLatencyValue;
> 
> +    Result.MaxNoSnoopLatencyScale       = LtrA.MaxNoSnoopLatencyScale;
> 
> +    Result.MaxNoSnoopLatencyRequirement =
> LtrA.MaxNoSnoopLatencyRequirement;
> 
> +  } else {
> 
> +    Result.MaxNoSnoopLatencyValue       = LtrB.MaxNoSnoopLatencyValue;
> 
> +    Result.MaxNoSnoopLatencyScale       = LtrB.MaxNoSnoopLatencyScale;
> 
> +    Result.MaxNoSnoopLatencyRequirement =
> LtrB.MaxNoSnoopLatencyRequirement;
> 
> +  }
> 
> +  if (LtrA.ForceOverride || LtrB.ForceOverride) {
> 
> +    Result.ForceOverride = TRUE;
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "CombineLtr: A(V%d S%d E%d : V%d S%d E%d,
> F%d)\n",
> 
> +    LtrA.MaxSnoopLatencyValue, LtrA.MaxSnoopLatencyScale,
> LtrA.MaxSnoopLatencyRequirement,
> 
> +    LtrA.MaxNoSnoopLatencyValue, LtrA.MaxNoSnoopLatencyScale,
> LtrA.MaxNoSnoopLatencyRequirement,
> 
> +    LtrA.ForceOverride
> 
> +    ));
> 
> +  DEBUG ((DEBUG_INFO, "          : B(V%d S%d E%d : V%d S%d E%d, F%d)\n",
> 
> +    LtrB.MaxSnoopLatencyValue, LtrB.MaxSnoopLatencyScale,
> LtrB.MaxSnoopLatencyRequirement,
> 
> +    LtrB.MaxNoSnoopLatencyValue, LtrB.MaxNoSnoopLatencyScale,
> LtrB.MaxNoSnoopLatencyRequirement,
> 
> +    LtrB.ForceOverride
> 
> +    ));
> 
> +  DEBUG ((DEBUG_INFO, "          : R(V%d S%d E%d : V%d S%d E%d, F%d)\n",
> 
> +    Result.MaxSnoopLatencyValue, Result.MaxSnoopLatencyScale,
> Result.MaxSnoopLatencyRequirement,
> 
> +    Result.MaxNoSnoopLatencyValue, Result.MaxNoSnoopLatencyScale,
> Result.MaxNoSnoopLatencyRequirement,
> 
> +    Result.ForceOverride
> 
> +    ));
> 
> +  return Result;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns LTR override value for given device
> 
> +  The value is extracted from Device Override table. If the device is not
> found,
> 
> +  the returned value will have Requirement bits clear
> 
> +
> 
> +  @param[in] Base            device's base address
> 
> +  @param[in] Override        device override table
> 
> +
> 
> +  @retval LTR override value
> 
> +**/
> 
> +LTR_OVERRIDE
> 
> +GetOverrideLtr (
> 
> +  UINT64         Base,
> 
> +  OVERRIDE_TABLE *Override
> 
> +  )
> 
> +{
> 
> +  UINT16       DevId;
> 
> +  UINT16       VenId;
> 
> +  UINT16       RevId;
> 
> +  UINT32       Index;
> 
> +  LTR_OVERRIDE ReturnValue = {0};
> 
> +
> 
> +  VenId = PciSegmentRead16 (Base + PCI_VENDOR_ID_OFFSET);
> 
> +  DevId = PciSegmentRead16 (Base + PCI_DEVICE_ID_OFFSET);
> 
> +  RevId = PciSegmentRead16 (Base + PCI_REVISION_ID_OFFSET);
> 
> +
> 
> +  for (Index = 0; Index < Override->Size; Index++) {
> 
> +    if (((Override->Table[Index].OverrideConfig & PchPcieLtrOverride) ==
> PchPcieLtrOverride) &&
> 
> +        (Override->Table[Index].VendorId == VenId) &&
> 
> +        ((Override->Table[Index].DeviceId == DevId) || (Override-
> >Table[Index].DeviceId == 0xFFFF)) &&
> 
> +        ((Override->Table[Index].RevId == RevId) || (Override-
> >Table[Index].RevId == 0xFF))) {
> 
> +      if (Override->Table[Index].SnoopLatency & 0x8000) {
> 
> +        ReturnValue.MaxSnoopLatencyRequirement = 1;
> 
> +        ReturnValue.MaxSnoopLatencyValue = Override-
> >Table[Index].SnoopLatency & 0x3FF;
> 
> +        ReturnValue.MaxSnoopLatencyScale = (Override-
> >Table[Index].SnoopLatency & 0x1C00) >> 10;
> 
> +      }
> 
> +      if (Override->Table[Index].NonSnoopLatency & 0x8000) {
> 
> +        ReturnValue.MaxNoSnoopLatencyRequirement = 1;
> 
> +        ReturnValue.MaxNoSnoopLatencyValue = Override-
> >Table[Index].NonSnoopLatency & 0x3FF;
> 
> +        ReturnValue.MaxNoSnoopLatencyScale = (Override-
> >Table[Index].NonSnoopLatency & 0x1C00) >> 10;
> 
> +      }
> 
> +      ReturnValue.ForceOverride = Override->Table[Index].ForceLtrOverride;
> 
> +      break;
> 
> +    }
> 
> +  }
> 
> +  return ReturnValue;
> 
> +}
> 
> +
> 
> +/**
> 
> +  In accordance with PCIe spec, devices with no LTR support are considered
> to have no LTR requirements
> 
> +  which means infinite latency tolerance. This was found to cause problems
> with HID and Audio devices without LTR
> 
> +  support placed behind PCIe switches with LTR support, as Switch's
> upstream link would be allowed to enter L1.2
> 
> +  and cause large latency downstream. To work around such issues and to fix
> some devices with broken
> 
> +  LTR reporting, Device Override table was introduced.
> 
> +  This function scans PCIe tree for devices mentioned in override table and
> calculates the strictest
> 
> +  LTR requirement between them. That value will be programmed into
> rootport's LTR override register
> 
> +
> 
> +  This function expects that bridges have bus numbers already configured
> 
> +
> 
> +  @param[in] BusLimit                       maximum Bus number that can be
> assigned below this port
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] AspmOverride                   Device specific ASPM policy override
> items
> 
> +
> 
> +  @retval MaxLTR programmed in this device
> 
> +**/
> 
> +LTR_OVERRIDE
> 
> +RecursiveLtrOverrideCheck (
> 
> +  SBDF           Sbdf,
> 
> +  OVERRIDE_TABLE *AspmOverride
> 
> +  )
> 
> +{
> 
> +  UINT64       Base;
> 
> +  SBDF         ChildSbdf;
> 
> +  LTR_OVERRIDE MyLtrOverride;
> 
> +  LTR_OVERRIDE ChildLtr;
> 
> +  PCI_DEV_TYPE DevType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RecursiveLtrOverrideCheck %x:%x:%x\n",
> Sbdf.Bus, Sbdf.Dev, Sbdf.Func));
> 
> +
> 
> +  Base = SbdfToBase(Sbdf);
> 
> +
> 
> +  MyLtrOverride = GetOverrideLtr (Base, AspmOverride);
> 
> +  if (HasChildBus (Sbdf, &ChildSbdf)) {
> 
> +    DevType = GetDeviceType (Sbdf);
> 
> +    while (FindNextPcieChild (DevType, &ChildSbdf)) {
> 
> +      ChildLtr = RecursiveLtrOverrideCheck (ChildSbdf, AspmOverride);
> 
> +      MyLtrOverride = CombineLtr (MyLtrOverride, ChildLtr);
> 
> +    }
> 
> +  }
> 
> +  return MyLtrOverride;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures the following power-management related features in rootport
> and devices behind it:
> 
> +  LTR limit (generic)
> 
> +  LTR override (proprietary)
> 
> +  Clock Power Management (generic)
> 
> +  L1 substates (generic except for the override table)
> 
> +  L1.LOW substate (proprietary)
> 
> +  L0s and L1 (generic)
> 
> +
> 
> +  Generic: any code written according to PCIE Express base specification can
> do that.
> 
> +  Proprietary: code uses registers and features that are specific to Intel
> silicon
> 
> +  and probably only this Reference Code knows how to handle that.
> 
> +
> 
> +  If OEM implemented generic feature enabling in his platform code or
> trusts Operating System
> 
> +  to do it, then those features can be deleted from here.
> 
> +
> 
> +  @param[in] RpSegment                address of rootport on PCIe
> 
> +  @param[in] RpBus                    address of rootport on PCIe
> 
> +  @param[in] RpDevice                 address of rootport on PCIe
> 
> +  @param[in] RpFunction               address of rootport on PCIe
> 
> +  @param[in] BusLimit                 maximum Bus number that can be assigned
> below this rootport
> 
> +  @param[in] PcieRpLtrConfig          address of LTR Policy struct
> 
> +  @param[in] PcieRpCommonConfig       address of Common PCIe Policy
> struct
> 
> +  @param[in] AspmOverrideTableSize    size of override array
> 
> +  @param[in] AspmOverrideTable        array of device that need exceptions
> in configuration
> 
> +**/
> 
> +VOID
> 
> +RootportDownstreamPmConfiguration (
> 
> +  UINT8                               RpSegment,
> 
> +  UINT8                               RpBus,
> 
> +  UINT8                               RpDevice,
> 
> +  UINT8                               RpFunction,
> 
> +  UINT8                               BusMin,
> 
> +  UINT8                               BusMax,
> 
> +  PCIE_ROOT_PORT_COMMON_CONFIG        *PcieRpCommonConfig,
> 
> +  UINT32                              AspmOverrideTableSize,
> 
> +  PCH_PCIE_DEVICE_OVERRIDE            *AspmOverrideTable
> 
> +  )
> 
> +{
> 
> +  LTR_LIMIT      PolicyLtr;
> 
> +  LTR_OVERRIDE   TreeLtr;
> 
> +  OVERRIDE_TABLE PmOverrideTable;
> 
> +  UINT64         RpBase;
> 
> +  SBDF           RpSbdf;
> 
> +  SBDF_TABLE     BridgeCleanupList;
> 
> +
> 
> +  RpBase = PCI_SEGMENT_LIB_ADDRESS (RpSegment, RpBus, RpDevice,
> RpFunction, 0);
> 
> +  if (!(IsDevicePresent (RpBase))) {
> 
> +    return;
> 
> +  }
> 
> +  PmOverrideTable.Size = AspmOverrideTableSize;
> 
> +  PmOverrideTable.Table = AspmOverrideTable;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "RootportDownstreamPmConfiguration
> %x:%x\n", RpDevice, RpFunction));
> 
> +  PolicyLtr.MaxNoSnoopLatencyScale = (PcieRpCommonConfig-
> >PcieRpLtrConfig.LtrMaxNoSnoopLatency & 0x1c00) >> 10;
> 
> +  PolicyLtr.MaxNoSnoopLatencyValue = PcieRpCommonConfig-
> >PcieRpLtrConfig.LtrMaxNoSnoopLatency & 0x3FF;
> 
> +  PolicyLtr.MaxSnoopLatencyScale   = (PcieRpCommonConfig-
> >PcieRpLtrConfig.LtrMaxSnoopLatency & 0x1c00) >> 10;
> 
> +  PolicyLtr.MaxSnoopLatencyValue   = PcieRpCommonConfig-
> >PcieRpLtrConfig.LtrMaxSnoopLatency & 0x3FF;
> 
> +
> 
> +  RpSbdf.Seg = RpSegment;
> 
> +  RpSbdf.Bus = RpBus;
> 
> +  RpSbdf.Dev = RpDevice;
> 
> +  RpSbdf.Func = RpFunction;
> 
> +  RpSbdf.PcieCap = PcieBaseFindCapId (RpBase,
> EFI_PCI_CAPABILITY_ID_PCIEXP);
> 
> +  //
> 
> +  // This code could execute either before or after enumeration. If before,
> then buses would not yet be assigned to bridges,
> 
> +  // making devices deeper in the hierarchy inaccessible.
> 
> +  // RecursiveBusAssignment will scan whole PCie tree and assign bus
> numbers to uninitialized bridges, if there are any
> 
> +  // List of such bridges will be kept in CleanupList, so that after PM
> programming is done, bus numbers can brought to original state
> 
> +  //
> 
> +  BridgeCleanupList.Count = 0;
> 
> +  RecursiveBusAssignment(RpSbdf, BusMin, BusMax, &BridgeCleanupList);
> 
> +  //
> 
> +  // The 'Recursive...' functions below expect bus numbers to be already
> assigned
> 
> +  //
> 
> +  RecursiveLtrConfiguration (RpSbdf, PolicyLtr);
> 
> +  TreeLtr = RecursiveLtrOverrideCheck (RpSbdf, &PmOverrideTable);
> 
> +  ConfigureRpLtrOverride (RpBase, RpSbdf.Dev, &TreeLtr,
> &(PcieRpCommonConfig->PcieRpLtrConfig));
> 
> +  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride %x:%x\n", RpSbdf.Dev,
> RpSbdf.Func));
> 
> +  if (PcieRpCommonConfig->EnableCpm) {
> 
> +    RecursiveCpmConfiguration (RpSbdf);
> 
> +  }
> 
> +  //
> 
> +  // L1 substates can be modified only when L1 is disabled, so this function
> must execute
> 
> +  // before Aspm configuration which enables L1
> 
> +  //
> 
> +  RecursiveL1ssConfiguration (RpSbdf, &PmOverrideTable);
> 
> +  L1ssProprietaryConfiguration (RpBase, IsLtrCapable (RpSbdf));
> 
> +  RecursiveAspmConfiguration (RpSbdf, 0, &PmOverrideTable);
> 
> +
> 
> +  ClearBusFromTable (&BridgeCleanupList);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.h
> new file mode 100644
> index 0000000000..19c1051771
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PciExpressHelpersLibrary.h
> @@ -0,0 +1,40 @@
> +/** @file
> 
> +  Header file for Pci Express helps library implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCI_EXPRESS_HELPERS_LIBRARY_H_
> 
> +#define _PCI_EXPRESS_HELPERS_LIBRARY_H_
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <PchPolicyCommon.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/TimerLib.h>
> 
> +#include <Library/PciExpressHelpersLib.h>
> 
> +#include <Library/PcieRpLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +
> 
> +#define LTR_VALUE_MASK (BIT0 + BIT1 + BIT2 + BIT3 + BIT4 + BIT5 + BIT6 +
> BIT7 + BIT8 + BIT9)
> 
> +#define LTR_SCALE_MASK (BIT10 + BIT11 + BIT12)
> 
> +
> 
> +  #define CONFIG_WRITE_LOOP_COUNT   100000
> 
> +
> 
> +//
> 
> +// LTR related macros
> 
> +//
> 
> +#define LTR_LATENCY_VALUE(x)           ((x) & LTR_VALUE_MASK)
> 
> +#define LTR_SCALE_VALUE(x)             (((x) & LTR_SCALE_MASK) >> 10)
> 
> +#define LTR_LATENCY_NS(x)              (LTR_LATENCY_VALUE(x) * (1 << (5 *
> LTR_SCALE_VALUE(x))))
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
> new file mode 100644
> index 0000000000..8f673d14c2
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PciExpress
> HelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
> @@ -0,0 +1,49 @@
> +## @file
> 
> +# Component description file for the PeiDxeSmmPciExpressHelpersLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION = 0x00010017
> 
> +  BASE_NAME = PeiDxeSmmPciExpressHelpersLib
> 
> +  FILE_GUID = 07E3F76D-6D26-419d-9053-58696A15B519
> 
> +  VERSION_STRING = 1.0
> 
> +  MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PciExpressHelpersLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PchPcieRpLib
> 
> +  PchPcrLib
> 
> +  PchInfoLib
> 
> +  GpioLib
> 
> +  TimerLib
> 
> +  BasePcieHelperLib
> 
> +  PchPciBdfLib
> 
> +  HobLib
> 
> +  PcieRpLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  PciExpressHelpersLibrary.c
> 
> +  PciExpressHelpersLibrary.h
> 
> +
> 
> +[Guids]
> 
> +  gCpuPcieHobGuid
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.c
> new file mode 100644
> index 0000000000..15d295a573
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.c
> @@ -0,0 +1,247 @@
> +/** @file
> 
> +  This file contains routines that support PCI Express initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <Library/PchSbiAccessLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/PcieRpLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PsfLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/PcieSipRegs.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <CpuPcieHob.h>
> 
> +
> 
> +/**
> 
> +  Get PCIe port number for enabled port.
> 
> +  @param[in] RpBase    Root Port pci segment base address
> 
> +
> 
> +  @retval Root Port number (1 based)
> 
> +**/
> 
> +UINT32
> 
> +PciePortNum (
> 
> +  IN     UINT64  RpBase
> 
> +  )
> 
> +{
> 
> +  return PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LCAP) >>
> N_PCH_PCIE_CFG_LCAP_PN;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCIe root port index
> 
> +
> 
> +  @param[in] RpBase    Root Port pci segment base address
> 
> +
> 
> +  @retval Root Port index (0 based)
> 
> +**/
> 
> +UINT32
> 
> +PciePortIndex (
> 
> +  IN     UINT64  RpBase
> 
> +  )
> 
> +{
> 
> +  return PciePortNum (RpBase) - 1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks whether PHY lane power gating is enabled on the
> port.
> 
> +
> 
> +  @param[in] RpBase                 Root Port base address
> 
> +
> 
> +  @retval TRUE                      PHY power gating is enabled
> 
> +  @retval FALSE                     PHY power gating disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +PcieIsPhyLanePgEnabled (
> 
> +  IN     UINT64  RpBase
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +
> 
> +  Data32 = PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL);
> 
> +  return (Data32 & B_PCH_PCIE_CFG_PCIEPMECTL_DLSULPPGE) != 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures Root Port packet split.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] Mps                            maximum packet size
> 
> +**/
> 
> +VOID
> 
> +ConfigureRpPacketSplit (
> 
> +  UINT64 RpBase,
> 
> +  UINT8  Mps
> 
> +  )
> 
> +{
> 
> +  PciSegmentAndThenOr32 (RpBase + R_PCIE_CFG_CCFG, (UINT32)
> ~(B_PCIE_CFG_CCFG_UNRS), Mps << N_PCIE_CFG_CCFG_UNRS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures LTR override in Root Port's proprietary registers.
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] DevNum                         currently visited device number
> 
> +  @param[in] RpConfig                       Root Port LTR configuration
> 
> +  @param[in] AspmOverride                   combination of LTR override values
> from all devices under this Root Port
> 
> +**/
> 
> +VOID
> 
> +ConfigureRpLtrOverride (
> 
> +  UINT64           RpBase,
> 
> +  UINT32           DevNum,
> 
> +  LTR_OVERRIDE     *TreeLtr,
> 
> +  PCIE_LTR_CONFIG  *LtrConfig
> 
> +  )
> 
> +{
> 
> +  UINT32       OvrEn;
> 
> +  UINT32       OvrVal;
> 
> +  BOOLEAN      IsCpuPcie;
> 
> +  UINT32       LtrCfgLock;
> 
> +
> 
> +  IsCpuPcie = FALSE;
> 
> +  OvrEn = 0;
> 
> +  OvrVal = 0;
> 
> +  LtrCfgLock = 0;
> 
> +
> 
> +  if (DevNum == SA_PEG0_DEV_NUM || DevNum == SA_PEG3_DEV_NUM)
> {
> 
> +    IsCpuPcie = TRUE;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // LTR settings from LTROVR register only get acknowledged on rising edge
> of LTROVR2[1:0]
> 
> +  // If those bits were already set (that can happen on a plug-hotUnplug-
> hotPlug scenario),
> 
> +  // they need to be toggled
> 
> +  //
> 
> +  if (PciSegmentRead32 (RpBase + R_PCH_PCIE_CFG_LTROVR2) != 0) {
> 
> +    PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR2, 0);
> 
> +  }
> 
> +  //
> 
> +  // (*)LatencyOverrideMode = 0 -> no override
> 
> +  //                          1 -> override with RP policy values
> 
> +  //                          2 -> override with endpoint's override values
> 
> +  //
> 
> +
> 
> +  if (LtrConfig->ForceLtrOverride || TreeLtr->ForceOverride) {
> 
> +    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_FORCE_OVERRIDE;
> 
> +  }
> 
> +  if (LtrConfig->LtrConfigLock == TRUE) {
> 
> +    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LOCK;
> 
> +  }
> 
> +
> 
> +  if (LtrConfig->SnoopLatencyOverrideMode == 1) {
> 
> +    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN;
> 
> +    OvrVal |= LtrConfig->SnoopLatencyOverrideValue;
> 
> +    OvrVal |= LtrConfig->SnoopLatencyOverrideMultiplier << 10;
> 
> +    OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRSROVR;
> 
> +  } else if (LtrConfig->SnoopLatencyOverrideMode == 2) {
> 
> +    if (TreeLtr->MaxSnoopLatencyRequirement) {
> 
> +      OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRSOVREN;
> 
> +      OvrVal |= TreeLtr->MaxSnoopLatencyValue;
> 
> +      OvrVal |= TreeLtr->MaxSnoopLatencyScale << 10;
> 
> +      OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRSROVR;
> 
> +    }
> 
> +  }
> 
> +  if (LtrConfig->NonSnoopLatencyOverrideMode == 1) {
> 
> +    OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN;
> 
> +    OvrVal |= LtrConfig->NonSnoopLatencyOverrideValue << 16;
> 
> +    OvrVal |= LtrConfig->NonSnoopLatencyOverrideMultiplier << 26;
> 
> +    OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRNSROVR;
> 
> +  } else if (LtrConfig->NonSnoopLatencyOverrideMode == 2) {
> 
> +    if (TreeLtr->MaxNoSnoopLatencyRequirement) {
> 
> +      OvrEn |= B_PCH_PCIE_CFG_LTROVR2_LTRNSOVREN;
> 
> +      OvrVal |= TreeLtr->MaxNoSnoopLatencyValue << 16;
> 
> +      OvrVal |= TreeLtr->MaxNoSnoopLatencyScale << 26;
> 
> +      OvrVal |= B_PCH_PCIE_CFG_LTROVR_LTRNSROVR;
> 
> +    }
> 
> +  }
> 
> +  PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR, OvrVal);
> 
> +  PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_LTROVR2, OvrEn);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride IsCpuPcie=%d\n",
> IsCpuPcie));
> 
> +  DEBUG ((DEBUG_INFO, "ConfigureRpLtrOverride %x Val %x En %x\n",
> RpBase, OvrVal, OvrEn));
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function configures EOI message forwarding for PCIe port.
> 
> +  If there's an IoAPIC behind this port, forwarding will be enabled
> 
> +  Otherwise it will be disabled to minimize bus traffic
> 
> +
> 
> +  @param[in] Segment,Bus,Device,Function    address of currently visited
> PCIe device
> 
> +  @param[in] IoApicPresent  TRUE if there's IoAPIC behind this Root Port
> 
> +**/
> 
> +VOID
> 
> +ConfigureEoiForwarding (
> 
> +  UINT64   RpBase,
> 
> +  BOOLEAN  IoApicPresent
> 
> +  )
> 
> +{
> 
> +  UINT32 RpIndex;
> 
> +
> 
> +  RpIndex = PciePortIndex (RpBase);
> 
> +
> 
> +  if (IoApicPresent == FALSE) {
> 
> +   PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_MPC2,
> B_PCH_PCIE_CFG_MPC2_EOIFD);
> 
> +  } else {
> 
> +    ///
> 
> +    /// If there is an IOAPIC discovered behind Root Port, program PSF
> Multicast registers
> 
> +    /// in accordance with PCH PCIe BWG  PSF EOI Multicast Configuration
> 
> +    ///
> 
> +    PciSegmentAnd32 (RpBase + R_PCH_PCIE_CFG_MPC2,
> (UINT32)~B_PCH_PCIE_CFG_MPC2_EOIFD);
> 
> +    PsfConfigurEoiForPciePort (RpIndex);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures proprietary parts of L1 substates configuration in Root Port
> 
> +
> 
> +  @param[in] RpSbdf       segment:bus:device:function coordinates of Root
> Port
> 
> +  @param[in] LtrCapable   TRUE if Root Port is LTR capable
> 
> +**/
> 
> +VOID
> 
> +L1ssProprietaryConfiguration (
> 
> +  UINT64  RpBase,
> 
> +  BOOLEAN LtrCapable
> 
> +  )
> 
> +{
> 
> +  BOOLEAN ClkreqSupported;
> 
> +  BOOLEAN L1ssEnabled;
> 
> +  UINT16  PcieCapOffset;
> 
> +  UINT32  Data32;
> 
> +  BOOLEAN L1LowSupported;
> 
> +
> 
> +  ClkreqSupported = PcieIsPhyLanePgEnabled (RpBase);
> 
> +
> 
> +  PcieCapOffset = PcieBaseFindExtendedCapId (RpBase,
> V_PCIE_EX_L1S_CID);
> 
> +  if (PcieCapOffset == 0) {
> 
> +    L1ssEnabled = FALSE;
> 
> +  } else {
> 
> +    Data32 = PciSegmentRead32 (RpBase + PcieCapOffset +
> R_PCIE_EX_L1SCTL1_OFFSET);
> 
> +    L1ssEnabled = Data32 & (B_PCIE_EX_L1SCAP_AL1SS |
> B_PCIE_EX_L1SCAP_AL12S | B_PCIE_EX_L1SCAP_PPL11S
> |B_PCIE_EX_L1SCAP_PPL12S);
> 
> +  }
> 
> +  L1LowSupported = ClkreqSupported && LtrCapable && !L1ssEnabled;
> 
> +
> 
> +  ///
> 
> +  /// If L1.SNOOZ and L1.OFF (L1 Sub-States) are not supported and per-port
> CLKREQ# is supported, and LTR is supported:
> 
> +  /// Enable L1.LOW by setting Dxx:Fn:420[17] = 1b
> 
> +  ///
> 
> +  if (L1LowSupported) {
> 
> +    PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL, (UINT32)
> B_PCH_PCIE_CFG_PCIEPMECTL_L1LE);
> 
> +  } else {
> 
> +    PciSegmentAnd32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL, (UINT32)
> ~B_PCH_PCIE_CFG_PCIEPMECTL_L1LE);
> 
> +  }
> 
> +
> 
> +  if (L1LowSupported || L1ssEnabled) {
> 
> +    ///
> 
> +    /// f.  Set Dxx:Fn:420h[0] to 1b prior to L1 enabling if any L1substate is
> enabled (including L1.LOW)
> 
> +    ///
> 
> +    PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_PCIEPMECTL,
> B_PCH_PCIE_CFG_PCIEPMECTL_L1FSOE);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.inf
> new file mode 100644
> index 0000000000..86dceb14ee
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/PcieRp/LibraryPrivate/PcieClientR
> pLib/PcieClientRpLib.inf
> @@ -0,0 +1,43 @@
> +## @file
> 
> +# Component description file for the PcieClientRpLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION = 0x00010017
> 
> +  BASE_NAME = PcieClientRpLib
> 
> +  FILE_GUID = 77EB467D-674C-4C20-A13E-381600E182C4
> 
> +  VERSION_STRING = 1.0
> 
> +  MODULE_TYPE = BASE
> 
> +  LIBRARY_CLASS = PcieRpLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PchPcieRpLib
> 
> +  PchPcrLib
> 
> +  PchInfoLib
> 
> +  GpioLib
> 
> +  TimerLib
> 
> +  PsfLib
> 
> +  BasePcieHelperLib
> 
> +  PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  PcieClientRpLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component
  2021-02-01  1:36 ` [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Pmc/IncludePrivate
>   * IpBlock/Pmc/Library
>   * IpBlock/Pmc/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcPri
> vateLib.h                                 | 120
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/PmcR
> egsVer2.h                                  |  52
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/Pei
> DxeSmmPmcLib.inf                            |  42
> ++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/P
> mcLib.c                                       | 545
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPm
> cPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf   |  39
> +++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPm
> cPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf |  40
> ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPm
> cPrivateLib/PmcPrivateLib.c                  | 166
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmPm
> cPrivateLib/PmcPrivateLibWithS3.c            | 122
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
>  8 files changed, 1126 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcP
> rivateLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcP
> rivateLib.h
> new file mode 100644
> index 0000000000..0f2f251d57
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Library/PmcP
> rivateLib.h
> @@ -0,0 +1,120 @@
> +/** @file
> 
> +  Header file for private PmcLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PMC_PRIVATE_LIB_H_
> 
> +#define _PMC_PRIVATE_LIB_H_
> 
> +
> 
> +#include <Library/PmcLib.h>
> 
> +#include "Register/PmcRegs.h"
> 
> +
> 
> +/**
> 
> +  This function checks if GbE device is supported (not disabled by fuse)
> 
> +
> 
> +  @retval GbE support state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsGbeSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if LAN wake from DeepSx is enabled
> 
> +
> 
> +  @retval Lan Wake state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsLanDeepSxWakeEnabled (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets SMI Lock with S3 Boot Script programming
> 
> +**/
> 
> +VOID
> 
> +PmcLockSmiWithS3BootScript (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function sets eSPI SMI Lock
> 
> +  @attention This function must be called after eSPI SMI generation has
> been enabled.
> 
> +    This setting is required in all boot modes and before EndOfDxe.
> 
> +    If set value will be restored upon S3 resume by bootscript.
> 
> +**/
> 
> +VOID
> 
> +PmcLockEspiSmiWithS3BootScript (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function checks if eSPI SMI Lock is set
> 
> +
> 
> +  @retval eSPI SMI Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsEspiSmiLockSet (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +typedef enum {
> 
> +  PmcSwSmiRate1p5ms = 0,
> 
> +  PmcSwSmiRate16ms,
> 
> +  PmcSwSmiRate32ms,
> 
> +  PmcSwSmiRate64ms
> 
> +} PMC_SWSMI_RATE;
> 
> +
> 
> +/**
> 
> +  This function sets SW SMI Rate.
> 
> +
> 
> +  @param[in] SwSmiRate        Refer to PMC_SWSMI_RATE for possible
> values
> 
> +**/
> 
> +VOID
> 
> +PmcSetSwSmiRate (
> 
> +  IN PMC_SWSMI_RATE          SwSmiRate
> 
> +  );
> 
> +
> 
> +typedef enum {
> 
> +  PmcPeriodicSmiRate8s = 0,
> 
> +  PmcPeriodicSmiRate16s,
> 
> +  PmcPeriodicSmiRate32s,
> 
> +  PmcPeriodicSmiRate64s
> 
> +} PMC_PERIODIC_SMI_RATE;
> 
> +
> 
> +/**
> 
> +  This function sets Periodic SMI Rate.
> 
> +
> 
> +  @param[in] PeriodicSmiRate        Refer to PMC_PERIODIC_SMI_RATE for
> possible values
> 
> +**/
> 
> +VOID
> 
> +PmcSetPeriodicSmiRate (
> 
> +  IN PMC_PERIODIC_SMI_RATE    PeriodicSmiRate
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function reads Power Button Level
> 
> +
> 
> +  @retval State of PWRBTN# signal (0: Low, 1: High)
> 
> +**/
> 
> +UINT8
> 
> +PmcGetPwrBtnLevel (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function gets Group to GPE0 configuration
> 
> +
> 
> +  @param[out] GpeDw0Value       GPIO Group to GPE_DW0 assignment
> 
> +  @param[out] GpeDw1Value       GPIO Group to GPE_DW1 assignment
> 
> +  @param[out] GpeDw2Value       GPIO Group to GPE_DW2 assignment
> 
> +**/
> 
> +VOID
> 
> +PmcGetGpioGpe (
> 
> +  OUT UINT32    *GpeDw0Value,
> 
> +  OUT UINT32    *GpeDw1Value,
> 
> +  OUT UINT32    *GpeDw2Value
> 
> +  );
> 
> +
> 
> +#endif // _PMC_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/Pmc
> RegsVer2.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/Pm
> cRegsVer2.h
> new file mode 100644
> index 0000000000..986173dd7d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/IncludePrivate/Register/Pm
> cRegsVer2.h
> @@ -0,0 +1,52 @@
> +/** @file
> 
> +  Register names for Ver2 PCH PMC device
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_PMC_TGL_H_
> 
> +#define _PCH_REGS_PMC_TGL_H_
> 
> +
> 
> +//
> 
> +// PWRM Registers
> 
> +//
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_B     0x0
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_A     0x2
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_R     0x3
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPD       0x4
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_S     0x5
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_H     0x6
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_D     0x7
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_F     0xA
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_C     0xB
> 
> +#define V_TGL_PCH_LP_PMC_PWRM_GPIO_CFG_GPP_E     0xC
> 
> +
> 
> +#endif // _PCH_REGS_PMC_TGL_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PeiDxeSmmPmcLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PeiDxeSmmPmcLib.inf
> new file mode 100644
> index 0000000000..eba6db767c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PeiDxeSmmPmcLib.inf
> @@ -0,0 +1,42 @@
> +## @file
> 
> +# PEI/DXE/SMM PCH PMC Lib.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPmcLib
> 
> +FILE_GUID = 9D60C364-5086-41E3-BC9D-C62AB7233DBF
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PmcLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchCycleDecodingLib
> 
> +PchPcrLib
> 
> +PchInfoLib
> 
> +BaseMemoryLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdTcoBaseAddress
> 
> +
> 
> +[Sources]
> 
> +PmcLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PmcLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PmcLib.c
> new file mode 100644
> index 0000000000..78e596b268
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/Library/PeiDxeSmmPmcLib/
> PmcLib.c
> @@ -0,0 +1,545 @@
> +/** @file
> 
> +  PCH PMC Library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +
> 
> +/**
> 
> +  Get PCH ACPI base address.
> 
> +
> 
> +  @retval Address                   Address of PWRM base address.
> 
> +**/
> 
> +UINT16
> 
> +PmcGetAcpiBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PcdGet16 (PcdAcpiBaseAddress);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH PWRM base address.
> 
> +
> 
> +  @retval Address                   Address of PWRM base address.
> 
> +**/
> 
> +UINT32
> 
> +PmcGetPwrmBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCH_PWRM_BASE_ADDRESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function enables Power Button SMI
> 
> +**/
> 
> +VOID
> 
> +PmcEnablePowerButtonSmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoOr16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_EN,
> B_ACPI_IO_PM1_EN_PWRBTN);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function disables Power Button SMI
> 
> +**/
> 
> +VOID
> 
> +PmcDisablePowerButtonSmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoAnd16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_EN,
> (UINT16)~B_ACPI_IO_PM1_EN_PWRBTN);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function reads PM Timer Count driven by 3.579545 MHz clock
> 
> +
> 
> +  @retval PM Timer Count
> 
> +**/
> 
> +UINT32
> 
> +PmcGetTimerCount (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return IoRead32 (PmcGetAcpiBase () + R_ACPI_IO_PM1_TMR) &
> B_ACPI_IO_PM1_TMR_VAL;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Sleep Type that platform has waken from
> 
> +
> 
> +  @retval SleepType                Sleep Type
> 
> +**/
> 
> +PMC_SLEEP_STATE
> 
> +PmcGetSleepTypeAfterWake (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT16  AcpiBase;
> 
> +  UINT32  PmconA;
> 
> +
> 
> +  AcpiBase = PmcGetAcpiBase ();
> 
> +  PmconA   = MmioRead32 (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_A);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PWRM_PMCON_A = 0x%x\n", PmconA));
> 
> +
> 
> +  //
> 
> +  // If Global Reset Status, Power Failure. Host Reset Status bits are set,
> return S5 State
> 
> +  //
> 
> +  if ((PmconA & (B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS |
> B_PMC_PWRM_GEN_PMCON_A_PWR_FLR |
> B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS)) != 0) {
> 
> +    return PmcNotASleepState;
> 
> +  }
> 
> +
> 
> +  if (IoRead16 (AcpiBase + R_ACPI_IO_PM1_STS) &
> B_ACPI_IO_PM1_STS_WAK) {
> 
> +    switch (IoRead16 (AcpiBase + R_ACPI_IO_PM1_CNT) &
> B_ACPI_IO_PM1_CNT_SLP_TYP) {
> 
> +      case V_ACPI_IO_PM1_CNT_S0:
> 
> +        return PmcInS0State;
> 
> +
> 
> +      case V_ACPI_IO_PM1_CNT_S1:
> 
> +        return PmcS1SleepState;
> 
> +
> 
> +      case V_ACPI_IO_PM1_CNT_S3:
> 
> +        return PmcS3SleepState;
> 
> +
> 
> +      case V_ACPI_IO_PM1_CNT_S4:
> 
> +        return PmcS4SleepState;
> 
> +
> 
> +      case V_ACPI_IO_PM1_CNT_S5:
> 
> +        return PmcS5SleepState;
> 
> +
> 
> +      default:
> 
> +        ASSERT (FALSE);
> 
> +        return PmcUndefinedState;
> 
> +    }
> 
> +  } else {
> 
> +    return PmcNotASleepState;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear PMC Wake Status
> 
> +**/
> 
> +VOID
> 
> +PmcClearWakeStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoWrite16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_STS,
> B_ACPI_IO_PM1_STS_WAK);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configure sleep state
> 
> +
> 
> +  @param[in] SleepState         S0/S1/S3/S4/S5, refer to PMC_SLEEP_STATE
> 
> +**/
> 
> +VOID
> 
> +PmcSetSleepState (
> 
> +  PMC_SLEEP_STATE  SleepState
> 
> +  )
> 
> +{
> 
> +  UINT16  Data16;
> 
> +
> 
> +  switch (SleepState) {
> 
> +    case PmcInS0State:
> 
> +      Data16 = V_ACPI_IO_PM1_CNT_S0;
> 
> +      break;
> 
> +
> 
> +    case PmcS1SleepState:
> 
> +      Data16 = V_ACPI_IO_PM1_CNT_S1;
> 
> +      break;
> 
> +
> 
> +    case PmcS3SleepState:
> 
> +      Data16 = V_ACPI_IO_PM1_CNT_S3;
> 
> +      break;
> 
> +
> 
> +    case PmcS4SleepState:
> 
> +      Data16 = V_ACPI_IO_PM1_CNT_S4;
> 
> +      break;
> 
> +
> 
> +    case PmcS5SleepState:
> 
> +      Data16 = V_ACPI_IO_PM1_CNT_S5;
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return;
> 
> +
> 
> +  }
> 
> +  IoAndThenOr16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_CNT, (UINT16)
> ~B_ACPI_IO_PM1_CNT_SLP_TYP, Data16);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if platform boots after shutdown caused by power button override
> event
> 
> +
> 
> +  @retval  TRUE   Power Button Override occurred in last system boot
> 
> +  @retval  FALSE  Power Button Override didn't occur
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsPowerButtonOverrideDetected (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((IoRead16 (PmcGetAcpiBase () + R_ACPI_IO_PM1_STS) &
> B_ACPI_IO_PM1_STS_PRBTNOR) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets tPCH25 timing
> 
> +
> 
> +  @param[in] TimingValue       tPCH25 timing value (10us, 100us, 1ms, 10ms)
> 
> +**/
> 
> +VOID
> 
> +PmcSetTPch25Timing (
> 
> +  IN PMC_TPCH25_TIMING    TimingValue
> 
> +  )
> 
> +{
> 
> +  ASSERT (TimingValue <= PmcTPch25_10ms);
> 
> +
> 
> +  MmioAndThenOr32 (
> 
> +    (UINTN) (PmcGetPwrmBase () + R_PMC_PWRM_CFG),
> 
> +    (UINT32)~(B_PMC_PWRM_CFG_TIMING_TPCH25),
> 
> +    TimingValue
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if RTC Power Failure occurred by
> 
> +  reading RTC_PWR_FLR bit
> 
> +
> 
> +  @retval RTC Power Failure state: TRUE  - Battery is always present.
> 
> +                                   FALSE - CMOS is cleared.
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsRtcBatteryGood (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((MmioRead8 (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_B) &
> B_PMC_PWRM_GEN_PMCON_B_RTC_PWR_STS) == 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if Power Failure occurred by
> 
> +  reading PWR_FLR bit
> 
> +
> 
> +  @retval Power Failure state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsPowerFailureDetected (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((MmioRead16 (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_A) &
> B_PMC_PWRM_GEN_PMCON_A_PWR_FLR) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if Power Failure occurred by
> 
> +  reading SUS_PWR_FLR bit
> 
> +
> 
> +  @retval SUS Power Failure state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsSusPowerFailureDetected (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((MmioRead32 (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_A) &
> B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears Power Failure status (PWR_FLR)
> 
> +**/
> 
> +VOID
> 
> +PmcClearPowerFailureStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Write 1 to clear PWR_FLR
> 
> +  // Avoid clearing other W1C bits
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
> 
> +    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS >> 8),
> 
> +    B_PMC_PWRM_GEN_PMCON_A_PWR_FLR >> 8
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears Global Reset status (GBL_RST_STS)
> 
> +**/
> 
> +VOID
> 
> +PmcClearGlobalResetStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Write 1 to clear GBL_RST_STS
> 
> +  // Avoid clearing other W1C bits
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 3,
> 
> +    (UINT8) ~0,
> 
> +    B_PMC_PWRM_GEN_PMCON_A_GBL_RST_STS >> 24
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears Host Reset status (HOST_RST_STS)
> 
> +**/
> 
> +VOID
> 
> +PmcClearHostResetStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Write 1 to clear HOST_RST_STS
> 
> +  // Avoid clearing other W1C bits
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
> 
> +    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_PWR_FLR >> 8),
> 
> +    B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS >> 8
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears SUS Power Failure status (SUS_PWR_FLR)
> 
> +**/
> 
> +VOID
> 
> +PmcClearSusPowerFailureStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // BIOS clears this bit by writing a '1' to it.
> 
> +  // Take care of other fields, so we don't clear them accidentally.
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 2,
> 
> +    (UINT8) ~(B_PMC_PWRM_GEN_PMCON_A_MS4V >> 16),
> 
> +    B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR >> 16
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets state to which platform will get after power is reapplied
> 
> +
> 
> +  @param[in] PowerStateAfterG3          0: S0 state (boot)
> 
> +                                        1: S5/S4 State
> 
> +**/
> 
> +VOID
> 
> +PmcSetPlatformStateAfterPowerFailure (
> 
> +  IN UINT8 PowerStateAfterG3
> 
> +  )
> 
> +{
> 
> +  UINT32                PchPwrmBase;
> 
> +
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  if (PowerStateAfterG3) {
> 
> +    MmioOr8 (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
> B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN);
> 
> +  } else {
> 
> +    MmioAnd8 (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
> (UINT8)~B_PMC_PWRM_GEN_PMCON_A_AFTERG3_EN);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function will set the DISB - DRAM Initialization Scratchpad Bit.
> 
> +**/
> 
> +VOID
> 
> +PmcSetDramInitScratchpad (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Set B_CNL_PCH_PWRM_GEN_PMCON_A_DISB.
> 
> +  // NOTE: Byte access and not clear BIT18 and BIT16 (W1C bits)
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 2,
> 
> +    (UINT8) ~((B_PMC_PWRM_GEN_PMCON_A_MS4V |
> B_PMC_PWRM_GEN_PMCON_A_SUS_PWR_FLR) >> 16),
> 
> +    B_PMC_PWRM_GEN_PMCON_A_DISB >> 16
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check global SMI enable is set
> 
> +
> 
> +  @retval TRUE  Global SMI enable is set
> 
> +          FALSE Global SMI enable is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsGblSmiEn (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(IoRead32 (PmcGetAcpiBase () + R_ACPI_IO_SMI_EN) &
> B_ACPI_IO_SMI_EN_GBL_SMI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if SMI Lock is set
> 
> +
> 
> +  @retval SMI Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsSmiLockSet (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((MmioRead8 ((UINTN) (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_B)) &
> B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if Debug Mode is locked
> 
> +
> 
> +  @retval Debug Mode Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsDebugModeLocked (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Get lock info from PWRMBASE + PM_CFG
> 
> +  //
> 
> +  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_CFG) &
> B_PMC_PWRM_CFG_DBG_MODE_LOCK) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check TCO second timeout status.
> 
> +
> 
> +  @retval  TRUE   TCO reboot happened.
> 
> +  @retval  FALSE  TCO reboot didn't happen.
> 
> +**/
> 
> +BOOLEAN
> 
> +TcoSecondToHappened (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  ///
> 
> +  /// Read the Second TO status bit
> 
> +  ///
> 
> +  if ((IoRead8 (PcdGet16 (PcdTcoBaseAddress) + R_TCO_IO_TCO2_STS) &
> R_TCO_IO_TCO2_STS) != 0) {
> 
> +    return TRUE;
> 
> +  } else {
> 
> +    return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears the Second TO status bit
> 
> +**/
> 
> +VOID
> 
> +TcoClearSecondToStatus (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoWrite8 (PcdGet16 (PcdTcoBaseAddress) + R_TCO_IO_TCO2_STS,
> B_TCO_IO_TCO2_STS_SECOND_TO);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check TCO SMI ENABLE is locked
> 
> +
> 
> +  @retval TRUE  TCO SMI ENABLE is locked
> 
> +          FALSE TCO SMI ENABLE is not locked
> 
> +**/
> 
> +BOOLEAN
> 
> +TcoIsSmiLock (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(IoRead16 (PcdGet16 (PcdTcoBaseAddress) +
> R_TCO_IO_TCO1_CNT) & B_TCO_IO_TCO1_CNT_LOCK);
> 
> +}
> 
> +
> 
> +/**
> 
> +   Check if user wants to turn off in PEI phase and power it off
> 
> +   CAUTION: this function will potentially turn off your system
> 
> +**/
> 
> +VOID
> 
> +CheckPowerOffNow (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT16  ABase;
> 
> +  UINT16  Pm1Sts;
> 
> +
> 
> +  ABase = PmcGetAcpiBase ();
> 
> +
> 
> +  //
> 
> +  // Read and check the ACPI registers
> 
> +  //
> 
> +  Pm1Sts = IoRead16 (ABase + R_ACPI_IO_PM1_STS);
> 
> +
> 
> +  DEBUG ((DEBUG_ERROR, "CheckPowerOffNow ()- Pm1Sts= 0x%04x\n",
> Pm1Sts));
> 
> +
> 
> +  if ((Pm1Sts & B_ACPI_IO_PM1_STS_PWRBTN) != 0) {
> 
> +    IoWrite16 (ABase + R_ACPI_IO_PM1_STS,
> B_ACPI_IO_PM1_STS_PWRBTN);
> 
> +    IoWrite16 (ABase + R_ACPI_IO_PM1_CNT, V_ACPI_IO_PM1_CNT_S5);
> 
> +    IoWrite16 (ABase + R_ACPI_IO_PM1_CNT, V_ACPI_IO_PM1_CNT_S5 |
> B_ACPI_IO_PM1_CNT_SLP_EN);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> + Clear any SMI status or wake status.
> 
> +**/
> 
> +VOID
> 
> +ClearSmiAndWake (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT16              ABase;
> 
> +  UINT16              Pm1Sts;
> 
> +
> 
> +  ABase = PmcGetAcpiBase ();
> 
> +
> 
> +  //
> 
> +  // Clear any SMI or wake state from the boot
> 
> +  //
> 
> +  Pm1Sts = B_ACPI_IO_PM1_STS_PWRBTN;
> 
> +
> 
> +  IoWrite16 (ABase + R_ACPI_IO_PM1_STS, Pm1Sts);
> 
> +
> 
> +  //
> 
> +  // Clear the GPE and PM enable
> 
> +  //
> 
> +  IoWrite16 (ABase + R_ACPI_IO_PM1_EN, 0);
> 
> +  IoWrite32 (ABase + R_ACPI_IO_GPE0_EN_127_96, 0);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Function to check if Dirty Warm Reset occurs
> 
> +  (Global Reset has been converted to Host Reset)
> 
> +
> 
> +  @reval TRUE DWR occurs
> 
> +  @reval FALSE Normal boot flow
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsDwrBootMode (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32      PchPwrmBase;
> 
> +
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +  ASSERT (PchPwrmBase != 0);
> 
> +
> 
> +  return !!(MmioRead32 (PchPwrmBase + R_PMC_PWRM_HPR_CAUSE0) &
> B_PMC_PWRM_HPR_CAUSE0_GBL_TO_HOST);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
> new file mode 100644
> index 0000000000..2bd57b79f0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
> @@ -0,0 +1,39 @@
> +## @file
> 
> +# PEI/DXE/SMM PCH PMC Private Lib Ver2.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPmcPrivateLibVer2
> 
> +FILE_GUID = EB69B12B-6D4C-4B12-BB31-66CBCC4C1DC7
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PmcPrivateLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PmcLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiBaseAddress
> 
> +
> 
> +[FixedPcd]
> 
> +
> 
> +[Sources]
> 
> +PmcPrivateLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
> new file mode 100644
> index 0000000000..72a21cfe14
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
> @@ -0,0 +1,40 @@
> +## @file
> 
> +# PEI/DXE/SMM PCH private PMC Lib.
> 
> +# This part of PMC lib includes S3BootScript support
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPmcPrivateLibWithS3
> 
> +FILE_GUID = 5890CA5A-1955-4A02-A09C-01E4150606CC
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PmcPrivateLibWithS3
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PmcLib
> 
> +PcdLib
> 
> +S3BootScriptLib
> 
> +PchPciBdfLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PmcPrivateLibWithS3.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLib.c
> new file mode 100644
> index 0000000000..4f04765886
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLib.c
> @@ -0,0 +1,166 @@
> +/** @file
> 
> +  PCH private PMC Library for all PCH generations.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +
> 
> +/**
> 
> +  This function checks if GbE device is supported (not disabled by fuse)
> 
> +
> 
> +  @retval GbE support state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsGbeSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Get fuse info from PWRMBASE + FUSE_SS_DIS_RD_2
> 
> +  //
> 
> +  return ((MmioRead32 (PmcGetPwrmBase () +
> R_PMC_PWRM_FUSE_DIS_RD_2) &
> B_PMC_PWRM_FUSE_DIS_RD_2_GBE_FUSE_SS_DIS) == 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if LAN wake from DeepSx is enabled
> 
> +
> 
> +  @retval Lan Wake state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsLanDeepSxWakeEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Get wake info from PWRMBASE + DSX_CFG
> 
> +  //
> 
> +  return ((MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_DSX_CFG)
> & (UINT32) B_PMC_PWRM_DSX_CFG_LAN_WAKE_EN) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function checks if eSPI SMI Lock is set
> 
> +
> 
> +  @retval eSPI SMI Lock state
> 
> +**/
> 
> +BOOLEAN
> 
> +PmcIsEspiSmiLockSet (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return ((MmioRead32 ((UINTN) (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_A)) &
> B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK) != 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets SW SMI Rate.
> 
> +
> 
> +  @param[in] SwSmiRate        Refer to PMC_SWSMI_RATE for possible
> values
> 
> +**/
> 
> +VOID
> 
> +PmcSetSwSmiRate (
> 
> +  IN PMC_SWSMI_RATE          SwSmiRate
> 
> +  )
> 
> +{
> 
> +  UINT32        PchPwrmBase;
> 
> +  STATIC UINT8  SwSmiRateRegVal[4] = {
> 
> +    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_1_5MS,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_16MS,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_32MS,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL_64MS
> 
> +  };
> 
> +
> 
> +  ASSERT (SwSmiRate <= PmcSwSmiRate64ms);
> 
> +
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  //
> 
> +  // SWSMI_RATE_SEL BIT (PWRMBASE offset 1020h[7:6]) bits are in RTC
> well
> 
> +  //
> 
> +  MmioAndThenOr8 (
> 
> +    PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
> 
> +    (UINT8)~B_PMC_PWRM_GEN_PMCON_A_SWSMI_RTSL,
> 
> +    SwSmiRateRegVal[SwSmiRate]
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets Periodic SMI Rate.
> 
> +
> 
> +  @param[in] PeriodicSmiRate        Refer to PMC_PERIODIC_SMI_RATE for
> possible values
> 
> +**/
> 
> +VOID
> 
> +PmcSetPeriodicSmiRate (
> 
> +  IN PMC_PERIODIC_SMI_RATE    PeriodicSmiRate
> 
> +  )
> 
> +{
> 
> +  UINT32        PchPwrmBase;
> 
> +  STATIC UINT8  PeriodicSmiRateRegVal[4] = {
> 
> +    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_8S,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_16S,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_32S,
> 
> +    V_PMC_PWRM_GEN_PMCON_A_PER_SMI_64S
> 
> +  };
> 
> +
> 
> +  ASSERT (PeriodicSmiRate <= PmcPeriodicSmiRate64s);
> 
> +
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  MmioAndThenOr8 (
> 
> +    PchPwrmBase + R_PMC_PWRM_GEN_PMCON_A,
> 
> +    (UINT8)~B_PMC_PWRM_GEN_PMCON_A_PER_SMI_SEL,
> 
> +    PeriodicSmiRateRegVal[PeriodicSmiRate]
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function reads Power Button Level
> 
> +
> 
> +  @retval State of PWRBTN# signal (0: Low, 1: High)
> 
> +**/
> 
> +UINT8
> 
> +PmcGetPwrBtnLevel (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  if (MmioRead32 (PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_B)
> & B_PMC_PWRM_GEN_PMCON_B_PWRBTN_LVL) {
> 
> +    return 1;
> 
> +  } else {
> 
> +    return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function gets Group to GPE0 configuration
> 
> +
> 
> +  @param[out] GpeDw0Value       GPIO Group to GPE_DW0 assignment
> 
> +  @param[out] GpeDw1Value       GPIO Group to GPE_DW1 assignment
> 
> +  @param[out] GpeDw2Value       GPIO Group to GPE_DW2 assignment
> 
> +**/
> 
> +VOID
> 
> +PmcGetGpioGpe (
> 
> +  OUT UINT32    *GpeDw0Value,
> 
> +  OUT UINT32    *GpeDw1Value,
> 
> +  OUT UINT32    *GpeDw2Value
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +
> 
> +  Data32 = MmioRead32 ((UINTN) (PmcGetPwrmBase () +
> R_PMC_PWRM_GPIO_CFG));
> 
> +
> 
> +  *GpeDw0Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW0) >>
> N_PMC_PWRM_GPIO_CFG_GPE0_DW0);
> 
> +  *GpeDw1Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW1) >>
> N_PMC_PWRM_GPIO_CFG_GPE0_DW1);
> 
> +  *GpeDw2Value = ((Data32 & B_PMC_PWRM_GPIO_CFG_GPE0_DW2) >>
> N_PMC_PWRM_GPIO_CFG_GPE0_DW2);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLibWithS3.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLibWithS3.c
> new file mode 100644
> index 0000000000..02acd0d688
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Pmc/LibraryPrivate/PeiDxeSmmP
> mcPrivateLib/PmcPrivateLibWithS3.c
> @@ -0,0 +1,122 @@
> +/** @file
> 
> +  PCH private PMC Library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +
> 
> +/**
> 
> +  This S3 BootScript only function disables triggering Global Reset of both
> 
> +  the Host and the ME partitions after CF9h write of 6h or Eh.
> 
> +**/
> 
> +VOID
> 
> +PmcDisableCf9GlobalResetInS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                          Data;
> 
> +
> 
> +  UINT32                          PchPwrmBase;
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  Data = MmioRead32 (PchPwrmBase + R_PMC_PWRM_ETR3);
> 
> +
> 
> +  Data &= (UINT32) ~B_PMC_PWRM_ETR3_CF9GR;
> 
> +
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) PchPwrmBase +
> 
> +    R_PMC_PWRM_ETR3,
> 
> +    1,
> 
> +    &Data
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This S3 BootScript only function disables triggering Global Reset of both
> 
> +  the Host and the ME partitions after CF9h write of 6h or Eh.
> 
> +  Global Reset configuration is locked after programming
> 
> +**/
> 
> +VOID
> 
> +PmcDisableCf9GlobalResetWithLockInS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                          Data;
> 
> +
> 
> +  UINT32                          PchPwrmBase;
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  Data = MmioRead32 (PchPwrmBase + R_PMC_PWRM_ETR3);
> 
> +
> 
> +  Data &= (UINT32) ~B_PMC_PWRM_ETR3_CF9GR;
> 
> +  Data |= (UINT32) B_PMC_PWRM_ETR3_CF9LOCK;
> 
> +
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) PchPwrmBase +
> 
> +    R_PMC_PWRM_ETR3,
> 
> +    1,
> 
> +    &Data
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets SMI Lock with S3 Boot Script programming
> 
> +**/
> 
> +VOID
> 
> +PmcLockSmiWithS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  PchPwrmBase;
> 
> +
> 
> +  PchPwrmBase = PmcGetPwrmBase ();
> 
> +
> 
> +  MmioOr8 ((UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B),
> B_PMC_PWRM_GEN_PMCON_B_SMI_LOCK);
> 
> +
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint8,
> 
> +    (UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B),
> 
> +    1,
> 
> +    (VOID *) (UINTN) (PchPwrmBase + R_PMC_PWRM_GEN_PMCON_B)
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sets eSPI SMI Lock
> 
> +  @attention This function must be called after eSPI SMI generation has
> been enabled.
> 
> +    This setting is required in all boot modes and before EndOfDxe.
> 
> +    If set value will be restored upon S3 resume by bootscript.
> 
> +**/
> 
> +VOID
> 
> +PmcLockEspiSmiWithS3BootScript (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8   Data8Or;
> 
> +  UINT8   Data8And;
> 
> +
> 
> +  Data8Or  = (UINT8) (B_PMC_PWRM_GEN_PMCON_A_ESPI_SMI_LOCK >>
> 8);
> 
> +  Data8And = (UINT8)~((B_PMC_PWRM_GEN_PMCON_A_PWR_FLR |
> B_PMC_PWRM_GEN_PMCON_A_HOST_RST_STS) >> 8);
> 
> +
> 
> +  MmioAndThenOr8 (PmcGetPwrmBase () +
> R_PMC_PWRM_GEN_PMCON_A + 1, Data8And, Data8Or);
> 
> +  S3BootScriptSaveMemReadWrite (
> 
> +    S3BootScriptWidthUint8,
> 
> +    PmcGetPwrmBase () + R_PMC_PWRM_GEN_PMCON_A + 1,
> 
> +    &Data8Or,
> 
> +    &Data8And
> 
> +    );
> 
> +}
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component
  2021-02-01  1:36 ` [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Psf/IncludePrivate
>   * IpBlock/Psf/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.h
> | 520
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeSm
> mPsfLibVer2.inf |  40 ++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
> | 203
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibInte
> rnal.h        | 470
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibVer
> 2.c            | 115
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  5 files changed, 1348 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.
> h
> new file mode 100644
> index 0000000000..f333be48d2
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/IncludePrivate/Library/PsfLib.
> h
> @@ -0,0 +1,520 @@
> +/** @file
> 
> +  Header file for PchPsfPrivateLib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PSF_PRIVATE_LIB_H_
> 
> +#define _PCH_PSF_PRIVATE_LIB_H_
> 
> +
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +typedef struct {
> 
> +  UINT32       Id;
> 
> +  PCH_SBI_PID  SbPid;
> 
> +} PSF_SEGMENT;
> 
> +
> 
> +/**
> 
> +  Get list of supported PSF segments.
> 
> +
> 
> +  @param[out] PsfTable        Array of supported PSF segments
> 
> +  @param[out] PsfTableLength  Length of PsfTable
> 
> +**/
> 
> +VOID
> 
> +PsfSegments (
> 
> +  OUT PSF_SEGMENT  **PsfTable,
> 
> +  OUT UINT32       *PsfTableLength
> 
> +  );
> 
> +
> 
> +//
> 
> +// Structure for storing data on both PSF SideBand Port ID and
> 
> +// PSF port register offset for specific device
> 
> +//
> 
> +typedef struct {
> 
> +  PCH_SBI_PID  PsfPid;
> 
> +  UINT16       RegBase;
> 
> +} PSF_PORT;
> 
> +
> 
> +/**
> 
> +  Disable device at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfDisableDevice (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable device at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfEnableDevice (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Hide PciCfgSpace of device at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfHideDevice (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unhide PciCfgSpace of device at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfUnhideDevice (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable device BARs at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +  @param[in] BarDisMask  BIT0-BAR0, BIT1-BAR1,...
> 
> +                         Mask corresponds to 32bit wide BARs
> 
> +**/
> 
> +VOID
> 
> +PsfDisableDeviceBar (
> 
> +  IN PSF_PORT  PsfPort,
> 
> +  IN UINT32    BarDisMask
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable device BARs at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +  @param[in] BarEnMask   BIT0-BAR0, BIT1-BAR1,...
> 
> +                         Mask corresponds to 32bit wide BARs
> 
> +**/
> 
> +VOID
> 
> +PsfEnableDeviceBar (
> 
> +  IN PSF_PORT  PsfPort,
> 
> +  IN UINT32    BarEnMask
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable IDER device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableIderDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable SOL device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfEnableSolDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable SOL device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableSolDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set PMC ABASE value in PSF
> 
> +
> 
> +  @param[in] Address     Address for ACPI base.
> 
> +**/
> 
> +VOID
> 
> +PsfSetPmcAbase (
> 
> +  IN  UINT16       Address
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PMC ABASE value from PSF
> 
> +
> 
> +  @retval Address     Address for ACPI base.
> 
> +**/
> 
> +UINT16
> 
> +PsfGetPmcAbase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get PMC PWRMBASE value from PSF
> 
> +
> 
> +  @retval Address     Address for PWRM base.
> 
> +**/
> 
> +UINT32
> 
> +PsfGetPmcPwrmBase (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Hide Cnvi WiFi device's PciCfgSpace at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfHideCnviWifiDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable Cnvi Wifi device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableCnviWifiDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable HDAudio device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableHdaDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable Dsp bar at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableDspBar (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable THC device at PSF level
> 
> +
> 
> +  @param[in]  ThcNumber                Touch Host Controller Number THC0 or
> THC1
> 
> +**/
> 
> +VOID
> 
> +PsfDisableThcDevice (
> 
> +  IN  UINT32        ThcNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable xDCI device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableXdciDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable xHCI device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableXhciDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable xHCI VTIO Phantom device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableXhciVtioDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable SATA device at PSF level
> 
> +
> 
> +  @param[in]  SataCtrlIndex     SATA controller index
> 
> +**/
> 
> +VOID
> 
> +PsfDisableSataDevice (
> 
> +  IN UINT32     SataCtrlIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for SCS eMMC device
> 
> +
> 
> +  @retval    PsfPort      PSF PORT structure for SCS eMMC device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfScsEmmcPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for SCS SD Card device
> 
> +
> 
> +  @retval    PsfPort      PSF PORT structure for SCS SD Card device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfScsSdCardPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for SCS UFS device
> 
> +
> 
> +  @param[in] UfsNum       UFS Device
> 
> +
> 
> +  @retval    PsfPort      PSF PORT structure for SCS UFS device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfScsUfsPort (
> 
> +  IN UINT32  UfsNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable ISH device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableIshDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable FPAK device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableFpakDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable ISH BAR1 at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableIshBar1 (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable GbE device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableGbeDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable SMBUS device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableSmbusDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable TraceHub ACPI devices at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableTraceHubAcpiDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Hide TraceHub ACPI devices PciCfgSpace at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfHideTraceHubAcpiDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will hide TraceHub PciCfgSpace at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfHideTraceHubDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will unhide TraceHub PciCfgSpace at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfUnhideTraceHubDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will disable TraceHub device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfDisableTraceHubDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures rootspace 3 bus number for PCIe IMR use
> 
> +
> 
> +  @param[in] Rs3Bus        bus number
> 
> +**/
> 
> +VOID
> 
> +PsfSetRs3Bus (
> 
> +  UINT8 Rs3Bus
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable PCIe Root Port at PSF level
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +**/
> 
> +VOID
> 
> +PsfDisablePcieRootPort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Program PSF grant counts for SATA
> 
> +  Call this before SATA ports are accessed for enumeration
> 
> +**/
> 
> +VOID
> 
> +PsfConfigureSataGrantCounts (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Specifies the root port configuration of the
> 
> +  PCIe controller. The number on the left of x
> 
> +  signifies the number of root ports in the controller
> 
> +  while value on the right is link width. N stands for
> 
> +  the number of PCIe lanes per root port instance.
> 
> +**/
> 
> +typedef enum {
> 
> +  PsfPcieCtrl4xn,
> 
> +  PsfPcieCtrl1x2n_2xn,
> 
> +  PsfPcieCtrl2xn_1x2n,
> 
> +  PsfPcieCtrl2x2n,
> 
> +  PsfPcieCtrl1x4n,
> 
> +  PsfPcieCtrlUndefined
> 
> +} PSF_PCIE_CTRL_CONFIG;
> 
> +
> 
> +/**
> 
> +  Program PSF grant counts for PCI express depending on controllers
> configuration
> 
> +
> 
> +  @param[in] PsfPcieCtrlConfigTable   Table with PCIe controllers
> configuration
> 
> +  @param[in] NumberOfPcieControllers  Number of PCIe controllers. This is
> also the size of PsfPcieCtrlConfig table
> 
> +**/
> 
> +VOID
> 
> +PsfConfigurePcieGrantCounts (
> 
> +  IN PSF_PCIE_CTRL_CONFIG  *PsfPcieCtrlConfigTable,
> 
> +  IN UINT32                NumberOfPcieControllers
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  This function enables EOI message forwarding in PSF for PCIe ports
> 
> +  for cases where IOAPIC is present behind this root port.
> 
> +
> 
> +  @param[in] RpIndex        Root port index (0 based)
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +PsfConfigurEoiForPciePort (
> 
> +  IN  UINT32   RpIndex
> 
> +  );
> 
> +
> 
> +//
> 
> +// Structure for PSF Port Destination ID
> 
> +//
> 
> +typedef union {
> 
> +  UINT32 RegVal;
> 
> +  struct {
> 
> +    UINT32  ChannelId   : 8;  // Channel ID
> 
> +    UINT32  PortId      : 7;  // Port ID
> 
> +    UINT32  PortGroupId : 1;  // Port Group ID
> 
> +    UINT32  PsfId       : 8;  // PSF ID
> 
> +    UINT32  Rsvd        : 7;  // Reserved
> 
> +    UINT32  ChanMap     : 1;  // Channel map
> 
> +  } Fields;
> 
> +} PSF_PORT_DEST_ID;
> 
> +
> 
> +/**
> 
> +  PCIe PSF port destination ID (psf_id:port_group_id:port_id:channel_id)
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval Destination ID
> 
> +**/
> 
> +PSF_PORT_DEST_ID
> 
> +PsfPcieDestinationId (
> 
> +  IN UINT32 RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  PSF early initialization.
> 
> +**/
> 
> +VOID
> 
> +PsfEarlyInit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Assign new function number for PCIe Port Number.
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +  @param[in] NewFunction    New Function number
> 
> +**/
> 
> +VOID
> 
> +PsfSetPcieFunction (
> 
> +  IN UINT32  RpIndex,
> 
> +  IN UINT32  NewFunction
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function enables PCIe Relaxed Order in PSF
> 
> +**/
> 
> +VOID
> 
> +PsfEnablePcieRelaxedOrder (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Enable VTd support in PSF.
> 
> +**/
> 
> +VOID
> 
> +PchPsfEnableVtd (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable PSF address-based peer-to-peer decoding.
> 
> +**/
> 
> +VOID
> 
> +PchPsfDisableP2pDecoding (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will hide PMC device at PSF level
> 
> +**/
> 
> +VOID
> 
> +PsfHidePmcDevice (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will disable D3:F0 device at PSF level for PCH-LP
> 
> +**/
> 
> +VOID
> 
> +PsfDisableD3F0 (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will disable PSF upstream completion tracking for HDAudio
> on PCH-LP
> 
> +**/
> 
> +VOID
> 
> +PsfDisableUpstreamCompletionTrackingForHda (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _PCH_PSF_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeS
> mmPsfLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeS
> mmPsfLibVer2.inf
> new file mode 100644
> index 0000000000..d8fc52444a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxeS
> mmPsfLibVer2.inf
> @@ -0,0 +1,40 @@
> +## @file
> 
> +#  PEI/DXE/SMM PCH PSF Private Lib for TigerLake PCH
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION                    = 0x00010017
> 
> +BASE_NAME                      = PeiDxeSmmPsfLibTgl
> 
> +FILE_GUID                      = 28B03D2C-6FD5-4061-96B8-39E3F0402DE5
> 
> +VERSION_STRING                 = 1.0
> 
> +MODULE_TYPE                    = BASE
> 
> +LIBRARY_CLASS                  = PsfLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +#  VALID_ARCHITECTURES           = IA32 X64
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PciSegmentLib
> 
> +  PchInfoLib
> 
> +  PchPcrLib
> 
> +  SataLib
> 
> +  CpuPcieInfoFruLib
> 
> +  PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +  PsfLib.c
> 
> +  PsfLibVer2.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
> new file mode 100644
> index 0000000000..1f0b11c11a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLib.c
> @@ -0,0 +1,203 @@
> +/** @file
> 
> +  This file contains PSF routines for RC usage
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SataLib.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <Library/PsfLib.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Register/PchRegsPsf.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include "PsfLibInternal.h"
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Get PSF SideBand Port ID from PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +
> 
> +  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +
> 
> +  @retval PSF SideBand Port ID
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PsfSbPortId (
> 
> +  UINT32        PsfId
> 
> +  )
> 
> +{
> 
> +  UINT32          PsfTableIndex;
> 
> +  PSF_SEGMENT     *PsfTable;
> 
> +  UINT32          PsfTableSize;
> 
> +
> 
> +  PsfSegments (&PsfTable, &PsfTableSize);
> 
> +
> 
> +  for (PsfTableIndex = 0; PsfTableIndex < PsfTableSize; PsfTableIndex++) {
> 
> +    if (PsfTable[PsfTableIndex].Id == PsfId) {
> 
> +      return PsfTable[PsfTableIndex].SbPid;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ASSERT (FALSE);
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Get PCH Root PSF ID. This is the PSF segment to which OPDMI/DMI is
> connected.
> 
> +
> 
> +  @retval PsfId             Root PSF ID
> 
> +**/
> 
> +UINT32
> 
> +PsfRootId (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  PSF_SEGMENT     *PsfTable;
> 
> +  UINT32          PsfTableSize;
> 
> +
> 
> +  PsfSegments (&PsfTable, &PsfTableSize);
> 
> +
> 
> +  return PsfTable[0].Id;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Add EOI Target in a given PSF
> 
> +
> 
> +  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +  @param[in] TargetId          EOI Target ID
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +PsfAddEoiTarget (
> 
> +  UINT32           PsfId,
> 
> +  PSF_PORT_DEST_ID TargetId
> 
> +  )
> 
> +{
> 
> +  UINT16      EoiTargetBase;
> 
> +  UINT16      EoiControlBase;
> 
> +  UINT8       NumOfEnabledTargets;
> 
> +  UINT8       MaximalNumberOfTargets;
> 
> +  PCH_SBI_PID PsfSbiPortId;
> 
> +  UINT32      Data32;
> 
> +  UINT8       TargetIndex;
> 
> +
> 
> +  MaximalNumberOfTargets = PsfEoiRegData (PsfId, &EoiTargetBase,
> &EoiControlBase);
> 
> +  PsfSbiPortId = PsfSbPortId (PsfId);
> 
> +
> 
> +  //
> 
> +  // Get number of enabled agents from
> PSF_x_PSF_MC_CONTROL_MCAST0_RS0_EOI register
> 
> +  //
> 
> +  Data32 = PchPcrRead32 (PsfSbiPortId, EoiControlBase);
> 
> +  NumOfEnabledTargets = (UINT8) (Data32 >>
> N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC);
> 
> +
> 
> +  //
> 
> +  // Check if target was not already enabled
> 
> +  // Targets from a different PSF segment are aggregated into single
> destination on
> 
> +  // current PSF segment.
> 
> +  //
> 
> +  for (TargetIndex = 0; TargetIndex < NumOfEnabledTargets;
> TargetIndex++) {
> 
> +    Data32 = PchPcrRead32 (PsfSbiPortId, EoiTargetBase + TargetIndex * 4);
> 
> +    //
> 
> +    // If target already added don't add it again
> 
> +    //
> 
> +    if (Data32 == TargetId.RegVal) {
> 
> +      ASSERT (FALSE);
> 
> +      return;
> 
> +    }
> 
> +    //
> 
> +    // If target is from different PSF segment than currently being analyzed
> 
> +    // it is enough that its PsfID is matching
> 
> +    //
> 
> +    if ((Data32 & B_PCH_PSFX_PCR_TARGET_PSFID) >>
> N_PCH_PSFX_PCR_TARGET_PSFID == TargetId.Fields.PsfId) {
> 
> +      return;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if next one can be added
> 
> +  //
> 
> +  if (NumOfEnabledTargets >= MaximalNumberOfTargets) {
> 
> +    ASSERT (FALSE);
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Add next target
> 
> +  // Configure Multicast Destination ID register with target device on PSF.
> 
> +  // Configuration must be done in next available
> PSF_MC_AGENT_MCAST0_RS0_TGT<x>_EOI register
> 
> +  // so that other targets  are not overridden. <x> is known from the
> number of multicast agents
> 
> +  // in Multicast Control Register. Value programmed is based on
> 
> +  // PsfID, PortGroupID, PortID and ChannelID of the target
> 
> +  //
> 
> +  PchPcrWrite32 (PsfSbiPortId, EoiTargetBase + NumOfEnabledTargets * 4,
> TargetId.RegVal);
> 
> +
> 
> +  //
> 
> +  // Enable new target
> 
> +  // Configure PSF_x_PSF_MC_CONTROL_MCAST0_RS0_EOI, increase
> NumMc and set MultCEn
> 
> +  //
> 
> +  NumOfEnabledTargets++;
> 
> +  Data32 = (NumOfEnabledTargets <<
> N_PCH_PSFX_PCR_MC_CONTROL_MCASTX_NUMMC) |
> B_PCH_PSFX_PCR_MC_CONTROL_MCASTX_MULTCEN;
> 
> +  PchPcrWrite32 (PsfSbiPortId, EoiControlBase, Data32);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enable EOI Target
> 
> +
> 
> +  @param[in] TargetId  Target ID
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +PsfEnableEoiTarget (
> 
> +  PSF_PORT_DEST_ID     TargetId
> 
> +  )
> 
> +{
> 
> +  UINT32 RootLevelPsf;
> 
> +
> 
> +  RootLevelPsf = PsfRootId ();
> 
> +
> 
> +  //
> 
> +  // Enable EOI target in root PSF
> 
> +  //
> 
> +  PsfAddEoiTarget (RootLevelPsf, TargetId);
> 
> +
> 
> +  //
> 
> +  // Enable EOI target on other PSF segment if target
> 
> +  // is not located on root PSF
> 
> +  //
> 
> +  if (TargetId.Fields.PsfId != RootLevelPsf) {
> 
> +    PsfAddEoiTarget (TargetId.Fields.PsfId, TargetId);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function enables EOI message forwarding in PSF for PCIe ports
> 
> +  for cases where IOAPIC is present behind this root port.
> 
> +
> 
> +  @param[in] RpIndex        Root port index (0 based)
> 
> +
> 
> +  @retval Status
> 
> +**/
> 
> +EFI_STATUS
> 
> +PsfConfigurEoiForPciePort (
> 
> +  IN  UINT32  RpIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (RpIndex < GetPchMaxPciePortNum ());
> 
> +
> 
> +  //
> 
> +  // If there is an IOAPIC discovered behind root port program PSF Multicast
> registers
> 
> +  // accordingly to CNL PCH BWG PSF EOI Multicast Configuration
> 
> +  // Since there is a device behind RootPort to which EOI needs to be
> forwarded
> 
> +  // enable multicast (MULTCEN) and increase the number of multicast
> agents (NUMMC)
> 
> +  // in Multicast Control Register.
> 
> +  //
> 
> +  PsfEnableEoiTarget (PsfPcieDestinationId (RpIndex));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibIn
> ternal.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibIn
> ternal.h
> new file mode 100644
> index 0000000000..9d636b5298
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibIn
> ternal.h
> @@ -0,0 +1,470 @@
> +/** @file
> 
> +  This file contains internal header for PSF lib usage
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_PSF_PRIVATE_LIB_INTERNAL_H_
> 
> +#define _PCH_PSF_PRIVATE_LIB_INTERNAL_H_
> 
> +
> 
> +#include <Library/PsfLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +#define PSF_PORT_NULL ((PSF_PORT){0,0})
> 
> +#define PSF_IS_PORT_NULL(PsfPort) ((PsfPort.PsfPid == 0) &&
> (PsfPort.RegBase == 0))
> 
> +
> 
> +typedef struct {
> 
> +  PCH_SBI_PID  PsfPid;
> 
> +  UINT32       RegisterAddress;
> 
> +  UINT8        Fro;
> 
> +} PSF_PORT_RELAXED_ORDERING_CONFIG_REG;
> 
> +/**
> 
> +  Disable bridge (e.g. PCIe Root Port) at PSF level
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfDisableBridge (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable bridge (e.g. PCIe Root Port) at PSF level in RS3
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfRs3DisableBridge (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if bridge (e.g. PCIe Root Port) is enabled at PSF level
> 
> +
> 
> +  @param[in] PsfPort  PSF PORT data structure
> 
> +
> 
> +  @retval TRUE        Bridge behind PSF Port is enabled
> 
> +          FALSE       Bridge behind PSF Port is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +PsfIsBridgeEnabled (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable device IOSpace at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfDisableDeviceIoSpace (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable device IOSpace at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfEnableDeviceIoSpace (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable device Memory Space at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfDisableDeviceMemSpace (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable device Memory Space at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +**/
> 
> +VOID
> 
> +PsfEnableDeviceMemSpace (
> 
> +  IN PSF_PORT  PsfPort
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set device BARx address at PSF level
> 
> +  Method not for bridges (e.g. PCIe Root Port)
> 
> +
> 
> +  @param[in] PsfPort     PSF PORT data structure
> 
> +  @param[in] BarNum      BAR Number (0:BAR0, 1:BAR1, ...)
> 
> +  @param[in] BarValue    32bit BAR value
> 
> +**/
> 
> +VOID
> 
> +PsfSetDeviceBarValue (
> 
> +  IN PSF_PORT  PsfPort,
> 
> +  IN UINT8     BarNum,
> 
> +  IN UINT32    BarValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for TraceHub device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for TraceHub device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfTraceHubPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return PSF_PORT for TraceHub ACPI device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for TraceHub ACPI device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfTraceHubAcpiDevPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This procedure will return PSF_PORT for SOL device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for SOL device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfSolPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for ISH device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for ISH device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfIshPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for FPAK device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for FPAK device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfFpakPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for CNVi device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for CNVi device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfCnviPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT for PMC device
> 
> +
> 
> +  @retval    PsfPort         PSF PORT structure for PMC device
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfPmcPort (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return second level PSF_PORT to which PCIE Root Port device is connected
> (directly)
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfPcieSecondLevelPort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return PSF_PORT at root PSF level to which PCIe Root Port device is
> connected
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe
> 
> +
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfRootPciePort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return RS3 PSF_PORT at root PSF level to which PCIe Root Port device is
> connected
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfRootRs3PciePort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if PCIe Root Port is enabled
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval TRUE              PCIe Root Port is enabled
> 
> +          FALSE             PCIe Root Port is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +PsfIsPcieRootPortEnabled (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +//
> 
> +// Type of enpoint connected to PSF port.
> 
> +// PsfNullPort is used for ports which do not exist
> 
> +//
> 
> +typedef enum {
> 
> +  PsfNullPort,
> 
> +  PsfToPsfPort,
> 
> +  PsfPcieCtrlPort
> 
> +} PSF_TOPO_PORT_TYPE;
> 
> +
> 
> +//
> 
> +// Structure for storing information on location in PSF topology
> 
> +// Every PSF node is identified by PsfID and PsfPortId
> 
> +//
> 
> +typedef struct {
> 
> +  UINT8         PsfId;
> 
> +  UINT8         PortId;
> 
> +} PSF_TOPO_PORT;
> 
> +
> 
> +#define PSF_TOPO_PORT_NULL ((PSF_TOPO_PORT){0, 0})
> 
> +#define PSF_IS_TOPO_PORT_NULL(PsfTopoPort) (((PsfTopoPort).PsfId ==
> 0) && ((PsfTopoPort).PortId == 0))
> 
> +
> 
> +//
> 
> +// This is optional field containing PSF port specific data
> 
> +//
> 
> +typedef union {
> 
> +  UINT32  PcieCtrlIndex;
> 
> +} PSF_TOPO_PORT_DATA;
> 
> +
> 
> +//
> 
> +// Structure representing PSF port in PSF topology
> 
> +// If port is of PsfToPsfPort type Child will point to the first
> 
> +// port of sub PSF segment.
> 
> +//
> 
> +typedef struct PSF_TOPOLOGY {
> 
> +  PSF_TOPO_PORT              PsfPort;
> 
> +  PSF_TOPO_PORT_TYPE         PortType;
> 
> +  CONST struct PSF_TOPOLOGY  *Child;
> 
> +  PSF_TOPO_PORT_DATA         PortData;
> 
> +} PSF_TOPOLOGY;
> 
> +
> 
> +//
> 
> +// Tag for identifying last element of PSF_TOPOLOGY type array
> 
> +//
> 
> +#define PSF_TOPOLOGY_END   {{0, 0}, PsfNullPort, NULL}
> 
> +
> 
> +/**
> 
> +  Get PSF Pcie Tree topology
> 
> +
> 
> +  @param[in] PsfTopology          PSF Port from PSF PCIe tree topology
> 
> +
> 
> +  @retval PsfTopology             PSF PCIe tree topology
> 
> +**/
> 
> +CONST PSF_TOPOLOGY*
> 
> +PsfGetRootPciePsfTopology (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +//
> 
> +// Structure for storing data on PCIe controller to PSF assignment and
> GrantCount register offsets
> 
> +//
> 
> +typedef struct {
> 
> +  PCH_SBI_PID  PsfPid;
> 
> +  UINT16       DevGntCnt0Base;
> 
> +  UINT16       TargetGntCntPg1Tgt0Base;
> 
> +} PSF_GRANT_COUNT_REG;
> 
> +
> 
> +/**
> 
> +  Grant count regs data for PSF that is directly connected to PCIe Root Ports
> 
> +
> 
> +  @param[in]  Controller     PCIe Root Port Controller index (0 based)
> 
> +  @param[out] GrantCountReg  Structure with PSF Grant Count register
> data
> 
> +**/
> 
> +VOID
> 
> +PsfPcieGrantCountBaseReg (
> 
> +  IN  UINT8                Controller,
> 
> +  OUT PSF_GRANT_COUNT_REG  *GrantCountReg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get Grant Count number (Device Grant Count and Target Grant Count)
> 
> +  for PSF that is directly connected to PCIe Root Ports
> 
> +
> 
> +  @param[in]  Controller    PCIe Root Port Controller index
> 
> +  @param[in]  Channel       PCIe Root Port Channel index
> 
> +  @param[out] DgcrNo        Device Grant Count number
> 
> +  @param[out] PgTgtNo       Target Grant Count number
> 
> +**/
> 
> +VOID
> 
> +PsfPcieGrantCountNumber (
> 
> +  IN  UINT8 Controller,
> 
> +  IN  UINT8 Channel,
> 
> +  OUT UINT8 *DgcrNo,
> 
> +  OUT UINT8 *PgTgtNo
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Grant count regs data for a given PSF-to-PSF port.
> 
> +
> 
> +  @param[in] PsfTopoPort         PSF-to-PSF port
> 
> +
> 
> +  @param[out] GrantCountReg      Structure with PSF Grant Count register
> data
> 
> +**/
> 
> +VOID
> 
> +PsfSegmentGrantCountBaseReg (
> 
> +  IN PSF_TOPO_PORT         PsfTopoPort,
> 
> +  OUT PSF_GRANT_COUNT_REG  *GrantCountReg
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Grant Count number (Device Grant Count and Target Grant Count) for a
> given PSF-to-PSF port.
> 
> +
> 
> +  @param[in] PsfTopoPort         PSF-to-PSF port
> 
> +  @param[out] DgcrNo             Device Grant Count number
> 
> +  @param[out] PgTgtNo            Target Grant Count number
> 
> +**/
> 
> +VOID
> 
> +PsfSegmentGrantCountNumber (
> 
> +  IN PSF_TOPO_PORT PsfTopoPort,
> 
> +  OUT UINT8        *DgcrNo,
> 
> +  OUT UINT8        *PgTgtNo
> 
> +  );
> 
> +
> 
> +//
> 
> +// Do not override PSF Grant Count value and leave HW default setting
> 
> +//
> 
> +#define DEFAULT_PCIE_GRANT_COUNT 0xFF
> 
> +
> 
> +/**
> 
> +  Get PSF SideBand Port ID from PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +
> 
> +  @param[in] PsfId             PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +
> 
> +  @retval PSF SideBand Port ID
> 
> +**/
> 
> +PCH_SBI_PID
> 
> +PsfSbPortId (
> 
> +  UINT32        PsfId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get EOI register data for given PSF ID
> 
> +
> 
> +  @param[in]  PsfId           PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +  @param[out] EoiTargetBase   EOI Target register
> 
> +  @param[out] EoiControlBase  EOI Control register
> 
> +
> 
> +  @retval MaxTargets          Number of supported targets
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +PsfEoiRegData (
> 
> +  UINT32        PsfId,
> 
> +  UINT16        *EoiTargetBase,
> 
> +  UINT16        *EoiControlBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get MCTP register data for given PSF ID
> 
> +
> 
> +  @param[in]  PsfId            PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +  @param[out] MctpTargetBase   MCTP Target register
> 
> +  @param[out] MctpControlBase  MCTP Control register
> 
> +
> 
> +  @retval MaxTargets           Number of supported targets
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +PsfMctpRegData (
> 
> +  UINT32        PsfId,
> 
> +  UINT16        *MctpTargetBase,
> 
> +  UINT16        *MctpControlBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if MCTP is supported
> 
> +
> 
> +  @retval TRUE              MCTP is supported
> 
> +          FALSE             MCTP is not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +PsfIsMctpSupported (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return the PSF (Root level) Function Config PSF_PORT for PCIe Root Port
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe Function Config
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfRootPcieFunctionConfigPort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return the PSF (Root level) RS3 Function Config PSF_PORT for PCIe Root
> Port
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe Function Config
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfRootRs3PcieFunctionConfigPort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Return the PSF Function Config Second Level PSF_PORT for PCIe Root Port
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval    PsfPort        PSF PORT structure for PCIe Function Config
> 
> +**/
> 
> +PSF_PORT
> 
> +PsfPcieFunctionConfigSecondLevelPort (
> 
> +  IN UINT32  RpIndex
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function returns Psf Port Relaxed Ordering Configs
> 
> +
> 
> +  @param[out] PsfPortRelaxedOrderingConfigRegs                          PCH Series
> specific table
> 
> +  @param[out] PsfPortRelaxedOrderingConfigRegsTableSize                 PCH
> Series specific table size
> 
> +  @param[out] PsfPortRelaxedOrderingConfigRegsPchTypeSpecific
> PCH type specific table
> 
> +  @param[out]
> PsfPortRelaxedOrderingConfigRegsPchTypeSpecificTableSize  PCH type
> specific table size
> 
> +**/
> 
> +VOID
> 
> +GetPsfPortRelaxedOrderingTables (
> 
> +  PSF_PORT_RELAXED_ORDERING_CONFIG_REG**
> PsfPortRelaxedOrderingConfigRegs,
> 
> +  UINT32*                                PsfPortRelaxedOrderingConfigRegsTableSize,
> 
> +  PSF_PORT_RELAXED_ORDERING_CONFIG_REG**
> PsfPortRelaxedOrderingConfigRegsPchTypeSpecific,
> 
> +  UINT32*
> PsfPortRelaxedOrderingConfigRegsPchTypeSpecificTableSize
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibV
> er2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibV
> er2.c
> new file mode 100644
> index 0000000000..fd21e5bed4
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Psf/LibraryPrivate/PsfLib/PsfLibV
> er2.c
> @@ -0,0 +1,115 @@
> +/** @file
> 
> +  This file contains internal PSF routines for PCH PSF VER2 lib usage
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SataLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Register/PchRegsPsf.h>
> 
> +#include "PsfLibInternal.h"
> 
> +#include <PchPcieRpInfo.h>
> 
> +
> 
> +
> 
> +/**
> 
> +  Get EOI register data for given PSF ID
> 
> +
> 
> +  @param[in]  PsfId           PSF ID (1 - PSF1, 2 - PSF2, ...)
> 
> +  @param[out] EoiTargetBase   EOI Target register
> 
> +  @param[out] EoiControlBase  EOI Control register
> 
> +
> 
> +  @retval MaxTargets          Number of supported targets
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +PsfEoiRegData (
> 
> +  UINT32        PsfId,
> 
> +  UINT16        *EoiTargetBase,
> 
> +  UINT16        *EoiControlBase
> 
> +  )
> 
> +{
> 
> +  UINT8  MaxTargets;
> 
> +
> 
> +  MaxTargets = 0;
> 
> +  *EoiTargetBase = 0;
> 
> +  *EoiControlBase = 0;
> 
> +
> 
> +  switch (PsfId) {
> 
> +    case 1:
> 
> +      break;
> 
> +
> 
> +    case 3:
> 
> +      break;
> 
> +
> 
> +    case 7:
> 
> +      break;
> 
> +
> 
> +    case 8:
> 
> +      break;
> 
> +
> 
> +    case 9:
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      break;
> 
> +
> 
> +  }
> 
> +  return MaxTargets;
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PSF_PORT_DEST_ID
> PchLpRpDestId[] =
> 
> +{
> 
> +  {0x18000}, {0x18001}, {0x18002}, {0x18003}, // SPA: PSF1, PortID = 0
> 
> +  {0x18100}, {0x18101}, {0x18102}, {0x18103}, // SPB: PSF1, PortID = 1
> 
> +  {0x18200}, {0x18201}, {0x18202}, {0x18203}, // SPC: PSF1, PortID = 2
> 
> +};
> 
> +
> 
> +/**
> 
> +  PCIe PSF port destination ID (psf_id:port_group_id:port_id:channel_id)
> 
> +
> 
> +  @param[in] RpIndex        PCIe Root Port Index (0 based)
> 
> +
> 
> +  @retval Destination ID
> 
> +**/
> 
> +PSF_PORT_DEST_ID
> 
> +PsfPcieDestinationId (
> 
> +  IN UINT32  RpIndex
> 
> +  )
> 
> +{
> 
> +  if (RpIndex < ARRAY_SIZE (PchLpRpDestId)) {
> 
> +    return PchLpRpDestId[RpIndex];
> 
> +  }
> 
> +  ASSERT (FALSE);
> 
> +  return (PSF_PORT_DEST_ID){0};
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PSF_SEGMENT mPchLpPsfTable[] =
> 
> +{
> 
> +  {1, PID_PSF1},
> 
> +  {2, PID_PSF2},
> 
> +  {3, PID_PSF3},
> 
> +  {4, PID_PSF4},
> 
> +  {5, PID_CSME_PSF},
> 
> +  {6, PID_PSF6}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get list of supported PSF segments.
> 
> +
> 
> +  @param[out] PsfTable        Array of supported PSF segments
> 
> +  @param[out] PsfTableLength  Length of PsfTable
> 
> +**/
> 
> +VOID
> 
> +PsfSegments (
> 
> +  OUT PSF_SEGMENT  **PsfTable,
> 
> +  OUT UINT32       *PsfTableLength
> 
> +  )
> 
> +{
> 
> +*PsfTable = mPchLpPsfTable;
> 
> +    *PsfTableLength = ARRAY_SIZE (mPchLpPsfTable);
> 
> +}
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component
  2021-02-01  1:36 ` [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Sata/Library
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/Pei
> DxeSmmSataLibVer2.inf |  32 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/Sat
> aLib.c                | 138
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/Sat
> aLibVer2.c            |  83
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++
>  3 files changed, 253 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> PeiDxeSmmSataLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> PeiDxeSmmSataLibVer2.inf
> new file mode 100644
> index 0000000000..1c304fed59
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> PeiDxeSmmSataLibVer2.inf
> @@ -0,0 +1,32 @@
> +## @file
> 
> +# PEI/DXE/SMM PCH SATA library Ver2
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchSataLibVer2
> 
> +FILE_GUID = 2519ADE8-D971-4551-8A8E-2EB55DFC555B
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = SataLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +PciSegmentLib
> 
> +PchInfoLib
> 
> +PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +SataLib.c
> 
> +SataLibVer2.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLib.c
> new file mode 100644
> index 0000000000..49cba49910
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLib.c
> @@ -0,0 +1,138 @@
> +/** @file
> 
> +  Pch SATA library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SataLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SataRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Get SATA controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +SataRegBase (
> 
> +  IN UINT32      SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +
> 
> +  return SataPciCfgBase (SataCtrlIndex);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller's Port Present Status
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     Port Present Status
> 
> +**/
> 
> +UINT8
> 
> +GetSataPortPresentStatus (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +
> 
> +  return PciSegmentRead8 (SataPciCfgBase (SataCtrlIndex) +
> R_SATA_CFG_PCS + 2);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller Function Disable Status
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval 0 SATA Controller is not Function Disabled
> 
> +  @retval 1 SATA Controller is Function Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SataControllerFunctionDisableStatus (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  UINT32 SataGc;
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +  SataGc = PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) +
> R_SATA_CFG_SATAGC);
> 
> +  return !!(SataGc & BIT10);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller ABAR size
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller ABAR size
> 
> +**/
> 
> +UINT32
> 
> +GetSataAbarSize (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  UINT32 SataGc;
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +  SataGc = PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) +
> R_SATA_CFG_SATAGC);
> 
> +
> 
> +  switch (SataGc & B_SATA_CFG_SATAGC_ASSEL) {
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_2K:
> 
> +      return SIZE_2KB;
> 
> +      break;
> 
> +
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_16K:
> 
> +      return SIZE_16KB;
> 
> +      break;
> 
> +
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_32K:
> 
> +      return SIZE_32KB;
> 
> +      break;
> 
> +
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_64K:
> 
> +      return SIZE_64KB;
> 
> +      break;
> 
> +
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_128K:
> 
> +      return SIZE_128KB;
> 
> +      break;
> 
> +
> 
> +    case V_SATA_CFG_SATAGC_ASSEL_512K:
> 
> +      return SIZE_256KB;
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      return SIZE_2KB;
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller AHCI base address
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller AHCI base address
> 
> +**/
> 
> +UINT32
> 
> +GetSataAhciBase (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +
> 
> +  return PciSegmentRead32 (SataPciCfgBase (SataCtrlIndex) +
> R_SATA_CFG_AHCI_BAR) & 0xFFFFF800;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLibVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLibVer2.c
> new file mode 100644
> index 0000000000..cde74e4e76
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Sata/Library/PeiDxeSmmSataLib/
> SataLibVer2.c
> @@ -0,0 +1,83 @@
> +/** @file
> 
> +  Pch SATA library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Register/SataRegs.h>
> 
> +#include <Library/SataLib.h>
> 
> +
> 
> +/**
> 
> +  Get Maximum Sata Controller Number
> 
> +
> 
> +  @retval Maximum Sata Controller Number
> 
> +**/
> 
> +UINT8
> 
> +MaxSataControllerNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Maximum Sata Port Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     Maximum Sata Port Number
> 
> +**/
> 
> +UINT8
> 
> +MaxSataPortNum (
> 
> +  IN UINT32      SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if SATA controller supports RST remapping
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval     TRUE                Controller supports remapping
> 
> +  @retval     FALSE               Controller does not support remapping
> 
> +
> 
> +**/
> 
> +BOOLEAN
> 
> +IsRemappingSupportedOnSata (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MaxSataControllerNum ());
> 
> +
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if SoC supports the SATA PGD power down on given
> 
> +  SATA controller.
> 
> +
> 
> +  @param[in] SataCtrlIndex  SATA controller index
> 
> +
> 
> +  @retval TRUE   SATA PGD power down supported
> 
> +  @retval FALSE  SATA PGD power down not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSataPowerGatingSupported (
> 
> +  IN UINT32 SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component
  2021-02-01  1:36 ` [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/SerialIo/IncludePrivate
>   * IpBlock/SerialIo/Library
>   * IpBlock/SerialIo/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> 
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/Seri
> alIoPrivateLib.h                                    | 377
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/Ser
> ialIoRegsVer2.h                                     | 108
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIo
> AccessLib/PeiDxeSmmSerialIoAccessLib.inf              |  35
> +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerialIo
> AccessLib/SerialIoAccessLib.c                         | 266
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf |  34
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLib.c                | 156
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibI2c.c             | 122
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c         |  70
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibInternal.h        |  20
> ++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibSpi.c             | 122
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c         |  82
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibUart.c            | 136
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSmm
> SerialIoPrivateLib/SerialIoPrivateLibUartVer2.c        |  82
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
>  13 files changed, 1610 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/Se
> rialIoPrivateLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/Se
> rialIoPrivateLib.h
> new file mode 100644
> index 0000000000..47057cd2ef
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Library/Se
> rialIoPrivateLib.h
> @@ -0,0 +1,377 @@
> +/** @file
> 
> +  Header file for Serial IO Private Lib implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_PRIVATE_LIB_H_
> 
> +#define _SERIAL_IO_PRIVATE_LIB_H_
> 
> +
> 
> +#include <SerialIoDevices.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Serial Io Pci Device State structure.
> 
> +  Used to preserve current information about the device when it is
> configured in Pci mode prior to Pch Initialization.
> 
> +**/
> 
> +typedef struct {
> 
> +  UINT64 PciCfgBar0;       ///< Pci Config Space Base Address Register
> 
> +  UINT8  PciCfgCommand;    ///< Pci Config Space Command Register
> 
> +  UINT8  PciCfgPmeCtrlSts; ///< Pci Config Space Pme Control Status
> 
> +  UINT8  PprReset;         ///< MMIO Proprietary Reset Register
> 
> +} SERIAL_IO_PCI_DEVICE_STATE;
> 
> +
> 
> +/**
> 
> +  Checks if higher functions are enabled.
> 
> +  Used for Function 0 Serial Io Device disabling
> 
> +
> 
> +  @param[in] DeviceNum       Device Number
> 
> +
> 
> +  @retval TRUE               At least one higher function device is enabled
> 
> +          FALSE              Higher functions are disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SerialIoHigherFunctionsEnabled (
> 
> +  IN UINT8                    DeviceNum
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Places SerialIo device in D3
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSetD3 (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Places SerialIo device in D0
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSetD0 (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Allows Memory Access
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +  @param[in] Hidden           Mode that determines access type
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoEnableMse (
> 
> +  IN UINT64                    PciCfgBase,
> 
> +  IN BOOLEAN                   Hidden
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable SerialIo memory access
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoDisableMse (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable SerialIo memory encoding
> 
> +  Designated for Pci modes
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +  @param[in] RemoveTempBar    Remove temporary mem base address or
> not
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoMmioDisable (
> 
> +  IN UINT64                    PciCfgBase,
> 
> +  IN BOOLEAN                   RemoveBar
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Fixed Base Address used for BAR0
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Config control offset
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoSpiFixedMmioAddress (
> 
> +  IN UINT8       SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoSpiFixedPciCfgAddress (
> 
> +  IN UINT8       SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Spi Device Id
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoSpiDeviceId (
> 
> +  IN UINT8       SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if SPI is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in] SpiNumber       Selects Serial IO SPI device
> 
> +
> 
> +  @retval   TRUE             SPI is in hidden mode
> 
> +  @retval   FALSE            SPI is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoSpiHidden (
> 
> +  IN UINT8               SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] SpiNumber         SPI Number
> 
> +  @param[in] SpiDeviceConfig   SerialIo SPI Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSpiBootHandler (
> 
> +  IN UINT8                      SpiNumber,
> 
> +  IN SERIAL_IO_SPI_CONFIG       *SpiDeviceConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     SpiNumber         SPI Number
> 
> +  @param[in]     SpiDeviceConfig   SerialIo SPI Config
> 
> +  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command           Pci Command register data to save
> 
> +  @param[in/out] Pme               Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSpiS3Handler (
> 
> +  IN     UINT8                 SpiNumber,
> 
> +  IN     SERIAL_IO_SPI_CONFIG  *SpiDeviceConfig,
> 
> +  IN OUT UINT64                *S3PciCfgBase,
> 
> +  IN OUT UINT32                *Command,
> 
> +  IN OUT UINT32                *Pme
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Pci Config control offset
> 
> +
> 
> +  @param[in] UartNumber              Serial IO device UART number
> 
> +
> 
> +  @retval                            Config control offset
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoUartConfigControlOffset (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Fixed Base Address used for BAR0
> 
> +
> 
> +  @param[in] UartNumber              Serial IO device UART number
> 
> +
> 
> +  @retval                            Config control offset
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoUartFixedMmioAddress (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] UartNumber              Serial IO device UART number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoUartFixedPciCfgAddress (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns UART S3 boot script PCI address
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    UART  S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoUartS3PciBase (
> 
> +  IN UINT8        UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns SPI S3 boot script PCI address
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    SPI S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoSpiS3PciBase (
> 
> +  IN UINT8        SpiNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Returns I2C S3 boot script PCI address
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +
> 
> +  @retval    I2C  S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoI2cS3PciBase (
> 
> +  IN UINT8        I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Uarts Device Id
> 
> +
> 
> +  @param[in] UartNumbe               Serial IO device UART number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoUartDeviceId (
> 
> +  IN UINT8       UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if UART is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in]      UartNumber     Selects Serial IO UART device
> 
> +
> 
> +  @retval   TRUE             UART is in hidden mode
> 
> +  @retval   FALSE            UART is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoUartHidden (
> 
> +  IN UINT8               UartNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +  @param[in] UartDeviceConfig   SerialIo UART Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoUartBootHandler (
> 
> +  IN UINT8                      UartNumber,
> 
> +  IN SERIAL_IO_UART_CONFIG      *UartDeviceConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     UartNumber         UART Number
> 
> +  @param[in]     UartDeviceConfig   SerialIo UART Config
> 
> +  @param[in/out] S3PciCfgBase       S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command            Pci Command register data to save
> 
> +  @param[in/out] Pme                Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoUartS3Handler (
> 
> +  IN     UINT8                  UartNumber,
> 
> +  IN     SERIAL_IO_UART_CONFIG  *UartDeviceConfig,
> 
> +  IN OUT UINT64                 *S3PciCfgBase,
> 
> +  IN OUT UINT32                 *Command,
> 
> +  IN OUT UINT32                 *Pme
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] I2cNumber               Serial IO device I2C number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoI2cFixedPciCfgAddress (
> 
> +  IN UINT8       I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gets I2C Device Id
> 
> +
> 
> +  @param[in] I2cNumber               Serial IO device I2C number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoI2cDeviceId (
> 
> +  IN UINT8       I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Checks if I2C is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in] 2cNumber        Selects Serial IO I2C device
> 
> +
> 
> +  @retval   TRUE             I2C is in hidden mode
> 
> +  @retval   FALSE            I2C is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cHidden (
> 
> +  IN UINT8               I2cNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +  @param[in] I2cDeviceConfig   SerialIo I2C Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoI2cBootHandler (
> 
> +  IN UINT8                      I2cNumber,
> 
> +  IN SERIAL_IO_I2C_CONFIG       *I2cDeviceConfig
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     I2cNumber         I2C Number
> 
> +  @param[in]     I2cDeviceConfig   SerialIo I2C Config
> 
> +  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command           Pci Command register data to save
> 
> +  @param[in/out] Pme               Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoI2cS3Handler (
> 
> +  IN     UINT8                 I2cNumber,
> 
> +  IN     SERIAL_IO_I2C_CONFIG  *I2cDeviceConfig,
> 
> +  IN OUT UINT64                *S3PciCfgBase,
> 
> +  IN OUT UINT32                *Command,
> 
> +  IN OUT UINT32                *Pme
> 
> +  );
> 
> +
> 
> +#endif // _SERIAL_IO_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/S
> erialIoRegsVer2.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/
> SerialIoRegsVer2.h
> new file mode 100644
> index 0000000000..01840b14c9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/IncludePrivate/Register/
> SerialIoRegsVer2.h
> @@ -0,0 +1,108 @@
> +/** @file
> 
> +  Device IDs for Serial IO Controllers for TGL PCH
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_REGS_VER2_H_
> 
> +#define _SERIAL_IO_REGS_VER2_H_
> 
> +//
> 
> +//  Serial IO I2C0 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C0_DEVICE_ID       0xA0E8
> 
> +
> 
> +//
> 
> +//  Serial IO I2C1 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C1_DEVICE_ID       0xA0E9
> 
> +
> 
> +//
> 
> +//  Serial IO I2C2 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C2_DEVICE_ID       0xA0EA
> 
> +
> 
> +//
> 
> +//  Serial IO I2C3 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C3_DEVICE_ID       0xA0EB
> 
> +
> 
> +//
> 
> +//  Serial IO I2C4 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C4_DEVICE_ID       0xA0C5
> 
> +
> 
> +//
> 
> +//  Serial IO I2C5 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_I2C5_DEVICE_ID       0xA0C6
> 
> +
> 
> +//
> 
> +//  Serial IO SPI0 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI0_DEVICE_ID       0xA0AA
> 
> +
> 
> +//
> 
> +//  Serial IO SPI1 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI1_DEVICE_ID       0xA0AB
> 
> +
> 
> +//
> 
> +//  Serial IO SPI2 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI2_DEVICE_ID       0xA0FB
> 
> +
> 
> +//
> 
> +//  Serial IO SPI3 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_SPI3_DEVICE_ID       0xA0FD
> 
> +
> 
> +//
> 
> +//  Serial IO UART0 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART0_DEVICE_ID      0xA0A8
> 
> +
> 
> +//
> 
> +//  Serial IO UART1 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART1_DEVICE_ID      0xA0A9
> 
> +
> 
> +//
> 
> +//  Serial IO UART2 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART2_DEVICE_ID      0xA0C7
> 
> +
> 
> +//
> 
> +//  Serial IO UART3 Controller Registers
> 
> +//
> 
> +#define V_VER2_PCH_LP_SERIAL_IO_CFG_UART3_DEVICE_ID      0xA0DA
> 
> +
> 
> +#endif //_SERIAL_IO_REGS_VER2_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
> new file mode 100644
> index 0000000000..9178840ca8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
> @@ -0,0 +1,35 @@
> +## @file
> 
> +# Component description file for PEI/DXE/SMM Serial Io Access Lib.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION    = 0x00010017
> 
> +  BASE_NAME      = PeiDxeSmmSerialIoAccessLib
> 
> +  FILE_GUID      = F1A20692-26CA-4CA4-A775-695BBD6D3EC7
> 
> +  VERSION_STRING = 1.0
> 
> +  MODULE_TYPE    = BASE
> 
> +  LIBRARY_CLASS  = SerialIoAccessLib
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PcdLib
> 
> +  PciSegmentLib
> 
> +  PchPcrLib
> 
> +  SerialIoPrivateLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +  SerialIoAccessLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/SerialIoAccessLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/SerialIoAccessLib.c
> new file mode 100644
> index 0000000000..2b3a3dca5a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/Library/PeiDxeSmmSerial
> IoAccessLib/SerialIoAccessLib.c
> @@ -0,0 +1,266 @@
> +/** @file
> 
> +  Serial Io Common Lib implementation.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Include/PcieRegs.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <PchLimits.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Returns BAR0
> 
> +
> 
> +  @param[in] PciCfgBase         Pci Config Base
> 
> +
> 
> +  @retval    64bit MMIO BAR Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoBar (
> 
> +  IN UINT64        PciCfgBase
> 
> +  )
> 
> +{
> 
> +  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
> 
> +    return (UINT64) ((PciSegmentRead32 ((UINTN) (PciCfgBase +
> PCI_BASE_ADDRESSREG_OFFSET)) & 0xFFFFF000) + LShiftU64
> (PciSegmentRead32 ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET
> + 4)), 32));
> 
> +  }
> 
> +  return (UINT64) ((MmioRead32 ((UINTN) (PciCfgBase +
> PCI_BASE_ADDRESSREG_OFFSET)) & 0xFFFFF000) + LShiftU64 (MmioRead32
> ((UINTN) (PciCfgBase + PCI_BASE_ADDRESSREG_OFFSET + 4)), 32));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns I2C Pci Config Space
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +
> 
> +  @retval    I2C Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoI2cPciCfg (
> 
> +  IN UINT8        I2cNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoI2cHidden (I2cNumber)) {
> 
> +    return (UINTN) GetSerialIoI2cFixedPciCfgAddress (I2cNumber);
> 
> +  }
> 
> +  return SerialIoI2cPciCfgBase (I2cNumber);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns SPI Pci Config Space
> 
> +
> 
> +  @param[in] SpiNumber         SPI Number
> 
> +
> 
> +  @retval    SPI Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoSpiPciCfg (
> 
> +  IN UINT8        SpiNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoSpiHidden (SpiNumber)) {
> 
> +    return (UINTN) GetSerialIoSpiFixedPciCfgAddress (SpiNumber);
> 
> +  }
> 
> +  return SerialIoSpiPciCfgBase (SpiNumber);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns UART Pci Config Space
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    UART Pci Config Space Address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoUartPciCfg (
> 
> +  IN UINT8        UartNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoUartHidden (UartNumber)) {
> 
> +    return GetSerialIoUartFixedPciCfgAddress (UartNumber);
> 
> +  }
> 
> +  return SerialIoUartPciCfgBase (UartNumber);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns SPI S3 boot script PCI address
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    SPI S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoSpiS3PciBase (
> 
> +  IN UINT8        SpiNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoSpiHidden (SpiNumber)) {
> 
> +  //
> 
> +  // It's not expected to return Spi S3 Boot Script PCI address for non PCI
> mode.
> 
> +  //
> 
> +    ASSERT (TRUE);
> 
> +  }
> 
> +  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoSpiDevNumber (SpiNumber),
> 
> +           SerialIoSpiFuncNumber (SpiNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns UART S3 boot script PCI address
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +
> 
> +  @retval    UART  S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoUartS3PciBase (
> 
> +  IN UINT8        UartNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoUartHidden (UartNumber)) {
> 
> +  //
> 
> +  // It's not expected to return Uart S3 Boot Script PCI address for non PCI
> mode.
> 
> +  //
> 
> +    ASSERT (TRUE);
> 
> +  }
> 
> +  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoUartDevNumber (UartNumber),
> 
> +           SerialIoUartFuncNumber (UartNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns I2C S3 boot script PCI address
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +
> 
> +  @retval    I2C  S3 boot script PCI address
> 
> +**/
> 
> +UINT64
> 
> +GetSerialIoI2cS3PciBase (
> 
> +  IN UINT8        I2cNumber
> 
> +  )
> 
> +{
> 
> +  if (IsSerialIoI2cHidden (I2cNumber)) {
> 
> +  //
> 
> +  // It's not expected to return I2c S3 Boot Script PCI address for non PCI
> mode.
> 
> +  //
> 
> +    ASSERT (TRUE);
> 
> +  }
> 
> +  return S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoI2cDevNumber (I2cNumber),
> 
> +           SerialIoI2cFuncNumber (I2cNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Device with given PciDeviceId is one of SerialIo I2C controllers
> 
> +  If yes, its number is returned through I2cIndex parameter, otherwise
> I2cIndex is not updated
> 
> +
> 
> +  @param[in]  PciDevId                  Device ID
> 
> +  @param[out] I2cNumber                 Number of SerialIo I2C controller
> 
> +
> 
> +  @retval TRUE                          yes it is a SerialIo I2C controller
> 
> +  @retval FALSE                         no it isn't a SerialIo I2C controller
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cDeviceId (
> 
> +  IN  UINT16    PciDevId,
> 
> +  OUT UINT8     *I2cNumber
> 
> +  )
> 
> +{
> 
> +  UINT8 Index;
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
> 
> +    if (PciDevId == GetSerialIoI2cDeviceId (Index)) {
> 
> +      *I2cNumber = Index;
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if I2c is Function 0 Enabled
> 
> +
> 
> +  @param[in] I2cIndex                   Number of the SerialIo I2C controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cFunction0Enabled (
> 
> +  IN UINT8    I2cIndex
> 
> +  )
> 
> +{
> 
> +  if (SerialIoI2cFuncNumber (I2cIndex) == 0) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cIndex))) {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Uart is Function 0 Enabled
> 
> +
> 
> +  @param[in] UartIndex                   Number of the SerialIo Uart controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoUartFunction0Enabled (
> 
> +  IN UINT8    UartIndex
> 
> +  )
> 
> +{
> 
> +  if (SerialIoUartFuncNumber (UartIndex) == 0) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber (UartIndex)))
> {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Spi is Function 0 Enabled
> 
> +
> 
> +  @param[in] SpiIndex                   Number of the SerialIo Spi controller
> 
> +
> 
> +  @retval TRUE                          Enabled
> 
> +  @retval FALSE                         Disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoSpiFunction0Enabled (
> 
> +  IN UINT8    SpiIndex
> 
> +  )
> 
> +{
> 
> +  if (SerialIoSpiFuncNumber (SpiIndex) == 0) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiIndex))) {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
> new file mode 100644
> index 0000000000..8981be2496
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
> @@ -0,0 +1,34 @@
> +## @file
> 
> +# Serial Io Private Lib Ver 2
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION    = 0x00010017
> 
> +  BASE_NAME      = PeiDxeSmmSerialIoLibVer2
> 
> +  FILE_GUID      = 9D9F99CD-C072-48C2-BF78-ABA3D664C0FA
> 
> +  VERSION_STRING = 1.0
> 
> +  MODULE_TYPE    = BASE
> 
> +  LIBRARY_CLASS  = SerialIoPrivateLib
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  IoLib
> 
> +  PciSegmentLib
> 
> +  SerialIoAccessLib
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +  SerialIoPrivateLib.c
> 
> +  SerialIoPrivateLibI2c.c
> 
> +  SerialIoPrivateLibI2cVer2.c
> 
> +  SerialIoPrivateLibSpi.c
> 
> +  SerialIoPrivateLibSpiVer2.c
> 
> +  SerialIoPrivateLibUart.c
> 
> +  SerialIoPrivateLibUartVer2.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLib.c
> new file mode 100644
> index 0000000000..9b84c2dda6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLib.c
> @@ -0,0 +1,156 @@
> +/** @file
> 
> +  Serial IO Private Lib implementation.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SerialIoRegs.h>
> 
> +#include <Include/PcieRegs.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <PchReservedResources.h>
> 
> +
> 
> +/**
> 
> +  Checks if higher functions are enabled.
> 
> +  Used for Function 0 Serial Io Device disabling
> 
> +
> 
> +  @param[in] DeviceNum       Device Number
> 
> +
> 
> +  @retval TRUE               At least one higher function device is enabled
> 
> +          FALSE              Higher functions are disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SerialIoHigherFunctionsEnabled (
> 
> +  IN UINT8                    DeviceNum
> 
> +  )
> 
> +{
> 
> +  UINT8 FuncNum;
> 
> +  //
> 
> +  // Check all other func devs(1 to 7) status except func 0.
> 
> +  //
> 
> +  for (FuncNum = 1; FuncNum <= PCI_MAX_FUNC; FuncNum++) {
> 
> +    if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +                                                   DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +                                                   DeviceNum,
> 
> +                                                   FuncNum,
> 
> +                                                   PCI_DEVICE_ID_OFFSET)
> 
> +                          ) != 0xFFFF) {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Places SerialIo device in D3
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSetD3 (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  )
> 
> +{
> 
> +  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
> 
> +    PciSegmentOr32 (PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, BIT1 |
> BIT0);
> 
> +  } else {
> 
> +    MmioOr8 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS, BIT1
> | BIT0);
> 
> +    //
> 
> +    // Reading back value after write to ensure bridge observes the BAR1
> write access
> 
> +    //
> 
> +    MmioRead8 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Places SerialIo device in D0
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSetD0 (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  )
> 
> +{
> 
> +  if (PciCfgBase < PCH_SERIAL_IO_BASE_ADDRESS) {
> 
> +    PciSegmentAnd32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_PME_CTRL_STS, (UINT32) ~(BIT1 | BIT0));
> 
> +  } else {
> 
> +    MmioAnd32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS,
> (UINT32) ~(BIT1 | BIT0));
> 
> +    //
> 
> +    // Reading back value after write to ensure bridge observes the BAR1
> write access
> 
> +    //
> 
> +    MmioRead32 ((UINTN) PciCfgBase + R_SERIAL_IO_CFG_PME_CTRL_STS);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Allows memory access
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +  @param[in] Hidden           Mode that determines access type
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoEnableMse (
> 
> +  IN UINT64                    PciCfgBase,
> 
> +  IN BOOLEAN                   Hidden
> 
> +  )
> 
> +{
> 
> +  if (Hidden) {
> 
> +    MmioOr16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +    //
> 
> +    // Reading back value after write to ensure bridge observes the BAR1
> write access
> 
> +    //
> 
> +    MmioRead16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET);
> 
> +  } else {
> 
> +    PciSegmentOr16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Disable SerialIo memory access
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoDisableMse (
> 
> +  IN UINT64                    PciCfgBase
> 
> +  )
> 
> +{
> 
> +  PciSegmentAnd16 ((UINTN) PciCfgBase + PCI_COMMAND_OFFSET,
> (UINT16) ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Disable SerialIo memory encoding
> 
> +  Designated for Pci modes
> 
> +
> 
> +  @param[in] PciCfgBase       Pci Config Offset
> 
> +  @param[in] RemoveTempBar    Remove temporary mem base address or
> not
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoMmioDisable (
> 
> +  IN UINT64                    PciCfgBase,
> 
> +  IN BOOLEAN                   RemoveBar
> 
> +  )
> 
> +{
> 
> +  SerialIoDisableMse (PciCfgBase);
> 
> +
> 
> +  if (RemoveBar == TRUE) {
> 
> +    PciSegmentWrite32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_BAR0_LOW,  0x0);
> 
> +    PciSegmentWrite32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_BAR0_HIGH,  0x0);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2c.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2c.c
> new file mode 100644
> index 0000000000..7601081cfa
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2c.c
> @@ -0,0 +1,122 @@
> +/** @file
> 
> +  Common Serial IO Private Lib implementation - I2C part
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SerialIoRegs.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Checks if I2C is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in] I2cNumber     Selects Serial IO I2C device
> 
> +
> 
> +  @retval   TRUE             I2C is in hidden mode
> 
> +  @retval   FALSE            I2C is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoI2cHidden (
> 
> +  IN UINT8               I2cNumber
> 
> +  )
> 
> +{
> 
> +  if (MmioRead16 (GetSerialIoI2cFixedPciCfgAddress (I2cNumber) +
> PCI_DEVICE_ID_OFFSET) == GetSerialIoI2cDeviceId (I2cNumber)) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] I2cNumber         I2C Number
> 
> +  @param[in] I2cDeviceConfig   SerialIo I2C Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoI2cBootHandler (
> 
> +  IN UINT8                      I2cNumber,
> 
> +  IN SERIAL_IO_I2C_CONFIG       *I2cDeviceConfig
> 
> +  )
> 
> +{
> 
> +  UINT64   PciCfgBase;
> 
> +  BOOLEAN  TurnOff;
> 
> +
> 
> +  TurnOff = FALSE;
> 
> +
> 
> +  if (I2cDeviceConfig->Mode == SerialIoI2cPci) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  if ((I2cDeviceConfig->Mode == SerialIoI2cDisabled) &&
> (SerialIoI2cFuncNumber (I2cNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cNumber)))
> {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    PciCfgBase = GetSerialIoI2cPciCfg (I2cNumber);
> 
> +    SerialIoSetD3 (PciCfgBase);
> 
> +    SerialIoMmioDisable (PciCfgBase, TRUE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     I2cNumber         I2C Number
> 
> +  @param[in]     I2cDeviceConfig   SerialIo I2C Config
> 
> +  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command           Pci Command register data to save
> 
> +  @param[in/out] Pme               Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoI2cS3Handler (
> 
> +  IN     UINT8                 I2cNumber,
> 
> +  IN     SERIAL_IO_I2C_CONFIG  *I2cDeviceConfig,
> 
> +  IN OUT UINT64                *S3PciCfgBase,
> 
> +  IN OUT UINT32                *Command,
> 
> +  IN OUT UINT32                *Pme
> 
> +  )
> 
> +{
> 
> +  BOOLEAN  TurnOff;
> 
> +  UINT64   PciCfgBase;
> 
> +
> 
> +  *S3PciCfgBase = 0;
> 
> +  TurnOff       = FALSE;
> 
> +
> 
> +  if (I2cDeviceConfig->Mode == SerialIoI2cPci) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  if ((I2cDeviceConfig->Mode == SerialIoI2cDisabled) &&
> (SerialIoI2cFuncNumber (I2cNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoI2cDevNumber (I2cNumber)))
> {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    *S3PciCfgBase = GetSerialIoI2cS3PciBase (I2cNumber);
> 
> +    PciCfgBase    = GetSerialIoI2cPciCfg (I2cNumber);
> 
> +    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_PME_CTRL_STS);
> 
> +    *Pme          = *Pme | BIT0 | BIT1;
> 
> +    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase +
> PCI_COMMAND_OFFSET);
> 
> +    *Command      = *Command &
> (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE |
> EFI_PCI_COMMAND_BUS_MASTER);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c
> new file mode 100644
> index 0000000000..fd684ca2a9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibI2cVer2.c
> @@ -0,0 +1,70 @@
> +/** @file
> 
> +  Serial IO I2C Private Lib implementation TigerLake specific.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Register/SerialIoRegsVer2.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoI2cDevId [] =
> {
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C0_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C1_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C2_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C3_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C4_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_I2C5_DEVICE_ID
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoI2cFixedAddress [] = {
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x0000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x1000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x2000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x3000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x4000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x5000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x6000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x7000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x8000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x9000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0xA000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0xB000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0xC000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0xD000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0xE000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0xF000}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] I2cNumber               Serial IO device I2C number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoI2cFixedPciCfgAddress (
> 
> +  IN UINT8       I2cNumber
> 
> +  )
> 
> +{
> 
> +  return mSerialIoI2cFixedAddress[I2cNumber].Bar1;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Gets I2C Device Id
> 
> +
> 
> +  @param[in] I2cNumber               Serial IO device I2C number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoI2cDeviceId (
> 
> +  IN UINT8       I2cNumber
> 
> +  )
> 
> +{
> 
> +  return mPchLpSerialIoI2cDevId[I2cNumber];
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibInternal.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibInternal.h
> new file mode 100644
> index 0000000000..b5e8aba9ac
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibInternal.h
> @@ -0,0 +1,20 @@
> +/** @file
> 
> +  Header file for SerialIoPrivateLibInternal.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SERIAL_IO_PRIVATE_LIB_INTERNAL_H_
> 
> +#define _SERIAL_IO_PRIVATE_LIB_INTERNAL_H_
> 
> +
> 
> +typedef struct {
> 
> +  UINT32 Bar0;
> 
> +  UINT32 Bar1;
> 
> +} SERIAL_IO_CONTROLLER_DESCRIPTOR;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8  DevNum;
> 
> +  UINT8  FuncNum;
> 
> +} SERIAL_IO_BDF_NUMBERS;
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpi.c
> new file mode 100644
> index 0000000000..a926941baf
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpi.c
> @@ -0,0 +1,122 @@
> +/** @file
> 
> +  Common Serial IO Private Lib implementation - SPI part
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SerialIoRegs.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Checks if SPI is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in]      SpiNumber     Selects Serial IO SPI device
> 
> +
> 
> +  @retval   TRUE             SPI is in hidden mode
> 
> +  @retval   FALSE            SPI is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoSpiHidden (
> 
> +  IN UINT8               SpiNumber
> 
> +  )
> 
> +{
> 
> +  if (MmioRead16 (GetSerialIoSpiFixedPciCfgAddress (SpiNumber) +
> PCI_DEVICE_ID_OFFSET) == GetSerialIoSpiDeviceId (SpiNumber)) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] SpiNumber         SPI Number
> 
> +  @param[in] SpiDeviceConfig   SerialIo SPI Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSpiBootHandler (
> 
> +  IN UINT8                      SpiNumber,
> 
> +  IN SERIAL_IO_SPI_CONFIG       *SpiDeviceConfig
> 
> +  )
> 
> +{
> 
> +  UINT64   PciCfgBase;
> 
> +  BOOLEAN  TurnOff;
> 
> +
> 
> +  TurnOff = FALSE;
> 
> +
> 
> +  if (SpiDeviceConfig->Mode == SerialIoSpiPci) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  if ((SpiDeviceConfig->Mode == SerialIoSpiDisabled) &&
> (SerialIoSpiFuncNumber (SpiNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiNumber)))
> {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    PciCfgBase = GetSerialIoSpiPciCfg (SpiNumber);
> 
> +    SerialIoSetD3 (PciCfgBase);
> 
> +    SerialIoMmioDisable (PciCfgBase, TRUE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     SpiNumber         SPI Number
> 
> +  @param[in]     SpiDeviceConfig   SerialIo SPI Config
> 
> +  @param[in/out] S3PciCfgBase      S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command           Pci Command register data to save
> 
> +  @param[in/out] Pme               Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoSpiS3Handler (
> 
> +  IN     UINT8                 SpiNumber,
> 
> +  IN     SERIAL_IO_SPI_CONFIG  *SpiDeviceConfig,
> 
> +  IN OUT UINT64                *S3PciCfgBase,
> 
> +  IN OUT UINT32                *Command,
> 
> +  IN OUT UINT32                *Pme
> 
> +  )
> 
> +{
> 
> +  BOOLEAN  TurnOff;
> 
> +  UINT64   PciCfgBase;
> 
> +
> 
> +  *S3PciCfgBase = 0;
> 
> +  TurnOff       = FALSE;
> 
> +
> 
> +  if (SpiDeviceConfig->Mode == SerialIoSpiPci) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  if ((SpiDeviceConfig->Mode == SerialIoSpiDisabled) &&
> (SerialIoSpiFuncNumber (SpiNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoSpiDevNumber (SpiNumber)))
> {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    *S3PciCfgBase = GetSerialIoSpiS3PciBase (SpiNumber);
> 
> +    PciCfgBase    = GetSerialIoSpiPciCfg (SpiNumber);
> 
> +    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_PME_CTRL_STS);
> 
> +    *Pme          = *Pme | BIT0 | BIT1;
> 
> +    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase +
> PCI_COMMAND_OFFSET);
> 
> +    *Command      = *Command &
> (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE |
> EFI_PCI_COMMAND_BUS_MASTER);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c
> new file mode 100644
> index 0000000000..abda359202
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibSpiVer2.c
> @@ -0,0 +1,82 @@
> +/** @file
> 
> +  Serial IO Spi Private Lib implementation TigerLake specific.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Register/SerialIoRegsVer2.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoSpiDevId [] =
> {
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI0_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI1_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI2_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_SPI3_DEVICE_ID
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoSpiFixedAddress [] = {
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x10000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x11000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x12000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x13000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x14000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x15000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x16000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x17000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x18000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x19000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1A000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x1B000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1C000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x1D000}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Gets Fixed Base Address used for BAR0
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Config control offset
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoSpiFixedMmioAddress (
> 
> +  IN UINT8       SpiNumber
> 
> +  )
> 
> +{
> 
> +  return mSerialIoSpiFixedAddress[SpiNumber].Bar0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoSpiFixedPciCfgAddress (
> 
> +  IN UINT8       SpiNumber
> 
> +  )
> 
> +{
> 
> +  return mSerialIoSpiFixedAddress[SpiNumber].Bar1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets Spi Device Id
> 
> +
> 
> +  @param[in] SpiNumber               Serial IO device SPI number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoSpiDeviceId (
> 
> +  IN UINT8       SpiNumber
> 
> +  )
> 
> +{
> 
> +  return mPchLpSerialIoSpiDevId[SpiNumber];
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUart.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUart.c
> new file mode 100644
> index 0000000000..0f7d6513ce
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUart.c
> @@ -0,0 +1,136 @@
> +/** @file
> 
> +  Serial IO Private Lib implementation - UART part
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SerialIoRegs.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchLimits.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Checks if UART is Hidden, and it's Pci Config space available
> 
> +
> 
> +  @param[in]      UartNumber     Selects Serial IO UART device
> 
> +
> 
> +  @retval   TRUE             UART is in hidden mode
> 
> +  @retval   FALSE            UART is not in hidden mode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSerialIoUartHidden (
> 
> +  IN UINT8               UartNumber
> 
> +  )
> 
> +{
> 
> +  if (MmioRead16 (GetSerialIoUartFixedPciCfgAddress (UartNumber) +
> PCI_DEVICE_ID_OFFSET) == GetSerialIoUartDeviceId (UartNumber)) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configures Serial IO Controller before control is passd to the OS
> 
> +
> 
> +  @param[in] UartNumber         UART Number
> 
> +  @param[in] UartDeviceConfig   SerialIo UART Config
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoUartBootHandler (
> 
> +  IN UINT8                      UartNumber,
> 
> +  IN SERIAL_IO_UART_CONFIG      *UartDeviceConfig
> 
> +  )
> 
> +{
> 
> +  UINT64   PciCfgBase;
> 
> +  BOOLEAN  TurnOff;
> 
> +
> 
> +  TurnOff = FALSE;
> 
> +
> 
> +  //
> 
> +  // Even if Uart is Hidden and in D3 SerialIoUartLib is capable of setting D0
> during each write/read.
> 
> +  // In case it is required for Os Debug DBG2 must be set to TRUE.
> 
> +  //
> 
> +  if (UartDeviceConfig->Mode == SerialIoUartPci || UartDeviceConfig-
> >Mode == SerialIoUartHidden) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Uart in Com mode will be placed in D3 depending on PG configuration
> through ACPI _PS3
> 
> +  //
> 
> +
> 
> +  if ((UartDeviceConfig->Mode == SerialIoUartDisabled) &&
> (SerialIoUartFuncNumber (UartNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber
> (UartNumber))) {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (UartDeviceConfig->DBG2 == TRUE) {
> 
> +    TurnOff = FALSE;
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    PciCfgBase = GetSerialIoUartPciCfg (UartNumber);
> 
> +    SerialIoSetD3 (PciCfgBase);
> 
> +    if ((UartDeviceConfig->Mode == SerialIoUartPci) || (UartDeviceConfig-
> >Mode == SerialIoUartDisabled)) {
> 
> +      SerialIoMmioDisable (PciCfgBase, TRUE);
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets Pme Control Status and Command register values required for S3 Boot
> Script
> 
> +
> 
> +  @param[in]     UartNumber         UART Number
> 
> +  @param[in]     UartDeviceConfig   SerialIo UART Config
> 
> +  @param[in/out] S3PciCfgBase       S3 Boot Script Pci Config Base
> 
> +  @param[in/out] Command            Pci Command register data to save
> 
> +  @param[in/out] Pme                Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SerialIoUartS3Handler (
> 
> +  IN     UINT8                  UartNumber,
> 
> +  IN     SERIAL_IO_UART_CONFIG  *UartDeviceConfig,
> 
> +  IN OUT UINT64                 *S3PciCfgBase,
> 
> +  IN OUT UINT32                 *Command,
> 
> +  IN OUT UINT32                 *Pme
> 
> +  )
> 
> +{
> 
> +  BOOLEAN  TurnOff;
> 
> +  UINT64   PciCfgBase;
> 
> +
> 
> +  *S3PciCfgBase = 0;
> 
> +  TurnOff       = FALSE;
> 
> +
> 
> +  if (UartDeviceConfig->Mode == SerialIoUartPci) {
> 
> +    TurnOff = TRUE;
> 
> +  }
> 
> +
> 
> +  if ((UartDeviceConfig->Mode == SerialIoUartDisabled) &&
> (SerialIoUartFuncNumber (UartNumber) == 0x0)) {
> 
> +    if (SerialIoHigherFunctionsEnabled (SerialIoUartDevNumber
> (UartNumber))) {
> 
> +      TurnOff = TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (TurnOff) {
> 
> +    *S3PciCfgBase = GetSerialIoUartS3PciBase (UartNumber);
> 
> +    PciCfgBase    = GetSerialIoUartPciCfg (UartNumber);
> 
> +    *Pme          = PciSegmentRead32 ((UINTN) PciCfgBase +
> R_SERIAL_IO_CFG_PME_CTRL_STS);
> 
> +    *Pme          = *Pme | BIT0 | BIT1;
> 
> +    *Command      = PciSegmentRead32 ((UINTN) PciCfgBase +
> PCI_COMMAND_OFFSET);
> 
> +    *Command      = *Command &
> (UINT32)~(EFI_PCI_COMMAND_MEMORY_SPACE |
> EFI_PCI_COMMAND_BUS_MASTER);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c
> new file mode 100644
> index 0000000000..91280f8e90
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/SerialIo/LibraryPrivate/PeiDxeSm
> mSerialIoPrivateLib/SerialIoPrivateLibUartVer2.c
> @@ -0,0 +1,82 @@
> +/** @file
> 
> +  Serial IO Private Uart Lib implementation TigerLake specific.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Register/SerialIoRegsVer2.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <SerialIoPrivateLibInternal.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <PchLimits.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mPchLpSerialIoUartDevId []
> = {
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_UART0_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_UART1_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_UART2_DEVICE_ID,
> 
> +  V_VER2_PCH_LP_SERIAL_IO_CFG_UART3_DEVICE_ID
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> SERIAL_IO_CONTROLLER_DESCRIPTOR mSerialIoUartFixedAddress [] = {
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x1E000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x1F000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x20000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x21000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x22000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x23000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x24000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x25000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x26000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x27000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x28000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x29000},
> 
> +  {PCH_SERIAL_IO_BASE_ADDRESS + 0x2A000,
> PCH_SERIAL_IO_BASE_ADDRESS + 0x2B000}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Gets Fixed Base Address used for BAR0
> 
> +
> 
> +  @param[in] UartNumber              Serial IO device UART number
> 
> +
> 
> +  @retval                            Config control offset
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoUartFixedMmioAddress (
> 
> +  IN UINT8       UartNumber
> 
> +  )
> 
> +{
> 
> +  return mSerialIoUartFixedAddress[UartNumber].Bar0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets Fixed Address used for Pci Config Space manipulation
> 
> +
> 
> +  @param[in] UartNumber              Serial IO device UART number
> 
> +
> 
> +  @retval                            Pci Config Address
> 
> +**/
> 
> +UINT32
> 
> +GetSerialIoUartFixedPciCfgAddress (
> 
> +  IN UINT8       UartNumber
> 
> +  )
> 
> +{
> 
> +  return mSerialIoUartFixedAddress[UartNumber].Bar1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets Uarts Device Id
> 
> +
> 
> +  @param[in] UartNumbe               Serial IO device UART number
> 
> +
> 
> +  @retval                            Device Id
> 
> +**/
> 
> +UINT16
> 
> +GetSerialIoUartDeviceId (
> 
> +  IN UINT8       UartNumber
> 
> +  )
> 
> +{
> 
> +  return mPchLpSerialIoUartDevId[UartNumber];
> 
> +}
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component
  2021-02-01  1:36 ` [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Smbus/IncludePrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/Sm
> busRegs.h | 50
> ++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 50 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/S
> mbusRegs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/S
> mbusRegs.h
> new file mode 100644
> index 0000000000..c863615583
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Smbus/IncludePrivate/Register/S
> mbusRegs.h
> @@ -0,0 +1,50 @@
> +/** @file
> 
> +  Register names for PCH Smbus Device.
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_REGS_SMBUS_H_
> 
> +#define _PCH_REGS_SMBUS_H_
> 
> +
> 
> +//
> 
> +// SMBus Controller Registers
> 
> +//
> 
> +#define R_SMBUS_CFG_BASE                      0x20
> 
> +#define B_SMBUS_CFG_BASE_BAR                  0x0000FFE0
> 
> +
> 
> +//
> 
> +// SMBus I/O Registers
> 
> +//
> 
> +#define R_SMBUS_IO_HSTS                  0x00  ///< Host Status Register R/W
> 
> +#define B_SMBUS_IO_SMBALERT_STS          0x20
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component
  2021-02-01  1:36 ` [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Spi/IncludePrivate
>   * IpBlock/Spi/Library
>   * IpBlock/Spi/LibraryPrivate
>   * IpBlock/Spi/Smm
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAcces
> sPrivateLib.h                                 |   40 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCom
> monLib.h                                        |  364
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRegs
> .h                                            |  136
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib
> /PeiDxeSmmSpiAccessLib.inf                      |   33
> ++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccessLib
> /SpiAccessLib.c                                 |  477
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommon
> Lib/BaseSpiCommonLib.inf                         |   31
> +++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiCommon
> Lib/SpiCommon.c                                  | 1115
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAc
> cessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf |   40
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpiAc
> cessPrivateLib/SpiAccessPrivateLib.c            |  133
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
> |  296
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
> |   47 +++++++++++++++++++++++++++++++++++++
>  11 files changed, 2712 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAcc
> essPrivateLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAcc
> essPrivateLib.h
> new file mode 100644
> index 0000000000..6da88a9047
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiAcc
> essPrivateLib.h
> @@ -0,0 +1,40 @@
> +/** @file
> 
> +  SPI library header for abstraction of SPI HW registers accesses
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SPI_ACCESS_PRIVATE_LIB_H_
> 
> +#define _SPI_ACCESS_PRIVATE_LIB_H_
> 
> +
> 
> +/**
> 
> +  Disable EISS (Enable InSMM.STS)
> 
> +**/
> 
> +VOID
> 
> +SpiDisableEiss (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Configure BiosLockEnable bit and BiosInterfaceLock bit according to policy
> setting.
> 
> +
> 
> +  @param[in] BiosLockEnable     Policy for BiosLockEnable bit programming
> 
> +  @param[in] BiosInterfaceLock  Policy for BiosInterfaceLock bit
> programming
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SpiBiosLockEnableAndBiosInterfaceLockWithS3BootScript (
> 
> +  IN BOOLEAN  BiosLockEnable,
> 
> +  IN BOOLEAN  BiosInterfaceLock
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clears BIOS Write Protect Disable bit
> 
> +**/
> 
> +VOID
> 
> +SpiClearBiosWriteProtectDisable (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _SPI_ACCESS_PRIVATE_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCo
> mmonLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCo
> mmonLib.h
> new file mode 100644
> index 0000000000..3290f77122
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Library/SpiCo
> mmonLib.h
> @@ -0,0 +1,364 @@
> +/** @file
> 
> +  Header file for the PCH SPI Common Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SPI_COMMON_LIB_H_
> 
> +#define _SPI_COMMON_LIB_H_
> 
> +
> 
> +#include <Protocol/Spi.h>
> 
> +
> 
> +//
> 
> +// Maximum time allowed while waiting the SPI cycle to complete
> 
> +//  Wait Time = 6 seconds = 6000000 microseconds
> 
> +//  Wait Period = 10 microseconds
> 
> +//
> 
> +#define SPI_WAIT_TIME   6000000     ///< Wait Time = 6 seconds = 6000000
> microseconds
> 
> +#define SPI_WAIT_PERIOD 10          ///< Wait Period = 10 microseconds
> 
> +
> 
> +///
> 
> +/// Flash cycle Type
> 
> +///
> 
> +typedef enum {
> 
> +  FlashCycleRead,
> 
> +  FlashCycleWrite,
> 
> +  FlashCycleErase,
> 
> +  FlashCycleReadSfdp,
> 
> +  FlashCycleReadJedecId,
> 
> +  FlashCycleWriteStatus,
> 
> +  FlashCycleReadStatus,
> 
> +  FlashCycleMax
> 
> +} FLASH_CYCLE_TYPE;
> 
> +
> 
> +///
> 
> +/// Flash Component Number
> 
> +///
> 
> +typedef enum {
> 
> +  FlashComponent0,
> 
> +  FlashComponent1,
> 
> +  FlashComponentMax
> 
> +} FLASH_COMPONENT_NUM;
> 
> +
> 
> +///
> 
> +/// Private data structure definitions for the driver
> 
> +///
> 
> +#define PCH_SPI_PRIVATE_DATA_SIGNATURE  SIGNATURE_32 ('P', 'S', 'P',
> 'I')
> 
> +
> 
> +typedef struct {
> 
> +  UINT32                Signature;
> 
> +  EFI_HANDLE            Handle;
> 
> +  PCH_SPI_PROTOCOL      SpiProtocol;
> 
> +  UINT16                PchAcpiBase;
> 
> +  UINT64                PchSpiBase;
> 
> +  UINT8                 ReadPermission;
> 
> +  UINT8                 WritePermission;
> 
> +  UINT32                SfdpVscc0Value;
> 
> +  UINT32                SfdpVscc1Value;
> 
> +  UINT16                PchStrapBaseAddr;
> 
> +  UINT16                PchStrapSize;
> 
> +  UINT16                CpuStrapBaseAddr;
> 
> +  UINT16                CpuStrapSize;
> 
> +  UINT8                 NumberOfComponents;
> 
> +  UINT32                Component1StartAddr;
> 
> +  UINT32                TotalFlashSize;
> 
> +} SPI_INSTANCE;
> 
> +
> 
> +#define SPI_INSTANCE_FROM_SPIPROTOCOL(a)  CR (a, SPI_INSTANCE,
> SpiProtocol, PCH_SPI_PRIVATE_DATA_SIGNATURE)
> 
> +
> 
> +//
> 
> +// Function prototypes used by the SPI protocol.
> 
> +//
> 
> +
> 
> +/**
> 
> +  Initialize an SPI protocol instance.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval EFI_SUCCESS             The protocol instance was properly initialized
> 
> +  @exception EFI_UNSUPPORTED      The PCH is not supported by this
> module
> 
> +**/
> 
> +EFI_STATUS
> 
> +SpiProtocolConstructor (
> 
> +  IN     SPI_INSTANCE       *SpiInstance
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function is a hook for Spi to disable BIOS Write Protect
> 
> +
> 
> +  @retval EFI_SUCCESS             The protocol instance was properly initialized
> 
> +  @retval EFI_ACCESS_DENIED       The BIOS Region can only be updated in
> SMM phase
> 
> +
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +DisableBiosWriteProtect (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function is a hook for Spi to enable BIOS Write Protect
> 
> +
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +EnableBiosWriteProtect (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Acquire pch spi mmio address.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval PchSpiBar0              return SPI MMIO address
> 
> +**/
> 
> +UINTN
> 
> +AcquireSpiBar0 (
> 
> +  IN  SPI_INSTANCE                *SpiInstance
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Release pch spi mmio address.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +ReleaseSpiBar0 (
> 
> +  IN  SPI_INSTANCE                *SpiInstance
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if it's granted to do flash write.
> 
> +
> 
> +  @retval TRUE    It's secure to do flash write.
> 
> +  @retval FALSE   It's not secure to do flash write.
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSpiFlashWriteGranted (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[out] Buffer              The Pointer to caller-allocated buffer
> containing the dada received.
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashRead (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *Buffer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write data to the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[in] Buffer               Pointer to caller-allocated buffer containing the
> data sent during the SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashWrite (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *Buffer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Erase some area on the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashErase (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read SFDP data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] Address              The starting byte address for SFDP data read.
> 
> +  @param[in] ByteCount            Number of bytes in SFDP data portion of the
> SPI cycle
> 
> +  @param[out] SfdpData            The Pointer to caller-allocated buffer
> containing the SFDP data received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadSfdp (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *SfdpData
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read Jedec Id from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] ByteCount            Number of bytes in JedecId data portion of
> the SPI cycle, the data size is 3 typically
> 
> +  @param[out] JedecId             The Pointer to caller-allocated buffer
> containing JEDEC ID received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadJedecId (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *JedecId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write the status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[in] StatusValue          The Pointer to caller-allocated buffer
> containing the value of Status register writing
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashWriteStatus (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *StatusValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[out] StatusValue         The Pointer to caller-allocated buffer
> containing the value of Status register received.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadStatus (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *StatusValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get the SPI region base and size, based on the enum type
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for for the base
> address which is listed in the Descriptor.
> 
> +  @param[out] BaseAddress         The Flash Linear Address for the Region 'n'
> Base
> 
> +  @param[out] RegionSize          The size for the Region 'n'
> 
> +
> 
> +  @retval EFI_SUCCESS             Read success
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid region type given
> 
> +  @retval EFI_DEVICE_ERROR        The region is not used
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolGetRegionAddress (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  OUT    UINT32             *BaseAddress,
> 
> +  OUT    UINT32             *RegionSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read PCH Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing PCH Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolReadPchSoftStrap (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read CPU Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        CPU Soft Strap address offset from
> FCPUSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle.
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing CPU Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolReadCpuSoftStrap (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiRe
> gs.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiR
> egs.h
> new file mode 100644
> index 0000000000..8e2029500c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/IncludePrivate/Register/SpiR
> egs.h
> @@ -0,0 +1,136 @@
> +/** @file
> 
> +  Register names for PCH SPI device.
> 
> +
> 
> +  Conventions:
> 
> +
> 
> +  - Register definition format:
> 
> +
> Prefix_[GenerationName]_[ComponentName]_SubsystemName_RegisterS
> pace_RegisterName
> 
> +  - Prefix:
> 
> +    Definitions beginning with "R_" are registers
> 
> +    Definitions beginning with "B_" are bits within registers
> 
> +    Definitions beginning with "V_" are meaningful values within the bits
> 
> +    Definitions beginning with "S_" are register size
> 
> +    Definitions beginning with "N_" are the bit position
> 
> +  - [GenerationName]:
> 
> +    Three letter acronym of the generation is used (e.g. SKL,KBL,CNL etc.).
> 
> +    Register name without GenerationName applies to all generations.
> 
> +  - [ComponentName]:
> 
> +    This field indicates the component name that the register belongs to (e.g.
> PCH, SA etc.)
> 
> +    Register name without ComponentName applies to all components.
> 
> +    Register that is specific to -LP denoted by "_PCH_LP_" in component
> name.
> 
> +  - SubsystemName:
> 
> +    This field indicates the subsystem name of the component that the
> register belongs to
> 
> +    (e.g. PCIE, USB, SATA, GPIO, PMC etc.).
> 
> +  - RegisterSpace:
> 
> +    MEM - MMIO space register of subsystem.
> 
> +    IO  - IO space register of subsystem.
> 
> +    PCR - Private configuration register of subsystem.
> 
> +    CFG - PCI configuration space register of subsystem.
> 
> +  - RegisterName:
> 
> +    Full register name.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SPI_REGS_H_
> 
> +#define _SPI_REGS_H_
> 
> +
> 
> +//
> 
> +// SPI Registers
> 
> +//
> 
> +#define R_SPI_CFG_BAR0                      0x10
> 
> +#define B_SPI_CFG_BAR0_MASK                 0x0FFF
> 
> +
> 
> +#define R_SPI_CFG_BDE                       0xD8
> 
> +
> 
> +#define R_SPI_CFG_BC                        0xDC
> 
> +#define S_SPI_CFG_BC                        4
> 
> +#define N_SPI_CFG_BC_ASE_BWP                11
> 
> +#define B_SPI_CFG_BC_ASE_BWP                BIT11
> 
> +#define N_SPI_CFG_BC_ASYNC_SS               10
> 
> +#define B_SPI_CFG_BC_ASYNC_SS               BIT10
> 
> +#define N_SPI_CFG_BC_SYNC_SS                8
> 
> +#define B_SPI_CFG_BC_SYNC_SS                BIT8
> 
> +#define B_SPI_CFG_BC_BILD                   BIT7
> 
> +#define B_SPI_CFG_BC_BBS                    BIT6            ///< Boot BIOS strap
> 
> +#define N_SPI_CFG_BC_BBS                    6
> 
> +#define V_SPI_CFG_BC_BBS_SPI                0               ///< Boot BIOS strapped
> to SPI
> 
> +#define B_SPI_CFG_BC_EISS                   BIT5            ///< Enable InSMM.STS
> 
> +#define B_SPI_CFG_BC_TSS                    BIT4
> 
> +#define B_SPI_CFG_BC_SRC                    (BIT3 | BIT2)
> 
> +#define N_SPI_CFG_BC_SRC                    2
> 
> +#define V_SPI_CFG_BC_SRC_PREF_DIS_CACHE_DIS 0x01            ///< No
> prefetching and no caching
> 
> +#define B_SPI_CFG_BC_LE                     BIT1            ///< Lock Enable
> 
> +#define N_SPI_CFG_BC_BLE                    1
> 
> +#define B_SPI_CFG_BC_WPD                    BIT0            ///< Write Protect Disable
> 
> +
> 
> +//
> 
> +// BIOS Flash Program Registers (based on SPI_BAR0)
> 
> +//
> 
> +#define R_SPI_MEM_HSFSC                     0x04                          ///< Hardware
> Sequencing Flash Status and Control Register(32bits)
> 
> +#define B_SPI_MEM_HSFSC_FDBC_MASK           0x3F000000                    ///<
> Flash Data Byte Count ( <= 64), Count = (Value in this field) + 1.
> 
> +#define N_SPI_MEM_HSFSC_FDBC                24
> 
> +#define B_SPI_MEM_HSFSC_CYCLE_MASK          0x001E0000                    ///<
> Flash Cycle.
> 
> +#define N_SPI_MEM_HSFSC_CYCLE               17
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_READ          0                             ///< Flash
> Cycle Read
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_WRITE         2                             ///< Flash
> Cycle Write
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_4K_ERASE      3                             ///< Flash
> Cycle 4K Block Erase
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_64K_ERASE     4                             ///<
> Flash Cycle 64K Sector Erase
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_READ_SFDP     5                             ///<
> Flash Cycle Read SFDP
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_READ_JEDEC_ID 6                             ///<
> Flash Cycle Read JEDEC ID
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_WRITE_STATUS  7                             ///<
> Flash Cycle Write Status
> 
> +#define V_SPI_MEM_HSFSC_CYCLE_READ_STATUS   8                             ///<
> Flash Cycle Read Status
> 
> +#define B_SPI_MEM_HSFSC_CYCLE_FGO           BIT16                         ///< Flash
> Cycle Go.
> 
> +#define B_SPI_MEM_HSFSC_FLOCKDN             BIT15                         ///< Flash
> Configuration Lock-Down
> 
> +#define B_SPI_MEM_HSFSC_FDV                 BIT14                         ///< Flash
> Descriptor Valid, once valid software can use hareware sequencing regs
> 
> +#define B_SPI_MEM_HSFSC_FDOPSS              BIT13                         ///< Flash
> Descriptor Override Pin-Strap Status
> 
> +#define B_SPI_MEM_HSFSC_WRSDIS              BIT11                         ///< Write
> Status Disable
> 
> +#define B_SPI_MEM_HSFSC_SAF_MODE_ACTIVE     BIT7                          ///<
> Indicates flash is attached either directly to the PCH via the SPI bus or
> EC/BMC
> 
> +#define B_SPI_MEM_HSFSC_SCIP                BIT5                          ///< SPI cycle in
> progress
> 
> +#define B_SPI_MEM_HSFSC_SAF_DLE             BIT4                          ///< SAF Data
> length error
> 
> +#define B_SPI_MEM_HSFSC_SAF_ERROR           BIT3                          ///< SAF
> Error
> 
> +#define B_SPI_MEM_HSFSC_AEL                 BIT2                          ///< Access Error
> Log
> 
> +#define B_SPI_MEM_HSFSC_FCERR               BIT1                          ///< Flash
> Cycle Error
> 
> +#define B_SPI_MEM_HSFSC_FDONE               BIT0                          ///< Flash
> Cycle Done
> 
> +#define R_SPI_MEM_FADDR                     0x08                          ///< SPI Flash
> Address
> 
> +#define B_SPI_MEM_FADDR_MASK                0x07FFFFFF                    ///< SPI
> Flash Address Mask (0~26bit)
> 
> +#define R_SPI_MEM_DLOCK                     0x0C                          ///< Discrete Lock
> Bits
> 
> +#define B_SPI_MEM_DLOCK_PR0LOCKDN           BIT8                          ///<
> PR0LOCKDN
> 
> +#define R_SPI_MEM_FDATA00                   0x10                          ///< SPI Data 00
> (32 bits)
> 
> +#define R_SPI_MEM_FRAP                      0x50                          ///< Flash Region
> Access Permissions Register
> 
> +#define B_SPI_MEM_FRAP_BRWA_MASK            0x0000FF00                    ///<
> BIOS Region Write Access MASK, Region0~7 - 0: Flash Descriptor; 1: BIOS; 2:
> ME; 3: GbE; 4: PlatformData
> 
> +#define N_SPI_MEM_FRAP_BRWA                 8                             ///< BIOS
> Region Write Access bit position
> 
> +#define B_SPI_MEM_FRAP_BRRA_MASK            0x000000FF                    ///<
> BIOS Region Read Access MASK, Region0~7 - 0: Flash Descriptor; 1: BIOS; 2:
> ME; 3: GbE; 4: PlatformData
> 
> +#define B_SPI_MEM_FRAP_BMRAG_MASK           0x00FF0000                    ///<
> BIOS Master Read Access Grant
> 
> +#define B_SPI_MEM_FRAP_BMWAG_MASK           0xFF000000                    ///<
> BIOS Master Write Access Grant
> 
> +#define R_SPI_MEM_FREG0_FLASHD              0x54                          ///< Flash
> Region 0(Flash Descriptor)(32bits)
> 
> +#define R_SPI_MEM_FREG3_GBE                 0x60                          ///< Flash
> Region 3(GbE)(32bits)
> 
> +#define S_SPI_MEM_FREGX                     4                             ///< Size of Flash
> Region register
> 
> +#define B_SPI_MEM_FREGX_LIMIT_MASK          0x7FFF0000                    ///<
> Flash Region Limit [30:16] represents [26:12], [11:0] are assumed to be FFFh
> 
> +#define N_SPI_MEM_FREGX_LIMIT               16                            ///< Region limit
> bit position
> 
> +#define N_SPI_MEM_FREGX_LIMIT_REPR          12                            ///< Region
> limit bit represents position
> 
> +#define B_SPI_MEM_FREGX_BASE_MASK           0x00007FFF                    ///<
> Flash Region Base, [14:0] represents [26:12]
> 
> +#define N_SPI_MEM_FREGX_BASE                0                             ///< Region base
> bit position
> 
> +#define N_SPI_MEM_FREGX_BASE_REPR           12                            ///< Region
> base bit represents position
> 
> +#define R_SPI_MEM_PR0                       0x84                          ///< Protected
> Region 0 Register
> 
> +#define S_SPI_MEM_PRX                       4                             ///< Protected Region
> X Register size
> 
> +#define B_SPI_MEM_PRX_WPE                   BIT31                         ///< Write
> Protection Enable
> 
> +#define B_SPI_MEM_PRX_PRL_MASK              0x7FFF0000                    ///<
> Protected Range Limit Mask, [30:16] here represents upper limit of address
> [26:12]
> 
> +#define N_SPI_MEM_PRX_PRL                   16                            ///< Protected
> Range Limit bit position
> 
> +#define B_SPI_MEM_PRX_RPE                   BIT15                         ///< Read
> Protection Enable
> 
> +#define B_SPI_MEM_PRX_PRB_MASK              0x00007FFF                    ///<
> Protected Range Base Mask, [14:0] here represents base limit of address
> [26:12]
> 
> +#define N_SPI_MEM_PRX_PRB                   0                             ///< Protected
> Range Base bit position
> 
> +#define R_SPI_MEM_FDOC                      0xB4                          ///< Flash
> Descriptor Observability Control Register(32 bits)
> 
> +#define B_SPI_MEM_FDOC_FDSS_MASK            (BIT14 | BIT13 | BIT12)
> ///< Flash Descritor Section Select
> 
> +#define V_SPI_MEM_FDOC_FDSS_FSDM            0x0000                        ///< Flash
> Signature and Descriptor Map
> 
> +#define V_SPI_MEM_FDOC_FDSS_COMP            0x1000                        ///<
> Component
> 
> +#define V_SPI_MEM_FDOC_FDSS_MSTR            0x3000                        ///<
> Master
> 
> +#define B_SPI_MEM_FDOC_FDSI_MASK            0x0FFC                        ///< Flash
> Descriptor Section Index
> 
> +#define R_SPI_MEM_FDOD                      0xB8                          ///< Flash
> Descriptor Observability Data Register(32 bits)
> 
> +#define R_SPI_MEM_SFDP0_VSCC0               0xC4                          ///< Vendor
> Specific Component Capabilities Register(32 bits)
> 
> +#define B_SPI_MEM_SFDPX_VSCCX_CPPTV         BIT31                         ///<
> Component Property Parameter Table Valid
> 
> +#define B_SPI_MEM_SFDP0_VSCC0_VCL           BIT30                         ///<
> Vendor Component Lock
> 
> +#define B_SPI_MEM_SFDPX_VSCCX_EO_64K        BIT29                         ///< 64k
> Erase valid (EO_64k_valid)
> 
> +#define R_SPI_MEM_SFDP1_VSCC1               0xC8                          ///< Vendor
> Specific Component Capabilities Register(32 bits)
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/PeiDxeSmmSpiAccessLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/PeiDxeSmmSpiAccessLib.inf
> new file mode 100644
> index 0000000000..bba0b1fef3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/PeiDxeSmmSpiAccessLib.inf
> @@ -0,0 +1,33 @@
> +## @file
> 
> +# Component description file for PCH SPI access library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION     = 0x00010017
> 
> +BASE_NAME       = PeiDxeSmmSpiAccessLib
> 
> +FILE_GUID       = A6D4C05A-F6CB-46D5-4BA1-8C47B139DCA6
> 
> +VERSION_STRING  = 1.0
> 
> +MODULE_TYPE     = BASE
> 
> +LIBRARY_CLASS   = SpiAccessLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchPciBdfLib
> 
> +PchPcrLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SpiAccessLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/SpiAccessLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/SpiAccessLib.c
> new file mode 100644
> index 0000000000..c91b9aaf4d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Library/PeiDxeSmmSpiAccess
> Lib/SpiAccessLib.c
> @@ -0,0 +1,477 @@
> +/** @file
> 
> +  SPI library for abstraction of SPI HW registers accesses
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <IndustryStandard/Pci22.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/SpiAccessLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/FlashRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchDmiRegs.h>
> 
> +
> 
> +/**
> 
> +  Checks if PCH SPI Controler is present and available
> 
> +
> 
> +  @retval TRUE    PCH SPI controller is avaialable
> 
> +  @retval FALSE   PCH SPI controller is not available
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsControllerAvailable (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Checks for SPI controller
> 
> +  //
> 
> +  return (PciSegmentRead16 (SpiPciCfgBase () + PCI_VENDOR_ID_OFFSET)
> != 0xFFFF);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns PCH SPI BAR0 value
> 
> +
> 
> +  @retval  UINT32  PCH SPI BAR0 value
> 
> +**/
> 
> +UINT32
> 
> +SpiGetBar0 (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SpiBar0;
> 
> +
> 
> +  ASSERT (SpiIsControllerAvailable ());
> 
> +  SpiBar0 = PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BAR0) &
> ~B_SPI_CFG_BAR0_MASK;
> 
> +  ASSERT (SpiBar0 != 0);
> 
> +
> 
> +  return SpiBar0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads given descriptor section and returns value
> 
> +
> 
> +  @param[in] UINT16   Descriptor section
> 
> +  @param[in] UINT16   Offset
> 
> +
> 
> +  @retval UINT32      Read value from a section under given offset
> 
> +**/
> 
> +STATIC
> 
> +UINT32
> 
> +SpiReadDescriptor (
> 
> +  IN  UINT16  DescriptorSection,
> 
> +  IN  UINT16  Offset
> 
> +  )
> 
> +{
> 
> +  UINT32  SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  MmioWrite32 (SpiBar0 + R_SPI_MEM_FDOC, (DescriptorSection | Offset));
> 
> +  return MmioRead32 (SpiBar0 + R_SPI_MEM_FDOD);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns descriptor signature
> 
> +
> 
> +  @retval UINT32    Descriptor signature
> 
> +**/
> 
> +UINT32
> 
> +SpiGetDescriptorSignature (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Read Descriptor offset 0x10 - To get Descriptor Signature
> 
> +  // Signature section 0x0000 + offset 0x0 which points to Descriptor offset
> 0x10
> 
> +  //
> 
> +  return SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM, 0x0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns supported features and R/W frequencies of Flash Component
> 
> +
> 
> +  @retval UINT32    Flash Component features descriptor
> 
> +**/
> 
> +UINT32
> 
> +SpiGetFlashComponentDescription (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Read Descriptor offset 0x30 - To get supported features and R/W
> frequencies
> 
> +  // Component section 0x1000 + offset 0x0 which points to Descriptor
> offset 0x30
> 
> +  //
> 
> +  return SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_COMP, 0x0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns number of Flash Components
> 
> +
> 
> +  @retval UINT32    Flash components number
> 
> +**/
> 
> +UINT32
> 
> +SpiGetFlashComponentsNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Read Descriptor offset 0x14 - To get number of components
> 
> +  // Signature section 0x0000 + offset 0x4 which points to Descriptor offset
> 0x14
> 
> +  //
> 
> +  return ((SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM,
> R_FLASH_FDBAR_FLASH_MAP0) & B_FLASH_FDBAR_NC) >>
> N_FLASH_FDBAR_NC);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns total Flash size with regards to number of flash components
> 
> +
> 
> +  @retval UINT32    Total Flash Memory size
> 
> +**/
> 
> +UINT32
> 
> +SpiGetTotalFlashSize (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  Data32;
> 
> +  UINT32  ComponentsNumber;
> 
> +  UINT32  TotalFlashSize;
> 
> +
> 
> +  Data32 = SpiGetFlashComponentDescription ();
> 
> +  ComponentsNumber = SpiGetFlashComponentsNumber ();
> 
> +
> 
> +  TotalFlashSize = (V_FLASH_FLCOMP_COMP_512KB << ((UINT8) (Data32 &
> B_FLASH_FLCOMP_COMP0_MASK)));
> 
> +  if (ComponentsNumber == 1) {
> 
> +    TotalFlashSize += (V_FLASH_FLCOMP_COMP_512KB << ((UINT8) ((Data32
> & B_FLASH_FLCOMP_COMP1_MASK) >> 4)));
> 
> +  }
> 
> +
> 
> +  return TotalFlashSize;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks BIOS lock bits for proper value and checks if write protection is
> enabled
> 
> +  Expected vales are: LE bit set, EISS bit set and WPD bit cleared
> 
> +
> 
> +  @retval  TRUE    All protection bits are set correctly
> 
> +  @retval  FALSE   Not all protection bits had exepcted values
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsWriteProtectionEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  BiosControl;
> 
> +  BiosControl = PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL LE: %x\n", (BiosControl &
> B_SPI_CFG_BC_LE) != 0 ));
> 
> +  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL WPD: %x\n", (BiosControl &
> B_SPI_CFG_BC_WPD) != 0 ));
> 
> +  DEBUG ((DEBUG_INFO, "SPI BIOS CONTROL EISS: %x\n", (BiosControl &
> B_SPI_CFG_BC_EISS) != 0 ));
> 
> +
> 
> +  return (((BiosControl & B_SPI_CFG_BC_LE) != 0) &&
> 
> +          ((BiosControl & B_SPI_CFG_BC_WPD) == 0) &&
> 
> +          ((BiosControl & B_SPI_CFG_BC_EISS) != 0));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns status of BIOS Interface Lockdown
> 
> +
> 
> +  @retval TRUE  BIOS Interface Lockdown is enabled
> 
> +  @retval FALSE BIOS Interface Lockdown is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsBiosInterfaceLockdownEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_BILD);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Flash Descriptor Override Pin Strap status
> 
> +
> 
> +  @retval TRUE     Flash Descriptor override is enabled
> 
> +  @retval FALSE    Flash Descriptor override is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashDescriptorOverrideEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  return !!(MmioRead16 (SpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_FDOPSS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Flash Configuration Lock Down bit status
> 
> +
> 
> +  @retval TRUE    Flash Configuration Lock Down bit is set
> 
> +  @retval FALSE   Flash Configuration Lock Down bit is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashConfigurationLockDownEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  return !!(MmioRead16 (SpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_FLOCKDN);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Top Swap functionality enable state
> 
> +
> 
> +  @retval TRUE    Top Swap is enabled
> 
> +  @retval FALSE   Top Swap is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsTopSwapEnabled (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(PciSegmentRead32 (SpiPciCfgBase () + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_TSS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return Component Property Parameter Table for a given component
> number
> 
> +
> 
> +  @param[in]  ComponentNumber   SPI Component number
> 
> +  @param[out] CppTable          Component Poperty Parameter Table value
> 
> +
> 
> +  @retval TRUE  Vendor Specific Component Capabilities Register value was
> read
> 
> +  @reval  FALSE Vendor Specific Component Capabilities Register value was
> not present
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiGetComponentPropertyParameterTable (
> 
> +  IN  UINT8  ComponentNumber,
> 
> +  OUT UINT32 *CppTable
> 
> +  )
> 
> +{
> 
> +  UINT32 SpiBar0;
> 
> +  UINT32 Data32;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  //
> 
> +  // More than 2 components not supported
> 
> +  //
> 
> +  switch (ComponentNumber) {
> 
> +    case 0:
> 
> +      *CppTable = MmioRead32 (SpiBar0 + R_SPI_MEM_SFDP0_VSCC0);
> 
> +      return TRUE;
> 
> +    case 1:
> 
> +      Data32    = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_FSDM,
> R_FLASH_FDBAR_FLASH_MAP0);
> 
> +      *CppTable = MmioRead32 (SpiBar0 + R_SPI_MEM_SFDP1_VSCC1);
> 
> +      return !!(Data32 & BIT8);
> 
> +    default:
> 
> +      return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns valid bit status in given Component Property Parameter Table
> 
> +
> 
> +  @param[in] CppTable          Component Poperty Parameter Table value
> 
> +
> 
> +  @retval TRUE    Valid bit is set
> 
> +  @reval  FALSE   Valid bit is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsCppValidBitSet (
> 
> +  IN UINT32  CppTable
> 
> +  )
> 
> +{
> 
> +  return !!(CppTable & B_SPI_MEM_SFDPX_VSCCX_CPPTV);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Flash Descriptor is valid
> 
> +
> 
> +  @retval TRUE  Flash Descriptor is valid
> 
> +  @retval FALSE Flash Descriptor is invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsFlashDescriptorValid (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  return !!(MmioRead32 (SpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_FDV);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads and returns value from Flash Region Access Permissions Register
> (FRAP)
> 
> +
> 
> +  @retval UINT32  Flash Region Access Permissions Register value
> 
> +**/
> 
> +STATIC
> 
> +UINT32
> 
> +SpiGetFlashRegionAccessPermissions (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return MmioRead32 (SpiGetBar0 () + R_SPI_MEM_FRAP);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns masked BIOS Master Read Access
> 
> +
> 
> +  @retval UINT32    Already masked BIOS Master Read Access
> 
> +**/
> 
> +UINT32
> 
> +SpiGetMasterReadAccess (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +  Data32 = SpiGetFlashRegionAccessPermissions () &
> B_SPI_MEM_FRAP_BMRAG_MASK;
> 
> +  DEBUG ((DEBUG_INFO, "BMRAG 0x%x\n", Data32));
> 
> +
> 
> +  return Data32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns masked BIOS Master Write Access
> 
> +
> 
> +  @retval UINT32    Already masked BIOS Master Write Access
> 
> +**/
> 
> +UINT32
> 
> +SpiGetMasterWriteAccess (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +  Data32 = SpiGetFlashRegionAccessPermissions () &
> B_SPI_MEM_FRAP_BMWAG_MASK;
> 
> +  DEBUG ((DEBUG_INFO, "BMWAG 0x%x\n", Data32));
> 
> +
> 
> +  return Data32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns GbE Region Access rights
> 
> +
> 
> +  @retval UINT32    GbE Region access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetGbeRegionAccess (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +
> 
> +  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x8);
> 
> +  DEBUG ((DEBUG_INFO, "GbE Region Access 0x%x\n", Data32));
> 
> +
> 
> +  return Data32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns CSME region access rights
> 
> +
> 
> +  @retval UINT32    CSME Region Access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetCsmeRegionAccess (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +
> 
> +  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x4);
> 
> +  DEBUG ((DEBUG_INFO, "CSME Region Access 0x%x\n", Data32));
> 
> +
> 
> +  return Data32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns EC region access right
> 
> +
> 
> +  @retval UINT32     EC Region access rights
> 
> +**/
> 
> +UINT32
> 
> +SpiGetEcRegionAccess (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 Data32;
> 
> +
> 
> +  Data32 = SpiReadDescriptor (V_SPI_MEM_FDOC_FDSS_MSTR, 0x10);
> 
> +  DEBUG ((DEBUG_INFO, "EC Region Access 0x%x\n", Data32));
> 
> +
> 
> +  return Data32;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if Slave Attached Flash (SAF) mode is active
> 
> +
> 
> +  @retval TRUE    SAF mode is active
> 
> +  @retval FALSE   SAF mode is not active
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsSafModeActive (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  return !!(MmioRead32 (SpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_SAF_MODE_ACTIVE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks validity of GbE region
> 
> +
> 
> +  @retval TRUE    GbE region is valid
> 
> +  @retval FALSE   GbE regios in invalid
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsGbeRegionValid (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SpiBar0;
> 
> +  SpiBar0 = SpiGetBar0 ();
> 
> +
> 
> +  if (MmioRead32 (SpiBar0 + R_SPI_MEM_FREG3_GBE) !=
> B_SPI_MEM_FREGX_BASE_MASK) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns TRUE if BIOS Boot Strap is set to SPI
> 
> +
> 
> +  @retval TRUE    BIOS Boot strap is set to SPI
> 
> +  @retval FALSE   BIOS Boot strap is set to LPC/eSPI
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsBiosBootFromSpi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(((PciSegmentRead8 (SpiPciCfgBase () + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_BBS) >> N_SPI_CFG_BC_BBS) == V_SPI_CFG_BC_BBS_SPI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check SPI write status disable is set
> 
> +
> 
> +  @retval TRUE    Write status disable is set
> 
> +  @retval FALSE   Write status disable is not set
> 
> +**/
> 
> +BOOLEAN
> 
> +SpiIsWriteStatusDisable (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return !!(MmioRead32 (SpiGetBar0 () + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_WRSDIS);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/BaseSpiCommonLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/BaseSpiCommonLib.inf
> new file mode 100644
> index 0000000000..a1a5467745
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/BaseSpiCommonLib.inf
> @@ -0,0 +1,31 @@
> +## @file
> 
> +#  Component description file for the PchSpiCommonLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION                    = 0x00010005
> 
> +  BASE_NAME                      = BaseSpiCommonLib
> 
> +  FILE_GUID                      = A37CB67E-7D85-45B3-B07E-BF65BDB603E8
> 
> +  MODULE_TYPE                    = BASE
> 
> +  VERSION_STRING                 = 1.0
> 
> +  LIBRARY_CLASS                  = SpiCommonLib
> 
> +
> 
> +[Sources]
> 
> +  SpiCommon.c
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[LibraryClasses]
> 
> +  IoLib
> 
> +  DebugLib
> 
> +  PmcLib
> 
> +  PchPciBdfLib
> 
> +  SpiAccessLib
> 
> +
> 
> +[Pcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/SpiCommon.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/SpiCommon.c
> new file mode 100644
> index 0000000000..954b349e7c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/BaseSpiComm
> onLib/SpiCommon.c
> @@ -0,0 +1,1115 @@
> +/** @file
> 
> +  PCH SPI Common Driver implements the SPI Host Controller Compatibility
> Interface.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Protocol/Spi.h>
> 
> +#include <Library/SpiCommonLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/FlashRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/SpiAccessLib.h>
> 
> +
> 
> +/**
> 
> +  Initialize an SPI protocol instance.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval EFI_SUCCESS             The protocol instance was properly initialized
> 
> +  @exception EFI_UNSUPPORTED      The PCH is not supported by this
> module
> 
> +**/
> 
> +EFI_STATUS
> 
> +SpiProtocolConstructor (
> 
> +  IN     SPI_INSTANCE       *SpiInstance
> 
> +  )
> 
> +{
> 
> +  UINTN           PchSpiBar0;
> 
> +  UINT32          Data32;
> 
> +  UINT16          Mdtba;
> 
> +  EFI_STATUS      Status;
> 
> +
> 
> +  //
> 
> +  // Initialize the SPI protocol instance
> 
> +  //
> 
> +  SpiInstance->Signature                    = PCH_SPI_PRIVATE_DATA_SIGNATURE;
> 
> +  SpiInstance->Handle                       = NULL;
> 
> +  SpiInstance->SpiProtocol.Revision         = PCH_SPI_SERVICES_REVISION;
> 
> +  SpiInstance->SpiProtocol.FlashRead        = SpiProtocolFlashRead;
> 
> +  SpiInstance->SpiProtocol.FlashWrite       = SpiProtocolFlashWrite;
> 
> +  SpiInstance->SpiProtocol.FlashErase       = SpiProtocolFlashErase;
> 
> +  SpiInstance->SpiProtocol.FlashReadSfdp    = SpiProtocolFlashReadSfdp;
> 
> +  SpiInstance->SpiProtocol.FlashReadJedecId =
> SpiProtocolFlashReadJedecId;
> 
> +  SpiInstance->SpiProtocol.FlashWriteStatus = SpiProtocolFlashWriteStatus;
> 
> +  SpiInstance->SpiProtocol.FlashReadStatus  = SpiProtocolFlashReadStatus;
> 
> +  SpiInstance->SpiProtocol.GetRegionAddress =
> SpiProtocolGetRegionAddress;
> 
> +  SpiInstance->SpiProtocol.ReadPchSoftStrap =
> SpiProtocolReadPchSoftStrap;
> 
> +  SpiInstance->SpiProtocol.ReadCpuSoftStrap =
> SpiProtocolReadCpuSoftStrap;
> 
> +
> 
> +  SpiInstance->PchSpiBase = SpiPciCfgBase ();
> 
> +
> 
> +  SpiInstance->PchAcpiBase = PmcGetAcpiBase ();
> 
> +  ASSERT (SpiInstance->PchAcpiBase != 0);
> 
> +
> 
> +  PchSpiBar0 = PciSegmentRead32 (SpiInstance->PchSpiBase +
> R_SPI_CFG_BAR0) & ~(B_SPI_CFG_BAR0_MASK);
> 
> +  if (PchSpiBar0 == 0) {
> 
> +    DEBUG ((DEBUG_ERROR, "ERROR : PchSpiBar0 is invalid!\n"));
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +
> 
> +  if ((MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_FDV) == 0) {
> 
> +    DEBUG ((DEBUG_ERROR, "ERROR : SPI Flash Signature invalid, cannot use
> the Hardware Sequencing registers!\n"));
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Get Region 0 - 7 read Permission bits, region 8 and above are not
> permitted.
> 
> +  //
> 
> +  SpiInstance->ReadPermission = MmioRead8 (PchSpiBar0 +
> R_SPI_MEM_FRAP) & B_SPI_MEM_FRAP_BRRA_MASK;
> 
> +  DEBUG ((DEBUG_INFO, "Flash Region read Permission : %0x\n",
> SpiInstance->ReadPermission));
> 
> +  //
> 
> +  // Get Region 0 - 7 write Permission bits, region 8 and above are not
> permitted.
> 
> +  //
> 
> +  SpiInstance->WritePermission = (UINT8) ((MmioRead16 (PchSpiBar0 +
> R_SPI_MEM_FRAP) &
> 
> +                                           B_SPI_MEM_FRAP_BRWA_MASK) >>
> N_SPI_MEM_FRAP_BRWA);
> 
> +  DEBUG ((DEBUG_INFO, "Flash Region write Permission : %0x\n",
> SpiInstance->WritePermission));
> 
> +
> 
> +  SpiInstance->SfdpVscc0Value = MmioRead32 (PchSpiBar0 +
> R_SPI_MEM_SFDP0_VSCC0);
> 
> +  DEBUG ((DEBUG_INFO, "Component 0 SFDP VSCC value : %0x\n",
> SpiInstance->SfdpVscc0Value));
> 
> +  SpiInstance->SfdpVscc1Value = MmioRead32 (PchSpiBar0 +
> R_SPI_MEM_SFDP1_VSCC1);
> 
> +  DEBUG ((DEBUG_INFO, "Component 1 SFDP VSCC value : %0x\n",
> SpiInstance->SfdpVscc1Value));
> 
> +
> 
> +  //
> 
> +  // Select to Flash Map 0 Register to get the number of flash Component
> 
> +  //
> 
> +  MmioAndThenOr32 (
> 
> +    PchSpiBar0 + R_SPI_MEM_FDOC,
> 
> +    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK |
> B_SPI_MEM_FDOC_FDSI_MASK)),
> 
> +    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM |
> R_FLASH_FDBAR_FLASH_MAP0)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Copy Zero based Number Of Components
> 
> +  //
> 
> +  SpiInstance->NumberOfComponents = (UINT8) ((MmioRead16
> (PchSpiBar0 + R_SPI_MEM_FDOD) & B_FLASH_FDBAR_NC) >>
> N_FLASH_FDBAR_NC);
> 
> +  DEBUG ((DEBUG_INFO, "Component Number : %0x\n", SpiInstance-
> >NumberOfComponents + 1));
> 
> +
> 
> +  MmioAndThenOr32 (
> 
> +    PchSpiBar0 + R_SPI_MEM_FDOC,
> 
> +    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK |
> B_SPI_MEM_FDOC_FDSI_MASK)),
> 
> +    (UINT32) (V_SPI_MEM_FDOC_FDSS_COMP | R_FLASH_FCBA_FLCOMP)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Copy Component 0 Density
> 
> +  //
> 
> +  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
> 
> +  if (SpiInstance->NumberOfComponents > 0) {
> 
> +    SpiInstance->Component1StartAddr = V_FLASH_FLCOMP_COMP_512KB
> <<
> 
> +      (Data32 & B_FLASH_FLCOMP_COMP0_MASK);
> 
> +    DEBUG ((DEBUG_INFO, "Component 1 StartAddr : %0x\n", SpiInstance-
> >Component1StartAddr));
> 
> +    SpiInstance->TotalFlashSize = SpiInstance->Component1StartAddr +
> 
> +      (V_FLASH_FLCOMP_COMP_512KB <<
> 
> +      ((Data32 & B_FLASH_FLCOMP_COMP1_MASK) >>
> 
> +      N_FLASH_FLCOMP_COMP1));
> 
> +  } else {
> 
> +    SpiInstance->TotalFlashSize = V_FLASH_FLCOMP_COMP_512KB <<
> 
> +      (Data32 & B_FLASH_FLCOMP_COMP0_MASK);
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "Total Flash Size : %0x\n", SpiInstance-
> >TotalFlashSize));
> 
> +
> 
> +  //
> 
> +  // Select FLASH_MAP1 to get Flash PCH Strap Base Address
> 
> +  //
> 
> +  MmioAndThenOr32 (
> 
> +    (PchSpiBar0 + R_SPI_MEM_FDOC),
> 
> +    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK |
> B_SPI_MEM_FDOC_FDSI_MASK)),
> 
> +    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM |
> R_FLASH_FDBAR_FLASH_MAP1)
> 
> +    );
> 
> +  //
> 
> +  // Align FPSBA with address bits for the PCH Strap portion of flash
> descriptor
> 
> +  //
> 
> +  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
> 
> +  SpiInstance->PchStrapBaseAddr = (UINT16) (((Data32 &
> B_FLASH_FDBAR_FPSBA)
> 
> +                                             >> N_FLASH_FDBAR_FPSBA)
> 
> +                                            << N_FLASH_FDBAR_FPSBA_REPR);
> 
> +  DEBUG ((DEBUG_INFO, "PchStrapBaseAddr : %0x\n", SpiInstance-
> >PchStrapBaseAddr));
> 
> +  ASSERT (SpiInstance->PchStrapBaseAddr != 0);
> 
> +  //
> 
> +  // PCH Strap Length, [31:24] represents number of Dwords
> 
> +  //
> 
> +  SpiInstance->PchStrapSize = (UINT16) (((Data32 &
> B_FLASH_FDBAR_PCHSL)
> 
> +                                         >> N_FLASH_FDBAR_PCHSL)
> 
> +                                        * sizeof (UINT32));
> 
> +  DEBUG ((DEBUG_INFO, "PchStrapSize : %0x\n", SpiInstance-
> >PchStrapSize));
> 
> +
> 
> +  //
> 
> +  // Select FLASH_MAP2 to get Flash CPU Strap Base Address
> 
> +  //
> 
> +  MmioAndThenOr32 (
> 
> +    (PchSpiBar0 + R_SPI_MEM_FDOC),
> 
> +    (UINT32) (~(B_SPI_MEM_FDOC_FDSS_MASK |
> B_SPI_MEM_FDOC_FDSI_MASK)),
> 
> +    (UINT32) (V_SPI_MEM_FDOC_FDSS_FSDM |
> R_FLASH_FDBAR_FLASH_MAP2)
> 
> +    );
> 
> +  //
> 
> +  // Align FPSBA with address bits for the CPU Strap portion of flash
> descriptor
> 
> +  //
> 
> +  Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_FDOD);
> 
> +  //
> 
> +  // CPU Strap Length, [23:16] represents number of Dwords
> 
> +  //
> 
> +  SpiInstance->CpuStrapSize = (UINT16) (((Data32 &
> B_FLASH_FDBAR_CPUSL)
> 
> +                                         >> N_FLASH_FDBAR_CPUSL)
> 
> +                                        * sizeof (UINT32));
> 
> +
> 
> +  //
> 
> +  // CPU Strap Address [11:2] represent offset from MDTBA
> 
> +  //
> 
> +  SpiInstance->CpuStrapBaseAddr = (UINT16) ((Data32 &
> B_FLASH_FDBAR_FCPUSBA) >> N_FLASH_FDBAR_FCPUSBA);
> 
> +  ASSERT (SpiInstance->CpuStrapBaseAddr != 0);
> 
> +
> 
> +  if (SpiInstance->CpuStrapBaseAddr != 0x300) {
> 
> +    Status = SpiProtocolFlashRead (&(SpiInstance->SpiProtocol),
> FlashRegionAll, R_FLASH_UMAP1, sizeof (Data32), (UINT8 *) (&Data32));
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    Mdtba = (UINT16)(((Data32 & B_FLASH_UMAP1_MDTBA) >>
> N_FLASH_UMAP1_MDTBA) << N_FLASH_UMAP1_MDTBA_REPR);
> 
> +    DEBUG ((DEBUG_INFO, "Mdtba : %0x\n", Mdtba));
> 
> +    // Add MDTBA offset for final address of CPU Straps
> 
> +    SpiInstance->CpuStrapBaseAddr += Mdtba;
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "CpuStrapBaseAddr : %0x\n", SpiInstance-
> >CpuStrapBaseAddr));
> 
> +  DEBUG ((DEBUG_INFO, "CpuStrapSize : %0x\n", SpiInstance-
> >CpuStrapSize));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Delay for at least the request number of microseconds for Runtime usage.
> 
> +
> 
> +  @param[in] ABase                Acpi base address
> 
> +  @param[in] Microseconds         Number of microseconds to delay.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPmTimerStallRuntimeSafe (
> 
> +  IN  UINT16  ABase,
> 
> +  IN  UINTN   Microseconds
> 
> +  )
> 
> +{
> 
> +  UINTN   Ticks;
> 
> +  UINTN   Counts;
> 
> +  UINTN   CurrentTick;
> 
> +  UINTN   OriginalTick;
> 
> +  UINTN   RemainingTick;
> 
> +
> 
> +  if (Microseconds == 0) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  OriginalTick   = IoRead32 ((UINTN) (ABase + R_ACPI_IO_PM1_TMR)) &
> B_ACPI_IO_PM1_TMR_VAL;
> 
> +  CurrentTick    = OriginalTick;
> 
> +
> 
> +  //
> 
> +  // The timer frequency is 3.579545 MHz, so 1 ms corresponds 3.58 clocks
> 
> +  //
> 
> +  Ticks = Microseconds * 358 / 100 + OriginalTick + 1;
> 
> +
> 
> +  //
> 
> +  // The loops needed by timer overflow
> 
> +  //
> 
> +  Counts = Ticks / V_ACPI_IO_PM1_TMR_MAX_VAL;
> 
> +
> 
> +  //
> 
> +  // Remaining clocks within one loop
> 
> +  //
> 
> +  RemainingTick = Ticks % V_ACPI_IO_PM1_TMR_MAX_VAL;
> 
> +
> 
> +  //
> 
> +  // not intend to use TMROF_STS bit of register PM1_STS, because this
> adds extra
> 
> +  // one I/O operation, and maybe generate SMI
> 
> +  //
> 
> +  while ((Counts != 0) || (RemainingTick > CurrentTick)) {
> 
> +    CurrentTick = IoRead32 ((UINTN) (ABase + R_ACPI_IO_PM1_TMR)) &
> B_ACPI_IO_PM1_TMR_VAL;
> 
> +    //
> 
> +    // Check if timer overflow
> 
> +    //
> 
> +    if ((CurrentTick < OriginalTick)) {
> 
> +      if (Counts != 0) {
> 
> +        Counts--;
> 
> +      } else {
> 
> +        //
> 
> +        // If timer overflow and Counts equ to 0, that means we already stalled
> more than
> 
> +        // RemainingTick, break the loop here
> 
> +        //
> 
> +        break;
> 
> +      }
> 
> +    }
> 
> +
> 
> +    OriginalTick = CurrentTick;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Wait execution cycle to complete on the SPI interface.
> 
> +
> 
> +  @param[in] This                 The SPI protocol instance
> 
> +  @param[in] PchSpiBar0           Spi MMIO base address
> 
> +  @param[in] ErrorCheck           TRUE if the SpiCycle needs to do the error
> check
> 
> +
> 
> +  @retval TRUE                    SPI cycle completed on the interface.
> 
> +  @retval FALSE                   Time out while waiting the SPI cycle to complete.
> 
> +                                  It's not safe to program the next command on the SPI
> interface.
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +WaitForSpiCycleComplete (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINTN              PchSpiBar0,
> 
> +  IN     BOOLEAN            ErrorCheck
> 
> +  )
> 
> +{
> 
> +  UINT64        WaitTicks;
> 
> +  UINT64        WaitCount;
> 
> +  UINT32        Data32;
> 
> +  SPI_INSTANCE  *SpiInstance;
> 
> +
> 
> +  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +
> 
> +  //
> 
> +  // Convert the wait period allowed into to tick count
> 
> +  //
> 
> +  WaitCount = SPI_WAIT_TIME / SPI_WAIT_PERIOD;
> 
> +  //
> 
> +  // Wait for the SPI cycle to complete.
> 
> +  //
> 
> +  for (WaitTicks = 0; WaitTicks < WaitCount; WaitTicks++) {
> 
> +    Data32 = MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC);
> 
> +    if ((Data32 & B_SPI_MEM_HSFSC_SCIP) == 0) {
> 
> +      MmioWrite32 (PchSpiBar0 + R_SPI_MEM_HSFSC,
> B_SPI_MEM_HSFSC_FCERR | B_SPI_MEM_HSFSC_FDONE);
> 
> +      if (((Data32 & B_SPI_MEM_HSFSC_FCERR) != 0) && (ErrorCheck ==
> TRUE)) {
> 
> +        return FALSE;
> 
> +      } else {
> 
> +        return TRUE;
> 
> +      }
> 
> +    }
> 
> +    PchPmTimerStallRuntimeSafe (SpiInstance->PchAcpiBase,
> SPI_WAIT_PERIOD);
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function sends the programmed SPI command to the slave device.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SpiRegionType        The SPI Region type for flash cycle which is
> listed in the Descriptor
> 
> +  @param[in] FlashCycleType       The Flash SPI cycle type list in HSFC
> (Hardware Sequencing Flash Control Register) register
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[in,out] Buffer           Pointer to caller-allocated buffer containing
> the dada received or sent during the SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             SPI command completes successfully.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, the command aborts
> abnormally.
> 
> +  @retval EFI_ACCESS_DENIED       Some unrecognized or blocked command
> encountered in hardware sequencing mode
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +SendSpiCmd (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     FLASH_CYCLE_TYPE   FlashCycleType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN OUT UINT8              *Buffer
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS      Status;
> 
> +  UINT32          Index;
> 
> +  SPI_INSTANCE    *SpiInstance;
> 
> +  UINT64          SpiBaseAddress;
> 
> +  UINTN           PchSpiBar0;
> 
> +  UINT32          HardwareSpiAddr;
> 
> +  UINT32          FlashRegionSize;
> 
> +  UINT32          SpiDataCount;
> 
> +  UINT32          FlashCycle;
> 
> +  UINT8           BiosCtlSave;
> 
> +  UINT32          SmiEnSave;
> 
> +  UINT16          ABase;
> 
> +  UINT32          HsfstsCtl;
> 
> +
> 
> +  //
> 
> +  // For flash write, there is a requirement that all CPU threads are in SMM
> 
> +  // before the flash protection is disabled.
> 
> +  //
> 
> +  if ((FlashCycleType == FlashCycleWrite) || (FlashCycleType ==
> FlashCycleErase)) {
> 
> +    if (!IsSpiFlashWriteGranted ()) {
> 
> +      return EFI_ACCESS_DENIED;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Status            = EFI_SUCCESS;
> 
> +  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +  SpiBaseAddress    = SpiInstance->PchSpiBase;
> 
> +  PchSpiBar0        = AcquireSpiBar0 (SpiInstance);
> 
> +  ABase             = SpiInstance->PchAcpiBase;
> 
> +
> 
> +  //
> 
> +  // Disable SMIs to make sure normal mode flash access is not interrupted
> by an SMI
> 
> +  // whose SMI handler accesses flash (e.g. for error logging)
> 
> +  //
> 
> +  // *** NOTE: if the SMI_LOCK bit is set (i.e., PMC PCI Offset A0h [4]='1'),
> 
> +  // clearing B_GBL_SMI_EN will not have effect. In this situation, some
> other
> 
> +  // synchronization methods must be applied here or in the consumer of
> the
> 
> +  // SendSpiCmd. An example method is disabling the specific SMI sources
> 
> +  // whose SMI handlers access flash before flash cycle and re-enabling the
> SMI
> 
> +  // sources after the flash cycle .
> 
> +  //
> 
> +  SmiEnSave   = IoRead32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN));
> 
> +  IoWrite32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN), SmiEnSave & (UINT32)
> (~B_ACPI_IO_SMI_EN_GBL_SMI));
> 
> +  BiosCtlSave = PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_SRC;
> 
> +
> 
> +  //
> 
> +  // If it's write cycle, disable Prefetching, Caching and disable BIOS Write
> Protect
> 
> +  //
> 
> +  if ((FlashCycleType == FlashCycleWrite) ||
> 
> +      (FlashCycleType == FlashCycleErase)) {
> 
> +    Status = DisableBiosWriteProtect ();
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      goto SendSpiCmdEnd;
> 
> +    }
> 
> +    PciSegmentAndThenOr8 (
> 
> +      SpiBaseAddress + R_SPI_CFG_BC,
> 
> +      (UINT8) (~B_SPI_CFG_BC_SRC),
> 
> +      (UINT8) (V_SPI_CFG_BC_SRC_PREF_DIS_CACHE_DIS <<
> N_SPI_CFG_BC_SRC)
> 
> +      );
> 
> +  }
> 
> +  //
> 
> +  // Make sure it's safe to program the command.
> 
> +  //
> 
> +  if (!WaitForSpiCycleComplete (This, PchSpiBar0, FALSE)) {
> 
> +    Status = EFI_DEVICE_ERROR;
> 
> +    goto SendSpiCmdEnd;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if Write Status isn't disabled in HW Sequencing
> 
> +  //
> 
> +  if (FlashCycleType == FlashCycleWriteStatus) {
> 
> +    HsfstsCtl = MmioRead32 (PchSpiBar0 + R_SPI_MEM_HSFSC);
> 
> +    if ((HsfstsCtl & B_SPI_MEM_HSFSC_WRSDIS) != 0) {
> 
> +      Status = EFI_ACCESS_DENIED;
> 
> +      goto SendSpiCmdEnd;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Status = SpiProtocolGetRegionAddress (This, FlashRegionType,
> &HardwareSpiAddr, &FlashRegionSize);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    goto SendSpiCmdEnd;
> 
> +  }
> 
> +  HardwareSpiAddr += Address;
> 
> +  if ((Address + ByteCount) > FlashRegionSize) {
> 
> +    Status = EFI_INVALID_PARAMETER;
> 
> +    goto SendSpiCmdEnd;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check for PCH SPI hardware sequencing required commands
> 
> +  //
> 
> +  FlashCycle = 0;
> 
> +  switch (FlashCycleType) {
> 
> +    case FlashCycleRead:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    case FlashCycleWrite:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_WRITE <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    case FlashCycleErase:
> 
> +      if (((ByteCount % SIZE_4KB) != 0) ||
> 
> +          ((HardwareSpiAddr % SIZE_4KB) != 0)) {
> 
> +        ASSERT (FALSE);
> 
> +        Status = EFI_INVALID_PARAMETER;
> 
> +        goto SendSpiCmdEnd;
> 
> +      }
> 
> +      break;
> 
> +    case FlashCycleReadSfdp:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_SFDP <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    case FlashCycleReadJedecId:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_JEDEC_ID <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    case FlashCycleWriteStatus:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_WRITE_STATUS <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    case FlashCycleReadStatus:
> 
> +      FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_READ_STATUS <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      break;
> 
> +    default:
> 
> +      //
> 
> +      // Unrecognized Operation
> 
> +      //
> 
> +      ASSERT (FALSE);
> 
> +      Status = EFI_INVALID_PARAMETER;
> 
> +      goto SendSpiCmdEnd;
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  do {
> 
> +    SpiDataCount = ByteCount;
> 
> +    if ((FlashCycleType == FlashCycleRead) ||
> 
> +        (FlashCycleType == FlashCycleWrite) ||
> 
> +        (FlashCycleType == FlashCycleReadSfdp)) {
> 
> +      //
> 
> +      // Trim at 256 byte boundary per operation,
> 
> +      // - PCH SPI controller requires trimming at 4KB boundary
> 
> +      // - Some SPI chips require trimming at 256 byte boundary for write
> operation
> 
> +      // - Trimming has limited performance impact as we can read / write
> atmost 64 byte
> 
> +      //   per operation
> 
> +      //
> 
> +      if (HardwareSpiAddr + ByteCount > ((HardwareSpiAddr + BIT8) &~(BIT8 -
> 1))) {
> 
> +        SpiDataCount = (((UINT32) (HardwareSpiAddr) + BIT8) &~(BIT8 - 1)) -
> (UINT32) (HardwareSpiAddr);
> 
> +      }
> 
> +      //
> 
> +      // Calculate the number of bytes to shift in/out during the SPI data cycle.
> 
> +      // Valid settings for the number of bytes duing each data portion of the
> 
> +      // PCH SPI cycles are: 0, 1, 2, 3, 4, 5, 6, 7, 8, 16, 24, 32, 40, 48, 56, 64
> 
> +      //
> 
> +      if (SpiDataCount >= 64) {
> 
> +        SpiDataCount = 64;
> 
> +      } else if ((SpiDataCount &~0x07) != 0) {
> 
> +        SpiDataCount = SpiDataCount &~0x07;
> 
> +      }
> 
> +    }
> 
> +    if (FlashCycleType == FlashCycleErase) {
> 
> +      if (((ByteCount / SIZE_64KB) != 0) &&
> 
> +          ((ByteCount % SIZE_64KB) == 0) &&
> 
> +          ((HardwareSpiAddr % SIZE_64KB) == 0)) {
> 
> +        if ((SpiInstance->NumberOfComponents == 0) ||
> 
> +            (HardwareSpiAddr < SpiInstance->Component1StartAddr)) {
> 
> +          //
> 
> +          // Check whether Component0 support 64k Erase
> 
> +          //
> 
> +          if ((SpiInstance->SfdpVscc0Value &
> B_SPI_MEM_SFDPX_VSCCX_EO_64K) != 0) {
> 
> +            SpiDataCount = SIZE_64KB;
> 
> +          } else {
> 
> +            SpiDataCount = SIZE_4KB;
> 
> +          }
> 
> +        } else {
> 
> +          //
> 
> +          // Check whether Component1 support 64k Erase
> 
> +          //
> 
> +          if ((SpiInstance->SfdpVscc1Value &
> B_SPI_MEM_SFDPX_VSCCX_EO_64K) != 0) {
> 
> +            SpiDataCount = SIZE_64KB;
> 
> +          } else {
> 
> +            SpiDataCount = SIZE_4KB;
> 
> +          }
> 
> +        }
> 
> +      } else {
> 
> +        SpiDataCount = SIZE_4KB;
> 
> +      }
> 
> +      if (SpiDataCount == SIZE_4KB) {
> 
> +        FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_4K_ERASE <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      } else {
> 
> +        FlashCycle = (UINT32) (V_SPI_MEM_HSFSC_CYCLE_64K_ERASE <<
> N_SPI_MEM_HSFSC_CYCLE);
> 
> +      }
> 
> +    }
> 
> +    //
> 
> +    // If it's write cycle, load data into the SPI data buffer.
> 
> +    //
> 
> +    if ((FlashCycleType == FlashCycleWrite) || (FlashCycleType ==
> FlashCycleWriteStatus)) {
> 
> +      if ((SpiDataCount & 0x07) != 0) {
> 
> +        //
> 
> +        // Use Byte write if Data Count is 0, 1, 2, 3, 4, 5, 6, 7
> 
> +        //
> 
> +        for (Index = 0; Index < SpiDataCount; Index++) {
> 
> +          MmioWrite8 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index,
> Buffer[Index]);
> 
> +        }
> 
> +      } else {
> 
> +        //
> 
> +        // Use Dword write if Data Count is 8, 16, 24, 32, 40, 48, 56, 64
> 
> +        //
> 
> +        for (Index = 0; Index < SpiDataCount; Index += sizeof (UINT32)) {
> 
> +          MmioWrite32 (PchSpiBar0 + R_SPI_MEM_FDATA00 + Index, *(UINT32
> *) (Buffer + Index));
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Set the Flash Address
> 
> +    //
> 
> +    MmioWrite32 (
> 
> +      (PchSpiBar0 + R_SPI_MEM_FADDR),
> 
> +      (UINT32) (HardwareSpiAddr & B_SPI_MEM_FADDR_MASK)
> 
> +      );
> 
> +
> 
> +    //
> 
> +    // Set Data count, Flash cycle, and Set Go bit to start a cycle
> 
> +    //
> 
> +    MmioAndThenOr32 (
> 
> +      PchSpiBar0 + R_SPI_MEM_HSFSC,
> 
> +      (UINT32) (~(B_SPI_MEM_HSFSC_FDBC_MASK |
> B_SPI_MEM_HSFSC_CYCLE_MASK)),
> 
> +      (UINT32) ((((SpiDataCount - 1) << N_SPI_MEM_HSFSC_FDBC) &
> B_SPI_MEM_HSFSC_FDBC_MASK) | FlashCycle |
> B_SPI_MEM_HSFSC_CYCLE_FGO)
> 
> +      );
> 
> +    //
> 
> +    // end of command execution
> 
> +    //
> 
> +    // Wait the SPI cycle to complete.
> 
> +    //
> 
> +    if (!WaitForSpiCycleComplete (This, PchSpiBar0, TRUE)) {
> 
> +      ASSERT (FALSE);
> 
> +      Status = EFI_DEVICE_ERROR;
> 
> +      goto SendSpiCmdEnd;
> 
> +    }
> 
> +    //
> 
> +    // If it's read cycle, load data into the call's buffer.
> 
> +    //
> 
> +    if ((FlashCycleType == FlashCycleRead) ||
> 
> +        (FlashCycleType == FlashCycleReadSfdp) ||
> 
> +        (FlashCycleType == FlashCycleReadJedecId) ||
> 
> +        (FlashCycleType == FlashCycleReadStatus)) {
> 
> +      if ((SpiDataCount & 0x07) != 0) {
> 
> +        //
> 
> +        // Use Byte read if Data Count is 0, 1, 2, 3, 4, 5, 6, 7
> 
> +        //
> 
> +        for (Index = 0; Index < SpiDataCount; Index++) {
> 
> +          Buffer[Index] = MmioRead8 (PchSpiBar0 + R_SPI_MEM_FDATA00 +
> Index);
> 
> +        }
> 
> +      } else {
> 
> +        //
> 
> +        // Use Dword read if Data Count is 8, 16, 24, 32, 40, 48, 56, 64
> 
> +        //
> 
> +        for (Index = 0; Index < SpiDataCount; Index += sizeof (UINT32)) {
> 
> +          *(UINT32 *) (Buffer + Index) = MmioRead32 (PchSpiBar0 +
> R_SPI_MEM_FDATA00 + Index);
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +
> 
> +    HardwareSpiAddr += SpiDataCount;
> 
> +    Buffer += SpiDataCount;
> 
> +    ByteCount -= SpiDataCount;
> 
> +  } while (ByteCount > 0);
> 
> +
> 
> +SendSpiCmdEnd:
> 
> +  //
> 
> +  // Restore the settings for SPI Prefetching and Caching and enable BIOS
> Write Protect
> 
> +  //
> 
> +  if ((FlashCycleType == FlashCycleWrite) ||
> 
> +      (FlashCycleType == FlashCycleErase)) {
> 
> +    EnableBiosWriteProtect ();
> 
> +    PciSegmentAndThenOr8 (
> 
> +      SpiBaseAddress + R_SPI_CFG_BC,
> 
> +      (UINT8) ~B_SPI_CFG_BC_SRC,
> 
> +      BiosCtlSave
> 
> +      );
> 
> +  }
> 
> +  //
> 
> +  // Restore SMIs.
> 
> +  //
> 
> +  IoWrite32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN), SmiEnSave);
> 
> +
> 
> +  ReleaseSpiBar0 (SpiInstance);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[out] Buffer              The Pointer to caller-allocated buffer
> containing the dada received.
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashRead (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *Buffer
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionType,
> 
> +             FlashCycleRead,
> 
> +             Address,
> 
> +             ByteCount,
> 
> +             Buffer
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write data to the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +  @param[in] Buffer               Pointer to caller-allocated buffer containing the
> data sent during the SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashWrite (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *Buffer
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionType,
> 
> +             FlashCycleWrite,
> 
> +             Address,
> 
> +             ByteCount,
> 
> +             Buffer
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Erase some area on the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for flash cycle which
> is listed in the Descriptor.
> 
> +  @param[in] Address              The Flash Linear Address must fall within a
> region for which BIOS has access permissions.
> 
> +  @param[in] ByteCount            Number of bytes in the data portion of the
> SPI cycle.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashErase (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionType,
> 
> +             FlashCycleErase,
> 
> +             Address,
> 
> +             ByteCount,
> 
> +             NULL
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read SFDP data from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] Address              The starting byte address for SFDP data read.
> 
> +  @param[in] ByteCount            Number of bytes in SFDP data portion of the
> SPI cycle
> 
> +  @param[out] SfdpData            The Pointer to caller-allocated buffer
> containing the SFDP data received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode
> enabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadSfdp (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             Address,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *SfdpData
> 
> +  )
> 
> +{
> 
> +  SPI_INSTANCE      *SpiInstance;
> 
> +  EFI_STATUS        Status;
> 
> +  UINT32            FlashAddress;
> 
> +
> 
> +  if (SpiIsSafModeActive ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is
> active.\n", __FUNCTION__));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +  Status            = EFI_SUCCESS;
> 
> +
> 
> +  if (ComponentNumber > SpiInstance->NumberOfComponents) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  FlashAddress = 0;
> 
> +  if (ComponentNumber == FlashComponent1) {
> 
> +    FlashAddress = SpiInstance->Component1StartAddr;
> 
> +  }
> 
> +  FlashAddress += Address;
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionAll,
> 
> +             FlashCycleReadSfdp,
> 
> +             FlashAddress,
> 
> +             ByteCount,
> 
> +             SfdpData
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read Jedec Id from the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ComponentNumber      The Componen Number for chip select
> 
> +  @param[in] ByteCount            Number of bytes in JedecId data portion of
> the SPI cycle, the data size is 3 typically
> 
> +  @param[out] JedecId             The Pointer to caller-allocated buffer
> containing JEDEC ID received
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode
> enabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadJedecId (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT8              ComponentNumber,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *JedecId
> 
> +  )
> 
> +{
> 
> +  SPI_INSTANCE      *SpiInstance;
> 
> +  EFI_STATUS        Status;
> 
> +  UINT32            Address;
> 
> +
> 
> +  if (SpiIsSafModeActive ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is
> active.\n", __FUNCTION__));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  SpiInstance       = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +  Status            = EFI_SUCCESS;
> 
> +
> 
> +  if (ComponentNumber > SpiInstance->NumberOfComponents) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Address = 0;
> 
> +  if (ComponentNumber == FlashComponent1) {
> 
> +    Address = SpiInstance->Component1StartAddr;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionAll,
> 
> +             FlashCycleReadJedecId,
> 
> +             Address,
> 
> +             ByteCount,
> 
> +             JedecId
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write the status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[in] StatusValue          The Pointer to caller-allocated buffer
> containing the value of Status register writing
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode
> enabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashWriteStatus (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  IN     UINT8              *StatusValue
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  if (SpiIsSafModeActive ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is
> active.\n", __FUNCTION__));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionAll,
> 
> +             FlashCycleWriteStatus,
> 
> +             0,
> 
> +             ByteCount,
> 
> +             StatusValue
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read status register in the flash part.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] ByteCount            Number of bytes in Status data portion of the
> SPI cycle, the data size is 1 typically
> 
> +  @param[out] StatusValue         The Pointer to caller-allocated buffer
> containing the value of Status register received.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +  @retval EFI_UNSUPPORTED         Unsupported operation with SAF Mode
> enabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolFlashReadStatus (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    UINT8              *StatusValue
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  if (SpiIsSafModeActive ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "Unallowed call to %a while SAF Mode is
> active.\n", __FUNCTION__));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Sends the command to the SPI interface to execute.
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionAll,
> 
> +             FlashCycleReadStatus,
> 
> +             0,
> 
> +             ByteCount,
> 
> +             StatusValue
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get the SPI region base and size, based on the enum type
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] FlashRegionType      The Flash Region type for for the base
> address which is listed in the Descriptor.
> 
> +  @param[out] BaseAddress         The Flash Linear Address for the Region 'n'
> Base
> 
> +  @param[out] RegionSize          The size for the Region 'n'
> 
> +
> 
> +  @retval EFI_SUCCESS             Read success
> 
> +  @retval EFI_INVALID_PARAMETER   Invalid region type given
> 
> +  @retval EFI_DEVICE_ERROR        The region is not used
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolGetRegionAddress (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     FLASH_REGION_TYPE  FlashRegionType,
> 
> +  OUT    UINT32             *BaseAddress,
> 
> +  OUT    UINT32             *RegionSize
> 
> +  )
> 
> +{
> 
> +  SPI_INSTANCE    *SpiInstance;
> 
> +  UINTN           PchSpiBar0;
> 
> +  UINT32          ReadValue;
> 
> +
> 
> +  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +
> 
> +  if (FlashRegionType >= FlashRegionMax) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (FlashRegionType == FlashRegionAll) {
> 
> +    *BaseAddress  = 0;
> 
> +    *RegionSize   = SpiInstance->TotalFlashSize;
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  PchSpiBar0      = AcquireSpiBar0 (SpiInstance);
> 
> +  ReadValue = MmioRead32 (PchSpiBar0 + (R_SPI_MEM_FREG0_FLASHD +
> (S_SPI_MEM_FREGX * ((UINT32) FlashRegionType))));
> 
> +  ReleaseSpiBar0 (SpiInstance);
> 
> +
> 
> +  //
> 
> +  // If the region is not used, the Region Base is 7FFFh and Region Limit is
> 0000h
> 
> +  //
> 
> +  if (ReadValue == B_SPI_MEM_FREGX_BASE_MASK) {
> 
> +    return EFI_DEVICE_ERROR;
> 
> +  }
> 
> +  *BaseAddress = ((ReadValue & B_SPI_MEM_FREGX_BASE_MASK) >>
> N_SPI_MEM_FREGX_BASE) <<
> 
> +    N_SPI_MEM_FREGX_BASE_REPR;
> 
> +  //
> 
> +  // Region limit address Bits[11:0] are assumed to be FFFh
> 
> +  //
> 
> +  *RegionSize = ((((ReadValue & B_SPI_MEM_FREGX_LIMIT_MASK) >>
> N_SPI_MEM_FREGX_LIMIT) + 1) <<
> 
> +                 N_SPI_MEM_FREGX_LIMIT_REPR) - *BaseAddress;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read PCH Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        PCH Soft Strap address offset from FPSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing PCH Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolReadPchSoftStrap (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  )
> 
> +{
> 
> +  SPI_INSTANCE      *SpiInstance;
> 
> +  UINT32            StrapFlashAddr;
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +
> 
> +  if (ByteCount == 0) {
> 
> +    *(UINT16 *) SoftStrapValue = SpiInstance->PchStrapSize;
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  if ((SoftStrapAddr + ByteCount) > (UINT32) SpiInstance->PchStrapSize) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // PCH Strap Flash Address = FPSBA + RamAddr
> 
> +  //
> 
> +  StrapFlashAddr = SpiInstance->PchStrapBaseAddr + SoftStrapAddr;
> 
> +
> 
> +  //
> 
> +  // Read PCH Soft straps from using execute command
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionDescriptor,
> 
> +             FlashCycleRead,
> 
> +             StrapFlashAddr,
> 
> +             ByteCount,
> 
> +             SoftStrapValue
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read CPU Soft Strap Values
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SPI_PROTOCOL instance.
> 
> +  @param[in] SoftStrapAddr        CPU Soft Strap address offset from
> FCPUSBA.
> 
> +  @param[in] ByteCount            Number of bytes in SoftStrap data portion of
> the SPI cycle.
> 
> +  @param[out] SoftStrapValue      The Pointer to caller-allocated buffer
> containing CPU Soft Strap Value.
> 
> +                                  If the value of ByteCount is 0, the data type of
> SoftStrapValue should be UINT16 and SoftStrapValue will be PCH Soft Strap
> Length
> 
> +                                  It is the caller's responsibility to make sure Buffer is large
> enough for the total number of bytes read.
> 
> +
> 
> +  @retval EFI_SUCCESS             Command succeed.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameters specified are not
> valid.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, command aborts abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SpiProtocolReadCpuSoftStrap (
> 
> +  IN     PCH_SPI_PROTOCOL   *This,
> 
> +  IN     UINT32             SoftStrapAddr,
> 
> +  IN     UINT32             ByteCount,
> 
> +  OUT    VOID               *SoftStrapValue
> 
> +  )
> 
> +{
> 
> +  SPI_INSTANCE      *SpiInstance;
> 
> +  UINT32            StrapFlashAddr;
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  SpiInstance     = SPI_INSTANCE_FROM_SPIPROTOCOL (This);
> 
> +
> 
> +  if (ByteCount == 0) {
> 
> +    *(UINT16 *) SoftStrapValue = SpiInstance->CpuStrapSize;
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  if ((SoftStrapAddr + ByteCount) > (UINT32) SpiInstance->CpuStrapSize) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // CPU Strap Flash Address = FCPUSBA + RamAddr
> 
> +  //
> 
> +  StrapFlashAddr = SpiInstance->CpuStrapBaseAddr + SoftStrapAddr;
> 
> +
> 
> +  //
> 
> +  // Read Cpu Soft straps from using execute command
> 
> +  //
> 
> +  Status = SendSpiCmd (
> 
> +             This,
> 
> +             FlashRegionDescriptor,
> 
> +             FlashCycleRead,
> 
> +             StrapFlashAddr,
> 
> +             ByteCount,
> 
> +             SoftStrapValue
> 
> +             );
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
> new file mode 100644
> index 0000000000..4e059494d8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
> @@ -0,0 +1,40 @@
> +## @file
> 
> +# Component description file for PCH SPI access private library
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION     = 0x00010017
> 
> +BASE_NAME       = PeiDxeSmmSpiAccessPrivateLib
> 
> +FILE_GUID       = 2CD382D7-9928-C32A-601D-69797C618A6D
> 
> +VERSION_STRING  = 1.0
> 
> +MODULE_TYPE     = BASE
> 
> +LIBRARY_CLASS   = SpiAccessPrivateLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +SpiAccessLib
> 
> +PcdLib
> 
> +S3BootScriptLib
> 
> +PchPciBdfLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SpiAccessPrivateLib.c
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/SpiAccessPrivateLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/SpiAccessPrivateLib.c
> new file mode 100644
> index 0000000000..de1f3d3f86
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/LibraryPrivate/PeiDxeSmmSpi
> AccessPrivateLib/SpiAccessPrivateLib.c
> @@ -0,0 +1,133 @@
> +/** @file
> 
> +  SPI library for abstraction of SPI HW registers accesses
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/SpiAccessLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Disable EISS (Enable InSMM.STS)
> 
> +**/
> 
> +VOID
> 
> +SpiDisableEiss (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64  SpiBaseAddress;
> 
> +  SpiBaseAddress = SpiPciCfgBase ();
> 
> +
> 
> +  ASSERT ((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_LE) == 0);
> 
> +
> 
> +  PciSegmentAnd8 (SpiBaseAddress + R_SPI_CFG_BC, (UINT8)
> ~(B_SPI_CFG_BC_EISS));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Configure BiosLockEnable bit and BiosInterfaceLock bit according to policy
> setting.
> 
> +
> 
> +  @param[in] BiosLockEnable     Policy for BiosLockEnable bit programming
> 
> +  @param[in] BiosInterfaceLock  Policy for BiosInterfaceLock bit
> programming
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SpiBiosLockEnableAndBiosInterfaceLockWithS3BootScript (
> 
> +  IN BOOLEAN  BiosLockEnable,
> 
> +  IN BOOLEAN  BiosInterfaceLock
> 
> +  )
> 
> +{
> 
> +  UINT64                   SpiBaseAddress;
> 
> +  UINT8                    SpiData8;
> 
> +
> 
> +  if (!BiosLockEnable && !BiosInterfaceLock) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  SpiBaseAddress = SpiPciCfgBase ();
> 
> +
> 
> +  ///
> 
> +  /// PCH BIOS Spec Flash Security Recommendation
> 
> +  ///
> 
> +  /// BIOS needs to enable the BIOS Lock Enable (BLE) feature of the PCH by
> setting
> 
> +  /// SPI/eSPI/LPC PCI offset DCh[1] = 1b.
> 
> +  /// When this bit is set, attempts to write the Write Protect Disable (WPD)
> bit
> 
> +  /// in PCH will cause a SMI which will allow the BIOS to verify that the write
> is
> 
> +  /// from a valid source.
> 
> +  /// Remember that BIOS needs to set SPI/LPC/eSPI PCI Offset DC [0] = 0b
> to enable
> 
> +  /// BIOS region protection before exiting the SMI handler.
> 
> +  /// Also, TCO_EN bit needs to be set (SMI_EN Register, ABASE + 30h[13] =
> 1b) to keep
> 
> +  /// BLE feature enabled after booting to the OS.
> 
> +  /// Intel requires that BIOS enables the Lock Enable (LE) feature of the PCH
> to
> 
> +  /// ensure SMM protection of flash.
> 
> +  /// RC installs a default SMI handler that clears WPD.
> 
> +  /// There could be additional SMI handler to log such attempt if desired.
> 
> +  ///
> 
> +  /// BIOS needs to enable the "Enable in SMM.STS" (EISS) feature of the
> PCH by setting
> 
> +  /// SPI PCI offset DCh[5] = 1b for SPI or setting eSPI PCI offset DCh[5] = 1b
> for eSPI.
> 
> +  /// When this bit is set, the BIOS region is not writable until SMM sets the
> InSMM.STS bit,
> 
> +  /// to ensure BIOS can only be modified from SMM. Please refer to CPU
> BWG for more details
> 
> +  /// on InSMM.STS bit.
> 
> +  /// Intel requires that BIOS enables the Lock Enable (LE) feature of the PCH
> to ensure
> 
> +  /// SMM protection of flash.
> 
> +  /// SPI PCI offset DCh[1] = 1b for SPI or setting eSPI PCI offset DCh[1] = 1b
> for eSPI.
> 
> +  /// When this bit is set, EISS is locked down.
> 
> +  ///
> 
> +  SpiData8 = 0;
> 
> +  if (BiosLockEnable) {
> 
> +    SpiData8 |= B_SPI_CFG_BC_EISS | B_SPI_CFG_BC_LE;
> 
> +  }
> 
> +  ///
> 
> +  /// BIOS also needs to set the BIOS Interface Lock Down bit in multiple
> locations
> 
> +  /// (PCR[DMI] + 274Ch[0], LPC/eSPI PCI offset DCh[7] and SPI PCI offset
> DCh[7]).
> 
> +  /// (done in PchInit/Dxe/PchInit.c by
> PchDmiSetBiosLockDownWithS3BootScript ()) for PCR[DMI] 274Ch)
> 
> +  /// Setting these bits will prevent writes to the Top Swap bit (under their
> respective locations)
> 
> +  /// and the Boot BIOS Straps. Enabling this bit will mitigate malicious
> software
> 
> +  /// attempts to replace the system BIOS option ROM with its own code.
> 
> +  ///
> 
> +  if (BiosInterfaceLock) {
> 
> +    SpiData8 |= B_SPI_CFG_BC_BILD;
> 
> +  }
> 
> +
> 
> +  PciSegmentOr8 (SpiBaseAddress + R_SPI_CFG_BC, SpiData8);
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint8,
> 
> +    PcdGet64 (PcdPciExpressBaseAddress) + SpiBaseAddress +
> R_SPI_CFG_BC,
> 
> +    1,
> 
> +    (VOID *) (UINTN) (PcdGet64 (PcdPciExpressBaseAddress) +
> SpiBaseAddress + R_SPI_CFG_BC)
> 
> +    );
> 
> +  //
> 
> +  // Reads back for posted write to take effect
> 
> +  //
> 
> +  SpiData8 = PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC);
> 
> +  S3BootScriptSaveMemPoll  (
> 
> +    S3BootScriptWidthUint8,
> 
> +    PcdGet64 (PcdPciExpressBaseAddress) + SpiBaseAddress +
> R_SPI_CFG_BC,
> 
> +    &SpiData8,
> 
> +    &SpiData8,
> 
> +    1,
> 
> +    1
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clears BIOS Write Protect Disable bit
> 
> +**/
> 
> +VOID
> 
> +SpiClearBiosWriteProtectDisable (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Disable BIOSWE bit to protect BIOS
> 
> +  //
> 
> +  PciSegmentAnd8 (SpiPciCfgBase () + R_SPI_CFG_BC, (UINT8)
> ~B_SPI_CFG_BC_WPD);
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
> new file mode 100644
> index 0000000000..419eddaff3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/Spi.c
> @@ -0,0 +1,296 @@
> +/** @file
> 
> +  PCH SPI SMM Driver implements the SPI Host Controller Compatibility
> Interface.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiDriverEntryPoint.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Protocol/Spi.h>
> 
> +#include <Protocol/SmmCpu.h>
> 
> +#include <Library/SpiCommonLib.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <Library/SmmPchPrivateLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +
> 
> +//
> 
> +// Global variables
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED SPI_INSTANCE          *mSpiInstance;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_CPU_PROTOCOL
> *mSmmCpuProtocol;
> 
> +//
> 
> +// mPchSpiResvMmioAddr keeps the reserved MMIO range assiged to SPI.
> 
> +// In SMM it always set back the reserved MMIO address to SPI BAR0 to
> ensure the MMIO range
> 
> +// won't overlap with SMRAM range, and trusted.
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT32                mSpiResvMmioAddr;
> 
> +
> 
> +/**
> 
> +  <b>SPI Runtime SMM Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +    The SPI SMM module provide a standard way for other modules to use
> the PCH SPI Interface in SMM.
> 
> +
> 
> +  - @pre
> 
> +    - EFI_SMM_BASE2_PROTOCOL
> 
> +      - Documented in System Management Mode Core Interface
> Specification .
> 
> +
> 
> +  - @result
> 
> +    The SPI SMM driver produces @link _PCH_SPI_PROTOCOL
> PCH_SPI_PROTOCOL @endlink with GUID
> 
> +    gPchSmmSpiProtocolGuid which is different from SPI RUNTIME driver.
> 
> +
> 
> +  - <b>Integration Check List</b>\n
> 
> +    - This driver supports Descriptor Mode only.
> 
> +    - This driver supports Hardware Sequence only.
> 
> +    - When using SMM SPI Protocol to perform flash access in an SMI handler,
> 
> +      and the SMI occurrence is asynchronous to normal mode code
> execution,
> 
> +      proper synchronization mechanism must be applied, e.g. disable SMI
> before
> 
> +      the normal mode SendSpiCmd() starts and re-enable SMI after
> 
> +      the normal mode SendSpiCmd() completes.
> 
> +      @note The implementation of SendSpiCmd() uses GBL_SMI_EN in
> 
> +      SMI_EN register (ABase + 30h) to disable and enable SMIs. But this may
> 
> +      not be effective as platform may well set the SMI_LOCK bit (i.e., PMC
> PCI Offset A0h [4]).
> 
> +      So the synchronization at caller level is likely needed.
> 
> +
> 
> +  @param[in] ImageHandle          Image handle of this driver.
> 
> +  @param[in] SystemTable          Global system service table.
> 
> +
> 
> +  @retval EFI_SUCCESS             Initialization complete.
> 
> +  @exception EFI_UNSUPPORTED      The chipset is unsupported by this
> driver.
> 
> +  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to
> initialize the driver.
> 
> +  @retval EFI_DEVICE_ERROR        Device error, driver exits abnormally.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchSpi (
> 
> +  IN EFI_HANDLE            ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE      *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  //
> 
> +  // Init PCH spi reserved MMIO address.
> 
> +  //
> 
> +  mSpiResvMmioAddr = PCH_SPI_BASE_ADDRESS;
> 
> +
> 
> +  ///
> 
> +  /// Allocate pool for SPI protocol instance
> 
> +  ///
> 
> +  Status = gSmst->SmmAllocatePool (
> 
> +                    EfiRuntimeServicesData, /// MemoryType don't care
> 
> +                    sizeof (SPI_INSTANCE),
> 
> +                    (VOID **) &mSpiInstance
> 
> +                    );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  if (mSpiInstance == NULL) {
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +
> 
> +  ZeroMem ((VOID *) mSpiInstance, sizeof (SPI_INSTANCE));
> 
> +  ///
> 
> +  /// Initialize the SPI protocol instance
> 
> +  ///
> 
> +  Status = SpiProtocolConstructor (mSpiInstance);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  ///
> 
> +  /// Install the SMM PCH_SPI_PROTOCOL interface
> 
> +  ///
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &(mSpiInstance->Handle),
> 
> +                    &gPchSmmSpiProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &(mSpiInstance->SpiProtocol)
> 
> +                    );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    gSmst->SmmFreePool (mSpiInstance);
> 
> +    return EFI_DEVICE_ERROR;
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Acquire PCH spi mmio address.
> 
> +  If it is ever different from the preallocated address, reassign it back.
> 
> +  In SMM, it always override the BAR0 and returns the reserved MMIO
> range for SPI.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval PchSpiBar0              return SPI MMIO address
> 
> +**/
> 
> +UINTN
> 
> +AcquireSpiBar0 (
> 
> +  IN  SPI_INSTANCE                *SpiInstance
> 
> +  )
> 
> +{
> 
> +  UINT32                          SpiBar0;
> 
> +  //
> 
> +  // Save original SPI physical MMIO address
> 
> +  //
> 
> +  SpiBar0 = PciSegmentRead32 (SpiInstance->PchSpiBase +
> R_SPI_CFG_BAR0) & ~(B_SPI_CFG_BAR0_MASK);
> 
> +
> 
> +  if (SpiBar0 != mSpiResvMmioAddr) {
> 
> +    //
> 
> +    // Temporary disable MSE, and override with SPI reserved MMIO
> address, then enable MSE.
> 
> +    //
> 
> +    PciSegmentAnd8 (SpiInstance->PchSpiBase + PCI_COMMAND_OFFSET,
> (UINT8) ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +    PciSegmentWrite32 (SpiInstance->PchSpiBase + R_SPI_CFG_BAR0,
> mSpiResvMmioAddr);
> 
> +    PciSegmentOr8 (SpiInstance->PchSpiBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  }
> 
> +  //
> 
> +  // SPIBAR0 will be different before and after PCI enum so need to get it
> from SPI BAR0 reg.
> 
> +  //
> 
> +  return mSpiResvMmioAddr;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Release pch spi mmio address. Do nothing.
> 
> +
> 
> +  @param[in] SpiInstance          Pointer to SpiInstance to initialize
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +ReleaseSpiBar0 (
> 
> +  IN  SPI_INSTANCE                *SpiInstance
> 
> +  )
> 
> +{
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function is a hook for Spi to disable BIOS Write Protect
> 
> +
> 
> +  @retval EFI_SUCCESS             The protocol instance was properly initialized
> 
> +  @retval EFI_ACCESS_DENIED       The BIOS Region can only be updated in
> SMM phase
> 
> +
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +DisableBiosWriteProtect (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64     SpiBaseAddress;
> 
> +
> 
> +  SpiBaseAddress = SpiPciCfgBase ();
> 
> +  // Write clear BC_SYNC_SS prior to change WPD from 0 to 1.
> 
> +  //
> 
> +  PciSegmentOr8 (
> 
> +    SpiBaseAddress + R_SPI_CFG_BC + 1,
> 
> +    (B_SPI_CFG_BC_SYNC_SS >> 8)
> 
> +    );
> 
> +  ///
> 
> +  /// Set BIOSWE bit (SPI PCI Offset DCh [0]) = 1b
> 
> +  /// Enable the access to the BIOS space for both read and write cycles
> 
> +  ///
> 
> +  PciSegmentOr8 (
> 
> +    SpiBaseAddress + R_SPI_CFG_BC,
> 
> +    B_SPI_CFG_BC_WPD
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// PCH BIOS Spec Section 3.7 BIOS Region SMM Protection Enabling
> 
> +  /// If the following steps are implemented:
> 
> +  ///  - Set the EISS bit (SPI PCI Offset DCh [5]) = 1b
> 
> +  ///  - Follow the 1st recommendation in section 3.6
> 
> +  /// the BIOS Region can only be updated by following the steps bellow:
> 
> +  ///  - Once all threads enter SMM
> 
> +  ///  - Read memory location FED30880h OR with 00000001h, place the
> result in EAX,
> 
> +  ///    and write data to lower 32 bits of MSR 1FEh (sample code available)
> 
> +  ///  - Set BIOSWE bit (SPI PCI Offset DCh [0]) = 1b
> 
> +  ///  - Modify BIOS Region
> 
> +  ///  - Clear BIOSWE bit (SPI PCI Offset DCh [0]) = 0b
> 
> +  ///
> 
> +  if ((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_EISS) != 0) {
> 
> +    PchSetInSmmSts ();
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function is a hook for Spi to enable BIOS Write Protect
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +EnableBiosWriteProtect (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64     SpiBaseAddress;
> 
> +
> 
> +  SpiBaseAddress = SpiPciCfgBase ();
> 
> +  ///
> 
> +  /// Clear BIOSWE bit (SPI PCI Offset DCh [0]) = 0b
> 
> +  /// Disable the access to the BIOS space for write cycles
> 
> +  ///
> 
> +  PciSegmentAnd8 (
> 
> +    SpiBaseAddress + R_SPI_CFG_BC,
> 
> +    (UINT8) (~B_SPI_CFG_BC_WPD)
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// Check if EISS bit is set
> 
> +  ///
> 
> +  if (((PciSegmentRead8 (SpiBaseAddress + R_SPI_CFG_BC)) &
> B_SPI_CFG_BC_EISS) == B_SPI_CFG_BC_EISS) {
> 
> +    PchClearInSmmSts ();
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if it's granted to do flash write.
> 
> +
> 
> +  @retval TRUE    It's secure to do flash write.
> 
> +  @retval FALSE   It's not secure to do flash write.
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSpiFlashWriteGranted (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS    Status;
> 
> +  UINT32        CpuIndex;
> 
> +  UINT64        ProcessorId;
> 
> +
> 
> +  if (mSmmCpuProtocol == NULL) {
> 
> +    Status = gSmst->SmmLocateProtocol (&gEfiSmmCpuProtocolGuid, NULL,
> (VOID **)&mSmmCpuProtocol);
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    if (mSmmCpuProtocol == NULL) {
> 
> +      return TRUE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  for (CpuIndex = 0; CpuIndex < gSmst->NumberOfCpus; CpuIndex++) {
> 
> +    Status = mSmmCpuProtocol->ReadSaveState (
> 
> +                                mSmmCpuProtocol,
> 
> +                                sizeof (ProcessorId),
> 
> +                                EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID,
> 
> +                                CpuIndex,
> 
> +                                &ProcessorId
> 
> +                                );
> 
> +    //
> 
> +    // If the processor is in SMM at the time the SMI occurred,
> 
> +    // it will return success. Otherwise, EFI_NOT_FOUND is returned.
> 
> +    //
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      return FALSE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
> new file mode 100644
> index 0000000000..033134cea1
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Spi/Smm/SpiSmm.inf
> @@ -0,0 +1,47 @@
> +## @file
> 
> +# Component description file for the SPI SMM driver.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = SpiSmm
> 
> +FILE_GUID = 27F4917B-A707-4aad-9676-26DF168CBF0D
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_SMM_DRIVER
> 
> +PI_SPECIFICATION_VERSION = 1.10
> 
> +ENTRY_POINT = InstallPchSpi
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +IoLib
> 
> +UefiDriverEntryPoint
> 
> +UefiBootServicesTableLib
> 
> +BaseLib
> 
> +SmmServicesTableLib
> 
> +SpiCommonLib
> 
> +SmmPchPrivateLib
> 
> +PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +Spi.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gPchSmmSpiProtocolGuid ## PRODUCES
> 
> +gEfiSmmCpuProtocolGuid ## CONSUMES
> 
> +
> 
> +
> 
> +[Depex]
> 
> +gEfiSmmBase2ProtocolGuid AND # This is for SmmServicesTableLib
> 
> +gEfiSmmCpuProtocolGuid # This is for CpuSmmDisableBiosWriteProtect()
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component
  2021-02-01  1:36 ` [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * IpBlock/Vtd/IncludePrivate
>   * IpBlock/Vtd/Library
>   * IpBlock/Vtd/LibraryPrivate
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtdI
> nitLib.h              |  62
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVtd
> PolicyLib.h            |  67
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.h
> |  32 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/
> PeiDxeSmmVtdInfoLib.inf |  45
> +++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLib/
> VtdInfoLib.c            |  86
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/D
> xeVtdInitLib.c        | 684
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/D
> xeVtdInitLib.inf      |  71
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib
> /DxeVtdPolicyLib.c    |  90
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLib
> /DxeVtdPolicyLib.inf  |  35 +++++++++++++++++++++++++++++++++++
>  9 files changed, 1172 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dInitLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dInitLib.h
> new file mode 100644
> index 0000000000..e439cfbac2
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dInitLib.h
> @@ -0,0 +1,62 @@
> +/** @file
> 
> +  Header file for DXE VTD Init Lib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_VTD_INIT_LIB_H_
> 
> +#define _DXE_VTD_INIT_LIB_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/VtdInfoLib.h>
> 
> +#include <Library/SaPlatformLib.h>
> 
> +#include <IndustryStandard/Acpi.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <VtdDataHob.h>
> 
> +#include <PchConfigHob.h>
> 
> +#include <PchInfoHob.h>
> 
> +#include <Register/P2sbRegs.h>
> 
> +#include <Register/IpuRegs.h>
> 
> +#include <Register/IgdRegs.h>
> 
> +#include <Register/VtdRegs.h>
> 
> +#include <DmaRemappingTable.h>
> 
> +#include <Protocol/AcpiSystemDescriptionTable.h>
> 
> +#include <Protocol/AcpiTable.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Protocol/SaNvsArea.h>
> 
> +#include <Protocol/FirmwareVolume2.h>
> 
> +
> 
> +/**
> 
> +  Locate the VT-d ACPI tables data file and read ACPI SSDT tables.
> 
> +  Publish the appropriate SSDT based on current configuration and
> capabilities.
> 
> +
> 
> +  @param[in] SaPolicy            SA DXE Policy protocol
> 
> +
> 
> +  @retval EFI_SUCCESS - Vtd initialization complete
> 
> +  @retval Other       - No Vtd function initiated
> 
> +**/
> 
> +EFI_STATUS
> 
> +VtdInit (
> 
> +  IN  SA_POLICY_PROTOCOL    *SaPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  EndOfPcieEnum routine for update DMAR
> 
> +**/
> 
> +VOID
> 
> +UpdateDmarEndOfPcieEnum (
> 
> +  VOID
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dPolicyLib.h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dPolicyLib.h
> new file mode 100644
> index 0000000000..d55cf6bc34
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/Library/DxeVt
> dPolicyLib.h
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  Prototype of the DXE VTD Policy Init library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_VTD_POLICY_INIT_LIB_H_
> 
> +#define _DXE_VTD_POLICY_INIT_LIB_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <VtdConfig.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +
> 
> +extern EFI_GUID gVtdDxeConfigGuid;
> 
> +
> 
> +/**
> 
> +  This function Load default Vtd DXE policy.
> 
> +
> 
> +  @param[in] ConfigBlockPointer    The pointer to add VTD config block
> 
> +**/
> 
> +VOID
> 
> +VtdLoadDefaultDxe (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function prints the DXE phase VTD policy.
> 
> +
> 
> +  @param[in] SaPolicy - Instance of SA_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +VtdPrintPolicyDxe (
> 
> +  IN  SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function is used to add VTD Config Block.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add VTD config
> blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VtdAddConfigBlocksDxe (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get VTD DXE config block table total size.
> 
> +
> 
> +  @retval     Size of VTD DXE config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +VtdGetConfigBlockTotalSizeDxe (
> 
> +  VOID
> 
> +  );
> 
> +#endif // _DXE_VTD_POLICY_INIT_LIB_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.
> h
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.
> h
> new file mode 100644
> index 0000000000..0f9d500af9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/IncludePrivate/VtdDataHob.
> h
> @@ -0,0 +1,32 @@
> +/** @file
> 
> +  The GUID definition for Vtd Data Hob
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _VTD_DATA_HOB_H_
> 
> +#define _VTD_DATA_HOB_H_
> 
> +
> 
> +#include <Library/VtdInfoLib.h>
> 
> +#include <Base.h>
> 
> +
> 
> +extern EFI_GUID gVtdDataHobGuid;
> 
> +
> 
> +#pragma pack (push,1)
> 
> +
> 
> +///
> 
> +/// The data elements should be initialized by a Platform Module.
> 
> +/// The data structure is for VT-d driver initialization
> 
> +///
> 
> +typedef struct {
> 
> +  EFI_HOB_GUID_TYPE     EfiHobGuidType;                    ///< GUID Hob type
> structure for gVtdDataHobGuid
> 
> +  BOOLEAN               VtdDisable;                        ///< 1 = Avoids programming Vtd
> bars, Vtd overrides and DMAR table
> 
> +  UINT32                BaseAddress[VTD_ENGINE_NUMBER];    ///< This field is
> used to describe the base addresses for VT-d function
> 
> +  BOOLEAN               X2ApicOptOut;                      ///< This field is used to enable
> the X2APIC_OPT_OUT bit in the DMAR table. <b>1=Enable/Set</b> and
> 0=Disable/Clear
> 
> +  BOOLEAN               DmaControlGuarantee;               ///< This field is used to
> enable the DMA_CONTROL_GUARANTEE bit in the DMAR table.
> <b>1=Enable/Set</b> and 0=Disable/Clear
> 
> +  BOOLEAN               InterruptRemappingSupport;         ///< This field is used to
> indicate Interrupt Remapping supported or not
> 
> +  UINT32                DmaBufferBase;                     ///< Iommu PEI DMA buffer
> base in low memory region, in Mbytes units
> 
> +} VTD_DATA_HOB;
> 
> +
> 
> +#pragma pack (pop)
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/PeiDxeSmmVtdInfoLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/PeiDxeSmmVtdInfoLib.inf
> new file mode 100644
> index 0000000000..c7c5e56b84
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/PeiDxeSmmVtdInfoLib.inf
> @@ -0,0 +1,45 @@
> +## @file
> 
> +# VTD Common Library.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmVtdInfoLib
> 
> +FILE_GUID = A1480873-3FDA-4E90-B450-743D8031F9DE
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = VtdInfoLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +HobLib
> 
> +VtdInfoLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +VtdInfoLib.c
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.VtdEngine1BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine2BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine3BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine4BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine5BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine6BaseAddeess
> 
> +gSiPkgTokenSpaceGuid.VtdEngine7BaseAddeess
> 
> +
> 
> +[FixedPcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/VtdInfoLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/VtdInfoLib.c
> new file mode 100644
> index 0000000000..e4f08592cc
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/Library/PeiDxeSmmVtdInfoLi
> b/VtdInfoLib.c
> @@ -0,0 +1,86 @@
> +/** @file
> 
> +  VTD Info library.
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Ppi/SiPolicy.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/VtdInfoLib.h>
> 
> +#include <Register/VtdRegs.h>
> 
> +
> 
> +/**
> 
> +  Get VTD Engine Base Address from PCD value
> 
> +
> 
> +  @param[in]  VtdEngineNumber        - Engine number for which VTD Base
> Adderess is required.
> 
> +
> 
> +  @retval   VTD Engine Base Address
> 
> +**/
> 
> +UINT32
> 
> +GetVtdBaseAddress (
> 
> +  IN UINT8        VtdEngineNumber
> 
> +  )
> 
> +{
> 
> +  switch (VtdEngineNumber) {
> 
> +    case 0:
> 
> +      return PcdGet32(VtdEngine1BaseAddeess);
> 
> +      break;
> 
> +    case 2:
> 
> +      return PcdGet32(VtdEngine3BaseAddeess);
> 
> +      break;
> 
> +    default:
> 
> +      return 0x0;
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Read VTD Engine Base Address from VTD BAR Offsets.
> 
> +
> 
> +  @param[in]  VtdEngineNumber        - Engine number for which VTD Base
> Adderess is required.
> 
> +
> 
> +  @retval   VTD Engine Base Address
> 
> +**/
> 
> +UINT32
> 
> +ReadVtdBaseAddress (
> 
> +  IN UINT8        VtdEngineNumber
> 
> +  )
> 
> +{
> 
> +  UINT64              McD0BaseAddress;
> 
> +  UINTN               MchBar;
> 
> +
> 
> +  McD0BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> SA_MC_BUS, 0, 0, 0);
> 
> +  MchBar          = PciSegmentRead32 (McD0BaseAddress + R_SA_MCHBAR) &
> (~BIT0);
> 
> +
> 
> +  switch (VtdEngineNumber) {
> 
> +    case 0:
> 
> +      return (MmioRead32 (MchBar + R_MCHBAR_VTD1_OFFSET) & (~BIT0));
> 
> +      break;
> 
> +    case 2:
> 
> +      return (MmioRead32 (MchBar + R_MCHBAR_VTD3_OFFSET) & (~BIT0));
> 
> +      break;
> 
> +    default:
> 
> +      return 0x0;
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  GetMaxVtdEngineNumber: Get Maximum Vtd Engine Number
> 
> +
> 
> +  @retval Vtd Engine Number
> 
> +**/
> 
> +UINT8
> 
> +GetMaxVtdEngineNumber(
> 
> +  VOID
> 
> +)
> 
> +{
> 
> +  return (UINT8)VTD_ENGINE_NUMBER;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.c
> new file mode 100644
> index 0000000000..faac07c45d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.c
> @@ -0,0 +1,684 @@
> +/** @file
> 
> +  DXE Library for VTD ACPI table initialization.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DxeVtdInitLib.h>
> 
> +#include <Library/DxeVtdPolicyLib.h>
> 
> +#include <Library/VtdInitFruLib.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +///
> 
> +/// Global Variables
> 
> +///
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED VTD_DATA_HOB     *mVtdDataHob;
> 
> +
> 
> +BOOLEAN mInterruptRemappingSupport;
> 
> +
> 
> +/**
> 
> +  Get the corresponding device Enable/Disable bit according DevNum and
> FunNum
> 
> +
> 
> +  @param[in] DevNum  - Device Number
> 
> +  @param[in] FunNum  - Function Number
> 
> +
> 
> +  @retval If the device is found, return disable/Enable bit in FD/Deven
> reigster
> 
> +  @retval If not found return 0xFF
> 
> +**/
> 
> +UINT16
> 
> +GetFunDisableBit (
> 
> +  UINT8 DevNum,
> 
> +  UINT8 FunNum
> 
> +  )
> 
> +{
> 
> +  UINTN Index;
> 
> +
> 
> +  for (Index = 0; Index < mDevEnMapSize; Index++) {
> 
> +    if (mDevEnMap[Index][0] == ((DevNum << 0x08) | FunNum)) {
> 
> +      return mDevEnMap[Index][1];
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return 0xFF;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the DRHD structure
> 
> +
> 
> +  @param[in, out] DrhdEnginePtr       - A pointer to DRHD structure
> 
> +**/
> 
> +VOID
> 
> +UpdateDrhd (
> 
> +  IN OUT VOID *DrhdEnginePtr
> 
> +  )
> 
> +{
> 
> +  UINT16                        Length;
> 
> +  UINT16                        DisableBit;
> 
> +  BOOLEAN                       NeedRemove;
> 
> +  EFI_ACPI_DRHD_ENGINE1_STRUCT  *DrhdEngine;
> 
> +
> 
> +  //
> 
> +  // Convert DrhdEnginePtr to EFI_ACPI_DRHD_ENGINE1_STRUCT Pointer
> 
> +  //
> 
> +  DrhdEngine      = (EFI_ACPI_DRHD_ENGINE1_STRUCT *) DrhdEnginePtr;
> 
> +  Length          = DrhdEngine->DrhdHeader.Header.Length;
> 
> +  DisableBit = GetFunDisableBit (
> 
> +                 DrhdEngine->DeviceScope[0].PciPath.Device,
> 
> +                 DrhdEngine->DeviceScope[0].PciPath.Function
> 
> +                 );
> 
> +  NeedRemove = FALSE;
> 
> +
> 
> +  if ((DisableBit == 0xFF) ||
> 
> +      (DrhdEngine->DrhdHeader.RegisterBaseAddress == 0) ||
> 
> +      ((DisableBit == 0x80) &&
> 
> +       (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0,
> DrhdEngine->DeviceScope[0].PciPath.Device, DrhdEngine-
> >DeviceScope[0].PciPath.Function, 0x00)) == 0xFFFFFFFF))
> 
> +      ) {
> 
> +    NeedRemove = TRUE;
> 
> +  }
> 
> +  if ((DrhdEngine->DeviceScope[0].PciPath.Device == IGD_DEV_NUM) &&
> (DrhdEngine->DeviceScope[0].PciPath.Function == IGD_FUN_NUM) &&
> 
> +      (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0,
> DrhdEngine->DeviceScope[0].PciPath.Device, DrhdEngine-
> >DeviceScope[0].PciPath.Function, 0x00)) != 0xFFFFFFFF)) {
> 
> +    NeedRemove = FALSE;
> 
> +  }
> 
> +  if (NeedRemove) {
> 
> +    Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
> 
> +  }
> 
> +  ///
> 
> +  /// If no devicescope is left, we set the structure length as 0x00
> 
> +  ///
> 
> +  if ((Length > EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) || (DrhdEngine-
> >DrhdHeader.Flags == 0x01)) {
> 
> +    DrhdEngine->DrhdHeader.Header.Length = Length;
> 
> +  } else {
> 
> +    DrhdEngine->DrhdHeader.Header.Length = 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get IOAPIC ID from LPC
> 
> +
> 
> +  @retval APIC ID
> 
> +**/
> 
> +UINT8
> 
> +GetIoApicId (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                IoApicAddress;
> 
> +  UINT32                IoApicId;
> 
> +
> 
> +  IoApicAddress = PcdGet32 (PcdSiIoApicBaseAddress);
> 
> +  ///
> 
> +  /// Get current IO APIC ID
> 
> +  ///
> 
> +  MmioWrite8 ((UINTN) (IoApicAddress +
> R_IO_APIC_MEM_INDEX_OFFSET), 0);
> 
> +  IoApicId = MmioRead32 ((UINTN) (IoApicAddress +
> R_IO_APIC_MEM_DATA_OFFSET)) >> 24;
> 
> +
> 
> +  return (UINT8) IoApicId;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the second DRHD structure
> 
> +
> 
> +  @param[in, out] DrhdEnginePtr       - A pointer to DRHD structure
> 
> +**/
> 
> +VOID
> 
> +UpdateDrhd2 (
> 
> +  IN OUT VOID *DrhdEnginePtr
> 
> +  )
> 
> +{
> 
> +  UINT16                        Length;
> 
> +  UINTN                         DeviceScopeNum;
> 
> +  UINTN                         ValidDeviceScopeNum;
> 
> +  UINT16                        Index;
> 
> +  UINT8                         Bus;
> 
> +  UINT8                         Path[2];
> 
> +  BOOLEAN                       NeedRemove;
> 
> +  EFI_ACPI_DRHD_ENGINE3_STRUCT  *DrhdEngine;
> 
> +  VOID                          *HobPtr;
> 
> +  PCH_INFO_HOB                  *PchInfoHob;
> 
> +
> 
> +  ///
> 
> +  /// Convert DrhdEnginePtr to EFI_ACPI_DRHD_ENGINE3_STRUCT Pointer
> 
> +  ///
> 
> +  DrhdEngine      = (EFI_ACPI_DRHD_ENGINE3_STRUCT *) DrhdEnginePtr;
> 
> +
> 
> +  Length          = DrhdEngine->DrhdHeader.Header.Length;
> 
> +  DeviceScopeNum  = (DrhdEngine->DrhdHeader.Header.Length -
> EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) / sizeof
> (EFI_ACPI_DEV_SCOPE_STRUCTURE);
> 
> +  Bus             = 0;
> 
> +  ValidDeviceScopeNum = 0;
> 
> +  Path[0]         = 0;
> 
> +  Path[1]         = 0;
> 
> +
> 
> +  HobPtr = GetFirstGuidHob (&gPchInfoHobGuid);
> 
> +  ASSERT (HobPtr != NULL);
> 
> +  if (HobPtr == NULL) {
> 
> +    return;
> 
> +  }
> 
> +  PchInfoHob = (PCH_INFO_HOB *) GET_GUID_HOB_DATA (HobPtr);
> 
> +  ASSERT (PchInfoHob != NULL);
> 
> +  if (PchInfoHob == NULL) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < DeviceScopeNum; Index++) {
> 
> +    NeedRemove = FALSE;
> 
> +    /**
> 
> +      For HPET and APIC, update device scope if Interrupt remapping is
> supported. remove device scope
> 
> +      if interrupt remapping is not supported.
> 
> +      - Index = 0 - IOAPIC
> 
> +      - Index = 1 - HPET
> 
> +    **/
> 
> +    if (mInterruptRemappingSupport) {
> 
> +      if (Index == 0) {
> 
> +        ///
> 
> +        /// Update source id for IoApic's device scope entry
> 
> +        ///
> 
> +        Bus = (UINT8) PchInfoHob->IoApicBusNum;
> 
> +        Path[0] = (UINT8) PchInfoHob->IoApicDevNum;
> 
> +        Path[1] = (UINT8) PchInfoHob->IoApicFuncNum;
> 
> +        DrhdEngine-
> >DeviceScope[Index].DeviceScopeStructureHeader.StartBusNumber = Bus;
> 
> +        DrhdEngine->DeviceScope[Index].PciPath.Device = Path[0];
> 
> +        DrhdEngine->DeviceScope[Index].PciPath.Function = Path[1];
> 
> +        //
> 
> +        // Update APIC ID
> 
> +        //
> 
> +        DrhdEngine-
> >DeviceScope[Index].DeviceScopeStructureHeader.EnumerationId =
> GetIoApicId ();
> 
> +      }
> 
> +      if (Index == 1) {
> 
> +        ///
> 
> +        /// Update source id for HPET's device scope entry
> 
> +        ///
> 
> +        Bus     = (UINT8) PchInfoHob->HpetBusNum;
> 
> +        Path[0] = (UINT8) PchInfoHob->HpetDevNum;
> 
> +        Path[1] = (UINT8) PchInfoHob->HpetFuncNum;
> 
> +        DrhdEngine-
> >DeviceScope[Index].DeviceScopeStructureHeader.StartBusNumber = Bus;
> 
> +        DrhdEngine->DeviceScope[Index].PciPath.Device = Path[0];
> 
> +        DrhdEngine->DeviceScope[Index].PciPath.Function = Path[1];
> 
> +      }
> 
> +    } else {
> 
> +      if ((Index == 0) || (Index == 1)) {
> 
> +        NeedRemove = TRUE;
> 
> +      }
> 
> +    }
> 
> +
> 
> +    CopyMem (
> 
> +      &DrhdEngine->DeviceScope[ValidDeviceScopeNum],
> 
> +      &DrhdEngine->DeviceScope[Index],
> 
> +      sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE)
> 
> +      );
> 
> +    if (NeedRemove) {
> 
> +      Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
> 
> +    } else {
> 
> +      ValidDeviceScopeNum++;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// If no devicescope is left, we set the structure length as 0x00
> 
> +  ///
> 
> +  if ((Length > EFI_ACPI_DRHD_ENGINE_HEADER_LENGTH) || (DrhdEngine-
> >DrhdHeader.Flags == 0x01)) {
> 
> +    DrhdEngine->DrhdHeader.Header.Length = Length;
> 
> +  } else {
> 
> +    DrhdEngine->DrhdHeader.Header.Length = 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the RMRR structure
> 
> +
> 
> +  @param[in, out] RmrrPtr             - A pointer to RMRR structure
> 
> +**/
> 
> +VOID
> 
> +UpdateRmrr (
> 
> +  IN OUT VOID *RmrrPtr
> 
> +  )
> 
> +{
> 
> +  UINT16                  Length;
> 
> +  UINT16                  DisableBit;
> 
> +  UINTN                   DeviceScopeNum;
> 
> +  UINTN                   ValidDeviceScopeNum;
> 
> +  UINTN                   Index;
> 
> +  BOOLEAN                 NeedRemove;
> 
> +  EFI_ACPI_RMRR_USB_STRUC *Rmrr;
> 
> +
> 
> +  ///
> 
> +  /// To make sure all devicescope can be checked,
> 
> +  /// we convert the RmrrPtr to EFI_ACPI_RMRR_USB_STRUC pointer
> 
> +  ///
> 
> +  Rmrr                = (EFI_ACPI_RMRR_USB_STRUC *) RmrrPtr;
> 
> +
> 
> +  Length              = Rmrr->RmrrHeader.Header.Length;
> 
> +  ValidDeviceScopeNum = 0;
> 
> +  DeviceScopeNum      = (Rmrr->RmrrHeader.Header.Length -
> EFI_ACPI_RMRR_HEADER_LENGTH) / sizeof
> (EFI_ACPI_DEV_SCOPE_STRUCTURE);
> 
> +  for (Index = 0; Index < DeviceScopeNum; Index++) {
> 
> +    DisableBit = GetFunDisableBit (
> 
> +                   Rmrr->DeviceScope[Index].PciPath.Device,
> 
> +                   Rmrr->DeviceScope[Index].PciPath.Function
> 
> +                   );
> 
> +    NeedRemove = FALSE;
> 
> +    if ((DisableBit == 0xFF) ||
> 
> +        ((DisableBit == 0x80) &&
> 
> +         (PciSegmentRead32 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, 0,
> Rmrr->DeviceScope[Index].PciPath.Device, Rmrr-
> >DeviceScope[Index].PciPath.Function, 0x00)) == 0xFFFFFFFF))
> 
> +        ) {
> 
> +      NeedRemove = TRUE;
> 
> +    } else if (DisableBit == 0x8F) {
> 
> +      DEBUG ((DEBUG_ERROR, "Rmrr-
> >RmrrHeader.ReservedMemoryRegionBaseAddress %x\n", Rmrr-
> >RmrrHeader.ReservedMemoryRegionBaseAddress));
> 
> +
> 
> +      if (Rmrr->RmrrHeader.ReservedMemoryRegionBaseAddress != 0) {
> 
> +        DEBUG ((DEBUG_ERROR, "NeedRemove = FALSE\n"));
> 
> +        NeedRemove = FALSE;
> 
> +      } else {
> 
> +        DEBUG ((DEBUG_ERROR, "NeedRemove = TRUE\n"));
> 
> +        NeedRemove = TRUE;
> 
> +      }
> 
> +    }
> 
> +    CopyMem (
> 
> +      &Rmrr->DeviceScope[ValidDeviceScopeNum],
> 
> +      &Rmrr->DeviceScope[Index],
> 
> +      sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE)
> 
> +      );
> 
> +
> 
> +    if (Rmrr->RmrrHeader.ReservedMemoryRegionLimitAddress == 0x0) {
> 
> +      NeedRemove = TRUE;
> 
> +    }
> 
> +
> 
> +    if (NeedRemove) {
> 
> +      Length -= sizeof (EFI_ACPI_DEV_SCOPE_STRUCTURE);
> 
> +    } else {
> 
> +      ValidDeviceScopeNum++;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// If No deviceScope is left, set length as 0x00
> 
> +  ///
> 
> +  if (Length > EFI_ACPI_RMRR_HEADER_LENGTH) {
> 
> +    Rmrr->RmrrHeader.Header.Length = Length;
> 
> +  } else {
> 
> +    Rmrr->RmrrHeader.Header.Length = 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the DMAR table
> 
> +
> 
> +  @param[in, out] TableHeader         - The table to be set
> 
> +  @param[in, out] Version             - Version to publish
> 
> +**/
> 
> +VOID
> 
> +DmarTableUpdate (
> 
> +  IN OUT   EFI_ACPI_DESCRIPTION_HEADER       *TableHeader,
> 
> +  IN OUT   EFI_ACPI_TABLE_VERSION            *Version
> 
> +  )
> 
> +{
> 
> +  EFI_ACPI_DMAR_TABLE *DmarTable;
> 
> +  EFI_ACPI_DMAR_TABLE TempDmarTable;
> 
> +  UINTN               Offset;
> 
> +  UINTN               StructureLen;
> 
> +  UINT64              McD0BaseAddress;
> 
> +  UINT32              GttMmAdr;
> 
> +  UINT64              McD2BaseAddress;
> 
> +  UINT16              IgdMode;
> 
> +  UINT16              GttMode;
> 
> +  UINT32              IgdMemSize;
> 
> +  UINT32              GttMemSize;
> 
> +  EFI_STATUS          Status;
> 
> +  VTD_DXE_CONFIG      *VtdDxeConfig;
> 
> +  SA_POLICY_PROTOCOL  *SaPolicy;
> 
> +
> 
> +
> 
> +  IgdMemSize  = 0;
> 
> +  GttMemSize  = 0;
> 
> +  DmarTable   = (EFI_ACPI_DMAR_TABLE *) TableHeader;
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **)
> &SaPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gVtdDxeConfigGuid, (VOID
> *)&VtdDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Set INTR_REMAP bit (BIT 0) if interrupt remapping is supported
> 
> +  ///
> 
> +  if (mInterruptRemappingSupport) {
> 
> +    DmarTable->DmarHeader.Flags |= BIT0;
> 
> +  }
> 
> +
> 
> +  if (mVtdDataHob->X2ApicOptOut == 1) {
> 
> +    DmarTable->DmarHeader.Flags |= BIT1;
> 
> +  } else {
> 
> +    DmarTable->DmarHeader.Flags &= 0xFD;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Set DMA_CONTROL_GUARANTEE bit (BIT 2) if Dma Control Guarantee
> is supported
> 
> +  ///
> 
> +  if (mVtdDataHob->DmaControlGuarantee == 1) {
> 
> +    DmarTable->DmarHeader.Flags |= BIT2;
> 
> +  }
> 
> +  ///
> 
> +  /// Get OemId
> 
> +  ///
> 
> +  CopyMem (DmarTable->DmarHeader.Header.OemId, PcdGetPtr
> (PcdAcpiDefaultOemId), sizeof (DmarTable->DmarHeader.Header.OemId));
> 
> +  DmarTable->DmarHeader.Header.OemTableId      = PcdGet64
> (PcdAcpiDefaultOemTableId);
> 
> +  DmarTable->DmarHeader.Header.OemRevision     = PcdGet32
> (PcdAcpiDefaultOemRevision);
> 
> +  DmarTable->DmarHeader.Header.CreatorId       = PcdGet32
> (PcdAcpiDefaultCreatorId);
> 
> +  DmarTable->DmarHeader.Header.CreatorRevision = PcdGet32
> (PcdAcpiDefaultCreatorRevision);
> 
> +
> 
> +  ///
> 
> +  /// Calculate IGD memsize
> 
> +  ///
> 
> +  McD0BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> SA_MC_BUS, 0, 0, 0);
> 
> +  IgdMode = ((PciSegmentRead16 (McD0BaseAddress + R_SA_GGC) &
> B_SA_GGC_GMS_MASK) >> N_SA_GGC_GMS_OFFSET) & 0xFF;
> 
> +  if (IgdMode < 0xF0) {
> 
> +    IgdMemSize = IgdMode * 32 * (1024) * (1024);
> 
> +  } else {
> 
> +    IgdMemSize = 4 * (IgdMode - 0xF0 + 1) * (1024) * (1024);
> 
> +  }
> 
> +  ///
> 
> +  /// Calculate GTT mem size
> 
> +  ///
> 
> +  GttMemSize = 0;
> 
> +  GttMode = (PciSegmentRead16 (McD0BaseAddress + R_SA_GGC) &
> B_SA_GGC_GGMS_MASK) >> N_SA_GGC_GGMS_OFFSET;
> 
> +  if (GttMode <= V_SA_GGC_GGMS_8MB) {
> 
> +    GttMemSize = (1 << GttMode) * (1024) * (1024);
> 
> +  }
> 
> +
> 
> +  McD2BaseAddress = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
> 
> +  GttMmAdr = (PciSegmentRead32 (McD2BaseAddress +
> R_SA_IGD_GTTMMADR)) & 0xFFFFFFF0;
> 
> +
> 
> +  DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress
> = (PciSegmentRead32 (McD0BaseAddress + R_SA_BGSM) & ~(0x01));
> 
> +  DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionLimitAddress
> = DmarTable->RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress +
> IgdMemSize + GttMemSize - 1;
> 
> +  DEBUG ((DEBUG_INFO, "RMRR Base  address IGD %016lX\n", DmarTable-
> >RmrrIgd.RmrrHeader.ReservedMemoryRegionBaseAddress));
> 
> +  DEBUG ((DEBUG_INFO, "RMRR Limit address IGD %016lX\n", DmarTable-
> >RmrrIgd.RmrrHeader.ReservedMemoryRegionLimitAddress));
> 
> +
> 
> +  ///
> 
> +  /// Update DRHD structures of DmarTable
> 
> +  ///
> 
> +  DmarTable->DrhdEngine1.DrhdHeader.RegisterBaseAddress =
> ReadVtdBaseAddress(0);
> 
> +  DmarTable->DrhdEngine3.DrhdHeader.RegisterBaseAddress =
> ReadVtdBaseAddress (2);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "VTD base address 1 = %x\n", DmarTable-
> >DrhdEngine1.DrhdHeader.RegisterBaseAddress));
> 
> +  DEBUG ((DEBUG_INFO, "VTD base address 3 = %x\n", DmarTable-
> >DrhdEngine3.DrhdHeader.RegisterBaseAddress));
> 
> +  ///
> 
> +  /// copy DmarTable to TempDmarTable to be processed
> 
> +  ///
> 
> +  CopyMem (&TempDmarTable, DmarTable, sizeof
> (EFI_ACPI_DMAR_TABLE));
> 
> +
> 
> +  ///
> 
> +  /// Update DRHD structures of temp DMAR table
> 
> +  ///
> 
> +  UpdateDrhd (&TempDmarTable.DrhdEngine1);
> 
> +  UpdateDrhd2 (&TempDmarTable.DrhdEngine3);
> 
> +
> 
> +  ///
> 
> +  /// Remove unused device scope or entire DRHD structures
> 
> +  ///
> 
> +  Offset = (UINTN) (&TempDmarTable.DrhdEngine1);
> 
> +  if (TempDmarTable.DrhdEngine1.DrhdHeader.Header.Length != 0) {
> 
> +    Offset += TempDmarTable.DrhdEngine1.DrhdHeader.Header.Length;
> 
> +  }
> 
> +  if (TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length != 0) {
> 
> +    StructureLen =
> TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length;
> 
> +    CopyMem ((VOID *) Offset, (VOID *) &TempDmarTable.DrhdEngine3,
> TempDmarTable.DrhdEngine3.DrhdHeader.Header.Length);
> 
> +    Offset += StructureLen;
> 
> +  }
> 
> +  ///
> 
> +  /// Remove unused device scope or entire RMRR structures
> 
> +  ///
> 
> +  if (TempDmarTable.RmrrIgd.RmrrHeader.Header.Length != 0) {
> 
> +    StructureLen = TempDmarTable.RmrrIgd.RmrrHeader.Header.Length;
> 
> +    CopyMem ((VOID *) Offset, (VOID *) &TempDmarTable.RmrrIgd,
> TempDmarTable.RmrrIgd.RmrrHeader.Header.Length);
> 
> +    Offset += StructureLen;
> 
> +  }
> 
> +  Offset = Offset - (UINTN) &TempDmarTable;
> 
> +  ///
> 
> +  /// Re-calculate DMAR table check sum
> 
> +  ///
> 
> +  TempDmarTable.DmarHeader.Header.Checksum = (UINT8)
> (TempDmarTable.DmarHeader.Header.Checksum +
> TempDmarTable.DmarHeader.Header.Length - Offset);
> 
> +  ///
> 
> +  /// Set DMAR table length
> 
> +  ///
> 
> +  TempDmarTable.DmarHeader.Header.Length = (UINT32) Offset;
> 
> +  ///
> 
> +  /// Replace DMAR table with rebuilt table TempDmarTable
> 
> +  ///
> 
> +  CopyMem ((VOID *) DmarTable, (VOID *) &TempDmarTable,
> TempDmarTable.DmarHeader.Header.Length);
> 
> +}
> 
> +
> 
> +/**
> 
> +  EndOfPcieEnumration routine for update DMAR
> 
> +**/
> 
> +VOID
> 
> +UpdateDmarEndOfPcieEnum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                      Status;
> 
> +  EFI_HANDLE                      *HandleBuffer;
> 
> +  UINTN                           NumberOfHandles;
> 
> +  EFI_FV_FILETYPE                 FileType;
> 
> +  UINT32                          FvStatus;
> 
> +  EFI_FV_FILE_ATTRIBUTES          Attributes;
> 
> +  UINTN                           Size;
> 
> +  UINTN                           i;
> 
> +  INTN                            Instance;
> 
> +  EFI_ACPI_TABLE_VERSION          Version;
> 
> +  EFI_ACPI_COMMON_HEADER          *CurrentTable;
> 
> +  UINTN                           AcpiTableHandle;
> 
> +  EFI_FIRMWARE_VOLUME2_PROTOCOL   *FwVol;
> 
> +  EFI_ACPI_TABLE_PROTOCOL         *AcpiTable;
> 
> +  EFI_ACPI_DESCRIPTION_HEADER     *VtdAcpiTable;
> 
> +  STATIC BOOLEAN                  Triggered = FALSE;
> 
> +
> 
> +
> 
> +  if (Triggered) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  Triggered     = TRUE;
> 
> +
> 
> +  FwVol         = NULL;
> 
> +  AcpiTable     = NULL;
> 
> +  VtdAcpiTable  = NULL;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "UpdateDmarEndOfPcieEnum \n"));
> 
> +
> 
> +
> 
> +  ///
> 
> +  /// Fix DMAR Table always created, skip install when disabled
> 
> +  ///
> 
> +  if ((mVtdDataHob->VtdDisable == TRUE) || (PciSegmentRead32
> (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS, 0, 0,
> R_SA_MC_CAPID0_A_OFFSET)) & BIT23)) {
> 
> +    DEBUG ((DEBUG_INFO, "Vtd Disabled, skip DMAR Table install\n"));
> 
> +    return;
> 
> +  }
> 
> +
> 
> +
> 
> +  ///
> 
> +  /// Locate ACPI support protocol
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID
> **) &AcpiTable);
> 
> +
> 
> +  ///
> 
> +  /// Locate protocol.
> 
> +  /// There is little chance we can't find an FV protocol
> 
> +  ///
> 
> +  Status = gBS->LocateHandleBuffer (
> 
> +                  ByProtocol,
> 
> +                  &gEfiFirmwareVolume2ProtocolGuid,
> 
> +                  NULL,
> 
> +                  &NumberOfHandles,
> 
> +                  &HandleBuffer
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Looking for FV with ACPI storage file
> 
> +  ///
> 
> +  for (i = 0; i < NumberOfHandles; i++) {
> 
> +    ///
> 
> +    /// Get the protocol on this handle
> 
> +    /// This should not fail because of LocateHandleBuffer
> 
> +    ///
> 
> +    Status = gBS->HandleProtocol (
> 
> +                    HandleBuffer[i],
> 
> +                    &gEfiFirmwareVolume2ProtocolGuid,
> 
> +                    (VOID **) &FwVol
> 
> +                    );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +    ///
> 
> +    /// See if it has the ACPI storage file
> 
> +    ///
> 
> +    Size      = 0;
> 
> +    FvStatus  = 0;
> 
> +    Status = FwVol->ReadFile (
> 
> +                      FwVol,
> 
> +                      &gSaAcpiTableStorageGuid,
> 
> +                      NULL,
> 
> +                      &Size,
> 
> +                      &FileType,
> 
> +                      &Attributes,
> 
> +                      &FvStatus
> 
> +                      );
> 
> +
> 
> +    ///
> 
> +    /// If we found it, then we are done
> 
> +    ///
> 
> +    if (Status == EFI_SUCCESS) {
> 
> +      break;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// Our exit status is determined by the success of the previous operations
> 
> +  /// If the protocol was found, Instance already points to it.
> 
> +  ///
> 
> +  ///
> 
> +  /// Free any allocated buffers
> 
> +  ///
> 
> +  FreePool (HandleBuffer);
> 
> +
> 
> +  ///
> 
> +  /// Sanity check that we found our data file
> 
> +  ///
> 
> +  ASSERT (FwVol);
> 
> +  if (FwVol == NULL) {
> 
> +    return;
> 
> +  }
> 
> +  ///
> 
> +  /// By default, a table belongs in all ACPI table versions published.
> 
> +  ///
> 
> +  Version = EFI_ACPI_TABLE_VERSION_1_0B |
> EFI_ACPI_TABLE_VERSION_2_0 | EFI_ACPI_TABLE_VERSION_3_0;
> 
> +
> 
> +  ///
> 
> +  /// Read tables from the storage file.
> 
> +  ///
> 
> +  Instance      = 0;
> 
> +  CurrentTable  = NULL;
> 
> +
> 
> +  while (Status == EFI_SUCCESS) {
> 
> +    Status = FwVol->ReadSection (
> 
> +                      FwVol,
> 
> +                      &gSaAcpiTableStorageGuid,
> 
> +                      EFI_SECTION_RAW,
> 
> +                      Instance,
> 
> +                      (VOID **) &CurrentTable,
> 
> +                      &Size,
> 
> +                      &FvStatus
> 
> +                      );
> 
> +
> 
> +    if (!EFI_ERROR (Status)) {
> 
> +      ///
> 
> +      /// Check the Signature ID to modify the table
> 
> +      ///
> 
> +      if ((CurrentTable != NULL) && ((EFI_ACPI_DESCRIPTION_HEADER *)
> CurrentTable)->Signature == EFI_ACPI_VTD_DMAR_TABLE_SIGNATURE) {
> 
> +        VtdAcpiTable = (EFI_ACPI_DESCRIPTION_HEADER *) CurrentTable;
> 
> +        DmarTableUpdate (VtdAcpiTable, &Version);
> 
> +        break;
> 
> +      }
> 
> +      ///
> 
> +      /// Increment the instance
> 
> +      ///
> 
> +      Instance++;
> 
> +      if (CurrentTable != NULL) {
> 
> +        gBS->FreePool (CurrentTable);
> 
> +        CurrentTable = NULL;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// Update the VTD table in the ACPI tables.
> 
> +  ///
> 
> +  AcpiTableHandle = 0;
> 
> +  if (VtdAcpiTable != NULL) {
> 
> +    Status = AcpiTable->InstallAcpiTable (
> 
> +                          AcpiTable,
> 
> +                          VtdAcpiTable,
> 
> +                          VtdAcpiTable->Length,
> 
> +                          &AcpiTableHandle
> 
> +                          );
> 
> +    FreePool (VtdAcpiTable);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Locate the VT-d ACPI tables data file and read ACPI SSDT tables.
> 
> +  Publish the appropriate SSDT based on current configuration and
> capabilities.
> 
> +
> 
> +  @param[in] SaPolicy     -  SA DXE Policy protocol
> 
> +
> 
> +  @retval EFI_SUCCESS     - Vtd initialization complete
> 
> +  @exception EFI_UNSUPPORTED - Vtd is not enabled by policy
> 
> +**/
> 
> +EFI_STATUS
> 
> +VtdInit (
> 
> +  IN  SA_POLICY_PROTOCOL    *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                      Status;
> 
> +  UINT64                          McD0BaseAddress;
> 
> +  UINT64                          McD2BaseAddress;
> 
> +  SYSTEM_AGENT_NVS_AREA_PROTOCOL  *SaNvsAreaProtocol;
> 
> +  UINT8                           Index;
> 
> +
> 
> +  mInterruptRemappingSupport  = FALSE;
> 
> +  mVtdDataHob = NULL;
> 
> +  mVtdDataHob = GetFirstGuidHob(&gVtdDataHobGuid);
> 
> +  if (mVtdDataHob != NULL) {
> 
> +    mInterruptRemappingSupport = mVtdDataHob-
> >InterruptRemappingSupport;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  ///  Locate the SA Global NVS Protocol.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (
> 
> +                  &gSaNvsAreaProtocolGuid,
> 
> +                  NULL,
> 
> +                  (VOID **) &SaNvsAreaProtocol
> 
> +                  );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  McD0BaseAddress  = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> SA_MC_BUS, 0, 0, 0);
> 
> +  McD2BaseAddress  = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM, 0);
> 
> +
> 
> +  if (mVtdDataHob != NULL) {
> 
> +    SaNvsAreaProtocol->Area->VtdDisable = mVtdDataHob->VtdDisable;
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < VTD_ENGINE_NUMBER; Index++) {
> 
> +    SaNvsAreaProtocol->Area->VtdBaseAddress[Index] =
> ReadVtdBaseAddress (Index);
> 
> +  }
> 
> +  SaNvsAreaProtocol->Area->VtdEngine1Vid =
> PciSegmentRead16(McD2BaseAddress + PCI_VENDOR_ID_OFFSET);
> 
> +
> 
> +  if (mVtdDataHob != NULL) {
> 
> +    if ((mVtdDataHob->VtdDisable) || (PciSegmentRead32
> (McD0BaseAddress + R_SA_MC_CAPID0_A_OFFSET) & BIT23)) {
> 
> +      DEBUG ((DEBUG_WARN, "VTd disabled or no capability!\n"));
> 
> +      return EFI_UNSUPPORTED;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// Check SA supports VTD and VTD is enabled in setup menu
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "VTd enabled\n"));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.inf
> new file mode 100644
> index 0000000000..9797c31cc6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdInitLib/
> DxeVtdInitLib.inf
> @@ -0,0 +1,71 @@
> +## @file
> 
> +# Component description file for the Dxe VTD Init library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeVtdInitLib
> 
> +FILE_GUID = 9BD11E68-923C-424C-A278-716084B4C931
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +LIBRARY_CLASS = DxeVtdInitLib
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +HobLib
> 
> +IoLib
> 
> +PciSegmentLib
> 
> +BaseMemoryLib
> 
> +MemoryAllocationLib
> 
> +MmPciLib
> 
> +VtdInfoLib
> 
> +PchInfoLib
> 
> +PchCycleDecodingLib
> 
> +SaPlatformLib
> 
> +DxeVtdInitFruLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeVtdInitLib.c
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemId
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemTableId
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultOemRevision
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorId
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision
> 
> +
> 
> +[FixedPcd]
> 
> +
> 
> +[Guids]
> 
> +gPchInfoHobGuid          ## CONSUMES
> 
> +gSaAcpiTableStorageGuid
> 
> +gVtdDataHobGuid
> 
> +gVtdDxeConfigGuid
> 
> +
> 
> +[Protocols]
> 
> +gSaPolicyProtocolGuid                  ## CONSUMES
> 
> +gSaNvsAreaProtocolGuid                 ## CONSUMES
> 
> +gEfiFirmwareVolume2ProtocolGuid
> 
> +gEfiAcpiTableProtocolGuid
> 
> +
> 
> +[Depex]
> 
> +gEfiAcpiTableProtocolGuid AND
> 
> +gEfiFirmwareVolume2ProtocolGuid AND
> 
> +gSaPolicyProtocolGuid AND
> 
> +gEfiPciRootBridgeIoProtocolGuid AND
> 
> +gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure
> that PCI MMIO resource has been prepared and available for this driver to
> allocate.
> 
> +gEfiHiiDatabaseProtocolGuid
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLi
> b/DxeVtdPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyL
> ib/DxeVtdPolicyLib.c
> new file mode 100644
> index 0000000000..168de0c0a9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyL
> ib/DxeVtdPolicyLib.c
> @@ -0,0 +1,90 @@
> +/** @file
> 
> +  This file provides services for DXE VTD policy default initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DxeVtdPolicyLib.h>
> 
> +
> 
> +/**
> 
> +  This function prints the DXE phase VTD policy.
> 
> +
> 
> +  @param[in] SaPolicy - Instance of SA_POLICY_PROTOCOL
> 
> +**/
> 
> +VOID
> 
> +VtdPrintPolicyDxe (
> 
> +  IN  SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                  Status;
> 
> +  VTD_DXE_CONFIG             *VtdDxeConfig;
> 
> +
> 
> +  //
> 
> +  // Get requisite IP Config Blocks which needs to be used here
> 
> +  //
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gVtdDxeConfigGuid, (VOID
> *)&VtdDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG_CODE_BEGIN ();
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ Vtd Policy (DXE) print
> BEGIN -----------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Revision : %d\n", VtdDxeConfig-
> >Header.Revision));
> 
> +  ASSERT (VtdDxeConfig->Header.Revision ==
> VTD_DXE_CONFIG_REVISION);
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ Vtd Policy (DXE) print END -
> ----------------\n"));
> 
> +  DEBUG_CODE_END ();
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function Load default Vtd DXE policy.
> 
> +
> 
> +  @param[in] ConfigBlockPointer    The pointer to add VTD config block
> 
> +**/
> 
> +VOID
> 
> +VtdLoadDefaultDxe (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  VTD_DXE_CONFIG        *VtdDxeConfig;
> 
> +
> 
> +  VtdDxeConfig = ConfigBlockPointer;
> 
> +  DEBUG ((DEBUG_INFO, "VtdDxeConfig->Header.GuidHob.Name = %g\n",
> &VtdDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "VtdDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", VtdDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +}
> 
> +
> 
> +static COMPONENT_BLOCK_ENTRY  mVtdDxeIpBlock = {
> 
> +  &gVtdDxeConfigGuid, sizeof (VTD_DXE_CONFIG),
> VTD_DXE_CONFIG_REVISION, VtdLoadDefaultDxe
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get VTD DXE config block table total size.
> 
> +
> 
> +  @retval     Size of VTD DXE config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +VtdGetConfigBlockTotalSizeDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return mVtdDxeIpBlock.Size;
> 
> +}
> 
> +
> 
> +/**
> 
> +  VtdAddConfigBlocks add VTD DXE config block.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add VTD config
> blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VtdAddConfigBlocksDxe (
> 
> +  IN VOID           *ConfigBlockTableAddress
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  Status = AddComponentConfigBlocks (ConfigBlockTableAddress,
> &mVtdDxeIpBlock, 1);
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyLi
> b/DxeVtdPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyL
> ib/DxeVtdPolicyLib.inf
> new file mode 100644
> index 0000000000..1fe288416a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/IpBlock/Vtd/LibraryPrivate/DxeVtdPolicyL
> ib/DxeVtdPolicyLib.inf
> @@ -0,0 +1,35 @@
> +## @file
> 
> +# Component description file for the DxeVtdPolicy library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeVtdPolicyLib
> 
> +FILE_GUID = 54754C6D-4883-4B67-BBBA-49D241539BE7
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeVtdPolicyLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseMemoryLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +HobLib
> 
> +SiConfigBlockLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +DxeVtdPolicyLib.c
> 
> +
> 
> +[Guids]
> 
> +gVtdDxeConfigGuid
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances
  2021-02-01  1:36 ` [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common
> library instances
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * Library/BasePciSegmentMultiSegLibPci
>   * Library/BaseSiConfigBlockLib
>   * Library/PeiDxeSmmMmPciLib
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Base
> PciSegmentMultiSegLibPci.inf |   38 +++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Base
> PciSegmentMultiSegLibPci.uni |   14 ++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/PciS
> egmentLib.c                  | 1280
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBl
> ockLib.c                   |   86
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfigBl
> ockLib.inf                 |   33 +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmm
> MmPciLib.c                         |   35 +++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSmm
> MmPciLib.inf                       |   43 ++++++++++++++++++++++++++++++
>  7 files changed, 1529 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.inf
> new file mode 100644
> index 0000000000..b04bce9cf0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.inf
> @@ -0,0 +1,38 @@
> +## @file
> 
> +# Instance of PCI Segment Library based on PCI Library.
> 
> +#
> 
> +# PCI Segment Library that layers on top of the PCI Library which only
> 
> +#  supports segment 0 and segment 1 PCI configuration access.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +  INF_VERSION                    = 0x00010005
> 
> +  BASE_NAME                      = BasePciSegmentMultiSegLibPci
> 
> +  MODULE_UNI_FILE                = BasePciSegmentMultiSegLibPci.uni
> 
> +  FILE_GUID                      = AC65B409-DF03-466e-8D2B-6FCE1079F0B2
> 
> +  MODULE_TYPE                    = BASE
> 
> +  VERSION_STRING                 = 1.0
> 
> +  LIBRARY_CLASS                  = PciSegmentLib
> 
> +
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +[Sources]
> 
> +  PciSegmentLib.c
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[LibraryClasses]
> 
> +  BaseLib
> 
> +  PciLib
> 
> +  DebugLib
> 
> +  PcdLib
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.uni
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.uni
> new file mode 100644
> index 0000000000..09bd0f5cfc
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Ba
> sePciSegmentMultiSegLibPci.uni
> @@ -0,0 +1,14 @@
> +/** @file
> 
> +  Instance of PCI Segment Library based on PCI Library.
> 
> +
> 
> +  PCI Segment Library that layers on top of the PCI Library which only
> 
> +   supports segment 0 and segment 1 PCI configuration access.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +
> 
> +#string STR_MODULE_ABSTRACT             #language en-US "Instance of PCI
> Segment Library based on PCI Library."
> 
> +
> 
> +#string STR_MODULE_DESCRIPTION          #language en-US "PCI Segment
> Library that layers on top of the PCI Library which only supports segment 0
> and segment 1 PCI configuration access."
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Pc
> iSegmentLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Pc
> iSegmentLib.c
> new file mode 100644
> index 0000000000..0d0c64be3f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BasePciSegmentMultiSegLibPci/Pc
> iSegmentLib.c
> @@ -0,0 +1,1280 @@
> +/** @file
> 
> +  PCI Segment Library that layers on top of the PCI Library which only
> 
> +   supports segment 0 and segment 1 PCI configuration access.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PciLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +
> 
> +/**
> 
> +  Assert the validity of a PCI Segment address.
> 
> +  A valid PCI Segment address should not contain 1's in bits 28..31 and 33..63
> 
> +  and the segment should be 0 or 1.
> 
> +
> 
> +  @param  A The address to validate.
> 
> +  @param  M Additional bits to assert to be zero.
> 
> +
> 
> +**/
> 
> +#define ASSERT_INVALID_PCI_SEGMENT_ADDRESS(A,M) \
> 
> +  ASSERT (((A) & (0xfffffffef0000000ULL | (M))) == 0)
> 
> +
> 
> +/**
> 
> +  Convert the PCI Segment library address to PCI library address.
> 
> +  From ICL generation support the multiple segment, and the segment
> number start from BIT28,
> 
> +  So we convert the Segment Number offset from BIT32 to BIT28
> 
> +
> 
> +  @param A The address to convert.
> 
> +**/
> 
> +#define PCI_SEGMENT_TO_PCI_ADDRESS(A) ((UINTN) (UINT32) ((A) |
> ((RShiftU64 ((A) & BIT32, 4)))))
> 
> +
> 
> +/**
> 
> +  Register a PCI device so PCI configuration registers may be accessed after
> 
> +  SetVirtualAddressMap().
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address The address that encodes the PCI Bus, Device, Function
> and
> 
> +                  Register.
> 
> +
> 
> +  @retval RETURN_SUCCESS           The PCI device was registered for runtime
> access.
> 
> +  @retval RETURN_UNSUPPORTED       An attempt was made to call this
> function
> 
> +                                   after ExitBootServices().
> 
> +  @retval RETURN_UNSUPPORTED       The resources required to access the
> PCI device
> 
> +                                   at runtime could not be mapped.
> 
> +  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources
> available to
> 
> +                                   complete the registration.
> 
> +
> 
> +**/
> 
> +RETURN_STATUS
> 
> +EFIAPI
> 
> +PciSegmentRegisterForRuntimeAccess (
> 
> +  IN UINTN  Address
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
> 
> +  return PciRegisterForRuntimeAccess (PCI_SEGMENT_TO_PCI_ADDRESS
> (Address));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads an 8-bit PCI configuration register.
> 
> +
> 
> +  Reads and returns the 8-bit PCI configuration register specified by Address.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +
> 
> +  @return The 8-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentRead8 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
> 
> +
> 
> +  return PciRead8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes an 8-bit PCI configuration register.
> 
> +
> 
> +  Writes the 8-bit PCI configuration register specified by Address with the
> value specified by Value.
> 
> +  Value is returned.  This function must guarantee that all PCI read and write
> operations are serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address     The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentWrite8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     Value
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
> 
> +
> 
> +  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of an 8-bit PCI configuration register with an 8-bit
> value.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise OR between the read result and the value specified by
> OrData,
> 
> +  and writes the result to the 8-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), (UINT8)
> (PciSegmentRead8 (Address) | OrData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit
> value.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  and writes the result to the 8-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentAnd8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (Address, (UINT8) (PciSegmentRead8 (Address)
> & AndData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit
> value,
> 
> +  followed a  bitwise OR with another 8-bit value.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  performs a bitwise OR between the result of the AND operation and the
> value specified by OrData,
> 
> +  and writes the result to the 8-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData    The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentAndThenOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT8                     AndData,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (Address, (UINT8) ((PciSegmentRead8 (Address)
> & AndData) | OrData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field of a PCI configuration register.
> 
> +
> 
> +  Reads the bit field in an 8-bit PCI configuration register. The bit field is
> 
> +  specified by the StartBit and the EndBit. The value of the bit field is
> 
> +  returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to read.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +
> 
> +  @return The value of the bit field read from the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentBitFieldRead8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit
> 
> +  )
> 
> +{
> 
> +  return BitFieldRead8 (PciSegmentRead8 (Address), StartBit, EndBit);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a bit field to a PCI configuration register.
> 
> +
> 
> +  Writes Value to the bit field of the PCI configuration register. The bit
> 
> +  field is specified by the StartBit and the EndBit. All other bits in the
> 
> +  destination PCI configuration register are preserved. The new value of the
> 
> +  8-bit register is returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If Value is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  Value     The new value of the bit field.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentBitFieldWrite8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT8                     Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (
> 
> +           Address,
> 
> +           BitFieldWrite8 (PciSegmentRead8 (Address), StartBit, EndBit, Value)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in an 8-bit PCI configuration, performs a bitwise OR, and
> 
> +  writes the result back to the bit field in the 8-bit port.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address, performs a
> 
> +  bitwise OR between the read result and the value specified by
> 
> +  OrData, and writes the result to the 8-bit PCI configuration register
> 
> +  specified by Address. The value written to the PCI configuration register is
> 
> +  returned. This function must guarantee that all PCI read and write
> operations
> 
> +  are serialized. Extra left bits in OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentBitFieldOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (
> 
> +           Address,
> 
> +           BitFieldOr8 (PciSegmentRead8 (Address), StartBit, EndBit, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in an 8-bit PCI configuration register, performs a bitwise
> 
> +  AND, and writes the result back to the bit field in the 8-bit register.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address, performs a
> 
> +  bitwise AND between the read result and the value specified by AndData,
> and
> 
> +  writes the result to the 8-bit PCI configuration register specified by
> 
> +  Address. The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> 
> +  serialized. Extra left bits in AndData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAnd8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT8                     AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (
> 
> +           Address,
> 
> +           BitFieldAnd8 (PciSegmentRead8 (Address), StartBit, EndBit, AndData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in an 8-bit port, performs a bitwise AND followed by a
> 
> +  bitwise OR, and writes the result back to the bit field in the
> 
> +  8-bit port.
> 
> +
> 
> +  Reads the 8-bit PCI configuration register specified by Address, performs a
> 
> +  bitwise AND followed by a bitwise OR between the read result and
> 
> +  the value specified by AndData, and writes the result to the 8-bit PCI
> 
> +  configuration register specified by Address. The value written to the PCI
> 
> +  configuration register is returned. This function must guarantee that all PCI
> 
> +  read and write operations are serialized. Extra left bits in both AndData and
> 
> +  OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..7.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the result of the AND operation.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT8
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAndThenOr8 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT8                     AndData,
> 
> +  IN UINT8                     OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite8 (
> 
> +           Address,
> 
> +           BitFieldAndThenOr8 (PciSegmentRead8 (Address), StartBit, EndBit,
> AndData, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a 16-bit PCI configuration register.
> 
> +
> 
> +  Reads and returns the 16-bit PCI configuration register specified by
> Address.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +
> 
> +  @return The 16-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentRead16 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
> 
> +
> 
> +  return PciRead16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a 16-bit PCI configuration register.
> 
> +
> 
> +  Writes the 16-bit PCI configuration register specified by Address with the
> value specified by Value.
> 
> +  Value is returned.  This function must guarantee that all PCI read and write
> operations are serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address     The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The parameter of Value.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentWrite16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    Value
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
> 
> +
> 
> +  return PciWrite16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of a 16-bit PCI configuration register with
> 
> +  a 16-bit value.
> 
> +
> 
> +  Reads the 16-bit PCI configuration register specified by Address, performs
> a
> 
> +  bitwise OR between the read result and the value specified by
> 
> +  OrData, and writes the result to the 16-bit PCI configuration register
> 
> +  specified by Address. The value written to the PCI configuration register is
> 
> +  returned. This function must guarantee that all PCI read and write
> operations
> 
> +  are serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address The address that encodes the PCI Segment, Bus, Device,
> Function and
> 
> +                  Register.
> 
> +  @param  OrData  The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16
> (Address) | OrData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value.
> 
> +
> 
> +  Reads the 16-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  and writes the result to the 16-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentAnd16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16
> (Address) & AndData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit
> value,
> 
> +  followed a  bitwise OR with another 16-bit value.
> 
> +
> 
> +  Reads the 16-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  performs a bitwise OR between the result of the AND operation and the
> value specified by OrData,
> 
> +  and writes the result to the 16-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData    The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentAndThenOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT16                    AndData,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (Address, (UINT16) ((PciSegmentRead16
> (Address) & AndData) | OrData));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field of a PCI configuration register.
> 
> +
> 
> +  Reads the bit field in a 16-bit PCI configuration register. The bit field is
> 
> +  specified by the StartBit and the EndBit. The value of the bit field is
> 
> +  returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 15, then ASSERT().
> 
> +  If EndBit is greater than 15, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to read.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +
> 
> +  @return The value of the bit field read from the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentBitFieldRead16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit
> 
> +  )
> 
> +{
> 
> +  return BitFieldRead16 (PciSegmentRead16 (Address), StartBit, EndBit);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a bit field to a PCI configuration register.
> 
> +
> 
> +  Writes Value to the bit field of the PCI configuration register. The bit
> 
> +  field is specified by the StartBit and the EndBit. All other bits in the
> 
> +  destination PCI configuration register are preserved. The new value of the
> 
> +  16-bit register is returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 15, then ASSERT().
> 
> +  If EndBit is greater than 15, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If Value is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  Value     The new value of the bit field.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentBitFieldWrite16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT16                    Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (
> 
> +           Address,
> 
> +           BitFieldWrite16 (PciSegmentRead16 (Address), StartBit, EndBit, Value)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads the 16-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise OR between the read result and the value specified by
> OrData,
> 
> +  and writes the result to the 16-bit PCI configuration register specified by
> Address.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 15, then ASSERT().
> 
> +  If EndBit is greater than 15, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentBitFieldOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (
> 
> +           Address,
> 
> +           BitFieldOr16 (PciSegmentRead16 (Address), StartBit, EndBit, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in a 16-bit PCI configuration, performs a bitwise OR,
> 
> +  and writes the result back to the bit field in the 16-bit port.
> 
> +
> 
> +  Reads the 16-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise OR between the read result and the value specified by
> OrData,
> 
> +  and writes the result to the 16-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +  Extra left bits in OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 16-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 7, then ASSERT().
> 
> +  If EndBit is greater than 7, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    The ordinal of the least significant bit in a byte is bit 0.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    The ordinal of the most significant bit in a byte is bit 7.
> 
> +  @param  AndData   The value to AND with the read value from the PCI
> configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAnd16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT16                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (
> 
> +           Address,
> 
> +           BitFieldAnd16 (PciSegmentRead16 (Address), StartBit, EndBit,
> AndData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in a 16-bit port, performs a bitwise AND followed by a
> 
> +  bitwise OR, and writes the result back to the bit field in the
> 
> +  16-bit port.
> 
> +
> 
> +  Reads the 16-bit PCI configuration register specified by Address, performs
> a
> 
> +  bitwise AND followed by a bitwise OR between the read result and
> 
> +  the value specified by AndData, and writes the result to the 16-bit PCI
> 
> +  configuration register specified by Address. The value written to the PCI
> 
> +  configuration register is returned. This function must guarantee that all PCI
> 
> +  read and write operations are serialized. Extra left bits in both AndData and
> 
> +  OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 15, then ASSERT().
> 
> +  If EndBit is greater than 15, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..15.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the result of the AND operation.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAndThenOr16 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT16                    AndData,
> 
> +  IN UINT16                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite16 (
> 
> +           Address,
> 
> +           BitFieldAndThenOr16 (PciSegmentRead16 (Address), StartBit, EndBit,
> AndData, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a 32-bit PCI configuration register.
> 
> +
> 
> +  Reads and returns the 32-bit PCI configuration register specified by
> Address.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +
> 
> +  @return The 32-bit PCI configuration register specified by Address.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentRead32 (
> 
> +  IN UINT64                    Address
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
> 
> +
> 
> +  return PciRead32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a 32-bit PCI configuration register.
> 
> +
> 
> +  Writes the 32-bit PCI configuration register specified by Address with the
> value specified by Value.
> 
> +  Value is returned.  This function must guarantee that all PCI read and write
> operations are serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address     The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  Value       The value to write.
> 
> +
> 
> +  @return The parameter of Value.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentWrite32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    Value
> 
> +  )
> 
> +{
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
> 
> +
> 
> +  return PciWrite32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise OR between the read result and the value specified by
> OrData,
> 
> +  and writes the result to the 32-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) |
> OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value.
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  and writes the result to the 32-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentAnd32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) &
> AndData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit
> value,
> 
> +  followed a  bitwise OR with another 32-bit value.
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address,
> 
> +  performs a bitwise AND between the read result and the value specified
> by AndData,
> 
> +  performs a bitwise OR between the result of the AND operation and the
> value specified by OrData,
> 
> +  and writes the result to the 32-bit PCI configuration register specified by
> Address.
> 
> +  The value written to the PCI configuration register is returned.
> 
> +  This function must guarantee that all PCI read and write operations are
> serialized.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +
> 
> +  @param  Address   The address that encodes the PCI Segment, Bus,
> Device, Function, and Register.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentAndThenOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINT32                    AndData,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (Address, (PciSegmentRead32 (Address) &
> AndData) | OrData);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field of a PCI configuration register.
> 
> +
> 
> +  Reads the bit field in a 32-bit PCI configuration register. The bit field is
> 
> +  specified by the StartBit and the EndBit. The value of the bit field is
> 
> +  returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 31, then ASSERT().
> 
> +  If EndBit is greater than 31, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to read.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +
> 
> +  @return The value of the bit field read from the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentBitFieldRead32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit
> 
> +  )
> 
> +{
> 
> +  return BitFieldRead32 (PciSegmentRead32 (Address), StartBit, EndBit);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Writes a bit field to a PCI configuration register.
> 
> +
> 
> +  Writes Value to the bit field of the PCI configuration register. The bit
> 
> +  field is specified by the StartBit and the EndBit. All other bits in the
> 
> +  destination PCI configuration register are preserved. The new value of the
> 
> +  32-bit register is returned.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 31, then ASSERT().
> 
> +  If EndBit is greater than 31, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If Value is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  Value     The new value of the bit field.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentBitFieldWrite32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT32                    Value
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (
> 
> +           Address,
> 
> +           BitFieldWrite32 (PciSegmentRead32 (Address), StartBit, EndBit, Value)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in a 32-bit PCI configuration, performs a bitwise OR, and
> 
> +  writes the result back to the bit field in the 32-bit port.
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address, performs
> a
> 
> +  bitwise OR between the read result and the value specified by
> 
> +  OrData, and writes the result to the 32-bit PCI configuration register
> 
> +  specified by Address. The value written to the PCI configuration register is
> 
> +  returned. This function must guarantee that all PCI read and write
> operations
> 
> +  are serialized. Extra left bits in OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 31, then ASSERT().
> 
> +  If EndBit is greater than 31, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  OrData    The value to OR with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentBitFieldOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (
> 
> +           Address,
> 
> +           BitFieldOr32 (PciSegmentRead32 (Address), StartBit, EndBit, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in a 32-bit PCI configuration register, performs a bitwise
> 
> +  AND, and writes the result back to the bit field in the 32-bit register.
> 
> +
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address, performs
> a bitwise
> 
> +  AND between the read result and the value specified by AndData, and
> writes the result
> 
> +  to the 32-bit PCI configuration register specified by Address. The value
> written to
> 
> +  the PCI configuration register is returned.  This function must guarantee
> that all PCI
> 
> +  read and write operations are serialized.  Extra left bits in AndData are
> stripped.
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If Address is not aligned on a 32-bit boundary, then ASSERT().
> 
> +  If StartBit is greater than 31, then ASSERT().
> 
> +  If EndBit is greater than 31, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAnd32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT32                    AndData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (
> 
> +           Address,
> 
> +           BitFieldAnd32 (PciSegmentRead32 (Address), StartBit, EndBit,
> AndData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a bit field in a 32-bit port, performs a bitwise AND followed by a
> 
> +  bitwise OR, and writes the result back to the bit field in the
> 
> +  32-bit port.
> 
> +
> 
> +  Reads the 32-bit PCI configuration register specified by Address, performs
> a
> 
> +  bitwise AND followed by a bitwise OR between the read result and
> 
> +  the value specified by AndData, and writes the result to the 32-bit PCI
> 
> +  configuration register specified by Address. The value written to the PCI
> 
> +  configuration register is returned. This function must guarantee that all PCI
> 
> +  read and write operations are serialized. Extra left bits in both AndData and
> 
> +  OrData are stripped.
> 
> +
> 
> +  If any reserved bits in Address are set, then ASSERT().
> 
> +  If StartBit is greater than 31, then ASSERT().
> 
> +  If EndBit is greater than 31, then ASSERT().
> 
> +  If EndBit is less than StartBit, then ASSERT().
> 
> +  If AndData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +  If OrData is larger than the bitmask value range specified by StartBit and
> EndBit, then ASSERT().
> 
> +
> 
> +  @param  Address   The PCI configuration register to write.
> 
> +  @param  StartBit  The ordinal of the least significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  EndBit    The ordinal of the most significant bit in the bit field.
> 
> +                    Range 0..31.
> 
> +  @param  AndData   The value to AND with the PCI configuration register.
> 
> +  @param  OrData    The value to OR with the result of the AND operation.
> 
> +
> 
> +  @return The value written back to the PCI configuration register.
> 
> +
> 
> +**/
> 
> +UINT32
> 
> +EFIAPI
> 
> +PciSegmentBitFieldAndThenOr32 (
> 
> +  IN UINT64                    Address,
> 
> +  IN UINTN                     StartBit,
> 
> +  IN UINTN                     EndBit,
> 
> +  IN UINT32                    AndData,
> 
> +  IN UINT32                    OrData
> 
> +  )
> 
> +{
> 
> +  return PciSegmentWrite32 (
> 
> +           Address,
> 
> +           BitFieldAndThenOr32 (PciSegmentRead32 (Address), StartBit, EndBit,
> AndData, OrData)
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Reads a range of PCI configuration registers into a caller supplied buffer.
> 
> +
> 
> +  Reads the range of PCI configuration registers specified by StartAddress
> and
> 
> +  Size into the buffer specified by Buffer. This function only allows the PCI
> 
> +  configuration registers from a single PCI function to be read. Size is
> 
> +  returned. When possible 32-bit PCI configuration read cycles are used to
> read
> 
> +  from StartAdress to StartAddress + Size. Due to alignment restrictions, 8-
> bit
> 
> +  and 16-bit PCI configuration read cycles may be used at the beginning and
> the
> 
> +  end of the range.
> 
> +
> 
> +  If any reserved bits in StartAddress are set, then ASSERT().
> 
> +  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
> 
> +  If Size > 0 and Buffer is NULL, then ASSERT().
> 
> +
> 
> +  @param  StartAddress  The starting address that encodes the PCI
> Segment, Bus, Device,
> 
> +                        Function and Register.
> 
> +  @param  Size          The size in bytes of the transfer.
> 
> +  @param  Buffer        The pointer to a buffer receiving the data read.
> 
> +
> 
> +  @return Size
> 
> +
> 
> +**/
> 
> +UINTN
> 
> +EFIAPI
> 
> +PciSegmentReadBuffer (
> 
> +  IN  UINT64                   StartAddress,
> 
> +  IN  UINTN                    Size,
> 
> +  OUT VOID                     *Buffer
> 
> +  )
> 
> +{
> 
> +  UINTN                                ReturnValue;
> 
> +
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
> 
> +  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
> 
> +
> 
> +  if (Size == 0) {
> 
> +    return Size;
> 
> +  }
> 
> +
> 
> +  ASSERT (Buffer != NULL);
> 
> +
> 
> +  //
> 
> +  // Save Size for return
> 
> +  //
> 
> +  ReturnValue = Size;
> 
> +
> 
> +  if ((StartAddress & BIT0) != 0) {
> 
> +    //
> 
> +    // Read a byte if StartAddress is byte aligned
> 
> +    //
> 
> +    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
> 
> +    StartAddress += sizeof (UINT8);
> 
> +    Size -= sizeof (UINT8);
> 
> +    Buffer = (UINT8*)Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
> 
> +    //
> 
> +    // Read a word if StartAddress is word aligned
> 
> +    //
> 
> +    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
> 
> +    StartAddress += sizeof (UINT16);
> 
> +    Size -= sizeof (UINT16);
> 
> +    Buffer = (UINT16*)Buffer + 1;
> 
> +  }
> 
> +
> 
> +  while (Size >= sizeof (UINT32)) {
> 
> +    //
> 
> +    // Read as many double words as possible
> 
> +    //
> 
> +    WriteUnaligned32 (Buffer, PciSegmentRead32 (StartAddress));
> 
> +    StartAddress += sizeof (UINT32);
> 
> +    Size -= sizeof (UINT32);
> 
> +    Buffer = (UINT32*)Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT16)) {
> 
> +    //
> 
> +    // Read the last remaining word if exist
> 
> +    //
> 
> +    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
> 
> +    StartAddress += sizeof (UINT16);
> 
> +    Size -= sizeof (UINT16);
> 
> +    Buffer = (UINT16*)Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT8)) {
> 
> +    //
> 
> +    // Read the last remaining byte if exist
> 
> +    //
> 
> +    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
> 
> +  }
> 
> +
> 
> +  return ReturnValue;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Copies the data in a caller supplied buffer to a specified range of PCI
> 
> +  configuration space.
> 
> +
> 
> +  Writes the range of PCI configuration registers specified by StartAddress
> and
> 
> +  Size from the buffer specified by Buffer. This function only allows the PCI
> 
> +  configuration registers from a single PCI function to be written. Size is
> 
> +  returned. When possible 32-bit PCI configuration write cycles are used to
> 
> +  write from StartAdress to StartAddress + Size. Due to alignment
> restrictions,
> 
> +  8-bit and 16-bit PCI configuration write cycles may be used at the beginning
> 
> +  and the end of the range.
> 
> +
> 
> +  If any reserved bits in StartAddress are set, then ASSERT().
> 
> +  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
> 
> +  If Size > 0 and Buffer is NULL, then ASSERT().
> 
> +
> 
> +  @param  StartAddress  The starting address that encodes the PCI
> Segment, Bus, Device,
> 
> +                        Function and Register.
> 
> +  @param  Size          The size in bytes of the transfer.
> 
> +  @param  Buffer        The pointer to a buffer containing the data to write.
> 
> +
> 
> +  @return The parameter of Size.
> 
> +
> 
> +**/
> 
> +UINTN
> 
> +EFIAPI
> 
> +PciSegmentWriteBuffer (
> 
> +  IN UINT64                    StartAddress,
> 
> +  IN UINTN                     Size,
> 
> +  IN VOID                      *Buffer
> 
> +  )
> 
> +{
> 
> +  UINTN                                ReturnValue;
> 
> +
> 
> +  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
> 
> +  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
> 
> +
> 
> +  if (Size == 0) {
> 
> +    return 0;
> 
> +  }
> 
> +
> 
> +  ASSERT (Buffer != NULL);
> 
> +
> 
> +  //
> 
> +  // Save Size for return
> 
> +  //
> 
> +  ReturnValue = Size;
> 
> +
> 
> +  if ((StartAddress & BIT0) != 0) {
> 
> +    //
> 
> +    // Write a byte if StartAddress is byte aligned
> 
> +    //
> 
> +    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
> 
> +    StartAddress += sizeof (UINT8);
> 
> +    Size -= sizeof (UINT8);
> 
> +    Buffer = (UINT8*) Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
> 
> +    //
> 
> +    // Write a word if StartAddress is word aligned
> 
> +    //
> 
> +    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
> 
> +    StartAddress += sizeof (UINT16);
> 
> +    Size -= sizeof (UINT16);
> 
> +    Buffer = (UINT16*) Buffer + 1;
> 
> +  }
> 
> +
> 
> +  while (Size >= sizeof (UINT32)) {
> 
> +    //
> 
> +    // Write as many double words as possible
> 
> +    //
> 
> +    PciSegmentWrite32 (StartAddress, ReadUnaligned32 (Buffer));
> 
> +    StartAddress += sizeof (UINT32);
> 
> +    Size -= sizeof (UINT32);
> 
> +    Buffer = (UINT32*) Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT16)) {
> 
> +    //
> 
> +    // Write the last remaining word if exist
> 
> +    //
> 
> +    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
> 
> +    StartAddress += sizeof (UINT16);
> 
> +    Size -= sizeof (UINT16);
> 
> +    Buffer = (UINT16*) Buffer + 1;
> 
> +  }
> 
> +
> 
> +  if (Size >= sizeof (UINT8)) {
> 
> +    //
> 
> +    // Write the last remaining byte if exist
> 
> +    //
> 
> +    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
> 
> +  }
> 
> +
> 
> +  return ReturnValue;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfig
> BlockLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfi
> gBlockLib.c
> new file mode 100644
> index 0000000000..4644de9b74
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfi
> gBlockLib.c
> @@ -0,0 +1,86 @@
> +/** @file
> 
> +  This file is BaseSiConfigBlockLib library is used to add config blocks
> 
> +  to config block header.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <ConfigBlock.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +
> 
> +
> 
> +/**
> 
> +  GetComponentConfigBlockTotalSize get config block table total size.
> 
> +
> 
> +  @param[in] ComponentBlocks    Component blocks array
> 
> +  @param[in] TotalBlockCount    Number of blocks
> 
> +
> 
> +  @retval                       Size of config block table
> 
> +**/
> 
> +UINT16
> 
> +EFIAPI
> 
> +GetComponentConfigBlockTotalSize (
> 
> +  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
> 
> +  IN UINT16                TotalBlockCount
> 
> +  )
> 
> +{
> 
> +  UINT16            TotalBlockSize;
> 
> +  UINT16            BlockCount;
> 
> +
> 
> +  TotalBlockSize = 0;
> 
> +  for (BlockCount = 0 ; BlockCount < TotalBlockCount; BlockCount++) {
> 
> +    TotalBlockSize += (UINT32) ComponentBlocks[BlockCount].Size;
> 
> +    DEBUG ((DEBUG_INFO, "TotalBlockSize after adding Block[0x%x]=
> 0x%x\n", BlockCount, TotalBlockSize));
> 
> +  }
> 
> +
> 
> +  return TotalBlockSize;
> 
> +}
> 
> +
> 
> +/**
> 
> +  AddComponentConfigBlocks add all config blocks.
> 
> +
> 
> +  @param[in] ConfigBlockTableAddress    The pointer to add config blocks
> 
> +  @param[in] ComponentBlocks            Config blocks array
> 
> +  @param[in] TotalBlockCount            Number of blocks
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +AddComponentConfigBlocks (
> 
> +  IN VOID                  *ConfigBlockTableAddress,
> 
> +  IN COMPONENT_BLOCK_ENTRY *ComponentBlocks,
> 
> +  IN UINT16                TotalBlockCount
> 
> +  )
> 
> +{
> 
> +  UINT16            BlockCount;
> 
> +  VOID              *ConfigBlockPointer;
> 
> +  CONFIG_BLOCK      ConfigBlockBuf;
> 
> +  EFI_STATUS        Status;
> 
> +
> 
> +  Status = EFI_SUCCESS;
> 
> +
> 
> +  //
> 
> +  // Initialize ConfigBlockPointer to NULL
> 
> +  //
> 
> +  ConfigBlockPointer = NULL;
> 
> +  //
> 
> +  // Loop to identify each config block from ComponentBlocks[] Table and
> add each of them
> 
> +  //
> 
> +  for (BlockCount = 0; BlockCount < TotalBlockCount; BlockCount++) {
> 
> +    ZeroMem (&ConfigBlockBuf, sizeof (CONFIG_BLOCK));
> 
> +    CopyMem (&(ConfigBlockBuf.Header.GuidHob.Name),
> ComponentBlocks[BlockCount].Guid, sizeof (EFI_GUID));
> 
> +    ConfigBlockBuf.Header.GuidHob.Header.HobLength =
> ComponentBlocks[BlockCount].Size;
> 
> +    ConfigBlockBuf.Header.Revision        =
> ComponentBlocks[BlockCount].Revision;
> 
> +    ConfigBlockPointer = (VOID *)&ConfigBlockBuf;
> 
> +    Status = AddConfigBlock ((VOID *)ConfigBlockTableAddress, (VOID
> *)&ConfigBlockPointer);
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    ComponentBlocks[BlockCount].LoadDefault (ConfigBlockPointer);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfig
> BlockLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfi
> gBlockLib.inf
> new file mode 100644
> index 0000000000..e23b2d342f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/BaseSiConfigBlockLib/BaseSiConfi
> gBlockLib.inf
> @@ -0,0 +1,33 @@
> +## @file
> 
> +# Component description file for the BaseSiConfigBlockLib library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = BaseSiConfigBlockLib
> 
> +FILE_GUID = 6C068D0F-F48E-48CB-B369-433E507AF4A2
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = SiConfigBlockLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +DebugLib
> 
> +IoLib
> 
> +ConfigBlockLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +BaseSiConfigBlockLib.c
> 
> +
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.c
> new file mode 100644
> index 0000000000..48e14dc9ee
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.c
> @@ -0,0 +1,35 @@
> +/** @file
> 
> +  This file contains routines that get PCI Express Address
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +
> 
> +/**
> 
> +  This procedure will get PCIE address
> 
> +
> 
> +  @param[in] Bus                  Pci Bus Number
> 
> +  @param[in] Device               Pci Device Number
> 
> +  @param[in] Function             Pci Function Number
> 
> +
> 
> +  @retval PCIE address
> 
> +**/
> 
> +UINTN
> 
> +EFIAPI
> 
> +MmPciBase (
> 
> +  IN UINT32                       Bus,
> 
> +  IN UINT32                       Device,
> 
> +  IN UINT32                       Function
> 
> +  )
> 
> +{
> 
> +  ASSERT ((Bus <= 0xFF) && (Device <= 0x1F) && (Function <= 0x7));
> 
> +
> 
> +#ifdef FSP_FLAG
> 
> +  return ((UINTN) PcdGet64 (PcdSiPciExpressBaseAddress) + (UINTN) (Bus
> << 20) + (UINTN) (Device << 15) + (UINTN) (Function << 12));
> 
> +#else
> 
> +  return ((UINTN) PcdGet64 (PcdPciExpressBaseAddress)   + (UINTN) (Bus
> << 20) + (UINTN) (Device << 15) + (UINTN) (Function << 12));
> 
> +#endif
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.inf
> new file mode 100644
> index 0000000000..353b97f3f6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Library/PeiDxeSmmMmPciLib/PeiDxeSm
> mMmPciLib.inf
> @@ -0,0 +1,43 @@
> +## @file
> 
> +# Component description file for the PeiDxeSmmMmPciLib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmMmPciLib
> 
> +FILE_GUID = D03D6670-A032-11E2-9E96-0800200C9A66
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = MmPciLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +PcdLib
> 
> +DebugLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> 
> +
> 
> +[FixedPcd]
> 
> +gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
> 
> +
> 
> +[Sources]
> 
> +PeiDxeSmmMmPciLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch common library instances
  2021-02-01  1:36 ` [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch " Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch common library
> instances
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * Pch/Library/BasePchPciBdfLib
>   * Pch/Library/BaseResetSystemLib
>   * Pch/Library/DxePchPolicyLib
>   * Pch/Library/PeiDxeSmmPchCycleDecodingLib
>   * Pch/Library/PeiDxeSmmPchInfoLib
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPciBd
> fLib.inf                         |   33 +++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLib.
> c                               | 1092
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseReset
> SystemLib.c                       |  158
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseReset
> SystemLib.inf                     |   38 +++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLi
> b.c                             |  198
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolicyLi
> b.inf                           |   43 +++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLi
> b/PchCycleDecodingLib.c            |  587
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodingLi
> b/PeiDxeSmmPchCycleDecodingLib.inf |   42
> ++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfo
> Lib.c                              |  127
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfo
> LibPrivate.h                       |   58
> +++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInfo
> LibTgl.c                           |  715
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDxeS
> mmPchInfoLibTgl.inf                |   43
> +++++++++++++++++++++++++++++++++++
>  12 files changed, 3134 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPci
> BdfLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPci
> BdfLib.inf
> new file mode 100644
> index 0000000000..4f4096a409
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/BasePchPci
> BdfLib.inf
> @@ -0,0 +1,33 @@
> +## @file
> 
> +# PCH PCIe Bus Device Function Library.
> 
> +#
> 
> +# All functions from this library are available in PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchPciBdfLib
> 
> +FILE_GUID = ED0C4241-40FA-4A74-B061-2E45E7AAD7BA
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchPciBdfLib
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchInfoLib
> 
> +PchPcieRpLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +PchPciBdfLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLi
> b.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLi
> b.c
> new file mode 100644
> index 0000000000..0db8cea4bb
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BasePchPciBdfLib/PchPciBdfLi
> b.c
> @@ -0,0 +1,1092 @@
> +/** @file
> 
> +  PCH PCIe Bus Device Function Library.
> 
> +  All functions from this library are available in PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Base.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <PchBdfAssignment.h>
> 
> +
> 
> +/**
> 
> +  Check if a Device is present for PCH FRU
> 
> +  If the data is defined for PCH RFU return it
> 
> +  If the data is not defined (Device is NOT present) assert.
> 
> +
> 
> +  @param[in]  DataToCheck       Device or Function number to check
> 
> +
> 
> +  @retval Device or Function number value if defined for PCH FRU
> 
> +          0xFF if not present in PCH FRU
> 
> +**/
> 
> +UINT8
> 
> +CheckAndReturn (
> 
> +  UINT8 DataToCheck
> 
> +  )
> 
> +{
> 
> +  if (DataToCheck == NOT_PRESENT) {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +  return DataToCheck;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get eSPI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval eSPI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +EspiPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  ASSERT (PCI_DEVICE_NUMBER_PCH_ESPI != NOT_PRESENT);
> 
> +
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           PCI_DEVICE_NUMBER_PCH_ESPI,
> 
> +           PCI_FUNCTION_NUMBER_PCH_ESPI,
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Device Number
> 
> +
> 
> +  @retval  GbE device number
> 
> +**/
> 
> +UINT8
> 
> +GbeDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_GBE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Gigabit Ethernet PCI Function Number
> 
> +
> 
> +  @retval  GbE function number
> 
> +**/
> 
> +UINT8
> 
> +GbeFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_GBE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get GbE controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval GbE controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +GbePciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            GbeDevNumber (),
> 
> +            GbeFuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HDA PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +HdaDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HDA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HDA PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +HdaFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HDA);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HDA controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HDA controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +HdaPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            HdaDevNumber (),
> 
> +            HdaFuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get P2SB PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +P2sbDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_P2SB);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get P2SB PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +P2sbFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_P2SB);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get P2SB controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval P2SB controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +P2sbPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           P2sbDevNumber (),
> 
> +           P2sbFuncNumber (),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns PCH SPI Device number
> 
> +
> 
> +  @retval UINT8   PCH SPI Device number
> 
> +**/
> 
> +UINT8
> 
> +SpiDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SPI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns PCH SPI Function number
> 
> +
> 
> +  @retval UINT8   PCH SPI Function number
> 
> +**/
> 
> +UINT8
> 
> +SpiFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SPI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns PCH SPI PCI Config Space base address
> 
> +
> 
> +  @retval  UINT64  PCH SPI Config Space base address
> 
> +**/
> 
> +UINT64
> 
> +SpiPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SpiDevNumber (),
> 
> +           SpiFuncNumber (),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XHCI controller PCIe Device Number
> 
> +
> 
> +  @retval XHCI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchXhciDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_XHCI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XHCI controller PCIe Function Number
> 
> +
> 
> +  @retval XHCI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchXhciFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_XHCI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XHCI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval XHCI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchXhciPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +          DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +          PchXhciDevNumber (),
> 
> +          PchXhciFuncNumber (),
> 
> +          0
> 
> +          );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XDCI controller PCIe Device Number
> 
> +
> 
> +  @retval XDCI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchXdciDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_XDCI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XDCI controller PCIe Function Number
> 
> +
> 
> +  @retval XDCI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchXdciFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_XDCI);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get XDCI controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval XDCI controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchXdciPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +          DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +          PchXdciDevNumber (),
> 
> +          PchXdciFuncNumber (),
> 
> +          0
> 
> +          );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return Smbus Device Number
> 
> +
> 
> +  @retval Smbus Device Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SMBUS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return Smbus Function Number
> 
> +
> 
> +  @retval  Smbus Function Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SMBUS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SMBUS controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @retval SMBUS controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +SmbusPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            SmbusDevNumber (),
> 
> +            SmbusFuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return DMA Smbus Device Number
> 
> +
> 
> +  @retval DMA Smbus Device Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDmaDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_DMA_SMBUS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return DMA Smbus Function Number
> 
> +
> 
> +  @retval  DMA Smbus Function Number
> 
> +**/
> 
> +UINT8
> 
> +SmbusDmaFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_DMA_SMBUS);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get DMA SMBUS controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @retval DMA SMBUS controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SmbusDmaPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            SmbusDmaDevNumber (),
> 
> +            SmbusDmaFuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller PCIe Device Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SataDevNumber (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MAX_SATA_CONTROLLER);
> 
> +
> 
> +  if (SataCtrlIndex == 0) {
> 
> +    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_1);
> 
> +  } else if (SataCtrlIndex == 1) {
> 
> +    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_2);
> 
> +  } else if (SataCtrlIndex == 2) {
> 
> +    return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SATA_3);
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller PCIe Function Number
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SataFuncNumber (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  ASSERT (SataCtrlIndex < MAX_SATA_CONTROLLER);
> 
> +
> 
> +  if (SataCtrlIndex == 0) {
> 
> +    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_1);
> 
> +  } else if (SataCtrlIndex == 1) {
> 
> +    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_2);
> 
> +  } else if (SataCtrlIndex == 2) {
> 
> +    return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_SATA_3);
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get SATA controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @param[in]  SataCtrlIndex       SATA controller index
> 
> +
> 
> +  @retval SATA controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +SataPciCfgBase (
> 
> +  IN UINT32  SataCtrlIndex
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SataDevNumber (SataCtrlIndex),
> 
> +           SataFuncNumber (SataCtrlIndex),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get LPC controller PCIe Device Number
> 
> +
> 
> +  @retval LPC controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +LpcDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_LPC);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get LPC controller PCIe Function Number
> 
> +
> 
> +  @retval LPC controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +LpcFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_LPC);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns PCH LPC device PCI base address.
> 
> +
> 
> +  @retval                   PCH LPC PCI base address.
> 
> +**/
> 
> +UINT64
> 
> +LpcPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           LpcDevNumber (),
> 
> +           LpcFuncNumber (),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Thermal Device PCIe Device Number
> 
> +
> 
> +  @retval Thermal Device PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +ThermalDevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_THERMAL);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Thermal Device PCIe Function Number
> 
> +
> 
> +  @retval Thermal Device PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +ThermalFuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_THERMAL);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns Thermal Device PCI base address.
> 
> +
> 
> +  @retval                   Thermal Device PCI base address.
> 
> +**/
> 
> +UINT64
> 
> +ThermalPciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           ThermalDevNumber (),
> 
> +           ThermalFuncNumber (),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller PCIe Device Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoI2cDevNumber (
> 
> +  IN UINT8       I2cNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoI2cControllersNum () <= I2cNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +  switch (I2cNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C0);
> 
> +    case 1:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C1);
> 
> +    case 2:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C2);
> 
> +    case 3:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C3);
> 
> +    case 4:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C4);
> 
> +    case 5:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C5);
> 
> +    case 6:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C6);
> 
> +    case 7:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_I2C7);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller PCIe Function Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoI2cFuncNumber (
> 
> +  IN UINT8       I2cNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoI2cControllersNum () <= I2cNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +  switch (I2cNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C0);
> 
> +    case 1:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C1);
> 
> +    case 2:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C2);
> 
> +    case 3:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C3);
> 
> +    case 4:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C4);
> 
> +    case 5:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C5);
> 
> +    case 6:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C6);
> 
> +    case 7:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_I2C7);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO I2C controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO I2C controller index
> 
> +
> 
> +  @retval Serial IO I2C controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoI2cPciCfgBase (
> 
> +  IN UINT8        I2cNumber
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoI2cDevNumber (I2cNumber),
> 
> +           SerialIoI2cFuncNumber (I2cNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller PCIe Device Number
> 
> +
> 
> +  @param[in]  I2cNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoSpiDevNumber (
> 
> +  IN UINT8       SpiNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoSpiControllersNum () <= SpiNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +
> 
> +  switch (SpiNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI0);
> 
> +    case 1:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI1);
> 
> +    case 2:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI2);
> 
> +    case 3:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI3);
> 
> +    case 4:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI4);
> 
> +    case 5:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI5);
> 
> +    case 6:
> 
> +      return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_SPI6);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller PCIe Function Number
> 
> +
> 
> +  @param[in]  SpiNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoSpiFuncNumber (
> 
> +  IN UINT8       SpiNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoSpiControllersNum () <= SpiNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +
> 
> +  switch (SpiNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI0);
> 
> +    case 1:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI1);
> 
> +    case 2:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI2);
> 
> +    case 3:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI3);
> 
> +    case 4:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI4);
> 
> +    case 5:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI5);
> 
> +    case 6:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_SPI6);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO SPI controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  SpiNumber       Serial IO SPI controller index
> 
> +
> 
> +  @retval Serial IO SPI controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoSpiPciCfgBase (
> 
> +  IN UINT8        SpiNumber
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoSpiDevNumber (SpiNumber),
> 
> +           SerialIoSpiFuncNumber (SpiNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller PCIe Device Number
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoUartDevNumber (
> 
> +  IN UINT8       UartNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoUartControllersNum () <= UartNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +  switch (UartNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART0);
> 
> +    case 1:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART1);
> 
> +    case 2:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART2);
> 
> +    case 3:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART3);
> 
> +    case 4:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART4);
> 
> +    case 5:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART5);
> 
> +    case 6:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_SERIAL_IO_UART6);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller PCIe Function Number
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +SerialIoUartFuncNumber (
> 
> +  IN UINT8       UartNumber
> 
> +  )
> 
> +{
> 
> +  if (GetPchMaxSerialIoUartControllersNum () <= UartNumber) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +  switch (UartNumber) {
> 
> +    case 0:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART0);
> 
> +    case 1:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART1);
> 
> +    case 2:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART2);
> 
> +    case 3:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART3);
> 
> +    case 4:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART4);
> 
> +    case 5:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART5);
> 
> +    case 6:
> 
> +      return CheckAndReturn
> (PCI_FUNCTION_NUMBER_PCH_SERIAL_IO_UART6);
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Serial IO UART controller address that can be passed to the PCI
> Segment Library functions.
> 
> +
> 
> +  @param[in]  UartNumber       Serial IO UART controller index
> 
> +
> 
> +  @retval Serial IO UART controller address in PCI Segment Library
> representation
> 
> +**/
> 
> +UINT64
> 
> +SerialIoUartPciCfgBase (
> 
> +  IN UINT8        UartNumber
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +           DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +           DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +           SerialIoUartDevNumber (UartNumber),
> 
> +           SerialIoUartFuncNumber (UartNumber),
> 
> +           0
> 
> +           );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller PCIe Device Number
> 
> +
> 
> +  @param[in]  RpIndex       Root port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller PCIe Device Number
> 
> +**/
> 
> +UINT8
> 
> +PchPcieRpDevNumber (
> 
> +  IN  UINTN   RpIndex
> 
> +  )
> 
> +{
> 
> +  if (RpIndex >= GetPchMaxPciePortNum ()) {
> 
> +    ASSERT (FALSE);
> 
> +    return 0xFF;
> 
> +  }
> 
> +  switch (RpIndex) {
> 
> +    case 0:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_1);
> 
> +    case 1:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_2);
> 
> +    case 2:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_3);
> 
> +    case 3:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_4);
> 
> +    case 4:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_5);
> 
> +    case 5:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_6);
> 
> +    case 6:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_7);
> 
> +    case 7:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_8);
> 
> +    case 8:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_9);
> 
> +    case 9:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_10);
> 
> +    case 10:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_11);
> 
> +    case 11:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_12);
> 
> +    case 12:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_13);
> 
> +    case 13:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_14);
> 
> +    case 14:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_15);
> 
> +    case 15:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_16);
> 
> +    case 16:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_17);
> 
> +    case 17:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_18);
> 
> +    case 18:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_19);
> 
> +    case 19:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_20);
> 
> +    case 20:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_21);
> 
> +    case 21:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_22);
> 
> +    case 22:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_23);
> 
> +    case 23:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_24);
> 
> +    case 24:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_25);
> 
> +    case 25:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_26);
> 
> +    case 26:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_27);
> 
> +    case 27:
> 
> +      return CheckAndReturn
> (PCI_DEVICE_NUMBER_PCH_PCIE_ROOT_PORT_28);
> 
> +
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      return 0xFF;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller PCIe Function Number
> 
> +  Note:
> 
> +  For Client PCH generations Function Number can be various
> 
> +  depending on "Root Port Function Swapping". For such cases
> 
> +  Function Number  MUST be obtain from proper register.
> 
> +  For Server PCHs we have no "Root Port Function Swapping"
> 
> +  and we can return fixed Function Number.
> 
> +  To address this difference in this, PCH generation independent,
> 
> +  library we should call specific function in PchPcieRpLib.
> 
> +
> 
> +  @param[in]  RpIndex       Root port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller PCIe Function Number
> 
> +**/
> 
> +UINT8
> 
> +PchPcieRpFuncNumber (
> 
> +  IN  UINTN   RpIndex
> 
> +  )
> 
> +{
> 
> +  UINTN   Device;
> 
> +  UINTN   Function;
> 
> +
> 
> +  GetPchPcieRpDevFun (RpIndex, &Device, &Function);
> 
> +
> 
> +  return (UINT8)Function;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH PCIe controller address that can be passed to the PCI Segment
> Library functions.
> 
> +
> 
> +  @param[in]  RpIndex       PCH PCIe Root Port physical number. (0-based)
> 
> +
> 
> +  @retval PCH PCIe controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchPcieRpPciCfgBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +          DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +          DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +          PchPcieRpDevNumber (RpIndex),
> 
> +          PchPcieRpFuncNumber (RpIndex),
> 
> +          0
> 
> +          );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI1 PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci1DevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HECI1);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI1 PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci1FuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HECI1);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI1 controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HECI1 controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchHeci1PciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            PchHeci1DevNumber (),
> 
> +            PchHeci1FuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI3 PCI device number
> 
> +
> 
> +  @retval PCI dev number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci3DevNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_DEVICE_NUMBER_PCH_HECI3);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI3 PCI function number
> 
> +
> 
> +  @retval PCI fun number
> 
> +**/
> 
> +UINT8
> 
> +PchHeci3FuncNumber (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CheckAndReturn (PCI_FUNCTION_NUMBER_PCH_HECI3);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HECI3 controller address that can be passed to the PCI Segment Library
> functions.
> 
> +
> 
> +  @retval HECI3 controller address in PCI Segment Library representation
> 
> +**/
> 
> +UINT64
> 
> +PchHeci3PciCfgBase (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (
> 
> +            DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +            DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +            PchHeci3DevNumber (),
> 
> +            PchHeci3FuncNumber (),
> 
> +            0
> 
> +            );
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRes
> etSystemLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRe
> setSystemLib.c
> new file mode 100644
> index 0000000000..2ede8e0021
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRe
> setSystemLib.c
> @@ -0,0 +1,158 @@
> +/** @file
> 
> +  System reset library services.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/ResetSystemLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16
> mBaseResetSystemABase;
> 
> +
> 
> +/**
> 
> +  Calling this function causes a system-wide reset. This sets
> 
> +  all circuitry within the system to its initial state. This type of reset
> 
> +  is asynchronous to system operation and operates without regard to
> 
> +  cycle boundaries.
> 
> +
> 
> +  System reset should not return, if it returns, it means the system does
> 
> +  not support cold reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetCold (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_FULLRESET);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Calling this function causes a system-wide initialization. The processors
> 
> +  are set to their initial state, and pending cycles are not corrupted.
> 
> +
> 
> +  System reset should not return, if it returns, it means the system does
> 
> +  not support warm reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetWarm (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_HARDRESET);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Calling this function causes the system to enter a power state equivalent
> 
> +  to the ACPI G2/S5 or G3 states.
> 
> +
> 
> +  System shutdown should not return, if it returns, it means the system
> does
> 
> +  not support shut down reset.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetShutdown (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT16         ABase;
> 
> +  UINT32         Data32;
> 
> +
> 
> +  ABase = mBaseResetSystemABase;
> 
> +  if (ABase == 0) {
> 
> +    ABase = PmcGetAcpiBase ();
> 
> +  }
> 
> +  ///
> 
> +  /// Firstly, GPE0_EN should be disabled to avoid any GPI waking up the
> system from S5
> 
> +  ///
> 
> +  IoWrite32 (ABase + R_ACPI_IO_GPE0_EN_127_96, 0);
> 
> +
> 
> +  ///
> 
> +  /// Secondly, PwrSts register must be cleared
> 
> +  ///
> 
> +  /// Write a "1" to bit[8] of power button status register at
> 
> +  /// (PM_BASE + PM1_STS_OFFSET) to clear this bit
> 
> +  ///
> 
> +  IoWrite16 (ABase + R_ACPI_IO_PM1_STS,
> B_ACPI_IO_PM1_STS_PWRBTN);
> 
> +
> 
> +  ///
> 
> +  /// Finally, transform system into S5 sleep state
> 
> +  ///
> 
> +  Data32 = IoRead32 (ABase + R_ACPI_IO_PM1_CNT);
> 
> +
> 
> +  Data32 = (UINT32) ((Data32 &~(B_ACPI_IO_PM1_CNT_SLP_TYP +
> B_ACPI_IO_PM1_CNT_SLP_EN)) | V_ACPI_IO_PM1_CNT_S5);
> 
> +
> 
> +  IoWrite32 (ABase + R_ACPI_IO_PM1_CNT, Data32);
> 
> +
> 
> +  Data32 = Data32 | B_ACPI_IO_PM1_CNT_SLP_EN;
> 
> +
> 
> +  IoWrite32 (ABase + R_ACPI_IO_PM1_CNT, Data32);
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Calling this function causes the system to enter a power state for platform
> specific.
> 
> +
> 
> +  @param[in] DataSize             The size of ResetData in bytes.
> 
> +  @param[in] ResetData            Optional element used to introduce a
> platform specific reset.
> 
> +                                  The exact type of the reset is defined by the EFI_GUID that
> follows
> 
> +                                  the Null-terminated Unicode string.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +ResetPlatformSpecific (
> 
> +  IN UINTN            DataSize,
> 
> +  IN VOID             *ResetData OPTIONAL
> 
> +  )
> 
> +{
> 
> +  IoWrite8 (R_PCH_IO_RST_CNT, V_PCH_IO_RST_CNT_FULLRESET);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Calling this function causes the system to enter a power state for capsule
> update.
> 
> +
> 
> +  Reset update should not return, if it returns, it means the system does
> 
> +  not support capsule update.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +EnterS3WithImmediateWake (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // In case there are pending capsules to process, need to flush the cache.
> 
> +  //
> 
> +  AsmWbinvd ();
> 
> +
> 
> +  ResetWarm ();
> 
> +  ASSERT (FALSE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  The library constructuor.
> 
> +
> 
> +  The function does the necessary initialization work for this library instance.
> 
> +
> 
> +  @retval     EFI_SUCCESS       The function always return EFI_SUCCESS for
> now.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +BaseResetSystemLibConstructor (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  mBaseResetSystemABase = PmcGetAcpiBase ();
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRes
> etSystemLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRe
> setSystemLib.inf
> new file mode 100644
> index 0000000000..a4f805035a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/BaseResetSystemLib/BaseRe
> setSystemLib.inf
> @@ -0,0 +1,38 @@
> +## @file
> 
> +# Component description file for Intel Ich7 Reset System Library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = BaseResetSystemLib
> 
> +FILE_GUID = D4FF05AA-3C7D-4B8A-A1EE-AA5EFA0B1732
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +UEFI_SPECIFICATION_VERSION = 2.00
> 
> +LIBRARY_CLASS = ResetSystemLib
> 
> +CONSTRUCTOR = BaseResetSystemLibConstructor
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +IoLib
> 
> +BaseLib
> 
> +DebugLib
> 
> +PmcLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +BaseResetSystemLib.c
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.c
> new file mode 100644
> index 0000000000..90aea8f420
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.c
> @@ -0,0 +1,198 @@
> +/** @file
> 
> +  This file provide services for DXE phase policy default initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <ConfigBlock.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/SiConfigBlockLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <ScsConfig.h>
> 
> +#include <Library/DxeGpioPolicyLib.h>
> 
> +#include <Library/DxeHdaPolicyLib.h>
> 
> +#include <Library/DxePchPcieRpPolicyLib.h>
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for eMMC
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +LoadEmmcDxeConfigDefault (
> 
> +  IN VOID          *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  SCS_EMMC_DXE_CONFIG  *EmmcDxeConfig;
> 
> +  EmmcDxeConfig = ConfigBlockPointer;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "EmmcDxeConfig->Header.GuidHob.Name =
> %g\n", &EmmcDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "EmmcDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", EmmcDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +
> 
> +  EmmcDxeConfig->DriverStrength = DriverStrength40Ohm;
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED COMPONENT_BLOCK_ENTRY
> mPchDxeIpBlocks [] = {
> 
> +  {&gEmmcDxeConfigGuid,    sizeof (SCS_EMMC_DXE_CONFIG),
> SCS_EMMC_DXE_CONFIG_REVISION, LoadEmmcDxeConfigDefault}
> 
> +};
> 
> +
> 
> +/**
> 
> +  Print SCS_EMMC_DXE_CONFIG.
> 
> +
> 
> +  @param[in] EmmcDxeConfig         Pointer to a SCS_EMMC_DXE_CONFIG
> that provides the eMMC settings
> 
> +**/
> 
> +VOID
> 
> +PchPrintEmmcDxeConfig (
> 
> +  IN CONST SCS_EMMC_DXE_CONFIG  *EmmcDxeConfig
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "------------------ PCH eMMC DXE Config -------------
> -----\n"));
> 
> +  DEBUG ((DEBUG_INFO, " DriverStrength : %d\n", EmmcDxeConfig-
> >DriverStrength));
> 
> +  DEBUG ((DEBUG_INFO, " EnableSoftwareHs400Tuning: %d\n",
> EmmcDxeConfig->EnableSoftwareHs400Tuning));
> 
> +  DEBUG ((DEBUG_INFO, " TuningLba : %X\n", EmmcDxeConfig-
> >TuningLba));
> 
> +  DEBUG ((DEBUG_INFO, " Previous tuning success : %d\n",
> EmmcDxeConfig->PreviousTuningResults.TuningSuccessful));
> 
> +  if (EmmcDxeConfig->PreviousTuningResults.TuningSuccessful) {
> 
> +    DEBUG ((DEBUG_INFO, "  Hs400 Rx DLL value : %X\n", EmmcDxeConfig-
> >PreviousTuningResults.Hs400RxValue));
> 
> +    DEBUG ((DEBUG_INFO, "  Hs400 Tx DLL value : %X\n", EmmcDxeConfig-
> >PreviousTuningResults.Hs400TxValue));
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function prints the PCH DXE phase policy.
> 
> +
> 
> +  @param[in] PchPolicy - PCH DXE Policy protocol
> 
> +**/
> 
> +VOID
> 
> +PchPrintPolicyProtocol (
> 
> +  IN  PCH_POLICY_PROTOCOL      *PchPolicy
> 
> +  )
> 
> +{
> 
> +  DEBUG_CODE_BEGIN();
> 
> +  EFI_STATUS                 Status;
> 
> +  SCS_EMMC_DXE_CONFIG        *EmmcDxeConfig;
> 
> +
> 
> +  //
> 
> +  // Get requisite IP Config Blocks which needs to be used here
> 
> +  //
> 
> +  Status = GetConfigBlock ((VOID *) PchPolicy, &gEmmcDxeConfigGuid,
> (VOID *)&EmmcDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------ PCH Policy (DXE) Print Start --
> ----------------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " Revision : %x\n", PchPolicy-
> >TableHeader.Header.Revision));
> 
> +
> 
> +  PchPrintEmmcDxeConfig (EmmcDxeConfig);
> 
> +  GpioDxePrintConfig (PchPolicy);
> 
> +  HdaDxePrintConfig (PchPolicy);
> 
> +  PchPcieRpDxePrintConfig (PchPolicy);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------ PCH Policy (DXE) Print End ---
> -----------------------\n"));
> 
> +  DEBUG_CODE_END();
> 
> +}
> 
> +
> 
> +/**
> 
> +  CreatePchDxeConfigBlocks generates the config blocksg of PCH DXE Policy.
> 
> +  It allocates and zero out buffer, and fills in the Intel default settings.
> 
> +
> 
> +  @param[out] PchPolicy                 The pointer to get PCH DXE Protocol
> instance
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +CreatePchDxeConfigBlocks (
> 
> +  IN OUT  PCH_POLICY_PROTOCOL      **DxePchPolicy
> 
> +  )
> 
> +{
> 
> +  UINT16              TotalBlockSize;
> 
> +  EFI_STATUS          Status;
> 
> +  PCH_POLICY_PROTOCOL *PchPolicyInit;
> 
> +  UINT16              RequiredSize;
> 
> +
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PCH Create Dxe Config Blocks\n"));
> 
> +
> 
> +  PchPolicyInit = NULL;
> 
> +
> 
> +  TotalBlockSize = GetComponentConfigBlockTotalSize
> (&mPchDxeIpBlocks[0], sizeof (mPchDxeIpBlocks) / sizeof
> (COMPONENT_BLOCK_ENTRY));
> 
> +  TotalBlockSize += GpioDxeGetConfigBlockTotalSize();
> 
> +  TotalBlockSize += HdaDxeGetConfigBlockTotalSize();
> 
> +  TotalBlockSize += PchPcieRpDxeGetConfigBlockTotalSize();
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "TotalBlockSize = 0x%x\n", TotalBlockSize));
> 
> +
> 
> +  RequiredSize = sizeof (CONFIG_BLOCK_TABLE_HEADER) + TotalBlockSize;
> 
> +
> 
> +  Status = CreateConfigBlockTable (RequiredSize, (VOID *) &PchPolicyInit);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // General initialization
> 
> +  //
> 
> +  PchPolicyInit->TableHeader.Header.Revision =
> PCH_POLICY_PROTOCOL_REVISION;
> 
> +  //
> 
> +  // Add config blocks.
> 
> +  //
> 
> +  Status =  AddComponentConfigBlocks ((VOID *) PchPolicyInit,
> &mPchDxeIpBlocks[0], sizeof (mPchDxeIpBlocks) / sizeof
> (COMPONENT_BLOCK_ENTRY));
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status =  GpioDxeAddConfigBlock ((VOID *) PchPolicyInit);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status =  HdaDxeAddConfigBlock ((VOID *) PchPolicyInit);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = PchPcieRpDxeAddConfigBlock ((VOID *) PchPolicyInit);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Assignment for returning SaInitPolicy config block base address
> 
> +  //
> 
> +  *DxePchPolicy = PchPolicyInit;
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PchInstallPolicyProtocol installs PCH Policy.
> 
> +  While installed, RC assumes the Policy is ready and finalized. So please
> update and override
> 
> +  any setting before calling this function.
> 
> +
> 
> +  @param[in] ImageHandle                Image handle of this driver.
> 
> +  @param[in] SaPolicy                   The pointer to SA Policy Protocol instance
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy is installed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchInstallPolicyProtocol (
> 
> +  IN  EFI_HANDLE                  ImageHandle,
> 
> +  IN  PCH_POLICY_PROTOCOL         *PchPolicy
> 
> +  )
> 
> +{
> 
> +
> 
> +  EFI_STATUS            Status;
> 
> +
> 
> +  ///
> 
> +  /// Print PCH DXE Policy
> 
> +  ///
> 
> +  PchPrintPolicyProtocol (PchPolicy);
> 
> +
> 
> +  ///
> 
> +  /// Install protocol to to allow access to this Policy.
> 
> +  ///
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gPchPolicyProtocolGuid,
> 
> +                  PchPolicy,
> 
> +                  NULL
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.inf
> new file mode 100644
> index 0000000000..50e5cdacfd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/DxePchPolicyLib/DxePchPolic
> yLib.inf
> @@ -0,0 +1,43 @@
> +## @file
> 
> +# Component description file for the PeiPchPolicy library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxePchPolicyLib
> 
> +FILE_GUID = E2179D04-7026-48A5-9475-309CEA2F21A3
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxePchPolicyLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseMemoryLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +ConfigBlockLib
> 
> +SiConfigBlockLib
> 
> +PchInfoLib
> 
> +DxeGpioPolicyLib
> 
> +DxeHdaPolicyLib
> 
> +DxePchPcieRpPolicyLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +DxePchPolicyLib.c
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gEmmcDxeConfigGuid
> 
> +
> 
> +[Protocols]
> 
> +gPchPolicyProtocolGuid ## PRODUCES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PchCycleDecodingLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PchCycleDecodingLib.c
> new file mode 100644
> index 0000000000..0927cd1ced
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PchCycleDecodingLib.c
> @@ -0,0 +1,587 @@
> +/** @file
> 
> +  PCH cycle decoding configuration and query library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PchDmiLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/SmbusRegs.h>
> 
> +#include <Library/EspiLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +typedef enum {
> 
> +  SlaveLpcEspiCS0,
> 
> +  SlaveEspiCS1,
> 
> +  SlaveId_Max
> 
> +} SLAVE_ID_INDEX;
> 
> +
> 
> +/**
> 
> +  Get PCH TCO base address.
> 
> +
> 
> +  @param[out] Address                   Address of TCO base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid pointer passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchTcoBaseGet (
> 
> +  OUT UINT16                            *Address
> 
> +  )
> 
> +{
> 
> +  if (Address == NULL) {
> 
> +    DEBUG ((DEBUG_ERROR, "PchTcoBaseGet Error. Invalid pointer.\n"));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Read "TCO Base Address" from DMI
> 
> +  // Don't read TCO base address from SMBUS PCI register since SMBUS
> might be disabled.
> 
> +  //
> 
> +  *Address = PchDmiGetTcoBase ();
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI and eSPI CS1# generic IO range decoding.
> 
> +
> 
> +  Steps of programming generic IO range:
> 
> +  1. Program LPC/eSPI PCI Offset 84h ~ 93h (LPC, eSPI CS0#) or A4h (eSPI
> CS1#) of Mask, Address, and Enable.
> 
> +  2. Program LPC/eSPI Generic IO Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range decoding.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +  @param[in] SlaveId                    Slave ID (refer to SLAVE_ID_INDEX)
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
> 
> +  @retval EFI_UNSUPPORTED               DMI configuration is locked,
> 
> +                                        GenIO range conflicting with other eSPI CS
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +LpcEspiGenIoRangeSetHelper (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  UINT32                            Length,
> 
> +  IN  SLAVE_ID_INDEX                    SlaveId
> 
> +  )
> 
> +{
> 
> +  return EFI_UNSUPPORTED;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI generic IO range.
> 
> +  For generic IO range, the base address must align to 4 and less than
> 0xFFFF, and the length must be power of 2
> 
> +  and less than or equal to 256. Moreover, the address must be length
> aligned.
> 
> +  This function basically checks the address and length, which should not
> overlap with all other generic ranges.
> 
> +  If no more generic range register available, it returns out of resource error.
> 
> +  This cycle decoding is also required on DMI side
> 
> +  Some IO ranges below 0x100 have fixed target. The target might be
> ITSS,RTC,LPC,PMC or terminated inside P2SB
> 
> +  but all predefined and can't be changed. IO range below 0x100 will be
> rejected in this function except below ranges:
> 
> +    0x00-0x1F,
> 
> +    0x44-0x4B,
> 
> +    0x54-0x5F,
> 
> +    0x68-0x6F,
> 
> +    0x80-0x8F,
> 
> +    0xC0-0xFF
> 
> +  Steps of programming generic IO range:
> 
> +  1. Program LPC/eSPI PCI Offset 84h ~ 93h of Mask, Address, and Enable.
> 
> +  2. Program LPC/eSPI Generic IO Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for generic IO range base address.
> 
> +  @param[in] Length                     Length of generic IO range.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcGenIoRangeSet (
> 
> +  IN  UINT16                            Address,
> 
> +  IN  UINTN                             Length
> 
> +  )
> 
> +{
> 
> +  return LpcEspiGenIoRangeSetHelper ((UINT32)Address, (UINT32)Length,
> SlaveLpcEspiCS0);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI and eSPI CS1# memory range decoding.
> 
> +  This cycle decoding is required to be set on DMI side
> 
> +  Programming steps:
> 
> +  1. Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [0]
> to [0] to disable memory decoding first before changing base address.
> 
> +  2. Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#)
> [31:16, 0] to [Address, 1].
> 
> +  3. Program LPC/eSPI Memory Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory for decoding.
> 
> +  @param[in] RangeIndex                 Slave ID (refer to SLAVE_ID_INDEX)
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +LpcEspiMemRangeSetHelper (
> 
> +  IN  UINT32                            Address,
> 
> +  IN  SLAVE_ID_INDEX                    SlaveId
> 
> +  )
> 
> +{
> 
> +  UINT64                                LpcBase;
> 
> +  EFI_STATUS                            Status;
> 
> +  UINT32                                GenMemReg;
> 
> +  UINT32                                MemRangeAddr;
> 
> +
> 
> +  if (((Address & (~B_LPC_CFG_LGMR_MA)) != 0) || (SlaveId >=
> SlaveId_Max)) {
> 
> +    DEBUG ((DEBUG_ERROR, "%a Error. Invalid Address: %x or invalid
> SlaveId\n", __FUNCTION__, Address));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  LpcBase = LpcPciCfgBase ();
> 
> +
> 
> +  MemRangeAddr = ~Address;
> 
> +  if (SlaveId == SlaveEspiCS1) {
> 
> +    GenMemReg = R_ESPI_CFG_CS1GMR1;
> 
> +    // Memory Range already decoded for LPC/eSPI?
> 
> +    Status = PchLpcMemRangeGet (&MemRangeAddr);
> 
> +    if (MemRangeAddr != Address) {
> 
> +      Status = PchDmiSetEspiCs1MemRange (Address);
> 
> +      if (EFI_ERROR (Status)) {
> 
> +        ASSERT_EFI_ERROR (Status);
> 
> +        return Status;
> 
> +      }
> 
> +    }
> 
> +  } else {
> 
> +    GenMemReg = R_LPC_CFG_LGMR;
> 
> +    // Memory Range already decoded for eSPI CS1?
> 
> +    Status = PchEspiCs1MemRangeGet (&MemRangeAddr);
> 
> +    if (MemRangeAddr != Address) {
> 
> +      Status = PchDmiSetLpcMemRange (Address);
> 
> +      if (EFI_ERROR (Status)) {
> 
> +        ASSERT_EFI_ERROR (Status);
> 
> +        return Status;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#) [0]
> to [0] to disable memory decoding first before changing base address.
> 
> +  //
> 
> +  PciSegmentAnd32 (
> 
> +    LpcBase + GenMemReg,
> 
> +    (UINT32) ~B_LPC_CFG_LGMR_LMRD_EN
> 
> +    );
> 
> +  //
> 
> +  // Program LPC/eSPI PCI Offset 98h (LPC, eSPI CS0#) or A8h (eSPI CS1#)
> [31:16, 0] to [Address, 1].
> 
> +  //
> 
> +  PciSegmentWrite32 (
> 
> +    LpcBase + GenMemReg,
> 
> +    (Address | B_LPC_CFG_LGMR_LMRD_EN)
> 
> +    );
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI memory range decoding.
> 
> +  This cycle decoding is required to be set on DMI side
> 
> +  Programming steps:
> 
> +  1. Program LPC PCI Offset 98h [0] to [0] to disable memory decoding first
> before changing base address.
> 
> +  2. Program LPC PCI Offset 98h [31:16, 0] to [Address, 1].
> 
> +  3. Program LPC Memory Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          No more generic range available.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcMemRangeSet (
> 
> +  IN  UINT32                            Address
> 
> +  )
> 
> +{
> 
> +  return LpcEspiMemRangeSetHelper (Address, SlaveLpcEspiCS0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# memory range decoding.
> 
> +  This cycle decoding is required to be set on DMI side
> 
> +  Programming steps:
> 
> +  1. Program eSPI PCI Offset A8h (eSPI CS1#) [0] to [0] to disable memory
> decoding first before changing base address.
> 
> +  2. Program eSPI PCI Offset A8h (eSPI CS1#) [31:16, 0] to [Address, 1].
> 
> +  3. Program eSPI Memory Range in DMI
> 
> +
> 
> +  @param[in] Address                    Address for memory for decoding.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address or length
> passed.
> 
> +  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1MemRangeSet (
> 
> +  IN  UINT32                            Address
> 
> +  )
> 
> +{
> 
> +  if (!IsEspiSecondSlaveSupported ()) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  return LpcEspiMemRangeSetHelper (Address, SlaveEspiCS1);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH LPC/eSPI and eSPI CS1# memory range decoding address.
> 
> +
> 
> +  @param[in]  SlaveId                   Slave ID (refer to SLAVE_ID_INDEX)
> 
> +  @param[out] Address                   Address of LPC/eSPI or eSPI CS1# memory
> decoding base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
> 
> +  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +LpcEspiMemRangeGetHelper (
> 
> +  IN  SLAVE_ID_INDEX                    SlaveId,
> 
> +  OUT UINT32                            *Address
> 
> +  )
> 
> +{
> 
> +  UINT32                                GenMemReg;
> 
> +
> 
> +  if ((Address == NULL) || (SlaveId >= SlaveId_Max)) {
> 
> +    DEBUG ((DEBUG_ERROR, "%a Error. Invalid pointer or SlaveId.\n",
> __FUNCTION__));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (SlaveId == SlaveEspiCS1) {
> 
> +    GenMemReg = R_ESPI_CFG_CS1GMR1;
> 
> +  } else {
> 
> +    GenMemReg = R_LPC_CFG_LGMR;
> 
> +  }
> 
> +  *Address = PciSegmentRead32 (LpcPciCfgBase () + GenMemReg) &
> B_LPC_CFG_LGMR_MA;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH LPC/eSPI memory range decoding address.
> 
> +
> 
> +  @param[out] Address                   Address of LPC/eSPI memory decoding
> base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcMemRangeGet (
> 
> +  OUT UINT32                            *Address
> 
> +  )
> 
> +{
> 
> +  return LpcEspiMemRangeGetHelper (SlaveLpcEspiCS0, Address);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH eSPI CS1# memory range decoding address.
> 
> +
> 
> +  @param[out] Address                   Address of eSPI CS1# memory decoding
> base address.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid base address passed.
> 
> +  @retval EFI_UNSUPPORTED               eSPI secondary slave not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1MemRangeGet (
> 
> +  OUT UINT32                            *Address
> 
> +  )
> 
> +{
> 
> +  if (!IsEspiSecondSlaveSupported ()) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  return LpcEspiMemRangeGetHelper (SlaveEspiCS1, Address);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH BIOS range deocding.
> 
> +  This will check General Control and Status bit 10 (GCS.BBS) to identify SPI
> or LPC/eSPI and program BDE register accordingly.
> 
> +  Please check EDS for detail of BiosDecodeEnable bit definition.
> 
> +    bit 15: F8-FF Enable
> 
> +    bit 14: F0-F8 Enable
> 
> +    bit 13: E8-EF Enable
> 
> +    bit 12: E0-E8 Enable
> 
> +    bit 11: D8-DF Enable
> 
> +    bit 10: D0-D7 Enable
> 
> +    bit  9: C8-CF Enable
> 
> +    bit  8: C0-C7 Enable
> 
> +    bit  7: Legacy F Segment Enable
> 
> +    bit  6: Legacy E Segment Enable
> 
> +    bit  5: Reserved
> 
> +    bit  4: Reserved
> 
> +    bit  3: 70-7F Enable
> 
> +    bit  2: 60-6F Enable
> 
> +    bit  1: 50-5F Enable
> 
> +    bit  0: 40-4F Enable
> 
> +  This cycle decoding is also required in DMI
> 
> +  Programming steps:
> 
> +  1. if GCS.BBS is 0 (SPI), program SPI offset D8h to BiosDecodeEnable.
> 
> +     if GCS.BBS is 1 (LPC/eSPi), program LPC offset D8h to BiosDecodeEnable.
> 
> +  2. program LPC BIOS Decode Enable in DMI
> 
> +
> 
> +  @param[in] BiosDecodeEnable           Bios decode enable setting.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchBiosDecodeEnableSet (
> 
> +  IN  UINT16                            BiosDecodeEnable
> 
> +  )
> 
> +{
> 
> +  UINT64                                BaseAddr;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  Status = PchDmiSetBiosDecodeEnable (BiosDecodeEnable);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check Boot BIOS Strap in DMI
> 
> +  //
> 
> +  if (PchDmiIsBootBiosStrapSetForSpi ()) {
> 
> +    BaseAddr = SpiPciCfgBase ();
> 
> +    //
> 
> +    // If SPI, Program SPI offset D8h to BiosDecodeEnable.
> 
> +    //
> 
> +    PciSegmentWrite16 (BaseAddr + R_SPI_CFG_BDE, BiosDecodeEnable);
> 
> +  } else {
> 
> +    BaseAddr = LpcPciCfgBase ();
> 
> +    //
> 
> +    // If LPC/eSPi, program LPC offset D8h to BiosDecodeEnable.
> 
> +    //
> 
> +    PciSegmentWrite16 (BaseAddr + R_LPC_CFG_BDE, BiosDecodeEnable);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI IO decode ranges.
> 
> +  Program LPC/eSPI I/O Decode Ranges in DMI to the same value
> programmed in LPC/eSPI PCI offset 80h.
> 
> +  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
> 
> +  Bit  12: FDD range
> 
> +  Bit 9:8: LPT range
> 
> +  Bit 6:4: ComB range
> 
> +  Bit 2:0: ComA range
> 
> +
> 
> +  @param[in] LpcIoDecodeRanges          LPC/eSPI IO decode ranges bit
> settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcIoDecodeRangesSet (
> 
> +  IN  UINT16                            LpcIoDecodeRanges
> 
> +  )
> 
> +{
> 
> +  UINT64                                LpcBaseAddr;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Note: Inside this function, don't use debug print since it's could used
> before debug print ready.
> 
> +  //
> 
> +
> 
> +  LpcBaseAddr = LpcPciCfgBase ();
> 
> +
> 
> +  //
> 
> +  // check if setting is identical
> 
> +  //
> 
> +  if (LpcIoDecodeRanges == PciSegmentRead16 (LpcBaseAddr +
> R_LPC_CFG_IOD)) {
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  Status = PchDmiSetLpcIoDecodeRanges (LpcIoDecodeRanges);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // program LPC/eSPI PCI offset 80h.
> 
> +  //
> 
> +  PciSegmentWrite16 (LpcBaseAddr + R_LPC_CFG_IOD,
> LpcIoDecodeRanges);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC/eSPI and eSPI CS1# IO enable decoding.
> 
> +  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset
> 82h (LPC, eSPI CS0#) or A0h (eSPI CS1#).
> 
> +  Note: Bit[15:10] of the source decode register is Read-Only. The IO range
> indicated by the Enables field
> 
> +  in LPC/eSPI PCI offset 82h[13:10] or A0h[13:10] is always forwarded by DMI
> to subtractive agent for handling.
> 
> +  Please check EDS for detail of Lpc/eSPI IO decode ranges bit definition.
> 
> +
> 
> +  @param[in] IoEnableDecoding           LPC/eSPI IO enable decoding bit
> settings.
> 
> +  @param[in] SlaveId                    Slave ID (refer to SLAVE_ID_INDEX)
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMI configuration is locked
> 
> +**/
> 
> +EFI_STATUS
> 
> +LpcEspiIoEnableDecodingSetHelper (
> 
> +  IN  UINT16                            IoEnableDecoding,
> 
> +  IN  SLAVE_ID_INDEX                    SlaveId
> 
> +  )
> 
> +{
> 
> +  UINT64      LpcBaseAddr;
> 
> +  EFI_STATUS  Status;
> 
> +  UINT16      Cs1IoEnableDecodingOrg;
> 
> +  UINT16      Cs0IoEnableDecodingOrg;
> 
> +  UINT16      IoEnableDecodingMerged;
> 
> +
> 
> +  LpcBaseAddr = LpcPciCfgBase ();
> 
> +
> 
> +  Cs0IoEnableDecodingOrg = PciSegmentRead16 (LpcBaseAddr +
> R_LPC_CFG_IOE);
> 
> +
> 
> +  if (IsEspiSecondSlaveSupported ()) {
> 
> +    Cs1IoEnableDecodingOrg = PciSegmentRead16 (LpcBaseAddr +
> R_ESPI_CFG_CS1IORE);
> 
> +  } else {
> 
> +    Cs1IoEnableDecodingOrg = 0;
> 
> +  }
> 
> +
> 
> +  if (SlaveId == SlaveEspiCS1) {
> 
> +    if (IoEnableDecoding == Cs1IoEnableDecodingOrg) {
> 
> +      return EFI_SUCCESS;
> 
> +    } else {
> 
> +      IoEnableDecodingMerged = (Cs0IoEnableDecodingOrg |
> IoEnableDecoding);
> 
> +    }
> 
> +  } else {
> 
> +    if ((IoEnableDecoding | Cs1IoEnableDecodingOrg) ==
> Cs0IoEnableDecodingOrg) {
> 
> +      return EFI_SUCCESS;
> 
> +    } else {
> 
> +      IoEnableDecodingMerged = (Cs1IoEnableDecodingOrg |
> IoEnableDecoding);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Status = PchDmiSetLpcIoEnable (IoEnableDecodingMerged);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // program PCI offset 82h for LPC/eSPI.
> 
> +  //
> 
> +  PciSegmentWrite16 (LpcBaseAddr + R_LPC_CFG_IOE,
> IoEnableDecodingMerged);
> 
> +
> 
> +  if (SlaveId == SlaveEspiCS1) {
> 
> +    //
> 
> +    // For eSPI CS1# device program eSPI PCI offset A0h.
> 
> +    //
> 
> +    PciSegmentWrite16 (LpcBaseAddr + R_ESPI_CFG_CS1IORE,
> IoEnableDecoding);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH LPC and eSPI CS0# IO enable decoding.
> 
> +  Setup I/O Enables in DMI to the same value program in LPC/eSPI PCI offset
> 82h.
> 
> +  Note: Bit[15:10] of the source decode register is Read-Only. The IO range
> indicated by the Enables field
> 
> +  in LPC/eSPI PCI offset 82h[13:10] is always forwarded by DMI to
> subtractive agent for handling.
> 
> +  Please check EDS for detail of LPC/eSPI IO decode ranges bit definition.
> 
> +
> 
> +  @param[in] LpcIoEnableDecoding        LPC IO enable decoding bit settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMIC.SRL is set.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchLpcIoEnableDecodingSet (
> 
> +  IN  UINT16                            LpcIoEnableDecoding
> 
> +  )
> 
> +{
> 
> +  return LpcEspiIoEnableDecodingSetHelper (LpcIoEnableDecoding,
> SlaveLpcEspiCS0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set PCH eSPI CS1# IO enable decoding.
> 
> +  Setup I/O Enables in DMI to the same value program in eSPI PCI offset A0h
> (eSPI CS1#).
> 
> +  Note: Bit[15:10] of the source decode register is Read-Only. The IO range
> indicated by the Enables field
> 
> +  in eSPI PCI offset A0h[13:10] is always forwarded by DMI to subtractive
> agent for handling.
> 
> +  Please check EDS for detail of eSPI IO decode ranges bit definition.
> 
> +
> 
> +  @param[in] IoEnableDecoding           eSPI IO enable decoding bit settings.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_UNSUPPORTED               DMI configuration is locked
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchEspiCs1IoEnableDecodingSet (
> 
> +  IN  UINT16                            IoEnableDecoding
> 
> +  )
> 
> +{
> 
> +  if (!IsEspiSecondSlaveSupported ()) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  return LpcEspiIoEnableDecodingSetHelper (IoEnableDecoding,
> SlaveEspiCS1);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Get IO APIC regsiters base address.
> 
> +
> 
> +  @param[out] IoApicBase                Buffer of IO APIC regsiter address
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchIoApicBaseGet (
> 
> +  OUT UINT32                            *IoApicBase
> 
> +  )
> 
> +{
> 
> +  *IoApicBase = PcdGet32 (PcdSiIoApicBaseAddress);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get HPET base address.
> 
> +
> 
> +  @param[out] HpetBase                  Buffer of HPET base address
> 
> +
> 
> +  @retval EFI_SUCCESS                   Successfully completed.
> 
> +  @retval EFI_INVALID_PARAMETER         Invalid offset passed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchHpetBaseGet (
> 
> +  OUT UINT32                            *HpetBase
> 
> +  )
> 
> +{
> 
> +  if (HpetBase == NULL) {
> 
> +    DEBUG ((DEBUG_ERROR, "PchHpetBaseGet Error. Invalid pointer.\n"));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  *HpetBase = PcdGet32 (PcdSiHpetBaseAddress);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PeiDxeSmmPchCycleDecodingLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PeiDxeSmmPchCycleDecodingLib.inf
> new file mode 100644
> index 0000000000..ea6b434f29
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchCycleDecodin
> gLib/PeiDxeSmmPchCycleDecodingLib.inf
> @@ -0,0 +1,42 @@
> +## @file
> 
> +# PCH cycle decoding Lib.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchCycleDecodingLib
> 
> +FILE_GUID = 676C749F-9CD1-46B7-BAFD-4B1BC36B4C8E
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchCycleDecodingLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PciSegmentLib
> 
> +PchInfoLib
> 
> +PchPcrLib
> 
> +PchDmiLib
> 
> +EspiLib
> 
> +PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +PchCycleDecodingLib.c
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiHpetBaseAddress        ## CONSUMES
> 
> +gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress      ## CONSUMES
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInf
> oLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLib.c
> new file mode 100644
> index 0000000000..df8a23d5a3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLib.c
> @@ -0,0 +1,127 @@
> +/** @file
> 
> +  Pch information library.
> 
> +
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PrintLib.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include "PchInfoLibPrivate.h"
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <PchPcieRpInfo.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Return Pch Series
> 
> +
> 
> +  @retval PCH_SERIES            Pch Series
> 
> +**/
> 
> +PCH_SERIES
> 
> +PchSeries (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return PCH_LP;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return Pch stepping type
> 
> +
> 
> +  @retval PCH_STEPPING            Pch stepping type
> 
> +**/
> 
> +PCH_STEPPING
> 
> +PchStepping (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if this is TGL PCH generation
> 
> +
> 
> +  @retval TRUE                It's TGL PCH
> 
> +  @retval FALSE               It's not TGL PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +IsTglPch (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return (PchGeneration () == TGL_PCH);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get PCH stepping ASCII string.
> 
> +  Function determines major and minor stepping versions and writes them
> into a buffer.
> 
> +  The return string is zero terminated
> 
> +
> 
> +  @param [out]     Buffer               Output buffer of string
> 
> +  @param [in]      BufferSize           Buffer size.
> 
> +                                        Must not be less then
> PCH_STEPPING_STR_LENGTH_MAX
> 
> +
> 
> +  @retval EFI_SUCCESS                   String copied successfully
> 
> +  @retval EFI_INVALID_PARAMETER         The stepping is not supported, or
> parameters are NULL
> 
> +  @retval EFI_BUFFER_TOO_SMALL          Input buffer size is too small
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchGetSteppingStr (
> 
> +  OUT    CHAR8                          *Buffer,
> 
> +  IN     UINT32                         BufferSize
> 
> +  )
> 
> +{
> 
> +  PCH_STEPPING PchStep;
> 
> +
> 
> +  PchStep = PchStepping ();
> 
> +
> 
> +  if ((Buffer == NULL) || (BufferSize == 0)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  if (BufferSize < PCH_STEPPING_STR_LENGTH_MAX) {
> 
> +    return EFI_BUFFER_TOO_SMALL;
> 
> +  }
> 
> +
> 
> +  PchPrintSteppingStr (Buffer, BufferSize, PchStep);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Controller Number
> 
> +
> 
> +  @retval Pch Maximum Pcie Root Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieControllerNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return GetPchMaxPciePortNum () / PCH_PCIE_CONTROLLER_PORTS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  return support status for P2SB PCR 20-bit addressing
> 
> +
> 
> +  @retval    TRUE
> 
> +  @retval    FALSE
> 
> +**/
> 
> +BOOLEAN
> 
> +IsP2sb20bPcrSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInf
> oLibPrivate.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLibPrivate.h
> new file mode 100644
> index 0000000000..a93c3dbafd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLibPrivate.h
> @@ -0,0 +1,58 @@
> +/** @file
> 
> +  Private header for PCH Info Lib.
> 
> +
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +/**
> 
> +  Structure for PCH SKU string mapping
> 
> +**/
> 
> +struct PCH_SKU_STRING {
> 
> +  UINT16        Id;
> 
> +  CHAR8         *String;
> 
> +};
> 
> +
> 
> +/**
> 
> +  Determine Pch Series based on Device Id
> 
> +
> 
> +  @param[in] LpcDeviceId      Lpc Device Id
> 
> +
> 
> +  @retval PCH_SERIES          Pch Series
> 
> +**/
> 
> +PCH_SERIES
> 
> +PchSeriesFromLpcDid (
> 
> +  IN UINT16 LpcDeviceId
> 
> +  );
> 
> +
> 
> +/**
> 
> +Determine Pch Generation based on Device Id
> 
> +
> 
> +@param[in] LpcDeviceId            Lpc Device Id
> 
> +
> 
> +@retval PCH_GENERATION            Pch Generation
> 
> +**/
> 
> +PCH_GENERATION
> 
> +PchGenerationFromDid (
> 
> +  IN UINT16 LpcDeviceId
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Print Pch Stepping String
> 
> +
> 
> +  @param[out] Buffer         Output buffer of string
> 
> +  @param[in]  BufferSize     Buffer Size
> 
> +  @param[in]  PchStep        Pch Stepping Type
> 
> +
> 
> +  @retval VOID
> 
> +**/
> 
> +VOID
> 
> +PchPrintSteppingStr (
> 
> +  OUT CHAR8        *Buffer,
> 
> +  IN  UINT32       BufferSize,
> 
> +  IN  PCH_STEPPING PchStep
> 
> +  );
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchInf
> oLibTgl.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLibTgl.c
> new file mode 100644
> index 0000000000..bb3c7975e8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PchIn
> foLibTgl.c
> @@ -0,0 +1,715 @@
> +/** @file
> 
> +  Pch information library for TGL.
> 
> +
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include "PchInfoLibPrivate.h"
> 
> +#include <Library/PrintLib.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +
> 
> +/**
> 
> +  Print Pch Stepping String
> 
> +
> 
> +  @param[out] Buffer         Output buffer of string
> 
> +  @param[in]  BufferSize     Buffer Size
> 
> +  @param[in]  PchStep        Pch Stepping Type
> 
> +
> 
> +  @retval VOID
> 
> +**/
> 
> +VOID
> 
> +PchPrintSteppingStr (
> 
> +  OUT CHAR8        *Buffer,
> 
> +  IN  UINT32       BufferSize,
> 
> +  IN  PCH_STEPPING PchStep
> 
> +  )
> 
> +{
> 
> +  AsciiSPrint (Buffer, BufferSize, "%c%c", 'A' + (PchStep >> 4), '0' + (PchStep
> & 0xF));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Return Pch Generation
> 
> +
> 
> +  @retval PCH_GENERATION      Pch Generation
> 
> +**/
> 
> +PCH_GENERATION
> 
> +PchGeneration (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TGL_PCH;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Get PCH series ASCII string.
> 
> +
> 
> +  @retval PCH Series string
> 
> +**/
> 
> +CHAR8*
> 
> +PchGetSeriesStr (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries ()) {
> 
> +
> 
> +    case PCH_LP:
> 
> +      return "TGL PCH-LP";
> 
> +
> 
> +    default:
> 
> +      return NULL;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Clock Number
> 
> +
> 
> +  @retval Pch Maximum Pcie Clock Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieClockNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 7;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie ClockReq Number
> 
> +
> 
> +  @retval Pch Maximum Pcie ClockReq Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPcieClockReqNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return GetPchMaxPcieClockNum ();
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Type C Port Number
> 
> +
> 
> +  @retval Pch Maximum Type C Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxTypeCPortNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries ()) {
> 
> +    case PCH_LP:
> 
> +      return 4;
> 
> +    default:
> 
> +      return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether integrated LAN controller is supported by PCH Series.
> 
> +
> 
> +  @retval TRUE                    GbE is supported in current PCH
> 
> +  @retval FALSE                   GbE is not supported on current PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsGbeSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether integrated TSN is supported by PCH Series.
> 
> +
> 
> +  @retval TRUE                    TSN is supported in current PCH
> 
> +  @retval FALSE                   TSN is not supported on current PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsTsnSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
> 
> +  return TRUE;
> 
> +#else
> 
> +  return FALSE;
> 
> +#endif
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether ISH is supported by PCH Series.
> 
> +
> 
> +  @retval TRUE                    ISH is supported in current PCH
> 
> +  @retval FALSE                   ISH is not supported on current PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +PchIsIshSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Pcie Root Port Number
> 
> +
> 
> +  @retval Pch Maximum Pcie Root Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxPciePortNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries ()) {
> 
> +    case PCH_LP:
> 
> +      return 12;
> 
> +    default:
> 
> +      return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Dmic Link
> 
> +
> 
> +  @retval Pch Maximum Hda Dmic Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxDmicLinkNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Sndw Link
> 
> +
> 
> +  @retval Pch Maximum Hda Sndw Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxSndwLinkNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 4;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Hda Ssp Link
> 
> +
> 
> +  @retval Pch Maximum Hda Ssp Link
> 
> +**/
> 
> +UINT8
> 
> +GetPchHdaMaxSspLinkNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 3;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if given Audio Interface is supported
> 
> +
> 
> +  @param[in] AudioLinkType   Link type support to be checked
> 
> +  @param[in] AudioLinkIndex  Link number
> 
> +
> 
> +  @retval    TRUE           Link supported
> 
> +  @retval    FALSE          Link not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsAudioInterfaceSupported (
> 
> +  IN HDAUDIO_LINK_TYPE     AudioLinkType,
> 
> +  IN UINT32                AudioLinkIndex
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Interfaces supported:
> 
> +  // 1. HDA Link (SDI0/SDI1)
> 
> +  // 2. Display Audio Link (SDI2)
> 
> +  // 3. SSP[0-5]
> 
> +  // 4. SNDW[1-4]
> 
> +  //
> 
> +  switch (AudioLinkType) {
> 
> +    case HdaLink:
> 
> +    case HdaIDispLink:
> 
> +      return TRUE;
> 
> +    case HdaDmic:
> 
> +      if (AudioLinkIndex < 2) {
> 
> +        return TRUE;
> 
> +      } else {
> 
> +        return FALSE;
> 
> +      }
> 
> +    case HdaSsp:
> 
> +      if (AudioLinkIndex < 6) {
> 
> +        return TRUE;
> 
> +      } else {
> 
> +        return FALSE;
> 
> +      }
> 
> +    case HdaSndw:
> 
> +      if (AudioLinkIndex < 1) {
> 
> +        return TRUE;
> 
> +      } else if (AudioLinkIndex < 4) {
> 
> +        return TRUE;
> 
> +      } else {
> 
> +        return FALSE;
> 
> +      }
> 
> +    default:
> 
> +      return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if given Display Audio Link T-Mode is supported
> 
> +
> 
> +  @param[in] Tmode          T-mode support to be checked
> 
> +
> 
> +  @retval    TRUE           T-mode supported
> 
> +  @retval    FALSE          T-mode not supported
> 
> +**/
> 
> +BOOLEAN
> 
> +IsAudioIDispTmodeSupported (
> 
> +  IN HDAUDIO_IDISP_TMODE Tmode
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // iDisplay Audio Link T-mode support per PCH Generation/Series:
> 
> +  // 1. 2T  - TGL-LP/H/N
> 
> +  // 2. 4T  - TGL-LP (default), TGL-H, TGL-N
> 
> +  // 3. 8T  - TGL-H, TGL-N (default)
> 
> +  // 4. 16T - TGL-H, TGL-N (not-POR)
> 
> +  //
> 
> +  switch (Tmode) {
> 
> +    case HdaIDispMode1T:
> 
> +      return FALSE;
> 
> +    case HdaIDispMode2T:
> 
> +    case HdaIDispMode4T:
> 
> +    case HdaIDispMode8T:
> 
> +      return TRUE;
> 
> +    case HdaIDispMode16T:
> 
> +      return FALSE;
> 
> +    default:
> 
> +      return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +Get Pch Usb2 Maximum Physical Port Number
> 
> +
> 
> +@retval Pch Usb2 Maximum Physical Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetPchUsb2MaxPhysicalPortNum(
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries()) {
> 
> +    case PCH_LP:
> 
> +      return 10;
> 
> +    default:
> 
> +      return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +Get Pch Maximum Usb2 Port Number of XHCI Controller
> 
> +
> 
> +@retval Pch Maximum Usb2 Port Number of XHCI Controller
> 
> +**/
> 
> +UINT8
> 
> +GetPchXhciMaxUsb2PortNum(
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries()) {
> 
> +    case PCH_LP:
> 
> +      return 12;
> 
> +    default:
> 
> +      return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +Get Pch Maximum Usb3 Port Number of XHCI Controller
> 
> +
> 
> +@retval Pch Maximum Usb3 Port Number of XHCI Controller
> 
> +**/
> 
> +UINT8
> 
> +GetPchXhciMaxUsb3PortNum(
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  switch (PchSeries()) {
> 
> +    case PCH_LP:
> 
> +      return 4;
> 
> +    default:
> 
> +      return 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gets the maximum number of UFS controller supported by this chipset.
> 
> +
> 
> +  @return Number of supported UFS controllers
> 
> +**/
> 
> +UINT8
> 
> +PchGetMaxUfsNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports eMMC controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchEmmcSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports SD controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchSdCardSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports THC controller
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchThcSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if this chipset supports HSIO BIOS Sync
> 
> +
> 
> +  @retval BOOLEAN  TRUE if supported, FALSE otherwise
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchChipsetInitSyncSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an P-DMI
> 
> +
> 
> +  @retval    TRUE           P-DMI link
> 
> +  @retval    FALSE          Not an P-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithPdmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether ATX Shutdown (PS_ON) is supported.
> 
> +
> 
> +  @retval    TRUE           ATX Shutdown (PS_ON) is supported in PCH
> 
> +  @retval    FALSE          ATX Shutdown (PS_ON) is not supported by PCH
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchPSOnSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an OP-DMI
> 
> +
> 
> +  @retval    TRUE           OP-DMI link
> 
> +  @retval    FALSE          Not an OP-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithOpdmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if link between PCH and CPU is an F-DMI
> 
> +
> 
> +  @retval    TRUE           F-DMI link
> 
> +  @retval    FALSE          Not an F-DMI link
> 
> +**/
> 
> +BOOLEAN
> 
> +IsPchWithFdmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +/**
> 
> +  Get Pch Maximum ISH UART Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH UART controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshUartControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH I2C Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH I2C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshI2cControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 3;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH I3C Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH I3C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshI3cControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 0;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH SPI Controller number
> 
> +
> 
> +  @retval Pch Maximum ISH SPI controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshSpiControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH SPI Controller Cs pins number
> 
> +
> 
> +  @retval Pch Maximum ISH SPI controller Cs pins number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshSpiControllerCsPinsNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 1;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ISH GP number
> 
> +
> 
> +  @retval Pch Maximum ISH GP number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxIshGpNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 8;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO I2C controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO I2C controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoI2cControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 6;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO SPI controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO SPI controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoSpiControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 4;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO UART controllers number
> 
> +
> 
> +  @retval Pch Maximum Serial IO UART controllers number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoUartControllersNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 4;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum Serial IO SPI Chip Selects count
> 
> +
> 
> +  @retval Pch Maximum Serial IO SPI Chip Selects number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxSerialIoSpiChipSelectsNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ME Applet count
> 
> +
> 
> +  @retval Pch Maximum ME Applet number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxMeAppletCount (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 31;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum ME Session count
> 
> +
> 
> +  @retval Pch Maximum ME Sesion number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxMeSessionCount (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 16;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get Pch Maximum THC count
> 
> +
> 
> +  @retval Pch Maximum THC count number
> 
> +**/
> 
> +UINT8
> 
> +GetPchMaxThcCount (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return 2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns a frequency of the sosc_clk signal.
> 
> +  All SATA controllers on the system are assumed to
> 
> +  work on the same sosc_clk frequency.
> 
> +
> 
> +  @retval Frequency of the sosc_clk signal.
> 
> +**/
> 
> +SATA_SOSC_CLK_FREQ
> 
> +GetSataSoscClkFreq (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return SataSosc100Mhz;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if SATA support should be awake after function disable
> 
> +
> 
> +  @retval    TRUE
> 
> +  @retval    FALSE
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSataSupportWakeAfterFunctionDisable (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns USB2 PHY Reference Clock frequency value used by PCH
> 
> +  This defines what electrical tuning parameters shall be used
> 
> +  during USB2 PHY initialization programming
> 
> +
> 
> +  @retval Frequency reference clock for USB2 PHY
> 
> +**/
> 
> +USB2_PHY_REF_FREQ
> 
> +GetUsb2PhyRefFreq (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FREQ_19_2;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if SPI in a given PCH generation supports an Extended BIOS Range
> Decode
> 
> +
> 
> +  @retval TRUE or FALSE if PCH supports Extended BIOS Range Decode
> 
> +**/
> 
> +BOOLEAN
> 
> +IsExtendedBiosRangeDecodeSupported (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +#define SPI_PCH_LP_DMI_TARGET   0x23A8
> 
> +
> 
> +/**
> 
> +  Returns DMI target for current PCH SPI
> 
> +
> 
> +  @retval PCH SPI DMI target value
> 
> +**/
> 
> +UINT16
> 
> +GetPchSpiDmiTarget (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return SPI_PCH_LP_DMI_TARGET;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDx
> eSmmPchInfoLibTgl.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDx
> eSmmPchInfoLibTgl.inf
> new file mode 100644
> index 0000000000..4b3fb988d2
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/Library/PeiDxeSmmPchInfoLib/PeiDx
> eSmmPchInfoLibTgl.inf
> @@ -0,0 +1,43 @@
> +## @file
> 
> +# PCH information library for TigerLake PCH.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmPchInfoLibTgl
> 
> +FILE_GUID = 253B9BFC-026F-4BB4-AC2C-AC167BC0F43C
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = PchInfoLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +PrintLib
> 
> +PciSegmentLib
> 
> +PchPcrLib
> 
> +PcdLib
> 
> +PchPciBdfLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchInfoLib.c
> 
> +PchInfoLibTgl.c
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdEmbeddedEnable                        ## CONSUMES
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private library instances
  2021-02-01  1:36 ` [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private " Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private library
> instances
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * Pch/LibraryPrivate/BaseSiScheduleResetLib
>   * Pch/LibraryPrivate/SmmPchPrivateLib
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/
> BaseSiScheduleResetLib.c   | 171
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLib/
> BaseSiScheduleResetLib.inf |  37
> +++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Smm
> PchPrivateLib.c               |  57
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Smm
> PchPrivateLib.inf             |  31 +++++++++++++++++++++++++++++++
>  4 files changed, 296 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.c
> new file mode 100644
> index 0000000000..1880244a01
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.c
> @@ -0,0 +1,171 @@
> +/** @file
> 
> +  Reset scheduling library services
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/ResetSystemLib.h>
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Uefi.h>
> 
> +#include <Pi/PiMultiPhase.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <PchResetPlatformSpecific.h>
> 
> +#include <Library/SiScheduleResetLib.h>
> 
> +#include <SiScheduleResetHob.h>
> 
> +
> 
> +/**
> 
> +  This function returns SiScheduleResetHob for library use
> 
> +**/
> 
> +STATIC
> 
> +SI_SCHEDULE_RESET_HOB *
> 
> +SiScheduleGetResetData (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  STATIC SI_SCHEDULE_RESET_HOB *SiScheduleResetHob = NULL;
> 
> +  SI_SCHEDULE_RESET_HOB        *SiScheduleResetHobTemp;
> 
> +  VOID                         *HobPtr;
> 
> +
> 
> +  if (SiScheduleResetHob != NULL) {
> 
> +    return SiScheduleResetHob;
> 
> +  }
> 
> +
> 
> +  HobPtr = GetFirstGuidHob (&gSiScheduleResetHobGuid);
> 
> +  if (HobPtr == NULL) {
> 
> +    SiScheduleResetHobTemp = BuildGuidHob (&gSiScheduleResetHobGuid,
> sizeof (SI_SCHEDULE_RESET_HOB));
> 
> +    if (SiScheduleResetHobTemp == NULL) {
> 
> +      ASSERT (FALSE);
> 
> +      return SiScheduleResetHobTemp;
> 
> +    }
> 
> +    SiScheduleResetHobTemp->ResetType = 0xFF;
> 
> +    DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : Init
> SiScheduleResetHob\n"));
> 
> +  } else {
> 
> +    SiScheduleResetHobTemp = (SI_SCHEDULE_RESET_HOB*)
> GET_GUID_HOB_DATA (HobPtr);
> 
> +  }
> 
> +  SiScheduleResetHob = SiScheduleResetHobTemp;
> 
> +  return SiScheduleResetHobTemp;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function updates the reset information in SiScheduleResetHob
> 
> +  @param[in] ResetType        UEFI defined reset type.
> 
> +  @param[in] ResetData        Optional element used to introduce a platform
> specific reset.
> 
> +                               The exact type of the reset is defined by the EFI_GUID that
> follows
> 
> +                               the Null-terminated Unicode string.
> 
> +**/
> 
> +VOID
> 
> +SiScheduleResetSetType (
> 
> +  IN EFI_RESET_TYPE     ResetType,
> 
> +  IN PCH_RESET_DATA     *ResetData OPTIONAL
> 
> +  )
> 
> +{
> 
> +  SI_SCHEDULE_RESET_HOB *SiScheduleResetHob;
> 
> +  if (ResetType > EfiResetPlatformSpecific) {
> 
> +    DEBUG ((DEBUG_INFO, "Unsupported Reset Type Requested\n"));
> 
> +    return;
> 
> +  }
> 
> +  SiScheduleResetHob = SiScheduleGetResetData ();
> 
> +  if (SiScheduleResetHob == NULL) {
> 
> +    return;
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : Current Reset Type =
> 0x%x\n", SiScheduleResetHob->ResetType));
> 
> +  if (SiScheduleResetHob->ResetType == ResetType) {
> 
> +    DEBUG ((DEBUG_INFO, "Current Reset Type is same as requested Reset
> Type\n"));
> 
> +    return;
> 
> +  }
> 
> +  if (SiScheduleResetHob->ResetType == 0xFF) {
> 
> +    // Init Reset Type to lowest ResetType
> 
> +    SiScheduleResetHob->ResetType = EfiResetWarm;
> 
> +  }
> 
> +  //
> 
> +  // ResetType Priority set as : ResetPlatformSpecific(3) > ResetShutdown(2)
> > ResetCold(0) > ResetWarm(1)
> 
> +  //
> 
> +  switch (ResetType) {
> 
> +    case EfiResetWarm:
> 
> +      break;
> 
> +
> 
> +    case EfiResetCold:
> 
> +      if (SiScheduleResetHob->ResetType == EfiResetWarm) {
> 
> +        SiScheduleResetHob->ResetType = ResetType;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case EfiResetShutdown:
> 
> +      if (SiScheduleResetHob->ResetType < ResetType)
> 
> +      SiScheduleResetHob->ResetType = ResetType;
> 
> +      break;
> 
> +
> 
> +    case EfiResetPlatformSpecific:
> 
> +      SiScheduleResetHob->ResetType = ResetType;
> 
> +      SiScheduleResetHob->ResetData = *ResetData;
> 
> +      break;
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "SiScheduleResetSetType : New Reset Type =
> 0x%x\n", SiScheduleResetHob->ResetType));
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function returns TRUE or FALSE depending on whether a reset is
> required based on SiScheduleResetHob
> 
> +
> 
> +  @retval     BOOLEAN       The function returns FALSE if no reset is required
> 
> +**/
> 
> +BOOLEAN
> 
> +SiScheduleResetIsRequired (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  VOID                  *HobPtr;
> 
> +
> 
> +  HobPtr = NULL;
> 
> +  HobPtr = GetFirstGuidHob (&gSiScheduleResetHobGuid);
> 
> +  if (HobPtr == NULL) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function performs reset based on SiScheduleResetHob
> 
> +
> 
> +  @retval     BOOLEAN       The function returns FALSE if no reset is required
> 
> +**/
> 
> +BOOLEAN
> 
> +SiScheduleResetPerformReset (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINTN                 DataSize;
> 
> +  SI_SCHEDULE_RESET_HOB *SiScheduleResetHob;
> 
> +
> 
> +  if (!SiScheduleResetIsRequired ()) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  SiScheduleResetHob = SiScheduleGetResetData ();
> 
> +
> 
> +  if (SiScheduleResetHob == NULL) {
> 
> +    return TRUE;
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SiScheduleResetPerformReset : Reset Type =
> 0x%x\n", SiScheduleResetHob->ResetType));
> 
> +  switch (SiScheduleResetHob->ResetType) {
> 
> +  case EfiResetWarm:
> 
> +    ResetWarm ();
> 
> +    break;
> 
> +
> 
> +  case EfiResetCold:
> 
> +    ResetCold ();
> 
> +    break;
> 
> +
> 
> +  case EfiResetShutdown:
> 
> +    ResetShutdown ();
> 
> +    break;
> 
> +
> 
> +  case EfiResetPlatformSpecific:
> 
> +    DataSize = sizeof (PCH_RESET_DATA);
> 
> +    ResetPlatformSpecific (DataSize, &SiScheduleResetHob->ResetData);
> 
> +    break;
> 
> +  }
> 
> +  // Code should never reach here
> 
> +  ASSERT (FALSE);
> 
> +  return TRUE;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.inf
> new file mode 100644
> index 0000000000..4363a752a9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/BaseSiScheduleResetLi
> b/BaseSiScheduleResetLib.inf
> @@ -0,0 +1,37 @@
> +## @file
> 
> +# Component description file for Si Reset Schedule Library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = BaseSiScheduleResetLib
> 
> +FILE_GUID = E6F3D551-36C0-4737-80C7-47FC57593163
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = SiScheduleResetLib
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 IPF
> 
> +#
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +HobLib
> 
> +ResetSystemLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Guids]
> 
> +gSiScheduleResetHobGuid
> 
> +
> 
> +[Sources]
> 
> +BaseSiScheduleResetLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.c
> new file mode 100644
> index 0000000000..46cf735860
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.c
> @@ -0,0 +1,57 @@
> +/** @file
> 
> +  PCH SMM private lib.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Register/CommonMsr.h>
> 
> +
> 
> +/**
> 
> +  Set InSmm.Sts bit
> 
> +**/
> 
> +VOID
> 
> +PchSetInSmmSts (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32      Data32;
> 
> +
> 
> +
> 
> +  ///
> 
> +  /// Read memory location FED30880h OR with 00000001h, place the result
> in EAX,
> 
> +  /// and write data to lower 32 bits of MSR 1FEh (sample code available)
> 
> +  ///
> 
> +  Data32 = MmioRead32 (0xFED30880);
> 
> +  AsmWriteMsr32 (MSR_SPCL_CHIPSET_USAGE, Data32 | BIT0);
> 
> +  ///
> 
> +  /// Read FED30880h back to ensure the setting went through.
> 
> +  ///
> 
> +  Data32 = MmioRead32 (0xFED30880);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear InSmm.Sts bit
> 
> +**/
> 
> +VOID
> 
> +PchClearInSmmSts (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32      Data32;
> 
> +
> 
> +  ///
> 
> +  /// Read memory location FED30880h AND with FFFFFFFEh, place the result
> in EAX,
> 
> +  /// and write data to lower 32 bits of MSR 1FEh (sample code available)
> 
> +  ///
> 
> +  Data32 = MmioRead32 (0xFED30880);
> 
> +  AsmWriteMsr32 (MSR_SPCL_CHIPSET_USAGE, Data32 & (UINT32)
> (~BIT0));
> 
> +  ///
> 
> +  /// Read FED30880h back to ensure the setting went through.
> 
> +  ///
> 
> +  Data32 = MmioRead32 (0xFED30880);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.inf
> new file mode 100644
> index 0000000000..6d4c3a5729
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/LibraryPrivate/SmmPchPrivateLib/Sm
> mPchPrivateLib.inf
> @@ -0,0 +1,31 @@
> +## @file
> 
> +#  PCH SMM private lib.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = SmmPchPrivateLib
> 
> +FILE_GUID = FE6495FB-7AA9-4A24-BF3E-4698F7BCE0EE
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_SMM_DRIVER
> 
> +LIBRARY_CLASS = SmmPchPrivateLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +IoLib
> 
> +DebugLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SmmPchPrivateLib.c
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and library instances
  2021-02-01  1:36 ` [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and " Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

Please see comments inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables
> and library instances
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * SystemAgent/AcpiTables
>   * SystemAgent/Library/DxeSaPolicyLib
>   * SystemAgent/Library/PeiDxeSmmSaPlatformLib
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp
> .asl                           |  252
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcieRp
> Common.asl                     |  289
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegComm
> on.asl                           | 1344
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3.a
> sl                             |  124
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
> |   26 ++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.asl
> |   20 ++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf
> |   22 +++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSa
> PolicyLib.c                   |  264
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSa
> PolicyLib.inf                 |   48 ++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/DxeSa
> PolicyLibrary.h               |   34 +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatfor
> mLib/PeiDxeSmmSaPlatformLib.inf |   32 ++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatfor
> mLib/SaPlatformLibrary.c        |   68
> +++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatfor
> mLib/SaPlatformLibrary.h        |   21 ++++++++++++++
>  13 files changed, 2544 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> Rp.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> Rp.asl
> new file mode 100644
> index 0000000000..0babf047ed
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> Rp.asl
> @@ -0,0 +1,252 @@
> +/** @file
> 
> +  This file contains the CPU PCIe Root Port configuration
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +External(LTRX) // CPU PCIe Root Port 0 Latency Tolerance Reporting Enable
> 
> +External(LTRY) // CPU PCIe Root Port 1 Latency Tolerance Reporting Enable
> 
> +External(LTRZ) // CPU PCIe Root Port 2 Latency Tolerance Reporting Enable
> 
> +External(LTRW) // CPU PCIe Root Port 3 Latency Tolerance Reporting Enable
> 
> +External(SMSL) // CPU PCIe Root Port Latency Tolerance Reporting Max
> Snoop Latency
> 
> +External(SNSL) // CPU PCIe Root Port Latency Tolerance Reporting Max No
> Snoop Latency
> 
> +External(PG0E) // CpuPcieRp0Enable <b>0: Disable</b>; 1: Enable
> 
> +External(PG1E) // CpuPcieRp1Enable <b>0: Disable</b>; 1: Enable
> 
> +External(PG2E) // CpuPcieRp2Enable <b>0: Disable</b>; 1: Enable
> 
> +External(PG3E) // CpuPcieRp3Enable <b>0: Disable</b>; 1: Enable
> 
> +External(\_SB.PC00.PEG0, DeviceObj)
> 
> +External(\_SB.PC00.PEG1, DeviceObj)
> 
> +External(\_SB.PC00.PEG2, DeviceObj)
> 
> +External(\_SB.PC00.PEG3, DeviceObj)
> 
> +External(\_SB.PC00.PEG0.PEGP, DeviceObj)
> 
> +External(\_SB.PC00.PEG1.PEGP, DeviceObj)
> 
> +External(\_SB.PC00.PEG2.PEGP, DeviceObj)
> 
> +External(\_SB.PC00.PEG3.PEGP, DeviceObj)
> 
> +External(\AR02)
> 
> +External(\PD02)
> 
> +External(\AR0A)
> 
> +External(\PD0A)
> 
> +External(\AR0B)
> 
> +External(\PD0B)
> 
> +External(\AR0C)
> 
> +External(\PD0C)
> 
> +External(VMDE)
> 
> +External(VMCP)
> 
> +External(MPGN)
> 
> +External(PBR1)
> 
> +External(PBR2)
> 
> +External(PBR3)
> 
> +
> 
> +Scope (\_SB.PC00.PEG0) {
> 
> +
> 
> +  Name(SLOT, 0) // CPU PCIe root port index 0 corresponds to PEG60 (0/6/0)
> 
> +
> 
> +  Method (_STA, 0x0, NotSerialized) {
> 
> +    if(PG0E == 1) { // If CPU PCIe RP0 enabled?
> 
> +      Return(0x0F)
> 
> +    }
> 
> +    Return(0x00)
> 
> +  }
> 
> +
> 
> +  Name(LTEN, 0)
> 
> +  Name(LMSL, 0)
> 
> +  Name(LNSL, 0)
> 
> +
> 
> +  Method(_INI)
> 
> +  {
> 
> +    Store (LTRX, LTEN)
> 
> +    Store (SMSL, LMSL)
> 
> +    Store (SNSL, LNSL)
> 
> +    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
> 
> +      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x8),0))) {
> 
> +        Store (1, CPMV)
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method(_PRT,0) {
> 
> +    If(PICM) {
> 
> +      Return(AR02)
> 
> +    } // APIC mode
> 
> +    Return (PD02) // PIC Mode
> 
> +  } // end _PRT
> 
> +
> 
> +  Include("CpuPcieRpCommon.asl")
> 
> +} // PEG0 scope end
> 
> +
> 
> +Scope (\_SB.PC00.PEG1) {
> 
> +
> 
> +  Name(SLOT, 1) // CPU PCIe root port index 1 corresponds to PEG10 (0/1/0)
> 
> +
> 
> +  Method (_STA, 0x0, NotSerialized) {
> 
> +    if(PG1E == 1) { // If CPU PCIe RP1 enabled?
> 
> +      Return(0x0F)
> 
> +    }
> 
> +    Return(0x00)
> 
> +  }
> 
> +
> 
> +  Name(LTEN, 0)
> 
> +  Name(LMSL, 0)
> 
> +  Name(LNSL, 0)
> 
> +
> 
> +  Method(_INI)
> 
> +  {
> 
> +    Store (LTRY, LTEN)
> 
> +    Store (SMSL, LMSL)
> 
> +    Store (SNSL, LNSL)
> 
> +    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
> 
> +      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x1),0))) {
> 
> +        Store (1, CPMV)
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method(_PRT,0) {
> 
> +    If(PICM) {
> 
> +      Return(AR0A)
> 
> +    } // APIC mode
> 
> +    Return (PD0A) // PIC Mode
> 
> +  } // end _PRT
> 
> +
> 
> +  Include("CpuPcieRpCommon.asl")
> 
> +} // PEG1 scope end
> 
> +
> 
> +Scope (\_SB.PC00.PEG2) {
> 
> +
> 
> +  Name(SLOT, 2) // CPU PCIe root port index 2 corresponds to PEG11 (0/1/1)
> 
> +
> 
> +  Method (_STA, 0x0, NotSerialized) {
> 
> +    if(PG2E == 1) { // If CPU PCIe RP2 enabled?
> 
> +      Return(0x0F)
> 
> +    }
> 
> +    Return(0x00)
> 
> +  }
> 
> +
> 
> +  Name(LTEN, 0)
> 
> +  Name(LMSL, 0)
> 
> +  Name(LNSL, 0)
> 
> +
> 
> +  Method(_INI)
> 
> +  {
> 
> +    Store (LTRZ, LTEN)
> 
> +    Store (SMSL, LMSL)
> 
> +    Store (SNSL, LNSL)
> 
> +    If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
> 
> +      If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x2),0))) {
> 
> +        Store (1, CPMV)
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method(_PRT,0) {
> 
> +    If(PICM) {
> 
> +      Return(AR0B)
> 
> +    } // APIC mode
> 
> +    Return (PD0B) // PIC Mode
> 
> +  } // end _PRT
> 
> +
> 
> +  Include("CpuPcieRpCommon.asl")
> 
> +} // PEG2 scope end
> 
> +
> 
> +If (CondRefOf(\_SB.PC00.PEG3)) {
> 
> +  Scope (\_SB.PC00.PEG3) {
> 
> +
> 
> +    Name(SLOT, 3) // CPU PCIe root port index 3 corresponds to PEG12
> (0/1/2)
> 
> +
> 
> +    Method (_STA, 0x0, NotSerialized) {
> 
> +      if(PG3E == 1) { // If CPU PCIe RP3 enabled?
> 
> +        Return(0x0F)
> 
> +      }
> 
> +      Return(0x00)
> 
> +    }
> 
> +
> 
> +    Name(LTEN, 0)
> 
> +    Name(LMSL, 0)
> 
> +    Name(LNSL, 0)
> 
> +
> 
> +    Method(_INI)
> 
> +    {
> 
> +      Store (LTRW, LTEN)
> 
> +      Store (SMSL, LMSL)
> 
> +      Store (SNSL, LNSL)
> 
> +      If(LAnd(CondRefOf(VMCP),CondRefOf(VMDE))) {
> 
> +        If(LAnd(LEqual(VMDE,1),LNotEqual(And(VMCP,0x4),0))) {
> 
> +          Store (1, CPMV)
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +
> 
> +    Method(_PRT,0) {
> 
> +      If(PICM) {
> 
> +        Return(AR0C)
> 
> +      } // APIC mode
> 
> +      Return (PD0C) // PIC Mode
> 
> +    } // end _PRT
> 
> +
> 
> +    Include("CpuPcieRpCommon.asl")
> 
> +  } // PEG3 scope end
> 
> +}
> 
> +
> 
> +Scope(\_SB.PC00.PEG0.PEGP) {
> 
> +  Method(_PRW, 0) {
> 
> +    Return(GPRW(0x69, 4)) // can wakeup from S4 state
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +If (PBR1) {
> 
> +  Scope(\_SB.PC00.PEG1.PEGP) {
> 
> +    Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +
> 
> +    Device (PEGD) {
> 
> +      Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +      Name(_ADR, 0x00000000)
> 
> +      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4
> state
> 
> +    }
> 
> +  } // end "P.E.G. Port Slot x16"
> 
> +}
> 
> +
> 
> +Scope(\_SB.PC00.PEG1.PEGP) {
> 
> +  Method(_PRW, 0) {
> 
> +    Return(GPRW(0x69, 4)) // can wakeup from S4 state
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +If (PBR2) {
> 
> +  Scope(\_SB.PC00.PEG2.PEGP) {
> 
> +    Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +
> 
> +    Device (PEGD) {
> 
> +      Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +      Name(_ADR, 0x00000000)
> 
> +      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4
> state
> 
> +    }
> 
> +  } // end "P.E.G. Port Slot 2x8"
> 
> +}
> 
> +
> 
> +Scope(\_SB.PC00.PEG2.PEGP) {
> 
> +  Method(_PRW, 0) {
> 
> +    Return(GPRW(0x69, 4)) // can wakeup from S4 state
> 
> +  }
> 
> +}
> 
> +
> 
> +If (PBR3) {
> 
> +  Scope(\_SB.PC00.PEG3.PEGP) {
> 
> +    Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +
> 
> +    Device (PEGD) {
> 
> +      Method(_S0W, 0) { Return(4)} //D3cold is supported
> 
> +      Name(_ADR, 0x00000000)
> 
> +      Method(_PRW, 0) { Return(GPRW(0x69, 4)) } // can wakeup from S4
> state
> 
> +    }
> 
> +  } // end "P.E.G. Port Slot 1x8 - 2x4"
> 
> +}
> 
> +
> 
> +If (CondRefOf(\_SB.PC00.PEG3)) {
> 
> +  Scope(\_SB.PC00.PEG3.PEGP) {
> 
> +    Method(_PRW, 0) {
> 
> +      Return(GPRW(0x69, 4)) // can wakeup from S4 state
> 
> +    }
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> RpCommon.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> RpCommon.asl
> new file mode 100644
> index 0000000000..81f785dfc5
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/CpuPcie
> RpCommon.asl
> @@ -0,0 +1,289 @@
> +/** @file
> 
> +  This file contains the CPU PCIe Root Port configuration
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +  External(ECR1)
> 
> +  External(GPRW, MethodObj)
> 
> +  External(PICM)
> 
> +  External(\_SB.PC00.PC2M, MethodObj)
> 
> +  External(_ADR, IntObj)
> 
> +
> 
> +
> 
> +  OperationRegion(PXCS,SystemMemory,\_SB.PC00.PC2M(_ADR),0x480)
> 
> +  Field(PXCS, AnyAcc, NoLock, Preserve)
> 
> +  {
> 
> +    Offset(0),
> 
> +    VDID, 32,
> 
> +    Offset(0x50), // LCTL - Link Control Register
> 
> +    L0SE, 1,      // 0, L0s Entry Enabled
> 
> +    , 3,
> 
> +    LDIS, 1,
> 
> +    , 3,
> 
> +    Offset(0x52), // LSTS - Link Status Register
> 
> +    , 13,
> 
> +    LASX, 1,      // 0, Link Active Status
> 
> +    Offset(0x5A), // SLSTS[7:0] - Slot Status Register
> 
> +    ABPX, 1,      // 0, Attention Button Pressed
> 
> +    , 2,
> 
> +    PDCX, 1,      // 3, Presence Detect Changed
> 
> +    , 2,
> 
> +    PDSX, 1,      // 6, Presence Detect State
> 
> +    , 1,
> 
> +    Offset(0x60), // RSTS - Root Status Register
> 
> +    , 16,
> 
> +    PSPX, 1,      // 16,  PME Status
> 
> +    Offset(0xA4),
> 
> +    D3HT, 2,      // Power State
> 
> +    Offset(0xD8), // 0xD8, MPC - Miscellaneous Port Configuration Register
> 
> +    , 30,
> 
> +    HPEX, 1,      // 30,  Hot Plug SCI Enable
> 
> +    PMEX, 1,      // 31,  Power Management SCI Enable
> 
> +    Offset(0xE0), // 0xE0, SPR - Scratch Pad Register
> 
> +    , 0,
> 
> +    SCB0, 1,      // Sticky Scratch Pad Bit SCB0
> 
> +    Offset(0xE2), // 0xE2, RPPGEN - Root Port Power Gating Enable
> 
> +    , 2,
> 
> +    L23E, 1,       // 2,   L23_Rdy Entry Request (L23ER)
> 
> +    L23R, 1,       // 3,   L23_Rdy to Detect Transition (L23R2DT)
> 
> +    Offset(0x324), // 0x324 - PCIEDBG
> 
> +    , 3,
> 
> +    LEDM, 1,       // PCIEDBG.DMIL1EDM
> 
> +    Offset(0x328), // 0x328 - PCIESTS1
> 
> +    , 24,
> 
> +    LTSM, 8,
> 
> +  }
> 
> +  Field(PXCS,AnyAcc, NoLock, WriteAsZeros)
> 
> +  {
> 
> +    Offset(0xDC), // 0xDC, SMSCS - SMI/SCI Status Register
> 
> +    , 30,
> 
> +    HPSX, 1,      // 30,  Hot Plug SCI Status
> 
> +    PMSX, 1       // 31,  Power Management SCI Status
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // L23D method recovers link from L2 or L3 state. Used for RTD3 flows, right
> after endpoint is powered up and exits reset.
> 
> +  // This flow is implemented in ASL because rootport registers used for
> L2/L3 entry/exit
> 
> +  // are proprietary and OS drivers don't know about them.
> 
> +  //
> 
> +  Method (L23D, 0, Serialized) {
> 
> +    If(LNotEqual(SCB0,0x1)) {
> 
> +      Return()
> 
> +    }
> 
> +
> 
> +    /// Set L23_Rdy to Detect Transition  (L23R2DT)
> 
> +    Store(1, L23R)
> 
> +    Store(0, Local0)
> 
> +    /// Wait for transition to Detect
> 
> +    While(L23R) {
> 
> +      If(Lgreater(Local0, 4))
> 
> +      {
> 
> +        Break
> 
> +      }
> 
> +      Sleep(16)
> 
> +      Increment(Local0)
> 
> +    }
> 
> +    Store(0,SCB0)
> 
> +
> 
> +    /// Once in Detect, wait up to 124 ms for Link Active (typically happens in
> under 70ms)
> 
> +    /// Worst case per PCIe spec from Detect to Link Active is:
> 
> +    /// 24ms in Detect (12+12), 72ms in Polling (24+48), 28ms in Config
> (24+2+2+2+2)
> 
> +    Store(0, Local0)
> 
> +    While(LEqual(LASX,0)) {
> 
> +      If(Lgreater(Local0, 8))
> 
> +      {
> 
> +        Break
> 
> +      }
> 
> +      Sleep(16)
> 
> +      Increment(Local0)
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // DL23 method puts link to L2 or L3 state. Used for RTD3 flows, before
> endpoint is powered down.
> 
> +  // This flow is implemented in ASL because rootport registers used for
> L2/L3 entry/exit
> 
> +  // are proprietary and OS drivers don't know about them.
> 
> +  //
> 
> +  Method (DL23, 0, Serialized) {
> 
> +    Store(1, L23E)
> 
> +    Sleep(16)
> 
> +    Store(0, Local0)
> 
> +    While(L23E) {
> 
> +      If(Lgreater(Local0, 4))
> 
> +      {
> 
> +        Break
> 
> +      }
> 
> +      Sleep(16)
> 
> +      Increment(Local0)
> 
> +    }
> 
> +    Store(1,SCB0)
> 
> +  }
> 
> +
> 
> +  Name(LTRV, Package(){0,0,0,0})
> 
> +  Name(CPMV, 0) // CPU Rp Mapped under VMD
> 
> +
> 
> +  //
> 
> +  // _DSM Device Specific Method
> 
> +  //
> 
> +  // Arg0: UUID Unique function identifier
> 
> +  // Arg1: Integer Revision Level
> 
> +  // Arg2: Integer Function Index (0 = Return Supported Functions)
> 
> +  // Arg3: Package Parameters
> 
> +  Method(_DSM, 4, Serialized) {
> 
> +    //
> 
> +    // Switch based on which unique function identifier was passed in
> 
> +    //
> 
> +    If (LEqual(Arg0, ToUUID ("E5C937D0-3553-4d7a-9117-EA4D19C3434D"))) {
> 
> +      //
> 
> +      // _DSM Definitions for Latency Tolerance Reporting
> 
> +      //
> 
> +      // Arguments:
> 
> +      // Arg0: UUID: E5C937D0-3553-4d7a-9117-EA4D19C3434D
> 
> +      // Arg1: Revision ID: 3
> 
> +      // Arg2: Function Index: 0, 6, 8, 9
> 
> +      // Arg3: Empty Package
> 
> +      //
> 
> +      // Switch by function index
> 
> +      //
> 
> +      Switch(ToInteger(Arg2)) {
> 
> +        //
> 
> +        // Function Index:0
> 
> +        // Standard query - A bitmask of functions supported
> 
> +        //
> 
> +        Case (0) {
> 
> +          Name(OPTS,Buffer(2){0,0})
> 
> +          CreateBitField(OPTS,0,FUN0)
> 
> +          CreateBitField(OPTS,6,FUN6)
> 
> +          CreateBitField(OPTS,8,FUN8)
> 
> +          CreateBitField(OPTS,9,FUN9)
> 
> +
> 
> +          Store(1,FUN0)
> 
> +          if(LEqual(LTEN,1)) {
> 
> +            Store(1,Fun6)
> 
> +          }
> 
> +
> 
> +          If (LGreaterEqual(Arg1, 2)){ // test Arg1 for Revision ID: 2
> 
> +            If(CondRefOf(ECR1)) {
> 
> +              if(LEqual(ECR1,1)){
> 
> +                if (LGreaterEqual(Arg1, 3)){ // test Arg1 for Revision ID: 3
> 
> +                  Store(1,Fun8)
> 
> +                  Store(1,Fun9)
> 
> +                }
> 
> +              }
> 
> +            }
> 
> +          }
> 
> +          Return (OPTS)
> 
> +        }
> 
> +
> 
> +        //
> 
> +        // Function Index: 6
> 
> +        // LTR Extended Capability Structure
> 
> +        //
> 
> +        Case(6) {
> 
> +          if (LGreaterEqual(Arg1, 2)){ // test Arg1 for Revision ID: 2
> 
> +            Store(And(ShiftRight(LMSL,10),7), Index(LTRV, 0))
> 
> +            Store(And(LMSL,0x3FF), Index(LTRV, 1))
> 
> +            Store(And(ShiftRight(LNSL,10),7), Index(LTRV, 2))
> 
> +            Store(And(LNSL,0x3FF), Index(LTRV, 3))
> 
> +            Return (LTRV)
> 
> +          }
> 
> +        }
> 
> +        Case(8) { //ECR ACPI additions for FW latency optimizations, DSM for
> Avoiding Power-On Reset Delay Duplication on Sx Resume
> 
> +          If(CondRefOf(ECR1)) {
> 
> +            if(LEqual(ECR1,1)){
> 
> +              if (LGreaterEqual(Arg1, 3)) { // test Arg1 for Revision ID: 3
> 
> +                return (1)
> 
> +              }
> 
> +            }
> 
> +          }
> 
> +        }
> 
> +        Case(9) { //ECR ACPI additions for FW latency optimizations, DSM for
> Specifying Device Readiness Durations
> 
> +          If(CondRefOf(ECR1)) {
> 
> +            if(LEqual(ECR1,1)){
> 
> +              if (LGreaterEqual(Arg1, 3)) { // test Arg1 for Revision ID: 3
> 
> +                return(Package(5){50000,Ones,Ones,50000,Ones})
> 
> +              }
> 
> +            }
> 
> +          }
> 
> +        }
> 
> +      } // End of switch(Arg2)
> 
> +    } // End of if
> 
> +    return (Buffer() {0x00})
> 
> +  } // End of _DSM
> 
> +
> 
> +  Method(_PRW, 0) {
> 
> +    Return(GPRW(0x69, 4)) // can wakeup from S4 state
> 
> +  }
> 
> +
> 
> +  Method(_PS0,0,Serialized)
> 
> +  {
> 
> +    If (LEqual(HPEX, 1)) {
> 
> +      Store(0, HPEX) // Disable Hot Plug SCI
> 
> +      Store(1, HPSX) // Clear Hot Plug SCI status
> 
> +    }
> 
> +    If (LEqual (PMEX, 1)) {
> 
> +      Store(0, PMEX) // Disable Power Management SCI
> 
> +      Store(1, PMSX) // Clear Power Management SCI status
> 
> +    }
> 
> +  }
> 
> +  Method(_PS3,0,Serialized)
> 
> +  {
> 
> +    If (LEqual (HPEX, 0)) {
> 
> +      Store(1, HPEX) // Enable Hot Plug SCI
> 
> +      Store(1, HPSX) // Clear Hot Plug SCI status
> 
> +    }
> 
> +    If (LEqual(PMEX, 0)) {
> 
> +      Store(1, PMEX) // Enable Power Management SCI
> 
> +      Store(1, PMSX) // Clear Power Management SCI status
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method (_DSD, 0) {
> 
> +    Return (
> 
> +      Package () {
> 
> +        ToUUID("FDF06FAD-F744-4451-BB64-ECD792215B10"),
> 
> +        Package () {
> 
> +          Package (2) {"FundamentalDeviceResetTriggeredOnD3ToD0", 1},
> 
> +        }
> 
> +      }
> 
> +    ) // End of Return ()
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // PCI_EXP_STS Handler for PCIE Root Port
> 
> +  //
> 
> +  Method(HPME,0,Serialized) {
> 
> +    If(LAnd(LNotEqual(VDID,0xFFFFFFFF), LEqual(PMSX,1))) { //if port exists
> and has PME SCI Status set...
> 
> +      Store(1,PMSX) // clear rootport's PME SCI status
> 
> +      Store(1,PSPX) // consume one pending PME status to prevent it from
> blocking the queue
> 
> +      Return(0x01)
> 
> +    }
> 
> +    Return(0x00)
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Sub-Method of _L61 Hot-Plug event
> 
> +  // _L61 event handler should invoke this method to support HotPlug wake
> event from PEG RP
> 
> +  //
> 
> +  Method(HPEV,0,Serialized) {
> 
> +    If(LAnd(LNotEqual(VDID,0xFFFFFFFF), HPSX)) {
> 
> +      // Clear HotPlug SCI event status
> 
> +      Store(1, HPSX)
> 
> +
> 
> +      If(LEqual(PDCX, 1)) {
> 
> +        // Clear Presence Detect Changed
> 
> +        Store(1,PDCX)
> 
> +
> 
> +        If(LEqual(PDSX, 0)) {
> 
> +          // The PCI Express slot is empty, so disable L0s on hot unplug
> 
> +          //
> 
> +          Store(0,L0SE)
> 
> +        }
> 
> +        // Perform proper notification
> 
> +        // to the OS.
> 
> +        Notify(^,0)
> 
> +      }
> 
> +    }
> 
> +  }
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCom
> mon.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCom
> mon.asl
> new file mode 100644
> index 0000000000..68b10309d4
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegCom
> mon.asl
> @@ -0,0 +1,1344 @@
> +/** @file
> 
> +  This file contains the device definitions of the SystemAgent
> 
> +  PCIE ACPI Reference Code.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +External(\_SB.ISME, MethodObj)
> 
> +External(\_SB.SHPO, MethodObj)
> 
> +External(\_SB.CAGS, MethodObj)
> 
> +External(\_SB.GGOV, MethodObj)
> 
> +External(\_SB.SGOV, MethodObj)
> 
> +External(\_SB.PC00.PEG0, DeviceObj)
> 
> +External(\_SB.PC00.PEG1, DeviceObj)
> 
> +External(\_SB.PC00.PEG2, DeviceObj)
> 
> +External(\_SB.PC00.PEG3, DeviceObj)
> 
> +External(\_SB.PC00.PEG0.PPRW, MethodObj)
> 
> +External(\_SB.PC00.PEG1.PPRW, MethodObj)
> 
> +External(\_SB.PC00.PEG2.PPRW, MethodObj)
> 
> +External(\_SB.PC00.PEG3.PPRW, MethodObj)
> 
> +External(\_SB.PC00.PC2M, MethodObj)
> 
> +External(P8XH, MethodObj)
> 
> +External(SPCO, MethodObj)
> 
> +External(PINI, MethodObj) // Platform specific PCIe root port initialization
> 
> +External(PRES, MethodObj)
> 
> +External(GPRW, MethodObj)
> 
> +External(\SLOT)
> 
> +External(\P0WK)
> 
> +External(\P1WK)
> 
> +External(\P2WK)
> 
> +External(\P3WK)
> 
> +External(\XBAS)
> 
> +External(\SBN0)
> 
> +External(\SBN1)
> 
> +External(\SBN2)
> 
> +External(\SBN3)
> 
> +External(\EECP)
> 
> +External(\EEC1)
> 
> +External(\EEC2)
> 
> +External(\EEC3)
> 
> +External(\SGGP)
> 
> +External(\HRE0)
> 
> +External(\HRG0)
> 
> +External(\HRA0)
> 
> +External(\PWE0)
> 
> +External(\PWG0)
> 
> +External(\PWA0)
> 
> +External(\P1GP)
> 
> +External(\HRE1)
> 
> +External(\HRG1)
> 
> +External(\HRA1)
> 
> +External(\PWE1)
> 
> +External(\PWG1)
> 
> +External(\PWA1)
> 
> +External(\P2GP)
> 
> +External(\HRE2)
> 
> +External(\HRG2)
> 
> +External(\HRA2)
> 
> +External(\PWE2)
> 
> +External(\PWG2)
> 
> +External(\PWA2)
> 
> +External(\P3GP)
> 
> +External(\HRE3)
> 
> +External(\HRG3)
> 
> +External(\HRA3)
> 
> +External(\PWE3)
> 
> +External(\PWG3)
> 
> +External(\PWA3)
> 
> +External(\P0SC)
> 
> +External(\P1SC)
> 
> +External(\P2SC)
> 
> +External(\P3SC)
> 
> +External(\DLPW)
> 
> +External(\DLHR)
> 
> +External(\OBFX)
> 
> +External(\OBFY)
> 
> +External(\OBFZ)
> 
> +External(\OBFA)
> 
> +External(\OSYS)
> 
> +
> 
> +//GPE Event handling - Start
> 
> +Scope(\_GPE) {
> 
> +  //
> 
> +  // _L6F Method call for PEG0/1/2/3 ports to handle 2-tier RTD3 GPE events
> 
> +  //
> 
> +  Method(P0L6,0)
> 
> +  {
> 
> +    // PEG0 Device Wake Event
> 
> +    If (\_SB.ISME(P0WK))
> 
> +    {
> 
> +      \_SB.SHPO(P0WK, 1)             // set gpio ownership to driver(0=ACPI mode,
> 1=GPIO mode)
> 
> +      Notify(\_SB.PC00.PEG0, 0x02)   // device wake
> 
> +      \_SB.CAGS(P0WK)                // Clear GPE status bit for PEG0 WAKE
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method(P1L6,0)
> 
> +  {
> 
> +    // PEG1 Device Wake Event
> 
> +    If (\_SB.ISME(P1WK))
> 
> +    {
> 
> +      \_SB.SHPO(P1WK, 1)             // set gpio ownership to driver(0=ACPI mode,
> 1=GPIO mode)
> 
> +      Notify(\_SB.PC00.PEG1, 0x02)   // device wake
> 
> +      \_SB.CAGS(P1WK)                // Clear GPE status bit for PEG1 WAKE
> 
> +    }
> 
> +  }
> 
> +
> 
> +  Method(P2L6,0)
> 
> +  {
> 
> +    // PEG2 Device Wake Event
> 
> +    If (\_SB.ISME(P2WK))
> 
> +    {
> 
> +      \_SB.SHPO(P2WK, 1)             // set gpio ownership to driver(0=ACPI mode,
> 1=GPIO mode)
> 
> +      Notify(\_SB.PC00.PEG2, 0x02)   // device wake
> 
> +      \_SB.CAGS(P2WK)                // Clear GPE status bit for PEG2 WAKE
> 
> +    }
> 
> +  }
> 
> +
> 
> +  If (CondRefOf(\_SB.PC00.PEG3)) {
> 
> +    Method(P3L6,0)
> 
> +    {
> 
> +      // PEG2 Device Wake Event
> 
> +      If (\_SB.ISME(P3WK))
> 
> +      {
> 
> +        \_SB.SHPO(P3WK, 1)             // set gpio ownership to driver(0=ACPI
> mode, 1=GPIO mode)
> 
> +        Notify(\_SB.PC00.PEG3, 0x02)   // device wake
> 
> +        \_SB.CAGS(P3WK)                // Clear GPE status bit for PEG2 WAKE
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +} //Scope(\_GPE)
> 
> +
> 
> +If(LAnd((LEqual(HGMD,2)), (LEqual(HGST,1)))) {
> 
> +///
> 
> +/// P.E.G. Root Port D6F0
> 
> +///
> 
> +Scope(\_SB.PC00.PEG0) {
> 
> +  Name(WKEN, 0)
> 
> +
> 
> +  PowerResource(PG00, 0, 0) {
> 
> +    Name(_STA, One)
> 
> +    Method(_ON, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGON(0)
> 
> +        Store(One, _STA)
> 
> +      }
> 
> +    }
> 
> +    Method(_OFF, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGOF(0)
> 
> +        Store(Zero, _STA)
> 
> +      }
> 
> +    }
> 
> +  } //End of PowerResource(PG00, 0, 0)
> 
> +
> 
> +  Name(_PR0,Package(){PG00})
> 
> +  Name(_PR3,Package(){PG00})
> 
> +
> 
> +  ///
> 
> +  /// This method is used to enable/disable wake from PEG60 (WKEN)
> 
> +  ///
> 
> +  Method(_DSW, 3)
> 
> +  {
> 
> +    If(Arg1)
> 
> +    {
> 
> +      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from
> generating runtime PME
> 
> +    }
> 
> +    Else
> 
> +    { /// If Staying in S0
> 
> +      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
> 
> +      {
> 
> +        Store(1, WKEN)      ///- Set PME
> 
> +      } Else {
> 
> +        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0
> or disabling wake
> 
> +      }
> 
> +    }
> 
> +  } // End _DSW
> 
> +
> 
> +  ///
> 
> +  /// This method is used to change the GPIO ownership back to ACPI and
> will be called in PEG OFF Method
> 
> +  ///
> 
> +  Method(P0EW, 0)
> 
> +  {
> 
> +    If(WKEN)
> 
> +    {
> 
> +      If(LNotEqual(SGGP, 0x0))
> 
> +      {
> 
> +        If(LEqual(SGGP, 0x1))      // GPIO mode
> 
> +        {
> 
> +          \_SB.SGOV(P0WK, 0x1)
> 
> +          \_SB.SHPO(P0WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode,
> 1=GPIO mode)
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  } // End P0EW
> 
> +
> 
> +  Method(_S0W, 0) {
> 
> +    Return(4) //D3cold is supported
> 
> +  }
> 
> +}// end "P.E.G. Root Port D6F0"
> 
> +
> 
> +///
> 
> +/// P.E.G. Root Port D1F0
> 
> +///
> 
> +Scope(\_SB.PC00.PEG1) {
> 
> +  Name(WKEN, 0)
> 
> +
> 
> +  PowerResource(PG01, 0, 0) {
> 
> +    Name(_STA, One)
> 
> +    Method(_ON, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGON(1)
> 
> +        Store(One, _STA)
> 
> +      }
> 
> +    }
> 
> +    Method(_OFF, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGOF(1)
> 
> +        Store(Zero, _STA)
> 
> +      }
> 
> +    }
> 
> +  } //End of PowerResource(PG01, 0, 0)
> 
> +
> 
> +  Name(_PR0,Package(){PG01})
> 
> +  Name(_PR3,Package(){PG01})
> 
> +
> 
> +  ///
> 
> +  /// This method is used to enable/disable wake from PEG10 (WKEN)
> 
> +  ///
> 
> +  Method(_DSW, 3)
> 
> +  {
> 
> +    If(Arg1)
> 
> +    {
> 
> +      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from
> generating runtime PME
> 
> +    }
> 
> +    Else
> 
> +    { /// If Staying in S0
> 
> +      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
> 
> +      {
> 
> +        Store(1, WKEN)      ///- Set PME
> 
> +      } Else {
> 
> +        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0
> or disabling wake
> 
> +      }
> 
> +    }
> 
> +  } // End _DSW
> 
> +
> 
> +  ///
> 
> +  /// This method is used to change the GPIO ownership back to ACPI and
> will be called in PEG OFF Method
> 
> +  ///
> 
> +  Method(P1EW, 0)
> 
> +  {
> 
> +    If(WKEN)
> 
> +    {
> 
> +      If(LNotEqual(P1GP, 0x0))
> 
> +      {
> 
> +        If(LEqual(P1GP, 0x1))      // GPIO mode
> 
> +        {
> 
> +          \_SB.SGOV(P1WK, 0x1)
> 
> +          \_SB.SHPO(P1WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode,
> 1=GPIO mode)
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  } // End P1EW
> 
> +}// end "P.E.G. Root Port D1F0"
> 
> +
> 
> +///
> 
> +/// P.E.G. Root Port D1F1
> 
> +///
> 
> +Scope(\_SB.PC00.PEG2) {
> 
> +  Name(WKEN, 0)
> 
> +
> 
> +  PowerResource(PG02, 0, 0) {
> 
> +    Name(_STA, One)
> 
> +    Method(_ON, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGON(2)
> 
> +        Store(One, _STA)
> 
> +      }
> 
> +    }
> 
> +    Method(_OFF, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGOF(2)
> 
> +        Store(Zero, _STA)
> 
> +      }
> 
> +    }
> 
> +  } //End of PowerResource(PG02, 0, 0)
> 
> +
> 
> +  Name(_PR0,Package(){PG02})
> 
> +
> 
> +  Name(_PR3,Package(){PG02})
> 
> +
> 
> +  ///
> 
> +  /// This method is used to enable/disable wake from PEG11 (WKEN)
> 
> +  ///
> 
> +  Method(_DSW, 3)
> 
> +  {
> 
> +    If(Arg1)
> 
> +    {
> 
> +      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from
> generating runtime PME
> 
> +    }
> 
> +    Else
> 
> +    { /// If Staying in S0
> 
> +      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
> 
> +      {
> 
> +        Store(1, WKEN)      ///- Set PME
> 
> +      } Else {
> 
> +        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0
> or disabling wake
> 
> +      }
> 
> +    }
> 
> +  } // End _DSW
> 
> +
> 
> +  ///
> 
> +  /// This method is used to change the GPIO ownership back to ACPI and
> will be called in PEG OFF Method
> 
> +  ///
> 
> +  Method(P2EW, 0)
> 
> +  {
> 
> +    If(WKEN)
> 
> +    {
> 
> +      If(LNotEqual(P2GP, 0x0))
> 
> +      {
> 
> +        If(LEqual(P2GP, 0x1))      // GPIO mode
> 
> +        {
> 
> +          \_SB.SGOV(P2WK, 0x1)
> 
> +          \_SB.SHPO(P2WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode,
> 1=GPIO mode)
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  } // End P2EW
> 
> +}// end "P.E.G. Root Port D1F1"
> 
> +
> 
> +///
> 
> +/// P.E.G. Root Port D1F2
> 
> +///
> 
> +Scope(\_SB.PC00.PEG3) {
> 
> +  Name(WKEN, 0)
> 
> +
> 
> +  PowerResource(PG03, 0, 0) {
> 
> +    Name(_STA, One)
> 
> +    Method(_ON, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGON(3)
> 
> +        Store(One, _STA)
> 
> +      }
> 
> +    }
> 
> +    Method(_OFF, 0, Serialized) {
> 
> +      If(LGreater(OSYS,2009)) {
> 
> +        PGOF(3)
> 
> +        Store(Zero, _STA)
> 
> +      }
> 
> +    }
> 
> +  } //End of PowerResource(PG03, 0, 0)
> 
> +
> 
> +  Name(_PR0,Package(){PG03})
> 
> +  Name(_PR3,Package(){PG03})
> 
> +
> 
> +  ///
> 
> +  /// This method is used to enable/disable wake from PEG12 (WKEN)
> 
> +  ///
> 
> +  Method(_DSW, 3)
> 
> +  {
> 
> +    If(Arg1)
> 
> +    {
> 
> +      Store(0, WKEN)        /// If entering Sx, need to disable WAKE# from
> generating runtime PME
> 
> +    }
> 
> +    Else
> 
> +    { /// If Staying in S0
> 
> +      If(LAnd(Arg0, Arg2))  ///- Check if Exiting D0 and arming for wake
> 
> +      {
> 
> +        Store(1, WKEN)      ///- Set PME
> 
> +      } Else {
> 
> +        Store(0, WKEN)    ///- Disable runtime PME, either because staying in D0
> or disabling wake
> 
> +      }
> 
> +    }
> 
> +  } // End _DSW
> 
> +
> 
> +  ///
> 
> +  /// This method is used to change the GPIO ownership back to ACPI and
> will be called in PEG OFF Method
> 
> +  ///
> 
> +  Method(P3EW, 0)
> 
> +  {
> 
> +    If(WKEN)
> 
> +    {
> 
> +      If(LNotEqual(P3GP, 0x0))
> 
> +      {
> 
> +        If(LEqual(P3GP, 0x1))      // GPIO mode
> 
> +        {
> 
> +          \_SB.SGOV(P3WK, 0x1)
> 
> +          \_SB.SHPO(P3WK, 0x0)     // set gpio ownership to ACPI(0=ACPI mode,
> 1=GPIO mode)
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  } // End P3EW
> 
> +}// end "P.E.G. Root Port D1F2"
> 
> +
> 
> +Scope (\_SB.PC00) {
> 
> +
> 
> +    Name(IVID, 0xFFFF) //Invalid Vendor ID
> 
> +
> 
> +    Name(PEBA, 0) //PCIE base address
> 
> +
> 
> +    Name(PION, 0) //PEG index for ON Method
> 
> +    Name(PIOF, 0) //PEG index for OFF Method
> 
> +
> 
> +    Name(PBUS, 0) //PEG Rootport bus no
> 
> +    Name(PDEV, 0) //PEG Rootport device no
> 
> +    Name(PFUN, 0) //PEG Rootport function no
> 
> +
> 
> +    Name(EBUS, 0) //Endpoint bus no
> 
> +    Name(EDEV, 0) //Endpoint device no
> 
> +    Name(EFN0, 0) //Endpoint function no 0
> 
> +    Name(EFN1, 1) //Endpoint function no 1
> 
> +
> 
> +    Name(LTRS, 0)
> 
> +    Name(OBFS, 0)
> 
> +
> 
> +    Name(DSOF, 0x06) //Device status PCI offset
> 
> +    Name(CPOF, 0x34) //Capabilities pointer PCI offset
> 
> +    Name(SBOF, 0x19) //PCI-2-PCI Secondary Bus number
> 
> +
> 
> +    // PEG0 Endpoint variable to save/restore Link Capability, Link control,
> Subsytem VendorId and Device Id
> 
> +    Name (ELC0, 0x00000000)
> 
> +    Name (ECP0, 0xffffffff)
> 
> +    Name (H0VI, 0x0000)
> 
> +    Name (H0DI, 0x0000)
> 
> +
> 
> +    // PEG1 Endpoint variable to save/restore Link Capability, Link control,
> Subsytem VendorId and Device Id
> 
> +    Name (ELC1, 0x00000000)
> 
> +    Name (ECP1, 0xffffffff)
> 
> +    Name (H1VI, 0x0000)
> 
> +    Name (H1DI, 0x0000)
> 
> +
> 
> +    // PEG2 Endpoint variable to save/restore Link Capability, Link control,
> Subsytem VendorId and Device Id
> 
> +    Name (ELC2, 0x00000000)
> 
> +    Name (ECP2, 0xffffffff)
> 
> +    Name (H2VI, 0x0000)
> 
> +    Name (H2DI, 0x0000)
> 
> +
> 
> +    // PEG3 Endpoint variable to save/restore Link Capability, Link control,
> Subsytem VendorId and Device Id
> 
> +    Name (ELC3, 0x00000000)
> 
> +    Name (ECP3, 0xffffffff)
> 
> +    Name (H3VI, 0x0000)
> 
> +    Name (H3DI, 0x0000)
> 
> +
> 
> +    // PEG_AFELN[15:0]VMTX2_OFFSET variables
> 
> +    Name(AFL0, 0)
> 
> +    Name(AFL1, 0)
> 
> +    Name(AFL2, 0)
> 
> +    Name(AFL3, 0)
> 
> +    Name(AFL4, 0)
> 
> +    Name(AFL5, 0)
> 
> +    Name(AFL6, 0)
> 
> +    Name(AFL7, 0)
> 
> +    Name(AFL8, 0)
> 
> +    Name(AFL9, 0)
> 
> +    Name(AFLA, 0)
> 
> +    Name(AFLB, 0)
> 
> +    Name(AFLC, 0)
> 
> +    Name(AFLD, 0)
> 
> +    Name(AFLE, 0)
> 
> +    Name(AFLF, 0)
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for PEG60 root port that will allow access to its
> 
> +    // Register Block.
> 
> +    //
> 
> +    OperationRegion(OPG0, SystemMemory, Add(XBAS,0x30000), 0x1000)
> 
> +    Field(OPG0, AnyAcc,NoLock,Preserve)
> 
> +    {
> 
> +      Offset(0),
> 
> +      P0VI,   16,        //Vendor ID PCI offset
> 
> +      P0DI,   16,        //Device ID PCI offset
> 
> +      Offset(0x06),
> 
> +      DSO0,   16,        //Device status PCI offset
> 
> +      Offset(0x34),
> 
> +      CPO0,   8,         //Capabilities pointer PCI offset
> 
> +      Offset(0x0B0),
> 
> +      ,       4,
> 
> +      P0LD,   1,         //Link Disable
> 
> +      Offset(0x11A),
> 
> +      ,       1,
> 
> +      P0VC,   1,         //VC0RSTS.VC0NP
> 
> +      Offset(0x214),
> 
> +      ,       16,
> 
> +      P0LS,   4,         //PEGSTS.LKS
> 
> +      Offset(0x248),
> 
> +      ,       7,
> 
> +      Q0L2,   1,         //L23_Rdy Entry Request for RTD3
> 
> +      Q0L0,   1,         //L23 to Detect Transition for RTD3
> 
> +      Offset(0x504),
> 
> +      HST0,  32,
> 
> +      Offset(0x508),
> 
> +      P0TR,   1,         //TRNEN.TREN
> 
> +      Offset(0xC74),
> 
> +      P0LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
> 
> +      Offset(0xD0C),
> 
> +      LRV0,  32,
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for Endpoint on PEG60 root port
> 
> +    //
> 
> +    OperationRegion (PCS0, SystemMemory, Add(XBAS,ShiftLeft(SBN0,20)),
> 0xF0)
> 
> +    Field(PCS0, DWordAcc, Lock, Preserve)
> 
> +    {
> 
> +        Offset(0x0),
> 
> +        D0VI, 16,
> 
> +        Offset(0x2C),
> 
> +        S0VI, 16,
> 
> +        S0DI, 16,
> 
> +    }
> 
> +
> 
> +    OperationRegion(CAP0, SystemMemory,
> Add(Add(XBAS,ShiftLeft(SBN0,20)),EECP),0x14)
> 
> +    Field(CAP0,DWordAcc, NoLock,Preserve)
> 
> +    {
> 
> +        Offset(0x0C),                    // Link Capabilities Register
> 
> +        LCP0,   32,                      // Link Capabilities Register Data
> 
> +        Offset(0x10),
> 
> +        LCT0,   16,                      // Link Control register
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for PEG10 root port that will allow access to its
> 
> +    // Register Block.
> 
> +    //
> 
> +    OperationRegion(OPG1, SystemMemory, Add(XBAS,0x8000), 0x1000)
> 
> +    Field(OPG1, AnyAcc,NoLock,Preserve)
> 
> +    {
> 
> +      Offset(0),
> 
> +      P1VI,   16,        //Vendor ID PCI offset
> 
> +      P1DI,   16,        //Device ID PCI offset
> 
> +      Offset(0x06),
> 
> +      DSO1,   16,        //Device status PCI offset
> 
> +      Offset(0x34),
> 
> +      CPO1,   8,         //Capabilities pointer PCI offset
> 
> +      Offset(0x0B0),
> 
> +      ,       4,
> 
> +      P1LD,   1,         //Link Disable
> 
> +      Offset(0x11A),
> 
> +      ,       1,
> 
> +      P1VC,   1,         //VC0RSTS.VC0NP
> 
> +      Offset(0x214),
> 
> +      ,       16,
> 
> +      P1LS,   4,         //PEGSTS.LKS
> 
> +      Offset(0x248),
> 
> +      ,       7,
> 
> +      Q1L2,   1,         //L23_Rdy Entry Request for RTD3
> 
> +      Q1L0,   1,         //L23 to Detect Transition for RTD3
> 
> +      Offset(0x504),
> 
> +      HST1,  32,
> 
> +      Offset(0x508),
> 
> +      P1TR,   1,         //TRNEN.TREN
> 
> +      Offset(0x70C),
> 
> +      PA0V,  32,         //PEG_AFELN0VMTX2_OFFSET
> 
> +      Offset(0x71C),
> 
> +      PA1V,  32,         //PEG_AFELN1VMTX2_OFFSET
> 
> +      Offset(0x72C),
> 
> +      PA2V,  32,         //PEG_AFELN2VMTX2_OFFSET
> 
> +      Offset(0x73C),
> 
> +      PA3V,  32,         //PEG_AFELN3VMTX2_OFFSET
> 
> +      Offset(0x74C),
> 
> +      PA4V,  32,         //PEG_AFELN4VMTX2_OFFSET
> 
> +      Offset(0x75C),
> 
> +      PA5V,  32,         //PEG_AFELN5VMTX2_OFFSET
> 
> +      Offset(0x76C),
> 
> +      PA6V,  32,         //PEG_AFELN6VMTX2_OFFSET
> 
> +      Offset(0x77C),
> 
> +      PA7V,  32,         //PEG_AFELN7VMTX2_OFFSET
> 
> +      Offset(0x78C),
> 
> +      PA8V,  32,         //PEG_AFELN8VMTX2_OFFSET
> 
> +      Offset(0x79C),
> 
> +      PA9V,  32,         //PEG_AFELN9VMTX2_OFFSET
> 
> +      Offset(0x7AC),
> 
> +      PAAV,  32,         //PEG_AFELNAVMTX2_OFFSET
> 
> +      Offset(0x7BC),
> 
> +      PABV,  32,         //PEG_AFELNBVMTX2_OFFSET
> 
> +      Offset(0x7CC),
> 
> +      PACV,  32,         //PEG_AFELNCVMTX2_OFFSET
> 
> +      Offset(0x7DC),
> 
> +      PADV,  32,         //PEG_AFELNDVMTX2_OFFSET
> 
> +      Offset(0x7EC),
> 
> +      PAEV,  32,         //PEG_AFELNEVMTX2_OFFSET
> 
> +      Offset(0x7FC),
> 
> +      PAFV,  32,         //PEG_AFELNFVMTX2_OFFSET
> 
> +      Offset(0x91C),
> 
> +      ,       31,
> 
> +      BSP1,   1,
> 
> +      Offset(0x93C),
> 
> +      ,       31,
> 
> +      BSP2,   1,
> 
> +      Offset(0x95C),
> 
> +      ,       31,
> 
> +      BSP3,   1,
> 
> +      Offset(0x97C),
> 
> +      ,       31,
> 
> +      BSP4,   1,
> 
> +      Offset(0x99C),
> 
> +      ,       31,
> 
> +      BSP5,   1,
> 
> +      Offset(0x9BC),
> 
> +      ,       31,
> 
> +      BSP6,   1,
> 
> +      Offset(0x9DC),
> 
> +      ,       31,
> 
> +      BSP7,   1,
> 
> +      Offset(0x9FC),
> 
> +       ,       31,
> 
> +      BSP8,   1,
> 
> +      Offset(0xC20),
> 
> +      ,       4,
> 
> +      P1AP,   2,         //AFEOVR.RXSQDETOVR
> 
> +      Offset(0xC38),
> 
> +      ,       3,
> 
> +      P1RM,   1,         //CMNSPARE.PCUNOTL1
> 
> +      Offset(0xC3C),
> 
> +      ,       31,
> 
> +      PRST,   1,
> 
> +      Offset(0xC74),
> 
> +      P1LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
> 
> +      Offset(0xD0C),
> 
> +      LRV1,  32,
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for Endpoint on PEG10 root port
> 
> +    //
> 
> +    OperationRegion (PCS1, SystemMemory, Add(XBAS,ShiftLeft(SBN1,20)),
> 0xF0)
> 
> +    Field(PCS0, DWordAcc, Lock, Preserve)
> 
> +    {
> 
> +        Offset(0x0),
> 
> +        D1VI, 16,
> 
> +        Offset(0x2C),
> 
> +        S1VI, 16,
> 
> +        S1DI, 16,
> 
> +    }
> 
> +
> 
> +    OperationRegion(CAP1, SystemMemory,
> Add(Add(XBAS,ShiftLeft(SBN1,20)),EEC1),0x14)
> 
> +    Field(CAP0,DWordAcc, NoLock,Preserve)
> 
> +    {
> 
> +        Offset(0x0C),                    // Link Capabilities Register
> 
> +        LCP1,   32,                      // Link Capabilities Register Data
> 
> +        Offset(0x10),
> 
> +        LCT1,   16,                      // Link Control register
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for PEG11 root port that will allow access to its
> 
> +    // Register Block.
> 
> +    //
> 
> +    OperationRegion(OPG2, SystemMemory, Add(XBAS,0x9000), 0x1000)
> 
> +    Field(OPG2, AnyAcc,NoLock,Preserve)
> 
> +    {
> 
> +      Offset(0),
> 
> +      P2VI,   16,        //Vendor ID PCI offset
> 
> +      P2DI,   16,        //Device ID PCI offset
> 
> +      Offset(0x06),
> 
> +      DSO2,   16,        //Device status PCI offset
> 
> +      Offset(0x34),
> 
> +      CPO2,   8,         //Capabilities pointer PCI offset
> 
> +      Offset(0x0B0),
> 
> +      ,       4,
> 
> +      P2LD,   1,         //Link Disable
> 
> +      Offset(0x11A),
> 
> +      ,       1,
> 
> +      P2VC,   1,         //VC0RSTS.VC0NP
> 
> +      Offset(0x214),
> 
> +      ,       16,
> 
> +      P2LS,   4,         //PEGSTS.LKS
> 
> +      Offset(0x248),
> 
> +      ,       7,
> 
> +      Q2L2,   1,         //L23_Rdy Entry Request for RTD3
> 
> +      Q2L0,   1,         //L23 to Detect Transition for RTD3
> 
> +      Offset(0x504),
> 
> +      HST2,  32,
> 
> +      Offset(0x508),
> 
> +      P2TR,   1,         //TRNEN.TREN
> 
> +      Offset(0xC20),
> 
> +      ,       4,
> 
> +      P2AP,   2,         //AFEOVR.RXSQDETOVR
> 
> +      Offset(0xC38),
> 
> +      ,       3,
> 
> +      P2RM,   1,         //CMNSPARE.PCUNOTL1
> 
> +      Offset(0xC74),
> 
> +      P2LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
> 
> +      Offset(0xD0C),
> 
> +      LRV2,  32,
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for Endpoint on PEG11 root port
> 
> +    //
> 
> +    OperationRegion (PCS2, SystemMemory, Add(XBAS,ShiftLeft(SBN2,20)),
> 0xF0)
> 
> +    Field(PCS2, DWordAcc, Lock, Preserve)
> 
> +    {
> 
> +        Offset(0x0),
> 
> +        D2VI, 16,
> 
> +        Offset(0x2C),
> 
> +        S2VI, 16,
> 
> +        S2DI, 16,
> 
> +    }
> 
> +
> 
> +    OperationRegion(CAP2, SystemMemory,
> Add(Add(XBAS,ShiftLeft(SBN2,20)),EEC2),0x14)
> 
> +    Field(CAP2,DWordAcc, NoLock,Preserve)
> 
> +    {
> 
> +        Offset(0x0C),    // Link Capabilities Register
> 
> +        LCP2,   32,      // Link Capabilities Register Data
> 
> +        Offset(0x10),
> 
> +        LCT2,   16,      // Link Control register
> 
> +    }
> 
> +
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for PEG12 root port that will allow access to its
> 
> +    // Register Block.
> 
> +    //
> 
> +    OperationRegion(OPG3, SystemMemory, Add(XBAS,0xA000), 0x1000)
> 
> +    Field(OPG3, AnyAcc,NoLock,Preserve)
> 
> +    {
> 
> +      Offset(0),
> 
> +      P3VI,   16,        //Vendor ID PCI offset
> 
> +      P3DI,   16,        //Device ID PCI offset
> 
> +      Offset(0x06),
> 
> +      DSO3,   16,        //Device status PCI offset
> 
> +      Offset(0x34),
> 
> +      CPO3,   8,         //Capabilities pointer PCI offset
> 
> +      Offset(0x0B0),
> 
> +      ,       4,
> 
> +      P3LD,   1,         //Link Disable
> 
> +      Offset(0x11A),
> 
> +      ,       1,
> 
> +      P3VC,   1,         //VC0RSTS.VC0NP
> 
> +      Offset(0x214),
> 
> +      ,       16,
> 
> +      P3LS,   4,         //PEGSTS.LKS
> 
> +      Offset(0x248),
> 
> +      ,       7,
> 
> +      Q3L2,   1,         //L23_Rdy Entry Request for RTD3
> 
> +      Q3L0,   1,         //L23 to Detect Transition for RTD3
> 
> +      Offset(0x504),
> 
> +      HST3,  32,
> 
> +      Offset(0x508),
> 
> +      P3TR,   1,         //TRNEN.TREN
> 
> +      Offset(0xC20),
> 
> +      ,       4,
> 
> +      P3AP,   2,         //AFEOVR.RXSQDETOVR
> 
> +      Offset(0xC38),
> 
> +      ,       3,
> 
> +      P3RM,   1,         //CMNSPARE.PCUNOTL1
> 
> +      Offset(0xC74),
> 
> +      P3LT,   4,         //LTSSM_FSM_RESTORE.LTSSM_FSM_PS
> 
> +      Offset(0xD0C),
> 
> +      LRV3,  32,
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Define a Memory Region for Endpoint on PEG2 root port
> 
> +    //
> 
> +    OperationRegion (PCS3, SystemMemory, Add(XBAS,ShiftLeft(SBN3,20)),
> 0xF0)
> 
> +    Field(PCS2, DWordAcc, Lock, Preserve)
> 
> +    {
> 
> +        Offset(0x0),
> 
> +        D3VI, 16,
> 
> +        Offset(0x2C),
> 
> +        S3VI, 16,
> 
> +        S3DI, 16,
> 
> +    }
> 
> +
> 
> +    OperationRegion(CAP3, SystemMemory,
> Add(Add(XBAS,ShiftLeft(SBN3,20)),EEC3),0x14)
> 
> +    Field(CAP3,DWordAcc, NoLock,Preserve)
> 
> +    {
> 
> +        Offset(0x0C),    // Link Capabilities Register
> 
> +        LCP3,   32,      // Link Capabilities Register Data
> 
> +        Offset(0x10),
> 
> +        LCT3,   16,      // Link Control register
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Name: PGON
> 
> +    // Description: Function to put the Pcie Endpoint in ON state
> 
> +    // Input: Arg0 -> PEG index
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(PGON,1,Serialized)
> 
> +    {
> 
> +      Store(Arg0, PION)
> 
> +
> 
> +      //
> 
> +      // Check for the GPIO support on PEG0/1/2/3 Configuration and Return if
> it is not supported.
> 
> +      //
> 
> +      If (LEqual(PION, 0))
> 
> +      {
> 
> +        If (LEqual(SGGP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 1))
> 
> +      {
> 
> +        If (LEqual(P1GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 2))
> 
> +      {
> 
> +        If (LEqual(P2GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 3))
> 
> +      {
> 
> +        If (LEqual(P3GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      Store(\XBAS, PEBA)
> 
> +      Store(GDEV(PIOF), PDEV)
> 
> +      Store(GFUN(PIOF), PFUN)
> 
> +
> 
> +      /// de-assert CLK_REQ MSK
> 
> +      PGSC(Arg0, 1)
> 
> +
> 
> +      If (LEqual(CCHK(PION, 1), 0))
> 
> +      {
> 
> +        Return ()
> 
> +      }
> 
> +
> 
> +      //Power on the Endpoint
> 
> +      GPPR(PION, 1)
> 
> +
> 
> +      // Restore PEG Recipe before program L23R2DT
> 
> +      //\_SB.PC00.PEG1.RAVR()
> 
> +
> 
> +      // Enable link for RTD3
> 
> +      RTEN()
> 
> +
> 
> +      // Re-store the DGPU Subsystem VendorID, DeviceID & Link control
> register data
> 
> +      If (LEqual(PION, 0))
> 
> +      {
> 
> +        Store(H0VI, S0VI)
> 
> +        Store(H0DI, S0DI)
> 
> +        Or(And(ELC0,0x0043),And(LCT0,0xFFBC),LCT0)
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 1))
> 
> +      {
> 
> +        Store(H1VI, S1VI)
> 
> +        Store(H1DI, S1DI)
> 
> +        Or(And(ELC1,0x0043),And(LCT1,0xFFBC),LCT1)
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 2))
> 
> +      {
> 
> +        Store(H2VI, S2VI)
> 
> +        Store(H2DI, S2DI)
> 
> +        Or(And(ELC2,0x0043),And(LCT2,0xFFBC),LCT2)
> 
> +      }
> 
> +      ElseIf (LEqual(PION, 3))
> 
> +      {
> 
> +        Store(H3VI, S3VI)
> 
> +        Store(H3DI, S3DI)
> 
> +        Or(And(ELC3,0x0043),And(LCT3,0xFFBC),LCT3)
> 
> +      }
> 
> +      Return ()
> 
> +    } // End of Method(PGON,1,Serialized)
> 
> +
> 
> +    //
> 
> +    // Name: PGOF
> 
> +    // Description: Function to put the Pcie Endpoint in OFF state
> 
> +    // Input: Arg0 -> PEG index
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(PGOF,1,Serialized)
> 
> +    {
> 
> +
> 
> +      Store(Arg0, PIOF)
> 
> +      //
> 
> +      // Check for the GPIO support on PEG0/1/2 Configuration and Return if it
> is not supported.
> 
> +      //
> 
> +      If (LEqual(PIOF, 0))
> 
> +      {
> 
> +        If (LEqual(SGGP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PIOF, 1))
> 
> +      {
> 
> +        If (LEqual(P1GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PIOF, 2))
> 
> +      {
> 
> +        If (LEqual(P2GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +      ElseIf (LEqual(PIOF, 3))
> 
> +      {
> 
> +        If (LEqual(P3GP, 0x0))
> 
> +        {
> 
> +          Return ()
> 
> +        }
> 
> +      }
> 
> +
> 
> +      Store(\XBAS, PEBA)
> 
> +      Store(GDEV(PIOF), PDEV)
> 
> +      Store(GFUN(PIOF), PFUN)
> 
> +
> 
> +      If (LEqual(CCHK(PIOF, 0), 0))
> 
> +      {
> 
> +        Return ()
> 
> +      }
> 
> +
> 
> +      // Save Endpoint Link Control register, Subsystem VendorID & Device ID,
> Link capability Data
> 
> +      If (LEqual(Arg0, 0)) //PEG60
> 
> +      {
> 
> +        Store(LCT0, ELC0)
> 
> +        Store(S0VI, H0VI)
> 
> +        Store(S0DI, H0DI)
> 
> +        Store(LCP0, ECP0)
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 1)) //PEG10
> 
> +      {
> 
> +        Store(LCT1, ELC1)
> 
> +        Store(S1VI, H1VI)
> 
> +        Store(S1DI, H1DI)
> 
> +        Store(LCP1, ECP1)
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 2)) //PEG11
> 
> +      {
> 
> +        Store(LCT2, ELC2)
> 
> +        Store(S2VI, H2VI)
> 
> +        Store(S2DI, H2DI)
> 
> +        Store(LCP2, ECP2)
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 3)) //PEG12
> 
> +      {
> 
> +        Store(LCT3, ELC3)
> 
> +        Store(S3VI, H3VI)
> 
> +        Store(S3DI, H3DI)
> 
> +        Store(LCP3, ECP3)
> 
> +      }
> 
> +
> 
> +      //\_SB.PC00.PEG0.SAVR()
> 
> +
> 
> +      // Put link in L2
> 
> +      RTDS()
> 
> +
> 
> +      /// assert CLK_REQ MSK
> 
> +      ///
> 
> +      /// On RTD3 entry, BIOS will instruct the PMC to disable source clocks.
> 
> +      /// This is done through sending a PMC IPC command.
> 
> +      ///
> 
> +      PGSC(Arg0, 0)
> 
> +
> 
> +      //Power-off the Endpoint
> 
> +      GPPR(PIOF, 0)
> 
> +      //Method to set Wake GPIO ownership from GPIO to ACPI for Device
> Initiated RTD3
> 
> +      DIWK(PIOF)
> 
> +
> 
> +      Return ()
> 
> +    } // End of Method(PGOF,1,Serialized)
> 
> +
> 
> +
> 
> +    //
> 
> +    // Name: GDEV
> 
> +    // Description: Function to return the PEG device no for the given PEG
> index
> 
> +    // Input: Arg0 -> PEG index
> 
> +    // Return: PEG device no for the given PEG index
> 
> +    //
> 
> +    Method(GDEV,1)
> 
> +    {
> 
> +      If(LEqual(Arg0, 0))
> 
> +      {
> 
> +        Store(0x6, Local0) //Device6-Function0 = 00110.000
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 1))
> 
> +      {
> 
> +        Store(0x1, Local0) //Device1-Function0 = 00001.000
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 2))
> 
> +      {
> 
> +        Store(0x1, Local0) //Device1-Function2 = 00001.001
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 3))
> 
> +      {
> 
> +        Store(0x1, Local0) //Device1-Function3 = 00001.010
> 
> +      }
> 
> +
> 
> +      Return(Local0)
> 
> +    } // End of Method(GDEV,1)
> 
> +
> 
> +    //
> 
> +    // Name: GFUN
> 
> +    // Description: Function to return the PEG function no for the given PEG
> index
> 
> +    // Input: Arg0 -> PEG index
> 
> +    // Return: PEG function no for the given PEG index
> 
> +    //
> 
> +    Method(GFUN,1)
> 
> +    {
> 
> +      If(LEqual(Arg0, 0))
> 
> +      {
> 
> +        Store(0x0, Local0) //Device6-Function0 = 00110.000
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 1))
> 
> +      {
> 
> +        Store(0x0, Local0) //Device1-Function0 = 00001.000
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 2))
> 
> +      {
> 
> +        Store(0x1, Local0) //Device1-Function1 = 00001.001
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 2))
> 
> +      {
> 
> +        Store(0x2, Local0) //Device1-Function2 = 00001.010
> 
> +      }
> 
> +
> 
> +      Return(Local0)
> 
> +    } // End of Method(GFUN,1)
> 
> +
> 
> +    //
> 
> +    // Name: CCHK
> 
> +    // Description: Function to check whether _ON/_OFF sequence is allowed
> to execute for the given PEG controller or not
> 
> +    // Input: Arg0 -> PEG index
> 
> +    //        Arg1 -> 0 means _OFF sequence, 1 means _ON sequence
> 
> +    // Return: 0 - Don't execute the flow, 1 - Execute the flow
> 
> +    //
> 
> +    Method(CCHK,2)
> 
> +    {
> 
> +
> 
> +      //Check for Referenced PEG controller is present or not
> 
> +      If(LEqual(Arg0, 0))
> 
> +      {
> 
> +        Store(P0VI, Local7)
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 1))
> 
> +      {
> 
> +        Store(P1VI, Local7)
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 2))
> 
> +      {
> 
> +        Store(P2VI, Local7)
> 
> +      }
> 
> +      ElseIf(LEqual(Arg0, 3))
> 
> +      {
> 
> +        Store(P3VI, Local7)
> 
> +      }
> 
> +
> 
> +      If(LEqual(Local7, IVID))
> 
> +      {
> 
> +        Return(0)
> 
> +      }
> 
> +
> 
> +      If(LNotEqual(Arg0, 1))
> 
> +      {
> 
> +        //Check for PEG10 controller presence
> 
> +        Store(P1VI, Local7)
> 
> +        If(LEqual(Local7, IVID))
> 
> +        {
> 
> +          Return(0)
> 
> +        }
> 
> +      }
> 
> +
> 
> +      //If Endpoint is not present[already disabled] before executing PGOF
> then don't call the PGOF method
> 
> +      //If Endpoint is present[already enabled] before executing PGON then
> don't call the PGON method
> 
> +      If(LEqual(Arg1, 0))
> 
> +      {
> 
> +        //_OFF sequence condition check
> 
> +        If(LEqual(Arg0, 0))
> 
> +        {
> 
> +          If(LEqual(SGPI(SGGP, PWE0, PWG0, PWA0), 0))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 1))
> 
> +        {
> 
> +          If(LEqual(SGPI(P1GP, PWE1, PWG1, PWA1), 0))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 2))
> 
> +        {
> 
> +          If(LEqual(SGPI(P2GP, PWE2, PWG2, PWA2), 0))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 3))
> 
> +        {
> 
> +          If(LEqual(SGPI(P3GP, PWE3, PWG3, PWA3), 0))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +      ElseIf(LEqual(Arg1, 1))
> 
> +      {
> 
> +        //_ON sequence condition check
> 
> +        If(LEqual(Arg0, 0))
> 
> +        {
> 
> +          If(LEqual(SGPI(SGGP, PWE0, PWG0, PWA0), 1))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 1))
> 
> +        {
> 
> +          If(LEqual(SGPI(P1GP, PWE1, PWG1, PWA1), 1))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 2))
> 
> +        {
> 
> +          If(LEqual(SGPI(P2GP, PWE2, PWG2, PWA2), 1))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +        If(LEqual(Arg0, 3))
> 
> +        {
> 
> +          If(LEqual(SGPI(P3GP, PWE3, PWG3, PWA3), 1))
> 
> +          {
> 
> +            Return(0)
> 
> +          }
> 
> +        }
> 
> +      }
> 
> +
> 
> +      Return(1)
> 
> +    }
> 
> +
> 
> +
> 
> +    //
> 
> +    // Name: SGPI [PCIe GPIO Read]
> 
> +    // Description: Function to Read from PCIe GPIO
> 
> +    // Input: Arg0 -> Gpio Support
> 
> +    //        Arg1 -> Expander Number
> 
> +    //        Arg2 -> Gpio Number
> 
> +    //        Arg3 -> Active Information
> 
> +    // Return: GPIO value
> 
> +    //
> 
> +    Method(SGPI, 4, Serialized)
> 
> +    {
> 
> +      If (LEqual(Arg0, 0x01))
> 
> +      {
> 
> +        //
> 
> +        // PCH based GPIO
> 
> +        //
> 
> +        If (CondRefOf(\_SB.GGOV))
> 
> +        {
> 
> +          Store(\_SB.GGOV(Arg2), Local0)
> 
> +        }
> 
> +      }
> 
> +      //
> 
> +      // Invert if Active Low
> 
> +      //
> 
> +      If (LEqual(Arg3,0))
> 
> +      {
> 
> +        Not(Local0, Local0)
> 
> +        And (Local0, 0x01, Local0)
> 
> +      }
> 
> +
> 
> +      Return(Local0)
> 
> +    }// End of Method(SGPI)
> 
> +
> 
> +    // Name: PGSC [PEG port source clock control]
> 
> +    // Description: Function to enable/disable PEG port source clocks
> 
> +    // Input: Arg0 -> PEG index
> 
> +    //        Arg1 -> Enable/Disable Clock (0 = Disable, 1 = Enable)
> 
> +    // Return: Nothing
> 
> +    //
> 
> +
> 
> +    Method(PGSC, 2, Serialized)
> 
> +    {
> 
> +      If(LEqual(Arg0, 0)) { // PEG0
> 
> +        Store (P0SC, Local0)
> 
> +      } ElseIf(LEqual(Arg0, 1)) { // PEG1
> 
> +        Store (P1SC, Local0)
> 
> +      } ElseIf(LEqual(Arg0, 2)) { // PEG2
> 
> +        Store (P2SC, Local0)
> 
> +      } ElseIf(LEqual(Arg0, 3)) {// PEG3
> 
> +        Store (P3SC, Local0)
> 
> +      } Else {
> 
> +        Return()
> 
> +      }
> 
> +
> 
> +      SPCO (Local0, Arg1)
> 
> +    }// End of Method(PGSC)
> 
> +
> 
> +    //
> 
> +    // Name: GPPR
> 
> +    // Description: Function to do Endpoint ON/OFF using GPIOs
> 
> +    //              There are two GPIOs currently used to control Third Party
> Vendor[TPV] DGPU Endpoint devices:
> 
> +    //              (1) DGPU_PWR_EN [used for Power control]
> 
> +    //              (2) DGPU_HOLD_RST[used for Reset control]
> 
> +    // Input: Arg0 -> PEG index
> 
> +    //        Arg1 -> 0 means _OFF sequence, 1 means _ON sequence
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(GPPR,2)
> 
> +    {
> 
> +
> 
> +      If(LEqual(Arg1, 0))
> 
> +      {
> 
> +        //_OFF sequence GPIO programming
> 
> +        If(LEqual(Arg0, 0))
> 
> +        {
> 
> +          SGPO(SGGP, HRE0, HRG0, HRA0, 1) // Assert PCIe0/dGPU_HOLD_RST#
> (PERST#)
> 
> +          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms
> after Assert the Reset
> 
> +          SGPO(SGGP, PWE0, PWG0, PWA0, 0) // Deassert
> PCIe0/dGPU_PWR_EN#
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 1))
> 
> +        {
> 
> +          SGPO(P1GP, HRE1, HRG1, HRA1, 1) // Assert PCIe1_HOLD_RST#
> (PERST#)
> 
> +          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms
> after Assert the Reset
> 
> +          SGPO(P1GP, PWE1, PWG1, PWA1, 0) // Deassert PCIe1_PWR_EN#
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 2))
> 
> +        {
> 
> +          SGPO(P2GP, HRE2, HRG2, HRA2, 1) // Assert PCIe2_HOLD_RST#
> (PERST#)
> 
> +          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms
> after Assert the Reset
> 
> +          SGPO(P2GP, PWE2, PWG2, PWA2, 0) // Deassert PCIe2_PWR_EN#
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 3))
> 
> +        {
> 
> +          SGPO(P3GP, HRE3, HRG3, HRA3, 1) // Assert PCIe3_HOLD_RST#
> (PERST#)
> 
> +          //Sleep(DLHR)                     // As per the PCIe spec, Wait for 'given'ms
> after Assert the Reset
> 
> +          SGPO(P3GP, PWE3, PWG3, PWA3, 0) // Deassert PCIe2_PWR_EN#
> 
> +        }
> 
> +      }
> 
> +      ElseIf(LEqual(Arg1, 1))
> 
> +      {
> 
> +        //_ON sequence GPIO programming
> 
> +        If(LEqual(Arg0, 0))
> 
> +        {
> 
> +          SGPO(SGGP, PWE0, PWG0, PWA0, 1) //Assert dGPU_PWR_EN#
> 
> +
> 
> +          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
> 
> +          SGPO(SGGP, HRE0, HRG0, HRA0, 0) //Deassert dGPU_HOLD_RST# as
> per the PCIe spec
> 
> +
> 
> +          //Sleep(DLHR) // Wait for 'given'ms after Deassert
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 1))
> 
> +        {
> 
> +          SGPO(P1GP, PWE1, PWG1, PWA1, 1) //Assert dGPU_PWR_EN#
> 
> +
> 
> +          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
> 
> +          SGPO(P1GP, HRE1, HRG1, HRA1, 0) //Deassert dGPU_HOLD_RST# as
> per the PCIe spec
> 
> +
> 
> +          //Sleep(DLHR) // Wait for 'given'ms after Deassert
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 2))
> 
> +        {
> 
> +          SGPO(P2GP, PWE2, PWG2, PWA2, 1) //Assert dGPU_PWR_EN#
> 
> +
> 
> +          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
> 
> +          SGPO(P2GP, HRE2, HRG2, HRA2, 0) //Deassert dGPU_HOLD_RST# as
> per the PCIe spec
> 
> +
> 
> +          //Sleep(DLHR) // Wait for 'given'ms after Deassert
> 
> +        }
> 
> +
> 
> +        If(LEqual(Arg0, 3))
> 
> +        {
> 
> +          SGPO(P3GP, PWE3, PWG3, PWA3, 1) //Assert dGPU_PWR_EN#
> 
> +
> 
> +          //Sleep(DLPW) // Wait for 'given'ms for power to get stable
> 
> +          SGPO(P3GP, HRE3, HRG3, HRA3, 0) //Deassert dGPU_HOLD_RST# as
> per the PCIe spec
> 
> +
> 
> +          //Sleep(DLHR) // Wait for 'given'ms after Deassert
> 
> +        }
> 
> +      }
> 
> +    } // End of Method(GPPR,2)
> 
> +
> 
> +    //
> 
> +    // Name: SGPO [PCIe GPIO Write]
> 
> +    // Description: Function to write into PCIe GPIO
> 
> +    // Input: Arg0 -> Gpio Support
> 
> +    //        Arg1 -> Expander Number
> 
> +    //        Arg2 -> Gpio Number
> 
> +    //        Arg3 -> Active Information
> 
> +    //        Arg4 -> Value to write
> 
> +    // Return: Nothing
> 
> +    //
> 
> +
> 
> +    Method(SGPO, 5, Serialized)
> 
> +    {
> 
> +      //
> 
> +      // Invert if Active Low
> 
> +      //
> 
> +      If (LEqual(Arg3,0))
> 
> +      {
> 
> +        Not(Arg4, Arg4)
> 
> +        And(Arg4, 0x01, Arg4)
> 
> +      }
> 
> +      If (LEqual(Arg0, 0x01))
> 
> +      {
> 
> +        //
> 
> +        // PCH based GPIO
> 
> +        //
> 
> +        If (CondRefOf(\_SB.SGOV))
> 
> +        {
> 
> +          \_SB.SGOV(Arg2, Arg4)
> 
> +        }
> 
> +      }
> 
> +    } // End of Method(SGPO)
> 
> +
> 
> +    //
> 
> +    // Name: DIWK
> 
> +    // Description: Function which set the GPIO ownership to ACPI for device
> initiated RTD3
> 
> +    // Input: PEG Index
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(DIWK,1)
> 
> +    {
> 
> +      If (LEqual(Arg0, 0))
> 
> +      {
> 
> +        \_SB.PC00.PEG0.P0EW()
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 1))
> 
> +      {
> 
> +        \_SB.PC00.PEG1.P1EW()
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 2))
> 
> +      {
> 
> +        \_SB.PC00.PEG2.P2EW()
> 
> +      }
> 
> +      ElseIf (LEqual(Arg0, 3))
> 
> +      {
> 
> +        \_SB.PC00.PEG3.P3EW()
> 
> +      }
> 
> +    }
> 
> +  }// End of Scope (\_SB.PC00)
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3
> .asl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3
> .asl
> new file mode 100644
> index 0000000000..b5d1a4e35e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/PegRtd3
> .asl
> @@ -0,0 +1,124 @@
> +/** @file
> 
> +  This file contains the device definitions of the SystemAgent
> 
> +  PCIE ACPI Reference Code.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +Scope (\_SB.PC00) {
> 
> +
> 
> +  OperationRegion(PXCS,PCI_Config,0x00,0x480)
> 
> +  Field(PXCS,AnyAcc, NoLock, Preserve)
> 
> +  {
> 
> +    Offset(0),
> 
> +    VDID, 32,
> 
> +    Offset(0x50), // LCTL - Link Control Register
> 
> +    L0SE, 1,      // 0, L0s Entry Enabled
> 
> +    , 3,
> 
> +    LDIS, 1,
> 
> +    , 3,
> 
> +    Offset(0x52), // LSTS - Link Status Register
> 
> +    , 13,
> 
> +    LASX, 1,      // 0, Link Active Status
> 
> +    Offset(0x5A), // SLSTS[7:0] - Slot Status Register
> 
> +    ABPX, 1,      // 0, Attention Button Pressed
> 
> +    , 2,
> 
> +    PDCX, 1,      // 3, Presence Detect Changed
> 
> +    , 2,
> 
> +    PDSX, 1,      // 6, Presence Detect State
> 
> +    , 1,
> 
> +    Offset(0x60), // RSTS - Root Status Register
> 
> +    , 16,
> 
> +    PSPX, 1,      // 16,  PME Status
> 
> +    Offset(0xA4),
> 
> +    D3HT, 2,      // Power State
> 
> +    Offset(0xD8), // 0xD8, MPC - Miscellaneous Port Configuration Register
> 
> +    , 30,
> 
> +    HPEX, 1,      // 30,  Hot Plug SCI Enable
> 
> +    PMEX, 1,      // 31,  Power Management SCI Enable
> 
> +    Offset(0xE0), // 0xE0, SPR - Scratch Pad Register
> 
> +    , 0,
> 
> +    SCB0, 1,      // Sticky Scratch Pad Bit SCB0
> 
> +    Offset(0xE2), // 0xE2, RPPGEN - Root Port Power Gating Enable
> 
> +    , 2,
> 
> +    L23E, 1,       // 2,   L23_Rdy Entry Request (L23ER)
> 
> +    L23R, 1,       // 3,   L23_Rdy to Detect Transition (L23R2DT)
> 
> +    Offset(0x324), // 0x324 - PCIEDBG
> 
> +    , 3,
> 
> +    LEDM, 1,       // PCIEDBG.DMIL1EDM
> 
> +    Offset(0x328), // 0x328 - PCIESTS1
> 
> +    , 24,
> 
> +    LTSM, 8,
> 
> +  }
> 
> +  Field(PXCS,AnyAcc, NoLock, WriteAsZeros)
> 
> +  {
> 
> +    Offset(0xDC), // 0xDC, SMSCS - SMI/SCI Status Register
> 
> +    , 30,
> 
> +    HPSX, 1,      // 30,  Hot Plug SCI Status
> 
> +    PMSX, 1       // 31,  Power Management SCI Status
> 
> +  }
> 
> +
> 
> +    //
> 
> +    // Name: RTEN
> 
> +    // Description: Function to Enable the link for RTD3 [RCTL.L22DT]
> 
> +    // Input: PEG Index
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(RTEN, 0, Serialized)
> 
> +    {
> 
> +      If (LNotEqual (SCB0,0x1)) {
> 
> +        Return ()
> 
> +      }
> 
> +
> 
> +      /// Set L23_Rdy to Detect Transition  (L23R2DT)
> 
> +      Store(1, L23R)
> 
> +      Store(0, Local0)
> 
> +      /// Wait for transition to Detect
> 
> +      While(L23R) {
> 
> +        If(Lgreater(Local0, 4))
> 
> +        {
> 
> +          Break
> 
> +        }
> 
> +        Sleep(16)
> 
> +        Increment(Local0)
> 
> +      }
> 
> +      Store(0,SCB0)
> 
> +
> 
> +      /// Once in Detect, wait up to 124 ms for Link Active (typically happens in
> under 70ms)
> 
> +      /// Worst case per PCIe spec from Detect to Link Active is:
> 
> +      /// 24ms in Detect (12+12), 72ms in Polling (24+48), 28ms in Config
> (24+2+2+2+2)
> 
> +      Store(0, Local0)
> 
> +      While(LEqual(LASX,0)) {
> 
> +        If(Lgreater(Local0, 8))
> 
> +        {
> 
> +          Break
> 
> +        }
> 
> +        Sleep(16)
> 
> +        Increment(Local0)
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Name: RTDS
> 
> +    // Description: Function to Disable link for RTD3 [RCTL.L23ER]
> 
> +    // Input: PEG Index
> 
> +    // Return: Nothing
> 
> +    //
> 
> +    Method(RTDS, 0, Serialized)
> 
> +    {
> 
> +      Store(1, L23E)
> 
> +      Sleep(16)
> 
> +      Store(0, Local0)
> 
> +      While(L23E) {
> 
> +        If(Lgreater(Local0, 4))
> 
> +        {
> 
> +          Break
> 
> +        }
> 
> +        Sleep(16)
> 
> +        Increment(Local0)
> 
> +      }
> 
> +      Store(1,SCB0)
> 
> +    }
> 
> +
> 
> +} // End of Scope (\_SB.PC00)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
> new file mode 100644
> index 0000000000..5228d9d753
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/Sa.asl
> @@ -0,0 +1,26 @@
> +/** @file
> 
> +  This file contains the device definition of the System Agent
> 
> +  ACPI reference code.
> 
> +  Currently defines the device objects for the
> 
> +  System Agent PCI Express* ports (PEG), iGfx and other devices.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +External(\HGMD)
> 
> +External(\HGST)
> 
> +External(\_SB.PC00, DeviceObj)
> 
> +External(\_SB.PC00.GFX0, DeviceObj)
> 
> +External(\_SB.PC00.IPU0, DeviceObj)
> 
> +External(\_SB.PC00.B0D3, DeviceObj)
> 
> +External(\_SB.PC00.PCIC, MethodObj)
> 
> +External(\_SB.PC00.PCID, MethodObj)
> 
> +///
> 
> +/// CPU PCIe Root Port
> 
> +///
> 
> +include("CpuPcieRp.asl")
> 
> +include("PegCommon.asl")
> 
> +If(LAnd((LEqual(HGMD,2)), (LEqual(HGST,1)))) {
> 
> +  include("PegRtd3.asl")
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.a
> sl
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.a
> sl
> new file mode 100644
> index 0000000000..0494c659e0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.a
> sl
> @@ -0,0 +1,20 @@
> +/** @file
> 
> +  This file contains the SystemAgent SSDT Table ASL code.
> 
> +  It defines a Global NVS table which exchanges datas between OS
> 
> +  and BIOS.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +DefinitionBlock (
> 
> +  "SaSsdt.aml",
> 
> +  "SSDT",
> 
> +  0x02,
> 
> +  "SaSsdt",
> 
> +  "SaSsdt ",
> 
> +  0x3000
> 
> +  )
> 
> +{
> 
> +  Include ("Sa.asl")
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.i
> nf
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.i
> nf
> new file mode 100644
> index 0000000000..d0d1494b99
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/AcpiTables/SaSsdt/SaSsdt.i
> nf
> @@ -0,0 +1,22 @@
> +## @file
> 
> +#  Component description file for the ACPI tables
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION          = 0x00010005
> 
> +BASE_NAME            = SaSsdt
> 
> +FILE_GUID            = ca89914d-2317-452e-b245-36c6fb77a9c6
> 
> +MODULE_TYPE          = USER_DEFINED
> 
> +VERSION_STRING       = 1.0
> 
> +
> 
> +[Sources]
> 
> +  SaSsdt.asl
> 
> +
> 
> +
> 
> +[Packages]
> 
> +  MdePkg/MdePkg.dec
> 
> +  TigerlakeSiliconPkg/SiPkg.dec
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.c
> new file mode 100644
> index 0000000000..d33c20605a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.c
> @@ -0,0 +1,264 @@
> +/** @file
> 
> +  This file provide services for DXE phase policy default initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include "DxeSaPolicyLibrary.h"
> 
> +#include <Library/DxeGraphicsPolicyLib.h>
> 
> +#include <Library/DxeVtdPolicyLib.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +extern EFI_GUID gMemoryDxeConfigGuid;
> 
> +extern EFI_GUID gPcieDxeConfigGuid;
> 
> +
> 
> +/**
> 
> +  This function prints the SA DXE phase policy.
> 
> +
> 
> +  @param[in] SaPolicy - SA DXE Policy protocol
> 
> +**/
> 
> +VOID
> 
> +SaPrintPolicyProtocol (
> 
> +  IN  SA_POLICY_PROTOCOL      *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                  Status;
> 
> +  PCIE_DXE_CONFIG             *PcieDxeConfig;
> 
> +  MEMORY_DXE_CONFIG           *MemoryDxeConfig;
> 
> +
> 
> +  //
> 
> +  // Get requisite IP Config Blocks which needs to be used here
> 
> +  //
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gPcieDxeConfigGuid, (VOID
> *)&PcieDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = GetConfigBlock ((VOID *) SaPolicy, &gMemoryDxeConfigGuid,
> (VOID *)&MemoryDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +
> 
> +  DEBUG_CODE_BEGIN ();
> 
> +  INTN  i;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ SA Policy (DXE) print BEGIN
> -----------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, "Revision : %x\n", SaPolicy-
> >TableHeader.Header.Revision));
> 
> +  ASSERT (SaPolicy->TableHeader.Header.Revision ==
> SA_POLICY_PROTOCOL_REVISION);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------
> SA_MEMORY_CONFIGURATION -----------------\n"));
> 
> +  //@todo: Matching the hardcode at lines 384.  Need to be addressed.

This is an old comment that is no longer relevant, please delete.

> 
> +  DEBUG ((DEBUG_INFO, " SpdAddressTable[%d] :", 4));
> 
> +  for (i = 0; i < 4; i++) {
> 
> +    DEBUG ((DEBUG_INFO, " %x", MemoryDxeConfig->SpdAddressTable[i]));
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " ChannelASlotMap : %x\n", MemoryDxeConfig-
> >ChannelASlotMap));
> 
> +  DEBUG ((DEBUG_INFO, " ChannelBSlotMap : %x\n", MemoryDxeConfig-
> >ChannelBSlotMap));
> 
> +  DEBUG ((DEBUG_INFO, " MrcTimeMeasure  : %x\n", MemoryDxeConfig-
> >MrcTimeMeasure));
> 
> +  DEBUG ((DEBUG_INFO, " MrcFastBoot     : %x\n", MemoryDxeConfig-
> >MrcFastBoot));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "------------------------ CPU_PCIE_CONFIGURATION
> -----------------\n"));
> 
> +  DEBUG ((DEBUG_INFO, " PegAspm[%d] :", SA_PEG_MAX_FUN));
> 
> +  for (i = 0; i < SA_PEG_MAX_FUN; i++) {
> 
> +    DEBUG ((DEBUG_INFO, " %x", PcieDxeConfig->PegAspm[i]));
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, " PegRootPortHPE[%d] :", SA_PEG_MAX_FUN));
> 
> +  for (i = 0; i < SA_PEG_MAX_FUN; i++) {
> 
> +    DEBUG ((DEBUG_INFO, " %x", PcieDxeConfig->PegRootPortHPE[i]));
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "\n"));
> 
> +
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "\n------------------------ SA Policy (DXE) print END --
> ---------------\n"));
> 
> +  DEBUG_CODE_END ();
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default for PCIe
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +LoadPcieDxeDefault (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  UINT8                  Index;
> 
> +  PCIE_DXE_CONFIG        *PcieDxeConfig;
> 
> +
> 
> +  PcieDxeConfig = ConfigBlockPointer;
> 
> +  DEBUG ((DEBUG_INFO, "PcieDxeConfig->Header.GuidHob.Name = %g\n",
> &PcieDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "PcieDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", PcieDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +  ///
> 
> +  /// Initialize the PCIE Configuration
> 
> +  /// PEG ASPM per port configuration. 4 PEG controllers i.e. 0,1,2,3
> 
> +  ///
> 
> +  for (Index = 0; Index < SA_PEG_MAX_FUN; Index++) {
> 
> +    PcieDxeConfig->PegAspm[Index]       = CpuPcieAspmAutoConfig;
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < SA_PEG_MAX_FUN; Index++) {
> 
> +    PcieDxeConfig->PegPwrOpt[Index].LtrEnable            = 1;
> 
> +    PcieDxeConfig->PegPwrOpt[Index].LtrMaxSnoopLatency   =
> V_SA_LTR_MAX_SNOOP_LATENCY_VALUE;
> 
> +    PcieDxeConfig->PegPwrOpt[Index].LtrMaxNoSnoopLatency =
> V_SA_LTR_MAX_NON_SNOOP_LATENCY_VALUE;
> 
> +    PcieDxeConfig->PegPwrOpt[Index].ObffEnable           = 1;
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Load DXE Config block default
> 
> +
> 
> +  @param[in] ConfigBlockPointer         Pointer to config block
> 
> +**/
> 
> +VOID
> 
> +LoadMemoryDxeDefault (
> 
> +  IN VOID    *ConfigBlockPointer
> 
> +  )
> 
> +{
> 
> +  MEMORY_DXE_CONFIG        *MemoryDxeConfig;
> 
> +
> 
> +  MemoryDxeConfig = ConfigBlockPointer;
> 
> +  DEBUG ((DEBUG_INFO, "MemoryDxeConfig->Header.GuidHob.Name =
> %g\n", &MemoryDxeConfig->Header.GuidHob.Name));
> 
> +  DEBUG ((DEBUG_INFO, "MemoryDxeConfig-
> >Header.GuidHob.Header.HobLength = 0x%x\n", MemoryDxeConfig-
> >Header.GuidHob.Header.HobLength));
> 
> +  ///
> 
> +  /// Initialize the Memory Configuration
> 
> +  ///
> 
> +  ///
> 
> +  /// DIMM SMBus addresses info
> 
> +  /// Refer to the SpdAddressTable[] mapping rule in DxeSaPolicyLibrary.h
> 
> +  ///
> 
> +  MemoryDxeConfig->SpdAddressTable = AllocateZeroPool (sizeof (UINT8)
> * 4);
> 
> +  ASSERT (MemoryDxeConfig->SpdAddressTable != NULL);
> 
> +  if (MemoryDxeConfig->SpdAddressTable != NULL) {
> 
> +    MemoryDxeConfig->SpdAddressTable[0] = DIMM_SMB_SPD_P0C0D0;
> 
> +    MemoryDxeConfig->SpdAddressTable[1] = DIMM_SMB_SPD_P0C0D1;
> 
> +    MemoryDxeConfig->SpdAddressTable[2] = DIMM_SMB_SPD_P0C1D0;
> 
> +    MemoryDxeConfig->SpdAddressTable[3] = DIMM_SMB_SPD_P0C1D1;
> 
> +  }
> 
> +  MemoryDxeConfig->ChannelASlotMap = 0x01;
> 
> +  MemoryDxeConfig->ChannelBSlotMap = 0x01;
> 
> +}
> 
> +
> 
> +/**
> 
> +  LoadSaDxeConfigBlockDefault - Initialize default settings for each SA Config
> block
> 
> +
> 
> +  @param[in] ConfigBlockPointer         The buffer pointer that will be
> initialized as specific config block
> 
> +  @param[in] BlockId                    Request to initialize defaults of specified
> config block by given Block ID
> 
> +
> 
> +  @retval EFI_SUCCESS                   The given buffer has contained the defaults
> of requested config block
> 
> +  @retval EFI_NOT_FOUND                 Block ID is not defined so no default
> Config block will be initialized
> 
> +**/
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED COMPONENT_BLOCK_ENTRY
> mSaDxeIpBlocks [] = {
> 
> +  {&gPcieDxeConfigGuid,     sizeof (PCIE_DXE_CONFIG),
> PCIE_DXE_CONFIG_REVISION,      LoadPcieDxeDefault},
> 
> +  {&gMemoryDxeConfigGuid,   sizeof (MEMORY_DXE_CONFIG),
> MEMORY_DXE_CONFIG_REVISION,    LoadMemoryDxeDefault}
> 
> +};
> 
> +
> 
> +
> 
> +/**
> 
> +  CreateSaDxeConfigBlocks generates the config blocksg of SA DXE Policy.
> 
> +  It allocates and zero out buffer, and fills in the Intel default settings.
> 
> +
> 
> +  @param[out] SaPolicy               The pointer to get SA  DXE Protocol instance
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy default is initialized.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +CreateSaDxeConfigBlocks (
> 
> +  IN OUT  SA_POLICY_PROTOCOL      **SaPolicy
> 
> +  )
> 
> +{
> 
> +  UINT16              TotalBlockSize;
> 
> +  EFI_STATUS          Status;
> 
> +  SA_POLICY_PROTOCOL  *SaInitPolicy;
> 
> +  UINT16              RequiredSize;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SA Create Dxe Config Blocks\n"));
> 
> +
> 
> +  SaInitPolicy = NULL;
> 
> +
> 
> +  TotalBlockSize = GetComponentConfigBlockTotalSize
> (&mSaDxeIpBlocks[0], sizeof (mSaDxeIpBlocks) / sizeof
> (COMPONENT_BLOCK_ENTRY));
> 
> +  TotalBlockSize += VtdGetConfigBlockTotalSizeDxe ();
> 
> +  TotalBlockSize += GraphicsGetConfigBlockTotalSizeDxe ();
> 
> +  DEBUG ((DEBUG_INFO, "TotalBlockSize = 0x%x\n", TotalBlockSize));
> 
> +
> 
> +  RequiredSize = sizeof (CONFIG_BLOCK_TABLE_HEADER) + TotalBlockSize;
> 
> +
> 
> +  Status = CreateConfigBlockTable (RequiredSize, (VOID *) &SaInitPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Initialize Policy Revision
> 
> +  //
> 
> +  SaInitPolicy->TableHeader.Header.Revision =
> SA_POLICY_PROTOCOL_REVISION;
> 
> +  //
> 
> +  // Add config blocks.
> 
> +  //
> 
> +  Status =  AddComponentConfigBlocks ((VOID *) SaInitPolicy,
> &mSaDxeIpBlocks[0], sizeof (mSaDxeIpBlocks) / sizeof
> (COMPONENT_BLOCK_ENTRY));
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  // Vtd
> 
> +  Status = VtdAddConfigBlocksDxe((VOID *) SaInitPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  // Gfx
> 
> +  Status = GraphicsAddConfigBlocksDxe ((VOID *) SaInitPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Assignment for returning SaInitPolicy config block base address
> 
> +  //
> 
> +  *SaPolicy = SaInitPolicy;
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  SaInstallPolicyProtocol installs SA Policy.
> 
> +  While installed, RC assumes the Policy is ready and finalized. So please
> update and override
> 
> +  any setting before calling this function.
> 
> +
> 
> +  @param[in] ImageHandle                Image handle of this driver.
> 
> +  @param[in] SaPolicy                   The pointer to SA Policy Protocol instance
> 
> +
> 
> +  @retval EFI_SUCCESS                   The policy is installed.
> 
> +  @retval EFI_OUT_OF_RESOURCES          Insufficient resources to create
> buffer
> 
> +
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaInstallPolicyProtocol (
> 
> +  IN  EFI_HANDLE                  ImageHandle,
> 
> +  IN  SA_POLICY_PROTOCOL         *SaPolicy
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +
> 
> +  ///
> 
> +  /// Print SA DXE Policy
> 
> +  ///
> 
> +  SaPrintPolicyProtocol (SaPolicy);
> 
> +  GraphicsDxePolicyPrint (SaPolicy);
> 
> +  VtdPrintPolicyDxe (SaPolicy);
> 
> +
> 
> +  ///
> 
> +  /// Install protocol to to allow access to this Policy.
> 
> +  ///
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gSaPolicyProtocolGuid,
> 
> +                  SaPolicy,
> 
> +                  NULL
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.inf
> new file mode 100644
> index 0000000000..8af3d09b80
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLib.inf
> @@ -0,0 +1,48 @@
> +## @file
> 
> +# Component description file for the PeiSaPolicy library.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeSaPolicyLib
> 
> +FILE_GUID = B402A3A4-4B82-410E-B79C-5914880A05E7
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = DxeSaPolicyLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseMemoryLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +PostCodeLib
> 
> +ConfigBlockLib
> 
> +HobLib
> 
> +DxeGraphicsPolicyLib
> 
> +DxeVtdPolicyLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +DxeSaPolicyLib.c
> 
> +DxeSaPolicyLibrary.h
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gPcieDxeConfigGuid
> 
> +gMemoryDxeConfigGuid
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gSaPolicyProtocolGuid ## PRODUCES
> 
> +
> 
> +[Pcd]
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLibrary.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLibrary.h
> new file mode 100644
> index 0000000000..d46dd44df3
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/DxeSaPolicyLib/Dxe
> SaPolicyLibrary.h
> @@ -0,0 +1,34 @@
> +/** @file
> 
> +  Header file for the DxeSaPolicy library.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _DXE_SA_POLICY_LIBRARY_H_
> 
> +#define _DXE_SA_POLICY_LIBRARY_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <CpuPcieConfigGen3.h>

Remove this line

> 
> +#include <CpuPcieConfig.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +
> 
> +#define WORD_FIELD_VALID_BIT  BIT15
> 
> +#define MAX_PCIE_ASPM_OVERRIDE  500
> 
> +#define MAX_PCIE_LTR_OVERRIDE   500
> 
> +///
> 
> +/// DIMM SMBus addresses
> 
> +///
> 
> +#define DIMM_SMB_SPD_P0C0D0 0xA0
> 
> +#define DIMM_SMB_SPD_P0C0D1 0xA2
> 
> +#define DIMM_SMB_SPD_P0C1D0 0xA4
> 
> +#define DIMM_SMB_SPD_P0C1D1 0xA6
> 
> +#define DIMM_SMB_SPD_P0C0D2 0xA8
> 
> +#define DIMM_SMB_SPD_P0C1D2 0xAA
> 
> +
> 
> +#endif // _DXE_SA_POLICY_LIBRARY_H_
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/PeiDxeSmmSaPlatformLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/PeiDxeSmmSaPlatformLib.inf
> new file mode 100644
> index 0000000000..0a632fc81a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/PeiDxeSmmSaPlatformLib.inf
> @@ -0,0 +1,32 @@
> +## @file
> 
> +# Component description file for SA Platform Lib
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmSaPlatformLib
> 
> +FILE_GUID = 9DB5ACB4-DB23-43AE-A283-2ABEF365CBE0
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = SaPlatformLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +BaseLib
> 
> +BaseMemoryLib
> 
> +DebugLib
> 
> +IoLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SaPlatformLibrary.h
> 
> +SaPlatformLibrary.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.c
> new file mode 100644
> index 0000000000..42902d795c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.c
> @@ -0,0 +1,68 @@
> +/** @file
> 
> +  SA Platform Lib implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "SaPlatformLibrary.h"
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <IndustryStandard/Pci22.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Mobile
> 
> +
> 
> +  @retval FALSE  SKU is not Mobile
> 
> +  @retval TRUE   SKU is Mobile
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsMobileSku (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT16           DeviceId;
> 
> +
> 
> +  DeviceId = PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS
> (SA_SEG_NUM, SA_MC_BUS, SA_MC_DEV, SA_MC_FUN,
> R_SA_MC_DEVICE_ID));
> 
> +  if (
> 
> +      (DeviceId == V_SA_DEVICE_ID_MB_ULT_1) || \
> 
> +      (DeviceId == V_SA_DEVICE_ID_MB_ULT_2) || \
> 
> +      (DeviceId == V_SA_DEVICE_ID_MB_ULX_1) || \
> 
> +      (DeviceId == V_SA_DEVICE_ID_MB_ULX_2) \
> 
> +    ) {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Desktop
> 
> +
> 
> +  @retval FALSE  SKU is not Desktop
> 
> +  @retval TRUE   SKU is Desktop
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsDesktopSku (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if SKU is Server
> 
> +
> 
> +  @retval FALSE  SKU is not Server
> 
> +  @retval TRUE   SKU is Server
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +IsServerSku (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.h
> new file mode 100644
> index 0000000000..10513d0ea0
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/Library/PeiDxeSmmSaPlatf
> ormLib/SaPlatformLibrary.h
> @@ -0,0 +1,21 @@
> +/** @file
> 
> +  Header file for SA Platform Lib implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _SA_PLATFORM_LIBRARY_IMPLEMENTATION_H_
> 
> +#define _SA_PLATFORM_LIBRARY_IMPLEMENTATION_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +#include <CpuAccess.h>
> 
> +#include <Library/SaPlatformLib.h>
> 
> +#include <Register/IgdRegs.h>
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd library instances
  2021-02-01  1:36 ` [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd " Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

Please see comments inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and
> Vtd library instances
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmmCpuPcieInfoFruLib
>   * Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLib
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmm
> CpuPcieInfoFruLib/CpuPcieInfoFruLib.c            | 81
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSmm
> CpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf | 36
> ++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLi
> b/DxeVtdInitFruLib.c                         | 18 ++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInitLi
> b/DxeVtdInitFruLib.inf                       | 39
> +++++++++++++++++++++++++++++++++++++++
>  4 files changed, 174 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/CpuPcieInfoFruLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/CpuPcieInfoFruLib.c
> new file mode 100644
> index 0000000000..6a9bc89ecf
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/CpuPcieInfoFruLib.c
> @@ -0,0 +1,81 @@
> +/** @file
> 
> +  CPU PCIe information library.
> 
> +
> 
> +  All function in this library is available for PEI, DXE, and SMM,
> 
> +  But do not support UEFI RUNTIME environment call.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <Library/CpuPcieInitCommon.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +#include <PcieRegs.h>
> 
> +
> 
> +/**
> 
> +  Get Maximum CPU Pcie Root Port Number
> 
> +
> 
> +  @retval Maximum CPU Pcie Root Port Number
> 
> +**/
> 
> +UINT8
> 
> +GetMaxCpuPciePortNum (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  return CPU_PCIE_ULT_ULX_MAX_ROOT_PORT;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get CPU Pcie Root Port Device and Function Number by Root Port physical
> Number
> 
> +
> 
> +  @param[in]  RpNumber              Root port physical number. (0-based)
> 
> +  @param[out] RpDev                 Return corresponding root port device
> number.
> 
> +  @param[out] RpFun                 Return corresponding root port function
> number.
> 
> +
> 
> +  @retval     EFI_SUCCESS           Root port device and function is retrieved
> 
> +  @retval     EFI_INVALID_PARAMETER RpNumber is invalid
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +GetCpuPcieRpDevFun (
> 
> +  IN  UINTN   RpNumber,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  )
> 
> +{
> 
> +  if (RpNumber > GetMaxCpuPciePortNum ()) {
> 
> +    DEBUG ((DEBUG_ERROR, "GetCpuPcieRpDevFun invalid RpNumber %x",
> RpNumber));
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  //  For TGL - U/Y only one CPU PCIE Root port is present
> 
> +  //
> 
> +  *RpDev = 6;
> 
> +  *RpFun = 0;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +/**
> 
> +
> 
> +  Gets pci segment base address of PCIe root port.
> 
> +
> 
> +  @param RpIndex    Root Port Index (0 based)
> 
> +
> 
> +  @return PCIe port base address.
> 
> +**/
> 
> +UINT64
> 
> +CpuPcieBase (
> 
> +  IN  UINT32   RpIndex
> 
> +  )
> 
> +{
> 
> +  UINTN   RpDevice;
> 
> +  UINTN   RpFunction;
> 
> +  GetCpuPcieRpDevFun (RpIndex, &RpDevice, &RpFunction);
> 
> +  return PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS,
> (UINT32) RpDevice, (UINT32) RpFunction, 0);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
> new file mode 100644
> index 0000000000..b6a40b2f7c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CpuPcieRp/Library/PeiDxeSm
> mCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
> @@ -0,0 +1,36 @@
> +## @file
> 
> +# CPU PCIe information library for TigerLake PCH.
> 
> +#
> 
> +# All function in this library is available for PEI, DXE, and SMM,
> 
> +# But do not support UEFI RUNTIME environment call.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PeiDxeSmmCpuPcieInfoFruLib
> 
> +FILE_GUID = 59CA5352-ED46-4449-BF1C-0D0074C4D5B1
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = BASE
> 
> +LIBRARY_CLASS = CpuPcieInfoFruLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +IoLib
> 
> +BaseLib
> 
> +DebugLib
> 
> +PrintLib
> 
> +PcdLib
> 
> +ConfigBlockLib
> 
> +CpuPcieInitCommonLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Sources]
> 
> +CpuPcieInfoFruLib.c
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.c
> new file mode 100644
> index 0000000000..8a0a8b6335
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.c
> @@ -0,0 +1,18 @@
> +/** @file
> 
> +  DXE Flu Library to initialize Vtd

DXE FRU Library to initialize Vtd

> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Base.h>
> 
> +
> 
> +/**
> 
> +  For device that specified by Device Num and Function Num,
> 
> +  mDevEnMap is used to check device presence.
> 
> +  0x80 means use Device ID to detemine presence
> 
> +  0x8F means force to update
> 
> +
> 
> +  The structure is used to check if device scope is valid when update DMAR
> table
> 
> +**/
> 
> +UINT16  mDevEnMap[][2] = {{0x0200, 0x80}, {0x0500, 0x80}, {0x1400, 0x80},
> {0x1401, 0x80}, {0x0700, 0x80}, {0x0701, 0x80}, {0x0702, 0x80}, {0x0703, 0x80},
> {0x1302, 0x8F}, {0x1303, 0x8F}};
> 
> +UINTN   mDevEnMapSize = sizeof (mDevEnMap) / (sizeof (UINT16) * 2);
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.inf
> new file mode 100644
> index 0000000000..e0aa88f68a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Vtd/LibraryPrivate/DxeVtdInit
> Lib/DxeVtdInitFruLib.inf
> @@ -0,0 +1,39 @@
> +## @file
> 
> +# Library description file for DXE Phase Vtd Init
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = DxeVtdInitFruLib
> 
> +FILE_GUID = 18690D67-08A9-4DCE-B62D-CBE3AF7CFEE7
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +LIBRARY_CLASS = DxeVtdFruLib
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiLib
> 
> +UefiRuntimeServicesTableLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +DxeSaPolicyLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Protocols]
> 
> +gSaNvsAreaProtocolGuid                  ## CONSUMES
> 
> +
> 
> +[Sources]
> 
> +DxeVtdInitFruLib.c
> 
> +
> 
> +[FixedPcd]
> 
> +
> 
> +[Guids]
> 
> +gTcssHobGuid                            ## CONSUMES
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules
  2021-02-01  1:36 ` [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

Please see comments inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * Pch/PchInit/Dxe
>   * Pch/PchInit/Smm
>   * Pch/PchSmiDispatcher/Smm
>   * Pch/SmmControl/RuntimeDxe
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c                      |  494
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c                  |
> 41 ++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c                   |
> 201
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c                      |  314
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h                      |  122
> ++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c                   |
> 354
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf              |
> 96 ++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c                      |   89
> ++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c                  |   33
> +++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c               |
> 134 ++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c                     |
> 266
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
> |  137 +++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
> |   33 +++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c                   |
> 285
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h                   |
> 254
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf                 |
> 110 +++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c                   |
> 451
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c                  |
> 67 +++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
> | 1284
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
> |  226
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatc
> h.c      | 2442
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispatc
> her.inf  |  116 ++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper.
> h        |   40 +++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelper
> Client.c  |   57 ++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
> | 1043
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCore.
> c          |  926
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.c
> | 1588
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi.h
> |  341
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.c
> |  263
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpe
> rs.c       |  332
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHelpe
> rs.h       |  155
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPerio
> dicTimer.c |  667
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPowe
> rButton.c   |   81 +++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.c
> |  381
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
> |  224
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb.c
> |  230
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelp
> ers.c      |  778
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHelp
> ers.h      |  107 ++++++++++++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl
> .inf       |   54 +++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl
> Driver.c   |  394
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmControl
> Driver.h   |  130
> +++++++++++++++++++++++++++++++++++++++++++++++++
>  41 files changed, 15340 insertions(+)
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c
> new file mode 100644
> index 0000000000..e88afa5ded
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchAcpi.c
> @@ -0,0 +1,494 @@
> +/** @file
> 
> +  This is the driver that initializes the Intel PCH.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +
> 
> +#include "PchInit.h"
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <GpioDevConfig.h>
> 
> +#include <ScsConfig.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/SerialIoAccessLib.h>
> 
> +#include <Library/GbeLib.h>
> 
> +#include <PchRstHob.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <TraceHubConfig.h>
> 
> +#include <PchReservedResources.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Register/UsbRegs.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <IndustryStandard/Pci22.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <PchHybridStorageHob.h>
> 
> +#include <Library/SataLib.h>
> 
> +
> 
> +//
> 
> +// Module variables
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA_PROTOCOL
> mPchNvsAreaProtocol;
> 
> +
> 
> +/**
> 
> +  Retrieve interrupt information about a PCH device from policy
> 
> +
> 
> +  @param[in] UartNumber                 Uart number
> 
> +
> 
> +  @retval PCH_DEVICE_INTERRUPT_CONFIG   structure with device's
> interrupt information
> 
> +**/
> 
> +PCH_DEVICE_INTERRUPT_CONFIG
> 
> +GetUartInterrupt (
> 
> +  IN UINT8  UartNumber
> 
> +  )
> 
> +{
> 
> +  PCH_DEVICE_INTERRUPT_CONFIG EmptyRecord;
> 
> +  UINT8                       DevNum;
> 
> +  UINT8                       FuncNum;
> 
> +  UINT8                       Index;
> 
> +
> 
> +  ZeroMem (&EmptyRecord, sizeof (PCH_DEVICE_INTERRUPT_CONFIG));
> 
> +  DevNum  = SerialIoUartDevNumber (UartNumber);
> 
> +  FuncNum = SerialIoUartFuncNumber (UartNumber);
> 
> +
> 
> +  for (Index = 0; Index < mPchConfigHob->Interrupt.NumOfDevIntConfig;
> Index++) {
> 
> +    if ((mPchConfigHob->Interrupt.DevIntConfig[Index].Device == DevNum)
> &&
> 
> +        (mPchConfigHob->Interrupt.DevIntConfig[Index].Function ==
> FuncNum)) {
> 
> +      return mPchConfigHob->Interrupt.DevIntConfig[Index];
> 
> +    }
> 
> +  }
> 
> +  return EmptyRecord;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update ASL definitions for SerialIo devices.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +UpdateSerialIoAcpiData (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8        Index;
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
> 
> +    mPchNvsAreaProtocol.Area->SM0[Index] = mPchConfigHob-
> >SerialIo.SpiDeviceConfig[Index].Mode;
> 
> +    mPchNvsAreaProtocol.Area->SC0[Index] = GetSerialIoSpiPciCfg (Index);
> 
> +  }
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
> 
> +    mPchNvsAreaProtocol.Area->IM0[Index] = mPchConfigHob-
> >SerialIo.I2cDeviceConfig[Index].Mode;
> 
> +    mPchNvsAreaProtocol.Area->IC0[Index] = GetSerialIoI2cPciCfg (Index);
> 
> +  }
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++)
> {
> 
> +    mPchNvsAreaProtocol.Area->UM0[Index] = mPchConfigHob-
> >SerialIo.UartDeviceConfig[Index].Mode;
> 
> +    mPchNvsAreaProtocol.Area->UC0[Index] = GetSerialIoUartPciCfg
> (Index);
> 
> +    mPchNvsAreaProtocol.Area->UD0[Index] = mPchConfigHob-
> >SerialIo.UartDeviceConfig[Index].DmaEnable;
> 
> +    mPchNvsAreaProtocol.Area->UP0[Index] = mPchConfigHob-
> >SerialIo.UartDeviceConfig[Index].PowerGating;
> 
> +    mPchNvsAreaProtocol.Area->UI0[Index] = (GetUartInterrupt
> (Index)).Irq;
> 
> +  }
> 
> +}
> 
> +
> 
> +#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
> 
> +/**
> 
> +  Update NVS Area for Timed GPIO devices.
> 
> +**/
> 
> +VOID
> 
> +UpdateTimedGpioSetup (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  mPchNvsAreaProtocol.Area->EnableTimedGpio0 =
> (UINT8)mPchConfigHob->Pm.EnableTimedGpio0;
> 
> +  mPchNvsAreaProtocol.Area->EnableTimedGpio1 =
> (UINT8)mPchConfigHob->Pm.EnableTimedGpio1;
> 
> +}
> 
> +#endif
> 
> +
> 
> +/**
> 
> +  Update NVS Area after RST PCIe Storage Remapping and before Boot
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_NOT_FOUND           Couldn't fetch RstHob
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchUpdateNvsAreaAfterRemapping (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINTN                 Index;
> 
> +  VOID                  *Hob;
> 
> +  PCH_RST_HOB           *RstHob;
> 
> +
> 
> +  Hob = GetFirstGuidHob (&gPchRstHobGuid);
> 
> +  if (Hob == NULL) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +
> 
> +  RstHob = (PCH_RST_HOB *) GET_GUID_HOB_DATA (Hob);
> 
> +
> 
> +  for (Index = 0; Index < PCH_MAX_RST_PCIE_STORAGE_CR; Index++) {
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageInterfaceType[Index]        =
> RstHob->RstCrConfiguration[Index].DeviceInterface;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStoragePmCapPtr[Index]             =
> RstHob->SavedRemapedDeviceConfigSpace[Index].PmCapPtr;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStoragePcieCapPtr[Index]           =
> RstHob->SavedRemapedDeviceConfigSpace[Index].PcieCapPtr;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageL1ssCapPtr[Index]           =
> RstHob->SavedRemapedDeviceConfigSpace[Index].L1ssCapPtr;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpL1ssControl2[Index]       =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointL1ssControl2;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpL1ssControl1[Index]       =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointL1ssControl1;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageLtrCapPtr[Index]            =
> RstHob->SavedRemapedDeviceConfigSpace[Index].LtrCapPtr;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpLtrData[Index]            =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointLtrData;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpLctlData16[Index]         =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointLctlData16;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpDctlData16[Index]         =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointDctlData16;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageEpDctl2Data16[Index]        =
> RstHob->SavedRemapedDeviceConfigSpace[Index].EndpointDctl2Data16;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageRpDctl2Data16[Index]        =
> RstHob->SavedRemapedDeviceConfigSpace[Index].RootPortDctl2Data16;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageUniqueTableBar[Index]       =
> RstHob->RstCrConfiguration[Index].EndPointUniqueMsixTableBar;
> 
> +    mPchNvsAreaProtocol.Area-
> >RstPcieStorageUniqueTableBarValue[Index]  = RstHob-
> >RstCrConfiguration[Index].EndPointUniqueMsixTableBarValue;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageUniquePbaBar[Index]         =
> RstHob->RstCrConfiguration[Index].EndPointUniqueMsixPbaBar;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageUniquePbaBarValue[Index]
> = RstHob->RstCrConfiguration[Index].EndPointUniqueMsixPbaBarValue;
> 
> +    mPchNvsAreaProtocol.Area->RstPcieStorageRootPortNum[Index]          =
> RstHob->RstCrConfiguration[Index].RootPortNum;
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the Hybrid storage location NVS Area if Hybrid Storage device is
> present
> 
> +**/
> 
> +EFI_STATUS
> 
> +UpdateHybridStorageLocation (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  VOID                               *Hob;
> 
> +  PCH_HYBRIDSTORAGE_HOB              *HybridStorageHob;
> 
> +
> 
> +  Hob = GetFirstGuidHob (&gHybridStorageHobGuid);
> 
> +  if (Hob == NULL) {
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +
> 
> +  HybridStorageHob = (PCH_HYBRIDSTORAGE_HOB *)
> GET_GUID_HOB_DATA (Hob);
> 
> +  mPchNvsAreaProtocol.Area->HybridStorageLocation = HybridStorageHob-
> >HybridStorageLocation;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCH ACPI initialization before Boot Sript Table is closed
> 
> +  It update ACPI table and ACPI NVS area.
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchAcpiOnEndOfDxe (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "PchAcpiOnEndOfDxe() Start\n"));
> 
> +
> 
> +  ///
> 
> +  /// Closed the event to avoid call twice when launch shell
> 
> +  ///
> 
> +  gBS->CloseEvent (Event);
> 
> +
> 
> +  //
> 
> +  // Init HDA Audio ACPI tables
> 
> +  //
> 
> +  PchHdAudioAcpiInit ();
> 
> +  //
> 
> +  // Update ASL definitions for SerialIo devices.
> 
> +  //
> 
> +  UpdateSerialIoAcpiData ();
> 
> +  UpdateCnviAcpiData ();
> 
> +#if FixedPcdGet8(PcdEmbeddedEnable) == 0x1
> 
> +  UpdateTimedGpioSetup();
> 
> +#endif
> 
> +
> 
> +  //
> 
> +  // Update Pch Nvs Area
> 
> +  //
> 
> +  PchUpdateNvsArea ();
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchAcpiOnEndOfDxe() End\n"));
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initialize Pch acpi
> 
> +  @param[in] ImageHandle          Handle for the image of this driver
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to
> initialize the driver
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiInit (
> 
> +  IN EFI_HANDLE         ImageHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  EFI_EVENT   EndOfDxeEvent;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Install PCH NVS protocol\n"));
> 
> +
> 
> +  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof
> (PCH_NVS_AREA), (VOID **) &mPchNvsAreaProtocol.Area);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ZeroMem ((VOID *) mPchNvsAreaProtocol.Area, sizeof
> (PCH_NVS_AREA));
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gPchNvsAreaProtocolGuid,
> 
> +                  &mPchNvsAreaProtocol,
> 
> +                  NULL
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Update the NVS Area after RST PCIe Storage Remapping
> 
> +  ///
> 
> +  PchUpdateNvsAreaAfterRemapping ();
> 
> +
> 
> +  UpdateHybridStorageLocation ();
> 
> +  //
> 
> +  // Register an end of DXE event for PCH ACPI to do tasks before invoking
> any UEFI drivers,
> 
> +  // applications, or connecting consoles,...
> 
> +  //
> 
> +  Status = gBS->CreateEventEx (
> 
> +                  EVT_NOTIFY_SIGNAL,
> 
> +                  TPL_CALLBACK,
> 
> +                  PchAcpiOnEndOfDxe,
> 
> +                  NULL,
> 
> +                  &gEfiEndOfDxeEventGroupGuid,
> 
> +                  &EndOfDxeEvent
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Update NVS area for PCIe root ports.
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +PcieRpUpdateNvsArea (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  Index;
> 
> +
> 
> +  for (Index = 0; Index < PCH_MAX_PCIE_CLOCKS; Index++) {
> 
> +    mPchNvsAreaProtocol.Area->ClockToRootPortMap[Index] =
> mPchConfigHob->PcieRp.PcieClock[Index].Usage;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update ASL object before Boot
> 
> +
> 
> +  @retval EFI_STATUS
> 
> +  @retval EFI_NOT_READY         The Acpi protocols are not ready.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchUpdateNvsArea (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  UINTN                 Index;
> 
> +  UINT32                HpetBaseAdress;
> 
> +  GPIO_GROUP            GroupToGpeDwX[3];
> 
> +  UINT32                GroupDw[3];
> 
> +  UINTN                 RpDev;
> 
> +  UINTN                 RpFun;
> 
> +  UINT32                Data32;
> 
> +  PCH_POLICY_PROTOCOL   *PchPolicy;
> 
> +  GPIO_DXE_CONFIG       *GpioDxeConfig;
> 
> +  UINT64                XdciPciBase;
> 
> +  UINT64                XdciBar;
> 
> +  UINT16                PciMemConfig;
> 
> +  UINT16                TcoBase;
> 
> +  UINT8                 ClearXdciBar = FALSE;
> 
> +
> 
> +  ///
> 
> +  /// Get PCH Policy Protocol
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID
> **)&PchPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Get GPIO DXE Config Block
> 
> +  ///
> 
> +  Status = GetConfigBlock ((VOID *)PchPolicy, &gGpioDxeConfigGuid, (VOID
> *)&GpioDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Update ASL PCIE port address according to root port device and function
> 
> +  //
> 
> +  for (Index = 0; Index < GetPchMaxPciePortNum (); Index++) {
> 
> +    RpDev = PchPcieRpDevNumber (Index);
> 
> +    RpFun = PchPcieRpFuncNumber (Index);
> 
> +    Data32 = ((UINT8) RpDev << 16) | (UINT8) RpFun;
> 
> +    mPchNvsAreaProtocol.Area->RpAddress[Index] = Data32;
> 
> +
> 
> +    //
> 
> +    // Update Maximum Snoop Latency and Maximum No-Snoop Latency
> values for PCIE
> 
> +    //
> 
> +    mPchNvsAreaProtocol.Area->PcieLtrMaxSnoopLatency[Index]   =
> mPchConfigHob-
> >PcieRp.RootPort[Index].PcieRpCommonConfig.PcieRpLtrConfig.LtrMaxSno
> opLatency;
> 
> +    mPchNvsAreaProtocol.Area->PcieLtrMaxNoSnoopLatency[Index] =
> mPchConfigHob-
> >PcieRp.RootPort[Index].PcieRpCommonConfig.PcieRpLtrConfig.LtrMaxNoS
> noopLatency;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Update PCHS.
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->PchSeries     = PchSeries ();
> 
> +  //
> 
> +  // Update PCHG.
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->PchGeneration = (UINT16) PchGeneration ();
> 
> +  //
> 
> +  // Update PSTP.
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->PchStepping = (UINT16) PchStepping ();
> 
> +  //
> 
> +  // Update HPET base address.
> 
> +  //
> 
> +  PchHpetBaseGet (&HpetBaseAdress);
> 
> +  mPchNvsAreaProtocol.Area->HPTE          = TRUE;  // @todo remove the
> NVS, since it's always enabled.
> 
> +  mPchNvsAreaProtocol.Area->HPTB          = HpetBaseAdress;
> 
> +  //
> 
> +  // Update SBREG_BAR.
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->SBRG          = PCH_PCR_BASE_ADDRESS;
> 
> +
> 
> +  //
> 
> +  // Update base address
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->PMBS = PmcGetAcpiBase ();
> 
> +  mPchNvsAreaProtocol.Area->PWRM = PmcGetPwrmBase ();
> 
> +  PchTcoBaseGet (&TcoBase);
> 
> +  mPchNvsAreaProtocol.Area->TcoBase = TcoBase;
> 
> +
> 
> +  //
> 
> +  // Update PCH PID info
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->IclkPid = PchPcrGetPid (PchIpIclk);
> 
> +
> 
> +  //
> 
> +  // Update GPIO device ACPI variables
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->SGIR = mPchConfigHob-
> >Interrupt.GpioIrqRoute;
> 
> +  mPchNvsAreaProtocol.Area->GPHD = (UINT8)GpioDxeConfig-
> >HideGpioAcpiDevice;
> 
> +
> 
> +  //
> 
> +  // Update GPP_X to GPE_DWX mapping.
> 
> +  //
> 
> +  GpioGetGroupDwToGpeDwX (
> 
> +    &GroupToGpeDwX[0], &GroupDw[0],
> 
> +    &GroupToGpeDwX[1], &GroupDw[1],
> 
> +    &GroupToGpeDwX[2], &GroupDw[2]
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // GEI0/1/2 and GED0/1/2 are objects for informing how GPIO groups are
> mapped to GPE0.
> 
> +  // If Group is mapped to 1-Tier GPE information is also stored on what
> Group DW
> 
> +  // is mapped to GPE_DWx. Because GPE_DWx register is 32 bits large if
> groups have more than
> 
> +  // 32 pads only part of it can be mapped.
> 
> +  //
> 
> +  //  GEIx - GroupIndex mapped to GPE0_DWx
> 
> +  //  GEDx - DoubleWorld part of Group: 0 - pins 31-0, 1 - pins 63-32, ...
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->GEI0 = (UINT8)
> GpioGetGroupIndexFromGroup (GroupToGpeDwX[0]);
> 
> +  mPchNvsAreaProtocol.Area->GEI1 = (UINT8)
> GpioGetGroupIndexFromGroup (GroupToGpeDwX[1]);
> 
> +  mPchNvsAreaProtocol.Area->GEI2 = (UINT8)
> GpioGetGroupIndexFromGroup (GroupToGpeDwX[2]);
> 
> +  mPchNvsAreaProtocol.Area->GED0 = (UINT8) GroupDw[0];
> 
> +  mPchNvsAreaProtocol.Area->GED1 = (UINT8) GroupDw[1];
> 
> +  mPchNvsAreaProtocol.Area->GED2 = (UINT8) GroupDw[2];
> 
> +
> 
> +  //
> 
> +  // SCS Configuration
> 
> +  //
> 
> +
> 
> +  PcieRpUpdateNvsArea ();
> 
> +
> 
> +  //
> 
> +  // SATA configuration.
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->SataPortPresence =
> GetSataPortPresentStatus (0);
> 
> +  DEBUG ((DEBUG_INFO, "SataPortPresence: 0x%x\n",
> mPchNvsAreaProtocol.Area->SataPortPresence));
> 
> +
> 
> +  //
> 
> +  // CPU SKU
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->CpuSku = 0;
> 
> +  mPchNvsAreaProtocol.Area->PsOnEnable            = (UINT8)mPchConfigHob-
> >Pm.PsOnEnable;
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxPciePortNum (); Index++) {
> 
> +    mPchNvsAreaProtocol.Area->LtrEnable[Index]  =
> (UINT8)mPchConfigHob-
> >PcieRp.RootPort[Index].PcieRpCommonConfig.LtrEnable;
> 
> +  }
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->GBES = IsGbePresent ();
> 
> +
> 
> +  //
> 
> +  // Update PCH Trace Hub Mode
> 
> +  //
> 
> +  mPchNvsAreaProtocol.Area->PchTraceHubMode     = (UINT8)
> mPchConfigHob->PchTraceHub.PchTraceHubMode;
> 
> +
> 
> +  //
> 
> +  // Saving GCTL value into PCH NVS area
> 
> +  //
> 
> +
> 
> +  XdciPciBase = PchXdciPciCfgBase ();
> 
> +
> 
> +  //
> 
> +  // Determine Base address for Base address register (Offset 0x10)
> 
> +  //
> 
> +  if (PciSegmentRead32 (XdciPciBase) != 0xFFFFFFFF) {
> 
> +
> 
> +    XdciBar = PciSegmentRead32 (XdciPciBase +
> PCI_BASE_ADDRESSREG_OFFSET) & 0xFFFFFFF0;
> 
> +
> 
> +    if ((PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET) &
> B_PCI_BAR_MEMORY_TYPE_MASK) == B_PCI_BAR_MEMORY_TYPE_64) {
> 
> +      XdciBar += (UINT64)PciSegmentRead32 (XdciPciBase +
> (PCI_BASE_ADDRESSREG_OFFSET + 4)) << 32;
> 
> +    }
> 
> +
> 
> +    if (XdciBar == 0x0) {
> 
> +      ClearXdciBar = TRUE;
> 
> +      PciSegmentWrite32 ((XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET),
> PcdGet32 (PcdSiliconInitTempMemBaseAddr));
> 
> +      XdciBar = PciSegmentRead32 (XdciPciBase +
> PCI_BASE_ADDRESSREG_OFFSET) & 0xFFFFFFF0;
> 
> +
> 
> +      if ((PciSegmentRead32 (XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET)
> & B_PCI_BAR_MEMORY_TYPE_MASK) == B_PCI_BAR_MEMORY_TYPE_64) {
> 
> +        XdciBar += (UINT64)PciSegmentRead32 (XdciPciBase +
> (PCI_BASE_ADDRESSREG_OFFSET + 4)) << 32;
> 
> +      }
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Enable Pci Memconfig to read the correct value for GCTL register
> 
> +    //
> 
> +    PciMemConfig = PciSegmentRead16 (XdciPciBase +
> PCI_COMMAND_OFFSET);
> 
> +    PciSegmentWrite16 (XdciPciBase + PCI_COMMAND_OFFSET,
> PciMemConfig | (EFI_PCI_COMMAND_BUS_MASTER |
> EFI_PCI_COMMAND_MEMORY_SPACE));
> 
> +
> 
> +    mPchNvsAreaProtocol.Area->PchxDCIPwrDnScale = MmioRead32(XdciBar
> + R_XDCI_MEM_GCTL);
> 
> +    DEBUG ((DEBUG_INFO, "PchxDCIPwrDnScale  0x%x\n",
> (UINT64)mPchNvsAreaProtocol.Area->PchxDCIPwrDnScale));
> 
> +    //
> 
> +    // Disable Pci Memconfig & clear Base address
> 
> +    //
> 
> +    PciSegmentWrite16(XdciPciBase + PCI_COMMAND_OFFSET,
> PciMemConfig);
> 
> +
> 
> +    if (ClearXdciBar == TRUE) {
> 
> +      PciSegmentWrite32 ((XdciPciBase + PCI_BASE_ADDRESSREG_OFFSET),
> 0x0);
> 
> +      PciSegmentWrite32 ((XdciPciBase + (PCI_BASE_ADDRESSREG_OFFSET +
> 4)), 0x0);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c
> new file mode 100644
> index 0000000000..5c8e1ce5b4
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchCnviAcpi.c
> @@ -0,0 +1,41 @@
> +/** @file
> 
> +  Initializes PCH CNVi device ACPI data.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <CnviConfigHob.h>
> 
> +#include "PchInit.h"
> 
> +#include <Register/PchPcrRegs.h>
> 
> +
> 
> +/**
> 
> +  Update ASL definitions for CNVi device.
> 
> +
> 
> +  @retval EFI_SUCCESS         The function completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +UpdateCnviAcpiData (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_PEI_HOB_POINTERS HobPtr;
> 
> +  CNVI_CONFIG_HOB      *CnviConfigHob;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "UpdateCnviAcpiData() Start\n"));
> 
> +
> 
> +  // Get CNVi Config HOB.
> 
> +  HobPtr.Guid = GetFirstGuidHob (&gCnviConfigHobGuid);
> 
> +  if (HobPtr.Guid != NULL) {
> 
> +    CnviConfigHob = (CNVI_CONFIG_HOB *) GET_GUID_HOB_DATA
> (HobPtr.Guid);
> 
> +    mPchNvsAreaProtocol.Area->CnviMode           = (UINT8)CnviConfigHob-
> >Mode;
> 
> +    mPchNvsAreaProtocol.Area->CnviBtCore         = (UINT8)CnviConfigHob-
> >BtCore;
> 
> +    mPchNvsAreaProtocol.Area->CnviBtAudioOffload =
> (UINT8)CnviConfigHob->BtAudioOffload;
> 
> +  }
> 
> +  mPchNvsAreaProtocol.Area->CnviPortId = PID_CNVI;
> 
> +  DEBUG ((DEBUG_INFO, "UpdateCnviAcpiData() End\n"));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c
> new file mode 100644
> index 0000000000..dbdb028483
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchHdaAcpi.c
> @@ -0,0 +1,201 @@
> +
> 
> +/** @file
> 
> +  Initializes the PCH HD Audio ACPI Tables.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Protocol/AcpiTable.h>
> 
> +#include <DxeHdaNhlt.h>
> 
> +#include <Library/DxeHdaNhltLib.h>
> 
> +#include "PchInit.h"
> 
> +#include <HdAudioConfig.h>
> 
> +#include <PchConfigHob.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +#include <HdAudioConfig.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +
> 
> +#define XTAL_FREQ_38P4MHZ    1
> 
> +
> 
> +/**
> 
> +  Retrieves address of NHLT table from XSDT/RSDT.
> 
> +
> 
> +  @retval NHLT_ACPI_TABLE*  Pointer to NHLT table if found
> 
> +  @retval NULL              NHLT could not be found
> 
> +**/
> 
> +NHLT_ACPI_TABLE *
> 
> +LocateNhltAcpiTable (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER  *Rsdp;
> 
> +  EFI_ACPI_DESCRIPTION_HEADER                   *Xsdt;
> 
> +  NHLT_ACPI_TABLE                               *Nhlt;
> 
> +  UINTN                                         Index;
> 
> +  UINT64                                        Data64;
> 
> +  EFI_STATUS                                    Status;
> 
> +  Rsdp  = NULL;
> 
> +  Xsdt  = NULL;
> 
> +  Nhlt  = NULL;
> 
> +
> 
> +  ///
> 
> +  /// Find the AcpiSupport protocol returns RSDP (or RSD PTR) address.
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "LocateNhltAcpiTable() Start\n"));
> 
> +
> 
> +  Status = EfiGetSystemConfigurationTable (&gEfiAcpiTableGuid, (VOID *)
> &Rsdp);
> 
> +  if (EFI_ERROR (Status) || (Rsdp == NULL)) {
> 
> +    DEBUG ((DEBUG_ERROR, "EFI_ERROR or Rsdp == NULL\n"));
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->XsdtAddress;
> 
> +  if (Xsdt == NULL || Xsdt->Signature !=
> EFI_ACPI_5_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {
> 
> +    // If XSDT has not been found, check RSDT
> 
> +    Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->RsdtAddress;
> 
> +    if (Xsdt == NULL || Xsdt->Signature !=
> EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {
> 
> +      DEBUG ((DEBUG_ERROR, "XSDT/RSDT == NULL or wrong signature\n"));
> 
> +      return NULL;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  for (Index = sizeof (EFI_ACPI_DESCRIPTION_HEADER); Index < Xsdt-
> >Length; Index = Index + sizeof (UINT64)) {
> 
> +    Data64  = *(UINT64 *) ((UINT8 *) Xsdt + Index);
> 
> +    Nhlt    = (NHLT_ACPI_TABLE *) (UINTN) Data64;
> 
> +    if (Nhlt != NULL && Nhlt->Header.Signature ==
> NHLT_ACPI_TABLE_SIGNATURE) {
> 
> +      break;
> 
> +    }
> 
> +    Nhlt = NULL;
> 
> +  }
> 
> +
> 
> +  if (Nhlt == NULL || Nhlt->Header.Signature !=
> NHLT_ACPI_TABLE_SIGNATURE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Nhlt == NULL or wrong signature\n"));
> 
> +    return NULL;
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Found NhltTable, Address = 0x%016x\n", Nhlt));
> 
> +
> 
> +  return Nhlt;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets NVS ACPI variables for HDAS._DSM and SNDW._DSD accordingly to
> policy.
> 
> +
> 
> +  @param[in]                NhltAcpiTableAddress
> 
> +  @param[in]                NhltAcpiTableLength
> 
> +  @param[in]                *HdAudioConfigHob
> 
> +  @param[in]                *HdAudioDxeConfig
> 
> +**/
> 
> +VOID
> 
> +UpdateHdaAcpiData (
> 
> +  IN       UINT64                 NhltAcpiTableAddress,
> 
> +  IN       UINT32                 NhltAcpiTableLength,
> 
> +  IN CONST HDAUDIO_HOB            *HdAudioConfigHob,
> 
> +  IN CONST HDAUDIO_DXE_CONFIG     *HdAudioDxeConfig
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "UpdateHdaAcpiData():\n NHLT Address =
> 0x%016x, Length = 0x%08x\n", NhltAcpiTableAddress,
> NhltAcpiTableLength));
> 
> +  DEBUG ((DEBUG_INFO, " FeatureMask = 0x%08x\n", HdAudioDxeConfig-
> >DspFeatureMask));
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->XTAL = XTAL_FREQ_38P4MHZ;
> 
> +  mPchNvsAreaProtocol.Area->NHLA = NhltAcpiTableAddress;
> 
> +  mPchNvsAreaProtocol.Area->NHLL = NhltAcpiTableLength;
> 
> +  mPchNvsAreaProtocol.Area->ADFM = HdAudioDxeConfig-
> >DspFeatureMask;
> 
> +
> 
> +  if (HdAudioConfigHob->DspEnable || HdAudioConfigHob-
> >DspUaaCompliance == FALSE) {
> 
> +    mPchNvsAreaProtocol.Area->SWQ0 = HdAudioConfigHob-
> >AudioLinkSndw1 ? 0 : BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ1 = HdAudioConfigHob-
> >AudioLinkSndw2 ? 0 : BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ2 = HdAudioConfigHob-
> >AudioLinkSndw3 ? 0 : BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ3 = HdAudioConfigHob-
> >AudioLinkSndw4 ? 0 : BIT1;
> 
> +  } else {
> 
> +    mPchNvsAreaProtocol.Area->SWQ0 = BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ1 = BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ2 = BIT1;
> 
> +    mPchNvsAreaProtocol.Area->SWQ3 = BIT1;
> 
> +  }
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->SWMC = GetPchHdaMaxSndwLinkNum ();
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->ACS0 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[0].AutonomousClockStop;
> 
> +  mPchNvsAreaProtocol.Area->ACS1 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[1].AutonomousClockStop;
> 
> +  mPchNvsAreaProtocol.Area->ACS2 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[2].AutonomousClockStop;
> 
> +  mPchNvsAreaProtocol.Area->ACS3 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[3].AutonomousClockStop;
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->DAI0 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[0].DataOnActiveIntervalSelect;
> 
> +  mPchNvsAreaProtocol.Area->DAI1 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[1].DataOnActiveIntervalSelect;
> 
> +  mPchNvsAreaProtocol.Area->DAI2 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[2].DataOnActiveIntervalSelect;
> 
> +  mPchNvsAreaProtocol.Area->DAI3 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[3].DataOnActiveIntervalSelect;
> 
> +
> 
> +  mPchNvsAreaProtocol.Area->DOD0 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[0].DataOnDelaySelect;
> 
> +  mPchNvsAreaProtocol.Area->DOD1 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[1].DataOnDelaySelect;
> 
> +  mPchNvsAreaProtocol.Area->DOD2 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[2].DataOnDelaySelect;
> 
> +  mPchNvsAreaProtocol.Area->DOD3 = (UINT8)HdAudioDxeConfig-
> >SndwConfig[3].DataOnDelaySelect;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initialize Intel High Definition Audio ACPI Tables
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_LOAD_ERROR          ACPI table cannot be installed
> 
> +  @retval EFI_UNSUPPORTED         ACPI table not set because DSP is disabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchHdAudioAcpiInit (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                    Status;
> 
> +  UINT64                        HdaPciBase;
> 
> +  CONST HDAUDIO_HOB             *HdAudioConfigHob;
> 
> +  PCH_POLICY_PROTOCOL           *PchPolicy;
> 
> +  HDAUDIO_DXE_CONFIG            *HdAudioDxeConfig;
> 
> +  NHLT_ACPI_TABLE               *NhltTable;
> 
> +
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchHdAudioAcpiInit() Start\n"));
> 
> +
> 
> +  HdAudioConfigHob = &mPchConfigHob->HdAudio;
> 
> +
> 
> +  ///
> 
> +  /// Get PCH Policy Protocol
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID
> **)&PchPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Get HD Audio DXE Config Block
> 
> +  ///
> 
> +  Status = GetConfigBlock ((VOID *)PchPolicy, &gHdAudioDxeConfigGuid,
> (VOID *)&HdAudioDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  HdaPciBase = HdaPciCfgBase ();
> 
> +
> 
> +  if ((PciSegmentRead16 (HdaPciBase + PCI_VENDOR_ID_OFFSET) ==
> 0xFFFF) || (HdAudioConfigHob->DspEnable == FALSE)) {
> 
> +    // Do not set ACPI tables if HDAudio is Function disabled or DSP is disabled
> 
> +    DEBUG ((DEBUG_INFO, "AudioDSP: Non-HDAudio ACPI Table (NHLT) not
> set!\n"));
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  NhltTable = LocateNhltAcpiTable ();
> 
> +  if (NhltTable == NULL) {
> 
> +    return EFI_LOAD_ERROR;
> 
> +  }
> 
> +
> 
> +  UpdateHdaAcpiData ((UINT64) (UINTN) NhltTable, (UINT32) (NhltTable-
> >Header.Length), HdAudioConfigHob, HdAudioDxeConfig);
> 
> +  DEBUG_CODE ( NhltAcpiTableDump (NhltTable); );
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchHdAudioAcpiInit() End - Status = %r\n",
> Status));
> 
> +  return Status;
> 
> +}
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c
> new file mode 100644
> index 0000000000..734d4e295a
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.c
> @@ -0,0 +1,314 @@
> +/** @file
> 
> +  This is the Common driver that initializes the Intel PCH.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/TimerLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +
> 
> +#include "PchInit.h"
> 
> +#include <PchPolicyCommon.h>
> 
> +#include <Library/SpiCommonLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/PchDmiLib.h>
> 
> +#include <Library/SiScheduleResetLib.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/SpiAccessPrivateLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/PchRegsPsth.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/HdaRegs.h>
> 
> +#include <Library/GpioCheckConflictLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +
> 
> +//
> 
> +// Module variables
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_CONFIG_HOB
> *mPchConfigHob;
> 
> +
> 
> +//
> 
> +// EFI_EVENT
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_EVENT mHeciEvent;
> 
> +
> 
> +/**
> 
> +  Common PchInit Module Entry Point
> 
> +**/
> 
> +VOID
> 
> +PchInitEntryPointCommon (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_PEI_HOB_POINTERS  HobPtr;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchInitEntryPointCommon() Start\n"));
> 
> +
> 
> +  //
> 
> +  // Get PCH Config HOB.
> 
> +  //
> 
> +  HobPtr.Guid   = GetFirstGuidHob (&gPchConfigHobGuid);
> 
> +  ASSERT (HobPtr.Guid != NULL);
> 
> +  mPchConfigHob = (PCH_CONFIG_HOB *) GET_GUID_HOB_DATA
> (HobPtr.Guid);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchInitEntryPointCommon() End\n"));
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Lock SPI register before boot
> 
> +**/
> 
> +VOID
> 
> +LockSpiConfiguration (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINTN         Index;
> 
> +  UINT16        Data16;
> 
> +  UINT16        Data16And;
> 
> +  UINT16        Data16Or;
> 
> +  UINT32        Data32;
> 
> +  UINT32        DlockValue;
> 
> +  UINT64        PciSpiRegBase;
> 
> +  UINT32        PchSpiBar0;
> 
> +  UINT32        Timer;
> 
> +
> 
> +  PciSpiRegBase = SpiPciCfgBase ();
> 
> +
> 
> +  //
> 
> +  // Check for SPI controller presence before programming
> 
> +  //
> 
> +  if (PciSegmentRead16 (PciSpiRegBase + PCI_VENDOR_ID_OFFSET) ==
> 0xFFFF) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Make sure SPI BAR0 has fixed address before writing to boot script.
> 
> +  // The same base address is set in PEI and will be used during resume.
> 
> +  //
> 
> +  PchSpiBar0 = PCH_SPI_BASE_ADDRESS;
> 
> +
> 
> +  PciSegmentAnd8    (PciSpiRegBase + PCI_COMMAND_OFFSET, (UINT8)
> ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  PciSegmentWrite32 (PciSpiRegBase + R_SPI_CFG_BAR0, PchSpiBar0);
> 
> +  PciSegmentOr8     (PciSpiRegBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +
> 
> +  //
> 
> +  // Locking for security reasons only if Extended BIOS Range Decode is
> supported
> 
> +  //
> 
> +  if (IsExtendedBiosRangeDecodeSupported ()) {
> 
> +    //
> 
> +    // Before setting FLOCKDN lock Extended BIOS Range configuration
> 
> +    // All configuration of this feature shall be done already at this moment
> 
> +    //
> 
> +    PciSegmentOr32 (PciSpiRegBase + R_SPI_CFG_BC, BIT28);
> 
> +    S3BootScriptSavePciCfgWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      (UINTN) PciSpiRegBase + R_SPI_CFG_BC,
> 
> +      1,
> 
> +      (VOID *) (UINTN) (PciSpiRegBase + R_SPI_CFG_BC)
> 
> +      );
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Program the Flash Protection Range Register based on policy
> 
> +  //
> 
> +  DlockValue = MmioRead32 (PchSpiBar0 + R_SPI_MEM_DLOCK);
> 
> +  for (Index = 0; Index < PCH_FLASH_PROTECTED_RANGES; ++Index) {
> 
> +    if ((mPchConfigHob->ProtectRange[Index].WriteProtectionEnable ||
> 
> +         mPchConfigHob->ProtectRange[Index].ReadProtectionEnable) !=
> TRUE) {
> 
> +      continue;
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Proceed to program the register after ensure it is enabled
> 
> +    //
> 
> +    Data32 = 0;
> 
> +    Data32 |= (mPchConfigHob->ProtectRange[Index].WriteProtectionEnable
> == TRUE) ? B_SPI_MEM_PRX_WPE : 0;
> 
> +    Data32 |= (mPchConfigHob->ProtectRange[Index].ReadProtectionEnable
> == TRUE) ? B_SPI_MEM_PRX_RPE : 0;
> 
> +    Data32 |= ((UINT32) mPchConfigHob-
> >ProtectRange[Index].ProtectedRangeLimit << N_SPI_MEM_PRX_PRL) &
> B_SPI_MEM_PRX_PRL_MASK;
> 
> +    Data32 |= ((UINT32) mPchConfigHob-
> >ProtectRange[Index].ProtectedRangeBase << N_SPI_MEM_PRX_PRB) &
> B_SPI_MEM_PRX_PRB_MASK;
> 
> +    DEBUG ((DEBUG_INFO, "Protected range %d: 0x%08x \n", Index,
> Data32));
> 
> +
> 
> +    DlockValue |= (UINT32) (B_SPI_MEM_DLOCK_PR0LOCKDN << Index);
> 
> +    MmioWrite32 ((UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index *
> S_SPI_MEM_PRX))), Data32);
> 
> +    S3BootScriptSaveMemWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      (UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index *
> S_SPI_MEM_PRX))),
> 
> +      1,
> 
> +      (VOID *) (UINTN) (PchSpiBar0 + (R_SPI_MEM_PR0 + (Index *
> S_SPI_MEM_PRX)))
> 
> +      );
> 
> +  }
> 
> +  //
> 
> +  // Program DLOCK register
> 
> +  //
> 
> +  MmioWrite32 ((UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK), DlockValue);
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK),
> 
> +    1,
> 
> +    (VOID *) (UINTN) (PchSpiBar0 + R_SPI_MEM_DLOCK)
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// PCH BIOS Spec Section 3.6 Flash Security Recommendation
> 
> +  /// In PCH SPI controller the BIOS should set the Flash Configuration Lock-
> Down bit
> 
> +  /// (SPI_BAR0 + 04[15]) at end of post.  When set to 1, those Flash Program
> Registers
> 
> +  /// that are locked down by this FLOCKDN bit cannot be written.
> 
> +  /// Please refer to the EDS for which program registers are impacted.
> 
> +  /// Additionally BIOS must program SPI_BAR0 + 0x04 BIT11 (WRSDIS) to
> disable Write Status in HW sequencing
> 
> +  ///
> 
> +
> 
> +  //
> 
> +  // Ensure there is no pending SPI trasaction before setting lock bits
> 
> +  //
> 
> +  Timer = 0;
> 
> +  while (MmioRead16 (PchSpiBar0 + R_SPI_MEM_HSFSC) &
> B_SPI_MEM_HSFSC_SCIP) {
> 
> +    if (Timer > SPI_WAIT_TIME) {
> 
> +      //
> 
> +      // SPI transaction is pending too long at this point, exit with error.
> 
> +      //
> 
> +      DEBUG ((DEBUG_ERROR, "SPI Cycle timeout\n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +    }
> 
> +    MicroSecondDelay (SPI_WAIT_PERIOD);
> 
> +    Timer += SPI_WAIT_PERIOD;
> 
> +  }
> 
> +
> 
> +  Data16And = B_SPI_MEM_HSFSC_SCIP;
> 
> +  Data16    = 0;
> 
> +  S3BootScriptSaveMemPoll (
> 
> +    S3BootScriptWidthUint16,
> 
> +    PchSpiBar0 + R_SPI_MEM_HSFSC,
> 
> +    &Data16And,
> 
> +    &Data16,
> 
> +    SPI_WAIT_PERIOD,
> 
> +    SPI_WAIT_TIME / SPI_WAIT_PERIOD
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Clear any outstanding status
> 
> +  //
> 
> +  Data16Or  = B_SPI_MEM_HSFSC_SAF_DLE
> 
> +            | B_SPI_MEM_HSFSC_SAF_ERROR
> 
> +            | B_SPI_MEM_HSFSC_AEL
> 
> +            | B_SPI_MEM_HSFSC_FCERR
> 
> +            | B_SPI_MEM_HSFSC_FDONE;
> 
> +  Data16And = 0xFFFF;
> 
> +  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And,
> Data16Or);
> 
> +  S3BootScriptSaveMemReadWrite (
> 
> +    S3BootScriptWidthUint16,
> 
> +    PchSpiBar0 + R_SPI_MEM_HSFSC,
> 
> +    &Data16Or,
> 
> +    &Data16And
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Set WRSDIS
> 
> +  //
> 
> +  Data16Or  = B_SPI_MEM_HSFSC_WRSDIS;
> 
> +  Data16And = 0xFFFF;
> 
> +  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And,
> Data16Or);
> 
> +  S3BootScriptSaveMemReadWrite (
> 
> +    S3BootScriptWidthUint16,
> 
> +    PchSpiBar0 + R_SPI_MEM_HSFSC,
> 
> +    &Data16Or,
> 
> +    &Data16And
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Set FLOCKDN
> 
> +  //
> 
> +  Data16Or  = B_SPI_MEM_HSFSC_FLOCKDN;
> 
> +  Data16And = 0xFFFF;
> 
> +  MmioAndThenOr16 (PchSpiBar0 + R_SPI_MEM_HSFSC, Data16And,
> Data16Or);
> 
> +  S3BootScriptSaveMemReadWrite (
> 
> +    S3BootScriptWidthUint16,
> 
> +    PchSpiBar0 + R_SPI_MEM_HSFSC,
> 
> +    &Data16Or,
> 
> +    &Data16And
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// SPI Flash Programming Guide Section 5.5.2 Vendor Component Lock
> 
> +  /// It is strongly recommended that BIOS sets the Vendor Component Lock
> (VCL) bits. VCL applies
> 
> +  /// the lock to both VSCC0 and VSCC1 even if VSCC0 is not used. Without
> the VCL bits set, it is
> 
> +  /// possible to make Host/GbE VSCC register(s) changes in that can cause
> undesired host and
> 
> +  /// integrated GbE Serial Flash functionality.
> 
> +  ///
> 
> +  MmioOr32 ((UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0),
> B_SPI_MEM_SFDP0_VSCC0_VCL);
> 
> +  S3BootScriptSaveMemWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    (UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0),
> 
> +    1,
> 
> +    (VOID *) (UINTN) (PchSpiBar0 + R_SPI_MEM_SFDP0_VSCC0)
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set HD Audio PME bit
> 
> +**/
> 
> +VOID
> 
> +ConfigureHdAudioPme (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64 HdaPciBase;
> 
> +
> 
> +  HdaPciBase = HdaPciCfgBase ();
> 
> +
> 
> +  if (PciSegmentRead16 (HdaPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF)
> {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// PME Enable for Audio controller
> 
> +  ///
> 
> +  if (mPchConfigHob->HdAudio.Pme == TRUE) {
> 
> +    PciSegmentOr32 (HdaPciBase + R_HDA_CFG_PCS, (UINT32)
> B_HDA_CFG_PCS_PMEE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set eSPI BME bit
> 
> +**/
> 
> +VOID
> 
> +ConfigureEspiBme (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64 EspiPciBase;
> 
> +
> 
> +  EspiPciBase = EspiPciCfgBase ();
> 
> +
> 
> +  if (PciSegmentRead16 (EspiPciBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF)
> {
> 
> +    return;
> 
> +  }
> 
> +  if ((PciSegmentRead32 (EspiPciBase + R_ESPI_CFG_PCBC) &
> B_ESPI_CFG_PCBC_ESPI_EN) == 0) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Refer to PCH BWG.
> 
> +  // To enable eSPI bus mastering BIOS must enable BME in eSPI controller
> 
> +  // and also set BME bit in the respective slave devices through
> Configuration
> 
> +  // and Capabilities register of each slave using Get_Configuration and
> Set_Configuration functionality.
> 
> +  //
> 
> +  // NOTE: The setting is also done in PEI, but might be cleared by PCI bus
> during PCI enumeration.
> 
> +  //       Therefore, reeable it after PCI enumeration done.
> 
> +  //
> 
> +  if (mPchConfigHob->Espi.BmeMasterSlaveEnabled == TRUE) {
> 
> +    PciSegmentOr8 (EspiPciBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_BUS_MASTER);
> 
> +  }
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h
> new file mode 100644
> index 0000000000..0d6647e3f3
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInit.h
> @@ -0,0 +1,122 @@
> +/** @file
> 
> +  Header file for PCH Initialization Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_INIT_DXE_H_
> 
> +#define _PCH_INIT_DXE_H_
> 
> +
> 
> +#include <SiConfigHob.h>
> 
> +#include <PchConfigHob.h>
> 
> +#include <Protocol/PchNvsArea.h>
> 
> +
> 
> +//
> 
> +// Data definitions
> 
> +//
> 
> +extern EFI_HANDLE               mImageHandle;
> 
> +
> 
> +//
> 
> +// Pch NVS area definition
> 
> +//
> 
> +extern PCH_NVS_AREA_PROTOCOL    mPchNvsAreaProtocol;
> 
> +
> 
> +extern PCH_CONFIG_HOB           *mPchConfigHob;
> 
> +extern SI_CONFIG_HOB_DATA       *mSiConfigHobData;
> 
> +
> 
> +//
> 
> +// Function Prototype
> 
> +//
> 
> +
> 
> +//
> 
> +// Local function prototypes
> 
> +//
> 
> +/**
> 
> +  Common PchInit Module Entry Point
> 
> +**/
> 
> +VOID
> 
> +PchInitEntryPointCommon (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Calls Boot Os Hand off routine for each Serial IO Controller
> 
> +**/
> 
> +VOID
> 
> +ConfigureSerialIoAtBoot (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Puts all SerialIo controllers (except UARTs in debug mode) in D3.
> 
> +  Clears MemoryEnable for all PCI-mode controllers on S3 resume
> 
> +**/
> 
> +VOID
> 
> +ConfigureSerialIoAtS3Resume (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Add Serial Io UART Hidden Handles
> 
> +**/
> 
> +VOID
> 
> +CreateSerialIoUartHiddenHandle (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Initialize Intel High Definition Audio ACPI Tables
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_LOAD_ERROR          ACPI table cannot be installed
> 
> +  @retval EFI_UNSUPPORTED         ACPI table not set because DSP is disabled
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchHdAudioAcpiInit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Perform the remaining configuration on SATA to perform device detection,
> 
> +  then set the SATA SPD and PxE corresponding, and set the Register Lock
> on PCH SATA
> 
> +**/
> 
> +VOID
> 
> +ConfigureSataOnEndOfDxe (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Update ASL data for CNVI Device.
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +UpdateCnviAcpiData (
> 
> +   VOID
> 
> +   );
> 
> +
> 
> +/**
> 
> +  Initialize Pch acpi
> 
> +  @param[in] ImageHandle          Handle for the image of this driver
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to
> initialize the driver
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiInit (
> 
> +  IN EFI_HANDLE         ImageHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Update ASL object before Boot
> 
> +
> 
> +  @retval EFI_STATUS
> 
> +  @retval EFI_NOT_READY         The Acpi protocols are not ready.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchUpdateNvsArea (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif // _PCH_INIT_DXE_H_
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c
> new file mode 100644
> index 0000000000..1d4f08a86c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxe.c
> @@ -0,0 +1,354 @@
> +/** @file
> 
> +  This is the Uefi driver that initializes the Intel PCH.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +
> 
> +#include "PchInit.h"
> 
> +#include <PchPolicyCommon.h>
> 
> +#include <Protocol/PcieIoTrap.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/PciExpressHelpersLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE               mImageHandle;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16
> mPcieIoTrapAddress;
> 
> +
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnBootToOs (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  );
> 
> +
> 
> +
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnExitBootServices (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  );
> 
> +
> 
> +
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnReadyToBoot (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Process all the lock downs
> 
> +**/
> 
> +VOID
> 
> +ProcessSmiLocks (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32        Data32And;
> 
> +  UINT32        Data32Or;
> 
> +  UINT16        ABase;
> 
> +
> 
> +  ///
> 
> +  /// PCH BIOS Spec Section 3.6 Flash Security Recommendation
> 
> +  /// BIOS needs to enables SMI_LOCK (PMC PCI offset A0h[4] = 1b) which
> prevent writes
> 
> +  /// to the Global SMI Enable bit (GLB_SMI_EN ABASE + 30h[0]). Enabling
> this bit will
> 
> +  /// mitigate malicious software attempts to gain system management
> mode privileges.
> 
> +  ///
> 
> +  if (mPchConfigHob->LockDown.GlobalSmi == TRUE) {
> 
> +    ///
> 
> +    /// Save Global SMI Enable bit setting before BIOS enables SMI_LOCK
> during S3 resume
> 
> +    ///
> 
> +    ABase = PmcGetAcpiBase ();
> 
> +    Data32Or = IoRead32 ((UINTN) (ABase + R_ACPI_IO_SMI_EN));
> 
> +    if ((Data32Or & B_ACPI_IO_SMI_EN_GBL_SMI) != 0) {
> 
> +      Data32And = 0xFFFFFFFF;
> 
> +      Data32Or |= B_ACPI_IO_SMI_EN_GBL_SMI;
> 
> +      S3BootScriptSaveIoReadWrite (
> 
> +        S3BootScriptWidthUint32,
> 
> +        (UINTN) (ABase + R_ACPI_IO_SMI_EN),
> 
> +        &Data32Or,  // Data to be ORed
> 
> +        &Data32And  // Data to be ANDed
> 
> +        );
> 
> +    }
> 
> +      PmcLockSmiWithS3BootScript ();
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Do PCIE power management while resume from S3
> 
> +**/
> 
> +VOID
> 
> +ReconfigurePciePowerManagementForS3 (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINT32                                Data32;
> 
> +  PCH_PCIE_IOTRAP_PROTOCOL              *PchPcieIoTrapProtocol;
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gPchPcieIoTrapProtocolGuid, NULL, (VOID
> **) &PchPcieIoTrapProtocol);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return;
> 
> +  }
> 
> +  mPcieIoTrapAddress = PchPcieIoTrapProtocol->PcieTrapAddress;
> 
> +  DEBUG ((DEBUG_INFO, "PcieIoTrapAddress: %0x\n",
> mPcieIoTrapAddress));
> 
> +
> 
> +  if (mPcieIoTrapAddress != 0) {
> 
> +    //
> 
> +    // Save PCH PCIE IoTrap address to re-config PCIE power management
> setting after resume from S3
> 
> +    //
> 
> +    Data32 = PchPciePmTrap;
> 
> +    S3BootScriptSaveIoWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      (UINTN) (mPcieIoTrapAddress),
> 
> +      1,
> 
> +      &Data32
> 
> +      );
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This is the callback function for PCI ENUMERATION COMPLETE.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnPciEnumComplete (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS          Status;
> 
> +  VOID                *ProtocolPointer;
> 
> +
> 
> +  ///
> 
> +  /// Check if this is first time called by EfiCreateProtocolNotifyEvent() or
> not,
> 
> +  /// if it is, we will skip it until real event is triggered
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol
> (&gEfiPciEnumerationCompleteProtocolGuid, NULL, (VOID **)
> &ProtocolPointer);
> 
> +  if (EFI_SUCCESS != Status) {
> 
> +    return;
> 
> +  }
> 
> +  gBS->CloseEvent (Event);
> 
> +
> 
> +  ReconfigurePciePowerManagementForS3 ();
> 
> +  ProcessSmiLocks ();
> 
> +  ConfigureSerialIoAtS3Resume ();
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register callback functions for PCH DXE.
> 
> +**/
> 
> +VOID
> 
> +PchRegisterNotifications (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  EFI_EVENT   ReadyToBoot;
> 
> +  EFI_EVENT   LegacyBootEvent;
> 
> +  EFI_EVENT   ExitBootServicesEvent;
> 
> +  VOID        *Registration;
> 
> +
> 
> +  ///
> 
> +  /// Create PCI Enumeration Completed callback for PCH
> 
> +  ///
> 
> +  EfiCreateProtocolNotifyEvent (
> 
> +    &gEfiPciEnumerationCompleteProtocolGuid,
> 
> +    TPL_CALLBACK,
> 
> +    PchOnPciEnumComplete,
> 
> +    NULL,
> 
> +    &Registration
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Register a Ready to boot event to config PCIE power management
> setting after OPROM executed
> 
> +  //
> 
> +  Status = EfiCreateEventReadyToBootEx (
> 
> +             TPL_CALLBACK,
> 
> +             PchOnReadyToBoot,
> 
> +             NULL,
> 
> +             &ReadyToBoot
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Create events for PCH to do the task before
> ExitBootServices/LegacyBoot.
> 
> +  // It is guaranteed that only one of two events below will be signalled
> 
> +  //
> 
> +  Status = gBS->CreateEvent (
> 
> +                  EVT_SIGNAL_EXIT_BOOT_SERVICES,
> 
> +                  TPL_CALLBACK,
> 
> +                  PchOnExitBootServices,
> 
> +                  NULL,
> 
> +                  &ExitBootServicesEvent
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = EfiCreateEventLegacyBootEx (
> 
> +             TPL_CALLBACK,
> 
> +             PchOnBootToOs,
> 
> +             NULL,
> 
> +             &LegacyBootEvent
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +}
> 
> +
> 
> +/**
> 
> +  <b>PchInit DXE Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +      The PchInit module is a DXE driver that initializes the Intel Platform
> Controller Hub
> 
> +      following the PCH BIOS specification and EDS requirements and
> recommendations. It consumes
> 
> +      the PCH_POLICY_HOB SI_POLICY_HOB for expected configurations per
> policy.
> 
> +      This is the standard EFI driver point that detects whether there is an
> supported PCH in
> 
> +      the system and if so, initializes the chipset.
> 
> +
> 
> +  - <b>Details</b>\n
> 
> +    This module is required for initializing the Intel Platform Controller Hub to
> 
> +    follow the PCH BIOS specification and EDS.
> 
> +    This includes some initialization sequences, enabling and disabling PCH
> devices,
> 
> +    configuring clock gating, RST PCIe Storage Remapping, SATA controller,
> ASPM of PCIE devices. Right before end of DXE,
> 
> +    it's responsible to lock down registers for security requirement.
> 
> +
> 
> +  - @pre
> 
> +    - PCH PCR base address configured
> 
> +    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
> 
> +      - This is to ensure that PCI MMIO and IO resource has been prepared
> and available for this driver to allocate.
> 
> +
> 
> +  - @result
> 
> +    - Publishes the @link _PCH_INFO_PROTOCOL PCH_INFO_PROTOCOL
> @endlink
> 
> +    - Publishes the @link _PCH_EMMC_TUNING_PROTOCOL
> PCH_EMMC_TUNING_PROTOCOL @endlink
> 
> +
> 
> +  - <b>References</b>\n
> 
> +    - @link _PCH_POLICY PCH_POLICY_HOB @endlink.
> 
> +    - @link _SI_POLICY_STRUCT SI_POLICY_HOB @endlink.
> 
> +
> 
> +  - <b>Integration Checklists</b>\n
> 
> +    - Verify prerequisites are met. Porting Recommendations.
> 
> +    - No modification of this module should be necessary
> 
> +    - Any modification of this module should follow the PCH BIOS
> Specification and EDS
> 
> +
> 
> +  @param[in] ImageHandle          Handle for the image of this driver
> 
> +  @param[in] SystemTable          Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    Do not have enough resources to
> initialize the driver
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchInitEntryPointDxe (
> 
> +  IN EFI_HANDLE         ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE   *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchInitEntryPointDxe() Start\n"));
> 
> +
> 
> +  mImageHandle = ImageHandle;
> 
> +
> 
> +  PchInitEntryPointCommon ();
> 
> +
> 
> +  Status = PchAcpiInit (ImageHandle);
> 
> +
> 
> +  PchRegisterNotifications ();
> 
> +
> 
> +  CreateSerialIoUartHiddenHandle ();
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchInitEntryPointDxe() End\n"));
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCH initialization before ExitBootServices / LegacyBoot events
> 
> +  Useful for operations which must happen later than at EndOfPost event
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnBootToOs (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  ///
> 
> +  /// Closed the event to avoid call twice
> 
> +  ///
> 
> +  if (Event != NULL) {
> 
> +    gBS->CloseEvent (Event);
> 
> +  }
> 
> +
> 
> +  ConfigureSerialIoAtBoot ();
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCH initialization on ExitBootService. This event is used if only
> ExitBootService is used
> 
> +  and not in legacy boot
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnExitBootServices (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  PchOnBootToOs (NULL, NULL);
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCH initialization before boot to OS
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchOnReadyToBoot (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "Uefi PchOnReadyToBoot() Start\n"));
> 
> +
> 
> +  if (Event != NULL) {
> 
> +    gBS->CloseEvent (Event);
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Trigger an Iotrap SMI to config PCIE power management setting after
> PCI enumrate is done
> 
> +  //
> 
> +  if (mPcieIoTrapAddress != 0) {
> 
> +    IoWrite32 ((UINTN) mPcieIoTrapAddress, PchPciePmTrap);
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Uefi PchOnReadyToBoot() End\n"));
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf
> new file mode 100644
> index 0000000000..4941ff0f49
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchInitDxeTgl.inf
> @@ -0,0 +1,96 @@
> +## @file
> 
> +# Component description file for Pch Initialization driver
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PchInitDxeTgl
> 
> +FILE_GUID = 4BD0EB2F-3A2D-442E-822D-753516F75424
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +ENTRY_POINT = PchInitEntryPointDxe
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +S3BootScriptLib
> 
> +PchCycleDecodingLib
> 
> +PchPcieRpLib
> 
> +PchPcrLib
> 
> +PchInfoLib
> 
> +PciExpressHelpersLib
> 
> +UefiBootServicesTableLib
> 
> +DebugLib
> 
> +IoLib
> 
> +TimerLib
> 
> +HobLib
> 
> +BaseMemoryLib
> 
> +MemoryAllocationLib
> 
> +UefiLib
> 
> +DxeServicesTableLib
> 
> +UefiDriverEntryPoint
> 
> +UefiRuntimeServicesTableLib
> 
> +GpioLib
> 
> +SerialIoAccessLib
> 
> +ConfigBlockLib
> 
> +PmcLib
> 
> +PmcPrivateLibWithS3
> 
> +SataLib
> 
> +PchDmiWithS3Lib
> 
> +GbeLib
> 
> +SiScheduleResetLib
> 
> +DxeHdaNhltLib
> 
> +SpiAccessPrivateLib
> 
> +PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr ## CONSUMES
> 
> +gSiPkgTokenSpaceGuid.PcdEmbeddedEnable             ## CONSUMES
> 
> +
> 
> +[Sources]
> 
> +PchInitDxe.c
> 
> +PchInit.h
> 
> +PchInit.c
> 
> +PchSata.c
> 
> +PchSerialIo.c
> 
> +PchSerialIoDxe.c
> 
> +PchHdaAcpi.c
> 
> +PchCnviAcpi.c
> 
> +PchAcpi.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gPchNvsAreaProtocolGuid ## PRODUCES
> 
> +gEfiPciIoProtocolGuid ## CONSUMES
> 
> +gEfiAcpiTableProtocolGuid ## CONSUMES
> 
> +gEfiBlockIoProtocolGuid ## CONSUMES
> 
> +gHeciProtocolGuid
> 
> +gEfiPciEnumerationCompleteProtocolGuid ## CONSUMES
> 
> +gPchPcieIoTrapProtocolGuid ## CONSUMES
> 
> +gPchPolicyProtocolGuid ## CONSUMES
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gEfiEndOfDxeEventGroupGuid
> 
> +gEfiAcpiTableGuid
> 
> +gEmmcDxeConfigGuid               ## CONSUMES
> 
> +gSiConfigHobGuid                 ## CONSUMES
> 
> +gPchConfigHobGuid                ## CONSUMES
> 
> +gPchRstHobGuid                   ## CONSUMES
> 
> +gHdAudioDxeConfigGuid            ## CONSUMES
> 
> +gGpioDxeConfigGuid               ## CONSUMES
> 
> +gCnviConfigHobGuid               ## CONSUMES
> 
> +gHybridStorageHobGuid            ## CONSUMES
> 
> +
> 
> +[Depex]
> 
> +gEfiPciHostBridgeResourceAllocationProtocolGuid ## This is to ensure that
> PCI MMIO and IO resource has been prepared and available for this driver to
> allocate.
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c
> new file mode 100644
> index 0000000000..886f3b4bc0
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSata.c
> @@ -0,0 +1,89 @@
> +/** @file
> 
> +  Perform related functions for PCH Sata in DXE phase
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +
> 
> +#include "PchInit.h"
> 
> +#include <Library/SataLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Register/SataRegs.h>
> 
> +
> 
> +/**
> 
> +  Perform the remaining configuration on SATA to perform device detection,
> 
> +  then set the SATA SPD and PxE corresponding, and set the Register Lock
> on PCH SATA
> 
> +
> 
> +  @retval None
> 
> +**/
> 
> +VOID
> 
> +ConfigureSataOnEndOfDxe (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64        PciSataRegBase;
> 
> +  UINT16        SataPortsEnabled;
> 
> +  UINT32        DwordReg;
> 
> +  UINTN         Index;
> 
> +  UINT32        SataCtrlIndex;
> 
> +
> 
> +  for (SataCtrlIndex = 0; SataCtrlIndex < MaxSataControllerNum ();
> SataCtrlIndex++) {
> 
> +    ///
> 
> +    /// SATA PCS: Enable the port in any of below condition:
> 
> +    /// i.)   Hot plug is enabled
> 
> +    /// ii.)  A device is attached
> 
> +    /// iii.) Test mode is enabled
> 
> +    /// iv.)  Configured as eSATA port
> 
> +    ///
> 
> +    PciSataRegBase    = SataPciCfgBase (SataCtrlIndex);
> 
> +    SataPortsEnabled  = 0;
> 
> +
> 
> +    DwordReg = PciSegmentRead32 (PciSataRegBase + R_SATA_CFG_PCS);
> 
> +    for (Index = 0; Index < MaxSataPortNum (SataCtrlIndex); Index++) {
> 
> +      if ((mPchConfigHob->Sata[SataCtrlIndex].PortSettings[Index].HotPlug
> == TRUE) ||
> 
> +          (DwordReg & (B_SATA_CFG_PCS_P0P << Index)) ||
> 
> +            (mPchConfigHob->Sata[SataCtrlIndex].TestMode == TRUE) ||
> 
> +            (mPchConfigHob->Sata[SataCtrlIndex].PortSettings[Index].External
> == TRUE)) {
> 
> +          SataPortsEnabled |= (mPchConfigHob-
> >Sata[SataCtrlIndex].PortSettings[Index].Enable << Index);
> 
> +      }
> 
> +    }
> 
> +
> 
> +    ///
> 
> +    /// Set MAP."Sata PortX Disable", SATA PCI offset 90h[23:16] to 1b if SATA
> Port 0/1/2/3/4/5/6/7 is disabled
> 
> +    ///
> 
> +    PciSegmentOr32 (PciSataRegBase + R_SATA_CFG_MAP,
> (~SataPortsEnabled << N_SATA_CFG_MAP_SPD));
> 
> +    S3BootScriptSaveMemWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase +
> R_SATA_CFG_MAP,
> 
> +      1,
> 
> +      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) +
> PciSataRegBase + R_SATA_CFG_MAP)
> 
> +      );
> 
> +
> 
> +    ///
> 
> +    /// Program PCS "Port X Enabled", SATA PCI offset 94h[7:0] = Port 0~7
> Enabled bit as per SataPortsEnabled value.
> 
> +    ///
> 
> +    PciSegmentOr16 (PciSataRegBase + R_SATA_CFG_PCS,
> SataPortsEnabled);
> 
> +    S3BootScriptSaveMemWrite (
> 
> +      S3BootScriptWidthUint16,
> 
> +      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase +
> R_SATA_CFG_PCS,
> 
> +      1,
> 
> +      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) +
> PciSataRegBase + R_SATA_CFG_PCS)
> 
> +      );
> 
> +
> 
> +    ///
> 
> +    /// Step 14
> 
> +    /// Program SATA PCI offset 9Ch [31] to 1b
> 
> +    ///
> 
> +    PciSegmentOr32 ((UINTN) (PciSataRegBase + R_SATA_CFG_SATAGC),
> BIT31);
> 
> +    S3BootScriptSaveMemWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      PcdGet64 (PcdSiPciExpressBaseAddress) + PciSataRegBase +
> R_SATA_CFG_SATAGC,
> 
> +      1,
> 
> +      (VOID *) (UINTN) (PcdGet64 (PcdSiPciExpressBaseAddress) +
> PciSataRegBase + R_SATA_CFG_SATAGC)
> 
> +      );
> 
> +  }
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c
> new file mode 100644
> index 0000000000..9409a9a387
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIo.c
> @@ -0,0 +1,33 @@
> +/** @file
> 
> +  Initializes Serial IO Controllers.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchInit.h"
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +
> 
> +/**
> 
> +  Calls Boot Os Hand off routine for each Serial IO Controller
> 
> +**/
> 
> +VOID
> 
> +ConfigureSerialIoAtBoot (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8  Index;
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
> 
> +    SerialIoSpiBootHandler (Index, &mPchConfigHob-
> >SerialIo.SpiDeviceConfig[Index]);
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
> 
> +    SerialIoI2cBootHandler (Index, &mPchConfigHob-
> >SerialIo.I2cDeviceConfig[Index]);
> 
> +  }
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++)
> {
> 
> +    SerialIoUartBootHandler (Index, &mPchConfigHob-
> >SerialIo.UartDeviceConfig[Index]);
> 
> +  }
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c
> new file mode 100644
> index 0000000000..fde7da6b96
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Dxe/PchSerialIoDxe.c
> @@ -0,0 +1,134 @@
> +/** @file
> 
> +  Initializes Serial IO Controllers.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/DevicePathLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/DxeServicesTableLib.h>
> 
> +#include <Library/SerialIoPrivateLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/SerialIoRegs.h>
> 
> +#include <PchInit.h>
> 
> +
> 
> +typedef struct {
> 
> +  ACPI_HID_DEVICE_PATH          RootPort;
> 
> +  ACPI_EXTENDED_HID_DEVICE_PATH AcpiDev;
> 
> +  CHAR8                         HidString[8];
> 
> +  UINT16                        DeviceId;
> 
> +  UINT8                         UartIndex;
> 
> +  EFI_DEVICE_PATH_PROTOCOL      End;
> 
> +} SERIALIO_UART_DEVICE_PATH;
> 
> +
> 
> +#define mPciRootBridge {{ACPI_DEVICE_PATH, ACPI_DP, {(UINT8)(sizeof
> (ACPI_HID_DEVICE_PATH)), 0}}, EISA_PNP_ID (0x0A03), 0}
> 
> +#define mAcpiDev {{ACPI_DEVICE_PATH, ACPI_EXTENDED_DP,
> {(UINT8)(sizeof (ACPI_EXTENDED_HID_DEVICE_PATH) + (sizeof(CHAR8) * 8)
> + sizeof (UINT16) + sizeof (UINT8)), 0}},0,0,0}
> 
> +#define mEndEntire {END_DEVICE_PATH_TYPE,
> END_ENTIRE_DEVICE_PATH_SUBTYPE, {END_DEVICE_PATH_LENGTH, 0}}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED SERIALIO_UART_DEVICE_PATH
> mSerialIoUartPath = {
> 
> +  mPciRootBridge,
> 
> +  mAcpiDev,
> 
> +  "UART\0\0\0",
> 
> +  0xFFFF,
> 
> +  0xFF,
> 
> +  mEndEntire
> 
> +};
> 
> +
> 
> +/**
> 
> +  Add Serial Io UART Hidden Handles
> 
> +**/
> 
> +VOID
> 
> +CreateSerialIoUartHiddenHandle (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_HANDLE               NewHandle;
> 
> +  EFI_DEVICE_PATH_PROTOCOL *NewPath;
> 
> +  EFI_STATUS               Status;
> 
> +  UINT8                    Index;
> 
> +  UINT16                   DeviceId;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "CreateSerialIoUartHandle\n"));
> 
> +
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++)
> {
> 
> +    DEBUG ((DEBUG_INFO, "UART Index: %d Mode: %d\n", Index,
> mPchConfigHob->SerialIo.UartDeviceConfig[Index].Mode));
> 
> +    if (mPchConfigHob->SerialIo.UartDeviceConfig[Index].Mode ==
> SerialIoUartHidden) {
> 
> +      NewHandle = NULL;
> 
> +      DeviceId = MmioRead16 (GetSerialIoUartFixedPciCfgAddress (Index) +
> PCI_DEVICE_ID_OFFSET);
> 
> +      DEBUG ((DEBUG_INFO, "Creating Handle for UART DEVICE_ID: 0x%X \n",
> DeviceId));
> 
> +      mSerialIoUartPath.AcpiDev.HID  = 0x5432 + (Index << 16); //UAR
> 
> +      mSerialIoUartPath.HidString[4] = (CHAR8)('0' + Index);
> 
> +      mSerialIoUartPath.DeviceId     = DeviceId;
> 
> +      mSerialIoUartPath.UartIndex    = Index;
> 
> +      NewPath = DuplicateDevicePath ((EFI_DEVICE_PATH_PROTOCOL*)
> &mSerialIoUartPath);
> 
> +      Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                      &NewHandle,
> 
> +                      &gEfiDevicePathProtocolGuid,
> 
> +                      NewPath,
> 
> +                      NULL
> 
> +                      );
> 
> +      DEBUG ((DEBUG_INFO, "CreateSerialIoUartHandle Status: %r\n",
> Status));
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Stores Pme Control Status and Command register values in S3 Boot Script
> 
> +
> 
> +  @param[in] S3PciCfgBase      S3 Boot Script Pci Config Base
> 
> +  @param[in] Command           Pci Command register data to save
> 
> +  @param[in] Pme               Pci Pme Control register data to save
> 
> +
> 
> +**/
> 
> +VOID
> 
> +STATIC
> 
> +SerialIoS3Save (
> 
> +  IN UINTN   S3PciCfgBase,
> 
> +  IN UINTN   Command,
> 
> +  IN UINTN   Pme
> 
> +  )
> 
> +{
> 
> +  if (S3PciCfgBase != 0) {
> 
> +    S3BootScriptSavePciCfgWrite (S3BootScriptWidthUint32, S3PciCfgBase +
> R_SERIAL_IO_CFG_PME_CTRL_STS, 1, &Pme);
> 
> +    S3BootScriptSavePciCfgWrite (S3BootScriptWidthUint32, S3PciCfgBase +
> PCI_COMMAND_OFFSET, 1, &Command);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Puts all SerialIo controllers (except UARTs in debug mode) in D3.
> 
> +  Clears MemoryEnable for all PCI-mode controllers on S3 resume
> 
> +**/
> 
> +VOID
> 
> +ConfigureSerialIoAtS3Resume (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8     Index;
> 
> +  UINTN     S3PciCfgBase;
> 
> +  UINT32    Command;
> 
> +  UINT32    Pme;
> 
> +
> 
> +  S3PciCfgBase = 0;
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoSpiControllersNum (); Index++) {
> 
> +    SerialIoSpiS3Handler (Index, &mPchConfigHob-
> >SerialIo.SpiDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
> 
> +    SerialIoS3Save (S3PciCfgBase, Command, Pme);
> 
> +  }
> 
> +
> 
> +  S3PciCfgBase = 0;
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoI2cControllersNum (); Index++) {
> 
> +    SerialIoI2cS3Handler (Index, &mPchConfigHob-
> >SerialIo.I2cDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
> 
> +    SerialIoS3Save (S3PciCfgBase, Command, Pme);
> 
> +  }
> 
> +
> 
> +  S3PciCfgBase = 0;
> 
> +  for (Index = 0; Index < GetPchMaxSerialIoUartControllersNum (); Index++)
> {
> 
> +    SerialIoUartS3Handler (Index, &mPchConfigHob-
> >SerialIo.UartDeviceConfig[Index], &S3PciCfgBase, &Command, &Pme);
> 
> +    SerialIoS3Save (S3PciCfgBase, Command, Pme);
> 
> +  }
> 
> +}
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c
> new file mode 100644
> index 0000000000..786ce13915
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/GbeSxSmm.c
> @@ -0,0 +1,266 @@
> +/** @file
> 
> +  Gbe Sx handler implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include <Library/TimerLib.h>
> 
> +#include "PchInitSmm.h"
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/GbeMdiLib.h>
> 
> +#include <Library/GbeLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/GbeRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +
> 
> +/**
> 
> +  Configure WOL during Sx entry.
> 
> +
> 
> +  @param [in]  GbeBar   GbE MMIO space
> 
> +**/
> 
> +VOID
> 
> +GbeWolWorkaround (
> 
> +  IN      UINT32  GbeBar
> 
> +  )
> 
> +{
> 
> +  UINT32      RAL0;
> 
> +  UINT32      RAH0;
> 
> +  UINT16      WUC;
> 
> +  EFI_STATUS  Status;
> 
> +  UINT16      Data16;
> 
> +
> 
> +  //
> 
> +  // 1. Set page to 769 Port Control Registers
> 
> +  // 2. Wait 4 mSec
> 
> +  //
> 
> +  Status = GbeMdiSetPage (GbeBar,
> PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 3. Set registry to 17 Port General Configuration
> 
> +  // 4. Copy all settings from Port General Configuration
> 
> +  //
> 
> +  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), &Data16);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 5. Modify BIT 4 and BIT 2 to disable host wake up and set MACPD
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), (Data16 |
> B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE) &
> (~B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 6. Read Receive Address Low and Receive Address High from MMIO
> 
> +  //
> 
> +  RAL0 = MmioRead32 (GbeBar + R_GBE_MEM_CSR_RAL);
> 
> +  RAH0 = MmioRead32 (GbeBar + R_GBE_MEM_CSR_RAH);
> 
> +
> 
> +  //
> 
> +  // 7. Set page to 800 Wake Up Registers
> 
> +  // 8. Wait 4 mSec
> 
> +  //
> 
> +  Status = GbeMdiSetPage (GbeBar,
> PHY_MDI_PAGE_800_WAKE_UP_REGISTERS);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 9. Set registry to 16 Receive Address Low 1/2
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_800_REGISETER_16_RAL0);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 10. Program first 16 bits [0:15] out of 48 in Receive Address Low 1/2
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAL0 & 0xFFFF));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 11. Set registry to 17 Receive Address Low 2/2
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_800_REGISETER_17_RAL1);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 12. Program second 16 bits [16:31] out of 48 in Receive Address Low 2/2
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAL0 >> 16));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 13. Set registry to 18 Receive Address High 1/2
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_800_REGISETER_18_RAH0);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 14. Program last 16 bits [32:47] out of 48
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (RAH0 &
> B_GBE_MEM_CSR_RAH_RAH));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 15. Set registry to 19 Receive Address High 2/2
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_800_REGISETER_19_RAH1);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 16. Set Address Valid
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE,
> B_PHY_MDI_PAGE_800_REGISETER_19_RAH1_ADDRESS_VALID);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 17. Set Wake Up Control Register 1
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_800_REGISETER_1_WUC);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 18. Copy WakeUp Control from MAC MMIO
> 
> +  //
> 
> +  WUC = (UINT16) MmioRead32 (GbeBar + R_GBE_MEM_CSR_WUC);
> 
> +
> 
> +  //
> 
> +  // 19. Store WakeUp Contorl into LCD
> 
> +  // Modify APME bit to enable APM wake up
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE, (WUC & 0xFFFF));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 20. Set page to 803 Host Wol Packet
> 
> +  // 21. Wait 4 mSec
> 
> +  //
> 
> +  Status = GbeMdiSetPage (GbeBar,
> PHY_MDI_PAGE_803_HOST_WOL_PACKET);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 22. Set registry to 66 Host WoL Packet Clear
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_803_REGISETER_66_HWPC);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 23. Clear WOL Packet
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> R_PHY_MDI_PHY_REG_DATA_READ_WRITE, 0);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +  //
> 
> +  // 24. Set page to 769 Port Control Registers
> 
> +  // 25. Wait 4 mSec
> 
> +  //
> 
> +  Status = GbeMdiSetPage (GbeBar,
> PHY_MDI_PAGE_769_PORT_CONTROL_REGISTERS);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 26. Set registry to 17 Port General Configuration
> 
> +  //
> 
> +  Status = GbeMdiSetRegister (GbeBar,
> R_PHY_MDI_PAGE_769_REGISETER_17_PGC);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 27. Copy all settings from Port General Configuration
> 
> +  //
> 
> +  Status = GbeMdiRead (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), &Data16);
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +
> 
> +  //
> 
> +  // 28. Modify BIT 4 and BIT 2 to enable host wake up and clear MACPD
> 
> +  //
> 
> +  Status = GbeMdiWrite (GbeBar, B_PHY_MDI_PHY_ADDRESS_01,
> MDI_REG_SHIFT (R_PHY_MDI_PAGE_769_REGISETER_17_PGC), (Data16 |
> B_PHY_MDI_PAGE_769_REGISETER_17_PGC_HOST_WAKE_UP) &
> (~B_PHY_MDI_PAGE_769_REGISETER_17_PGC_MACPD_ENABLE));
> 
> +  if (EFI_ERROR (Status)) return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Additional Internal GbE Controller special cases WOL Support.
> 
> +
> 
> +  System BIOS is required perform additional steps upon S0 to S3,4,5
> transition
> 
> +  when ME is off and GbE device in D0. This is needed to enable LAN wake
> 
> +  in particular when platform is shut-down from EFI.
> 
> +**/
> 
> +VOID
> 
> +GbeSxWorkaround (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64      LanRegBase;
> 
> +  UINT32      GbeBar;
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  LanRegBase = GbePciCfgBase ();
> 
> +
> 
> +  if (PciSegmentRead16 (LanRegBase + PCI_VENDOR_ID_OFFSET) ==
> 0xFFFF) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check if GbE device is in D0
> 
> +  //
> 
> +  if ((PciSegmentRead16 (LanRegBase + R_GBE_CFG_PMCS) &
> B_GBE_CFG_PMCS_PS) != V_GBE_CFG_PMCS_PS0) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  ASSERT (mResvMmioSize >= (1 << N_GBE_CFG_MBARA_ALIGN));
> 
> +  GbeBar = (UINT32) mResvMmioBaseAddr;
> 
> +  if (GbeBar == 0) {
> 
> +    ASSERT (FALSE);
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Enable MMIO decode using reserved range.
> 
> +  //
> 
> +  PciSegmentAnd16 (LanRegBase + PCI_COMMAND_OFFSET, (UINT16)
> ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  PciSegmentWrite32 (LanRegBase + R_GBE_CFG_MBARA, GbeBar);
> 
> +  PciSegmentOr16 (LanRegBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +
> 
> +  //
> 
> +  // If MBARA offset 5800h [0] = 1b then proceed with the w/a
> 
> +  //
> 
> +  if (MmioRead32 (GbeBar + R_GBE_MEM_CSR_WUC) &
> B_GBE_MEM_CSR_WUC_APME) {
> 
> +    Status = GbeMdiAcquireMdio (GbeBar);
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    if (!EFI_ERROR (Status)) {
> 
> +      GbeWolWorkaround (GbeBar);
> 
> +      GbeMdiReleaseMdio (GbeBar);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Disable MMIO decode.
> 
> +  //
> 
> +  PciSegmentAnd16 (LanRegBase + PCI_COMMAND_OFFSET, (UINT16)
> ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  PciSegmentWrite32 (LanRegBase + R_GBE_CFG_MBARA, 0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enable platform wake from LAN when in DeepSx if platform supports it.
> 
> +  Called upon Sx entry.
> 
> +**/
> 
> +VOID
> 
> +GbeConfigureDeepSxWake (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  if (PmcIsLanDeepSxWakeEnabled ()) {
> 
> +    IoOr32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_GPE0_EN_127_96),
> (UINT32) B_ACPI_IO_GPE0_EN_127_96_LAN_WAKE);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  GbE Sx entry handler
> 
> +**/
> 
> +VOID
> 
> +PchLanSxCallback (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  if (IsGbeEnabled ()) {
> 
> +    GbeSxWorkaround ();
> 
> +    GbeConfigureDeepSxWake ();
> 
> +
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
> new file mode 100644
> index 0000000000..f435af434a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchBiosWriteProtect.c
> @@ -0,0 +1,137 @@
> +/** @file
> 
> +  PCH BIOS Write Protect Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchInitSmm.h"
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Library/SpiAccessPrivateLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +//
> 
> +// Global variables
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> PCH_TCO_SMI_DISPATCH_PROTOCOL     *mPchTcoSmiDispatchProtocol;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> PCH_ESPI_SMI_DISPATCH_PROTOCOL    *mEspiSmmDispatchProtocol;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT64                            mLpcRegBase;
> 
> +
> 
> +/**
> 
> +  This hardware SMI handler will be run every time the BIOS Write Enable bit
> is set.
> 
> +
> 
> +  @param[in] DispatchHandle       Not used
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchSpiBiosWpCallback (
> 
> +  IN  EFI_HANDLE                              DispatchHandle
> 
> +  )
> 
> +{
> 
> +  SpiClearBiosWriteProtectDisable ();
> 
> +}
> 
> +
> 
> +/**
> 
> +  This hardware SMI handler will be run every time the BIOS Write Enable bit
> is set.
> 
> +
> 
> +  @param[in] DispatchHandle       Not used
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchLpcBiosWpCallback (
> 
> +  IN  EFI_HANDLE                              DispatchHandle
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Disable BIOSWE bit to protect BIOS
> 
> +  //
> 
> +  PciSegmentAnd8 ((UINTN) (mLpcRegBase + R_LPC_CFG_BC), (UINT8)
> ~B_LPC_CFG_BC_WPD);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Entry point for Pch Bios Write Protect driver.
> 
> +
> 
> +  @param[in] ImageHandle          Image handle of this driver.
> 
> +  @param[in] SystemTable          Global system service table.
> 
> +
> 
> +  @retval EFI_SUCCESS             Initialization complete.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchBiosWriteProtect (
> 
> +  IN EFI_HANDLE            ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE      *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS              Status;
> 
> +  EFI_HANDLE              Handle;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InstallPchBiosWriteProtect()\n"));
> 
> +
> 
> +  if (mPchConfigHob->LockDown.BiosLock != TRUE) {
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  mLpcRegBase = LpcPciCfgBase ();
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Installing BIOS Write Protect SMI handler\n"));
> 
> +  //
> 
> +  // Get the PCH TCO SMM dispatch protocol
> 
> +  //
> 
> +  mPchTcoSmiDispatchProtocol = NULL;
> 
> +  Status = gSmst->SmmLocateProtocol (&gPchTcoSmiDispatchProtocolGuid,
> NULL, (VOID **) &mPchTcoSmiDispatchProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  //
> 
> +  // Always register an SPI BiosWp callback function to handle TCO BIOSWR
> SMI
> 
> +  // NOTE: No matter the BIOS resides behind SPI or not, it needs to handle
> the SPI BIOS WP SMI
> 
> +  //       to avoid SMI deadloop on SPI WPD write.
> 
> +  //
> 
> +  Handle = NULL;
> 
> +  Status = mPchTcoSmiDispatchProtocol->SpiBiosWpRegister (
> 
> +                                         mPchTcoSmiDispatchProtocol,
> 
> +                                         PchSpiBiosWpCallback,
> 
> +                                         &Handle
> 
> +                                         );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Always register an LPC/eSPI BiosWp callback function to handle TCO
> BIOSWR SMI
> 
> +  // NOTE: No matter the BIOS resides behind LPC/eSPI or not, it needs to
> handle the BIOS WP SMI
> 
> +  //       to avoid SMI deadloop on LPC/eSPI WPD write.
> 
> +  //
> 
> +  if (IsEspiEnabled ()) {
> 
> +    //
> 
> +    // Get the PCH ESPI SMM dispatch protocol
> 
> +    //
> 
> +    mEspiSmmDispatchProtocol = NULL;
> 
> +    Status = gSmst->SmmLocateProtocol
> (&gPchEspiSmiDispatchProtocolGuid, NULL, (VOID **)
> &mEspiSmmDispatchProtocol);
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +    //
> 
> +    // Register an ESpiBiosWp callback function to handle BIOSWR SMI
> 
> +    //
> 
> +    Handle = NULL;
> 
> +    Status = mEspiSmmDispatchProtocol->BiosWrProtectRegister (
> 
> +                                         mEspiSmmDispatchProtocol,
> 
> +                                         PchLpcBiosWpCallback,
> 
> +                                         &Handle
> 
> +                                         );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +  } else {
> 
> +    //
> 
> +    // Register an LPC BiosWp callback function to handle TCO BIOSWR SMI
> 
> +    //
> 
> +    Handle = NULL;
> 
> +    Status = mPchTcoSmiDispatchProtocol->LpcBiosWpRegister (
> 
> +                                           mPchTcoSmiDispatchProtocol,
> 
> +                                           PchLpcBiosWpCallback,
> 
> +                                           &Handle
> 
> +                                           );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
> new file mode 100644
> index 0000000000..f3d11ab204
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchHdaSxSmm.c
> @@ -0,0 +1,33 @@
> +/** @file
> 
> +  PCH HD Audio Sx handler implementation.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include "PchInitSmm.h"
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/HdaRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT64  mHdaPciBase;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN
> mHdaCodecSxWakeCapability = FALSE;
> 
> +
> 
> +/**
> 
> +  Updates Codec Sx Wake Capability setting: disabled/enabled
> 
> +**/
> 
> +VOID
> 
> +UpdateHdaCodecSxWakeCapabilitySetting (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  mHdaPciBase = HdaPciCfgBase ();
> 
> +
> 
> +  if ((mPchConfigHob->HdAudio.CodecSxWakeCapability == FALSE) ||
> 
> +      (PciSegmentRead16 (mHdaPciBase + PCI_VENDOR_ID_OFFSET) ==
> 0xFFFF)) {
> 
> +    mHdaCodecSxWakeCapability = FALSE;
> 
> +  } else {
> 
> +    mHdaCodecSxWakeCapability = TRUE;
> 
> +  }
> 
> +}
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c
> new file mode 100644
> index 0000000000..9c2475e3a1
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.c
> @@ -0,0 +1,285 @@
> +/** @file
> 
> +  PCH Init Smm module for PCH specific SMI handlers.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchInitSmm.h"
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/UsbRegs.h>
> 
> +#include <Register/SmbusRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA
> *mPchNvsArea;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16
> mAcpiBaseAddr;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED FIVR_EXT_RAIL_CONFIG
> mFivrExtVnnRailSxConfig;
> 
> +
> 
> +//
> 
> +// NOTE: The module variables of policy here are only valid in post time, but
> not runtime time.
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_CONFIG_HOB
> *mPchConfigHob;
> 
> +
> 
> +//
> 
> +// The reserved MMIO range to be used in Sx handler
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_PHYSICAL_ADDRESS
> mResvMmioBaseAddr;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINTN
> mResvMmioSize;
> 
> +
> 
> +/**
> 
> +  SMBUS Sx entry SMI handler.
> 
> +**/
> 
> +VOID
> 
> +SmbusSxCallback (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64                      SmbusRegBase;
> 
> +  UINT16                      SmbusIoBase;
> 
> +
> 
> +  SmbusRegBase = SmbusPciCfgBase ();
> 
> +
> 
> +  if (PciSegmentRead32 (SmbusRegBase) == 0xFFFFFFFF) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  SmbusIoBase = PciSegmentRead16 (SmbusRegBase +
> R_SMBUS_CFG_BASE) & B_SMBUS_CFG_BASE_BAR;
> 
> +  if (SmbusIoBase == 0) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  PciSegmentOr8 (SmbusRegBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_IO_SPACE);
> 
> +  //
> 
> +  // Clear SMBUS status and SMB_WAK_STS of GPE0
> 
> +  //
> 
> +  IoWrite8 (SmbusIoBase + R_SMBUS_IO_HSTS,
> B_SMBUS_IO_SMBALERT_STS);
> 
> +  IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96,
> B_ACPI_IO_GPE0_STS_127_96_SMB_WAK);
> 
> +}
> 
> +
> 
> +/*
> 
> +  PCH xHCI Sx entry SMI handler
> 
> +*/
> 
> +VOID
> 
> +PchXhciSxCallback (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINTN      XhciPciBase;
> 
> +
> 
> +  XhciPciBase = PchXhciPciCfgBase ();
> 
> +
> 
> +  //
> 
> +  // Safety check for xHCI existense
> 
> +  //
> 
> +  if (PciSegmentRead32 (XhciPciBase) == 0xFFFFFFFF) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If xHCI is in D0 that means OS didn't put it to D3 during Sx entry i.e. USB
> kernel debug is enabled.
> 
> +  // Unless it is put manually to D3, USB wake functionality will not work.
> 
> +  //
> 
> +  if ((PciSegmentRead8 (XhciPciBase + R_XHCI_CFG_PWR_CNTL_STS) &
> V_XHCI_CFG_PWR_CNTL_STS_PWR_STS_D3) == 0) {
> 
> +    //
> 
> +    // Put device to D3 to enable wake functionality for USB devices
> 
> +    //
> 
> +    PciSegmentOr8 (XhciPciBase + R_XHCI_CFG_PWR_CNTL_STS,
> (UINT8)(B_XHCI_CFG_PWR_CNTL_STS_PWR_STS));
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Cache PCH FIVR policy.
> 
> +**/
> 
> +VOID
> 
> +UpdatePchFivrSettings (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  CopyMem (
> 
> +    &mFivrExtVnnRailSxConfig,
> 
> +    &mPchConfigHob->Fivr.ExtVnnRailSx,
> 
> +    sizeof (mFivrExtVnnRailSxConfig)
> 
> +    );
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCH Sx entry SMI handler.
> 
> +
> 
> +  @param[in]     Handle          Handle of the callback
> 
> +  @param[in]     Context         The dispatch context
> 
> +  @param[in,out] CommBuffer      A pointer to a collection of data in
> memory that will
> 
> +                                 be conveyed from a non-SMM environment into an SMM
> environment.
> 
> +  @param[in,out] CommBufferSize  The size of the CommBuffer.
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSxHandler (
> 
> +  IN  EFI_HANDLE                   Handle,
> 
> +  IN CONST VOID                    *Context OPTIONAL,
> 
> +  IN OUT VOID                      *CommBuffer OPTIONAL,
> 
> +  IN OUT UINTN                     *CommBufferSize OPTIONAL
> 
> +  )
> 
> +{
> 
> +  PchLanSxCallback ();
> 
> +  PchXhciSxCallback ();
> 
> +
> 
> +  SmbusSxCallback ();
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initialize PCH Sx entry SMI handler.
> 
> +
> 
> +  @param[in] ImageHandle - Handle for the image of this driver
> 
> +**/
> 
> +VOID
> 
> +InitializeSxHandler (
> 
> +  IN EFI_HANDLE        ImageHandle
> 
> +  )
> 
> +{
> 
> +  EFI_SMM_SX_REGISTER_CONTEXT               SxDispatchContext;
> 
> +  EFI_HANDLE                                SxDispatchHandle;
> 
> +  EFI_SLEEP_TYPE                            SxType;
> 
> +  EFI_STATUS                                Status;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializeSxHandler() Start\n"));
> 
> +
> 
> +  //
> 
> +  // Register the callback for S3/S4/S5 entry
> 
> +  //
> 
> +  SxDispatchContext.Phase = SxEntry;
> 
> +  for (SxType = SxS3; SxType <= SxS5; SxType++) {
> 
> +    SxDispatchContext.Type  = SxType;
> 
> +    Status = mSxDispatch->Register (
> 
> +                            mSxDispatch,
> 
> +                            PchSxHandler,
> 
> +                            &SxDispatchContext,
> 
> +                            &SxDispatchHandle
> 
> +                            );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializeSxHandler() End\n"));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Allocates reserved MMIO for Sx SMI handler use.
> 
> +**/
> 
> +VOID
> 
> +AllocateReservedMmio (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  mResvMmioBaseAddr = PcdGet32 (PcdSiliconInitTempMemBaseAddr);
> 
> +  mResvMmioSize     = PcdGet32 (PcdSiliconInitTempMemSize);
> 
> +  DEBUG ((DEBUG_INFO, "mResvMmioBaseAddr %x, mResvMmioSize
> %x\n", mResvMmioBaseAddr, mResvMmioSize));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initializes the PCH SMM handler for for PCIE hot plug support
> 
> +  <b>PchInit SMM Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +      The PchInitSmm module is a SMM driver that initializes the Intel Platform
> Controller Hub
> 
> +      SMM requirements and services. It consumes the PCH_POLICY_HOB and
> SI_POLICY_HOB for expected
> 
> +      configurations per policy.
> 
> +
> 
> +  - <b>Details</b>\n
> 
> +    This module provides SMI handlers to services PCIE HotPlug SMI,
> LinkActive SMI, and LinkEq SMI.
> 
> +    And also provides port 0x61 emulation support, registers BIOS WP handler
> to process BIOSWP status,
> 
> +    and registers SPI Async SMI handler to handler SPI Async SMI.
> 
> +    This module also registers Sx SMI callback function to detail with GPIO Sx
> Isolation and LAN requirement.
> 
> +
> 
> +  - @pre
> 
> +    - PCH PCR base address configured
> 
> +    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
> 
> +      - This is to ensure that PCI MMIO and IO resource has been prepared
> and available for this driver to allocate.
> 
> +    - EFI_SMM_BASE2_PROTOCOL
> 
> +    - EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_SX_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_CPU_PROTOCOL
> 
> +    - @link _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL @endlink
> 
> +    - @link _PCH_SMI_DISPATCH_PROTOCOL
> PCH_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_PCIE_SMI_DISPATCH_PROTOCOL
> PCH_PCIE_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_TCO_SMI_DISPATCH_PROTOCOL
> PCH_TCO_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_ESPI_SMI_DISPATCH_PROTOCOL
> PCH_ESPI_SMI_DISPATCH_PROTOCOL @endlink
> 
> +
> 
> +  - <b>References</b>\n
> 
> +    - @link _PCH_POLICY PCH_POLICY_HOB @endlink.
> 
> +    - @link _SI_POLICY_STRUCT SI_POLICY_HOB @endlink.
> 
> +
> 
> +  - <b>Integration Checklists</b>\n
> 
> +    - Verify prerequisites are met. Porting Recommendations.
> 
> +    - No modification of this module should be necessary
> 
> +    - Any modification of this module should follow the PCH BIOS
> Specification and EDS
> 
> +
> 
> +  @param[in] ImageHandle - Handle for the image of this driver
> 
> +  @param[in] SystemTable - Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS    - PCH SMM handler was installed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchInitSmmEntryPoint (
> 
> +  IN EFI_HANDLE        ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                                Status;
> 
> +  PCH_NVS_AREA_PROTOCOL                     *PchNvsAreaProtocol;
> 
> +  EFI_PEI_HOB_POINTERS                      HobPtr;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchInitSmmEntryPoint()\n"));
> 
> +
> 
> +  Status = gSmst->SmmLocateProtocol (
> 
> +                    &gEfiSmmIoTrapDispatch2ProtocolGuid,
> 
> +                    NULL,
> 
> +                    (VOID **) &mPchIoTrap
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = gSmst->SmmLocateProtocol (
> 
> +                    &gEfiSmmSxDispatch2ProtocolGuid,
> 
> +                    NULL,
> 
> +                    (VOID**) &mSxDispatch
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID
> **) &PchNvsAreaProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  mPchNvsArea = PchNvsAreaProtocol->Area;
> 
> +
> 
> +  //
> 
> +  // Get PCH Data HOB.
> 
> +  //
> 
> +  HobPtr.Guid   = GetFirstGuidHob (&gPchConfigHobGuid);
> 
> +  ASSERT (HobPtr.Guid != NULL);
> 
> +  mPchConfigHob = (PCH_CONFIG_HOB *) GET_GUID_HOB_DATA
> (HobPtr.Guid);
> 
> +
> 
> +  mAcpiBaseAddr = PmcGetAcpiBase ();
> 
> +
> 
> +  AllocateReservedMmio ();
> 
> +
> 
> +  InitializeSxHandler (ImageHandle);
> 
> +
> 
> +  Status = InitializePchPcieSmm (ImageHandle, SystemTable);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = InstallPchBiosWriteProtect (ImageHandle, SystemTable);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = InstallPchSpiAsyncSmiHandler ();
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  UpdateHdaCodecSxWakeCapabilitySetting ();
> 
> +
> 
> +  UpdatePchFivrSettings ();
> 
> +
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h
> new file mode 100644
> index 0000000000..c2a09acd11
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.h
> @@ -0,0 +1,254 @@
> +/** @file
> 
> +  Header file for PCH Init SMM Handler
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_INIT_SMM_H_
> 
> +#define _PCH_INIT_SMM_H_
> 
> +
> 
> +#include <PiDxe.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/UefiDriverEntryPoint.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/UefiRuntimeServicesTableLib.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <Library/DxeServicesTableLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Protocol/SmmSxDispatch2.h>
> 
> +#include <Protocol/SmmIoTrapDispatch2.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Protocol/SmmCpu.h>
> 
> +#include <Library/TimerLib.h>
> 
> +
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/SataLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/GpioNativeLib.h>
> 
> +#include <Library/EspiLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/ConfigBlockLib.h>
> 
> +#include <Library/PciExpressHelpersLib.h>
> 
> +#include <Protocol/PchPcieSmiDispatch.h>
> 
> +#include <Protocol/PchTcoSmiDispatch.h>
> 
> +#include <Protocol/PchSmiDispatch.h>
> 
> +#include <Protocol/PchEspiSmiDispatch.h>
> 
> +#include <Protocol/PchSmmIoTrapControl.h>
> 
> +#include <Protocol/PchNvsArea.h>
> 
> +#include <Protocol/PcieIoTrap.h>
> 
> +#include <SiConfigHob.h>
> 
> +#include <PchConfigHob.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +
> 
> +extern EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
> 
> +extern EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
> 
> +
> 
> +extern PCH_NVS_AREA                              *mPchNvsArea;
> 
> +extern UINT16                                    mAcpiBaseAddr;
> 
> +
> 
> +extern EFI_PHYSICAL_ADDRESS                      mResvMmioBaseAddr;
> 
> +extern UINTN                                     mResvMmioSize;
> 
> +
> 
> +//
> 
> +// NOTE: The module variables of policy here are only valid in post time, but
> not runtime time.
> 
> +//
> 
> +extern PCH_CONFIG_HOB                            *mPchConfigHob;
> 
> +extern SI_CONFIG_HOB_DATA                        *mSiConfigHobData;
> 
> +
> 
> +/**
> 
> +  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
> 
> +
> 
> +  @param[in] ImageHandle          The image handle of this module
> 
> +  @param[in] SystemTable          The EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InitializePchPcieSmm (
> 
> +  IN      EFI_HANDLE            ImageHandle,
> 
> +  IN      EFI_SYSTEM_TABLE      *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Program Common Clock and ASPM of Downstream Devices
> 
> +
> 
> +  @param[in] PortIndex                  Pcie Root Port Number
> 
> +  @param[in] RpDevice                   Pcie Root Pci Device Number
> 
> +  @param[in] RpFunction                 Pcie Root Pci Function Number
> 
> +
> 
> +  @retval EFI_SUCCESS                   Root port complete successfully
> 
> +  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchPcieSmi (
> 
> +  IN  UINT8                             PortIndex,
> 
> +  IN  UINT8                             RpDevice,
> 
> +  IN  UINT8                             RpFunction
> 
> +  );
> 
> +
> 
> +/**
> 
> +  PCIE Hotplug SMI call back function for each Root port
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieSmiRpHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  );
> 
> +
> 
> +/**
> 
> +  PCIE Link Active State Change Hotplug SMI call back function for all Root
> ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieLinkActiveStateChange (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  );
> 
> +
> 
> +/**
> 
> +  PCIE Link Equalization Request SMI call back function for all Root ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieLinkEqHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  );
> 
> +
> 
> +/**
> 
> +  An IoTrap callback to config PCIE power management settings
> 
> +
> 
> +  @param[in] DispatchHandle  - The handle of this callback, obtained when
> registering
> 
> +  @param[in] DispatchContext - Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieIoTrapSmiCallback (
> 
> +  IN     EFI_HANDLE                     DispatchHandle,
> 
> +  IN     EFI_SMM_IO_TRAP_CONTEXT        *CallbackContext,
> 
> +  IN OUT VOID                           *CommBuffer,
> 
> +  IN OUT UINTN                          *CommBufferSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Initializes the PCH SMM handler for PCH save and restore
> 
> +
> 
> +  @param[in] ImageHandle - Handle for the image of this driver
> 
> +  @param[in] SystemTable - Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS    - PCH SMM handler was installed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchInitLateSmm (
> 
> +  IN      EFI_HANDLE            ImageHandle,
> 
> +  IN      EFI_SYSTEM_TABLE      *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Initialize PCH Sx entry SMI handler.
> 
> +
> 
> +  @param[in] ImageHandle - Handle for the image of this driver
> 
> +**/
> 
> +VOID
> 
> +InitializeSxHandler (
> 
> +  IN EFI_HANDLE        ImageHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  PCH Sx entry SMI handler.
> 
> +
> 
> +  @param[in]     Handle          Handle of the callback
> 
> +  @param[in]     Context         The dispatch context
> 
> +  @param[in,out] CommBuffer      A pointer to a collection of data in
> memory that will
> 
> +                                 be conveyed from a non-SMM environment into an SMM
> environment.
> 
> +  @param[in,out] CommBufferSize  The size of the CommBuffer.
> 
> +
> 
> +  @retval EFI_SUCCESS
> 
> +**/
> 
> +
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSxHandler (
> 
> +  IN  EFI_HANDLE                   Handle,
> 
> +  IN CONST VOID                    *Context OPTIONAL,
> 
> +  IN OUT VOID                      *CommBuffer OPTIONAL,
> 
> +  IN OUT UINTN                     *CommBufferSize OPTIONAL
> 
> +  );
> 
> +
> 
> +/**
> 
> +  GbE Sx entry handler
> 
> +**/
> 
> +VOID
> 
> +PchLanSxCallback (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Updates Codec Sx Wake Capability setting: disabled/enabled
> 
> +**/
> 
> +VOID
> 
> +UpdateHdaCodecSxWakeCapabilitySetting (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register dispatch function to handle GPIO pads Sx isolation
> 
> +**/
> 
> +VOID
> 
> +InitializeGpioSxIsolationSmm (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Entry point for Pch Bios Write Protect driver.
> 
> +
> 
> +  @param[in] ImageHandle          Image handle of this driver.
> 
> +  @param[in] SystemTable          Global system service table.
> 
> +
> 
> +  @retval EFI_SUCCESS             Initialization complete.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchBiosWriteProtect (
> 
> +  IN EFI_HANDLE            ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE      *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This fuction install SPI ASYNC SMI handler.
> 
> +
> 
> +  @retval EFI_SUCCESS             Initialization complete.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchSpiAsyncSmiHandler (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +
> 
> +
> 
> +
> 
> +#endif
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf
> new file mode 100644
> index 0000000000..aaf36a7b2a
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchInitSmm.inf
> @@ -0,0 +1,110 @@
> +## @file
> 
> +# Component description file for PchInitSmm driver
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PchInitSmm
> 
> +FILE_GUID = D7B10D4E-67E6-4C74-83E9-F9AF0ACC33CC
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_SMM_DRIVER
> 
> +PI_SPECIFICATION_VERSION = 1.10
> 
> +ENTRY_POINT = PchInitSmmEntryPoint
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64
> 
> +#
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiBootServicesTableLib
> 
> +UefiDriverEntryPoint
> 
> +DxeServicesTableLib
> 
> +IoLib
> 
> +DebugLib
> 
> +BaseLib
> 
> +BaseMemoryLib
> 
> +S3BootScriptLib
> 
> +PciExpressHelpersLib
> 
> +SmmServicesTableLib
> 
> +PciSegmentLib
> 
> +HobLib
> 
> +GpioLib
> 
> +GpioPrivateLib
> 
> +ReportStatusCodeLib
> 
> +DevicePathLib
> 
> +PmcLib
> 
> +PchPcieRpLib
> 
> +PchInfoLib
> 
> +EspiLib
> 
> +TimerLib
> 
> +ConfigBlockLib
> 
> +PmcPrivateLib
> 
> +SataLib
> 
> +GbeLib
> 
> +GbeMdiLib
> 
> +SpiAccessPrivateLib
> 
> +PchPciBdfLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemBaseAddr
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempMemSize
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchInitSmm.c
> 
> +PchPcieSmm.c
> 
> +GbeSxSmm.c
> 
> +PchInitSmm.h
> 
> +PchBiosWriteProtect.c
> 
> +PchSpiAsync.c
> 
> +PchHdaSxSmm.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gEfiSmmIoTrapDispatch2ProtocolGuid ## CONSUMES
> 
> +gEfiSmmSxDispatch2ProtocolGuid ## CONSUMES
> 
> +gPchSmmIoTrapControlGuid ## CONSUMES
> 
> +gEfiSmmCpuProtocolGuid ## CONSUMES
> 
> +gPchNvsAreaProtocolGuid ## CONSUMES
> 
> +gPchPcieSmiDispatchProtocolGuid ## CONSUMES
> 
> +gPchTcoSmiDispatchProtocolGuid ## CONSUMES
> 
> +gPchSmiDispatchProtocolGuid ## CONSUMES
> 
> +gPchEspiSmiDispatchProtocolGuid ## CONSUMES
> 
> +gPchPcieIoTrapProtocolGuid ## PRODUCES
> 
> +gPchPolicyProtocolGuid ##CONSUMES
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gSiConfigHobGuid             ## CONSUMES
> 
> +gPchConfigHobGuid            ## CONSUMES
> 
> +gPchDeviceTableHobGuid
> 
> +gPchPcieRpDxeConfigGuid         ## CONSUMES
> 
> +
> 
> +
> 
> +[Depex]
> 
> +gEfiSmmIoTrapDispatch2ProtocolGuid AND
> 
> +gEfiSmmSxDispatch2ProtocolGuid AND
> 
> +gPchSmmIoTrapControlGuid AND
> 
> +gPchPcieSmiDispatchProtocolGuid AND
> 
> +gPchTcoSmiDispatchProtocolGuid AND
> 
> +gEfiSmmCpuProtocolGuid AND
> 
> +gPchNvsAreaProtocolGuid AND
> 
> +gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure
> that PCI MMIO resource has been prepared and available for this driver to
> allocate.
> 
> +gEfiSmmBase2ProtocolGuid AND # This is for SmmServicesTableLib
> 
> +gPchPolicyProtocolGuid
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c
> new file mode 100644
> index 0000000000..e885a342a7
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchPcieSmm.c
> @@ -0,0 +1,451 @@
> +/** @file
> 
> +  PCH Pcie SMM Driver Entry
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchInitSmm.h"
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Protocol/PchPolicy.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE
> *mDevAspmOverride;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT32
> mNumOfDevAspmOverride;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mPchBusNumber;
> 
> +//
> 
> +// @note:
> 
> +// These temp bus numbers cannot be used in runtime (hot-plug).
> 
> +// These can be used only during boot.
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mTempRootPortBusNumMin;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mTempRootPortBusNumMax;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_ROOT_PORT_CONFIG
> mPcieRootPortConfig[PCH_MAX_PCIE_ROOT_PORTS];
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN
> mPchPciePmTrapExecuted = FALSE;
> 
> +
> 
> +extern EFI_GUID gPchDeviceTableHobGuid;
> 
> +
> 
> +/**
> 
> +  Program Common Clock and ASPM of Downstream Devices
> 
> +
> 
> +  @param[in] PortIndex                  Pcie Root Port Number
> 
> +  @param[in] RpDevice                   Pcie Root Pci Device Number
> 
> +  @param[in] RpFunction                 Pcie Root Pci Function Number
> 
> +
> 
> +  @retval EFI_SUCCESS                   Root port complete successfully
> 
> +  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchPcieSmi (
> 
> +  IN  UINT8                             PortIndex,
> 
> +  IN  UINT8                             RpDevice,
> 
> +  IN  UINT8                             RpFunction
> 
> +  )
> 
> +{
> 
> +  UINT8                 SecBus;
> 
> +  UINT8                 SubBus;
> 
> +  UINT64                RpBase;
> 
> +  UINT64                EpBase;
> 
> +  UINT8                 EpPcieCapPtr;
> 
> +  UINT8                 EpMaxSpeed;
> 
> +  BOOLEAN               DownstreamDevicePresent;
> 
> +  UINT32                Timeout;
> 
> +
> 
> +  RpBase   = PCI_SEGMENT_LIB_ADDRESS (
> 
> +               DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +               mPchBusNumber,
> 
> +               (UINT32) RpDevice,
> 
> +               (UINT32) RpFunction,
> 
> +               0
> 
> +               );
> 
> +
> 
> +  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +  //
> 
> +  // Check presence detect state. Here the endpoint must be detected using
> PDS rather than
> 
> +  // the usual LinkActive check, because PDS changes immediately and LA
> takes a few milliseconds to stabilize
> 
> +  //
> 
> +  DownstreamDevicePresent = !!(PciSegmentRead16 (RpBase +
> R_PCH_PCIE_CFG_SLSTS) & B_PCIE_SLSTS_PDS);
> 
> +
> 
> +  if (DownstreamDevicePresent) {
> 
> +    ///
> 
> +    /// Make sure the link is active before trying to talk to device behind it
> 
> +    /// Wait up to 100ms, according to PCIE spec chapter 6.7.3.3
> 
> +    ///
> 
> +    Timeout = 100 * 1000;
> 
> +    while ((PciSegmentRead16 (RpBase + R_PCH_PCIE_CFG_LSTS) &
> B_PCIE_LSTS_LA) == 0 ) {
> 
> +      MicroSecondDelay (10);
> 
> +      Timeout-=10;
> 
> +      if (Timeout == 0) {
> 
> +        return EFI_NOT_FOUND;
> 
> +      }
> 
> +    }
> 
> +    SecBus  = PciSegmentRead8 (RpBase +
> PCI_BRIDGE_SECONDARY_BUS_REGISTER_OFFSET);
> 
> +    SubBus  = PciSegmentRead8 (RpBase +
> PCI_BRIDGE_SUBORDINATE_BUS_REGISTER_OFFSET);
> 
> +    ASSERT (SecBus != 0 && SubBus != 0);
> 
> +    RootportDownstreamConfiguration (
> 
> +      DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +      DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +      RpDevice,
> 
> +      RpFunction,
> 
> +      mTempRootPortBusNumMin,
> 
> +      mTempRootPortBusNumMax,
> 
> +      EnumPchPcie
> 
> +      );
> 
> +    RootportDownstreamPmConfiguration (
> 
> +      DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +      DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +      RpDevice,
> 
> +      RpFunction,
> 
> +      mTempRootPortBusNumMin,
> 
> +      mTempRootPortBusNumMax,
> 
> +      &mPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
> 
> +      mNumOfDevAspmOverride,
> 
> +      mDevAspmOverride
> 
> +    );
> 
> +    //
> 
> +    // Perform Equalization
> 
> +    //
> 
> +    EpBase = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH, SecBus, 0, 0, 0);
> 
> +    EpPcieCapPtr = PcieFindCapId (DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> SecBus, 0, 0, EFI_PCI_CAPABILITY_ID_PCIEXP);
> 
> +    EpMaxSpeed = PciSegmentRead8 (EpBase + EpPcieCapPtr +
> R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_MLS;
> 
> +    if (EpMaxSpeed >= 3) {
> 
> +      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_EX_LCTL3,
> B_PCIE_EX_LCTL3_PE);
> 
> +      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_LCTL, B_PCIE_LCTL_RL);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Hotplug SMI call back function for each Root port
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieSmiRpHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  PchPcieSmi (RpContext->RpIndex, RpContext->DevNum, RpContext-
> >FuncNum);
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Link Active State Change Hotplug SMI call back function for all Root
> ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieLinkActiveStateChange (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Link Equalization Request SMI call back function for all Root ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieLinkEqHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  ///
> 
> +  /// From PCI Express specification, the PCIe device can request for Link
> Equalization. When the
> 
> +  /// Link Equalization is requested by the device, an SMI will be generated
> by PCIe RP when
> 
> +  /// enabled and the SMI subroutine would invoke the Software
> Preset/Coefficient Search
> 
> +  /// software to re-equalize the link.
> 
> +  ///
> 
> +
> 
> +  return;
> 
> +
> 
> +}
> 
> +
> 
> +/**
> 
> +  An IoTrap callback to config PCIE power management settings
> 
> +**/
> 
> +VOID
> 
> +PchPciePmIoTrapSmiCallback (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                                    PortIndex;
> 
> +  UINT64                                    RpBase;
> 
> +  UINT8                                     MaxPciePortNum;
> 
> +
> 
> +  MaxPciePortNum                   = GetPchMaxPciePortNum ();
> 
> +
> 
> +  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
> 
> +    RpBase = PchPcieRpPciCfgBase (PortIndex);
> 
> +
> 
> +    if (PciSegmentRead16 (RpBase) != 0xFFFF) {
> 
> +      RootportDownstreamPmConfiguration (
> 
> +        DEFAULT_PCI_SEGMENT_NUMBER_PCH,
> 
> +        DEFAULT_PCI_BUS_NUMBER_PCH,
> 
> +        PchPcieRpDevNumber (PortIndex),
> 
> +        PchPcieRpFuncNumber (PortIndex),
> 
> +        mTempRootPortBusNumMin,
> 
> +        mTempRootPortBusNumMax,
> 
> +        &mPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
> 
> +        mNumOfDevAspmOverride,
> 
> +        mDevAspmOverride
> 
> +      );
> 
> +
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  An IoTrap callback to config PCIE power management settings
> 
> +
> 
> +  @param[in] DispatchHandle  - The handle of this callback, obtained when
> registering
> 
> +  @param[in] DispatchContext - Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchPcieIoTrapSmiCallback (
> 
> +  IN  EFI_HANDLE                            DispatchHandle,
> 
> +  IN  EFI_SMM_IO_TRAP_CONTEXT                *CallbackContext,
> 
> +  IN OUT VOID                               *CommBuffer,
> 
> +  IN OUT UINTN                              *CommBufferSize
> 
> +  )
> 
> +{
> 
> +  if (CallbackContext->WriteData == PchPciePmTrap) {
> 
> +    if (mPchPciePmTrapExecuted == FALSE) {
> 
> +      PchPciePmIoTrapSmiCallback ();
> 
> +      mPchPciePmTrapExecuted = TRUE;
> 
> +    }
> 
> +  } else {
> 
> +    ASSERT_EFI_ERROR (EFI_INVALID_PARAMETER);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clear the Io trap executed flag before enter S3
> 
> +
> 
> +  @param[in] Handle    Handle of the callback
> 
> +  @param[in] Context   The dispatch context
> 
> +
> 
> +  @retval EFI_SUCCESS  PCH register saved
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPcieS3EntryCallBack (
> 
> +  IN  EFI_HANDLE                        Handle,
> 
> +  IN CONST VOID                    *Context OPTIONAL,
> 
> +  IN OUT VOID                      *CommBuffer OPTIONAL,
> 
> +  IN OUT UINTN                     *CommBufferSize OPTIONAL
> 
> +  )
> 
> +{
> 
> +  mPchPciePmTrapExecuted = FALSE;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +/**
> 
> +  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
> 
> +
> 
> +  @param[in] ImageHandle          The image handle of this module
> 
> +  @param[in] SystemTable          The EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InitializePchPcieSmm (
> 
> +  IN      EFI_HANDLE            ImageHandle,
> 
> +  IN      EFI_SYSTEM_TABLE      *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINT8                                 PortIndex;
> 
> +  UINT8                                 Data8;
> 
> +  UINT32                                Data32Or;
> 
> +  UINT32                                Data32And;
> 
> +  UINT64                                RpBase;
> 
> +  EFI_HANDLE                            PcieHandle;
> 
> +  PCH_PCIE_SMI_DISPATCH_PROTOCOL        *PchPcieSmiDispatchProtocol;
> 
> +  EFI_HANDLE                            PchIoTrapHandle;
> 
> +  EFI_SMM_IO_TRAP_REGISTER_CONTEXT      PchIoTrapContext;
> 
> +  EFI_SMM_SX_REGISTER_CONTEXT           SxDispatchContext;
> 
> +  PCH_PCIE_IOTRAP_PROTOCOL              *PchPcieIoTrapProtocol;
> 
> +  EFI_HANDLE                            SxDispatchHandle;
> 
> +  UINT8                                 MaxPciePortNum;
> 
> +  PCH_POLICY_PROTOCOL                   *PchPolicy;
> 
> +  PCIE_RP_DXE_CONFIG                    *PchPcieRpDxeConfig;
> 
> +  UINTN                                 PcieDeviceTableSize;
> 
> +  PCH_PCIE_DEVICE_OVERRIDE              *DevAspmOverride;
> 
> +  UINTN                                 Count;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializePchPcieSmm () Start\n"));
> 
> +
> 
> +  MaxPciePortNum    = GetPchMaxPciePortNum ();
> 
> +
> 
> +  //
> 
> +  // Locate Pch Pcie Smi Dispatch Protocol
> 
> +  //
> 
> +  Status = gSmst->SmmLocateProtocol (&gPchPcieSmiDispatchProtocolGuid,
> NULL, (VOID**) &PchPcieSmiDispatchProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  mPchBusNumber = DEFAULT_PCI_BUS_NUMBER_PCH;
> 
> +  mTempRootPortBusNumMin = PcdGet8 (PcdSiliconInitTempPciBusMin);
> 
> +  mTempRootPortBusNumMax = PcdGet8 (PcdSiliconInitTempPciBusMax);
> 
> +
> 
> +  ASSERT (sizeof mPcieRootPortConfig == sizeof mPchConfigHob-
> >PcieRp.RootPort);
> 
> +  CopyMem (
> 
> +    mPcieRootPortConfig,
> 
> +    &(mPchConfigHob->PcieRp.RootPort),
> 
> +    sizeof (mPcieRootPortConfig)
> 
> +    );
> 
> +
> 
> +  DevAspmOverride                   = NULL;
> 
> +  mDevAspmOverride                  = NULL;
> 
> +  mNumOfDevAspmOverride             = 0;
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gPchPolicyProtocolGuid, NULL, (VOID **)
> &PchPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = GetConfigBlock ((VOID*) PchPolicy, &gPchPcieRpDxeConfigGuid,
> (VOID*) &PchPcieRpDxeConfig);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DevAspmOverride = PchPcieRpDxeConfig->PcieDeviceOverrideTablePtr;
> 
> +
> 
> +  Count = 0;
> 
> +  if (DevAspmOverride != NULL) {
> 
> +    for (Count = 0; DevAspmOverride[Count].DeviceId != 0; Count++) {}
> 
> +  }
> 
> +
> 
> +  if (Count !=0) {
> 
> +    PcieDeviceTableSize = Count * sizeof (PCH_PCIE_DEVICE_OVERRIDE);
> 
> +    Status = gSmst->SmmAllocatePool (
> 
> +                      EfiRuntimeServicesData,
> 
> +                      PcieDeviceTableSize,
> 
> +                      (VOID **) &mDevAspmOverride
> 
> +                      );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    CopyMem (mDevAspmOverride, DevAspmOverride,
> PcieDeviceTableSize);
> 
> +    mNumOfDevAspmOverride = (UINT32) Count;
> 
> +  }
> 
> +  //
> 
> +  // Throught all PCIE root port function and register the SMI Handler for
> enabled ports.
> 
> +  //
> 
> +  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
> 
> +    RpBase = PchPcieRpPciCfgBase (PortIndex);
> 
> +    //
> 
> +    // Skip the root port function which is not enabled
> 
> +    //
> 
> +    if (PciSegmentRead32 (RpBase) == 0xFFFFFFFF) {
> 
> +      continue;
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Register SMI Handlers for Hot Plug and Link Active State Change
> 
> +    //
> 
> +    Data8 = PciSegmentRead8 (RpBase + R_PCH_PCIE_CFG_SLCAP);
> 
> +    if (Data8 & B_PCIE_SLCAP_HPC) {
> 
> +      PcieHandle = NULL;
> 
> +      Status = PchPcieSmiDispatchProtocol->HotPlugRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             PchPcieSmiRpHandlerFunction,
> 
> +                                             PortIndex,
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      Status = PchPcieSmiDispatchProtocol->LinkActiveRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             PchPcieLinkActiveStateChange,
> 
> +                                             PortIndex,
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      Data32Or  = B_PCH_PCIE_CFG_MPC_HPME;
> 
> +      Data32And = (UINT32) ~B_PCH_PCIE_CFG_MPC_HPME;
> 
> +      PciSegmentOr32 (RpBase + R_PCH_PCIE_CFG_MPC, Data32Or);
> 
> +      S3BootScriptSaveMemReadWrite (
> 
> +        S3BootScriptWidthUint32,
> 
> +        PcdGet64 (PcdSiPciExpressBaseAddress) + RpBase +
> R_PCH_PCIE_CFG_MPC,
> 
> +        &Data32Or,  /// Data to be ORed
> 
> +        &Data32And  /// Data to be ANDed
> 
> +        );
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Register SMI Handler for Link Equalization Request from Gen 3 Devices.
> 
> +    //
> 
> +    Data8 = PciSegmentRead8 (RpBase + R_PCH_PCIE_CFG_LCAP);
> 
> +    if ((Data8 & B_PCIE_LCAP_MLS) == V_PCIE_LCAP_MLS_GEN3) {
> 
> +      Status = PchPcieSmiDispatchProtocol->LinkEqRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             PchPcieLinkEqHandlerFunction,
> 
> +                                             PortIndex,
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  PchIoTrapContext.Type     = WriteTrap;
> 
> +  PchIoTrapContext.Length   = 4;
> 
> +  PchIoTrapContext.Address  = 0;
> 
> +  Status = mPchIoTrap->Register (
> 
> +                         mPchIoTrap,
> 
> +                         (EFI_SMM_HANDLER_ENTRY_POINT2)
> PchPcieIoTrapSmiCallback,
> 
> +                         &PchIoTrapContext,
> 
> +                         &PchIoTrapHandle
> 
> +                         );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Install the PCH Pcie IoTrap protocol
> 
> +  //
> 
> +  (gBS->AllocatePool) (EfiBootServicesData, sizeof
> (PCH_PCIE_IOTRAP_PROTOCOL), (VOID **)&PchPcieIoTrapProtocol);
> 
> +  PchPcieIoTrapProtocol->PcieTrapAddress = PchIoTrapContext.Address;
> 
> +
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gPchPcieIoTrapProtocolGuid,
> 
> +                  PchPcieIoTrapProtocol,
> 
> +                  NULL
> 
> +                  );
> 
> +
> 
> +  //
> 
> +  // Register the callback for S3 entry
> 
> +  //
> 
> +  SxDispatchContext.Type  = SxS3;
> 
> +  SxDispatchContext.Phase = SxEntry;
> 
> +  Status = mSxDispatch->Register (
> 
> +                          mSxDispatch,
> 
> +                          PchPcieS3EntryCallBack,
> 
> +                          &SxDispatchContext,
> 
> +                          &SxDispatchHandle
> 
> +                          );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializePchPcieSmm, IoTrap @ %x () End\n",
> PchIoTrapContext.Address));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c
> new file mode 100644
> index 0000000000..bdae6fe918
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchInit/Smm/PchSpiAsync.c
> @@ -0,0 +1,67 @@
> +/** @file
> 
> +  PCH SPI Async SMI handler.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchInitSmm.h"
> 
> +
> 
> +///
> 
> +/// Global variables
> 
> +///
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMI_DISPATCH_PROTOCOL
> *mPchSmiDispatchProtocol;
> 
> +
> 
> +/**
> 
> +  This hardware SMI handler will be run every time the flash write/earse
> happens.
> 
> +
> 
> +  @param[in] DispatchHandle       Not used
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchSpiAsyncCallback (
> 
> +  IN  EFI_HANDLE                              DispatchHandle
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Dummy SMI handler
> 
> +  //
> 
> +}
> 
> +
> 
> +/**
> 
> +  This fuction install SPI ASYNC SMI handler.
> 
> +
> 
> +  @retval EFI_SUCCESS             Initialization complete.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchSpiAsyncSmiHandler (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS              Status;
> 
> +  EFI_HANDLE              Handle;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InstallPchSpiAsyncSmiHandler()\n"));
> 
> +
> 
> +  ///
> 
> +  /// Get the PCH SMM dispatch protocol
> 
> +  ///
> 
> +  mPchSmiDispatchProtocol = NULL;
> 
> +  Status = gSmst->SmmLocateProtocol (&gPchSmiDispatchProtocolGuid,
> NULL, (VOID **) &mPchSmiDispatchProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Register an SpiAsync callback function
> 
> +  ///
> 
> +  Handle = NULL;
> 
> +  Status = mPchSmiDispatchProtocol->SpiAsyncRegister (
> 
> +                                      mPchSmiDispatchProtocol,
> 
> +                                      PchSpiAsyncCallback,
> 
> +                                      &Handle
> 
> +                                      );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
> new file mode 100644
> index 0000000000..54a1575f2c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.c
> @@ -0,0 +1,1284 @@
> +/** @file
> 
> +  Main implementation source file for the Io Trap SMM driver
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Protocol/PchNvsArea.h>
> 
> +#include <Library/SmiHandlerProfileLib.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchRegsPsth.h>
> 
> +#include <Register/PchDmiRegs.h>
> 
> +
> 
> +#define GENERIC_IOTRAP_SIZE 0x100
> 
> +
> 
> +//
> 
> +// Module global variables
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE
> mDriverImageHandle;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_HANDLE
> mIoTrapHandle;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED IO_TRAP_INSTANCE
> mIoTrapData;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED IO_TRAP_RECORD
> *mIoTrapRecord;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_NVS_AREA
> *mPchNvsArea;
> 
> +
> 
> +
> 
> +static CONST UINT16             mLengthTable[10] = { 1, 2, 3, 4, 8, 16, 32, 64, 128,
> 256 };
> 
> +
> 
> +/**
> 
> +  Helper function that encapsulates IoTrap register access.
> 
> +  IO trap related register updates must be made in 2 registers, IOTRAP and
> DMI source decode.
> 
> +
> 
> +  @param[in] TrapHandlerNum    trap number (0-3)
> 
> +  @param[in] Value             value to be written in both registers
> 
> +  @param[in] SaveToBootscript  if true, this register write will be saved to
> bootscript
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SetIoTrapLowDword (
> 
> +  IN UINT8   TrapHandlerNum,
> 
> +  IN UINT32  Value,
> 
> +  IN BOOLEAN SaveToBootscript
> 
> +  )
> 
> +{
> 
> +  UINT32  BitMask;
> 
> +  UINT32  BitValue;
> 
> +  //
> 
> +  // To provide sequentially consistent programming model for IO trap
> 
> +  // all pending IO cycles must be flushed before enabling and before
> disabling a trap.
> 
> +  // Without this the trap may trigger due to IO cycle issued before the trap
> is enabled or a cycle issued before the trap is disabled might be missed.
> 
> +  // a. Issues a MemRd to PSTH IO Trap Enable bit -> This serves to flush all
> previous IO cycles.
> 
> +  // b. Then only issues a MemWr to PSTH IO Trap Enable == Value
> 
> +  // c. Issues another MemRd to PSTH IO Trap Enable bit -> This serves to
> push the MemWr to PSTH and confirmed that IO Trap is in fact enabled
> 
> +  //
> 
> +  PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
> 
> +  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8,
> Value);
> 
> +  PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8);
> 
> +
> 
> +  PchPcrWrite32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8,
> Value);
> 
> +  //
> 
> +  // Read back DMI IOTRAP register to enforce ordering so DMI write is
> completed before any IO reads
> 
> +  // from other threads which may occur after this point (after SMI exit).
> 
> +  //
> 
> +  PchPcrRead32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8);
> 
> +  if (SaveToBootscript) {
> 
> +    //
> 
> +    // Ignore the value check of PCH_PCR_BOOT_SCRIPT_READ
> 
> +    //
> 
> +    BitMask  = 0;
> 
> +    BitValue = 0;
> 
> +
> 
> +    PCH_PCR_BOOT_SCRIPT_READ (S3BootScriptWidthUint32, PID_PSTH,
> R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, &BitMask, &BitValue);
> 
> +    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_PSTH,
> R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, 1, &Value);
> 
> +    PCH_PCR_BOOT_SCRIPT_READ (S3BootScriptWidthUint32, PID_PSTH,
> R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8, &BitMask, &BitValue);
> 
> +    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_DMI,
> R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8, 1, &Value);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Helper function that encapsulates IoTrap register access.
> 
> +  IO trap related register updates must be made in 2 registers, IOTRAP and
> DMI source decode.
> 
> +
> 
> +  @param[in] TrapHandlerNum    trap number (0-3)
> 
> +  @param[in] Value             value to be written in both registers
> 
> +  @param[in] SaveToBootscript  if true, this register write will be saved to
> bootscript
> 
> +
> 
> +**/
> 
> +VOID
> 
> +SetIoTrapHighDword (
> 
> +  IN UINT8   TrapHandlerNum,
> 
> +  IN UINT32  Value,
> 
> +  IN BOOLEAN SaveToBootscript
> 
> +  )
> 
> +{
> 
> +  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8
> + 4, Value);
> 
> +  PchPcrWrite32 (PID_DMI, R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8 +
> 4, Value);
> 
> +  if (SaveToBootscript) {
> 
> +    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_PSTH,
> R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4, 1, &Value);
> 
> +    PCH_PCR_BOOT_SCRIPT_WRITE (S3BootScriptWidthUint32, PID_DMI,
> R_PCH_DMI_PCR_IOT1 + TrapHandlerNum * 8 + 4, 1, &Value);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear pending IOTRAP status.
> 
> +  If IOTRAP status is pending and IOTRAP is disabled, then BIOS will not find a
> match SMI source
> 
> +  and will not dispatch any SMI handler for it. The pending status will lead to
> SMI storm.
> 
> +  This prevents that IOTRAP gets triggered by pending IO cycles even after
> it's disabled.
> 
> +
> 
> +  @param[in] TrapHandlerNum    trap number (0-3)
> 
> +
> 
> +**/
> 
> +VOID
> 
> +ClearPendingIoTrapStatus (
> 
> +  IN UINT8   TrapHandlerNum
> 
> +  )
> 
> +{
> 
> +  PchPcrWrite32 (PID_PSTH, R_PSTH_PCR_TRPST, (UINT32)(1 <<
> TrapHandlerNum));
> 
> +}
> 
> +
> 
> +/**
> 
> +  IO resources allocated to IO traps need to be reported to OS so that they
> don't get reused.
> 
> +  This function makes IO trap allocation data available to ACPI
> 
> +
> 
> +  @param[in] TrapHandlerNum  trap number (0-3)
> 
> +  @param[in] BaseAddress     address of allocated IO resource
> 
> +  @param[in] Track           TRUE = resource allocated, FALSE = resource freed
> 
> +
> 
> +**/
> 
> +VOID
> 
> +UpdateIoTrapAcpiResources (
> 
> +  IN UINT8                TrapHandlerNum,
> 
> +  IN EFI_PHYSICAL_ADDRESS BaseAddress,
> 
> +  IN BOOLEAN              Track
> 
> +  )
> 
> +{
> 
> +
> 
> +  if (Track == TRUE) {
> 
> +    mPchNvsArea->IoTrapAddress[TrapHandlerNum] = (UINT16)
> BaseAddress;
> 
> +    mPchNvsArea->IoTrapStatus[TrapHandlerNum] = 1;
> 
> +  } else {
> 
> +    mPchNvsArea->IoTrapStatus[TrapHandlerNum] = 0;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get address from IOTRAP low dword.
> 
> +
> 
> +  @param[in] IoTrapRegLowDword    IOTRAP register low dword
> 
> +
> 
> +  @retval                         Address of IOTRAP setting.
> 
> +**/
> 
> +STATIC
> 
> +UINT16
> 
> +AddressFromLowDword (
> 
> +  UINT32  IoTrapRegLowDword
> 
> +  )
> 
> +{
> 
> +  return (UINT16) (IoTrapRegLowDword & B_PSTH_PCR_TRPREG_AD);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get length from IOTRAP low dword.
> 
> +
> 
> +  @param[in] IoTrapRegLowDword    IOTRAP register low dword
> 
> +
> 
> +  @retval                         Length of IOTRAP setting.
> 
> +**/
> 
> +STATIC
> 
> +UINT16
> 
> +LengthFromLowDword (
> 
> +  UINT32  IoTrapRegLowDword
> 
> +  )
> 
> +{
> 
> +  return (UINT16) (((IoTrapRegLowDword >> 16) & 0xFC) + 4);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get ByteEnable from IOTRAP high dword.
> 
> +
> 
> +  @param[in] IoTrapRegHighDword   IOTRAP register high dword
> 
> +
> 
> +  @retval                         ByteEnable of IOTRAP setting.
> 
> +**/
> 
> +STATIC
> 
> +UINT8
> 
> +ByteEnableFromHighDword (
> 
> +  UINT32  IoTrapRegHighDword
> 
> +  )
> 
> +{
> 
> +  return (UINT8) (IoTrapRegHighDword & 0x0F);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get ByteEnableMask from IOTRAP high dword.
> 
> +
> 
> +  @param[in] IoTrapRegHighDword   IOTRAP register high dword
> 
> +
> 
> +  @retval                         ByteEnableMask of IOTRAP setting.
> 
> +**/
> 
> +STATIC
> 
> +UINT8
> 
> +ByteEnableMaskFromHighDword (
> 
> +  UINT32  IoTrapRegHighDword
> 
> +  )
> 
> +{
> 
> +  return (UINT8) ((IoTrapRegHighDword & 0xF0) >> 4);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check the IoTrap register matches the IOTRAP EX content.
> 
> +
> 
> +  @param[in] IoTrapRecord         IOTRAP registration record structure
> 
> +  @param[in] IoTrapRegLowDword    IOTRAP register low dword
> 
> +  @param[in] IoTrapRegHighDword   IOTRAP register high dword
> 
> +
> 
> +  @retval    TRUE                 Content matched
> 
> +             FALSE                Content mismatched
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +IsIoTrapExContentMatched (
> 
> +  IO_TRAP_RECORD  *IoTrapRecord,
> 
> +  UINT32          IoTrapRegLowDword,
> 
> +  UINT32          IoTrapRegHighDword
> 
> +  )
> 
> +{
> 
> +  if ((IoTrapRecord->Context.Address == AddressFromLowDword
> (IoTrapRegLowDword))          &&
> 
> +      (IoTrapRecord->Context.Length == LengthFromLowDword
> (IoTrapRegLowDword))            &&
> 
> +      (IoTrapRecord->Context.ByteEnable == ByteEnableFromHighDword
> (IoTrapRegHighDword))  &&
> 
> +      (IoTrapRecord->Context.ByteEnableMask ==
> ByteEnableMaskFromHighDword (IoTrapRegHighDword)))
> 
> +  {
> 
> +    return TRUE;
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  The helper function for IoTrap callback dispacther
> 
> +
> 
> +  @param[in] TrapHandlerNum  trap number (0-3)
> 
> +**/
> 
> +VOID
> 
> +IoTrapDispatcherHelper (
> 
> +  UINTN                                     TrapHandlerNum
> 
> +  )
> 
> +{
> 
> +  IO_TRAP_RECORD                            *RecordInDb;
> 
> +  LIST_ENTRY                                *LinkInDb;
> 
> +  EFI_SMM_IO_TRAP_REGISTER_CONTEXT          CurrentIoTrapRegisterData;
> 
> +  EFI_SMM_IO_TRAP_CONTEXT                   CurrentIoTrapContextData;
> 
> +  UINT16                                    BaseAddress;
> 
> +  UINT16                                    StartAddress;
> 
> +  UINT16                                    EndAddress;
> 
> +  UINT32                                    Data32;
> 
> +  UINT8                                     ActiveHighByteEnable;
> 
> +  BOOLEAN                                   ReadCycle;
> 
> +  UINT32                                    WriteData;
> 
> +
> 
> +  if (!IsListEmpty
> (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase))) {
> 
> +    Data32 = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPC);
> 
> +    WriteData = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPD);
> 
> +
> 
> +    BaseAddress           = (UINT16) (Data32 & B_PSTH_PCR_TRPC_IOA);
> 
> +    ActiveHighByteEnable  = (UINT8)((Data32 & B_PSTH_PCR_TRPC_AHBE) >>
> 16);
> 
> +    ReadCycle             = (BOOLEAN) ((Data32 & B_PSTH_PCR_TRPC_RW) ==
> B_PSTH_PCR_TRPC_RW);
> 
> +    //
> 
> +    // StartAddress and EndAddress will be equal if it's byte access
> 
> +    //
> 
> +    EndAddress    = (UINT16) (HighBitSet32 ((UINT32)
> (ActiveHighByteEnable))) + BaseAddress;
> 
> +    StartAddress  = (UINT16) (LowBitSet32 ((UINT32)
> (ActiveHighByteEnable))) + BaseAddress;
> 
> +
> 
> +    CurrentIoTrapRegisterData.Type =
> (EFI_SMM_IO_TRAP_DISPATCH_TYPE)ReadCycle;
> 
> +    CurrentIoTrapContextData.WriteData = WriteData;
> 
> +
> 
> +    LinkInDb = GetFirstNode
> (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase));
> 
> +
> 
> +    while (!IsNull
> (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), LinkInDb)) {
> 
> +      RecordInDb = IO_TRAP_RECORD_FROM_LINK (LinkInDb);
> 
> +
> 
> +      //
> 
> +      // If MergeDisable is TRUE, no need to check the address range, dispatch
> the callback function directly.
> 
> +      //
> 
> +      if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable) {
> 
> +        if (RecordInDb->IoTrapCallback != NULL) {
> 
> +          RecordInDb->IoTrapCallback (&RecordInDb->Link,
> &CurrentIoTrapContextData, NULL, NULL);
> 
> +        }
> 
> +        if (RecordInDb->IoTrapExCallback != NULL) {
> 
> +          RecordInDb->IoTrapExCallback (BaseAddress, ActiveHighByteEnable,
> !ReadCycle, WriteData);
> 
> +        }
> 
> +        //
> 
> +        // Expect only one callback available. So break immediately.
> 
> +        //
> 
> +        break;
> 
> +      //
> 
> +      // If MergeDisable is FALSE, check the address range and trap type.
> 
> +      //
> 
> +      } else {
> 
> +        if ((RecordInDb->Context.Address <= StartAddress) &&
> 
> +            (RecordInDb->Context.Address + RecordInDb->Context.Length >
> EndAddress)) {
> 
> +          if ((RecordInDb->Context.Type == IoTrapExTypeReadWrite) ||
> (RecordInDb->Context.Type == (IO_TRAP_EX_DISPATCH_TYPE)
> CurrentIoTrapRegisterData.Type)) {
> 
> +            //
> 
> +            // Pass the IO trap context information
> 
> +            //
> 
> +            RecordInDb->IoTrapCallback (&RecordInDb->Link,
> &CurrentIoTrapContextData, NULL, NULL);
> 
> +          }
> 
> +          //
> 
> +          // Break if the address is match
> 
> +          //
> 
> +          break;
> 
> +        } else {
> 
> +          LinkInDb = GetNextNode
> (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase), &RecordInDb-
> >Link);
> 
> +          if (IsNull (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase),
> LinkInDb)) {
> 
> +            //
> 
> +            // An IO access was trapped that does not have a handler registered.
> 
> +            // This indicates an error condition.
> 
> +            //
> 
> +            ASSERT (FALSE);
> 
> +          }
> 
> +        }
> 
> +      } // end of if else block
> 
> +    } // end of while loop
> 
> +  } // end of if else block
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap dispatcher for IoTrap register 0.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +IoTrapDispatcher0 (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IoTrapDispatcherHelper (0);
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap dispatcher for IoTrap register 1.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +IoTrapDispatcher1 (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IoTrapDispatcherHelper (1);
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap dispatcher for IoTrap register 2.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +IoTrapDispatcher2 (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IoTrapDispatcherHelper (2);
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap dispatcher for IoTrap register 3.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +IoTrapDispatcher3 (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IoTrapDispatcherHelper (3);
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap registratrion helper fucntion.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +  @param[in] IoTrapDispatchFunction     Dispatch function of
> IoTrapDispatch2Protocol.
> 
> +                                        This could be NULL if it's not from
> IoTrapDispatch2Protocol.
> 
> +  @param[in] IoTrapExDispatchFunction   Dispatch function of
> IoTrapExDispatchProtocol.
> 
> +                                        This could be NULL if it's not from
> IoTrapExDispatchProtocol.
> 
> +  @param[in out] Address                The pointer of IO Address.
> 
> +                                        If the input Addres is 0, it will return the address
> assigned
> 
> +                                        by registration to this caller.
> 
> +  @param[in] Length                     Length of IO address range.
> 
> +  @param[in] Type                       Read/Write type of IO trap.
> 
> +  @param[in] ByteEnable                 Bitmap to enable trap for each byte of
> every dword alignment address.
> 
> +  @param[in] ByteEnableMask             ByteEnableMask bitwise to ignore the
> ByteEnable setting.
> 
> +
> 
> +  @retval    EFI_INVALID_PARAMETER      If Type is invalid,
> 
> +                                        If Length is invalid,
> 
> +                                        If Address is invalid,
> 
> +             EFI_ACCESS_DENIED          If the SmmReadyToLock event has been
> triggered,
> 
> +             EFI_OUT_OF_RESOURCES       If run out of IoTrap register resource,
> 
> +                                        If run out of SMM memory pool,
> 
> +             EFI_SUCCESS                IoTrap register successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +IoTrapRegisterHelper (
> 
> +  OUT       EFI_HANDLE                             *DispatchHandle,
> 
> +  IN        EFI_SMM_HANDLER_ENTRY_POINT2           IoTrapDispatchFunction,
> 
> +  IN        IO_TRAP_EX_DISPATCH_CALLBACK           IoTrapExDispatchFunction,
> 
> +  IN OUT    UINT16                                 *Address,
> 
> +  IN        UINT16                                 Length,
> 
> +  IN        IO_TRAP_EX_DISPATCH_TYPE               Type,
> 
> +  IN        UINT8                                  ByteEnable,
> 
> +  IN        UINT8                                  ByteEnableMask
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  EFI_PHYSICAL_ADDRESS  BaseAddress;
> 
> +  UINT32                UsedLength;
> 
> +  UINT8                 TrapHandlerNum;
> 
> +  UINT32                IoTrapRegLowDword;
> 
> +  UINT32                IoTrapRegHighDword;
> 
> +  BOOLEAN               TempMergeDisable;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "IoTrapRegisterHelper\n"));
> 
> +  DEBUG ((DEBUG_INFO, "Address:%x \n", *Address));
> 
> +  DEBUG ((DEBUG_INFO, "Length:%x \n", Length));
> 
> +  DEBUG ((DEBUG_INFO, "Type:%x \n", Type));
> 
> +  DEBUG ((DEBUG_INFO, "ByteEnable:%x \n", ByteEnable));
> 
> +  DEBUG ((DEBUG_INFO, "ByteEnableMask:%x \n", ByteEnableMask));
> 
> +
> 
> +  //
> 
> +  // Return error if the type is invalid
> 
> +  //
> 
> +  if (Type >= IoTrapExTypeMaximum) {
> 
> +    DEBUG ((DEBUG_ERROR, "The Dispatch Type %0X is invalid! \n", Type));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Return error if the Length is invalid
> 
> +  //
> 
> +  if (Length < 1 || Length > GENERIC_IOTRAP_SIZE) {
> 
> +    DEBUG ((DEBUG_ERROR, "The Dispatch Length %0X is invalid! \n",
> Length));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  //
> 
> +  // Return error if the address is invalid
> 
> +  // PCH supports non-aligned address but (Address % 4 + Length) must not
> be more than 4
> 
> +  //
> 
> +  if (((Length & (Length - 1)) != 0) && (Length != 3)) {
> 
> +    DEBUG ((DEBUG_ERROR, "The Dispatch Length is not power of 2 \n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (((Length >= 4) && (*Address & 0x3)) ||
> 
> +      ((Length < 4) && (((*Address & 0x3) + Length) > 4))) {
> 
> +    DEBUG ((DEBUG_ERROR, "PCH does not support Dispatch Address %0X
> and Length %0X combination \n", *Address, Length));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if ((Length >= 4) && ((*Address & (Length - 1)) != 0)) {
> 
> +    DEBUG ((DEBUG_ERROR, "Dispatch Address %0X is not aligned to the
> Length %0X \n", *Address, Length));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  if (*Address) {
> 
> +    TempMergeDisable = TRUE;
> 
> +  }else {
> 
> +    TempMergeDisable = FALSE;
> 
> +  }
> 
> +  //
> 
> +  // Loop through the first IO Trap handler, looking for the suitable handler
> 
> +  //
> 
> +  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM;
> TrapHandlerNum++) {
> 
> +    //
> 
> +    // Get information from Io Trap handler register
> 
> +    //
> 
> +    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8);
> 
> +
> 
> +    //
> 
> +    // Check if the IO Trap handler is not used
> 
> +    //
> 
> +    if (AddressFromLowDword (IoTrapRegLowDword) == 0) {
> 
> +      //
> 
> +      //  Search available IO address and allocate it if the IO address is 0
> 
> +      //
> 
> +      BaseAddress = *Address;
> 
> +      if (BaseAddress == 0) {
> 
> +        //
> 
> +        // Allocate 256 byte range from GCD for common pool usage
> 
> +        //
> 
> +        if ((PcdGet8 (PcdEfiGcdAllocateType) ==
> EfiGcdAllocateMaxAddressSearchBottomUp) || (PcdGet8
> (PcdEfiGcdAllocateType) == EfiGcdAllocateMaxAddressSearchTopDown)) {
> 
> +          BaseAddress = 0xFFFF;
> 
> +        }
> 
> +        Status = gDS->AllocateIoSpace (
> 
> +                        PcdGet8 (PcdEfiGcdAllocateType),
> 
> +                        EfiGcdIoTypeIo,
> 
> +                        8,
> 
> +                        GENERIC_IOTRAP_SIZE,
> 
> +                        &BaseAddress,
> 
> +                        mDriverImageHandle,
> 
> +                        NULL
> 
> +                        );
> 
> +        if (EFI_ERROR (Status)) {
> 
> +          DEBUG ((DEBUG_ERROR, "Can't find any available IO address! \n"));
> 
> +          return EFI_OUT_OF_RESOURCES;
> 
> +        }
> 
> +
> 
> +        *Address   = (UINT16) BaseAddress;
> 
> +        UsedLength = GENERIC_IOTRAP_SIZE;
> 
> +        mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength = Length;
> 
> +        mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource = TRUE;
> 
> +        UpdateIoTrapAcpiResources (TrapHandlerNum, BaseAddress, TRUE);
> 
> +      } else {
> 
> +        BaseAddress &= B_PSTH_PCR_TRPREG_AD;
> 
> +        UsedLength = Length;
> 
> +      }
> 
> +
> 
> +      Status = PchInternalIoTrapSmiRegister (
> 
> +                 mIoTrapData.Entry[TrapHandlerNum].CallbackDispatcher,
> 
> +                 TrapHandlerNum,
> 
> +                 &mIoTrapHandle
> 
> +                 );
> 
> +
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +      mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle = mIoTrapHandle;
> 
> +
> 
> +      //
> 
> +      // Fill in the Length, address and Enable the IO Trap SMI
> 
> +      //
> 
> +      IoTrapRegLowDword = (UINT32) (((UsedLength - 1) & ~(BIT1 + BIT0)) <<
> 16) |
> 
> +        (UINT16) BaseAddress |
> 
> +        B_PSTH_PCR_TRPREG_TSE;
> 
> +
> 
> +      if (UsedLength < 4) {
> 
> +        //
> 
> +        // The 4 bits is the Byte Enable Mask bits to indicate which byte that are
> trapped.
> 
> +        // The input ByteEnable and ByteEnableMask are ignored in this case.
> 
> +        //
> 
> +        IoTrapRegHighDword  = (((1 << UsedLength) - 1) << ((*Address & 0x3) +
> (N_PSTH_PCR_TRPREG_BEM - 32))) |
> 
> +          (UINT32) (Type << N_PSTH_PCR_TRPREG_RWIO);
> 
> +      } else {
> 
> +        //
> 
> +        // Fill in the ByteEnable, ByteEnableMask, and Type of Io Trap register
> 
> +        //
> 
> +        IoTrapRegHighDword  = ((ByteEnableMask & 0xF) <<
> (N_PSTH_PCR_TRPREG_BEM - 32)) |
> 
> +          ((ByteEnable & 0xF) << (N_PSTH_PCR_TRPREG_BE - 32)) |
> 
> +          (UINT32) (Type << N_PSTH_PCR_TRPREG_RWIO);
> 
> +      }
> 
> +      SetIoTrapHighDword (TrapHandlerNum, IoTrapRegHighDword, TRUE);
> 
> +      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, TRUE);
> 
> +      //
> 
> +      // Set MergeDisable flag of the registered IoTrap
> 
> +      //
> 
> +      mIoTrapData.Entry[TrapHandlerNum].MergeDisable =
> TempMergeDisable;
> 
> +    } else {
> 
> +      //
> 
> +      // Check next handler if MergeDisable is TRUE or the registered IoTrap if
> MergeDisable is TRUE
> 
> +      // If the Io Trap register is used by IoTrapEx protocol, then the
> MergeDisable will be FALSE.
> 
> +      //
> 
> +      if ((TempMergeDisable == TRUE) ||
> (mIoTrapData.Entry[TrapHandlerNum].MergeDisable == TRUE)) {
> 
> +        continue;
> 
> +      }
> 
> +      //
> 
> +      // The IO Trap handler is used, calculate the Length
> 
> +      //
> 
> +      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
> 
> +      //
> 
> +      //  Assign an addfress from common pool if the caller's address is 0
> 
> +      //
> 
> +      if (*Address == 0) {
> 
> +        //
> 
> +        //  Check next handler if it's fully used
> 
> +        //
> 
> +        if (mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength >=
> GENERIC_IOTRAP_SIZE) {
> 
> +          continue;
> 
> +        }
> 
> +        //
> 
> +        // Check next handler if it's not for a common pool
> 
> +        //
> 
> +        if (UsedLength < GENERIC_IOTRAP_SIZE) {
> 
> +          continue;
> 
> +        }
> 
> +        //
> 
> +        // Check next handler if the size is too big
> 
> +        //
> 
> +        if (Length >= (UINT16) GENERIC_IOTRAP_SIZE -
> mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength) {
> 
> +          continue;
> 
> +        }
> 
> +        //
> 
> +        // For common pool, we don't need to change the BaseAddress and
> UsedLength
> 
> +        //
> 
> +        *Address = (UINT16) (BaseAddress +
> mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength);
> 
> +        mIoTrapData.Entry[TrapHandlerNum].TrapUsedLength += Length;
> 
> +      }
> 
> +      //
> 
> +      // Only set RWM bit when we need both read and write cycles.
> 
> +      //
> 
> +      IoTrapRegHighDword = PchPcrRead32 (PID_PSTH,
> R_PSTH_PCR_TRPREG0 + TrapHandlerNum * 8 + 4);
> 
> +      if ((IoTrapRegHighDword & B_PSTH_PCR_TRPREG_RWM) == 0 &&
> 
> +          (UINT32) ((IoTrapRegHighDword & B_PSTH_PCR_TRPREG_RWIO) >>
> N_PSTH_PCR_TRPREG_RWIO) !=
> 
> +          (UINT32) Type) {
> 
> +        IoTrapRegHighDword = ((IoTrapRegHighDword |
> B_PSTH_PCR_TRPREG_RWM) & ~B_PSTH_PCR_TRPREG_RWIO);
> 
> +        SetIoTrapHighDword (TrapHandlerNum, IoTrapRegHighDword, TRUE);
> 
> +      }
> 
> +    }
> 
> +    break;
> 
> +  }
> 
> +
> 
> +  if (TrapHandlerNum >= IO_TRAP_HANDLER_NUM) {
> 
> +    DEBUG ((DEBUG_ERROR, "All IO Trap handler is used, no available IO Trap
> handler! \n"));
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +  //
> 
> +  // Create database record and add to database
> 
> +  //
> 
> +  Status = gSmst->SmmAllocatePool (
> 
> +                    EfiRuntimeServicesData,
> 
> +                    sizeof (IO_TRAP_RECORD),
> 
> +                    (VOID **) &mIoTrapRecord
> 
> +                    );
> 
> +
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "Failed to allocate memory for mIoTrapRecord!
> \n"));
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +  //
> 
> +  // Gather information about the registration request
> 
> +  //
> 
> +  mIoTrapRecord->Signature               = IO_TRAP_RECORD_SIGNATURE;
> 
> +  mIoTrapRecord->Context.Address         = *Address;
> 
> +  mIoTrapRecord->Context.Length          = Length;
> 
> +  mIoTrapRecord->Context.Type            = Type;
> 
> +  mIoTrapRecord->Context.ByteEnable      = ByteEnable;
> 
> +  mIoTrapRecord->Context.ByteEnableMask  = ByteEnableMask;
> 
> +  mIoTrapRecord->IoTrapCallback          = IoTrapDispatchFunction;
> 
> +  mIoTrapRecord->IoTrapExCallback        = IoTrapExDispatchFunction;
> 
> +  mIoTrapRecord->IoTrapNumber            = TrapHandlerNum;
> 
> +
> 
> +  InsertTailList (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase),
> &mIoTrapRecord->Link);
> 
> +
> 
> +  //
> 
> +  // Child's handle will be the address linked list link in the record
> 
> +  //
> 
> +  *DispatchHandle = (EFI_HANDLE) (&mIoTrapRecord->Link);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Result Address:%x \n", *Address));
> 
> +  DEBUG ((DEBUG_INFO, "Result Length:%x \n", Length));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  IoTrap unregistratrion helper fucntion.
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function
> 
> +
> 
> +  @retval    EFI_INVALID_PARAMETER      If DispatchHandle is invalid,
> 
> +             EFI_ACCESS_DENIED          If the SmmReadyToLock event has been
> triggered,
> 
> +             EFI_SUCCESS                IoTrap unregister successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +IoTrapUnRegisterHelper (
> 
> +  IN EFI_HANDLE                                  DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  IO_TRAP_RECORD        *RecordToDelete;
> 
> +  UINT32                IoTrapRegLowDword;
> 
> +  EFI_PHYSICAL_ADDRESS  BaseAddress;
> 
> +  UINT32                UsedLength;
> 
> +  UINT8                 TrapHandlerNum;
> 
> +  UINT8                 LengthIndex;
> 
> +  BOOLEAN               RequireToDisableIoTrapHandler;
> 
> +
> 
> +  if (DispatchHandle == 0) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the
> SmmReadyToLock event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
> 
> +  //
> 
> +  // Take the entry out of the linked list
> 
> +  //
> 
> +  if (RecordToDelete->Link.ForwardLink == (LIST_ENTRY *)
> EFI_BAD_POINTER) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  RequireToDisableIoTrapHandler = FALSE;
> 
> +  //
> 
> +  // Loop through the first IO Trap handler, looking for the suitable handler
> 
> +  //
> 
> +  TrapHandlerNum = RecordToDelete->IoTrapNumber;
> 
> +
> 
> +  if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable) {
> 
> +    //
> 
> +    // Disable the IO Trap handler if it's the only child of the Trap handler
> 
> +    //
> 
> +    RequireToDisableIoTrapHandler = TRUE;
> 
> +  } else {
> 
> +    //
> 
> +    // Get information from Io Trap handler register
> 
> +    //
> 
> +    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8);
> 
> +
> 
> +    //
> 
> +    // Check next Io Trap handler if the IO Trap handler is not used
> 
> +    //
> 
> +    if (AddressFromLowDword (IoTrapRegLowDword) != 0) {
> 
> +
> 
> +      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
> 
> +
> 
> +      //
> 
> +      // Check if it's the maximum address of the Io Trap handler
> 
> +      //
> 
> +      if ((UINTN)(BaseAddress + UsedLength) == (UINTN)(RecordToDelete-
> >Context.Address + RecordToDelete->Context.Length)) {
> 
> +
> 
> +        if (BaseAddress == RecordToDelete->Context.Address) {
> 
> +          //
> 
> +          // Disable the IO Trap handler if it's the only child of the Trap handler
> 
> +          //
> 
> +          RequireToDisableIoTrapHandler = TRUE;
> 
> +        } else {
> 
> +          //
> 
> +          // Calculate the new IO Trap handler Length
> 
> +          //
> 
> +          UsedLength = UsedLength - RecordToDelete->Context.Length;
> 
> +          //
> 
> +          // Check the alignment is dword * power of 2 or not
> 
> +          //
> 
> +          for (LengthIndex = 0; LengthIndex < sizeof (mLengthTable) / sizeof
> (UINT16); LengthIndex++) {
> 
> +            if (UsedLength == mLengthTable[LengthIndex]) {
> 
> +              break;
> 
> +            }
> 
> +          }
> 
> +          //
> 
> +          // Do not decrease the length if the alignment is not dword * power of
> 2
> 
> +          //
> 
> +          if (LengthIndex < sizeof (mLengthTable) / sizeof (UINT16)) {
> 
> +            //
> 
> +            // Decrease the length to prevent the IO trap SMI
> 
> +            //
> 
> +            IoTrapRegLowDword = (UINT32) ((((UsedLength - 1) &~(BIT1 + BIT0))
> << 16) | BaseAddress | B_PSTH_PCR_TRPREG_TSE);
> 
> +          }
> 
> +          SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, TRUE);
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (RequireToDisableIoTrapHandler) {
> 
> +    mIoTrapHandle = mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle;
> 
> +    Status        = PchInternalIoTrapSmiUnRegister (mIoTrapHandle);
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +    SetIoTrapLowDword (TrapHandlerNum, 0, TRUE);
> 
> +    SetIoTrapHighDword (TrapHandlerNum, 0, TRUE);
> 
> +    //
> 
> +    // Also clear pending IOTRAP status.
> 
> +    //
> 
> +    ClearPendingIoTrapStatus (TrapHandlerNum);
> 
> +
> 
> +    mIoTrapData.Entry[TrapHandlerNum].IoTrapHandle = 0;
> 
> +    mIoTrapData.Entry[TrapHandlerNum].MergeDisable = FALSE;
> 
> +    if (mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource ==
> TRUE) {
> 
> +      mIoTrapData.Entry[TrapHandlerNum].ReservedAcpiIoResource = FALSE;
> 
> +      UpdateIoTrapAcpiResources (TrapHandlerNum, 0, FALSE);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  RemoveEntryList (&RecordToDelete->Link);
> 
> +  Status = gSmst->SmmFreePool (RecordToDelete);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register a new IO Trap SMI dispatch function with a parent SMM driver.
> 
> +  The caller will provide information about the IO trap characteristics via
> 
> +  the context.  This includes base address, length, read vs. r/w, etc.
> 
> +  This function will autoallocate IO base address from a common pool if the
> base address is 0,
> 
> +  and the RegisterContext Address field will be updated.
> 
> +  The service will not perform GCD allocation if the base address is non-zero.
> 
> +  In this case, the caller is responsible for the existence and allocation of the
> 
> +  specific IO range.
> 
> +  This function looks for the suitable handler and Register a new IoTrap
> handler
> 
> +  if the IO Trap handler is not used. It also enable the IO Trap Range to
> generate
> 
> +  SMI.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for
> 
> +                                  this SMI source.
> 
> +  @param[in, out] RegisterContext Pointer to the dispatch function's
> context.
> 
> +                                  The caller fills this context in before calling
> 
> +                                  the register function to indicate to the register
> 
> +                                  function the IO trap SMI source for which the dispatch
> 
> +                                  function should be invoked.  This may not be NULL.
> 
> +                                  If the registration address is not 0, it's caller's responsibility
> 
> +                                  to reserve the IO resource in ACPI.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function, for when
> interfacing
> 
> +                                  with the parent SMM driver, will be the address of linked
> 
> +                                  list link in the call back record.  This may not be NULL.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR        The driver was unable to enable the SMI
> source.
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
> 
> +  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapRegister (
> 
> +  IN CONST  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL     *This,
> 
> +  IN        EFI_SMM_HANDLER_ENTRY_POINT2           DispatchFunction,
> 
> +  IN OUT    EFI_SMM_IO_TRAP_REGISTER_CONTEXT       *RegisterContext,
> 
> +  OUT       EFI_HANDLE                             *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "IoTrapRegister\n"));
> 
> +  Status = IoTrapRegisterHelper (
> 
> +             DispatchHandle,
> 
> +             DispatchFunction,
> 
> +             NULL,
> 
> +             &(RegisterContext->Address),
> 
> +             RegisterContext->Length,
> 
> +             (IO_TRAP_EX_DISPATCH_TYPE) RegisterContext->Type,
> 
> +             0x00,
> 
> +             0x0F);
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (
> 
> +      &gEfiSmmIoTrapDispatch2ProtocolGuid,
> 
> +      DispatchFunction,
> 
> +      (UINTN)RETURN_ADDRESS (0),
> 
> +      RegisterContext,
> 
> +      sizeof (EFI_SMM_IO_TRAP_REGISTER_CONTEXT)
> 
> +      );
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapUnRegister (
> 
> +  IN CONST EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL    *This,
> 
> +  IN EFI_HANDLE                                  DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IO_TRAP_RECORD *RecordToDelete;
> 
> +
> 
> +  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
> 
> +  SmiHandlerProfileUnregisterHandler (
> 
> +    &gIoTrapExDispatchProtocolGuid,
> 
> +    RecordToDelete->IoTrapCallback,
> 
> +    &RecordToDelete->Context,
> 
> +    sizeof (EFI_SMM_IO_TRAP_REGISTER_CONTEXT)
> 
> +    );
> 
> +  return IoTrapUnRegisterHelper (DispatchHandle);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register a new IO Trap Ex SMI dispatch function.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> IO_TRAP_EX_DISPATCH_PROTOCOL instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for
> 
> +                                  this SMI source.
> 
> +  @param[in] RegisterContext      Pointer to the dispatch function's context.
> 
> +                                  The caller fills this context in before calling
> 
> +                                  the register function to indicate to the register
> 
> +                                  function the IO trap Ex SMI source for which the dispatch
> 
> +                                  function should be invoked.  This MUST not be NULL.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
> 
> +  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapExRegister (
> 
> +  IN  IO_TRAP_EX_DISPATCH_PROTOCOL  *This,
> 
> +  IN  IO_TRAP_EX_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  IN  IO_TRAP_EX_REGISTER_CONTEXT   *RegisterContext,
> 
> +  OUT EFI_HANDLE                    *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "PchSmmIoTrapExRegister\n"));
> 
> +  //
> 
> +  // Return error if length is less than 4 and not power of 2.
> 
> +  //
> 
> +  if ((RegisterContext->Length < 4) || ((RegisterContext->Length &
> (RegisterContext->Length - 1)) != 0)) {
> 
> +    DEBUG ((DEBUG_ERROR, "The Dispatch Length is not power of 2 \n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Status = IoTrapRegisterHelper (
> 
> +             DispatchHandle,
> 
> +             NULL,
> 
> +             DispatchFunction,
> 
> +             &(RegisterContext->Address),
> 
> +             RegisterContext->Length,
> 
> +             RegisterContext->Type,
> 
> +             RegisterContext->ByteEnable,
> 
> +             RegisterContext->ByteEnableMask);
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (
> 
> +      &gIoTrapExDispatchProtocolGuid,
> 
> +      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> 
> +      (UINTN)RETURN_ADDRESS (0),
> 
> +      RegisterContext,
> 
> +      sizeof (*RegisterContext)
> 
> +      );
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a SMI source dispatch function.
> 
> +  This function is unsupported.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> IO_TRAP_EX_DISPATCH_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_UNSUPPORTED         The function is unsupported.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapExUnRegister (
> 
> +  IN IO_TRAP_EX_DISPATCH_PROTOCOL   *This,
> 
> +  IN EFI_HANDLE                     DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IO_TRAP_RECORD *RecordToDelete;
> 
> +
> 
> +  RecordToDelete = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
> 
> +  SmiHandlerProfileUnregisterHandler (
> 
> +    &gIoTrapExDispatchProtocolGuid,
> 
> +    RecordToDelete->IoTrapCallback,
> 
> +    &RecordToDelete->Context,
> 
> +    sizeof (RecordToDelete->Context)
> 
> +    );
> 
> +  return IoTrapUnRegisterHelper (DispatchHandle);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Pause IoTrap callback function.
> 
> +
> 
> +  This function disables the SMI enable of IoTrap according to the
> DispatchHandle,
> 
> +  which is returned by IoTrap callback registration. It only supports the
> DispatchHandle
> 
> +  with MergeDisable TRUE and address not zero.
> 
> +
> 
> +  NOTE: This call does not guarantee all pending IO cycles to be synchronized
> 
> +        and pending IO cycles issued before this call might not be trapped.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of the child service to change state.
> 
> +
> 
> +  @retval EFI_SUCCESS             This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       The SMI status is alrady PAUSED.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapControlPause (
> 
> +  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL   *This,
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IO_TRAP_RECORD                        *IoTrapRecord;
> 
> +  UINT32                                IoTrapRegLowDword;
> 
> +  UINT32                                IoTrapRegHighDword;
> 
> +  EFI_PHYSICAL_ADDRESS                  BaseAddress;
> 
> +  UINT32                                UsedLength;
> 
> +  UINT8                                 TrapHandlerNum;
> 
> +  BOOLEAN                               TempMergeDisable;
> 
> +  BOOLEAN                               DisableIoTrap;
> 
> +
> 
> +  if (DispatchHandle == 0) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  IoTrapRecord = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
> 
> +
> 
> +  if (IoTrapRecord->Context.Address) {
> 
> +    TempMergeDisable =TRUE;
> 
> +  }else {
> 
> +    TempMergeDisable = FALSE;
> 
> +  }
> 
> +
> 
> +  if ((IoTrapRecord->Signature != IO_TRAP_RECORD_SIGNATURE) ||
> 
> +      (TempMergeDisable != TRUE)                            ||
> 
> +      (IoTrapRecord->Context.Address == 0)                  ||
> 
> +      (IoTrapRecord->Context.Length == 0)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM;
> TrapHandlerNum++) {
> 
> +    //
> 
> +    // This IoTrap register should be merge disabled.
> 
> +    //
> 
> +    if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable != TRUE) {
> 
> +      continue;
> 
> +    }
> 
> +    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8);
> 
> +    IoTrapRegHighDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8 + 4);
> 
> +    //
> 
> +    // Depending on the usage, we will obtain the UsedLength and
> BaseAddress differently
> 
> +    // If the registered trap length is less than 4, we obtain the length from
> Byte Enable Mask
> 
> +    // In the other hand, we obtain the length from Address Mask
> 
> +    //
> 
> +    if (ByteEnableMaskFromHighDword (IoTrapRegHighDword) != 0xF) {
> 
> +      UsedLength = (UINT32) (HighBitSet32 (IoTrapRegHighDword & 0xF0) -
> LowBitSet32 (IoTrapRegHighDword & 0xF0) + 1);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword) +
> LowBitSet32 (ByteEnableMaskFromHighDword (IoTrapRegHighDword));
> 
> +    } else {
> 
> +      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // The address and length of record matches the IoTrap register's.
> 
> +    //
> 
> +    DisableIoTrap = FALSE;
> 
> +    if ((IoTrapRecord->IoTrapExCallback != NULL) &&
> 
> +        IsIoTrapExContentMatched (IoTrapRecord, IoTrapRegLowDword,
> IoTrapRegHighDword)) {
> 
> +      DisableIoTrap = TRUE;
> 
> +    } else if ((BaseAddress == IoTrapRecord->Context.Address) &&
> 
> +               (UsedLength  == IoTrapRecord->Context.Length )) {
> 
> +      DisableIoTrap = TRUE;
> 
> +    }
> 
> +
> 
> +    if (DisableIoTrap) {
> 
> +      //
> 
> +      // Check if status matched.
> 
> +      // If this is already Paused, return warning status.
> 
> +      //
> 
> +      if ((IoTrapRegLowDword & B_PSTH_PCR_TRPREG_TSE) == 0) {
> 
> +        return EFI_ACCESS_DENIED;
> 
> +      }
> 
> +      //
> 
> +      // Clear IoTrap register SMI enable bit
> 
> +      //
> 
> +      IoTrapRegLowDword &= (~B_PSTH_PCR_TRPREG_TSE);
> 
> +      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, FALSE);
> 
> +      //
> 
> +      // Also clear pending IOTRAP status.
> 
> +      //
> 
> +      ClearPendingIoTrapStatus (TrapHandlerNum);
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +  }
> 
> +  return EFI_INVALID_PARAMETER;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Resume IoTrap callback function.
> 
> +
> 
> +  This function enables the SMI enable of IoTrap according to the
> DispatchHandle,
> 
> +  which is returned by IoTrap callback registration. It only supports the
> DispatchHandle
> 
> +  with MergeDisable TRUE and address not zero.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of the child service to change state.
> 
> +
> 
> +  @retval EFI_SUCCESS             This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       The SMI status is alrady RESUMED.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapControlResume (
> 
> +  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL   *This,
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  )
> 
> +{
> 
> +  IO_TRAP_RECORD                        *IoTrapRecord;
> 
> +  UINT32                                IoTrapRegLowDword;
> 
> +  UINT32                                IoTrapRegHighDword;
> 
> +  EFI_PHYSICAL_ADDRESS                  BaseAddress;
> 
> +  UINT32                                UsedLength;
> 
> +  UINT8                                 TrapHandlerNum;
> 
> +  BOOLEAN                               TempMergeDisable;
> 
> +  BOOLEAN                               EnableIoTrap;
> 
> +
> 
> +  if (DispatchHandle == 0) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  IoTrapRecord = IO_TRAP_RECORD_FROM_LINK (DispatchHandle);
> 
> +
> 
> +  if (IoTrapRecord->Context.Address) {
> 
> +    TempMergeDisable = TRUE;
> 
> +  }else {
> 
> +    TempMergeDisable = FALSE;
> 
> +  }
> 
> +
> 
> +  if ((IoTrapRecord->Signature != IO_TRAP_RECORD_SIGNATURE) ||
> 
> +      (TempMergeDisable != TRUE)          ||
> 
> +      (IoTrapRecord->Context.Address == 0)                  ||
> 
> +      (IoTrapRecord->Context.Length == 0)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM;
> TrapHandlerNum++) {
> 
> +    //
> 
> +    // This IoTrap register should be merge disabled.
> 
> +    //
> 
> +    if (mIoTrapData.Entry[TrapHandlerNum].MergeDisable != TRUE) {
> 
> +      continue;
> 
> +    }
> 
> +    IoTrapRegLowDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8);
> 
> +    IoTrapRegHighDword = PchPcrRead32 (PID_PSTH, R_PSTH_PCR_TRPREG0
> + TrapHandlerNum * 8 + 4);
> 
> +    //
> 
> +    // Depending on the usage, we will obtain the UsedLength and
> BaseAddress differently
> 
> +    // If the registered trap length is less than 4, we obtain the length from
> Byte Enable Mask
> 
> +    // In the other hand, we obtain the length from Address Mask
> 
> +    //
> 
> +    if (ByteEnableMaskFromHighDword (IoTrapRegHighDword) != 0xF) {
> 
> +      UsedLength  = (UINT32) (HighBitSet32 (IoTrapRegHighDword & 0xF0) -
> LowBitSet32 (IoTrapRegHighDword & 0xF0) + 1);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword) +
> LowBitSet32 (ByteEnableMaskFromHighDword (IoTrapRegHighDword));
> 
> +    } else {
> 
> +      UsedLength  = LengthFromLowDword (IoTrapRegLowDword);
> 
> +      BaseAddress = AddressFromLowDword (IoTrapRegLowDword);
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // The address and length of record matches the IoTrap register's.
> 
> +    //
> 
> +    EnableIoTrap = FALSE;
> 
> +    if ((IoTrapRecord->IoTrapExCallback != NULL) &&
> 
> +        IsIoTrapExContentMatched (IoTrapRecord, IoTrapRegLowDword,
> IoTrapRegHighDword)) {
> 
> +      EnableIoTrap = TRUE;
> 
> +    } else if ((BaseAddress == IoTrapRecord->Context.Address) &&
> 
> +               (UsedLength  == IoTrapRecord->Context.Length )) {
> 
> +      EnableIoTrap = TRUE;
> 
> +    }
> 
> +
> 
> +    if (EnableIoTrap) {
> 
> +      //
> 
> +      // Check if status matched.
> 
> +      // If this is already Resume, return warning status.
> 
> +      //
> 
> +      if ((IoTrapRegLowDword & B_PSTH_PCR_TRPREG_TSE) != 0) {
> 
> +        return EFI_ACCESS_DENIED;
> 
> +      }
> 
> +      //
> 
> +      // Set IoTrap register SMI enable bit
> 
> +      //
> 
> +      IoTrapRegLowDword |= (B_PSTH_PCR_TRPREG_TSE);
> 
> +      SetIoTrapLowDword (TrapHandlerNum, IoTrapRegLowDword, FALSE);
> 
> +      return EFI_SUCCESS;
> 
> +    }
> 
> +  }
> 
> +  return EFI_INVALID_PARAMETER;
> 
> +}
> 
> +
> 
> +/**
> 
> +  The IoTrap module abstracts PCH I/O trapping capabilities for other drivers.
> 
> +  This driver manages the limited I/O trap resources.
> 
> +
> 
> +  @param[in] ImageHandle                Image handle for this driver image
> 
> +
> 
> +  @retval EFI_SUCCESS                   Driver initialization completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallIoTrap (
> 
> +  IN EFI_HANDLE                         ImageHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS             Status;
> 
> +  PCH_NVS_AREA_PROTOCOL  *PchNvsAreaProtocol;
> 
> +  UINTN                  TrapHandlerNum;
> 
> +
> 
> +  //
> 
> +  // Initialize the EFI SMM driver library
> 
> +  //
> 
> +  mDriverImageHandle = ImageHandle;
> 
> +
> 
> +  //
> 
> +  // Initialize the IO TRAP protocol we produce
> 
> +  //
> 
> +  mIoTrapData.Signature = IO_TRAP_INSTANCE_SIGNATURE;
> 
> +  mIoTrapData.EfiSmmIoTrapDispatchProtocol.Register   = IoTrapRegister;
> 
> +  mIoTrapData.EfiSmmIoTrapDispatchProtocol.UnRegister =
> IoTrapUnRegister;
> 
> +
> 
> +  //
> 
> +  // Initialize the IO TRAP EX protocol
> 
> +  //
> 
> +  mIoTrapData.IoTrapExDispatchProtocol.Register       = IoTrapExRegister;
> 
> +  mIoTrapData.IoTrapExDispatchProtocol.UnRegister     =
> IoTrapExUnRegister;
> 
> +
> 
> +  //
> 
> +  // Initialize the IO TRAP control protocol.
> 
> +  //
> 
> +  mIoTrapData.PchSmmIoTrapControlProtocol.Pause       =
> IoTrapControlPause;
> 
> +  mIoTrapData.PchSmmIoTrapControlProtocol.Resume      =
> IoTrapControlResume;
> 
> +
> 
> +  for (TrapHandlerNum = 0; TrapHandlerNum < IO_TRAP_HANDLER_NUM;
> TrapHandlerNum++) {
> 
> +    //
> 
> +    // Initialize IO TRAP Callback DataBase
> 
> +    //
> 
> +    InitializeListHead
> (&(mIoTrapData.Entry[TrapHandlerNum].CallbackDataBase));
> 
> +  }
> 
> +  mIoTrapData.Entry[0].CallbackDispatcher = IoTrapDispatcher0;
> 
> +  mIoTrapData.Entry[1].CallbackDispatcher = IoTrapDispatcher1;
> 
> +  mIoTrapData.Entry[2].CallbackDispatcher = IoTrapDispatcher2;
> 
> +  mIoTrapData.Entry[3].CallbackDispatcher = IoTrapDispatcher3;
> 
> +
> 
> +  //
> 
> +  // Get address of PchNvs structure for later use
> 
> +  //
> 
> +  Status = gBS->LocateProtocol (&gPchNvsAreaProtocolGuid, NULL, (VOID
> **) &PchNvsAreaProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  mPchNvsArea = PchNvsAreaProtocol->Area;
> 
> +
> 
> +  //
> 
> +  // Install protocol interface
> 
> +  //
> 
> +  mIoTrapData.Handle = NULL;
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &mIoTrapData.Handle,
> 
> +                    &gEfiSmmIoTrapDispatch2ProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mIoTrapData.EfiSmmIoTrapDispatchProtocol
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &mIoTrapData.Handle,
> 
> +                    &gIoTrapExDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mIoTrapData.IoTrapExDispatchProtocol
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &mIoTrapData.Handle,
> 
> +                    &gPchSmmIoTrapControlGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mIoTrapData.PchSmmIoTrapControlProtocol
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
> new file mode 100644
> index 0000000000..e69d2e2d4d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/IoTrap.h
> @@ -0,0 +1,226 @@
> +/** @file
> 
> +  Defines and prototypes for the IoTrap SMM driver
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _IO_TRAP_H_
> 
> +#define _IO_TRAP_H_
> 
> +
> 
> +//
> 
> +// Include files
> 
> +//
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/UefiDriverEntryPoint.h>
> 
> +#include <Protocol/SmmIoTrapDispatch2.h>
> 
> +#include <Protocol/PchSmmIoTrapControl.h>
> 
> +#include <Protocol/IoTrapExDispatch.h>
> 
> +
> 
> +#define IO_TRAP_HANDLER_NUM 4
> 
> +
> 
> +//
> 
> +// Driver private data
> 
> +//
> 
> +#define IO_TRAP_INSTANCE_SIGNATURE  SIGNATURE_32 ('I', 'O', 'T', 'P')
> 
> +
> 
> +typedef struct {
> 
> +  EFI_HANDLE                            IoTrapHandle;
> 
> +  /**
> 
> +    The callback linked list for all "merged" IoTrap callbacks.
> 
> +  **/
> 
> +  LIST_ENTRY                            CallbackDataBase;
> 
> +  /**
> 
> +    The IoTrap IO range used length tracking for "merged" IoTrap register.
> 
> +  **/
> 
> +  UINT32                                TrapUsedLength;
> 
> +  /**
> 
> +    Determine if IoTrap can be merged with other IoTrap callbacks.
> 
> +    If MergeDisable is TRUE, then there is only one callback function for one
> IoTrap register.
> 
> +    If MergeDisable is FALSE, then there are multiple callbacks in the
> "CallbackDataBase" for one IoTrap register.
> 
> +  **/
> 
> +  BOOLEAN                               MergeDisable;
> 
> +  /**
> 
> +    Indicator of the resource tracking in ACPI.
> 
> +    If the registration address is not 0, it's caller's responsibility to reserve the
> IO resource in ACPI.
> 
> +  **/
> 
> +  BOOLEAN                               ReservedAcpiIoResource;
> 
> +  /**
> 
> +    Dispatcher for each IoTrap register.
> 
> +  **/
> 
> +  PCH_SMI_DISPATCH_CALLBACK             CallbackDispatcher;
> 
> +} IO_TRAP_ENTRY_ATTRIBUTES;
> 
> +
> 
> +typedef struct {
> 
> +  UINT32                                Signature;
> 
> +  EFI_HANDLE                            Handle;
> 
> +  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
> EfiSmmIoTrapDispatchProtocol;
> 
> +  PCH_SMM_IO_TRAP_CONTROL_PROTOCOL
> PchSmmIoTrapControlProtocol;        ///< Protocol for runtime control the
> IoTrap state
> 
> +  IO_TRAP_EX_DISPATCH_PROTOCOL          IoTrapExDispatchProtocol;
> ///< Protocol for IoTrap Extension
> 
> +  IO_TRAP_ENTRY_ATTRIBUTES              Entry[IO_TRAP_HANDLER_NUM];
> 
> +} IO_TRAP_INSTANCE;
> 
> +
> 
> +#define IO_TRAP_INSTANCE_FROM_THIS(a) CR (a, IO_TRAP_INSTANCE,
> EfiSmmIoTrapDispatchProtocol, IO_TRAP_INSTANCE_SIGNATURE)
> 
> +
> 
> +///
> 
> +/// "IOTRAP" RECORD
> 
> +/// Linked list data structures
> 
> +///
> 
> +#define IO_TRAP_RECORD_SIGNATURE  SIGNATURE_32 ('I', 'T', 'R', 'C')
> 
> +
> 
> +typedef struct _IO_TRAP_RECORD {
> 
> +  UINT32                                    Signature;
> 
> +  LIST_ENTRY                                Link;
> 
> +  IO_TRAP_EX_REGISTER_CONTEXT               Context;
> 
> +  /**
> 
> +    The callback function of IoTrap protocol.
> 
> +    This also indicate it's the record for IoTrapProtocol.
> 
> +    Only one of IoTrapCallback or IoTrapExCallback is valid at a time.
> 
> +  **/
> 
> +  EFI_SMM_HANDLER_ENTRY_POINT2              IoTrapCallback;
> 
> +  /**
> 
> +    The callback function of IoTrapEx protocol
> 
> +    This also indicate it's the record for IoTrapExProtocol.
> 
> +    Only one of IoTrapCallback or IoTrapExCallback is valid at a time.
> 
> +  **/
> 
> +  IO_TRAP_EX_DISPATCH_CALLBACK              IoTrapExCallback;
> 
> +  UINT8                                     IoTrapNumber;
> 
> +} IO_TRAP_RECORD;
> 
> +
> 
> +#define IO_TRAP_RECORD_FROM_LINK(_record) CR (_record,
> IO_TRAP_RECORD, Link, IO_TRAP_RECORD_SIGNATURE)
> 
> +
> 
> +//
> 
> +// Prototypes
> 
> +//
> 
> +/**
> 
> +  The IoTrap module abstracts PCH I/O trapping capabilities for other drivers.
> 
> +  This driver manages the limited I/O trap resources.
> 
> +
> 
> +  @param[in] ImageHandle                Image handle for this driver image
> 
> +
> 
> +  @retval EFI_SUCCESS                   Driver initialization completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallIoTrap (
> 
> +  IN EFI_HANDLE                     ImageHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a new IO Trap SMI dispatch function with a parent SMM driver.
> 
> +  The caller will provide information about the IO trap characteristics via
> 
> +  the context.  This includes base address, length, read vs. r/w, etc.
> 
> +  This function will autoallocate IO base address from a common pool if the
> base address is 0,
> 
> +  and the RegisterContext Address field will be updated.
> 
> +  The service will not perform GCD allocation if the base address is non-zero.
> 
> +  In this case, the caller is responsible for the existence and allocation of the
> 
> +  specific IO range.
> 
> +  This function looks for the suitable handler and Register a new IoTrap
> handler
> 
> +  if the IO Trap handler is not used. It also enable the IO Trap Range to
> generate
> 
> +  SMI.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for
> 
> +                                  this SMI source.
> 
> +  @param[in, out] RegisterContext Pointer to the dispatch function's
> context.
> 
> +                                  The caller fills this context in before calling
> 
> +                                  the register function to indicate to the register
> 
> +                                  function the IO trap SMI source for which the dispatch
> 
> +                                  function should be invoked.  This may not be NULL.
> 
> +                                  If the registration address is not 0, it's caller's responsibility
> 
> +                                  to reserve the IO resource in ACPI.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function, for when
> interfacing
> 
> +                                  with the parent SMM driver, will be the address of linked
> 
> +                                  list link in the call back record.  This may not be NULL.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR        The driver was unable to enable the SMI
> source.
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources are available
> 
> +  @retval EFI_INVALID_PARAMETER   Address requested is already in use.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapRegister (
> 
> +  IN  CONST   EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL     *This,
> 
> +  IN          EFI_SMM_HANDLER_ENTRY_POINT2           DispatchFunction,
> 
> +  IN OUT      EFI_SMM_IO_TRAP_REGISTER_CONTEXT       *RegisterContext,
> 
> +  OUT EFI_HANDLE                                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapUnRegister (
> 
> +  IN CONST  EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL    *This,
> 
> +  IN EFI_HANDLE                                   DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This I/O Trap SMI handler invokes the ACPI reference code to handle the
> SMI.
> 
> +  It currently assumes it owns all of the IO trap SMI.
> 
> +
> 
> +  @param[in] DispatchHandle           Not used
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +IoTrapCallback (
> 
> +  IN  EFI_HANDLE                      DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Pause IoTrap callback function.
> 
> +
> 
> +  This function disables the SMI enable of IoTrap according to the
> DispatchHandle,
> 
> +  which is returned by IoTrap callback registration. It only supports the
> DispatchHandle
> 
> +  with MergeDisable TRUE and address not zero.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of the child service to change state.
> 
> +
> 
> +  @retval EFI_SUCCESS             This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       The SMI status is alrady PAUSED.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapControlPause (
> 
> +  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL * This,
> 
> +  IN EFI_HANDLE                       DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Resume IoTrap callback function.
> 
> +
> 
> +  This function enables the SMI enable of IoTrap according to the
> DispatchHandle,
> 
> +  which is returned by IoTrap callback registration. It only supports the
> DispatchHandle
> 
> +  with MergeDisable TRUE and address not zero.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of the child service to change state.
> 
> +
> 
> +  @retval EFI_SUCCESS             This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER   The DispatchHandle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED       The SMI status is alrady RESUMED.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +IoTrapControlResume (
> 
> +  IN PCH_SMM_IO_TRAP_CONTROL_PROTOCOL * This,
> 
> +  IN EFI_HANDLE                       DispatchHandle
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tch.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tch.c
> new file mode 100644
> index 0000000000..affbe94eb7
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tch.c
> @@ -0,0 +1,2442 @@
> +/** @file
> 
> +  This function handle the register/unregister of PCH specific SMI events.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Library/SmiHandlerProfileLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/PchRegsPsth.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <PchBdfAssignment.h>
> 
> +#include "PchSmiHelper.h"
> 
> +
> 
> +/**
> 
> +  The internal function used to create and insert a database record
> 
> +  for SMI record of Pch Smi types.
> 
> +
> 
> +  @param[in]  SrcDesc                   The pointer to the SMI source description
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  PchSmiType                Specific SMI type of PCH SMI
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmiRecordInsert (
> 
> +  IN  CONST PCH_SMM_SOURCE_DESC         *SrcDesc,
> 
> +  IN  PCH_SMI_CALLBACK_FUNCTIONS        DispatchFunction,
> 
> +  IN  PCH_SMI_TYPES                     PchSmiType,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       Record;
> 
> +
> 
> +  if (SrcDesc == NULL) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  ZeroMem (&Record, sizeof (DATABASE_RECORD));
> 
> +  //
> 
> +  // Gather information about the registration request
> 
> +  //
> 
> +  Record.Signature                      = DATABASE_RECORD_SIGNATURE;
> 
> +  Record.PchSmiCallback                 = DispatchFunction;
> 
> +  Record.ProtocolType                   = PchSmiDispatchType;
> 
> +  Record.PchSmiType                     = PchSmiType;
> 
> +
> 
> +  CopyMem (&Record.SrcDesc, SrcDesc, sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +  Status = SmmCoreInsertRecord (
> 
> +             &Record,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +
> 
> +//
> 
> +// TCO_STS bit that needs to be cleared
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mDescSrcTcoSts = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    NULL_BIT_DESC_INITIALIZER,
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_TCO
> 
> +    }
> 
> +  },
> 
> +  NULL_BIT_DESC_INITIALIZER
> 
> +};
> 
> +
> 
> +/**
> 
> +  Clear the TCO SMI status bit and block after the SMI handling is done
> 
> +
> 
> +  @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchTcoSmiClearSourceAndBlock (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  )
> 
> +{
> 
> +  PchSmmClearSourceAndBlock (SrcDesc);
> 
> +  //
> 
> +  // Any TCO-based status bits require special handling.
> 
> +  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the
> TCO registers
> 
> +  //
> 
> +  PchSmmClearSource (&mDescSrcTcoSts);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear the TCO SMI status bit after the SMI handling is done
> 
> +
> 
> +  @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchTcoSmiClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  )
> 
> +{
> 
> +  PchSmmClearSource (SrcDesc);
> 
> +  //
> 
> +  // Any TCO-based status bits require special handling.
> 
> +  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the
> TCO registers
> 
> +  //
> 
> +  PchSmmClearSource (&mDescSrcTcoSts);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initialize Source descriptor structure
> 
> +
> 
> +   @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +NullInitSourceDesc (
> 
> +   PCH_SMM_SOURCE_DESC                   *SrcDesc
> 
> +   )
> 
> +{
> 
> +  ZeroMem (SrcDesc, sizeof (PCH_SMM_SOURCE_DESC));
> 
> +  SrcDesc->En[0].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
> 
> +  SrcDesc->En[1].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
> 
> +  SrcDesc->Sts[0].Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
> 
> +  SrcDesc->PmcSmiSts.Reg.Type = PCH_SMM_ADDR_TYPE_NULL;
> 
> +}
> 
> +
> 
> +//
> 
> +// Mch srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescMch = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_DMISMI
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of MCH event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiMchRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescMch,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiMchType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// TcoTimeout srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescTcoTimeout = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_TIMEOUT
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of TcoTimeout event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiTcoTimeoutRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescTcoTimeout,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiTcoTimeoutType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// OsTco srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescOsTco = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_SW_TCO_SMI
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of OS TCO event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiOsTcoRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescOsTco,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiOsTcoType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// Nmi
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescNmi = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_CNT}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_CNT,
> 
> +      N_TCO_IO_TCO1_CNT_NMI2SMI_EN
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_NMI2SMI
> 
> +    }
> 
> +  },
> 
> +  //
> 
> +  // NOTE: The status of NMI2SMI won't reflect to PMC SMI_STS.
> 
> +  //       So skip the top level status check and check the TCO1_STS directly.
> 
> +  //
> 
> +  NULL_BIT_DESC_INITIALIZER
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of NMI event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiNmiRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescNmi,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiNmiType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// IntruderDetect srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescIntruderDet = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO2_CNT}
> 
> +      },
> 
> +      S_TCO_IO_TCO2_CNT,
> 
> +      N_TCO_IO_TCO2_CNT_INTRD_SEL
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO2_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO2_STS,
> 
> +      N_TCO_IO_TCO2_STS_INTRD_DET
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of Intruder Detect
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiIntruderDetRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescIntruderDet,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiIntruderDetectType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSourceAndBlock;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// SpiBiosWp srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescSpiBiosWp = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
> 
> +          R_SPI_CFG_BC
> 
> +        ) }
> 
> +      },
> 
> +      S_SPI_CFG_BC,
> 
> +      N_SPI_CFG_BC_BLE
> 
> +    },
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
> 
> +          R_SPI_CFG_BC
> 
> +        ) }
> 
> +      },
> 
> +      S_SPI_CFG_BC,
> 
> +      N_SPI_CFG_BC_SYNC_SS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Special handling for SPI Write Protect
> 
> +
> 
> +  @param[in]  SrcDesc   Not used
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchTcoSpiWpClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINT64 SpiRegBase;
> 
> +  UINT32 BiosControl;
> 
> +  UINT32 Timeout;
> 
> +
> 
> +  SpiRegBase = SpiPciCfgBase ();
> 
> +  PciSegmentAndThenOr32 (
> 
> +    SpiRegBase + R_SPI_CFG_BC,
> 
> +    (UINT32) ~B_SPI_CFG_BC_ASYNC_SS,
> 
> +    B_SPI_CFG_BC_SYNC_SS
> 
> +    );
> 
> +  //
> 
> +  // Ensure the SYNC is cleared
> 
> +  //
> 
> +  Timeout = 1000;
> 
> +  do {
> 
> +    BiosControl = PciSegmentRead32 (SpiRegBase + R_SPI_CFG_BC);
> 
> +    Timeout--;
> 
> +  } while ((BiosControl & B_SPI_CFG_BC_SYNC_SS) && (Timeout > 0));
> 
> +
> 
> +  //
> 
> +  // Any TCO-based status bits require special handling.
> 
> +  // SMI_STS.TCO_STS must be cleared in addition to the status bit in the
> TCO registers
> 
> +  //
> 
> +  PchSmmClearSource (&mDescSrcTcoSts);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set SMI_EN_TCO to enable TCO SMI.
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +PchSetSmiEnTco (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  IoOr32 (mAcpiBaseAddr + R_ACPI_IO_SMI_EN,
> B_ACPI_IO_SMI_EN_TCO);
> 
> +}
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of BIOS write protect
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiSpiBiosWpRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescSpiBiosWp,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiSpiBiosWpType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSpiWpClearSource;
> 
> +    PchTcoSpiWpClearSource (NULL);
> 
> +    //
> 
> +    // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
> 
> +    // Only enable SMI_EN_TCO.
> 
> +    //
> 
> +    PchSetSmiEnTco ();
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// LpcBiosWp srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescLpcBiosWp = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
> 
> +          R_LPC_CFG_BC
> 
> +        ) }
> 
> +      },
> 
> +      S_LPC_CFG_BC,
> 
> +      N_LPC_CFG_BC_LE
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_BIOSWR
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of LPC BIOS write
> protect event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiLpcBiosWpRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  if (IsEspiEnabled ()) {
> 
> +    //
> 
> +    // Status is D31F0's PCBC.BWPDS
> 
> +    //
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescLpcBiosWp,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiLpcBiosWpType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    //
> 
> +    // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
> 
> +    // Only enable SMI_EN_TCO.
> 
> +    //
> 
> +    PchSetSmiEnTco ();
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// NEWCENTURY_STS bit that needs to be cleared
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescNewCentury = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        TCO_ADDR_TYPE,
> 
> +        {R_TCO_IO_TCO1_STS}
> 
> +      },
> 
> +      S_TCO_IO_TCO1_STS,
> 
> +      N_TCO_IO_TCO1_STS_NEWCENTURY
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of NEW CENTURY event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiNewCenturyRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  PCH_TCO_SMI_DISPATCH_CALLBACK     DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescNewCentury,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchTcoSmiNewCenturyType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchTcoSmiClearSourceAndBlock;
> 
> +    PchSmmClearSource (&Record->SrcDesc);
> 
> +    PchSmmEnableSource (&Record->SrcDesc);
> 
> +    SmiHandlerProfileRegisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchTcoSmiUnRegister (
> 
> +  IN  PCH_TCO_SMI_DISPATCH_PROTOCOL     *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *Record;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  Record = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  if ((Record->SrcDesc.En[1].Reg.Type == ACPI_ADDR_TYPE) &&
> 
> +      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Dev == SpiDevNumber ())
> &&
> 
> +      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Fnc == SpiFuncNumber ())
> &&
> 
> +      (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Reg == R_SPI_CFG_BC) &&
> 
> +      (Record->SrcDesc.En[1].Bit == N_SPI_CFG_BC_BLE)) {
> 
> +    //
> 
> +    // SPI Write Protect cannot be disabled
> 
> +    //
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  } else if ((Record->SrcDesc.En[1].Reg.Type == ACPI_ADDR_TYPE) &&
> 
> +             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Dev == LpcDevNumber
> ()) &&
> 
> +             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Fnc == LpcFuncNumber
> ()) &&
> 
> +             (Record->SrcDesc.En[1].Reg.Data.pcie.Fields.Reg == R_LPC_CFG_BC)
> &&
> 
> +             (Record->SrcDesc.En[1].Bit == N_LPC_CFG_BC_LE)) {
> 
> +    //
> 
> +    // eSPI/LPC Write Protect cannot be disabled
> 
> +    //
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileUnregisterHandler (&gPchTcoSmiDispatchProtocolGuid,
> Record->Callback, NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +
> 
> +//
> 
> +// PcieRpHotPlug srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC
> PchPcieSmiRpHotPlugTemplate = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_MPC}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_MPC,
> 
> +      N_PCH_PCIE_CFG_MPC_HPME
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_SMSCS}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_SMSCS,
> 
> +      N_PCH_PCIE_CFG_SMSCS_HPPDM
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PCI_EXP
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of PCIE RP hotplug
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH
> RP index and CPU RP index.
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPcieSmiHotPlugRegister (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
> 
> +  IN  UINTN                             RpIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINTN                                 RpDev;
> 
> +  UINTN                                 RpFun;
> 
> +  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
> 
> +
> 
> +  PchPcieSmiRpHotPlugTemplate.En[0].Reg.Data.pcie.Fields.Dev = (UINT8)
> RpDev;
> 
> +  PchPcieSmiRpHotPlugTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8)
> RpFun;
> 
> +  PchPcieSmiRpHotPlugTemplate.Sts[0].Reg.Data.pcie.Fields.Dev = (UINT8)
> RpDev;
> 
> +  PchPcieSmiRpHotPlugTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc = (UINT8)
> RpFun;
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &PchPcieSmiRpHotPlugTemplate,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchPcieSmiRpHotplugType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpHotplugType;
> 
> +    Record->ChildContext.Pcie.RpIndex = RpIndex;
> 
> +    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
> 
> +    SmiHandlerProfileRegisterHandler (
> 
> +      &gPchPcieSmiDispatchProtocolGuid,
> 
> +      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> 
> +      (UINTN)RETURN_ADDRESS (0),
> 
> +      &Context,
> 
> +      sizeof (Context)
> 
> +      );
> 
> +  }
> 
> +  PchSmmClearSource (&PchPcieSmiRpHotPlugTemplate);
> 
> +  PchSmmEnableSource (&PchPcieSmiRpHotPlugTemplate);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// PcieRpLinkActive srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC
> PchPcieSmiRpLinkActiveTemplate = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_MPC}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_MPC,
> 
> +      N_PCH_PCIE_CFG_MPC_HPME
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_SMSCS}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_SMSCS,
> 
> +      N_PCH_PCIE_CFG_SMSCS_HPLAS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PCI_EXP
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of PCIE RP link active
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH
> RP index and CPU RP index.
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPcieSmiLinkActiveRegister (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
> 
> +  IN  UINTN                             RpIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINTN                                 RpDev;
> 
> +  UINTN                                 RpFun;
> 
> +  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
> 
> +
> 
> +
> 
> +  PchPcieSmiRpLinkActiveTemplate.En[0].Reg.Data.pcie.Fields.Dev =
> (UINT8) RpDev;
> 
> +  PchPcieSmiRpLinkActiveTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8)
> RpFun;
> 
> +  PchPcieSmiRpLinkActiveTemplate.Sts[0].Reg.Data.pcie.Fields.Dev =
> (UINT8) RpDev;
> 
> +  PchPcieSmiRpLinkActiveTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc =
> (UINT8) RpFun;
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &PchPcieSmiRpLinkActiveTemplate,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchPcieSmiRpLinkActiveType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpLinkActiveType;
> 
> +    Record->ChildContext.Pcie.RpIndex = RpIndex;
> 
> +    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
> 
> +    SmiHandlerProfileRegisterHandler (
> 
> +      &gPchPcieSmiDispatchProtocolGuid,
> 
> +      (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> 
> +      (UINTN)RETURN_ADDRESS (0),
> 
> +      &Context,
> 
> +      sizeof (Context)
> 
> +      );
> 
> +  }
> 
> +  PchSmmClearSource (&PchPcieSmiRpLinkActiveTemplate);
> 
> +  PchSmmEnableSource (&PchPcieSmiRpLinkActiveTemplate);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// PcieRpLinkEq srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_SMM_SOURCE_DESC
> PchPcieSmiRpLinkEqTemplate = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_EQCFG1}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_EQCFG1,
> 
> +      N_PCH_PCIE_CFG_EQCFG1_LERSMIE
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        {R_PCH_PCIE_CFG_SMSCS}
> 
> +      },
> 
> +      S_PCH_PCIE_CFG_SMSCS,
> 
> +      N_PCH_PCIE_CFG_SMSCS_LERSMIS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PCI_EXP
> 
> +  }
> 
> +};
> 
> +/**
> 
> +  The register function used to register SMI handler of PCIE RP Link
> Equalization Request event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  RpIndex                   Refer PCIE_COMBINED_RPINDEX for PCH
> RP index and CPU RP index.
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPcieSmiLinkEqRegister (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_PCIE_SMI_RP_DISPATCH_CALLBACK DispatchFunction,
> 
> +  IN  UINTN                             RpIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  UINTN                                 RpDev;
> 
> +  UINTN                                 RpFun;
> 
> +  EFI_STATUS                            Status;
> 
> +  PCH_SMM_PCIE_REGISTER_CONTEXT         Context;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  GetPcieRpDevFun (RpIndex, &RpDev, &RpFun);
> 
> +
> 
> +  //
> 
> +  // Patch the RP device number and function number of srcdesc.
> 
> +  //
> 
> +  PchPcieSmiRpLinkEqTemplate.En[0].Reg.Data.pcie.Fields.Dev = (UINT8)
> RpDev;
> 
> +  PchPcieSmiRpLinkEqTemplate.En[0].Reg.Data.pcie.Fields.Fnc = (UINT8)
> RpFun;
> 
> +  PchPcieSmiRpLinkEqTemplate.Sts[0].Reg.Data.pcie.Fields.Dev = (UINT8)
> RpDev;
> 
> +  PchPcieSmiRpLinkEqTemplate.Sts[0].Reg.Data.pcie.Fields.Fnc = (UINT8)
> RpFun;
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +           &PchPcieSmiRpLinkEqTemplate,
> 
> +           (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +           PchPcieSmiRpLinkEqType,
> 
> +           DispatchHandle
> 
> +           );
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ChildContext.Pcie.PchSmiType = PchPcieSmiRpLinkEqType;
> 
> +    Record->ChildContext.Pcie.RpIndex = RpIndex;
> 
> +    Record->ContextSize = sizeof (PCH_SMM_PCIE_REGISTER_CONTEXT);
> 
> +    SmiHandlerProfileRegisterHandler (
> 
> +      &gPchPcieSmiDispatchProtocolGuid,
> 
> +      (EFI_SMM_HANDLER_ENTRY_POINT2) DispatchFunction,
> 
> +      (UINTN)RETURN_ADDRESS (0),
> 
> +      &Context,
> 
> +      sizeof (Context)
> 
> +      );
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPcieSmiUnRegister (
> 
> +  IN  PCH_PCIE_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *RecordToDelete;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +      SmiHandlerProfileUnregisterHandler (
> 
> +        &gPchPcieSmiDispatchProtocolGuid,
> 
> +        RecordToDelete->Callback,
> 
> +        &RecordToDelete->ChildContext,
> 
> +        sizeof (RecordToDelete->ContextSize)
> 
> +        );
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// Pme srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescPme = {
> 
> +  PCH_SMM_SCI_EN_DEPENDENT,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_GPE0_EN_127_96}
> 
> +      },
> 
> +      S_ACPI_IO_GPE0_EN_127_96,
> 
> +      N_ACPI_IO_GPE0_EN_127_96_PME
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_GPE0_STS_127_96}
> 
> +      },
> 
> +      S_ACPI_IO_GPE0_STS_127_96,
> 
> +      N_ACPI_IO_GPE0_STS_127_96_PME
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_GPE0
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of PME event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiSmiPmeRegister (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescPme,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchAcpiSmiPmeType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescPme);
> 
> +  PchSmmEnableSource (&mSrcDescPme);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// PmeB0 srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescPmeB0 = {
> 
> +  PCH_SMM_SCI_EN_DEPENDENT,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_GPE0_EN_127_96}
> 
> +      },
> 
> +      S_ACPI_IO_GPE0_EN_127_96,
> 
> +      N_ACPI_IO_GPE0_EN_127_96_PME_B0
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_GPE0_STS_127_96}
> 
> +      },
> 
> +      S_ACPI_IO_GPE0_STS_127_96,
> 
> +      N_ACPI_IO_GPE0_STS_127_96_PME_B0
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_GPE0
> 
> +  }
> 
> +};
> 
> +/**
> 
> +  The register function used to register SMI handler of PME B0 event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiSmiPmeB0Register (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescPmeB0,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchAcpiSmiPmeB0Type,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescPmeB0);
> 
> +  PchSmmEnableSource (&mSrcDescPmeB0);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// RtcAlarm srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescRtcAlarm = {
> 
> +  PCH_SMM_SCI_EN_DEPENDENT,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_EN}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_EN,
> 
> +      N_ACPI_IO_PM1_EN_RTC
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_STS}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_STS,
> 
> +      N_ACPI_IO_PM1_STS_RTC
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PM1_STS_REG
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of RTC alarm event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiSmiRtcAlarmRegister (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescRtcAlarm,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchAcpiSmiRtcAlarmType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +
> 
> +  PchSmmClearSource (&mSrcDescRtcAlarm);
> 
> +  PchSmmEnableSource (&mSrcDescRtcAlarm);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// TmrOverflow srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescTmrOverflow = {
> 
> +  PCH_SMM_SCI_EN_DEPENDENT,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_EN}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_EN,
> 
> +      N_ACPI_IO_PM1_EN_TMROF
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_STS}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_STS,
> 
> +      N_ACPI_IO_PM1_STS_TMROF
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PM1_STS_REG
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of Timer Overflow
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiSmiTmrOverflowRegister (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescTmrOverflow,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchAcpiSmiTmrOverflowType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescTmrOverflow);
> 
> +  PchSmmEnableSource (&mSrcDescTmrOverflow);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchAcpiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchAcpiSmiUnRegister (
> 
> +  IN  PCH_ACPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                   *RecordToDelete;
> 
> +  EFI_STATUS                        Status;
> 
> +
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileUnregisterHandler
> (&gPchAcpiSmiDispatchProtocolGuid, RecordToDelete->Callback, NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// SerialIrq srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescSerialIrq = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    NULL_BIT_DESC_INITIALIZER,
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_SERIRQ
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_SERIRQ
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of Serial IRQ event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmiSerialIrqRegister (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescSerialIrq,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchSmiSerialIrqType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescSerialIrq);
> 
> +  PchSmmEnableSource (&mSrcDescSerialIrq);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +     SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// McSmi srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescMcSmi = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_MCSMI
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_MCSMI
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_MCSMI
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of MCSMI event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmiMcSmiRegister (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescMcSmi,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchSmiMcSmiType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescMcSmi);
> 
> +  PchSmmEnableSource (&mSrcDescMcSmi);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// SmBus srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescSmbus = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    NULL_BIT_DESC_INITIALIZER,
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_SMBUS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_SMBUS
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of SMBUS event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmiSmbusRegister (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescSmbus,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchSmiSmBusType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescSmbus);
> 
> +  PchSmmEnableSource (&mSrcDescSmbus);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// SpiAsyncSmi srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescSpiAsyncSmi = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
> 
> +          R_SPI_CFG_BC
> 
> +        ) }
> 
> +      },
> 
> +      S_SPI_CFG_BC,
> 
> +      N_SPI_CFG_BC_ASE_BWP
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_SPI << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_SPI << 16) |
> 
> +          R_SPI_CFG_BC
> 
> +        ) }
> 
> +      },
> 
> +      S_SPI_CFG_BC,
> 
> +      N_SPI_CFG_BC_ASYNC_SS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_SPI
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Special handling for SPI Asynchronous SMI.
> 
> +  If SPI ASYNC SMI is enabled, De-assert SMI is sent when Flash Cycle Done
> 
> +  transitions from 1 to 0 or when the SMI enable becomes false.
> 
> +
> 
> +  @param[in]  SrcDesc   Not used
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchSmiSpiAsyncClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINT64                                SpiRegBase;
> 
> +  UINT32                                SpiBar0;
> 
> +
> 
> +  SpiRegBase = SpiPciCfgBase ();
> 
> +  SpiBar0 = PciSegmentRead32 (SpiRegBase + R_SPI_CFG_BAR0) &
> ~(B_SPI_CFG_BAR0_MASK);
> 
> +  if (SpiBar0 != PCH_SPI_BASE_ADDRESS) {
> 
> +    //
> 
> +    // Temporary disable MSE, and override with SPI reserved MMIO
> address, then enable MSE.
> 
> +    //
> 
> +    SpiBar0 = PCH_SPI_BASE_ADDRESS;
> 
> +    PciSegmentAnd8 (SpiRegBase + PCI_COMMAND_OFFSET, (UINT8)
> ~EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +    PciSegmentWrite32 (SpiRegBase + R_SPI_CFG_BAR0, SpiBar0);
> 
> +    PciSegmentOr8 (SpiRegBase + PCI_COMMAND_OFFSET,
> EFI_PCI_COMMAND_MEMORY_SPACE);
> 
> +  }
> 
> +
> 
> +  MmioOr32 (SpiBar0 + R_SPI_MEM_HSFSC, B_SPI_MEM_HSFSC_FDONE);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Special handling to enable SPI Asynchronous SMI
> 
> +**/
> 
> +VOID
> 
> +PchSmiSpiAsyncEnableSource (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT64 SpiRegBase;
> 
> +  UINT32 Data32And;
> 
> +  UINT32 Data32Or;
> 
> +
> 
> +  SpiRegBase = SpiPciCfgBase ();
> 
> +  Data32And = (UINT32) ~B_SPI_CFG_BC_SYNC_SS;
> 
> +  Data32Or = B_SPI_CFG_BC_ASE_BWP;
> 
> +
> 
> +  PciSegmentAndThenOr32 (
> 
> +    SpiRegBase + R_SPI_CFG_BC,
> 
> +    Data32And,
> 
> +    Data32Or
> 
> +    );
> 
> +  S3BootScriptSavePciCfgReadWrite (
> 
> +    S3BootScriptWidthUint32,
> 
> +    SpiRegBase + R_SPI_CFG_BC,
> 
> +    (VOID*) &Data32Or,
> 
> +    (VOID*) &Data32And
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Clear the source
> 
> +  //
> 
> +  PchSmiSpiAsyncClearSource (NULL);
> 
> +}
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of SPI Asynchronous
> event.
> 
> +
> 
> +  @param[in]  This                      The pointer to the protocol itself
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmiSpiAsyncRegister (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescSpiAsyncSmi,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchSmiSpiAsyncType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    Record = DATABASE_RECORD_FROM_LINK (*DispatchHandle);
> 
> +    Record->ClearSource = PchSmiSpiAsyncClearSource;
> 
> +    PchSmiSpiAsyncClearSource (NULL);
> 
> +    PchSmiSpiAsyncEnableSource ();
> 
> +    SmiHandlerProfileRegisterHandler (&gPchSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied since SPI aync
> SMI handler is not able to disabled.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmiUnRegister (
> 
> +  IN  PCH_SMI_DISPATCH_PROTOCOL         *This,
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *Record;
> 
> +  UINT64                                SpiRegBase;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  Record = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  if ((Record->SrcDesc.En[0].Reg.Type == PCIE_ADDR_TYPE) &&
> 
> +      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Dev == SpiDevNumber ())
> &&
> 
> +      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Fnc == SpiFuncNumber ())
> &&
> 
> +      (Record->SrcDesc.En[0].Reg.Data.pcie.Fields.Reg == R_SPI_CFG_BC) &&
> 
> +      (Record->SrcDesc.En[0].Bit == N_SPI_CFG_BC_ASE_BWP)) {
> 
> +    SpiRegBase = SpiPciCfgBase ();
> 
> +    if (PciSegmentRead8 (SpiRegBase + R_SPI_CFG_BC) &
> B_SPI_CFG_BC_BILD) {
> 
> +      //
> 
> +      // SPI Asynchronous SMI cannot be disabled
> 
> +      //
> 
> +      return EFI_ACCESS_DENIED;
> 
> +    }
> 
> +  }
> 
> +  Status = PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileUnregisterHandler (&gPchSmiDispatchProtocolGuid,
> Record->Callback, NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Declaration of PCH TCO SMI DISPATCH PROTOCOL instance
> 
> +**/
> 
> +PCH_TCO_SMI_DISPATCH_PROTOCOL mPchTcoSmiDispatchProtocol = {
> 
> +  PCH_TCO_SMI_DISPATCH_REVISION,        // Revision
> 
> +  PchTcoSmiUnRegister,                  // Unregister
> 
> +  PchTcoSmiMchRegister,                 // Mch
> 
> +  PchTcoSmiTcoTimeoutRegister,          // TcoTimeout
> 
> +  PchTcoSmiOsTcoRegister,               // OsTco
> 
> +  PchTcoSmiNmiRegister,                 // Nmi
> 
> +  PchTcoSmiIntruderDetRegister,         // IntruderDectect
> 
> +  PchTcoSmiSpiBiosWpRegister,           // SpiBiosWp
> 
> +  PchTcoSmiLpcBiosWpRegister,           // LpcBiosWp
> 
> +  PchTcoSmiNewCenturyRegister           // NewCentury
> 
> +};
> 
> +
> 
> +/**
> 
> +  Declaration of PCH PCIE SMI DISPATCH PROTOCOL instance
> 
> +**/
> 
> +PCH_PCIE_SMI_DISPATCH_PROTOCOL mPchPcieSmiDispatchProtocol = {
> 
> +  PCH_PCIE_SMI_DISPATCH_REVISION,       // Revision
> 
> +  PchPcieSmiUnRegister,                 // Unregister
> 
> +  PchPcieSmiHotPlugRegister,            // PcieRpXHotPlug
> 
> +  PchPcieSmiLinkActiveRegister,         // PcieRpXLinkActive
> 
> +  PchPcieSmiLinkEqRegister              // PcieRpXLinkEq
> 
> +};
> 
> +
> 
> +/**
> 
> +  Declaration of PCH ACPI SMI DISPATCH PROTOCOL instance
> 
> +**/
> 
> +PCH_ACPI_SMI_DISPATCH_PROTOCOL mPchAcpiSmiDispatchProtocol = {
> 
> +  PCH_ACPI_SMI_DISPATCH_REVISION,       // Revision
> 
> +  PchAcpiSmiUnRegister,                 // Unregister
> 
> +  PchAcpiSmiPmeRegister,                // Pme
> 
> +  PchAcpiSmiPmeB0Register,              // PmeB0
> 
> +  PchAcpiSmiRtcAlarmRegister,           // RtcAlarm
> 
> +  PchAcpiSmiTmrOverflowRegister         // TmrOverflow
> 
> +};
> 
> +
> 
> +/**
> 
> +  Declaration of MISC PCH SMI DISPATCH PROTOCOL instance
> 
> +**/
> 
> +PCH_SMI_DISPATCH_PROTOCOL mPchSmiDispatchProtocol = {
> 
> +  PCH_SMI_DISPATCH_REVISION,            // Revision
> 
> +  PchSmiUnRegister,                     // Unregister
> 
> +  PchSmiSerialIrqRegister,              // SerialIrq
> 
> +  PchSmiMcSmiRegister,                  // McSmi
> 
> +  PchSmiSmbusRegister,                  // SmBus
> 
> +  PchSmiSpiAsyncRegister                // SpiAsync
> 
> +};
> 
> +
> 
> +/**
> 
> +  Install protocols of PCH specifics SMI types, including
> 
> +  PCH TCO SMI types, PCH PCIE SMI types, PCH ACPI SMI types, PCH MISC
> SMI types.
> 
> +
> 
> +  @retval                               the result of protocol installation
> 
> +**/
> 
> +EFI_STATUS
> 
> +InstallPchSmiDispatchProtocols (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_HANDLE                            Handle;
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  Handle = NULL;
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &Handle,
> 
> +                    &gPchTcoSmiDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mPchTcoSmiDispatchProtocol
> 
> +                    );
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &Handle,
> 
> +                    &gPchPcieSmiDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mPchPcieSmiDispatchProtocol
> 
> +                    );
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &Handle,
> 
> +                    &gPchAcpiSmiDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mPchAcpiSmiDispatchProtocol
> 
> +                    );
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &Handle,
> 
> +                    &gPchSmiDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mPchSmiDispatchProtocol
> 
> +                    );
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  The function to dispatch all callback function of PCH SMI types.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Function successfully completed
> 
> +  @retval EFI_UNSUPPORTED               no
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmiTypeCallbackDispatcher (
> 
> +  IN  DATABASE_RECORD                   *Record
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  PCH_SMI_TYPES                         PchSmiType;
> 
> +  UINTN                                 RpIndex;
> 
> +  PCH_PCIE_SMI_RP_CONTEXT               RpContext;
> 
> +
> 
> +  PchSmiType = Record->PchSmiType;
> 
> +  Status     = EFI_SUCCESS;
> 
> +
> 
> +  switch (PchSmiType) {
> 
> +    case PchTcoSmiMchType:
> 
> +    case PchTcoSmiTcoTimeoutType:
> 
> +    case PchTcoSmiOsTcoType:
> 
> +    case PchTcoSmiNmiType:
> 
> +    case PchTcoSmiIntruderDetectType:
> 
> +    case PchTcoSmiSpiBiosWpType:
> 
> +    case PchTcoSmiLpcBiosWpType:
> 
> +    case PchTcoSmiNewCenturyType:
> 
> +      ((PCH_TCO_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback))
> ((EFI_HANDLE)&Record->Link);
> 
> +      break;
> 
> +    case PchPcieSmiRpHotplugType:
> 
> +    case PchPcieSmiRpLinkActiveType:
> 
> +    case PchPcieSmiRpLinkEqType:
> 
> +      RpContext.BusNum  = DEFAULT_PCI_BUS_NUMBER_PCH;
> 
> +      RpContext.DevNum  = (UINT8) Record-
> >SrcDesc.En[0].Reg.Data.pcie.Fields.Dev;
> 
> +      RpContext.FuncNum = (UINT8) Record-
> >SrcDesc.En[0].Reg.Data.pcie.Fields.Fnc;
> 
> +      GetPcieRpNumber (RpContext.DevNum, RpContext.FuncNum,
> &RpIndex);
> 
> +      RpContext.RpIndex = (UINT8) RpIndex;
> 
> +      ((PCH_PCIE_SMI_RP_DISPATCH_CALLBACK) (Record->PchSmiCallback))
> ((EFI_HANDLE)&Record->Link, &RpContext);
> 
> +      break;
> 
> +    case PchAcpiSmiPmeType:
> 
> +    case PchAcpiSmiPmeB0Type:
> 
> +    case PchAcpiSmiRtcAlarmType:
> 
> +    case PchAcpiSmiTmrOverflowType:
> 
> +      ((PCH_ACPI_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback))
> ((EFI_HANDLE)&Record->Link);
> 
> +      break;
> 
> +    case PchEspiSmiEspiSlaveType:
> 
> +      ((PCH_ESPI_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback))
> ((EFI_HANDLE)&Record->Link);
> 
> +      break;
> 
> +    case PchSmiSerialIrqType:
> 
> +    case PchSmiMcSmiType:
> 
> +    case PchSmiSmBusType:
> 
> +    case PchSmiSpiAsyncType:
> 
> +    case PchIoTrapSmiType:                ///< internal type for IoTrap
> 
> +      ((PCH_SMI_DISPATCH_CALLBACK) (Record->PchSmiCallback))
> ((EFI_HANDLE)&Record->Link);
> 
> +      break;
> 
> +    default:
> 
> +      Status = EFI_UNSUPPORTED;
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescIoTrap[4] = {
> 
> +  //
> 
> +  // PCH I/O Trap register 0 monitor
> 
> +  //
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG0) }
> 
> +        },
> 
> +        4,
> 
> +        0
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
> 
> +        },
> 
> +        1,
> 
> +        0
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_MONITOR
> 
> +    }
> 
> +  },
> 
> +  //
> 
> +  // PCH I/O Trap register 1 monitor
> 
> +  //
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG1) }
> 
> +        },
> 
> +        4,
> 
> +        0
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
> 
> +        },
> 
> +        1,
> 
> +        1
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_MONITOR
> 
> +    }
> 
> +  },
> 
> +  //
> 
> +  // PCH I/O Trap register 2 monitor
> 
> +  //
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG2) }
> 
> +        },
> 
> +        4,
> 
> +        0
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
> 
> +        },
> 
> +        1,
> 
> +        2
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_MONITOR
> 
> +    }
> 
> +  },
> 
> +  //
> 
> +  // PCH I/O Trap register 3 monitor,
> 
> +  //
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPREG3) }
> 
> +        },
> 
> +        4,
> 
> +        0
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          PCR_ADDR_TYPE,
> 
> +          {PCH_PCR_ADDRESS (PID_PSTH, R_PSTH_PCR_TRPST) }
> 
> +        },
> 
> +        1,
> 
> +        3
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_MONITOR
> 
> +    }
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of IoTrap event.
> 
> +  This is internal function and only used by Iotrap module.
> 
> +
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  IoTrapIndex               Index number of IOTRAP register
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalIoTrapSmiRegister (
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  IN  UINTN                             IoTrapIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescIoTrap[IoTrapIndex],
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchIoTrapSmiType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescIoTrap[IoTrapIndex]);
> 
> +  PchSmmEnableSource (&mSrcDescIoTrap[IoTrapIndex]);
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalIoTrapSmiUnRegister (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  )
> 
> +{
> 
> +  return PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tcher.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tcher.inf
> new file mode 100644
> index 0000000000..97ad2f457e
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiDispa
> tcher.inf
> @@ -0,0 +1,116 @@
> +## @file
> 
> +# Component description file for the Pch SMI Dispatch Handlers module
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = PchSmiDispatcher
> 
> +FILE_GUID = B0D6ED53-B844-43f5-BD2F-61095264E77E
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_SMM_DRIVER
> 
> +PI_SPECIFICATION_VERSION = 1.10
> 
> +ENTRY_POINT = InitializePchSmmDispatcher
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiBootServicesTableLib
> 
> +UefiDriverEntryPoint
> 
> +IoLib
> 
> +DebugLib
> 
> +PcdLib
> 
> +BaseLib
> 
> +BaseMemoryLib
> 
> +HobLib
> 
> +DevicePathLib
> 
> +PchCycleDecodingLib
> 
> +PchPcieRpLib
> 
> +PchPcrLib
> 
> +SmmServicesTableLib
> 
> +ReportStatusCodeLib
> 
> +PerformanceLib
> 
> +DxeServicesTableLib
> 
> +GpioLib
> 
> +GpioPrivateLib
> 
> +EspiLib
> 
> +S3BootScriptLib
> 
> +ConfigBlockLib
> 
> +PmcPrivateLib
> 
> +PmcLib
> 
> +SmiHandlerProfileLib
> 
> +CpuPcieRpLib
> 
> +PchPciBdfLib
> 
> +PmcPrivateLibWithS3
> 
> +CpuPcieInfoFruLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Pcd]
> 
> +# Progress Code for S3 Suspend start.
> 
> +# PROGRESS_CODE_S3_SUSPEND_START = (EFI_SOFTWARE_SMM_DRIVER
> | (EFI_OEM_SPECIFIC | 0x00000000))    = 0x03078000
> 
> +gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendStart
> 
> +# Progress Code for S3 Suspend end.
> 
> +# PROGRESS_CODE_S3_SUSPEND_END   = (EFI_SOFTWARE_SMM_DRIVER
> | (EFI_OEM_SPECIFIC | 0x00000001))    = 0x03078001
> 
> +gSiPkgTokenSpaceGuid.PcdProgressCodeS3SuspendEnd
> 
> +gSiPkgTokenSpaceGuid.PcdEfiGcdAllocateType
> 
> +
> 
> +
> 
> +[Sources]
> 
> +PchSmm.h
> 
> +PchSmmCore.c
> 
> +PchSmmHelpers.h
> 
> +PchSmmHelpers.c
> 
> +PchxSmmHelpers.h
> 
> +PchxSmmHelpers.c
> 
> +PchSmmUsb.c
> 
> +PchSmmGpi.c
> 
> +PchSmmPowerButton.c
> 
> +PchSmmSw.c
> 
> +PchSmmSx.c
> 
> +PchSmmPeriodicTimer.c
> 
> +IoTrap.c
> 
> +PchSmiDispatch.c
> 
> +PchSmmEspi.c
> 
> +PchSmiHelperClient.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gEfiPciRootBridgeIoProtocolGuid ## CONSUMES
> 
> +gEfiSmmGpiDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmSxDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmSwDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmUsbDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmPowerButtonDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmPeriodicTimerDispatch2ProtocolGuid ## PRODUCES
> 
> +gEfiSmmBase2ProtocolGuid ## CONSUMES
> 
> +gEfiSmmCpuProtocolGuid ## CONSUMES
> 
> +gEfiSmmReadyToLockProtocolGuid ## CONSUMES
> 
> +gEfiSmmIoTrapDispatch2ProtocolGuid ## PRODUCES
> 
> +gPchSmmIoTrapControlGuid ## PRODUCES
> 
> +gPchTcoSmiDispatchProtocolGuid ## PRODUCES
> 
> +gPchPcieSmiDispatchProtocolGuid ## PRODUCES
> 
> +gPchAcpiSmiDispatchProtocolGuid ## PRODUCES
> 
> +gPchSmiDispatchProtocolGuid ## PRODUCES
> 
> +gPchEspiSmiDispatchProtocolGuid ## PRODUCES
> 
> +gPchSmmPeriodicTimerControlGuid ## PRODUCES
> 
> +gIoTrapExDispatchProtocolGuid ## PRODUCES
> 
> +gPchNvsAreaProtocolGuid ## CONSUMES
> 
> +
> 
> +
> 
> +[Guids]
> 
> +
> 
> +
> 
> +[Depex]
> 
> +gEfiPciRootBridgeIoProtocolGuid AND
> 
> +gEfiPciHostBridgeResourceAllocationProtocolGuid AND ## This is to ensure
> that PCI MMIO resource has been prepared and available for this driver to
> allocate.
> 
> +gEfiSmmCpuProtocolGuid AND
> 
> +gEfiSmmBase2ProtocolGuid AND ## This is for SmmServicesTableLib
> 
> +gPchNvsAreaProtocolGuid
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> er.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> er.h
> new file mode 100644
> index 0000000000..189197f4a2
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> er.h
> @@ -0,0 +1,40 @@
> +/** @file
> 
> +  eSPI SMI Dispatch header

PCH SMI Helper Header

> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_SMI_HELPER_H_
> 
> +#define _PCH_SMI_HELPER_H_
> 
> +#include <Uefi/UefiBaseType.h>
> 
> +
> 
> +/**
> 
> +  Get Root Port physical Number by CPU or PCH Pcie Root Port Device and
> Function Number
> 
> +
> 
> +  @param[in]  RpDev                 Root port device number.
> 
> +  @param[in]  RpFun                 Root port function number.
> 
> +  @param[out] RpNumber              Return corresponding physical Root Port
> index (0-based)
> 
> +**/
> 
> +VOID
> 
> +GetPcieRpNumber (
> 
> +  IN  UINTN   RpDev,
> 
> +  IN  UINTN   RpFun,
> 
> +  OUT UINTN   *RpNumber
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get CPU or PCH Pcie Root Port Device and Function Number by Root Port
> physical Number
> 
> +
> 
> +  @param[in]  RpNumber              Root port physical number. (0-based)
> 
> +  @param[out] RpDev                 Return corresponding root port device
> number.
> 
> +  @param[out] RpFun                 Return corresponding root port function
> number.
> 
> +**/
> 
> +VOID
> 
> +GetPcieRpDevFun (
> 
> +  IN  UINTN   RpIndex,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> erClient.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> erClient.c
> new file mode 100644
> index 0000000000..7693e76683
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmiHelp
> erClient.c
> @@ -0,0 +1,57 @@
> +/** @file
> 
> +  This file provides function to handle client-server differences.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <Library/CpuPcieRpLib.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +
> 
> +/**
> 
> +  Get Root Port physical Number by CPU or PCH Pcie Root Port Device and
> Function Number
> 
> +
> 
> +  @param[in]  RpDev                 Root port device number.
> 
> +  @param[in]  RpFun                 Root port function number.
> 
> +  @param[out] RpNumber              Return corresponding physical Root Port
> index (0-based)
> 
> +**/
> 
> +VOID
> 
> +GetPcieRpNumber (
> 
> +  IN  UINTN   RpDev,
> 
> +  IN  UINTN   RpFun,
> 
> +  OUT UINTN   *RpNumber
> 
> +  )
> 
> +{
> 
> +  UINT64  RpBase;
> 
> +  RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS,
> RpDev, RpFun, 0);
> 
> +  GetPchPcieRpNumber (RpDev, RpFun, RpNumber);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Get CPU or PCH Pcie Root Port Device and Function Number by Root Port
> physical Number
> 
> +
> 
> +  @param[in]  RpNumber              Root port physical number. (0-based)
> 
> +  @param[out] RpDev                 Return corresponding root port device
> number.
> 
> +  @param[out] RpFun                 Return corresponding root port function
> number.
> 
> +**/
> 
> +VOID
> 
> +GetPcieRpDevFun (
> 
> +  IN  UINTN   RpIndex,
> 
> +  OUT UINTN   *RpDev,
> 
> +  OUT UINTN   *RpFun
> 
> +  )
> 
> +{
> 
> +  if (RpIndex >= CpuRpIndex0 && RpIndex <= CpuRpIndex3) {
> 
> +    GetCpuPcieRpDevFun ((RpIndex - CpuRpIndex0), RpDev, RpFun);
> 
> +  } else {
> 
> +    *RpDev = PchPcieRpDevNumber (RpIndex);
> 
> +    *RpFun = PchPcieRpFuncNumber (RpIndex);
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
> new file mode 100644
> index 0000000000..6a23de2bc9
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmm.h
> @@ -0,0 +1,1043 @@
> +/** @file
> 
> +  Prototypes and defines for the PCH SMM Dispatcher.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCH_SMM_H_
> 
> +#define _PCH_SMM_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <Protocol/PciRootBridgeIo.h>
> 
> +#include <Protocol/LoadedImage.h>
> 
> +#include <Protocol/SmmControl2.h>
> 
> +#include <Protocol/SmmUsbDispatch2.h>
> 
> +#include <Protocol/SmmSxDispatch2.h>
> 
> +#include <Protocol/SmmSwDispatch2.h>
> 
> +#include <Protocol/SmmGpiDispatch2.h>
> 
> +#include <Protocol/SmmPowerButtonDispatch2.h>
> 
> +#include <Protocol/SmmPeriodicTimerDispatch2.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/DxeServicesTableLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/DevicePathLib.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <Library/ReportStatusCodeLib.h>
> 
> +#include <Library/PerformanceLib.h>
> 
> +#include <Protocol/SmmReadyToLock.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Library/PchCycleDecodingLib.h>
> 
> +#include <Library/PchPcieRpLib.h>
> 
> +#include <Library/PchPcrLib.h>
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <Library/EspiLib.h>
> 
> +#include <Library/GpioPrivateLib.h>
> 
> +#include <Protocol/PchTcoSmiDispatch.h>
> 
> +#include <Protocol/PchPcieSmiDispatch.h>
> 
> +#include <Protocol/PchAcpiSmiDispatch.h>
> 
> +#include <Protocol/PchSmiDispatch.h>
> 
> +#include <Protocol/PchEspiSmiDispatch.h>
> 
> +#include <Protocol/IoTrapExDispatch.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include "IoTrap.h"
> 
> +
> 
> +#define EFI_BAD_POINTER          0xAFAFAFAFAFAFAFAFULL
> 
> +
> 
> +extern BOOLEAN                   mReadyToLock;
> 
> +
> 
> +///
> 
> +/// Define an enumeration for all the supported protocols
> 
> +///
> 
> +#define PCH_SMM_PROTOCOL_TYPE_MAX       6
> 
> +
> 
> +typedef enum {
> 
> +  UsbType,
> 
> +  SxType,
> 
> +  SwType,
> 
> +  GpiType,
> 
> +  PowerButtonType,
> 
> +  PeriodicTimerType,
> 
> +  PchSmiDispatchType,
> 
> +  PchSmmProtocolTypeMax
> 
> +} PCH_SMM_PROTOCOL_TYPE;
> 
> +
> 
> +///
> 
> +/// Define all the supported types of PCH SMI
> 
> +///
> 
> +typedef enum {
> 
> +  PchTcoSmiMchType,
> 
> +  PchTcoSmiTcoTimeoutType,
> 
> +  PchTcoSmiOsTcoType,
> 
> +  PchTcoSmiNmiType,
> 
> +  PchTcoSmiIntruderDetectType,
> 
> +  PchTcoSmiSpiBiosWpType,
> 
> +  PchTcoSmiLpcBiosWpType,
> 
> +  PchTcoSmiNewCenturyType,
> 
> +  PchPcieSmiRpHotplugType,
> 
> +  PchPcieSmiRpLinkActiveType,
> 
> +  PchPcieSmiRpLinkEqType,
> 
> +  PchAcpiSmiPmeType,
> 
> +  PchAcpiSmiPmeB0Type,
> 
> +  PchAcpiSmiRtcAlarmType,
> 
> +  PchAcpiSmiTmrOverflowType,
> 
> +  PchEspiSmiEspiSlaveType,
> 
> +  PchSmiSerialIrqType,
> 
> +  PchSmiMcSmiType,
> 
> +  PchSmiSmBusType,
> 
> +  PchSmiSpiAsyncType,
> 
> +  PchIoTrapSmiType                      ///< internal SMI type
> 
> +} PCH_SMI_TYPES;
> 
> +
> 
> +///
> 
> +/// Generic funciton pointer to cover all Pch SMI function pointer types
> 
> +///
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_SMI_CALLBACK_FUNCTIONS) (
> 
> +  IN EFI_HANDLE                         DispatchHandle,
> 
> +  ...
> 
> +  );
> 
> +
> 
> +
> 
> +///
> 
> +/// SPECIFYING A REGISTER
> 
> +/// We want a general way of referring to addresses.  For this case, we'll
> only
> 
> +/// need addresses in the ACPI table (and the TCO entries within the ACPI
> table).
> 
> +/// However, it's interesting to consider what it would take to support other
> types
> 
> +/// of addresses.  To address Will's concern, I think it prudent to
> accommodate it
> 
> +/// early on in the design.
> 
> +///
> 
> +/// Addresses we need to consider:
> 
> +///
> 
> +///  Type:                           Required:
> 
> +///  I/O                             Yes
> 
> +///    ACPI (special case of I/O)    Only if we want to
> 
> +///    TCO  (special case of I/O)    Only if we want to
> 
> +///  GPIO  (special case of MMIO)    Only if we want to
> 
> +///  Memory (or Memory Mapped I/O)   Only if we want to
> 
> +///  PCIE                            Yes, for BiosWp
> 
> +///
> 
> +typedef enum {
> 
> +  ///
> 
> +  ///  IO_ADDR_TYPE, /// unimplemented
> 
> +  ///
> 
> +  ACPI_ADDR_TYPE,
> 
> +  TCO_ADDR_TYPE,
> 
> +  ///
> 
> +  ///  MEMORY_ADDR_TYPE, /// unimplemented
> 
> +  ///
> 
> +  GPIO_ADDR_TYPE,
> 
> +  MEMORY_MAPPED_IO_ADDRESS_TYPE,
> 
> +  PCIE_ADDR_TYPE,
> 
> +  PCR_ADDR_TYPE,
> 
> +  NUM_ADDR_TYPES,                     ///< count of items in this enum
> 
> +  PCH_SMM_ADDR_TYPE_NULL        = -1  ///< sentinel to indicate NULL or to
> signal end of arrays
> 
> +} ADDR_TYPE;
> 
> +
> 
> +//
> 
> +// Assumption: 32-bits -- enum's evaluate to integer
> 
> +// Assumption: This code will only run on IA-32.  Justification: IA-64 doesn't
> have SMIs.
> 
> +// We don't have to worry about 64-bit addresses.
> 
> +// Typedef the size of addresses in case the numbers I'm using are wrong or
> in case
> 
> +// this changes.  This is a good idea because PCI_ADDR will change, for
> example, when
> 
> +// we add support for PciExpress.
> 
> +//
> 
> +typedef UINT16 IO_ADDR;
> 
> +typedef IO_ADDR ACPI_ADDR;  ///< can omit
> 
> +typedef IO_ADDR TCO_ADDR;   ///< can omit
> 
> +typedef UINTN MEM_ADDR;
> 
> +typedef MEM_ADDR *MEMORY_MAPPED_IO_ADDRESS;
> 
> +typedef MEM_ADDR *GPIO_ADDR;
> 
> +typedef union {
> 
> +  UINT32  Raw;
> 
> +  struct {
> 
> +    UINT32 Reg: 16;
> 
> +    UINT32 Fnc: 3;
> 
> +    UINT32 Dev: 5;
> 
> +    UINT32 Bus: 8;
> 
> +  } Fields;
> 
> +} PCIE_ADDR;
> 
> +
> 
> +typedef union {
> 
> +  UINT32  Raw;
> 
> +  struct {
> 
> +    UINT16 Offset;
> 
> +    UINT8  Pid;
> 
> +    UINT8  Base;
> 
> +  } Fields;
> 
> +} PCR_ADDR;
> 
> +
> 
> +typedef struct {
> 
> +  ADDR_TYPE Type;
> 
> +  union {
> 
> +    ///
> 
> +    /// used to initialize during declaration/definition
> 
> +    ///
> 
> +    UINT32                    raw;
> 
> +
> 
> +    ///
> 
> +    /// used to access useful data
> 
> +    ///
> 
> +    IO_ADDR                   io;
> 
> +    ACPI_ADDR                 acpi;
> 
> +    TCO_ADDR                  tco;
> 
> +    GPIO_ADDR                 gpio;
> 
> +    MEM_ADDR                  mem;
> 
> +    MEMORY_MAPPED_IO_ADDRESS  Mmio;
> 
> +    PCIE_ADDR                 pcie;
> 
> +    PCR_ADDR                  Pcr;
> 
> +
> 
> +  } Data;
> 
> +
> 
> +} PCH_SMM_ADDRESS;
> 
> +
> 
> +///
> 
> +/// SPECIFYING BITS WITHIN A REGISTER
> 
> +/// Here's a struct that helps us specify a source or enable bit.
> 
> +///
> 
> +typedef struct {
> 
> +  PCH_SMM_ADDRESS Reg;
> 
> +  UINT8           SizeInBytes;  ///< of the register
> 
> +  UINT8           Bit;
> 
> +} PCH_SMM_BIT_DESC;
> 
> +
> 
> +//
> 
> +// Sometimes, we'll have bit descriptions that are unused.  It'd be great to
> have a
> 
> +// way to easily identify them:
> 
> +//
> 
> +#define IS_BIT_DESC_NULL(BitDesc)   ((BitDesc).Reg.Type ==
> PCH_SMM_ADDR_TYPE_NULL)  ///< "returns" true when BitDesc is NULL
> 
> +#define NULL_THIS_BIT_DESC(BitDesc) ((BitDesc).Reg.Type =
> PCH_SMM_ADDR_TYPE_NULL)   ///< will "return" an integer w/ value of 0
> 
> +#define NULL_BIT_DESC_INITIALIZER \
> 
> +  { \
> 
> +    { \
> 
> +      PCH_SMM_ADDR_TYPE_NULL, \
> 
> +      { \
> 
> +        0 \
> 
> +      } \
> 
> +    }, \
> 
> +    0, 0 \
> 
> +  }
> 
> +//
> 
> +// I'd like a type to specify the callback's Sts & En bits because they'll
> 
> +// be commonly used together:
> 
> +//
> 
> +#define NUM_EN_BITS   2
> 
> +#define NUM_STS_BITS  1
> 
> +
> 
> +//
> 
> +// Flags
> 
> +//
> 
> +typedef UINT8 PCH_SMM_SOURCE_FLAGS;
> 
> +
> 
> +//
> 
> +// Flags required to describe the event source
> 
> +//
> 
> +#define PCH_SMM_NO_FLAGS          0
> 
> +#define PCH_SMM_SCI_EN_DEPENDENT  1
> 
> +
> 
> +typedef struct {
> 
> +  PCH_SMM_SOURCE_FLAGS  Flags;
> 
> +  PCH_SMM_BIT_DESC      En[NUM_EN_BITS];    ///< Describes the enable
> bit(s) for the SMI event
> 
> +  PCH_SMM_BIT_DESC      Sts[NUM_STS_BITS];  ///< Describes the
> secondary status bit for the SMI event. Might be the same as TopLevelSmi
> 
> +  PCH_SMM_BIT_DESC      PmcSmiSts;          ///< Refereing to the top level
> status bit in PMC SMI_STS, i.e. R_PCH_SMI_STS
> 
> +} PCH_SMM_SOURCE_DESC;
> 
> +
> 
> +///
> 
> +/// Used to initialize null source descriptor
> 
> +///
> 
> +#define NULL_SOURCE_DESC_INITIALIZER \
> 
> +  { \
> 
> +    PCH_SMM_NO_FLAGS, \
> 
> +    { \
> 
> +      NULL_BIT_DESC_INITIALIZER, NULL_BIT_DESC_INITIALIZER \
> 
> +    }, \
> 
> +    { \
> 
> +      NULL_BIT_DESC_INITIALIZER \
> 
> +    }, \
> 
> +    NULL_BIT_DESC_INITIALIZER \
> 
> +  }
> 
> +
> 
> +///
> 
> +/// Define a PCIE RP event context for SmiProfileHandlerInfo tool
> 
> +///
> 
> +typedef struct {
> 
> +  PCH_SMI_TYPES               PchSmiType;
> 
> +  UINTN                       RpIndex;
> 
> +} PCH_SMM_PCIE_REGISTER_CONTEXT;
> 
> +
> 
> +///
> 
> +/// CHILD CONTEXTS
> 
> +/// To keep consistent w/ the architecture, we'll need to provide the
> context
> 
> +/// to the child when we call its callback function.  After talking with Will,
> 
> +/// we agreed that we'll need functions to "dig" the context out of the
> hardware
> 
> +/// in many cases (Sx, Trap, Gpi, etc), and we'll need a function to compare
> those
> 
> +/// contexts to prevent unnecessary dispatches.  I'd like a general type for
> these
> 
> +/// "GetContext" functions, so I'll need a union of all the protocol contexts
> for
> 
> +/// our internal use:
> 
> +///
> 
> +typedef union {
> 
> +  //
> 
> +  // (in no particular order)
> 
> +  //
> 
> +  EFI_SMM_SX_REGISTER_CONTEXT             Sx;
> 
> +  EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT PeriodicTimer;
> 
> +  EFI_SMM_SW_REGISTER_CONTEXT             Sw;
> 
> +  EFI_SMM_POWER_BUTTON_REGISTER_CONTEXT   PowerButton;
> 
> +  EFI_SMM_USB_REGISTER_CONTEXT            Usb;
> 
> +  EFI_SMM_GPI_REGISTER_CONTEXT            Gpi;
> 
> +  PCH_SMM_PCIE_REGISTER_CONTEXT           Pcie;
> 
> +} PCH_SMM_CONTEXT;
> 
> +
> 
> +///
> 
> +/// Misc data for PchDispatcher usage.
> 
> +/// For PeriodicTimer, since the ElapsedTime is removed from
> EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT of EDKII,
> 
> +/// and PchDispatcher needs it for every record. Thus move it here to
> support ElapsedTime.
> 
> +///
> 
> +typedef struct {
> 
> +  UINTN    ElapsedTime;
> 
> +  ///
> 
> +  /// A switch to control periodic timer SMI enabling
> 
> +  ///
> 
> +  BOOLEAN  TimerSmiEnabled;
> 
> +} PCH_SMM_MISC_DATA;
> 
> +
> 
> +//
> 
> +// Assumption: PeriodicTimer largest at 3x64-bits or 24 bytes
> 
> +//
> 
> +typedef struct _DATABASE_RECORD DATABASE_RECORD;
> 
> +
> 
> +///
> 
> +/// Assumption: the GET_CONTEXT function will be as small and simple as
> possible.
> 
> +/// Assumption: We don't need to pass in an enumeration for the protocol
> because each
> 
> +///    GET_CONTEXT function is written for only one protocol.
> 
> +/// We also need a function to compare contexts to see if the child should
> be dispatched
> 
> +/// In addition, we need a function to acquire CommBuffer and
> CommBufferSize for
> 
> +///    dispatch callback function of EDKII native support.
> 
> +///
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *GET_CONTEXT) (
> 
> +  IN  DATABASE_RECORD    * Record,
> 
> +  OUT PCH_SMM_CONTEXT    * Context
> 
> +  );
> 
> +
> 
> +typedef
> 
> +BOOLEAN
> 
> +(EFIAPI *CMP_CONTEXT) (
> 
> +  IN PCH_SMM_CONTEXT     * Context1,
> 
> +  IN PCH_SMM_CONTEXT     * Context2
> 
> +  );
> 
> +
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *GET_COMMBUFFER) (
> 
> +  IN  DATABASE_RECORD    * Record,
> 
> +  OUT VOID               **CommBuffer,
> 
> +  OUT UINTN              * CommBufferSize
> 
> +  );
> 
> +
> 
> +///
> 
> +/// Finally, every protocol will require a "Get Context" and "Compare
> Context" call, so
> 
> +/// we may as well wrap that up in a table, too.
> 
> +///
> 
> +typedef struct {
> 
> +  GET_CONTEXT     GetContext;
> 
> +  CMP_CONTEXT     CmpContext;
> 
> +  GET_COMMBUFFER  GetCommBuffer;
> 
> +} CONTEXT_FUNCTIONS;
> 
> +
> 
> +extern CONTEXT_FUNCTIONS
> ContextFunctions[PCH_SMM_PROTOCOL_TYPE_MAX];
> 
> +
> 
> +///
> 
> +/// MAPPING CONTEXT TO BIT DESCRIPTIONS
> 
> +/// I'd like to have a general approach to mapping contexts to bit
> descriptions.
> 
> +/// Sometimes, we'll find that we can use table lookups or constant
> assignments;
> 
> +/// other times, we'll find that we'll need to use a function to perform the
> mapping.
> 
> +/// If we define a macro to mask that process, we'll never have to change
> the code.
> 
> +/// I don't know if this is desirable or not -- if it isn't, then we can get rid
> 
> +/// of the macros and just use function calls or variable assignments.
> Doesn't matter
> 
> +/// to me.
> 
> +/// Mapping complex contexts requires a function
> 
> +///
> 
> +
> 
> +/**
> 
> +  Maps a USB context to a source description.
> 
> +
> 
> +  @param[in] Context              The context we need to map.  Type must be
> USB.
> 
> +  @param[out] SrcDesc             The source description that corresponds to
> the given context.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +MapUsbToSrcDesc (
> 
> +  IN  PCH_SMM_CONTEXT         *Context,
> 
> +  OUT PCH_SMM_SOURCE_DESC     *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Figure out which timer the child is requesting and
> 
> +  send back the source description
> 
> +
> 
> +  @param[in] DispatchContext      The pointer to the Dispatch Context
> instances
> 
> +  @param[out] SrcDesc             The pointer to the source description
> 
> +
> 
> +**/
> 
> +VOID
> 
> +MapPeriodicTimerToSrcDesc (
> 
> +  IN  PCH_SMM_CONTEXT                                         *DispatchContext,
> 
> +  OUT PCH_SMM_SOURCE_DESC                                     *SrcDesc
> 
> +  );
> 
> +
> 
> +//
> 
> +// Mapping simple contexts can be done by assignment or lookup table
> 
> +//
> 
> +extern CONST PCH_SMM_SOURCE_DESC  mSxSourceDesc;
> 
> +extern CONST PCH_SMM_SOURCE_DESC  mPowerButtonSourceDesc;
> 
> +extern CONST PCH_SMM_SOURCE_DESC  mSrcDescNewCentury;
> 
> +extern CONST PCH_SMM_SOURCE_DESC  mGpiSourceDescTemplate;
> 
> +
> 
> +///
> 
> +/// For PCHx, APMC is UINT8 port, so the MAX SWI Value is 0xFF.
> 
> +///
> 
> +#define MAXIMUM_SWI_VALUE 0xFF
> 
> +///
> 
> +/// Open: Need to make sure this kind of type cast will actually work.
> 
> +///   May need an intermediate form w/ two VOID* arguments.  I'll figure
> 
> +///   that out when I start compiling.
> 
> +///
> 
> +typedef
> 
> +VOID
> 
> +(EFIAPI *PCH_SMM_CLEAR_SOURCE) (
> 
> +  CONST PCH_SMM_SOURCE_DESC * SrcDesc
> 
> +  );
> 
> +
> 
> +///
> 
> +/// "DATABASE" RECORD
> 
> +/// Linked list data structures
> 
> +///
> 
> +#define DATABASE_RECORD_SIGNATURE SIGNATURE_32 ('D', 'B', 'R', 'C')
> 
> +
> 
> +struct _DATABASE_RECORD {
> 
> +  UINT32                        Signature;
> 
> +  LIST_ENTRY                    Link;
> 
> +  BOOLEAN                       Processed;
> 
> +  ///
> 
> +  /// Status and Enable bit description
> 
> +  ///
> 
> +  PCH_SMM_SOURCE_DESC           SrcDesc;
> 
> +
> 
> +  ///
> 
> +  /// Callback function
> 
> +  ///
> 
> +  EFI_SMM_HANDLER_ENTRY_POINT2  Callback;
> 
> +  PCH_SMM_CONTEXT               ChildContext;
> 
> +  UINTN                         ContextSize;
> 
> +
> 
> +  ///
> 
> +  /// Special handling hooks -- init them to NULL if unused/unneeded
> 
> +  ///
> 
> +  PCH_SMM_CLEAR_SOURCE          ClearSource;
> 
> +
> 
> +  ///
> 
> +  /// Functions required to make callback code general
> 
> +  ///
> 
> +  CONTEXT_FUNCTIONS             ContextFunctions;
> 
> +
> 
> +  ///
> 
> +  /// The protocol that this record dispatches
> 
> +  ///
> 
> +  PCH_SMM_PROTOCOL_TYPE         ProtocolType;
> 
> +
> 
> +  ///
> 
> +  /// Misc data for private usage
> 
> +  ///
> 
> +  PCH_SMM_MISC_DATA             MiscData;
> 
> +
> 
> +  ///
> 
> +  /// PCH SMI callback function
> 
> +  ///
> 
> +  PCH_SMI_CALLBACK_FUNCTIONS    PchSmiCallback;
> 
> +  ///
> 
> +  /// Indicate the PCH SMI types.
> 
> +  ///
> 
> +  PCH_SMI_TYPES                 PchSmiType;
> 
> +};
> 
> +
> 
> +#define DATABASE_RECORD_FROM_LINK(_record)  CR (_record,
> DATABASE_RECORD, Link, DATABASE_RECORD_SIGNATURE)
> 
> +#define DATABASE_RECORD_FROM_CHILDCONTEXT(_record)  CR (_record,
> DATABASE_RECORD, ChildContext, DATABASE_RECORD_SIGNATURE)
> 
> +
> 
> +///
> 
> +/// HOOKING INTO THE ARCHITECTURE
> 
> +///
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMM_GENERIC_REGISTER) (
> 
> +  IN  VOID                                    **This,
> 
> +  IN  VOID                                    *DispatchFunction,
> 
> +  IN  VOID                                    *DispatchContext,
> 
> +  OUT EFI_HANDLE                              *DispatchHandle
> 
> +  );
> 
> +typedef
> 
> +EFI_STATUS
> 
> +(EFIAPI *PCH_SMM_GENERIC_UNREGISTER) (
> 
> +  IN  VOID                                    **This,
> 
> +  IN  EFI_HANDLE                              DispatchHandle
> 
> +  );
> 
> +
> 
> +///
> 
> +/// Define a memory "stamp" equivalent in size and function to most of the
> protocols
> 
> +///
> 
> +typedef struct {
> 
> +  PCH_SMM_GENERIC_REGISTER    Register;
> 
> +  PCH_SMM_GENERIC_UNREGISTER  Unregister;
> 
> +  UINTN                       Extra1;
> 
> +  UINTN                       Extra2; ///< may not need this one
> 
> +} PCH_SMM_GENERIC_PROTOCOL;
> 
> +
> 
> +/**
> 
> +  Register a child SMI dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL
> instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for this SMI source.
> 
> +  @param[in] DispatchContext      Pointer to the dispatch function's context.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function, for when
> interfacing
> 
> +                                  with the parent SMM driver, will be the address of linked
> 
> +                                  list link in the call back record.
> 
> +
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources to create
> database record
> 
> +  @retval EFI_INVALID_PARAMETER   The input parameter is invalid
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPiSmmCoreRegister (
> 
> +  IN  PCH_SMM_GENERIC_PROTOCOL                          *This,
> 
> +  IN  EFI_SMM_HANDLER_ENTRY_POINT2                      DispatchFunction,
> 
> +  IN  PCH_SMM_CONTEXT                                   *DispatchContext,
> 
> +  OUT EFI_HANDLE                                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPiSmmCoreUnRegister (
> 
> +  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
> 
> +  IN EFI_HANDLE                                         *DispatchHandle
> 
> +  );
> 
> +
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL
> instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmCoreUnRegister (
> 
> +  IN  PCH_SMM_GENERIC_PROTOCOL                         *This,
> 
> +  IN  EFI_HANDLE                                       *DispatchHandle
> 
> +  );
> 
> +
> 
> +typedef union {
> 
> +  PCH_SMM_GENERIC_PROTOCOL                    Generic;
> 
> +  EFI_SMM_USB_DISPATCH2_PROTOCOL              Usb;
> 
> +  EFI_SMM_SX_DISPATCH2_PROTOCOL               Sx;
> 
> +  EFI_SMM_SW_DISPATCH2_PROTOCOL               Sw;
> 
> +  EFI_SMM_GPI_DISPATCH2_PROTOCOL              Gpi;
> 
> +  EFI_SMM_POWER_BUTTON_DISPATCH2_PROTOCOL     PowerButton;
> 
> +  EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL   PeriodicTimer;
> 
> +} PCH_SMM_PROTOCOL;
> 
> +
> 
> +///
> 
> +/// Define a structure to help us identify the generic protocol
> 
> +///
> 
> +#define PROTOCOL_SIGNATURE  SIGNATURE_32 ('P', 'R', 'O', 'T')
> 
> +
> 
> +typedef struct {
> 
> +  UINTN                 Signature;
> 
> +
> 
> +  PCH_SMM_PROTOCOL_TYPE Type;
> 
> +  EFI_GUID              *Guid;
> 
> +  PCH_SMM_PROTOCOL      Protocols;
> 
> +} PCH_SMM_QUALIFIED_PROTOCOL;
> 
> +
> 
> +#define QUALIFIED_PROTOCOL_FROM_GENERIC(_generic) \
> 
> +  CR ( \
> 
> +  _generic, \
> 
> +  PCH_SMM_QUALIFIED_PROTOCOL, \
> 
> +  Protocols, \
> 
> +  PROTOCOL_SIGNATURE \
> 
> +  )
> 
> +
> 
> +///
> 
> +/// Create private data for the protocols that we'll publish
> 
> +///
> 
> +typedef struct {
> 
> +  LIST_ENTRY                  CallbackDataBase;
> 
> +  EFI_HANDLE                  SmiHandle;
> 
> +  EFI_HANDLE                  InstallMultProtHandle;
> 
> +  PCH_SMM_QUALIFIED_PROTOCOL
> Protocols[PCH_SMM_PROTOCOL_TYPE_MAX];
> 
> +} PRIVATE_DATA;
> 
> +
> 
> +extern PRIVATE_DATA           mPrivateData;
> 
> +extern UINT16                 mAcpiBaseAddr;
> 
> +extern UINT16                 mTcoBaseAddr;
> 
> +
> 
> +/**
> 
> +  The internal function used to create and insert a database record
> 
> +
> 
> +  @param[in]  InsertRecord              Record to insert to database.
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +SmmCoreInsertRecord (
> 
> +  IN  DATABASE_RECORD                   *NewRecord,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get the Sleep type
> 
> +
> 
> +  @param[in] Record               No use
> 
> +  @param[out] Context             The context that includes SLP_TYP bits to be
> filled
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SxGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *Context
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for the specified software
> SMI.
> 
> +
> 
> +  This service registers a function (DispatchFunction) which will be called
> when the software
> 
> +  SMI source specified by RegisterContext->SwSmiCpuIndex is detected. On
> return,
> 
> +  DispatchHandle contains a unique handle which may be used later to
> unregister the function
> 
> +  using UnRegister().
> 
> +
> 
> +  @param[in]  This                 Pointer to the
> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in]  DispatchFunction     Function to register for handler when the
> specified software
> 
> +                                   SMI is generated.
> 
> +  @param[in, out] RegisterContext  Pointer to the dispatch function's
> context.
> 
> +                                   The caller fills this context in before calling
> 
> +                                   the register function to indicate to the register
> 
> +                                   function which Software SMI input value the
> 
> +                                   dispatch function should be invoked for.
> 
> +  @param[out] DispatchHandle       Handle generated by the dispatcher to
> track the
> 
> +                                   function instance.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> 
> +                                 registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR       The SW driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The SW SMI
> input value
> 
> +                                 is not within a valid range or is already in use.
> 
> +  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system
> or SMM) to manage this
> 
> +                                 child.
> 
> +  @retval EFI_OUT_OF_RESOURCES   A unique software SMI value could not
> be assigned
> 
> +                                 for this dispatch.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSwSmiRegister (
> 
> +  IN  EFI_SMM_SW_DISPATCH2_PROTOCOL       *This,
> 
> +  IN  EFI_SMM_HANDLER_ENTRY_POINT2        DispatchFunction,
> 
> +  IN  EFI_SMM_SW_REGISTER_CONTEXT         *DispatchContext,
> 
> +  OUT EFI_HANDLE                          *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function for the specified software
> SMI.
> 
> +
> 
> +  This service removes the handler associated with DispatchHandle so that it
> will no longer be
> 
> +  called in response to a software SMI.
> 
> +
> 
> +  @param[in] This                Pointer to the
> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle      Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> unregistered.
> 
> +  @retval EFI_INVALID_PARAMETER  The DispatchHandle was not valid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSwSmiUnRegister (
> 
> +  IN CONST EFI_SMM_SW_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_HANDLE                     DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Init required protocol for Pch Sw Dispatch protocol.
> 
> +**/
> 
> +VOID
> 
> +PchSwDispatchInit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether sleep type of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes sleep type 1
> 
> +  @param[in] Context2             Context 2 that includes sleep type 2
> 
> +
> 
> +  @retval FALSE                   Sleep types match
> 
> +  @retval TRUE                    Sleep types don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +SxCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *Context1,
> 
> +  IN PCH_SMM_CONTEXT     *Context2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Update the elapsed time from the Interval data of DATABASE_RECORD
> 
> +
> 
> +  @param[in] Record               The pointer to the DATABASE_RECORD.
> 
> +  @param[out] HwContext           The Context to be updated.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PeriodicTimerGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *Context
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether Periodic Timer of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes Periodic Timer  1
> 
> +  @param[in] Context2             Context 2 that includes Periodic Timer  2
> 
> +
> 
> +  @retval FALSE                   Periodic Timer match
> 
> +  @retval TRUE                    Periodic Timer don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +PeriodicTimerCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *Context1,
> 
> +  IN PCH_SMM_CONTEXT     *Context2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Gather the CommBuffer information of SmmPeriodicTimerDispatch2.
> 
> +
> 
> +  @param[in]  Record              No use
> 
> +  @param[out] CommBuffer          Point to the CommBuffer structure
> 
> +  @param[out] CommBufferSize      Point to the Size of CommBuffer
> structure
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PeriodicTimerGetCommBuffer (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT VOID               **CommBuffer,
> 
> +  OUT UINTN              *CommBufferSize
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Get the power button status.
> 
> +
> 
> +  @param[in] Record               The pointer to the DATABASE_RECORD.
> 
> +  @param[out] Context             Calling context from the hardware, will be
> updated with the current power button status.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PowerButtonGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *Context
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check whether Power Button status of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes Power Button status 1
> 
> +  @param[in] Context2             Context 2 that includes Power Button status 2
> 
> +
> 
> +  @retval FALSE                   Power Button status match
> 
> +  @retval TRUE                    Power Button status don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +PowerButtonCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *Context1,
> 
> +  IN PCH_SMM_CONTEXT     *Context2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function is responsible for calculating and enabling any timers that are
> required
> 
> +  to dispatch messages to children. The SrcDesc argument isn't acutally used.
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC
> instance.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchSmmPeriodicTimerClearSource (
> 
> +  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This services returns the next SMI tick period that is supported by the
> chipset.
> 
> +  The order returned is from longest to shortest interval period.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in, out] SmiTickInterval Pointer to pointer of the next shorter SMI
> interval period that is supported by the child.
> 
> +
> 
> +  @retval EFI_SUCCESS             The service returned successfully.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameter SmiTickInterval is
> invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmPeriodicTimerDispatchGetNextShorterInterval (
> 
> +  IN CONST EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL    *This,
> 
> +  IN OUT UINT64                                         **SmiTickInterval
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Install PCH SMM periodic timer control protocol
> 
> +
> 
> +  @param[in] Handle                     handle for this driver
> 
> +
> 
> +  @retval EFI_SUCCESS                   Driver initialization completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchSmmPeriodicTimerControlProtocol (
> 
> +  IN EFI_HANDLE                         Handle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  When we get an SMI that indicates that we are transitioning to a sleep
> state,
> 
> +  we need to actually transition to that state.  We do this by disabling the
> 
> +  "SMI on sleep enable" feature, which generates an SMI when the
> operating system
> 
> +  tries to put the system to sleep, and then physically putting the system to
> sleep.
> 
> +**/
> 
> +VOID
> 
> +PchSmmSxGoToSleep (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Install protocols of PCH specifics SMI types, including
> 
> +  PCH TCO SMI types, PCH PCIE SMI types, PCH ACPI SMI types, PCH MISC
> SMI types.
> 
> +
> 
> +  @retval                               the result of protocol installation
> 
> +**/
> 
> +EFI_STATUS
> 
> +InstallPchSmiDispatchProtocols (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The function to dispatch all callback function of PCH SMI types.
> 
> +
> 
> +  @retval EFI_SUCCESS                   Function successfully completed
> 
> +  @retval EFI_UNSUPPORTED               no
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmiTypeCallbackDispatcher (
> 
> +  IN  DATABASE_RECORD                   *Record
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of IoTrap event.
> 
> +  This is internal function and only used by Iotrap module.
> 
> +
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  IoTrapIndex               Index number of IOTRAP register
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalIoTrapSmiRegister (
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  IN  UINTN                             IoTrapIndex,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalIoTrapSmiUnRegister (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register an eSPI SMI handler based on the type
> 
> +
> 
> +  @param[in]  DispatchFunction        Callback in an event of eSPI SMI
> 
> +  @param[in]  PchSmiTypes             The eSPI type published by
> PchSmiDispatch
> 
> +  @param[out] DispatchHandle          The callback handle
> 
> +
> 
> +  @retval     EFI_INVALID_PARAMETER   Error with NULL SMI source
> description
> 
> +  @retval     EFI_OUT_OF_RESOURCES    Fail to allocate pool for database
> record
> 
> +  @retval     EFI_SUCCESS             Registration is successful.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalEspiSmiRegister (
> 
> +  IN  PCH_SMI_DISPATCH_CALLBACK         DispatchFunction,
> 
> +  IN  PCH_SMI_TYPES                     PchSmiTypes,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister an eSPI SMI handler
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchInternalEspiSmiUnRegister (
> 
> +  IN  EFI_HANDLE                        DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The internal function used to create and insert a database record
> 
> +  for SMI record of Pch Smi types.
> 
> +
> 
> +  @param[in]  SrcDesc                   The pointer to the SMI source description
> 
> +  @param[in]  DispatchFunction          Pointer to dispatch function to be
> invoked for this SMI source
> 
> +  @param[in]  PchSmiType                Specific SMI type of PCH SMI
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmiRecordInsert (
> 
> +  IN  CONST PCH_SMM_SOURCE_DESC         *SrcDesc,
> 
> +  IN  PCH_SMI_CALLBACK_FUNCTIONS        DispatchFunction,
> 
> +  IN  PCH_SMI_TYPES                     PchSmiType,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +extern CONST PCH_SMM_SOURCE_DESC mSrcDescSerialIrq;
> 
> +extern CONST PCH_SMM_SOURCE_DESC mSrcDescLpcBiosWp;
> 
> +
> 
> +/**
> 
> +  Clear the TCO SMI status bit and block after the SMI handling is done
> 
> +
> 
> +  @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchTcoSmiClearSourceAndBlock (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clear the TCO SMI status bit after the SMI handling is done
> 
> +
> 
> +  @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchTcoSmiClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC             *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Initialize Source descriptor structure
> 
> +
> 
> +  @param[in] SrcDesc                    Pointer to the PCH SMI source description
> table
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +NullInitSourceDesc (
> 
> +  PCH_SMM_SOURCE_DESC                   *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of GPI SMI event.
> 
> +
> 
> +  @param[in]  This               Pointer to the
> EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in]  DispatchFunction   Function to register for handler when the
> specified GPI causes an SMI.
> 
> +  @param[in]  RegisterContext    Pointer to the dispatch function's context.
> 
> +                                 The caller fills this context in before calling
> 
> +                                 the register function to indicate to the register
> 
> +                                 function the GPI(s) for which the dispatch function
> 
> +                                 should be invoked.
> 
> +  @param[out] DispatchHandle     Handle generated by the dispatcher to
> track the
> 
> +                                 function instance.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> 
> +                                 registered and the SMI source has been enabled.
> 
> +  @retval EFI_ACCESS_DENIED      Register is not allowed
> 
> +  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The GPI
> input value
> 
> +                                 is not within valid range.
> 
> +  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system
> or SMM) to manage this child.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchGpiSmiRegister (
> 
> +  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_SMM_HANDLER_ENTRY_POINT2    DispatchFunction,
> 
> +  IN       EFI_SMM_GPI_REGISTER_CONTEXT    *RegisterContext,
> 
> +  OUT      EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Unregister a GPI SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchGpiSmiUnRegister (
> 
> +  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_HANDLE                      DispatchHandle
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCor
> e.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCor
> e.c
> new file mode 100644
> index 0000000000..b2e76a8b72
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmCor
> e.c
> @@ -0,0 +1,926 @@
> +/** @file
> 
> +  This driver is responsible for the registration of child drivers
> 
> +  and the abstraction of the PCH SMI sources.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmm.h"
> 
> +#include "PchSmmHelpers.h"
> 
> +#include "PchSmmEspi.h"
> 
> +#include <Library/SmiHandlerProfileLib.h>
> 
> +#include <Register/GpioRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/RtcRegs.h>
> 
> +
> 
> +#define PROGRESS_CODE_S3_SUSPEND_START  PcdGet32
> (PcdProgressCodeS3SuspendStart)
> 
> +//
> 
> +// MODULE / GLOBAL DATA
> 
> +//
> 
> +// Module variables used by the both the main dispatcher and the source
> dispatchers
> 
> +// Declared in PchSmm.h
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16                mAcpiBaseAddr;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16                mTcoBaseAddr;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN               mReadyToLock;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN               mS3SusStart;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PRIVATE_DATA          mPrivateData =
> {
> 
> +  {
> 
> +    NULL,
> 
> +    NULL
> 
> +  },                                    // CallbackDataBase linked list head
> 
> +  NULL,                                 // EFI handle returned when calling
> InstallMultipleProtocolInterfaces
> 
> +  NULL,                                 //
> 
> +  {                                     // protocol arrays
> 
> +    //
> 
> +    // elements within the array
> 
> +    //
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      UsbType,
> 
> +      &gEfiSmmUsbDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
> 
> +      }}
> 
> +    },
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      SxType,
> 
> +      &gEfiSmmSxDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
> 
> +      }}
> 
> +    },
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      SwType,
> 
> +      &gEfiSmmSwDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchSwSmiRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchSwSmiUnRegister,
> 
> +        (UINTN) MAXIMUM_SWI_VALUE
> 
> +      }}
> 
> +    },
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      GpiType,
> 
> +      &gEfiSmmGpiDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchGpiSmiRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchGpiSmiUnRegister,
> 
> +        (UINTN) PCH_GPIO_NUM_SUPPORTED_GPIS
> 
> +      }}
> 
> +    },
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      PowerButtonType,
> 
> +      &gEfiSmmPowerButtonDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister
> 
> +      }}
> 
> +    },
> 
> +    {
> 
> +      PROTOCOL_SIGNATURE,
> 
> +      PeriodicTimerType,
> 
> +      &gEfiSmmPeriodicTimerDispatch2ProtocolGuid,
> 
> +      {{
> 
> +        (PCH_SMM_GENERIC_REGISTER) PchPiSmmCoreRegister,
> 
> +        (PCH_SMM_GENERIC_UNREGISTER) PchPiSmmCoreUnRegister,
> 
> +        (UINTN) PchSmmPeriodicTimerDispatchGetNextShorterInterval
> 
> +      }}
> 
> +    },
> 
> +  }
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONTEXT_FUNCTIONS
> mContextFunctions[PCH_SMM_PROTOCOL_TYPE_MAX] = {
> 
> +  {
> 
> +    NULL,
> 
> +    NULL,
> 
> +    NULL
> 
> +  },
> 
> +  {
> 
> +    SxGetContext,
> 
> +    SxCmpContext,
> 
> +    NULL
> 
> +  },
> 
> +  {
> 
> +    NULL,
> 
> +    NULL,
> 
> +    NULL
> 
> +  },
> 
> +  {
> 
> +    NULL,
> 
> +    NULL,
> 
> +    NULL
> 
> +  },
> 
> +  {
> 
> +    PowerButtonGetContext,
> 
> +    PowerButtonCmpContext,
> 
> +    NULL
> 
> +  },
> 
> +  {
> 
> +    PeriodicTimerGetContext,
> 
> +    PeriodicTimerCmpContext,
> 
> +    PeriodicTimerGetCommBuffer
> 
> +  },
> 
> +};
> 
> +
> 
> +//
> 
> +// PROTOTYPES
> 
> +//
> 
> +// Functions use only in this file
> 
> +//
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmCoreDispatcher (
> 
> +  IN       EFI_HANDLE         SmmImageHandle,
> 
> +  IN CONST VOID               *PchSmmCore,     OPTIONAL
> 
> +  IN OUT   VOID               *CommunicationBuffer,
> 
> +  IN OUT   UINTN              *SourceSize
> 
> +  );
> 
> +
> 
> +//
> 
> +// FUNCTIONS
> 
> +//
> 
> +/**
> 
> +  SMM ready to lock notification event handler.
> 
> +
> 
> +  @param  Protocol   Points to the protocol's unique identifier
> 
> +  @param  Interface  Points to the interface instance
> 
> +  @param  Handle     The handle on which the interface was installed
> 
> +
> 
> +  @retval EFI_SUCCESS   SmmReadyToLockCallback runs successfully
> 
> +
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmReadyToLockCallback (
> 
> +  IN CONST EFI_GUID                       *Protocol,
> 
> +  IN VOID                                 *Interface,
> 
> +  IN EFI_HANDLE                           Handle
> 
> +  )
> 
> +{
> 
> +  mReadyToLock = TRUE;
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  <b>PchSmiDispatcher SMM Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +    The PchSmiDispatcher module is an SMM driver which  provides SMI
> handler registration
> 
> +    services for PCH generated SMIs.
> 
> +
> 
> +  - <b>Details</b>\n
> 
> +    This module provides SMI handler registration servicies for PCH SMIs.
> 
> +    NOTE: All the register/unregister functions will be locked after SMM
> ready to boot signal event.
> 
> +    Please make sure no handler is installed after that.
> 
> +
> 
> +  - @pre
> 
> +    - EFI_SMM_BASE2_PROTOCOL
> 
> +      - Documented in the System Management Mode Core Interface
> Specification
> 
> +    - EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
> 
> +      - Documented in the UEFI 2.0 Specification and above
> 
> +    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
> 
> +      - This is to ensure that PCI MMIO and IO resource has been prepared
> and available for this driver to allocate.
> 
> +    - EFI_SMM_CPU_PROTOCOL
> 
> +
> 
> +  - @result
> 
> +    The PchSmiDispatcher driver produces:
> 
> +    - EFI_SMM_USB_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_SX_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_SW_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_GPI_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_POWER_BUTTON_DISPATCH2_PROTOCOL
> 
> +    - EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL
> 
> +    - @link _PCH_SMM_IO_TRAP_CONTROL_PROTOCOL
> PCH_SMM_IO_TRAP_CONTROL_PROTOCOL @endlink
> 
> +    - @link _PCH_PCIE_SMI_DISPATCH_PROTOCOL
> PCH_PCIE_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_TCO_SMI_DISPATCH_PROTOCOL
> PCH_TCO_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_ACPI_SMI_DISPATCH_PROTOCOL
> PCH_ACPI_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_SMI_DISPATCH_PROTOCOL
> PCH_SMI_DISPATCH_PROTOCOL @endlink
> 
> +    - @link _PCH_ESPI_SMI_DISPATCH_PROTOCOL
> PCH_ESPI_SMI_DISPATCH_PROTOCOL @endlink
> 
> +
> 
> +  @param[in] ImageHandle          Pointer to the loaded image protocol for
> this driver
> 
> +  @param[in] SystemTable          Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             PchSmmDispatcher Initialization completed.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InitializePchSmmDispatcher (
> 
> +  IN EFI_HANDLE        ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS           Status;
> 
> +  VOID                 *SmmReadyToLockRegistration;
> 
> +
> 
> +  mS3SusStart = FALSE;
> 
> +  //
> 
> +  // Access ACPI Base Addresses Register
> 
> +  //
> 
> +
> 
> +  mAcpiBaseAddr = PmcGetAcpiBase ();
> 
> +  ASSERT (mAcpiBaseAddr != 0);
> 
> +
> 
> +  //
> 
> +  // Access TCO Base Addresses Register
> 
> +  //
> 
> +  PchTcoBaseGet (&mTcoBaseAddr);
> 
> +  ASSERT (mTcoBaseAddr != 0);
> 
> +
> 
> +  //
> 
> +  // Register a callback function to handle subsequent SMIs.  This callback
> 
> +  // will be called by SmmCoreDispatcher.
> 
> +  //
> 
> +  Status = gSmst->SmiHandlerRegister (PchSmmCoreDispatcher, NULL,
> &mPrivateData.SmiHandle);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  //
> 
> +  // Initialize Callback DataBase
> 
> +  //
> 
> +  InitializeListHead (&mPrivateData.CallbackDataBase);
> 
> +
> 
> +  //
> 
> +  // Enable SMIs on the PCH now that we have a callback
> 
> +  //
> 
> +  PchSmmInitHardware ();
> 
> +
> 
> +  //
> 
> +  // Install and initialize all the needed protocols
> 
> +  //
> 
> +  PchSwDispatchInit ();
> 
> +  PchSmmPublishDispatchProtocols ();
> 
> +  InstallPchSmiDispatchProtocols ();
> 
> +  InstallIoTrap (ImageHandle);
> 
> +  InstallEspiSmi (ImageHandle);
> 
> +  InstallPchSmmPeriodicTimerControlProtocol
> (mPrivateData.InstallMultProtHandle);
> 
> +
> 
> +  //
> 
> +  // Register EFI_SMM_READY_TO_LOCK_PROTOCOL_GUID notify function.
> 
> +  //
> 
> +  Status = gSmst->SmmRegisterProtocolNotify (
> 
> +                    &gEfiSmmReadyToLockProtocolGuid,
> 
> +                    SmmReadyToLockCallback,
> 
> +                    &SmmReadyToLockRegistration
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  The internal function used to create and insert a database record
> 
> +
> 
> +  @param[in]  InsertRecord              Record to insert to database.
> 
> +  @param[out] DispatchHandle            Handle of dispatch function to register.
> 
> +
> 
> +  @retval EFI_INVALID_PARAMETER         Error with NULL SMI source
> description
> 
> +  @retval EFI_OUT_OF_RESOURCES          Fail to allocate pool for database
> record
> 
> +  @retval EFI_SUCCESS                   The database record is created successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +SmmCoreInsertRecord (
> 
> +  IN  DATABASE_RECORD                   *NewRecord,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  DATABASE_RECORD                       *Record;
> 
> +
> 
> +  if ((NewRecord == NULL) ||
> 
> +      (NewRecord->Signature != DATABASE_RECORD_SIGNATURE))
> 
> +  {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  Status = gSmst->SmmAllocatePool (EfiRuntimeServicesData, sizeof
> (DATABASE_RECORD), (VOID **) &Record);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +  CopyMem (Record, NewRecord, sizeof (DATABASE_RECORD));
> 
> +
> 
> +  //
> 
> +  // After ensuring the source of event is not null, we will insert the record
> into the database
> 
> +  //
> 
> +  InsertTailList (&mPrivateData.CallbackDataBase, &Record->Link);
> 
> +
> 
> +  //
> 
> +  // Child's handle will be the address linked list link in the record
> 
> +  //
> 
> +  *DispatchHandle = (EFI_HANDLE) (&Record->Link);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                       Protocol instance pointer.
> 
> +  @param[in] DispatchHandle             Handle of dispatch function to
> deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS                   The dispatch function has been successfully
> 
> +                                        unregistered and the SMI source has been disabled
> 
> +                                        if there are no other registered child dispatch
> 
> +                                        functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER         Handle is invalid.
> 
> +  @retval EFI_ACCESS_DENIED             Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPiSmmCoreUnRegister (
> 
> +  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
> 
> +  IN EFI_HANDLE                                         *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                   *RecordToDelete;
> 
> +  EFI_STATUS                        Status;
> 
> +  PCH_SMM_QUALIFIED_PROTOCOL        *Qualified;
> 
> +
> 
> +  Qualified      = QUALIFIED_PROTOCOL_FROM_GENERIC (This);
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  Status         = PchSmmCoreUnRegister (NULL, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileUnregisterHandler (
> 
> +      Qualified->Guid,
> 
> +      RecordToDelete->Callback,
> 
> +      &RecordToDelete->ChildContext,
> 
> +      RecordToDelete->ContextSize
> 
> +      );
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register a child SMI dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL
> instance.
> 
> +  @param[in] DispatchFunction     Pointer to dispatch function to be invoked
> for this SMI source.
> 
> +  @param[in] DispatchContext      Pointer to the dispatch function's context.
> 
> +  @param[out] DispatchHandle      Handle of dispatch function, for when
> interfacing
> 
> +                                  with the parent SMM driver, will be the address of linked
> 
> +                                  list link in the call back record.
> 
> +
> 
> +  @retval EFI_OUT_OF_RESOURCES    Insufficient resources to create
> database record
> 
> +  @retval EFI_INVALID_PARAMETER   The input parameter is invalid
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  registered and the SMI source has been enabled.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchPiSmmCoreRegister (
> 
> +  IN  PCH_SMM_GENERIC_PROTOCOL                          *This,
> 
> +  IN  EFI_SMM_HANDLER_ENTRY_POINT2                      DispatchFunction,
> 
> +  IN  PCH_SMM_CONTEXT                                   *DispatchContext,
> 
> +  OUT EFI_HANDLE                                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                  Status;
> 
> +  DATABASE_RECORD             Record;
> 
> +  PCH_SMM_QUALIFIED_PROTOCOL  *Qualified;
> 
> +  PCH_SMM_SOURCE_DESC         NullSourceDesc;
> 
> +
> 
> +  //
> 
> +  // Initialize NullSourceDesc
> 
> +  //
> 
> +  NullInitSourceDesc (&NullSourceDesc);
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the EndOfDxe event
> has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  ZeroMem (&Record, sizeof (DATABASE_RECORD));
> 
> +
> 
> +  //
> 
> +  // Gather information about the registration request
> 
> +  //
> 
> +  Record.Callback          = DispatchFunction;
> 
> +
> 
> +  Qualified                = QUALIFIED_PROTOCOL_FROM_GENERIC (This);
> 
> +
> 
> +  Record.ProtocolType      = Qualified->Type;
> 
> +
> 
> +  Record.ContextFunctions  = mContextFunctions[Qualified->Type];
> 
> +  //
> 
> +  // Perform linked list housekeeping
> 
> +  //
> 
> +  Record.Signature         = DATABASE_RECORD_SIGNATURE;
> 
> +
> 
> +  switch (Qualified->Type) {
> 
> +    //
> 
> +    // By the end of this switch statement, we'll know the
> 
> +    // source description the child is registering for
> 
> +    //
> 
> +    case UsbType:
> 
> +      Record.ContextSize = sizeof (EFI_SMM_USB_REGISTER_CONTEXT);
> 
> +      CopyMem (&Record.ChildContext, DispatchContext,
> Record.ContextSize);
> 
> +      //
> 
> +      // Check the validity of Context Type
> 
> +      //
> 
> +      if ((Record.ChildContext.Usb.Type < UsbLegacy) ||
> (Record.ChildContext.Usb.Type > UsbWake)) {
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +
> 
> +      MapUsbToSrcDesc (DispatchContext, &Record.SrcDesc);
> 
> +      Record.ClearSource = NULL;
> 
> +      //
> 
> +      // use default clear source function
> 
> +      //
> 
> +      break;
> 
> +
> 
> +    case SxType:
> 
> +      Record.ContextSize = sizeof (EFI_SMM_SX_REGISTER_CONTEXT);
> 
> +      CopyMem (&Record.ChildContext, DispatchContext,
> Record.ContextSize);
> 
> +      //
> 
> +      // Check the validity of Context Type and Phase
> 
> +      //
> 
> +      if ((Record.ChildContext.Sx.Type < SxS0) ||
> 
> +          (Record.ChildContext.Sx.Type >= EfiMaximumSleepType) ||
> 
> +          (Record.ChildContext.Sx.Phase < SxEntry) ||
> 
> +          (Record.ChildContext.Sx.Phase >= EfiMaximumPhase)
> 
> +          ) {
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +
> 
> +      CopyMem (&Record.SrcDesc, &mSxSourceDesc, sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +      Record.ClearSource = NULL;
> 
> +      //
> 
> +      // use default clear source function
> 
> +      //
> 
> +      break;
> 
> +
> 
> +    case PowerButtonType:
> 
> +      Record.ContextSize = sizeof
> (EFI_SMM_POWER_BUTTON_REGISTER_CONTEXT);
> 
> +      CopyMem (&Record.ChildContext, DispatchContext,
> Record.ContextSize);
> 
> +      //
> 
> +      // Check the validity of Context Phase
> 
> +      //
> 
> +      if ((Record.ChildContext.PowerButton.Phase < EfiPowerButtonEntry) ||
> 
> +          (Record.ChildContext.PowerButton.Phase > EfiPowerButtonExit))
> 
> +      {
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +
> 
> +      CopyMem (&Record.SrcDesc, &mPowerButtonSourceDesc, sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +      Record.ClearSource = NULL;
> 
> +      //
> 
> +      // use default clear source function
> 
> +      //
> 
> +      break;
> 
> +
> 
> +    case PeriodicTimerType:
> 
> +      Record.ContextSize = sizeof
> (EFI_SMM_PERIODIC_TIMER_REGISTER_CONTEXT);
> 
> +      CopyMem (&Record.ChildContext, DispatchContext,
> Record.ContextSize);
> 
> +      //
> 
> +      // Check the validity of timer value
> 
> +      //
> 
> +      if (DispatchContext->PeriodicTimer.SmiTickInterval <= 0) {
> 
> +        return EFI_INVALID_PARAMETER;
> 
> +      }
> 
> +
> 
> +      MapPeriodicTimerToSrcDesc (DispatchContext, &Record.SrcDesc);
> 
> +      Record.MiscData.TimerSmiEnabled = TRUE;
> 
> +      Record.ClearSource = PchSmmPeriodicTimerClearSource;
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      return EFI_INVALID_PARAMETER;
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  if (CompareSources (&Record.SrcDesc, &NullSourceDesc)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // After ensuring the source of event is not null, we will insert the record
> into the database
> 
> +  // Child's handle will be the address linked list link in the record
> 
> +  //
> 
> +  Status = SmmCoreInsertRecord (
> 
> +             &Record,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  if (Record.ClearSource == NULL) {
> 
> +    //
> 
> +    // Clear the SMI associated w/ the source using the default function
> 
> +    //
> 
> +    PchSmmClearSource (&Record.SrcDesc);
> 
> +  } else {
> 
> +    //
> 
> +    // This source requires special handling to clear
> 
> +    //
> 
> +    Record.ClearSource (&Record.SrcDesc);
> 
> +  }
> 
> +
> 
> +  PchSmmEnableSource (&Record.SrcDesc);
> 
> +  SmiHandlerProfileRegisterHandler (
> 
> +    Qualified->Guid,
> 
> +    DispatchFunction,
> 
> +    (UINTN)RETURN_ADDRESS (0),
> 
> +    DispatchContext,
> 
> +    Record.ContextSize
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function with a parent SMM driver.
> 
> +
> 
> +  @param[in] This                 Pointer to the PCH_SMM_GENERIC_PROTOCOL
> instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmCoreUnRegister (
> 
> +  IN PCH_SMM_GENERIC_PROTOCOL                           *This,
> 
> +  IN EFI_HANDLE                                         *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                   Status;
> 
> +  BOOLEAN                      NeedClearEnable;
> 
> +  UINTN                        DescIndex;
> 
> +  DATABASE_RECORD              *RecordToDelete;
> 
> +  DATABASE_RECORD              *RecordInDb;
> 
> +  LIST_ENTRY                   *LinkInDb;
> 
> +
> 
> +  if (DispatchHandle == NULL) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the
> SmmReadyToLock event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +
> 
> +  //
> 
> +  // Take the entry out of the linked list
> 
> +  //
> 
> +  if (RecordToDelete->Link.ForwardLink == (LIST_ENTRY *)
> EFI_BAD_POINTER) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  RemoveEntryList (&RecordToDelete->Link);
> 
> +
> 
> +  //
> 
> +  // Loop through all the souces in record linked list to see if any source
> enable is equal.
> 
> +  // If any source enable is equal, we do not want to disable it.
> 
> +  //
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; ++DescIndex) {
> 
> +    if (IS_BIT_DESC_NULL (RecordToDelete->SrcDesc.En[DescIndex])) {
> 
> +      continue;
> 
> +    }
> 
> +    NeedClearEnable = TRUE;
> 
> +    LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
> 
> +    while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +      RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
> 
> +      if (IsBitEqualToAnySourceEn (&RecordToDelete-
> >SrcDesc.En[DescIndex], &RecordInDb->SrcDesc)) {
> 
> +        NeedClearEnable = FALSE;
> 
> +        break;
> 
> +      }
> 
> +      LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase,
> &RecordInDb->Link);
> 
> +    }
> 
> +    if (NeedClearEnable == FALSE) {
> 
> +      continue;
> 
> +    }
> 
> +    WriteBitDesc (&RecordToDelete->SrcDesc.En[DescIndex], 0, FALSE);
> 
> +  }
> 
> +  Status = gSmst->SmmFreePool (RecordToDelete);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT (FALSE);
> 
> +    return Status;
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clears the pending SMI status before set EOS.
> 
> +  NOTE: This only clears the pending SMI with known reason.
> 
> +        Please do not clear unknown pending SMI status since that will hide
> potential issues.
> 
> +
> 
> +  @param[in] SmiStsValue                SMI status
> 
> +  @param[in] SciEn                      Sci Enable status
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +ClearPendingSmiStatus (
> 
> +  UINT32  SmiStsValue,
> 
> +  BOOLEAN SciEn
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Clear NewCentury status if it's not handled.
> 
> +  //
> 
> +  if (SmiStsValue & B_ACPI_IO_SMI_STS_TCO) {
> 
> +    if (IoRead16 (mTcoBaseAddr + R_TCO_IO_TCO1_STS) &
> B_TCO_IO_TCO1_STS_NEWCENTURY) {
> 
> +      PchTcoSmiClearSourceAndBlock (&mSrcDescNewCentury);
> 
> +    }
> 
> +  }
> 
> +  // Clear PWRBTNOR_STS if it's not handled.
> 
> +  //
> 
> +  if (IoRead16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS) &
> B_ACPI_IO_PM1_STS_PRBTNOR) {
> 
> +    IoWrite16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS,
> B_ACPI_IO_PM1_STS_PRBTNOR);
> 
> +  }
> 
> +  //
> 
> +  // Clear WADT_STS if this is triggered by WADT timer.
> 
> +  //
> 
> +  if (!SciEn) {
> 
> +    if (IoRead32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96) &
> B_ACPI_IO_GPE0_STS_127_96_WADT) {
> 
> +      IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96,
> B_ACPI_IO_GPE0_STS_127_96_WADT);
> 
> +    }
> 
> +  }
> 
> +  //
> 
> +  // Clear GPIO_UNLOCK_SMI_STS in case it is set as GPIO Unlock SMI is not
> supported
> 
> +  //
> 
> +  if (SmiStsValue & B_ACPI_IO_SMI_STS_GPIO_UNLOCK) {
> 
> +    IoWrite32 (mAcpiBaseAddr + R_ACPI_IO_SMI_STS,
> B_ACPI_IO_SMI_STS_GPIO_UNLOCK);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  The callback function to handle subsequent SMIs.  This callback will be
> called by SmmCoreDispatcher.
> 
> +
> 
> +  @param[in] SmmImageHandle             Not used
> 
> +  @param[in] PchSmmCore                 Not used
> 
> +  @param[in, out] CommunicationBuffer   Not used
> 
> +  @param[in, out] SourceSize            Not used
> 
> +
> 
> +  @retval EFI_SUCCESS                   Function successfully completed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmCoreDispatcher (
> 
> +  IN       EFI_HANDLE         SmmImageHandle,
> 
> +  IN CONST VOID               *PchSmmCore,
> 
> +  IN OUT   VOID               *CommunicationBuffer,
> 
> +  IN OUT   UINTN              *SourceSize
> 
> +  )
> 
> +{
> 
> +  //
> 
> +  // Used to prevent infinite loops
> 
> +  //
> 
> +  UINTN               EscapeCount;
> 
> +
> 
> +  BOOLEAN             ContextsMatch;
> 
> +  BOOLEAN             EosSet;
> 
> +  BOOLEAN             SxChildWasDispatched;
> 
> +
> 
> +  DATABASE_RECORD     *RecordInDb;
> 
> +  LIST_ENTRY          *LinkInDb;
> 
> +  DATABASE_RECORD     *RecordToExhaust;
> 
> +  LIST_ENTRY          *LinkToExhaust;
> 
> +
> 
> +  PCH_SMM_CONTEXT     Context;
> 
> +  VOID                *CommBuffer;
> 
> +  UINTN               CommBufferSize;
> 
> +
> 
> +  EFI_STATUS          Status;
> 
> +  BOOLEAN             SciEn;
> 
> +  UINT32              SmiEnValue;
> 
> +  UINT32              SmiStsValue;
> 
> +  UINT8               Port74Save;
> 
> +  UINT8               Port76Save;
> 
> +
> 
> +  PCH_SMM_SOURCE_DESC ActiveSource;
> 
> +
> 
> +  //
> 
> +  // Initialize ActiveSource
> 
> +  //
> 
> +  NullInitSourceDesc (&ActiveSource);
> 
> +
> 
> +  EscapeCount           = 3;
> 
> +  ContextsMatch         = FALSE;
> 
> +  EosSet                = FALSE;
> 
> +  SxChildWasDispatched  = FALSE;
> 
> +  Status                = EFI_SUCCESS;
> 
> +
> 
> +  //
> 
> +  // Save IO index registers
> 
> +  // @note: Save/Restore port 70h directly might break NMI_EN# setting,
> 
> +  //       then save/restore 74h/76h instead.
> 
> +  // @note: CF8 is not saved. Prefer method is to use MMIO instead of CF8
> 
> +  //
> 
> +  Port76Save = IoRead8 (R_RTC_IO_EXT_INDEX_ALT);
> 
> +  Port74Save = IoRead8 (R_RTC_IO_INDEX_ALT);
> 
> +
> 
> +  if (!IsListEmpty (&mPrivateData.CallbackDataBase)) {
> 
> +    //
> 
> +    // We have children registered w/ us -- continue
> 
> +    //
> 
> +    while ((!EosSet) && (EscapeCount > 0)) {
> 
> +      EscapeCount--;
> 
> +
> 
> +      LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
> 
> +
> 
> +      //
> 
> +      // Cache SciEn, SmiEnValue and SmiStsValue to determine if source is
> active
> 
> +      //
> 
> +      SciEn       = PchSmmGetSciEn ();
> 
> +      SmiEnValue  = IoRead32 ((UINTN) (mAcpiBaseAddr +
> R_ACPI_IO_SMI_EN));
> 
> +      SmiStsValue = IoRead32 ((UINTN) (mAcpiBaseAddr +
> R_ACPI_IO_SMI_STS));
> 
> +
> 
> +      while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +        RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
> 
> +
> 
> +        //
> 
> +        // look for the first active source
> 
> +        //
> 
> +        if (!SourceIsActive (&RecordInDb->SrcDesc, SciEn, SmiEnValue,
> SmiStsValue)) {
> 
> +          //
> 
> +          // Didn't find the source yet, keep looking
> 
> +          //
> 
> +          LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase,
> &RecordInDb->Link);
> 
> +
> 
> +          //
> 
> +          // if it's the last one, try to clear EOS
> 
> +          //
> 
> +          if (IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +            //
> 
> +            // Clear pending SMI status before EOS
> 
> +            //
> 
> +            ClearPendingSmiStatus (SmiStsValue, SciEn);
> 
> +            EosSet = PchSmmSetAndCheckEos ();
> 
> +          }
> 
> +        } else {
> 
> +          //
> 
> +          // We found a source. If this is a sleep type, we have to go to
> 
> +          // appropriate sleep state anyway.No matter there is sleep child or not
> 
> +          //
> 
> +          if (RecordInDb->ProtocolType == SxType) {
> 
> +            SxChildWasDispatched = TRUE;
> 
> +          }
> 
> +          //
> 
> +          // "cache" the source description and don't query I/O anymore
> 
> +          //
> 
> +          CopyMem ((VOID *) &ActiveSource, (VOID *) &(RecordInDb-
> >SrcDesc), sizeof (PCH_SMM_SOURCE_DESC));
> 
> +          LinkToExhaust = LinkInDb;
> 
> +
> 
> +          //
> 
> +          // exhaust the rest of the queue looking for the same source
> 
> +          //
> 
> +          while (!IsNull (&mPrivateData.CallbackDataBase, LinkToExhaust)) {
> 
> +            RecordToExhaust = DATABASE_RECORD_FROM_LINK
> (LinkToExhaust);
> 
> +            //
> 
> +            // RecordToExhaust->Link might be removed (unregistered) by
> Callback function, and then the
> 
> +            // system will hang in ASSERT() while calling GetNextNode().
> 
> +            // To prevent the issue, we need to get next record in DB here
> (before Callback function).
> 
> +            //
> 
> +            LinkToExhaust = GetNextNode (&mPrivateData.CallbackDataBase,
> &RecordToExhaust->Link);
> 
> +
> 
> +            if (CompareSources (&RecordToExhaust->SrcDesc, &ActiveSource)) {
> 
> +              //
> 
> +              // These source descriptions are equal, so this callback should be
> 
> +              // dispatched.
> 
> +              //
> 
> +              if (RecordToExhaust->ContextFunctions.GetContext != NULL) {
> 
> +                //
> 
> +                // This child requires that we get a calling context from
> 
> +                // hardware and compare that context to the one supplied
> 
> +                // by the child.
> 
> +                //
> 
> +                ASSERT (RecordToExhaust->ContextFunctions.CmpContext !=
> NULL);
> 
> +
> 
> +                //
> 
> +                // Make sure contexts match before dispatching event to child
> 
> +                //
> 
> +                RecordToExhaust->ContextFunctions.GetContext
> (RecordToExhaust, &Context);
> 
> +                ContextsMatch = RecordToExhaust-
> >ContextFunctions.CmpContext (&Context, &RecordToExhaust-
> >ChildContext);
> 
> +
> 
> +              } else {
> 
> +                //
> 
> +                // This child doesn't require any more calling context beyond what
> 
> +                // it supplied in registration.  Simply pass back what it gave us.
> 
> +                //
> 
> +                Context       = RecordToExhaust->ChildContext;
> 
> +                ContextsMatch = TRUE;
> 
> +              }
> 
> +
> 
> +              if (ContextsMatch) {
> 
> +                if (RecordToExhaust->ProtocolType == PchSmiDispatchType) {
> 
> +                  //
> 
> +                  // For PCH SMI dispatch protocols
> 
> +                  //
> 
> +                  PchSmiTypeCallbackDispatcher (RecordToExhaust);
> 
> +                } else {
> 
> +                  if ((RecordToExhaust->ProtocolType == SxType) &&
> (Context.Sx.Type == SxS3) && (Context.Sx.Phase == SxEntry) &&
> !mS3SusStart) {
> 
> +                    REPORT_STATUS_CODE (EFI_PROGRESS_CODE,
> PROGRESS_CODE_S3_SUSPEND_START);
> 
> +                    mS3SusStart = TRUE;
> 
> +                  }
> 
> +                  //
> 
> +                  // For EFI standard SMI dispatch protocols
> 
> +                  //
> 
> +                  if (RecordToExhaust->Callback != NULL) {
> 
> +                    if (RecordToExhaust->ContextFunctions.GetCommBuffer !=
> NULL) {
> 
> +                      //
> 
> +                      // This callback function needs CommBuffer and
> CommBufferSize.
> 
> +                      // Get those from child and then pass to callback function.
> 
> +                      //
> 
> +                      RecordToExhaust->ContextFunctions.GetCommBuffer
> (RecordToExhaust, &CommBuffer, &CommBufferSize);
> 
> +                    } else {
> 
> +                      //
> 
> +                      // Child doesn't support the CommBuffer and CommBufferSize.
> 
> +                      // Just pass NULL value to callback function.
> 
> +                      //
> 
> +                      CommBuffer     = NULL;
> 
> +                      CommBufferSize = 0;
> 
> +                    }
> 
> +
> 
> +                    PERF_START_EX (NULL, "SmmFunction", NULL, AsmReadTsc (),
> RecordToExhaust->ProtocolType);
> 
> +                    RecordToExhaust->Callback ((EFI_HANDLE) & RecordToExhaust-
> >Link, &Context, CommBuffer, &CommBufferSize);
> 
> +                    PERF_END_EX (NULL, "SmmFunction", NULL, AsmReadTsc (),
> RecordToExhaust->ProtocolType);
> 
> +                    if (RecordToExhaust->ProtocolType == SxType) {
> 
> +                      SxChildWasDispatched = TRUE;
> 
> +                    }
> 
> +                  } else {
> 
> +                    ASSERT (FALSE);
> 
> +                  }
> 
> +                }
> 
> +              }
> 
> +            }
> 
> +          }
> 
> +
> 
> +          if (RecordInDb->ClearSource == NULL) {
> 
> +            //
> 
> +            // Clear the SMI associated w/ the source using the default function
> 
> +            //
> 
> +            PchSmmClearSource (&ActiveSource);
> 
> +          } else {
> 
> +            //
> 
> +            // This source requires special handling to clear
> 
> +            //
> 
> +            RecordInDb->ClearSource (&ActiveSource);
> 
> +          }
> 
> +          //
> 
> +          // Clear pending SMI status before EOS
> 
> +          //
> 
> +          ClearPendingSmiStatus (SmiStsValue, SciEn);
> 
> +          //
> 
> +          // Also, try to clear EOS
> 
> +          //
> 
> +          EosSet = PchSmmSetAndCheckEos ();
> 
> +          //
> 
> +          // Queue is empty, reset the search
> 
> +          //
> 
> +          break;
> 
> +        }
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  //
> 
> +  // If you arrive here, there are two possible reasons:
> 
> +  // (1) you've got problems with clearing the SMI status bits in the
> 
> +  // ACPI table.  If you don't properly clear the SMI bits, then you won't be
> able to set the
> 
> +  // EOS bit.  If this happens too many times, the loop exits.
> 
> +  // (2) there was a SMM communicate for callback messages that was
> received prior
> 
> +  // to this driver.
> 
> +  // If there is an asynchronous SMI that occurs while processing the
> Callback, let
> 
> +  // all of the drivers (including this one) have an opportunity to scan for the
> SMI
> 
> +  // and handle it.
> 
> +  // If not, we don't want to exit and have the foreground app. clear EOS
> without letting
> 
> +  // these other sources get serviced.
> 
> +  //
> 
> +  // This assert is not valid with CSM legacy solution because it generates
> software SMI
> 
> +  // to test for legacy USB support presence.
> 
> +  // This may not be illegal, so we cannot assert at this time.
> 
> +  //
> 
> +  //  ASSERT (EscapeCount > 0);
> 
> +  //
> 
> +  if (SxChildWasDispatched) {
> 
> +    //
> 
> +    // A child of the SmmSxDispatch protocol was dispatched during this call;
> 
> +    // put the system to sleep.
> 
> +    //
> 
> +    PchSmmSxGoToSleep ();
> 
> +  }
> 
> +  //
> 
> +  // Restore IO index registers
> 
> +  // @note: Save/Restore port 70h directly might break NMI_EN# setting,
> 
> +  //       then save/restore 74h/76h instead.
> 
> +  //
> 
> +  IoWrite8 (R_RTC_IO_EXT_INDEX_ALT, Port76Save);
> 
> +  IoWrite8 (R_RTC_IO_INDEX_ALT, Port74Save);
> 
> +
> 
> +  return Status;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .c
> new file mode 100644
> index 0000000000..9ce4072e37
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .c
> @@ -0,0 +1,1588 @@
> +/** @file
> 
> +  eSPI SMI implementation
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#include "PchSmmEspi.h"
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +#include <Library/EspiLib.h>
> 
> +#include <Library/SmiHandlerProfileLib.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PchPcrRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <PchBdfAssignment.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED ESPI_SMI_INSTANCE
> mEspiSmiInstance = {
> 
> +  //
> 
> +  // Signature
> 
> +  //
> 
> +  ESPI_SMI_INSTANCE_SIGNATURE,
> 
> +  //
> 
> +  // Handle
> 
> +  //
> 
> +  NULL,
> 
> +  //
> 
> +  // PchEspiSmiDispatchProtocol
> 
> +  //
> 
> +  {
> 
> +    PCH_ESPI_SMI_DISPATCH_REVISION,
> 
> +    EspiSmiUnRegister,
> 
> +    BiosWrProtectRegister,
> 
> +    BiosWrReportRegister,
> 
> +    PcNonFatalErrRegister,
> 
> +    PcFatalErrRegister,
> 
> +    VwNonFatalErrRegister,
> 
> +    VwFatalErrRegister,
> 
> +    FlashNonFatalErrRegister,
> 
> +    FlashFatalErrRegister,
> 
> +    LnkType1ErrRegister,
> 
> +    EspiSlaveSmiRegister
> 
> +  },
> 
> +  //
> 
> +  // PchSmiEspiHandle[EspiTopLevelTypeMax]
> 
> +  //
> 
> +  {
> 
> +    NULL, NULL, NULL
> 
> +  },
> 
> +  //
> 
> +  // CallbackDataBase[EspiSmiTypeMax]
> 
> +  //
> 
> +  {
> 
> +    {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL},
> 
> +    {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}, {NULL, NULL}
> 
> +  },
> 
> +  //
> 
> +  // EspiSmiEventCounter[EspiSmiTypeMax]
> 
> +  //
> 
> +  {
> 
> +    0, 0, 0, 0, 0, 0, 0, 0, 0, 0
> 
> +  },
> 
> +  //
> 
> +  // Barrier[EspiTopLevelTypeMax]
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      BiosWrProtect,
> 
> +      BiosWrProtect
> 
> +    },
> 
> +    {
> 
> +      BiosWrReport,
> 
> +      LnkType1Err
> 
> +    },
> 
> +    {
> 
> +      EspiSlaveSmi,
> 
> +      EspiSlaveSmi
> 
> +    }
> 
> +  }
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST ESPI_DESCRIPTOR
> mEspiDescriptor[EspiSmiTypeMax] = {
> 
> +  //
> 
> +  // BiosWrProtect
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCIE_ADDR_TYPE,
> 
> +      { (
> 
> +        (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +        (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
> 
> +        (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
> 
> +        R_ESPI_CFG_PCBC
> 
> +      ) }
> 
> +    },
> 
> +    //
> 
> +    // SourceIsActiveAndMask and SourceIsActiveValue
> 
> +    //
> 
> +    B_ESPI_CFG_PCBC_BWPDS | B_ESPI_CFG_PCBC_LE,
> 
> +    B_ESPI_CFG_PCBC_BWPDS | B_ESPI_CFG_PCBC_LE,
> 
> +    //
> 
> +    // ClearStatusAndMask and ClearStatusOrMask
> 
> +    //
> 
> +    (UINT32) ~B_ESPI_CFG_PCBC_BWRS,
> 
> +    B_ESPI_CFG_PCBC_BWPDS
> 
> +  },
> 
> +  //
> 
> +  // BiosWrReport
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCIE_ADDR_TYPE,
> 
> +      { (
> 
> +        (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +        (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
> 
> +        (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
> 
> +        R_ESPI_CFG_PCBC
> 
> +      ) }
> 
> +    },
> 
> +    B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWRE,
> 
> +    B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWRE,
> 
> +    (UINT32) ~B_ESPI_CFG_PCBC_BWPDS,
> 
> +    B_ESPI_CFG_PCBC_BWRS
> 
> +  },
> 
> +  //
> 
> +  // PcNonFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_PCERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
> 
> +    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI <<
> N_ESPI_PCR_XERR_XNFEE)),
> 
> +    (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XFES),
> 
> +    B_ESPI_PCR_XERR_XNFES
> 
> +  },
> 
> +  //
> 
> +  // PcFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_PCERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
> 
> +    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI <<
> N_ESPI_PCR_XERR_XFEE)),
> 
> +    (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XNFES),
> 
> +    B_ESPI_PCR_XERR_XFES
> 
> +  },
> 
> +  //
> 
> +  // VwNonFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_VWERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
> 
> +    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI <<
> N_ESPI_PCR_XERR_XNFEE)),
> 
> +    (UINT32) ~B_ESPI_PCR_XERR_XFES,
> 
> +    B_ESPI_PCR_XERR_XNFES
> 
> +  },
> 
> +  //
> 
> +  // VwFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_VWERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
> 
> +    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI <<
> N_ESPI_PCR_XERR_XFEE)),
> 
> +    (UINT32) ~B_ESPI_PCR_XERR_XNFES,
> 
> +    B_ESPI_PCR_XERR_XFES
> 
> +  },
> 
> +  //
> 
> +  // FlashNonFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_FCERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XNFEE),
> 
> +    (B_ESPI_PCR_XERR_XNFES | (V_ESPI_PCR_XERR_XNFEE_SMI <<
> N_ESPI_PCR_XERR_XNFEE)),
> 
> +    (UINT32) ~B_ESPI_PCR_XERR_XFES,
> 
> +    B_ESPI_PCR_XERR_XNFES
> 
> +  },
> 
> +  //
> 
> +  // FlashFatalErr
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_FCERR_SLV0) }
> 
> +    },
> 
> +    (B_ESPI_PCR_XERR_XFES | B_ESPI_PCR_XERR_XFEE),
> 
> +    (B_ESPI_PCR_XERR_XFES | (V_ESPI_PCR_XERR_XFEE_SMI <<
> N_ESPI_PCR_XERR_XFEE)),
> 
> +    (UINT32) ~B_ESPI_PCR_XERR_XNFES,
> 
> +    B_ESPI_PCR_XERR_XFES
> 
> +  },
> 
> +  //
> 
> +  // LnkType1Err
> 
> +  //
> 
> +  {
> 
> +    {
> 
> +      PCR_ADDR_TYPE,
> 
> +      {PCH_PCR_ADDRESS (PID_ESPISPI, R_ESPI_PCR_LNKERR_SLV0) }
> 
> +    },
> 
> +    B_ESPI_PCR_LNKERR_SLV0_LFET1S | B_ESPI_PCR_LNKERR_SLV0_LFET1E,
> 
> +    B_ESPI_PCR_LNKERR_SLV0_LFET1S |
> (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI <<
> N_ESPI_PCR_LNKERR_SLV0_LFET1E),
> 
> +    (UINT32) ~B_ESPI_PCR_LNKERR_SLV0_SLCRR,
> 
> +    B_ESPI_PCR_LNKERR_SLV0_LFET1S
> 
> +  },
> 
> +};
> 
> +
> 
> +/**
> 
> +  Enable eSPI SMI source
> 
> +
> 
> +  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EspiSmiEnableSource (
> 
> +  IN CONST  ESPI_SMI_TYPE EspiSmiType
> 
> +  )
> 
> +{
> 
> +  UINT64      PciBaseAddress;
> 
> +
> 
> +  switch (EspiSmiType) {
> 
> +    case BiosWrProtect:
> 
> +      //
> 
> +      // It doesn't enable the BIOSLOCK here. Enable it by policy in DXE.
> 
> +      //
> 
> +      break;
> 
> +    case BiosWrReport:
> 
> +      PciBaseAddress = EspiPciCfgBase ();
> 
> +      PciSegmentAndThenOr32 (
> 
> +        PciBaseAddress + R_ESPI_CFG_PCBC,
> 
> +        (UINT32) ~(B_ESPI_CFG_PCBC_BWRS | B_ESPI_CFG_PCBC_BWPDS),
> 
> +        B_ESPI_CFG_PCBC_BWRE
> 
> +        );
> 
> +      break;
> 
> +    case PcNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_PCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XNFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case PcFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_PCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case VwNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_VWERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XNFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case VwFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_VWERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case FlashNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_FCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XNFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case FlashFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_FCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES),
> 
> +        B_ESPI_PCR_XERR_XFEE
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case LnkType1Err:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_LNKERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR |
> B_ESPI_PCR_LNKERR_SLV0_LFET1S),
> 
> +        (UINT32) (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI <<
> N_ESPI_PCR_LNKERR_SLV0_LFET1E)
> 
> +        );
> 
> +
> 
> +      if (IsEspiSecondSlaveSupported ()) {
> 
> +        PchPcrAndThenOr32 (
> 
> +          PID_ESPISPI,
> 
> +          (UINT16) R_ESPI_PCR_LNKERR_SLV1,
> 
> +          (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR |
> B_ESPI_PCR_LNKERR_SLV0_LFET1S),
> 
> +          (UINT32) (V_ESPI_PCR_LNKERR_SLV0_LFET1E_SMI <<
> N_ESPI_PCR_LNKERR_SLV0_LFET1E)
> 
> +          );
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      DEBUG ((DEBUG_ERROR, "Unsupported EspiSmiType \n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Disable eSPI SMI source
> 
> +
> 
> +  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EspiSmiDisableSource (
> 
> +  IN CONST  ESPI_SMI_TYPE EspiSmiType
> 
> +  )
> 
> +{
> 
> +
> 
> +  switch (EspiSmiType) {
> 
> +    case BiosWrProtect:
> 
> +    case BiosWrReport:
> 
> +      DEBUG ((DEBUG_ERROR, "Bit is write lock, thus BWRE/BWPDS source
> cannot be disabled \n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +    case PcNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_PCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XNFEE),
> 
> +        0
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case PcFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_PCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_PCERR_SLV0_PCURD |
> B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XFEE),
> 
> +        0
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case VwNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_VWERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XNFEE),
> 
> +        0
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case VwFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_VWERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XFEE),
> 
> +        0
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case FlashNonFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_FCERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XNFEE),
> 
> +        0
> 
> +        );
> 
> +      break;
> 
> +
> 
> +    case FlashFatalErr:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +       (UINT16) R_ESPI_PCR_FCERR_SLV0,
> 
> +       (UINT32) ~(B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES |
> B_ESPI_PCR_XERR_XFEE),
> 
> +       0
> 
> +       );
> 
> +      break;
> 
> +
> 
> +    case LnkType1Err:
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) R_ESPI_PCR_LNKERR_SLV0,
> 
> +        (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR |
> B_ESPI_PCR_LNKERR_SLV0_LFET1S),
> 
> +        0
> 
> +        );
> 
> +
> 
> +      if (IsEspiSecondSlaveSupported ()) {
> 
> +        PchPcrAndThenOr32 (
> 
> +          PID_ESPISPI,
> 
> +          (UINT16) R_ESPI_PCR_LNKERR_SLV1,
> 
> +          (UINT32) ~(B_ESPI_PCR_LNKERR_SLV0_SLCRR |
> B_ESPI_PCR_LNKERR_SLV0_LFET1S),
> 
> +          0
> 
> +          );
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      DEBUG ((DEBUG_ERROR, "Unsupported EspiSmiType \n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear a status for the SMI event
> 
> +
> 
> +  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
> 
> +**/
> 
> +STATIC
> 
> +VOID
> 
> +EspiSmiClearStatus (
> 
> +  IN CONST  ESPI_SMI_TYPE EspiSmiType
> 
> +  )
> 
> +{
> 
> +  UINT32                  PciBus;
> 
> +  UINT32                  PciDev;
> 
> +  UINT32                  PciFun;
> 
> +  UINT32                  PciReg;
> 
> +  UINT64                  PciBaseAddress;
> 
> +  CONST ESPI_DESCRIPTOR   *Desc;
> 
> +
> 
> +  Desc = &mEspiDescriptor[EspiSmiType];
> 
> +
> 
> +  switch (Desc->Address.Type) {
> 
> +    case PCIE_ADDR_TYPE:
> 
> +      PciBus  = Desc->Address.Data.pcie.Fields.Bus;
> 
> +      PciDev  = Desc->Address.Data.pcie.Fields.Dev;
> 
> +      PciFun  = Desc->Address.Data.pcie.Fields.Fnc;
> 
> +      PciReg  = Desc->Address.Data.pcie.Fields.Reg;
> 
> +      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
> 
> +      PciSegmentAndThenOr32 (PciBaseAddress + PciReg, Desc-
> >ClearStatusAndMask, Desc->ClearStatusOrMask);
> 
> +      break;
> 
> +    case PCR_ADDR_TYPE:
> 
> +      PchPcrAndThenOr32 (
> 
> +        Desc->Address.Data.Pcr.Fields.Pid,
> 
> +        Desc->Address.Data.Pcr.Fields.Offset,
> 
> +        Desc->ClearStatusAndMask,
> 
> +        Desc->ClearStatusOrMask
> 
> +        );
> 
> +      break;
> 
> +    default:
> 
> +      DEBUG ((DEBUG_ERROR, "Address type for eSPI SMI is invalid \n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if a source is active by looking at the enable and status bits
> 
> +
> 
> +  @param[in]  EspiSmiType  Type based on ESPI_SMI_TYPE
> 
> +**/
> 
> +STATIC
> 
> +BOOLEAN
> 
> +EspiSmiSourceIsActive (
> 
> +  IN CONST  ESPI_SMI_TYPE EspiSmiType
> 
> +  )
> 
> +{
> 
> +  BOOLEAN                 Active;
> 
> +  UINT32                  PciBus;
> 
> +  UINT32                  PciDev;
> 
> +  UINT32                  PciFun;
> 
> +  UINT32                  PciReg;
> 
> +  UINT64                  PciBaseAddress;
> 
> +  UINT32                  Data32;
> 
> +  CONST ESPI_DESCRIPTOR   *Desc;
> 
> +
> 
> +  Desc = &mEspiDescriptor[EspiSmiType];
> 
> +
> 
> +  Active = FALSE;
> 
> +  switch (Desc->Address.Type) {
> 
> +    case PCIE_ADDR_TYPE:
> 
> +      PciBus  = Desc->Address.Data.pcie.Fields.Bus;
> 
> +      PciDev  = Desc->Address.Data.pcie.Fields.Dev;
> 
> +      PciFun  = Desc->Address.Data.pcie.Fields.Fnc;
> 
> +      PciReg  = Desc->Address.Data.pcie.Fields.Reg;
> 
> +      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
> 
> +      Data32 = PciSegmentRead32 (PciBaseAddress + PciReg);
> 
> +      break;
> 
> +
> 
> +    case PCR_ADDR_TYPE:
> 
> +      Data32 = PchPcrRead32 (
> 
> +                 Desc->Address.Data.Pcr.Fields.Pid,
> 
> +                 Desc->Address.Data.Pcr.Fields.Offset
> 
> +                 );
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      Data32 = 0;
> 
> +      DEBUG ((DEBUG_ERROR, "Address type for eSPI SMI is invalid \n"));
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  if ((Data32 & Desc->SourceIsActiveAndMask) == Desc-
> >SourceIsActiveValue) {
> 
> +    Active = TRUE;
> 
> +  }
> 
> +
> 
> +  return Active;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Insert a handler into the corresponding linked list based on EspiSmiType
> 
> +
> 
> +  @param[in]  DispatchFunction      The callback to execute
> 
> +  @param[in]  EspiSmiType           Type based on ESPI_SMI_TYPE to
> determine which linked list to use
> 
> +  @param[out] DispatchHandle        The link to the record in the database
> 
> +
> 
> +  @retval     EFI_SUCCESS           Record was successfully inserted into master
> database
> 
> +  @retval     EFI_OUT_OF_RESOURCES  Cannot allocate pool to insert record
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +InsertEspiRecord (
> 
> +  IN        PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  IN        ESPI_SMI_TYPE                   EspiSmiType,
> 
> +  OUT       EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS      Status;
> 
> +  ESPI_SMI_RECORD *Record;
> 
> +
> 
> +  Status = gSmst->SmmAllocatePool (EfiRuntimeServicesData, sizeof
> (ESPI_SMI_RECORD), (VOID **) &Record);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT (FALSE);
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +  SetMem (Record, sizeof (ESPI_SMI_RECORD), 0);
> 
> +
> 
> +  Record->Callback  = DispatchFunction;
> 
> +  Record->Signature = ESPI_SMI_RECORD_SIGNATURE;
> 
> +
> 
> +  InsertTailList (&mEspiSmiInstance.CallbackDataBase[EspiSmiType],
> &Record->Link);
> 
> +  EspiSmiClearStatus (EspiSmiType);
> 
> +  EspiSmiEnableSource (EspiSmiType);
> 
> +
> 
> +  ++mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType];
> 
> +
> 
> +  *DispatchHandle = (EFI_HANDLE) (&Record->Link);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This callback is registered to PchSmiDispatch
> 
> +
> 
> +  @param[in]  DispatchHandle  Used to determine which source have been
> triggered
> 
> +**/
> 
> +VOID
> 
> +EspiSmiCallback (
> 
> +  IN  EFI_HANDLE                      DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD     *PchSmiRecord;
> 
> +  ESPI_TOP_LEVEL_TYPE EspiTopLevelType;
> 
> +  ESPI_SMI_TYPE       EspiSmiType;
> 
> +  ESPI_SMI_RECORD     *RecordInDb;
> 
> +  LIST_ENTRY          *LinkInDb;
> 
> +
> 
> +  PchSmiRecord = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +
> 
> +  if (PchSmiRecord->PchSmiType == PchTcoSmiLpcBiosWpType) {
> 
> +    EspiTopLevelType = EspiBiosWrProtect;
> 
> +  } else if (PchSmiRecord->PchSmiType == PchSmiSerialIrqType) {
> 
> +    EspiTopLevelType = EspiSerialIrq;
> 
> +  } else {
> 
> +    DEBUG ((DEBUG_ERROR, "EspiSmiCallback was dispatched with a wrong
> DispatchHandle"));
> 
> +    ASSERT (FALSE);
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  for (EspiSmiType = mEspiSmiInstance.Barrier[EspiTopLevelType].Start;
> EspiSmiType <= mEspiSmiInstance.Barrier[EspiTopLevelType].End;
> ++EspiSmiType) {
> 
> +    if (!EspiSmiSourceIsActive (EspiSmiType)) {
> 
> +      continue;
> 
> +    }
> 
> +    //
> 
> +    // The source is active, so walk the callback database and dispatch
> 
> +    //
> 
> +    if (!IsListEmpty (&mEspiSmiInstance.CallbackDataBase[EspiSmiType])) {
> 
> +      //
> 
> +      // We have children registered w/ us -- continue
> 
> +      //
> 
> +      LinkInDb = GetFirstNode
> (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
> 
> +
> 
> +      while (!IsNull (&mEspiSmiInstance.CallbackDataBase[EspiSmiType],
> LinkInDb)) {
> 
> +        RecordInDb = ESPI_RECORD_FROM_LINK (LinkInDb);
> 
> +
> 
> +        //
> 
> +        // RecordInDb->Link might be removed (unregistered) by Callback
> function, and then the
> 
> +        // system will hang in ASSERT() while calling GetNextNode().
> 
> +        // To prevent the issue, we need to get next record in DB here (before
> Callback function).
> 
> +        //
> 
> +        LinkInDb = GetNextNode
> (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], &RecordInDb->Link);
> 
> +
> 
> +        //
> 
> +        // Callback
> 
> +        //
> 
> +        if (RecordInDb->Callback != NULL) {
> 
> +          RecordInDb->Callback ((EFI_HANDLE) &RecordInDb->Link);
> 
> +        } else {
> 
> +          ASSERT (FALSE);
> 
> +        }
> 
> +      }
> 
> +    } else if (EspiSmiType == LnkType1Err) {
> 
> +      //
> 
> +      // If no proper handler registered for Link Type 1 Error
> 
> +      // Call default SMI handler recover otherwise
> 
> +      //
> 
> +      EspiDefaultFatalErrorHandler ();
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Finish walking the linked list for the EspiSmiType, so clear status
> 
> +    //
> 
> +    EspiSmiClearStatus (EspiSmiType);
> 
> +  }
> 
> +}
> 
> +
> 
> +//
> 
> +// EspiBiosWp srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescEspiBiosWp = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_TCO
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
> 
> +          R_ESPI_CFG_PCBC
> 
> +        ) }
> 
> +      },
> 
> +      S_ESPI_CFG_PCBC,
> 
> +      N_ESPI_CFG_PCBC_LE
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        PCIE_ADDR_TYPE,
> 
> +        { (
> 
> +          (DEFAULT_PCI_BUS_NUMBER_PCH << 24) |
> 
> +          (PCI_DEVICE_NUMBER_PCH_LPC << 19) |
> 
> +          (PCI_FUNCTION_NUMBER_PCH_LPC << 16) |
> 
> +          R_ESPI_CFG_PCBC
> 
> +        ) }
> 
> +      },
> 
> +      S_ESPI_CFG_PCBC,
> 
> +      N_ESPI_CFG_PCBC_BWPDS
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_TCO
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  This function will register EspiSmiCallback with mSrcDescEspiBiosWp source
> decriptor
> 
> +  This function make sure there is only one BIOS WP SMI handler is
> registered.
> 
> +  While any ESPI sub BIOS WP SMI type is registered, all the BIOS WP SMI
> 
> +  will go to callback function EspiSmiCallback first, and then dispatchs the
> callbacks
> 
> +  recorded in mEspiSmiInstance.
> 
> +
> 
> +  @retval EFI_SUCCESS Registration succeed
> 
> +  @retval others      Registration failed
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +RegisterBiosWrProtectIfNull (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS      Status;
> 
> +  DATABASE_RECORD *Record;
> 
> +
> 
> +  if (mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect] == NULL) {
> 
> +    Status = PchSmiRecordInsert (
> 
> +               &mSrcDescEspiBiosWp,
> 
> +               (PCH_SMI_CALLBACK_FUNCTIONS) EspiSmiCallback,
> 
> +               PchTcoSmiLpcBiosWpType,
> 
> +               &mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect]
> 
> +               );
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      DEBUG ((DEBUG_ERROR, "Fail to register BIOS WP SMI handler \n"));
> 
> +      return Status;
> 
> +    }
> 
> +    Record = DATABASE_RECORD_FROM_LINK
> (mEspiSmiInstance.PchSmiEspiHandle[EspiBiosWrProtect]);
> 
> +    Record->ClearSource = PchTcoSmiClearSource;
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function will register EspiSmiCallback with mSrcDescSerialIrq source
> decriptor
> 
> +  This function make sure there is only one Serial IRQ SMI handler is
> registered.
> 
> +  While any ESPI sub Serial IRQ SMI type is registered, all the Serial IRQ SMI
> 
> +  will go to callback function EspiSmiCallback first, and then dispatchs the
> callbacks
> 
> +  recorded in mEspiSmiInstance.
> 
> +
> 
> +  @retval EFI_SUCCESS Registration succeed
> 
> +  @retval others      Registration failed
> 
> +**/
> 
> +STATIC
> 
> +EFI_STATUS
> 
> +RegisterSerialIrqIfNull (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  if (mEspiSmiInstance.PchSmiEspiHandle[EspiSerialIrq] == NULL) {
> 
> +    Status = PchSmiRecordInsert (
> 
> +               &mSrcDescSerialIrq,
> 
> +               (PCH_SMI_CALLBACK_FUNCTIONS) EspiSmiCallback,
> 
> +               PchSmiSerialIrqType,
> 
> +               &mEspiSmiInstance.PchSmiEspiHandle[EspiSerialIrq]
> 
> +               );
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      DEBUG ((DEBUG_ERROR, "Fail to register Serial IRQ SMI handler \n"));
> 
> +      return Status;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Installs and initialize this protocol
> 
> +
> 
> +  @param[in]  ImageHandle   Not used
> 
> +
> 
> +  @retval     EFI_SUCCESS   Installation succeed
> 
> +  @retval     others        Installation failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallEspiSmi (
> 
> +  IN EFI_HANDLE           ImageHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS    Status;
> 
> +  ESPI_SMI_TYPE EspiSmiType;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "[InstallEspiSmi] Enter\n"));
> 
> +
> 
> +  //
> 
> +  // InitializeListHead for
> mEspiSmiInstance.CallBackDataBase[EspiTopLevelTypeMax]
> 
> +  //
> 
> +  for (EspiSmiType = 0; EspiSmiType < EspiSmiTypeMax; ++EspiSmiType) {
> 
> +    InitializeListHead (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Install EfiEspiSmiDispatchProtocol
> 
> +  //
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &mEspiSmiInstance.Handle,
> 
> +                    &gPchEspiSmiDispatchProtocolGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mEspiSmiInstance.PchEspiSmiDispatchProtocol
> 
> +                    );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "Failed to install eSPI SMI Dispatch
> Protocol\n"));
> 
> +    ASSERT (FALSE);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  // Register eSPI SMM callback to enable Fatal Error handling by default
> handler
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  // Enable LnkType1Err SMI generation for default handler
> 
> +  EspiSmiClearStatus (LnkType1Err);
> 
> +  EspiSmiEnableSource (LnkType1Err);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a BIOS Write Protect event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +BiosWrProtectRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterBiosWrProtectIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, BiosWrProtect,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a BIOS Write Report event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +BiosWrReportRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, BiosWrReport,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Non
> Fatal Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PcNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, PcNonFatalErr,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PcFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, PcFatalErr, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Non Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VwNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, VwNonFatalErr,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Fatal Error
> event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VwFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, VwFatalErr, DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Flash Channel Non Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +FlashNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, FlashNonFatalErr,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Flash Channel Fatal Error
> event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +FlashFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, FlashFatalErr,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Link Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +LnkType1ErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = RegisterSerialIrqIfNull ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +  //
> 
> +  // Insert a record
> 
> +  //
> 
> +  Status = InsertEspiRecord (DispatchFunction, LnkType1Err,
> DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +//
> 
> +// EspiSlave srcdesc
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSrcDescEspiSlave = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_ESPI
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_ESPI
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_ESPI
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a eSPI slave SMI
> 
> +  This routine will also lock down ESPI_SMI_LOCK bit after registration and
> prevent
> 
> +  this handler from unregistration.
> 
> +  On platform that supports more than 1 device through another chip select
> (SPT-H),
> 
> +  the SMI handler itself needs to inspect both the eSPI devices' interrupt
> status registers
> 
> +  (implementation specific for each Slave) in order to identify and service
> the cause.
> 
> +  After servicing it, it has to clear the Slaves' internal SMI# status registers
> 
> +
> 
> +  @param[in]  This                      Not used
> 
> +  @param[in]  DispatchFunction          The callback to execute
> 
> +  @param[out] DispatchHandle            The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS               Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED         Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     EFI_ACCESS_DENIED         The ESPI_SMI_LOCK is set and register
> is blocked.
> 
> +  @retval     others                    Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +EspiSlaveSmiRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // If ESPI_SMI_LOCK is set, the register is blocked.
> 
> +  //
> 
> +  if (PmcIsEspiSmiLockSet ()) {
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // @note: This service doesn't utilize the data base of mEspiSmiInstance.
> 
> +  //        While SMI is triggered it directly goes to the registing
> DispatchFunction
> 
> +  //        instead of EspiSmiCallback.
> 
> +  //
> 
> +  Status = PchSmiRecordInsert (
> 
> +             &mSrcDescEspiSlave,
> 
> +             (PCH_SMI_CALLBACK_FUNCTIONS) DispatchFunction,
> 
> +             PchEspiSmiEspiSlaveType,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  PchSmmClearSource (&mSrcDescEspiSlave);
> 
> +  PchSmmEnableSource (&mSrcDescEspiSlave);
> 
> +
> 
> +  //
> 
> +  // Lock down the ESPI_SMI_LOCK after ESPI SMI is enabled.
> 
> +  //
> 
> +  PmcLockEspiSmiWithS3BootScript ();
> 
> +  //
> 
> +  // Keep the DispatchHandle which will be used for unregister function.
> 
> +  //
> 
> +  mEspiSmiInstance.PchSmiEspiHandle[EspiPmc] = *DispatchHandle;
> 
> +
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileRegisterHandler (&gPchEspiSmiDispatchProtocolGuid,
> (EFI_SMM_HANDLER_ENTRY_POINT2)DispatchFunction,
> (UINTN)RETURN_ADDRESS (0), NULL, 0);
> 
> +  }
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to unregister a callback based on
> handle
> 
> +
> 
> +  @param[in]  This                    Not used
> 
> +  @param[in]  DispatchHandle          Handle acquired during registration
> 
> +
> 
> +  @retval     EFI_SUCCESS             Unregister successful
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has
> bad pointer
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in
> database
> 
> +  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
> 
> +  @retval     EFI_ACCESS_DENIED       DispatchHandle is not allowed to
> unregistered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +EspiSmiUnRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  EFI_HANDLE                      DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS          Status;
> 
> +  ESPI_TOP_LEVEL_TYPE EspiTopLevelType;
> 
> +  ESPI_SMI_TYPE       EspiSmiType;
> 
> +  BOOLEAN             SafeToDisable;
> 
> +  LIST_ENTRY          *LinkInDb;
> 
> +  ESPI_SMI_RECORD     *RecordPointer;
> 
> +  DATABASE_RECORD    *RecordToDelete;
> 
> +
> 
> +  if (DispatchHandle == NULL) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the
> SmmReadyToLock event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  if (((LIST_ENTRY *) DispatchHandle)->ForwardLink == (LIST_ENTRY *)
> EFI_BAD_POINTER) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // For DispatchHandle belongs to Espi Slave SMI, refuses the request of
> unregistration.
> 
> +  //
> 
> +  if (mEspiSmiInstance.PchSmiEspiHandle[EspiPmc] == DispatchHandle) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed for ESPI Slave SMI
> handle! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Iterate through all the database to find the record
> 
> +  //
> 
> +  for (EspiSmiType = 0; EspiSmiType < EspiSmiTypeMax; ++EspiSmiType) {
> 
> +    LinkInDb = GetFirstNode
> (&mEspiSmiInstance.CallbackDataBase[EspiSmiType]);
> 
> +
> 
> +    while (!IsNull (&mEspiSmiInstance.CallbackDataBase[EspiSmiType],
> LinkInDb)) {
> 
> +      if (LinkInDb != (LIST_ENTRY *) DispatchHandle) {
> 
> +        LinkInDb = GetNextNode
> (&mEspiSmiInstance.CallbackDataBase[EspiSmiType], LinkInDb);
> 
> +
> 
> +      } else {
> 
> +        //
> 
> +        // Found the source to be from this list
> 
> +        //
> 
> +        RemoveEntryList (LinkInDb);
> 
> +        RecordPointer = (ESPI_RECORD_FROM_LINK (LinkInDb));
> 
> +
> 
> +        if (mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] != 0) {
> 
> +          if (--mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] == 0) {
> 
> +            EspiSmiDisableSource (EspiSmiType);
> 
> +          }
> 
> +        }
> 
> +
> 
> +        Status = gSmst->SmmFreePool (RecordPointer);
> 
> +        if (EFI_ERROR (Status)) {
> 
> +          ASSERT (FALSE);
> 
> +        }
> 
> +
> 
> +        goto EspiSmiUnRegisterEnd;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  //
> 
> +  // If the code reach here, the handle passed in cannot be found
> 
> +  //
> 
> +  DEBUG ((DEBUG_ERROR, "eSPI SMI handle is not in record database \n"));
> 
> +  ASSERT (FALSE);
> 
> +  return EFI_INVALID_PARAMETER;
> 
> +
> 
> +EspiSmiUnRegisterEnd:
> 
> +
> 
> +  //
> 
> +  // Unregister and clear the handle from PchSmiDispatch
> 
> +  //
> 
> +  for (EspiTopLevelType = 0; EspiTopLevelType < EspiTopLevelTypeMax;
> ++EspiTopLevelType) {
> 
> +    SafeToDisable = TRUE;
> 
> +    //
> 
> +    // Checks all the child events that belongs to a top level status in PMC
> 
> +    //
> 
> +    for (EspiSmiType = mEspiSmiInstance.Barrier[EspiTopLevelType].Start;
> EspiSmiType <= mEspiSmiInstance.Barrier[EspiTopLevelType].End;
> ++EspiSmiType) {
> 
> +      if (mEspiSmiInstance.EspiSmiEventCounter[EspiSmiType] != 0) {
> 
> +        SafeToDisable = FALSE;
> 
> +      }
> 
> +    }
> 
> +    //
> 
> +    // Finally, disable the top level event in PMC
> 
> +    //
> 
> +    if (SafeToDisable) {
> 
> +      if (mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType] != NULL) {
> 
> +        Status = PchSmmCoreUnRegister (NULL,
> mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType]);
> 
> +        ASSERT_EFI_ERROR (Status);
> 
> +        mEspiSmiInstance.PchSmiEspiHandle[EspiTopLevelType] = NULL;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  if (!EFI_ERROR (Status)) {
> 
> +    SmiHandlerProfileUnregisterHandler
> (&gPchEspiSmiDispatchProtocolGuid, RecordToDelete->Callback, NULL, 0);
> 
> +  }
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Returns AND maks for clearing eSPI channel registers errors statuses
> 
> +  In addition to common status bit we add channel specific erro bits to avoid
> clearing them
> 
> +
> 
> +  @param[in]  ChannelNumber           Channel number (0 for PC, 1 for VW, 2
> for OOB, 3 for FA)
> 
> +
> 
> +  @retval     UINT32                  AND mask with all the status bit masked to not
> clear them by mistake
> 
> +**/
> 
> +UINT32
> 
> +GetEspiChannelStatusClearMask (
> 
> +  UINT8       ChannelNumber
> 
> +  )
> 
> +{
> 
> +  UINT32    Data32;
> 
> +
> 
> +  // Common error status bits for all channel registers
> 
> +  Data32 = B_ESPI_PCR_XERR_XNFES | B_ESPI_PCR_XERR_XFES;
> 
> +
> 
> +  // Check channels for channel specific status bits
> 
> +  switch(ChannelNumber) {
> 
> +    case 0:   // Peripheral Channel specific status bits
> 
> +      Data32 |= B_ESPI_PCR_PCERR_PCURD;
> 
> +      break;
> 
> +    case 3:   // Flash Access Channel specific status bits
> 
> +      Data32 |= B_ESPI_PCR_FCERR_SAFBLK;
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  // Return the expected AND mask
> 
> +  return (UINT32)~(Data32);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Checks if channel error register data has Fatal Error bit set
> 
> +  If yes then reset the channel on slave
> 
> +
> 
> +  @param[in]  ChannelBaseAddress      Base address
> 
> +  @param[in]  ChannelNumber           Channel number (0 for PC, 1 for VW, 2
> for OOB, 3 for FA)
> 
> +  @param[in]  SlaveId                 Slave ID of which channel is to be reset
> 
> +**/
> 
> +VOID
> 
> +CheckSlaveChannelErrorAndReset (
> 
> +  UINT16      ChannelBaseAddress,
> 
> +  UINT8       ChannelNumber,
> 
> +  UINT8       SlaveId
> 
> +  )
> 
> +{
> 
> +  UINT32      Data32;
> 
> +  UINT16      ChannelAddress;
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  if (ChannelNumber == 2) {
> 
> +    DEBUG ((DEBUG_INFO, "Channel %d is not supported by this function
> due to lack of error register\n", ChannelNumber));
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  if (!IsEspiSlaveChannelSupported (SlaveId, ChannelNumber)) {
> 
> +    DEBUG ((DEBUG_WARN, "Channel %d is not supported by slave
> device\n", ChannelNumber));
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  // Calculate channel address based on slave id
> 
> +  ChannelAddress = (UINT16) (ChannelBaseAddress + (SlaveId *
> S_ESPI_PCR_XERR));
> 
> +
> 
> +  // Reading channel error register data
> 
> +  Data32 = PchPcrRead32 (PID_ESPISPI, ChannelAddress);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "eSPI channel error register (0x%4X) has value
> 0x%8X\n", ChannelAddress, Data32));
> 
> +
> 
> +  // Check Fatal Error status bit in channel error register data
> 
> +  if ((Data32 & B_ESPI_PCR_XERR_XFES) != 0) {
> 
> +    Status = PchEspiSlaveChannelReset (SlaveId, ChannelNumber);
> 
> +
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      switch (Status) {
> 
> +        case EFI_UNSUPPORTED:
> 
> +          DEBUG ((DEBUG_ERROR, "Slave doesn't support channel %d\n",
> ChannelNumber));
> 
> +          break;
> 
> +        case EFI_TIMEOUT:
> 
> +          DEBUG ((DEBUG_ERROR, "Timeout occured during channel %d reset
> on slave %d\n", ChannelNumber, SlaveId));
> 
> +          break;
> 
> +        default:
> 
> +          DEBUG ((DEBUG_ERROR, "Error occured during channel %d reset\n",
> ChannelNumber));
> 
> +          break;
> 
> +      }
> 
> +    } else {
> 
> +      DEBUG ((DEBUG_INFO, "eSPI Slave %d channel %d reset ended
> successfully\n", SlaveId, ChannelNumber));
> 
> +      // If channel reset was successfull clear the fatal error flag by writing one
> 
> +      // we should be aware not to clear other status bits by mistake and mask
> them
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        ChannelAddress,
> 
> +        GetEspiChannelStatusClearMask (ChannelNumber),
> 
> +        B_ESPI_PCR_XERR_XFES
> 
> +        );
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  eSPI SMI handler for Fatal Error recovery flow
> 
> +**/
> 
> +VOID
> 
> +EspiDefaultFatalErrorHandler (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32      Data32;
> 
> +  UINT8       SlaveId;
> 
> +  UINT8       MaxSlavesCount;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Enter\n"));
> 
> +
> 
> +  MaxSlavesCount = IsEspiSecondSlaveSupported () ? 2 : 1;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] MaxSlavesCount
> %d\n", MaxSlavesCount));
> 
> +
> 
> +  for (SlaveId = 0; SlaveId < MaxSlavesCount; ++SlaveId) {
> 
> +    //
> 
> +    // Check if slave has SLCRR bit set. If it does it means it needs recovery.
> 
> +    //
> 
> +    Data32 = PchPcrRead32 (PID_ESPISPI, (UINT16)
> (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_XERR)));
> 
> +
> 
> +    DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Slave %d LNKERR
> reg 0x%8X\n", SlaveId, Data32));
> 
> +    //
> 
> +    // If SLCRR[31] bit is set we need to recover that slave
> 
> +    //
> 
> +    if ((Data32 & B_ESPI_PCR_LNKERR_SLV0_SLCRR) != 0) {
> 
> +      // 1. Perform in-band reset
> 
> +      PchEspiSlaveInBandReset (SlaveId);
> 
> +
> 
> +      // 2. Channels reset
> 
> +      CheckSlaveChannelErrorAndReset (R_ESPI_PCR_PCERR_SLV0, 0,
> SlaveId); // Peripheral channel reset
> 
> +      CheckSlaveChannelErrorAndReset (R_ESPI_PCR_VWERR_SLV0, 1,
> SlaveId); // Virtual Wire channel reset
> 
> +
> 
> +      // Flash Access channel is not supported for CS1#
> 
> +      if (SlaveId == 0) {
> 
> +        CheckSlaveChannelErrorAndReset (R_ESPI_PCR_PCERR_SLV0, 3,
> SlaveId); // Flash Access channel reset
> 
> +      }
> 
> +
> 
> +      // Clear SLCRR bit of slave after all channels recovery was done
> 
> +      PchPcrAndThenOr32 (
> 
> +        PID_ESPISPI,
> 
> +        (UINT16) (R_ESPI_PCR_LNKERR_SLV0 + (SlaveId * S_ESPI_PCR_XERR)),
> 
> +        (UINT32)~(B_ESPI_PCR_LNKERR_SLV0_LFET1S),
> 
> +        (UINT32) (B_ESPI_PCR_LNKERR_SLV0_SLCRR)
> 
> +        );
> 
> +    }
> 
> +  }
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "[EspiRecoverFromFatalError] Exit\n"));
> 
> +}
> 
> +
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .h
> new file mode 100644
> index 0000000000..4903464fae
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmEspi
> .h
> @@ -0,0 +1,341 @@
> +/** @file
> 
> +  eSPI SMI Dispatch header
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +
> 
> +#ifndef _PCH_SMM_ESPI_H_
> 
> +#define _PCH_SMM_ESPI_H_
> 
> +
> 
> +#include "PchSmmHelpers.h"
> 
> +
> 
> +#define ESPI_SMI_INSTANCE_SIGNATURE       SIGNATURE_32 ('E', 'S', 'P', 'I')
> 
> +#define ESPI_SMI_RECORD_SIGNATURE         SIGNATURE_32 ('E', 'S', 'R', 'C')
> 
> +
> 
> +#define ESPI_INSTANCE_FROM_THIS(_this)      CR (_this,
> ESPI_SMI_INSTANCE, EfiEspiSmiDispatchProtocol,
> ESPI_SMI_INSTANCE_SIGNATURE)
> 
> +#define ESPI_RECORD_FROM_LINK(_link)        CR (_link, ESPI_SMI_RECORD,
> Link, ESPI_SMI_RECORD_SIGNATURE)
> 
> +
> 
> +typedef enum {
> 
> +  EspiBiosWrProtect,    ///< BIOS Write Protect
> 
> +  EspiSerialIrq,        ///< eSPI Master Asserted SMI
> 
> +  EspiPmc,              ///< eSPI PMC SMI
> 
> +  EspiTopLevelTypeMax
> 
> +} ESPI_TOP_LEVEL_TYPE;
> 
> +
> 
> +typedef enum {
> 
> +  BiosWrProtect,        ///< BIOS Write Protect
> 
> +  BiosWrReport,         ///< Peripheral Channel BIOS Write Protect
> 
> +  PcNonFatalErr,        ///< Peripheral Channel Non Fatal Error
> 
> +  PcFatalErr,           ///< Peripheral Channel Fatal Error
> 
> +  VwNonFatalErr,        ///< Virtual Wire Non Fatal Error
> 
> +  VwFatalErr,           ///< Virtual Wire Fatal Error
> 
> +  FlashNonFatalErr,     ///< Flash Channel Non Fatal Error
> 
> +  FlashFatalErr,        ///< Flash Channel Fatal Error
> 
> +  LnkType1Err,          ///< Link Error
> 
> +  EspiSlaveSmi,         ///< Espi Slave SMI
> 
> +  EspiSmiTypeMax
> 
> +} ESPI_SMI_TYPE;
> 
> +
> 
> +///
> 
> +/// This is used to classify ESPI_SMI_TYPE to ESPI_TOP_LEVEL_TYPE.
> 
> +/// Used during dispatching and unregistering
> 
> +///
> 
> +typedef struct {
> 
> +  ESPI_SMI_TYPE Start;
> 
> +  ESPI_SMI_TYPE End;
> 
> +} ESPI_SMI_TYPE_BARRIER;
> 
> +
> 
> +typedef struct _ESPI_SMI_INSTANCE {
> 
> +  ///
> 
> +  /// Signature associated with this instance
> 
> +  ///
> 
> +  UINT32                          Signature;
> 
> +  ///
> 
> +  /// EFI_HANDLE acquired when installing PchEspiSmiDispatchProtocol
> 
> +  ///
> 
> +  EFI_HANDLE                      Handle;
> 
> +  ///
> 
> +  /// The protocol to register or unregister eSPI SMI callbacks
> 
> +  ///
> 
> +  PCH_ESPI_SMI_DISPATCH_PROTOCOL  PchEspiSmiDispatchProtocol;
> 
> +  ///
> 
> +  /// The handle acquired when registering eSPI SMI callback to
> PchSmiDispatch
> 
> +  ///
> 
> +  EFI_HANDLE                      PchSmiEspiHandle[EspiTopLevelTypeMax];
> 
> +  ///
> 
> +  /// The linked list for record database.
> 
> +  ///
> 
> +  LIST_ENTRY                      CallbackDataBase[EspiSmiTypeMax];
> 
> +  ///
> 
> +  /// This is an internal counter to track the number of eSPI master events
> have been registered.
> 
> +  /// When unregistering, we can disable the SMI if the counter is zero
> 
> +  ///
> 
> +  UINTN                           EspiSmiEventCounter[EspiSmiTypeMax];
> 
> +  ///
> 
> +  /// Instance of barrier
> 
> +  ///
> 
> +  CONST ESPI_SMI_TYPE_BARRIER     Barrier[EspiTopLevelTypeMax];
> 
> +} ESPI_SMI_INSTANCE;
> 
> +
> 
> +typedef struct _ESPI_DESCRIPTOR {
> 
> +  PCH_SMM_ADDRESS   Address;
> 
> +  UINT32            SourceIsActiveAndMask;
> 
> +  UINT32            SourceIsActiveValue;
> 
> +  UINT32            ClearStatusAndMask;
> 
> +  UINT32            ClearStatusOrMask;
> 
> +} ESPI_DESCRIPTOR;
> 
> +
> 
> +///
> 
> +/// A simple record to store the callbacks associated with an eSPI SMI
> source
> 
> +///
> 
> +typedef struct _ESPI_SMI_RECORD {
> 
> +  UINT32                          Signature;
> 
> +  LIST_ENTRY                      Link;
> 
> +  PCH_ESPI_SMI_DISPATCH_CALLBACK  Callback;
> 
> +} ESPI_SMI_RECORD;
> 
> +
> 
> +/**
> 
> +  Installs and initialize this protocol
> 
> +
> 
> +  @param[in]  ImageHandle   Not used
> 
> +
> 
> +  @retval     EFI_SUCCESS   Installation succeed
> 
> +  @retval     others        Installation failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallEspiSmi (
> 
> +  IN EFI_HANDLE           ImageHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a BIOS Write Protect event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +BiosWrProtectRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a BIOS Write Report event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +BiosWrReportRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Non
> Fatal Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PcNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Peripheral Channel Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PcFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Non Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VwNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Virtual Wire Fatal Error
> event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +VwFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Flash Channel Non Fatal
> Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +FlashNonFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Flash Channel Fatal Error
> event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +FlashFatalErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a Link Error event
> 
> +
> 
> +  @param[in]  This              Not used
> 
> +  @param[in]  DispatchFunction  The callback to execute
> 
> +  @param[out] DispatchHandle    The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS       Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     others            Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +LnkType1ErrRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK  DispatchFunction,
> 
> +  OUT EFI_HANDLE                      *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to register a eSPI slave SMI
> 
> +  NOTE: The register function is not available when the ESPI_SMI_LOCK bit is
> set.
> 
> +        This runtine will also lock donw ESPI_SMI_LOCK bit after registration
> and
> 
> +        prevent this handler from unregistration.
> 
> +  On platform that supports more than 1 device through another chip select
> (SPT-H),
> 
> +  the SMI handler itself needs to inspect both the eSPI devices' interrupt
> status registers
> 
> +  (implementation specific for each Slave) in order to identify and service
> the cause.
> 
> +  After servicing it, it has to clear the Slaves' internal SMI# status registers
> 
> +
> 
> +  @param[in]  This                      Not used
> 
> +  @param[in]  DispatchFunction          The callback to execute
> 
> +  @param[out] DispatchHandle            The handle for this callback registration
> 
> +
> 
> +  @retval     EFI_SUCCESS               Registration succeed
> 
> +  @retval     EFI_ACCESS_DENIED         Return access denied if the
> SmmReadyToLock event has been triggered
> 
> +  @retval     EFI_ACCESS_DENIED         The ESPI_SMI_LOCK is set and register
> is blocked.
> 
> +  @retval     others                    Registration failed
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +EspiSlaveSmiRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL    *This,
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_CALLBACK    DispatchFunction,
> 
> +  OUT EFI_HANDLE                        *DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI Dispatch Protocol instance to unregister a callback based on
> handle
> 
> +
> 
> +  @param[in]  This                    Not used
> 
> +  @param[in]  DispatchHandle          Handle acquired during registration
> 
> +
> 
> +  @retval     EFI_SUCCESS             Unregister successful
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle is null
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle's forward link has
> bad pointer
> 
> +  @retval     EFI_INVALID_PARAMETER   DispatchHandle does not exist in
> database
> 
> +  @retval     EFI_ACCESS_DENIED       Unregistration is done after end of DXE
> 
> +  @retval     EFI_ACCESS_DENIED       DispatchHandle is not allowed to
> unregistered
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +EspiSmiUnRegister (
> 
> +  IN  PCH_ESPI_SMI_DISPATCH_PROTOCOL  *This,
> 
> +  IN  EFI_HANDLE                      DispatchHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  eSPI SMI handler for Fatal Error recovery flow
> 
> +
> 
> +  @param[in]  DispatchHandle          Handle acquired during registration
> 
> +**/
> 
> +VOID
> 
> +EspiDefaultFatalErrorHandler (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi.
> c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi
> .c
> new file mode 100644
> index 0000000000..61f925c860
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmGpi
> .c
> @@ -0,0 +1,263 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Smm Gpi dispatch
> protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmm.h"
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Library/SmiHandlerProfileLib.h>
> 
> +#include <Register/GpioRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +//
> 
> +// Structure for GPI SMI is a template which needs to have
> 
> +// GPI Smi bit offset and Smi Status & Enable registers updated (accordingly
> 
> +// to choosen group and pad number) after adding it to SMM Callback
> database
> 
> +//
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mPchGpiSourceDescTemplate = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    NULL_BIT_DESC_INITIALIZER,
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        GPIO_ADDR_TYPE, {0x0}
> 
> +      },
> 
> +      S_GPIO_PCR_GP_SMI_STS, 0x0,
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_GPIO_SMI
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  The register function used to register SMI handler of GPI SMI event.
> 
> +
> 
> +  @param[in]  This               Pointer to the
> EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in]  DispatchFunction   Function to register for handler when the
> specified GPI causes an SMI.
> 
> +  @param[in]  RegisterContext    Pointer to the dispatch function's context.
> 
> +                                 The caller fills this context in before calling
> 
> +                                 the register function to indicate to the register
> 
> +                                 function the GPI(s) for which the dispatch function
> 
> +                                 should be invoked.
> 
> +  @param[out] DispatchHandle     Handle generated by the dispatcher to
> track the
> 
> +                                 function instance.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> 
> +                                 registered and the SMI source has been enabled.
> 
> +  @retval EFI_ACCESS_DENIED      Register is not allowed
> 
> +  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The GPI
> input value
> 
> +                                 is not within valid range.
> 
> +  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system
> or SMM) to manage this child.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchGpiSmiRegister (
> 
> +  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_SMM_HANDLER_ENTRY_POINT2    DispatchFunction,
> 
> +  IN       EFI_SMM_GPI_REGISTER_CONTEXT    *RegisterContext,
> 
> +  OUT      EFI_HANDLE                      *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                  Status;
> 
> +  DATABASE_RECORD             Record;
> 
> +  GPIO_PAD                    GpioPad;
> 
> +  UINT8                       GpiSmiBitOffset;
> 
> +  UINT32                      GpiHostSwOwnRegAddress;
> 
> +  UINT32                      GpiSmiStsRegAddress;
> 
> +  UINT32                      Data32Or;
> 
> +  UINT32                      Data32And;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the EndOfDxe event
> has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  Status = GpioGetPadAndSmiRegs (
> 
> +             (UINT32) RegisterContext->GpiNum,
> 
> +             &GpioPad,
> 
> +             &GpiSmiBitOffset,
> 
> +             &GpiHostSwOwnRegAddress,
> 
> +             &GpiSmiStsRegAddress
> 
> +             );
> 
> +
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  ZeroMem (&Record, sizeof (DATABASE_RECORD));
> 
> +
> 
> +  //
> 
> +  // Gather information about the registration request
> 
> +  //
> 
> +  Record.Callback          = DispatchFunction;
> 
> +  Record.ChildContext.Gpi  = *RegisterContext;
> 
> +  Record.ProtocolType      = GpiType;
> 
> +  Record.Signature         = DATABASE_RECORD_SIGNATURE;
> 
> +
> 
> +  CopyMem (&Record.SrcDesc, &mPchGpiSourceDescTemplate, sizeof
> (PCH_SMM_SOURCE_DESC) );
> 
> +
> 
> +  Record.SrcDesc.Sts[0].Reg.Data.raw = GpiSmiStsRegAddress;  // GPI SMI
> Status register
> 
> +  Record.SrcDesc.Sts[0].Bit = GpiSmiBitOffset;               // Bit position for
> selected pad
> 
> +
> 
> +  //
> 
> +  // Insert GpiSmi handler to PchSmmCore database
> 
> +  //
> 
> +  *DispatchHandle = NULL;
> 
> +
> 
> +  Status = SmmCoreInsertRecord (
> 
> +             &Record,
> 
> +             DispatchHandle
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  SmiHandlerProfileRegisterHandler (
> 
> +    &gEfiSmmGpiDispatch2ProtocolGuid,
> 
> +    (EFI_SMM_HANDLER_ENTRY_POINT2) DispatchFunction,
> 
> +    (UINTN)RETURN_ADDRESS (0),
> 
> +    RegisterContext,
> 
> +    sizeof(*RegisterContext)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Enable GPI SMI
> 
> +  // HOSTSW_OWN with respect to generating GPI SMI has negative logic:
> 
> +  //  - 0 (ACPI mode) - GPIO pad will be capable of generating SMI/NMI/SCI
> 
> +  //  - 1 (GPIO mode) - GPIO pad will not generate SMI/NMI/SCI
> 
> +  //
> 
> +  Data32And  = (UINT32)~(1u << GpiSmiBitOffset);
> 
> +  MmioAnd32 (GpiHostSwOwnRegAddress, Data32And);
> 
> +
> 
> +  //
> 
> +  // Add HOSTSW_OWN programming into S3 boot script
> 
> +  //
> 
> +  Data32Or = 0;
> 
> +  S3BootScriptSaveMemReadWrite (S3BootScriptWidthUint32,
> GpiHostSwOwnRegAddress, &Data32Or, &Data32And);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a GPI SMI source dispatch function with a parent SMM driver
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_GPI_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle       Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS             The dispatch function has been successfully
> 
> +                                  unregistered and the SMI source has been disabled
> 
> +                                  if there are no other registered child dispatch
> 
> +                                  functions for this SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER   Handle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchGpiSmiUnRegister (
> 
> +  IN CONST EFI_SMM_GPI_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_HANDLE                      DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS      Status;
> 
> +  DATABASE_RECORD *RecordToDelete;
> 
> +  DATABASE_RECORD *RecordInDb;
> 
> +  LIST_ENTRY      *LinkInDb;
> 
> +  GPIO_PAD        GpioPad;
> 
> +  UINT8           GpiSmiBitOffset;
> 
> +  UINT32          GpiHostSwOwnRegAddress;
> 
> +  UINT32          GpiSmiStsRegAddress;
> 
> +  UINT32          Data32Or;
> 
> +  UINT32          Data32And;
> 
> +  BOOLEAN         DisableGpiSmiSource;
> 
> +
> 
> +
> 
> +  if (DispatchHandle == NULL) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  RecordToDelete = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  if ((RecordToDelete->Signature != DATABASE_RECORD_SIGNATURE) ||
> 
> +      (RecordToDelete->ProtocolType != GpiType)) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the
> SmmReadyToLock event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  DisableGpiSmiSource = TRUE;
> 
> +  //
> 
> +  // Loop through all sources in record linked list to see if any other GPI SMI
> 
> +  // is installed on the same pin. If no then disable GPI SMI capability on this
> pad
> 
> +  //
> 
> +  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
> 
> +  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +    RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
> 
> +    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase,
> &RecordInDb->Link);
> 
> +    //
> 
> +    // If this is the record to delete skip it
> 
> +    //
> 
> +    if (RecordInDb == RecordToDelete) {
> 
> +      continue;
> 
> +    }
> 
> +    //
> 
> +    // Check if record is GPI SMI type
> 
> +    //
> 
> +    if (RecordInDb->ProtocolType == GpiType) {
> 
> +      //
> 
> +      // Check if same GPIO pad is the source of this SMI
> 
> +      //
> 
> +      if (RecordInDb->ChildContext.Gpi.GpiNum == RecordToDelete-
> >ChildContext.Gpi.GpiNum) {
> 
> +        DisableGpiSmiSource = FALSE;
> 
> +        break;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (DisableGpiSmiSource) {
> 
> +    GpioGetPadAndSmiRegs (
> 
> +      (UINT32) RecordToDelete->ChildContext.Gpi.GpiNum,
> 
> +      &GpioPad,
> 
> +      &GpiSmiBitOffset,
> 
> +      &GpiHostSwOwnRegAddress,
> 
> +      &GpiSmiStsRegAddress
> 
> +      );
> 
> +
> 
> +    Data32Or = 1u << GpiSmiBitOffset;
> 
> +    Data32And = 0xFFFFFFFF;
> 
> +    MmioOr32 (GpiHostSwOwnRegAddress, Data32Or);
> 
> +    S3BootScriptSaveMemReadWrite (S3BootScriptWidthUint32,
> GpiHostSwOwnRegAddress, &Data32Or, &Data32And);
> 
> +  }
> 
> +
> 
> +
> 
> +  RemoveEntryList (&RecordToDelete->Link);
> 
> +  ZeroMem (RecordToDelete, sizeof (DATABASE_RECORD));
> 
> +  Status = gSmst->SmmFreePool (RecordToDelete);
> 
> +
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    ASSERT (FALSE);
> 
> +    return Status;
> 
> +  }
> 
> +  SmiHandlerProfileUnregisterHandler (
> 
> +    &gEfiSmmGpiDispatch2ProtocolGuid,
> 
> +    RecordToDelete->Callback,
> 
> +    &RecordToDelete->ChildContext,
> 
> +    RecordToDelete->ContextSize
> 
> +    );
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.c
> new file mode 100644
> index 0000000000..6bbf9ea8e8
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.c
> @@ -0,0 +1,332 @@
> +/** @file
> 
> +  Helper functions for PCH SMM dispatcher.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +///
> 
> +/// #define BIT_ZERO 0x00000001
> 
> +///
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST UINT32  BIT_ZERO =
> 0x00000001;
> 
> +
> 
> +///
> 
> +/// SUPPORT / HELPER FUNCTIONS (PCH version-independent)
> 
> +///
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors' enable settings.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The enable settings of the 2 SMM source
> descriptors are identical.
> 
> +  @retval FALSE                   The enable settings of the 2 SMM source
> descriptors are not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareEnables (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  )
> 
> +{
> 
> +  BOOLEAN IsEqual;
> 
> +  UINTN   DescIndex;
> 
> +
> 
> +  IsEqual = TRUE;
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
> 
> +    ///
> 
> +    /// It's okay to compare a NULL bit description to a non-NULL bit
> description.
> 
> +    /// They are unequal and these tests will generate the correct result.
> 
> +    ///
> 
> +    if (Src1->En[DescIndex].Bit != Src2->En[DescIndex].Bit ||
> 
> +        Src1->En[DescIndex].Reg.Type != Src2->En[DescIndex].Reg.Type ||
> 
> +        Src1->En[DescIndex].Reg.Data.raw != Src2-
> >En[DescIndex].Reg.Data.raw
> 
> +        ) {
> 
> +      IsEqual = FALSE;
> 
> +      break;
> 
> +      ///
> 
> +      /// out of for loop
> 
> +      ///
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return IsEqual;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Compare a bit descriptor to the enables of source descriptor. Includes null
> address type.
> 
> +
> 
> +  @param[in] BitDesc              Pointer to the PCH SMI bit descriptor
> 
> +  @param[in] Src                  Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The bit desc is equal to any of the enables in source
> descriptor
> 
> +  @retval FALSE                   The bid desc is not equal to all of the enables in
> source descriptor
> 
> +**/
> 
> +BOOLEAN
> 
> +IsBitEqualToAnySourceEn (
> 
> +  CONST IN PCH_SMM_BIT_DESC    *BitDesc,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src
> 
> +  )
> 
> +{
> 
> +  BOOLEAN IsEqual;
> 
> +  UINTN   DescIndex;
> 
> +
> 
> +  IsEqual = FALSE;
> 
> +
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; ++DescIndex) {
> 
> +    if ((BitDesc->Reg.Type == Src->En[DescIndex].Reg.Type) &&
> 
> +        (BitDesc->Reg.Data.raw == Src->En[DescIndex].Reg.Data.raw) &&
> 
> +        (BitDesc->Bit == Src->En[DescIndex].Bit)) {
> 
> +      IsEqual = TRUE;
> 
> +      break;
> 
> +    }
> 
> +  }
> 
> +  return IsEqual;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors' statuses.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The statuses of the 2 SMM source descriptors are
> identical.
> 
> +  @retval FALSE                   The statuses of the 2 SMM source descriptors are
> not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareStatuses (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  )
> 
> +{
> 
> +  BOOLEAN IsEqual;
> 
> +  UINTN   DescIndex;
> 
> +
> 
> +  IsEqual = TRUE;
> 
> +
> 
> +  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
> 
> +    ///
> 
> +    /// It's okay to compare a NULL bit description to a non-NULL bit
> description.
> 
> +    /// They are unequal and these tests will generate the correct result.
> 
> +    ///
> 
> +    if (Src1->Sts[DescIndex].Bit != Src2->Sts[DescIndex].Bit ||
> 
> +        Src1->Sts[DescIndex].Reg.Type != Src2->Sts[DescIndex].Reg.Type ||
> 
> +        Src1->Sts[DescIndex].Reg.Data.raw != Src2-
> >Sts[DescIndex].Reg.Data.raw
> 
> +        ) {
> 
> +      IsEqual = FALSE;
> 
> +      break;
> 
> +      ///
> 
> +      /// out of for loop
> 
> +      ///
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return IsEqual;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors, based on Enable settings and Status
> settings of them.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The 2 SMM source descriptors are identical.
> 
> +  @retval FALSE                   The 2 SMM source descriptors are not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareSources (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  )
> 
> +{
> 
> +  return (BOOLEAN) (CompareEnables (Src1, Src2) && CompareStatuses
> (Src1, Src2));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check if an SMM source is active.
> 
> +
> 
> +  @param[in] Src                  Pointer to the PCH SMI source description table
> 
> +  @param[in] SciEn                Indicate if SCI is enabled or not
> 
> +  @param[in] SmiEnValue           Value from R_ACPI_IO_SMI_EN
> 
> +  @param[in] SmiStsValue          Value from R_ACPI_IO_SMI_STS
> 
> +
> 
> +  @retval TRUE                    It is active.
> 
> +  @retval FALSE                   It is inactive.
> 
> +**/
> 
> +BOOLEAN
> 
> +SourceIsActive (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC  *Src,
> 
> +  CONST IN BOOLEAN              SciEn,
> 
> +  CONST IN UINT32               SmiEnValue,
> 
> +  CONST IN UINT32               SmiStsValue
> 
> +  )
> 
> +{
> 
> +  UINTN   DescIndex;
> 
> +
> 
> +  ///
> 
> +  /// This source is dependent on SciEn, and SciEn == 1.  An ACPI OS is
> present,
> 
> +  /// so we shouldn't do anything w/ this source until SciEn == 0.
> 
> +  ///
> 
> +  if ((Src->Flags == PCH_SMM_SCI_EN_DEPENDENT) && (SciEn)) {
> 
> +    return FALSE;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Checking top level SMI status. If the status is not active, return false
> immediately
> 
> +  ///
> 
> +  if (!IS_BIT_DESC_NULL (Src->PmcSmiSts)) {
> 
> +    if ((Src->PmcSmiSts.Reg.Type == ACPI_ADDR_TYPE) &&
> 
> +        (Src->PmcSmiSts.Reg.Data.acpi == R_ACPI_IO_SMI_STS) &&
> 
> +        ((SmiStsValue & (1u << Src->PmcSmiSts.Bit)) == 0)) {
> 
> +      return FALSE;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Read each bit desc from hardware and make sure it's a one
> 
> +  ///
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (Src->En[DescIndex])) {
> 
> +      if ((Src->En[DescIndex].Reg.Type == ACPI_ADDR_TYPE) &&
> 
> +          (Src->En[DescIndex].Reg.Data.acpi == R_ACPI_IO_SMI_EN) &&
> 
> +          ((SmiEnValue & (1u << Src->En[DescIndex].Bit)) == 0)) {
> 
> +        return FALSE;
> 
> +      } else if (ReadBitDesc (&Src->En[DescIndex]) == 0) {
> 
> +        return FALSE;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Read each bit desc from hardware and make sure it's a one
> 
> +  ///
> 
> +  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (Src->Sts[DescIndex])) {
> 
> +      if ((Src->Sts[DescIndex].Reg.Type == ACPI_ADDR_TYPE) &&
> 
> +          (Src->Sts[DescIndex].Reg.Data.acpi == R_ACPI_IO_SMI_STS) &&
> 
> +          ((SmiStsValue & (1u << Src->Sts[DescIndex].Bit)) == 0)) {
> 
> +        return FALSE;
> 
> +      } else if (ReadBitDesc (&Src->Sts[DescIndex]) == 0) {
> 
> +        return FALSE;
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return TRUE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enable the SMI source event by set the SMI enable bit, this function would
> also clear SMI
> 
> +  status bit to make initial state is correct
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmEnableSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINTN DescIndex;
> 
> +
> 
> +  ///
> 
> +  /// Set enables to 1 by writing a 1
> 
> +  ///
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (SrcDesc->En[DescIndex])) {
> 
> +      WriteBitDesc (&SrcDesc->En[DescIndex], 1, FALSE);
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// Clear statuses to 0 by writing a 1
> 
> +  ///
> 
> +  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
> 
> +      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Disable the SMI source event by clear the SMI enable bit
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmDisableSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINTN DescIndex;
> 
> +
> 
> +  for (DescIndex = 0; DescIndex < NUM_EN_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (SrcDesc->En[DescIndex])) {
> 
> +      WriteBitDesc (&SrcDesc->En[DescIndex], 0, FALSE);
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear the SMI status bit by set the source bit of SMI status register
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINTN DescIndex;
> 
> +
> 
> +  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
> 
> +    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
> 
> +      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Sets the source to a 1 and then waits for it to clear.
> 
> +  Be very careful when calling this function -- it will not
> 
> +  ASSERT.  An acceptable case to call the function is when
> 
> +  waiting for the NEWCENTURY_STS bit to clear (which takes
> 
> +  3 RTCCLKs).
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmClearSourceAndBlock (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  )
> 
> +{
> 
> +  UINTN   DescIndex;
> 
> +  BOOLEAN IsSet;
> 
> +
> 
> +  for (DescIndex = 0; DescIndex < NUM_STS_BITS; DescIndex++) {
> 
> +
> 
> +    if (!IS_BIT_DESC_NULL (SrcDesc->Sts[DescIndex])) {
> 
> +      ///
> 
> +      /// Write the bit
> 
> +      ///
> 
> +      WriteBitDesc (&SrcDesc->Sts[DescIndex], 1, TRUE);
> 
> +
> 
> +      ///
> 
> +      /// Don't return until the bit actually clears.
> 
> +      ///
> 
> +      IsSet = TRUE;
> 
> +      while (IsSet) {
> 
> +        IsSet = ReadBitDesc (&SrcDesc->Sts[DescIndex]);
> 
> +        ///
> 
> +        /// IsSet will eventually clear -- or else we'll have
> 
> +        /// an infinite loop.
> 
> +        ///
> 
> +      }
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.h
> new file mode 100644
> index 0000000000..db7713fa02
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmHel
> pers.h
> @@ -0,0 +1,155 @@
> +/** @file
> 
> +  Helper functions for PCH SMM
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef PCH_SMM_HELPERS_H
> 
> +#define PCH_SMM_HELPERS_H
> 
> +
> 
> +#include "PchSmm.h"
> 
> +#include "PchxSmmHelpers.h"
> 
> +//
> 
> +//
> //////////////////////////////////////////////////////////////////////////////
> /////////////////////////////////////
> 
> +// SUPPORT / HELPER FUNCTIONS (PCH version-independent)
> 
> +//
> 
> +
> 
> +/**
> 
> +  Publish SMI Dispatch protocols.
> 
> +
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmPublishDispatchProtocols (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors' enable settings.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The enable settings of the 2 SMM source
> descriptors are identical.
> 
> +  @retval FALSE                   The enable settings of the 2 SMM source
> descriptors are not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareEnables (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Compare a bit descriptor to the enables of source descriptor. Includes null
> address type.
> 
> +
> 
> +  @param[in] BitDesc              Pointer to the PCH SMI bit descriptor
> 
> +  @param[in] Src                  Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The bit desc is equal to any of the enables in source
> descriptor
> 
> +  @retval FALSE                   The bid desc is not equal to all of the enables in
> source descriptor
> 
> +**/
> 
> +BOOLEAN
> 
> +IsBitEqualToAnySourceEn (
> 
> +  CONST IN PCH_SMM_BIT_DESC    *BitDesc,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors' statuses.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The statuses of the 2 SMM source descriptors are
> identical.
> 
> +  @retval FALSE                   The statuses of the 2 SMM source descriptors are
> not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareStatuses (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Compare 2 SMM source descriptors, based on Enable settings and Status
> settings of them.
> 
> +
> 
> +  @param[in] Src1                 Pointer to the PCH SMI source description table 1
> 
> +  @param[in] Src2                 Pointer to the PCH SMI source description table 2
> 
> +
> 
> +  @retval TRUE                    The 2 SMM source descriptors are identical.
> 
> +  @retval FALSE                   The 2 SMM source descriptors are not identical.
> 
> +**/
> 
> +BOOLEAN
> 
> +CompareSources (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src1,
> 
> +  CONST IN PCH_SMM_SOURCE_DESC *Src2
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Check if an SMM source is active.
> 
> +
> 
> +  @param[in] Src                  Pointer to the PCH SMI source description table
> 
> +  @param[in] SciEn                Indicate if SCI is enabled or not
> 
> +  @param[in] SmiEnValue           Value from R_PCH_SMI_EN
> 
> +  @param[in] SmiStsValue          Value from R_PCH_SMI_STS
> 
> +
> 
> +  @retval TRUE                    It is active.
> 
> +  @retval FALSE                   It is inactive.
> 
> +**/
> 
> +BOOLEAN
> 
> +SourceIsActive (
> 
> +  CONST IN PCH_SMM_SOURCE_DESC  *Src,
> 
> +  CONST IN BOOLEAN              SciEn,
> 
> +  CONST IN UINT32               SmiEnValue,
> 
> +  CONST IN UINT32               SmiStsValue
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enable the SMI source event by set the SMI enable bit, this function would
> also clear SMI
> 
> +  status bit to make initial state is correct
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmEnableSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Disable the SMI source event by clear the SMI enable bit
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmDisableSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clear the SMI status bit by set the source bit of SMI status register
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmClearSource (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Sets the source to a 1 and then waits for it to clear.
> 
> +  Be very careful when calling this function -- it will not
> 
> +  ASSERT.  An acceptable case to call the function is when
> 
> +  waiting for the NEWCENTURY_STS bit to clear (which takes
> 
> +  3 RTCCLKs).
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH SMI source description table
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmClearSourceAndBlock (
> 
> +  CONST PCH_SMM_SOURCE_DESC *SrcDesc
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeri
> odicTimer.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeri
> odicTimer.c
> new file mode 100644
> index 0000000000..3c3e638cbf
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPeri
> odicTimer.c
> @@ -0,0 +1,667 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Periodical Timer
> dispatch protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Protocol/PchSmmPeriodicTimerControl.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +
> 
> +//
> 
> +// There is only one instance for PeriodicTimerCommBuffer.
> 
> +// It's safe in SMM since there is no re-entry for the function.
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> EFI_SMM_PERIODIC_TIMER_CONTEXT          mPchPeriodicTimerCommBuffer;
> 
> +
> 
> +typedef enum {
> 
> +  PERIODIC_TIMER= 0,
> 
> +  SWSMI_TIMER,
> 
> +  NUM_TIMERS
> 
> +} SUPPORTED_TIMER;
> 
> +
> 
> +typedef struct _TIMER_INTERVAL {
> 
> +  UINT64  Interval;
> 
> +  UINT8   AssociatedTimer;
> 
> +} TIMER_INTERVAL;
> 
> +
> 
> +#define NUM_INTERVALS 8
> 
> +
> 
> +//
> 
> +// Time constants, in 100 nano-second units
> 
> +//
> 
> +#define TIME_64s    640000000 ///< 64   s
> 
> +#define TIME_32s    320000000 ///< 32   s
> 
> +#define TIME_16s    160000000 ///< 16   s
> 
> +#define TIME_8s     80000000  ///<  8   s
> 
> +#define TIME_64ms   640000    ///< 64   ms
> 
> +#define TIME_32ms   320000    ///< 32   ms
> 
> +#define TIME_16ms   160000    ///< 16   ms
> 
> +#define TIME_1_5ms  15000     ///< 1.5  ms
> 
> +
> 
> +typedef enum {
> 
> +  INDEX_TIME_64s  = 0,
> 
> +  INDEX_TIME_32s,
> 
> +  INDEX_TIME_16s,
> 
> +  INDEX_TIME_8s,
> 
> +  INDEX_TIME_64ms,
> 
> +  INDEX_TIME_32ms,
> 
> +  INDEX_TIME_16ms,
> 
> +  INDEX_TIME_1_5ms,
> 
> +  INDEX_TIME_MAX
> 
> +} TIMER_INTERVAL_INDEX;
> 
> +
> 
> +static TIMER_INTERVAL mSmmPeriodicTimerIntervals[NUM_INTERVALS] = {
> 
> +  {
> 
> +    TIME_64s,
> 
> +    PERIODIC_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_32s,
> 
> +    PERIODIC_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_16s,
> 
> +    PERIODIC_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_8s,
> 
> +    PERIODIC_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_64ms,
> 
> +    SWSMI_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_32ms,
> 
> +    SWSMI_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_16ms,
> 
> +    SWSMI_TIMER
> 
> +  },
> 
> +  {
> 
> +    TIME_1_5ms,
> 
> +    SWSMI_TIMER
> 
> +  },
> 
> +};
> 
> +
> 
> +typedef struct _TIMER_INFO {
> 
> +  UINTN   NumChildren;        ///< number of children using this timer
> 
> +  UINT64  MinReqInterval;     ///< minimum interval required by children
> 
> +  UINTN   CurrentSetting;     ///< interval this timer is set at right now (index
> into interval table)
> 
> +} TIMER_INFO;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED TIMER_INFO
> mTimers[NUM_TIMERS];
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mTimerSourceDesc[NUM_TIMERS] = {
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          ACPI_ADDR_TYPE,
> 
> +          {R_ACPI_IO_SMI_EN}
> 
> +        },
> 
> +        S_ACPI_IO_SMI_EN,
> 
> +        N_ACPI_IO_SMI_EN_PERIODIC
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          ACPI_ADDR_TYPE,
> 
> +          {R_ACPI_IO_SMI_STS}
> 
> +        },
> 
> +        S_ACPI_IO_SMI_STS,
> 
> +        N_ACPI_IO_SMI_STS_PERIODIC
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_PERIODIC
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    PCH_SMM_NO_FLAGS,
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          ACPI_ADDR_TYPE,
> 
> +          {R_ACPI_IO_SMI_EN}
> 
> +        },
> 
> +        S_ACPI_IO_SMI_EN,
> 
> +        N_ACPI_IO_SMI_EN_SWSMI_TMR
> 
> +      },
> 
> +      NULL_BIT_DESC_INITIALIZER
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        {
> 
> +          ACPI_ADDR_TYPE,
> 
> +          {R_ACPI_IO_SMI_STS}
> 
> +        },
> 
> +        S_ACPI_IO_SMI_STS,
> 
> +        N_ACPI_IO_SMI_STS_SWSMI_TMR
> 
> +      }
> 
> +    },
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_SWSMI_TMR
> 
> +    }
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Program Smm Periodic Timer
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC
> instance.
> 
> +**/
> 
> +VOID
> 
> +PchSmmPeriodicTimerProgramTimers (
> 
> +  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Convert the dispatch context to the timer interval, this function will assert
> if then either:
> 
> +  (1) The context contains an invalid interval
> 
> +  (2) The timer interval table is corrupt
> 
> +
> 
> +  @param[in] DispatchContext      The pointer to the Dispatch Context
> 
> +
> 
> +  @retval TIMER_INTERVAL          The timer interval of input dispatch context
> 
> +**/
> 
> +TIMER_INTERVAL *
> 
> +ContextToTimerInterval (
> 
> +  IN  PCH_SMM_CONTEXT     *DispatchContext
> 
> +  )
> 
> +{
> 
> +  UINTN loopvar;
> 
> +
> 
> +  ///
> 
> +  /// Determine which timer this child is using
> 
> +  ///
> 
> +  for (loopvar = 0; loopvar < NUM_INTERVALS; loopvar++) {
> 
> +    if (((DispatchContext->PeriodicTimer.SmiTickInterval == 0) &&
> 
> +         (DispatchContext->PeriodicTimer.Period >=
> mSmmPeriodicTimerIntervals[loopvar].Interval)) ||
> 
> +        (DispatchContext->PeriodicTimer.SmiTickInterval ==
> mSmmPeriodicTimerIntervals[loopvar].Interval)) {
> 
> +      return &mSmmPeriodicTimerIntervals[loopvar];
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// If this assertion fires, then either:
> 
> +  ///    (1) the context contains an invalid interval
> 
> +  ///    (2) the timer interval table is corrupt
> 
> +  ///
> 
> +  ASSERT (FALSE);
> 
> +
> 
> +  return NULL;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Figure out which timer the child is requesting and
> 
> +  send back the source description
> 
> +
> 
> +  @param[in] DispatchContext      The pointer to the Dispatch Context
> instances
> 
> +  @param[out] SrcDesc             The pointer to the source description
> 
> +
> 
> +**/
> 
> +VOID
> 
> +MapPeriodicTimerToSrcDesc (
> 
> +  IN  PCH_SMM_CONTEXT             *DispatchContext,
> 
> +  OUT PCH_SMM_SOURCE_DESC         *SrcDesc
> 
> +  )
> 
> +{
> 
> +  TIMER_INTERVAL  *TimerInterval;
> 
> +
> 
> +  ///
> 
> +  /// Figure out which timer the child is requesting and
> 
> +  /// send back the source description
> 
> +  ///
> 
> +  TimerInterval = ContextToTimerInterval (DispatchContext);
> 
> +  if (TimerInterval == NULL) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  CopyMem (
> 
> +    (VOID *) SrcDesc,
> 
> +    (VOID *) (&mTimerSourceDesc[TimerInterval->AssociatedTimer]),
> 
> +    sizeof (PCH_SMM_SOURCE_DESC)
> 
> +    );
> 
> +
> 
> +  ///
> 
> +  /// Program the value of the interval into hardware
> 
> +  ///
> 
> +  PchSmmPeriodicTimerProgramTimers (SrcDesc);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Update the elapsed time from the Interval data of DATABASE_RECORD
> 
> +
> 
> +  @param[in] Record               The pointer to the DATABASE_RECORD.
> 
> +  @param[out] HwContext           The Context to be updated.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PeriodicTimerGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *HwContext
> 
> +  )
> 
> +{
> 
> +  TIMER_INTERVAL  *TimerInterval;
> 
> +
> 
> +  ASSERT (Record->ProtocolType == PeriodicTimerType);
> 
> +
> 
> +  TimerInterval = ContextToTimerInterval (&Record->ChildContext);
> 
> +  if (TimerInterval == NULL) {
> 
> +    return;
> 
> +  }
> 
> +  ///
> 
> +  /// Ignore the hardware context. It's not required for this protocol.
> 
> +  /// Instead, just increment the child's context.
> 
> +  /// Update the elapsed time w/ the data from our tables
> 
> +  ///
> 
> +  Record->MiscData.ElapsedTime += mTimers[TimerInterval-
> >AssociatedTimer].MinReqInterval;
> 
> +  *HwContext = Record->ChildContext;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether Periodic Timer of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes Periodic Timer  1
> 
> +  @param[in] Context2             Context 2 that includes Periodic Timer  2
> 
> +
> 
> +  @retval FALSE                   Periodic Timer match
> 
> +  @retval TRUE                    Periodic Timer don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +PeriodicTimerCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *HwContext,
> 
> +  IN PCH_SMM_CONTEXT     *ChildContext
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD        *Record;
> 
> +  Record = DATABASE_RECORD_FROM_CHILDCONTEXT (ChildContext);
> 
> +
> 
> +  if (!Record->MiscData.TimerSmiEnabled) {
> 
> +    return FALSE;
> 
> +  }
> 
> +  if (Record->MiscData.ElapsedTime >= ChildContext->PeriodicTimer.Period)
> {
> 
> +    ///
> 
> +    /// For EDKII, the ElapsedTime is reset when
> PeriodicTimerGetCommBuffer
> 
> +    ///
> 
> +    return TRUE;
> 
> +  } else {
> 
> +    return FALSE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Gather the CommBuffer information of SmmPeriodicTimerDispatch2.
> 
> +
> 
> +  @param[in]  Record              No use
> 
> +  @param[out] CommBuffer          Point to the CommBuffer structure
> 
> +  @param[out] CommBufferSize      Point to the Size of CommBuffer
> structure
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PeriodicTimerGetCommBuffer (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT VOID               **CommBuffer,
> 
> +  OUT UINTN              *CommBufferSize
> 
> +  )
> 
> +{
> 
> +  ASSERT (Record->ProtocolType == PeriodicTimerType);
> 
> +
> 
> +  mPchPeriodicTimerCommBuffer.ElapsedTime = Record-
> >MiscData.ElapsedTime;
> 
> +
> 
> +  ///
> 
> +  /// For EDKII, the ElapsedTime is reset here
> 
> +  ///
> 
> +  Record->MiscData.ElapsedTime = 0;
> 
> +
> 
> +  ///
> 
> +  /// Return the CommBuffer
> 
> +  ///
> 
> +  *CommBuffer = (VOID *) &mPchPeriodicTimerCommBuffer;
> 
> +  *CommBufferSize = sizeof (EFI_SMM_PERIODIC_TIMER_CONTEXT);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Program Smm Periodic Timer
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC
> instance.
> 
> +**/
> 
> +VOID
> 
> +PchSmmPeriodicTimerProgramTimers (
> 
> +  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
> 
> +  )
> 
> +{
> 
> +  SUPPORTED_TIMER Timer;
> 
> +  DATABASE_RECORD *RecordInDb;
> 
> +  LIST_ENTRY      *LinkInDb;
> 
> +  TIMER_INTERVAL  *TimerInterval;
> 
> +
> 
> +  ///
> 
> +  /// Find the minimum required interval for each timer
> 
> +  ///
> 
> +  for (Timer = 0; Timer < NUM_TIMERS; Timer++) {
> 
> +    mTimers[Timer].MinReqInterval = ~ (UINT64) 0x0;
> 
> +    mTimers[Timer].NumChildren    = 0;
> 
> +  }
> 
> +
> 
> +  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
> 
> +  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +    RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
> 
> +    if (RecordInDb->ProtocolType == PeriodicTimerType) {
> 
> +      if (RecordInDb->MiscData.TimerSmiEnabled) {
> 
> +        ///
> 
> +        /// This child is registerd with the PeriodicTimer protocol
> 
> +        ///
> 
> +        TimerInterval = ContextToTimerInterval (&RecordInDb->ChildContext);
> 
> +        if (TimerInterval == NULL) {
> 
> +          return;
> 
> +        }
> 
> +
> 
> +        Timer = TimerInterval->AssociatedTimer;
> 
> +        if (Timer < 0 || Timer >= NUM_TIMERS) {
> 
> +          ASSERT (FALSE);
> 
> +          CpuDeadLoop ();
> 
> +          return;
> 
> +        }
> 
> +        if (mTimers[Timer].MinReqInterval > RecordInDb-
> >ChildContext.PeriodicTimer.SmiTickInterval) {
> 
> +          mTimers[Timer].MinReqInterval = RecordInDb-
> >ChildContext.PeriodicTimer.SmiTickInterval;
> 
> +        }
> 
> +        mTimers[Timer].NumChildren++;
> 
> +      }
> 
> +    }
> 
> +    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase,
> &RecordInDb->Link);
> 
> +  }
> 
> +  ///
> 
> +  /// Program the hardware
> 
> +  ///
> 
> +  if (mTimers[PERIODIC_TIMER].NumChildren > 0) {
> 
> +    switch (mTimers[PERIODIC_TIMER].MinReqInterval) {
> 
> +      case TIME_64s:
> 
> +        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate64s);
> 
> +        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_64s;
> 
> +        break;
> 
> +
> 
> +      case TIME_32s:
> 
> +        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate32s);
> 
> +        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_32s;
> 
> +        break;
> 
> +
> 
> +      case TIME_16s:
> 
> +        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate16s);
> 
> +        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_16s;
> 
> +        break;
> 
> +
> 
> +      case TIME_8s:
> 
> +        PmcSetPeriodicSmiRate (PmcPeriodicSmiRate8s);
> 
> +        mTimers[PERIODIC_TIMER].CurrentSetting = INDEX_TIME_8s;
> 
> +        break;
> 
> +
> 
> +      default:
> 
> +        ASSERT (FALSE);
> 
> +        break;
> 
> +    }
> 
> +
> 
> +    ///
> 
> +    /// Restart the timer here, just need to clear the SMI
> 
> +    ///
> 
> +    if (SrcDesc->Sts[0].Bit == N_ACPI_IO_SMI_STS_PERIODIC) {
> 
> +      PchSmmClearSource (&mTimerSourceDesc[PERIODIC_TIMER]);
> 
> +    }
> 
> +  } else {
> 
> +    PchSmmDisableSource (&mTimerSourceDesc[PERIODIC_TIMER]);
> 
> +  }
> 
> +
> 
> +  if (mTimers[SWSMI_TIMER].NumChildren > 0) {
> 
> +    switch (mTimers[SWSMI_TIMER].MinReqInterval) {
> 
> +      case TIME_64ms:
> 
> +        PmcSetSwSmiRate (PmcSwSmiRate64ms);
> 
> +        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_64ms;
> 
> +        break;
> 
> +
> 
> +      case TIME_32ms:
> 
> +        PmcSetSwSmiRate (PmcSwSmiRate32ms);
> 
> +        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_32ms;
> 
> +        break;
> 
> +
> 
> +      case TIME_16ms:
> 
> +        PmcSetSwSmiRate (PmcSwSmiRate16ms);
> 
> +        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_16ms;
> 
> +        break;
> 
> +
> 
> +      case TIME_1_5ms:
> 
> +        PmcSetSwSmiRate (PmcSwSmiRate1p5ms);
> 
> +        mTimers[SWSMI_TIMER].CurrentSetting = INDEX_TIME_1_5ms;
> 
> +        break;
> 
> +
> 
> +      default:
> 
> +        ASSERT (FALSE);
> 
> +        break;
> 
> +    }
> 
> +
> 
> +    ///
> 
> +    /// Restart the timer here, need to disable, clear, then enable to restart
> this timer
> 
> +    ///
> 
> +    if (SrcDesc->Sts[0].Bit == N_ACPI_IO_SMI_STS_SWSMI_TMR) {
> 
> +      PchSmmDisableSource (&mTimerSourceDesc[SWSMI_TIMER]);
> 
> +      PchSmmClearSource (&mTimerSourceDesc[SWSMI_TIMER]);
> 
> +      PchSmmEnableSource (&mTimerSourceDesc[SWSMI_TIMER]);
> 
> +    }
> 
> +  } else {
> 
> +    PchSmmDisableSource (&mTimerSourceDesc[SWSMI_TIMER]);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This services returns the next SMI tick period that is supported by the
> chipset.
> 
> +  The order returned is from longest to shortest interval period.
> 
> +
> 
> +  @param[in] This                 Pointer to the
> EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in, out] SmiTickInterval Pointer to pointer of the next shorter SMI
> interval period that is supported by the child.
> 
> +
> 
> +  @retval EFI_SUCCESS             The service returned successfully.
> 
> +  @retval EFI_INVALID_PARAMETER   The parameter SmiTickInterval is
> invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmPeriodicTimerDispatchGetNextShorterInterval (
> 
> +  IN CONST EFI_SMM_PERIODIC_TIMER_DISPATCH2_PROTOCOL  *This,
> 
> +  IN OUT   UINT64                                     **SmiTickInterval
> 
> +  )
> 
> +{
> 
> +  TIMER_INTERVAL  *IntervalPointer;
> 
> +
> 
> +  ASSERT (SmiTickInterval != NULL);
> 
> +
> 
> +  IntervalPointer = (TIMER_INTERVAL *) *SmiTickInterval;
> 
> +
> 
> +  if (IntervalPointer == NULL) {
> 
> +    ///
> 
> +    /// The first time child requesting an interval
> 
> +    ///
> 
> +    IntervalPointer = &mSmmPeriodicTimerIntervals[0];
> 
> +  } else if (IntervalPointer ==
> &mSmmPeriodicTimerIntervals[NUM_INTERVALS - 1]) {
> 
> +    ///
> 
> +    /// At end of the list
> 
> +    ///
> 
> +    IntervalPointer = NULL;
> 
> +  } else {
> 
> +    if ((IntervalPointer >= &mSmmPeriodicTimerIntervals[0]) &&
> 
> +        (IntervalPointer < &mSmmPeriodicTimerIntervals[NUM_INTERVALS -
> 1])
> 
> +        ) {
> 
> +      ///
> 
> +      /// Get the next interval in the list
> 
> +      ///
> 
> +      IntervalPointer++;
> 
> +    } else {
> 
> +      ///
> 
> +      /// Input is out of range
> 
> +      ///
> 
> +      return EFI_INVALID_PARAMETER;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (IntervalPointer != NULL) {
> 
> +    *SmiTickInterval = &IntervalPointer->Interval;
> 
> +  } else {
> 
> +    *SmiTickInterval = NULL;
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function is responsible for calculating and enabling any timers that are
> required
> 
> +  to dispatch messages to children. The SrcDesc argument isn't acutally used.
> 
> +
> 
> +  @param[in] SrcDesc              Pointer to the PCH_SMM_SOURCE_DESC
> instance.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PchSmmPeriodicTimerClearSource (
> 
> +  IN CONST PCH_SMM_SOURCE_DESC    *SrcDesc
> 
> +  )
> 
> +{
> 
> +  PchSmmPeriodicTimerProgramTimers (SrcDesc);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  Check if the handle is in type of PeriodicTimer
> 
> +
> 
> +  @retval TRUE                          The handle is in type of PeriodicTimer.
> 
> +  @retval FALSE                         The handle is not in type of PeriodicTimer.
> 
> +**/
> 
> +BOOLEAN
> 
> +IsSmmPeriodicTimerHandle (
> 
> +  IN EFI_HANDLE                         DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *RecordInDb;
> 
> +  LIST_ENTRY                            *LinkInDb;
> 
> +
> 
> +  LinkInDb = GetFirstNode (&mPrivateData.CallbackDataBase);
> 
> +  while (!IsNull (&mPrivateData.CallbackDataBase, LinkInDb)) {
> 
> +    if (DispatchHandle == (EFI_HANDLE) LinkInDb) {
> 
> +      RecordInDb = DATABASE_RECORD_FROM_LINK (LinkInDb);
> 
> +      if (RecordInDb->ProtocolType == PeriodicTimerType) {
> 
> +        return TRUE;
> 
> +      }
> 
> +    }
> 
> +    LinkInDb = GetNextNode (&mPrivateData.CallbackDataBase, LinkInDb);
> 
> +  }
> 
> +  return FALSE;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Pause SMM periodic timer callback function.
> 
> +
> 
> +  This function disable the SMI enable of SMI timer according to the
> DispatchHandle,
> 
> +  which is returned by SMM periodic timer callback registration.
> 
> +
> 
> +  @retval EFI_SUCCESS                   This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmPeriodicTimerControlPause (
> 
> +  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
> 
> +  IN EFI_HANDLE                                   DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *RecordInDb;
> 
> +
> 
> +  if (IsSmmPeriodicTimerHandle (DispatchHandle) == FALSE) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  RecordInDb = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  RecordInDb->MiscData.TimerSmiEnabled = FALSE;
> 
> +  //
> 
> +  // reset the timer interval per SMI trigger due to stop a periodic timer SMI
> 
> +  //
> 
> +  PchSmmPeriodicTimerProgramTimers (&RecordInDb->SrcDesc);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Resume SMM periodic timer callback function.
> 
> +
> 
> +  This function enable the SMI enable of SMI timer according to the
> DispatchHandle,
> 
> +  which is returned by SMM periodic timer callback registration.
> 
> +
> 
> +  @retval EFI_SUCCESS                   This operation is complete.
> 
> +  @retval EFI_INVALID_PARAMETER         The DispatchHandle is invalid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSmmPeriodicTimerControlResume (
> 
> +  IN PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL      *This,
> 
> +  IN EFI_HANDLE                                   DispatchHandle
> 
> +  )
> 
> +{
> 
> +  DATABASE_RECORD                       *RecordInDb;
> 
> +
> 
> +  if (IsSmmPeriodicTimerHandle (DispatchHandle) == FALSE) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +  RecordInDb = DATABASE_RECORD_FROM_LINK (DispatchHandle);
> 
> +  RecordInDb->MiscData.TimerSmiEnabled = TRUE;
> 
> +  //
> 
> +  // reset the timer interval per SMI trigger due to resume a periodic timer
> SMI
> 
> +  //
> 
> +  PchSmmPeriodicTimerProgramTimers (&RecordInDb->SrcDesc);
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> PCH_SMM_PERIODIC_TIMER_CONTROL_PROTOCOL
> mPchSmmPeriodicTimerControlProtocol = {
> 
> +  PchSmmPeriodicTimerControlPause,
> 
> +  PchSmmPeriodicTimerControlResume
> 
> +};
> 
> +
> 
> +/**
> 
> +  Install PCH SMM periodic timer control protocol
> 
> +
> 
> +  @param[in] Handle                     handle for this driver
> 
> +
> 
> +  @retval EFI_SUCCESS                   Driver initialization completed successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InstallPchSmmPeriodicTimerControlProtocol (
> 
> +  IN EFI_HANDLE                         Handle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +
> 
> +  //
> 
> +  // Install protocol interface
> 
> +  //
> 
> +  Status = gSmst->SmmInstallProtocolInterface (
> 
> +                    &Handle,
> 
> +                    &gPchSmmPeriodicTimerControlGuid,
> 
> +                    EFI_NATIVE_INTERFACE,
> 
> +                    &mPchSmmPeriodicTimerControlProtocol
> 
> +                    );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPo
> werButton.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPo
> werButton.c
> new file mode 100644
> index 0000000000..bfed944848
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmPo
> werButton.c
> @@ -0,0 +1,81 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Smm Power Button
> dispatch protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <PchSmmHelpers.h>
> 
> +#include <Library/PmcPrivateLib.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mPowerButtonSourceDesc = {
> 
> +  PCH_SMM_SCI_EN_DEPENDENT,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_EN}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_EN,
> 
> +      N_ACPI_IO_PM1_EN_PWRBTN
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_PM1_STS}
> 
> +      },
> 
> +      S_ACPI_IO_PM1_STS,
> 
> +      N_ACPI_IO_PM1_STS_PWRBTN
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_PM1_STS_REG
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get the power button status.
> 
> +
> 
> +  @param[in] Record               The pointer to the DATABASE_RECORD.
> 
> +  @param[out] Context             Calling context from the hardware, will be
> updated with the current power button status.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +PowerButtonGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *Context
> 
> +  )
> 
> +{
> 
> +  if (PmcGetPwrBtnLevel ()) {
> 
> +    Context->PowerButton.Phase = EfiPowerButtonExit;
> 
> +  } else {
> 
> +    Context->PowerButton.Phase = EfiPowerButtonEntry;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether Power Button status of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes Power Button status 1
> 
> +  @param[in] Context2             Context 2 that includes Power Button status 2
> 
> +
> 
> +  @retval FALSE                   Power Button status match
> 
> +  @retval TRUE                    Power Button status don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +PowerButtonCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *Context1,
> 
> +  IN PCH_SMM_CONTEXT     *Context2
> 
> +  )
> 
> +{
> 
> +  return (BOOLEAN) (Context1->PowerButton.Phase == Context2-
> >PowerButton.Phase);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.
> c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.
> c
> new file mode 100644
> index 0000000000..9b13bf6308
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSw.
> c
> @@ -0,0 +1,381 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Smm Sw dispatch
> protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Protocol/SmmCpu.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED EFI_SMM_CPU_PROTOCOL
> *mSmmCpuProtocol;
> 
> +
> 
> +STATIC LIST_ENTRY                       mSwSmiCallbackDataBase;
> 
> +
> 
> +//
> 
> +// "SWSMI" RECORD
> 
> +// Linked list data structures
> 
> +//
> 
> +#define SW_SMI_RECORD_SIGNATURE         SIGNATURE_32 ('S', 'W', 'S', 'M')
> 
> +
> 
> +#define SW_SMI_RECORD_FROM_LINK(_record)  CR (_record,
> SW_SMI_RECORD, Link, SW_SMI_RECORD_SIGNATURE)
> 
> +
> 
> +typedef struct {
> 
> +  UINT32                                Signature;
> 
> +  LIST_ENTRY                            Link;
> 
> +  EFI_SMM_SW_REGISTER_CONTEXT           Context;
> 
> +  EFI_SMM_HANDLER_ENTRY_POINT2          Callback;
> 
> +} SW_SMI_RECORD;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSwSourceDesc = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_APMC
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_APM
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_APM
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Check the SwSmiInputValue to see if there is a duplicated one in the
> database
> 
> +
> 
> +  @param[in] SwSmiInputValue      SwSmiInputValue
> 
> +
> 
> +  @retval EFI_SUCCESS             There is no duplicated SwSmiInputValue
> 
> +  @retval EFI_INVALID_PARAMETER   There is a duplicated
> SwSmiInputValue
> 
> +**/
> 
> +EFI_STATUS
> 
> +SmiInputValueDuplicateCheck (
> 
> +  IN UINTN  SwSmiInputValue
> 
> +  )
> 
> +{
> 
> +  SW_SMI_RECORD   *SwSmiRecord;
> 
> +  LIST_ENTRY      *LinkInDb;
> 
> +
> 
> +  LinkInDb = GetFirstNode (&mSwSmiCallbackDataBase);
> 
> +  while (!IsNull (&mSwSmiCallbackDataBase, LinkInDb)) {
> 
> +    SwSmiRecord = SW_SMI_RECORD_FROM_LINK (LinkInDb);
> 
> +    if (SwSmiRecord->Context.SwSmiInputValue == SwSmiInputValue) {
> 
> +      return EFI_INVALID_PARAMETER;
> 
> +    }
> 
> +    LinkInDb = GetNextNode (&mSwSmiCallbackDataBase, &SwSmiRecord-
> >Link);
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register a child SMI source dispatch function for the specified software
> SMI.
> 
> +
> 
> +  This service registers a function (DispatchFunction) which will be called
> when the software
> 
> +  SMI source specified by RegisterContext->SwSmiCpuIndex is detected. On
> return,
> 
> +  DispatchHandle contains a unique handle which may be used later to
> unregister the function
> 
> +  using UnRegister().
> 
> +
> 
> +  @param[in]  This                 Pointer to the
> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in]  DispatchFunction     Function to register for handler when the
> specified software
> 
> +                                   SMI is generated.
> 
> +  @param[in, out] RegisterContext  Pointer to the dispatch function's
> context.
> 
> +                                   The caller fills this context in before calling
> 
> +                                   the register function to indicate to the register
> 
> +                                   function which Software SMI input value the
> 
> +                                   dispatch function should be invoked for.
> 
> +  @param[out] DispatchHandle       Handle generated by the dispatcher to
> track the
> 
> +                                   function instance.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> 
> +                                 registered and the SMI source has been enabled.
> 
> +  @retval EFI_DEVICE_ERROR       The SW driver was unable to enable the
> SMI source.
> 
> +  @retval EFI_INVALID_PARAMETER  RegisterContext is invalid. The SW SMI
> input value
> 
> +                                 is not within a valid range or is already in use.
> 
> +  @retval EFI_OUT_OF_RESOURCES   There is not enough memory (system
> or SMM) to manage this
> 
> +                                 child.
> 
> +  @retval EFI_OUT_OF_RESOURCES   A unique software SMI value could not
> be assigned
> 
> +                                 for this dispatch.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSwSmiRegister (
> 
> +  IN  EFI_SMM_SW_DISPATCH2_PROTOCOL       *This,
> 
> +  IN  EFI_SMM_HANDLER_ENTRY_POINT2        DispatchFunction,
> 
> +  IN  EFI_SMM_SW_REGISTER_CONTEXT         *DispatchContext,
> 
> +  OUT EFI_HANDLE                          *DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS       Status;
> 
> +  SW_SMI_RECORD    *SwSmiRecord;
> 
> +  UINTN            Index;
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "Register is not allowed if the SmmReadyToLock
> event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Find available SW SMI value if the input is -1
> 
> +  //
> 
> +  if (DispatchContext->SwSmiInputValue == (UINTN) -1) {
> 
> +    for (Index = 1; Index < MAXIMUM_SWI_VALUE; Index++) {
> 
> +      if (!EFI_ERROR (SmiInputValueDuplicateCheck (Index))) {
> 
> +        DispatchContext->SwSmiInputValue = Index;
> 
> +        break;
> 
> +      }
> 
> +    }
> 
> +    if (DispatchContext->SwSmiInputValue == (UINTN) -1) {
> 
> +      return EFI_OUT_OF_RESOURCES;
> 
> +    }
> 
> +  }
> 
> +  //
> 
> +  // Check if it's a valid SW SMI value.
> 
> +  // The value must not bigger than 0xFF.
> 
> +  // And the value must not be 0xFF sincie it's used for SmmControll
> protocol.
> 
> +  //
> 
> +  if (DispatchContext->SwSmiInputValue >= MAXIMUM_SWI_VALUE) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (EFI_ERROR (SmiInputValueDuplicateCheck (DispatchContext-
> >SwSmiInputValue))) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Create database record and add to database
> 
> +  //
> 
> +  Status = gSmst->SmmAllocatePool (
> 
> +                    EfiRuntimeServicesData,
> 
> +                    sizeof (SW_SMI_RECORD),
> 
> +                    (VOID **) &SwSmiRecord
> 
> +                    );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    DEBUG ((DEBUG_ERROR, "Failed to allocate memory for SwSmiRecord!
> \n"));
> 
> +    return EFI_OUT_OF_RESOURCES;
> 
> +  }
> 
> +  //
> 
> +  // Gather information about the registration request
> 
> +  //
> 
> +  SwSmiRecord->Signature               = SW_SMI_RECORD_SIGNATURE;
> 
> +  SwSmiRecord->Context.SwSmiInputValue = DispatchContext-
> >SwSmiInputValue;
> 
> +  SwSmiRecord->Callback                = DispatchFunction;
> 
> +  //
> 
> +  // Publish the S/W SMI numbers in Serial logs used for Debug build.
> 
> +  //
> 
> +  DEBUG ((DEBUG_INFO, "SW SMI NUM %x  Sw Record at Address 0x%X\n",
> SwSmiRecord->Context.SwSmiInputValue, SwSmiRecord));
> 
> +
> 
> +  InsertTailList (&mSwSmiCallbackDataBase, &SwSmiRecord->Link);
> 
> +
> 
> +  //
> 
> +  // Child's handle will be the address linked list link in the record
> 
> +  //
> 
> +  *DispatchHandle = (EFI_HANDLE) (&SwSmiRecord->Link);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Unregister a child SMI source dispatch function for the specified software
> SMI.
> 
> +
> 
> +  This service removes the handler associated with DispatchHandle so that it
> will no longer be
> 
> +  called in response to a software SMI.
> 
> +
> 
> +  @param[in] This                Pointer to the
> EFI_SMM_SW_DISPATCH2_PROTOCOL instance.
> 
> +  @param[in] DispatchHandle      Handle of dispatch function to deregister.
> 
> +
> 
> +  @retval EFI_SUCCESS            The dispatch function has been successfully
> unregistered.
> 
> +  @retval EFI_INVALID_PARAMETER  The DispatchHandle was not valid.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSwSmiUnRegister (
> 
> +  IN CONST EFI_SMM_SW_DISPATCH2_PROTOCOL  *This,
> 
> +  IN       EFI_HANDLE                     DispatchHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS            Status;
> 
> +  SW_SMI_RECORD         *RecordToDelete;
> 
> +
> 
> +  if (DispatchHandle == 0) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Return access denied if the SmmReadyToLock event has been triggered
> 
> +  //
> 
> +  if (mReadyToLock == TRUE) {
> 
> +    DEBUG ((DEBUG_ERROR, "UnRegister is not allowed if the
> SmmReadyToLock event has been triggered! \n"));
> 
> +    return EFI_ACCESS_DENIED;
> 
> +  }
> 
> +
> 
> +  RecordToDelete = SW_SMI_RECORD_FROM_LINK (DispatchHandle);
> 
> +  //
> 
> +  // Take the entry out of the linked list
> 
> +  //
> 
> +  if (RecordToDelete->Signature != SW_SMI_RECORD_SIGNATURE) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  RemoveEntryList (&RecordToDelete->Link);
> 
> +  ZeroMem (RecordToDelete, sizeof (SW_SMI_RECORD));
> 
> +  Status = gSmst->SmmFreePool (RecordToDelete);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Main entry point for an SMM handler dispatch or communicate-based
> callback.
> 
> +
> 
> +  @param[in]     DispatchHandle  The unique handle assigned to this handler
> by SmiHandlerRegister().
> 
> +  @param[in]     Context         Points to an optional handler context which was
> specified when the
> 
> +                                 handler was registered.
> 
> +  @param[in,out] CommBuffer      A pointer to a collection of data in
> memory that will
> 
> +                                 be conveyed from a non-SMM environment into an SMM
> environment.
> 
> +  @param[in,out] CommBufferSize  The size of the CommBuffer.
> 
> +
> 
> +  @retval EFI_SUCCESS                         The interrupt was handled and quiesced.
> No other handlers
> 
> +                                              should still be called.
> 
> +  @retval EFI_WARN_INTERRUPT_SOURCE_QUIESCED  The interrupt has
> been quiesced but other handlers should
> 
> +                                              still be called.
> 
> +  @retval EFI_WARN_INTERRUPT_SOURCE_PENDING   The interrupt is still
> pending and other handlers should still
> 
> +                                              be called.
> 
> +  @retval EFI_INTERRUPT_PENDING               The interrupt could not be
> quiesced.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +PchSwSmiDispatcher (
> 
> +  IN       EFI_HANDLE         DispatchHandle,
> 
> +  IN CONST VOID               *Context,
> 
> +  IN OUT   VOID               *CommBuffer,
> 
> +  IN OUT   UINTN              *CommBufferSize
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  EFI_SMM_SAVE_STATE_IO_INFO            SmiIoInfo;
> 
> +  UINTN                                 CpuIndex;
> 
> +  SW_SMI_RECORD                         *SwSmiRecord;
> 
> +  LIST_ENTRY                            *LinkInDb;
> 
> +  EFI_SMM_SW_CONTEXT                    SwSmiCommBuffer;
> 
> +  UINTN                                 SwSmiCommBufferSize;
> 
> +
> 
> +  SwSmiCommBufferSize      = sizeof (EFI_SMM_SW_CONTEXT);
> 
> +  //
> 
> +  // The value in DataPort might not be accurate in multiple thread
> environment.
> 
> +  // There might be racing condition for R_PCH_IO_APM_STS port.
> 
> +  // Therefor, this is just for reference.
> 
> +  //
> 
> +  SwSmiCommBuffer.DataPort = IoRead8 (R_PCH_IO_APM_STS);
> 
> +
> 
> +  for (CpuIndex = 0; CpuIndex < gSmst->NumberOfCpus; CpuIndex++) {
> 
> +    Status = mSmmCpuProtocol->ReadSaveState (
> 
> +                                mSmmCpuProtocol,
> 
> +                                sizeof (EFI_SMM_SAVE_STATE_IO_INFO),
> 
> +                                EFI_SMM_SAVE_STATE_REGISTER_IO,
> 
> +                                CpuIndex,
> 
> +                                &SmiIoInfo
> 
> +                                );
> 
> +    //
> 
> +    // If this is not the SMI source, skip it.
> 
> +    //
> 
> +    if (EFI_ERROR (Status)) {
> 
> +      continue;
> 
> +    }
> 
> +    //
> 
> +    // If the IO address is not "BYTE" "WRITE" to "R_PCH_IO_APM_CNT
> (0xB2)", skip it.
> 
> +    //
> 
> +    if ((SmiIoInfo.IoPort != R_PCH_IO_APM_CNT) ||
> 
> +        (SmiIoInfo.IoType != EFI_SMM_SAVE_STATE_IO_TYPE_OUTPUT) ||
> 
> +        (SmiIoInfo.IoWidth != EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8))
> 
> +    {
> 
> +      continue;
> 
> +    }
> 
> +    //
> 
> +    // If the IO data is used for SmmControl protocol, skip it.
> 
> +    //
> 
> +    if (SmiIoInfo.IoData == 0xFF) {
> 
> +      continue;
> 
> +    }
> 
> +
> 
> +    SwSmiCommBuffer.SwSmiCpuIndex = CpuIndex;
> 
> +    SwSmiCommBuffer.CommandPort   = (UINT8) SmiIoInfo.IoData;
> 
> +
> 
> +    LinkInDb = GetFirstNode (&mSwSmiCallbackDataBase);
> 
> +    while (!IsNull (&mSwSmiCallbackDataBase, LinkInDb)) {
> 
> +      SwSmiRecord = SW_SMI_RECORD_FROM_LINK (LinkInDb);
> 
> +      if (SwSmiRecord->Context.SwSmiInputValue == SmiIoInfo.IoData) {
> 
> +        SwSmiRecord->Callback ((EFI_HANDLE) &SwSmiRecord->Link,
> &SwSmiRecord->Context, &SwSmiCommBuffer, &SwSmiCommBufferSize);
> 
> +      }
> 
> +      LinkInDb = GetNextNode (&mSwSmiCallbackDataBase, &SwSmiRecord-
> >Link);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Init required protocol for Pch Sw Dispatch protocol.
> 
> +**/
> 
> +VOID
> 
> +PchSwDispatchInit (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  EFI_HANDLE                            DispatchHandle;
> 
> +  DATABASE_RECORD                       Record;
> 
> +
> 
> +  //
> 
> +  // Locate PI SMM CPU protocol
> 
> +  //
> 
> +  Status = gSmst->SmmLocateProtocol (&gEfiSmmCpuProtocolGuid, NULL,
> (VOID **)&mSmmCpuProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Initialize SW SMI Callback DataBase
> 
> +  //
> 
> +  InitializeListHead (&mSwSmiCallbackDataBase);
> 
> +
> 
> +  //
> 
> +  // Insert SwSmi handler to PchSmmCore database
> 
> +  // There will always be one SwType record in PchSmmCore database
> 
> +  //
> 
> +  ZeroMem (&Record, sizeof (DATABASE_RECORD));
> 
> +  Record.Signature    = DATABASE_RECORD_SIGNATURE;
> 
> +  Record.Callback     = PchSwSmiDispatcher;
> 
> +  Record.ProtocolType = SwType;
> 
> +
> 
> +  CopyMem (&Record.SrcDesc, &mSwSourceDesc, sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +
> 
> +  DispatchHandle      = NULL;
> 
> +  Status = SmmCoreInsertRecord (
> 
> +             &Record,
> 
> +             &DispatchHandle
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
> new file mode 100644
> index 0000000000..7d79f21dbd
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmSx.c
> @@ -0,0 +1,224 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Smm Sx dispatch
> protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Register/PchPcieRpRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include "PchSmiHelper.h"
> 
> +
> 
> +extern BOOLEAN               mS3SusStart;
> 
> +#define PROGRESS_CODE_S3_SUSPEND_END  PcdGet32
> (PcdProgressCodeS3SuspendEnd)
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mSxSourceDesc = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_ON_SLP_EN
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_ON_SLP_EN
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_ON_SLP_EN
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Get the Sleep type
> 
> +
> 
> +  @param[in] Record               No use
> 
> +  @param[out] Context             The context that includes SLP_TYP bits to be
> filled
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SxGetContext (
> 
> +  IN  DATABASE_RECORD    *Record,
> 
> +  OUT PCH_SMM_CONTEXT    *Context
> 
> +  )
> 
> +{
> 
> +  UINT32  Pm1Cnt;
> 
> +
> 
> +  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
> 
> +
> 
> +  ///
> 
> +  /// By design, the context phase will always be ENTRY
> 
> +  ///
> 
> +  Context->Sx.Phase = SxEntry;
> 
> +
> 
> +  ///
> 
> +  /// Map the PM1_CNT register's SLP_TYP bits to the context type
> 
> +  ///
> 
> +  switch (Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) {
> 
> +    case V_ACPI_IO_PM1_CNT_S0:
> 
> +      Context->Sx.Type = SxS0;
> 
> +      break;
> 
> +
> 
> +    case V_ACPI_IO_PM1_CNT_S1:
> 
> +      Context->Sx.Type = SxS1;
> 
> +      break;
> 
> +
> 
> +    case V_ACPI_IO_PM1_CNT_S3:
> 
> +      Context->Sx.Type = SxS3;
> 
> +      break;
> 
> +
> 
> +    case V_ACPI_IO_PM1_CNT_S4:
> 
> +      Context->Sx.Type = SxS4;
> 
> +      break;
> 
> +
> 
> +    case V_ACPI_IO_PM1_CNT_S5:
> 
> +      Context->Sx.Type = SxS5;
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Check whether sleep type of two contexts match
> 
> +
> 
> +  @param[in] Context1             Context 1 that includes sleep type 1
> 
> +  @param[in] Context2             Context 2 that includes sleep type 2
> 
> +
> 
> +  @retval FALSE                   Sleep types match
> 
> +  @retval TRUE                    Sleep types don't match
> 
> +**/
> 
> +BOOLEAN
> 
> +EFIAPI
> 
> +SxCmpContext (
> 
> +  IN PCH_SMM_CONTEXT     *Context1,
> 
> +  IN PCH_SMM_CONTEXT     *Context2
> 
> +  )
> 
> +{
> 
> +  return (BOOLEAN) (Context1->Sx.Type == Context2->Sx.Type);
> 
> +}
> 
> +
> 
> +/**
> 
> +  For each PCIE RP clear PME SCI status and disable SCI, then
> PCIEXP_WAKE_STS from PMC.
> 
> +  This prevents platform from waking more than one time due to a single
> PCIE wake event.
> 
> +  Normally it's up to OS to clear SCI statuses. But in a scenario where
> platform wakes
> 
> +  and goes to S5 instead of booting to OS, the SCI status would remain set
> and would trigger another wake.
> 
> +**/
> 
> +VOID
> 
> +ClearPcieSci (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32 MaxPorts;
> 
> +  UINT32 RpIndex;
> 
> +  UINT64 RpBase;
> 
> +
> 
> +  MaxPorts = GetPchMaxPciePortNum ();
> 
> +  for (RpIndex = 0; RpIndex < MaxPorts; RpIndex++) {
> 
> +    RpBase = PchPcieRpPciCfgBase (RpIndex);
> 
> +  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) != 0xFFFF) {
> 
> +      PciSegmentAnd8 ((RpBase + R_PCH_PCIE_CFG_MPC + 3),
> (UINT8)~((UINT8)(B_PCH_PCIE_CFG_MPC_PMCE >> 24)));
> 
> +      PciSegmentWrite32 (RpBase + R_PCH_PCIE_CFG_SMSCS,
> B_PCH_PCIE_CFG_SMSCS_PMCS);
> 
> +    }
> 
> +  }
> 
> +  IoWrite16 (mAcpiBaseAddr + R_ACPI_IO_PM1_STS,
> B_ACPI_IO_PM1_STS_PCIEXP_WAKE_STS);
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  When we get an SMI that indicates that we are transitioning to a sleep
> state,
> 
> +  we need to actually transition to that state.  We do this by disabling the
> 
> +  "SMI on sleep enable" feature, which generates an SMI when the
> operating system
> 
> +  tries to put the system to sleep, and then physically putting the system to
> sleep.
> 
> +
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmSxGoToSleep (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32      Pm1Cnt;
> 
> +
> 
> +  ClearPcieSci ();
> 
> +
> 
> +  ///
> 
> +  /// Disable SMIs
> 
> +  ///
> 
> +  PchSmmClearSource (&mSxSourceDesc);
> 
> +  PchSmmDisableSource (&mSxSourceDesc);
> 
> +
> 
> +  ///
> 
> +  /// Get Power Management 1 Control Register Value
> 
> +  ///
> 
> +  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
> 
> +
> 
> +  ///
> 
> +  /// Record S3 suspend performance data
> 
> +  ///
> 
> +  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) ==
> V_ACPI_IO_PM1_CNT_S3) {
> 
> +    ///
> 
> +    /// Report status code before goto S3 sleep
> 
> +    ///
> 
> +    REPORT_STATUS_CODE (EFI_PROGRESS_CODE,
> PROGRESS_CODE_S3_SUSPEND_END);
> 
> +    mS3SusStart = FALSE;
> 
> +    ///
> 
> +    /// Write back cache into memory and invalidate cache before going to
> sleep.
> 
> +    ///
> 
> +    AsmWbinvd ();
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Now that SMIs are disabled, write to the SLP_EN bit again to trigger the
> sleep
> 
> +  ///
> 
> +  Pm1Cnt |= B_ACPI_IO_PM1_CNT_SLP_EN;
> 
> +
> 
> +  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT), Pm1Cnt);
> 
> +
> 
> +  ///
> 
> +  /// Should only proceed if wake event is generated.
> 
> +  ///
> 
> +  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SLP_TYP) ==
> V_ACPI_IO_PM1_CNT_S1) {
> 
> +    while (((IoRead16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS))) &
> B_ACPI_IO_PM1_STS_WAK) == 0x0);
> 
> +  } else {
> 
> +    CpuDeadLoop ();
> 
> +  }
> 
> +  ///
> 
> +  /// The system just went to sleep. If the sleep state was S1, then code
> execution will resume
> 
> +  /// here when the system wakes up.
> 
> +  ///
> 
> +  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
> 
> +
> 
> +  if ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) == 0) {
> 
> +    ///
> 
> +    /// An ACPI OS isn't present, clear the sleep information
> 
> +    ///
> 
> +    Pm1Cnt &= ~B_ACPI_IO_PM1_CNT_SLP_TYP;
> 
> +    Pm1Cnt |= V_ACPI_IO_PM1_CNT_S0;
> 
> +
> 
> +    IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT), Pm1Cnt);
> 
> +  }
> 
> +
> 
> +  PchSmmClearSource (&mSxSourceDesc);
> 
> +  PchSmmEnableSource (&mSxSourceDesc);
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb
> .c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb
> .c
> new file mode 100644
> index 0000000000..a0c67bd959
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchSmmUsb
> .c
> @@ -0,0 +1,230 @@
> +/** @file
> 
> +  File to contain all the hardware specific stuff for the Smm USB dispatch
> protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Register/UsbRegs.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include <Library/PchPciBdfLib.h>
> 
> +#include <PchBdfAssignment.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mUsb1Legacy = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_LEGACY_USB
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_LEGACY_USB
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_LEGACY_USB
> 
> +  }
> 
> +};
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CONST PCH_SMM_SOURCE_DESC
> mUsb3Legacy = {
> 
> +  PCH_SMM_NO_FLAGS,
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_EN}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_EN,
> 
> +      N_ACPI_IO_SMI_EN_LEGACY_USB3
> 
> +    },
> 
> +    NULL_BIT_DESC_INITIALIZER
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      {
> 
> +        ACPI_ADDR_TYPE,
> 
> +        {R_ACPI_IO_SMI_STS}
> 
> +      },
> 
> +      S_ACPI_IO_SMI_STS,
> 
> +      N_ACPI_IO_SMI_STS_LEGACY_USB3
> 
> +    }
> 
> +  },
> 
> +  {
> 
> +    {
> 
> +      ACPI_ADDR_TYPE,
> 
> +      {R_ACPI_IO_SMI_STS}
> 
> +    },
> 
> +    S_ACPI_IO_SMI_STS,
> 
> +    N_ACPI_IO_SMI_STS_LEGACY_USB3
> 
> +  }
> 
> +};
> 
> +
> 
> +typedef enum {
> 
> +  PchUsbControllerLpc0    = 0,
> 
> +  PchUsbControllerXhci,
> 
> +  PchUsbControllerTypeMax
> 
> +} PCH_USB_CONTROLLER_TYPE;
> 
> +
> 
> +typedef struct {
> 
> +  UINT8                   Function;
> 
> +  UINT8                   Device;
> 
> +  PCH_USB_CONTROLLER_TYPE UsbConType;
> 
> +} USB_CONTROLLER;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED USB_CONTROLLER
> mUsbControllersMap[] = {
> 
> +  {
> 
> +    PCI_FUNCTION_NUMBER_PCH_LPC,
> 
> +    PCI_DEVICE_NUMBER_PCH_LPC,
> 
> +    PchUsbControllerLpc0
> 
> +  },
> 
> +  {
> 
> +    PCI_FUNCTION_NUMBER_PCH_XHCI,
> 
> +    PCI_DEVICE_NUMBER_PCH_XHCI,
> 
> +    PchUsbControllerXhci
> 
> +  }
> 
> +};
> 
> +
> 
> +/**
> 
> +  Find the handle that best matches the input Device Path and return the
> USB controller type
> 
> +
> 
> +  @param[in] DevicePath           Pointer to the device Path table
> 
> +  @param[out] Controller          Returned with the USB controller type of the
> input device path
> 
> +
> 
> +  @retval EFI_SUCCESS             Find the handle that best matches the input
> Device Path
> 
> +  @exception EFI_UNSUPPORTED      Invalid device Path table or can't find
> any match USB device path
> 
> +                                  PCH_USB_CONTROLLER_TYPE The USB controller type of
> the input
> 
> +                                  device path
> 
> +**/
> 
> +EFI_STATUS
> 
> +DevicePathToSupportedController (
> 
> +  IN  EFI_DEVICE_PATH_PROTOCOL   *DevicePath,
> 
> +  OUT PCH_USB_CONTROLLER_TYPE    *Controller
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                Status;
> 
> +  EFI_HANDLE                DeviceHandle;
> 
> +  ACPI_HID_DEVICE_PATH      *AcpiNode;
> 
> +  PCI_DEVICE_PATH           *PciNode;
> 
> +  EFI_DEVICE_PATH_PROTOCOL  *RemaingDevicePath;
> 
> +  UINT8                     UsbIndex;
> 
> +  ///
> 
> +  /// Find the handle that best matches the Device Path. If it is only a
> 
> +  /// partial match the remaining part of the device path is returned in
> 
> +  /// RemainingDevicePath.
> 
> +  ///
> 
> +  RemaingDevicePath = DevicePath;
> 
> +  Status = gBS->LocateDevicePath (
> 
> +                  &gEfiPciRootBridgeIoProtocolGuid,
> 
> +                  &DevicePath,
> 
> +                  &DeviceHandle
> 
> +                  );
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +
> 
> +  DevicePath = RemaingDevicePath;
> 
> +
> 
> +  ///
> 
> +  /// Get first node: Acpi Node
> 
> +  ///
> 
> +  AcpiNode = (ACPI_HID_DEVICE_PATH *) RemaingDevicePath;
> 
> +
> 
> +  if (AcpiNode->Header.Type != ACPI_DEVICE_PATH ||
> 
> +      AcpiNode->Header.SubType != ACPI_DP ||
> 
> +      DevicePathNodeLength (&AcpiNode->Header) != sizeof
> (ACPI_HID_DEVICE_PATH) ||
> 
> +      AcpiNode->HID != EISA_PNP_ID (0x0A03) ||
> 
> +      AcpiNode->UID != 0
> 
> +      ) {
> 
> +    return EFI_UNSUPPORTED;
> 
> +  } else {
> 
> +    ///
> 
> +    /// Get the next node: Pci Node
> 
> +    ///
> 
> +    RemaingDevicePath = NextDevicePathNode (RemaingDevicePath);
> 
> +    PciNode           = (PCI_DEVICE_PATH *) RemaingDevicePath;
> 
> +    if (PciNode->Header.Type != HARDWARE_DEVICE_PATH ||
> 
> +        PciNode->Header.SubType != HW_PCI_DP ||
> 
> +        DevicePathNodeLength (&PciNode->Header) != sizeof
> (PCI_DEVICE_PATH)
> 
> +        ) {
> 
> +      return EFI_UNSUPPORTED;
> 
> +    }
> 
> +
> 
> +    for (UsbIndex = 0; UsbIndex < sizeof (mUsbControllersMap) / sizeof
> (USB_CONTROLLER); UsbIndex++) {
> 
> +      if ((PciNode->Device == mUsbControllersMap[UsbIndex].Device) &&
> 
> +          (PciNode->Function == mUsbControllersMap[UsbIndex].Function)) {
> 
> +        *Controller = mUsbControllersMap[UsbIndex].UsbConType;
> 
> +        return EFI_SUCCESS;
> 
> +      }
> 
> +    }
> 
> +
> 
> +    return EFI_UNSUPPORTED;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Maps a USB context to a source description.
> 
> +
> 
> +  @param[in] Context              The context we need to map.  Type must be
> USB.
> 
> +  @param[in] SrcDesc              The source description that corresponds to the
> given context.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +MapUsbToSrcDesc (
> 
> +  IN  PCH_SMM_CONTEXT         *Context,
> 
> +  OUT PCH_SMM_SOURCE_DESC     *SrcDesc
> 
> +  )
> 
> +{
> 
> +  PCH_USB_CONTROLLER_TYPE Controller;
> 
> +  EFI_STATUS              Status;
> 
> +
> 
> +  Status = DevicePathToSupportedController (Context->Usb.Device,
> &Controller);
> 
> +  ///
> 
> +  /// Either the device path passed in by the child is incorrect or
> 
> +  /// the ones stored here internally are incorrect.
> 
> +  ///
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  switch (Context->Usb.Type) {
> 
> +    case UsbLegacy:
> 
> +      switch (Controller) {
> 
> +        case PchUsbControllerLpc0:
> 
> +          CopyMem ((VOID *) SrcDesc, (VOID *) (&mUsb1Legacy), sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +          break;
> 
> +
> 
> +        case PchUsbControllerXhci:
> 
> +          CopyMem ((VOID *) SrcDesc, (VOID *) (&mUsb3Legacy), sizeof
> (PCH_SMM_SOURCE_DESC));
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case UsbWake:
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.c
> new file mode 100644
> index 0000000000..a0b7e37d46
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.c
> @@ -0,0 +1,778 @@
> +/** @file
> 
> +  This driver is responsible for the registration of child drivers
> 
> +  and the abstraction of the PCH SMI sources.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "PchSmmHelpers.h"
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +
> 
> +//
> 
> +// Help handle porting bit shifts to IA-64.
> 
> +//
> 
> +#define BIT_ZERO  0x00000001
> 
> +
> 
> +/**
> 
> +  Publish SMI Dispatch protocols.
> 
> +
> 
> +
> 
> +**/
> 
> +VOID
> 
> +PchSmmPublishDispatchProtocols (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS Status = EFI_SUCCESS;
> 
> +  UINTN      Index;
> 
> +  //
> 
> +  // Install protocol interfaces.
> 
> +  //
> 
> +  for (Index = 0; Index < PCH_SMM_PROTOCOL_TYPE_MAX; Index++) {
> 
> +    Status = gSmst->SmmInstallProtocolInterface (
> 
> +                      &mPrivateData.InstallMultProtHandle,
> 
> +                      mPrivateData.Protocols[Index].Guid,
> 
> +                      EFI_NATIVE_INTERFACE,
> 
> +                      &mPrivateData.Protocols[Index].Protocols.Generic
> 
> +                      );
> 
> +  }
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +}
> 
> +
> 
> +/**
> 
> +  Initialize bits that aren't necessarily related to an SMI source.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             SMI source initialization completed.
> 
> +  @retval Asserts                 Global Smi Bit is not enabled successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmInitHardware (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +
> 
> +  //
> 
> +  // Clear all SMIs
> 
> +  //
> 
> +  PchSmmClearSmi ();
> 
> +
> 
> +  Status = PchSmmEnableGlobalSmiBit ();
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Be *really* sure to clear all SMIs
> 
> +  //
> 
> +  PchSmmClearSmi ();
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Enables the PCH to generate SMIs. Note that no SMIs will be generated
> 
> +  if no SMI sources are enabled. Conversely, no enabled SMI source will
> 
> +  generate SMIs if SMIs are not globally enabled. This is the main
> 
> +  switchbox for SMI generation.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             Enable Global Smi Bit completed
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmEnableGlobalSmiBit (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SmiEn;
> 
> +
> 
> +  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
> 
> +
> 
> +  //
> 
> +  // Set the "global smi enable" bit
> 
> +  //
> 
> +  SmiEn |= B_ACPI_IO_SMI_EN_GBL_SMI;
> 
> +
> 
> +  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN), SmiEn);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clears the SMI after all SMI source have been processed.
> 
> +  Note that this function will not work correctly (as it is
> 
> +  written) unless all SMI sources have been processed.
> 
> +  A revision of this function could manually clear all SMI
> 
> +  status bits to guarantee success.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             Clears the SMIs completed
> 
> +  @retval Asserts                 EOS was not set to a 1
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmClearSmi (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  BOOLEAN     EosSet;
> 
> +  BOOLEAN     SciEn;
> 
> +  UINT32      Pm1Cnt;
> 
> +  UINT16      Pm1Sts;
> 
> +  UINT32      Gpe0Sts;
> 
> +  UINT32      SmiSts;
> 
> +  UINT16      DevActSts;
> 
> +  UINT16      Tco1Sts;
> 
> +
> 
> +  Gpe0Sts      = 0;
> 
> +  //
> 
> +  // Determine whether an ACPI OS is present (via the SCI_EN bit)
> 
> +  //
> 
> +  Pm1Cnt = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
> 
> +  SciEn  = (BOOLEAN) ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) ==
> B_ACPI_IO_PM1_CNT_SCI_EN);
> 
> +  if (!SciEn) {
> 
> +    //
> 
> +    // Clear any SMIs that double as SCIs (when SCI_EN==0)
> 
> +    //
> 
> +    Pm1Sts   = IoRead16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS));
> 
> +    Gpe0Sts  = IoRead32 ((UINTN) (mAcpiBaseAddr +
> R_ACPI_IO_GPE0_STS_127_96));
> 
> +
> 
> +    Pm1Sts |=
> 
> +    (
> 
> +      B_ACPI_IO_PM1_STS_WAK |
> 
> +      B_ACPI_IO_PM1_STS_PRBTNOR |
> 
> +      B_ACPI_IO_PM1_STS_RTC |
> 
> +      B_ACPI_IO_PM1_STS_PWRBTN |
> 
> +      B_ACPI_IO_PM1_STS_GBL |
> 
> +      B_ACPI_IO_PM1_STS_TMROF
> 
> +      );
> 
> +
> 
> +    Gpe0Sts |=
> 
> +    (
> 
> +      B_ACPI_IO_GPE0_STS_127_96_WADT |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_PME_B0 |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_PME |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_BATLOW |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_RI |
> 
> +      B_ACPI_IO_GPE0_STS_127_96_SWGPE
> 
> +      );
> 
> +
> 
> +    IoWrite16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_STS), (UINT16)
> Pm1Sts);
> 
> +    IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_GPE0_STS_127_96),
> (UINT32) Gpe0Sts);
> 
> +  }
> 
> +  //
> 
> +  // Clear all SMIs that are unaffected by SCI_EN
> 
> +  //
> 
> +  SmiSts        = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_STS));
> 
> +  DevActSts     = IoRead16 ((UINTN) (mAcpiBaseAddr +
> R_ACPI_IO_DEVACT_STS));
> 
> +  Tco1Sts       = IoRead16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO1_STS));
> 
> +
> 
> +  SmiSts |=
> 
> +  (
> 
> +    B_ACPI_IO_SMI_STS_SMBUS |
> 
> +    B_ACPI_IO_SMI_STS_PERIODIC |
> 
> +    B_ACPI_IO_SMI_STS_TCO |
> 
> +    B_ACPI_IO_SMI_STS_MCSMI |
> 
> +    B_ACPI_IO_SMI_STS_SWSMI_TMR |
> 
> +    B_ACPI_IO_SMI_STS_APM |
> 
> +    B_ACPI_IO_SMI_STS_ON_SLP_EN |
> 
> +    B_ACPI_IO_SMI_STS_BIOS
> 
> +    );
> 
> +  DevActSts |=
> 
> +  (
> 
> +    B_ACPI_IO_DEVACT_STS_KBC |
> 
> +    B_ACPI_IO_DEVACT_STS_PIRQDH |
> 
> +    B_ACPI_IO_DEVACT_STS_PIRQCG |
> 
> +    B_ACPI_IO_DEVACT_STS_PIRQBF |
> 
> +    B_ACPI_IO_DEVACT_STS_PIRQAE
> 
> +    );
> 
> +  Tco1Sts |=
> 
> +  (
> 
> +    B_TCO_IO_TCO1_STS_DMISERR |
> 
> +    B_TCO_IO_TCO1_STS_DMISMI |
> 
> +    B_TCO_IO_TCO1_STS_DMISCI |
> 
> +    B_TCO_IO_TCO1_STS_BIOSWR |
> 
> +    B_TCO_IO_TCO1_STS_NEWCENTURY |
> 
> +    B_TCO_IO_TCO1_STS_TIMEOUT |
> 
> +    B_TCO_IO_TCO1_STS_TCO_INT |
> 
> +    B_TCO_IO_TCO1_STS_SW_TCO_SMI
> 
> +    );
> 
> +
> 
> +  GpioClearAllGpiSmiSts ();
> 
> +
> 
> +  IoWrite16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO1_STS), Tco1Sts);
> 
> +
> 
> +  //
> 
> +  // We do not want to write 1 to clear INTRD_DET bit.
> 
> +  //
> 
> +  IoWrite16 ((UINTN) (mTcoBaseAddr + R_TCO_IO_TCO2_STS), (UINT16)
> ~B_TCO_IO_TCO2_STS_INTRD_DET);
> 
> +
> 
> +  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_STS), SmiSts);
> 
> +
> 
> +  IoWrite16 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_DEVACT_STS),
> DevActSts);
> 
> +
> 
> +  //
> 
> +  // Try to clear the EOS bit. ASSERT on an error
> 
> +  //
> 
> +  EosSet = PchSmmSetAndCheckEos ();
> 
> +  ASSERT (EosSet);
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Set the SMI EOS bit after all SMI source have been processed.
> 
> +
> 
> +
> 
> +  @retval FALSE                   EOS was not set to a 1; this is an error
> 
> +  @retval TRUE                    EOS was correctly set to a 1
> 
> +**/
> 
> +BOOLEAN
> 
> +PchSmmSetAndCheckEos (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32  SmiEn;
> 
> +
> 
> +  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
> 
> +
> 
> +  //
> 
> +  // Reset the PCH to generate subsequent SMIs
> 
> +  //
> 
> +  SmiEn |= B_ACPI_IO_SMI_EN_EOS;
> 
> +
> 
> +  IoWrite32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN), SmiEn);
> 
> +
> 
> +  //
> 
> +  // Double check that the assert worked
> 
> +  //
> 
> +  SmiEn = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_SMI_EN));
> 
> +
> 
> +  //
> 
> +  // Return TRUE if EOS is set correctly
> 
> +  //
> 
> +  if ((SmiEn & B_ACPI_IO_SMI_EN_EOS) == 0) {
> 
> +    //
> 
> +    // EOS was not set to a 1; this is an error
> 
> +    //
> 
> +    return FALSE;
> 
> +  } else {
> 
> +    //
> 
> +    // EOS was correctly set to a 1
> 
> +    //
> 
> +    return TRUE;
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Determine whether an ACPI OS is present (via the SCI_EN bit)
> 
> +
> 
> +
> 
> +  @retval TRUE                    ACPI OS is present
> 
> +  @retval FALSE                   ACPI OS is not present
> 
> +**/
> 
> +BOOLEAN
> 
> +PchSmmGetSciEn (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  BOOLEAN SciEn;
> 
> +  UINT32  Pm1Cnt;
> 
> +
> 
> +  //
> 
> +  // Determine whether an ACPI OS is present (via the SCI_EN bit)
> 
> +  //
> 
> +  Pm1Cnt  = IoRead32 ((UINTN) (mAcpiBaseAddr + R_ACPI_IO_PM1_CNT));
> 
> +  SciEn   = (BOOLEAN) ((Pm1Cnt & B_ACPI_IO_PM1_CNT_SCI_EN) ==
> B_ACPI_IO_PM1_CNT_SCI_EN);
> 
> +
> 
> +  return SciEn;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Read a specifying bit with the register
> 
> +  These may or may not need to change w/ the PCH version; they're highly
> IA-32 dependent, though.
> 
> +
> 
> +  @param[in] BitDesc              The struct that includes register address, size in
> byte and bit number
> 
> +
> 
> +  @retval TRUE                    The bit is enabled
> 
> +  @retval FALSE                   The bit is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +ReadBitDesc (
> 
> +  CONST PCH_SMM_BIT_DESC  *BitDesc
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT64      Register;
> 
> +  UINT32      PciBus;
> 
> +  UINT32      PciDev;
> 
> +  UINT32      PciFun;
> 
> +  UINT32      PciReg;
> 
> +  UINTN       RegSize;
> 
> +  BOOLEAN     BitWasOne;
> 
> +  UINTN       ShiftCount;
> 
> +  UINTN       RegisterOffset;
> 
> +  UINT32      BaseAddr;
> 
> +  UINT64      PciBaseAddress;
> 
> +
> 
> +  ASSERT (BitDesc != NULL);
> 
> +  ASSERT (!IS_BIT_DESC_NULL (*BitDesc));
> 
> +
> 
> +  RegSize     = 0;
> 
> +  Register    = 0;
> 
> +  ShiftCount  = 0;
> 
> +  BitWasOne   = FALSE;
> 
> +
> 
> +  switch (BitDesc->Reg.Type) {
> 
> +
> 
> +    case ACPI_ADDR_TYPE:
> 
> +    case TCO_ADDR_TYPE:
> 
> +      if (BitDesc->Reg.Type == ACPI_ADDR_TYPE) {
> 
> +        RegisterOffset  = BitDesc->Reg.Data.acpi;
> 
> +        BaseAddr        = mAcpiBaseAddr;
> 
> +      } else {
> 
> +        RegisterOffset  = BitDesc->Reg.Data.tco;
> 
> +        BaseAddr        = mTcoBaseAddr;
> 
> +      }
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +
> 
> +        case 0:
> 
> +          //
> 
> +          // Chances are that this field didn't get initialized.
> 
> +          // Check your assignments to bit descriptions.
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +
> 
> +        case 1:
> 
> +          RegSize = SMM_IO_UINT8;
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          RegSize = SMM_IO_UINT16;
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          RegSize = SMM_IO_UINT32;
> 
> +          break;
> 
> +
> 
> +        case 8:
> 
> +          RegSize = SMM_IO_UINT64;
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      //
> 
> +      // Double check that we correctly read in the acpi base address
> 
> +      //
> 
> +      ASSERT ((BaseAddr != 0x0) && ((BaseAddr & 0x1) != 0x1));
> 
> +
> 
> +      ShiftCount      = BitDesc->Bit;
> 
> +      //
> 
> +      // As current CPU Smm Io can only support at most
> 
> +      // 32-bit read/write,if Operation is 64 bit,
> 
> +      // we do a 32 bit operation according to BitDesc->Bit
> 
> +      //
> 
> +      if (RegSize == SMM_IO_UINT64) {
> 
> +        RegSize = SMM_IO_UINT32;
> 
> +        //
> 
> +        // If the operation is for high 32 bits
> 
> +        //
> 
> +        if (BitDesc->Bit >= 32) {
> 
> +          RegisterOffset += 4;
> 
> +          ShiftCount -= 32;
> 
> +        }
> 
> +      }
> 
> +
> 
> +      Status = gSmst->SmmIo.Io.Read (
> 
> +                                 &gSmst->SmmIo,
> 
> +                                 RegSize,
> 
> +                                 BaseAddr + RegisterOffset,
> 
> +                                 1,
> 
> +                                 &Register
> 
> +                                 );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      if ((Register & (LShiftU64 (BIT_ZERO, ShiftCount))) != 0) {
> 
> +        BitWasOne = TRUE;
> 
> +      } else {
> 
> +        BitWasOne = FALSE;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case GPIO_ADDR_TYPE:
> 
> +    case MEMORY_MAPPED_IO_ADDRESS_TYPE:
> 
> +      //
> 
> +      // Read the register, and it with the bit to read
> 
> +      //
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +        case 1:
> 
> +          Register = (UINT64) MmioRead8 ((UINTN) BitDesc->Reg.Data.Mmio);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          Register = (UINT64) MmioRead16 ((UINTN) BitDesc->Reg.Data.Mmio);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          Register = (UINT64) MmioRead32 ((UINTN) BitDesc->Reg.Data.Mmio);
> 
> +          break;
> 
> +
> 
> +        case 8:
> 
> +          Register                      = (UINT64) MmioRead32 ((UINTN) BitDesc-
> >Reg.Data.Mmio);
> 
> +          *((UINT32 *) (&Register) + 1) = MmioRead32 ((UINTN) BitDesc-
> >Reg.Data.Mmio + 4);
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +
> 
> +      Register = Register & (LShiftU64 (BIT0, BitDesc->Bit));
> 
> +      if (Register) {
> 
> +        BitWasOne = TRUE;
> 
> +      } else {
> 
> +        BitWasOne = FALSE;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case PCIE_ADDR_TYPE:
> 
> +      PciBus  = BitDesc->Reg.Data.pcie.Fields.Bus;
> 
> +      PciDev  = BitDesc->Reg.Data.pcie.Fields.Dev;
> 
> +      PciFun  = BitDesc->Reg.Data.pcie.Fields.Fnc;
> 
> +      PciReg  = BitDesc->Reg.Data.pcie.Fields.Reg;
> 
> +      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +
> 
> +        case 0:
> 
> +          //
> 
> +          // Chances are that this field didn't get initialized.
> 
> +          // Check your assignments to bit descriptions.
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +
> 
> +        case 1:
> 
> +          Register = (UINT64) PciSegmentRead8 (PciBaseAddress + PciReg);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          Register = (UINT64) PciSegmentRead16 (PciBaseAddress + PciReg);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          Register = (UINT64) PciSegmentRead32 (PciBaseAddress + PciReg);
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +
> 
> +      if ((Register & (LShiftU64 (BIT_ZERO, BitDesc->Bit))) != 0) {
> 
> +        BitWasOne = TRUE;
> 
> +      } else {
> 
> +        BitWasOne = FALSE;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case PCR_ADDR_TYPE:
> 
> +      //
> 
> +      // Read the register, and it with the bit to read
> 
> +      //
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +        case 1:
> 
> +          Register = PchPcrRead8  (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc-
> >Reg.Data.Pcr.Fields.Offset);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          Register = PchPcrRead16 (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc-
> >Reg.Data.Pcr.Fields.Offset);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          Register = PchPcrRead32 (BitDesc->Reg.Data.Pcr.Fields.Pid, BitDesc-
> >Reg.Data.Pcr.Fields.Offset);
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +
> 
> +      Register = Register & (LShiftU64 (BIT0, BitDesc->Bit));
> 
> +      if (Register) {
> 
> +        BitWasOne = TRUE;
> 
> +      } else {
> 
> +        BitWasOne = FALSE;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      //
> 
> +      // This address type is not yet implemented
> 
> +      //
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +
> 
> +  return BitWasOne;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Write a specifying bit with the register
> 
> +
> 
> +  @param[in] BitDesc              The struct that includes register address, size in
> byte and bit number
> 
> +  @param[in] ValueToWrite         The value to be wrote
> 
> +  @param[in] WriteClear           If the rest bits of the register is write clear
> 
> +
> 
> +**/
> 
> +VOID
> 
> +WriteBitDesc (
> 
> +  CONST PCH_SMM_BIT_DESC  *BitDesc,
> 
> +  CONST BOOLEAN           ValueToWrite,
> 
> +  CONST BOOLEAN           WriteClear
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT64      Register;
> 
> +  UINT64      AndVal;
> 
> +  UINT64      OrVal;
> 
> +  UINT32      RegSize;
> 
> +  UINT32      PciBus;
> 
> +  UINT32      PciDev;
> 
> +  UINT32      PciFun;
> 
> +  UINT32      PciReg;
> 
> +  UINTN       RegisterOffset;
> 
> +  UINT32      BaseAddr;
> 
> +  UINT64      PciBaseAddress;
> 
> +
> 
> +  ASSERT (BitDesc != NULL);
> 
> +  ASSERT (!IS_BIT_DESC_NULL (*BitDesc));
> 
> +
> 
> +  RegSize   = 0;
> 
> +  Register  = 0;
> 
> +
> 
> +  if (WriteClear) {
> 
> +    AndVal = LShiftU64 (BIT_ZERO, BitDesc->Bit);
> 
> +  } else {
> 
> +    AndVal = ~(LShiftU64 (BIT_ZERO, BitDesc->Bit));
> 
> +  }
> 
> +
> 
> +  OrVal = (LShiftU64 ((UINT32) ValueToWrite, BitDesc->Bit));
> 
> +
> 
> +  switch (BitDesc->Reg.Type) {
> 
> +
> 
> +    case ACPI_ADDR_TYPE:
> 
> +    case TCO_ADDR_TYPE:
> 
> +      if (BitDesc->Reg.Type == ACPI_ADDR_TYPE) {
> 
> +        RegisterOffset  = BitDesc->Reg.Data.acpi;
> 
> +        BaseAddr        = mAcpiBaseAddr;
> 
> +      } else {
> 
> +        RegisterOffset  = BitDesc->Reg.Data.tco;
> 
> +        BaseAddr        = mTcoBaseAddr;
> 
> +      }
> 
> +
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +
> 
> +        case 0:
> 
> +          //
> 
> +          // Chances are that this field didn't get initialized.
> 
> +          // Check your assignments to bit descriptions.
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +
> 
> +        case 1:
> 
> +          RegSize = SMM_IO_UINT8;
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          RegSize = SMM_IO_UINT16;
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          RegSize = SMM_IO_UINT32;
> 
> +          break;
> 
> +
> 
> +        case 8:
> 
> +          RegSize = SMM_IO_UINT64;
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      //
> 
> +      // Double check that we correctly read in the acpi base address
> 
> +      //
> 
> +      ASSERT ((BaseAddr != 0x0) && ((BaseAddr & 0x1) != 0x1));
> 
> +
> 
> +      //
> 
> +      // As current CPU Smm Io can only support at most
> 
> +      // 32-bit read/write,if Operation is 64 bit,
> 
> +      // we do a 32 bit operation according to BitDesc->Bit
> 
> +      //
> 
> +      if (RegSize == SMM_IO_UINT64) {
> 
> +        RegSize = SMM_IO_UINT32;
> 
> +        //
> 
> +        // If the operation is for high 32 bits
> 
> +        //
> 
> +        if (BitDesc->Bit >= 32) {
> 
> +          RegisterOffset += 4;
> 
> +
> 
> +          if (WriteClear) {
> 
> +            AndVal = LShiftU64 (BIT_ZERO, BitDesc->Bit - 32);
> 
> +          } else {
> 
> +            AndVal = ~(LShiftU64 (BIT_ZERO, BitDesc->Bit - 32));
> 
> +          }
> 
> +
> 
> +          OrVal = LShiftU64 ((UINT32) ValueToWrite, BitDesc->Bit - 32);
> 
> +        }
> 
> +      }
> 
> +
> 
> +      Status = gSmst->SmmIo.Io.Read (
> 
> +                                 &gSmst->SmmIo,
> 
> +                                 RegSize,
> 
> +                                 BaseAddr + RegisterOffset,
> 
> +                                 1,
> 
> +                                 &Register
> 
> +                                 );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      Register &= AndVal;
> 
> +      Register |= OrVal;
> 
> +
> 
> +      Status = gSmst->SmmIo.Io.Write (
> 
> +                                 &gSmst->SmmIo,
> 
> +                                 RegSize,
> 
> +                                 BaseAddr + RegisterOffset,
> 
> +                                 1,
> 
> +                                 &Register
> 
> +                                 );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +      break;
> 
> +
> 
> +    case GPIO_ADDR_TYPE:
> 
> +    case MEMORY_MAPPED_IO_ADDRESS_TYPE:
> 
> +      //
> 
> +      // Read the register, or it with the bit to set, then write it back.
> 
> +      //
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +        case 1:
> 
> +          MmioAndThenOr8  ((UINTN) BitDesc->Reg.Data.Mmio, (UINT8)
> AndVal, (UINT8)  OrVal);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          MmioAndThenOr16 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT16)
> AndVal, (UINT16) OrVal);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          MmioAndThenOr32 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT32)
> AndVal, (UINT32) OrVal);
> 
> +          break;
> 
> +
> 
> +        case 8:
> 
> +          Register                      = (UINT64) MmioRead32 ((UINTN) BitDesc-
> >Reg.Data.Mmio);
> 
> +          *((UINT32 *) (&Register) + 1) = MmioRead32 ((UINTN) BitDesc-
> >Reg.Data.Mmio + 4);
> 
> +          Register &= AndVal;
> 
> +          Register |= OrVal;
> 
> +          MmioWrite32 ((UINTN) BitDesc->Reg.Data.Mmio, (UINT32) Register);
> 
> +          MmioWrite32 ((UINTN) BitDesc->Reg.Data.Mmio + 4, *((UINT32 *)
> (&Register) + 1));
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case PCIE_ADDR_TYPE:
> 
> +      PciBus  = BitDesc->Reg.Data.pcie.Fields.Bus;
> 
> +      PciDev  = BitDesc->Reg.Data.pcie.Fields.Dev;
> 
> +      PciFun  = BitDesc->Reg.Data.pcie.Fields.Fnc;
> 
> +      PciReg  = BitDesc->Reg.Data.pcie.Fields.Reg;
> 
> +      PciBaseAddress = PCI_SEGMENT_LIB_ADDRESS
> (DEFAULT_PCI_SEGMENT_NUMBER_PCH, PciBus, PciDev, PciFun, 0);
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +
> 
> +        case 0:
> 
> +          //
> 
> +          // Chances are that this field didn't get initialized -- check your
> assignments
> 
> +          // to bit descriptions.
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +
> 
> +        case 1:
> 
> +          PciSegmentAndThenOr8 (PciBaseAddress + PciReg, (UINT8) AndVal,
> (UINT8) OrVal);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          PciSegmentAndThenOr16 (PciBaseAddress + PciReg, (UINT16) AndVal,
> (UINT16) OrVal);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          PciSegmentAndThenOr32 (PciBaseAddress + PciReg, (UINT32) AndVal,
> (UINT32) OrVal);
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    case PCR_ADDR_TYPE:
> 
> +      //
> 
> +      // Read the register, or it with the bit to set, then write it back.
> 
> +      //
> 
> +      switch (BitDesc->SizeInBytes) {
> 
> +        case 1:
> 
> +          PchPcrAndThenOr8  ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid,
> (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT8)  AndVal, (UINT8)
> OrVal);
> 
> +          break;
> 
> +
> 
> +        case 2:
> 
> +          PchPcrAndThenOr16 ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid,
> (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT16) AndVal, (UINT16)
> OrVal);
> 
> +          break;
> 
> +
> 
> +        case 4:
> 
> +          PchPcrAndThenOr32 ((PCH_SBI_PID) BitDesc->Reg.Data.Pcr.Fields.Pid,
> (UINT16) BitDesc->Reg.Data.Pcr.Fields.Offset, (UINT32) AndVal, (UINT32)
> OrVal);
> 
> +          break;
> 
> +
> 
> +        default:
> 
> +          //
> 
> +          // Unsupported or invalid register size
> 
> +          //
> 
> +          ASSERT (FALSE);
> 
> +          break;
> 
> +      }
> 
> +      break;
> 
> +
> 
> +    default:
> 
> +      //
> 
> +      // This address type is not yet implemented
> 
> +      //
> 
> +      ASSERT (FALSE);
> 
> +      break;
> 
> +  }
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.h
> new file mode 100644
> index 0000000000..6dd6f2027d
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/PchSmiDispatcher/Smm/PchxSmmHe
> lpers.h
> @@ -0,0 +1,107 @@
> +/** @file
> 
> +  This driver is responsible for the registration of child drivers
> 
> +  and the abstraction of the PCH SMI sources.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _PCHX_SMM_HELPERS_H_
> 
> +#define _PCHX_SMM_HELPERS_H_
> 
> +
> 
> +#include "PchSmm.h"
> 
> +
> 
> +/**
> 
> +  Initialize bits that aren't necessarily related to an SMI source.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             SMI source initialization completed.
> 
> +  @retval Asserts                 Global Smi Bit is not enabled successfully.
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmInitHardware (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Enables the PCH to generate SMIs. Note that no SMIs will be generated
> 
> +  if no SMI sources are enabled. Conversely, no enabled SMI source will
> 
> +  generate SMIs if SMIs are not globally enabled. This is the main
> 
> +  switchbox for SMI generation.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             Enable Global Smi Bit completed
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmEnableGlobalSmiBit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clears the SMI after all SMI source have been processed.
> 
> +  Note that this function will not work correctly (as it is
> 
> +  written) unless all SMI sources have been processed.
> 
> +  A revision of this function could manually clear all SMI
> 
> +  status bits to guarantee success.
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             Clears the SMIs completed
> 
> +  @retval Asserts                 EOS was not set to a 1
> 
> +**/
> 
> +EFI_STATUS
> 
> +PchSmmClearSmi (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Set the SMI EOS bit after all SMI source have been processed.
> 
> +
> 
> +
> 
> +  @retval FALSE                   EOS was not set to a 1; this is an error
> 
> +  @retval TRUE                    EOS was correctly set to a 1
> 
> +**/
> 
> +BOOLEAN
> 
> +PchSmmSetAndCheckEos (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Determine whether an ACPI OS is present (via the SCI_EN bit)
> 
> +
> 
> +
> 
> +  @retval TRUE                    ACPI OS is present
> 
> +  @retval FALSE                   ACPI OS is not present
> 
> +**/
> 
> +BOOLEAN
> 
> +PchSmmGetSciEn (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Read a specifying bit with the register
> 
> +
> 
> +  @param[in] BitDesc              The struct that includes register address, size in
> byte and bit number
> 
> +
> 
> +  @retval TRUE                    The bit is enabled
> 
> +  @retval FALSE                   The bit is disabled
> 
> +**/
> 
> +BOOLEAN
> 
> +ReadBitDesc (
> 
> +  CONST PCH_SMM_BIT_DESC *BitDesc
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Write a specifying bit with the register
> 
> +
> 
> +  @param[in] BitDesc              The struct that includes register address, size in
> byte and bit number
> 
> +  @param[in] ValueToWrite         The value to be wrote
> 
> +  @param[in] WriteClear           If the rest bits of the register is write clear
> 
> +
> 
> +**/
> 
> +VOID
> 
> +WriteBitDesc (
> 
> +  CONST PCH_SMM_BIT_DESC  *BitDesc,
> 
> +  CONST BOOLEAN           ValueToWrite,
> 
> +  CONST BOOLEAN           WriteClear
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> ol.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> ol.inf
> new file mode 100644
> index 0000000000..a142cfa95a
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> ol.inf
> @@ -0,0 +1,54 @@
> +## @file
> 
> +# Component description file for SmmControl module
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = SmmControl
> 
> +FILE_GUID = A0BAD9F7-AB78-491b-B583-C52B7F84B9E0
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_RUNTIME_DRIVER
> 
> +ENTRY_POINT = SmmControlDriverEntryInit
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +IoLib
> 
> +UefiDriverEntryPoint
> 
> +DebugLib
> 
> +UefiBootServicesTableLib
> 
> +UefiRuntimeServicesTableLib
> 
> +PmcLib
> 
> +GpioLib
> 
> +
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SmmControlDriver.h
> 
> +SmmControlDriver.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gEfiSmmControl2ProtocolGuid ## PRODUCES
> 
> +
> 
> +
> 
> +[Guids]
> 
> +gEfiEventVirtualAddressChangeGuid
> 
> +
> 
> +
> 
> +[Depex]
> 
> +TRUE
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.c
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.c
> new file mode 100644
> index 0000000000..5822f42165
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.c
> @@ -0,0 +1,394 @@
> +/** @file
> 
> +  This is the driver that publishes the SMM Control Protocol.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/UefiDriverEntryPoint.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/UefiRuntimeServicesTableLib.h>
> 
> +#include <Guid/EventGroup.h>
> 
> +#include <Library/PmcLib.h>
> 
> +#include <Library/GpioLib.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/PchRegsLpc.h>
> 
> +#include <Register/SpiRegs.h>
> 
> +#include <Register/PmcRegs.h>
> 
> +#include "SmmControlDriver.h"
> 
> +
> 
> +STATIC SMM_CONTROL_PRIVATE_DATA mSmmControl;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16                          mABase;
> 
> +
> 
> +VOID
> 
> +EFIAPI
> 
> +DisablePendingSmis (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Fixup internal data pointers so that the services can be called in virtual
> mode.
> 
> +
> 
> +  @param[in] Event                The event registered.
> 
> +  @param[in] Context              Event context.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SmmControlVirtualAddressChangeEvent (
> 
> +  IN EFI_EVENT                  Event,
> 
> +  IN VOID                       *Context
> 
> +  )
> 
> +{
> 
> +  gRT->ConvertPointer (0, (VOID *) &(mSmmControl.SmmControl.Trigger));
> 
> +  gRT->ConvertPointer (0, (VOID *) &(mSmmControl.SmmControl.Clear));
> 
> +}
> 
> +
> 
> +/**
> 
> +  <b>SmmControl DXE RUNTIME Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +    The SmmControl module is a DXE RUNTIME driver that provides a
> standard way
> 
> +    for other drivers to trigger software SMIs.
> 
> +
> 
> +  - @pre
> 
> +    - PCH Power Management I/O space base address has already been
> programmed.
> 
> +      If SmmControl Runtime DXE driver is run before Status Code Runtime
> Protocol
> 
> +      is installed and there is the need to use Status code in the driver, it will
> 
> +      be necessary to add EFI_STATUS_CODE_RUNTIME_PROTOCOL_GUID to
> the dependency file.
> 
> +    - EFI_SMM_BASE2_PROTOCOL
> 
> +      - Documented in the System Management Mode Core Interface
> Specification.
> 
> +
> 
> +  - @result
> 
> +    The SmmControl driver produces the EFI_SMM_CONTROL_PROTOCOL
> documented in
> 
> +    System Management Mode Core Interface Specification.
> 
> +
> 
> +  @param[in] ImageHandle          Handle for the image of this driver
> 
> +  @param[in] SystemTable          Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_STATUS              Results of the installation of the SMM Control
> Protocol
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmControlDriverEntryInit (
> 
> +  IN EFI_HANDLE         ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE   *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  EFI_EVENT   Event;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SmmControlDriverEntryInit() Start\n"));
> 
> +
> 
> +  //
> 
> +  // Get the Power Management I/O space base address. We assume that
> 
> +  // this base address has already been programmed if this driver is
> 
> +  // being run.
> 
> +  //
> 
> +  mABase = PmcGetAcpiBase ();
> 
> +
> 
> +  Status = EFI_SUCCESS;
> 
> +  if (mABase != 0) {
> 
> +    //
> 
> +    // Install the instance of the protocol
> 
> +    //
> 
> +    mSmmControl.Signature                       =
> SMM_CONTROL_PRIVATE_DATA_SIGNATURE;
> 
> +    mSmmControl.Handle                          = ImageHandle;
> 
> +
> 
> +    mSmmControl.SmmControl.Trigger              = Activate;
> 
> +    mSmmControl.SmmControl.Clear                = Deactivate;
> 
> +    mSmmControl.SmmControl.MinimumTriggerPeriod = 0;
> 
> +
> 
> +    //
> 
> +    // Install our protocol interfaces on the device's handle
> 
> +    //
> 
> +    Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                    &mSmmControl.Handle,
> 
> +                    &gEfiSmmControl2ProtocolGuid,
> 
> +                    &mSmmControl.SmmControl,
> 
> +                    NULL
> 
> +                    );
> 
> +  } else {
> 
> +    Status = EFI_DEVICE_ERROR;
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  Status = gBS->CreateEventEx (
> 
> +                  EVT_NOTIFY_SIGNAL,
> 
> +                  TPL_NOTIFY,
> 
> +                  SmmControlVirtualAddressChangeEvent,
> 
> +                  NULL,
> 
> +                  &gEfiEventVirtualAddressChangeGuid,
> 
> +                  &Event
> 
> +                  );
> 
> +  //
> 
> +  // Disable any PCH SMIs that, for whatever reason, are asserted after the
> boot.
> 
> +  //
> 
> +  DisablePendingSmis ();
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SmmControlDriverEntryInit() End\n"));
> 
> +
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Trigger the software SMI
> 
> +
> 
> +  @param[in] Data                 The value to be set on the software SMI data
> port
> 
> +
> 
> +  @retval EFI_SUCCESS             Function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmTrigger (
> 
> +  IN UINT8   Data
> 
> +  )
> 
> +{
> 
> +  UINT32  OutputData;
> 
> +  UINT32  OutputPort;
> 
> +
> 
> +  //
> 
> +  // Enable the APMC SMI
> 
> +  //
> 
> +  OutputPort  = mABase + R_ACPI_IO_SMI_EN;
> 
> +  OutputData  = IoRead32 ((UINTN) OutputPort);
> 
> +  OutputData |= (B_ACPI_IO_SMI_EN_APMC |
> B_ACPI_IO_SMI_EN_GBL_SMI);
> 
> +  DEBUG (
> 
> +    (DEBUG_VERBOSE,
> 
> +     "The SMI Control Port at address %x will be written to %x.\n",
> 
> +     OutputPort,
> 
> +     OutputData)
> 
> +    );
> 
> +  IoWrite32 (
> 
> +    (UINTN) OutputPort,
> 
> +    (UINT32) (OutputData)
> 
> +    );
> 
> +
> 
> +  OutputPort  = R_PCH_IO_APM_CNT;
> 
> +  OutputData  = Data;
> 
> +
> 
> +  //
> 
> +  // Generate the APMC SMI
> 
> +  //
> 
> +  IoWrite8 (
> 
> +    (UINTN) OutputPort,
> 
> +    (UINT8) (OutputData)
> 
> +    );
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Clear the SMI status
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +  @retval EFI_DEVICE_ERROR        Something error occurred
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmClear (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT32      OutputData;
> 
> +  UINT32      OutputPort;
> 
> +
> 
> +  Status = EFI_SUCCESS;
> 
> +
> 
> +  //
> 
> +  // Clear the Power Button Override Status Bit, it gates EOS from being set.
> 
> +  //
> 
> +  OutputPort  = mABase + R_ACPI_IO_PM1_STS;
> 
> +  OutputData  = B_ACPI_IO_PM1_STS_PRBTNOR;
> 
> +  DEBUG (
> 
> +    (DEBUG_VERBOSE,
> 
> +     "The PM1 Status Port at address %x will be written to %x.\n",
> 
> +     OutputPort,
> 
> +     OutputData)
> 
> +    );
> 
> +  IoWrite16 (
> 
> +    (UINTN) OutputPort,
> 
> +    (UINT16) (OutputData)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Clear the APM SMI Status Bit
> 
> +  //
> 
> +  OutputPort  = mABase + R_ACPI_IO_SMI_STS;
> 
> +  OutputData  = B_ACPI_IO_SMI_STS_APM;
> 
> +  DEBUG (
> 
> +    (DEBUG_VERBOSE,
> 
> +     "The SMI Status Port at address %x will be written to %x.\n",
> 
> +     OutputPort,
> 
> +     OutputData)
> 
> +    );
> 
> +  IoWrite32 (
> 
> +    (UINTN) OutputPort,
> 
> +    (UINT32) (OutputData)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Set the EOS Bit
> 
> +  //
> 
> +  OutputPort  = mABase + R_ACPI_IO_SMI_EN;
> 
> +  OutputData  = IoRead32 ((UINTN) OutputPort);
> 
> +  OutputData |= B_ACPI_IO_SMI_EN_EOS;
> 
> +  DEBUG (
> 
> +    (DEBUG_VERBOSE,
> 
> +     "The SMI Control Port at address %x will be written to %x.\n",
> 
> +     OutputPort,
> 
> +     OutputData)
> 
> +    );
> 
> +  IoWrite32 (
> 
> +    (UINTN) OutputPort,
> 
> +    (UINT32) (OutputData)
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // There is no need to read EOS back and check if it is set.
> 
> +  // This can lead to a reading of zero if an SMI occurs right after the SMI_EN
> port read
> 
> +  // but before the data is returned to the CPU.
> 
> +  // SMM Dispatcher should make sure that EOS is set after all SMI sources
> are processed.
> 
> +  //
> 
> +  return Status;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This routine generates an SMI
> 
> +
> 
> +  @param[in] This                       The EFI SMM Control protocol instance
> 
> +  @param[in, out] CommandPort           The buffer contains data to the
> command port
> 
> +  @param[in, out] DataPort              The buffer contains data to the data port
> 
> +  @param[in] Periodic                   Periodic or not
> 
> +  @param[in] ActivationInterval         Interval of periodic SMI
> 
> +
> 
> +  @retval EFI Status                    Describing the result of the operation
> 
> +  @retval EFI_INVALID_PARAMETER         Some parameter value passed is
> not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +Activate (
> 
> +  IN CONST EFI_SMM_CONTROL2_PROTOCOL                    * This,
> 
> +  IN OUT  UINT8                                         *CommandPort       OPTIONAL,
> 
> +  IN OUT  UINT8                                         *DataPort          OPTIONAL,
> 
> +  IN      BOOLEAN                                       Periodic           OPTIONAL,
> 
> +  IN      UINTN                                         ActivationInterval OPTIONAL
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS  Status;
> 
> +  UINT8       Data;
> 
> +
> 
> +  if (Periodic) {
> 
> +    DEBUG ((DEBUG_WARN, "Invalid parameter\n"));
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  if (CommandPort == NULL) {
> 
> +    Data = 0xFF;
> 
> +  } else {
> 
> +    Data = *CommandPort;
> 
> +  }
> 
> +  //
> 
> +  // Clear any pending the APM SMI
> 
> +  //
> 
> +  Status = SmmClear ();
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  return SmmTrigger (Data);
> 
> +}
> 
> +
> 
> +/**
> 
> +  This routine clears an SMI
> 
> +
> 
> +  @param[in] This                 The EFI SMM Control protocol instance
> 
> +  @param[in] Periodic             Periodic or not
> 
> +
> 
> +  @retval EFI Status              Describing the result of the operation
> 
> +  @retval EFI_INVALID_PARAMETER   Some parameter value passed is not
> supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +Deactivate (
> 
> +  IN CONST EFI_SMM_CONTROL2_PROTOCOL       *This,
> 
> +  IN  BOOLEAN                              Periodic OPTIONAL
> 
> +  )
> 
> +{
> 
> +  if (Periodic) {
> 
> +    return EFI_INVALID_PARAMETER;
> 
> +  }
> 
> +
> 
> +  return SmmClear ();
> 
> +}
> 
> +/**
> 
> +  Disable all pending SMIs
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +DisablePendingSmis (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32               Data;
> 
> +  BOOLEAN              SciEn;
> 
> +
> 
> +  //
> 
> +  // Determine whether an ACPI OS is present (via the SCI_EN bit)
> 
> +  //
> 
> +  Data      = IoRead16 ((UINTN) mABase + R_ACPI_IO_PM1_CNT);
> 
> +  SciEn     = (BOOLEAN) ((Data & B_ACPI_IO_PM1_CNT_SCI_EN) ==
> B_ACPI_IO_PM1_CNT_SCI_EN);
> 
> +
> 
> +  if (!SciEn) {
> 
> +    //
> 
> +    // Clear any SMIs that double as SCIs (when SCI_EN==0)
> 
> +    //
> 
> +    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_STS, 0xFFFF);
> 
> +    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_EN, 0);
> 
> +    IoWrite16 ((UINTN) mABase + R_ACPI_IO_PM1_CNT, 0);
> 
> +    IoWrite32 (
> 
> +      (UINTN) mABase + R_ACPI_IO_GPE0_STS_127_96,
> 
> +      (UINT32)( B_ACPI_IO_GPE0_STS_127_96_WADT |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_USB_CON_DSX_STS |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_LAN_WAKE |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_PME_B0 |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_PME |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_BATLOW |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_RI |
> 
> +                B_ACPI_IO_GPE0_STS_127_96_SWGPE)
> 
> +      );
> 
> +    IoWrite32 ((UINTN) mABase + R_ACPI_IO_GPE0_EN_127_96, (UINT32)
> B_ACPI_IO_GPE0_EN_127_96_WADT);
> 
> +  }
> 
> +  //
> 
> +  // Clear and disable all SMIs that are unaffected by SCI_EN
> 
> +  //
> 
> +  GpioDisableAllGpiSmi ();
> 
> +
> 
> +  GpioClearAllGpiSmiSts ();
> 
> +
> 
> +  IoWrite32 ((UINTN) mABase + R_ACPI_IO_DEVACT_STS, 0x0000FFFF);
> 
> +
> 
> +  IoWrite32 ((UINTN) mABase + R_ACPI_IO_SMI_STS, ~0u);
> 
> +
> 
> +  //
> 
> +  // (Make sure to write this register last -- EOS re-enables SMIs for the PCH)
> 
> +  //
> 
> +  Data  = IoRead32 ((UINTN) mABase + R_ACPI_IO_SMI_EN);
> 
> +  //
> 
> +  // clear all bits except those tied to SCI_EN
> 
> +  //
> 
> +  Data &= B_ACPI_IO_SMI_EN_BIOS_RLS;
> 
> +  //
> 
> +  // enable SMIs and specifically enable writes to APM_CNT.
> 
> +  //
> 
> +  Data |= B_ACPI_IO_SMI_EN_GBL_SMI | B_ACPI_IO_SMI_EN_APMC;
> 
> +  //
> 
> +  //  NOTE: Default value of EOS is set in PCH, it will be automatically cleared
> Once the PCH asserts SMI# low,
> 
> +  //  we don't need to do anything to clear it
> 
> +  //
> 
> +  IoWrite32 ((UINTN) mABase + R_ACPI_IO_SMI_EN, Data);
> 
> +}
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.h
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.h
> new file mode 100644
> index 0000000000..af368e6945
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/Pch/SmmControl/RuntimeDxe/SmmContr
> olDriver.h
> @@ -0,0 +1,130 @@
> +/** @file
> 
> +  Header file for SMM Control Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SMM_CONTROL_DRIVER_H_
> 
> +#define _SMM_CONTROL_DRIVER_H_
> 
> +
> 
> +#include <Protocol/SmmControl2.h>
> 
> +
> 
> +
> 
> +#define SMM_CONTROL_PRIVATE_DATA_SIGNATURE  SIGNATURE_32 ('i',
> '4', 's', 'c')
> 
> +
> 
> +typedef struct {
> 
> +  UINTN                           Signature;
> 
> +  EFI_HANDLE                      Handle;
> 
> +  EFI_SMM_CONTROL2_PROTOCOL       SmmControl;
> 
> +} SMM_CONTROL_PRIVATE_DATA;
> 
> +
> 
> +#define SMM_CONTROL_PRIVATE_DATA_FROM_THIS(a) CR (a,
> SMM_CONTROL_PRIVATE_DATA, SmmControl,
> SMM_CONTROL_DEV_SIGNATURE)
> 
> +
> 
> +//
> 
> +// Prototypes
> 
> +//
> 
> +
> 
> +/**
> 
> +  <b>SmmControl DXE RUNTIME Module Entry Point</b>\n
> 
> +  - <b>Introduction</b>\n
> 
> +    The SmmControl module is a DXE RUNTIME driver that provides a
> standard way
> 
> +    for other drivers to trigger software SMIs.
> 
> +
> 
> +  - @pre
> 
> +    - PCH Power Management I/O space base address has already been
> programmed.
> 
> +      If SmmControl Runtime DXE driver is run before Status Code Runtime
> Protocol
> 
> +      is installed and there is the need to use Status code in the driver, it will
> 
> +      be necessary to add EFI_STATUS_CODE_RUNTIME_PROTOCOL_GUID to
> the dependency file.
> 
> +    - EFI_SMM_BASE2_PROTOCOL
> 
> +      - Documented in the System Management Mode Core Interface
> Specification.
> 
> +
> 
> +  - @result
> 
> +    The SmmControl driver produces the EFI_SMM_CONTROL_PROTOCOL
> documented in
> 
> +    System Management Mode Core Interface Specification.
> 
> +
> 
> +  @param[in] ImageHandle          Handle for the image of this driver
> 
> +  @param[in] SystemTable          Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_STATUS              Results of the installation of the SMM Control
> Protocol
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmControlDriverEntryInit (
> 
> +  IN EFI_HANDLE         ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE   *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Trigger the software SMI
> 
> +
> 
> +  @param[in] Data                 The value to be set on the software SMI data
> port
> 
> +
> 
> +  @retval EFI_SUCCESS             Function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmTrigger (
> 
> +  UINT8   Data
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Clear the SMI status
> 
> +
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +  @retval EFI_DEVICE_ERROR        Something error occurred
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SmmClear (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This routine generates an SMI
> 
> +
> 
> +  @param[in] This                       The EFI SMM Control protocol instance
> 
> +  @param[in, out] ArgumentBuffer        The buffer of argument
> 
> +  @param[in, out] ArgumentBufferSize    The size of the argument buffer
> 
> +  @param[in] Periodic                   Periodic or not
> 
> +  @param[in] ActivationInterval         Interval of periodic SMI
> 
> +
> 
> +  @retval EFI Status                    Describing the result of the operation
> 
> +  @retval EFI_INVALID_PARAMETER         Some parameter value passed is
> not supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +Activate (
> 
> +  IN CONST EFI_SMM_CONTROL2_PROTOCOL    *This,
> 
> +  IN OUT  UINT8                         *ArgumentBuffer OPTIONAL,
> 
> +  IN OUT  UINT8                         *ArgumentBufferSize OPTIONAL,
> 
> +  IN      BOOLEAN                       Periodic OPTIONAL,
> 
> +  IN      UINTN                         ActivationInterval OPTIONAL
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This routine clears an SMI
> 
> +
> 
> +  @param[in] This                 The EFI SMM Control protocol instance
> 
> +  @param[in] Periodic             Periodic or not
> 
> +
> 
> +  @retval EFI Status              Describing the result of the operation
> 
> +  @retval EFI_INVALID_PARAMETER   Some parameter value passed is not
> supported
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +Deactivate (
> 
> +  IN CONST EFI_SMM_CONTROL2_PROTOCOL    *This,
> 
> +  IN       BOOLEAN                      Periodic OPTIONAL
> 
> +  );
> 
> +/**
> 
> +  Disable all pending SMIs
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +DisablePendingSmis (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules
  2021-02-01  1:36 ` [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent
> modules
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following files:
>   * SystemAgent/SaInit/Dxe
>   * SystemAgent/SaInit/Smm
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c          |
> 431
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c          | 120
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h          |  58
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c       |
> 181
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h       |
> 136
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf     |
> 117
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
> | 454
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.c
> | 112
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.h
> | 122
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
> 
> Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm.in
> f |  72
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++
>  10 files changed, 1803 insertions(+)
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c
> new file mode 100644
> index 0000000000..d84a0c1fa4
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaAcpi.c
> @@ -0,0 +1,431 @@
> +/** @file
> 
> +  This is the driver that initializes the Intel System Agent.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "SaInitDxe.h"
> 
> +#include "SaInit.h"
> 
> +#include <SaConfigHob.h>
> 
> +#include <Protocol/SaNvsArea.h>
> 
> +#include <Library/PchInfoLib.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <Library/DxeCpuPcieRpLib.h>
> 
> +#include <SaConfigHob.h>
> 
> +#include <CpuPcieHob.h>
> 
> +#include <HostBridgeDataHob.h>
> 
> +#include <CpuDataStruct.h>
> 
> +
> 
> +///
> 
> +/// Global Variables
> 
> +///
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> SYSTEM_AGENT_NVS_AREA_PROTOCOL  mSaNvsAreaProtocol;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED SA_POLICY_PROTOCOL
> *mSaPolicy;
> 
> +extern SA_CONFIG_HOB                                          *mSaConfigHob;
> 
> +
> 
> +/**
> 
> +  A protocol callback which updates 64bits MMIO Base and Length in SA
> GNVS area
> 
> +**/
> 
> +VOID
> 
> +UpdateSaGnvsForMmioResourceBaseLength (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_PHYSICAL_ADDRESS      PciBaseAddress;
> 
> +  UINT32                    Tolud;
> 
> +  UINT64                    Length;
> 
> +  UINT64                    McD0BaseAddress;
> 
> +  UINTN                     ResMemLimit1;
> 
> +  UINT8                     EnableAbove4GBMmioBiosAssignemnt;
> 
> +  HOST_BRIDGE_DATA_HOB      *HostBridgeDataHob;
> 
> +
> 
> +  PciBaseAddress = 0;
> 
> +  Tolud = 0;
> 
> +  Length = 0;
> 
> +  ResMemLimit1 = 0;
> 
> +  EnableAbove4GBMmioBiosAssignemnt = 0;
> 
> +  HostBridgeDataHob = NULL;
> 
> +  //
> 
> +  // Read memory map registers
> 
> +  //
> 
> +  McD0BaseAddress        = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> SA_MC_BUS, 0, 0, 0);
> 
> +  Tolud                  = PciSegmentRead32 (McD0BaseAddress + R_SA_TOLUD) &
> B_SA_TOLUD_TOLUD_MASK;
> 
> +  PciBaseAddress         = Tolud;
> 
> +
> 
> +  ResMemLimit1 = (UINTN) PcdGet64 (PcdSiPciExpressBaseAddress);
> 
> +
> 
> +  Length = ResMemLimit1 - PciBaseAddress;
> 
> +
> 
> +  //
> 
> +  // Get HostBridgeData HOB and see if above 4GB MMIO BIOS assignment
> enabled
> 
> +  //
> 
> +  HostBridgeDataHob = (HOST_BRIDGE_DATA_HOB *) GetFirstGuidHob
> (&gHostBridgeDataHobGuid);
> 
> +  if ((HostBridgeDataHob != NULL) && (HostBridgeDataHob-
> >EnableAbove4GBMmio == 1)) {
> 
> +    EnableAbove4GBMmioBiosAssignemnt = 1;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Enable Above 4GB MMIO when Aperture Size is 2GB or higher
> 
> +  //
> 
> +  if ((mSaConfigHob != NULL) && (mSaConfigHob->ApertureSize >= 15)) {
> 
> +    EnableAbove4GBMmioBiosAssignemnt = 1;
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Check Enable Above 4GB MMIO or not
> 
> +  //
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Update SA GNVS Area.\n"));
> 
> +  mSaNvsAreaProtocol.Area->Mmio32Base   = (UINT32) PciBaseAddress;
> 
> +  mSaNvsAreaProtocol.Area->Mmio32Length = (UINT32) Length;
> 
> +  if (EnableAbove4GBMmioBiosAssignemnt == 1) {
> 
> +    mSaNvsAreaProtocol.Area->Mmio64Base   = BASE_256GB;
> 
> +    mSaNvsAreaProtocol.Area->Mmio64Length = SIZE_256GB;
> 
> +  }
> 
> +  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio64Base = %lx\n",
> mSaNvsAreaProtocol.Area->Mmio64Base));
> 
> +  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio64Length =
> %lx\n", mSaNvsAreaProtocol.Area->Mmio64Length));
> 
> +  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio32Base = %lx\n",
> mSaNvsAreaProtocol.Area->Mmio32Base));
> 
> +  DEBUG ((DEBUG_INFO, "SaNvsAreaProtocol.Area->Mmio32Length =
> %lx\n", mSaNvsAreaProtocol.Area->Mmio32Length));
> 
> +}
> 
> +
> 
> +/**
> 
> +  Install SSDT Table
> 
> +
> 
> +  @retval EFI_SUCCESS - SSDT Table load successful.
> 
> +**/
> 
> +EFI_STATUS
> 
> +InstallSsdtAcpiTable (
> 
> +  IN GUID   SsdtTableGuid,
> 
> +  IN UINT64 Signature
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                    Status;
> 
> +  EFI_HANDLE                    *HandleBuffer;
> 
> +  BOOLEAN                       LoadTable;
> 
> +  UINTN                         NumberOfHandles;
> 
> +  UINTN                         Index;
> 
> +  INTN                          Instance;
> 
> +  UINTN                         Size;
> 
> +  UINT32                        FvStatus;
> 
> +  UINTN                         TableHandle;
> 
> +  EFI_FV_FILETYPE               FileType;
> 
> +  EFI_FV_FILE_ATTRIBUTES        Attributes;
> 
> +  EFI_FIRMWARE_VOLUME2_PROTOCOL *FwVol;
> 
> +  EFI_ACPI_TABLE_PROTOCOL       *AcpiTable;
> 
> +  EFI_ACPI_DESCRIPTION_HEADER   *TableHeader;
> 
> +  EFI_ACPI_COMMON_HEADER        *Table;
> 
> +
> 
> +  FwVol         = NULL;
> 
> +  Table         = NULL;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "Loading SSDT Table GUID: %g\n",
> SsdtTableGuid));
> 
> +
> 
> +  ///
> 
> +  /// Locate FV protocol.
> 
> +  ///
> 
> +  Status = gBS->LocateHandleBuffer (
> 
> +                  ByProtocol,
> 
> +                  &gEfiFirmwareVolume2ProtocolGuid,
> 
> +                  NULL,
> 
> +                  &NumberOfHandles,
> 
> +                  &HandleBuffer
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Look for FV with ACPI storage file
> 
> +  ///
> 
> +  for (Index = 0; Index < NumberOfHandles; Index++) {
> 
> +    ///
> 
> +    /// Get the protocol on this handle
> 
> +    /// This should not fail because of LocateHandleBuffer
> 
> +    ///
> 
> +    Status = gBS->HandleProtocol (
> 
> +                    HandleBuffer[Index],
> 
> +                    &gEfiFirmwareVolume2ProtocolGuid,
> 
> +                    (VOID **) &FwVol
> 
> +                    );
> 
> +    ASSERT_EFI_ERROR (Status);
> 
> +    if (FwVol == NULL) {
> 
> +      return EFI_NOT_FOUND;
> 
> +    }
> 
> +    ///
> 
> +    /// See if it has the ACPI storage file
> 
> +    ///
> 
> +    Size      = 0;
> 
> +    FvStatus  = 0;
> 
> +    Status = FwVol->ReadFile (
> 
> +                      FwVol,
> 
> +                      &SsdtTableGuid,
> 
> +                      NULL,
> 
> +                      &Size,
> 
> +                      &FileType,
> 
> +                      &Attributes,
> 
> +                      &FvStatus
> 
> +                      );
> 
> +
> 
> +    ///
> 
> +    /// If we found it, then we are done
> 
> +    ///
> 
> +    if (!EFI_ERROR (Status)) {
> 
> +      break;
> 
> +    }
> 
> +  }
> 
> +  ///
> 
> +  /// Our exit status is determined by the success of the previous operations
> 
> +  /// If the protocol was found, Instance already points to it.
> 
> +  ///
> 
> +  ///
> 
> +  /// Free any allocated buffers
> 
> +  ///
> 
> +  FreePool (HandleBuffer);
> 
> +
> 
> +  ///
> 
> +  /// Sanity check that we found our data file
> 
> +  ///
> 
> +  ASSERT (FwVol);
> 
> +
> 
> +  ///
> 
> +  /// Locate ACPI tables
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID
> **) &AcpiTable);
> 
> +
> 
> +  ///
> 
> +  /// Read tables from the storage file.
> 
> +  ///
> 
> +  if (FwVol == NULL) {
> 
> +    ASSERT_EFI_ERROR (EFI_NOT_FOUND);
> 
> +    return EFI_NOT_FOUND;
> 
> +  }
> 
> +  Instance = 0;
> 
> +
> 
> +  while (Status == EFI_SUCCESS) {
> 
> +    ///
> 
> +    /// Read the ACPI tables
> 
> +    ///
> 
> +    Status = FwVol->ReadSection (
> 
> +                      FwVol,
> 
> +                      &SsdtTableGuid,
> 
> +                      EFI_SECTION_RAW,
> 
> +                      Instance,
> 
> +                      (VOID **) &Table,
> 
> +                      &Size,
> 
> +                      &FvStatus
> 
> +                      );
> 
> +    if (!EFI_ERROR (Status)) {
> 
> +      ///
> 
> +      /// check and load HybridGraphics SSDT table
> 
> +      ///
> 
> +      LoadTable   = FALSE;
> 
> +      TableHeader = (EFI_ACPI_DESCRIPTION_HEADER *) Table;
> 
> +
> 
> +      if (((EFI_ACPI_DESCRIPTION_HEADER *) TableHeader)->OemTableId ==
> Signature) {
> 
> +        ///
> 
> +        /// This is the SSDT table that match the Signature
> 
> +        ///
> 
> +        DEBUG ((DEBUG_INFO, "Found out SSDT Table GUID: %g\n",
> SsdtTableGuid));
> 
> +        LoadTable = TRUE;
> 
> +      }
> 
> +
> 
> +      ///
> 
> +      /// Add the table
> 
> +      ///
> 
> +      if (LoadTable) {
> 
> +        TableHandle = 0;
> 
> +        Status = AcpiTable->InstallAcpiTable (
> 
> +                              AcpiTable,
> 
> +                              TableHeader,
> 
> +                              TableHeader->Length,
> 
> +                              &TableHandle
> 
> +                              );
> 
> +      }
> 
> +      ///
> 
> +      /// Increment the instance
> 
> +      ///
> 
> +      Instance++;
> 
> +      Table = NULL;
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function gets registered as a callback to perform Dmar Igd
> 
> +
> 
> +  @param[in] Event     - A pointer to the Event that triggered the callback.
> 
> +  @param[in] Context   - A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SaAcpiEndOfDxeCallback (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS          Status;
> 
> +
> 
> +  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM,
> PCI_VENDOR_ID_OFFSET)) != 0xFFFF) {
> 
> +    Status = PostPmInitEndOfDxe ();
> 
> +    if (EFI_SUCCESS != Status) {
> 
> +      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe GraphicsInit Error, Status = %r
> \n", Status));
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IGD_BUS_NUM, IGD_DEV_NUM, IGD_FUN_NUM,
> PCI_VENDOR_ID_OFFSET)) != 0xFFFF) {
> 
> +    Status = GetVBiosVbtEndOfDxe ();
> 
> +    if (EFI_SUCCESS != Status) {
> 
> +      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe Op Region Error, Status = %r
> \n", Status));
> 
> +    }
> 
> +
> 
> +    Status = UpdateIgdOpRegionEndOfDxe ();
> 
> +    if (EFI_SUCCESS != Status) {
> 
> +      DEBUG ((DEBUG_WARN, "[SA] EndOfDxe Update Op Region Error,
> Status = %r \n", Status));
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  SystemAgent Acpi Initialization.
> 
> +
> 
> +  @param[in] ImageHandle             Handle for the image of this driver
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaAcpiInit (
> 
> +  IN EFI_HANDLE         ImageHandle
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                Status;
> 
> +  EFI_CPUID_REGISTER        CpuidRegs;
> 
> +  EFI_EVENT                 EndOfDxeEvent;
> 
> +
> 
> +  CPU_PCIE_HOB              *CpuPcieHob;
> 
> +
> 
> +  AsmCpuid (1, &CpuidRegs.RegEax, 0, 0, 0);
> 
> +  ///
> 
> +  /// Get the platform setup policy.
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol (&gSaPolicyProtocolGuid, NULL, (VOID **)
> &mSaPolicy);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Install System Agent Global NVS protocol
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "Install SA GNVS protocol\n"));
> 
> +  Status = (gBS->AllocatePool) (EfiACPIMemoryNVS, sizeof
> (SYSTEM_AGENT_NVS_AREA), (VOID **) &mSaNvsAreaProtocol.Area);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  ZeroMem ((VOID *) mSaNvsAreaProtocol.Area, sizeof
> (SYSTEM_AGENT_NVS_AREA));
> 
> +  mSaNvsAreaProtocol.Area->XPcieCfgBaseAddress  = (UINT32) (PcdGet64
> (PcdSiPciExpressBaseAddress));
> 
> +  mSaNvsAreaProtocol.Area->CpuIdInfo            = CpuidRegs.RegEax;
> 
> +
> 
> +  ///
> 
> +  /// Get CpuPcieHob HOB
> 
> +  ///
> 
> +  CpuPcieHob = NULL;
> 
> +  CpuPcieHob = (CPU_PCIE_HOB *) GetFirstGuidHob (&gCpuPcieHobGuid);
> 
> +  if (CpuPcieHob == NULL) {
> 
> +    DEBUG((DEBUG_ERROR, "CpuPcieHob not found\n"));
> 
> +    // @todo: Will add it back once it will get add into NVS library since
> currently it is failing for JSL
> 
> +    //ASSERT(CpuPcieHob != NULL);
> 
> +    //return EFI_NOT_FOUND;
> 
> +  } else {
> 
> +    mSaNvsAreaProtocol.Area->SlotSelection = CpuPcieHob->SlotSelection;
> 
> +    DEBUG((DEBUG_INFO, "RpEnabledMask == %x\n", CpuPcieHob-
> >RpEnabledMask));
> 
> +    if (CpuPcieHob->RpEnabledMask == 0) {
> 
> +      DEBUG ((DEBUG_ERROR, "All CPU PCIe root ports are disabled!!\n"));
> 
> +    } else {
> 
> +      if (CpuPcieHob->RpEnabledMask & BIT0) {
> 
> +        mSaNvsAreaProtocol.Area->CpuPcieRp0Enable = 1;
> 
> +      }
> 
> +      if (CpuPcieHob->RpEnabledMask & BIT1) {
> 
> +        mSaNvsAreaProtocol.Area->CpuPcieRp1Enable = 1;
> 
> +      }
> 
> +      if (CpuPcieHob->RpEnabledMask & BIT2) {
> 
> +        mSaNvsAreaProtocol.Area->CpuPcieRp2Enable = 1;
> 
> +      }
> 
> +      if (CpuPcieHob->RpEnabledMask & BIT3) {
> 
> +        mSaNvsAreaProtocol.Area->CpuPcieRp3Enable = 1;
> 
> +      }
> 
> +    }
> 
> +    mSaNvsAreaProtocol.Area->MaxPegPortNumber =
> GetMaxCpuPciePortNum ();
> 
> +  }
> 
> +
> 
> +  mSaNvsAreaProtocol.Area->SimicsEnvironment = 0;
> 
> +
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gSaNvsAreaProtocolGuid,
> 
> +                  &mSaNvsAreaProtocol,
> 
> +                  NULL
> 
> +                  );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// GtPostInit Initialization
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "Initializing GT ACPI tables\n"));
> 
> +  GraphicsInit (ImageHandle, mSaPolicy);
> 
> +
> 
> +  ///
> 
> +  /// Audio (dHDA) Initialization
> 
> +  ///
> 
> +  ///
> 
> +  /// Vtd Initialization
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "Initializing VT-d ACPI tables\n"));
> 
> +  VtdInit (mSaPolicy);
> 
> +
> 
> +  ///
> 
> +  /// IgdOpRegion Install Initialization
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "Initializing IGD OpRegion\n"));
> 
> +  IgdOpRegionInit ();
> 
> +
> 
> +  ///
> 
> +  /// Register an end of DXE event for SA ACPI to do tasks before invoking
> any UEFI drivers,
> 
> +  /// applications, or connecting consoles,...
> 
> +  ///
> 
> +  Status = gBS->CreateEventEx (
> 
> +                  EVT_NOTIFY_SIGNAL,
> 
> +                  TPL_CALLBACK,
> 
> +                  SaAcpiEndOfDxeCallback,
> 
> +                  NULL,
> 
> +                  &gEfiEndOfDxeEventGroupGuid,
> 
> +                  &EndOfDxeEvent
> 
> +                  );
> 
> +
> 
> +  ///
> 
> +  /// Install System Agent Global NVS ACPI table
> 
> +  ///
> 
> +  Status = InstallSsdtAcpiTable (gSaSsdtAcpiTableStorageGuid,
> SIGNATURE_64 ('S', 'a', 'S', 's', 'd', 't', ' ', 0));
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Update CPU PCIE RP NVS AREA
> 
> +  ///
> 
> +  UpdateCpuPcieNVS();
> 
> +  ///
> 
> +  /// Install Intel Graphics SSDT
> 
> +  ///
> 
> +  Status = InstallSsdtAcpiTable (gGraphicsAcpiTableStorageGuid,
> SIGNATURE_64 ('I','g','f','x','S','s','d','t'));
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  ///
> 
> +  /// Install IPU SSDT if IPU is present.
> 
> +  ///
> 
> +  if (PciSegmentRead16 (PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM,
> IPU_BUS_NUM, IPU_DEV_NUM, IPU_FUN_NUM, 0)) !=
> V_SA_DEVICE_ID_INVALID) {
> 
> +      Status = InstallSsdtAcpiTable (gIpuAcpiTableStorageGuid, SIGNATURE_64
> ('I','p','u','S','s','d','t',0));
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c
> new file mode 100644
> index 0000000000..5c0fea422b
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.c
> @@ -0,0 +1,120 @@
> +/** @file
> 
> +  This is the Common driver that initializes the Intel System Agent.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "SaInit.h"
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <HostBridgeDataHob.h>
> 
> +#include <SaConfigHob.h>
> 
> +#include <Protocol/PciEnumerationComplete.h>
> 
> +
> 
> +///
> 
> +/// Global Variables
> 
> +///
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED SA_CONFIG_HOB
> *mSaConfigHob;
> 
> +BOOLEAN                                                              mSkipPamLock = FALSE;
> 
> +
> 
> +/*
> 
> +  Intel(R) Core Processor Skylake BWG version 0.4.0
> 
> +
> 
> +  18.6 System Agent Configuration Locking
> 
> +   For reliable operation and security, System BIOS must set the following
> bits:
> 
> +   1. For all modern Intel processors, Intel strongly recommends that BIOS
> should set
> 
> +       the D_LCK bit. Set B0:D0:F0.R088h [4] = 1b to lock down SMRAM space.
> 
> +  BaseAddr values for mSaSecurityRegisters that uses
> PciExpressBaseAddress will be initialized at
> 
> +  Runtime inside function CpuPcieInitPolicy().
> 
> +*/
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOT_SCRIPT_REGISTER_SETTING
> mSaSecurityRegisters[] = {
> 
> +  {0,  R_SA_SMRAMC,  0xFFFFFFFF,  BIT4}
> 
> +};
> 
> +
> 
> +/**
> 
> +  SystemAgent Initialization Common Function.
> 
> +
> 
> +  @retval EFI_SUCCESS   - Always.
> 
> +**/
> 
> +
> 
> +VOID
> 
> +SaInitEntryPoint (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  HOST_BRIDGE_DATA_HOB        *HostBridgeDataHob;
> 
> +
> 
> +  ///
> 
> +  /// Get Host Bridge Data HOB
> 
> +  ///
> 
> +  HostBridgeDataHob = NULL;
> 
> +  HostBridgeDataHob = (HOST_BRIDGE_DATA_HOB *) GetFirstGuidHob
> (&gHostBridgeDataHobGuid);
> 
> +  if (HostBridgeDataHob != NULL) {
> 
> +    mSkipPamLock = HostBridgeDataHob->SkipPamLock;
> 
> +  }
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function does SA security lock
> 
> +**/
> 
> +VOID
> 
> +SaSecurityLock (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT8           Index;
> 
> +  UINT64          BaseAddress;
> 
> +  UINT32          RegOffset;
> 
> +  UINT32          Data32And;
> 
> +  UINT32          Data32Or;
> 
> +
> 
> +  ///
> 
> +  /// 17.2 System Agent Security Lock configuration
> 
> +  ///
> 
> +  DEBUG ((DEBUG_INFO, "DXE SaSecurityLock\n"));
> 
> +  for (Index = 0; Index < (sizeof (mSaSecurityRegisters) / sizeof
> (BOOT_SCRIPT_REGISTER_SETTING)); Index++) {
> 
> +    BaseAddress = mSaSecurityRegisters[Index].BaseAddr;
> 
> +    RegOffset   = mSaSecurityRegisters[Index].Offset;
> 
> +    Data32And   = mSaSecurityRegisters[Index].AndMask;
> 
> +    Data32Or    = mSaSecurityRegisters[Index].OrMask;
> 
> +
> 
> +    if (RegOffset == R_SA_SMRAMC) {
> 
> +      ///
> 
> +      /// SMRAMC LOCK must use CF8/CFC access
> 
> +      ///
> 
> +      PciCf8Or8 (PCI_CF8_LIB_ADDRESS (SA_MC_BUS, SA_MC_DEV,
> SA_MC_FUN, R_SA_SMRAMC), (UINT8) Data32Or);
> 
> +      BaseAddress = S3_BOOT_SCRIPT_LIB_PCI_ADDRESS (SA_MC_BUS,
> SA_MC_DEV, SA_MC_FUN, R_SA_SMRAMC);
> 
> +      S3BootScriptSavePciCfgReadWrite (
> 
> +        S3BootScriptWidthUint8,
> 
> +        (UINTN) BaseAddress,
> 
> +        &Data32Or,
> 
> +        &Data32And
> 
> +        );
> 
> +    }
> 
> +  }
> 
> +
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function performs SA Security locking in EndOfDxe callback
> 
> +
> 
> +  @retval EFI_SUCCESS     - Security lock has done
> 
> +  @retval EFI_UNSUPPORTED - Security lock not done successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +SaSecurityInit (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +
> 
> +  UINT8                     Index;
> 
> +
> 
> +  for (Index = 0; Index < (sizeof (mSaSecurityRegisters) / sizeof
> (BOOT_SCRIPT_REGISTER_SETTING)); Index++) {
> 
> +    if (mSaSecurityRegisters[Index].BaseAddr != PcdGet64
> (PcdMchBaseAddress)) {
> 
> +      mSaSecurityRegisters[Index].BaseAddr = PcdGet64
> (PcdSiPciExpressBaseAddress);
> 
> +    }
> 
> +  }
> 
> +  SaSecurityLock ();
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h
> new file mode 100644
> index 0000000000..5c8f7dfd5f
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInit.h
> @@ -0,0 +1,58 @@
> +/** @file
> 
> +  Header file for SA Common Initialization Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_INITIALIZATION_DRIVER_H_
> 
> +#define _SA_INITIALIZATION_DRIVER_H_
> 
> +
> 
> +#include <Uefi.h>
> 
> +#include <IndustryStandard/Acpi.h>
> 
> +#include <IndustryStandard/Pci.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/UefiLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/PciCf8Lib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/SaPlatformLib.h>
> 
> +#include <Guid/EventGroup.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +#include <SaConfigHob.h>
> 
> +
> 
> +extern SA_POLICY_PROTOCOL              *mSaPolicy;
> 
> +extern SA_CONFIG_HOB                   *SaConfigHob;
> 
> +
> 
> +typedef struct {
> 
> +  UINT64  BaseAddr;
> 
> +  UINT32  Offset;
> 
> +  UINT32  AndMask;
> 
> +  UINT32  OrMask;
> 
> +} BOOT_SCRIPT_REGISTER_SETTING;
> 
> +
> 
> +/**
> 
> +  SystemAgent Initialization Common Function.
> 
> +
> 
> +  @retval EFI_SUCCESS   - Always.
> 
> +**/
> 
> +VOID
> 
> +SaInitEntryPoint (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  This function performs SA Security locking in EndOfDxe callback
> 
> +
> 
> +  @retval EFI_SUCCESS     - Security lock has done
> 
> +  @retval EFI_UNSUPPORTED - Security lock not done successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +SaSecurityInit (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c
> new file mode 100644
> index 0000000000..2a0e0accf5
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.c
> @@ -0,0 +1,181 @@
> +/** @file
> 
> +  This is the driver that initializes the Intel System Agent.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "SaInitDxe.h"
> 
> +#include "SaInit.h"
> 
> +#include <SaConfigHob.h>
> 
> +#include <Protocol/PciEnumerationComplete.h>
> 
> +#include <MemInfoHob.h>
> 
> +#include <Protocol/SaIotrapSmi.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT16
> mPcieIoTrapAddress;
> 
> +
> 
> +///
> 
> +/// Global Variables
> 
> +///
> 
> +extern SA_CONFIG_HOB         *mSaConfigHob;
> 
> +
> 
> +
> 
> +/**
> 
> +  SystemAgent Dxe Initialization.
> 
> +
> 
> +  @param[in] ImageHandle             Handle for the image of this driver
> 
> +  @param[in] SystemTable             Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaInitEntryPointDxe (
> 
> +  IN EFI_HANDLE         ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE   *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                Status;
> 
> +  VOID                      *Registration;
> 
> +  EFI_EVENT                 ReadyToBoot;
> 
> +
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SaInitDxe Start\n"));
> 
> +
> 
> +  SaInitEntryPoint ();
> 
> +
> 
> +  Status = SaAcpiInit (ImageHandle);
> 
> +  ///
> 
> +  /// Create PCI Enumeration Completed callback for CPU PCIe
> 
> +  ///
> 
> +  EfiCreateProtocolNotifyEvent (
> 
> +    &gEfiPciEnumerationCompleteProtocolGuid,
> 
> +    TPL_CALLBACK,
> 
> +    CpuPciEnumCompleteCallback,
> 
> +    NULL,
> 
> +    &Registration
> 
> +    );
> 
> +
> 
> +  //
> 
> +  // Register a Ready to boot event to config PCIE power management
> setting after OPROM executed
> 
> +  //
> 
> +  Status = EfiCreateEventReadyToBootEx (
> 
> +             TPL_CALLBACK,
> 
> +             SaOnReadyToBoot,
> 
> +             NULL,
> 
> +             &ReadyToBoot
> 
> +             );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SaInitDxe End\n"));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Do PCIE power management while resume from S3
> 
> +**/
> 
> +VOID
> 
> +ReconfigureCpuPciePowerManagementForS3 (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINT32                                Data32;
> 
> +  SA_IOTRAP_SMI_PROTOCOL                *CpuPcieIoTrapProtocol;
> 
> +
> 
> +  Status = gBS->LocateProtocol (&gCpuPcieIoTrapProtocolGuid, NULL, (VOID
> **) &CpuPcieIoTrapProtocol);
> 
> +  if (EFI_ERROR (Status)) {
> 
> +    return;
> 
> +  }
> 
> +  mPcieIoTrapAddress = CpuPcieIoTrapProtocol->SaIotrapSmiAddress;
> 
> +  DEBUG ((DEBUG_INFO, "PcieIoTrapAddress: %0x\n",
> mPcieIoTrapAddress));
> 
> +
> 
> +  if (mPcieIoTrapAddress != 0) {
> 
> +    //
> 
> +    // Save PCH PCIE IoTrap address to re-config PCIE power management
> setting after resume from S3
> 
> +    //
> 
> +    Data32 = CpuPciePmTrap;
> 
> +    S3BootScriptSaveIoWrite (
> 
> +      S3BootScriptWidthUint32,
> 
> +      (UINTN) (mPcieIoTrapAddress),
> 
> +      1,
> 
> +      &Data32
> 
> +      );
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  SA initialization before boot to OS
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SaOnReadyToBoot (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  DEBUG ((DEBUG_INFO, "Uefi SaOnReadyToBoot() Start\n"));
> 
> +
> 
> +  if (Event != NULL) {
> 
> +    gBS->CloseEvent (Event);
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Trigger an Iotrap SMI to config PCIE power management setting after
> PCI enumrate is done
> 
> +  //
> 
> +#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
> 
> +  if (mPcieIoTrapAddress != 0) {
> 
> +    IoWrite32 ((UINTN) mPcieIoTrapAddress, CpuPciePmTrap);
> 
> +  } else {
> 
> +    ASSERT (FALSE);
> 
> +  }
> 
> +#endif
> 
> +  DEBUG ((DEBUG_INFO, "Uefi SaOnReadyToBoot() End\n"));
> 
> +}
> 
> +
> 
> +
> 
> +/**
> 
> +  This function gets registered as a callback to perform CPU PCIe initialization
> before EndOfDxe
> 
> +
> 
> +  @param[in] Event     - A pointer to the Event that triggered the callback.
> 
> +  @param[in] Context   - A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPciEnumCompleteCallback (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS          Status;
> 
> +  VOID                *ProtocolPointer;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "CpuPciEnumCompleteCallback Start\n"));
> 
> +  ///
> 
> +  /// Check if this is first time called by EfiCreateProtocolNotifyEvent() or
> not,
> 
> +  /// if it is, we will skip it until real event is triggered
> 
> +  ///
> 
> +  Status = gBS->LocateProtocol
> (&gEfiPciEnumerationCompleteProtocolGuid, NULL, (VOID **)
> &ProtocolPointer);
> 
> +  if (EFI_SUCCESS != Status) {
> 
> +    return;
> 
> +  }
> 
> +
> 
> +  gBS->CloseEvent (Event);
> 
> +
> 
> +  ReconfigureCpuPciePowerManagementForS3();
> 
> +  //
> 
> +  // Routine for update DMAR
> 
> +  //
> 
> +  UpdateDmarEndOfPcieEnum ();
> 
> +
> 
> +  UpdateSaGnvsForMmioResourceBaseLength ();
> 
> +  DEBUG ((DEBUG_INFO, "CpuPciEnumCompleteCallback End\n"));
> 
> +  return;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h
> new file mode 100644
> index 0000000000..7110d049a8
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.h
> @@ -0,0 +1,136 @@
> +/** @file
> 
> +  Header file for SA Initialization Driver.
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SA_INIT_DXE_DRIVER_H_
> 
> +#define _SA_INIT_DXE_DRIVER_H_
> 
> +
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Protocol/AcpiTable.h>
> 
> +#include <Library/DxeVtdInitLib.h>
> 
> +#include <Library/DxeIgdOpRegionInitLib.h>
> 
> +#include <Library/DxeGraphicsInitLib.h>
> 
> +#include <Register/SaRegsHostBridge.h>
> 
> +
> 
> +///
> 
> +/// Driver Consumed Protocol Prototypes
> 
> +///
> 
> +#include <Protocol/SaPolicy.h>
> 
> +
> 
> +extern EFI_GUID gSaAcpiTableStorageGuid;
> 
> +extern EFI_GUID gSaSsdtAcpiTableStorageGuid;
> 
> +
> 
> +typedef struct {
> 
> +  UINT64                Address;
> 
> +  EFI_BOOT_SCRIPT_WIDTH Width;
> 
> +  UINT32                Value;
> 
> +} BOOT_SCRIPT_PCI_REGISTER_SAVE;
> 
> +
> 
> +///
> 
> +/// Function Prototype
> 
> +///
> 
> +/**
> 
> +  This function gets registered as a callback to perform CPU PCIe initialization
> before ExitPmAuth
> 
> +
> 
> +  @param[in] Event     - A pointer to the Event that triggered the callback.
> 
> +  @param[in] Context   - A pointer to private data registered with the
> callback function.
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPciEnumCompleteCallback (
> 
> +  IN EFI_EVENT Event,
> 
> +  IN VOID      *Context
> 
> +  );
> 
> +
> 
> +/**
> 
> +  <b>System Agent Initialization DXE Driver Entry Point</b>
> 
> +  - <b>Introduction</b> \n
> 
> +    Based on the information/data in SA_POLICY_PROTOCOL, this module
> performs further SA initialization in DXE phase,
> 
> +    e.g. internal devices enable/disable, SSVID/SID programming, graphic
> power-management, VT-d, IGD OpRegion initialization.
> 
> +    From the perspective of a PCI Express hierarchy, the Broadwell System
> Agent and PCH together appear as a Root Complex with root ports the
> number of which depends on how the 8 PCH ports and 4 System Agent PCIe
> ports are configured [4x1, 2x8, 1x16].
> 
> +    There is an internal link (DMI or OPI) that connects the System Agent to
> the PCH component. This driver includes initialization of SA DMI, PCI Express,
> SA & PCH Root Complex Topology.
> 
> +    For iGFX, this module implements the initialization of the Graphics
> Technology Power Management from the Broadwell System Agent BIOS
> Specification and the initialization of the IGD OpRegion/Software SCI - BIOS
> Specification.
> 
> +    The ASL files that go along with the driver define the IGD OpRegion
> mailboxes in ACPI space and implement the software SCI interrupt
> mechanism.
> 
> +    The IGD OpRegion/Software SCI code serves as a communication
> interface between system BIOS, ASL, and Intel graphics driver including
> making a block of customizable data (VBT) from the Intel video BIOS
> available.
> 
> +    Reference Code for the SCI service functions "Get BIOS Data" and
> "System BIOS Callback" can be found in the ASL files, those functions can be
> platform specific, the sample provided in the reference code are
> implemented for Intel CRB.
> 
> +    This module implements the VT-d functionality described in the Broadwell
> System Agent BIOS Specification.
> 
> +    This module publishes the LegacyRegion protocol to control the read and
> write accesses to the Legacy BIOS ranges.
> 
> +    E000 and F000 segments are the legacy BIOS ranges and contain pointers
> to the ACPI regions, SMBIOS tables and so on. This is a private protocol used
> by Intel Framework.
> 
> +    This module registers CallBack function that performs SA security registers
> lockdown at end of post as required from Broadwell Bios Spec.
> 
> +    In addition, this module publishes the SaInfo Protocol with information
> such as current System Agent reference code version#.
> 
> +
> 
> +  - @pre
> 
> +    - EFI_FIRMWARE_VOLUME_PROTOCOL: Documented in Firmware
> Volume Specification, available at the URL:
> http://www.intel.com/technology/framework/spec.htm
> 
> +    - SA_POLICY_PROTOCOL: A protocol published by a platform DXE module
> executed earlier; this is documented in this document as well.
> 
> +    - EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL: Documented in the Unified
> Extensible Firmware Interface Specification, version 2.0, available at the URL:
> http://www.uefi.org/specs/
> 
> +    - EFI_BOOT_SCRIPT_SAVE_PROTOCOL: A protocol published by a
> platform DXE module executed earlier; refer to the Sample Code section of
> the Framework PCH Reference Code.
> 
> +    - EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL:
> Documented in the Unified Extensible Firmware Interface Specification,
> version 2.0, available at the URL: http://www.uefi.org/specs/
> 
> +    - EFI_ACPI_TABLE_PROTOCOL : Documented in PI Specification 1.2
> 
> +    - EFI_CPU_IO_PROTOCOL: Documented in CPU I/O Protocol Specification,
> available at the URL:
> http://www.intel.com/technology/framework/spec.htm
> 
> +    - EFI_DATA_HUB_PROTOCOL: Documented in EFI Data Hub Infrastructure
> Specification, available at the URL:
> http://www.intel.com/technology/framework/spec.htm
> 
> +    - EFI_HII_PROTOCOL (or EFI_HII_DATABASE_PROTOCOL for UEFI 2.1):
> Documented in Human Interface Infrastructure Specification, available at the
> URL: http://www.intel.com/technology/framework/spec.htm
> 
> +    (For EFI_HII_DATABASE_PROTOCOL, refer to UEFI Specification Version
> 2.1 available at the URL: http://www.uefi.org/)
> 
> +
> 
> +  - @result
> 
> +    IGD power-management functionality is initialized;  VT-d is initialized
> (meanwhile, the DMAR table is updated); IGD OpRegion is initialized -
> IGD_OPREGION_PROTOCOL installed, IGD OpRegion allocated and mailboxes
> initialized, chipset initialized and ready to generate Software SCI for Internal
> graphics events. Publishes the SA_INFO_PROTOCOL with current SA
> reference code version #. Publishes the EFI_LEGACY_REGION_PROTOCOL
> documented in the Compatibility Support Module Specification, version 0.9,
> available at the URL:
> http://www.intel.com/technology/framework/spec.htm
> 
> +
> 
> +  - <b>References</b> \n
> 
> +    IGD OpRegion/Software SCI for Broadwell
> 
> +    Advanced Configuration and Power Interface Specification Revision 4.0a.
> 
> +
> 
> +  - <b>Porting Recommendations</b> \n
> 
> +    No modification of the DXE driver should be typically necessary.
> 
> +    This driver should be executed after all related devices (audio, video, ME,
> etc.) are initialized to ensure correct data in DMAR table and DMA-remapping
> registers.
> 
> +
> 
> +  @param[in] ImageHandle             Handle for the image of this driver
> 
> +  @param[in] SystemTable             Pointer to the EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaInitEntryPointDxe (
> 
> +  IN EFI_HANDLE         ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE   *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +  SystemAgent Acpi Initialization.
> 
> +
> 
> +  @param[in] ImageHandle             Handle for the image of this driver
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completed successfully
> 
> +  @retval EFI_OUT_OF_RESOURCES    No enough buffer to allocate
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaAcpiInit (
> 
> +  IN EFI_HANDLE         ImageHandle
> 
> +  );
> 
> +
> 
> +/**
> 
> +  A protocol callback which updates 64bits MMIO Base and Length in SA
> GNVS area
> 
> +**/
> 
> +VOID
> 
> +UpdateSaGnvsForMmioResourceBaseLength (
> 
> +  VOID
> 
> +  );
> 
> +
> 
> +/**
> 
> +  SA initialization before boot to OS
> 
> +
> 
> +  @param[in] Event                A pointer to the Event that triggered the
> callback.
> 
> +  @param[in] Context              A pointer to private data registered with the
> callback function.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +SaOnReadyToBoot (
> 
> +  IN EFI_EVENT    Event,
> 
> +  IN VOID         *Context
> 
> +  );
> 
> +
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf
> new file mode 100644
> index 0000000000..d23ba0fa3b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Dxe/SaInitDxe.inf
> @@ -0,0 +1,117 @@
> +## @file
> 
> +# Component description file for SystemAgent Initialization driver
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = SaInitDxe
> 
> +FILE_GUID = DE23ACEE-CF55-4fb6-AA77-984AB53DE811
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_DRIVER
> 
> +ENTRY_POINT = SaInitEntryPointDxe
> 
> +#
> 
> +# The following information is for reference only and not required by the
> build tools.
> 
> +#
> 
> +# VALID_ARCHITECTURES = IA32 X64 EBC
> 
> +#
> 
> +
> 
> +
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiDriverEntryPoint
> 
> +UefiLib
> 
> +UefiBootServicesTableLib
> 
> +DxeServicesTableLib
> 
> +DebugLib
> 
> +PciCf8Lib
> 
> +PciSegmentLib
> 
> +BaseMemoryLib
> 
> +MemoryAllocationLib
> 
> +IoLib
> 
> +S3BootScriptLib
> 
> +PmcLib
> 
> +PchInfoLib
> 
> +GpioLib
> 
> +ConfigBlockLib
> 
> +SaPlatformLib
> 
> +PchPcieRpLib
> 
> +DxeGraphicsInitLib
> 
> +DxeIgdOpRegionInitLib
> 
> +DxeVtdInitLib
> 
> +PciExpressHelpersLib
> 
> +DxeCpuPcieRpLib
> 
> +SataLib
> 
> +
> 
> +[Packages]
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +MdePkg/MdePkg.dec
> 
> +UefiCpuPkg/UefiCpuPkg.dec
> 
> +IntelSiliconPkg/IntelSiliconPkg.dec
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdMchBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdSiIoApicBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                  ## CONSUMES
> 
> +
> 
> +[FixedPcd]
> 
> +
> 
> +[Sources]
> 
> +SaInitDxe.h
> 
> +SaInitDxe.c
> 
> +SaInit.h
> 
> +SaInit.c
> 
> +SaAcpi.c
> 
> +
> 
> +
> 
> +[Protocols]
> 
> +gEfiAcpiTableProtocolGuid              ## CONSUMES
> 
> +gSaNvsAreaProtocolGuid                 ## PRODUCES
> 
> +gSaPolicyProtocolGuid                  ## CONSUMES
> 
> +gEfiCpuArchProtocolGuid                ## CONSUMES
> 
> +gEfiPciEnumerationCompleteProtocolGuid ## CONSUMES
> 
> +gEfiPciRootBridgeIoProtocolGuid        ## CONSUMES
> 
> +gIgdOpRegionProtocolGuid               ## PRODUCES
> 
> +gEfiFirmwareVolume2ProtocolGuid        ## CONSUMES
> 
> +gGopComponentName2ProtocolGuid         ## CONSUMES
> 
> +gSaIotrapSmiProtocolGuid               ## CONSUMES
> 
> +gCpuPcieIoTrapProtocolGuid             ## CONSUMES
> 
> +
> 
> +[Guids]
> 
> +gSaConfigHobGuid
> 
> +gHgAcpiTablePchStorageGuid
> 
> +gSaAcpiTableStorageGuid
> 
> +gHgAcpiTableStorageGuid
> 
> +gSaSsdtAcpiTableStorageGuid
> 
> +gSegSsdtAcpiTableStorageGuid
> 
> +gTcssSsdtAcpiTableStorageGuid
> 
> +gGraphicsAcpiTableStorageGuid
> 
> +gIpuAcpiTableStorageGuid
> 
> +gEfiEndOfDxeEventGroupGuid
> 
> +gSiConfigHobGuid        ## CONSUMES
> 
> +gGraphicsDxeConfigGuid
> 
> +gMemoryDxeConfigGuid
> 
> +gPcieDxeConfigGuid
> 
> +gPchInfoHobGuid
> 
> +gTcssHobGuid
> 
> +gSaConfigHobGuid
> 
> +gSaDataHobGuid
> 
> +gCpuPcieHobGuid
> 
> +gHostBridgeDataHobGuid
> 
> +gVmdInfoHobGuid                   ## CONSUMES
> 
> +
> 
> +[FixedPcd]
> 
> +
> 
> +[Depex]
> 
> +gEfiAcpiTableProtocolGuid AND
> 
> +gEfiFirmwareVolume2ProtocolGuid AND
> 
> +gSaPolicyProtocolGuid AND
> 
> +gEfiPciRootBridgeIoProtocolGuid AND
> 
> +gEfiPciHostBridgeResourceAllocationProtocolGuid AND # This is to ensure
> that PCI MMIO resource has been prepared and available for this driver to
> allocate.
> 
> +gEfiHiiDatabaseProtocolGuid
> 
> +
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
> new file mode 100644
> index 0000000000..70d47e787f
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/CpuPcieSmm.c
> @@ -0,0 +1,454 @@
> +/** @file
> 
> +  CPU PCIe SMM Driver Entry
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include "SaLateInitSmm.h"
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/DxeServicesTableLib.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <PcieRegs.h>
> 
> +#include <Register/PchRegs.h>
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <Library/PcieHelperLib.h>
> 
> +#include <CpuPcieInfo.h>
> 
> +#include <Library/TimerLib.h>
> 
> +#include <Library/PciExpressHelpersLib.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +#include <CpuPcieConfig.h>
> 
> +#include <Library/CpuPcieRpLib.h>
> 
> +#include <Protocol/PchPcieSmiDispatch.h>
> 
> +#include <Protocol/PchSmiDispatch.h>
> 
> +#include <Protocol/SaIotrapSmi.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <Library/BaseMemoryLib.h>
> 
> +#include <CpuPcieHob.h>
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8                       mSaBusNumber;
> 
> +//
> 
> +// @note:
> 
> +// These temp bus numbers cannot be used in runtime (hot-plug).
> 
> +// These can be used only during boot.
> 
> +//
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mTempRootPortBusNumMin;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mTempRootPortBusNumMax;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED CPU_PCIE_ROOT_PORT_CONFIG
> mCpuPcieRootPortConfig[CPU_PCIE_MAX_ROOT_PORTS];
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED BOOLEAN
> mCpuPciePmTrapExecuted = FALSE;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED PCH_PCIE_DEVICE_OVERRIDE
> *mDevAspmOverride;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT32
> mNumOfDevAspmOverride;
> 
> +
> 
> +/**
> 
> +  An IoTrap callback to config PCIE power management settings
> 
> +**/
> 
> +VOID
> 
> +CpuPciePmIoTrapSmiCallback (
> 
> +  VOID
> 
> +  )
> 
> +{
> 
> +  UINT32                                    PortIndex;
> 
> +  UINT64                                    RpBase;
> 
> +  UINT8                                     MaxPciePortNum;
> 
> +  UINTN                                     RpDevice;
> 
> +  UINTN                                     RpFunction;
> 
> +
> 
> +  MaxPciePortNum = GetMaxCpuPciePortNum ();
> 
> +
> 
> +  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
> 
> +    GetCpuPcieRpDevFun (PortIndex, &RpDevice, &RpFunction);
> 
> +    RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS,
> (UINT32) RpDevice, (UINT32) RpFunction, 0);
> 
> +
> 
> +    if (PciSegmentRead16 (RpBase) != 0xFFFF) {
> 
> +      mDevAspmOverride                  = NULL;
> 
> +      mNumOfDevAspmOverride             = 0;
> 
> +      RootportDownstreamPmConfiguration (
> 
> +        SA_SEG_NUM,
> 
> +        SA_MC_BUS,
> 
> +        (UINT8)RpDevice,
> 
> +        (UINT8)RpFunction,
> 
> +        mTempRootPortBusNumMin,
> 
> +        mTempRootPortBusNumMax,
> 
> +        &mCpuPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
> 
> +        mNumOfDevAspmOverride,
> 
> +        mDevAspmOverride
> 
> +      );
> 
> +
> 
> +    }
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  Program Common Clock and ASPM of Downstream Devices
> 
> +
> 
> +  @param[in] PortIndex                  Pcie Root Port Number
> 
> +  @param[in] RpDevice                   Pcie Root Pci Device Number
> 
> +  @param[in] RpFunction                 Pcie Root Pci Function Number
> 
> +
> 
> +  @retval EFI_SUCCESS                   Root port complete successfully
> 
> +  @retval EFI_UNSUPPORTED               PMC has invalid vendor ID
> 
> +**/
> 
> +EFI_STATUS
> 
> +CpuPcieSmi (
> 
> +  IN  UINT8                             PortIndex,
> 
> +  IN  UINT8                             RpDevice,
> 
> +  IN  UINT8                             RpFunction
> 
> +  )
> 
> +{
> 
> +  UINT8                 SecBus;
> 
> +  UINT8                 SubBus;
> 
> +  UINT64                RpBase;
> 
> +  UINT64                EpBase;
> 
> +  UINT8                 EpPcieCapPtr;
> 
> +  UINT8                 EpMaxSpeed;
> 
> +  BOOLEAN               DownstreamDevicePresent;
> 
> +  UINT32                Timeout;
> 
> +  UINT32                MaxLinkSpeed;
> 
> +
> 
> +  RpBase   = PCI_SEGMENT_LIB_ADDRESS (
> 
> +               SA_SEG_NUM,
> 
> +               SA_MC_BUS,
> 
> +               (UINT32) RpDevice,
> 
> +               (UINT32) RpFunction,
> 
> +               0
> 
> +               );
> 
> +
> 
> +  if (PciSegmentRead16 (RpBase + PCI_VENDOR_ID_OFFSET) == 0xFFFF) {
> 
> +    DEBUG((DEBUG_INFO, "PCIe controller is disabled, return!!\n"));
> 
> +    return EFI_SUCCESS;
> 
> +  }
> 
> +  //
> 
> +  // Check presence detect state. Here the endpoint must be detected using
> PDS rather than
> 
> +  // the usual LinkActive check, because PDS changes immediately and LA
> takes a few milliseconds to stabilize
> 
> +  //
> 
> +  DownstreamDevicePresent = !!(PciSegmentRead16 (RpBase +
> R_PCIE_SLSTS) & B_PCIE_SLSTS_PDS);
> 
> +
> 
> +  if (DownstreamDevicePresent) {
> 
> +    ///
> 
> +    /// Make sure the link is active before trying to talk to device behind it
> 
> +    /// Wait up to 100ms, according to PCIE spec chapter 6.7.3.3
> 
> +    ///
> 
> +    Timeout = 100 * 1000;
> 
> +    while (CpuPcieIsLinkActive(RpBase) == 0) {
> 
> +      MicroSecondDelay (10);
> 
> +      Timeout-=10;
> 
> +      if (Timeout == 0) {
> 
> +        DEBUG((DEBUG_INFO, "PDS set but timeout while waiting for LA bit to
> get set!!!\n"));
> 
> +        return EFI_NOT_FOUND;
> 
> +      }
> 
> +    }
> 
> +    SecBus  = PciSegmentRead8 (RpBase +
> PCI_BRIDGE_SECONDARY_BUS_REGISTER_OFFSET);
> 
> +    SubBus  = PciSegmentRead8 (RpBase +
> PCI_BRIDGE_SUBORDINATE_BUS_REGISTER_OFFSET);
> 
> +    ASSERT (SecBus != 0 && SubBus != 0);
> 
> +    if (SecBus == 0) {
> 
> +      DEBUG((DEBUG_INFO, "Secondary Bus is 0, return!!!\n"));
> 
> +      return EFI_NOT_FOUND;
> 
> +    }
> 
> +    RootportDownstreamConfiguration (
> 
> +      SA_SEG_NUM,
> 
> +      SA_MC_BUS,
> 
> +      RpDevice,
> 
> +      RpFunction,
> 
> +      mTempRootPortBusNumMin,
> 
> +      mTempRootPortBusNumMax,
> 
> +      EnumCpuPcie
> 
> +      );
> 
> +    RootportDownstreamPmConfiguration (
> 
> +      SA_SEG_NUM,
> 
> +      SA_MC_BUS,
> 
> +      RpDevice,
> 
> +      RpFunction,
> 
> +      mTempRootPortBusNumMin,
> 
> +      mTempRootPortBusNumMax,
> 
> +      &mCpuPcieRootPortConfig[PortIndex].PcieRpCommonConfig,
> 
> +      mNumOfDevAspmOverride,
> 
> +      mDevAspmOverride
> 
> +    );
> 
> +    //
> 
> +    // Perform Equalization
> 
> +    //
> 
> +    EpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SecBus, 0, 0, 0);
> 
> +    EpPcieCapPtr = PcieFindCapId (SA_SEG_NUM, SecBus, 0, 0,
> EFI_PCI_CAPABILITY_ID_PCIEXP);
> 
> +    EpMaxSpeed = PciSegmentRead8 (EpBase + EpPcieCapPtr +
> R_PCIE_LCAP_OFFSET) & B_PCIE_LCAP_MLS;
> 
> +    MaxLinkSpeed = CpuPcieGetMaxLinkSpeed (RpBase);
> 
> +    if (EpMaxSpeed < MaxLinkSpeed) {
> 
> +        MaxLinkSpeed = EpMaxSpeed;
> 
> +    }
> 
> +    if (EpMaxSpeed >= V_PCIE_LCAP_MLS_GEN3 && EpMaxSpeed <=
> V_PCIE_LCAP_MLS_GEN4) {
> 
> +      PciSegmentAndThenOr16 (RpBase + R_PCIE_LCTL2,
> (UINT16)~B_PCIE_LCTL2_TLS, (UINT16)MaxLinkSpeed);
> 
> +      PciSegmentOr32 (RpBase + R_PCIE_LCTL3, B_PCIE_LCTL3_PE);
> 
> +      PciSegmentOr32 (RpBase + R_PCIE_LCTL, B_PCIE_LCTL_RL);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Hotplug SMI call back function for each Root port
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPcieSmiRpHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  CpuPcieSmi (RpContext->RpIndex, RpContext->DevNum, RpContext-
> >FuncNum);
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Link Active State Change Hotplug SMI call back function for all Root
> ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPcieLinkActiveStateChange (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  return;
> 
> +}
> 
> +
> 
> +/**
> 
> +  PCIE Link Equalization Request SMI call back function for all Root ports
> 
> +
> 
> +  @param[in] DispatchHandle             Handle of this dispatch function
> 
> +  @param[in] RpContext                  Rootport context, which contains RootPort
> Index,
> 
> +                                        and RootPort PCI BDF.
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPcieLinkEqHandlerFunction (
> 
> +  IN  EFI_HANDLE                        DispatchHandle,
> 
> +  IN  PCH_PCIE_SMI_RP_CONTEXT           *RpContext
> 
> +  )
> 
> +{
> 
> +  ///
> 
> +  /// From PCI Express specification, the PCIe device can request for Link
> Equalization. When the
> 
> +  /// Link Equalization is requested by the device, an SMI will be generated
> by PCIe RP when
> 
> +  /// enabled and the SMI subroutine would invoke the Software
> Preset/Coefficient Search
> 
> +  /// software to re-equalize the link.
> 
> +  ///
> 
> +
> 
> +  return;
> 
> +
> 
> +}
> 
> +/**
> 
> +  An IoTrap callback to config PCIE power management settings
> 
> +
> 
> +  @param[in] DispatchHandle  - The handle of this callback, obtained when
> registering
> 
> +  @param[in] DispatchContext - Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPcieIoTrapSmiCallback (
> 
> +  IN  EFI_HANDLE                            DispatchHandle,
> 
> +  IN  EFI_SMM_IO_TRAP_CONTEXT               *CallbackContext,
> 
> +  IN OUT VOID                               *CommBuffer,
> 
> +  IN OUT UINTN                              *CommBufferSize
> 
> +  )
> 
> +{
> 
> +  if (CallbackContext->WriteData == CpuPciePmTrap) {
> 
> +    if (mCpuPciePmTrapExecuted == FALSE) {
> 
> +      CpuPciePmIoTrapSmiCallback ();
> 
> +      mCpuPciePmTrapExecuted = TRUE;
> 
> +    }
> 
> +  } else {
> 
> +    ASSERT_EFI_ERROR (EFI_INVALID_PARAMETER);
> 
> +  }
> 
> +}
> 
> +
> 
> +/**
> 
> +  This function clear the Io trap executed flag before enter S3
> 
> +
> 
> +  @param[in] Handle    Handle of the callback
> 
> +  @param[in] Context   The dispatch context
> 
> +
> 
> +  @retval EFI_SUCCESS  SA register saved
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +CpuPcieS3EntryCallBack (
> 
> +  IN  EFI_HANDLE                   Handle,
> 
> +  IN CONST VOID                    *Context OPTIONAL,
> 
> +  IN OUT VOID                      *CommBuffer OPTIONAL,
> 
> +  IN OUT UINTN                     *CommBufferSize OPTIONAL
> 
> +  )
> 
> +{
> 
> +  mCpuPciePmTrapExecuted = FALSE;
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> +
> 
> +/**
> 
> +  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
> 
> +
> 
> +  @param[in] ImageHandle          The image handle of this module
> 
> +  @param[in] SystemTable          The EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InitializeCpuPcieSmm (
> 
> +  IN      EFI_HANDLE            ImageHandle,
> 
> +  IN      EFI_SYSTEM_TABLE      *SystemTable
> 
> +  )
> 
> +{
> 
> +  EFI_STATUS                            Status;
> 
> +  UINT8                                 PortIndex;
> 
> +  UINT8                                 Data8;
> 
> +  UINT32                                Data32Or;
> 
> +  UINT32                                Data32And;
> 
> +  UINT64                                RpBase;
> 
> +  UINTN                                 RpDevice;
> 
> +  UINTN                                 RpFunction;
> 
> +  EFI_HANDLE                            PcieHandle;
> 
> +  EFI_HANDLE                            PchIoTrapHandle;
> 
> +  PCH_PCIE_SMI_DISPATCH_PROTOCOL        *PchPcieSmiDispatchProtocol;
> 
> +  EFI_SMM_IO_TRAP_REGISTER_CONTEXT      PchIoTrapContext;
> 
> +  EFI_SMM_SX_REGISTER_CONTEXT           SxDispatchContext;
> 
> +  SA_IOTRAP_SMI_PROTOCOL                *CpuPcieIoTrapProtocol;
> 
> +  EFI_HANDLE                            SxDispatchHandle;
> 
> +  UINT8                                 MaxPciePortNum;
> 
> +  CPU_PCIE_HOB                          *CpuPcieHob;
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializeCpuPcieSmm () Start\n"));
> 
> +
> 
> +  MaxPciePortNum    = GetMaxCpuPciePortNum ();
> 
> +
> 
> +  //
> 
> +  // Locate Pch Pcie Smi Dispatch Protocol
> 
> +  //
> 
> +  Status = gSmst->SmmLocateProtocol (&gPchPcieSmiDispatchProtocolGuid,
> NULL, (VOID**) &PchPcieSmiDispatchProtocol);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  mTempRootPortBusNumMin = PcdGet8 (PcdSiliconInitTempPciBusMin);
> 
> +  mTempRootPortBusNumMax = PcdGet8 (PcdSiliconInitTempPciBusMax);
> 
> +
> 
> +  ///
> 
> +  /// Locate HOB for CPU PCIe
> 
> +  ///
> 
> +  CpuPcieHob = GetFirstGuidHob(&gCpuPcieHobGuid);
> 
> +  if (CpuPcieHob != NULL) {
> 
> +    ASSERT (sizeof mCpuPcieRootPortConfig == sizeof CpuPcieHob-
> >RootPort);
> 
> +    CopyMem (
> 
> +      mCpuPcieRootPortConfig,
> 
> +      &(CpuPcieHob->RootPort),
> 
> +      sizeof (mCpuPcieRootPortConfig)
> 
> +      );
> 
> +  }
> 
> +
> 
> +  //
> 
> +  // Throught all PCIE root port function and register the SMI Handler for
> enabled ports.
> 
> +  //
> 
> +  for (PortIndex = 0; PortIndex < MaxPciePortNum; PortIndex++) {
> 
> +    GetCpuPcieRpDevFun (PortIndex, &RpDevice, &RpFunction);
> 
> +    RpBase = PCI_SEGMENT_LIB_ADDRESS (SA_SEG_NUM, SA_MC_BUS,
> (UINT32) RpDevice, (UINT32) RpFunction, 0);
> 
> +    //
> 
> +    // Skip the root port function which is not enabled
> 
> +    //
> 
> +    if (PciSegmentRead32 (RpBase) == 0xFFFFFFFF) {
> 
> +      continue;
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Register SMI Handlers for Hot Plug and Link Active State Change
> 
> +    //
> 
> +    Data8 = PciSegmentRead8 (RpBase + R_PCIE_SLCAP);
> 
> +    if (Data8 & B_PCIE_SLCAP_HPC) {
> 
> +      PcieHandle = NULL;
> 
> +      Status = PchPcieSmiDispatchProtocol->HotPlugRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             CpuPcieSmiRpHandlerFunction,
> 
> +                                             (PortIndex + CpuRpIndex0),
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      Status = PchPcieSmiDispatchProtocol->LinkActiveRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             CpuPcieLinkActiveStateChange,
> 
> +                                             (PortIndex + CpuRpIndex0),
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +      Data32Or  = B_PCIE_MPC_HPME;
> 
> +      Data32And = (UINT32) ~B_PCIE_MPC_HPME;
> 
> +      S3BootScriptSaveMemReadWrite (
> 
> +        S3BootScriptWidthUint32,
> 
> +        PcdGet64 (PcdSiPciExpressBaseAddress) + RpBase + R_PCIE_MPC,
> 
> +        &Data32Or,  /// Data to be ORed
> 
> +        &Data32And  /// Data to be ANDed
> 
> +        );
> 
> +    }
> 
> +
> 
> +    //
> 
> +    // Register SMI Handler for Link Equalization Request from Gen 3 Devices.
> 
> +    //
> 
> +    Data8 = PciSegmentRead8 (RpBase + R_PCIE_LCAP);
> 
> +    if ((Data8 & B_PCIE_LCAP_MLS) == V_PCIE_LCAP_MLS_GEN3) {
> 
> +      Status = PchPcieSmiDispatchProtocol->LinkEqRegister (
> 
> +                                             PchPcieSmiDispatchProtocol,
> 
> +                                             CpuPcieLinkEqHandlerFunction,
> 
> +                                             (PortIndex + CpuRpIndex0),
> 
> +                                             &PcieHandle
> 
> +                                             );
> 
> +      ASSERT_EFI_ERROR (Status);
> 
> +    }
> 
> +  }
> 
> +
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  PchIoTrapContext.Type     = WriteTrap;
> 
> +  PchIoTrapContext.Length   = 4;
> 
> +  PchIoTrapContext.Address  = 0;
> 
> +  Status = mPchIoTrap->Register (
> 
> +                         mPchIoTrap,
> 
> +                         (EFI_SMM_HANDLER_ENTRY_POINT2)
> CpuPcieIoTrapSmiCallback,
> 
> +                         &PchIoTrapContext,
> 
> +                         &PchIoTrapHandle
> 
> +                         );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  //
> 
> +  // Install the SA Pcie IoTrap protocol
> 
> +  //
> 
> +  (gBS->AllocatePool) (EfiBootServicesData, sizeof
> (SA_IOTRAP_SMI_PROTOCOL), (VOID **)&CpuPcieIoTrapProtocol);
> 
> +  CpuPcieIoTrapProtocol->SaIotrapSmiAddress =
> PchIoTrapContext.Address;
> 
> +
> 
> +  Status = gBS->InstallMultipleProtocolInterfaces (
> 
> +                  &ImageHandle,
> 
> +                  &gCpuPcieIoTrapProtocolGuid,
> 
> +                  CpuPcieIoTrapProtocol,
> 
> +                  NULL
> 
> +                  );
> 
> +
> 
> +  //
> 
> +  // Register the callback for S3 entry
> 
> +  //
> 
> +  SxDispatchContext.Type  = SxS3;
> 
> +  SxDispatchContext.Phase = SxEntry;
> 
> +  Status = mSxDispatch->Register (
> 
> +                          mSxDispatch,
> 
> +                          CpuPcieS3EntryCallBack,
> 
> +                          &SxDispatchContext,
> 
> +                          &SxDispatchHandle
> 
> +                          );
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "InitializeCpuPcieSmm, IoTrap @ %x () End\n",
> PchIoTrapContext.Address));
> 
> +
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .c
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .c
> new file mode 100644
> index 0000000000..0e9ba41f1b
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .c
> @@ -0,0 +1,112 @@
> +/** @file
> 
> +  This SMM driver will handle SA relevant late initialization
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#include <Library/BaseLib.h>
> 
> +#include <Base.h>
> 
> +#include <Library/MemoryAllocationLib.h>
> 
> +#include <Library/UefiBootServicesTableLib.h>
> 
> +#include <Library/DxeServicesTableLib.h>
> 
> +#include <Library/SmmServicesTableLib.h>
> 
> +#include <Library/DebugLib.h>
> 
> +#include <Library/PcdLib.h>
> 
> +#include <Library/IoLib.h>
> 
> +#include <Library/HobLib.h>
> 
> +#include <Library/SaPlatformLib.h>
> 
> +#include <Protocol/SmmIoTrapDispatch2.h>
> 
> +#include "SaLateInitSmm.h"
> 
> +#include <Library/PciSegmentLib.h>
> 
> +#include <CpuDataStruct.h>
> 
> +#include <CpuPcieHob.h>
> 
> +#include <Protocol/SaIotrapSmi.h>
> 
> +#include <PchPcieRpConfig.h>
> 
> +#include <SaConfigHob.h>
> 
> +#include "CpuPcieInfo.h"
> 
> +#include <Register/CpuPcieRegs.h>
> 
> +#include <IndustryStandard/Pci30.h>
> 
> +#include <Register/IgdRegs.h>
> 
> +#include <Register/CommonMsr.h>
> 
> +
> 
> +typedef enum {
> 
> +  EnumSaSmiCallbackForMaxPayLoad,
> 
> +  EnumSaSmiCallbackForSaSaveRestore,
> 
> +  EnumSaSmiCallbackForLateInit,
> 
> +  EnumSaSmiCallbackForS3resume,
> 
> +  EnumSaSmiCallbackMax
> 
> +} SMI_OPERATION;
> 
> +
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED UINT8
> mSaSmiCallbackPhase      = EnumSaSmiCallbackForMaxPayLoad;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
> 
> +GLOBAL_REMOVE_IF_UNREFERENCED
> EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
> 
> +
> 
> +
> 
> +typedef struct {
> 
> +  UINT64  BaseAddr;
> 
> +  UINT32  Offset;
> 
> +  UINT32  AndMask;
> 
> +  UINT32  OrMask;
> 
> +} BOOT_SCRIPT_REGISTER_SETTING;
> 
> +
> 
> +/**
> 
> +  Initializes the SA SMM handler
> 
> +
> 
> +  @param[in] ImageHandle - The image handle of Wake On Lan driver
> 
> +  @param[in] SystemTable - The standard EFI system table
> 
> +
> 
> +  @retval EFI_SUCCESS    - SA SMM handler was installed or not necessary
> 
> +  @retval EFI_NOT_FOUND  - Fail to register SMI callback or required
> protocol/hob missing.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaLateInitSmmEntryPoint (
> 
> +  IN EFI_HANDLE        ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> 
> +  )
> 
> +{
> 
> +#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
> 
> +  CPU_PCIE_HOB                              *CpuPcieHob = NULL;
> 
> +  EFI_STATUS                                Status;
> 
> +#endif
> 
> +
> 
> +  DEBUG ((DEBUG_INFO, "SaLateInitSmmEntryPoint()\n"));
> 
> +
> 
> +#if FixedPcdGetBool(PcdCpuPcieEnable) == 1
> 
> +  CpuPcieHob = (CPU_PCIE_HOB *) GetFirstGuidHob (&gCpuPcieHobGuid);
> 
> +  Status = EFI_NOT_FOUND;
> 
> +  if (CpuPcieHob == NULL) {
> 
> +    DEBUG ((DEBUG_INFO, "CPU PCIE HOB Not found\n"));
> 
> +    ASSERT (CpuPcieHob != NULL);
> 
> +    return Status;
> 
> +  }
> 
> +
> 
> +  ///
> 
> +  /// Locate the PCH Trap dispatch protocol
> 
> +  ///
> 
> +  Status = gSmst->SmmLocateProtocol
> (&gEfiSmmIoTrapDispatch2ProtocolGuid, NULL, (VOID **) &mPchIoTrap);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  Status = gSmst->SmmLocateProtocol (&gEfiSmmSxDispatch2ProtocolGuid,
> NULL, (VOID**) &mSxDispatch);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +  if (Status == EFI_SUCCESS) {
> 
> +    ///
> 
> +    /// If ASPM policy is set to "Before OPROM", this SMI callback is not
> necessary
> 
> +    /// Ensure the SMI callback handler will directly return and continue the
> POST.
> 
> +    ///
> 
> +    mSaSmiCallbackPhase = EnumSaSmiCallbackMax;
> 
> +    Status = EFI_SUCCESS;
> 
> +  }
> 
> +
> 
> +  Status = InitializeCpuPcieSmm (ImageHandle, SystemTable);
> 
> +  ASSERT_EFI_ERROR (Status);
> 
> +
> 
> +  if (Status != EFI_SUCCESS) {
> 
> +    DEBUG ((DEBUG_ERROR, "Failed to register SaIotrapSmiCallback!\n"));
> 
> +    ///
> 
> +    /// System will halt when failing to register required SMI handler
> 
> +    ///
> 
> +    CpuDeadLoop ();
> 
> +  }
> 
> +#endif
> 
> +  return EFI_SUCCESS;
> 
> +}
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .h
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .h
> new file mode 100644
> index 0000000000..c93f92305c
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .h
> @@ -0,0 +1,122 @@
> +/** @file
> 
> +  Header file for SA SMM Handler
> 
> +
> 
> +  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +**/
> 
> +#ifndef _SaLateInitSmm_H_
> 
> +#define _SaLateInitSmm_H_
> 
> +
> 
> +///
> 
> +/// Driver Consumed Protocol Prototypes
> 
> +///
> 
> +
> 
> +#include <Protocol/SmmBase2.h>
> 
> +#include <Protocol/SmmSxDispatch2.h>
> 
> +#include <Protocol/SmmIoTrapDispatch2.h>
> 
> +#include <Protocol/SaPolicy.h>
> 
> +#include <Library/S3BootScriptLib.h>
> 
> +#include <CpuPcieConfig.h>
> 
> +#include <Library/CpuPcieInfoFruLib.h>
> 
> +
> 
> +extern EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL        *mPchIoTrap;
> 
> +extern EFI_SMM_SX_DISPATCH2_PROTOCOL             *mSxDispatch;
> 
> +
> 
> +///
> 
> +/// The value before AutoConfig match the setting of PCI Express Base
> Specification 1.1, please be careful for adding new feature
> 
> +///
> 
> +typedef enum {
> 
> +  PcieAspmDisabled,
> 
> +  PcieAspmL0s,
> 
> +  PcieAspmL1,
> 
> +  PcieAspmL0sL1,
> 
> +  PcieAspmAutoConfig,
> 
> +  PcieAspmMax
> 
> +} CPU_PCIE_ASPM_CONFIG;
> 
> +
> 
> +typedef struct {
> 
> +  UINT64                    Address;
> 
> +  S3_BOOT_SCRIPT_LIB_WIDTH  Width;
> 
> +  UINT32                    Value;
> 
> +} BOOT_SCRIPT_PCI_REGISTER_SAVE;
> 
> +
> 
> +
> 
> +/**
> 
> +  <b>System Agent Initialization SMM Driver Entry Point</b>
> 
> +  - <b>Introduction</b> \n
> 
> +    This is an optional driver to support PCIe ASPM initialization later than
> Option ROM initialization.\n
> 
> +    In this scenario S3 Save Boot Script table has been closed per security
> consideration so the ASPM settings will be stored in SMM memory and
> restored during S3 resume.
> 
> +    If platform does not support this scenario this driver can be excluded and
> SI_SA_POLICY_PPI -> PCIE_CONFIG -> InitPcieAspmAfterOprom must be set
> to FALSE. \n
> 
> +    Note: When InitPcieAspmAfterOprom enabled, the SMI callback handler
> must be registered successfully, otherwise it will halt the system.
> 
> +
> 
> +  - @pre
> 
> +    - _EFI_SMM_BASE_PROTOCOL (or _EFI_SMM_BASE2_PROTOCOL for
> EDK2): Provides SMM infrastructure services.
> 
> +    - _EFI_SMM_IO_TRAP_DISPATCH_PROTOCOL (or
> _EFI_SMM_IO_TRAP_DISPATCH2_PROTOCOL for EDK2): Interface structure
> for the SMM IO trap specific SMI Dispatch Protocol
> 
> +    - SA_POLICY_PROTOCOL: A protocol published by a platform DXE module
> executed earlier; this is documented in this document as well.
> 
> +
> 
> +  - @result
> 
> +    PCIe ASPM has been initialized on all end point devices discovered and
> same settings will be restored during S3 resume.
> 
> +
> 
> +  @param[in] ImageHandle - The image handle of Wake On Lan driver
> 
> +  @param[in] SystemTable - The standard EFI system table
> 
> +
> 
> +  @retval EFI_SUCCESS    - SA SMM handler was installed or not necessary
> 
> +  @retval EFI_NOT_FOUND  - Fail to register SMI callback or required
> protocol/hob missing.
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +SaLateInitSmmEntryPoint (
> 
> +  IN EFI_HANDLE        ImageHandle,
> 
> +  IN EFI_SYSTEM_TABLE  *SystemTable
> 
> +  );
> 
> +
> 
> +/**
> 
> +An IoTrap callback to config PCIE power management settings
> 
> +
> 
> +@param[in] DispatchHandle  - The handle of this callback, obtained when
> registering
> 
> +@param[in] DispatchContext - Pointer to the
> EFI_SMM_IO_TRAP_DISPATCH_CALLBACK_CONTEXT
> 
> +
> 
> +**/
> 
> +VOID
> 
> +EFIAPI
> 
> +CpuPcieIoTrapSmiCallback(
> 
> +IN     EFI_HANDLE                     DispatchHandle,
> 
> +IN     EFI_SMM_IO_TRAP_CONTEXT        *CallbackContext,
> 
> +IN OUT VOID                           *CommBuffer,
> 
> +IN OUT UINTN                          *CommBufferSize
> 
> +);
> 
> +
> 
> +/**
> 
> +  This function is used to set or clear flags at S3 entry
> 
> +  Clear the Io trap executed flag before enter S3
> 
> +
> 
> +  @param[in] Handle              Handle of the callback
> 
> +  @param[in] Context             The dispatch context
> 
> +  @param[in,out] CommBuffer      A pointer to a collection of data in
> memory that will be conveyed from a non-SMM environment into an SMM
> environment.
> 
> +  @param[in,out] CommBufferSize  The size of the CommBuffer.
> 
> +  @retval EFI_SUCCESS            SA register saved
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +CpuPcieS3EntryCallBack (
> 
> +  IN  EFI_HANDLE                   Handle,
> 
> +  IN CONST VOID                    *Context OPTIONAL,
> 
> +  IN OUT VOID                      *CommBuffer OPTIONAL,
> 
> +  IN OUT UINTN                     *CommBufferSize OPTIONAL
> 
> +  );
> 
> +
> 
> +/**
> 
> +  Register PCIE Hotplug SMI dispatch function to handle Hotplug enabling
> 
> +
> 
> +  @param[in] ImageHandle          The image handle of this module
> 
> +  @param[in] SystemTable          The EFI System Table
> 
> +
> 
> +  @retval EFI_SUCCESS             The function completes successfully
> 
> +**/
> 
> +EFI_STATUS
> 
> +EFIAPI
> 
> +InitializeCpuPcieSmm (
> 
> +  IN      EFI_HANDLE            ImageHandle,
> 
> +  IN      EFI_SYSTEM_TABLE      *SystemTable
> 
> +  );
> 
> +#endif
> 
> diff --git
> a/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .inf
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .inf
> new file mode 100644
> index 0000000000..ef3486d2a6
> --- /dev/null
> +++
> b/Silicon/Intel/TigerlakeSiliconPkg/SystemAgent/SaInit/Smm/SaLateInitSmm
> .inf
> @@ -0,0 +1,72 @@
> +## @file
> 
> +# Component description file for the SA late initialization SMM module.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[Defines]
> 
> +INF_VERSION = 0x00010017
> 
> +BASE_NAME = SaLateInitSmm
> 
> +FILE_GUID = 2D1E361C-7B3F-4d15-8B1F-66E551FABDC7
> 
> +VERSION_STRING = 1.0
> 
> +MODULE_TYPE = DXE_SMM_DRIVER
> 
> +PI_SPECIFICATION_VERSION = 1.10
> 
> +ENTRY_POINT = SaLateInitSmmEntryPoint
> 
> +
> 
> +[LibraryClasses]
> 
> +UefiDriverEntryPoint
> 
> +UefiBootServicesTableLib
> 
> +DxeServicesTableLib
> 
> +DebugLib
> 
> +HobLib
> 
> +BaseLib
> 
> +S3BootScriptLib
> 
> +PciSegmentLib
> 
> +SaPlatformLib
> 
> +TimerLib
> 
> +PciExpressHelpersLib
> 
> +PcdLib
> 
> +S3BootScriptLib
> 
> +CpuPcieInfoFruLib
> 
> +ConfigBlockLib
> 
> +CpuPcieRpLib
> 
> +
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[Pcd]
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMax
> 
> +gSiPkgTokenSpaceGuid.PcdSiliconInitTempPciBusMin
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPcieEnable              ## CONSUMES
> 
> +
> 
> +
> 
> +[Sources]
> 
> +SaLateInitSmm.c
> 
> +CpuPcieSmm.c
> 
> +SaLateInitSmm.h
> 
> +
> 
> +[Protocols]
> 
> +gSaPolicyProtocolGuid              ## CONSUMES
> 
> +gEfiSmmIoTrapDispatch2ProtocolGuid ## CONSUMES
> 
> +gSaIotrapSmiProtocolGuid           ## PRODUCES
> 
> +gCpuPcieIoTrapProtocolGuid         ## PRODUCES
> 
> +gEfiSmmSxDispatch2ProtocolGuid     ## CONSUMES
> 
> +gPchSmiDispatchProtocolGuid        ## CONSUMES
> 
> +gPchPcieSmiDispatchProtocolGuid    ## CONSUMES
> 
> +
> 
> +[Guids]
> 
> +gSaConfigHobGuid
> 
> +gCpuPcieHobGuid
> 
> +gPcieDxeConfigGuid
> 
> +gSaPegHobGuid
> 
> +
> 
> +[Depex]
> 
> +gEfiSmmBase2ProtocolGuid AND
> 
> +gEfiSmmSxDispatch2ProtocolGuid AND
> 
> +gEfiSmmIoTrapDispatch2ProtocolGuid AND
> 
> +gSaPolicyProtocolGuid
> 
> +
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files
  2021-02-01  1:36 ` [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Reviewed-by: Nate DeSimone <nathaniel.l.desimone@intel.com>

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Adds the following DSC files:
>   * Fru/TglCpu
>   * Fru/TglPch
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc | 11
> +++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc       |  9 +++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc    | 20
> ++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc       |  8 ++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc    |  7 +++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc | 30
> ++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc       |  9 +++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc    | 13
> +++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc       |  8 ++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc    | 10 ++++++++++
>  10 files changed, 125 insertions(+)
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc
> new file mode 100644
> index 0000000000..99ee0eccac
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/CommonLib.dsc
> @@ -0,0 +1,11 @@
> +## @file
> 
> +#  Component description file for the TigerLake CPU Common FRU libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +VtdInfoLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/Library/PeiDxeSmmVt
> dInfoLib/PeiDxeSmmVtdInfoLib.inf
> 
> +CpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Library/PeiD
> xeSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
> 
> +CpuPcieInfoFruLib|$(PLATFORM_SI_PACKAGE)/Fru/TglCpu/CpuPcieRp/Libr
> ary/PeiDxeSmmCpuPcieInfoFruLib/PeiDxeSmmCpuPcieInfoFruLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc
> new file mode 100644
> index 0000000000..874e4cbaad
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Dxe.dsc
> @@ -0,0 +1,9 @@
> +## @file
> 
> +#  Component description file for the Tigerlake CPU DXE FRU drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc
> new file mode 100644
> index 0000000000..5c72c2ac61
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/DxeLib.dsc
> @@ -0,0 +1,20 @@
> +## @file
> 
> +#  Component description file for the Tigerlake CPU DXE FRU libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +DxeGraphicsPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/Librar
> yPrivate/DxeGraphicsPolicyLib/DxeGraphicsPolicyLib.inf
> 
> +DxeGraphicsInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/LibraryPr
> ivate/DxeGraphicsInitLib/DxeGraphicsInitLib.inf
> 
> +DxeIgdOpRegionInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/Libra
> ryPrivate/DxeIgdOpRegionInitLib/DxeIgdOpRegionInitLib.inf
> 
> +DxeVtdInitLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/Dxe
> VtdInitLib/DxeVtdInitLib.inf
> 
> +DxeVtdPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/D
> xeVtdPolicyLib/DxeVtdPolicyLib.inf
> 
> +DxeVtdInitFruLib|$(PLATFORM_SI_PACKAGE)/Fru/TglCpu/Vtd/LibraryPriva
> te/DxeVtdInitLib/DxeVtdInitFruLib.inf
> 
> +
> 
> +
> 
> +#
> 
> +#  CPU PCIe IpBlock
> 
> +#
> 
> +DxeCpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/LibraryP
> rivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc
> new file mode 100644
> index 0000000000..de8288364a
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/Pei.dsc
> @@ -0,0 +1,8 @@
> +## @file
> 
> +#  Component description file for the Tigerlake CPU PEI FRU drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc
> new file mode 100644
> index 0000000000..5355ecb288
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglCpu/PeiLib.dsc
> @@ -0,0 +1,7 @@
> +## @file
> 
> +#  Component description file for the Tigerlake CPU PEI FRU ibraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc
> new file mode 100644
> index 0000000000..b7ba1f752c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/CommonLib.dsc
> @@ -0,0 +1,30 @@
> +## @file
> 
> +#  Component description file for the Tigerlake PCH Common FRU libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> PsfLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Psf/LibraryPrivate/PsfLib/PeiDxe
> SmmPsfLibVer2.inf
> 
> +
> PchPcrLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/Library/PeiDxeSmmPch
> PcrLib/PeiDxeSmmPchPcrLib.inf
> 
> +
> PchSbiAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/LibraryPrivate/P
> eiDxeSmmPchSbiAccessLib/PeiDxeSmmPchSbiAccessLib.inf
> 
> +
> GbeMdiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gbe/LibraryPrivate/PeiDxe
> SmmGbeMdiLib/PeiDxeSmmGbeMdiLib.inf
> 
> +
> GbeLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gbe/Library/PeiDxeSmmGbeLi
> b/PeiDxeSmmGbeLib.inf
> 
> +
> EspiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Espi/Library/PeiDxeSmmEspiLib
> /PeiDxeSmmEspiLib.inf
> 
> +
> PmcLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/Library/PeiDxeSmmPmcLi
> b/PeiDxeSmmPmcLib.inf
> 
> +
> PmcPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/LibraryPrivate/PeiD
> xeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibVer2.inf
> 
> +
> PmcPrivateLibWithS3|$(PLATFORM_SI_PACKAGE)/IpBlock/Pmc/LibraryPriva
> te/PeiDxeSmmPmcPrivateLib/PeiDxeSmmPmcPrivateLibWithS3.inf
> 
> +
> SpiCommonLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/LibraryPrivate/Base
> SpiCommonLib/BaseSpiCommonLib.inf
> 
> +
> GpioLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/Library/PeiDxeSmmGpio
> Lib/PeiDxeSmmGpioLib.inf
> 
> +
> GpioPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/Pei
> DxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
> 
> +
> GpioCheckConflictLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/Library/Bas
> eGpioCheckConflictLib/BaseGpioCheckConflictLib.inf
> 
> +
> PchDmiLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PchDmi/LibraryPrivate/PeiD
> xeSmmPchDmiLib/PeiDxeSmmPchDmiLib.inf
> 
> +
> PchDmiWithS3Lib|$(PLATFORM_SI_PACKAGE)/IpBlock/PchDmi/LibraryPrivat
> e/PeiDxeSmmPchDmiLib/PeiDxeSmmPchDmiWithS3Lib.inf
> 
> +
> SataLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Sata/Library/PeiDxeSmmSataLi
> b/PeiDxeSmmSataLibVer2.inf
> 
> +
> SpiAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/Library/PeiDxeSmmSp
> iAccessLib/PeiDxeSmmSpiAccessLib.inf
> 
> +
> SpiAccessPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/LibraryPrivate/
> PeiDxeSmmSpiAccessPrivateLib/PeiDxeSmmSpiAccessPrivateLib.inf
> 
> +
> PchPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/Library/PeiDxeSm
> mPchPcieRpLib/PeiDxeSmmPchPcieRpLibVer2.inf
> 
> +
> PcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/PcieCli
> entRpLib/PcieClientRpLib.inf
> 
> +
> PciExpressHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPri
> vate/PciExpressHelpersLibrary/PeiDxeSmmPciExpressHelpersLib.inf
> 
> +
> BasePcieHelperLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/Library/Base
> PcieHelperLib/BasePcieHelperLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc
> new file mode 100644
> index 0000000000..9fefc6b4c9
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Dxe.dsc
> @@ -0,0 +1,9 @@
> +## @file
> 
> +#  Component description file for the Tigerlake PCH DXE FRU drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +$(PLATFORM_SI_PACKAGE)/IpBlock/Spi/Smm/SpiSmm.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc
> new file mode 100644
> index 0000000000..e9be448baa
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/DxeLib.dsc
> @@ -0,0 +1,13 @@
> +## @file
> 
> +#  Component description file for the Tigerlake PCH DXE FRU libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> DxeHdaNhltLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Hda/Library/DxeHdaNh
> ltLib/DxeHdaNhltLib.inf
> 
> +
> DxeHdaPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Hda/LibraryPrivate/Dx
> eHdaPolicyLib/DxeHdaPolicyLib.inf
> 
> +
> GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/Ba
> seGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
> 
> +
> GpioNameBufferLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivat
> e/DxeGpioNameBufferLib/DxeGpioNameBufferLib.inf
> 
> +
> DxeGpioPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/
> DxeGpioPolicyLib/DxeGpioPolicyLib.inf
> 
> +
> DxePchPcieRpPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryP
> rivate/DxePchPcieRpPolicyLib/DxePchPcieRpPolicyLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc
> new file mode 100644
> index 0000000000..2eacbe905c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/Pei.dsc
> @@ -0,0 +1,8 @@
> +## @file
> 
> +#  Component description file for the Tigerlake PCH PEI FRU drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc
> new file mode 100644
> index 0000000000..d8e6313084
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/Fru/TglPch/PeiLib.dsc
> @@ -0,0 +1,10 @@
> +## @file
> 
> +#  Component description file for the Tigerlake PCH PEI FRU libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +
> GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/Pe
> iGpioHelpersLib/PeiGpioHelpersLib.inf
> 
> +
> GpioNameBufferLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivat
> e/PeiGpioNameBufferLib/PeiGpioNameBufferLib.inf
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 39/40] TigerlakeSiliconPkg: Add package DSC files
  2021-02-01  1:36 ` [PATCH 39/40] TigerlakeSiliconPkg: Add package " Heng Luo
@ 2021-02-04  3:56   ` Nate DeSimone
  0 siblings, 0 replies; 81+ messages in thread
From: Nate DeSimone @ 2021-02-04  3:56 UTC (permalink / raw)
  To: Luo, Heng, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Hi Heng,

Please see comments inline.

Thanks,
Nate

> -----Original Message-----
> From: Luo, Heng <heng.luo@intel.com>
> Sent: Sunday, January 31, 2021 5:37 PM
> To: devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> Nathaniel L <nathaniel.l.desimone@intel.com>
> Subject: [PATCH 39/40] TigerlakeSiliconPkg: Add package DSC files
> 
> REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> 
> Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> Signed-off-by: Heng Luo <heng.luo@intel.com>
> ---
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc    | 122
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc      |  49
> +++++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc            |  47
> +++++++++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc         |  40
> ++++++++++++++++++++++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc            |  20
> ++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc         |  20
> ++++++++++++++++++++
>  Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc | 229
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  7 files changed, 527 insertions(+)
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc
> new file mode 100644
> index 0000000000..51c40812ea
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgBuildOption.dsc
> @@ -0,0 +1,122 @@
> +## @file
> 
> +#  Silicon build option configuration file.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +[BuildOptions]
> 
> +# Define Build Options both for EDK and EDKII drivers.
> 
> +
> 
> +  DEFINE PCH_BUILD_OPTIONS = -DPCH_TGL
> 
> +#
> 
> +# SA
> 
> +#
> 
> +!if gSiPkgTokenSpaceGuid.PcdBdatEnable == TRUE
> 
> +  DEFINE BDAT_BUILD_OPTION = -DBDAT_SUPPORT=1
> 
> +!else
> 
> +  DEFINE BDAT_BUILD_OPTION =
> 
> +!endif
> 
> +
> 
> +  DEFINE SLE_BUILD_OPTIONS =
> 
> +!if $(TARGET) == RELEASE
> 
> +!if gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable == TRUE
> 
> +  DEFINE DEBUG_BUILD_OPTIONS =
> 
> +!else
> 
> +  # MDEPKG_NDEBUG is introduced for the intention
> 
> +  # of size reduction when compiler optimization is disabled. If
> MDEPKG_NDEBUG is
> 
> +  # defined, then debug and assert related macros wrapped by it are the
> NULL implementations.
> 
> +  DEFINE DEBUG_BUILD_OPTIONS = -DMDEPKG_NDEBUG
> 
> +!endif
> 
> +!else
> 
> +  DEFINE DEBUG_BUILD_OPTIONS =
> 
> +!endif
> 
> +
> 
> +!if ($(TARGET) == RELEASE) AND
> (gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable == TRUE)
> 
> +  DEFINE RELEASE_CATALOG_BUILD_OPTIONS = -DRELEASE_CATALOG
> 
> +!else
> 
> +  DEFINE RELEASE_CATALOG_BUILD_OPTIONS =
> 
> +!endif
> 
> +
> 
> +!if gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable == FALSE
> 
> +  DEFINE OPTIMIZE_DISABLE_OPTIONS = -Od -GL-
> 
> +!else
> 
> +  DEFINE OPTIMIZE_DISABLE_OPTIONS =
> 
> +!endif
> 
> +
> 
> +  DEFINE HSLE_BUILD_OPTIONS =
> 
> +
> 
> +
> 
> +  DEFINE CPU_FLAGS = -DCPU_ICL -DCPU_TGL
> 
> +
> 
> +
> 
> +  DEFINE RESTRICTED_OPTION =
> 
> +
> 
> +!if gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported == FALSE
> 
> +  *_*_*_MRC_NDEBUG = -DMDEPKG_NDEBUG
> 
> +!endif
> 
> +
> 
> +DEFINE DSC_SIPKG_FEATURE_BUILD_OPTIONS = $(BDAT_BUILD_OPTION)
> $(DEBUG_BUILD_OPTIONS)
> 
> +DEFINE DSC_SIPKG_FEATURE_BUILD_OPTIONS =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(PCH_BUILD_OPTIONS)
> $(CPU_FLAGS) $(HSLE_BUILD_OPTIONS)
> 
> +
> 
> +!if gSiPkgTokenSpaceGuid.PcdSourceDebugEnable == TRUE
> 
> +  *_*_X64_GENFW_FLAGS = --keepexceptiontable
> 
> +!endif
> 
> +
> 
> +[BuildOptions.Common.EDKII]
> 
> +
> 
> +#
> 
> +# For IA32 Global Build Flag
> 
> +#
> 
> +       *_*_IA32_CC_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) -D
> PI_SPECIFICATION_VERSION=0x00010015 -DASF_PEI
> 
> +       *_*_IA32_VFRPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_IA32_APP_FLAGS     = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_IA32_ASLPP_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_IA32_ASLCC_FLAGS   = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +
> 
> +#
> 
> +# For IA32 Specific Build Flag
> 
> +#
> 
> +GCC:   *_*_IA32_PP_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +MSFT:  *_*_IA32_ASM_FLAGS     =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +MSFT:  *_*_IA32_CC_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> $(OPTIMIZE_DISABLE_OPTIONS) -D
> PI_SPECIFICATION_VERSION=0x00010015 -DASF_PEI /w34668
> 
> +MSFT:  *_*_IA32_VFRPP_FLAGS   =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +MSFT:  *_*_IA32_APP_FLAGS     =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +MSFT:  *_*_IA32_ASLPP_FLAGS   =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +MSFT:  *_*_IA32_ASLCC_FLAGS   =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +
> 
> +#
> 
> +# For X64 Global Build Flag
> 
> +#
> 
> +       *_*_X64_CC_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) -D
> PI_SPECIFICATION_VERSION=0x00010015
> 
> +       *_*_X64_VFRPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_X64_APP_FLAGS      = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_X64_ASLPP_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +       *_*_X64_ASLCC_FLAGS    = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +
> 
> +#
> 
> +# For X64 Specific Build Flag
> 
> +#
> 
> +GCC:   *_*_X64_PP_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +MSFT:  *_*_X64_ASM_FLAGS      =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +MSFT:  *_*_X64_CC_FLAGS       = $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> $(OPTIMIZE_DISABLE_OPTIONS) -D
> PI_SPECIFICATION_VERSION=0x00010015 /w34668
> 
> +MSFT:  *_*_X64_VFRPP_FLAGS    =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +MSFT:  *_*_X64_APP_FLAGS      =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS) $(OPTIMIZE_DISABLE_OPTIONS)
> 
> +MSFT:  *_*_X64_ASLPP_FLAGS    =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +MSFT:  *_*_X64_ASLCC_FLAGS    =
> $(DSC_SIPKG_FEATURE_BUILD_OPTIONS)
> 
> +
> 
> +#
> 
> +# For Xcode Specific Build Flag
> 
> +#
> 
> +# Override assembly code build order
> 
> +*_XCODE5_*_*_BUILDRULEORDER = nasm S s
> 
> +# Align 47bfbd7f8069e523798ef973c8eb0abd5c6b0746 to fix the usage of
> VA_START in undefined way
> 
> +*_XCODE5_*_CC_FLAGS = -Wno-varargs
> 
> +
> 
> +# Force PE/COFF sections to be aligned at 4KB boundaries to support page
> level protection of runtime modules
> 
> +[BuildOptions.common.EDKII.DXE_RUNTIME_DRIVER]
> 
> +  MSFT:  *_*_*_DLINK_FLAGS      = /ALIGN:4096
> 
> +  GCC:   *_GCC*_*_DLINK_FLAGS   = -z common-page-size=0x1000
> 
> +
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc
> new file mode 100644
> index 0000000000..d93ecfc9d6
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgCommonLib.dsc
> @@ -0,0 +1,49 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package both Pei and
> Dxe libraries DSC file.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +#
> 
> +# Set PCH generation according PCD.
> 
> +# The DEFINE will be used to select PCH library INF file corresponding to PCH
> generation
> 
> +#
> 
> +DEFINE  PCH = Cnl

This define is not used. Please delete it.

> 
> +
> 
> +#
> 
> +# FRUs
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/CommonLib.dsc
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/CommonLib.dsc
> 
> +
> 
> +#
> 
> +# Common
> 
> +#
> 
> +
> MmPciLib|$(PLATFORM_SI_PACKAGE)/Library/PeiDxeSmmMmPciLib/PeiDx
> eSmmMmPciLib.inf
> 
> +
> PciSegmentLib|$(PLATFORM_SI_PACKAGE)/Library/BasePciSegmentMultiSe
> gLibPci/BasePciSegmentMultiSegLibPci.inf
> 
> +
> 
> +#
> 
> +# Pch
> 
> +#
> 
> +
> PchCycleDecodingLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/PeiDxeSmmP
> chCycleDecodingLib/PeiDxeSmmPchCycleDecodingLib.inf
> 
> +
> PchInfoLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/PeiDxeSmmPchInfoLib/
> PeiDxeSmmPchInfoLibTgl.inf
> 
> +
> CpuPcieInitCommonLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Libr
> ary/PeiDxeSmmCpuPcieInitCommonLib/PeiDxeSmmCpuPcieInitCommonLib.i
> nf
> 
> +
> CpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/Library/PeiDx
> eSmmCpuPcieRpLib/PeiDxeSmmCpuPcieRpLib.inf
> 
> +
> 
> +
> SerialIoAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/SerialIo/Library/PeiDx
> eSmmSerialIoAccessLib/PeiDxeSmmSerialIoAccessLib.inf
> 
> +
> SerialIoPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/SerialIo/LibraryPrivat
> e/PeiDxeSmmSerialIoPrivateLib/PeiDxeSmmSerialIoPrivateLibVer2.inf
> 
> +
> ResetSystemLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/BaseResetSystem
> Lib/BaseResetSystemLib.inf
> 
> + #private
> 
> +
> GpioPrivateLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/Pei
> DxeSmmGpioPrivateLib/PeiDxeSmmGpioPrivateLibVer2.inf
> 
> +
> 
> +
> SiScheduleResetLib|$(PLATFORM_SI_PACKAGE)/Pch/LibraryPrivate/BaseSiS
> cheduleResetLib/BaseSiScheduleResetLib.inf
> 
> +
> PchPciBdfLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/BasePchPciBdfLib/Bas
> ePchPciBdfLib.inf
> 
> +
> PcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/PcieRp/LibraryPrivate/PcieCli
> entRpLib/PcieClientRpLib.inf
> 
> +
> 
> +#
> 
> +# SA
> 
> +#
> 
> +
> SaPlatformLib|$(PLATFORM_SI_PACKAGE)/SystemAgent/Library/PeiDxeSm
> mSaPlatformLib/PeiDxeSmmSaPlatformLib.inf
> 
> +
> CpuRegbarAccessLib|$(PLATFORM_SI_PACKAGE)/IpBlock/P2sb/Library/PeiD
> xeSmmCpuRegbarAccessLib/PeiDxeSmmCpuRegbarAccessLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc
> new file mode 100644
> index 0000000000..1a08fbc24c
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxe.dsc
> @@ -0,0 +1,47 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package DXE drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +#
> 
> +# FRUs
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/Dxe.dsc
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/Dxe.dsc
> 
> +
> 
> +#
> 
> +# Common
> 
> +#
> 
> +
> 
> +#
> 
> +# Pch
> 
> +#
> 
> +  $(PLATFORM_SI_PACKAGE)/Pch/PchInit/Dxe/PchInitDxeTgl.inf
> 
> +
> $(PLATFORM_SI_PACKAGE)/Pch/SmmControl/RuntimeDxe/SmmControl.inf
> 
> +
> 
> +
> $(PLATFORM_SI_PACKAGE)/Pch/PchSmiDispatcher/Smm/PchSmiDispatcher.
> inf{
> 
> +    <LibraryClasses>
> 
> +
> #SmiHandlerProfileLib|MdeModulePkg/Library/SmmSmiHandlerProfileLib/S
> mmSmiHandlerProfileLib.inf
> 
> +
> SmiHandlerProfileLib|MdePkg/Library/SmiHandlerProfileLibNull/SmiHandler
> ProfileLibNull.inf
> 
> +  }
> 
> +  $(PLATFORM_SI_PACKAGE)/Pch/PchInit/Smm/PchInitSmm.inf
> 
> +
> 
> +#
> 
> +# SystemAgent
> 
> +#
> 
> +
> 
> +  $(PLATFORM_SI_PACKAGE)/SystemAgent/SaInit/Dxe/SaInitDxe.inf
> 
> +
> 
> +  $(PLATFORM_SI_PACKAGE)/SystemAgent/SaInit/Smm/SaLateInitSmm.inf
> {
> 
> +    <LibraryClasses>
> 
> +
> S3BootScriptLib|MdePkg/Library/BaseS3BootScriptLibNull/BaseS3BootScriptL
> ibNull.inf
> 
> +  }
> 
> +
> 
> +!if gSiPkgTokenSpaceGuid.PcdAcpiEnable == TRUE
> 
> +  $(PLATFORM_SI_PACKAGE)/SystemAgent/AcpiTables/SaSsdt/SaSsdt.inf
> 
> +  $(PLATFORM_SI_PACKAGE)/IpBlock/Graphics/AcpiTables/IgfxSsdt.inf
> 
> +!endif
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc
> new file mode 100644
> index 0000000000..210fb37332
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgDxeLib.dsc
> @@ -0,0 +1,40 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package DXE libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +#
> 
> +# Silicon Init Dxe Library
> 
> +#
> 
> +
> 
> +#
> 
> +# FRUs
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/DxeLib.dsc
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/DxeLib.dsc
> 
> +
> 
> +#
> 
> +# Common
> 
> +#
> 
> +SiConfigBlockLib|$(PLATFORM_SI_PACKAGE)/Library/BaseSiConfigBlockLib/
> BaseSiConfigBlockLib.inf
> 
> +
> 
> +#
> 
> +# Pch
> 
> +#
> 
> +DxePchPolicyLib|$(PLATFORM_SI_PACKAGE)/Pch/Library/DxePchPolicyLib/
> DxePchPolicyLib.inf
> 
> +SmmPchPrivateLib|$(PLATFORM_SI_PACKAGE)/Pch/LibraryPrivate/SmmPc
> hPrivateLib/SmmPchPrivateLib.inf
> 
> +
> 
> +#
> 
> +# SystemAgent
> 
> +#
> 
> +DxeSaPolicyLib|$(PLATFORM_SI_PACKAGE)/SystemAgent/Library/DxeSaP
> olicyLib/DxeSaPolicyLib.inf
> 
> +DxeVtdPolicyLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Vtd/LibraryPrivate/D
> xeVtdPolicyLib/DxeVtdPolicyLib.inf
> 
> +
> 
> +#
> 
> +#  CPU PCIe IpBlock
> 
> +#
> 
> +
> 
> +DxeCpuPcieRpLib|$(PLATFORM_SI_PACKAGE)/IpBlock/CpuPcieRp/LibraryP
> rivate/DxeCpuPcieRpLib/DxeCpuPcieRpLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc
> new file mode 100644
> index 0000000000..15fc5685a5
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPei.dsc
> @@ -0,0 +1,20 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package PEI drivers.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +#
> 
> +# Common
> 
> +#
> 
> +
> 
> +#
> 
> +# SystemAgent
> 
> +#
> 
> +
> 
> +#
> 
> +# Cpu
> 
> +#
> 
> +
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc
> new file mode 100644
> index 0000000000..6f90ff02bb
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/SiPkgPeiLib.dsc
> @@ -0,0 +1,20 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package PEI libraries.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +
> 
> +#
> 
> +# Silicon Init Pei Library
> 
> +#
> 
> +
> 
> +#
> 
> +# FRUs
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglCpu/PeiLib.dsc
> 
> +
> 
> +!include $(PLATFORM_SI_PACKAGE)/Fru/TglPch/PeiLib.dsc
> 
> +
> 
> +
> SiConfigBlockLib|$(PLATFORM_SI_PACKAGE)/Library/BaseSiConfigBlockLib/B
> aseSiConfigBlockLib.inf
> 
> diff --git a/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc
> b/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc
> new file mode 100644
> index 0000000000..73a2594887
> --- /dev/null
> +++ b/Silicon/Intel/TigerlakeSiliconPkg/TigerlakeSiliconPkg.dsc
> @@ -0,0 +1,229 @@
> +## @file
> 
> +#  Component description file for the TigerLake silicon package DSC file.
> 
> +#
> 
> +#  Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
> 
> +#  SPDX-License-Identifier: BSD-2-Clause-Patent
> 
> +#
> 
> +##
> 
> +[Packages]
> 
> +MdePkg/MdePkg.dec
> 
> +UefiCpuPkg/UefiCpuPkg.dec
> 
> +TigerlakeSiliconPkg/SiPkg.dec
> 
> +
> 
> +[PcdsFixedAtBuild]
> 
> +gSiPkgTokenSpaceGuid.PcdSmmVariableEnable            |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdAtaEnable                    |FALSE
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdAcpiEnable                   |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdSourceDebugEnable            |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdPpmEnable                    |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdPttEnable                    |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdJhiEnable                    |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdSmbiosEnable                 |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdS3Enable                     |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdOverclockEnable              |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPowerOnConfigEnable       |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdBdatEnable                   |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdIgdEnable                    |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdPegEnable                    |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdSaDmiEnable                  |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdVtdEnable                    |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdBiosGuardEnable              |FALSE
> #BiosGuardModule.bin
> 
> +gSiPkgTokenSpaceGuid.PcdOptimizeCompilerEnable       |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdPeiDisplayEnable             |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdSiCatalogDebugEnable         |FALSE
> 
> +gSiPkgTokenSpaceGuid.PcdMrcTraceMessageSupported     |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdOcWdtEnable                  |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdSerialIoUartEnable           |TRUE
> 
> +
> 
> +gSiPkgTokenSpaceGuid.PcdThcEnable                    |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdPpamEnable                   |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdEmbeddedEnable               |0x0
> 
> +gSiPkgTokenSpaceGuid.PcdCpuPcieEnable                |TRUE
> 
> +gSiPkgTokenSpaceGuid.PcdHybridStorageSupport         |TRUE
> 
> +
> 
> +!if gSiPkgTokenSpaceGuid.PcdPpamEnable == TRUE
> 
> +#
> 
> +# PCD for State Save Support on DGR
> 
> +# TRUE - SMM State Save region access is protected
> 
> +# FALSE - SMM can have Read/Write access to SMM State Save region
> 
> +#
> 
> +gSiPkgTokenSpaceGuid.PcdSpsStateSaveEnable           |FALSE
> 
> +#
> 
> +# PCD to enable SPA Support on DGR
> 
> +# Note: This PCD is mainly used for Debugging purpose. Not recommended
> to set for End Product.
> 
> +#
> 
> +gSiPkgTokenSpaceGuid.PcdSpaEnable                    |FALSE
> 
> +!endif
> 
> +
> 
> +[PcdsFixedAtBuild.common]
> 
> +gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress       |0xC0000000
> 
> +gSiPkgTokenSpaceGuid.PcdSiPciExpressBaseAddress
> |gEfiMdePkgTokenSpaceGuid.PcdPciExpressBaseAddress
> 
> +gSiPkgTokenSpaceGuid.PcdTemporaryPciExpressRegionLength
> |0x10000000
> 
> +
> 
> +[PcdsDynamicDefault.common]
> 
> +gSiPkgTokenSpaceGuid.PcdPciExpressRegionLength          |0x10000000
> 
> +## Specifies the AP wait loop state during POST phase.
> 
> +#  The value is defined as below.
> 
> +#  1: Place AP in the Hlt-Loop state.
> 
> +#  2: Place AP in the Mwait-Loop state.
> 
> +#  3: Place AP in the Run-Loop state.
> 
> +# @Prompt The AP wait loop state.
> 
> +gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode|2
> 
> +## Specifies the AP target C-state for Mwait during POST phase.
> 
> +#  The default value 0 means C1 state.
> 
> +#  The value is defined as below.<BR><BR>
> 
> +# @Prompt The specified AP target C-state for Mwait.
> 
> +gUefiCpuPkgTokenSpaceGuid.PcdCpuApTargetCstate|0
> 
> +
> 
> +[Defines]
> 
> +  PLATFORM_NAME = TigerlakeSiliconPkg
> 
> +  PLATFORM_GUID = CCD38CA7-61D3-4185-9CDA-A9FDF209CB31
> 
> +  PLATFORM_VERSION = 0.4
> 
> +  DSC_SPECIFICATION = 0x00010005
> 
> +  OUTPUT_DIRECTORY = Build/TigerlakeSiliconPkg
> 
> +  SUPPORTED_ARCHITECTURES = IA32|X64
> 
> +  BUILD_TARGETS = DEBUG|RELEASE
> 
> +  SKUID_IDENTIFIER = DEFAULT
> 
> +
> 
> +  DEFINE   PLATFORM_SI_PACKAGE        = TigerlakeSiliconPkg
> 
> +  #
> 
> +  # Definition for Build Flag
> 
> +  #
> 
> +  !include $(PLATFORM_SI_PACKAGE)/SiPkgBuildOption.dsc
> 
> +
> 
> +[LibraryClasses.common]
> 
> +  #
> 
> +  # Entry point
> 
> +  #
> 
> +
> PeiCoreEntryPoint|MdePkg/Library/PeiCoreEntryPoint/PeiCoreEntryPoint.in
> f
> 
> +  PeimEntryPoint|MdePkg/Library/PeimEntryPoint/PeimEntryPoint.inf
> 
> +
> DxeCoreEntryPoint|MdePkg/Library/DxeCoreEntryPoint/DxeCoreEntryPoint
> .inf
> 
> +
> UefiDriverEntryPoint|MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntry
> Point.inf
> 
> +
> UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiA
> pplicationEntryPoint.inf
> 
> +
> PeCoffExtraActionLib|MdePkg/Library/BasePeCoffExtraActionLibNull/BaseP
> eCoffExtraActionLibNull.inf
> 
> +
> 
> +  #
> 
> +  # Basic
> 
> +  #
> 
> +  BaseLib|MdePkg/Library/BaseLib/BaseLib.inf
> 
> +
> BaseMemoryLib|MdePkg/Library/BaseMemoryLibRepStr/BaseMemoryLibR
> epStr.inf
> 
> +  PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf
> 
> +  CpuLib|MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
> 
> +  IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
> 
> +
> PciSegmentLib|$(PLATFORM_SI_PACKAGE)/Library/BasePciSegmentMultiSe
> gLibPci/BasePciSegmentMultiSegLibPci.inf
> 
> +  PciLib|MdePkg/Library/BasePciLibPciExpress/BasePciLibPciExpress.inf
> 
> +  PciCf8Lib|MdePkg/Library/BasePciCf8Lib/BasePciCf8Lib.inf
> 
> +
> CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCac
> heMaintenanceLib.inf
> 
> +  PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
> 
> +
> PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/Base
> PeCoffGetEntryPointLib.inf
> 
> +  PciExpressLib|MdePkg/Library/BasePciExpressLib/BasePciExpressLib.inf
> 
> +
> PostCodeLib|MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort
> 80.inf
> 
> +
> 
> +  #
> 
> +  # UEFI & PI
> 
> +  #
> 
> +
> UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBo
> otServicesTableLib.inf
> 
> +
> UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib
> /UefiRuntimeServicesTableLib.inf
> 
> +  UefiRuntimeLib|MdePkg/Library/UefiRuntimeLib/UefiRuntimeLib.inf
> 
> +  UefiLib|MdePkg/Library/UefiLib/UefiLib.inf
> 
> +  DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
> 
> +
> PeiServicesTablePointerLib|MdePkg/Library/PeiServicesTablePointerLibIdt/P
> eiServicesTablePointerLibIdt.inf
> 
> +  PeiServicesLib|MdePkg/Library/PeiServicesLib/PeiServicesLib.inf
> 
> +  DxeServicesLib|MdePkg/Library/DxeServicesLib/DxeServicesLib.inf
> 
> +
> DxeServicesTableLib|MdePkg/Library/DxeServicesTableLib/DxeServicesTabl
> eLib.inf
> 
> +
> 
> +
> S3BootScriptLib|MdePkg/Library/BaseS3BootScriptLibNull/BaseS3BootScriptL
> ibNull.inf
> 
> +  S3IoLib|MdePkg/Library/BaseS3IoLib/BaseS3IoLib.inf
> 
> +  S3PciLib|MdePkg/Library/BaseS3PciLib/BaseS3PciLib.inf
> 
> +
> 
> +  UefiUsbLib|MdePkg/Library/UefiUsbLib/UefiUsbLib.inf
> 
> +  UefiScsiLib|MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
> 
> +
> SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchroniz
> ationLib.inf
> 
> +
> 
> +
> DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/Bas
> eDebugPrintErrorLevelLib.inf
> 
> +
> 
> +  #
> 
> +  # Misc
> 
> +  #
> 
> +  DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
> 
> +
> PerformanceLib|MdePkg/Library/BasePerformanceLibNull/BasePerformanc
> eLibNull.inf
> 
> +  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
> 
> +
> TimerLib|MdePkg/Library/BaseTimerLibNullTemplate/BaseTimerLibNullTem
> plate.inf
> 
> +
> ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseR
> eportStatusCodeLibNull.inf
> 
> +  MtrrLib|UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
> 
> +  RngLib|MdePkg/Library/BaseRngLib/BaseRngLib.inf
> 
> +
> 
> +#########################################################
> ############################################
> 
> +
> 
> +#
> 
> +# Silicon Init Common Library
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/SiPkgCommonLib.dsc
> 
> +ConfigBlockLib|IntelSiliconPkg/Library/BaseConfigBlockLib/BaseConfigBlock
> Lib.inf
> 
> +
> 
> +[LibraryClasses.IA32]
> 
> +#
> 
> +# PEI phase common
> 
> +#
> 
> +  PcdLib|MdePkg/Library/PeiPcdLib/PeiPcdLib.inf
> 
> +  HobLib|MdePkg/Library/PeiHobLib/PeiHobLib.inf
> 
> +
> MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemory
> AllocationLib.inf
> 
> +
> ExtractGuidedSectionLib|MdePkg/Library/PeiExtractGuidedSectionLib/PeiEx
> tractGuidedSectionLib.inf
> 
> +
> PeiGetVtdPmrAlignmentLib|IntelSiliconPkg/Library/PeiGetVtdPmrAlignment
> Lib/PeiGetVtdPmrAlignmentLib.inf
> 
> +
> 
> +#########################################################
> ##########################################################
> ##################
> 
> +
> 
> +#
> 
> +# Silicon Init Pei Library
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/SiPkgPeiLib.dsc
> 
> +
> 
> +[LibraryClasses.IA32.SEC]
> 
> +
> GpioHelpersLib|$(PLATFORM_SI_PACKAGE)/IpBlock/Gpio/LibraryPrivate/Ba
> seGpioHelpersLibNull/BaseGpioHelpersLibNull.inf
> 
> +
> 
> +[LibraryClasses.X64]
> 
> + #
> 
> + # DXE phase common
> 
> + #
> 
> +  HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
> 
> +  PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf
> 
> +
> MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemo
> ryAllocationLib.inf
> 
> +
> ExtractGuidedSectionLib|MdePkg/Library/DxeExtractGuidedSectionLib/DxeE
> xtractGuidedSectionLib.inf
> 
> +
> 
> +#
> 
> +# Hsti
> 
> +#
> 
> +  HstiLib|MdePkg/Library/DxeHstiLib/DxeHstiLib.inf
> 
> +
> 
> +#########################################################
> ##########################################
> 
> +#
> 
> +# Silicon Init Dxe Library
> 
> +#
> 
> +!include $(PLATFORM_SI_PACKAGE)/SiPkgDxeLib.dsc
> 
> +
> 
> +[LibraryClasses.X64.PEIM]
> 
> +
> 
> +[LibraryClasses.X64.DXE_CORE]
> 
> +  HobLib|MdePkg/Library/DxeCoreHobLib/DxeCoreHobLib.inf
> 
> +  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
> 
> +
> 
> +[LibraryClasses.X64.DXE_SMM_DRIVER]
> 
> +
> SmmServicesTableLib|MdePkg/Library/SmmServicesTableLib/SmmServicesT
> ableLib.inf
> 
> +
> MemoryAllocationLib|MdePkg/Library/SmmMemoryAllocationLib/SmmMe
> moryAllocationLib.inf
> 
> +  SmmIoLib|MdePkg/Library/SmmIoLib/SmmIoLib.inf
> 
> +  SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
> 
> +
> 
> +[LibraryClasses.X64.SMM_CORE]
> 
> +
> 
> +[LibraryClasses.X64.UEFI_DRIVER]
> 
> +  PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
> 
> +
> 
> +[LibraryClasses.X64.UEFI_APPLICATION]
> 
> +  PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf
> 
> +
> 
> +[Components.IA32]
> 
> +!include $(PLATFORM_SI_PACKAGE)/SiPkgPei.dsc
> 
> +
> 
> +[Components.X64]
> 
> +!include $(PLATFORM_SI_PACKAGE)/SiPkgDxe.dsc
> 
> --
> 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

* Re: [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers
  2021-02-04  3:51   ` Nate DeSimone
@ 2021-02-04  8:24     ` Heng Luo
  0 siblings, 0 replies; 81+ messages in thread
From: Heng Luo @ 2021-02-04  8:24 UTC (permalink / raw)
  To: Desimone, Nathaniel L, devel@edk2.groups.io; +Cc: Chaganty, Rangasai V

Thank Nate, I will send out Patch V2 following you comments.

> -----Original Message-----
> From: Desimone, Nathaniel L <nathaniel.l.desimone@intel.com>
> Sent: Thursday, February 4, 2021 11:51 AM
> To: Luo, Heng <heng.luo@intel.com>; devel@edk2.groups.io
> Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>
> Subject: RE: [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers
> 
> Hi Heng,
> 
> Thank you so much for all your work on this! I have a couple of minor comments,
> however due to the size of this patch series I produced a summary of these
> comments here for your convenience:
> 
> [PATCH 01/40]
> 
> #1) CpuPcieConfigGen3.h is only used on Rocket Lake boards for backwards
> socket compatibility with Comet Lake. It is not needed for Tiger Lake. Please
> remove it.
> #2) CpuPcieConfig.h - CPU_PCIE_CONFIG Is missing the following from its
> definition:
> 
> CPU_PCIE_ROOT_PORT_CONFIG2
> RootPort2[CPU_PCIE_MAX_ROOT_PORTS];
> PCIE_COMMON_CONFIG2                PcieCommonConfig2;
> 
> [PATCH 02/40]
> 
> #1) FspmArchConfigPpi.h is a duplicate of a header file in IntelFsp2Pkg, please
> remove this duplicate
> #2) SiPolicy.h - Please also remove the #include for CpuPcieConfigGen3.h
> 
> [PATCH 34/40]
> 
> #1) DxeSaPolicyLib.c - There is an old comment that is no longer relevant, please
> delete.
> #2) DxeSaPolicyLibrary.h - Please also remove the #include for
> CpuPcieConfigGen3.h
> 
> [PATCH 35/40]
> 
> #1) DxeVtdInitFruLib.c - Comment on line 2 has a typo "Flu" should be "FRU"
> 
> [PATCH 36/40]
> 
> #1) PchSmiHelper.h - Comment on line 2 has a typo: "eSPI SMI Dispatch header"
> should be "PCH SMI Helper Header"
> 
> [PATCH 39/40]
> 
> #1) SiPkgCommonLib.dsc - The DEFINE  PCH = Cnl is unused, please delete it.
> 
> Thanks,
> Nate
> 
> > -----Original Message-----
> > From: Luo, Heng <heng.luo@intel.com>
> > Sent: Sunday, January 31, 2021 5:37 PM
> > To: devel@edk2.groups.io
> > Cc: Chaganty, Rangasai V <rangasai.v.chaganty@intel.com>; Desimone,
> > Nathaniel L <nathaniel.l.desimone@intel.com>
> > Subject: [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg
> > maintainers
> >
> > REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3171
> >
> > Cc: Sai Chaganty <rangasai.v.chaganty@intel.com>
> > Cc: Nate DeSimone <nathaniel.l.desimone@intel.com>
> > Signed-off-by: Heng Luo <heng.luo@intel.com>
> > ---
> >  Maintainers.txt | 6 ++++++
> >  1 file changed, 6 insertions(+)
> >
> > diff --git a/Maintainers.txt b/Maintainers.txt index
> > 56e16fc48c..34f0b58581
> > 100644
> > --- a/Maintainers.txt
> > +++ b/Maintainers.txt
> > @@ -242,6 +242,12 @@ F: Silicon/Intel/KabylakeSiliconPkg/
> >  M: Chasel Chiu <chasel.chiu@intel.com> M: Sai Chaganty
> > <rangasai.v.chaganty@intel.com> +Silicon/Intel/TigerlakeSiliconPkg+F:
> > Silicon/Intel/TigerlakeSiliconPkg/+M: Sai Chaganty
> > <rangasai.v.chaganty@intel.com>+M: Nate DeSimone
> > <nathaniel.l.desimone@intel.com>+R: Heng Luo <heng.luo@intel.com>+
> > Silicon/Intel/SimicsX58SktPkg F: Silicon/Intel/SimicsX58SktPkg/ M:
> > Agyeman Prince <prince.agyeman@intel.com>--
> > 2.24.0.windows.2


^ permalink raw reply	[flat|nested] 81+ messages in thread

end of thread, other threads:[~2021-02-04  8:24 UTC | newest]

Thread overview: 81+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-02-01  1:36 [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Heng Luo
2021-02-01  1:36 ` [PATCH 02/40] TigerlakeSiliconPkg/Include: Add Library, PPI and Protocol include headers Heng Luo
2021-02-04  3:51   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 03/40] TigerlakeSiliconPkg/Include: Add Pins, Register and other " Heng Luo
2021-02-04  3:52   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 04/40] TigerlakeSiliconPkg/Cpu: Add Include headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 05/40] TigerlakeSiliconPkg/Pch: Add include headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 06/40] TigerlakeSiliconPkg/Pch: Add IncludePrivate headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 07/40] TigerlakeSiliconPkg/SystemAgent: Add include headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 08/40] TigerlakeSiliconPkg/SystemAgent: Add IncludePrivate headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 09/40] TigerlakeSiliconPkg/Fru: Add TglCpu/Include headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 10/40] TigerlakeSiliconPkg/Fru: Add TglCpu/IncludePrivate headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 11/40] TigerlakeSiliconPkg/Fru: Add TglPch/Include headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 12/40] TigerlakeSiliconPkg/Fru: Add TglPch/IncludePrivate headers Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 13/40] TigerlakeSiliconPkg/IpBlock: Add Cnvi component Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 14/40] TigerlakeSiliconPkg/IpBlock: Add CpuPcieRp component Heng Luo
2021-02-04  3:53   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 15/40] TigerlakeSiliconPkg/IpBlock: Add Espi component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 16/40] TigerlakeSiliconPkg/IpBlock: Add Gbe component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 17/40] TigerlakeSiliconPkg/IpBlock: Add Gpio component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 18/40] TigerlakeSiliconPkg/IpBlock: Add Graphics component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 19/40] TigerlakeSiliconPkg/IpBlock: Add Hda component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 20/40] TigerlakeSiliconPkg/IpBlock: Add HostBridge component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 21/40] TigerlakeSiliconPkg/IpBlock: Add P2sb component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 22/40] TigerlakeSiliconPkg/IpBlock: Add PchDmi component Heng Luo
2021-02-04  3:54   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 23/40] TigerlakeSiliconPkg/IpBlock: Add PcieRp component Heng Luo
2021-02-04  3:55   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 24/40] TigerlakeSiliconPkg/IpBlock: Add Pmc component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 25/40] TigerlakeSiliconPkg/IpBlock: Add Psf component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 26/40] TigerlakeSiliconPkg/IpBlock: Add Sata component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 27/40] TigerlakeSiliconPkg/IpBlock: Add SerialIo component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 28/40] TigerlakeSiliconPkg/IpBlock: Add Smbus component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 29/40] TigerlakeSiliconPkg/IpBlock: Add Spi component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 30/40] TigerlakeSiliconPkg/IpBlock: Add Vtd component Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 31/40] TigerlakeSiliconPkg/Library: Add package common library instances Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 32/40] TigerlakeSiliconPkg/Pch: Add Pch " Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 33/40] TigerlakeSiliconPkg/Pch: Add Pch private " Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 34/40] TigerlakeSiliconPkg/SystemAgent: Add Acpi Tables and " Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 35/40] TigerlakeSiliconPkg/Fru/TglCpu: Add CpuPcieRp and Vtd " Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 36/40] TigerlakeSiliconPkg/Pch: Add Pch modules Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 37/40] TigerlakeSiliconPkg/SystemAgent: Add SystemAgent modules Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 38/40] TigerlakeSiliconPkg/Fru: Add Fru DSC files Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 39/40] TigerlakeSiliconPkg: Add package " Heng Luo
2021-02-04  3:56   ` Nate DeSimone
2021-02-01  1:36 ` [PATCH 40/40] Maintainers.txt: Add TigerlakeSiliconPkg maintainers Heng Luo
2021-02-04  3:51   ` Nate DeSimone
2021-02-04  8:24     ` Heng Luo
2021-02-04  3:51 ` [PATCH 01/40] TigerlakeSiliconPkg: Add package and Include/ConfigBlock headers Nate DeSimone

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox