PciHostBridgeLib.h

Go to the documentation of this file.

 
#ifndef __PCI_HOST_BRIDGE_LIB_H__
#define __PCI_HOST_BRIDGE_LIB_H__
 
//
// (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;
} PCI_ROOT_BRIDGE_APERTURE;
 
typedef struct {
  UINT32                      Segment;               
  UINT64                      Supports;              
  UINT64                      Attributes;            
  BOOLEAN                     DmaAbove4G;            
  BOOLEAN                     NoExtendedConfigSpace; 
  BOOLEAN                     ResourceAssigned;      
  UINT64                      AllocationAttributes;  
  PCI_ROOT_BRIDGE_APERTURE    Bus;                   
  PCI_ROOT_BRIDGE_APERTURE    Io;                    
  PCI_ROOT_BRIDGE_APERTURE    Mem;                   
  PCI_ROOT_BRIDGE_APERTURE    MemAbove4G;            
  PCI_ROOT_BRIDGE_APERTURE    PMem;                  
  PCI_ROOT_BRIDGE_APERTURE    PMemAbove4G;           
  EFI_DEVICE_PATH_PROTOCOL    *DevicePath;           
} PCI_ROOT_BRIDGE;
 
PCI_ROOT_BRIDGE *
EFIAPI
PciHostBridgeGetRootBridges (
  UINTN  *Count
  );
 
VOID
EFIAPI
PciHostBridgeFreeRootBridges (
  PCI_ROOT_BRIDGE  *Bridges,
  UINTN            Count
  );
 
VOID
EFIAPI
PciHostBridgeResourceConflict (
  EFI_HANDLE  HostBridgeHandle,
  VOID        *Configuration
  );
 
#endif