From: "Liming Gao" <liming.gao@intel.com>
To: "devel@edk2.groups.io" <devel@edk2.groups.io>,
"leif@nuviainc.com" <leif@nuviainc.com>,
"Javeed, Ashraf" <ashraf.javeed@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>,
"Gao, Liming" <liming.gao@intel.com>
Subject: Re: [edk2-devel] [PATCH V4 1/2] MdePkg/Include/IndustryStandard: CXL 1.1 Registers
Date: Mon, 27 Jul 2020 14:55:03 +0000 [thread overview]
Message-ID: <MWHPR11MB1630F090E441E8C38B53DCFA80720@MWHPR11MB1630.namprd11.prod.outlook.com> (raw)
In-Reply-To: <20200727142442.GA1337@vanye>
Lefi:
Thanks for your comments.
> -----Original Message-----
> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Leif Lindholm
> Sent: Monday, July 27, 2020 10:25 PM
> To: devel@edk2.groups.io; Javeed, Ashraf <ashraf.javeed@intel.com>
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Gao, Liming <liming.gao@intel.com>
> Subject: Re: [edk2-devel] [PATCH V4 1/2] MdePkg/Include/IndustryStandard: CXL 1.1 Registers
>
> Hi Ashraf, but also Mike, Liming.
>
> I just saw this patch go in and have some comments.
>
> On Fri, Jul 24, 2020 at 23:56:12 +0530, Javeed, Ashraf wrote:
> > BZ: https://bugzilla.tianocore.org/show_bug.cgi?id=2611
> >
> > Register definitions from chapter 7 of Compute Express Link
> > Specification Revision 1.1 are ported into the new Cxl11.h.
> > The CXL Flex Bus registers are based on the PCIe Extended Capability
> > DVSEC structure header, led to the inclusion of upgraded Pci.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>
> > --
> >
> > V4: fix code style
> >
> > V3: Copyright date fix
> >
> > V2: Indentation and double declaration fix, copyright date update
> > ---
> > MdePkg/Include/IndustryStandard/Cxl11.h | 569
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> +++++++++
> > MdePkg/Include/IndustryStandard/Pci.h | 6 ++----
> > 2 files changed, 571 insertions(+), 4 deletions(-)
> >
> > diff --git a/MdePkg/Include/IndustryStandard/Cxl11.h b/MdePkg/Include/IndustryStandard/Cxl11.h
> > new file mode 100644
> > index 0000000000..933c1ab817
> > --- /dev/null
> > +++ b/MdePkg/Include/IndustryStandard/Cxl11.h
> > @@ -0,0 +1,569 @@
> > +/** @file
> > + CXL 1.1 Register definitions
> > +
> > + This file contains the register definitions based on the Compute Express Link
> > + (CXL) Specification Revision 1.1.
> > +
> > +Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> > +SPDX-License-Identifier: BSD-2-Clause-Patent
> > +
> > +**/
> > +
> > +#ifndef _CXL11_H_
> > +#define _CXL11_H_
>
> We should not be adding macros with a leading _ - these are intended
> for toolchain use.
This style is align to other header file. This is the file header macro to make sure the header file be included more than once.
>
> > +
> > +#include <IndustryStandard/Pci.h>
> > +//
> > +// DVSEC Vendor ID
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.1.1 - Table 58
> > +// (subject to change as per CXL assigned Vendor ID)
> > +//
> > +#define INTEL_CXL_DVSEC_VENDOR_ID 0x8086
>
> This is Cxl11.h - surely this should be CXL_DVSEC_VENDOR_ID_INTEL?
Ashraf: is it defined in spec?
>
> > +
> > +//
> > +// CXL Flex Bus Device default device and function number
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.1.1
> > +//
> > +#define CXL_DEV_DEV 0
> > +#define CXL_DEV_FUNC 0
> > +
> > +//
> > +// Ensure proper structure formats
> > +//
> > +#pragma pack(1)
>
> And this pragma has no function whatsoever with regards to any of the
> register definition structs below. It would be much better if the
> structs requiring packing (_DEVICE, _PORT, ...) were grouped together
> and only those were given this treatment.
>
> #pragma pack(1) is *not* a safe default.
>
I know pack(1) is for the compact structure layout.
> > +
> > +///
> > +/// The PCIe DVSEC for Flex Bus Device
> > +///@{
> > +typedef union {
> > + struct {
> > + UINT16 CacheCapable : 1; // bit 0
> > + UINT16 IoCapable : 1; // bit 1
> > + UINT16 MemCapable : 1; // bit 2
> > + UINT16 MemHwInitMode : 1; // bit 3
> > + UINT16 HdmCount : 2; // bit 4..5
> > + UINT16 Reserved1 : 8; // bit 6..13
> > + UINT16 ViralCapable : 1; // bit 14
> > + UINT16 Reserved2 : 1; // bit 15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_CAPABILITY;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 CacheEnable : 1; // bit 0
> > + UINT16 IoEnable : 1; // bit 1
> > + UINT16 MemEnable : 1; // bit 2
> > + UINT16 CacheSfCoverage : 5; // bit 3..7
> > + UINT16 CacheSfGranularity : 3; // bit 8..10
> > + UINT16 CacheCleanEviction : 1; // bit 11
> > + UINT16 Reserved1 : 2; // bit 12..13
> > + UINT16 ViralEnable : 1; // bit 14
> > + UINT16 Reserved2 : 1; // bit 15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_CONTROL;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 Reserved1 : 14; // bit 0..13
> > + UINT16 ViralStatus : 1; // bit 14
> > + UINT16 Reserved2 : 1; // bit 15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 Reserved1 : 1; // bit 0
> > + UINT16 Reserved2 : 1; // bit 1
> > + UINT16 Reserved3 : 1; // bit 2
> > + UINT16 Reserved4 : 13; // bit 3..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_1_1_DVSEC_FLEX_BUS_DEVICE_CONTROL2;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 Reserved1 : 1; // bit 0
> > + UINT16 Reserved2 : 1; // bit 1
> > + UINT16 Reserved3 : 14; // bit 2..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_1_1_DVSEC_FLEX_BUS_DEVICE_STATUS2;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 ConfigLock : 1; // bit 0
> > + UINT16 Reserved1 : 15; // bit 1..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_LOCK;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemorySizeHigh : 32; // bit 0..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_SIZE_HIGH;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemoryInfoValid : 1; // bit 0
> > + UINT32 MemoryActive : 1; // bit 1
> > + UINT32 MediaType : 3; // bit 2..4
> > + UINT32 MemoryClass : 3; // bit 5..7
> > + UINT32 DesiredInterleave : 3; // bit 8..10
> > + UINT32 Reserved : 17; // bit 11..27
> > + UINT32 MemorySizeLow : 4; // bit 28..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_SIZE_LOW;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemoryBaseHigh : 32; // bit 0..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_BASE_HIGH;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 Reserved : 28; // bit 0..27
> > + UINT32 MemoryBaseLow : 4; // bit 28..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_BASE_LOW;
> > +
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemorySizeHigh : 32; // bit 0..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_SIZE_HIGH;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemoryInfoValid : 1; // bit 0
> > + UINT32 MemoryActive : 1; // bit 1
> > + UINT32 MediaType : 3; // bit 2..4
> > + UINT32 MemoryClass : 3; // bit 5..7
> > + UINT32 DesiredInterleave : 3; // bit 8..10
> > + UINT32 Reserved : 17; // bit 11..27
> > + UINT32 MemorySizeLow : 4; // bit 28..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_SIZE_LOW;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MemoryBaseHigh : 32; // bit 0..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_BASE_HIGH;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 Reserved : 28; // bit 0..27
> > + UINT32 MemoryBaseLow : 4; // bit 28..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_BASE_LOW;
> > +
> > +//
> > +// Flex Bus Device DVSEC ID
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.1.1, Table 58
> > +//
> > +#define FLEX_BUS_DEVICE_DVSEC_ID 0
> > +
> > +//
> > +// PCIe DVSEC for Flex Bus Device
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.1.1, Figure 95
> > +//
> > +typedef struct {
> > + PCI_EXPRESS_EXTENDED_CAPABILITIES_HEADER Header; // offset 0
> > + PCI_EXPRESS_DESIGNATED_VENDOR_SPECIFIC_HEADER_1 DesignatedVendorSpecificHeader1; // offset 4
> > + PCI_EXPRESS_DESIGNATED_VENDOR_SPECIFIC_HEADER_2 DesignatedVendorSpecificHeader2; // offset 8
> > + CXL_DVSEC_FLEX_BUS_DEVICE_CAPABILITY DeviceCapability; // offset 10
> > + CXL_DVSEC_FLEX_BUS_DEVICE_CONTROL DeviceControl; // offset 12
> > + CXL_DVSEC_FLEX_BUS_DEVICE_STATUS DeviceStatus; // offset 14
> > + CXL_1_1_DVSEC_FLEX_BUS_DEVICE_CONTROL2 DeviceControl2; // offset 16
> > + CXL_1_1_DVSEC_FLEX_BUS_DEVICE_STATUS2 DeviceStatus2; // offset 18
> > + CXL_DVSEC_FLEX_BUS_DEVICE_LOCK DeviceLock; // offset 20
> > + UINT16 Reserved; // offset 22
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_SIZE_HIGH DeviceRange1SizeHigh; // offset 24
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_SIZE_LOW DeviceRange1SizeLow; // offset 28
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_BASE_HIGH DeviceRange1BaseHigh; // offset 32
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE1_BASE_LOW DeviceRange1BaseLow; // offset 36
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_SIZE_HIGH DeviceRange2SizeHigh; // offset 40
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_SIZE_LOW DeviceRange2SizeLow; // offset 44
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_BASE_HIGH DeviceRange2BaseHigh; // offset 48
> > + CXL_DVSEC_FLEX_BUS_DEVICE_RANGE2_BASE_LOW DeviceRange2BaseLow; // offset 52
> > +} CXL_1_1_DVSEC_FLEX_BUS_DEVICE;
> > +///@}
> > +
> > +///
> > +/// PCIe DVSEC for FLex Bus Port
> > +///@{
> > +typedef union {
> > + struct {
> > + UINT16 CacheCapable : 1; // bit 0
> > + UINT16 IoCapable : 1; // bit 1
> > + UINT16 MemCapable : 1; // bit 2
> > + UINT16 Reserved : 13; // bit 3..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_1_1_DVSEC_FLEX_BUS_PORT_CAPABILITY;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 CacheEnable : 1; // bit 0
> > + UINT16 IoEnable : 1; // bit 1
> > + UINT16 MemEnable : 1; // bit 2
> > + UINT16 CxlSyncBypassEnable : 1; // bit 3
> > + UINT16 DriftBufferEnable : 1; // bit 4
> > + UINT16 Reserved : 3; // bit 5..7
> > + UINT16 Retimer1Present : 1; // bit 8
> > + UINT16 Retimer2Present : 1; // bit 9
> > + UINT16 Reserved2 : 6; // bit 10..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_1_1_DVSEC_FLEX_BUS_PORT_CONTROL;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 CacheEnable : 1; // bit 0
> > + UINT16 IoEnable : 1; // bit 1
> > + UINT16 MemEnable : 1; // bit 2
> > + UINT16 CxlSyncBypassEnable : 1; // bit 3
> > + UINT16 DriftBufferEnable : 1; // bit 4
> > + UINT16 Reserved : 3; // bit 5..7
> > + UINT16 CxlCorrectableProtocolIdFramingError : 1; // bit 8
> > + UINT16 CxlUncorrectableProtocolIdFramingError : 1; // bit 9
> > + UINT16 CxlUnexpectedProtocolIdDropped : 1; // bit 10
> > + UINT16 Reserved2 : 5; // bit 11..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_1_1_DVSEC_FLEX_BUS_PORT_STATUS;
> > +
> > +//
> > +// Flex Bus Port DVSEC ID
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.2.1.3, Table 62
> > +//
> > +#define FLEX_BUS_PORT_DVSEC_ID 7
> > +
> > +//
> > +// PCIe DVSEC for Flex Bus Port
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.2.1.3, Figure 99
> > +//
> > +typedef struct {
> > + PCI_EXPRESS_EXTENDED_CAPABILITIES_HEADER Header; // offset 0
> > + PCI_EXPRESS_DESIGNATED_VENDOR_SPECIFIC_HEADER_1 DesignatedVendorSpecificHeader1; // offset 4
> > + PCI_EXPRESS_DESIGNATED_VENDOR_SPECIFIC_HEADER_2 DesignatedVendorSpecificHeader2; // offset 8
> > + CXL_1_1_DVSEC_FLEX_BUS_PORT_CAPABILITY PortCapability; // offset 10
> > + CXL_1_1_DVSEC_FLEX_BUS_PORT_CONTROL PortControl; // offset 12
> > + CXL_1_1_DVSEC_FLEX_BUS_PORT_STATUS PortStatus; // offset 14
> > +} CXL_1_1_DVSEC_FLEX_BUS_PORT;
> > +///@}
> > +
> > +///
> > +/// CXL 1.1 Upstream and Downstream Port Subsystem Component registers
> > +///
> > +
> > +/// The CXL.Cache and CXL.Memory Architectural register definitions
> > +/// Based on chapter 7.2.2 of Compute Express Link Specification Revision: 1.1
> > +///@{
> > +
> > +#define CXL_CAPABILITY_HEADER_OFFSET 0
> > +typedef union {
> > + struct {
> > + UINT32 CxlCapabilityId : 16; // bit 0..15
> > + UINT32 CxlCapabilityVersion : 4; // bit 16..19
> > + UINT32 CxlCacheMemVersion : 4; // bit 20..23
> > + UINT32 ArraySize : 8; // bit 24..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_CAPABILITY_HEADER;
> > +
> > +#define CXL_RAS_CAPABILITY_HEADER_OFFSET 4
> > +typedef union {
> > + struct {
> > + UINT32 CxlCapabilityId : 16; // bit 0..15
> > + UINT32 CxlCapabilityVersion : 4; // bit 16..19
> > + UINT32 CxlRasCapabilityPointer : 12; // bit 20..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_RAS_CAPABILITY_HEADER;
> > +
> > +#define CXL_SECURITY_CAPABILITY_HEADER_OFFSET 8
> > +typedef union {
> > + struct {
> > + UINT32 CxlCapabilityId : 16; // bit 0..15
> > + UINT32 CxlCapabilityVersion : 4; // bit 16..19
> > + UINT32 CxlSecurityCapabilityPointer : 12; // bit 20..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_SECURITY_CAPABILITY_HEADER;
> > +
> > +#define CXL_LINK_CAPABILITY_HEADER_OFFSET 0xC
> > +typedef union {
> > + struct {
> > + UINT32 CxlCapabilityId : 16; // bit 0..15
> > + UINT32 CxlCapabilityVersion : 4; // bit 16..19
> > + UINT32 CxlLinkCapabilityPointer : 12; // bit 20..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_LINK_CAPABILITY_HEADER;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 CacheDataParity : 1; // bit 0..0
> > + UINT32 CacheAddressParity : 1; // bit 1..1
> > + UINT32 CacheByteEnableParity : 1; // bit 2..2
> > + UINT32 CacheDataEcc : 1; // bit 3..3
> > + UINT32 MemDataParity : 1; // bit 4..4
> > + UINT32 MemAddressParity : 1; // bit 5..5
> > + UINT32 MemByteEnableParity : 1; // bit 6..6
> > + UINT32 MemDataEcc : 1; // bit 7..7
> > + UINT32 ReInitThreshold : 1; // bit 8..8
> > + UINT32 RsvdEncodingViolation : 1; // bit 9..9
> > + UINT32 PoisonReceived : 1; // bit 10..10
> > + UINT32 ReceiverOverflow : 1; // bit 11..11
> > + UINT32 Reserved : 20; // bit 12..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_1_1_UNCORRECTABLE_ERROR_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 CacheDataParityMask : 1; // bit 0..0
> > + UINT32 CacheAddressParityMask : 1; // bit 1..1
> > + UINT32 CacheByteEnableParityMask : 1; // bit 2..2
> > + UINT32 CacheDataEccMask : 1; // bit 3..3
> > + UINT32 MemDataParityMask : 1; // bit 4..4
> > + UINT32 MemAddressParityMask : 1; // bit 5..5
> > + UINT32 MemByteEnableParityMask : 1; // bit 6..6
> > + UINT32 MemDataEccMask : 1; // bit 7..7
> > + UINT32 ReInitThresholdMask : 1; // bit 8..8
> > + UINT32 RsvdEncodingViolationMask : 1; // bit 9..9
> > + UINT32 PoisonReceivedMask : 1; // bit 10..10
> > + UINT32 ReceiverOverflowMask : 1; // bit 11..11
> > + UINT32 Reserved : 20; // bit 12..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_1_1_UNCORRECTABLE_ERROR_MASK;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 CacheDataParitySeverity : 1; // bit 0..0
> > + UINT32 CacheAddressParitySeverity : 1; // bit 1..1
> > + UINT32 CacheByteEnableParitySeverity : 1; // bit 2..2
> > + UINT32 CacheDataEccSeverity : 1; // bit 3..3
> > + UINT32 MemDataParitySeverity : 1; // bit 4..4
> > + UINT32 MemAddressParitySeverity : 1; // bit 5..5
> > + UINT32 MemByteEnableParitySeverity : 1; // bit 6..6
> > + UINT32 MemDataEccSeverity : 1; // bit 7..7
> > + UINT32 ReInitThresholdSeverity : 1; // bit 8..8
> > + UINT32 RsvdEncodingViolationSeverity : 1; // bit 9..9
> > + UINT32 PoisonReceivedSeverity : 1; // bit 10..10
> > + UINT32 ReceiverOverflowSeverity : 1; // bit 11..11
> > + UINT32 Reserved : 20; // bit 12..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_1_1_UNCORRECTABLE_ERROR_SEVERITY;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 CacheDataEcc : 1; // bit 0..0
> > + UINT32 MemoryDataEcc : 1; // bit 1..1
> > + UINT32 CrcThreshold : 1; // bit 2..2
> > + UINT32 RetryThreshold : 1; // bit 3..3
> > + UINT32 CachePoisonReceived : 1; // bit 4..4
> > + UINT32 MemoryPoisonReceived : 1; // bit 5..5
> > + UINT32 PhysicalLayerError : 1; // bit 6..6
> > + UINT32 Reserved : 25; // bit 7..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_CORRECTABLE_ERROR_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 CacheDataEccMask : 1; // bit 0..0
> > + UINT32 MemoryDataEccMask : 1; // bit 1..1
> > + UINT32 CrcThresholdMask : 1; // bit 2..2
> > + UINT32 RetryThresholdMask : 1; // bit 3..3
> > + UINT32 CachePoisonReceivedMask : 1; // bit 4..4
> > + UINT32 MemoryPoisonReceivedMask : 1; // bit 5..5
> > + UINT32 PhysicalLayerErrorMask : 1; // bit 6..6
> > + UINT32 Reserved : 25; // bit 7..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_CORRECTABLE_ERROR_MASK;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 FirstErrorPointer : 4; // bit 0..3
> > + UINT32 Reserved1 : 5; // bit 4..8
> > + UINT32 MultipleHeaderRecordingCapability : 1; // bit 9..9
> > + UINT32 Reserved2 : 3; // bit 10..12
> > + UINT32 PoisonEnabled : 1; // bit 13..13
> > + UINT32 Reserved3 : 18; // bit 14..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_ERROR_CAPABILITIES_AND_CONTROL;
> > +
> > +typedef struct {
> > + CXL_1_1_UNCORRECTABLE_ERROR_STATUS UncorrectableErrorStatus;
> > + CXL_1_1_UNCORRECTABLE_ERROR_MASK UncorrectableErrorMask;
> > + CXL_1_1_UNCORRECTABLE_ERROR_SEVERITY UncorrectableErrorSeverity;
> > + CXL_CORRECTABLE_ERROR_STATUS CorrectableErrorStatus;
> > + CXL_CORRECTABLE_ERROR_MASK CorrectableErrorMask;
> > + CXL_ERROR_CAPABILITIES_AND_CONTROL ErrorCapabilitiesAndControl;
> > + UINT32 HeaderLog[16];
> > +} CXL_1_1_RAS_CAPABILITY_STRUCTURE;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 DeviceTrustLevel : 2; // bit 0..1
> > + UINT32 Reserved : 30; // bit 2..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_1_1_SECURITY_POLICY;
> > +
> > +typedef struct {
> > + CXL_1_1_SECURITY_POLICY SecurityPolicy;
> > +} CXL_1_1_SECURITY_CAPABILITY_STRUCTURE;
> > +
> > +typedef union {
> > + struct {
> > + UINT64 CxlLinkVersionSupported : 4; // bit 0..3
> > + UINT64 CxlLinkVersionReceived : 4; // bit 4..7
> > + UINT64 LlrWrapValueSupported : 8; // bit 8..15
> > + UINT64 LlrWrapValueReceived : 8; // bit 16..23
> > + UINT64 NumRetryReceived : 5; // bit 24..28
> > + UINT64 NumPhyReinitReceived : 5; // bit 29..33
> > + UINT64 WrPtrReceived : 8; // bit 34..41
> > + UINT64 EchoEseqReceived : 8; // bit 42..49
> > + UINT64 NumFreeBufReceived : 8; // bit 50..57
> > + UINT64 Reserved : 6; // bit 58..63
> > + } Bits;
> > + UINT64 Uint64;
> > +} CXL_LINK_LAYER_CAPABILITY;
> > +
> > +typedef union {
> > + struct {
> > + UINT16 LlReset : 1; // bit 0..0
> > + UINT16 LlInitStall : 1; // bit 1..1
> > + UINT16 LlCrdStall : 1; // bit 2..2
> > + UINT16 InitState : 2; // bit 3..4
> > + UINT16 LlRetryBufferConsumed : 8; // bit 5..12
> > + UINT16 Reserved : 3; // bit 13..15
> > + } Bits;
> > + UINT16 Uint16;
> > +} CXL_LINK_LAYER_CONTROL_AND_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT64 CacheReqCredits : 10; // bit 0..9
> > + UINT64 CacheRspCredits : 10; // bit 10..19
> > + UINT64 CacheDataCredits : 10; // bit 20..29
> > + UINT64 MemReqRspCredits : 10; // bit 30..39
> > + UINT64 MemDataCredits : 10; // bit 40..49
> > + } Bits;
> > + UINT64 Uint64;
> > +} CXL_LINK_LAYER_RX_CREDIT_CONTROL;
> > +
> > +typedef union {
> > + struct {
> > + UINT64 CacheReqCredits : 10; // bit 0..9
> > + UINT64 CacheRspCredits : 10; // bit 10..19
> > + UINT64 CacheDataCredits : 10; // bit 20..29
> > + UINT64 MemReqRspCredits : 10; // bit 30..39
> > + UINT64 MemDataCredits : 10; // bit 40..49
> > + } Bits;
> > + UINT64 Uint64;
> > +} CXL_LINK_LAYER_RX_CREDIT_RETURN_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT64 CacheReqCredits : 10; // bit 0..9
> > + UINT64 CacheRspCredits : 10; // bit 10..19
> > + UINT64 CacheDataCredits : 10; // bit 20..29
> > + UINT64 MemReqRspCredits : 10; // bit 30..39
> > + UINT64 MemDataCredits : 10; // bit 40..49
> > + } Bits;
> > + UINT64 Uint64;
> > +} CXL_LINK_LAYER_TX_CREDIT_STATUS;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 AckForceThreshold : 8; // bit 0..7
> > + UINT32 AckFLushRetimer : 10; // bit 8..17
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_LINK_LAYER_ACK_TIMER_CONTROL;
> > +
> > +typedef union {
> > + struct {
> > + UINT32 MdhDisable : 1; // bit 0..0
> > + UINT32 Reserved : 31; // bit 1..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_LINK_LAYER_DEFEATURE;
> > +
> > +typedef struct {
> > + CXL_LINK_LAYER_CAPABILITY LinkLayerCapability;
> > + CXL_LINK_LAYER_CONTROL_AND_STATUS LinkLayerControlStatus;
> > + CXL_LINK_LAYER_RX_CREDIT_CONTROL LinkLayerRxCreditControl;
> > + CXL_LINK_LAYER_RX_CREDIT_RETURN_STATUS LinkLayerRxCreditReturnStatus;
> > + CXL_LINK_LAYER_TX_CREDIT_STATUS LinkLayerTxCreditStatus;
> > + CXL_LINK_LAYER_ACK_TIMER_CONTROL LinkLayerAckTimerControl;
> > + CXL_LINK_LAYER_DEFEATURE LinkLayerDefeature;
> > +} CXL_1_1_LINK_CAPABILITY_STRUCTURE;
> > +
> > +#define CXL_IO_ARBITRATION_CONTROL_OFFSET 0x180
> > +typedef union {
> > + struct {
> > + UINT32 Reserved1 : 4; // bit 0..3
> > + UINT32 WeightedRoundRobinArbitrationWeight : 4; // bit 4..7
> > + UINT32 Reserved2 : 24; // bit 8..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_IO_ARBITRATION_CONTROL;
> > +
> > +#define CXL_CACHE_MEMORY_ARBITRATION_CONTROL_OFFSET 0x1C0
> > +typedef union {
> > + struct {
> > + UINT32 Reserved1 : 4; // bit 0..3
> > + UINT32 WeightedRoundRobinArbitrationWeight : 4; // bit 4..7
> > + UINT32 Reserved2 : 24; // bit 8..31
> > + } Bits;
> > + UINT32 Uint32;
> > +} CXL_CACHE_MEMORY_ARBITRATION_CONTROL;
> > +///@}
> > +
> > +/// The CXL.RCRB base register definition
> > +/// Based on chapter 7.3 of Compute Express Link Specification Revision: 1.1
> > +///@{
> > +typedef union {
> > + struct {
> > + UINT64 RcrbEnable : 1; // bit 0..0
> > + UINT64 Reserved : 12; // bit 1..12
> > + UINT64 RcrbBaseAddress : 51; // bit 13..63
> > + } Bits;
> > + UINT64 Uint64;
> > +} CXL_RCRB_BASE;
> > +///@}
> > +
> > +#pragma pack()
> > +
> > +//
> > +// CXL Downstream / Upstream Port RCRB space register offsets
> > +// Compute Express Link Specification Revision: 1.1 - Chapter 7.2.1.1 - Figure 97
> > +//
> > +#define CXL_PORT_RCRB_MEMBAR0_LOW_OFFSET 0x010
> > +#define CXL_PORT_RCRB_MEMBAR0_HIGH_OFFSET 0x014
> > +#define CXL_PORT_RCRB_EXTENDED_CAPABILITY_BASE_OFFSET 0x100
> > +
> > +#endif
> > diff --git a/MdePkg/Include/IndustryStandard/Pci.h b/MdePkg/Include/IndustryStandard/Pci.h
> > index 8ed96b992a..42c00ac762 100644
> > --- a/MdePkg/Include/IndustryStandard/Pci.h
> > +++ b/MdePkg/Include/IndustryStandard/Pci.h
>
> But here is the thing that really disappoints me getting through
> review - this change is completely, fundamentally unrelated to the
> rest of this patch, and not even mentioned in the commit message. This
> should have been a separate patch preceding this one.
>
> > @@ -1,7 +1,7 @@
> > /** @file
> > Support for the latest PCI standard.
> >
> > -Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
> > +Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > **/
> > @@ -9,9 +9,7 @@ SPDX-License-Identifier: BSD-2-Clause-Patent
> > #ifndef _PCI_H_
> > #define _PCI_H_
> >
> > -#include <IndustryStandard/Pci30.h>
> > -#include <IndustryStandard/PciExpress21.h>
> > -#include <IndustryStandard/PciExpress30.h>
> > +#include <IndustryStandard/PciExpress50.h>
> > #include <IndustryStandard/PciCodeId.h>
> >
> > #endif
>
> Now, one final comment - and this is more of a project feature
> suggestion:
> Industry standard headers is something fairly special, even in
> comparison with the rest of MdePkg. *I* would certainly like to ensure
> I don't miss changes or additions to them.
> Could we set up a dedicated group of reviewers for this folder only?
> This need not affect the actual maintainership of MdePkg, just ensure
> more eyeballs (or screen readers, braille terminals, ...) hit updates
> here?
>
> i.e. something like the below to Maintainers.txt:
>
> F: MdePkg/Include/IndustryStandard/
> R: Leif ...
> R: ...
> R: ...
>
This is a good suggestion. IndustryStandard needs more feedback.
Can you send the patch to update Maintainers.txt?
Thanks
Liming
> /
> Leif
>
> > --
> > 2.21.0.windows.1
> >
> >
> >
> >
>
>
next prev parent reply other threads:[~2020-07-27 14:55 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-24 18:26 [PATCH V4 0/2] CXL Specification Registers Javeed, Ashraf
2020-07-24 18:26 ` [PATCH V4 1/2] MdePkg/Include/IndustryStandard: CXL 1.1 Registers Javeed, Ashraf
2020-07-27 14:24 ` [edk2-devel] [PATCH V4 1/2] MdePkg/Include/IndustryStandard: " Leif Lindholm
2020-07-27 14:55 ` Liming Gao [this message]
2020-07-27 16:14 ` Leif Lindholm
2020-07-28 2:07 ` Liming Gao
2020-07-28 2:22 ` Michael D Kinney
2020-07-28 2:36 ` Ni, Ray
2020-07-28 6:18 ` Javeed, Ashraf
2020-07-28 6:46 ` Javeed, Ashraf
2020-07-24 18:26 ` [PATCH V4 2/2] MdePkg/Include/IndustryStandard: Main CXL header Javeed, Ashraf
2020-07-27 2:35 ` [PATCH V4 0/2] CXL Specification Registers Liming Gao
2020-07-27 3:43 ` Liming Gao
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=MWHPR11MB1630F090E441E8C38B53DCFA80720@MWHPR11MB1630.namprd11.prod.outlook.com \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox