2 PCI emumeration support functions implementation for PCI Bus module.
4 Copyright (c) 2006 - 2021, Intel Corporation. All rights reserved.<BR>
5 (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
6 SPDX-License-Identifier: BSD-2-Clause-Patent
12 extern CHAR16
*mBarTypeStr
[];
13 extern EDKII_DEVICE_SECURITY_PROTOCOL
*mDeviceSecurityProtocol
;
15 #define OLD_ALIGN 0xFFFFFFFFFFFFFFFFULL
16 #define EVEN_ALIGN 0xFFFFFFFFFFFFFFFEULL
17 #define SQUAD_ALIGN 0xFFFFFFFFFFFFFFFDULL
18 #define DQUAD_ALIGN 0xFFFFFFFFFFFFFFFCULL
21 This routine is used to check whether the pci device is present.
23 @param PciRootBridgeIo Pointer to instance of EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
24 @param Pci Output buffer for PCI device configuration space.
25 @param Bus PCI bus NO.
26 @param Device PCI device NO.
27 @param Func PCI Func NO.
29 @retval EFI_NOT_FOUND PCI device not present.
30 @retval EFI_SUCCESS PCI device is found.
35 IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
*PciRootBridgeIo
,
46 // Create PCI address map in terms of Bus, Device and Func
48 Address
= EFI_PCI_ADDRESS (Bus
, Device
, Func
, 0);
51 // Read the Vendor ID register
53 Status
= PciRootBridgeIo
->Pci
.Read (
61 if (!EFI_ERROR (Status
) && (Pci
->Hdr
).VendorId
!= 0xffff) {
63 // Read the entire config header for the device
65 Status
= PciRootBridgeIo
->Pci
.Read (
69 sizeof (PCI_TYPE00
) / sizeof (UINT32
),
80 Collect all the resource information under this root bridge.
82 A database that records all the information about pci device subject to this
83 root bridge will then be created.
85 @param Bridge Parent bridge instance.
86 @param StartBusNumber Bus number of beginning.
88 @retval EFI_SUCCESS PCI device is found.
89 @retval other Some error occurred when reading PCI bridge information.
93 PciPciDeviceInfoCollector (
94 IN PCI_IO_DEVICE
*Bridge
,
95 IN UINT8 StartBusNumber
103 PCI_IO_DEVICE
*PciIoDevice
;
104 EFI_PCI_IO_PROTOCOL
*PciIo
;
106 Status
= EFI_SUCCESS
;
109 for (Device
= 0; Device
<= PCI_MAX_DEVICE
; Device
++) {
111 for (Func
= 0; Func
<= PCI_MAX_FUNC
; Func
++) {
114 // Check to see whether PCI device is present
116 Status
= PciDevicePresent (
117 Bridge
->PciRootBridgeIo
,
119 (UINT8
) StartBusNumber
,
124 if (EFI_ERROR (Status
) && Func
== 0) {
126 // go to next device if there is no Function 0
131 if (!EFI_ERROR (Status
)) {
134 // Call back to host bridge function
136 PreprocessController (Bridge
, (UINT8
) StartBusNumber
, Device
, Func
, EfiPciBeforeResourceCollection
);
139 // Collect all the information about the PCI device discovered
141 Status
= PciSearchDevice (
144 (UINT8
) StartBusNumber
,
151 // Recursively scan PCI busses on the other side of PCI-PCI bridges
154 if (!EFI_ERROR (Status
) && (IS_PCI_BRIDGE (&Pci
) || IS_CARDBUS_BRIDGE (&Pci
))) {
157 // If it is PPB, we need to get the secondary bus to continue the enumeration
159 PciIo
= &(PciIoDevice
->PciIo
);
161 Status
= PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint8
, PCI_BRIDGE_SECONDARY_BUS_REGISTER_OFFSET
, 1, &SecBus
);
163 if (EFI_ERROR (Status
)) {
168 // Ensure secondary bus number is greater than the primary bus number to avoid
169 // any potential dead loop when PcdPciDisableBusEnumeration is set to TRUE
171 if (SecBus
<= StartBusNumber
) {
176 // Get resource padding for PPB
178 GetResourcePaddingPpb (PciIoDevice
);
181 // Deep enumerate the next level bus
183 Status
= PciPciDeviceInfoCollector (
190 if (Func
== 0 && !IS_PCI_MULTI_FUNC (&Pci
)) {
193 // Skip sub functions, this is not a multi function device
206 Search required device and create PCI device instance.
208 @param Bridge Parent bridge instance.
209 @param Pci Input PCI device information block.
210 @param Bus PCI bus NO.
211 @param Device PCI device NO.
212 @param Func PCI func NO.
213 @param PciDevice Output of searched PCI device instance.
215 @retval EFI_SUCCESS Successfully created PCI device instance.
216 @retval EFI_OUT_OF_RESOURCES Cannot get PCI device information.
221 IN PCI_IO_DEVICE
*Bridge
,
226 OUT PCI_IO_DEVICE
**PciDevice
229 PCI_IO_DEVICE
*PciIoDevice
;
235 "PciBus: Discovered %s @ [%02x|%02x|%02x]\n",
236 IS_PCI_BRIDGE (Pci
) ? L
"PPB" :
237 IS_CARDBUS_BRIDGE (Pci
) ? L
"P2C" :
242 if (!IS_PCI_BRIDGE (Pci
)) {
244 if (IS_CARDBUS_BRIDGE (Pci
)) {
245 PciIoDevice
= GatherP2CInfo (
252 if ((PciIoDevice
!= NULL
) && gFullEnumeration
) {
253 InitializeP2C (PciIoDevice
);
258 // Create private data for Pci Device
260 PciIoDevice
= GatherDeviceInfo (
273 // Create private data for PPB
275 PciIoDevice
= GatherPpbInfo (
284 // Special initialization for PPB including making the PPB quiet
286 if ((PciIoDevice
!= NULL
) && gFullEnumeration
) {
287 InitializePpb (PciIoDevice
);
291 if (PciIoDevice
== NULL
) {
292 return EFI_OUT_OF_RESOURCES
;
296 // Update the bar information for this PCI device so as to support some specific device
298 UpdatePciInfo (PciIoDevice
);
300 if (PciIoDevice
->DevicePath
== NULL
) {
301 return EFI_OUT_OF_RESOURCES
;
305 // Detect this function has option rom
307 if (gFullEnumeration
) {
309 if (!IS_CARDBUS_BRIDGE (Pci
)) {
311 GetOpRomInfo (PciIoDevice
);
315 ResetPowerManagementFeature (PciIoDevice
);
320 // Insert it into a global tree for future reference
322 InsertPciDevice (Bridge
, PciIoDevice
);
325 // Determine PCI device attributes
328 if (PciDevice
!= NULL
) {
329 *PciDevice
= PciIoDevice
;
336 Dump the PPB padding resource information.
338 @param PciIoDevice PCI IO instance.
339 @param ResourceType The desired resource type to dump.
340 PciBarTypeUnknown means to dump all types of resources.
343 DumpPpbPaddingResource (
344 IN PCI_IO_DEVICE
*PciIoDevice
,
345 IN PCI_BAR_TYPE ResourceType
348 EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
*Descriptor
;
351 if (PciIoDevice
->ResourcePaddingDescriptors
== NULL
) {
355 if (ResourceType
== PciBarTypeIo16
|| ResourceType
== PciBarTypeIo32
) {
356 ResourceType
= PciBarTypeIo
;
359 for (Descriptor
= PciIoDevice
->ResourcePaddingDescriptors
; Descriptor
->Desc
!= ACPI_END_TAG_DESCRIPTOR
; Descriptor
++) {
361 Type
= PciBarTypeUnknown
;
362 if (Descriptor
->Desc
== ACPI_ADDRESS_SPACE_DESCRIPTOR
&& Descriptor
->ResType
== ACPI_ADDRESS_SPACE_TYPE_IO
) {
364 } else if (Descriptor
->Desc
== ACPI_ADDRESS_SPACE_DESCRIPTOR
&& Descriptor
->ResType
== ACPI_ADDRESS_SPACE_TYPE_MEM
) {
366 if (Descriptor
->AddrSpaceGranularity
== 32) {
370 if (Descriptor
->SpecificFlag
== EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE
) {
371 Type
= PciBarTypePMem32
;
377 if (Descriptor
->SpecificFlag
== 0) {
378 Type
= PciBarTypeMem32
;
382 if (Descriptor
->AddrSpaceGranularity
== 64) {
386 if (Descriptor
->SpecificFlag
== EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE
) {
387 Type
= PciBarTypePMem64
;
393 if (Descriptor
->SpecificFlag
== 0) {
394 Type
= PciBarTypeMem64
;
399 if ((Type
!= PciBarTypeUnknown
) && ((ResourceType
== PciBarTypeUnknown
) || (ResourceType
== Type
))) {
402 " Padding: Type = %s; Alignment = 0x%lx;\tLength = 0x%lx\n",
403 mBarTypeStr
[Type
], Descriptor
->AddrRangeMax
, Descriptor
->AddrLen
411 Dump the PCI BAR information.
413 @param PciIoDevice PCI IO instance.
417 IN PCI_IO_DEVICE
*PciIoDevice
422 for (Index
= 0; Index
< PCI_MAX_BAR
; Index
++) {
423 if (PciIoDevice
->PciBar
[Index
].BarType
== PciBarTypeUnknown
) {
429 " BAR[%d]: Type = %s; Alignment = 0x%lx;\tLength = 0x%lx;\tOffset = 0x%02x\n",
430 Index
, mBarTypeStr
[MIN (PciIoDevice
->PciBar
[Index
].BarType
, PciBarTypeMaxType
)],
431 PciIoDevice
->PciBar
[Index
].Alignment
, PciIoDevice
->PciBar
[Index
].Length
, PciIoDevice
->PciBar
[Index
].Offset
435 for (Index
= 0; Index
< PCI_MAX_BAR
; Index
++) {
436 if ((PciIoDevice
->VfPciBar
[Index
].BarType
== PciBarTypeUnknown
) && (PciIoDevice
->VfPciBar
[Index
].Length
== 0)) {
442 " VFBAR[%d]: Type = %s; Alignment = 0x%lx;\tLength = 0x%lx;\tOffset = 0x%02x\n",
443 Index
, mBarTypeStr
[MIN (PciIoDevice
->VfPciBar
[Index
].BarType
, PciBarTypeMaxType
)],
444 PciIoDevice
->VfPciBar
[Index
].Alignment
, PciIoDevice
->VfPciBar
[Index
].Length
, PciIoDevice
->VfPciBar
[Index
].Offset
447 DEBUG ((EFI_D_INFO
, "\n"));
451 Create PCI device instance for PCI device.
453 @param Bridge Parent bridge instance.
454 @param Pci Input PCI device information block.
455 @param Bus PCI device Bus NO.
456 @param Device PCI device Device NO.
457 @param Func PCI device's func NO.
459 @return Created PCI device instance.
464 IN PCI_IO_DEVICE
*Bridge
,
473 PCI_IO_DEVICE
*PciIoDevice
;
475 PciIoDevice
= CreatePciIoDevice (
483 if (PciIoDevice
== NULL
) {
488 // If it is a full enumeration, disconnect the device in advance
490 if (gFullEnumeration
) {
492 PCI_DISABLE_COMMAND_REGISTER (PciIoDevice
, EFI_PCI_COMMAND_BITS_OWNED
);
497 // Start to parse the bars
499 for (Offset
= 0x10, BarIndex
= 0; Offset
<= 0x24 && BarIndex
< PCI_MAX_BAR
; BarIndex
++) {
500 Offset
= PciParseBar (PciIoDevice
, Offset
, BarIndex
);
504 // Parse the SR-IOV VF bars
506 if (PcdGetBool (PcdSrIovSupport
) && PciIoDevice
->SrIovCapabilityOffset
!= 0) {
507 for (Offset
= PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_BAR0
, BarIndex
= 0;
508 Offset
<= PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_BAR5
;
511 ASSERT (BarIndex
< PCI_MAX_BAR
);
512 Offset
= PciIovParseVfBar (PciIoDevice
, Offset
, BarIndex
);
516 DEBUG_CODE (DumpPciBars (PciIoDevice
););
521 Create PCI device instance for PCI-PCI bridge.
523 @param Bridge Parent bridge instance.
524 @param Pci Input PCI device information block.
525 @param Bus PCI device Bus NO.
526 @param Device PCI device Device NO.
527 @param Func PCI device's func NO.
529 @return Created PCI device instance.
534 IN PCI_IO_DEVICE
*Bridge
,
541 PCI_IO_DEVICE
*PciIoDevice
;
544 EFI_PCI_IO_PROTOCOL
*PciIo
;
546 UINT32 PMemBaseLimit
;
547 UINT16 PrefetchableMemoryBase
;
548 UINT16 PrefetchableMemoryLimit
;
550 PciIoDevice
= CreatePciIoDevice (
558 if (PciIoDevice
== NULL
) {
562 if (gFullEnumeration
) {
563 PCI_DISABLE_COMMAND_REGISTER (PciIoDevice
, EFI_PCI_COMMAND_BITS_OWNED
);
566 // Initialize the bridge control register
568 PCI_DISABLE_BRIDGE_CONTROL_REGISTER (PciIoDevice
, EFI_PCI_BRIDGE_CONTROL_BITS_OWNED
);
573 // PPB can have two BARs
575 if (PciParseBar (PciIoDevice
, 0x10, PPB_BAR_0
) == 0x14) {
579 PciParseBar (PciIoDevice
, 0x14, PPB_BAR_1
);
582 PciIo
= &PciIoDevice
->PciIo
;
585 // Test whether it support 32 decode or not
587 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Temp
);
588 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &gAllOne
);
589 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Value
);
590 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Temp
);
593 if ((Value
& 0x01) != 0) {
594 PciIoDevice
->Decodes
|= EFI_BRIDGE_IO32_DECODE_SUPPORTED
;
596 PciIoDevice
->Decodes
|= EFI_BRIDGE_IO16_DECODE_SUPPORTED
;
601 // if PcdPciBridgeIoAlignmentProbe is TRUE, PCI bus driver probes
602 // PCI bridge supporting non-standard I/O window alignment less than 4K.
605 PciIoDevice
->BridgeIoAlignment
= 0xFFF;
606 if (FeaturePcdGet (PcdPciBridgeIoAlignmentProbe
)) {
608 // Check any bits of bit 3-1 of I/O Base Register are writable.
609 // if so, it is assumed non-standard I/O window alignment is supported by this bridge.
610 // Per spec, bit 3-1 of I/O Base Register are reserved bits, so its content can't be assumed.
612 Value
= (UINT8
)(Temp
^ (BIT3
| BIT2
| BIT1
));
613 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Value
);
614 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Value
);
615 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &Temp
);
616 Value
= (UINT8
)((Value
^ Temp
) & (BIT3
| BIT2
| BIT1
));
619 PciIoDevice
->BridgeIoAlignment
= 0x7FF;
622 PciIoDevice
->BridgeIoAlignment
= 0x3FF;
624 case BIT3
| BIT2
| BIT1
:
625 PciIoDevice
->BridgeIoAlignment
= 0x1FF;
630 Status
= BarExisted (
638 // Test if it supports 64 memory or not
640 // The bottom 4 bits of both the Prefetchable Memory Base and Prefetchable Memory Limit
642 // 0 - the bridge supports only 32 bit addresses.
643 // 1 - the bridge supports 64-bit addresses.
645 PrefetchableMemoryBase
= (UINT16
)(PMemBaseLimit
& 0xffff);
646 PrefetchableMemoryLimit
= (UINT16
)(PMemBaseLimit
>> 16);
647 if (!EFI_ERROR (Status
) &&
648 (PrefetchableMemoryBase
& 0x000f) == 0x0001 &&
649 (PrefetchableMemoryLimit
& 0x000f) == 0x0001) {
650 Status
= BarExisted (
657 if (!EFI_ERROR (Status
)) {
658 PciIoDevice
->Decodes
|= EFI_BRIDGE_PMEM32_DECODE_SUPPORTED
;
659 PciIoDevice
->Decodes
|= EFI_BRIDGE_PMEM64_DECODE_SUPPORTED
;
661 PciIoDevice
->Decodes
|= EFI_BRIDGE_PMEM32_DECODE_SUPPORTED
;
666 // Memory 32 code is required for ppb
668 PciIoDevice
->Decodes
|= EFI_BRIDGE_MEM32_DECODE_SUPPORTED
;
670 GetResourcePaddingPpb (PciIoDevice
);
673 DumpPpbPaddingResource (PciIoDevice
, PciBarTypeUnknown
);
674 DumpPciBars (PciIoDevice
);
682 Create PCI device instance for PCI Card bridge device.
684 @param Bridge Parent bridge instance.
685 @param Pci Input PCI device information block.
686 @param Bus PCI device Bus NO.
687 @param Device PCI device Device NO.
688 @param Func PCI device's func NO.
690 @return Created PCI device instance.
695 IN PCI_IO_DEVICE
*Bridge
,
702 PCI_IO_DEVICE
*PciIoDevice
;
704 PciIoDevice
= CreatePciIoDevice (
712 if (PciIoDevice
== NULL
) {
716 if (gFullEnumeration
) {
717 PCI_DISABLE_COMMAND_REGISTER (PciIoDevice
, EFI_PCI_COMMAND_BITS_OWNED
);
720 // Initialize the bridge control register
722 PCI_DISABLE_BRIDGE_CONTROL_REGISTER (PciIoDevice
, EFI_PCCARD_BRIDGE_CONTROL_BITS_OWNED
);
726 // P2C only has one bar that is in 0x10
728 PciParseBar (PciIoDevice
, 0x10, P2C_BAR_0
);
731 // Read PciBar information from the bar register
733 GetBackPcCardBar (PciIoDevice
);
734 PciIoDevice
->Decodes
= EFI_BRIDGE_MEM32_DECODE_SUPPORTED
|
735 EFI_BRIDGE_PMEM32_DECODE_SUPPORTED
|
736 EFI_BRIDGE_IO32_DECODE_SUPPORTED
;
738 DEBUG_CODE (DumpPciBars (PciIoDevice
););
744 Create device path for pci device.
746 @param ParentDevicePath Parent bridge's path.
747 @param PciIoDevice Pci device instance.
749 @return Device path protocol instance for specific pci device.
752 EFI_DEVICE_PATH_PROTOCOL
*
753 CreatePciDevicePath (
754 IN EFI_DEVICE_PATH_PROTOCOL
*ParentDevicePath
,
755 IN PCI_IO_DEVICE
*PciIoDevice
759 PCI_DEVICE_PATH PciNode
;
762 // Create PCI device path
764 PciNode
.Header
.Type
= HARDWARE_DEVICE_PATH
;
765 PciNode
.Header
.SubType
= HW_PCI_DP
;
766 SetDevicePathNodeLength (&PciNode
.Header
, sizeof (PciNode
));
768 PciNode
.Device
= PciIoDevice
->DeviceNumber
;
769 PciNode
.Function
= PciIoDevice
->FunctionNumber
;
770 PciIoDevice
->DevicePath
= AppendDevicePathNode (ParentDevicePath
, &PciNode
.Header
);
772 return PciIoDevice
->DevicePath
;
776 Check whether the PCI IOV VF bar is existed or not.
778 @param PciIoDevice A pointer to the PCI_IO_DEVICE.
779 @param Offset The offset.
780 @param BarLengthValue The bar length value returned.
781 @param OriginalBarValue The original bar value returned.
783 @retval EFI_NOT_FOUND The bar doesn't exist.
784 @retval EFI_SUCCESS The bar exist.
789 IN PCI_IO_DEVICE
*PciIoDevice
,
791 OUT UINT32
*BarLengthValue
,
792 OUT UINT32
*OriginalBarValue
795 EFI_PCI_IO_PROTOCOL
*PciIo
;
796 UINT32 OriginalValue
;
801 // Ensure it is called properly
803 ASSERT (PciIoDevice
->SrIovCapabilityOffset
!= 0);
804 if (PciIoDevice
->SrIovCapabilityOffset
== 0) {
805 return EFI_NOT_FOUND
;
808 PciIo
= &PciIoDevice
->PciIo
;
811 // Preserve the original value
814 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint32
, (UINT32
)Offset
, 1, &OriginalValue
);
817 // Raise TPL to high level to disable timer interrupt while the BAR is probed
819 OldTpl
= gBS
->RaiseTPL (TPL_HIGH_LEVEL
);
821 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, (UINT32
)Offset
, 1, &gAllOne
);
822 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint32
, (UINT32
)Offset
, 1, &Value
);
825 // Write back the original value
827 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, (UINT32
)Offset
, 1, &OriginalValue
);
830 // Restore TPL to its original level
832 gBS
->RestoreTPL (OldTpl
);
834 if (BarLengthValue
!= NULL
) {
835 *BarLengthValue
= Value
;
838 if (OriginalBarValue
!= NULL
) {
839 *OriginalBarValue
= OriginalValue
;
843 return EFI_NOT_FOUND
;
850 Check whether the bar is existed or not.
852 @param PciIoDevice A pointer to the PCI_IO_DEVICE.
853 @param Offset The offset.
854 @param BarLengthValue The bar length value returned.
855 @param OriginalBarValue The original bar value returned.
857 @retval EFI_NOT_FOUND The bar doesn't exist.
858 @retval EFI_SUCCESS The bar exist.
863 IN PCI_IO_DEVICE
*PciIoDevice
,
865 OUT UINT32
*BarLengthValue
,
866 OUT UINT32
*OriginalBarValue
869 EFI_PCI_IO_PROTOCOL
*PciIo
;
870 UINT32 OriginalValue
;
874 PciIo
= &PciIoDevice
->PciIo
;
877 // Preserve the original value
879 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint32
, (UINT8
) Offset
, 1, &OriginalValue
);
882 // Raise TPL to high level to disable timer interrupt while the BAR is probed
884 OldTpl
= gBS
->RaiseTPL (TPL_HIGH_LEVEL
);
886 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, (UINT8
) Offset
, 1, &gAllOne
);
887 PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint32
, (UINT8
) Offset
, 1, &Value
);
890 // Write back the original value
892 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, (UINT8
) Offset
, 1, &OriginalValue
);
895 // Restore TPL to its original level
897 gBS
->RestoreTPL (OldTpl
);
899 if (BarLengthValue
!= NULL
) {
900 *BarLengthValue
= Value
;
903 if (OriginalBarValue
!= NULL
) {
904 *OriginalBarValue
= OriginalValue
;
908 return EFI_NOT_FOUND
;
915 Test whether the device can support given attributes.
917 @param PciIoDevice Pci device instance.
918 @param Command Input command register value, and
919 returned supported register value.
920 @param BridgeControl Input bridge control value for PPB or P2C, and
921 returned supported bridge control value.
922 @param OldCommand Returned and stored old command register offset.
923 @param OldBridgeControl Returned and stored old Bridge control value for PPB or P2C.
927 PciTestSupportedAttribute (
928 IN PCI_IO_DEVICE
*PciIoDevice
,
929 IN OUT UINT16
*Command
,
930 IN OUT UINT16
*BridgeControl
,
931 OUT UINT16
*OldCommand
,
932 OUT UINT16
*OldBridgeControl
939 // Preserve the original value
941 PCI_READ_COMMAND_REGISTER (PciIoDevice
, OldCommand
);
944 // Raise TPL to high level to disable timer interrupt while the BAR is probed
946 OldTpl
= gBS
->RaiseTPL (TPL_HIGH_LEVEL
);
947 CommandValue
= *Command
| *OldCommand
;
949 PCI_SET_COMMAND_REGISTER (PciIoDevice
, CommandValue
);
950 PCI_READ_COMMAND_REGISTER (PciIoDevice
, &CommandValue
);
952 *Command
= *Command
& CommandValue
;
954 // Write back the original value
956 PCI_SET_COMMAND_REGISTER (PciIoDevice
, *OldCommand
);
959 // Restore TPL to its original level
961 gBS
->RestoreTPL (OldTpl
);
963 if (IS_PCI_BRIDGE (&PciIoDevice
->Pci
) || IS_CARDBUS_BRIDGE (&PciIoDevice
->Pci
)) {
966 // Preserve the original value
968 PCI_READ_BRIDGE_CONTROL_REGISTER (PciIoDevice
, OldBridgeControl
);
971 // Raise TPL to high level to disable timer interrupt while the BAR is probed
973 OldTpl
= gBS
->RaiseTPL (TPL_HIGH_LEVEL
);
975 PCI_SET_BRIDGE_CONTROL_REGISTER (PciIoDevice
, *BridgeControl
);
976 PCI_READ_BRIDGE_CONTROL_REGISTER (PciIoDevice
, BridgeControl
);
979 // Write back the original value
981 PCI_SET_BRIDGE_CONTROL_REGISTER (PciIoDevice
, *OldBridgeControl
);
984 // Restore TPL to its original level
986 gBS
->RestoreTPL (OldTpl
);
989 *OldBridgeControl
= 0;
995 Set the supported or current attributes of a PCI device.
997 @param PciIoDevice Structure pointer for PCI device.
998 @param Command Command register value.
999 @param BridgeControl Bridge control value for PPB or P2C.
1000 @param Option Make a choice of EFI_SET_SUPPORTS or EFI_SET_ATTRIBUTES.
1004 PciSetDeviceAttribute (
1005 IN PCI_IO_DEVICE
*PciIoDevice
,
1007 IN UINT16 BridgeControl
,
1015 if ((Command
& EFI_PCI_COMMAND_IO_SPACE
) != 0) {
1016 Attributes
|= EFI_PCI_IO_ATTRIBUTE_IO
;
1019 if ((Command
& EFI_PCI_COMMAND_MEMORY_SPACE
) != 0) {
1020 Attributes
|= EFI_PCI_IO_ATTRIBUTE_MEMORY
;
1023 if ((Command
& EFI_PCI_COMMAND_BUS_MASTER
) != 0) {
1024 Attributes
|= EFI_PCI_IO_ATTRIBUTE_BUS_MASTER
;
1027 if ((Command
& EFI_PCI_COMMAND_VGA_PALETTE_SNOOP
) != 0) {
1028 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_PALETTE_IO
;
1031 if ((BridgeControl
& EFI_PCI_BRIDGE_CONTROL_ISA
) != 0) {
1032 Attributes
|= EFI_PCI_IO_ATTRIBUTE_ISA_IO
;
1035 if ((BridgeControl
& EFI_PCI_BRIDGE_CONTROL_VGA
) != 0) {
1036 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_IO
;
1037 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_MEMORY
;
1038 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_PALETTE_IO
;
1041 if ((BridgeControl
& EFI_PCI_BRIDGE_CONTROL_VGA_16
) != 0) {
1042 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_IO_16
;
1043 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_PALETTE_IO_16
;
1046 if (Option
== EFI_SET_SUPPORTS
) {
1048 Attributes
|= (UINT64
) (EFI_PCI_IO_ATTRIBUTE_MEMORY_WRITE_COMBINE
|
1049 EFI_PCI_IO_ATTRIBUTE_MEMORY_CACHED
|
1050 EFI_PCI_IO_ATTRIBUTE_MEMORY_DISABLE
|
1051 EFI_PCI_IO_ATTRIBUTE_EMBEDDED_DEVICE
|
1052 EFI_PCI_IO_ATTRIBUTE_EMBEDDED_ROM
|
1053 EFI_PCI_IO_ATTRIBUTE_DUAL_ADDRESS_CYCLE
);
1055 if (IS_PCI_LPC (&PciIoDevice
->Pci
)) {
1056 Attributes
|= EFI_PCI_IO_ATTRIBUTE_ISA_MOTHERBOARD_IO
;
1057 Attributes
|= (mReserveIsaAliases
? (UINT64
) EFI_PCI_IO_ATTRIBUTE_ISA_IO
: \
1058 (UINT64
) EFI_PCI_IO_ATTRIBUTE_ISA_IO_16
);
1061 if (IS_PCI_BRIDGE (&PciIoDevice
->Pci
) || IS_CARDBUS_BRIDGE (&PciIoDevice
->Pci
)) {
1063 // For bridge, it should support IDE attributes
1065 Attributes
|= EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO
;
1066 Attributes
|= EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO
;
1068 if (mReserveVgaAliases
) {
1069 Attributes
&= ~(UINT64
)(EFI_PCI_IO_ATTRIBUTE_VGA_IO_16
| \
1070 EFI_PCI_IO_ATTRIBUTE_VGA_PALETTE_IO_16
);
1072 Attributes
&= ~(UINT64
)(EFI_PCI_IO_ATTRIBUTE_VGA_IO
| \
1073 EFI_PCI_IO_ATTRIBUTE_VGA_PALETTE_IO
);
1077 if (IS_PCI_IDE (&PciIoDevice
->Pci
)) {
1078 Attributes
|= EFI_PCI_IO_ATTRIBUTE_IDE_SECONDARY_IO
;
1079 Attributes
|= EFI_PCI_IO_ATTRIBUTE_IDE_PRIMARY_IO
;
1082 if (IS_PCI_VGA (&PciIoDevice
->Pci
)) {
1083 Attributes
|= EFI_PCI_IO_ATTRIBUTE_VGA_MEMORY
;
1084 Attributes
|= (mReserveVgaAliases
? (UINT64
) EFI_PCI_IO_ATTRIBUTE_VGA_IO
: \
1085 (UINT64
) EFI_PCI_IO_ATTRIBUTE_VGA_IO_16
);
1089 PciIoDevice
->Supports
= Attributes
;
1090 PciIoDevice
->Supports
&= ( (PciIoDevice
->Parent
->Supports
) | \
1091 EFI_PCI_IO_ATTRIBUTE_IO
| EFI_PCI_IO_ATTRIBUTE_MEMORY
| \
1092 EFI_PCI_IO_ATTRIBUTE_BUS_MASTER
);
1096 // When this attribute is clear, the RomImage and RomSize fields in the PCI IO were
1097 // initialized based on the PCI option ROM found through the ROM BAR of the PCI controller.
1098 // When this attribute is set, the PCI option ROM described by the RomImage and RomSize
1099 // fields is not from the the ROM BAR of the PCI controller.
1101 if (!PciIoDevice
->EmbeddedRom
) {
1102 Attributes
|= EFI_PCI_IO_ATTRIBUTE_EMBEDDED_ROM
;
1104 PciIoDevice
->Attributes
= Attributes
;
1109 Determine if the device can support Fast Back to Back attribute.
1111 @param PciIoDevice Pci device instance.
1112 @param StatusIndex Status register value.
1114 @retval EFI_SUCCESS This device support Fast Back to Back attribute.
1115 @retval EFI_UNSUPPORTED This device doesn't support Fast Back to Back attribute.
1119 GetFastBackToBackSupport (
1120 IN PCI_IO_DEVICE
*PciIoDevice
,
1121 IN UINT8 StatusIndex
1124 EFI_PCI_IO_PROTOCOL
*PciIo
;
1126 UINT32 StatusRegister
;
1129 // Read the status register
1131 PciIo
= &PciIoDevice
->PciIo
;
1132 Status
= PciIo
->Pci
.Read (PciIo
, EfiPciIoWidthUint16
, StatusIndex
, 1, &StatusRegister
);
1133 if (EFI_ERROR (Status
)) {
1134 return EFI_UNSUPPORTED
;
1138 // Check the Fast B2B bit
1140 if ((StatusRegister
& EFI_PCI_FAST_BACK_TO_BACK_CAPABLE
) != 0) {
1143 return EFI_UNSUPPORTED
;
1148 Process the option ROM for all the children of the specified parent PCI device.
1149 It can only be used after the first full Option ROM process.
1151 @param PciIoDevice Pci device instance.
1155 ProcessOptionRomLight (
1156 IN PCI_IO_DEVICE
*PciIoDevice
1159 PCI_IO_DEVICE
*Temp
;
1160 LIST_ENTRY
*CurrentLink
;
1163 // For RootBridge, PPB , P2C, go recursively to traverse all its children
1165 CurrentLink
= PciIoDevice
->ChildList
.ForwardLink
;
1166 while (CurrentLink
!= NULL
&& CurrentLink
!= &PciIoDevice
->ChildList
) {
1168 Temp
= PCI_IO_DEVICE_FROM_LINK (CurrentLink
);
1170 if (!IsListEmpty (&Temp
->ChildList
)) {
1171 ProcessOptionRomLight (Temp
);
1174 Temp
->AllOpRomProcessed
= PciRomGetImageMapping (Temp
);
1176 CurrentLink
= CurrentLink
->ForwardLink
;
1181 Determine the related attributes of all devices under a Root Bridge.
1183 @param PciIoDevice PCI device instance.
1187 DetermineDeviceAttribute (
1188 IN PCI_IO_DEVICE
*PciIoDevice
1192 UINT16 BridgeControl
;
1194 UINT16 OldBridgeControl
;
1195 BOOLEAN FastB2BSupport
;
1196 PCI_IO_DEVICE
*Temp
;
1197 LIST_ENTRY
*CurrentLink
;
1201 // For Root Bridge, just copy it by RootBridgeIo protocol
1202 // so as to keep consistent with the actual attribute
1204 if (PciIoDevice
->Parent
== NULL
) {
1205 Status
= PciIoDevice
->PciRootBridgeIo
->GetAttributes (
1206 PciIoDevice
->PciRootBridgeIo
,
1207 &PciIoDevice
->Supports
,
1208 &PciIoDevice
->Attributes
1210 if (EFI_ERROR (Status
)) {
1214 // Assume the PCI Root Bridge supports DAC
1216 PciIoDevice
->Supports
|= (UINT64
)(EFI_PCI_IO_ATTRIBUTE_EMBEDDED_DEVICE
|
1217 EFI_PCI_IO_ATTRIBUTE_EMBEDDED_ROM
|
1218 EFI_PCI_IO_ATTRIBUTE_DUAL_ADDRESS_CYCLE
);
1223 // Set the attributes to be checked for common PCI devices and PPB or P2C
1224 // Since some devices only support part of them, it is better to set the
1225 // attribute according to its command or bridge control register
1227 Command
= EFI_PCI_COMMAND_IO_SPACE
|
1228 EFI_PCI_COMMAND_MEMORY_SPACE
|
1229 EFI_PCI_COMMAND_BUS_MASTER
|
1230 EFI_PCI_COMMAND_VGA_PALETTE_SNOOP
;
1232 BridgeControl
= EFI_PCI_BRIDGE_CONTROL_ISA
| EFI_PCI_BRIDGE_CONTROL_VGA
| EFI_PCI_BRIDGE_CONTROL_VGA_16
;
1235 // Test whether the device can support attributes above
1237 PciTestSupportedAttribute (PciIoDevice
, &Command
, &BridgeControl
, &OldCommand
, &OldBridgeControl
);
1240 // Set the supported attributes for specified PCI device
1242 PciSetDeviceAttribute (PciIoDevice
, Command
, BridgeControl
, EFI_SET_SUPPORTS
);
1245 // Set the current attributes for specified PCI device
1247 PciSetDeviceAttribute (PciIoDevice
, OldCommand
, OldBridgeControl
, EFI_SET_ATTRIBUTES
);
1250 // Enable other PCI supported attributes but not defined in PCI_IO_PROTOCOL
1251 // For PCI Express devices, Memory Write and Invalidate is hardwired to 0b so only enable it for PCI devices.
1252 if (!PciIoDevice
->IsPciExp
) {
1253 PCI_ENABLE_COMMAND_REGISTER (PciIoDevice
, EFI_PCI_COMMAND_MEMORY_WRITE_AND_INVALIDATE
);
1257 FastB2BSupport
= TRUE
;
1260 // P2C can not support FB2B on the secondary side
1262 if (IS_CARDBUS_BRIDGE (&PciIoDevice
->Pci
)) {
1263 FastB2BSupport
= FALSE
;
1267 // For RootBridge, PPB , P2C, go recursively to traverse all its children
1269 CurrentLink
= PciIoDevice
->ChildList
.ForwardLink
;
1270 while (CurrentLink
!= NULL
&& CurrentLink
!= &PciIoDevice
->ChildList
) {
1272 Temp
= PCI_IO_DEVICE_FROM_LINK (CurrentLink
);
1273 Status
= DetermineDeviceAttribute (Temp
);
1274 if (EFI_ERROR (Status
)) {
1278 // Detect Fast Back to Back support for the device under the bridge
1280 Status
= GetFastBackToBackSupport (Temp
, PCI_PRIMARY_STATUS_OFFSET
);
1281 if (FastB2BSupport
&& EFI_ERROR (Status
)) {
1282 FastB2BSupport
= FALSE
;
1285 CurrentLink
= CurrentLink
->ForwardLink
;
1288 // Set or clear Fast Back to Back bit for the whole bridge
1290 if (!IsListEmpty (&PciIoDevice
->ChildList
)) {
1292 if (IS_PCI_BRIDGE (&PciIoDevice
->Pci
)) {
1294 Status
= GetFastBackToBackSupport (PciIoDevice
, PCI_BRIDGE_STATUS_REGISTER_OFFSET
);
1296 if (EFI_ERROR (Status
) || (!FastB2BSupport
)) {
1297 FastB2BSupport
= FALSE
;
1298 PCI_DISABLE_BRIDGE_CONTROL_REGISTER (PciIoDevice
, EFI_PCI_BRIDGE_CONTROL_FAST_BACK_TO_BACK
);
1300 PCI_ENABLE_BRIDGE_CONTROL_REGISTER (PciIoDevice
, EFI_PCI_BRIDGE_CONTROL_FAST_BACK_TO_BACK
);
1304 CurrentLink
= PciIoDevice
->ChildList
.ForwardLink
;
1305 while (CurrentLink
!= NULL
&& CurrentLink
!= &PciIoDevice
->ChildList
) {
1306 Temp
= PCI_IO_DEVICE_FROM_LINK (CurrentLink
);
1307 if (FastB2BSupport
) {
1308 PCI_ENABLE_COMMAND_REGISTER (Temp
, EFI_PCI_COMMAND_FAST_BACK_TO_BACK
);
1310 PCI_DISABLE_COMMAND_REGISTER (Temp
, EFI_PCI_COMMAND_FAST_BACK_TO_BACK
);
1313 CurrentLink
= CurrentLink
->ForwardLink
;
1317 // End for IsListEmpty
1323 This routine is used to update the bar information for those incompatible PCI device.
1325 @param PciIoDevice Input Pci device instance. Output Pci device instance with updated
1328 @retval EFI_SUCCESS Successfully updated bar information.
1329 @retval EFI_UNSUPPORTED Given PCI device doesn't belong to incompatible PCI device list.
1334 IN OUT PCI_IO_DEVICE
*PciIoDevice
1340 VOID
*Configuration
;
1341 EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
*Ptr
;
1343 Configuration
= NULL
;
1344 Status
= EFI_SUCCESS
;
1346 if (gIncompatiblePciDeviceSupport
== NULL
) {
1348 // It can only be supported after the Incompatible PCI Device
1349 // Support Protocol has been installed
1351 Status
= gBS
->LocateProtocol (
1352 &gEfiIncompatiblePciDeviceSupportProtocolGuid
,
1354 (VOID
**) &gIncompatiblePciDeviceSupport
1357 if (Status
== EFI_SUCCESS
) {
1359 // Check whether the device belongs to incompatible devices from protocol or not
1360 // If it is , then get its special requirement in the ACPI table
1362 Status
= gIncompatiblePciDeviceSupport
->CheckDevice (
1363 gIncompatiblePciDeviceSupport
,
1364 PciIoDevice
->Pci
.Hdr
.VendorId
,
1365 PciIoDevice
->Pci
.Hdr
.DeviceId
,
1366 PciIoDevice
->Pci
.Hdr
.RevisionID
,
1367 PciIoDevice
->Pci
.Device
.SubsystemVendorID
,
1368 PciIoDevice
->Pci
.Device
.SubsystemID
,
1374 if (EFI_ERROR (Status
) || Configuration
== NULL
) {
1375 return EFI_UNSUPPORTED
;
1379 // Update PCI device information from the ACPI table
1381 Ptr
= (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
*) Configuration
;
1383 while (Ptr
->Desc
!= ACPI_END_TAG_DESCRIPTOR
) {
1385 if (Ptr
->Desc
!= ACPI_ADDRESS_SPACE_DESCRIPTOR
) {
1387 // The format is not support
1392 for (BarIndex
= 0; BarIndex
< PCI_MAX_BAR
; BarIndex
++) {
1393 if ((Ptr
->AddrTranslationOffset
!= MAX_UINT64
) &&
1394 (Ptr
->AddrTranslationOffset
!= MAX_UINT8
) &&
1395 (Ptr
->AddrTranslationOffset
!= BarIndex
)
1398 // Skip updating when AddrTranslationOffset is not MAX_UINT64 or MAX_UINT8 (wide match).
1399 // Skip updating when current BarIndex doesn't equal to AddrTranslationOffset.
1400 // Comparing against MAX_UINT8 is to keep backward compatibility.
1406 switch (Ptr
->ResType
) {
1407 case ACPI_ADDRESS_SPACE_TYPE_MEM
:
1410 // Make sure the bar is memory type
1412 if (CheckBarType (PciIoDevice
, (UINT8
) BarIndex
, PciBarTypeMem
)) {
1416 // Ignored if granularity is 0.
1417 // Ignored if PCI BAR is I/O or 32-bit memory.
1418 // If PCI BAR is 64-bit memory and granularity is 32, then
1419 // the PCI BAR resource is allocated below 4GB.
1420 // If PCI BAR is 64-bit memory and granularity is 64, then
1421 // the PCI BAR resource is allocated above 4GB.
1423 if (PciIoDevice
->PciBar
[BarIndex
].BarType
== PciBarTypeMem64
) {
1424 switch (Ptr
->AddrSpaceGranularity
) {
1426 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeMem32
;
1428 PciIoDevice
->PciBar
[BarIndex
].BarTypeFixed
= TRUE
;
1435 if (PciIoDevice
->PciBar
[BarIndex
].BarType
== PciBarTypePMem64
) {
1436 switch (Ptr
->AddrSpaceGranularity
) {
1438 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypePMem32
;
1440 PciIoDevice
->PciBar
[BarIndex
].BarTypeFixed
= TRUE
;
1449 case ACPI_ADDRESS_SPACE_TYPE_IO
:
1452 // Make sure the bar is IO type
1454 if (CheckBarType (PciIoDevice
, (UINT8
) BarIndex
, PciBarTypeIo
)) {
1463 // Update the new alignment for the device
1465 SetNewAlign (&(PciIoDevice
->PciBar
[BarIndex
].Alignment
), Ptr
->AddrRangeMax
);
1468 // Update the new length for the device
1470 if (Ptr
->AddrLen
!= 0) {
1471 PciIoDevice
->PciBar
[BarIndex
].Length
= Ptr
->AddrLen
;
1479 FreePool (Configuration
);
1485 This routine will update the alignment with the new alignment.
1486 Compare with OLD_ALIGN/EVEN_ALIGN/SQUAD_ALIGN/DQUAD_ALIGN is to keep
1487 backward compatibility.
1489 @param Alignment Input Old alignment. Output updated alignment.
1490 @param NewAlignment New alignment.
1495 IN OUT UINT64
*Alignment
,
1496 IN UINT64 NewAlignment
1499 UINT64 OldAlignment
;
1503 // The new alignment is the same as the original,
1506 if ((NewAlignment
== 0) || (NewAlignment
== OLD_ALIGN
)) {
1510 // Check the validity of the parameter
1512 if (NewAlignment
!= EVEN_ALIGN
&&
1513 NewAlignment
!= SQUAD_ALIGN
&&
1514 NewAlignment
!= DQUAD_ALIGN
) {
1515 *Alignment
= NewAlignment
;
1519 OldAlignment
= (*Alignment
) + 1;
1523 // Get the first non-zero hex value of the length
1525 while ((OldAlignment
& 0x0F) == 0x00) {
1526 OldAlignment
= RShiftU64 (OldAlignment
, 4);
1531 // Adjust the alignment to even, quad or double quad boundary
1533 if (NewAlignment
== EVEN_ALIGN
) {
1534 if ((OldAlignment
& 0x01) != 0) {
1535 OldAlignment
= OldAlignment
+ 2 - (OldAlignment
& 0x01);
1537 } else if (NewAlignment
== SQUAD_ALIGN
) {
1538 if ((OldAlignment
& 0x03) != 0) {
1539 OldAlignment
= OldAlignment
+ 4 - (OldAlignment
& 0x03);
1541 } else if (NewAlignment
== DQUAD_ALIGN
) {
1542 if ((OldAlignment
& 0x07) != 0) {
1543 OldAlignment
= OldAlignment
+ 8 - (OldAlignment
& 0x07);
1548 // Update the old value
1550 NewAlignment
= LShiftU64 (OldAlignment
, ShiftBit
) - 1;
1551 *Alignment
= NewAlignment
;
1557 Parse PCI IOV VF bar information and fill them into PCI device instance.
1559 @param PciIoDevice Pci device instance.
1560 @param Offset Bar offset.
1561 @param BarIndex Bar index.
1563 @return Next bar offset.
1568 IN PCI_IO_DEVICE
*PciIoDevice
,
1574 UINT32 OriginalValue
;
1579 // Ensure it is called properly
1581 ASSERT (PciIoDevice
->SrIovCapabilityOffset
!= 0);
1582 if (PciIoDevice
->SrIovCapabilityOffset
== 0) {
1589 Status
= VfBarExisted (
1596 if (EFI_ERROR (Status
)) {
1597 PciIoDevice
->VfPciBar
[BarIndex
].BaseAddress
= 0;
1598 PciIoDevice
->VfPciBar
[BarIndex
].Length
= 0;
1599 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= 0;
1602 // Scan all the BARs anyway
1604 PciIoDevice
->VfPciBar
[BarIndex
].Offset
= (UINT16
) Offset
;
1608 PciIoDevice
->VfPciBar
[BarIndex
].Offset
= (UINT16
) Offset
;
1609 if ((Value
& 0x01) != 0) {
1611 // Device I/Os. Impossible
1620 PciIoDevice
->VfPciBar
[BarIndex
].BaseAddress
= OriginalValue
& Mask
;
1622 switch (Value
& 0x07) {
1625 //memory space; anywhere in 32 bit address space
1628 if ((Value
& 0x08) != 0) {
1629 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypePMem32
;
1631 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypeMem32
;
1634 PciIoDevice
->VfPciBar
[BarIndex
].Length
= (~(Value
& Mask
)) + 1;
1635 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->VfPciBar
[BarIndex
].Length
- 1;
1640 PciIoDevice
->VfPciBar
[BarIndex
].Length
= MultU64x32 (PciIoDevice
->VfPciBar
[BarIndex
].Length
, PciIoDevice
->InitialVFs
);
1644 if (PciIoDevice
->VfPciBar
[BarIndex
].Alignment
< PciIoDevice
->SystemPageSize
- 1) {
1645 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->SystemPageSize
- 1;
1651 // memory space; anywhere in 64 bit address space
1654 if ((Value
& 0x08) != 0) {
1655 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypePMem64
;
1657 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypeMem64
;
1661 // According to PCI 2.2,if the bar indicates a memory 64 decoding, next bar
1662 // is regarded as an extension for the first bar. As a result
1663 // the sizing will be conducted on combined 64 bit value
1664 // Here just store the masked first 32bit value for future size
1667 PciIoDevice
->VfPciBar
[BarIndex
].Length
= Value
& Mask
;
1668 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->VfPciBar
[BarIndex
].Length
- 1;
1670 if (PciIoDevice
->VfPciBar
[BarIndex
].Alignment
< PciIoDevice
->SystemPageSize
- 1) {
1671 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->SystemPageSize
- 1;
1675 // Increment the offset to point to next DWORD
1679 Status
= VfBarExisted (
1686 if (EFI_ERROR (Status
)) {
1687 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1692 // Fix the length to support some special 64 bit BAR
1694 Value
|= ((UINT32
) -1 << HighBitSet32 (Value
));
1697 // Calculate the size of 64bit bar
1699 PciIoDevice
->VfPciBar
[BarIndex
].BaseAddress
|= LShiftU64 ((UINT64
) OriginalValue
, 32);
1701 PciIoDevice
->VfPciBar
[BarIndex
].Length
= PciIoDevice
->VfPciBar
[BarIndex
].Length
| LShiftU64 ((UINT64
) Value
, 32);
1702 PciIoDevice
->VfPciBar
[BarIndex
].Length
= (~(PciIoDevice
->VfPciBar
[BarIndex
].Length
)) + 1;
1703 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->VfPciBar
[BarIndex
].Length
- 1;
1708 PciIoDevice
->VfPciBar
[BarIndex
].Length
= MultU64x32 (PciIoDevice
->VfPciBar
[BarIndex
].Length
, PciIoDevice
->InitialVFs
);
1712 if (PciIoDevice
->VfPciBar
[BarIndex
].Alignment
< PciIoDevice
->SystemPageSize
- 1) {
1713 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->SystemPageSize
- 1;
1722 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1723 PciIoDevice
->VfPciBar
[BarIndex
].Length
= (~(Value
& Mask
)) + 1;
1724 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->VfPciBar
[BarIndex
].Length
- 1;
1726 if (PciIoDevice
->VfPciBar
[BarIndex
].Alignment
< PciIoDevice
->SystemPageSize
- 1) {
1727 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= PciIoDevice
->SystemPageSize
- 1;
1735 // Check the length again so as to keep compatible with some special bars
1737 if (PciIoDevice
->VfPciBar
[BarIndex
].Length
== 0) {
1738 PciIoDevice
->VfPciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1739 PciIoDevice
->VfPciBar
[BarIndex
].BaseAddress
= 0;
1740 PciIoDevice
->VfPciBar
[BarIndex
].Alignment
= 0;
1744 // Increment number of bar
1750 Parse PCI bar information and fill them into PCI device instance.
1752 @param PciIoDevice Pci device instance.
1753 @param Offset Bar offset.
1754 @param BarIndex Bar index.
1756 @return Next bar offset.
1761 IN PCI_IO_DEVICE
*PciIoDevice
,
1767 UINT32 OriginalValue
;
1774 Status
= BarExisted (
1781 if (EFI_ERROR (Status
)) {
1782 PciIoDevice
->PciBar
[BarIndex
].BaseAddress
= 0;
1783 PciIoDevice
->PciBar
[BarIndex
].Length
= 0;
1784 PciIoDevice
->PciBar
[BarIndex
].Alignment
= 0;
1787 // Some devices don't fully comply to PCI spec 2.2. So be to scan all the BARs anyway
1789 PciIoDevice
->PciBar
[BarIndex
].Offset
= (UINT8
) Offset
;
1793 PciIoDevice
->PciBar
[BarIndex
].BarTypeFixed
= FALSE
;
1794 PciIoDevice
->PciBar
[BarIndex
].Offset
= (UINT8
) Offset
;
1795 if ((Value
& 0x01) != 0) {
1801 if ((Value
& 0xFFFF0000) != 0) {
1805 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeIo32
;
1806 PciIoDevice
->PciBar
[BarIndex
].Length
= ((~(Value
& Mask
)) + 1);
1807 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1813 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeIo16
;
1814 PciIoDevice
->PciBar
[BarIndex
].Length
= 0x0000FFFF & ((~(Value
& Mask
)) + 1);
1815 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1819 // Workaround. Some platforms implement IO bar with 0 length
1820 // Need to treat it as no-bar
1822 if (PciIoDevice
->PciBar
[BarIndex
].Length
== 0) {
1823 PciIoDevice
->PciBar
[BarIndex
].BarType
= (PCI_BAR_TYPE
) 0;
1826 PciIoDevice
->PciBar
[BarIndex
].BaseAddress
= OriginalValue
& Mask
;
1832 PciIoDevice
->PciBar
[BarIndex
].BaseAddress
= OriginalValue
& Mask
;
1834 switch (Value
& 0x07) {
1837 //memory space; anywhere in 32 bit address space
1840 if ((Value
& 0x08) != 0) {
1841 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypePMem32
;
1843 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeMem32
;
1846 PciIoDevice
->PciBar
[BarIndex
].Length
= (~(Value
& Mask
)) + 1;
1847 if (PciIoDevice
->PciBar
[BarIndex
].Length
< (SIZE_4KB
)) {
1849 // Force minimum 4KByte alignment for Virtualization technology for Directed I/O
1851 PciIoDevice
->PciBar
[BarIndex
].Alignment
= (SIZE_4KB
- 1);
1853 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1858 // memory space; anywhere in 64 bit address space
1861 if ((Value
& 0x08) != 0) {
1862 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypePMem64
;
1864 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeMem64
;
1868 // According to PCI 2.2,if the bar indicates a memory 64 decoding, next bar
1869 // is regarded as an extension for the first bar. As a result
1870 // the sizing will be conducted on combined 64 bit value
1871 // Here just store the masked first 32bit value for future size
1874 PciIoDevice
->PciBar
[BarIndex
].Length
= Value
& Mask
;
1875 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1878 // Increment the offset to point to next DWORD
1882 Status
= BarExisted (
1889 if (EFI_ERROR (Status
)) {
1891 // the high 32 bit does not claim any BAR, we need to re-check the low 32 bit BAR again
1893 if (PciIoDevice
->PciBar
[BarIndex
].Length
== 0) {
1895 // some device implement MMIO bar with 0 length, need to treat it as no-bar
1897 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1903 // Fix the length to support some special 64 bit BAR
1906 DEBUG ((EFI_D_INFO
, "[PciBus]BAR probing for upper 32bit of MEM64 BAR returns 0, change to 0xFFFFFFFF.\n"));
1907 Value
= (UINT32
) -1;
1909 Value
|= ((UINT32
)(-1) << HighBitSet32 (Value
));
1913 // Calculate the size of 64bit bar
1915 PciIoDevice
->PciBar
[BarIndex
].BaseAddress
|= LShiftU64 ((UINT64
) OriginalValue
, 32);
1917 PciIoDevice
->PciBar
[BarIndex
].Length
= PciIoDevice
->PciBar
[BarIndex
].Length
| LShiftU64 ((UINT64
) Value
, 32);
1918 PciIoDevice
->PciBar
[BarIndex
].Length
= (~(PciIoDevice
->PciBar
[BarIndex
].Length
)) + 1;
1919 if (PciIoDevice
->PciBar
[BarIndex
].Length
< (SIZE_4KB
)) {
1921 // Force minimum 4KByte alignment for Virtualization technology for Directed I/O
1923 PciIoDevice
->PciBar
[BarIndex
].Alignment
= (SIZE_4KB
- 1);
1925 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1934 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1935 PciIoDevice
->PciBar
[BarIndex
].Length
= (~(Value
& Mask
)) + 1;
1936 if (PciIoDevice
->PciBar
[BarIndex
].Length
< (SIZE_4KB
)) {
1938 // Force minimum 4KByte alignment for Virtualization technology for Directed I/O
1940 PciIoDevice
->PciBar
[BarIndex
].Alignment
= (SIZE_4KB
- 1);
1942 PciIoDevice
->PciBar
[BarIndex
].Alignment
= PciIoDevice
->PciBar
[BarIndex
].Length
- 1;
1949 // Check the length again so as to keep compatible with some special bars
1951 if (PciIoDevice
->PciBar
[BarIndex
].Length
== 0) {
1952 PciIoDevice
->PciBar
[BarIndex
].BarType
= PciBarTypeUnknown
;
1953 PciIoDevice
->PciBar
[BarIndex
].BaseAddress
= 0;
1954 PciIoDevice
->PciBar
[BarIndex
].Alignment
= 0;
1958 // Increment number of bar
1964 This routine is used to initialize the bar of a PCI device.
1966 @param PciIoDevice Pci device instance.
1968 @note It can be called typically when a device is going to be rejected.
1972 InitializePciDevice (
1973 IN PCI_IO_DEVICE
*PciIoDevice
1976 EFI_PCI_IO_PROTOCOL
*PciIo
;
1979 PciIo
= &(PciIoDevice
->PciIo
);
1982 // Put all the resource apertures
1983 // Resource base is set to all ones so as to indicate its resource
1984 // has not been allocated
1986 for (Offset
= 0x10; Offset
<= 0x24; Offset
+= sizeof (UINT32
)) {
1987 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, Offset
, 1, &gAllOne
);
1992 This routine is used to initialize the bar of a PCI-PCI Bridge device.
1994 @param PciIoDevice PCI-PCI bridge device instance.
1999 IN PCI_IO_DEVICE
*PciIoDevice
2002 EFI_PCI_IO_PROTOCOL
*PciIo
;
2004 PciIo
= &(PciIoDevice
->PciIo
);
2007 // Put all the resource apertures including IO16
2008 // Io32, pMem32, pMem64 to quiescent state
2009 // Resource base all ones, Resource limit all zeros
2011 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1C, 1, &gAllOne
);
2012 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x1D, 1, &gAllZero
);
2014 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x20, 1, &gAllOne
);
2015 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x22, 1, &gAllZero
);
2017 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x24, 1, &gAllOne
);
2018 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x26, 1, &gAllZero
);
2020 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x28, 1, &gAllOne
);
2021 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x2C, 1, &gAllZero
);
2024 // Don't support use io32 as for now
2026 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x30, 1, &gAllOne
);
2027 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint16
, 0x32, 1, &gAllZero
);
2030 // Force Interrupt line to zero for cards that come up randomly
2032 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x3C, 1, &gAllZero
);
2036 This routine is used to initialize the bar of a PCI Card Bridge device.
2038 @param PciIoDevice PCI Card bridge device.
2043 IN PCI_IO_DEVICE
*PciIoDevice
2046 EFI_PCI_IO_PROTOCOL
*PciIo
;
2048 PciIo
= &(PciIoDevice
->PciIo
);
2051 // Put all the resource apertures including IO16
2052 // Io32, pMem32, pMem64 to quiescent state(
2053 // Resource base all ones, Resource limit all zeros
2055 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x1c, 1, &gAllOne
);
2056 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x20, 1, &gAllZero
);
2058 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x24, 1, &gAllOne
);
2059 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x28, 1, &gAllZero
);
2061 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x2c, 1, &gAllOne
);
2062 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x30, 1, &gAllZero
);
2064 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x34, 1, &gAllOne
);
2065 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint32
, 0x38, 1, &gAllZero
);
2068 // Force Interrupt line to zero for cards that come up randomly
2070 PciIo
->Pci
.Write (PciIo
, EfiPciIoWidthUint8
, 0x3C, 1, &gAllZero
);
2074 Authenticate the PCI device by using DeviceSecurityProtocol.
2076 @param PciIoDevice PCI device.
2078 @retval EFI_SUCCESS The device passes the authentication.
2079 @return not EFI_SUCCESS The device failes the authentication or
2080 unexpected error happen during authentication.
2083 AuthenticatePciDevice (
2084 IN PCI_IO_DEVICE
*PciIoDevice
2087 EDKII_DEVICE_IDENTIFIER DeviceIdentifier
;
2090 if (mDeviceSecurityProtocol
!= NULL
) {
2092 // Prepare the parameter
2094 DeviceIdentifier
.Version
= EDKII_DEVICE_IDENTIFIER_REVISION
;
2095 CopyGuid (&DeviceIdentifier
.DeviceType
, &gEdkiiDeviceIdentifierTypePciGuid
);
2096 DeviceIdentifier
.DeviceHandle
= NULL
;
2097 Status
= gBS
->InstallMultipleProtocolInterfaces (
2098 &DeviceIdentifier
.DeviceHandle
,
2099 &gEfiDevicePathProtocolGuid
,
2100 PciIoDevice
->DevicePath
,
2101 &gEdkiiDeviceIdentifierTypePciGuid
,
2102 &PciIoDevice
->PciIo
,
2105 if (EFI_ERROR(Status
)) {
2110 // Do DeviceAuthentication
2112 Status
= mDeviceSecurityProtocol
->DeviceAuthenticate (mDeviceSecurityProtocol
, &DeviceIdentifier
);
2114 // Always uninstall, because they are only for Authentication.
2115 // No need to check return Status.
2117 gBS
->UninstallMultipleProtocolInterfaces (
2118 DeviceIdentifier
.DeviceHandle
,
2119 &gEfiDevicePathProtocolGuid
,
2120 PciIoDevice
->DevicePath
,
2121 &gEdkiiDeviceIdentifierTypePciGuid
,
2122 &PciIoDevice
->PciIo
,
2129 // Device Security Protocol is not found, just return success
2135 Create and initialize general PCI I/O device instance for
2136 PCI device/bridge device/hotplug bridge device.
2138 @param Bridge Parent bridge instance.
2139 @param Pci Input Pci information block.
2140 @param Bus Device Bus NO.
2141 @param Device Device device NO.
2142 @param Func Device func NO.
2144 @return Instance of PCI device. NULL means no instance created.
2149 IN PCI_IO_DEVICE
*Bridge
,
2156 PCI_IO_DEVICE
*PciIoDevice
;
2157 EFI_PCI_IO_PROTOCOL
*PciIo
;
2160 PciIoDevice
= AllocateZeroPool (sizeof (PCI_IO_DEVICE
));
2161 if (PciIoDevice
== NULL
) {
2165 PciIoDevice
->Signature
= PCI_IO_DEVICE_SIGNATURE
;
2166 PciIoDevice
->Handle
= NULL
;
2167 PciIoDevice
->PciRootBridgeIo
= Bridge
->PciRootBridgeIo
;
2168 PciIoDevice
->DevicePath
= NULL
;
2169 PciIoDevice
->BusNumber
= Bus
;
2170 PciIoDevice
->DeviceNumber
= Device
;
2171 PciIoDevice
->FunctionNumber
= Func
;
2172 PciIoDevice
->Decodes
= 0;
2174 if (gFullEnumeration
) {
2175 PciIoDevice
->Allocated
= FALSE
;
2177 PciIoDevice
->Allocated
= TRUE
;
2180 PciIoDevice
->Registered
= FALSE
;
2181 PciIoDevice
->Attributes
= 0;
2182 PciIoDevice
->Supports
= 0;
2183 PciIoDevice
->BusOverride
= FALSE
;
2184 PciIoDevice
->AllOpRomProcessed
= FALSE
;
2186 PciIoDevice
->IsPciExp
= FALSE
;
2188 CopyMem (&(PciIoDevice
->Pci
), Pci
, sizeof (PCI_TYPE01
));
2191 // Initialize the PCI I/O instance structure
2193 InitializePciIoInstance (PciIoDevice
);
2194 InitializePciDriverOverrideInstance (PciIoDevice
);
2195 InitializePciLoadFile2 (PciIoDevice
);
2196 PciIo
= &PciIoDevice
->PciIo
;
2199 // Create a device path for this PCI device and store it into its private data
2201 CreatePciDevicePath (
2207 // Detect if PCI Express Device
2209 PciIoDevice
->PciExpressCapabilityOffset
= 0;
2210 Status
= LocateCapabilityRegBlock (
2212 EFI_PCI_CAPABILITY_ID_PCIEXP
,
2213 &PciIoDevice
->PciExpressCapabilityOffset
,
2216 if (!EFI_ERROR (Status
)) {
2217 PciIoDevice
->IsPciExp
= TRUE
;
2221 // Now we can do the authentication check for the device.
2223 Status
= AuthenticatePciDevice (PciIoDevice
);
2225 // If authentication fails, skip this device.
2227 if (EFI_ERROR(Status
)) {
2228 if (PciIoDevice
->DevicePath
!= NULL
) {
2229 FreePool (PciIoDevice
->DevicePath
);
2231 FreePool (PciIoDevice
);
2235 if (PcdGetBool (PcdAriSupport
)) {
2237 // Check if the device is an ARI device.
2239 Status
= LocatePciExpressCapabilityRegBlock (
2241 EFI_PCIE_CAPABILITY_ID_ARI
,
2242 &PciIoDevice
->AriCapabilityOffset
,
2245 if (!EFI_ERROR (Status
)) {
2247 // We need to enable ARI feature before calculate BusReservation,
2248 // because FirstVFOffset and VFStride may change after that.
2250 EFI_PCI_IO_PROTOCOL
*ParentPciIo
;
2254 // Check if its parent supports ARI forwarding.
2256 ParentPciIo
= &Bridge
->PciIo
;
2257 ParentPciIo
->Pci
.Read (
2259 EfiPciIoWidthUint32
,
2260 Bridge
->PciExpressCapabilityOffset
+ EFI_PCIE_CAPABILITY_DEVICE_CAPABILITIES_2_OFFSET
,
2264 if ((Data32
& EFI_PCIE_CAPABILITY_DEVICE_CAPABILITIES_2_ARI_FORWARDING
) != 0) {
2266 // ARI forward support in bridge, so enable it.
2268 ParentPciIo
->Pci
.Read (
2270 EfiPciIoWidthUint32
,
2271 Bridge
->PciExpressCapabilityOffset
+ EFI_PCIE_CAPABILITY_DEVICE_CONTROL_2_OFFSET
,
2275 if ((Data32
& EFI_PCIE_CAPABILITY_DEVICE_CONTROL_2_ARI_FORWARDING
) == 0) {
2276 Data32
|= EFI_PCIE_CAPABILITY_DEVICE_CONTROL_2_ARI_FORWARDING
;
2277 ParentPciIo
->Pci
.Write (
2279 EfiPciIoWidthUint32
,
2280 Bridge
->PciExpressCapabilityOffset
+ EFI_PCIE_CAPABILITY_DEVICE_CONTROL_2_OFFSET
,
2286 " ARI: forwarding enabled for PPB[%02x:%02x:%02x]\n",
2288 Bridge
->DeviceNumber
,
2289 Bridge
->FunctionNumber
2294 DEBUG ((EFI_D_INFO
, " ARI: CapOffset = 0x%x\n", PciIoDevice
->AriCapabilityOffset
));
2299 // Initialization for SR-IOV
2302 if (PcdGetBool (PcdSrIovSupport
)) {
2303 Status
= LocatePciExpressCapabilityRegBlock (
2305 EFI_PCIE_CAPABILITY_ID_SRIOV
,
2306 &PciIoDevice
->SrIovCapabilityOffset
,
2309 if (!EFI_ERROR (Status
)) {
2310 UINT32 SupportedPageSize
;
2312 UINT16 FirstVFOffset
;
2318 // If the SR-IOV device is an ARI device, then Set ARI Capable Hierarchy for the device.
2320 if (PcdGetBool (PcdAriSupport
) && PciIoDevice
->AriCapabilityOffset
!= 0) {
2323 EfiPciIoWidthUint16
,
2324 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_CONTROL
,
2328 Data16
|= EFI_PCIE_CAPABILITY_ID_SRIOV_CONTROL_ARI_HIERARCHY
;
2331 EfiPciIoWidthUint16
,
2332 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_CONTROL
,
2339 // Calculate SystemPageSize
2344 EfiPciIoWidthUint32
,
2345 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_SUPPORTED_PAGE_SIZE
,
2349 PciIoDevice
->SystemPageSize
= (PcdGet32 (PcdSrIovSystemPageSize
) & SupportedPageSize
);
2350 ASSERT (PciIoDevice
->SystemPageSize
!= 0);
2354 EfiPciIoWidthUint32
,
2355 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_SYSTEM_PAGE_SIZE
,
2357 &PciIoDevice
->SystemPageSize
2360 // Adjust SystemPageSize for Alignment usage later
2362 PciIoDevice
->SystemPageSize
<<= 12;
2365 // Calculate BusReservation for PCI IOV
2369 // Read First FirstVFOffset, InitialVFs, and VFStride
2373 EfiPciIoWidthUint16
,
2374 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_FIRSTVF
,
2380 EfiPciIoWidthUint16
,
2381 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_INITIALVFS
,
2383 &PciIoDevice
->InitialVFs
2387 EfiPciIoWidthUint16
,
2388 PciIoDevice
->SrIovCapabilityOffset
+ EFI_PCIE_CAPABILITY_ID_SRIOV_VFSTRIDE
,
2395 PFRid
= EFI_PCI_RID(Bus
, Device
, Func
);
2396 LastVF
= PFRid
+ FirstVFOffset
+ (PciIoDevice
->InitialVFs
- 1) * VFStride
;
2399 // Calculate ReservedBusNum for this PF
2401 PciIoDevice
->ReservedBusNum
= (UINT16
)(EFI_PCI_BUS_OF_RID (LastVF
) - Bus
+ 1);
2405 " SR-IOV: SupportedPageSize = 0x%x; SystemPageSize = 0x%x; FirstVFOffset = 0x%x;\n",
2406 SupportedPageSize
, PciIoDevice
->SystemPageSize
>> 12, FirstVFOffset
2410 " InitialVFs = 0x%x; ReservedBusNum = 0x%x; CapOffset = 0x%x\n",
2411 PciIoDevice
->InitialVFs
, PciIoDevice
->ReservedBusNum
, PciIoDevice
->SrIovCapabilityOffset
2416 if (PcdGetBool (PcdMrIovSupport
)) {
2417 Status
= LocatePciExpressCapabilityRegBlock (
2419 EFI_PCIE_CAPABILITY_ID_MRIOV
,
2420 &PciIoDevice
->MrIovCapabilityOffset
,
2423 if (!EFI_ERROR (Status
)) {
2424 DEBUG ((EFI_D_INFO
, " MR-IOV: CapOffset = 0x%x\n", PciIoDevice
->MrIovCapabilityOffset
));
2428 PciIoDevice
->ResizableBarOffset
= 0;
2429 if (PcdGetBool (PcdPcieResizableBarSupport
)) {
2430 Status
= LocatePciExpressCapabilityRegBlock (
2432 PCI_EXPRESS_EXTENDED_CAPABILITY_RESIZABLE_BAR_ID
,
2433 &PciIoDevice
->ResizableBarOffset
,
2436 if (!EFI_ERROR (Status
)) {
2437 PCI_EXPRESS_EXTENDED_CAPABILITIES_RESIZABLE_BAR_CONTROL ResizableBarControl
;
2439 Offset
= PciIoDevice
->ResizableBarOffset
+ sizeof (PCI_EXPRESS_EXTENDED_CAPABILITIES_HEADER
)
2440 + sizeof (PCI_EXPRESS_EXTENDED_CAPABILITIES_RESIZABLE_BAR_CAPABILITY
),
2445 sizeof (PCI_EXPRESS_EXTENDED_CAPABILITIES_RESIZABLE_BAR_CONTROL
),
2446 &ResizableBarControl
2448 PciIoDevice
->ResizableBarNumber
= ResizableBarControl
.Bits
.ResizableBarNumber
;
2449 PciProgramResizableBar (PciIoDevice
, PciResizableBarMax
);
2454 // Initialize the reserved resource list
2456 InitializeListHead (&PciIoDevice
->ReservedResourceList
);
2459 // Initialize the driver list
2461 InitializeListHead (&PciIoDevice
->OptionRomDriverList
);
2464 // Initialize the child list
2466 InitializeListHead (&PciIoDevice
->ChildList
);
2472 This routine is used to enumerate entire pci bus system
2473 in a given platform.
2475 It is only called on the second start on the same Root Bridge.
2477 @param Controller Parent bridge handler.
2479 @retval EFI_SUCCESS PCI enumeration finished successfully.
2480 @retval other Some error occurred when enumerating the pci bus system.
2484 PciEnumeratorLight (
2485 IN EFI_HANDLE Controller
2490 EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
*PciRootBridgeIo
;
2491 PCI_IO_DEVICE
*RootBridgeDev
;
2494 EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
*Descriptors
;
2497 MaxBus
= PCI_MAX_BUS
;
2501 // If this root bridge has been already enumerated, then return successfully
2503 if (GetRootBridgeByHandle (Controller
) != NULL
) {
2508 // Open pci root bridge io protocol
2510 Status
= gBS
->OpenProtocol (
2512 &gEfiPciRootBridgeIoProtocolGuid
,
2513 (VOID
**) &PciRootBridgeIo
,
2514 gPciBusDriverBinding
.DriverBindingHandle
,
2516 EFI_OPEN_PROTOCOL_BY_DRIVER
2518 if (EFI_ERROR (Status
) && Status
!= EFI_ALREADY_STARTED
) {
2522 Status
= PciRootBridgeIo
->Configuration (PciRootBridgeIo
, (VOID
**) &Descriptors
);
2524 if (EFI_ERROR (Status
)) {
2528 while (PciGetBusRange (&Descriptors
, &MinBus
, &MaxBus
, NULL
) == EFI_SUCCESS
) {
2531 // Create a device node for root bridge device with a NULL host bridge controller handle
2533 RootBridgeDev
= CreateRootBridge (Controller
);
2535 if (RootBridgeDev
== NULL
) {
2541 // Record the root bridge-io protocol
2543 RootBridgeDev
->PciRootBridgeIo
= PciRootBridgeIo
;
2545 Status
= PciPciDeviceInfoCollector (
2550 if (!EFI_ERROR (Status
)) {
2553 // Remove those PCI devices which are rejected when full enumeration
2555 RemoveRejectedPciDevices (RootBridgeDev
->Handle
, RootBridgeDev
);
2558 // Process option rom light
2560 ProcessOptionRomLight (RootBridgeDev
);
2563 // Determine attributes for all devices under this root bridge
2565 DetermineDeviceAttribute (RootBridgeDev
);
2568 // If successfully, insert the node into device pool
2570 InsertRootBridge (RootBridgeDev
);
2574 // If unsuccessfully, destroy the entire node
2576 DestroyRootBridge (RootBridgeDev
);
2586 Get bus range from PCI resource descriptor list.
2588 @param Descriptors A pointer to the address space descriptor.
2589 @param MinBus The min bus returned.
2590 @param MaxBus The max bus returned.
2591 @param BusRange The bus range returned.
2593 @retval EFI_SUCCESS Successfully got bus range.
2594 @retval EFI_NOT_FOUND Can not find the specific bus.
2599 IN EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR
**Descriptors
,
2602 OUT UINT16
*BusRange
2605 while ((*Descriptors
)->Desc
!= ACPI_END_TAG_DESCRIPTOR
) {
2606 if ((*Descriptors
)->ResType
== ACPI_ADDRESS_SPACE_TYPE_BUS
) {
2607 if (MinBus
!= NULL
) {
2608 *MinBus
= (UINT16
) (*Descriptors
)->AddrRangeMin
;
2611 if (MaxBus
!= NULL
) {
2612 *MaxBus
= (UINT16
) (*Descriptors
)->AddrRangeMax
;
2615 if (BusRange
!= NULL
) {
2616 *BusRange
= (UINT16
) (*Descriptors
)->AddrLen
;
2625 return EFI_NOT_FOUND
;
2629 This routine can be used to start the root bridge.
2631 @param RootBridgeDev Pci device instance.
2633 @retval EFI_SUCCESS This device started.
2634 @retval other Failed to get PCI Root Bridge I/O protocol.
2638 StartManagingRootBridge (
2639 IN PCI_IO_DEVICE
*RootBridgeDev
2642 EFI_HANDLE RootBridgeHandle
;
2644 EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
*PciRootBridgeIo
;
2647 // Get the root bridge handle
2649 RootBridgeHandle
= RootBridgeDev
->Handle
;
2650 PciRootBridgeIo
= NULL
;
2653 // Get the pci root bridge io protocol
2655 Status
= gBS
->OpenProtocol (
2657 &gEfiPciRootBridgeIoProtocolGuid
,
2658 (VOID
**) &PciRootBridgeIo
,
2659 gPciBusDriverBinding
.DriverBindingHandle
,
2661 EFI_OPEN_PROTOCOL_BY_DRIVER
2664 if (EFI_ERROR (Status
) && Status
!= EFI_ALREADY_STARTED
) {
2669 // Store the PciRootBridgeIo protocol into root bridge private data
2671 RootBridgeDev
->PciRootBridgeIo
= PciRootBridgeIo
;
2678 This routine can be used to check whether a PCI device should be rejected when light enumeration.
2680 @param PciIoDevice Pci device instance.
2682 @retval TRUE This device should be rejected.
2683 @retval FALSE This device shouldn't be rejected.
2687 IsPciDeviceRejected (
2688 IN PCI_IO_DEVICE
*PciIoDevice
2698 // PPB should be skip!
2700 if (IS_PCI_BRIDGE (&PciIoDevice
->Pci
)) {
2704 if (IS_CARDBUS_BRIDGE (&PciIoDevice
->Pci
)) {
2706 // Only test base registers for P2C
2708 for (BarOffset
= 0x1C; BarOffset
<= 0x38; BarOffset
+= 2 * sizeof (UINT32
)) {
2710 Mask
= (BarOffset
< 0x2C) ? 0xFFFFF000 : 0xFFFFFFFC;
2711 Status
= BarExisted (PciIoDevice
, BarOffset
, &TestValue
, &OldValue
);
2712 if (EFI_ERROR (Status
)) {
2716 TestValue
= TestValue
& Mask
;
2717 if ((TestValue
!= 0) && (TestValue
== (OldValue
& Mask
))) {
2719 // The bar isn't programed, so it should be rejected
2728 for (BarOffset
= 0x14; BarOffset
<= 0x24; BarOffset
+= sizeof (UINT32
)) {
2732 Status
= BarExisted (PciIoDevice
, BarOffset
, &TestValue
, &OldValue
);
2733 if (EFI_ERROR (Status
)) {
2737 if ((TestValue
& 0x01) != 0) {
2743 TestValue
= TestValue
& Mask
;
2744 if ((TestValue
!= 0) && (TestValue
== (OldValue
& Mask
))) {
2754 TestValue
= TestValue
& Mask
;
2756 if ((TestValue
& 0x07) == 0x04) {
2761 BarOffset
+= sizeof (UINT32
);
2762 if ((TestValue
!= 0) && (TestValue
== (OldValue
& Mask
))) {
2765 // Test its high 32-Bit BAR
2767 Status
= BarExisted (PciIoDevice
, BarOffset
, &TestValue
, &OldValue
);
2768 if (TestValue
== OldValue
) {
2778 if ((TestValue
!= 0) && (TestValue
== (OldValue
& Mask
))) {
2789 Reset all bus number from specific bridge.
2791 @param Bridge Parent specific bridge.
2792 @param StartBusNumber Start bus number.
2796 ResetAllPpbBusNumber (
2797 IN PCI_IO_DEVICE
*Bridge
,
2798 IN UINT8 StartBusNumber
2808 EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
*PciRootBridgeIo
;
2810 PciRootBridgeIo
= Bridge
->PciRootBridgeIo
;
2812 for (Device
= 0; Device
<= PCI_MAX_DEVICE
; Device
++) {
2813 for (Func
= 0; Func
<= PCI_MAX_FUNC
; Func
++) {
2816 // Check to see whether a pci device is present
2818 Status
= PciDevicePresent (
2826 if (EFI_ERROR (Status
) && Func
== 0) {
2828 // go to next device if there is no Function 0
2833 if (!EFI_ERROR (Status
) && (IS_PCI_BRIDGE (&Pci
))) {
2836 Address
= EFI_PCI_ADDRESS (StartBusNumber
, Device
, Func
, 0x18);
2837 Status
= PciRootBridgeIo
->Pci
.Read (
2844 SecondaryBus
= (UINT8
)(Register
>> 8);
2846 if (SecondaryBus
!= 0) {
2847 ResetAllPpbBusNumber (Bridge
, SecondaryBus
);
2851 // Reset register 18h, 19h, 1Ah on PCI Bridge
2853 Register
&= 0xFF000000;
2854 Status
= PciRootBridgeIo
->Pci
.Write (
2863 if (Func
== 0 && !IS_PCI_MULTI_FUNC (&Pci
)) {
2865 // Skip sub functions, this is not a multi function device
2867 Func
= PCI_MAX_FUNC
;