2 Header files and data structures needed by PCI Bus module.
4 Copyright (c) 2006 - 2009, Intel Corporation
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #ifndef _EFI_PCI_BUS_H_
17 #define _EFI_PCI_BUS_H_
19 #include <FrameworkDxe.h>
21 #include <Protocol/LoadedImage.h>
22 #include <Protocol/PciHostBridgeResourceAllocation.h>
23 #include <Protocol/PciIo.h>
24 #include <Protocol/LoadFile2.h>
25 #include <Protocol/PciRootBridgeIo.h>
26 #include <Protocol/PciHotPlugRequest.h>
27 #include <Protocol/DevicePath.h>
28 #include <Protocol/PciPlatform.h>
29 #include <Protocol/PciHotPlugInit.h>
30 #include <Protocol/Decompress.h>
31 #include <Protocol/BusSpecificDriverOverride.h>
32 #include <Protocol/IncompatiblePciDeviceSupport.h>
34 #include <Library/DebugLib.h>
35 #include <Library/UefiDriverEntryPoint.h>
36 #include <Library/BaseLib.h>
37 #include <Library/UefiLib.h>
38 #include <Library/BaseMemoryLib.h>
39 #include <Library/ReportStatusCodeLib.h>
40 #include <Library/MemoryAllocationLib.h>
41 #include <Library/UefiBootServicesTableLib.h>
42 #include <Library/DevicePathLib.h>
43 #include <Library/PcdLib.h>
44 #include <Library/PciIncompatibleDeviceSupportLib.h>
45 #include <Library/PeCoffLib.h>
47 #include <IndustryStandard/Pci.h>
48 #include <IndustryStandard/PeImage.h>
49 #include <IndustryStandard/Acpi.h>
51 typedef struct _PCI_IO_DEVICE PCI_IO_DEVICE
;
52 typedef struct _PCI_BAR PCI_BAR
;
55 PciBarTypeUnknown
= 0,
67 #include "ComponentName.h"
69 #include "PciCommand.h"
70 #include "PciDeviceSupport.h"
71 #include "PciEnumerator.h"
72 #include "PciEnumeratorSupport.h"
73 #include "PciDriverOverride.h"
74 #include "PciRomTable.h"
75 #include "PciOptionRomSupport.h"
76 #include "PciPowerManagement.h"
77 #include "PciHotPlugSupport.h"
80 #define VGABASE1 0x3B0
81 #define VGALIMIT1 0x3BB
83 #define VGABASE2 0x3C0
84 #define VGALIMIT2 0x3DF
87 #define ISALIMIT 0x3FF
104 #define PPB_IO_RANGE 2
105 #define PPB_MEM32_RANGE 3
106 #define PPB_PMEM32_RANGE 4
107 #define PPB_PMEM64_RANGE 5
108 #define PPB_MEM64_RANGE 0xFF
116 #define EFI_BRIDGE_IO32_DECODE_SUPPORTED 0x0001
117 #define EFI_BRIDGE_PMEM32_DECODE_SUPPORTED 0x0002
118 #define EFI_BRIDGE_PMEM64_DECODE_SUPPORTED 0x0004
119 #define EFI_BRIDGE_IO16_DECODE_SUPPORTED 0x0008
120 #define EFI_BRIDGE_PMEM_MEM_COMBINE_SUPPORTED 0x0010
121 #define EFI_BRIDGE_MEM64_DECODE_SUPPORTED 0x0020
122 #define EFI_BRIDGE_MEM32_DECODE_SUPPORTED 0x0040
124 #define PCI_MAX_HOST_BRIDGE_NUM 0x0010
127 // Define option for attribute
129 #define EFI_SET_SUPPORTS 0
130 #define EFI_SET_ATTRIBUTES 1
132 #define PCI_IO_DEVICE_SIGNATURE SIGNATURE_32 ('p', 'c', 'i', 'o')
134 struct _PCI_IO_DEVICE
{
137 EFI_PCI_IO_PROTOCOL PciIo
;
140 EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL PciDriverOverride
;
141 EFI_DEVICE_PATH_PROTOCOL
*DevicePath
;
142 EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
*PciRootBridgeIo
;
143 EFI_LOAD_FILE2_PROTOCOL LoadFile2
;
146 // PCI configuration space header type
151 // Bus number, Device number, Function number
155 UINT8 FunctionNumber
;
158 // BAR for this PCI Device
160 PCI_BAR PciBar
[PCI_MAX_BAR
];
163 // The bridge device this pci device is subject to
165 PCI_IO_DEVICE
*Parent
;
168 // A linked list for children Pci Device if it is bridge device
170 LIST_ENTRY ChildList
;
173 // TURE if the PCI bus driver creates the handle for this PCI device
178 // TRUE if the PCI bus driver successfully allocates the resource required by
184 // The attribute this PCI device currently set
189 // The attributes this PCI device actually supports
194 // The resource decode the bridge supports
199 // The OptionRom Size
204 // The OptionRom Size
209 // TRUE if all OpROM (in device or in platform specific position) have been processed
211 BOOLEAN AllOpRomProcessed
;
214 // TRUE if there is any EFI driver in the OptionRom
219 // A list tracking reserved resource on a bridge device
221 LIST_ENTRY ReservedResourceList
;
224 // A list tracking image handle of platform specific overriding driver
226 LIST_ENTRY OptionRomDriverList
;
228 EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
*ResourcePaddingDescriptors
;
229 EFI_HPC_PADDING_ATTRIBUTES PaddingAttributes
;
235 #define PCI_IO_DEVICE_FROM_PCI_IO_THIS(a) \
236 CR (a, PCI_IO_DEVICE, PciIo, PCI_IO_DEVICE_SIGNATURE)
238 #define PCI_IO_DEVICE_FROM_PCI_DRIVER_OVERRIDE_THIS(a) \
239 CR (a, PCI_IO_DEVICE, PciDriverOverride, PCI_IO_DEVICE_SIGNATURE)
241 #define PCI_IO_DEVICE_FROM_LINK(a) \
242 CR (a, PCI_IO_DEVICE, Link, PCI_IO_DEVICE_SIGNATURE)
244 #define PCI_IO_DEVICE_FROM_LOAD_FILE2_THIS(a) \
245 CR (a, PCI_IO_DEVICE, LoadFile2, PCI_IO_DEVICE_SIGNATURE)
252 extern EFI_INCOMPATIBLE_PCI_DEVICE_SUPPORT_PROTOCOL
*gEfiIncompatiblePciDeviceSupport
;
253 extern EFI_DRIVER_BINDING_PROTOCOL gPciBusDriverBinding
;
254 extern EFI_COMPONENT_NAME_PROTOCOL gPciBusComponentName
;
255 extern EFI_COMPONENT_NAME2_PROTOCOL gPciBusComponentName2
;
256 extern BOOLEAN gFullEnumeration
;
257 extern UINTN gPciHostBridgeNumber
;
258 extern EFI_HANDLE gPciHostBrigeHandles
[PCI_MAX_HOST_BRIDGE_NUM
];
259 extern UINT64 gAllOne
;
260 extern UINT64 gAllZero
;
261 extern EFI_PCI_PLATFORM_PROTOCOL
*gPciPlatformProtocol
;
265 Macro that checks whether device is a GFX device.
267 @param _p Specified device.
269 @retval TRUE Device is a a GFX device.
270 @retval FALSE Device is not a a GFX device.
273 #define IS_PCI_GFX(_p) IS_CLASS2 (_p, PCI_CLASS_DISPLAY, PCI_CLASS_DISPLAY_OTHER)
276 Test to see if this driver supports ControllerHandle. Any ControllerHandle
277 than contains a gEfiPciRootBridgeIoProtocolGuid protocol can be supported.
279 @param This Protocol instance pointer.
280 @param Controller Handle of device to test.
281 @param RemainingDevicePath Optional parameter use to pick a specific child.
284 @retval EFI_SUCCESS This driver supports this device.
285 @retval EFI_ALREADY_STARTED This driver is already running on this device.
286 @retval other This driver does not support this device.
291 PciBusDriverBindingSupported (
292 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
293 IN EFI_HANDLE Controller
,
294 IN EFI_DEVICE_PATH_PROTOCOL
*RemainingDevicePath
298 Start this driver on ControllerHandle and enumerate Pci bus and start
299 all device under PCI bus.
301 @param This Protocol instance pointer.
302 @param Controller Handle of device to bind driver to.
303 @param RemainingDevicePath Optional parameter use to pick a specific child.
306 @retval EFI_SUCCESS This driver is added to ControllerHandle.
307 @retval EFI_ALREADY_STARTED This driver is already running on ControllerHandle.
308 @retval other This driver does not support this device.
313 PciBusDriverBindingStart (
314 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
315 IN EFI_HANDLE Controller
,
316 IN EFI_DEVICE_PATH_PROTOCOL
*RemainingDevicePath
320 Stop this driver on ControllerHandle. Support stoping any child handles
321 created by this driver.
323 @param This Protocol instance pointer.
324 @param Controller Handle of device to stop driver on.
325 @param NumberOfChildren Number of Handles in ChildHandleBuffer. If number of
326 children is zero stop the entire bus driver.
327 @param ChildHandleBuffer List of Child Handles to Stop.
329 @retval EFI_SUCCESS This driver is removed ControllerHandle.
330 @retval other This driver was not removed from this device.
335 PciBusDriverBindingStop (
336 IN EFI_DRIVER_BINDING_PROTOCOL
*This
,
337 IN EFI_HANDLE Controller
,
338 IN UINTN NumberOfChildren
,
339 IN EFI_HANDLE
*ChildHandleBuffer