#include <IndustryStandard/Acpi10.h>
#include <IndustryStandard/Pci.h>
#include <Library/BaseMemoryLib.h>
#include <Library/DebugLib.h>
#include <Library/DevicePathLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/PciHostBridgeLib.h>
#include <Library/PciHostBridgeUtilityLib.h>
#include <Library/PciLib.h>

Data Structures
struct	EFI_PCI_ROOT_BRIDGE_DEVICE_PATH

Functions
PCI_ROOT_BRIDGE *EFIAPI	PciHostBridgeUtilityGetRootBridges (OUT UINTN Count, IN UINT64 Attributes, IN UINT64 AllocationAttributes, IN BOOLEAN DmaAbove4G, IN BOOLEAN NoExtendedConfigSpace, IN UINTN BusMin, IN UINTN BusMax, IN PCI_ROOT_BRIDGE_APERTURE Io, IN PCI_ROOT_BRIDGE_APERTURE Mem, IN PCI_ROOT_BRIDGE_APERTURE MemAbove4G, IN PCI_ROOT_BRIDGE_APERTURE PMem, IN PCI_ROOT_BRIDGE_APERTURE PMemAbove4G)

VOID EFIAPI	PciHostBridgeUtilityFreeRootBridges (IN PCI_ROOT_BRIDGE *Bridges, IN UINTN Count)

VOID EFIAPI	PciHostBridgeUtilityResourceConflict (IN VOID *Configuration)

Variables
GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *	mPciHostBridgeAcpiAddressSpaceTypeStr []

STATIC CONST EFI_PCI_ROOT_BRIDGE_DEVICE_PATH	mEfiPciRootBridgeDevicePath

GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *	mPciHostBridgeLibAcpiAddressSpaceTypeStr []

STATIC PCI_ROOT_BRIDGE	mRootBridge

Detailed Description

PCI Host Bridge utility functions for ArmVirt.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file ArmVirtPciHostBridgeUtilityLib.c.

Function Documentation

◆ PciHostBridgeUtilityFreeRootBridges()

VOID EFIAPI PciHostBridgeUtilityFreeRootBridges	(	IN PCI_ROOT_BRIDGE *	Bridges,
		IN UINTN	Count
	)

Utility function to free root bridge instances array from PciHostBridgeUtilityGetRootBridges().

Parameters

[in]	Bridges	The root bridge instances array.
[in]	Count	The count of the array.

Definition at line 150 of file ArmVirtPciHostBridgeUtilityLib.c.

◆ PciHostBridgeUtilityGetRootBridges()

PCI_ROOT_BRIDGE *EFIAPI PciHostBridgeUtilityGetRootBridges	(	OUT UINTN *	Count,
		IN UINT64	Attributes,
		IN UINT64	AllocationAttributes,
		IN BOOLEAN	DmaAbove4G,
		IN BOOLEAN	NoExtendedConfigSpace,
		IN UINTN	BusMin,
		IN UINTN	BusMax,
		IN PCI_ROOT_BRIDGE_APERTURE *	Io,
		IN PCI_ROOT_BRIDGE_APERTURE *	Mem,
		IN PCI_ROOT_BRIDGE_APERTURE *	MemAbove4G,
		IN PCI_ROOT_BRIDGE_APERTURE *	PMem,
		IN PCI_ROOT_BRIDGE_APERTURE *	PMemAbove4G
	)

Utility function to return all the root bridge instances in an array.

Parameters

[out]	Count	The number of root bridge instances.
[in]	Attributes	Initial attributes.
[in]	AllocationAttributes	Allocation attributes.
[in]	DmaAbove4G	DMA above 4GB memory.
[in]	NoExtendedConfigSpace	No Extended Config Space.
[in]	BusMin	Minimum Bus number, inclusive.
[in]	BusMax	Maximum Bus number, inclusive.
[in]	Io	IO aperture.
[in]	Mem	MMIO aperture.
[in]	MemAbove4G	MMIO aperture above 4G.
[in]	PMem	Prefetchable MMIO aperture.
[in]	PMemAbove4G	Prefetchable MMIO aperture above 4G.

Returns: All the root bridge instances in an array.

Definition at line 85 of file ArmVirtPciHostBridgeUtilityLib.c.

◆ PciHostBridgeUtilityResourceConflict()

VOID EFIAPI PciHostBridgeUtilityResourceConflict ( IN VOID * Configuration )

Utility function to inform the platform that the resource conflict happens.

Parameters

[in] Configuration Pointer to PCI I/O and PCI memory resource descriptors. The Configuration contains the resources for all the root bridges. The resource for each root bridge is terminated with END descriptor and an additional END is appended indicating the end of the entire resources. The resource descriptor field values follow the description in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL .SubmitResources().

Definition at line 174 of file ArmVirtPciHostBridgeUtilityLib.c.

Variable Documentation

◆ mEfiPciRootBridgeDevicePath

STATIC CONST EFI_PCI_ROOT_BRIDGE_DEVICE_PATH mEfiPciRootBridgeDevicePath

Initial value:

= {
  {
    {
      ACPI_DEVICE_PATH,
      ACPI_DP,
      {
        (UINT8)(sizeof (ACPI_HID_DEVICE_PATH)),
        (UINT8)((sizeof (ACPI_HID_DEVICE_PATH)) >> 8)
      }
    },
    EISA_PNP_ID (0x0A03), 
    0                     
  },
 
  {
    END_DEVICE_PATH_TYPE,
    END_ENTIRE_DEVICE_PATH_SUBTYPE,
    {
      END_DEVICE_PATH_LENGTH,
      0
    }
  }
}