[edk2-devel] [Patch V3 2/9] MdeModulePkg: Add new structure for the PCI Root Bridge Info Hob
Wu, Hao A
hao.a.wu at intel.com
Tue Jun 8 05:20:54 UTC 2021
> -----Original Message-----
> From: Liu, Zhiguang <zhiguang.liu at intel.com>
> Sent: Friday, June 4, 2021 5:42 PM
> To: devel at edk2.groups.io
> Cc: Kinney, Michael D <michael.d.kinney at intel.com>; Liming Gao
> <gaoliming at byosoft.com.cn>; Wang, Jian J <jian.j.wang at intel.com>; Wu, Hao
> A <hao.a.wu at intel.com>
> Subject: [Patch V3 2/9] MdeModulePkg: Add new structure for the PCI Root
> Bridge Info Hob
>
> Cc: Michael D Kinney <michael.d.kinney at intel.com>
> Cc: Liming Gao <gaoliming at byosoft.com.cn>
> Cc: Jian J Wang <jian.j.wang at intel.com>
> Cc: Hao A Wu <hao.a.wu at intel.com>
>
> Signed-off-by: Zhiguang Liu <zhiguang.liu at intel.com>
> ---
> MdeModulePkg/Include/UniversalPayload/PciRootBridges.h | 89
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> ++++++++++++++++++++++++
> MdeModulePkg/MdeModulePkg.dec | 6 ++++++
> 2 files changed, 95 insertions(+)
>
> diff --git a/MdeModulePkg/Include/UniversalPayload/PciRootBridges.h
> b/MdeModulePkg/Include/UniversalPayload/PciRootBridges.h
> new file mode 100644
> index 0000000000..72e8331ede
> --- /dev/null
> +++ b/MdeModulePkg/Include/UniversalPayload/PciRootBridges.h
> @@ -0,0 +1,89 @@
> +/** @file
>
> + This file defines the structure for the PCI Root Bridges.
>
> +
>
> + Copyright (c) 2021, Intel Corporation. All rights reserved.<BR>
>
> + SPDX-License-Identifier: BSD-2-Clause-Patent
>
> +
Could you help to add the specification reference information in the header file description comment?
With this handled:
Reviewed-by: Hao A Wu <hao.a.wu at intel.com>
Best Regards,
Hao Wu
>
> +**/
>
> +
>
> +#ifndef __PLD_PCI_ROOT_BRIDGES_H__
>
> +#define __PLD_PCI_ROOT_BRIDGES_H__
>
> +
>
> +#include <UniversalPayload/UniversalPayload.h>
>
> +
>
> +#pragma pack(1)
>
> +
>
> +//
>
> +// (Base > Limit) indicates an aperture is not available.
>
> +//
>
> +typedef struct {
>
> + //
>
> + // Base and Limit are the device address instead of host address when
>
> + // Translation is not zero
>
> + //
>
> + UINT64 Base;
>
> + UINT64 Limit;
>
> + //
>
> + // According to UEFI 2.7, Device Address = Host Address + Translation,
>
> + // so Translation = Device Address - Host Address.
>
> + // On platforms where Translation is not zero, the subtraction is probably to
>
> + // be performed with UINT64 wrap-around semantics, for we may translate
> an
>
> + // above-4G host address into a below-4G device address for legacy PCIe
> device
>
> + // compatibility.
>
> + //
>
> + // NOTE: The alignment of Translation is required to be larger than any BAR
>
> + // alignment in the same root bridge, so that the same alignment can be
>
> + // applied to both device address and host address, which simplifies the
>
> + // situation and makes the current resource allocation code in generic PCI
>
> + // host bridge driver still work.
>
> + //
>
> + UINT64 Translation;
>
> +} PLD_PCI_ROOT_BRIDGE_APERTURE;
>
> +
>
> +///
>
> +/// Payload PCI Root Bridge Information HOB
>
> +///
>
> +typedef struct {
>
> + UINT32 Segment; ///< Segment number.
>
> + UINT64 Supports; ///< Supported attributes.
>
> + ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by
> GetAttributes()
>
> + ///< and SetAttributes() in
> EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
>
> + UINT64 Attributes; ///< Initial attributes.
>
> + ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by
> GetAttributes()
>
> + ///< and SetAttributes() in
> EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
>
> + BOOLEAN DmaAbove4G; ///< DMA above 4GB memory.
>
> + ///< Set to TRUE when root bridge supports DMA
> above 4GB memory.
>
> + BOOLEAN NoExtendedConfigSpace; ///< When FALSE, the root
> bridge supports
>
> + ///< Extended (4096-byte) Configuration Space.
>
> + ///< When TRUE, the root bridge supports
>
> + ///< 256-byte Configuration Space only.
>
> + UINT64 AllocationAttributes; ///< Allocation attributes.
>
> + ///< Refer to
> EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM and
>
> + ///< EFI_PCI_HOST_BRIDGE_MEM64_DECODE
> used by GetAllocAttributes()
>
> + ///< in
> EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE Bus; ///< Bus aperture which
> can be used by the root bridge.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE Io; ///< IO aperture which can
> be used by the root bridge.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE Mem; ///< MMIO aperture
> below 4GB which can be used by the root bridge.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE MemAbove4G; ///< MMIO
> aperture above 4GB which can be used by the root bridge.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE PMem; ///< Prefetchable MMIO
> aperture below 4GB which can be used by the root bridge.
>
> + PLD_PCI_ROOT_BRIDGE_APERTURE PMemAbove4G; ///< Prefetchable
> MMIO aperture above 4GB which can be used by the root bridge.
>
> + UINT32 HID; ///< PnP hardware ID of the root bridge.
> This value must match the corresponding
>
> + ///< _HID in the ACPI name space.
>
> + UINT32 UID; ///< Unique ID that is required by ACPI if
> two devices have the same _HID.
>
> + ///< This value must also match the
> corresponding _UID/_HID pair in the ACPI name space.
>
> +} PLD_PCI_ROOT_BRIDGE;
>
> +
>
> +typedef struct {
>
> + PLD_GENERIC_HEADER PldHeader;
>
> + BOOLEAN ResourceAssigned;
>
> + UINT8 Count;
>
> + PLD_PCI_ROOT_BRIDGE RootBridge[0];
>
> +} PLD_PCI_ROOT_BRIDGES;
>
> +
>
> +#pragma pack()
>
> +
>
> +#define PLD_PCI_ROOT_BRIDGES_REVISION 1
>
> +
>
> +extern GUID gPldPciRootBridgeInfoGuid;
>
> +
>
> +#endif // __PLD_PCI_ROOT_BRIDGES_H__
>
> diff --git a/MdeModulePkg/MdeModulePkg.dec
> b/MdeModulePkg/MdeModulePkg.dec
> index 8d38383915..671d0f33c8 100644
> --- a/MdeModulePkg/MdeModulePkg.dec
> +++ b/MdeModulePkg/MdeModulePkg.dec
> @@ -404,6 +404,12 @@
> ## Include/Guid/MigratedFvInfo.h
>
> gEdkiiMigratedFvInfoGuid = { 0xc1ab12f7, 0x74aa, 0x408d, { 0xa2, 0xf4, 0xc6,
> 0xce, 0xfd, 0x17, 0x98, 0x71 } }
>
>
>
> + #
>
> + # GUID defined in UniversalPayload
>
> + #
>
> + ## Include/UniversalPayload/PciRootBridges.h
>
> + gPldPciRootBridgeInfoGuid = { 0xec4ebacb, 0x2638, 0x416e, { 0xbe, 0x80,
> 0xe5, 0xfa, 0x4b, 0x51, 0x19, 0x01 }}
>
> +
>
> [Ppis]
>
> ## Include/Ppi/AtaController.h
>
> gPeiAtaControllerPpiGuid = { 0xa45e60d1, 0xc719, 0x44aa, { 0xb0, 0x7a,
> 0xaa, 0x77, 0x7f, 0x85, 0x90, 0x6d }}
>
> --
> 2.30.0.windows.2
-=-=-=-=-=-=-=-=-=-=-=-
Groups.io Links: You receive all messages sent to this group.
View/Reply Online (#76181): https://edk2.groups.io/g/devel/message/76181
Mute This Topic: https://groups.io/mt/83304944/1813853
Group Owner: devel+owner at edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub [edk2-devel-archive at redhat.com]
-=-=-=-=-=-=-=-=-=-=-=-
More information about the edk2-devel-archive
mailing list