* [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
@ 2019-07-25 14:45 Javeed, Ashraf
0 siblings, 0 replies; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-25 14:45 UTC (permalink / raw)
To: devel; +Cc: Michael D Kinney, Liming Gao, Ray Ni
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
In V2: Correction made to header sections of source files
New interface added to PCI Platform Protocol / PCI Override Protocol to
retrieve device-specific platform policy for the following PCI standard
features, like Maximum Payload Size (MPS), Maximum Read Request Size
(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power Management
(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
Configuration, Extended SYNCH, PTM support, and Completion Timeout (CTO).
New source files added with enhanced definitions are in:
MdePkg/Include/Protocol/PciPlatform2.h,
MdePkg/Include/Protocol/PciOverride2.h
Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
---
MdePkg/Include/Protocol/PciOverride2.h | 3 ---
MdePkg/Include/Protocol/PciPlatform2.h | 5 +----
2 files changed, 1 insertion(+), 7 deletions(-)
diff --git a/MdePkg/Include/Protocol/PciOverride2.h b/MdePkg/Include/Protocol/PciOverride2.h
index cf452d9f8f..a7f541b4c3 100644
--- a/MdePkg/Include/Protocol/PciOverride2.h
+++ b/MdePkg/Include/Protocol/PciOverride2.h
@@ -13,9 +13,6 @@
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
- @par Revision Reference:
- This Protocol is defined in UEFI Platform Initialization Specification 1.2
- Volume 5: Standards
**/
diff --git a/MdePkg/Include/Protocol/PciPlatform2.h b/MdePkg/Include/Protocol/PciPlatform2.h
index 3ff41b7754..717938e68d 100644
--- a/MdePkg/Include/Protocol/PciPlatform2.h
+++ b/MdePkg/Include/Protocol/PciPlatform2.h
@@ -4,7 +4,7 @@
driver to describe the unique features of a platform.
This protocol is optional.
-Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at
@@ -13,9 +13,6 @@ http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
- @par Revision Reference:
- This Protocol is defined in UEFI Platform Initialization Specification 1.2
- Volume 5: Standards
**/
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 13+ messages in thread
* [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
@ 2019-07-25 16:46 Javeed, Ashraf
0 siblings, 0 replies; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-25 16:46 UTC (permalink / raw)
To: devel; +Cc: Michael D Kinney, Liming Gao, Ray Ni
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
New interface added to PCI Platform Protocol / PCI Override Protocol to
retrieve device-specific platform policy for the following PCI standard
features, like Maximum Payload Size (MPS), Maximum Read Request Size
(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power Management
(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
Configuration, Extended SYNCH, PTM support, and Completion Timeout (CTO).
New source files added with enhanced definitions are in:
MdePkg/Include/Protocol/PciPlatform2.h,
MdePkg/Include/Protocol/PciOverride2.h
Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
---
MdePkg/Include/Protocol/PciOverride2.h | 46 ++++++++++++++++++++++++++++++++++++++++++++++
MdePkg/Include/Protocol/PciPlatform2.h | 396 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
MdePkg/MdePkg.dec | 6 ++++++
3 files changed, 448 insertions(+)
diff --git a/MdePkg/Include/Protocol/PciOverride2.h b/MdePkg/Include/Protocol/PciOverride2.h
new file mode 100644
index 0000000000..cf452d9f8f
--- /dev/null
+++ b/MdePkg/Include/Protocol/PciOverride2.h
@@ -0,0 +1,46 @@
+/** @file
+ This file declares EFI PCI Override protocol which provides the interface between
+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and an implementation's
+ driver to describe the unique features of a platform.
+ This protocol is optional.
+
+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+ This program and the accompanying materials
+ are licensed and made available under the terms and conditions of the BSD License
+ which accompanies this distribution. The full text of the license may be found at
+ http://opensource.org/licenses/bsd-license.php
+
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+ @par Revision Reference:
+ This Protocol is defined in UEFI Platform Initialization Specification 1.2
+ Volume 5: Standards
+
+**/
+
+#ifndef _PCI_OVERRIDE2_H_
+#define _PCI_OVERRIDE2_H_
+
+///
+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with EFI_PCI_PLATFORM_PROTOCOL
+///
+#include <Protocol/PciPlatform2.h>
+
+///
+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL
+///
+#define EFI_PCI_OVERRIDE2_GUID \
+ { \
+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47} \
+ }
+
+///
+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL
+///
+typedef EFI_PCI_PLATFORM_PROTOCOL2 EFI_PCI_OVERRIDE_PROTOCOL2;
+
+
+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
+
+#endif
diff --git a/MdePkg/Include/Protocol/PciPlatform2.h b/MdePkg/Include/Protocol/PciPlatform2.h
new file mode 100644
index 0000000000..3ff41b7754
--- /dev/null
+++ b/MdePkg/Include/Protocol/PciPlatform2.h
@@ -0,0 +1,396 @@
+/** @file
+ This file declares PCI Platform Protocol that provide the interface between
+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and a platform-specific
+ driver to describe the unique features of a platform.
+ This protocol is optional.
+
+Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+ @par Revision Reference:
+ This Protocol is defined in UEFI Platform Initialization Specification 1.2
+ Volume 5: Standards
+
+**/
+
+#ifndef _PCI_PLATFORM2_H_
+#define _PCI_PLATFORM2_H_
+
+///
+/// This file must be included because the EFI_PCI_PLATFORM_PROTOCOL2 uses
+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
+///
+#include <Protocol/PciHostBridgeResourceAllocation.h>
+
+///
+/// Reuse the existing definition to maintain backward compatibility
+///
+#include <Protocol/PciPlatform.h>
+
+///
+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
+///
+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
+ { \
+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6} \
+ }
+
+///
+/// As per the present definition and specification of this protocol, the major
+/// version is 1, and minor version is 1. Any driver utilizing this protocol
+/// shall use these versions number to maintain the backward compatibility as
+/// per its specification changes in future.
+///
+enum EfiPciPlatformProtocolVersion {
+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1
+};
+
+///
+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
+///
+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2 EFI_PCI_PLATFORM_PROTOCOL2;
+
+///
+/// Following are the data types for EFI_PCI_PLATYFORM_EXTENDED_POLICY
+/// each for the PCI standard feature and its corresponding bitmask
+/// representing the valid combinations of PCI attributes
+///
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Maximum Payload Size (MPS). Refer to PCI Base Specification
+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per the
+/// PCI hardware terminology. If this data member value is returned as 0 than
+/// there is no platform policy to override, this feature would be enabled as
+/// per its PCI specification based on the device capabilities. Below is it
+/// data type and the macro definitions which the driver uses for interpreting
+/// the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
+
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to default 128B
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to 256B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to 512B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to 1024B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to 2048B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to 4096B if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Maximum Read Request Size (MRRS). Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
+
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to default 128B
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to 256B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to 512B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to 1024B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to 2048B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to 4096B if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Extended Tags. Refer to PCI Base Specification
+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per the
+/// PCI hardware terminology. If this data member value is returned as 0 than
+/// there is no platform policy to override, this feature would be enabled as
+/// per its PCI specification based on the device capabilities. Below is it
+/// data type and the macro definitions which the driver uses for interpreting
+/// the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
+
+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to default 5-bit
+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit if applicable
+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Active State Power Mgmt (ASPM). Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.7) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
+
+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s state
+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1 state
+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s and L1 state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Relax Ordering enable/disable. Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
+
+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's No-Snoop enable/disable. Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
+
+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Clock configuration is common or discrete.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
+
+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default asynchronous clock
+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to common clock
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Extended Synch enable or disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
+
+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's AtomicOp Requester enable or disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
+
+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's LTR Mechanism enable/disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_LTR;
+
+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Precision Time Measurement (PTM) enable/disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_PTM;
+
+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state only
+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select & enable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Completion Timeout (CTO) set to supported ranges
+/// or disable. Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
+/// translate the below EFI encodings as per the PCI hardware terminology. If this
+/// data member value is returned as 0 than there is no platform policy to override,
+/// this feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
+
+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default range of 5us to 50ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of 50us to 100us if applicable
+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of 1ms to 10ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of 16ms to 55ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of 65ms to 210ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of 260ms to 900ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of 1s to 3.5s if applicable
+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of 4s to 13s if applicable
+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of 17s to 64s if applicable
+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO detection disable if applicable
+
+///
+/// Reserves for future use
+///
+typedef UINT8 EFI_PCI_CONF_RESERVES;
+
+///
+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether 128-byte size, with each
+/// byte field representing one PCI standerd feature defined in the PCI Express Base
+/// Specification 4.0, version 1.0.
+///
+typedef struct {
+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
+ EFI_PCI_CONF_PTM PTMControl;
+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
+ EFI_PCI_CONF_RESERVES Reserves[116];
+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
+
+/**
+ Retrieves the PCI device-specific platform policy regarding enumeration.
+
+ The PCI Bus driver and PCI Host Bridge Resource Allocation Protocol drivers
+ can call this member function to retrieve the platform policies specific to
+ PCI device, regarding the PCI enumeration.
+
+ The GetDevicePolicy() function retrieves the platform policy for a particular
+ component regarding PCI enumeration. The PCI bus driver and the PCI Host Bridge
+ Resource Allocation Protocol driver can call this member function to retrieve
+ the policy.
+ The existing GetPlatformPolicy() member function is used by the PCI Bus driver
+ to program the legacy ranges, the data that is returned by that member function
+ determines the supported attributes that are returned by the
+ EFI_PCI_IO_PROTOCOL.Attributes() function.
+ The GetDevicePolicy() member function is meant to return data about other PCI
+ compliant features which would be supported by the PCI Bus driver in future;
+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The details about
+ this PCI features can be obtained from the PCI Base Specification 4.x. The
+ EFI encodings for these feature are defined in the
+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition section for this.
+ This member function will use the associated EFI handle of the PCI IO Protocol
+ to determine the physical PCI device within the chipset, to return its
+ device-specific platform policies.
+
+ @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL2 instance.
+ @param[in] PciDevice The associated PCI IO Protocol handle of the PCI
+ device. Type EFI_HANDLE is defined in
+ InstallProtocolInterface() in the UEFI 2.1
+ Specification
+ @param[in] PciExtPolicy The platform policy with respect to other PCI features
+ like, the MPS, MRRS, etc. Type EFI_PCI_PLATFORM_EXTENDED_POLICY
+ is defined in "Related Definitions" below.
+
+
+ @retval EFI_SUCCESS The function completed successfully, may returns
+ platform policy data for the given PCI component
+ @retval EFI_UNSUPPORTED PCI component belongs to PCI topology but not
+ part of chipset to provide the platform policy
+ @retval EFI_INVALID_PARAMETER If any of the input parameters are passed with
+ invalid data
+
+ **/
+typedef
+EFI_STATUS
+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
+ IN EFI_HANDLE PciDevice,
+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy
+);
+
+///
+/// This protocol provides the interface between the PCI bus driver/PCI Host
+/// Bridge Resource Allocation driver and a platform-specific driver to describe
+/// the unique features of a platform.
+///
+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
+ ///
+ /// The notification from the PCI bus enumerator to the platform that it is about to
+ /// enter a certain phase during the enumeration process.
+ ///
+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
+ ///
+ /// The notification from the PCI bus enumerator to the platform for each PCI
+ /// controller at several predefined points during PCI controller initialization.
+ ///
+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER PlatformPrepController;
+ ///
+ /// Retrieves the platform policy regarding enumeration.
+ ///
+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
+ ///
+ /// Gets the PCI device's option ROM from a platform-specific location.
+ ///
+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
+ ///
+ /// Retrieves the PCI device-specific platform policy regarding enumeration.
+ ///
+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
+ ///
+ /// The major version of this PCI Platform Protocol
+ ///
+ UINT8 MajorVersion;
+ ///
+ /// The minor version of this PCI Platform Protocol
+ ///
+ UINT8 MinorVersion;
+
+};
+
+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
+
+#endif
diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
index b382efd578..670b448031 100644
--- a/MdePkg/MdePkg.dec
+++ b/MdePkg/MdePkg.dec
@@ -1013,6 +1013,12 @@
## Include/Protocol/PciOverride.h
gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06, {0x99, 0xfc, 0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
+ ## Include/Protocol/PciPlatform2.h
+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60, { 0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
+
+ ## Include/Protocol/PciOverride2.h
+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546, { 0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
+
## Include/Protocol/PciEnumerationComplete.h
gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7, 0x3de1, 0x4586, {0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
--
2.21.0.windows.1
>From 6ad5aa5250485793f3c8fb603869ce936b317677 Mon Sep 17 00:00:00 2001
From: Ashraf Javeed <ashraf.javeed@intel.com>
Date: Thu, 25 Jul 2019 20:03:49 +0530
Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New
interface, EFI encodings to PCI Plat protocol
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
In V2: Correction made to header sections of source files
New interface added to PCI Platform Protocol / PCI Override Protocol to
retrieve device-specific platform policy for the following PCI standard
features, like Maximum Payload Size (MPS), Maximum Read Request Size
(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power Management
(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
Configuration, Extended SYNCH, PTM support, and Completion Timeout (CTO).
New source files added with enhanced definitions are in:
MdePkg/Include/Protocol/PciPlatform2.h,
MdePkg/Include/Protocol/PciOverride2.h
Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
---
MdePkg/Include/Protocol/PciOverride2.h | 3 ---
MdePkg/Include/Protocol/PciPlatform2.h | 5 +----
2 files changed, 1 insertion(+), 7 deletions(-)
diff --git a/MdePkg/Include/Protocol/PciOverride2.h b/MdePkg/Include/Protocol/PciOverride2.h
index cf452d9f8f..a7f541b4c3 100644
--- a/MdePkg/Include/Protocol/PciOverride2.h
+++ b/MdePkg/Include/Protocol/PciOverride2.h
@@ -13,9 +13,6 @@
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
- @par Revision Reference:
- This Protocol is defined in UEFI Platform Initialization Specification 1.2
- Volume 5: Standards
**/
diff --git a/MdePkg/Include/Protocol/PciPlatform2.h b/MdePkg/Include/Protocol/PciPlatform2.h
index 3ff41b7754..717938e68d 100644
--- a/MdePkg/Include/Protocol/PciPlatform2.h
+++ b/MdePkg/Include/Protocol/PciPlatform2.h
@@ -4,7 +4,7 @@
driver to describe the unique features of a platform.
This protocol is optional.
-Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at
@@ -13,9 +13,6 @@ http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
- @par Revision Reference:
- This Protocol is defined in UEFI Platform Initialization Specification 1.2
- Volume 5: Standards
**/
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 13+ messages in thread
* [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
@ 2019-07-29 6:51 Javeed, Ashraf
2019-07-29 7:52 ` Liming Gao
0 siblings, 1 reply; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-29 6:51 UTC (permalink / raw)
To: devel; +Cc: Michael D Kinney, Liming Gao, Ray Ni
BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
New interface added to PCI Platform Protocol / PCI Override Protocol to
retrieve device-specific platform policy for the following PCI standard
features, like Maximum Payload Size (MPS), Maximum Read Request Size
(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power Management
(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
Configuration, Extended SYNCH, PTM support, and Completion Timeout (CTO).
New source files added with enhanced definitions are in:
MdePkg/Include/Protocol/PciPlatform2.h,
MdePkg/Include/Protocol/PciOverride2.h
Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Ray Ni <ray.ni@intel.com>
---
In V2: Correction made to header sections of source files
---
MdePkg/Include/Protocol/PciOverride2.h | 43 +++++++++++++++++++++++++++++++++++++++++++
MdePkg/Include/Protocol/PciPlatform2.h | 393 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
MdePkg/MdePkg.dec | 6 ++++++
3 files changed, 442 insertions(+)
diff --git a/MdePkg/Include/Protocol/PciOverride2.h b/MdePkg/Include/Protocol/PciOverride2.h
new file mode 100644
index 0000000000..a7f541b4c3
--- /dev/null
+++ b/MdePkg/Include/Protocol/PciOverride2.h
@@ -0,0 +1,43 @@
+/** @file
+ This file declares EFI PCI Override protocol which provides the interface between
+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and an implementation's
+ driver to describe the unique features of a platform.
+ This protocol is optional.
+
+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+ This program and the accompanying materials
+ are licensed and made available under the terms and conditions of the BSD License
+ which accompanies this distribution. The full text of the license may be found at
+ http://opensource.org/licenses/bsd-license.php
+
+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+
+**/
+
+#ifndef _PCI_OVERRIDE2_H_
+#define _PCI_OVERRIDE2_H_
+
+///
+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with EFI_PCI_PLATFORM_PROTOCOL
+///
+#include <Protocol/PciPlatform2.h>
+
+///
+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL
+///
+#define EFI_PCI_OVERRIDE2_GUID \
+ { \
+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47} \
+ }
+
+///
+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL
+///
+typedef EFI_PCI_PLATFORM_PROTOCOL2 EFI_PCI_OVERRIDE_PROTOCOL2;
+
+
+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
+
+#endif
diff --git a/MdePkg/Include/Protocol/PciPlatform2.h b/MdePkg/Include/Protocol/PciPlatform2.h
new file mode 100644
index 0000000000..717938e68d
--- /dev/null
+++ b/MdePkg/Include/Protocol/PciPlatform2.h
@@ -0,0 +1,393 @@
+/** @file
+ This file declares PCI Platform Protocol that provide the interface between
+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and a platform-specific
+ driver to describe the unique features of a platform.
+ This protocol is optional.
+
+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+
+**/
+
+#ifndef _PCI_PLATFORM2_H_
+#define _PCI_PLATFORM2_H_
+
+///
+/// This file must be included because the EFI_PCI_PLATFORM_PROTOCOL2 uses
+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
+///
+#include <Protocol/PciHostBridgeResourceAllocation.h>
+
+///
+/// Reuse the existing definition to maintain backward compatibility
+///
+#include <Protocol/PciPlatform.h>
+
+///
+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
+///
+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
+ { \
+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6} \
+ }
+
+///
+/// As per the present definition and specification of this protocol, the major
+/// version is 1, and minor version is 1. Any driver utilizing this protocol
+/// shall use these versions number to maintain the backward compatibility as
+/// per its specification changes in future.
+///
+enum EfiPciPlatformProtocolVersion {
+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1
+};
+
+///
+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
+///
+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2 EFI_PCI_PLATFORM_PROTOCOL2;
+
+///
+/// Following are the data types for EFI_PCI_PLATYFORM_EXTENDED_POLICY
+/// each for the PCI standard feature and its corresponding bitmask
+/// representing the valid combinations of PCI attributes
+///
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Maximum Payload Size (MPS). Refer to PCI Base Specification
+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per the
+/// PCI hardware terminology. If this data member value is returned as 0 than
+/// there is no platform policy to override, this feature would be enabled as
+/// per its PCI specification based on the device capabilities. Below is it
+/// data type and the macro definitions which the driver uses for interpreting
+/// the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
+
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to default 128B
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to 256B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to 512B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to 1024B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to 2048B if applicable
+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to 4096B if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Maximum Read Request Size (MRRS). Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
+
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to default 128B
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to 256B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to 512B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to 1024B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to 2048B if applicable
+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to 4096B if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature Extended Tags. Refer to PCI Base Specification
+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per the
+/// PCI hardware terminology. If this data member value is returned as 0 than
+/// there is no platform policy to override, this feature would be enabled as
+/// per its PCI specification based on the device capabilities. Below is it
+/// data type and the macro definitions which the driver uses for interpreting
+/// the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
+
+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to default 5-bit
+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit if applicable
+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit if applicable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Active State Power Mgmt (ASPM). Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.7) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
+
+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s state
+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1 state
+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s and L1 state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Relax Ordering enable/disable. Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
+
+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's No-Snoop enable/disable. Refer to PCI Base
+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
+/// encodings as per the PCI hardware terminology. If this data member value
+/// is returned as 0 than there is no platform policy to override, this feature
+/// would be enabled as per its PCI specification based on the device capabilities.
+/// Below is it data type and the macro definitions which the driver uses for
+/// interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
+
+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Clock configuration is common or discrete.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
+
+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default asynchronous clock
+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to common clock
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe link's Extended Synch enable or disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
+
+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's AtomicOp Requester enable or disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
+
+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's LTR Mechanism enable/disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_LTR;
+
+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable state
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Precision Time Measurement (PTM) enable/disable.
+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate the
+/// below EFI encodings as per the PCI hardware terminology. If this data member
+/// value is returned as 0 than there is no platform policy to override, this
+/// feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_PTM;
+
+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default disable state
+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state only
+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select & enable
+
+///
+/// This data type is to retrieve the PCI device platform policy for the PCI-
+/// compliant feature PCIe Device's Completion Timeout (CTO) set to supported ranges
+/// or disable. Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
+/// translate the below EFI encodings as per the PCI hardware terminology. If this
+/// data member value is returned as 0 than there is no platform policy to override,
+/// this feature would be enabled as per its PCI specification based on the device
+/// capabilities. Below is its data type and the macro definitions which the
+/// driver uses for interpreting the platform policy.
+///
+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
+
+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for override
+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default range of 5us to 50ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of 50us to 100us if applicable
+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of 1ms to 10ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of 16ms to 55ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of 65ms to 210ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of 260ms to 900ms if applicable
+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of 1s to 3.5s if applicable
+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of 4s to 13s if applicable
+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of 17s to 64s if applicable
+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO detection disable if applicable
+
+///
+/// Reserves for future use
+///
+typedef UINT8 EFI_PCI_CONF_RESERVES;
+
+///
+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether 128-byte size, with each
+/// byte field representing one PCI standerd feature defined in the PCI Express Base
+/// Specification 4.0, version 1.0.
+///
+typedef struct {
+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
+ EFI_PCI_CONF_PTM PTMControl;
+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
+ EFI_PCI_CONF_RESERVES Reserves[116];
+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
+
+/**
+ Retrieves the PCI device-specific platform policy regarding enumeration.
+
+ The PCI Bus driver and PCI Host Bridge Resource Allocation Protocol drivers
+ can call this member function to retrieve the platform policies specific to
+ PCI device, regarding the PCI enumeration.
+
+ The GetDevicePolicy() function retrieves the platform policy for a particular
+ component regarding PCI enumeration. The PCI bus driver and the PCI Host Bridge
+ Resource Allocation Protocol driver can call this member function to retrieve
+ the policy.
+ The existing GetPlatformPolicy() member function is used by the PCI Bus driver
+ to program the legacy ranges, the data that is returned by that member function
+ determines the supported attributes that are returned by the
+ EFI_PCI_IO_PROTOCOL.Attributes() function.
+ The GetDevicePolicy() member function is meant to return data about other PCI
+ compliant features which would be supported by the PCI Bus driver in future;
+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The details about
+ this PCI features can be obtained from the PCI Base Specification 4.x. The
+ EFI encodings for these feature are defined in the
+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition section for this.
+ This member function will use the associated EFI handle of the PCI IO Protocol
+ to determine the physical PCI device within the chipset, to return its
+ device-specific platform policies.
+
+ @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL2 instance.
+ @param[in] PciDevice The associated PCI IO Protocol handle of the PCI
+ device. Type EFI_HANDLE is defined in
+ InstallProtocolInterface() in the UEFI 2.1
+ Specification
+ @param[in] PciExtPolicy The platform policy with respect to other PCI features
+ like, the MPS, MRRS, etc. Type EFI_PCI_PLATFORM_EXTENDED_POLICY
+ is defined in "Related Definitions" below.
+
+
+ @retval EFI_SUCCESS The function completed successfully, may returns
+ platform policy data for the given PCI component
+ @retval EFI_UNSUPPORTED PCI component belongs to PCI topology but not
+ part of chipset to provide the platform policy
+ @retval EFI_INVALID_PARAMETER If any of the input parameters are passed with
+ invalid data
+
+ **/
+typedef
+EFI_STATUS
+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
+ IN EFI_HANDLE PciDevice,
+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy
+);
+
+///
+/// This protocol provides the interface between the PCI bus driver/PCI Host
+/// Bridge Resource Allocation driver and a platform-specific driver to describe
+/// the unique features of a platform.
+///
+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
+ ///
+ /// The notification from the PCI bus enumerator to the platform that it is about to
+ /// enter a certain phase during the enumeration process.
+ ///
+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
+ ///
+ /// The notification from the PCI bus enumerator to the platform for each PCI
+ /// controller at several predefined points during PCI controller initialization.
+ ///
+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER PlatformPrepController;
+ ///
+ /// Retrieves the platform policy regarding enumeration.
+ ///
+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
+ ///
+ /// Gets the PCI device's option ROM from a platform-specific location.
+ ///
+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
+ ///
+ /// Retrieves the PCI device-specific platform policy regarding enumeration.
+ ///
+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
+ ///
+ /// The major version of this PCI Platform Protocol
+ ///
+ UINT8 MajorVersion;
+ ///
+ /// The minor version of this PCI Platform Protocol
+ ///
+ UINT8 MinorVersion;
+
+};
+
+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
+
+#endif
diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
index b382efd578..670b448031 100644
--- a/MdePkg/MdePkg.dec
+++ b/MdePkg/MdePkg.dec
@@ -1013,6 +1013,12 @@
## Include/Protocol/PciOverride.h
gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06, {0x99, 0xfc, 0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
+ ## Include/Protocol/PciPlatform2.h
+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60, { 0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
+
+ ## Include/Protocol/PciOverride2.h
+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546, { 0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
+
## Include/Protocol/PciEnumerationComplete.h
gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7, 0x3de1, 0x4586, {0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 13+ messages in thread
* Re: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 6:51 [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol Javeed, Ashraf
@ 2019-07-29 7:52 ` Liming Gao
2019-07-29 8:05 ` [edk2-devel] " Yao, Jiewen
0 siblings, 1 reply; 13+ messages in thread
From: Liming Gao @ 2019-07-29 7:52 UTC (permalink / raw)
To: Javeed, Ashraf, devel@edk2.groups.io; +Cc: Kinney, Michael D, Ni, Ray
Ashraf:
For new files, please use license: SPDX-License-Identifier: BSD-2-Clause-Patent.
Other change is good. Reviewed-by: Liming Gao <liming.gao@intel.com>
Thanks
Liming
>-----Original Message-----
>From: Javeed, Ashraf
>Sent: Monday, July 29, 2019 2:52 PM
>To: devel@edk2.groups.io
>Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
>Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols:
>New interface, EFI encodings to PCI Plat protocol
>
>BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
>
>New interface added to PCI Platform Protocol / PCI Override Protocol to
>retrieve device-specific platform policy for the following PCI standard
>features, like Maximum Payload Size (MPS), Maximum Read Request Size
>(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power
>Management
>(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
>Configuration, Extended SYNCH, PTM support, and Completion Timeout (CTO).
>New source files added with enhanced definitions are in:
>MdePkg/Include/Protocol/PciPlatform2.h,
>MdePkg/Include/Protocol/PciOverride2.h
>
>Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
>Cc: Michael D Kinney <michael.d.kinney@intel.com>
>Cc: Liming Gao <liming.gao@intel.com>
>Cc: Ray Ni <ray.ni@intel.com>
>---
>
>In V2: Correction made to header sections of source files
>---
> MdePkg/Include/Protocol/PciOverride2.h | 43
>+++++++++++++++++++++++++++++++++++++++++++
> MdePkg/Include/Protocol/PciPlatform2.h | 393
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>+++++++++++++++++++++++++++++++++++++++
> MdePkg/MdePkg.dec | 6 ++++++
> 3 files changed, 442 insertions(+)
>
>diff --git a/MdePkg/Include/Protocol/PciOverride2.h
>b/MdePkg/Include/Protocol/PciOverride2.h
>new file mode 100644
>index 0000000000..a7f541b4c3
>--- /dev/null
>+++ b/MdePkg/Include/Protocol/PciOverride2.h
>@@ -0,0 +1,43 @@
>+/** @file
>+ This file declares EFI PCI Override protocol which provides the interface
>between
>+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and an
>implementation's
>+ driver to describe the unique features of a platform.
>+ This protocol is optional.
>+
>+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
>+ This program and the accompanying materials
>+ are licensed and made available under the terms and conditions of the BSD
>License
>+ which accompanies this distribution. The full text of the license may be
>found at
>+ http://opensource.org/licenses/bsd-license.php
>+
>+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
>BASIS,
>+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
>EXPRESS OR IMPLIED.
>+
>+
>+**/
>+
>+#ifndef _PCI_OVERRIDE2_H_
>+#define _PCI_OVERRIDE2_H_
>+
>+///
>+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
>EFI_PCI_PLATFORM_PROTOCOL
>+///
>+#include <Protocol/PciPlatform2.h>
>+
>+///
>+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL
>+///
>+#define EFI_PCI_OVERRIDE2_GUID \
>+ { \
>+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47}
>\
>+ }
>+
>+///
>+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL
>+///
>+typedef EFI_PCI_PLATFORM_PROTOCOL2 EFI_PCI_OVERRIDE_PROTOCOL2;
>+
>+
>+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
>+
>+#endif
>diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
>b/MdePkg/Include/Protocol/PciPlatform2.h
>new file mode 100644
>index 0000000000..717938e68d
>--- /dev/null
>+++ b/MdePkg/Include/Protocol/PciPlatform2.h
>@@ -0,0 +1,393 @@
>+/** @file
>+ This file declares PCI Platform Protocol that provide the interface between
>+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and a
>platform-specific
>+ driver to describe the unique features of a platform.
>+ This protocol is optional.
>+
>+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
>+This program and the accompanying materials are licensed and made
>available under
>+the terms and conditions of the BSD License that accompanies this
>distribution.
>+The full text of the license may be found at
>+http://opensource.org/licenses/bsd-license.php.
>+
>+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
>BASIS,
>+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
>EXPRESS OR IMPLIED.
>+
>+
>+**/
>+
>+#ifndef _PCI_PLATFORM2_H_
>+#define _PCI_PLATFORM2_H_
>+
>+///
>+/// This file must be included because the EFI_PCI_PLATFORM_PROTOCOL2
>uses
>+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
>+///
>+#include <Protocol/PciHostBridgeResourceAllocation.h>
>+
>+///
>+/// Reuse the existing definition to maintain backward compatibility
>+///
>+#include <Protocol/PciPlatform.h>
>+
>+///
>+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
>+///
>+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
>+ { \
>+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2, 0xd0,
>0xb6} \
>+ }
>+
>+///
>+/// As per the present definition and specification of this protocol, the major
>+/// version is 1, and minor version is 1. Any driver utilizing this protocol
>+/// shall use these versions number to maintain the backward compatibility
>as
>+/// per its specification changes in future.
>+///
>+enum EfiPciPlatformProtocolVersion {
>+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
>+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1
>+};
>+
>+///
>+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
>+///
>+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
>EFI_PCI_PLATFORM_PROTOCOL2;
>+
>+///
>+/// Following are the data types for
>EFI_PCI_PLATYFORM_EXTENDED_POLICY
>+/// each for the PCI standard feature and its corresponding bitmask
>+/// representing the valid combinations of PCI attributes
>+///
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature Maximum Payload Size (MPS). Refer to PCI Base
>Specification
>+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per
>the
>+/// PCI hardware terminology. If this data member value is returned as 0
>than
>+/// there is no platform policy to override, this feature would be enabled as
>+/// per its PCI specification based on the device capabilities. Below is it
>+/// data type and the macro definitions which the driver uses for interpreting
>+/// the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
>+
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No request for
>override
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to default
>128B
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to 256B if
>applicable
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to 512B if
>applicable
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to 1024B if
>applicable
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to 2048B if
>applicable
>+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to 4096B if
>applicable
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature Maximum Read Request Size (MRRS). Refer to PCI
>Base
>+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
>+/// encodings as per the PCI hardware terminology. If this data member
>value
>+/// is returned as 0 than there is no platform policy to override, this feature
>+/// would be enabled as per its PCI specification based on the device
>capabilities.
>+/// Below is it data type and the macro definitions which the driver uses for
>+/// interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
>+
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No request
>for override
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to default
>128B
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to 256B if
>applicable
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to 512B if
>applicable
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to 1024B if
>applicable
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to 2048B if
>applicable
>+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to 4096B if
>applicable
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature Extended Tags. Refer to PCI Base Specification
>+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per
>the
>+/// PCI hardware terminology. If this data member value is returned as 0
>than
>+/// there is no platform policy to override, this feature would be enabled as
>+/// per its PCI specification based on the device capabilities. Below is it
>+/// data type and the macro definitions which the driver uses for interpreting
>+/// the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
>+
>+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No request for
>override
>+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to default 5-bit
>+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit if
>applicable
>+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit if
>applicable
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe link's Active State Power Mgmt (ASPM). Refer to
>PCI Base
>+/// Specification 4, (chapter 7.5.3.7) on how to translate the below EFI
>+/// encodings as per the PCI hardware terminology. If this data member
>value
>+/// is returned as 0 than there is no platform policy to override, this feature
>+/// would be enabled as per its PCI specification based on the device
>capabilities.
>+/// Below is it data type and the macro definitions which the driver uses for
>+/// interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
>+
>+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to default disable
>state
>+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s state
>+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1 state
>+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s and L1
>state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's Relax Ordering enable/disable. Refer to
>PCI Base
>+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
>+/// encodings as per the PCI hardware terminology. If this data member
>value
>+/// is returned as 0 than there is no platform policy to override, this feature
>+/// would be enabled as per its PCI specification based on the device
>capabilities.
>+/// Below is it data type and the macro definitions which the driver uses for
>+/// interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
>+
>+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable state
>+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's No-Snoop enable/disable. Refer to PCI
>Base
>+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
>+/// encodings as per the PCI hardware terminology. If this data member
>value
>+/// is returned as 0 than there is no platform policy to override, this feature
>+/// would be enabled as per its PCI specification based on the device
>capabilities.
>+/// Below is it data type and the macro definitions which the driver uses for
>+/// interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
>+
>+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable state
>+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe link's Clock configuration is common or discrete.
>+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate
>the
>+/// below EFI encodings as per the PCI hardware terminology. If this data
>member
>+/// value is returned as 0 than there is no platform policy to override, this
>+/// feature would be enabled as per its PCI specification based on the device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
>+
>+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default
>asynchronous clock
>+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to common clock
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe link's Extended Synch enable or disable.
>+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate
>the
>+/// below EFI encodings as per the PCI hardware terminology. If this data
>member
>+/// value is returned as 0 than there is no platform policy to override, this
>+/// feature would be enabled as per its PCI specification based on the device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
>+
>+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default disable
>state
>+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's AtomicOp Requester enable or disable.
>+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate
>the
>+/// below EFI encodings as per the PCI hardware terminology. If this data
>member
>+/// value is returned as 0 than there is no platform policy to override, this
>+/// feature would be enabled as per its PCI specification based on the device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
>+
>+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request for
>override
>+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default disable
>state
>+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's LTR Mechanism enable/disable.
>+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate
>the
>+/// below EFI encodings as per the PCI hardware terminology. If this data
>member
>+/// value is returned as 0 than there is no platform policy to override, this
>+/// feature would be enabled as per its PCI specification based on the device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_LTR;
>+
>+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable state
>+#define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable state
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's Precision Time Measurement (PTM)
>enable/disable.
>+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to translate
>the
>+/// below EFI encodings as per the PCI hardware terminology. If this data
>member
>+/// value is returned as 0 than there is no platform policy to override, this
>+/// feature would be enabled as per its PCI specification based on the device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_PTM;
>+
>+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default disable state
>+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state only
>+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select & enable
>+
>+///
>+/// This data type is to retrieve the PCI device platform policy for the PCI-
>+/// compliant feature PCIe Device's Completion Timeout (CTO) set to
>supported ranges
>+/// or disable. Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
>+/// translate the below EFI encodings as per the PCI hardware terminology. If
>this
>+/// data member value is returned as 0 than there is no platform policy to
>override,
>+/// this feature would be enabled as per its PCI specification based on the
>device
>+/// capabilities. Below is its data type and the macro definitions which the
>+/// driver uses for interpreting the platform policy.
>+///
>+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
>+
>+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for override
>+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default range of 5us
>to 50ms if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of 50us to
>100us if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of 1ms to
>10ms if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of 16ms to
>55ms if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of 65ms to
>210ms if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of 260ms to
>900ms if applicable
>+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of 1s to 3.5s if
>applicable
>+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of 4s to 13s if
>applicable
>+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of 17s to 64s
>if applicable
>+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO detection
>disable if applicable
>+
>+///
>+/// Reserves for future use
>+///
>+typedef UINT8 EFI_PCI_CONF_RESERVES;
>+
>+///
>+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether 128-byte size,
>with each
>+/// byte field representing one PCI standerd feature defined in the PCI
>Express Base
>+/// Specification 4.0, version 1.0.
>+///
>+typedef struct {
>+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
>+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
>+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
>+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
>+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
>+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
>+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
>+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
>+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
>+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
>+ EFI_PCI_CONF_PTM PTMControl;
>+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
>+ EFI_PCI_CONF_RESERVES Reserves[116];
>+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
>+
>+/**
>+ Retrieves the PCI device-specific platform policy regarding enumeration.
>+
>+ The PCI Bus driver and PCI Host Bridge Resource Allocation Protocol drivers
>+ can call this member function to retrieve the platform policies specific to
>+ PCI device, regarding the PCI enumeration.
>+
>+ The GetDevicePolicy() function retrieves the platform policy for a particular
>+ component regarding PCI enumeration. The PCI bus driver and the PCI Host
>Bridge
>+ Resource Allocation Protocol driver can call this member function to retrieve
>+ the policy.
>+ The existing GetPlatformPolicy() member function is used by the PCI Bus
>driver
>+ to program the legacy ranges, the data that is returned by that member
>function
>+ determines the supported attributes that are returned by the
>+ EFI_PCI_IO_PROTOCOL.Attributes() function.
>+ The GetDevicePolicy() member function is meant to return data about
>other PCI
>+ compliant features which would be supported by the PCI Bus driver in
>future;
>+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The details
>about
>+ this PCI features can be obtained from the PCI Base Specification 4.x. The
>+ EFI encodings for these feature are defined in the
>+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition section
>for this.
>+ This member function will use the associated EFI handle of the PCI IO
>Protocol
>+ to determine the physical PCI device within the chipset, to return its
>+ device-specific platform policies.
>+
>+ @param[in] This Pointer to the EFI_PCI_PLATFORM_PROTOCOL2
>instance.
>+ @param[in] PciDevice The associated PCI IO Protocol handle of the PCI
>+ device. Type EFI_HANDLE is defined in
>+ InstallProtocolInterface() in the UEFI 2.1
>+ Specification
>+ @param[in] PciExtPolicy The platform policy with respect to other PCI
>features
>+ like, the MPS, MRRS, etc. Type
>EFI_PCI_PLATFORM_EXTENDED_POLICY
>+ is defined in "Related Definitions" below.
>+
>+
>+ @retval EFI_SUCCESS The function completed successfully, may
>returns
>+ platform policy data for the given PCI component
>+ @retval EFI_UNSUPPORTED PCI component belongs to PCI topology but
>not
>+ part of chipset to provide the platform policy
>+ @retval EFI_INVALID_PARAMETER If any of the input parameters are
>passed with
>+ invalid data
>+
>+ **/
>+typedef
>+EFI_STATUS
>+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
>+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
>+ IN EFI_HANDLE PciDevice,
>+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy
>+);
>+
>+///
>+/// This protocol provides the interface between the PCI bus driver/PCI Host
>+/// Bridge Resource Allocation driver and a platform-specific driver to
>describe
>+/// the unique features of a platform.
>+///
>+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
>+ ///
>+ /// The notification from the PCI bus enumerator to the platform that it is
>about to
>+ /// enter a certain phase during the enumeration process.
>+ ///
>+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
>+ ///
>+ /// The notification from the PCI bus enumerator to the platform for each
>PCI
>+ /// controller at several predefined points during PCI controller initialization.
>+ ///
>+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER PlatformPrepController;
>+ ///
>+ /// Retrieves the platform policy regarding enumeration.
>+ ///
>+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
>+ ///
>+ /// Gets the PCI device's option ROM from a platform-specific location.
>+ ///
>+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
>+ ///
>+ /// Retrieves the PCI device-specific platform policy regarding enumeration.
>+ ///
>+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
>+ ///
>+ /// The major version of this PCI Platform Protocol
>+ ///
>+ UINT8 MajorVersion;
>+ ///
>+ /// The minor version of this PCI Platform Protocol
>+ ///
>+ UINT8 MinorVersion;
>+
>+};
>+
>+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
>+
>+#endif
>diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
>index b382efd578..670b448031 100644
>--- a/MdePkg/MdePkg.dec
>+++ b/MdePkg/MdePkg.dec
>@@ -1013,6 +1013,12 @@
> ## Include/Protocol/PciOverride.h
> gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06, {0x99, 0xfc,
>0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
>
>+ ## Include/Protocol/PciPlatform2.h
>+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60, { 0x8d, 0x34,
>0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
>+
>+ ## Include/Protocol/PciOverride2.h
>+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546, { 0xb0, 0xbb,
>0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
>+
> ## Include/Protocol/PciEnumerationComplete.h
> gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7, 0x3de1, 0x4586,
>{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
>
>--
>2.21.0.windows.1
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 7:52 ` Liming Gao
@ 2019-07-29 8:05 ` Yao, Jiewen
2019-07-29 8:12 ` Javeed, Ashraf
0 siblings, 1 reply; 13+ messages in thread
From: Yao, Jiewen @ 2019-07-29 8:05 UTC (permalink / raw)
To: devel@edk2.groups.io, Gao, Liming, Javeed, Ashraf
Cc: Kinney, Michael D, Ni, Ray, Yao, Jiewen
Hi
I think this policy protocol should be EDKII specific. Currently it is no in PI spec.
Should it be in MdeModulePkg ?
Thank you
Yao Jiewen
> -----Original Message-----
> From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of
> Liming Gao
> Sent: Monday, July 29, 2019 3:52 PM
> To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> Ashraf:
> For new files, please use license: SPDX-License-Identifier:
> BSD-2-Clause-Patent.
>
> Other change is good. Reviewed-by: Liming Gao <liming.gao@intel.com>
>
> Thanks
> Liming
> >-----Original Message-----
> >From: Javeed, Ashraf
> >Sent: Monday, July 29, 2019 2:52 PM
> >To: devel@edk2.groups.io
> >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols:
> >New interface, EFI encodings to PCI Plat protocol
> >
> >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> >
> >New interface added to PCI Platform Protocol / PCI Override Protocol to
> >retrieve device-specific platform policy for the following PCI standard
> >features, like Maximum Payload Size (MPS), Maximum Read Request Size
> >(MRRS),Extended Tags, Relax Order, No-Snoop, Active State Power
> >Management
> >(ASPM),Latency Time Reporting (LTR), AtomicOp, Reference Clock
> >Configuration, Extended SYNCH, PTM support, and Completion Timeout
> (CTO).
> >New source files added with enhanced definitions are in:
> >MdePkg/Include/Protocol/PciPlatform2.h,
> >MdePkg/Include/Protocol/PciOverride2.h
> >
> >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> >Cc: Liming Gao <liming.gao@intel.com>
> >Cc: Ray Ni <ray.ni@intel.com>
> >---
> >
> >In V2: Correction made to header sections of source files
> >---
> > MdePkg/Include/Protocol/PciOverride2.h | 43
> >+++++++++++++++++++++++++++++++++++++++++++
> > MdePkg/Include/Protocol/PciPlatform2.h | 393
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> >+++++++++++++++++++++++++++++++++++++++
> > MdePkg/MdePkg.dec | 6 ++++++
> > 3 files changed, 442 insertions(+)
> >
> >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> >b/MdePkg/Include/Protocol/PciOverride2.h
> >new file mode 100644
> >index 0000000000..a7f541b4c3
> >--- /dev/null
> >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> >@@ -0,0 +1,43 @@
> >+/** @file
> >+ This file declares EFI PCI Override protocol which provides the interface
> >between
> >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and an
> >implementation's
> >+ driver to describe the unique features of a platform.
> >+ This protocol is optional.
> >+
> >+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> >+ This program and the accompanying materials
> >+ are licensed and made available under the terms and conditions of the
> BSD
> >License
> >+ which accompanies this distribution. The full text of the license may
> be
> >found at
> >+ http://opensource.org/licenses/bsd-license.php
> >+
> >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS
> IS"
> >BASIS,
> >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> >EXPRESS OR IMPLIED.
> >+
> >+
> >+**/
> >+
> >+#ifndef _PCI_OVERRIDE2_H_
> >+#define _PCI_OVERRIDE2_H_
> >+
> >+///
> >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> >EFI_PCI_PLATFORM_PROTOCOL
> >+///
> >+#include <Protocol/PciPlatform2.h>
> >+
> >+///
> >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL
> >+///
> >+#define EFI_PCI_OVERRIDE2_GUID \
> >+ { \
> >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9,
> 0x42, 0x47}
> >\
> >+ }
> >+
> >+///
> >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL
> >+///
> >+typedef EFI_PCI_PLATFORM_PROTOCOL2
> EFI_PCI_OVERRIDE_PROTOCOL2;
> >+
> >+
> >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> >+
> >+#endif
> >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> >b/MdePkg/Include/Protocol/PciPlatform2.h
> >new file mode 100644
> >index 0000000000..717938e68d
> >--- /dev/null
> >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> >@@ -0,0 +1,393 @@
> >+/** @file
> >+ This file declares PCI Platform Protocol that provide the interface
> between
> >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and a
> >platform-specific
> >+ driver to describe the unique features of a platform.
> >+ This protocol is optional.
> >+
> >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> >+This program and the accompanying materials are licensed and made
> >available under
> >+the terms and conditions of the BSD License that accompanies this
> >distribution.
> >+The full text of the license may be found at
> >+http://opensource.org/licenses/bsd-license.php.
> >+
> >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
> >BASIS,
> >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> >EXPRESS OR IMPLIED.
> >+
> >+
> >+**/
> >+
> >+#ifndef _PCI_PLATFORM2_H_
> >+#define _PCI_PLATFORM2_H_
> >+
> >+///
> >+/// This file must be included because the
> EFI_PCI_PLATFORM_PROTOCOL2
> >uses
> >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> >+///
> >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> >+
> >+///
> >+/// Reuse the existing definition to maintain backward compatibility
> >+///
> >+#include <Protocol/PciPlatform.h>
> >+
> >+///
> >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> >+///
> >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> >+ { \
> >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2,
> 0xd0,
> >0xb6} \
> >+ }
> >+
> >+///
> >+/// As per the present definition and specification of this protocol, the
> major
> >+/// version is 1, and minor version is 1. Any driver utilizing this protocol
> >+/// shall use these versions number to maintain the backward
> compatibility
> >as
> >+/// per its specification changes in future.
> >+///
> >+enum EfiPciPlatformProtocolVersion {
> >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1
> >+};
> >+
> >+///
> >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> >+///
> >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> >EFI_PCI_PLATFORM_PROTOCOL2;
> >+
> >+///
> >+/// Following are the data types for
> >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> >+/// each for the PCI standard feature and its corresponding bitmask
> >+/// representing the valid combinations of PCI attributes
> >+///
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature Maximum Payload Size (MPS). Refer to PCI Base
> >Specification
> >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per
> >the
> >+/// PCI hardware terminology. If this data member value is returned as 0
> >than
> >+/// there is no platform policy to override, this feature would be enabled
> as
> >+/// per its PCI specification based on the device capabilities. Below is it
> >+/// data type and the macro definitions which the driver uses for
> interpreting
> >+/// the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> >+
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No
> request for
> >override
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to
> default
> >128B
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to
> 256B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to
> 512B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to
> 1024B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to
> 2048B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to
> 4096B if
> >applicable
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature Maximum Read Request Size (MRRS). Refer to PCI
> >Base
> >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
> >+/// encodings as per the PCI hardware terminology. If this data member
> >value
> >+/// is returned as 0 than there is no platform policy to override, this
> feature
> >+/// would be enabled as per its PCI specification based on the device
> >capabilities.
> >+/// Below is it data type and the macro definitions which the driver uses
> for
> >+/// interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> >+
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No
> request
> >for override
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to
> default
> >128B
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to
> 256B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to
> 512B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to
> 1024B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to
> 2048B if
> >applicable
> >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to
> 4096B if
> >applicable
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature Extended Tags. Refer to PCI Base Specification
> >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings as per
> >the
> >+/// PCI hardware terminology. If this data member value is returned as 0
> >than
> >+/// there is no platform policy to override, this feature would be enabled
> as
> >+/// per its PCI specification based on the device capabilities. Below is it
> >+/// data type and the macro definitions which the driver uses for
> interpreting
> >+/// the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> >+
> >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No request
> for
> >override
> >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to default
> 5-bit
> >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit if
> >applicable
> >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit if
> >applicable
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe link's Active State Power Mgmt (ASPM). Refer
> to
> >PCI Base
> >+/// Specification 4, (chapter 7.5.3.7) on how to translate the below EFI
> >+/// encodings as per the PCI hardware terminology. If this data member
> >value
> >+/// is returned as 0 than there is no platform policy to override, this
> feature
> >+/// would be enabled as per its PCI specification based on the device
> >capabilities.
> >+/// Below is it data type and the macro definitions which the driver uses
> for
> >+/// interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> >+
> >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request for
> override
> >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to default
> disable
> >state
> >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s state
> >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1 state
> >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s and
> L1
> >state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's Relax Ordering enable/disable. Refer
> to
> >PCI Base
> >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
> >+/// encodings as per the PCI hardware terminology. If this data member
> >value
> >+/// is returned as 0 than there is no platform policy to override, this
> feature
> >+/// would be enabled as per its PCI specification based on the device
> >capabilities.
> >+/// Below is it data type and the macro definitions which the driver uses
> for
> >+/// interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> >+
> >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for override
> >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable
> state
> >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's No-Snoop enable/disable. Refer to PCI
> >Base
> >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below EFI
> >+/// encodings as per the PCI hardware terminology. If this data member
> >value
> >+/// is returned as 0 than there is no platform policy to override, this
> feature
> >+/// would be enabled as per its PCI specification based on the device
> >capabilities.
> >+/// Below is it data type and the macro definitions which the driver uses
> for
> >+/// interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> >+
> >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for override
> >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable state
> >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe link's Clock configuration is common or
> discrete.
> >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate
> >the
> >+/// below EFI encodings as per the PCI hardware terminology. If this data
> >member
> >+/// value is returned as 0 than there is no platform policy to override, this
> >+/// feature would be enabled as per its PCI specification based on the
> device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> >+
> >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for
> override
> >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default
> >asynchronous clock
> >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to common
> clock
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe link's Extended Synch enable or disable.
> >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to translate
> >the
> >+/// below EFI encodings as per the PCI hardware terminology. If this data
> >member
> >+/// value is returned as 0 than there is no platform policy to override, this
> >+/// feature would be enabled as per its PCI specification based on the
> device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> >+
> >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request for
> override
> >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default
> disable
> >state
> >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable
> state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's AtomicOp Requester enable or
> disable.
> >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> translate
> >the
> >+/// below EFI encodings as per the PCI hardware terminology. If this data
> >member
> >+/// value is returned as 0 than there is no platform policy to override, this
> >+/// feature would be enabled as per its PCI specification based on the
> device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> >+
> >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request for
> >override
> >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default
> disable
> >state
> >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable
> state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's LTR Mechanism enable/disable.
> >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> translate
> >the
> >+/// below EFI encodings as per the PCI hardware terminology. If this data
> >member
> >+/// value is returned as 0 than there is no platform policy to override, this
> >+/// feature would be enabled as per its PCI specification based on the
> device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_LTR;
> >+
> >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for override
> >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable state
> >+#define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable state
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's Precision Time Measurement (PTM)
> >enable/disable.
> >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> translate
> >the
> >+/// below EFI encodings as per the PCI hardware terminology. If this data
> >member
> >+/// value is returned as 0 than there is no platform policy to override, this
> >+/// feature would be enabled as per its PCI specification based on the
> device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_PTM;
> >+
> >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> override
> >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default disable
> state
> >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state
> only
> >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select &
> enable
> >+
> >+///
> >+/// This data type is to retrieve the PCI device platform policy for the PCI-
> >+/// compliant feature PCIe Device's Completion Timeout (CTO) set to
> >supported ranges
> >+/// or disable. Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> to
> >+/// translate the below EFI encodings as per the PCI hardware terminology.
> If
> >this
> >+/// data member value is returned as 0 than there is no platform policy to
> >override,
> >+/// this feature would be enabled as per its PCI specification based on the
> >device
> >+/// capabilities. Below is its data type and the macro definitions which the
> >+/// driver uses for interpreting the platform policy.
> >+///
> >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> >+
> >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for
> override
> >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default range
> of 5us
> >to 50ms if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of 50us
> to
> >100us if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of 1ms
> to
> >10ms if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of
> 16ms to
> >55ms if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of
> 65ms to
> >210ms if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of
> 260ms to
> >900ms if applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of 1s
> to 3.5s if
> >applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of 4s
> to 13s if
> >applicable
> >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of 17s
> to 64s
> >if applicable
> >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO detection
> >disable if applicable
> >+
> >+///
> >+/// Reserves for future use
> >+///
> >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> >+
> >+///
> >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether 128-byte
> size,
> >with each
> >+/// byte field representing one PCI standerd feature defined in the PCI
> >Express Base
> >+/// Specification 4.0, version 1.0.
> >+///
> >+typedef struct {
> >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> >+ EFI_PCI_CONF_PTM PTMControl;
> >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> >+ EFI_PCI_CONF_RESERVES Reserves[116];
> >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> >+
> >+/**
> >+ Retrieves the PCI device-specific platform policy regarding
> enumeration.
> >+
> >+ The PCI Bus driver and PCI Host Bridge Resource Allocation Protocol
> drivers
> >+ can call this member function to retrieve the platform policies specific
> to
> >+ PCI device, regarding the PCI enumeration.
> >+
> >+ The GetDevicePolicy() function retrieves the platform policy for a
> particular
> >+ component regarding PCI enumeration. The PCI bus driver and the PCI
> Host
> >Bridge
> >+ Resource Allocation Protocol driver can call this member function to
> retrieve
> >+ the policy.
> >+ The existing GetPlatformPolicy() member function is used by the PCI Bus
> >driver
> >+ to program the legacy ranges, the data that is returned by that member
> >function
> >+ determines the supported attributes that are returned by the
> >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> >+ The GetDevicePolicy() member function is meant to return data about
> >other PCI
> >+ compliant features which would be supported by the PCI Bus driver in
> >future;
> >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The details
> >about
> >+ this PCI features can be obtained from the PCI Base Specification 4.x.
> The
> >+ EFI encodings for these feature are defined in the
> >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition
> section
> >for this.
> >+ This member function will use the associated EFI handle of the PCI IO
> >Protocol
> >+ to determine the physical PCI device within the chipset, to return its
> >+ device-specific platform policies.
> >+
> >+ @param[in] This Pointer to the
> EFI_PCI_PLATFORM_PROTOCOL2
> >instance.
> >+ @param[in] PciDevice The associated PCI IO Protocol handle of
> the PCI
> >+ device. Type EFI_HANDLE is defined in
> >+ InstallProtocolInterface() in the UEFI
> 2.1
> >+ Specification
> >+ @param[in] PciExtPolicy The platform policy with respect to other
> PCI
> >features
> >+ like, the MPS, MRRS, etc. Type
> >EFI_PCI_PLATFORM_EXTENDED_POLICY
> >+ is defined in "Related Definitions"
> below.
> >+
> >+
> >+ @retval EFI_SUCCESS The function completed
> successfully, may
> >returns
> >+ platform policy data for the given
> PCI component
> >+ @retval EFI_UNSUPPORTED PCI component belongs to PCI
> topology but
> >not
> >+ part of chipset to provide the
> platform policy
> >+ @retval EFI_INVALID_PARAMETER If any of the input parameters are
> >passed with
> >+ invalid data
> >+
> >+ **/
> >+typedef
> >+EFI_STATUS
> >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> >+ IN EFI_HANDLE PciDevice,
> >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy
> >+);
> >+
> >+///
> >+/// This protocol provides the interface between the PCI bus driver/PCI
> Host
> >+/// Bridge Resource Allocation driver and a platform-specific driver to
> >describe
> >+/// the unique features of a platform.
> >+///
> >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> >+ ///
> >+ /// The notification from the PCI bus enumerator to the platform that it
> is
> >about to
> >+ /// enter a certain phase during the enumeration process.
> >+ ///
> >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> >+ ///
> >+ /// The notification from the PCI bus enumerator to the platform for
> each
> >PCI
> >+ /// controller at several predefined points during PCI controller
> initialization.
> >+ ///
> >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> PlatformPrepController;
> >+ ///
> >+ /// Retrieves the platform policy regarding enumeration.
> >+ ///
> >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
> >+ ///
> >+ /// Gets the PCI device's option ROM from a platform-specific location.
> >+ ///
> >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> >+ ///
> >+ /// Retrieves the PCI device-specific platform policy regarding
> enumeration.
> >+ ///
> >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
> >+ ///
> >+ /// The major version of this PCI Platform Protocol
> >+ ///
> >+ UINT8 MajorVersion;
> >+ ///
> >+ /// The minor version of this PCI Platform Protocol
> >+ ///
> >+ UINT8 MinorVersion;
> >+
> >+};
> >+
> >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> >+
> >+#endif
> >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
> >index b382efd578..670b448031 100644
> >--- a/MdePkg/MdePkg.dec
> >+++ b/MdePkg/MdePkg.dec
> >@@ -1013,6 +1013,12 @@
> > ## Include/Protocol/PciOverride.h
> > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06,
> {0x99, 0xfc,
> >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> >
> >+ ## Include/Protocol/PciPlatform2.h
> >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60,
> { 0x8d, 0x34,
> >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> >+
> >+ ## Include/Protocol/PciOverride2.h
> >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546,
> { 0xb0, 0xbb,
> >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> >+
> > ## Include/Protocol/PciEnumerationComplete.h
> > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7, 0x3de1,
> 0x4586,
> >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> >
> >--
> >2.21.0.windows.1
>
>
>
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 8:05 ` [edk2-devel] " Yao, Jiewen
@ 2019-07-29 8:12 ` Javeed, Ashraf
2019-07-29 8:56 ` Yao, Jiewen
0 siblings, 1 reply; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-29 8:12 UTC (permalink / raw)
To: Yao, Jiewen, devel@edk2.groups.io, Gao, Liming; +Cc: Kinney, Michael D, Ni, Ray
Hi Yao Jiewen,
Can you please elaborate your concern?
The PCI Platform Protocol / PCI Override Protocol are defined in PI Spec 1.7. These same protocols are enhanced here.
The producer would be the platform firmware, and consumer would be the MdeModulePkg's PCI Bus driver.
The detailed document is attached to Bugzilla feature request Id 1954.
Thanks
Ashraf
> -----Original Message-----
> From: Yao, Jiewen
> Sent: Monday, July 29, 2019 1:36 PM
> To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>; Javeed, Ashraf
> <ashraf.javeed@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> Hi
> I think this policy protocol should be EDKII specific. Currently it is no in PI spec.
> Should it be in MdeModulePkg ?
>
> Thank you
> Yao Jiewen
>
> > -----Original Message-----
> > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of
> > Liming Gao
> > Sent: Monday, July 29, 2019 3:52 PM
> > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > Ashraf:
> > For new files, please use license: SPDX-License-Identifier:
> > BSD-2-Clause-Patent.
> >
> > Other change is good. Reviewed-by: Liming Gao <liming.gao@intel.com>
> >
> > Thanks
> > Liming
> > >-----Original Message-----
> > >From: Javeed, Ashraf
> > >Sent: Monday, July 29, 2019 2:52 PM
> > >To: devel@edk2.groups.io
> > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> > ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols:
> > >New interface, EFI encodings to PCI Plat protocol
> > >
> > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > >
> > >New interface added to PCI Platform Protocol / PCI Override Protocol
> > >to retrieve device-specific platform policy for the following PCI
> > >standard features, like Maximum Payload Size (MPS), Maximum Read
> > >Request Size (MRRS),Extended Tags, Relax Order, No-Snoop, Active
> > >State Power Management (ASPM),Latency Time Reporting (LTR), AtomicOp,
> > >Reference Clock Configuration, Extended SYNCH, PTM support, and
> > >Completion Timeout
> > (CTO).
> > >New source files added with enhanced definitions are in:
> > >MdePkg/Include/Protocol/PciPlatform2.h,
> > >MdePkg/Include/Protocol/PciOverride2.h
> > >
> > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > >Cc: Liming Gao <liming.gao@intel.com>
> > >Cc: Ray Ni <ray.ni@intel.com>
> > >---
> > >
> > >In V2: Correction made to header sections of source files
> > >---
> > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > >+++++++++++++++++++++++++++++++++++++++++++
> > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > >+++++++++++++++++++++++++++++++++++++++
> > > MdePkg/MdePkg.dec | 6 ++++++
> > > 3 files changed, 442 insertions(+)
> > >
> > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > >b/MdePkg/Include/Protocol/PciOverride2.h
> > >new file mode 100644
> > >index 0000000000..a7f541b4c3
> > >--- /dev/null
> > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > >@@ -0,0 +1,43 @@
> > >+/** @file
> > >+ This file declares EFI PCI Override protocol which provides the
> > >+interface
> > >between
> > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and
> > >+ an
> > >implementation's
> > >+ driver to describe the unique features of a platform.
> > >+ This protocol is optional.
> > >+
> > >+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> > >+ This program and the accompanying materials are licensed and made
> > >+ available under the terms and conditions of the
> > BSD
> > >License
> > >+ which accompanies this distribution. The full text of the license
> > >+ may
> > be
> > >found at
> > >+ http://opensource.org/licenses/bsd-license.php
> > >+
> > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS
> > IS"
> > >BASIS,
> > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> > >EXPRESS OR IMPLIED.
> > >+
> > >+
> > >+**/
> > >+
> > >+#ifndef _PCI_OVERRIDE2_H_
> > >+#define _PCI_OVERRIDE2_H_
> > >+
> > >+///
> > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > >EFI_PCI_PLATFORM_PROTOCOL
> > >+///
> > >+#include <Protocol/PciPlatform2.h>
> > >+
> > >+///
> > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > >+EFI_PCI_OVERRIDE2_GUID \
> > >+ { \
> > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9,
> > 0x42, 0x47}
> > >\
> > >+ }
> > >+
> > >+///
> > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > >+EFI_PCI_PLATFORM_PROTOCOL2
> > EFI_PCI_OVERRIDE_PROTOCOL2;
> > >+
> > >+
> > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > >+
> > >+#endif
> > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > >new file mode 100644
> > >index 0000000000..717938e68d
> > >--- /dev/null
> > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > >@@ -0,0 +1,393 @@
> > >+/** @file
> > >+ This file declares PCI Platform Protocol that provide the
> > >+interface
> > between
> > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and
> > >+ a
> > >platform-specific
> > >+ driver to describe the unique features of a platform.
> > >+ This protocol is optional.
> > >+
> > >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR> This
> > >+program and the accompanying materials are licensed and made
> > >available under
> > >+the terms and conditions of the BSD License that accompanies this
> > >distribution.
> > >+The full text of the license may be found at
> > >+http://opensource.org/licenses/bsd-license.php.
> > >+
> > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
> > >BASIS,
> > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> > >EXPRESS OR IMPLIED.
> > >+
> > >+
> > >+**/
> > >+
> > >+#ifndef _PCI_PLATFORM2_H_
> > >+#define _PCI_PLATFORM2_H_
> > >+
> > >+///
> > >+/// This file must be included because the
> > EFI_PCI_PLATFORM_PROTOCOL2
> > >uses
> > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > >+///
> > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > >+
> > >+///
> > >+/// Reuse the existing definition to maintain backward compatibility
> > >+/// #include <Protocol/PciPlatform.h>
> > >+
> > >+///
> > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > >+///
> > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > >+ { \
> > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88, 0xd2,
> > 0xd0,
> > >0xb6} \
> > >+ }
> > >+
> > >+///
> > >+/// As per the present definition and specification of this
> > >+protocol, the
> > major
> > >+/// version is 1, and minor version is 1. Any driver utilizing this
> > >+protocol /// shall use these versions number to maintain the
> > >+backward
> > compatibility
> > >as
> > >+/// per its specification changes in future.
> > >+///
> > >+enum EfiPciPlatformProtocolVersion {
> > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > >+
> > >+///
> > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > >+///
> > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > >EFI_PCI_PLATFORM_PROTOCOL2;
> > >+
> > >+///
> > >+/// Following are the data types for
> > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > >+/// each for the PCI standard feature and its corresponding bitmask
> > >+/// representing the valid combinations of PCI attributes ///
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature Maximum Payload Size (MPS). Refer to
> > >+PCI Base
> > >Specification
> > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings
> > >+as per
> > >the
> > >+/// PCI hardware terminology. If this data member value is returned
> > >+as 0
> > >than
> > >+/// there is no platform policy to override, this feature would be
> > >+enabled
> > as
> > >+/// per its PCI specification based on the device capabilities.
> > >+Below is it /// data type and the macro definitions which the driver
> > >+uses for
> > interpreting
> > >+/// the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > >+
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No
> > request for
> > >override
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to
> > default
> > >128B
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to
> > 256B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to
> > 512B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to
> > 1024B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to
> > 2048B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to
> > 4096B if
> > >applicable
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature Maximum Read Request Size (MRRS).
> > >+Refer to PCI
> > >Base
> > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > >+member
> > >value
> > >+/// is returned as 0 than there is no platform policy to override,
> > >+this
> > feature
> > >+/// would be enabled as per its PCI specification based on the
> > >+device
> > >capabilities.
> > >+/// Below is it data type and the macro definitions which the driver
> > >+uses
> > for
> > >+/// interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > >+
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No
> > request
> > >for override
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to
> > default
> > >128B
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to
> > 256B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to
> > 512B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to
> > 1024B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to
> > 2048B if
> > >applicable
> > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to
> > 4096B if
> > >applicable
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature Extended Tags. Refer to PCI Base
> > >+Specification /// 4, (chapter 7.5.3.4) on how to translate the below
> > >+EFI encodings as per
> > >the
> > >+/// PCI hardware terminology. If this data member value is returned
> > >+as 0
> > >than
> > >+/// there is no platform policy to override, this feature would be
> > >+enabled
> > as
> > >+/// per its PCI specification based on the device capabilities.
> > >+Below is it /// data type and the macro definitions which the driver
> > >+uses for
> > interpreting
> > >+/// the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > >+
> > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No request
> > for
> > >override
> > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to default
> > 5-bit
> > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit if
> > >applicable
> > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit if
> > >applicable
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe link's Active State Power Mgmt
> > >+(ASPM). Refer
> > to
> > >PCI Base
> > >+/// Specification 4, (chapter 7.5.3.7) on how to translate the below
> > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > >+member
> > >value
> > >+/// is returned as 0 than there is no platform policy to override,
> > >+this
> > feature
> > >+/// would be enabled as per its PCI specification based on the
> > >+device
> > >capabilities.
> > >+/// Below is it data type and the macro definitions which the driver
> > >+uses
> > for
> > >+/// interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > >+
> > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request for
> > override
> > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to default
> > disable
> > >state
> > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s state
> > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1 state
> > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s and
> > L1
> > >state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's Relax Ordering
> > >+enable/disable. Refer
> > to
> > >PCI Base
> > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > >+member
> > >value
> > >+/// is returned as 0 than there is no platform policy to override,
> > >+this
> > feature
> > >+/// would be enabled as per its PCI specification based on the
> > >+device
> > >capabilities.
> > >+/// Below is it data type and the macro definitions which the driver
> > >+uses
> > for
> > >+/// interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > >+
> > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for override
> > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable
> > state
> > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's No-Snoop
> > >+enable/disable. Refer to PCI
> > >Base
> > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > >+member
> > >value
> > >+/// is returned as 0 than there is no platform policy to override,
> > >+this
> > feature
> > >+/// would be enabled as per its PCI specification based on the
> > >+device
> > >capabilities.
> > >+/// Below is it data type and the macro definitions which the driver
> > >+uses
> > for
> > >+/// interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > >+
> > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for override
> > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable state
> > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe link's Clock configuration is
> > >+common or
> > discrete.
> > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to
> > >+translate
> > >the
> > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > >+data
> > >member
> > >+/// value is returned as 0 than there is no platform policy to
> > >+override, this /// feature would be enabled as per its PCI
> > >+specification based on the
> > device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > >+
> > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for
> > override
> > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default
> > >asynchronous clock
> > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to common
> > clock
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe link's Extended Synch enable or disable.
> > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to
> > >+translate
> > >the
> > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > >+data
> > >member
> > >+/// value is returned as 0 than there is no platform policy to
> > >+override, this /// feature would be enabled as per its PCI
> > >+specification based on the
> > device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > >+
> > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request for
> > override
> > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default
> > disable
> > >state
> > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable
> > state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's AtomicOp Requester
> > >+enable or
> > disable.
> > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > translate
> > >the
> > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > >+data
> > >member
> > >+/// value is returned as 0 than there is no platform policy to
> > >+override, this /// feature would be enabled as per its PCI
> > >+specification based on the
> > device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > >+
> > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request for
> > >override
> > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default
> > disable
> > >state
> > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable
> > state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's LTR Mechanism enable/disable.
> > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > translate
> > >the
> > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > >+data
> > >member
> > >+/// value is returned as 0 than there is no platform policy to
> > >+override, this /// feature would be enabled as per its PCI
> > >+specification based on the
> > device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > >+
> > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for override
> > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable
> > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable state
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's Precision Time
> > >+Measurement (PTM)
> > >enable/disable.
> > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > translate
> > >the
> > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > >+data
> > >member
> > >+/// value is returned as 0 than there is no platform policy to
> > >+override, this /// feature would be enabled as per its PCI
> > >+specification based on the
> > device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > >+
> > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> > override
> > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default disable
> > state
> > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state
> > only
> > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select &
> > enable
> > >+
> > >+///
> > >+/// This data type is to retrieve the PCI device platform policy for
> > >+the PCI- /// compliant feature PCIe Device's Completion Timeout
> > >+(CTO) set to
> > >supported ranges
> > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > >+7.5.3.16) on how
> > to
> > >+/// translate the below EFI encodings as per the PCI hardware terminology.
> > If
> > >this
> > >+/// data member value is returned as 0 than there is no platform
> > >+policy to
> > >override,
> > >+/// this feature would be enabled as per its PCI specification based
> > >+on the
> > >device
> > >+/// capabilities. Below is its data type and the macro definitions
> > >+which the /// driver uses for interpreting the platform policy.
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > >+
> > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for
> > override
> > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default range
> > of 5us
> > >to 50ms if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of 50us
> > to
> > >100us if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of 1ms
> > to
> > >10ms if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of
> > 16ms to
> > >55ms if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of
> > 65ms to
> > >210ms if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of
> > 260ms to
> > >900ms if applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of 1s
> > to 3.5s if
> > >applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of 4s
> > to 13s if
> > >applicable
> > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of 17s
> > to 64s
> > >if applicable
> > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO detection
> > >disable if applicable
> > >+
> > >+///
> > >+/// Reserves for future use
> > >+///
> > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > >+
> > >+///
> > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether 128-byte
> > size,
> > >with each
> > >+/// byte field representing one PCI standerd feature defined in the
> > >+PCI
> > >Express Base
> > >+/// Specification 4.0, version 1.0.
> > >+///
> > >+typedef struct {
> > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > >+ EFI_PCI_CONF_PTM PTMControl;
> > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > >+
> > >+/**
> > >+ Retrieves the PCI device-specific platform policy regarding
> > enumeration.
> > >+
> > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > >+ Protocol
> > drivers
> > >+ can call this member function to retrieve the platform policies
> > >+ specific
> > to
> > >+ PCI device, regarding the PCI enumeration.
> > >+
> > >+ The GetDevicePolicy() function retrieves the platform policy for a
> > particular
> > >+ component regarding PCI enumeration. The PCI bus driver and the
> > >+ PCI
> > Host
> > >Bridge
> > >+ Resource Allocation Protocol driver can call this member function
> > >+ to
> > retrieve
> > >+ the policy.
> > >+ The existing GetPlatformPolicy() member function is used by the
> > >+ PCI Bus
> > >driver
> > >+ to program the legacy ranges, the data that is returned by that
> > >+ member
> > >function
> > >+ determines the supported attributes that are returned by the
> > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > >+ The GetDevicePolicy() member function is meant to return data
> > >+ about
> > >other PCI
> > >+ compliant features which would be supported by the PCI Bus driver
> > >+ in
> > >future;
> > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The
> > >+ details
> > >about
> > >+ this PCI features can be obtained from the PCI Base Specification 4.x.
> > The
> > >+ EFI encodings for these feature are defined in the
> > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition
> > section
> > >for this.
> > >+ This member function will use the associated EFI handle of the PCI
> > >+ IO
> > >Protocol
> > >+ to determine the physical PCI device within the chipset, to return
> > >+ its device-specific platform policies.
> > >+
> > >+ @param[in] This Pointer to the
> > EFI_PCI_PLATFORM_PROTOCOL2
> > >instance.
> > >+ @param[in] PciDevice The associated PCI IO Protocol handle of
> > the PCI
> > >+ device. Type EFI_HANDLE is defined in
> > >+ InstallProtocolInterface() in the UEFI
> > 2.1
> > >+ Specification @param[in] PciExtPolicy
> > >+ The platform policy with respect to other
> > PCI
> > >features
> > >+ like, the MPS, MRRS, etc. Type
> > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > >+ is defined in "Related Definitions"
> > below.
> > >+
> > >+
> > >+ @retval EFI_SUCCESS The function completed
> > successfully, may
> > >returns
> > >+ platform policy data for the given
> > PCI component
> > >+ @retval EFI_UNSUPPORTED PCI component belongs to PCI
> > topology but
> > >not
> > >+ part of chipset to provide the
> > platform policy
> > >+ @retval EFI_INVALID_PARAMETER If any of the input parameters are
> > >passed with
> > >+ invalid data
> > >+
> > >+ **/
> > >+typedef
> > >+EFI_STATUS
> > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > >+ IN EFI_HANDLE PciDevice,
> > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > >+
> > >+///
> > >+/// This protocol provides the interface between the PCI bus
> > >+driver/PCI
> > Host
> > >+/// Bridge Resource Allocation driver and a platform-specific driver
> > >+to
> > >describe
> > >+/// the unique features of a platform.
> > >+///
> > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > >+ ///
> > >+ /// The notification from the PCI bus enumerator to the platform
> > >+that it
> > is
> > >about to
> > >+ /// enter a certain phase during the enumeration process.
> > >+ ///
> > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> > >+ ///
> > >+ /// The notification from the PCI bus enumerator to the platform
> > >+ for
> > each
> > >PCI
> > >+ /// controller at several predefined points during PCI controller
> > initialization.
> > >+ ///
> > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > PlatformPrepController;
> > >+ ///
> > >+ /// Retrieves the platform policy regarding enumeration.
> > >+ ///
> > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY GetPlatformPolicy;
> > >+ ///
> > >+ /// Gets the PCI device's option ROM from a platform-specific location.
> > >+ ///
> > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > >+ ///
> > >+ /// Retrieves the PCI device-specific platform policy regarding
> > enumeration.
> > >+ ///
> > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
> > >+ ///
> > >+ /// The major version of this PCI Platform Protocol ///
> > >+ UINT8 MajorVersion;
> > >+ ///
> > >+ /// The minor version of this PCI Platform Protocol ///
> > >+ UINT8 MinorVersion;
> > >+
> > >+};
> > >+
> > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > >+
> > >+#endif
> > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > >b382efd578..670b448031 100644
> > >--- a/MdePkg/MdePkg.dec
> > >+++ b/MdePkg/MdePkg.dec
> > >@@ -1013,6 +1013,12 @@
> > > ## Include/Protocol/PciOverride.h
> > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06,
> > {0x99, 0xfc,
> > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > >
> > >+ ## Include/Protocol/PciPlatform2.h
> > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60,
> > { 0x8d, 0x34,
> > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > >+
> > >+ ## Include/Protocol/PciOverride2.h
> > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546,
> > { 0xb0, 0xbb,
> > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > >+
> > > ## Include/Protocol/PciEnumerationComplete.h
> > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7, 0x3de1,
> > 0x4586,
> > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > >
> > >--
> > >2.21.0.windows.1
> >
> >
> >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 8:12 ` Javeed, Ashraf
@ 2019-07-29 8:56 ` Yao, Jiewen
2019-07-29 11:17 ` Javeed, Ashraf
0 siblings, 1 reply; 13+ messages in thread
From: Yao, Jiewen @ 2019-07-29 8:56 UTC (permalink / raw)
To: Javeed, Ashraf, devel@edk2.groups.io, Gao, Liming
Cc: Kinney, Michael D, Ni, Ray
Oh. This patch is for staging. Not for EDKII master, right?
If so, I have no concern.
For the master, I think MdePkg should only include what has been defined.
For this patch, I am curious on how to maintain the compatibility?
For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
It seems weird to bind a PI protocol to another industry standard. We had better decouple them.
As such, we don't need update PI spec again and again just because PCIE spec update.
Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need update protocol interface just because they are updated.
Thank you
Yao Jiewen
> -----Original Message-----
> From: Javeed, Ashraf
> Sent: Monday, July 29, 2019 4:12 PM
> To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> Hi Yao Jiewen,
> Can you please elaborate your concern?
> The PCI Platform Protocol / PCI Override Protocol are defined in PI Spec 1.7.
> These same protocols are enhanced here.
> The producer would be the platform firmware, and consumer would be the
> MdeModulePkg's PCI Bus driver.
> The detailed document is attached to Bugzilla feature request Id 1954.
>
> Thanks
> Ashraf
>
> > -----Original Message-----
> > From: Yao, Jiewen
> > Sent: Monday, July 29, 2019 1:36 PM
> > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>; Javeed,
> Ashraf
> > <ashraf.javeed@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > Hi
> > I think this policy protocol should be EDKII specific. Currently it is no in PI
> spec.
> > Should it be in MdeModulePkg ?
> >
> > Thank you
> > Yao Jiewen
> >
> > > -----Original Message-----
> > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf
> Of
> > > Liming Gao
> > > Sent: Monday, July 29, 2019 3:52 PM
> > > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > Ashraf:
> > > For new files, please use license: SPDX-License-Identifier:
> > > BSD-2-Clause-Patent.
> > >
> > > Other change is good. Reviewed-by: Liming Gao
> <liming.gao@intel.com>
> > >
> > > Thanks
> > > Liming
> > > >-----Original Message-----
> > > >From: Javeed, Ashraf
> > > >Sent: Monday, July 29, 2019 2:52 PM
> > > >To: devel@edk2.groups.io
> > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> > > ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > MdePkg/Protocols:
> > > >New interface, EFI encodings to PCI Plat protocol
> > > >
> > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > >
> > > >New interface added to PCI Platform Protocol / PCI Override Protocol
> > > >to retrieve device-specific platform policy for the following PCI
> > > >standard features, like Maximum Payload Size (MPS), Maximum Read
> > > >Request Size (MRRS),Extended Tags, Relax Order, No-Snoop, Active
> > > >State Power Management (ASPM),Latency Time Reporting (LTR),
> AtomicOp,
> > > >Reference Clock Configuration, Extended SYNCH, PTM support, and
> > > >Completion Timeout
> > > (CTO).
> > > >New source files added with enhanced definitions are in:
> > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > >MdePkg/Include/Protocol/PciOverride2.h
> > > >
> > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > >Cc: Liming Gao <liming.gao@intel.com>
> > > >Cc: Ray Ni <ray.ni@intel.com>
> > > >---
> > > >
> > > >In V2: Correction made to header sections of source files
> > > >---
> > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > > >+++++++++++++++++++++++++++++++++++++++
> > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > 3 files changed, 442 insertions(+)
> > > >
> > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > >new file mode 100644
> > > >index 0000000000..a7f541b4c3
> > > >--- /dev/null
> > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > >@@ -0,0 +1,43 @@
> > > >+/** @file
> > > >+ This file declares EFI PCI Override protocol which provides the
> > > >+interface
> > > >between
> > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and
> > > >+ an
> > > >implementation's
> > > >+ driver to describe the unique features of a platform.
> > > >+ This protocol is optional.
> > > >+
> > > >+ Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> > > >+ This program and the accompanying materials are licensed and
> made
> > > >+ available under the terms and conditions of the
> > > BSD
> > > >License
> > > >+ which accompanies this distribution. The full text of the license
> > > >+ may
> > > be
> > > >found at
> > > >+ http://opensource.org/licenses/bsd-license.php
> > > >+
> > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> "AS
> > > IS"
> > > >BASIS,
> > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> EITHER
> > > >EXPRESS OR IMPLIED.
> > > >+
> > > >+
> > > >+**/
> > > >+
> > > >+#ifndef _PCI_OVERRIDE2_H_
> > > >+#define _PCI_OVERRIDE2_H_
> > > >+
> > > >+///
> > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > >EFI_PCI_PLATFORM_PROTOCOL
> > > >+///
> > > >+#include <Protocol/PciPlatform2.h>
> > > >+
> > > >+///
> > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > > >+EFI_PCI_OVERRIDE2_GUID \
> > > >+ { \
> > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae, 0xd9,
> > > 0x42, 0x47}
> > > >\
> > > >+ }
> > > >+
> > > >+///
> > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > >+
> > > >+
> > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > >+
> > > >+#endif
> > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > >new file mode 100644
> > > >index 0000000000..717938e68d
> > > >--- /dev/null
> > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > >@@ -0,0 +1,393 @@
> > > >+/** @file
> > > >+ This file declares PCI Platform Protocol that provide the
> > > >+interface
> > > between
> > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver and
> > > >+ a
> > > >platform-specific
> > > >+ driver to describe the unique features of a platform.
> > > >+ This protocol is optional.
> > > >+
> > > >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR> This
> > > >+program and the accompanying materials are licensed and made
> > > >available under
> > > >+the terms and conditions of the BSD License that accompanies this
> > > >distribution.
> > > >+The full text of the license may be found at
> > > >+http://opensource.org/licenses/bsd-license.php.
> > > >+
> > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS
> IS"
> > > >BASIS,
> > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> > > >EXPRESS OR IMPLIED.
> > > >+
> > > >+
> > > >+**/
> > > >+
> > > >+#ifndef _PCI_PLATFORM2_H_
> > > >+#define _PCI_PLATFORM2_H_
> > > >+
> > > >+///
> > > >+/// This file must be included because the
> > > EFI_PCI_PLATFORM_PROTOCOL2
> > > >uses
> > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > >+///
> > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > >+
> > > >+///
> > > >+/// Reuse the existing definition to maintain backward compatibility
> > > >+/// #include <Protocol/PciPlatform.h>
> > > >+
> > > >+///
> > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > >+///
> > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > >+ { \
> > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88,
> 0xd2,
> > > 0xd0,
> > > >0xb6} \
> > > >+ }
> > > >+
> > > >+///
> > > >+/// As per the present definition and specification of this
> > > >+protocol, the
> > > major
> > > >+/// version is 1, and minor version is 1. Any driver utilizing this
> > > >+protocol /// shall use these versions number to maintain the
> > > >+backward
> > > compatibility
> > > >as
> > > >+/// per its specification changes in future.
> > > >+///
> > > >+enum EfiPciPlatformProtocolVersion {
> > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > >+
> > > >+///
> > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > >+///
> > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > >+
> > > >+///
> > > >+/// Following are the data types for
> > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > >+/// each for the PCI standard feature and its corresponding bitmask
> > > >+/// representing the valid combinations of PCI attributes ///
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature Maximum Payload Size (MPS). Refer to
> > > >+PCI Base
> > > >Specification
> > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI encodings
> > > >+as per
> > > >the
> > > >+/// PCI hardware terminology. If this data member value is returned
> > > >+as 0
> > > >than
> > > >+/// there is no platform policy to override, this feature would be
> > > >+enabled
> > > as
> > > >+/// per its PCI specification based on the device capabilities.
> > > >+Below is it /// data type and the macro definitions which the driver
> > > >+uses for
> > > interpreting
> > > >+/// the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > >+
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No
> > > request for
> > > >override
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to
> > > default
> > > >128B
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to
> > > 256B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to
> > > 512B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to
> > > 1024B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to
> > > 2048B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to
> > > 4096B if
> > > >applicable
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature Maximum Read Request Size (MRRS).
> > > >+Refer to PCI
> > > >Base
> > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > > >+member
> > > >value
> > > >+/// is returned as 0 than there is no platform policy to override,
> > > >+this
> > > feature
> > > >+/// would be enabled as per its PCI specification based on the
> > > >+device
> > > >capabilities.
> > > >+/// Below is it data type and the macro definitions which the driver
> > > >+uses
> > > for
> > > >+/// interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > >+
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No
> > > request
> > > >for override
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to
> > > default
> > > >128B
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to
> > > 256B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to
> > > 512B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to
> > > 1024B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to
> > > 2048B if
> > > >applicable
> > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to
> > > 4096B if
> > > >applicable
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature Extended Tags. Refer to PCI Base
> > > >+Specification /// 4, (chapter 7.5.3.4) on how to translate the below
> > > >+EFI encodings as per
> > > >the
> > > >+/// PCI hardware terminology. If this data member value is returned
> > > >+as 0
> > > >than
> > > >+/// there is no platform policy to override, this feature would be
> > > >+enabled
> > > as
> > > >+/// per its PCI specification based on the device capabilities.
> > > >+Below is it /// data type and the macro definitions which the driver
> > > >+uses for
> > > interpreting
> > > >+/// the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > >+
> > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> request
> > > for
> > > >override
> > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> default
> > > 5-bit
> > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit
> if
> > > >applicable
> > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit
> if
> > > >applicable
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe link's Active State Power Mgmt
> > > >+(ASPM). Refer
> > > to
> > > >PCI Base
> > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate the below
> > > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > > >+member
> > > >value
> > > >+/// is returned as 0 than there is no platform policy to override,
> > > >+this
> > > feature
> > > >+/// would be enabled as per its PCI specification based on the
> > > >+device
> > > >capabilities.
> > > >+/// Below is it data type and the macro definitions which the driver
> > > >+uses
> > > for
> > > >+/// interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > >+
> > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request
> for
> > > override
> > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> default
> > > disable
> > > >state
> > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s
> state
> > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1
> state
> > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s
> and
> > > L1
> > > >state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's Relax Ordering
> > > >+enable/disable. Refer
> > > to
> > > >PCI Base
> > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > > >+member
> > > >value
> > > >+/// is returned as 0 than there is no platform policy to override,
> > > >+this
> > > feature
> > > >+/// would be enabled as per its PCI specification based on the
> > > >+device
> > > >capabilities.
> > > >+/// Below is it data type and the macro definitions which the driver
> > > >+uses
> > > for
> > > >+/// interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > >+
> > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> override
> > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable
> > > state
> > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's No-Snoop
> > > >+enable/disable. Refer to PCI
> > > >Base
> > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the below
> > > >+EFI /// encodings as per the PCI hardware terminology. If this data
> > > >+member
> > > >value
> > > >+/// is returned as 0 than there is no platform policy to override,
> > > >+this
> > > feature
> > > >+/// would be enabled as per its PCI specification based on the
> > > >+device
> > > >capabilities.
> > > >+/// Below is it data type and the macro definitions which the driver
> > > >+uses
> > > for
> > > >+/// interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > >+
> > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> override
> > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable
> state
> > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe link's Clock configuration is
> > > >+common or
> > > discrete.
> > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to
> > > >+translate
> > > >the
> > > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > > >+data
> > > >member
> > > >+/// value is returned as 0 than there is no platform policy to
> > > >+override, this /// feature would be enabled as per its PCI
> > > >+specification based on the
> > > device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > >+
> > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for
> > > override
> > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default
> > > >asynchronous clock
> > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> common
> > > clock
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe link's Extended Synch enable or
> disable.
> > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how to
> > > >+translate
> > > >the
> > > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > > >+data
> > > >member
> > > >+/// value is returned as 0 than there is no platform policy to
> > > >+override, this /// feature would be enabled as per its PCI
> > > >+specification based on the
> > > device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > >+
> > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request
> for
> > > override
> > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default
> > > disable
> > > >state
> > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable
> > > state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's AtomicOp Requester
> > > >+enable or
> > > disable.
> > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > > translate
> > > >the
> > > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > > >+data
> > > >member
> > > >+/// value is returned as 0 than there is no platform policy to
> > > >+override, this /// feature would be enabled as per its PCI
> > > >+specification based on the
> > > device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > >+
> > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request
> for
> > > >override
> > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default
> > > disable
> > > >state
> > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable
> > > state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's LTR Mechanism
> enable/disable.
> > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > > translate
> > > >the
> > > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > > >+data
> > > >member
> > > >+/// value is returned as 0 than there is no platform policy to
> > > >+override, this /// feature would be enabled as per its PCI
> > > >+specification based on the
> > > device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > >+
> > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> override
> > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable
> > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable
> state
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's Precision Time
> > > >+Measurement (PTM)
> > > >enable/disable.
> > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how to
> > > translate
> > > >the
> > > >+/// below EFI encodings as per the PCI hardware terminology. If this
> > > >+data
> > > >member
> > > >+/// value is returned as 0 than there is no platform policy to
> > > >+override, this /// feature would be enabled as per its PCI
> > > >+specification based on the
> > > device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > >+
> > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> > > override
> > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> disable
> > > state
> > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state
> > > only
> > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select
> &
> > > enable
> > > >+
> > > >+///
> > > >+/// This data type is to retrieve the PCI device platform policy for
> > > >+the PCI- /// compliant feature PCIe Device's Completion Timeout
> > > >+(CTO) set to
> > > >supported ranges
> > > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > > >+7.5.3.16) on how
> > > to
> > > >+/// translate the below EFI encodings as per the PCI hardware
> terminology.
> > > If
> > > >this
> > > >+/// data member value is returned as 0 than there is no platform
> > > >+policy to
> > > >override,
> > > >+/// this feature would be enabled as per its PCI specification based
> > > >+on the
> > > >device
> > > >+/// capabilities. Below is its data type and the macro definitions
> > > >+which the /// driver uses for interpreting the platform policy.
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > >+
> > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for
> > > override
> > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default
> range
> > > of 5us
> > > >to 50ms if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of
> 50us
> > > to
> > > >100us if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of
> 1ms
> > > to
> > > >10ms if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of
> > > 16ms to
> > > >55ms if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of
> > > 65ms to
> > > >210ms if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of
> > > 260ms to
> > > >900ms if applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of
> 1s
> > > to 3.5s if
> > > >applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of
> 4s
> > > to 13s if
> > > >applicable
> > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of
> 17s
> > > to 64s
> > > >if applicable
> > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> detection
> > > >disable if applicable
> > > >+
> > > >+///
> > > >+/// Reserves for future use
> > > >+///
> > > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > > >+
> > > >+///
> > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> 128-byte
> > > size,
> > > >with each
> > > >+/// byte field representing one PCI standerd feature defined in the
> > > >+PCI
> > > >Express Base
> > > >+/// Specification 4.0, version 1.0.
> > > >+///
> > > >+typedef struct {
> > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > >+
> > > >+/**
> > > >+ Retrieves the PCI device-specific platform policy regarding
> > > enumeration.
> > > >+
> > > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > > >+ Protocol
> > > drivers
> > > >+ can call this member function to retrieve the platform policies
> > > >+ specific
> > > to
> > > >+ PCI device, regarding the PCI enumeration.
> > > >+
> > > >+ The GetDevicePolicy() function retrieves the platform policy for a
> > > particular
> > > >+ component regarding PCI enumeration. The PCI bus driver and the
> > > >+ PCI
> > > Host
> > > >Bridge
> > > >+ Resource Allocation Protocol driver can call this member function
> > > >+ to
> > > retrieve
> > > >+ the policy.
> > > >+ The existing GetPlatformPolicy() member function is used by the
> > > >+ PCI Bus
> > > >driver
> > > >+ to program the legacy ranges, the data that is returned by that
> > > >+ member
> > > >function
> > > >+ determines the supported attributes that are returned by the
> > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > >+ The GetDevicePolicy() member function is meant to return data
> > > >+ about
> > > >other PCI
> > > >+ compliant features which would be supported by the PCI Bus driver
> > > >+ in
> > > >future;
> > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The
> > > >+ details
> > > >about
> > > >+ this PCI features can be obtained from the PCI Base Specification
> 4.x.
> > > The
> > > >+ EFI encodings for these feature are defined in the
> > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition
> > > section
> > > >for this.
> > > >+ This member function will use the associated EFI handle of the PCI
> > > >+ IO
> > > >Protocol
> > > >+ to determine the physical PCI device within the chipset, to return
> > > >+ its device-specific platform policies.
> > > >+
> > > >+ @param[in] This Pointer to the
> > > EFI_PCI_PLATFORM_PROTOCOL2
> > > >instance.
> > > >+ @param[in] PciDevice The associated PCI IO Protocol handle
> of
> > > the PCI
> > > >+ device. Type EFI_HANDLE is defined
> in
> > > >+ InstallProtocolInterface() in the
> UEFI
> > > 2.1
> > > >+ Specification @param[in]
> PciExtPolicy
> > > >+ The platform policy with respect to other
> > > PCI
> > > >features
> > > >+ like, the MPS, MRRS, etc. Type
> > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > >+ is defined in "Related Definitions"
> > > below.
> > > >+
> > > >+
> > > >+ @retval EFI_SUCCESS The function completed
> > > successfully, may
> > > >returns
> > > >+ platform policy data for the
> given
> > > PCI component
> > > >+ @retval EFI_UNSUPPORTED PCI component belongs to PCI
> > > topology but
> > > >not
> > > >+ part of chipset to provide the
> > > platform policy
> > > >+ @retval EFI_INVALID_PARAMETER If any of the input parameters
> are
> > > >passed with
> > > >+ invalid data
> > > >+
> > > >+ **/
> > > >+typedef
> > > >+EFI_STATUS
> > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > >+ IN EFI_HANDLE PciDevice,
> > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > >+
> > > >+///
> > > >+/// This protocol provides the interface between the PCI bus
> > > >+driver/PCI
> > > Host
> > > >+/// Bridge Resource Allocation driver and a platform-specific driver
> > > >+to
> > > >describe
> > > >+/// the unique features of a platform.
> > > >+///
> > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > >+ ///
> > > >+ /// The notification from the PCI bus enumerator to the platform
> > > >+that it
> > > is
> > > >about to
> > > >+ /// enter a certain phase during the enumeration process.
> > > >+ ///
> > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> > > >+ ///
> > > >+ /// The notification from the PCI bus enumerator to the platform
> > > >+ for
> > > each
> > > >PCI
> > > >+ /// controller at several predefined points during PCI controller
> > > initialization.
> > > >+ ///
> > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > PlatformPrepController;
> > > >+ ///
> > > >+ /// Retrieves the platform policy regarding enumeration.
> > > >+ ///
> > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> GetPlatformPolicy;
> > > >+ ///
> > > >+ /// Gets the PCI device's option ROM from a platform-specific
> location.
> > > >+ ///
> > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > >+ ///
> > > >+ /// Retrieves the PCI device-specific platform policy regarding
> > > enumeration.
> > > >+ ///
> > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
> > > >+ ///
> > > >+ /// The major version of this PCI Platform Protocol ///
> > > >+ UINT8 MajorVersion;
> > > >+ ///
> > > >+ /// The minor version of this PCI Platform Protocol ///
> > > >+ UINT8 MinorVersion;
> > > >+
> > > >+};
> > > >+
> > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > >+
> > > >+#endif
> > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > >b382efd578..670b448031 100644
> > > >--- a/MdePkg/MdePkg.dec
> > > >+++ b/MdePkg/MdePkg.dec
> > > >@@ -1013,6 +1013,12 @@
> > > > ## Include/Protocol/PciOverride.h
> > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06,
> > > {0x99, 0xfc,
> > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > >
> > > >+ ## Include/Protocol/PciPlatform2.h
> > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60,
> > > { 0x8d, 0x34,
> > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > >+
> > > >+ ## Include/Protocol/PciOverride2.h
> > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546,
> > > { 0xb0, 0xbb,
> > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > >+
> > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> 0x3de1,
> > > 0x4586,
> > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > >
> > > >--
> > > >2.21.0.windows.1
> > >
> > >
> > >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 8:56 ` Yao, Jiewen
@ 2019-07-29 11:17 ` Javeed, Ashraf
2019-07-29 12:18 ` Yao, Jiewen
[not found] ` <15B5DFFD7DF9B8EB.10519@groups.io>
0 siblings, 2 replies; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-29 11:17 UTC (permalink / raw)
To: Yao, Jiewen, devel@edk2.groups.io, Gao, Liming; +Cc: Kinney, Michael D, Ni, Ray
My response inline below...
Thanks
Ashraf
> -----Original Message-----
> From: Yao, Jiewen
> Sent: Monday, July 29, 2019 2:26 PM
> To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io; Gao,
> Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> Oh. This patch is for staging. Not for EDKII master, right?
> If so, I have no concern.
> For the master, I think MdePkg should only include what has been defined.
>
> For this patch, I am curious on how to maintain the compatibility?
[Ashraf] I had discussion with Ray related to compatibility; the new GUID is defined
to maintain both backward and forward compatibility, hence the name PCI Platform
Protocol 2.
>
> For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
[Ashraf] There is major/minor version defined in the PCI Platform Protocol 2, which can
be used for extending it in future if required.
> It seems weird to bind a PI protocol to another industry standard. We had better
> decouple them.
[Ashraf] The abstraction for the PCI attributes are done in similar way as it is done in
the existing PI spec for the EFI_PCI_PLATFORM_POLICY. Please suggest how to represent
the PCI attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY of the PciPlatform2.h?
>
> As such, we don't need update PI spec again and again just because PCIE spec
> update.
> Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need update protocol
> interface just because they are updated.
[Ashraf] As I have indicated in the feature request Id 1954; the reason to enhance this protocol
is because there is no interface to obtain device specific platform policies from its platform firmware.
There is a demand from Intel Server products to extend PCI standard feature set in the PCI Bus driver
of the MdeModulePkg, and this protocol needs to be enhanced to accommodate device-specific
platform policies which would be used directly by the PCI Bus driver.
I strongly believe enhancing this protocol will help the PCI Bus driver to support many PCI
features seamlessly in future, without further changes to PI specification.
Otherwise, please provide an alternative to consider the device-specific platform policies which the
MdeModulePkg's PCI Bus driver can adhere to support those PCI standard features in future?
>
> Thank you
> Yao Jiewen
>
> > -----Original Message-----
> > From: Javeed, Ashraf
> > Sent: Monday, July 29, 2019 4:12 PM
> > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > Hi Yao Jiewen,
> > Can you please elaborate your concern?
> > The PCI Platform Protocol / PCI Override Protocol are defined in PI Spec 1.7.
> > These same protocols are enhanced here.
> > The producer would be the platform firmware, and consumer would be the
> > MdeModulePkg's PCI Bus driver.
> > The detailed document is attached to Bugzilla feature request Id 1954.
> >
> > Thanks
> > Ashraf
> >
> > > -----Original Message-----
> > > From: Yao, Jiewen
> > > Sent: Monday, July 29, 2019 1:36 PM
> > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > Javeed,
> > Ashraf
> > > <ashraf.javeed@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > Hi
> > > I think this policy protocol should be EDKII specific. Currently it
> > > is no in PI
> > spec.
> > > Should it be in MdeModulePkg ?
> > >
> > > Thank you
> > > Yao Jiewen
> > >
> > > > -----Original Message-----
> > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf
> > Of
> > > > Liming Gao
> > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>
> > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > protocol
> > > >
> > > > Ashraf:
> > > > For new files, please use license: SPDX-License-Identifier:
> > > > BSD-2-Clause-Patent.
> > > >
> > > > Other change is good. Reviewed-by: Liming Gao
> > <liming.gao@intel.com>
> > > >
> > > > Thanks
> > > > Liming
> > > > >-----Original Message-----
> > > > >From: Javeed, Ashraf
> > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > >To: devel@edk2.groups.io
> > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> > > > ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > MdePkg/Protocols:
> > > > >New interface, EFI encodings to PCI Plat protocol
> > > > >
> > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > >
> > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > >Protocol to retrieve device-specific platform policy for the
> > > > >following PCI standard features, like Maximum Payload Size (MPS),
> > > > >Maximum Read Request Size (MRRS),Extended Tags, Relax Order,
> > > > >No-Snoop, Active State Power Management (ASPM),Latency Time
> > > > >Reporting (LTR),
> > AtomicOp,
> > > > >Reference Clock Configuration, Extended SYNCH, PTM support, and
> > > > >Completion Timeout
> > > > (CTO).
> > > > >New source files added with enhanced definitions are in:
> > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > >
> > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > >---
> > > > >
> > > > >In V2: Correction made to header sections of source files
> > > > >---
> > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > 3 files changed, 442 insertions(+)
> > > > >
> > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > >new file mode 100644
> > > > >index 0000000000..a7f541b4c3
> > > > >--- /dev/null
> > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > >@@ -0,0 +1,43 @@
> > > > >+/** @file
> > > > >+ This file declares EFI PCI Override protocol which provides
> > > > >+the interface
> > > > >between
> > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > >+ and an
> > > > >implementation's
> > > > >+ driver to describe the unique features of a platform.
> > > > >+ This protocol is optional.
> > > > >+
> > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > >+ reserved.<BR> This program and the accompanying materials are
> > > > >+ licensed and
> > made
> > > > >+ available under the terms and conditions of the
> > > > BSD
> > > > >License
> > > > >+ which accompanies this distribution. The full text of the
> > > > >+ license may
> > > > be
> > > > >found at
> > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > >+
> > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > "AS
> > > > IS"
> > > > >BASIS,
> > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > EITHER
> > > > >EXPRESS OR IMPLIED.
> > > > >+
> > > > >+
> > > > >+**/
> > > > >+
> > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > >+#define _PCI_OVERRIDE2_H_
> > > > >+
> > > > >+///
> > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > >+///
> > > > >+#include <Protocol/PciPlatform2.h>
> > > > >+
> > > > >+///
> > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > > > >+EFI_PCI_OVERRIDE2_GUID \
> > > > >+ { \
> > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae,
> > > > >+0xd9,
> > > > 0x42, 0x47}
> > > > >\
> > > > >+ }
> > > > >+
> > > > >+///
> > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > >+
> > > > >+
> > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > >+
> > > > >+#endif
> > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > >new file mode 100644
> > > > >index 0000000000..717938e68d
> > > > >--- /dev/null
> > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > >@@ -0,0 +1,393 @@
> > > > >+/** @file
> > > > >+ This file declares PCI Platform Protocol that provide the
> > > > >+interface
> > > > between
> > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > >+ and a
> > > > >platform-specific
> > > > >+ driver to describe the unique features of a platform.
> > > > >+ This protocol is optional.
> > > > >+
> > > > >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> > > > >+This program and the accompanying materials are licensed and
> > > > >+made
> > > > >available under
> > > > >+the terms and conditions of the BSD License that accompanies
> > > > >+this
> > > > >distribution.
> > > > >+The full text of the license may be found at
> > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > >+
> > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS
> > IS"
> > > > >BASIS,
> > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
> > > > >EXPRESS OR IMPLIED.
> > > > >+
> > > > >+
> > > > >+**/
> > > > >+
> > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > >+#define _PCI_PLATFORM2_H_
> > > > >+
> > > > >+///
> > > > >+/// This file must be included because the
> > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > >uses
> > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > >+///
> > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > >+
> > > > >+///
> > > > >+/// Reuse the existing definition to maintain backward
> > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > >+
> > > > >+///
> > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > >+///
> > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > >+ { \
> > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88,
> > 0xd2,
> > > > 0xd0,
> > > > >0xb6} \
> > > > >+ }
> > > > >+
> > > > >+///
> > > > >+/// As per the present definition and specification of this
> > > > >+protocol, the
> > > > major
> > > > >+/// version is 1, and minor version is 1. Any driver utilizing
> > > > >+this protocol /// shall use these versions number to maintain
> > > > >+the backward
> > > > compatibility
> > > > >as
> > > > >+/// per its specification changes in future.
> > > > >+///
> > > > >+enum EfiPciPlatformProtocolVersion {
> > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > >+
> > > > >+///
> > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > >+///
> > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > >+
> > > > >+///
> > > > >+/// Following are the data types for
> > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > >+/// each for the PCI standard feature and its corresponding
> > > > >+bitmask /// representing the valid combinations of PCI
> > > > >+attributes ///
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature Maximum Payload Size (MPS).
> > > > >+Refer to PCI Base
> > > > >Specification
> > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > >+encodings as per
> > > > >the
> > > > >+/// PCI hardware terminology. If this data member value is
> > > > >+returned as 0
> > > > >than
> > > > >+/// there is no platform policy to override, this feature would
> > > > >+be enabled
> > > > as
> > > > >+/// per its PCI specification based on the device capabilities.
> > > > >+Below is it /// data type and the macro definitions which the
> > > > >+driver uses for
> > > > interpreting
> > > > >+/// the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > >+
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00 //No
> > > > request for
> > > > >override
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set to
> > > > default
> > > > >128B
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set to
> > > > 256B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set to
> > > > 512B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set to
> > > > 1024B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set to
> > > > 2048B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set to
> > > > 4096B if
> > > > >applicable
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature Maximum Read Request Size (MRRS).
> > > > >+Refer to PCI
> > > > >Base
> > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > >+this data member
> > > > >value
> > > > >+/// is returned as 0 than there is no platform policy to
> > > > >+override, this
> > > > feature
> > > > >+/// would be enabled as per its PCI specification based on the
> > > > >+device
> > > > >capabilities.
> > > > >+/// Below is it data type and the macro definitions which the
> > > > >+driver uses
> > > > for
> > > > >+/// interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > >+
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00 //No
> > > > request
> > > > >for override
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set to
> > > > default
> > > > >128B
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set to
> > > > 256B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set to
> > > > 512B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set to
> > > > 1024B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set to
> > > > 2048B if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set to
> > > > 4096B if
> > > > >applicable
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature Extended Tags. Refer to PCI
> > > > >+Base Specification /// 4, (chapter 7.5.3.4) on how to translate
> > > > >+the below EFI encodings as per
> > > > >the
> > > > >+/// PCI hardware terminology. If this data member value is
> > > > >+returned as 0
> > > > >than
> > > > >+/// there is no platform policy to override, this feature would
> > > > >+be enabled
> > > > as
> > > > >+/// per its PCI specification based on the device capabilities.
> > > > >+Below is it /// data type and the macro definitions which the
> > > > >+driver uses for
> > > > interpreting
> > > > >+/// the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > >+
> > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > request
> > > > for
> > > > >override
> > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > default
> > > > 5-bit
> > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to 8-bit
> > if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to 10-bit
> > if
> > > > >applicable
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe link's Active State
> > > > >+Power Mgmt (ASPM). Refer
> > > > to
> > > > >PCI Base
> > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate the
> > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > >+this data member
> > > > >value
> > > > >+/// is returned as 0 than there is no platform policy to
> > > > >+override, this
> > > > feature
> > > > >+/// would be enabled as per its PCI specification based on the
> > > > >+device
> > > > >capabilities.
> > > > >+/// Below is it data type and the macro definitions which the
> > > > >+driver uses
> > > > for
> > > > >+/// interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > >+
> > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No request
> > for
> > > > override
> > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > default
> > > > disable
> > > > >state
> > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to L0s
> > state
> > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to L1
> > state
> > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to L0s
> > and
> > > > L1
> > > > >state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's Relax Ordering
> > > > >+enable/disable. Refer
> > > > to
> > > > >PCI Base
> > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > >+this data member
> > > > >value
> > > > >+/// is returned as 0 than there is no platform policy to
> > > > >+override, this
> > > > feature
> > > > >+/// would be enabled as per its PCI specification based on the
> > > > >+device
> > > > >capabilities.
> > > > >+/// Below is it data type and the macro definitions which the
> > > > >+driver uses
> > > > for
> > > > >+/// interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > >+
> > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > override
> > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default disable
> > > > state
> > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's No-Snoop
> > > > >+enable/disable. Refer to PCI
> > > > >Base
> > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > >+this data member
> > > > >value
> > > > >+/// is returned as 0 than there is no platform policy to
> > > > >+override, this
> > > > feature
> > > > >+/// would be enabled as per its PCI specification based on the
> > > > >+device
> > > > >capabilities.
> > > > >+/// Below is it data type and the macro definitions which the
> > > > >+driver uses
> > > > for
> > > > >+/// interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > >+
> > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > override
> > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default disable
> > state
> > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe link's Clock
> > > > >+configuration is common or
> > > > discrete.
> > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > >+to translate
> > > > >the
> > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > >+this data
> > > > >member
> > > > >+/// value is returned as 0 than there is no platform policy to
> > > > >+override, this /// feature would be enabled as per its PCI
> > > > >+specification based on the
> > > > device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > >+
> > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request for
> > > > override
> > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to default
> > > > >asynchronous clock
> > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > common
> > > > clock
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe link's Extended Synch
> > > > >+enable or
> > disable.
> > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > >+to translate
> > > > >the
> > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > >+this data
> > > > >member
> > > > >+/// value is returned as 0 than there is no platform policy to
> > > > >+override, this /// feature would be enabled as per its PCI
> > > > >+specification based on the
> > > > device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > >+
> > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No request
> > for
> > > > override
> > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to default
> > > > disable
> > > > >state
> > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to enable
> > > > state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's AtomicOp
> > > > >+Requester enable or
> > > > disable.
> > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > >+to
> > > > translate
> > > > >the
> > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > >+this data
> > > > >member
> > > > >+/// value is returned as 0 than there is no platform policy to
> > > > >+override, this /// feature would be enabled as per its PCI
> > > > >+specification based on the
> > > > device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > >+
> > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No request
> > for
> > > > >override
> > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to default
> > > > disable
> > > > >state
> > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to enable
> > > > state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's LTR Mechanism
> > enable/disable.
> > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > >+to
> > > > translate
> > > > >the
> > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > >+this data
> > > > >member
> > > > >+/// value is returned as 0 than there is no platform policy to
> > > > >+override, this /// feature would be enabled as per its PCI
> > > > >+specification based on the
> > > > device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > >+
> > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > override
> > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default disable
> > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable
> > state
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's Precision Time
> > > > >+Measurement (PTM)
> > > > >enable/disable.
> > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > >+to
> > > > translate
> > > > >the
> > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > >+this data
> > > > >member
> > > > >+/// value is returned as 0 than there is no platform policy to
> > > > >+override, this /// feature would be enabled as per its PCI
> > > > >+specification based on the
> > > > device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > >+
> > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> > > > override
> > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > disable
> > > > state
> > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable state
> > > > only
> > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root select
> > &
> > > > enable
> > > > >+
> > > > >+///
> > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > >+for the PCI- /// compliant feature PCIe Device's Completion
> > > > >+Timeout
> > > > >+(CTO) set to
> > > > >supported ranges
> > > > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > > > >+7.5.3.16) on how
> > > > to
> > > > >+/// translate the below EFI encodings as per the PCI hardware
> > terminology.
> > > > If
> > > > >this
> > > > >+/// data member value is returned as 0 than there is no platform
> > > > >+policy to
> > > > >override,
> > > > >+/// this feature would be enabled as per its PCI specification
> > > > >+based on the
> > > > >device
> > > > >+/// capabilities. Below is its data type and the macro
> > > > >+definitions which the /// driver uses for interpreting the platform policy.
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > >+
> > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request for
> > > > override
> > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default
> > range
> > > > of 5us
> > > > >to 50ms if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range of
> > 50us
> > > > to
> > > > >100us if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range of
> > 1ms
> > > > to
> > > > >10ms if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range of
> > > > 16ms to
> > > > >55ms if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range of
> > > > 65ms to
> > > > >210ms if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range of
> > > > 260ms to
> > > > >900ms if applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range of
> > 1s
> > > > to 3.5s if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range of
> > 4s
> > > > to 13s if
> > > > >applicable
> > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range of
> > 17s
> > > > to 64s
> > > > >if applicable
> > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > detection
> > > > >disable if applicable
> > > > >+
> > > > >+///
> > > > >+/// Reserves for future use
> > > > >+///
> > > > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > > > >+
> > > > >+///
> > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > 128-byte
> > > > size,
> > > > >with each
> > > > >+/// byte field representing one PCI standerd feature defined in
> > > > >+the PCI
> > > > >Express Base
> > > > >+/// Specification 4.0, version 1.0.
> > > > >+///
> > > > >+typedef struct {
> > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > >+
> > > > >+/**
> > > > >+ Retrieves the PCI device-specific platform policy regarding
> > > > enumeration.
> > > > >+
> > > > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > > > >+ Protocol
> > > > drivers
> > > > >+ can call this member function to retrieve the platform
> > > > >+ policies specific
> > > > to
> > > > >+ PCI device, regarding the PCI enumeration.
> > > > >+
> > > > >+ The GetDevicePolicy() function retrieves the platform policy
> > > > >+ for a
> > > > particular
> > > > >+ component regarding PCI enumeration. The PCI bus driver and
> > > > >+ the PCI
> > > > Host
> > > > >Bridge
> > > > >+ Resource Allocation Protocol driver can call this member
> > > > >+ function to
> > > > retrieve
> > > > >+ the policy.
> > > > >+ The existing GetPlatformPolicy() member function is used by
> > > > >+ the PCI Bus
> > > > >driver
> > > > >+ to program the legacy ranges, the data that is returned by
> > > > >+ that member
> > > > >function
> > > > >+ determines the supported attributes that are returned by the
> > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > >+ The GetDevicePolicy() member function is meant to return data
> > > > >+ about
> > > > >other PCI
> > > > >+ compliant features which would be supported by the PCI Bus
> > > > >+ driver in
> > > > >future;
> > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The
> > > > >+ details
> > > > >about
> > > > >+ this PCI features can be obtained from the PCI Base
> > > > >+ Specification
> > 4.x.
> > > > The
> > > > >+ EFI encodings for these feature are defined in the
> > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related Definition
> > > > section
> > > > >for this.
> > > > >+ This member function will use the associated EFI handle of the
> > > > >+ PCI IO
> > > > >Protocol
> > > > >+ to determine the physical PCI device within the chipset, to
> > > > >+ return its device-specific platform policies.
> > > > >+
> > > > >+ @param[in] This Pointer to the
> > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > >instance.
> > > > >+ @param[in] PciDevice The associated PCI IO Protocol handle
> > of
> > > > the PCI
> > > > >+ device. Type EFI_HANDLE is defined
> > in
> > > > >+ InstallProtocolInterface() in the
> > UEFI
> > > > 2.1
> > > > >+ Specification @param[in]
> > PciExtPolicy
> > > > >+ The platform policy with respect to other
> > > > PCI
> > > > >features
> > > > >+ like, the MPS, MRRS, etc. Type
> > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > >+ is defined in "Related Definitions"
> > > > below.
> > > > >+
> > > > >+
> > > > >+ @retval EFI_SUCCESS The function completed
> > > > successfully, may
> > > > >returns
> > > > >+ platform policy data for the
> > given
> > > > PCI component
> > > > >+ @retval EFI_UNSUPPORTED PCI component belongs to PCI
> > > > topology but
> > > > >not
> > > > >+ part of chipset to provide the
> > > > platform policy
> > > > >+ @retval EFI_INVALID_PARAMETER If any of the input parameters
> > are
> > > > >passed with
> > > > >+ invalid data
> > > > >+
> > > > >+ **/
> > > > >+typedef
> > > > >+EFI_STATUS
> > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > >+ IN EFI_HANDLE PciDevice,
> > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > >+
> > > > >+///
> > > > >+/// This protocol provides the interface between the PCI bus
> > > > >+driver/PCI
> > > > Host
> > > > >+/// Bridge Resource Allocation driver and a platform-specific
> > > > >+driver to
> > > > >describe
> > > > >+/// the unique features of a platform.
> > > > >+///
> > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > >+ ///
> > > > >+ /// The notification from the PCI bus enumerator to the
> > > > >+platform that it
> > > > is
> > > > >about to
> > > > >+ /// enter a certain phase during the enumeration process.
> > > > >+ ///
> > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> > > > >+ ///
> > > > >+ /// The notification from the PCI bus enumerator to the
> > > > >+ platform for
> > > > each
> > > > >PCI
> > > > >+ /// controller at several predefined points during PCI
> > > > >+ controller
> > > > initialization.
> > > > >+ ///
> > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > PlatformPrepController;
> > > > >+ ///
> > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > >+ ///
> > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > GetPlatformPolicy;
> > > > >+ ///
> > > > >+ /// Gets the PCI device's option ROM from a platform-specific
> > location.
> > > > >+ ///
> > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > >+ ///
> > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > >+ regarding
> > > > enumeration.
> > > > >+ ///
> > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY GetDevicePolicy;
> > > > >+ ///
> > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > >+ UINT8 MajorVersion;
> > > > >+ ///
> > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > >+ UINT8 MinorVersion;
> > > > >+
> > > > >+};
> > > > >+
> > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > >+
> > > > >+#endif
> > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > >b382efd578..670b448031 100644
> > > > >--- a/MdePkg/MdePkg.dec
> > > > >+++ b/MdePkg/MdePkg.dec
> > > > >@@ -1013,6 +1013,12 @@
> > > > > ## Include/Protocol/PciOverride.h
> > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c, 0x4a06,
> > > > {0x99, 0xfc,
> > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > >
> > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945, 0x4d60,
> > > > { 0x8d, 0x34,
> > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > >+
> > > > >+ ## Include/Protocol/PciOverride2.h
> > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb, 0x4546,
> > > > { 0xb0, 0xbb,
> > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > >+
> > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > 0x3de1,
> > > > 0x4586,
> > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > >
> > > > >--
> > > > >2.21.0.windows.1
> > > >
> > > >
> > > >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 11:17 ` Javeed, Ashraf
@ 2019-07-29 12:18 ` Yao, Jiewen
2019-07-29 14:27 ` Javeed, Ashraf
[not found] ` <15B5DFFD7DF9B8EB.10519@groups.io>
1 sibling, 1 reply; 13+ messages in thread
From: Yao, Jiewen @ 2019-07-29 12:18 UTC (permalink / raw)
To: Javeed, Ashraf, devel@edk2.groups.io, Gao, Liming
Cc: Kinney, Michael D, Ni, Ray
I think the request makes sense.
I am not sure if I understand your question on PCI attributes. It is generic concept and defined in UEFI spec. Here we are discussing device policy in PCIE spec.
I checked ECR in https://bugzilla.tianocore.org/show_bug.cgi?id=1954, it defines
typedef struct {
EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
EFI_PCI_CONF_LTR DeviceCtl2LTR;
EFI_PCI_CONF_PTM PTMControl;
EFI_PCI_CONF_RESERVES Reserves[117];
} EFI_PCI_PLATFORM_EXTENDED_POLICY;
But in below patch, it is already changed to:
typedef struct {
EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
EFI_PCI_CONF_LTR DeviceCtl2LTR;
EFI_PCI_CONF_PTM PTMControl;
EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
EFI_PCI_CONF_RESERVES Reserves[116];
} EFI_PCI_PLATFORM_EXTENDED_POLICY;
That means, *the policy structure is changed within 1 month.*
I am not sure how stable the current version is. But changing spec is time consuming.
Maybe we can start with EDKII interface only.
Wait for a while, to see if we need add something, then decide if there is need to add to PI spec.
Thank you
Yao Jiewen
> -----Original Message-----
> From: Javeed, Ashraf
> Sent: Monday, July 29, 2019 7:18 PM
> To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> My response inline below...
>
> Thanks
> Ashraf
>
> > -----Original Message-----
> > From: Yao, Jiewen
> > Sent: Monday, July 29, 2019 2:26 PM
> > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io;
> Gao,
> > Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > Oh. This patch is for staging. Not for EDKII master, right?
> > If so, I have no concern.
> > For the master, I think MdePkg should only include what has been defined.
> >
> > For this patch, I am curious on how to maintain the compatibility?
> [Ashraf] I had discussion with Ray related to compatibility; the new GUID is
> defined
> to maintain both backward and forward compatibility, hence the name PCI
> Platform
> Protocol 2.
> >
> > For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
> [Ashraf] There is major/minor version defined in the PCI Platform Protocol 2,
> which can
> be used for extending it in future if required.
> > It seems weird to bind a PI protocol to another industry standard. We had
> better
> > decouple them.
> [Ashraf] The abstraction for the PCI attributes are done in similar way as it is
> done in
> the existing PI spec for the EFI_PCI_PLATFORM_POLICY. Please suggest how
> to represent
> the PCI attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY of
> the PciPlatform2.h?
> >
> > As such, we don't need update PI spec again and again just because PCIE
> spec
> > update.
> > Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need update
> protocol
> > interface just because they are updated.
> [Ashraf] As I have indicated in the feature request Id 1954; the reason to
> enhance this protocol
> is because there is no interface to obtain device specific platform policies
> from its platform firmware.
> There is a demand from Intel Server products to extend PCI standard feature
> set in the PCI Bus driver
> of the MdeModulePkg, and this protocol needs to be enhanced to
> accommodate device-specific
> platform policies which would be used directly by the PCI Bus driver.
> I strongly believe enhancing this protocol will help the PCI Bus driver to
> support many PCI
> features seamlessly in future, without further changes to PI specification.
> Otherwise, please provide an alternative to consider the device-specific
> platform policies which the
> MdeModulePkg's PCI Bus driver can adhere to support those PCI standard
> features in future?
> >
> > Thank you
> > Yao Jiewen
> >
> > > -----Original Message-----
> > > From: Javeed, Ashraf
> > > Sent: Monday, July 29, 2019 4:12 PM
> > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > > Liming <liming.gao@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > Hi Yao Jiewen,
> > > Can you please elaborate your concern?
> > > The PCI Platform Protocol / PCI Override Protocol are defined in PI Spec
> 1.7.
> > > These same protocols are enhanced here.
> > > The producer would be the platform firmware, and consumer would be
> the
> > > MdeModulePkg's PCI Bus driver.
> > > The detailed document is attached to Bugzilla feature request Id 1954.
> > >
> > > Thanks
> > > Ashraf
> > >
> > > > -----Original Message-----
> > > > From: Yao, Jiewen
> > > > Sent: Monday, July 29, 2019 1:36 PM
> > > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > > Javeed,
> > > Ashraf
> > > > <ashraf.javeed@intel.com>
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > > >
> > > > Hi
> > > > I think this policy protocol should be EDKII specific. Currently it
> > > > is no in PI
> > > spec.
> > > > Should it be in MdeModulePkg ?
> > > >
> > > > Thank you
> > > > Yao Jiewen
> > > >
> > > > > -----Original Message-----
> > > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On
> Behalf
> > > Of
> > > > > Liming Gao
> > > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> devel@edk2.groups.io
> > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > <ray.ni@intel.com>
> > > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> PATCH
> > > V2]
> > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > protocol
> > > > >
> > > > > Ashraf:
> > > > > For new files, please use license: SPDX-License-Identifier:
> > > > > BSD-2-Clause-Patent.
> > > > >
> > > > > Other change is good. Reviewed-by: Liming Gao
> > > <liming.gao@intel.com>
> > > > >
> > > > > Thanks
> > > > > Liming
> > > > > >-----Original Message-----
> > > > > >From: Javeed, Ashraf
> > > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > > >To: devel@edk2.groups.io
> > > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> > > > > ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > > MdePkg/Protocols:
> > > > > >New interface, EFI encodings to PCI Plat protocol
> > > > > >
> > > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > > >
> > > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > > >Protocol to retrieve device-specific platform policy for the
> > > > > >following PCI standard features, like Maximum Payload Size (MPS),
> > > > > >Maximum Read Request Size (MRRS),Extended Tags, Relax Order,
> > > > > >No-Snoop, Active State Power Management (ASPM),Latency Time
> > > > > >Reporting (LTR),
> > > AtomicOp,
> > > > > >Reference Clock Configuration, Extended SYNCH, PTM support, and
> > > > > >Completion Timeout
> > > > > (CTO).
> > > > > >New source files added with enhanced definitions are in:
> > > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > > >
> > > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > > >---
> > > > > >
> > > > > >In V2: Correction made to header sections of source files
> > > > > >---
> > > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++
> > > +
> > > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > > 3 files changed, 442 insertions(+)
> > > > > >
> > > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > >new file mode 100644
> > > > > >index 0000000000..a7f541b4c3
> > > > > >--- /dev/null
> > > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > >@@ -0,0 +1,43 @@
> > > > > >+/** @file
> > > > > >+ This file declares EFI PCI Override protocol which provides
> > > > > >+the interface
> > > > > >between
> > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > > >+ and an
> > > > > >implementation's
> > > > > >+ driver to describe the unique features of a platform.
> > > > > >+ This protocol is optional.
> > > > > >+
> > > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > > >+ reserved.<BR> This program and the accompanying materials
> are
> > > > > >+ licensed and
> > > made
> > > > > >+ available under the terms and conditions of the
> > > > > BSD
> > > > > >License
> > > > > >+ which accompanies this distribution. The full text of the
> > > > > >+ license may
> > > > > be
> > > > > >found at
> > > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > > >+
> > > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > > "AS
> > > > > IS"
> > > > > >BASIS,
> > > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > EITHER
> > > > > >EXPRESS OR IMPLIED.
> > > > > >+
> > > > > >+
> > > > > >+**/
> > > > > >+
> > > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > > >+#define _PCI_OVERRIDE2_H_
> > > > > >+
> > > > > >+///
> > > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > > >+///
> > > > > >+#include <Protocol/PciPlatform2.h>
> > > > > >+
> > > > > >+///
> > > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > > > > >+EFI_PCI_OVERRIDE2_GUID \
> > > > > >+ { \
> > > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae,
> > > > > >+0xd9,
> > > > > 0x42, 0x47}
> > > > > >\
> > > > > >+ }
> > > > > >+
> > > > > >+///
> > > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > > >+
> > > > > >+
> > > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > > >+
> > > > > >+#endif
> > > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > >new file mode 100644
> > > > > >index 0000000000..717938e68d
> > > > > >--- /dev/null
> > > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > >@@ -0,0 +1,393 @@
> > > > > >+/** @file
> > > > > >+ This file declares PCI Platform Protocol that provide the
> > > > > >+interface
> > > > > between
> > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > > >+ and a
> > > > > >platform-specific
> > > > > >+ driver to describe the unique features of a platform.
> > > > > >+ This protocol is optional.
> > > > > >+
> > > > > >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> > > > > >+This program and the accompanying materials are licensed and
> > > > > >+made
> > > > > >available under
> > > > > >+the terms and conditions of the BSD License that accompanies
> > > > > >+this
> > > > > >distribution.
> > > > > >+The full text of the license may be found at
> > > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > > >+
> > > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> "AS
> > > IS"
> > > > > >BASIS,
> > > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> EITHER
> > > > > >EXPRESS OR IMPLIED.
> > > > > >+
> > > > > >+
> > > > > >+**/
> > > > > >+
> > > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > > >+#define _PCI_PLATFORM2_H_
> > > > > >+
> > > > > >+///
> > > > > >+/// This file must be included because the
> > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > >uses
> > > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > > >+///
> > > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > > >+
> > > > > >+///
> > > > > >+/// Reuse the existing definition to maintain backward
> > > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > > >+
> > > > > >+///
> > > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > >+///
> > > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > > >+ { \
> > > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1, 0x88,
> > > 0xd2,
> > > > > 0xd0,
> > > > > >0xb6} \
> > > > > >+ }
> > > > > >+
> > > > > >+///
> > > > > >+/// As per the present definition and specification of this
> > > > > >+protocol, the
> > > > > major
> > > > > >+/// version is 1, and minor version is 1. Any driver utilizing
> > > > > >+this protocol /// shall use these versions number to maintain
> > > > > >+the backward
> > > > > compatibility
> > > > > >as
> > > > > >+/// per its specification changes in future.
> > > > > >+///
> > > > > >+enum EfiPciPlatformProtocolVersion {
> > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > > >+
> > > > > >+///
> > > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > >+///
> > > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > > >+
> > > > > >+///
> > > > > >+/// Following are the data types for
> > > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > > >+/// each for the PCI standard feature and its corresponding
> > > > > >+bitmask /// representing the valid combinations of PCI
> > > > > >+attributes ///
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature Maximum Payload Size (MPS).
> > > > > >+Refer to PCI Base
> > > > > >Specification
> > > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > > >+encodings as per
> > > > > >the
> > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > >+returned as 0
> > > > > >than
> > > > > >+/// there is no platform policy to override, this feature would
> > > > > >+be enabled
> > > > > as
> > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > >+Below is it /// data type and the macro definitions which the
> > > > > >+driver uses for
> > > > > interpreting
> > > > > >+/// the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00
> //No
> > > > > request for
> > > > > >override
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set
> to
> > > > > default
> > > > > >128B
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set
> to
> > > > > 256B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set
> to
> > > > > 512B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set
> to
> > > > > 1024B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set
> to
> > > > > 2048B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set
> to
> > > > > 4096B if
> > > > > >applicable
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature Maximum Read Request Size
> (MRRS).
> > > > > >+Refer to PCI
> > > > > >Base
> > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > >+this data member
> > > > > >value
> > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > >+override, this
> > > > > feature
> > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > >+device
> > > > > >capabilities.
> > > > > >+/// Below is it data type and the macro definitions which the
> > > > > >+driver uses
> > > > > for
> > > > > >+/// interpreting the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00
> //No
> > > > > request
> > > > > >for override
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set
> to
> > > > > default
> > > > > >128B
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set
> to
> > > > > 256B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set
> to
> > > > > 512B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set
> to
> > > > > 1024B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set
> to
> > > > > 2048B if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set
> to
> > > > > 4096B if
> > > > > >applicable
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature Extended Tags. Refer to PCI
> > > > > >+Base Specification /// 4, (chapter 7.5.3.4) on how to translate
> > > > > >+the below EFI encodings as per
> > > > > >the
> > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > >+returned as 0
> > > > > >than
> > > > > >+/// there is no platform policy to override, this feature would
> > > > > >+be enabled
> > > > > as
> > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > >+Below is it /// data type and the macro definitions which the
> > > > > >+driver uses for
> > > > > interpreting
> > > > > >+/// the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > > request
> > > > > for
> > > > > >override
> > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > > default
> > > > > 5-bit
> > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to
> 8-bit
> > > if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to
> 10-bit
> > > if
> > > > > >applicable
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe link's Active State
> > > > > >+Power Mgmt (ASPM). Refer
> > > > > to
> > > > > >PCI Base
> > > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate the
> > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > >+this data member
> > > > > >value
> > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > >+override, this
> > > > > feature
> > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > >+device
> > > > > >capabilities.
> > > > > >+/// Below is it data type and the macro definitions which the
> > > > > >+driver uses
> > > > > for
> > > > > >+/// interpreting the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No
> request
> > > for
> > > > > override
> > > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > > default
> > > > > disable
> > > > > >state
> > > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to
> L0s
> > > state
> > > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to
> L1
> > > state
> > > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to
> L0s
> > > and
> > > > > L1
> > > > > >state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's Relax Ordering
> > > > > >+enable/disable. Refer
> > > > > to
> > > > > >PCI Base
> > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > >+this data member
> > > > > >value
> > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > >+override, this
> > > > > feature
> > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > >+device
> > > > > >capabilities.
> > > > > >+/// Below is it data type and the macro definitions which the
> > > > > >+driver uses
> > > > > for
> > > > > >+/// interpreting the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > > override
> > > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default
> disable
> > > > > state
> > > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable
> state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's No-Snoop
> > > > > >+enable/disable. Refer to PCI
> > > > > >Base
> > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > >+this data member
> > > > > >value
> > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > >+override, this
> > > > > feature
> > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > >+device
> > > > > >capabilities.
> > > > > >+/// Below is it data type and the macro definitions which the
> > > > > >+driver uses
> > > > > for
> > > > > >+/// interpreting the platform policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > > override
> > > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default
> disable
> > > state
> > > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe link's Clock
> > > > > >+configuration is common or
> > > > > discrete.
> > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > > >+to translate
> > > > > >the
> > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > >+this data
> > > > > >member
> > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > >+specification based on the
> > > > > device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request
> for
> > > > > override
> > > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to
> default
> > > > > >asynchronous clock
> > > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > > common
> > > > > clock
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe link's Extended Synch
> > > > > >+enable or
> > > disable.
> > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > > >+to translate
> > > > > >the
> > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > >+this data
> > > > > >member
> > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > >+specification based on the
> > > > > device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No
> request
> > > for
> > > > > override
> > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to
> default
> > > > > disable
> > > > > >state
> > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to
> enable
> > > > > state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's AtomicOp
> > > > > >+Requester enable or
> > > > > disable.
> > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > >+to
> > > > > translate
> > > > > >the
> > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > >+this data
> > > > > >member
> > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > >+specification based on the
> > > > > device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No
> request
> > > for
> > > > > >override
> > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to
> default
> > > > > disable
> > > > > >state
> > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to
> enable
> > > > > state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's LTR Mechanism
> > > enable/disable.
> > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > >+to
> > > > > translate
> > > > > >the
> > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > >+this data
> > > > > >member
> > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > >+specification based on the
> > > > > device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > > override
> > > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default
> disable
> > > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable
> > > state
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's Precision Time
> > > > > >+Measurement (PTM)
> > > > > >enable/disable.
> > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > >+to
> > > > > translate
> > > > > >the
> > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > >+this data
> > > > > >member
> > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > >+specification based on the
> > > > > device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> > > > > override
> > > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > > disable
> > > > > state
> > > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable
> state
> > > > > only
> > > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root
> select
> > > &
> > > > > enable
> > > > > >+
> > > > > >+///
> > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > >+for the PCI- /// compliant feature PCIe Device's Completion
> > > > > >+Timeout
> > > > > >+(CTO) set to
> > > > > >supported ranges
> > > > > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > > > > >+7.5.3.16) on how
> > > > > to
> > > > > >+/// translate the below EFI encodings as per the PCI hardware
> > > terminology.
> > > > > If
> > > > > >this
> > > > > >+/// data member value is returned as 0 than there is no platform
> > > > > >+policy to
> > > > > >override,
> > > > > >+/// this feature would be enabled as per its PCI specification
> > > > > >+based on the
> > > > > >device
> > > > > >+/// capabilities. Below is its data type and the macro
> > > > > >+definitions which the /// driver uses for interpreting the platform
> policy.
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > > >+
> > > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request
> for
> > > > > override
> > > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default
> > > range
> > > > > of 5us
> > > > > >to 50ms if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range
> of
> > > 50us
> > > > > to
> > > > > >100us if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range
> of
> > > 1ms
> > > > > to
> > > > > >10ms if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range
> of
> > > > > 16ms to
> > > > > >55ms if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range
> of
> > > > > 65ms to
> > > > > >210ms if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range
> of
> > > > > 260ms to
> > > > > >900ms if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range
> of
> > > 1s
> > > > > to 3.5s if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range
> of
> > > 4s
> > > > > to 13s if
> > > > > >applicable
> > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range
> of
> > > 17s
> > > > > to 64s
> > > > > >if applicable
> > > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > > detection
> > > > > >disable if applicable
> > > > > >+
> > > > > >+///
> > > > > >+/// Reserves for future use
> > > > > >+///
> > > > > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > > > > >+
> > > > > >+///
> > > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > > 128-byte
> > > > > size,
> > > > > >with each
> > > > > >+/// byte field representing one PCI standerd feature defined in
> > > > > >+the PCI
> > > > > >Express Base
> > > > > >+/// Specification 4.0, version 1.0.
> > > > > >+///
> > > > > >+typedef struct {
> > > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > > >+
> > > > > >+/**
> > > > > >+ Retrieves the PCI device-specific platform policy regarding
> > > > > enumeration.
> > > > > >+
> > > > > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > > > > >+ Protocol
> > > > > drivers
> > > > > >+ can call this member function to retrieve the platform
> > > > > >+ policies specific
> > > > > to
> > > > > >+ PCI device, regarding the PCI enumeration.
> > > > > >+
> > > > > >+ The GetDevicePolicy() function retrieves the platform policy
> > > > > >+ for a
> > > > > particular
> > > > > >+ component regarding PCI enumeration. The PCI bus driver and
> > > > > >+ the PCI
> > > > > Host
> > > > > >Bridge
> > > > > >+ Resource Allocation Protocol driver can call this member
> > > > > >+ function to
> > > > > retrieve
> > > > > >+ the policy.
> > > > > >+ The existing GetPlatformPolicy() member function is used by
> > > > > >+ the PCI Bus
> > > > > >driver
> > > > > >+ to program the legacy ranges, the data that is returned by
> > > > > >+ that member
> > > > > >function
> > > > > >+ determines the supported attributes that are returned by the
> > > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > > >+ The GetDevicePolicy() member function is meant to return data
> > > > > >+ about
> > > > > >other PCI
> > > > > >+ compliant features which would be supported by the PCI Bus
> > > > > >+ driver in
> > > > > >future;
> > > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The
> > > > > >+ details
> > > > > >about
> > > > > >+ this PCI features can be obtained from the PCI Base
> > > > > >+ Specification
> > > 4.x.
> > > > > The
> > > > > >+ EFI encodings for these feature are defined in the
> > > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related
> Definition
> > > > > section
> > > > > >for this.
> > > > > >+ This member function will use the associated EFI handle of the
> > > > > >+ PCI IO
> > > > > >Protocol
> > > > > >+ to determine the physical PCI device within the chipset, to
> > > > > >+ return its device-specific platform policies.
> > > > > >+
> > > > > >+ @param[in] This Pointer to the
> > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > >instance.
> > > > > >+ @param[in] PciDevice The associated PCI IO Protocol
> handle
> > > of
> > > > > the PCI
> > > > > >+ device. Type EFI_HANDLE is
> defined
> > > in
> > > > > >+ InstallProtocolInterface() in the
> > > UEFI
> > > > > 2.1
> > > > > >+ Specification @param[in]
> > > PciExtPolicy
> > > > > >+ The platform policy with respect to other
> > > > > PCI
> > > > > >features
> > > > > >+ like, the MPS, MRRS, etc. Type
> > > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > > >+ is defined in "Related
> Definitions"
> > > > > below.
> > > > > >+
> > > > > >+
> > > > > >+ @retval EFI_SUCCESS The function completed
> > > > > successfully, may
> > > > > >returns
> > > > > >+ platform policy data for
> the
> > > given
> > > > > PCI component
> > > > > >+ @retval EFI_UNSUPPORTED PCI component belongs to
> PCI
> > > > > topology but
> > > > > >not
> > > > > >+ part of chipset to provide
> the
> > > > > platform policy
> > > > > >+ @retval EFI_INVALID_PARAMETER If any of the input
> parameters
> > > are
> > > > > >passed with
> > > > > >+ invalid data
> > > > > >+
> > > > > >+ **/
> > > > > >+typedef
> > > > > >+EFI_STATUS
> > > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > > >+ IN EFI_HANDLE PciDevice,
> > > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > > >+
> > > > > >+///
> > > > > >+/// This protocol provides the interface between the PCI bus
> > > > > >+driver/PCI
> > > > > Host
> > > > > >+/// Bridge Resource Allocation driver and a platform-specific
> > > > > >+driver to
> > > > > >describe
> > > > > >+/// the unique features of a platform.
> > > > > >+///
> > > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > > >+ ///
> > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > >+platform that it
> > > > > is
> > > > > >about to
> > > > > >+ /// enter a certain phase during the enumeration process.
> > > > > >+ ///
> > > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> > > > > >+ ///
> > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > >+ platform for
> > > > > each
> > > > > >PCI
> > > > > >+ /// controller at several predefined points during PCI
> > > > > >+ controller
> > > > > initialization.
> > > > > >+ ///
> > > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > > PlatformPrepController;
> > > > > >+ ///
> > > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > > >+ ///
> > > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > > GetPlatformPolicy;
> > > > > >+ ///
> > > > > >+ /// Gets the PCI device's option ROM from a platform-specific
> > > location.
> > > > > >+ ///
> > > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > > >+ ///
> > > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > > >+ regarding
> > > > > enumeration.
> > > > > >+ ///
> > > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY
> GetDevicePolicy;
> > > > > >+ ///
> > > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > > >+ UINT8 MajorVersion;
> > > > > >+ ///
> > > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > > >+ UINT8 MinorVersion;
> > > > > >+
> > > > > >+};
> > > > > >+
> > > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > > >+
> > > > > >+#endif
> > > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > > >b382efd578..670b448031 100644
> > > > > >--- a/MdePkg/MdePkg.dec
> > > > > >+++ b/MdePkg/MdePkg.dec
> > > > > >@@ -1013,6 +1013,12 @@
> > > > > > ## Include/Protocol/PciOverride.h
> > > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c,
> 0x4a06,
> > > > > {0x99, 0xfc,
> > > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > > >
> > > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945,
> 0x4d60,
> > > > > { 0x8d, 0x34,
> > > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > > >+
> > > > > >+ ## Include/Protocol/PciOverride2.h
> > > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb,
> 0x4546,
> > > > > { 0xb0, 0xbb,
> > > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > > >+
> > > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > > 0x3de1,
> > > > > 0x4586,
> > > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > > >
> > > > > >--
> > > > > >2.21.0.windows.1
> > > > >
> > > > >
> > > > >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
[not found] ` <15B5DFFD7DF9B8EB.10519@groups.io>
@ 2019-07-29 12:25 ` Yao, Jiewen
2019-07-29 14:39 ` Javeed, Ashraf
0 siblings, 1 reply; 13+ messages in thread
From: Yao, Jiewen @ 2019-07-29 12:25 UTC (permalink / raw)
To: devel@edk2.groups.io, Yao, Jiewen, Javeed, Ashraf, Gao, Liming
Cc: Kinney, Michael D, Ni, Ray
Forgot to mention: since we want to handle device policy, another option is to create PCI_DEVICE_POLICY_PROTOCOL. No need to update previous one.
Thank you
Yao Jiewen
> -----Original Message-----
> From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of
> Yao, Jiewen
> Sent: Monday, July 29, 2019 8:19 PM
> To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io; Gao,
> Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> I think the request makes sense.
>
> I am not sure if I understand your question on PCI attributes. It is generic
> concept and defined in UEFI spec. Here we are discussing device policy in
> PCIE spec.
>
> I checked ECR in https://bugzilla.tianocore.org/show_bug.cgi?id=1954, it
> defines
> typedef struct {
> EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> EFI_PCI_CONF_LTR DeviceCtl2LTR;
> EFI_PCI_CONF_PTM PTMControl;
> EFI_PCI_CONF_RESERVES Reserves[117];
> } EFI_PCI_PLATFORM_EXTENDED_POLICY;
>
> But in below patch, it is already changed to:
>
> typedef struct {
> EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> EFI_PCI_CONF_LTR DeviceCtl2LTR;
> EFI_PCI_CONF_PTM PTMControl;
> EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> EFI_PCI_CONF_RESERVES Reserves[116];
> } EFI_PCI_PLATFORM_EXTENDED_POLICY;
>
> That means, *the policy structure is changed within 1 month.*
>
> I am not sure how stable the current version is. But changing spec is time
> consuming.
>
> Maybe we can start with EDKII interface only.
> Wait for a while, to see if we need add something, then decide if there is
> need to add to PI spec.
>
> Thank you
> Yao Jiewen
>
>
>
> > -----Original Message-----
> > From: Javeed, Ashraf
> > Sent: Monday, July 29, 2019 7:18 PM
> > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > My response inline below...
> >
> > Thanks
> > Ashraf
> >
> > > -----Original Message-----
> > > From: Yao, Jiewen
> > > Sent: Monday, July 29, 2019 2:26 PM
> > > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io;
> > Gao,
> > > Liming <liming.gao@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > Oh. This patch is for staging. Not for EDKII master, right?
> > > If so, I have no concern.
> > > For the master, I think MdePkg should only include what has been
> defined.
> > >
> > > For this patch, I am curious on how to maintain the compatibility?
> > [Ashraf] I had discussion with Ray related to compatibility; the new GUID is
> > defined
> > to maintain both backward and forward compatibility, hence the name PCI
> > Platform
> > Protocol 2.
> > >
> > > For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
> > [Ashraf] There is major/minor version defined in the PCI Platform Protocol
> 2,
> > which can
> > be used for extending it in future if required.
> > > It seems weird to bind a PI protocol to another industry standard. We
> had
> > better
> > > decouple them.
> > [Ashraf] The abstraction for the PCI attributes are done in similar way as it
> is
> > done in
> > the existing PI spec for the EFI_PCI_PLATFORM_POLICY. Please suggest
> how
> > to represent
> > the PCI attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY
> of
> > the PciPlatform2.h?
> > >
> > > As such, we don't need update PI spec again and again just because PCIE
> > spec
> > > update.
> > > Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need update
> > protocol
> > > interface just because they are updated.
> > [Ashraf] As I have indicated in the feature request Id 1954; the reason to
> > enhance this protocol
> > is because there is no interface to obtain device specific platform policies
> > from its platform firmware.
> > There is a demand from Intel Server products to extend PCI standard
> feature
> > set in the PCI Bus driver
> > of the MdeModulePkg, and this protocol needs to be enhanced to
> > accommodate device-specific
> > platform policies which would be used directly by the PCI Bus driver.
> > I strongly believe enhancing this protocol will help the PCI Bus driver to
> > support many PCI
> > features seamlessly in future, without further changes to PI specification.
> > Otherwise, please provide an alternative to consider the device-specific
> > platform policies which the
> > MdeModulePkg's PCI Bus driver can adhere to support those PCI standard
> > features in future?
> > >
> > > Thank you
> > > Yao Jiewen
> > >
> > > > -----Original Message-----
> > > > From: Javeed, Ashraf
> > > > Sent: Monday, July 29, 2019 4:12 PM
> > > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > > > Liming <liming.gao@intel.com>
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>
> > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > > >
> > > > Hi Yao Jiewen,
> > > > Can you please elaborate your concern?
> > > > The PCI Platform Protocol / PCI Override Protocol are defined in PI
> Spec
> > 1.7.
> > > > These same protocols are enhanced here.
> > > > The producer would be the platform firmware, and consumer would be
> > the
> > > > MdeModulePkg's PCI Bus driver.
> > > > The detailed document is attached to Bugzilla feature request Id 1954.
> > > >
> > > > Thanks
> > > > Ashraf
> > > >
> > > > > -----Original Message-----
> > > > > From: Yao, Jiewen
> > > > > Sent: Monday, July 29, 2019 1:36 PM
> > > > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > > > Javeed,
> > > > Ashraf
> > > > > <ashraf.javeed@intel.com>
> > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> PATCH
> > V2]
> > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > > > >
> > > > > Hi
> > > > > I think this policy protocol should be EDKII specific. Currently it
> > > > > is no in PI
> > > > spec.
> > > > > Should it be in MdeModulePkg ?
> > > > >
> > > > > Thank you
> > > > > Yao Jiewen
> > > > >
> > > > > > -----Original Message-----
> > > > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On
> > Behalf
> > > > Of
> > > > > > Liming Gao
> > > > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > devel@edk2.groups.io
> > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > <ray.ni@intel.com>
> > > > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > PATCH
> > > > V2]
> > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > protocol
> > > > > >
> > > > > > Ashraf:
> > > > > > For new files, please use license: SPDX-License-Identifier:
> > > > > > BSD-2-Clause-Patent.
> > > > > >
> > > > > > Other change is good. Reviewed-by: Liming Gao
> > > > <liming.gao@intel.com>
> > > > > >
> > > > > > Thanks
> > > > > > Liming
> > > > > > >-----Original Message-----
> > > > > > >From: Javeed, Ashraf
> > > > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > > > >To: devel@edk2.groups.io
> > > > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming
> > > > > > ><liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > > > MdePkg/Protocols:
> > > > > > >New interface, EFI encodings to PCI Plat protocol
> > > > > > >
> > > > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > > > >
> > > > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > > > >Protocol to retrieve device-specific platform policy for the
> > > > > > >following PCI standard features, like Maximum Payload Size (MPS),
> > > > > > >Maximum Read Request Size (MRRS),Extended Tags, Relax Order,
> > > > > > >No-Snoop, Active State Power Management (ASPM),Latency Time
> > > > > > >Reporting (LTR),
> > > > AtomicOp,
> > > > > > >Reference Clock Configuration, Extended SYNCH, PTM support,
> and
> > > > > > >Completion Timeout
> > > > > > (CTO).
> > > > > > >New source files added with enhanced definitions are in:
> > > > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >
> > > > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > > > >---
> > > > > > >
> > > > > > >In V2: Correction made to header sections of source files
> > > > > > >---
> > > > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > > > 3 files changed, 442 insertions(+)
> > > > > > >
> > > > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >new file mode 100644
> > > > > > >index 0000000000..a7f541b4c3
> > > > > > >--- /dev/null
> > > > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >@@ -0,0 +1,43 @@
> > > > > > >+/** @file
> > > > > > >+ This file declares EFI PCI Override protocol which provides
> > > > > > >+the interface
> > > > > > >between
> > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > > > >+ and an
> > > > > > >implementation's
> > > > > > >+ driver to describe the unique features of a platform.
> > > > > > >+ This protocol is optional.
> > > > > > >+
> > > > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > > > >+ reserved.<BR> This program and the accompanying materials
> > are
> > > > > > >+ licensed and
> > > > made
> > > > > > >+ available under the terms and conditions of the
> > > > > > BSD
> > > > > > >License
> > > > > > >+ which accompanies this distribution. The full text of the
> > > > > > >+ license may
> > > > > > be
> > > > > > >found at
> > > > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > > > >+
> > > > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON
> AN
> > > > "AS
> > > > > > IS"
> > > > > > >BASIS,
> > > > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > > EITHER
> > > > > > >EXPRESS OR IMPLIED.
> > > > > > >+
> > > > > > >+
> > > > > > >+**/
> > > > > > >+
> > > > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > > > >+#define _PCI_OVERRIDE2_H_
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > > > >+///
> > > > > > >+#include <Protocol/PciPlatform2.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > > > > > >+EFI_PCI_OVERRIDE2_GUID \
> > > > > > >+ { \
> > > > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d, 0xae,
> > > > > > >+0xd9,
> > > > > > 0x42, 0x47}
> > > > > > >\
> > > > > > >+ }
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > > > >+
> > > > > > >+
> > > > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > > > >+
> > > > > > >+#endif
> > > > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >new file mode 100644
> > > > > > >index 0000000000..717938e68d
> > > > > > >--- /dev/null
> > > > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >@@ -0,0 +1,393 @@
> > > > > > >+/** @file
> > > > > > >+ This file declares PCI Platform Protocol that provide the
> > > > > > >+interface
> > > > > > between
> > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation driver
> > > > > > >+ and a
> > > > > > >platform-specific
> > > > > > >+ driver to describe the unique features of a platform.
> > > > > > >+ This protocol is optional.
> > > > > > >+
> > > > > > >+Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>
> > > > > > >+This program and the accompanying materials are licensed and
> > > > > > >+made
> > > > > > >available under
> > > > > > >+the terms and conditions of the BSD License that accompanies
> > > > > > >+this
> > > > > > >distribution.
> > > > > > >+The full text of the license may be found at
> > > > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > > > >+
> > > > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > "AS
> > > > IS"
> > > > > > >BASIS,
> > > > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > EITHER
> > > > > > >EXPRESS OR IMPLIED.
> > > > > > >+
> > > > > > >+
> > > > > > >+**/
> > > > > > >+
> > > > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > > > >+#define _PCI_PLATFORM2_H_
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This file must be included because the
> > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >uses
> > > > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > > > >+///
> > > > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Reuse the existing definition to maintain backward
> > > > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > >+///
> > > > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > > > >+ { \
> > > > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1,
> 0x88,
> > > > 0xd2,
> > > > > > 0xd0,
> > > > > > >0xb6} \
> > > > > > >+ }
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// As per the present definition and specification of this
> > > > > > >+protocol, the
> > > > > > major
> > > > > > >+/// version is 1, and minor version is 1. Any driver utilizing
> > > > > > >+this protocol /// shall use these versions number to maintain
> > > > > > >+the backward
> > > > > > compatibility
> > > > > > >as
> > > > > > >+/// per its specification changes in future.
> > > > > > >+///
> > > > > > >+enum EfiPciPlatformProtocolVersion {
> > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > >+///
> > > > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Following are the data types for
> > > > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > > > >+/// each for the PCI standard feature and its corresponding
> > > > > > >+bitmask /// representing the valid combinations of PCI
> > > > > > >+attributes ///
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature Maximum Payload Size (MPS).
> > > > > > >+Refer to PCI Base
> > > > > > >Specification
> > > > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > > > >+encodings as per
> > > > > > >the
> > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > >+returned as 0
> > > > > > >than
> > > > > > >+/// there is no platform policy to override, this feature would
> > > > > > >+be enabled
> > > > > > as
> > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > >+Below is it /// data type and the macro definitions which the
> > > > > > >+driver uses for
> > > > > > interpreting
> > > > > > >+/// the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00
> > //No
> > > > > > request for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01
> //set
> > to
> > > > > > default
> > > > > > >128B
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02
> //set
> > to
> > > > > > 256B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03
> //set
> > to
> > > > > > 512B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04
> //set
> > to
> > > > > > 1024B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05
> //set
> > to
> > > > > > 2048B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06
> //set
> > to
> > > > > > 4096B if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature Maximum Read Request Size
> > (MRRS).
> > > > > > >+Refer to PCI
> > > > > > >Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > > >+this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > > >+device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which the
> > > > > > >+driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00
> > //No
> > > > > > request
> > > > > > >for override
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01
> //set
> > to
> > > > > > default
> > > > > > >128B
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02
> //set
> > to
> > > > > > 256B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03
> //set
> > to
> > > > > > 512B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04
> //set
> > to
> > > > > > 1024B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05
> //set
> > to
> > > > > > 2048B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06
> //set
> > to
> > > > > > 4096B if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature Extended Tags. Refer to PCI
> > > > > > >+Base Specification /// 4, (chapter 7.5.3.4) on how to translate
> > > > > > >+the below EFI encodings as per
> > > > > > >the
> > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > >+returned as 0
> > > > > > >than
> > > > > > >+/// there is no platform policy to override, this feature would
> > > > > > >+be enabled
> > > > > > as
> > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > >+Below is it /// data type and the macro definitions which the
> > > > > > >+driver uses for
> > > > > > interpreting
> > > > > > >+/// the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > > > request
> > > > > > for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > > > default
> > > > > > 5-bit
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to
> > 8-bit
> > > > if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to
> > 10-bit
> > > > if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe link's Active State
> > > > > > >+Power Mgmt (ASPM). Refer
> > > > > > to
> > > > > > >PCI Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate the
> > > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > > >+this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > > >+device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which the
> > > > > > >+driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No
> > request
> > > > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > > > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to
> > L0s
> > > > state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to
> > L1
> > > > state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to
> > L0s
> > > > and
> > > > > > L1
> > > > > > >state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's Relax Ordering
> > > > > > >+enable/disable. Refer
> > > > > > to
> > > > > > >PCI Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > > >+this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > > >+device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which the
> > > > > > >+driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default
> > disable
> > > > > > state
> > > > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable
> > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's No-Snoop
> > > > > > >+enable/disable. Refer to PCI
> > > > > > >Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate the
> > > > > > >+below EFI /// encodings as per the PCI hardware terminology. If
> > > > > > >+this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on the
> > > > > > >+device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which the
> > > > > > >+driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default
> > disable
> > > > state
> > > > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable
> state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe link's Clock
> > > > > > >+configuration is common or
> > > > > > discrete.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > > > >+to translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > > >+this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No
> request
> > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to
> > default
> > > > > > >asynchronous clock
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > > > common
> > > > > > clock
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe link's Extended Synch
> > > > > > >+enable or
> > > > disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on how
> > > > > > >+to translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > > >+this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No
> > request
> > > > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to
> > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to
> > enable
> > > > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's AtomicOp
> > > > > > >+Requester enable or
> > > > > > disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > > >+to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > > >+this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No
> > request
> > > > for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to
> > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to
> > enable
> > > > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's LTR Mechanism
> > > > enable/disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > > >+to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > > >+this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default
> > disable
> > > > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to
> enable
> > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's Precision Time
> > > > > > >+Measurement (PTM)
> > > > > > >enable/disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on how
> > > > > > >+to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology. If
> > > > > > >+this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy to
> > > > > > >+override, this /// feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request
> for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > > > disable
> > > > > > state
> > > > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable
> > state
> > > > > > only
> > > > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root
> > select
> > > > &
> > > > > > enable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform policy
> > > > > > >+for the PCI- /// compliant feature PCIe Device's Completion
> > > > > > >+Timeout
> > > > > > >+(CTO) set to
> > > > > > >supported ranges
> > > > > > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > > > > > >+7.5.3.16) on how
> > > > > > to
> > > > > > >+/// translate the below EFI encodings as per the PCI hardware
> > > > terminology.
> > > > > > If
> > > > > > >this
> > > > > > >+/// data member value is returned as 0 than there is no platform
> > > > > > >+policy to
> > > > > > >override,
> > > > > > >+/// this feature would be enabled as per its PCI specification
> > > > > > >+based on the
> > > > > > >device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request
> > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to
> default
> > > > range
> > > > > > of 5us
> > > > > > >to 50ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to
> range
> > of
> > > > 50us
> > > > > > to
> > > > > > >100us if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to
> range
> > of
> > > > 1ms
> > > > > > to
> > > > > > >10ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to
> range
> > of
> > > > > > 16ms to
> > > > > > >55ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to
> range
> > of
> > > > > > 65ms to
> > > > > > >210ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to
> range
> > of
> > > > > > 260ms to
> > > > > > >900ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to
> range
> > of
> > > > 1s
> > > > > > to 3.5s if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to
> range
> > of
> > > > 4s
> > > > > > to 13s if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to
> range
> > of
> > > > 17s
> > > > > > to 64s
> > > > > > >if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > > > detection
> > > > > > >disable if applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Reserves for future use
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > > > 128-byte
> > > > > > size,
> > > > > > >with each
> > > > > > >+/// byte field representing one PCI standerd feature defined in
> > > > > > >+the PCI
> > > > > > >Express Base
> > > > > > >+/// Specification 4.0, version 1.0.
> > > > > > >+///
> > > > > > >+typedef struct {
> > > > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG
> LinkCtlCommonClkCfg;
> > > > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > > > >+
> > > > > > >+/**
> > > > > > >+ Retrieves the PCI device-specific platform policy regarding
> > > > > > enumeration.
> > > > > > >+
> > > > > > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > > > > > >+ Protocol
> > > > > > drivers
> > > > > > >+ can call this member function to retrieve the platform
> > > > > > >+ policies specific
> > > > > > to
> > > > > > >+ PCI device, regarding the PCI enumeration.
> > > > > > >+
> > > > > > >+ The GetDevicePolicy() function retrieves the platform policy
> > > > > > >+ for a
> > > > > > particular
> > > > > > >+ component regarding PCI enumeration. The PCI bus driver and
> > > > > > >+ the PCI
> > > > > > Host
> > > > > > >Bridge
> > > > > > >+ Resource Allocation Protocol driver can call this member
> > > > > > >+ function to
> > > > > > retrieve
> > > > > > >+ the policy.
> > > > > > >+ The existing GetPlatformPolicy() member function is used by
> > > > > > >+ the PCI Bus
> > > > > > >driver
> > > > > > >+ to program the legacy ranges, the data that is returned by
> > > > > > >+ that member
> > > > > > >function
> > > > > > >+ determines the supported attributes that are returned by the
> > > > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > > > >+ The GetDevicePolicy() member function is meant to return
> data
> > > > > > >+ about
> > > > > > >other PCI
> > > > > > >+ compliant features which would be supported by the PCI Bus
> > > > > > >+ driver in
> > > > > > >future;
> > > > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc. The
> > > > > > >+ details
> > > > > > >about
> > > > > > >+ this PCI features can be obtained from the PCI Base
> > > > > > >+ Specification
> > > > 4.x.
> > > > > > The
> > > > > > >+ EFI encodings for these feature are defined in the
> > > > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related
> > Definition
> > > > > > section
> > > > > > >for this.
> > > > > > >+ This member function will use the associated EFI handle of the
> > > > > > >+ PCI IO
> > > > > > >Protocol
> > > > > > >+ to determine the physical PCI device within the chipset, to
> > > > > > >+ return its device-specific platform policies.
> > > > > > >+
> > > > > > >+ @param[in] This Pointer to the
> > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >instance.
> > > > > > >+ @param[in] PciDevice The associated PCI IO Protocol
> > handle
> > > > of
> > > > > > the PCI
> > > > > > >+ device. Type EFI_HANDLE is
> > defined
> > > > in
> > > > > > >+ InstallProtocolInterface() in
> the
> > > > UEFI
> > > > > > 2.1
> > > > > > >+ Specification @param[in]
> > > > PciExtPolicy
> > > > > > >+ The platform policy with respect to other
> > > > > > PCI
> > > > > > >features
> > > > > > >+ like, the MPS, MRRS, etc. Type
> > > > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > > > >+ is defined in "Related
> > Definitions"
> > > > > > below.
> > > > > > >+
> > > > > > >+
> > > > > > >+ @retval EFI_SUCCESS The function completed
> > > > > > successfully, may
> > > > > > >returns
> > > > > > >+ platform policy data for
> > the
> > > > given
> > > > > > PCI component
> > > > > > >+ @retval EFI_UNSUPPORTED PCI component belongs
> to
> > PCI
> > > > > > topology but
> > > > > > >not
> > > > > > >+ part of chipset to
> provide
> > the
> > > > > > platform policy
> > > > > > >+ @retval EFI_INVALID_PARAMETER If any of the input
> > parameters
> > > > are
> > > > > > >passed with
> > > > > > >+ invalid data
> > > > > > >+
> > > > > > >+ **/
> > > > > > >+typedef
> > > > > > >+EFI_STATUS
> > > > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > > > >+ IN EFI_HANDLE PciDevice,
> > > > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This protocol provides the interface between the PCI bus
> > > > > > >+driver/PCI
> > > > > > Host
> > > > > > >+/// Bridge Resource Allocation driver and a platform-specific
> > > > > > >+driver to
> > > > > > >describe
> > > > > > >+/// the unique features of a platform.
> > > > > > >+///
> > > > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > > > >+ ///
> > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > >+platform that it
> > > > > > is
> > > > > > >about to
> > > > > > >+ /// enter a certain phase during the enumeration process.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY
> PlatformNotify;
> > > > > > >+ ///
> > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > >+ platform for
> > > > > > each
> > > > > > >PCI
> > > > > > >+ /// controller at several predefined points during PCI
> > > > > > >+ controller
> > > > > > initialization.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > > > PlatformPrepController;
> > > > > > >+ ///
> > > > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > > > GetPlatformPolicy;
> > > > > > >+ ///
> > > > > > >+ /// Gets the PCI device's option ROM from a platform-specific
> > > > location.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > > > >+ ///
> > > > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > > > >+ regarding
> > > > > > enumeration.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY
> > GetDevicePolicy;
> > > > > > >+ ///
> > > > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > > > >+ UINT8 MajorVersion;
> > > > > > >+ ///
> > > > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > > > >+ UINT8 MinorVersion;
> > > > > > >+
> > > > > > >+};
> > > > > > >+
> > > > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > > > >+
> > > > > > >+#endif
> > > > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > > > >b382efd578..670b448031 100644
> > > > > > >--- a/MdePkg/MdePkg.dec
> > > > > > >+++ b/MdePkg/MdePkg.dec
> > > > > > >@@ -1013,6 +1013,12 @@
> > > > > > > ## Include/Protocol/PciOverride.h
> > > > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c,
> > 0x4a06,
> > > > > > {0x99, 0xfc,
> > > > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > > > >
> > > > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945,
> > 0x4d60,
> > > > > > { 0x8d, 0x34,
> > > > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > > > >+
> > > > > > >+ ## Include/Protocol/PciOverride2.h
> > > > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb,
> > 0x4546,
> > > > > > { 0xb0, 0xbb,
> > > > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > > > >+
> > > > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > > > 0x3de1,
> > > > > > 0x4586,
> > > > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > > > >
> > > > > > >--
> > > > > > >2.21.0.windows.1
> > > > > >
> > > > > >
> > > > > >
>
>
>
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 12:18 ` Yao, Jiewen
@ 2019-07-29 14:27 ` Javeed, Ashraf
0 siblings, 0 replies; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-29 14:27 UTC (permalink / raw)
To: Yao, Jiewen, devel@edk2.groups.io, Gao, Liming; +Cc: Kinney, Michael D, Ni, Ray
Hello Yao Jeiwen,
Thanks for reviewing in detail!
I used the PCIe attribute in the context of my ECR; say MPS is a PCI standard feature which has to be set to defined set of values only, thus I called it as its attributes.
I had updated about this latest additional PCI feature (CTO) inclusion in this Bugzilla feature request itself (Reference: https://bugzilla.tianocore.org/show_bug.cgi?id=1954#c2)
Regards
Ashraf
> -----Original Message-----
> From: Yao, Jiewen
> Sent: Monday, July 29, 2019 5:49 PM
> To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io; Gao,
> Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> I think the request makes sense.
>
> I am not sure if I understand your question on PCI attributes. It is generic
> concept and defined in UEFI spec. Here we are discussing device policy in PCIE
> spec.
>
> I checked ECR in https://bugzilla.tianocore.org/show_bug.cgi?id=1954, it
> defines
> typedef struct {
> EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> EFI_PCI_CONF_LTR DeviceCtl2LTR;
> EFI_PCI_CONF_PTM PTMControl;
> EFI_PCI_CONF_RESERVES Reserves[117];
> } EFI_PCI_PLATFORM_EXTENDED_POLICY;
>
> But in below patch, it is already changed to:
>
> typedef struct {
> EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> EFI_PCI_CONF_LTR DeviceCtl2LTR;
> EFI_PCI_CONF_PTM PTMControl;
> EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> EFI_PCI_CONF_RESERVES Reserves[116];
> } EFI_PCI_PLATFORM_EXTENDED_POLICY;
>
> That means, *the policy structure is changed within 1 month.*
>
> I am not sure how stable the current version is. But changing spec is time
> consuming.
>
> Maybe we can start with EDKII interface only.
> Wait for a while, to see if we need add something, then decide if there is need
> to add to PI spec.
>
> Thank you
> Yao Jiewen
>
>
>
> > -----Original Message-----
> > From: Javeed, Ashraf
> > Sent: Monday, July 29, 2019 7:18 PM
> > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > My response inline below...
> >
> > Thanks
> > Ashraf
> >
> > > -----Original Message-----
> > > From: Yao, Jiewen
> > > Sent: Monday, July 29, 2019 2:26 PM
> > > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io;
> > Gao,
> > > Liming <liming.gao@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > Oh. This patch is for staging. Not for EDKII master, right?
> > > If so, I have no concern.
> > > For the master, I think MdePkg should only include what has been defined.
> > >
> > > For this patch, I am curious on how to maintain the compatibility?
> > [Ashraf] I had discussion with Ray related to compatibility; the new
> > GUID is defined to maintain both backward and forward compatibility,
> > hence the name PCI Platform Protocol 2.
> > >
> > > For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
> > [Ashraf] There is major/minor version defined in the PCI Platform
> > Protocol 2, which can be used for extending it in future if required.
> > > It seems weird to bind a PI protocol to another industry standard.
> > > We had
> > better
> > > decouple them.
> > [Ashraf] The abstraction for the PCI attributes are done in similar
> > way as it is done in the existing PI spec for the
> > EFI_PCI_PLATFORM_POLICY. Please suggest how to represent the PCI
> > attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY of the
> > PciPlatform2.h?
> > >
> > > As such, we don't need update PI spec again and again just because
> > > PCIE
> > spec
> > > update.
> > > Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need update
> > protocol
> > > interface just because they are updated.
> > [Ashraf] As I have indicated in the feature request Id 1954; the
> > reason to enhance this protocol is because there is no interface to
> > obtain device specific platform policies from its platform firmware.
> > There is a demand from Intel Server products to extend PCI standard
> > feature set in the PCI Bus driver of the MdeModulePkg, and this
> > protocol needs to be enhanced to accommodate device-specific platform
> > policies which would be used directly by the PCI Bus driver.
> > I strongly believe enhancing this protocol will help the PCI Bus
> > driver to support many PCI features seamlessly in future, without
> > further changes to PI specification.
> > Otherwise, please provide an alternative to consider the
> > device-specific platform policies which the MdeModulePkg's PCI Bus
> > driver can adhere to support those PCI standard features in future?
> > >
> > > Thank you
> > > Yao Jiewen
> > >
> > > > -----Original Message-----
> > > > From: Javeed, Ashraf
> > > > Sent: Monday, July 29, 2019 4:12 PM
> > > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > > > Liming <liming.gao@intel.com>
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>
> > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > protocol
> > > >
> > > > Hi Yao Jiewen,
> > > > Can you please elaborate your concern?
> > > > The PCI Platform Protocol / PCI Override Protocol are defined in
> > > > PI Spec
> > 1.7.
> > > > These same protocols are enhanced here.
> > > > The producer would be the platform firmware, and consumer would be
> > the
> > > > MdeModulePkg's PCI Bus driver.
> > > > The detailed document is attached to Bugzilla feature request Id 1954.
> > > >
> > > > Thanks
> > > > Ashraf
> > > >
> > > > > -----Original Message-----
> > > > > From: Yao, Jiewen
> > > > > Sent: Monday, July 29, 2019 1:36 PM
> > > > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > > > Javeed,
> > > > Ashraf
> > > > > <ashraf.javeed@intel.com>
> > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > V2]
> > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > protocol
> > > > >
> > > > > Hi
> > > > > I think this policy protocol should be EDKII specific. Currently
> > > > > it is no in PI
> > > > spec.
> > > > > Should it be in MdeModulePkg ?
> > > > >
> > > > > Thank you
> > > > > Yao Jiewen
> > > > >
> > > > > > -----Original Message-----
> > > > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On
> > Behalf
> > > > Of
> > > > > > Liming Gao
> > > > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > devel@edk2.groups.io
> > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > <ray.ni@intel.com>
> > > > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > PATCH
> > > > V2]
> > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > protocol
> > > > > >
> > > > > > Ashraf:
> > > > > > For new files, please use license: SPDX-License-Identifier:
> > > > > > BSD-2-Clause-Patent.
> > > > > >
> > > > > > Other change is good. Reviewed-by: Liming Gao
> > > > <liming.gao@intel.com>
> > > > > >
> > > > > > Thanks
> > > > > > Liming
> > > > > > >-----Original Message-----
> > > > > > >From: Javeed, Ashraf
> > > > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > > > >To: devel@edk2.groups.io
> > > > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao,
> > > > > > >Liming <liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > > > MdePkg/Protocols:
> > > > > > >New interface, EFI encodings to PCI Plat protocol
> > > > > > >
> > > > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > > > >
> > > > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > > > >Protocol to retrieve device-specific platform policy for the
> > > > > > >following PCI standard features, like Maximum Payload Size
> > > > > > >(MPS), Maximum Read Request Size (MRRS),Extended Tags, Relax
> > > > > > >Order, No-Snoop, Active State Power Management (ASPM),Latency
> > > > > > >Time Reporting (LTR),
> > > > AtomicOp,
> > > > > > >Reference Clock Configuration, Extended SYNCH, PTM support,
> > > > > > >and Completion Timeout
> > > > > > (CTO).
> > > > > > >New source files added with enhanced definitions are in:
> > > > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >
> > > > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > > > >---
> > > > > > >
> > > > > > >In V2: Correction made to header sections of source files
> > > > > > >---
> > > > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +++
> > > > +
> > > > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > > > 3 files changed, 442 insertions(+)
> > > > > > >
> > > > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >new file mode 100644
> > > > > > >index 0000000000..a7f541b4c3
> > > > > > >--- /dev/null
> > > > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > >@@ -0,0 +1,43 @@
> > > > > > >+/** @file
> > > > > > >+ This file declares EFI PCI Override protocol which
> > > > > > >+provides the interface
> > > > > > >between
> > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > >+ driver and an
> > > > > > >implementation's
> > > > > > >+ driver to describe the unique features of a platform.
> > > > > > >+ This protocol is optional.
> > > > > > >+
> > > > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > > > >+ reserved.<BR> This program and the accompanying materials
> > are
> > > > > > >+ licensed and
> > > > made
> > > > > > >+ available under the terms and conditions of the
> > > > > > BSD
> > > > > > >License
> > > > > > >+ which accompanies this distribution. The full text of the
> > > > > > >+ license may
> > > > > > be
> > > > > > >found at
> > > > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > > > >+
> > > > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > > > "AS
> > > > > > IS"
> > > > > > >BASIS,
> > > > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > > EITHER
> > > > > > >EXPRESS OR IMPLIED.
> > > > > > >+
> > > > > > >+
> > > > > > >+**/
> > > > > > >+
> > > > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > > > >+#define _PCI_OVERRIDE2_H_
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > > > >+///
> > > > > > >+#include <Protocol/PciPlatform2.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL /// #define
> > > > > > >+EFI_PCI_OVERRIDE2_GUID \
> > > > > > >+ { \
> > > > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d,
> > > > > > >+0xae, 0xd9,
> > > > > > 0x42, 0x47}
> > > > > > >\
> > > > > > >+ }
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > > > >+
> > > > > > >+
> > > > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > > > >+
> > > > > > >+#endif
> > > > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >new file mode 100644
> > > > > > >index 0000000000..717938e68d
> > > > > > >--- /dev/null
> > > > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > >@@ -0,0 +1,393 @@
> > > > > > >+/** @file
> > > > > > >+ This file declares PCI Platform Protocol that provide the
> > > > > > >+interface
> > > > > > between
> > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > >+ driver and a
> > > > > > >platform-specific
> > > > > > >+ driver to describe the unique features of a platform.
> > > > > > >+ This protocol is optional.
> > > > > > >+
> > > > > > >+Copyright (c) 2019, Intel Corporation. All rights
> > > > > > >+reserved.<BR> This program and the accompanying materials
> > > > > > >+are licensed and made
> > > > > > >available under
> > > > > > >+the terms and conditions of the BSD License that accompanies
> > > > > > >+this
> > > > > > >distribution.
> > > > > > >+The full text of the license may be found at
> > > > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > > > >+
> > > > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > "AS
> > > > IS"
> > > > > > >BASIS,
> > > > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > EITHER
> > > > > > >EXPRESS OR IMPLIED.
> > > > > > >+
> > > > > > >+
> > > > > > >+**/
> > > > > > >+
> > > > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > > > >+#define _PCI_PLATFORM2_H_
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This file must be included because the
> > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >uses
> > > > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > > > >+///
> > > > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Reuse the existing definition to maintain backward
> > > > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > >+///
> > > > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > > > >+ { \
> > > > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1,
> > > > > > >+0x88,
> > > > 0xd2,
> > > > > > 0xd0,
> > > > > > >0xb6} \
> > > > > > >+ }
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// As per the present definition and specification of this
> > > > > > >+protocol, the
> > > > > > major
> > > > > > >+/// version is 1, and minor version is 1. Any driver
> > > > > > >+utilizing this protocol /// shall use these versions number
> > > > > > >+to maintain the backward
> > > > > > compatibility
> > > > > > >as
> > > > > > >+/// per its specification changes in future.
> > > > > > >+///
> > > > > > >+enum EfiPciPlatformProtocolVersion {
> > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > >+///
> > > > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Following are the data types for
> > > > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > > > >+/// each for the PCI standard feature and its corresponding
> > > > > > >+bitmask /// representing the valid combinations of PCI
> > > > > > >+attributes ///
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature Maximum Payload Size
> (MPS).
> > > > > > >+Refer to PCI Base
> > > > > > >Specification
> > > > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > > > >+encodings as per
> > > > > > >the
> > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > >+returned as 0
> > > > > > >than
> > > > > > >+/// there is no platform policy to override, this feature
> > > > > > >+would be enabled
> > > > > > as
> > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > >+the driver uses for
> > > > > > interpreting
> > > > > > >+/// the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00
> > //No
> > > > > > request for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01 //set
> > to
> > > > > > default
> > > > > > >128B
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02 //set
> > to
> > > > > > 256B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03 //set
> > to
> > > > > > 512B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04 //set
> > to
> > > > > > 1024B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05 //set
> > to
> > > > > > 2048B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06 //set
> > to
> > > > > > 4096B if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature Maximum Read
> > > > > > >+Request Size
> > (MRRS).
> > > > > > >+Refer to PCI
> > > > > > >Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > >+terminology. If this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > >+the device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > >+the driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00
> > //No
> > > > > > request
> > > > > > >for override
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01 //set
> > to
> > > > > > default
> > > > > > >128B
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02 //set
> > to
> > > > > > 256B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03 //set
> > to
> > > > > > 512B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04 //set
> > to
> > > > > > 1024B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05 //set
> > to
> > > > > > 2048B if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06 //set
> > to
> > > > > > 4096B if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature Extended Tags.
> > > > > > >+Refer to PCI Base Specification /// 4, (chapter 7.5.3.4) on
> > > > > > >+how to translate the below EFI encodings as per
> > > > > > >the
> > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > >+returned as 0
> > > > > > >than
> > > > > > >+/// there is no platform policy to override, this feature
> > > > > > >+would be enabled
> > > > > > as
> > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > >+the driver uses for
> > > > > > interpreting
> > > > > > >+/// the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > > > request
> > > > > > for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > > > default
> > > > > > 5-bit
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to
> > 8-bit
> > > > if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to
> > 10-bit
> > > > if
> > > > > > >applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe link's Active
> > > > > > >+State Power Mgmt (ASPM). Refer
> > > > > > to
> > > > > > >PCI Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate
> > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > >+terminology. If this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > >+the device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > >+the driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No
> > request
> > > > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > > > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to
> > L0s
> > > > state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to
> > L1
> > > > state
> > > > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to
> > L0s
> > > > and
> > > > > > L1
> > > > > > >state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > >+Relax Ordering enable/disable. Refer
> > > > > > to
> > > > > > >PCI Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > >+terminology. If this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > >+the device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > >+the driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default
> > disable
> > > > > > state
> > > > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable
> > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > >+No-Snoop enable/disable. Refer to PCI
> > > > > > >Base
> > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > >+terminology. If this data member
> > > > > > >value
> > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > >+override, this
> > > > > > feature
> > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > >+the device
> > > > > > >capabilities.
> > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > >+the driver uses
> > > > > > for
> > > > > > >+/// interpreting the platform policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default
> > disable
> > > > state
> > > > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe link's Clock
> > > > > > >+configuration is common or
> > > > > > discrete.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on
> > > > > > >+how to translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology.
> > > > > > >+If this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy
> > > > > > >+to override, this /// feature would be enabled as per its
> > > > > > >+PCI specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No request
> > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to
> > default
> > > > > > >asynchronous clock
> > > > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > > > common
> > > > > > clock
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > >+Extended Synch enable or
> > > > disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7) on
> > > > > > >+how to translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology.
> > > > > > >+If this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy
> > > > > > >+to override, this /// feature would be enabled as per its
> > > > > > >+PCI specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No
> > request
> > > > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to
> > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to
> > enable
> > > > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > >+AtomicOp Requester enable or
> > > > > > disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on
> > > > > > >+how to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology.
> > > > > > >+If this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy
> > > > > > >+to override, this /// feature would be enabled as per its
> > > > > > >+PCI specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No
> > request
> > > > for
> > > > > > >override
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to
> > default
> > > > > > disable
> > > > > > >state
> > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to
> > enable
> > > > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's LTR
> > > > > > >+Mechanism
> > > > enable/disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on
> > > > > > >+how to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology.
> > > > > > >+If this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy
> > > > > > >+to override, this /// feature would be enabled as per its
> > > > > > >+PCI specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > > > override
> > > > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default
> > disable
> > > > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to enable
> > > > state
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > >+Precision Time Measurement (PTM)
> > > > > > >enable/disable.
> > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16) on
> > > > > > >+how to
> > > > > > translate
> > > > > > >the
> > > > > > >+/// below EFI encodings as per the PCI hardware terminology.
> > > > > > >+If this data
> > > > > > >member
> > > > > > >+/// value is returned as 0 than there is no platform policy
> > > > > > >+to override, this /// feature would be enabled as per its
> > > > > > >+PCI specification based on the
> > > > > > device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > > > disable
> > > > > > state
> > > > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable
> > state
> > > > > > only
> > > > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root
> > select
> > > > &
> > > > > > enable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > >+Completion Timeout
> > > > > > >+(CTO) set to
> > > > > > >supported ranges
> > > > > > >+/// or disable. Refer to PCI Base Specification 4, (chapter
> > > > > > >+7.5.3.16) on how
> > > > > > to
> > > > > > >+/// translate the below EFI encodings as per the PCI
> > > > > > >+hardware
> > > > terminology.
> > > > > > If
> > > > > > >this
> > > > > > >+/// data member value is returned as 0 than there is no
> > > > > > >+platform policy to
> > > > > > >override,
> > > > > > >+/// this feature would be enabled as per its PCI
> > > > > > >+specification based on the
> > > > > > >device
> > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > >+platform
> > policy.
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > > > >+
> > > > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request
> > for
> > > > > > override
> > > > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to default
> > > > range
> > > > > > of 5us
> > > > > > >to 50ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to range
> > of
> > > > 50us
> > > > > > to
> > > > > > >100us if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to range
> > of
> > > > 1ms
> > > > > > to
> > > > > > >10ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to range
> > of
> > > > > > 16ms to
> > > > > > >55ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to range
> > of
> > > > > > 65ms to
> > > > > > >210ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to range
> > of
> > > > > > 260ms to
> > > > > > >900ms if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to range
> > of
> > > > 1s
> > > > > > to 3.5s if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to range
> > of
> > > > 4s
> > > > > > to 13s if
> > > > > > >applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to range
> > of
> > > > 17s
> > > > > > to 64s
> > > > > > >if applicable
> > > > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > > > detection
> > > > > > >disable if applicable
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// Reserves for future use
> > > > > > >+///
> > > > > > >+typedef UINT8 EFI_PCI_CONF_RESERVES;
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > > > 128-byte
> > > > > > size,
> > > > > > >with each
> > > > > > >+/// byte field representing one PCI standerd feature defined
> > > > > > >+in the PCI
> > > > > > >Express Base
> > > > > > >+/// Specification 4.0, version 1.0.
> > > > > > >+///
> > > > > > >+typedef struct {
> > > > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > > > >+
> > > > > > >+/**
> > > > > > >+ Retrieves the PCI device-specific platform policy
> > > > > > >+regarding
> > > > > > enumeration.
> > > > > > >+
> > > > > > >+ The PCI Bus driver and PCI Host Bridge Resource Allocation
> > > > > > >+ Protocol
> > > > > > drivers
> > > > > > >+ can call this member function to retrieve the platform
> > > > > > >+ policies specific
> > > > > > to
> > > > > > >+ PCI device, regarding the PCI enumeration.
> > > > > > >+
> > > > > > >+ The GetDevicePolicy() function retrieves the platform
> > > > > > >+ policy for a
> > > > > > particular
> > > > > > >+ component regarding PCI enumeration. The PCI bus driver
> > > > > > >+ and the PCI
> > > > > > Host
> > > > > > >Bridge
> > > > > > >+ Resource Allocation Protocol driver can call this member
> > > > > > >+ function to
> > > > > > retrieve
> > > > > > >+ the policy.
> > > > > > >+ The existing GetPlatformPolicy() member function is used
> > > > > > >+ by the PCI Bus
> > > > > > >driver
> > > > > > >+ to program the legacy ranges, the data that is returned by
> > > > > > >+ that member
> > > > > > >function
> > > > > > >+ determines the supported attributes that are returned by
> > > > > > >+ the
> > > > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > > > >+ The GetDevicePolicy() member function is meant to return
> > > > > > >+ data about
> > > > > > >other PCI
> > > > > > >+ compliant features which would be supported by the PCI Bus
> > > > > > >+ driver in
> > > > > > >future;
> > > > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc.
> > > > > > >+ The details
> > > > > > >about
> > > > > > >+ this PCI features can be obtained from the PCI Base
> > > > > > >+ Specification
> > > > 4.x.
> > > > > > The
> > > > > > >+ EFI encodings for these feature are defined in the
> > > > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related
> > Definition
> > > > > > section
> > > > > > >for this.
> > > > > > >+ This member function will use the associated EFI handle of
> > > > > > >+ the PCI IO
> > > > > > >Protocol
> > > > > > >+ to determine the physical PCI device within the chipset,
> > > > > > >+ to return its device-specific platform policies.
> > > > > > >+
> > > > > > >+ @param[in] This Pointer to the
> > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > >instance.
> > > > > > >+ @param[in] PciDevice The associated PCI IO Protocol
> > handle
> > > > of
> > > > > > the PCI
> > > > > > >+ device. Type EFI_HANDLE is
> > defined
> > > > in
> > > > > > >+ InstallProtocolInterface() in
> > > > > > >+ the
> > > > UEFI
> > > > > > 2.1
> > > > > > >+ Specification @param[in]
> > > > PciExtPolicy
> > > > > > >+ The platform policy with respect to other
> > > > > > PCI
> > > > > > >features
> > > > > > >+ like, the MPS, MRRS, etc. Type
> > > > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > > > >+ is defined in "Related
> > Definitions"
> > > > > > below.
> > > > > > >+
> > > > > > >+
> > > > > > >+ @retval EFI_SUCCESS The function completed
> > > > > > successfully, may
> > > > > > >returns
> > > > > > >+ platform policy data for
> > the
> > > > given
> > > > > > PCI component
> > > > > > >+ @retval EFI_UNSUPPORTED PCI component belongs to
> > PCI
> > > > > > topology but
> > > > > > >not
> > > > > > >+ part of chipset to provide
> > the
> > > > > > platform policy
> > > > > > >+ @retval EFI_INVALID_PARAMETER If any of the input
> > parameters
> > > > are
> > > > > > >passed with
> > > > > > >+ invalid data
> > > > > > >+
> > > > > > >+ **/
> > > > > > >+typedef
> > > > > > >+EFI_STATUS
> > > > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > > > >+ IN EFI_HANDLE PciDevice,
> > > > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > > > >+
> > > > > > >+///
> > > > > > >+/// This protocol provides the interface between the PCI bus
> > > > > > >+driver/PCI
> > > > > > Host
> > > > > > >+/// Bridge Resource Allocation driver and a
> > > > > > >+platform-specific driver to
> > > > > > >describe
> > > > > > >+/// the unique features of a platform.
> > > > > > >+///
> > > > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > > > >+ ///
> > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > >+platform that it
> > > > > > is
> > > > > > >about to
> > > > > > >+ /// enter a certain phase during the enumeration process.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY PlatformNotify;
> > > > > > >+ ///
> > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > >+ platform for
> > > > > > each
> > > > > > >PCI
> > > > > > >+ /// controller at several predefined points during PCI
> > > > > > >+ controller
> > > > > > initialization.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > > > PlatformPrepController;
> > > > > > >+ ///
> > > > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > > > GetPlatformPolicy;
> > > > > > >+ ///
> > > > > > >+ /// Gets the PCI device's option ROM from a
> > > > > > >+ platform-specific
> > > > location.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > > > >+ ///
> > > > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > > > >+ regarding
> > > > > > enumeration.
> > > > > > >+ ///
> > > > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY
> > GetDevicePolicy;
> > > > > > >+ ///
> > > > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > > > >+ UINT8 MajorVersion;
> > > > > > >+ ///
> > > > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > > > >+ UINT8 MinorVersion;
> > > > > > >+
> > > > > > >+};
> > > > > > >+
> > > > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > > > >+
> > > > > > >+#endif
> > > > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > > > >b382efd578..670b448031 100644
> > > > > > >--- a/MdePkg/MdePkg.dec
> > > > > > >+++ b/MdePkg/MdePkg.dec
> > > > > > >@@ -1013,6 +1013,12 @@
> > > > > > > ## Include/Protocol/PciOverride.h
> > > > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c,
> > 0x4a06,
> > > > > > {0x99, 0xfc,
> > > > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > > > >
> > > > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945,
> > 0x4d60,
> > > > > > { 0x8d, 0x34,
> > > > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > > > >+
> > > > > > >+ ## Include/Protocol/PciOverride2.h
> > > > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb,
> > 0x4546,
> > > > > > { 0xb0, 0xbb,
> > > > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > > > >+
> > > > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > > > 0x3de1,
> > > > > > 0x4586,
> > > > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > > > >
> > > > > > >--
> > > > > > >2.21.0.windows.1
> > > > > >
> > > > > >
> > > > > >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 12:25 ` Yao, Jiewen
@ 2019-07-29 14:39 ` Javeed, Ashraf
2019-07-30 3:26 ` Liming Gao
0 siblings, 1 reply; 13+ messages in thread
From: Javeed, Ashraf @ 2019-07-29 14:39 UTC (permalink / raw)
To: Yao, Jiewen, devel@edk2.groups.io, Gao, Liming; +Cc: Kinney, Michael D, Ni, Ray
I did discuss this option with Ray; the thing is there is already a pair of protocols defined to retrieve platform policy - PCI Platform Protocol and its alias PCI Override Protocol; a new protocol would be third one for the same purpose, to be consumed by the PCI Bus driver or PCI Root Bridge Resource allocation driver; it appeared better to avoid new one and utilize existing one by enhancing it.
However, I am open for further suggestions.
Thanks
Ashraf
> -----Original Message-----
> From: Yao, Jiewen
> Sent: Monday, July 29, 2019 5:55 PM
> To: devel@edk2.groups.io; Yao, Jiewen <jiewen.yao@intel.com>; Javeed,
> Ashraf <ashraf.javeed@intel.com>; Gao, Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
>
> Forgot to mention: since we want to handle device policy, another option is to
> create PCI_DEVICE_POLICY_PROTOCOL. No need to update previous one.
>
> Thank you
> Yao Jiewen
>
> > -----Original Message-----
> > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of
> > Yao, Jiewen
> > Sent: Monday, July 29, 2019 8:19 PM
> > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io;
> > Gao, Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > I think the request makes sense.
> >
> > I am not sure if I understand your question on PCI attributes. It is
> > generic concept and defined in UEFI spec. Here we are discussing
> > device policy in PCIE spec.
> >
> > I checked ECR in https://bugzilla.tianocore.org/show_bug.cgi?id=1954,
> > it defines
> > typedef struct {
> > EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > EFI_PCI_CONF_PTM PTMControl;
> > EFI_PCI_CONF_RESERVES Reserves[117];
> > } EFI_PCI_PLATFORM_EXTENDED_POLICY;
> >
> > But in below patch, it is already changed to:
> >
> > typedef struct {
> > EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > EFI_PCI_CONF_PTM PTMControl;
> > EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > EFI_PCI_CONF_RESERVES Reserves[116];
> > } EFI_PCI_PLATFORM_EXTENDED_POLICY;
> >
> > That means, *the policy structure is changed within 1 month.*
> >
> > I am not sure how stable the current version is. But changing spec is
> > time consuming.
> >
> > Maybe we can start with EDKII interface only.
> > Wait for a while, to see if we need add something, then decide if
> > there is need to add to PI spec.
> >
> > Thank you
> > Yao Jiewen
> >
> >
> >
> > > -----Original Message-----
> > > From: Javeed, Ashraf
> > > Sent: Monday, July 29, 2019 7:18 PM
> > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > > Liming <liming.gao@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > My response inline below...
> > >
> > > Thanks
> > > Ashraf
> > >
> > > > -----Original Message-----
> > > > From: Yao, Jiewen
> > > > Sent: Monday, July 29, 2019 2:26 PM
> > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > > > devel@edk2.groups.io;
> > > Gao,
> > > > Liming <liming.gao@intel.com>
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>
> > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > protocol
> > > >
> > > > Oh. This patch is for staging. Not for EDKII master, right?
> > > > If so, I have no concern.
> > > > For the master, I think MdePkg should only include what has been
> > defined.
> > > >
> > > > For this patch, I am curious on how to maintain the compatibility?
> > > [Ashraf] I had discussion with Ray related to compatibility; the new
> > > GUID is defined to maintain both backward and forward compatibility,
> > > hence the name PCI Platform Protocol 2.
> > > >
> > > > For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
> > > [Ashraf] There is major/minor version defined in the PCI Platform
> > > Protocol
> > 2,
> > > which can
> > > be used for extending it in future if required.
> > > > It seems weird to bind a PI protocol to another industry standard.
> > > > We
> > had
> > > better
> > > > decouple them.
> > > [Ashraf] The abstraction for the PCI attributes are done in similar
> > > way as it
> > is
> > > done in
> > > the existing PI spec for the EFI_PCI_PLATFORM_POLICY. Please suggest
> > how
> > > to represent
> > > the PCI attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY
> > of
> > > the PciPlatform2.h?
> > > >
> > > > As such, we don't need update PI spec again and again just because
> > > > PCIE
> > > spec
> > > > update.
> > > > Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need
> > > > update
> > > protocol
> > > > interface just because they are updated.
> > > [Ashraf] As I have indicated in the feature request Id 1954; the
> > > reason to enhance this protocol is because there is no interface to
> > > obtain device specific platform policies from its platform firmware.
> > > There is a demand from Intel Server products to extend PCI standard
> > feature
> > > set in the PCI Bus driver
> > > of the MdeModulePkg, and this protocol needs to be enhanced to
> > > accommodate device-specific platform policies which would be used
> > > directly by the PCI Bus driver.
> > > I strongly believe enhancing this protocol will help the PCI Bus
> > > driver to support many PCI features seamlessly in future, without
> > > further changes to PI specification.
> > > Otherwise, please provide an alternative to consider the
> > > device-specific platform policies which the MdeModulePkg's PCI Bus
> > > driver can adhere to support those PCI standard features in future?
> > > >
> > > > Thank you
> > > > Yao Jiewen
> > > >
> > > > > -----Original Message-----
> > > > > From: Javeed, Ashraf
> > > > > Sent: Monday, July 29, 2019 4:12 PM
> > > > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io;
> > > > > Gao, Liming <liming.gao@intel.com>
> > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > <ray.ni@intel.com>
> > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > > V2]
> > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > protocol
> > > > >
> > > > > Hi Yao Jiewen,
> > > > > Can you please elaborate your concern?
> > > > > The PCI Platform Protocol / PCI Override Protocol are defined in
> > > > > PI
> > Spec
> > > 1.7.
> > > > > These same protocols are enhanced here.
> > > > > The producer would be the platform firmware, and consumer would
> > > > > be
> > > the
> > > > > MdeModulePkg's PCI Bus driver.
> > > > > The detailed document is attached to Bugzilla feature request Id 1954.
> > > > >
> > > > > Thanks
> > > > > Ashraf
> > > > >
> > > > > > -----Original Message-----
> > > > > > From: Yao, Jiewen
> > > > > > Sent: Monday, July 29, 2019 1:36 PM
> > > > > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > > > > Javeed,
> > > > > Ashraf
> > > > > > <ashraf.javeed@intel.com>
> > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > PATCH
> > > V2]
> > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > protocol
> > > > > >
> > > > > > Hi
> > > > > > I think this policy protocol should be EDKII specific.
> > > > > > Currently it is no in PI
> > > > > spec.
> > > > > > Should it be in MdeModulePkg ?
> > > > > >
> > > > > > Thank you
> > > > > > Yao Jiewen
> > > > > >
> > > > > > > -----Original Message-----
> > > > > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On
> > > Behalf
> > > > > Of
> > > > > > > Liming Gao
> > > > > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > > devel@edk2.groups.io
> > > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > > <ray.ni@intel.com>
> > > > > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > > PATCH
> > > > > V2]
> > > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > > protocol
> > > > > > >
> > > > > > > Ashraf:
> > > > > > > For new files, please use license: SPDX-License-Identifier:
> > > > > > > BSD-2-Clause-Patent.
> > > > > > >
> > > > > > > Other change is good. Reviewed-by: Liming Gao
> > > > > <liming.gao@intel.com>
> > > > > > >
> > > > > > > Thanks
> > > > > > > Liming
> > > > > > > >-----Original Message-----
> > > > > > > >From: Javeed, Ashraf
> > > > > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > > > > >To: devel@edk2.groups.io
> > > > > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao,
> > > > > > > >Liming <liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > > > > MdePkg/Protocols:
> > > > > > > >New interface, EFI encodings to PCI Plat protocol
> > > > > > > >
> > > > > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > > > > >
> > > > > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > > > > >Protocol to retrieve device-specific platform policy for
> > > > > > > >the following PCI standard features, like Maximum Payload
> > > > > > > >Size (MPS), Maximum Read Request Size (MRRS),Extended Tags,
> > > > > > > >Relax Order, No-Snoop, Active State Power Management
> > > > > > > >(ASPM),Latency Time Reporting (LTR),
> > > > > AtomicOp,
> > > > > > > >Reference Clock Configuration, Extended SYNCH, PTM support,
> > and
> > > > > > > >Completion Timeout
> > > > > > > (CTO).
> > > > > > > >New source files added with enhanced definitions are in:
> > > > > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > >
> > > > > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > > > > >---
> > > > > > > >
> > > > > > > >In V2: Correction made to header sections of source files
> > > > > > > >---
> > > > > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > +
> > > +++
> > > > > +
> > > > > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > > > > 3 files changed, 442 insertions(+)
> > > > > > > >
> > > > > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > >new file mode 100644
> > > > > > > >index 0000000000..a7f541b4c3
> > > > > > > >--- /dev/null
> > > > > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > >@@ -0,0 +1,43 @@
> > > > > > > >+/** @file
> > > > > > > >+ This file declares EFI PCI Override protocol which
> > > > > > > >+provides the interface
> > > > > > > >between
> > > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > > >+ driver and an
> > > > > > > >implementation's
> > > > > > > >+ driver to describe the unique features of a platform.
> > > > > > > >+ This protocol is optional.
> > > > > > > >+
> > > > > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > > > > >+ reserved.<BR> This program and the accompanying materials
> > > are
> > > > > > > >+ licensed and
> > > > > made
> > > > > > > >+ available under the terms and conditions of the
> > > > > > > BSD
> > > > > > > >License
> > > > > > > >+ which accompanies this distribution. The full text of
> > > > > > > >+ the license may
> > > > > > > be
> > > > > > > >found at
> > > > > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > > > > >+
> > > > > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON
> > AN
> > > > > "AS
> > > > > > > IS"
> > > > > > > >BASIS,
> > > > > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > > > EITHER
> > > > > > > >EXPRESS OR IMPLIED.
> > > > > > > >+
> > > > > > > >+
> > > > > > > >+**/
> > > > > > > >+
> > > > > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > > > > >+#define _PCI_OVERRIDE2_H_
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > > > > >+///
> > > > > > > >+#include <Protocol/PciPlatform2.h>
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL ///
> > > > > > > >+#define EFI_PCI_OVERRIDE2_GUID \
> > > > > > > >+ { \
> > > > > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d,
> > > > > > > >+0xae, 0xd9,
> > > > > > > 0x42, 0x47}
> > > > > > > >\
> > > > > > > >+ }
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > > > > >+
> > > > > > > >+
> > > > > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > > > > >+
> > > > > > > >+#endif
> > > > > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > >new file mode 100644
> > > > > > > >index 0000000000..717938e68d
> > > > > > > >--- /dev/null
> > > > > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > >@@ -0,0 +1,393 @@
> > > > > > > >+/** @file
> > > > > > > >+ This file declares PCI Platform Protocol that provide
> > > > > > > >+the interface
> > > > > > > between
> > > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > > >+ driver and a
> > > > > > > >platform-specific
> > > > > > > >+ driver to describe the unique features of a platform.
> > > > > > > >+ This protocol is optional.
> > > > > > > >+
> > > > > > > >+Copyright (c) 2019, Intel Corporation. All rights
> > > > > > > >+reserved.<BR> This program and the accompanying materials
> > > > > > > >+are licensed and made
> > > > > > > >available under
> > > > > > > >+the terms and conditions of the BSD License that
> > > > > > > >+accompanies this
> > > > > > > >distribution.
> > > > > > > >+The full text of the license may be found at
> > > > > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > > > > >+
> > > > > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > > "AS
> > > > > IS"
> > > > > > > >BASIS,
> > > > > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > EITHER
> > > > > > > >EXPRESS OR IMPLIED.
> > > > > > > >+
> > > > > > > >+
> > > > > > > >+**/
> > > > > > > >+
> > > > > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > > > > >+#define _PCI_PLATFORM2_H_
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This file must be included because the
> > > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > >uses
> > > > > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > > > > >+///
> > > > > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Reuse the existing definition to maintain backward
> > > > > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > > >+///
> > > > > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > > > > >+ { \
> > > > > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1,
> > 0x88,
> > > > > 0xd2,
> > > > > > > 0xd0,
> > > > > > > >0xb6} \
> > > > > > > >+ }
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// As per the present definition and specification of
> > > > > > > >+this protocol, the
> > > > > > > major
> > > > > > > >+/// version is 1, and minor version is 1. Any driver
> > > > > > > >+utilizing this protocol /// shall use these versions
> > > > > > > >+number to maintain the backward
> > > > > > > compatibility
> > > > > > > >as
> > > > > > > >+/// per its specification changes in future.
> > > > > > > >+///
> > > > > > > >+enum EfiPciPlatformProtocolVersion {
> > > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > > >+///
> > > > > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Following are the data types for
> > > > > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > > > > >+/// each for the PCI standard feature and its
> > > > > > > >+corresponding bitmask /// representing the valid
> > > > > > > >+combinations of PCI attributes ///
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature Maximum Payload Size
> (MPS).
> > > > > > > >+Refer to PCI Base
> > > > > > > >Specification
> > > > > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > > > > >+encodings as per
> > > > > > > >the
> > > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > > >+returned as 0
> > > > > > > >than
> > > > > > > >+/// there is no platform policy to override, this feature
> > > > > > > >+would be enabled
> > > > > > > as
> > > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > > >+the driver uses for
> > > > > > > interpreting
> > > > > > > >+/// the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00
> > > //No
> > > > > > > request for
> > > > > > > >override
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01
> > //set
> > > to
> > > > > > > default
> > > > > > > >128B
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02
> > //set
> > > to
> > > > > > > 256B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03
> > //set
> > > to
> > > > > > > 512B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04
> > //set
> > > to
> > > > > > > 1024B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05
> > //set
> > > to
> > > > > > > 2048B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06
> > //set
> > > to
> > > > > > > 4096B if
> > > > > > > >applicable
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature Maximum Read
> > > > > > > >+Request Size
> > > (MRRS).
> > > > > > > >+Refer to PCI
> > > > > > > >Base
> > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > >+terminology. If this data member
> > > > > > > >value
> > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > >+override, this
> > > > > > > feature
> > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > >+the device
> > > > > > > >capabilities.
> > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > >+the driver uses
> > > > > > > for
> > > > > > > >+/// interpreting the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00
> > > //No
> > > > > > > request
> > > > > > > >for override
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01
> > //set
> > > to
> > > > > > > default
> > > > > > > >128B
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02
> > //set
> > > to
> > > > > > > 256B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03
> > //set
> > > to
> > > > > > > 512B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04
> > //set
> > > to
> > > > > > > 1024B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05
> > //set
> > > to
> > > > > > > 2048B if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06
> > //set
> > > to
> > > > > > > 4096B if
> > > > > > > >applicable
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature Extended Tags.
> > > > > > > >+Refer to PCI Base Specification /// 4, (chapter 7.5.3.4)
> > > > > > > >+on how to translate the below EFI encodings as per
> > > > > > > >the
> > > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > > >+returned as 0
> > > > > > > >than
> > > > > > > >+/// there is no platform policy to override, this feature
> > > > > > > >+would be enabled
> > > > > > > as
> > > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > > >+the driver uses for
> > > > > > > interpreting
> > > > > > > >+/// the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > > > > request
> > > > > > > for
> > > > > > > >override
> > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > > > > default
> > > > > > > 5-bit
> > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to
> > > 8-bit
> > > > > if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to
> > > 10-bit
> > > > > if
> > > > > > > >applicable
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > >+Active State Power Mgmt (ASPM). Refer
> > > > > > > to
> > > > > > > >PCI Base
> > > > > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate
> > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > >+terminology. If this data member
> > > > > > > >value
> > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > >+override, this
> > > > > > > feature
> > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > >+the device
> > > > > > > >capabilities.
> > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > >+the driver uses
> > > > > > > for
> > > > > > > >+/// interpreting the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No
> > > request
> > > > > for
> > > > > > > override
> > > > > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > > > > default
> > > > > > > disable
> > > > > > > >state
> > > > > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to
> > > L0s
> > > > > state
> > > > > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to
> > > L1
> > > > > state
> > > > > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to
> > > L0s
> > > > > and
> > > > > > > L1
> > > > > > > >state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+Relax Ordering enable/disable. Refer
> > > > > > > to
> > > > > > > >PCI Base
> > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > >+terminology. If this data member
> > > > > > > >value
> > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > >+override, this
> > > > > > > feature
> > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > >+the device
> > > > > > > >capabilities.
> > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > >+the driver uses
> > > > > > > for
> > > > > > > >+/// interpreting the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > > > > override
> > > > > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default
> > > disable
> > > > > > > state
> > > > > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable
> > > state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+No-Snoop enable/disable. Refer to PCI
> > > > > > > >Base
> > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > >+terminology. If this data member
> > > > > > > >value
> > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > >+override, this
> > > > > > > feature
> > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > >+the device
> > > > > > > >capabilities.
> > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > >+the driver uses
> > > > > > > for
> > > > > > > >+/// interpreting the platform policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > > > > override
> > > > > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default
> > > disable
> > > > > state
> > > > > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable
> > state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > >+Clock configuration is common or
> > > > > > > discrete.
> > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7)
> > > > > > > >+on how to translate
> > > > > > > >the
> > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > >+terminology. If this data
> > > > > > > >member
> > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > >+per its PCI specification based on the
> > > > > > > device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No
> > request
> > > for
> > > > > > > override
> > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to
> > > default
> > > > > > > >asynchronous clock
> > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > > > > common
> > > > > > > clock
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > >+Extended Synch enable or
> > > > > disable.
> > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7)
> > > > > > > >+on how to translate
> > > > > > > >the
> > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > >+terminology. If this data
> > > > > > > >member
> > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > >+per its PCI specification based on the
> > > > > > > device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No
> > > request
> > > > > for
> > > > > > > override
> > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to
> > > default
> > > > > > > disable
> > > > > > > >state
> > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to
> > > enable
> > > > > > > state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+AtomicOp Requester enable or
> > > > > > > disable.
> > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > >+on how to
> > > > > > > translate
> > > > > > > >the
> > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > >+terminology. If this data
> > > > > > > >member
> > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > >+per its PCI specification based on the
> > > > > > > device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No
> > > request
> > > > > for
> > > > > > > >override
> > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to
> > > default
> > > > > > > disable
> > > > > > > >state
> > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to
> > > enable
> > > > > > > state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+LTR Mechanism
> > > > > enable/disable.
> > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > >+on how to
> > > > > > > translate
> > > > > > > >the
> > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > >+terminology. If this data
> > > > > > > >member
> > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > >+per its PCI specification based on the
> > > > > > > device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > > > > override
> > > > > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default
> > > disable
> > > > > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to
> > enable
> > > > > state
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+Precision Time Measurement (PTM)
> > > > > > > >enable/disable.
> > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > >+on how to
> > > > > > > translate
> > > > > > > >the
> > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > >+terminology. If this data
> > > > > > > >member
> > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > >+per its PCI specification based on the
> > > > > > > device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request
> > for
> > > > > > > override
> > > > > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > > > > disable
> > > > > > > state
> > > > > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable
> > > state
> > > > > > > only
> > > > > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root
> > > select
> > > > > &
> > > > > > > enable
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > >+Completion Timeout
> > > > > > > >+(CTO) set to
> > > > > > > >supported ranges
> > > > > > > >+/// or disable. Refer to PCI Base Specification 4,
> > > > > > > >+(chapter
> > > > > > > >+7.5.3.16) on how
> > > > > > > to
> > > > > > > >+/// translate the below EFI encodings as per the PCI
> > > > > > > >+hardware
> > > > > terminology.
> > > > > > > If
> > > > > > > >this
> > > > > > > >+/// data member value is returned as 0 than there is no
> > > > > > > >+platform policy to
> > > > > > > >override,
> > > > > > > >+/// this feature would be enabled as per its PCI
> > > > > > > >+specification based on the
> > > > > > > >device
> > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > >+platform
> > > policy.
> > > > > > > >+///
> > > > > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > > > > >+
> > > > > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request
> > > for
> > > > > > > override
> > > > > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to
> > default
> > > > > range
> > > > > > > of 5us
> > > > > > > >to 50ms if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to
> > range
> > > of
> > > > > 50us
> > > > > > > to
> > > > > > > >100us if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to
> > range
> > > of
> > > > > 1ms
> > > > > > > to
> > > > > > > >10ms if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to
> > range
> > > of
> > > > > > > 16ms to
> > > > > > > >55ms if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to
> > range
> > > of
> > > > > > > 65ms to
> > > > > > > >210ms if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to
> > range
> > > of
> > > > > > > 260ms to
> > > > > > > >900ms if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to
> > range
> > > of
> > > > > 1s
> > > > > > > to 3.5s if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to
> > range
> > > of
> > > > > 4s
> > > > > > > to 13s if
> > > > > > > >applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to
> > range
> > > of
> > > > > 17s
> > > > > > > to 64s
> > > > > > > >if applicable
> > > > > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > > > > detection
> > > > > > > >disable if applicable
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// Reserves for future use /// typedef UINT8
> > > > > > > >+EFI_PCI_CONF_RESERVES;
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > > > > 128-byte
> > > > > > > size,
> > > > > > > >with each
> > > > > > > >+/// byte field representing one PCI standerd feature
> > > > > > > >+defined in the PCI
> > > > > > > >Express Base
> > > > > > > >+/// Specification 4.0, version 1.0.
> > > > > > > >+///
> > > > > > > >+typedef struct {
> > > > > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG
> > LinkCtlCommonClkCfg;
> > > > > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > > > > >+
> > > > > > > >+/**
> > > > > > > >+ Retrieves the PCI device-specific platform policy
> > > > > > > >+regarding
> > > > > > > enumeration.
> > > > > > > >+
> > > > > > > >+ The PCI Bus driver and PCI Host Bridge Resource
> > > > > > > >+ Allocation Protocol
> > > > > > > drivers
> > > > > > > >+ can call this member function to retrieve the platform
> > > > > > > >+ policies specific
> > > > > > > to
> > > > > > > >+ PCI device, regarding the PCI enumeration.
> > > > > > > >+
> > > > > > > >+ The GetDevicePolicy() function retrieves the platform
> > > > > > > >+ policy for a
> > > > > > > particular
> > > > > > > >+ component regarding PCI enumeration. The PCI bus driver
> > > > > > > >+ and the PCI
> > > > > > > Host
> > > > > > > >Bridge
> > > > > > > >+ Resource Allocation Protocol driver can call this member
> > > > > > > >+ function to
> > > > > > > retrieve
> > > > > > > >+ the policy.
> > > > > > > >+ The existing GetPlatformPolicy() member function is used
> > > > > > > >+ by the PCI Bus
> > > > > > > >driver
> > > > > > > >+ to program the legacy ranges, the data that is returned
> > > > > > > >+ by that member
> > > > > > > >function
> > > > > > > >+ determines the supported attributes that are returned by
> > > > > > > >+ the
> > > > > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > > > > >+ The GetDevicePolicy() member function is meant to return
> > data
> > > > > > > >+ about
> > > > > > > >other PCI
> > > > > > > >+ compliant features which would be supported by the PCI
> > > > > > > >+ Bus driver in
> > > > > > > >future;
> > > > > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc.
> > > > > > > >+ The details
> > > > > > > >about
> > > > > > > >+ this PCI features can be obtained from the PCI Base
> > > > > > > >+ Specification
> > > > > 4.x.
> > > > > > > The
> > > > > > > >+ EFI encodings for these feature are defined in the
> > > > > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related
> > > Definition
> > > > > > > section
> > > > > > > >for this.
> > > > > > > >+ This member function will use the associated EFI handle
> > > > > > > >+ of the PCI IO
> > > > > > > >Protocol
> > > > > > > >+ to determine the physical PCI device within the chipset,
> > > > > > > >+ to return its device-specific platform policies.
> > > > > > > >+
> > > > > > > >+ @param[in] This Pointer to the
> > > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > >instance.
> > > > > > > >+ @param[in] PciDevice The associated PCI IO Protocol
> > > handle
> > > > > of
> > > > > > > the PCI
> > > > > > > >+ device. Type EFI_HANDLE is
> > > defined
> > > > > in
> > > > > > > >+ InstallProtocolInterface() in
> > the
> > > > > UEFI
> > > > > > > 2.1
> > > > > > > >+ Specification @param[in]
> > > > > PciExtPolicy
> > > > > > > >+ The platform policy with respect to other
> > > > > > > PCI
> > > > > > > >features
> > > > > > > >+ like, the MPS, MRRS, etc. Type
> > > > > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > > > > >+ is defined in "Related
> > > Definitions"
> > > > > > > below.
> > > > > > > >+
> > > > > > > >+
> > > > > > > >+ @retval EFI_SUCCESS The function completed
> > > > > > > successfully, may
> > > > > > > >returns
> > > > > > > >+ platform policy data for
> > > the
> > > > > given
> > > > > > > PCI component
> > > > > > > >+ @retval EFI_UNSUPPORTED PCI component belongs
> > to
> > > PCI
> > > > > > > topology but
> > > > > > > >not
> > > > > > > >+ part of chipset to
> > provide
> > > the
> > > > > > > platform policy
> > > > > > > >+ @retval EFI_INVALID_PARAMETER If any of the input
> > > parameters
> > > > > are
> > > > > > > >passed with
> > > > > > > >+ invalid data
> > > > > > > >+
> > > > > > > >+ **/
> > > > > > > >+typedef
> > > > > > > >+EFI_STATUS
> > > > > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > > > > >+ IN EFI_HANDLE PciDevice,
> > > > > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > > > > >+
> > > > > > > >+///
> > > > > > > >+/// This protocol provides the interface between the PCI
> > > > > > > >+bus driver/PCI
> > > > > > > Host
> > > > > > > >+/// Bridge Resource Allocation driver and a
> > > > > > > >+platform-specific driver to
> > > > > > > >describe
> > > > > > > >+/// the unique features of a platform.
> > > > > > > >+///
> > > > > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > > > > >+ ///
> > > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > > >+platform that it
> > > > > > > is
> > > > > > > >about to
> > > > > > > >+ /// enter a certain phase during the enumeration process.
> > > > > > > >+ ///
> > > > > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY
> > PlatformNotify;
> > > > > > > >+ ///
> > > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > > >+ platform for
> > > > > > > each
> > > > > > > >PCI
> > > > > > > >+ /// controller at several predefined points during PCI
> > > > > > > >+ controller
> > > > > > > initialization.
> > > > > > > >+ ///
> > > > > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > > > > PlatformPrepController;
> > > > > > > >+ ///
> > > > > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > > > > >+ ///
> > > > > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > > > > GetPlatformPolicy;
> > > > > > > >+ ///
> > > > > > > >+ /// Gets the PCI device's option ROM from a
> > > > > > > >+ platform-specific
> > > > > location.
> > > > > > > >+ ///
> > > > > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > > > > >+ ///
> > > > > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > > > > >+ regarding
> > > > > > > enumeration.
> > > > > > > >+ ///
> > > > > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY
> > > GetDevicePolicy;
> > > > > > > >+ ///
> > > > > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > > > > >+ UINT8 MajorVersion;
> > > > > > > >+ ///
> > > > > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > > > > >+ UINT8 MinorVersion;
> > > > > > > >+
> > > > > > > >+};
> > > > > > > >+
> > > > > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > > > > >+
> > > > > > > >+#endif
> > > > > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > > > > >b382efd578..670b448031 100644
> > > > > > > >--- a/MdePkg/MdePkg.dec
> > > > > > > >+++ b/MdePkg/MdePkg.dec
> > > > > > > >@@ -1013,6 +1013,12 @@
> > > > > > > > ## Include/Protocol/PciOverride.h
> > > > > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c,
> > > 0x4a06,
> > > > > > > {0x99, 0xfc,
> > > > > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > > > > >
> > > > > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945,
> > > 0x4d60,
> > > > > > > { 0x8d, 0x34,
> > > > > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > > > > >+
> > > > > > > >+ ## Include/Protocol/PciOverride2.h
> > > > > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb,
> > > 0x4546,
> > > > > > > { 0xb0, 0xbb,
> > > > > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > > > > >+
> > > > > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > > > > 0x3de1,
> > > > > > > 0x4586,
> > > > > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > > > > >
> > > > > > > >--
> > > > > > > >2.21.0.windows.1
> > > > > > >
> > > > > > >
> > > > > > >
> >
> >
> >
^ permalink raw reply [flat|nested] 13+ messages in thread
* Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
2019-07-29 14:39 ` Javeed, Ashraf
@ 2019-07-30 3:26 ` Liming Gao
0 siblings, 0 replies; 13+ messages in thread
From: Liming Gao @ 2019-07-30 3:26 UTC (permalink / raw)
To: Javeed, Ashraf, Yao, Jiewen, devel@edk2.groups.io
Cc: Kinney, Michael D, Ni, Ray
For this patch, I am OK to add it into edk2-staging/UEFI_PCI_ENHANCE-2 first, and for further discussion.
Thanks
Liming
> -----Original Message-----
> From: Javeed, Ashraf
> Sent: Monday, July 29, 2019 10:40 PM
> To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray <ray.ni@intel.com>
> Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> protocol
>
> I did discuss this option with Ray; the thing is there is already a pair of protocols defined to retrieve platform policy - PCI Platform Protocol
> and its alias PCI Override Protocol; a new protocol would be third one for the same purpose, to be consumed by the PCI Bus driver or PCI
> Root Bridge Resource allocation driver; it appeared better to avoid new one and utilize existing one by enhancing it.
> However, I am open for further suggestions.
> Thanks
> Ashraf
>
> > -----Original Message-----
> > From: Yao, Jiewen
> > Sent: Monday, July 29, 2019 5:55 PM
> > To: devel@edk2.groups.io; Yao, Jiewen <jiewen.yao@intel.com>; Javeed,
> > Ashraf <ashraf.javeed@intel.com>; Gao, Liming <liming.gao@intel.com>
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > <ray.ni@intel.com>
> > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> >
> > Forgot to mention: since we want to handle device policy, another option is to
> > create PCI_DEVICE_POLICY_PROTOCOL. No need to update previous one.
> >
> > Thank you
> > Yao Jiewen
> >
> > > -----Original Message-----
> > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of
> > > Yao, Jiewen
> > > Sent: Monday, July 29, 2019 8:19 PM
> > > To: Javeed, Ashraf <ashraf.javeed@intel.com>; devel@edk2.groups.io;
> > > Gao, Liming <liming.gao@intel.com>
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > <ray.ni@intel.com>
> > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > >
> > > I think the request makes sense.
> > >
> > > I am not sure if I understand your question on PCI attributes. It is
> > > generic concept and defined in UEFI spec. Here we are discussing
> > > device policy in PCIE spec.
> > >
> > > I checked ECR in https://bugzilla.tianocore.org/show_bug.cgi?id=1954,
> > > it defines
> > > typedef struct {
> > > EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > EFI_PCI_CONF_PTM PTMControl;
> > > EFI_PCI_CONF_RESERVES Reserves[117];
> > > } EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > >
> > > But in below patch, it is already changed to:
> > >
> > > typedef struct {
> > > EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > EFI_PCI_CONF_COMMON_CLOCK_CFG LinkCtlCommonClkCfg;
> > > EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > EFI_PCI_CONF_PTM PTMControl;
> > > EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > EFI_PCI_CONF_RESERVES Reserves[116];
> > > } EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > >
> > > That means, *the policy structure is changed within 1 month.*
> > >
> > > I am not sure how stable the current version is. But changing spec is
> > > time consuming.
> > >
> > > Maybe we can start with EDKII interface only.
> > > Wait for a while, to see if we need add something, then decide if
> > > there is need to add to PI spec.
> > >
> > > Thank you
> > > Yao Jiewen
> > >
> > >
> > >
> > > > -----Original Message-----
> > > > From: Javeed, Ashraf
> > > > Sent: Monday, July 29, 2019 7:18 PM
> > > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io; Gao,
> > > > Liming <liming.gao@intel.com>
> > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > <ray.ni@intel.com>
> > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol
> > > >
> > > > My response inline below...
> > > >
> > > > Thanks
> > > > Ashraf
> > > >
> > > > > -----Original Message-----
> > > > > From: Yao, Jiewen
> > > > > Sent: Monday, July 29, 2019 2:26 PM
> > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > > > > devel@edk2.groups.io;
> > > > Gao,
> > > > > Liming <liming.gao@intel.com>
> > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > <ray.ni@intel.com>
> > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > > V2]
> > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > protocol
> > > > >
> > > > > Oh. This patch is for staging. Not for EDKII master, right?
> > > > > If so, I have no concern.
> > > > > For the master, I think MdePkg should only include what has been
> > > defined.
> > > > >
> > > > > For this patch, I am curious on how to maintain the compatibility?
> > > > [Ashraf] I had discussion with Ray related to compatibility; the new
> > > > GUID is defined to maintain both backward and forward compatibility,
> > > > hence the name PCI Platform Protocol 2.
> > > > >
> > > > > For example, what happen, if PCIE 5.0 or PCIE 6.0 add new device policy?
> > > > [Ashraf] There is major/minor version defined in the PCI Platform
> > > > Protocol
> > > 2,
> > > > which can
> > > > be used for extending it in future if required.
> > > > > It seems weird to bind a PI protocol to another industry standard.
> > > > > We
> > > had
> > > > better
> > > > > decouple them.
> > > > [Ashraf] The abstraction for the PCI attributes are done in similar
> > > > way as it
> > > is
> > > > done in
> > > > the existing PI spec for the EFI_PCI_PLATFORM_POLICY. Please suggest
> > > how
> > > > to represent
> > > > the PCI attributes defined in the EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > of
> > > > the PciPlatform2.h?
> > > > >
> > > > > As such, we don't need update PI spec again and again just because
> > > > > PCIE
> > > > spec
> > > > > update.
> > > > > Thinking of SMBIOS, ACPI, ATA, SCSI, I don't believe we need
> > > > > update
> > > > protocol
> > > > > interface just because they are updated.
> > > > [Ashraf] As I have indicated in the feature request Id 1954; the
> > > > reason to enhance this protocol is because there is no interface to
> > > > obtain device specific platform policies from its platform firmware.
> > > > There is a demand from Intel Server products to extend PCI standard
> > > feature
> > > > set in the PCI Bus driver
> > > > of the MdeModulePkg, and this protocol needs to be enhanced to
> > > > accommodate device-specific platform policies which would be used
> > > > directly by the PCI Bus driver.
> > > > I strongly believe enhancing this protocol will help the PCI Bus
> > > > driver to support many PCI features seamlessly in future, without
> > > > further changes to PI specification.
> > > > Otherwise, please provide an alternative to consider the
> > > > device-specific platform policies which the MdeModulePkg's PCI Bus
> > > > driver can adhere to support those PCI standard features in future?
> > > > >
> > > > > Thank you
> > > > > Yao Jiewen
> > > > >
> > > > > > -----Original Message-----
> > > > > > From: Javeed, Ashraf
> > > > > > Sent: Monday, July 29, 2019 4:12 PM
> > > > > > To: Yao, Jiewen <jiewen.yao@intel.com>; devel@edk2.groups.io;
> > > > > > Gao, Liming <liming.gao@intel.com>
> > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > <ray.ni@intel.com>
> > > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH
> > > > V2]
> > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > protocol
> > > > > >
> > > > > > Hi Yao Jiewen,
> > > > > > Can you please elaborate your concern?
> > > > > > The PCI Platform Protocol / PCI Override Protocol are defined in
> > > > > > PI
> > > Spec
> > > > 1.7.
> > > > > > These same protocols are enhanced here.
> > > > > > The producer would be the platform firmware, and consumer would
> > > > > > be
> > > > the
> > > > > > MdeModulePkg's PCI Bus driver.
> > > > > > The detailed document is attached to Bugzilla feature request Id 1954.
> > > > > >
> > > > > > Thanks
> > > > > > Ashraf
> > > > > >
> > > > > > > -----Original Message-----
> > > > > > > From: Yao, Jiewen
> > > > > > > Sent: Monday, July 29, 2019 1:36 PM
> > > > > > > To: devel@edk2.groups.io; Gao, Liming <liming.gao@intel.com>;
> > > > > > > Javeed,
> > > > > > Ashraf
> > > > > > > <ashraf.javeed@intel.com>
> > > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > > <ray.ni@intel.com>; Yao, Jiewen <jiewen.yao@intel.com>
> > > > > > > Subject: RE: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > > PATCH
> > > > V2]
> > > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > > protocol
> > > > > > >
> > > > > > > Hi
> > > > > > > I think this policy protocol should be EDKII specific.
> > > > > > > Currently it is no in PI
> > > > > > spec.
> > > > > > > Should it be in MdeModulePkg ?
> > > > > > >
> > > > > > > Thank you
> > > > > > > Yao Jiewen
> > > > > > >
> > > > > > > > -----Original Message-----
> > > > > > > > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On
> > > > Behalf
> > > > > > Of
> > > > > > > > Liming Gao
> > > > > > > > Sent: Monday, July 29, 2019 3:52 PM
> > > > > > > > To: Javeed, Ashraf <ashraf.javeed@intel.com>;
> > > > devel@edk2.groups.io
> > > > > > > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Ni, Ray
> > > > > > > > <ray.ni@intel.com>
> > > > > > > > Subject: Re: [edk2-devel] [edk2-staging/UEFI_PCI_ENHANCE-2
> > > > PATCH
> > > > > > V2]
> > > > > > > > MdePkg/Protocols: New interface, EFI encodings to PCI Plat
> > > > > > > > protocol
> > > > > > > >
> > > > > > > > Ashraf:
> > > > > > > > For new files, please use license: SPDX-License-Identifier:
> > > > > > > > BSD-2-Clause-Patent.
> > > > > > > >
> > > > > > > > Other change is good. Reviewed-by: Liming Gao
> > > > > > <liming.gao@intel.com>
> > > > > > > >
> > > > > > > > Thanks
> > > > > > > > Liming
> > > > > > > > >-----Original Message-----
> > > > > > > > >From: Javeed, Ashraf
> > > > > > > > >Sent: Monday, July 29, 2019 2:52 PM
> > > > > > > > >To: devel@edk2.groups.io
> > > > > > > > >Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao,
> > > > > > > > >Liming <liming.gao@intel.com>; Ni, Ray <ray.ni@intel.com>
> > > > > > > > >Subject: [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2]
> > > > > > > > MdePkg/Protocols:
> > > > > > > > >New interface, EFI encodings to PCI Plat protocol
> > > > > > > > >
> > > > > > > > >BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=1954
> > > > > > > > >
> > > > > > > > >New interface added to PCI Platform Protocol / PCI Override
> > > > > > > > >Protocol to retrieve device-specific platform policy for
> > > > > > > > >the following PCI standard features, like Maximum Payload
> > > > > > > > >Size (MPS), Maximum Read Request Size (MRRS),Extended Tags,
> > > > > > > > >Relax Order, No-Snoop, Active State Power Management
> > > > > > > > >(ASPM),Latency Time Reporting (LTR),
> > > > > > AtomicOp,
> > > > > > > > >Reference Clock Configuration, Extended SYNCH, PTM support,
> > > and
> > > > > > > > >Completion Timeout
> > > > > > > > (CTO).
> > > > > > > > >New source files added with enhanced definitions are in:
> > > > > > > > >MdePkg/Include/Protocol/PciPlatform2.h,
> > > > > > > > >MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > > >
> > > > > > > > >Signed-off-by: Ashraf Javeed <ashraf.javeed@intel.com>
> > > > > > > > >Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > > > > > > >Cc: Liming Gao <liming.gao@intel.com>
> > > > > > > > >Cc: Ray Ni <ray.ni@intel.com>
> > > > > > > > >---
> > > > > > > > >
> > > > > > > > >In V2: Correction made to header sections of source files
> > > > > > > > >---
> > > > > > > > > MdePkg/Include/Protocol/PciOverride2.h | 43
> > > > > > > > >+++++++++++++++++++++++++++++++++++++++++++
> > > > > > > > > MdePkg/Include/Protocol/PciPlatform2.h | 393
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >++++++++++++++++++++++++++++++++++++++++++++++++++++++
> > > +
> > > > +++
> > > > > > +
> > > > > > > > >+++++++++++++++++++++++++++++++++++++++
> > > > > > > > > MdePkg/MdePkg.dec | 6 ++++++
> > > > > > > > > 3 files changed, 442 insertions(+)
> > > > > > > > >
> > > > > > > > >diff --git a/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > > >b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > > >new file mode 100644
> > > > > > > > >index 0000000000..a7f541b4c3
> > > > > > > > >--- /dev/null
> > > > > > > > >+++ b/MdePkg/Include/Protocol/PciOverride2.h
> > > > > > > > >@@ -0,0 +1,43 @@
> > > > > > > > >+/** @file
> > > > > > > > >+ This file declares EFI PCI Override protocol which
> > > > > > > > >+provides the interface
> > > > > > > > >between
> > > > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > > > >+ driver and an
> > > > > > > > >implementation's
> > > > > > > > >+ driver to describe the unique features of a platform.
> > > > > > > > >+ This protocol is optional.
> > > > > > > > >+
> > > > > > > > >+ Copyright (c) 2019, Intel Corporation. All rights
> > > > > > > > >+ reserved.<BR> This program and the accompanying materials
> > > > are
> > > > > > > > >+ licensed and
> > > > > > made
> > > > > > > > >+ available under the terms and conditions of the
> > > > > > > > BSD
> > > > > > > > >License
> > > > > > > > >+ which accompanies this distribution. The full text of
> > > > > > > > >+ the license may
> > > > > > > > be
> > > > > > > > >found at
> > > > > > > > >+ http://opensource.org/licenses/bsd-license.php
> > > > > > > > >+
> > > > > > > > >+ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON
> > > AN
> > > > > > "AS
> > > > > > > > IS"
> > > > > > > > >BASIS,
> > > > > > > > >+ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > > > > EITHER
> > > > > > > > >EXPRESS OR IMPLIED.
> > > > > > > > >+
> > > > > > > > >+
> > > > > > > > >+**/
> > > > > > > > >+
> > > > > > > > >+#ifndef _PCI_OVERRIDE2_H_
> > > > > > > > >+#define _PCI_OVERRIDE2_H_
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// EFI_PCI_OVERRIDE_PROTOCOL has the same structure with
> > > > > > > > >EFI_PCI_PLATFORM_PROTOCOL
> > > > > > > > >+///
> > > > > > > > >+#include <Protocol/PciPlatform2.h>
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Global ID for the EFI_PCI_OVERRIDE_PROTOCOL ///
> > > > > > > > >+#define EFI_PCI_OVERRIDE2_GUID \
> > > > > > > > >+ { \
> > > > > > > > >+ 0xb9d5ea1, 0x66cb, 0x4546, {0xb0, 0xbb, 0x5c, 0x6d,
> > > > > > > > >+0xae, 0xd9,
> > > > > > > > 0x42, 0x47}
> > > > > > > > >\
> > > > > > > > >+ }
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Declaration for EFI_PCI_OVERRIDE_PROTOCOL /// typedef
> > > > > > > > >+EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > > EFI_PCI_OVERRIDE_PROTOCOL2;
> > > > > > > > >+
> > > > > > > > >+
> > > > > > > > >+extern EFI_GUID gEfiPciOverrideProtocol2Guid;
> > > > > > > > >+
> > > > > > > > >+#endif
> > > > > > > > >diff --git a/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > > >b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > > >new file mode 100644
> > > > > > > > >index 0000000000..717938e68d
> > > > > > > > >--- /dev/null
> > > > > > > > >+++ b/MdePkg/Include/Protocol/PciPlatform2.h
> > > > > > > > >@@ -0,0 +1,393 @@
> > > > > > > > >+/** @file
> > > > > > > > >+ This file declares PCI Platform Protocol that provide
> > > > > > > > >+the interface
> > > > > > > > between
> > > > > > > > >+ the PCI bus driver/PCI Host Bridge Resource Allocation
> > > > > > > > >+ driver and a
> > > > > > > > >platform-specific
> > > > > > > > >+ driver to describe the unique features of a platform.
> > > > > > > > >+ This protocol is optional.
> > > > > > > > >+
> > > > > > > > >+Copyright (c) 2019, Intel Corporation. All rights
> > > > > > > > >+reserved.<BR> This program and the accompanying materials
> > > > > > > > >+are licensed and made
> > > > > > > > >available under
> > > > > > > > >+the terms and conditions of the BSD License that
> > > > > > > > >+accompanies this
> > > > > > > > >distribution.
> > > > > > > > >+The full text of the license may be found at
> > > > > > > > >+http://opensource.org/licenses/bsd-license.php.
> > > > > > > > >+
> > > > > > > > >+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN
> > > > "AS
> > > > > > IS"
> > > > > > > > >BASIS,
> > > > > > > > >+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND,
> > > > EITHER
> > > > > > > > >EXPRESS OR IMPLIED.
> > > > > > > > >+
> > > > > > > > >+
> > > > > > > > >+**/
> > > > > > > > >+
> > > > > > > > >+#ifndef _PCI_PLATFORM2_H_
> > > > > > > > >+#define _PCI_PLATFORM2_H_
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This file must be included because the
> > > > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > > >uses
> > > > > > > > >+/// EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE.
> > > > > > > > >+///
> > > > > > > > >+#include <Protocol/PciHostBridgeResourceAllocation.h>
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Reuse the existing definition to maintain backward
> > > > > > > > >+compatibility /// #include <Protocol/PciPlatform.h>
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Global ID for the EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > > > >+///
> > > > > > > > >+#define EFI_PCI_PLATFORM_PROTOCOL2_GUID \
> > > > > > > > >+ { \
> > > > > > > > >+ 0x787b0367, 0xa945, 0x4d60, {0x8d, 0x34, 0xb9, 0xd1,
> > > 0x88,
> > > > > > 0xd2,
> > > > > > > > 0xd0,
> > > > > > > > >0xb6} \
> > > > > > > > >+ }
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// As per the present definition and specification of
> > > > > > > > >+this protocol, the
> > > > > > > > major
> > > > > > > > >+/// version is 1, and minor version is 1. Any driver
> > > > > > > > >+utilizing this protocol /// shall use these versions
> > > > > > > > >+number to maintain the backward
> > > > > > > > compatibility
> > > > > > > > >as
> > > > > > > > >+/// per its specification changes in future.
> > > > > > > > >+///
> > > > > > > > >+enum EfiPciPlatformProtocolVersion {
> > > > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MAJOR_VERSION = 1,
> > > > > > > > >+ EFI_PCI_PLATFORM_PROTOCOL_MINOR_VERSION = 1 };
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Forward declaration for EFI_PCI_PLATFORM_PROTOCOL2.
> > > > > > > > >+///
> > > > > > > > >+typedef struct _EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > > >EFI_PCI_PLATFORM_PROTOCOL2;
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Following are the data types for
> > > > > > > > >EFI_PCI_PLATYFORM_EXTENDED_POLICY
> > > > > > > > >+/// each for the PCI standard feature and its
> > > > > > > > >+corresponding bitmask /// representing the valid
> > > > > > > > >+combinations of PCI attributes ///
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature Maximum Payload Size
> > (MPS).
> > > > > > > > >+Refer to PCI Base
> > > > > > > > >Specification
> > > > > > > > >+/// 4, (chapter 7.5.3.4) on how to translate the below EFI
> > > > > > > > >+encodings as per
> > > > > > > > >the
> > > > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > > > >+returned as 0
> > > > > > > > >than
> > > > > > > > >+/// there is no platform policy to override, this feature
> > > > > > > > >+would be enabled
> > > > > > > > as
> > > > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > > > >+the driver uses for
> > > > > > > > interpreting
> > > > > > > > >+/// the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_PAYLOAD_SIZE;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_AUTO 0x00
> > > > //No
> > > > > > > > request for
> > > > > > > > >override
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_128B 0x01
> > > //set
> > > > to
> > > > > > > > default
> > > > > > > > >128B
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_256B 0x02
> > > //set
> > > > to
> > > > > > > > 256B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_512B 0x03
> > > //set
> > > > to
> > > > > > > > 512B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_1024B 0x04
> > > //set
> > > > to
> > > > > > > > 1024B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_2048B 0x05
> > > //set
> > > > to
> > > > > > > > 2048B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_PAYLOAD_SIZE_4096B 0x06
> > > //set
> > > > to
> > > > > > > > 4096B if
> > > > > > > > >applicable
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature Maximum Read
> > > > > > > > >+Request Size
> > > > (MRRS).
> > > > > > > > >+Refer to PCI
> > > > > > > > >Base
> > > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data member
> > > > > > > > >value
> > > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > > >+override, this
> > > > > > > > feature
> > > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > > >+the device
> > > > > > > > >capabilities.
> > > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > > >+the driver uses
> > > > > > > > for
> > > > > > > > >+/// interpreting the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_MAX_READ_REQ_SIZE;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_AUTO 0x00
> > > > //No
> > > > > > > > request
> > > > > > > > >for override
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_128B 0x01
> > > //set
> > > > to
> > > > > > > > default
> > > > > > > > >128B
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_256B 0x02
> > > //set
> > > > to
> > > > > > > > 256B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_512B 0x03
> > > //set
> > > > to
> > > > > > > > 512B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_1024B 0x04
> > > //set
> > > > to
> > > > > > > > 1024B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_2048B 0x05
> > > //set
> > > > to
> > > > > > > > 2048B if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_MAX_READ_REQ_SIZE_4096B 0x06
> > > //set
> > > > to
> > > > > > > > 4096B if
> > > > > > > > >applicable
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature Extended Tags.
> > > > > > > > >+Refer to PCI Base Specification /// 4, (chapter 7.5.3.4)
> > > > > > > > >+on how to translate the below EFI encodings as per
> > > > > > > > >the
> > > > > > > > >+/// PCI hardware terminology. If this data member value is
> > > > > > > > >+returned as 0
> > > > > > > > >than
> > > > > > > > >+/// there is no platform policy to override, this feature
> > > > > > > > >+would be enabled
> > > > > > > > as
> > > > > > > > >+/// per its PCI specification based on the device capabilities.
> > > > > > > > >+Below is it /// data type and the macro definitions which
> > > > > > > > >+the driver uses for
> > > > > > > > interpreting
> > > > > > > > >+/// the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_TAG;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_AUTO 0x00 //No
> > > > > > request
> > > > > > > > for
> > > > > > > > >override
> > > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_5BIT 0x01 //set to
> > > > > > default
> > > > > > > > 5-bit
> > > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_8BIT 0x02 //set to
> > > > 8-bit
> > > > > > if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_EXTENDED_TAG_10BIT 0x03 //set to
> > > > 10-bit
> > > > > > if
> > > > > > > > >applicable
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > > >+Active State Power Mgmt (ASPM). Refer
> > > > > > > > to
> > > > > > > > >PCI Base
> > > > > > > > >+/// Specification 4, (chapter 7.5.3.7) on how to translate
> > > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data member
> > > > > > > > >value
> > > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > > >+override, this
> > > > > > > > feature
> > > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > > >+the device
> > > > > > > > >capabilities.
> > > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > > >+the driver uses
> > > > > > > > for
> > > > > > > > >+/// interpreting the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_ASPM_SUPPORT;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_ASPM_AUTO 0x00 //No
> > > > request
> > > > > > for
> > > > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_ASPM_DISABLE 0x01 //set to
> > > > > > default
> > > > > > > > disable
> > > > > > > > >state
> > > > > > > > >+#define EFI_PCI_CONF_ASPM_L0s_SUPPORT 0x02 //set to
> > > > L0s
> > > > > > state
> > > > > > > > >+#define EFI_PCI_CONF_ASPM_L1_SUPPORT 0x03 //set to
> > > > L1
> > > > > > state
> > > > > > > > >+#define EFI_PCI_CONF_ASPM_L0S_L1_SUPPORT 0x04 //set to
> > > > L0s
> > > > > > and
> > > > > > > > L1
> > > > > > > > >state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+Relax Ordering enable/disable. Refer
> > > > > > > > to
> > > > > > > > >PCI Base
> > > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data member
> > > > > > > > >value
> > > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > > >+override, this
> > > > > > > > feature
> > > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > > >+the device
> > > > > > > > >capabilities.
> > > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > > >+the driver uses
> > > > > > > > for
> > > > > > > > >+/// interpreting the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_RELAX_ORDER;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_RO_AUTO 0x00 //No request for
> > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_RO_DISABLE 0x01 //set to default
> > > > disable
> > > > > > > > state
> > > > > > > > >+#define EFI_PCI_CONF_RO_ENABLE 0x02 //set to enable
> > > > state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+No-Snoop enable/disable. Refer to PCI
> > > > > > > > >Base
> > > > > > > > >+/// Specification 4, (chapter 7.5.3.4) on how to translate
> > > > > > > > >+the below EFI /// encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data member
> > > > > > > > >value
> > > > > > > > >+/// is returned as 0 than there is no platform policy to
> > > > > > > > >+override, this
> > > > > > > > feature
> > > > > > > > >+/// would be enabled as per its PCI specification based on
> > > > > > > > >+the device
> > > > > > > > >capabilities.
> > > > > > > > >+/// Below is it data type and the macro definitions which
> > > > > > > > >+the driver uses
> > > > > > > > for
> > > > > > > > >+/// interpreting the platform policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_NO_SNOOP;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_NS_AUTO 0x00 //No request for
> > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_NS_DISABLE 0x01 //set to default
> > > > disable
> > > > > > state
> > > > > > > > >+#define EFI_PCI_CONF_NS_ENABLE 0x02 //set to enable
> > > state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > > >+Clock configuration is common or
> > > > > > > > discrete.
> > > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7)
> > > > > > > > >+on how to translate
> > > > > > > > >the
> > > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data
> > > > > > > > >member
> > > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > > >+per its PCI specification based on the
> > > > > > > > device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_COMMON_CLOCK_CFG;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_AUTO 0x00 //No
> > > request
> > > > for
> > > > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_ASYNCH 0x01 //set to
> > > > default
> > > > > > > > >asynchronous clock
> > > > > > > > >+#define EFI_PCI_CONF_CLK_CFG_COMMON 0x02 //set to
> > > > > > common
> > > > > > > > clock
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe link's
> > > > > > > > >+Extended Synch enable or
> > > > > > disable.
> > > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.7)
> > > > > > > > >+on how to translate
> > > > > > > > >the
> > > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data
> > > > > > > > >member
> > > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > > >+per its PCI specification based on the
> > > > > > > > device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_EXTENDED_SYNCH;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_AUTO 0x00 //No
> > > > request
> > > > > > for
> > > > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_DISABLE 0x01 //set to
> > > > default
> > > > > > > > disable
> > > > > > > > >state
> > > > > > > > >+#define EFI_PCI_CONF_EXT_SYNCH_ENABLE 0x02 //set to
> > > > enable
> > > > > > > > state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+AtomicOp Requester enable or
> > > > > > > > disable.
> > > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > > >+on how to
> > > > > > > > translate
> > > > > > > > >the
> > > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data
> > > > > > > > >member
> > > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > > >+per its PCI specification based on the
> > > > > > > > device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_ATOMIC_OP;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_AUTO 0x00 //No
> > > > request
> > > > > > for
> > > > > > > > >override
> > > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_DISABLE 0x01 //set to
> > > > default
> > > > > > > > disable
> > > > > > > > >state
> > > > > > > > >+#define EFI_PCI_CONF_ATOMIC_OP_ENABLE 0x02 //set to
> > > > enable
> > > > > > > > state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+LTR Mechanism
> > > > > > enable/disable.
> > > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > > >+on how to
> > > > > > > > translate
> > > > > > > > >the
> > > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data
> > > > > > > > >member
> > > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > > >+per its PCI specification based on the
> > > > > > > > device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_LTR;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_LTR_AUTO 0x00 //No request for
> > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_LTR_DISABLE 0x01 //set to default
> > > > disable
> > > > > > > > >+state #define EFI_PCI_CONF_LTR_ENABLE 0x02 //set to
> > > enable
> > > > > > state
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+Precision Time Measurement (PTM)
> > > > > > > > >enable/disable.
> > > > > > > > >+/// Refer to PCI Base Specification 4, (chapter 7.5.3.16)
> > > > > > > > >+on how to
> > > > > > > > translate
> > > > > > > > >the
> > > > > > > > >+/// below EFI encodings as per the PCI hardware
> > > > > > > > >+terminology. If this data
> > > > > > > > >member
> > > > > > > > >+/// value is returned as 0 than there is no platform
> > > > > > > > >+policy to override, this /// feature would be enabled as
> > > > > > > > >+per its PCI specification based on the
> > > > > > > > device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_PTM;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_PTM_AUTO 0x00 //No request
> > > for
> > > > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_PTM_DISABLE 0x01 //set to default
> > > > > > disable
> > > > > > > > state
> > > > > > > > >+#define EFI_PCI_CONF_PTM_ENABLE 0x02 //set to enable
> > > > state
> > > > > > > > only
> > > > > > > > >+#define EFI_PCI_CONF_PTM_ROOT_SEL 0x02 //set to root
> > > > select
> > > > > > &
> > > > > > > > enable
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This data type is to retrieve the PCI device platform
> > > > > > > > >+policy for the PCI- /// compliant feature PCIe Device's
> > > > > > > > >+Completion Timeout
> > > > > > > > >+(CTO) set to
> > > > > > > > >supported ranges
> > > > > > > > >+/// or disable. Refer to PCI Base Specification 4,
> > > > > > > > >+(chapter
> > > > > > > > >+7.5.3.16) on how
> > > > > > > > to
> > > > > > > > >+/// translate the below EFI encodings as per the PCI
> > > > > > > > >+hardware
> > > > > > terminology.
> > > > > > > > If
> > > > > > > > >this
> > > > > > > > >+/// data member value is returned as 0 than there is no
> > > > > > > > >+platform policy to
> > > > > > > > >override,
> > > > > > > > >+/// this feature would be enabled as per its PCI
> > > > > > > > >+specification based on the
> > > > > > > > >device
> > > > > > > > >+/// capabilities. Below is its data type and the macro
> > > > > > > > >+definitions which the /// driver uses for interpreting the
> > > > > > > > >+platform
> > > > policy.
> > > > > > > > >+///
> > > > > > > > >+typedef UINT8 EFI_PCI_CONF_CTO_SUPPORT;
> > > > > > > > >+
> > > > > > > > >+#define EFI_PCI_CONF_CTO_AUTO 0x00 //No request
> > > > for
> > > > > > > > override
> > > > > > > > >+#define EFI_PCI_CONF_CTO_DEFAULT 0x01 //set to
> > > default
> > > > > > range
> > > > > > > > of 5us
> > > > > > > > >to 50ms if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A1 0x02 //set to
> > > range
> > > > of
> > > > > > 50us
> > > > > > > > to
> > > > > > > > >100us if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_A2 0x03 //set to
> > > range
> > > > of
> > > > > > 1ms
> > > > > > > > to
> > > > > > > > >10ms if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B1 0x04 //set to
> > > range
> > > > of
> > > > > > > > 16ms to
> > > > > > > > >55ms if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_B2 0x05 //set to
> > > range
> > > > of
> > > > > > > > 65ms to
> > > > > > > > >210ms if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C1 0x06 //set to
> > > range
> > > > of
> > > > > > > > 260ms to
> > > > > > > > >900ms if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_C2 0x07 //set to
> > > range
> > > > of
> > > > > > 1s
> > > > > > > > to 3.5s if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D1 0x08 //set to
> > > range
> > > > of
> > > > > > 4s
> > > > > > > > to 13s if
> > > > > > > > >applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_RANGE_D2 0x09 //set to
> > > range
> > > > of
> > > > > > 17s
> > > > > > > > to 64s
> > > > > > > > >if applicable
> > > > > > > > >+#define EFI_PCI_CONF_CTO_DET_DISABLE 0x10 //set to CTO
> > > > > > detection
> > > > > > > > >disable if applicable
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// Reserves for future use /// typedef UINT8
> > > > > > > > >+EFI_PCI_CONF_RESERVES;
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// The EFI_PCI_PLATYFORM_EXTENDED_POLICY is altogether
> > > > > > 128-byte
> > > > > > > > size,
> > > > > > > > >with each
> > > > > > > > >+/// byte field representing one PCI standerd feature
> > > > > > > > >+defined in the PCI
> > > > > > > > >Express Base
> > > > > > > > >+/// Specification 4.0, version 1.0.
> > > > > > > > >+///
> > > > > > > > >+typedef struct {
> > > > > > > > >+ EFI_PCI_CONF_MAX_PAYLOAD_SIZE DeviceCtlMPS;
> > > > > > > > >+ EFI_PCI_CONF_MAX_READ_REQ_SIZE DeviceCtlMRRS;
> > > > > > > > >+ EFI_PCI_CONF_EXTENDED_TAG DeviceCtlExtTag;
> > > > > > > > >+ EFI_PCI_CONF_RELAX_ORDER DeviceCtlRelaxOrder;
> > > > > > > > >+ EFI_PCI_CONF_NO_SNOOP DeviceCtlNoSnoop;
> > > > > > > > >+ EFI_PCI_CONF_ASPM_SUPPORT LinkCtlASPMState;
> > > > > > > > >+ EFI_PCI_CONF_COMMON_CLOCK_CFG
> > > LinkCtlCommonClkCfg;
> > > > > > > > >+ EFI_PCI_CONF_EXTENDED_SYNCH LinkCtlExtSynch;
> > > > > > > > >+ EFI_PCI_CONF_ATOMIC_OP DeviceCtl2AtomicOp;
> > > > > > > > >+ EFI_PCI_CONF_LTR DeviceCtl2LTR;
> > > > > > > > >+ EFI_PCI_CONF_PTM PTMControl;
> > > > > > > > >+ EFI_PCI_CONF_CTO_SUPPORT CTOsupport;
> > > > > > > > >+ EFI_PCI_CONF_RESERVES Reserves[116];
> > > > > > > > >+} EFI_PCI_PLATFORM_EXTENDED_POLICY;
> > > > > > > > >+
> > > > > > > > >+/**
> > > > > > > > >+ Retrieves the PCI device-specific platform policy
> > > > > > > > >+regarding
> > > > > > > > enumeration.
> > > > > > > > >+
> > > > > > > > >+ The PCI Bus driver and PCI Host Bridge Resource
> > > > > > > > >+ Allocation Protocol
> > > > > > > > drivers
> > > > > > > > >+ can call this member function to retrieve the platform
> > > > > > > > >+ policies specific
> > > > > > > > to
> > > > > > > > >+ PCI device, regarding the PCI enumeration.
> > > > > > > > >+
> > > > > > > > >+ The GetDevicePolicy() function retrieves the platform
> > > > > > > > >+ policy for a
> > > > > > > > particular
> > > > > > > > >+ component regarding PCI enumeration. The PCI bus driver
> > > > > > > > >+ and the PCI
> > > > > > > > Host
> > > > > > > > >Bridge
> > > > > > > > >+ Resource Allocation Protocol driver can call this member
> > > > > > > > >+ function to
> > > > > > > > retrieve
> > > > > > > > >+ the policy.
> > > > > > > > >+ The existing GetPlatformPolicy() member function is used
> > > > > > > > >+ by the PCI Bus
> > > > > > > > >driver
> > > > > > > > >+ to program the legacy ranges, the data that is returned
> > > > > > > > >+ by that member
> > > > > > > > >function
> > > > > > > > >+ determines the supported attributes that are returned by
> > > > > > > > >+ the
> > > > > > > > >+ EFI_PCI_IO_PROTOCOL.Attributes() function.
> > > > > > > > >+ The GetDevicePolicy() member function is meant to return
> > > data
> > > > > > > > >+ about
> > > > > > > > >other PCI
> > > > > > > > >+ compliant features which would be supported by the PCI
> > > > > > > > >+ Bus driver in
> > > > > > > > >future;
> > > > > > > > >+ like for example the MPS, MRRS, Extended Tag, ASPM, etc.
> > > > > > > > >+ The details
> > > > > > > > >about
> > > > > > > > >+ this PCI features can be obtained from the PCI Base
> > > > > > > > >+ Specification
> > > > > > 4.x.
> > > > > > > > The
> > > > > > > > >+ EFI encodings for these feature are defined in the
> > > > > > > > >+ EFI_PCI_PLATFORM_EXTENDED_POLICY, see the Related
> > > > Definition
> > > > > > > > section
> > > > > > > > >for this.
> > > > > > > > >+ This member function will use the associated EFI handle
> > > > > > > > >+ of the PCI IO
> > > > > > > > >Protocol
> > > > > > > > >+ to determine the physical PCI device within the chipset,
> > > > > > > > >+ to return its device-specific platform policies.
> > > > > > > > >+
> > > > > > > > >+ @param[in] This Pointer to the
> > > > > > > > EFI_PCI_PLATFORM_PROTOCOL2
> > > > > > > > >instance.
> > > > > > > > >+ @param[in] PciDevice The associated PCI IO Protocol
> > > > handle
> > > > > > of
> > > > > > > > the PCI
> > > > > > > > >+ device. Type EFI_HANDLE is
> > > > defined
> > > > > > in
> > > > > > > > >+ InstallProtocolInterface() in
> > > the
> > > > > > UEFI
> > > > > > > > 2.1
> > > > > > > > >+ Specification @param[in]
> > > > > > PciExtPolicy
> > > > > > > > >+ The platform policy with respect to other
> > > > > > > > PCI
> > > > > > > > >features
> > > > > > > > >+ like, the MPS, MRRS, etc. Type
> > > > > > > > >EFI_PCI_PLATFORM_EXTENDED_POLICY
> > > > > > > > >+ is defined in "Related
> > > > Definitions"
> > > > > > > > below.
> > > > > > > > >+
> > > > > > > > >+
> > > > > > > > >+ @retval EFI_SUCCESS The function completed
> > > > > > > > successfully, may
> > > > > > > > >returns
> > > > > > > > >+ platform policy data for
> > > > the
> > > > > > given
> > > > > > > > PCI component
> > > > > > > > >+ @retval EFI_UNSUPPORTED PCI component belongs
> > > to
> > > > PCI
> > > > > > > > topology but
> > > > > > > > >not
> > > > > > > > >+ part of chipset to
> > > provide
> > > > the
> > > > > > > > platform policy
> > > > > > > > >+ @retval EFI_INVALID_PARAMETER If any of the input
> > > > parameters
> > > > > > are
> > > > > > > > >passed with
> > > > > > > > >+ invalid data
> > > > > > > > >+
> > > > > > > > >+ **/
> > > > > > > > >+typedef
> > > > > > > > >+EFI_STATUS
> > > > > > > > >+(EFIAPI * EFI_PCI_PLATFORM_GET_DEVICE_POLICY) (
> > > > > > > > >+ IN CONST EFI_PCI_PLATFORM_PROTOCOL2 *This,
> > > > > > > > >+ IN EFI_HANDLE PciDevice,
> > > > > > > > >+ OUT EFI_PCI_PLATFORM_EXTENDED_POLICY *PciExtPolicy );
> > > > > > > > >+
> > > > > > > > >+///
> > > > > > > > >+/// This protocol provides the interface between the PCI
> > > > > > > > >+bus driver/PCI
> > > > > > > > Host
> > > > > > > > >+/// Bridge Resource Allocation driver and a
> > > > > > > > >+platform-specific driver to
> > > > > > > > >describe
> > > > > > > > >+/// the unique features of a platform.
> > > > > > > > >+///
> > > > > > > > >+struct _EFI_PCI_PLATFORM_PROTOCOL2 {
> > > > > > > > >+ ///
> > > > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > > > >+platform that it
> > > > > > > > is
> > > > > > > > >about to
> > > > > > > > >+ /// enter a certain phase during the enumeration process.
> > > > > > > > >+ ///
> > > > > > > > >+ EFI_PCI_PLATFORM_PHASE_NOTIFY
> > > PlatformNotify;
> > > > > > > > >+ ///
> > > > > > > > >+ /// The notification from the PCI bus enumerator to the
> > > > > > > > >+ platform for
> > > > > > > > each
> > > > > > > > >PCI
> > > > > > > > >+ /// controller at several predefined points during PCI
> > > > > > > > >+ controller
> > > > > > > > initialization.
> > > > > > > > >+ ///
> > > > > > > > >+ EFI_PCI_PLATFORM_PREPROCESS_CONTROLLER
> > > > > > > > PlatformPrepController;
> > > > > > > > >+ ///
> > > > > > > > >+ /// Retrieves the platform policy regarding enumeration.
> > > > > > > > >+ ///
> > > > > > > > >+ EFI_PCI_PLATFORM_GET_PLATFORM_POLICY
> > > > > > GetPlatformPolicy;
> > > > > > > > >+ ///
> > > > > > > > >+ /// Gets the PCI device's option ROM from a
> > > > > > > > >+ platform-specific
> > > > > > location.
> > > > > > > > >+ ///
> > > > > > > > >+ EFI_PCI_PLATFORM_GET_PCI_ROM GetPciRom;
> > > > > > > > >+ ///
> > > > > > > > >+ /// Retrieves the PCI device-specific platform policy
> > > > > > > > >+ regarding
> > > > > > > > enumeration.
> > > > > > > > >+ ///
> > > > > > > > >+ EFI_PCI_PLATFORM_GET_DEVICE_POLICY
> > > > GetDevicePolicy;
> > > > > > > > >+ ///
> > > > > > > > >+ /// The major version of this PCI Platform Protocol ///
> > > > > > > > >+ UINT8 MajorVersion;
> > > > > > > > >+ ///
> > > > > > > > >+ /// The minor version of this PCI Platform Protocol ///
> > > > > > > > >+ UINT8 MinorVersion;
> > > > > > > > >+
> > > > > > > > >+};
> > > > > > > > >+
> > > > > > > > >+extern EFI_GUID gEfiPciPlatformProtocol2Guid;
> > > > > > > > >+
> > > > > > > > >+#endif
> > > > > > > > >diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index
> > > > > > > > >b382efd578..670b448031 100644
> > > > > > > > >--- a/MdePkg/MdePkg.dec
> > > > > > > > >+++ b/MdePkg/MdePkg.dec
> > > > > > > > >@@ -1013,6 +1013,12 @@
> > > > > > > > > ## Include/Protocol/PciOverride.h
> > > > > > > > > gEfiPciOverrideProtocolGuid = { 0xb5b35764, 0x460c,
> > > > 0x4a06,
> > > > > > > > {0x99, 0xfc,
> > > > > > > > >0x77, 0xa1, 0x7c, 0x1b, 0x5c, 0xeb }}
> > > > > > > > >
> > > > > > > > >+ ## Include/Protocol/PciPlatform2.h
> > > > > > > > >+ gEfiPciPlatformProtocol2Guid = { 0x787b0367, 0xa945,
> > > > 0x4d60,
> > > > > > > > { 0x8d, 0x34,
> > > > > > > > >0xb9, 0xd1, 0x88, 0xd2, 0xd0, 0xb6 }}
> > > > > > > > >+
> > > > > > > > >+ ## Include/Protocol/PciOverride2.h
> > > > > > > > >+ gEfiPciOverrideProtocol2Guid = { 0xb9d5ea1, 0x66cb,
> > > > 0x4546,
> > > > > > > > { 0xb0, 0xbb,
> > > > > > > > >0x5c, 0x6d, 0xae, 0xd9, 0x42, 0x47 }}
> > > > > > > > >+
> > > > > > > > > ## Include/Protocol/PciEnumerationComplete.h
> > > > > > > > > gEfiPciEnumerationCompleteProtocolGuid = { 0x30cfe3e7,
> > > > > > 0x3de1,
> > > > > > > > 0x4586,
> > > > > > > > >{0xbe, 0x20, 0xde, 0xab, 0xa1, 0xb3, 0xb7, 0x93}}
> > > > > > > > >
> > > > > > > > >--
> > > > > > > > >2.21.0.windows.1
> > > > > > > >
> > > > > > > >
> > > > > > > >
> > >
> > >
> > >
^ permalink raw reply [flat|nested] 13+ messages in thread
end of thread, other threads:[~2019-07-30 3:26 UTC | newest]
Thread overview: 13+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-07-29 6:51 [edk2-staging/UEFI_PCI_ENHANCE-2 PATCH V2] MdePkg/Protocols: New interface, EFI encodings to PCI Plat protocol Javeed, Ashraf
2019-07-29 7:52 ` Liming Gao
2019-07-29 8:05 ` [edk2-devel] " Yao, Jiewen
2019-07-29 8:12 ` Javeed, Ashraf
2019-07-29 8:56 ` Yao, Jiewen
2019-07-29 11:17 ` Javeed, Ashraf
2019-07-29 12:18 ` Yao, Jiewen
2019-07-29 14:27 ` Javeed, Ashraf
[not found] ` <15B5DFFD7DF9B8EB.10519@groups.io>
2019-07-29 12:25 ` Yao, Jiewen
2019-07-29 14:39 ` Javeed, Ashraf
2019-07-30 3:26 ` Liming Gao
-- strict thread matches above, loose matches on Subject: below --
2019-07-25 16:46 Javeed, Ashraf
2019-07-25 14:45 Javeed, Ashraf
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox