public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "Wu, Hao A" <hao.a.wu@intel.com>
To: "Liu, Zhiguang" <zhiguang.liu@intel.com>,
	"devel@edk2.groups.io" <devel@edk2.groups.io>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>,
	Liming Gao <gaoliming@byosoft.com.cn>,
	"Wang, Jian J" <jian.j.wang@intel.com>
Subject: Re: [Patch V3 2/9] MdeModulePkg: Add new structure for the PCI Root Bridge Info Hob
Date: Tue, 8 Jun 2021 05:20:54 +0000	[thread overview]
Message-ID: <BN8PR11MB36667C63B0E07EA40597BA0BCA379@BN8PR11MB3666.namprd11.prod.outlook.com> (raw)
In-Reply-To: <20210604094227.1890-3-zhiguang.liu@intel.com>

> -----Original Message-----
> From: Liu, Zhiguang <zhiguang.liu@intel.com>
> Sent: Friday, June 4, 2021 5:42 PM
> To: devel@edk2.groups.io
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Liming Gao
> <gaoliming@byosoft.com.cn>; Wang, Jian J <jian.j.wang@intel.com>; Wu, Hao
> A <hao.a.wu@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@intel.com>
> Cc: Liming Gao <gaoliming@byosoft.com.cn>
> Cc: Jian J Wang <jian.j.wang@intel.com>
> Cc: Hao A Wu <hao.a.wu@intel.com>
> 
> Signed-off-by: Zhiguang Liu <zhiguang.liu@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@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


  reply	other threads:[~2021-06-08  5:20 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-06-04  9:42 [Patch V3 0/9] Create multiple Hobs for Universal Payload Zhiguang Liu
2021-06-04  9:42 ` [Patch V3 1/9] MdeModulePkg: Add Universal Payload general defination header file Zhiguang Liu
2021-06-08  5:20   ` Wu, Hao A
2021-06-08 16:25   ` Michael D Kinney
2021-06-09  2:58     ` [edk2-devel] " Ni, Ray
2021-06-09  3:08       ` Ma, Maurice
2021-06-09  5:45         ` Zhiguang Liu
2021-06-04  9:42 ` [Patch V3 2/9] MdeModulePkg: Add new structure for the PCI Root Bridge Info Hob Zhiguang Liu
2021-06-08  5:20   ` Wu, Hao A [this message]
2021-06-04  9:42 ` [Patch V3 3/9] UefiPayloadPkg: UefiPayload retrieve PCI root bridge from Guid Hob Zhiguang Liu
2021-06-04  9:42 ` [Patch V3 4/9] MdeModulePkg: Add new structure for the Universal Payload SMBios Table Info Hob Zhiguang Liu
2021-06-08  5:20   ` Wu, Hao A
2021-06-04  9:42 ` [Patch V3 5/9] MdeModulePkg/Universal/SmbiosDxe: Scan for existing tables Zhiguang Liu
2021-06-08  5:21   ` Wu, Hao A
2021-06-08  9:20   ` Patrick Rudolph
2021-06-10  1:56     ` Zhiguang Liu
2021-06-04  9:42 ` [Patch V3 6/9] UefiPayloadPkg: Creat gPldSmbiosTableGuid Hob Zhiguang Liu
2021-06-04  9:42 ` [Patch V3 7/9] MdeModulePkg: Add new structure for the Universal Payload ACPI Table Info Hob Zhiguang Liu
2021-06-08  5:21   ` Wu, Hao A
2021-06-04  9:42 ` [Patch V3 8/9] MdeModulePkg/ACPI: Install ACPI table from HOB Zhiguang Liu
2021-06-08  5:21   ` Wu, Hao A
2021-06-04  9:42 ` [Patch V3 9/9] UefiPayloadPkg: Creat gPldAcpiTableGuid Hob Zhiguang Liu

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=BN8PR11MB36667C63B0E07EA40597BA0BCA379@BN8PR11MB3666.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