| /** @file | |
| PCI Root Bridge Io Protocol code. | |
| Copyright (c) 1999 - 2018, Intel Corporation. All rights reserved.<BR> | |
| SPDX-License-Identifier: BSD-2-Clause-Patent | |
| **/ | |
| #include "PciHostBridge.h" | |
| #include "PciRootBridge.h" | |
| #include "PciHostResource.h" | |
| #define NO_MAPPING (VOID *) (UINTN) -1 | |
| #define RESOURCE_VALID(Resource) ((Resource)->Base <= (Resource)->Limit) | |
| // | |
| // Lookup table for increment values based on transfer widths | |
| // | |
| UINT8 mInStride[] = { | |
| 1, // EfiPciWidthUint8 | |
| 2, // EfiPciWidthUint16 | |
| 4, // EfiPciWidthUint32 | |
| 8, // EfiPciWidthUint64 | |
| 0, // EfiPciWidthFifoUint8 | |
| 0, // EfiPciWidthFifoUint16 | |
| 0, // EfiPciWidthFifoUint32 | |
| 0, // EfiPciWidthFifoUint64 | |
| 1, // EfiPciWidthFillUint8 | |
| 2, // EfiPciWidthFillUint16 | |
| 4, // EfiPciWidthFillUint32 | |
| 8 // EfiPciWidthFillUint64 | |
| }; | |
| // | |
| // Lookup table for increment values based on transfer widths | |
| // | |
| UINT8 mOutStride[] = { | |
| 1, // EfiPciWidthUint8 | |
| 2, // EfiPciWidthUint16 | |
| 4, // EfiPciWidthUint32 | |
| 8, // EfiPciWidthUint64 | |
| 1, // EfiPciWidthFifoUint8 | |
| 2, // EfiPciWidthFifoUint16 | |
| 4, // EfiPciWidthFifoUint32 | |
| 8, // EfiPciWidthFifoUint64 | |
| 0, // EfiPciWidthFillUint8 | |
| 0, // EfiPciWidthFillUint16 | |
| 0, // EfiPciWidthFillUint32 | |
| 0 // EfiPciWidthFillUint64 | |
| }; | |
| /** | |
| Construct the Pci Root Bridge instance. | |
| @param Bridge The root bridge instance. | |
| @return The pointer to PCI_ROOT_BRIDGE_INSTANCE just created | |
| or NULL if creation fails. | |
| **/ | |
| PCI_ROOT_BRIDGE_INSTANCE * | |
| CreateRootBridge ( | |
| IN PCI_ROOT_BRIDGE *Bridge | |
| ) | |
| { | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| PCI_RESOURCE_TYPE Index; | |
| CHAR16 *DevicePathStr; | |
| PCI_ROOT_BRIDGE_APERTURE *Aperture; | |
| DevicePathStr = NULL; | |
| DEBUG ((DEBUG_INFO, "RootBridge: ")); | |
| DEBUG ((DEBUG_INFO, "%s\n", DevicePathStr = ConvertDevicePathToText (Bridge->DevicePath, FALSE, FALSE))); | |
| DEBUG ((DEBUG_INFO, " Support/Attr: %lx / %lx\n", Bridge->Supports, Bridge->Attributes)); | |
| DEBUG ((DEBUG_INFO, " DmaAbove4G: %s\n", Bridge->DmaAbove4G ? L"Yes" : L"No")); | |
| DEBUG ((DEBUG_INFO, "NoExtConfSpace: %s\n", Bridge->NoExtendedConfigSpace ? L"Yes" : L"No")); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " AllocAttr: %lx (%s%s)\n", | |
| Bridge->AllocationAttributes, | |
| (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0 ? L"CombineMemPMem " : L"", | |
| (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) != 0 ? L"Mem64Decode" : L"" | |
| )); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " Bus: %lx - %lx Translation=%lx\n", | |
| Bridge->Bus.Base, | |
| Bridge->Bus.Limit, | |
| Bridge->Bus.Translation | |
| )); | |
| // | |
| // Translation for bus is not supported. | |
| // | |
| ASSERT (Bridge->Bus.Translation == 0); | |
| if (Bridge->Bus.Translation != 0) { | |
| return NULL; | |
| } | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " Io: %lx - %lx Translation=%lx\n", | |
| Bridge->Io.Base, | |
| Bridge->Io.Limit, | |
| Bridge->Io.Translation | |
| )); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " Mem: %lx - %lx Translation=%lx\n", | |
| Bridge->Mem.Base, | |
| Bridge->Mem.Limit, | |
| Bridge->Mem.Translation | |
| )); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " MemAbove4G: %lx - %lx Translation=%lx\n", | |
| Bridge->MemAbove4G.Base, | |
| Bridge->MemAbove4G.Limit, | |
| Bridge->MemAbove4G.Translation | |
| )); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " PMem: %lx - %lx Translation=%lx\n", | |
| Bridge->PMem.Base, | |
| Bridge->PMem.Limit, | |
| Bridge->PMem.Translation | |
| )); | |
| DEBUG (( | |
| DEBUG_INFO, | |
| " PMemAbove4G: %lx - %lx Translation=%lx\n", | |
| Bridge->PMemAbove4G.Base, | |
| Bridge->PMemAbove4G.Limit, | |
| Bridge->PMemAbove4G.Translation | |
| )); | |
| // | |
| // Make sure Mem and MemAbove4G apertures are valid | |
| // | |
| if (RESOURCE_VALID (&Bridge->Mem)) { | |
| ASSERT (Bridge->Mem.Limit < SIZE_4GB); | |
| if (Bridge->Mem.Limit >= SIZE_4GB) { | |
| return NULL; | |
| } | |
| } | |
| if (RESOURCE_VALID (&Bridge->MemAbove4G)) { | |
| ASSERT (Bridge->MemAbove4G.Base >= SIZE_4GB); | |
| if (Bridge->MemAbove4G.Base < SIZE_4GB) { | |
| return NULL; | |
| } | |
| } | |
| if (RESOURCE_VALID (&Bridge->PMem)) { | |
| ASSERT (Bridge->PMem.Limit < SIZE_4GB); | |
| if (Bridge->PMem.Limit >= SIZE_4GB) { | |
| return NULL; | |
| } | |
| } | |
| if (RESOURCE_VALID (&Bridge->PMemAbove4G)) { | |
| ASSERT (Bridge->PMemAbove4G.Base >= SIZE_4GB); | |
| if (Bridge->PMemAbove4G.Base < SIZE_4GB) { | |
| return NULL; | |
| } | |
| } | |
| // | |
| // Ignore AllocationAttributes when resources were already assigned. | |
| // | |
| if (!Bridge->ResourceAssigned) { | |
| if ((Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0) { | |
| // | |
| // If this bit is set, then the PCI Root Bridge does not | |
| // support separate windows for Non-prefetchable and Prefetchable | |
| // memory. | |
| // | |
| ASSERT (!RESOURCE_VALID (&Bridge->PMem)); | |
| ASSERT (!RESOURCE_VALID (&Bridge->PMemAbove4G)); | |
| if (RESOURCE_VALID (&Bridge->PMem) || RESOURCE_VALID (&Bridge->PMemAbove4G)) { | |
| return NULL; | |
| } | |
| } | |
| if ((Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) == 0) { | |
| // | |
| // If this bit is not set, then the PCI Root Bridge does not support | |
| // 64 bit memory windows. | |
| // | |
| ASSERT (!RESOURCE_VALID (&Bridge->MemAbove4G)); | |
| ASSERT (!RESOURCE_VALID (&Bridge->PMemAbove4G)); | |
| if (RESOURCE_VALID (&Bridge->MemAbove4G) || RESOURCE_VALID (&Bridge->PMemAbove4G)) { | |
| return NULL; | |
| } | |
| } | |
| } | |
| RootBridge = AllocateZeroPool (sizeof (PCI_ROOT_BRIDGE_INSTANCE)); | |
| ASSERT (RootBridge != NULL); | |
| RootBridge->Signature = PCI_ROOT_BRIDGE_SIGNATURE; | |
| RootBridge->Supports = Bridge->Supports; | |
| RootBridge->Attributes = Bridge->Attributes; | |
| RootBridge->DmaAbove4G = Bridge->DmaAbove4G; | |
| RootBridge->NoExtendedConfigSpace = Bridge->NoExtendedConfigSpace; | |
| RootBridge->AllocationAttributes = Bridge->AllocationAttributes; | |
| RootBridge->DevicePath = DuplicateDevicePath (Bridge->DevicePath); | |
| RootBridge->DevicePathStr = DevicePathStr; | |
| RootBridge->ConfigBuffer = AllocatePool ( | |
| TypeMax * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR) | |
| ); | |
| ASSERT (RootBridge->ConfigBuffer != NULL); | |
| InitializeListHead (&RootBridge->Maps); | |
| CopyMem (&RootBridge->Bus, &Bridge->Bus, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| CopyMem (&RootBridge->Io, &Bridge->Io, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| CopyMem (&RootBridge->Mem, &Bridge->Mem, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| CopyMem (&RootBridge->MemAbove4G, &Bridge->MemAbove4G, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| CopyMem (&RootBridge->PMem, &Bridge->PMem, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| CopyMem (&RootBridge->PMemAbove4G, &Bridge->PMemAbove4G, sizeof (PCI_ROOT_BRIDGE_APERTURE)); | |
| for (Index = TypeIo; Index < TypeMax; Index++) { | |
| switch (Index) { | |
| case TypeBus: | |
| Aperture = &RootBridge->Bus; | |
| break; | |
| case TypeIo: | |
| Aperture = &RootBridge->Io; | |
| break; | |
| case TypeMem32: | |
| Aperture = &RootBridge->Mem; | |
| break; | |
| case TypeMem64: | |
| Aperture = &RootBridge->MemAbove4G; | |
| break; | |
| case TypePMem32: | |
| Aperture = &RootBridge->PMem; | |
| break; | |
| case TypePMem64: | |
| Aperture = &RootBridge->PMemAbove4G; | |
| break; | |
| default: | |
| ASSERT (FALSE); | |
| Aperture = NULL; | |
| break; | |
| } | |
| RootBridge->ResAllocNode[Index].Type = Index; | |
| if (Bridge->ResourceAssigned && (Aperture->Limit >= Aperture->Base)) { | |
| // | |
| // Base in ResAllocNode is a host address, while Base in Aperture is a | |
| // device address. | |
| // | |
| RootBridge->ResAllocNode[Index].Base = TO_HOST_ADDRESS ( | |
| Aperture->Base, | |
| Aperture->Translation | |
| ); | |
| RootBridge->ResAllocNode[Index].Length = Aperture->Limit - Aperture->Base + 1; | |
| RootBridge->ResAllocNode[Index].Status = ResAllocated; | |
| } else { | |
| RootBridge->ResAllocNode[Index].Base = 0; | |
| RootBridge->ResAllocNode[Index].Length = 0; | |
| RootBridge->ResAllocNode[Index].Status = ResNone; | |
| } | |
| } | |
| RootBridge->RootBridgeIo.SegmentNumber = Bridge->Segment; | |
| RootBridge->RootBridgeIo.PollMem = RootBridgeIoPollMem; | |
| RootBridge->RootBridgeIo.PollIo = RootBridgeIoPollIo; | |
| RootBridge->RootBridgeIo.Mem.Read = RootBridgeIoMemRead; | |
| RootBridge->RootBridgeIo.Mem.Write = RootBridgeIoMemWrite; | |
| RootBridge->RootBridgeIo.Io.Read = RootBridgeIoIoRead; | |
| RootBridge->RootBridgeIo.Io.Write = RootBridgeIoIoWrite; | |
| RootBridge->RootBridgeIo.CopyMem = RootBridgeIoCopyMem; | |
| RootBridge->RootBridgeIo.Pci.Read = RootBridgeIoPciRead; | |
| RootBridge->RootBridgeIo.Pci.Write = RootBridgeIoPciWrite; | |
| RootBridge->RootBridgeIo.Map = RootBridgeIoMap; | |
| RootBridge->RootBridgeIo.Unmap = RootBridgeIoUnmap; | |
| RootBridge->RootBridgeIo.AllocateBuffer = RootBridgeIoAllocateBuffer; | |
| RootBridge->RootBridgeIo.FreeBuffer = RootBridgeIoFreeBuffer; | |
| RootBridge->RootBridgeIo.Flush = RootBridgeIoFlush; | |
| RootBridge->RootBridgeIo.GetAttributes = RootBridgeIoGetAttributes; | |
| RootBridge->RootBridgeIo.SetAttributes = RootBridgeIoSetAttributes; | |
| RootBridge->RootBridgeIo.Configuration = RootBridgeIoConfiguration; | |
| return RootBridge; | |
| } | |
| /** | |
| Check parameters for IO,MMIO,PCI read/write services of PCI Root Bridge IO. | |
| The I/O operations are carried out exactly as requested. The caller is | |
| responsible for satisfying any alignment and I/O width restrictions that a PI | |
| System on a platform might require. For example on some platforms, width | |
| requests of EfiCpuIoWidthUint64 do not work. Misaligned buffers, on the other | |
| hand, will be handled by the driver. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] OperationType I/O operation type: IO/MMIO/PCI. | |
| @param[in] Width Signifies the width of the I/O or Memory operation. | |
| @param[in] Address The base address of the I/O operation. | |
| @param[in] Count The number of I/O operations to perform. The number | |
| of bytes moved is Width size * Count, starting at | |
| Address. | |
| @param[in] Buffer For read operations, the destination buffer to | |
| store the results. For write operations, the source | |
| buffer from which to write data. | |
| @retval EFI_SUCCESS The parameters for this request pass the | |
| checks. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PI system. | |
| @retval EFI_INVALID_PARAMETER Buffer is NULL. | |
| @retval EFI_INVALID_PARAMETER Address or Count is invalid. | |
| @retval EFI_UNSUPPORTED The Buffer is not aligned for the given Width. | |
| @retval EFI_UNSUPPORTED The address range specified by Address, Width, | |
| and Count is not valid for this PI system. | |
| **/ | |
| EFI_STATUS | |
| RootBridgeIoCheckParameter ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN OPERATION_TYPE OperationType, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN VOID *Buffer | |
| ) | |
| { | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS *PciRbAddr; | |
| UINT64 Base; | |
| UINT64 Limit; | |
| UINT32 Size; | |
| UINT64 Length; | |
| // | |
| // Check to see if Buffer is NULL | |
| // | |
| if (Buffer == NULL) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // Check to see if Width is in the valid range | |
| // | |
| if ((UINT32)Width >= EfiPciWidthMaximum) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // For FIFO type, the device address won't increase during the access, | |
| // so treat Count as 1 | |
| // | |
| if ((Width >= EfiPciWidthFifoUint8) && (Width <= EfiPciWidthFifoUint64)) { | |
| Count = 1; | |
| } | |
| Width = (EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH)(Width & 0x03); | |
| Size = 1 << Width; | |
| // | |
| // Make sure (Count * Size) doesn't exceed MAX_UINT64 | |
| // | |
| if (Count > DivU64x32 (MAX_UINT64, Size)) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // Check to see if Address is aligned | |
| // | |
| if ((Address & (Size - 1)) != 0) { | |
| return EFI_UNSUPPORTED; | |
| } | |
| // | |
| // Make sure (Address + Count * Size) doesn't exceed MAX_UINT64 | |
| // | |
| Length = MultU64x32 (Count, Size); | |
| if (Address > MAX_UINT64 - Length) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| // | |
| // Check to see if any address associated with this transfer exceeds the | |
| // maximum allowed address. The maximum address implied by the parameters | |
| // passed in is Address + Size * Count. If the following condition is met, | |
| // then the transfer is not supported. | |
| // | |
| // Address + Size * Count > Limit + 1 | |
| // | |
| // Since Limit can be the maximum integer value supported by the CPU and | |
| // Count can also be the maximum integer value supported by the CPU, this | |
| // range check must be adjusted to avoid all oveflow conditions. | |
| // | |
| if (OperationType == IoOperation) { | |
| // | |
| // Allow Legacy IO access | |
| // | |
| if (Address + Length <= 0x1000) { | |
| if ((RootBridge->Attributes & ( | |
| EFI_PCI_ATTRIBUTE_ISA_IO | EFI_PCI_ATTRIBUTE_VGA_PALETTE_IO | EFI_PCI_ATTRIBUTE_VGA_IO | | |
| EFI_PCI_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_ATTRIBUTE_IDE_SECONDARY_IO | | |
| EFI_PCI_ATTRIBUTE_ISA_IO_16 | EFI_PCI_ATTRIBUTE_VGA_PALETTE_IO_16 | EFI_PCI_ATTRIBUTE_VGA_IO_16)) != 0) | |
| { | |
| return EFI_SUCCESS; | |
| } | |
| } | |
| Base = RootBridge->Io.Base; | |
| Limit = RootBridge->Io.Limit; | |
| } else if (OperationType == MemOperation) { | |
| // | |
| // Allow Legacy MMIO access | |
| // | |
| if ((Address >= 0xA0000) && ((Address + Length) <= 0xC0000)) { | |
| if ((RootBridge->Attributes & EFI_PCI_ATTRIBUTE_VGA_MEMORY) != 0) { | |
| return EFI_SUCCESS; | |
| } | |
| } | |
| // | |
| // By comparing the Address against Limit we know which range to be used | |
| // for checking | |
| // | |
| if ((Address >= RootBridge->Mem.Base) && (Address + Length <= RootBridge->Mem.Limit + 1)) { | |
| Base = RootBridge->Mem.Base; | |
| Limit = RootBridge->Mem.Limit; | |
| } else if ((Address >= RootBridge->PMem.Base) && (Address + Length <= RootBridge->PMem.Limit + 1)) { | |
| Base = RootBridge->PMem.Base; | |
| Limit = RootBridge->PMem.Limit; | |
| } else if ((Address >= RootBridge->MemAbove4G.Base) && (Address + Length <= RootBridge->MemAbove4G.Limit + 1)) { | |
| Base = RootBridge->MemAbove4G.Base; | |
| Limit = RootBridge->MemAbove4G.Limit; | |
| } else { | |
| Base = RootBridge->PMemAbove4G.Base; | |
| Limit = RootBridge->PMemAbove4G.Limit; | |
| } | |
| } else { | |
| PciRbAddr = (EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS *)&Address; | |
| if ((PciRbAddr->Bus < RootBridge->Bus.Base) || | |
| (PciRbAddr->Bus > RootBridge->Bus.Limit)) | |
| { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if ((PciRbAddr->Device > PCI_MAX_DEVICE) || | |
| (PciRbAddr->Function > PCI_MAX_FUNC)) | |
| { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if (PciRbAddr->ExtendedRegister != 0) { | |
| Address = PciRbAddr->ExtendedRegister; | |
| } else { | |
| Address = PciRbAddr->Register; | |
| } | |
| Base = 0; | |
| Limit = RootBridge->NoExtendedConfigSpace ? 0xFF : 0xFFF; | |
| } | |
| if (Address < Base) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if (Address + Length > Limit + 1) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Use address to match apertures of memory type and then get the corresponding | |
| translation. | |
| @param RootBridge The root bridge instance. | |
| @param Address The address used to match aperture. | |
| @param Translation Pointer containing the output translation. | |
| @return EFI_SUCCESS Get translation successfully. | |
| @return EFI_INVALID_PARAMETER No matched memory aperture; the input Address | |
| must be invalid. | |
| **/ | |
| EFI_STATUS | |
| RootBridgeIoGetMemTranslationByAddress ( | |
| IN PCI_ROOT_BRIDGE_INSTANCE *RootBridge, | |
| IN UINT64 Address, | |
| IN OUT UINT64 *Translation | |
| ) | |
| { | |
| if ((Address >= RootBridge->Mem.Base) && (Address <= RootBridge->Mem.Limit)) { | |
| *Translation = RootBridge->Mem.Translation; | |
| } else if ((Address >= RootBridge->PMem.Base) && (Address <= RootBridge->PMem.Limit)) { | |
| *Translation = RootBridge->PMem.Translation; | |
| } else if ((Address >= RootBridge->MemAbove4G.Base) && (Address <= RootBridge->MemAbove4G.Limit)) { | |
| *Translation = RootBridge->MemAbove4G.Translation; | |
| } else if ((Address >= RootBridge->PMemAbove4G.Base) && (Address <= RootBridge->PMemAbove4G.Limit)) { | |
| *Translation = RootBridge->PMemAbove4G.Translation; | |
| } else { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Return the result of (Multiplicand * Multiplier / Divisor). | |
| @param Multiplicand A 64-bit unsigned value. | |
| @param Multiplier A 64-bit unsigned value. | |
| @param Divisor A 32-bit unsigned value. | |
| @param Remainder A pointer to a 32-bit unsigned value. This parameter is | |
| optional and may be NULL. | |
| @return Multiplicand * Multiplier / Divisor. | |
| **/ | |
| UINT64 | |
| MultThenDivU64x64x32 ( | |
| IN UINT64 Multiplicand, | |
| IN UINT64 Multiplier, | |
| IN UINT32 Divisor, | |
| OUT UINT32 *Remainder OPTIONAL | |
| ) | |
| { | |
| UINT64 Uint64; | |
| UINT32 LocalRemainder; | |
| UINT32 Uint32; | |
| if (Multiplicand > DivU64x64Remainder (MAX_UINT64, Multiplier, NULL)) { | |
| // | |
| // Make sure Multiplicand is the bigger one. | |
| // | |
| if (Multiplicand < Multiplier) { | |
| Uint64 = Multiplicand; | |
| Multiplicand = Multiplier; | |
| Multiplier = Uint64; | |
| } | |
| // | |
| // Because Multiplicand * Multiplier overflows, | |
| // Multiplicand * Multiplier / Divisor | |
| // = (2 * Multiplicand' + 1) * Multiplier / Divisor | |
| // = 2 * (Multiplicand' * Multiplier / Divisor) + Multiplier / Divisor | |
| // | |
| Uint64 = MultThenDivU64x64x32 (RShiftU64 (Multiplicand, 1), Multiplier, Divisor, &LocalRemainder); | |
| Uint64 = LShiftU64 (Uint64, 1); | |
| Uint32 = 0; | |
| if ((Multiplicand & 0x1) == 1) { | |
| Uint64 += DivU64x32Remainder (Multiplier, Divisor, &Uint32); | |
| } | |
| return Uint64 + DivU64x32Remainder (Uint32 + LShiftU64 (LocalRemainder, 1), Divisor, Remainder); | |
| } else { | |
| return DivU64x32Remainder (MultU64x64 (Multiplicand, Multiplier), Divisor, Remainder); | |
| } | |
| } | |
| /** | |
| Return the elapsed tick count from CurrentTick. | |
| @param CurrentTick On input, the previous tick count. | |
| On output, the current tick count. | |
| @param StartTick The value the performance counter starts with when it | |
| rolls over. | |
| @param EndTick The value that the performance counter ends with before | |
| it rolls over. | |
| @return The elapsed tick count from CurrentTick. | |
| **/ | |
| UINT64 | |
| GetElapsedTick ( | |
| UINT64 *CurrentTick, | |
| UINT64 StartTick, | |
| UINT64 EndTick | |
| ) | |
| { | |
| UINT64 PreviousTick; | |
| PreviousTick = *CurrentTick; | |
| *CurrentTick = GetPerformanceCounter (); | |
| if (StartTick < EndTick) { | |
| return *CurrentTick - PreviousTick; | |
| } else { | |
| return PreviousTick - *CurrentTick; | |
| } | |
| } | |
| /** | |
| Polls an address in memory mapped I/O space until an exit condition is met, | |
| or a timeout occurs. | |
| This function provides a standard way to poll a PCI memory location. A PCI | |
| memory read operation is performed at the PCI memory address specified by | |
| Address for the width specified by Width. The result of this PCI memory read | |
| operation is stored in Result. This PCI memory read operation is repeated | |
| until either a timeout of Delay 100 ns units has expired, or (Result & Mask) | |
| is equal to Value. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the memory operations. | |
| @param[in] Address The base address of the memory operations. The caller | |
| is responsible for aligning Address if required. | |
| @param[in] Mask Mask used for the polling criteria. Bytes above Width | |
| in Mask are ignored. The bits in the bytes below Width | |
| which are zero in Mask are ignored when polling the | |
| memory address. | |
| @param[in] Value The comparison value used for the polling exit | |
| criteria. | |
| @param[in] Delay The number of 100 ns units to poll. Note that timer | |
| available may be of poorer granularity. | |
| @param[out] Result Pointer to the last value read from the memory | |
| location. | |
| @retval EFI_SUCCESS The last data returned from the access matched | |
| the poll exit criteria. | |
| @retval EFI_INVALID_PARAMETER Width is invalid. | |
| @retval EFI_INVALID_PARAMETER Result is NULL. | |
| @retval EFI_TIMEOUT Delay expired before a match occurred. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoPollMem ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINT64 Mask, | |
| IN UINT64 Value, | |
| IN UINT64 Delay, | |
| OUT UINT64 *Result | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| UINT64 NumberOfTicks; | |
| UINT32 Remainder; | |
| UINT64 StartTick; | |
| UINT64 EndTick; | |
| UINT64 CurrentTick; | |
| UINT64 ElapsedTick; | |
| UINT64 Frequency; | |
| if (Result == NULL) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if ((UINT32)Width > EfiPciWidthUint64) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // No matter what, always do a single poll. | |
| // | |
| Status = This->Mem.Read (This, Width, Address, 1, Result); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| if ((*Result & Mask) == Value) { | |
| return EFI_SUCCESS; | |
| } | |
| if (Delay == 0) { | |
| return EFI_SUCCESS; | |
| } else { | |
| // | |
| // NumberOfTicks = Frenquency * Delay / EFI_TIMER_PERIOD_SECONDS(1) | |
| // | |
| Frequency = GetPerformanceCounterProperties (&StartTick, &EndTick); | |
| NumberOfTicks = MultThenDivU64x64x32 (Frequency, Delay, (UINT32)EFI_TIMER_PERIOD_SECONDS (1), &Remainder); | |
| if (Remainder >= (UINTN)EFI_TIMER_PERIOD_SECONDS (1) / 2) { | |
| NumberOfTicks++; | |
| } | |
| for ( ElapsedTick = 0, CurrentTick = GetPerformanceCounter () | |
| ; ElapsedTick <= NumberOfTicks | |
| ; ElapsedTick += GetElapsedTick (&CurrentTick, StartTick, EndTick) | |
| ) | |
| { | |
| Status = This->Mem.Read (This, Width, Address, 1, Result); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| if ((*Result & Mask) == Value) { | |
| return EFI_SUCCESS; | |
| } | |
| } | |
| } | |
| return EFI_TIMEOUT; | |
| } | |
| /** | |
| Reads from the I/O space of a PCI Root Bridge. Returns when either the | |
| polling exit criteria is satisfied or after a defined duration. | |
| This function provides a standard way to poll a PCI I/O location. A PCI I/O | |
| read operation is performed at the PCI I/O address specified by Address for | |
| the width specified by Width. | |
| The result of this PCI I/O read operation is stored in Result. This PCI I/O | |
| read operation is repeated until either a timeout of Delay 100 ns units has | |
| expired, or (Result & Mask) is equal to Value. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the I/O operations. | |
| @param[in] Address The base address of the I/O operations. The caller is | |
| responsible for aligning Address if required. | |
| @param[in] Mask Mask used for the polling criteria. Bytes above Width in | |
| Mask are ignored. The bits in the bytes below Width | |
| which are zero in Mask are ignored when polling the I/O | |
| address. | |
| @param[in] Value The comparison value used for the polling exit criteria. | |
| @param[in] Delay The number of 100 ns units to poll. Note that timer | |
| available may be of poorer granularity. | |
| @param[out] Result Pointer to the last value read from the memory location. | |
| @retval EFI_SUCCESS The last data returned from the access matched | |
| the poll exit criteria. | |
| @retval EFI_INVALID_PARAMETER Width is invalid. | |
| @retval EFI_INVALID_PARAMETER Result is NULL. | |
| @retval EFI_TIMEOUT Delay expired before a match occurred. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoPollIo ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINT64 Mask, | |
| IN UINT64 Value, | |
| IN UINT64 Delay, | |
| OUT UINT64 *Result | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| UINT64 NumberOfTicks; | |
| UINT32 Remainder; | |
| UINT64 StartTick; | |
| UINT64 EndTick; | |
| UINT64 CurrentTick; | |
| UINT64 ElapsedTick; | |
| UINT64 Frequency; | |
| // | |
| // No matter what, always do a single poll. | |
| // | |
| if (Result == NULL) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if ((UINT32)Width > EfiPciWidthUint64) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| Status = This->Io.Read (This, Width, Address, 1, Result); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| if ((*Result & Mask) == Value) { | |
| return EFI_SUCCESS; | |
| } | |
| if (Delay == 0) { | |
| return EFI_SUCCESS; | |
| } else { | |
| // | |
| // NumberOfTicks = Frenquency * Delay / EFI_TIMER_PERIOD_SECONDS(1) | |
| // | |
| Frequency = GetPerformanceCounterProperties (&StartTick, &EndTick); | |
| NumberOfTicks = MultThenDivU64x64x32 (Frequency, Delay, (UINT32)EFI_TIMER_PERIOD_SECONDS (1), &Remainder); | |
| if (Remainder >= (UINTN)EFI_TIMER_PERIOD_SECONDS (1) / 2) { | |
| NumberOfTicks++; | |
| } | |
| for ( ElapsedTick = 0, CurrentTick = GetPerformanceCounter () | |
| ; ElapsedTick <= NumberOfTicks | |
| ; ElapsedTick += GetElapsedTick (&CurrentTick, StartTick, EndTick) | |
| ) | |
| { | |
| Status = This->Io.Read (This, Width, Address, 1, Result); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| if ((*Result & Mask) == Value) { | |
| return EFI_SUCCESS; | |
| } | |
| } | |
| } | |
| return EFI_TIMEOUT; | |
| } | |
| /** | |
| Enables a PCI driver to access PCI controller registers in the PCI root | |
| bridge memory space. | |
| The Mem.Read(), and Mem.Write() functions enable a driver to access PCI | |
| controller registers in the PCI root bridge memory space. | |
| The memory operations are carried out exactly as requested. The caller is | |
| responsible for satisfying any alignment and memory width restrictions that a | |
| PCI Root Bridge on a platform might require. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the memory operation. | |
| @param[in] Address The base address of the memory operation. The caller | |
| is responsible for aligning the Address if required. | |
| @param[in] Count The number of memory operations to perform. Bytes | |
| moved is Width size * Count, starting at Address. | |
| @param[out] Buffer For read operations, the destination buffer to store | |
| the results. For write operations, the source buffer | |
| to write data from. | |
| @retval EFI_SUCCESS The data was read from or written to the PCI | |
| root bridge. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Buffer is NULL. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoMemRead ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| OUT VOID *Buffer | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| UINT64 Translation; | |
| Status = RootBridgeIoCheckParameter ( | |
| This, | |
| MemOperation, | |
| Width, | |
| Address, | |
| Count, | |
| Buffer | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| Status = RootBridgeIoGetMemTranslationByAddress (RootBridge, Address, &Translation); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| // Address passed to CpuIo->Mem.Read needs to be a host address instead of | |
| // device address. | |
| return mCpuIo->Mem.Read ( | |
| mCpuIo, | |
| (EFI_CPU_IO_PROTOCOL_WIDTH)Width, | |
| TO_HOST_ADDRESS (Address, Translation), | |
| Count, | |
| Buffer | |
| ); | |
| } | |
| /** | |
| Enables a PCI driver to access PCI controller registers in the PCI root | |
| bridge memory space. | |
| The Mem.Read(), and Mem.Write() functions enable a driver to access PCI | |
| controller registers in the PCI root bridge memory space. | |
| The memory operations are carried out exactly as requested. The caller is | |
| responsible for satisfying any alignment and memory width restrictions that a | |
| PCI Root Bridge on a platform might require. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the memory operation. | |
| @param[in] Address The base address of the memory operation. The caller | |
| is responsible for aligning the Address if required. | |
| @param[in] Count The number of memory operations to perform. Bytes | |
| moved is Width size * Count, starting at Address. | |
| @param[in] Buffer For read operations, the destination buffer to store | |
| the results. For write operations, the source buffer | |
| to write data from. | |
| @retval EFI_SUCCESS The data was read from or written to the PCI | |
| root bridge. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Buffer is NULL. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoMemWrite ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN VOID *Buffer | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| UINT64 Translation; | |
| Status = RootBridgeIoCheckParameter ( | |
| This, | |
| MemOperation, | |
| Width, | |
| Address, | |
| Count, | |
| Buffer | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| Status = RootBridgeIoGetMemTranslationByAddress (RootBridge, Address, &Translation); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| // Address passed to CpuIo->Mem.Write needs to be a host address instead of | |
| // device address. | |
| return mCpuIo->Mem.Write ( | |
| mCpuIo, | |
| (EFI_CPU_IO_PROTOCOL_WIDTH)Width, | |
| TO_HOST_ADDRESS (Address, Translation), | |
| Count, | |
| Buffer | |
| ); | |
| } | |
| /** | |
| Enables a PCI driver to access PCI controller registers in the PCI root | |
| bridge I/O space. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the memory operations. | |
| @param[in] Address The base address of the I/O operation. The caller is | |
| responsible for aligning the Address if required. | |
| @param[in] Count The number of I/O operations to perform. Bytes moved | |
| is Width size * Count, starting at Address. | |
| @param[out] Buffer For read operations, the destination buffer to store | |
| the results. For write operations, the source buffer | |
| to write data from. | |
| @retval EFI_SUCCESS The data was read from or written to the PCI | |
| root bridge. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Buffer is NULL. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoIoRead ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| OUT VOID *Buffer | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| Status = RootBridgeIoCheckParameter ( | |
| This, | |
| IoOperation, | |
| Width, | |
| Address, | |
| Count, | |
| Buffer | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| // Address passed to CpuIo->Io.Read needs to be a host address instead of | |
| // device address. | |
| return mCpuIo->Io.Read ( | |
| mCpuIo, | |
| (EFI_CPU_IO_PROTOCOL_WIDTH)Width, | |
| TO_HOST_ADDRESS (Address, RootBridge->Io.Translation), | |
| Count, | |
| Buffer | |
| ); | |
| } | |
| /** | |
| Enables a PCI driver to access PCI controller registers in the PCI root | |
| bridge I/O space. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Width Signifies the width of the memory operations. | |
| @param[in] Address The base address of the I/O operation. The caller is | |
| responsible for aligning the Address if required. | |
| @param[in] Count The number of I/O operations to perform. Bytes moved | |
| is Width size * Count, starting at Address. | |
| @param[in] Buffer For read operations, the destination buffer to store | |
| the results. For write operations, the source buffer | |
| to write data from. | |
| @retval EFI_SUCCESS The data was read from or written to the PCI | |
| root bridge. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Buffer is NULL. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoIoWrite ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN VOID *Buffer | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| Status = RootBridgeIoCheckParameter ( | |
| This, | |
| IoOperation, | |
| Width, | |
| Address, | |
| Count, | |
| Buffer | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| // Address passed to CpuIo->Io.Write needs to be a host address instead of | |
| // device address. | |
| return mCpuIo->Io.Write ( | |
| mCpuIo, | |
| (EFI_CPU_IO_PROTOCOL_WIDTH)Width, | |
| TO_HOST_ADDRESS (Address, RootBridge->Io.Translation), | |
| Count, | |
| Buffer | |
| ); | |
| } | |
| /** | |
| Enables a PCI driver to copy one region of PCI root bridge memory space to | |
| another region of PCI root bridge memory space. | |
| The CopyMem() function enables a PCI driver to copy one region of PCI root | |
| bridge memory space to another region of PCI root bridge memory space. This | |
| is especially useful for video scroll operation on a memory mapped video | |
| buffer. | |
| The memory operations are carried out exactly as requested. The caller is | |
| responsible for satisfying any alignment and memory width restrictions that a | |
| PCI root bridge on a platform might require. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL | |
| instance. | |
| @param[in] Width Signifies the width of the memory operations. | |
| @param[in] DestAddress The destination address of the memory operation. The | |
| caller is responsible for aligning the DestAddress if | |
| required. | |
| @param[in] SrcAddress The source address of the memory operation. The caller | |
| is responsible for aligning the SrcAddress if | |
| required. | |
| @param[in] Count The number of memory operations to perform. Bytes | |
| moved is Width size * Count, starting at DestAddress | |
| and SrcAddress. | |
| @retval EFI_SUCCESS The data was copied from one memory region | |
| to another memory region. | |
| @retval EFI_INVALID_PARAMETER Width is invalid for this PCI root bridge. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to a | |
| lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoCopyMem ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 DestAddress, | |
| IN UINT64 SrcAddress, | |
| IN UINTN Count | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| BOOLEAN Forward; | |
| UINTN Stride; | |
| UINTN Index; | |
| UINT64 Result; | |
| if ((UINT32)Width > EfiPciWidthUint64) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| if (DestAddress == SrcAddress) { | |
| return EFI_SUCCESS; | |
| } | |
| Stride = (UINTN)(1 << Width); | |
| Forward = TRUE; | |
| if ((DestAddress > SrcAddress) && | |
| (DestAddress < (SrcAddress + Count * Stride))) | |
| { | |
| Forward = FALSE; | |
| SrcAddress = SrcAddress + (Count - 1) * Stride; | |
| DestAddress = DestAddress + (Count - 1) * Stride; | |
| } | |
| for (Index = 0; Index < Count; Index++) { | |
| Status = RootBridgeIoMemRead ( | |
| This, | |
| Width, | |
| SrcAddress, | |
| 1, | |
| &Result | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| Status = RootBridgeIoMemWrite ( | |
| This, | |
| Width, | |
| DestAddress, | |
| 1, | |
| &Result | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| if (Forward) { | |
| SrcAddress += Stride; | |
| DestAddress += Stride; | |
| } else { | |
| SrcAddress -= Stride; | |
| DestAddress -= Stride; | |
| } | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| PCI configuration space access. | |
| @param This A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL | |
| @param Read TRUE indicating it's a read operation. | |
| @param Width Signifies the width of the memory operation. | |
| @param Address The address within the PCI configuration space | |
| for the PCI controller. | |
| @param Count The number of PCI configuration operations | |
| to perform. | |
| @param Buffer The destination buffer to store the results. | |
| @retval EFI_SUCCESS The data was read/written from/to the PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Invalid parameters found. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoPciAccess ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN BOOLEAN Read, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN OUT VOID *Buffer | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS PciAddress; | |
| UINT8 *Uint8Buffer; | |
| UINT8 InStride; | |
| UINT8 OutStride; | |
| UINTN Size; | |
| Status = RootBridgeIoCheckParameter (This, PciOperation, Width, Address, Count, Buffer); | |
| if (EFI_ERROR (Status)) { | |
| return Status; | |
| } | |
| // | |
| // Read Pci configuration space | |
| // | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| CopyMem (&PciAddress, &Address, sizeof (PciAddress)); | |
| if (PciAddress.ExtendedRegister == 0) { | |
| PciAddress.ExtendedRegister = PciAddress.Register; | |
| } | |
| Address = PCI_SEGMENT_LIB_ADDRESS ( | |
| RootBridge->RootBridgeIo.SegmentNumber, | |
| PciAddress.Bus, | |
| PciAddress.Device, | |
| PciAddress.Function, | |
| PciAddress.ExtendedRegister | |
| ); | |
| // | |
| // Select loop based on the width of the transfer | |
| // | |
| InStride = mInStride[Width]; | |
| OutStride = mOutStride[Width]; | |
| Size = (UINTN)(1 << (Width & 0x03)); | |
| for (Uint8Buffer = Buffer; Count > 0; Address += InStride, Uint8Buffer += OutStride, Count--) { | |
| if (Read) { | |
| PciSegmentReadBuffer (Address, Size, Uint8Buffer); | |
| } else { | |
| PciSegmentWriteBuffer (Address, Size, Uint8Buffer); | |
| } | |
| } | |
| // | |
| // If the access was a PCI write, it might have side effects that impact how | |
| // the PCI device decodes its MMIO regions. Issue a barrier to ensure that | |
| // subsequent MMIO accesses to those regions will not be reordered, and will | |
| // not arrive before the PCI write. | |
| // | |
| if (!Read) { | |
| MemoryFence (); | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Allows read from PCI configuration space. | |
| @param This A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL | |
| @param Width Signifies the width of the memory operation. | |
| @param Address The address within the PCI configuration space | |
| for the PCI controller. | |
| @param Count The number of PCI configuration operations | |
| to perform. | |
| @param Buffer The destination buffer to store the results. | |
| @retval EFI_SUCCESS The data was read from the PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Invalid parameters found. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoPciRead ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN OUT VOID *Buffer | |
| ) | |
| { | |
| return RootBridgeIoPciAccess (This, TRUE, Width, Address, Count, Buffer); | |
| } | |
| /** | |
| Allows write to PCI configuration space. | |
| @param This A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL | |
| @param Width Signifies the width of the memory operation. | |
| @param Address The address within the PCI configuration space | |
| for the PCI controller. | |
| @param Count The number of PCI configuration operations | |
| to perform. | |
| @param Buffer The source buffer to get the results. | |
| @retval EFI_SUCCESS The data was written to the PCI root bridge. | |
| @retval EFI_INVALID_PARAMETER Invalid parameters found. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoPciWrite ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width, | |
| IN UINT64 Address, | |
| IN UINTN Count, | |
| IN OUT VOID *Buffer | |
| ) | |
| { | |
| return RootBridgeIoPciAccess (This, FALSE, Width, Address, Count, Buffer); | |
| } | |
| /** | |
| Provides the PCI controller-specific address needed to access | |
| system memory for DMA. | |
| @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param Operation Indicate if the bus master is going to read or write | |
| to system memory. | |
| @param HostAddress The system memory address to map on the PCI controller. | |
| @param NumberOfBytes On input the number of bytes to map. | |
| On output the number of bytes that were mapped. | |
| @param DeviceAddress The resulting map address for the bus master PCI | |
| controller to use to access the system memory's HostAddress. | |
| @param Mapping The value to pass to Unmap() when the bus master DMA | |
| operation is complete. | |
| @retval EFI_SUCCESS Success. | |
| @retval EFI_INVALID_PARAMETER Invalid parameters found. | |
| @retval EFI_UNSUPPORTED The HostAddress cannot be mapped as a common buffer. | |
| @retval EFI_DEVICE_ERROR The System hardware could not map the requested address. | |
| @retval EFI_OUT_OF_RESOURCES The request could not be completed due to lack of resources. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoMap ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_OPERATION Operation, | |
| IN VOID *HostAddress, | |
| IN OUT UINTN *NumberOfBytes, | |
| OUT EFI_PHYSICAL_ADDRESS *DeviceAddress, | |
| OUT VOID **Mapping | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| EFI_PHYSICAL_ADDRESS PhysicalAddress; | |
| MAP_INFO *MapInfo; | |
| if ((HostAddress == NULL) || (NumberOfBytes == NULL) || (DeviceAddress == NULL) || | |
| (Mapping == NULL)) | |
| { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // Make sure that Operation is valid | |
| // | |
| if ((UINT32)Operation >= EfiPciOperationMaximum) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| if (mIoMmu != NULL) { | |
| if (!RootBridge->DmaAbove4G) { | |
| // | |
| // Clear 64bit support | |
| // | |
| if (Operation > EfiPciOperationBusMasterCommonBuffer) { | |
| Operation = (EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_OPERATION)(Operation - EfiPciOperationBusMasterRead64); | |
| } | |
| } | |
| Status = mIoMmu->Map ( | |
| mIoMmu, | |
| (EDKII_IOMMU_OPERATION)Operation, | |
| HostAddress, | |
| NumberOfBytes, | |
| DeviceAddress, | |
| Mapping | |
| ); | |
| return Status; | |
| } | |
| PhysicalAddress = (EFI_PHYSICAL_ADDRESS)(UINTN)HostAddress; | |
| if ((!RootBridge->DmaAbove4G || | |
| ((Operation != EfiPciOperationBusMasterRead64) && | |
| (Operation != EfiPciOperationBusMasterWrite64) && | |
| (Operation != EfiPciOperationBusMasterCommonBuffer64))) && | |
| ((PhysicalAddress + *NumberOfBytes) > SIZE_4GB)) | |
| { | |
| // | |
| // If the root bridge or the device cannot handle performing DMA above | |
| // 4GB but any part of the DMA transfer being mapped is above 4GB, then | |
| // map the DMA transfer to a buffer below 4GB. | |
| // | |
| if ((Operation == EfiPciOperationBusMasterCommonBuffer) || | |
| (Operation == EfiPciOperationBusMasterCommonBuffer64)) | |
| { | |
| // | |
| // Common Buffer operations can not be remapped. If the common buffer | |
| // if above 4GB, then it is not possible to generate a mapping, so return | |
| // an error. | |
| // | |
| return EFI_UNSUPPORTED; | |
| } | |
| // | |
| // Allocate a MAP_INFO structure to remember the mapping when Unmap() is | |
| // called later. | |
| // | |
| MapInfo = AllocatePool (sizeof (MAP_INFO)); | |
| if (MapInfo == NULL) { | |
| *NumberOfBytes = 0; | |
| return EFI_OUT_OF_RESOURCES; | |
| } | |
| // | |
| // Initialize the MAP_INFO structure | |
| // | |
| MapInfo->Signature = MAP_INFO_SIGNATURE; | |
| MapInfo->Operation = Operation; | |
| MapInfo->NumberOfBytes = *NumberOfBytes; | |
| MapInfo->NumberOfPages = EFI_SIZE_TO_PAGES (MapInfo->NumberOfBytes); | |
| MapInfo->HostAddress = PhysicalAddress; | |
| MapInfo->MappedHostAddress = SIZE_4GB - 1; | |
| // | |
| // Allocate a buffer below 4GB to map the transfer to. | |
| // | |
| Status = gBS->AllocatePages ( | |
| AllocateMaxAddress, | |
| EfiBootServicesData, | |
| MapInfo->NumberOfPages, | |
| &MapInfo->MappedHostAddress | |
| ); | |
| if (EFI_ERROR (Status)) { | |
| FreePool (MapInfo); | |
| *NumberOfBytes = 0; | |
| return Status; | |
| } | |
| // | |
| // If this is a read operation from the Bus Master's point of view, | |
| // then copy the contents of the real buffer into the mapped buffer | |
| // so the Bus Master can read the contents of the real buffer. | |
| // | |
| if ((Operation == EfiPciOperationBusMasterRead) || | |
| (Operation == EfiPciOperationBusMasterRead64)) | |
| { | |
| CopyMem ( | |
| (VOID *)(UINTN)MapInfo->MappedHostAddress, | |
| (VOID *)(UINTN)MapInfo->HostAddress, | |
| MapInfo->NumberOfBytes | |
| ); | |
| } | |
| InsertTailList (&RootBridge->Maps, &MapInfo->Link); | |
| // | |
| // The DeviceAddress is the address of the maped buffer below 4GB | |
| // | |
| *DeviceAddress = MapInfo->MappedHostAddress; | |
| // | |
| // Return a pointer to the MAP_INFO structure in Mapping | |
| // | |
| *Mapping = MapInfo; | |
| } else { | |
| // | |
| // If the root bridge CAN handle performing DMA above 4GB or | |
| // the transfer is below 4GB, so the DeviceAddress is simply the | |
| // HostAddress | |
| // | |
| *DeviceAddress = PhysicalAddress; | |
| *Mapping = NO_MAPPING; | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Completes the Map() operation and releases any corresponding resources. | |
| The Unmap() function completes the Map() operation and releases any | |
| corresponding resources. | |
| If the operation was an EfiPciOperationBusMasterWrite or | |
| EfiPciOperationBusMasterWrite64, the data is committed to the target system | |
| memory. | |
| Any resources used for the mapping are freed. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[in] Mapping The mapping value returned from Map(). | |
| @retval EFI_SUCCESS The range was unmapped. | |
| @retval EFI_INVALID_PARAMETER Mapping is not a value that was returned by Map(). | |
| @retval EFI_DEVICE_ERROR The data was not committed to the target system memory. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoUnmap ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN VOID *Mapping | |
| ) | |
| { | |
| MAP_INFO *MapInfo; | |
| LIST_ENTRY *Link; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| EFI_STATUS Status; | |
| if (mIoMmu != NULL) { | |
| Status = mIoMmu->Unmap ( | |
| mIoMmu, | |
| Mapping | |
| ); | |
| return Status; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| // | |
| // See if the Map() operation associated with this Unmap() required a mapping | |
| // buffer. If a mapping buffer was not required, then this function simply | |
| // returns EFI_SUCCESS. | |
| // | |
| if (Mapping == NO_MAPPING) { | |
| return EFI_SUCCESS; | |
| } | |
| MapInfo = NO_MAPPING; | |
| for (Link = GetFirstNode (&RootBridge->Maps) | |
| ; !IsNull (&RootBridge->Maps, Link) | |
| ; Link = GetNextNode (&RootBridge->Maps, Link) | |
| ) | |
| { | |
| MapInfo = MAP_INFO_FROM_LINK (Link); | |
| if (MapInfo == Mapping) { | |
| break; | |
| } | |
| } | |
| // | |
| // Mapping is not a valid value returned by Map() | |
| // | |
| if (MapInfo != Mapping) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| RemoveEntryList (&MapInfo->Link); | |
| // | |
| // If this is a write operation from the Bus Master's point of view, | |
| // then copy the contents of the mapped buffer into the real buffer | |
| // so the processor can read the contents of the real buffer. | |
| // | |
| if ((MapInfo->Operation == EfiPciOperationBusMasterWrite) || | |
| (MapInfo->Operation == EfiPciOperationBusMasterWrite64)) | |
| { | |
| CopyMem ( | |
| (VOID *)(UINTN)MapInfo->HostAddress, | |
| (VOID *)(UINTN)MapInfo->MappedHostAddress, | |
| MapInfo->NumberOfBytes | |
| ); | |
| } | |
| // | |
| // Free the mapped buffer and the MAP_INFO structure. | |
| // | |
| gBS->FreePages (MapInfo->MappedHostAddress, MapInfo->NumberOfPages); | |
| FreePool (Mapping); | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Allocates pages that are suitable for an EfiPciOperationBusMasterCommonBuffer | |
| or EfiPciOperationBusMasterCommonBuffer64 mapping. | |
| @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param Type This parameter is not used and must be ignored. | |
| @param MemoryType The type of memory to allocate, EfiBootServicesData or | |
| EfiRuntimeServicesData. | |
| @param Pages The number of pages to allocate. | |
| @param HostAddress A pointer to store the base system memory address of the | |
| allocated range. | |
| @param Attributes The requested bit mask of attributes for the allocated | |
| range. Only the attributes | |
| EFI_PCI_ATTRIBUTE_MEMORY_WRITE_COMBINE, | |
| EFI_PCI_ATTRIBUTE_MEMORY_CACHED, and | |
| EFI_PCI_ATTRIBUTE_DUAL_ADDRESS_CYCLE may be used with this | |
| function. | |
| @retval EFI_SUCCESS The requested memory pages were allocated. | |
| @retval EFI_INVALID_PARAMETER MemoryType is invalid. | |
| @retval EFI_INVALID_PARAMETER HostAddress is NULL. | |
| @retval EFI_UNSUPPORTED Attributes is unsupported. The only legal | |
| attribute bits are MEMORY_WRITE_COMBINE, | |
| MEMORY_CACHED, and DUAL_ADDRESS_CYCLE. | |
| @retval EFI_OUT_OF_RESOURCES The memory pages could not be allocated. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoAllocateBuffer ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN EFI_ALLOCATE_TYPE Type, | |
| IN EFI_MEMORY_TYPE MemoryType, | |
| IN UINTN Pages, | |
| OUT VOID **HostAddress, | |
| IN UINT64 Attributes | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| EFI_PHYSICAL_ADDRESS PhysicalAddress; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| EFI_ALLOCATE_TYPE AllocateType; | |
| // | |
| // Validate Attributes | |
| // | |
| if ((Attributes & EFI_PCI_ATTRIBUTE_INVALID_FOR_ALLOCATE_BUFFER) != 0) { | |
| return EFI_UNSUPPORTED; | |
| } | |
| // | |
| // Check for invalid inputs | |
| // | |
| if (HostAddress == NULL) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| // | |
| // The only valid memory types are EfiBootServicesData and | |
| // EfiRuntimeServicesData | |
| // | |
| if ((MemoryType != EfiBootServicesData) && | |
| (MemoryType != EfiRuntimeServicesData)) | |
| { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| if (mIoMmu != NULL) { | |
| if (!RootBridge->DmaAbove4G) { | |
| // | |
| // Clear DUAL_ADDRESS_CYCLE | |
| // | |
| Attributes &= ~((UINT64)EFI_PCI_ATTRIBUTE_DUAL_ADDRESS_CYCLE); | |
| } | |
| Status = mIoMmu->AllocateBuffer ( | |
| mIoMmu, | |
| Type, | |
| MemoryType, | |
| Pages, | |
| HostAddress, | |
| Attributes | |
| ); | |
| return Status; | |
| } | |
| AllocateType = AllocateAnyPages; | |
| if (!RootBridge->DmaAbove4G || | |
| ((Attributes & EFI_PCI_ATTRIBUTE_DUAL_ADDRESS_CYCLE) == 0)) | |
| { | |
| // | |
| // Limit allocations to memory below 4GB | |
| // | |
| AllocateType = AllocateMaxAddress; | |
| PhysicalAddress = (EFI_PHYSICAL_ADDRESS)(SIZE_4GB - 1); | |
| } | |
| Status = gBS->AllocatePages ( | |
| AllocateType, | |
| MemoryType, | |
| Pages, | |
| &PhysicalAddress | |
| ); | |
| if (!EFI_ERROR (Status)) { | |
| *HostAddress = (VOID *)(UINTN)PhysicalAddress; | |
| } | |
| return Status; | |
| } | |
| /** | |
| Frees memory that was allocated with AllocateBuffer(). | |
| The FreeBuffer() function frees memory that was allocated with | |
| AllocateBuffer(). | |
| @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param Pages The number of pages to free. | |
| @param HostAddress The base system memory address of the allocated range. | |
| @retval EFI_SUCCESS The requested memory pages were freed. | |
| @retval EFI_INVALID_PARAMETER The memory range specified by HostAddress and | |
| Pages was not allocated with AllocateBuffer(). | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoFreeBuffer ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN UINTN Pages, | |
| OUT VOID *HostAddress | |
| ) | |
| { | |
| EFI_STATUS Status; | |
| if (mIoMmu != NULL) { | |
| Status = mIoMmu->FreeBuffer ( | |
| mIoMmu, | |
| Pages, | |
| HostAddress | |
| ); | |
| return Status; | |
| } | |
| return gBS->FreePages ((EFI_PHYSICAL_ADDRESS)(UINTN)HostAddress, Pages); | |
| } | |
| /** | |
| Flushes all PCI posted write transactions from a PCI host bridge to system | |
| memory. | |
| The Flush() function flushes any PCI posted write transactions from a PCI | |
| host bridge to system memory. Posted write transactions are generated by PCI | |
| bus masters when they perform write transactions to target addresses in | |
| system memory. | |
| This function does not flush posted write transactions from any PCI bridges. | |
| A PCI controller specific action must be taken to guarantee that the posted | |
| write transactions have been flushed from the PCI controller and from all the | |
| PCI bridges into the PCI host bridge. This is typically done with a PCI read | |
| transaction from the PCI controller prior to calling Flush(). | |
| @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @retval EFI_SUCCESS The PCI posted write transactions were flushed | |
| from the PCI host bridge to system memory. | |
| @retval EFI_DEVICE_ERROR The PCI posted write transactions were not flushed | |
| from the PCI host bridge due to a hardware error. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoFlush ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This | |
| ) | |
| { | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Gets the attributes that a PCI root bridge supports setting with | |
| SetAttributes(), and the attributes that a PCI root bridge is currently | |
| using. | |
| The GetAttributes() function returns the mask of attributes that this PCI | |
| root bridge supports and the mask of attributes that the PCI root bridge is | |
| currently using. | |
| @param This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param Supported A pointer to the mask of attributes that this PCI root | |
| bridge supports setting with SetAttributes(). | |
| @param Attributes A pointer to the mask of attributes that this PCI root | |
| bridge is currently using. | |
| @retval EFI_SUCCESS If Supports is not NULL, then the attributes | |
| that the PCI root bridge supports is returned | |
| in Supports. If Attributes is not NULL, then | |
| the attributes that the PCI root bridge is | |
| currently using is returned in Attributes. | |
| @retval EFI_INVALID_PARAMETER Both Supports and Attributes are NULL. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoGetAttributes ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| OUT UINT64 *Supported, | |
| OUT UINT64 *Attributes | |
| ) | |
| { | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| if ((Attributes == NULL) && (Supported == NULL)) { | |
| return EFI_INVALID_PARAMETER; | |
| } | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| // | |
| // Set the return value for Supported and Attributes | |
| // | |
| if (Supported != NULL) { | |
| *Supported = RootBridge->Supports; | |
| } | |
| if (Attributes != NULL) { | |
| *Attributes = RootBridge->Attributes; | |
| } | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Sets attributes for a resource range on a PCI root bridge. | |
| The SetAttributes() function sets the attributes specified in Attributes for | |
| the PCI root bridge on the resource range specified by ResourceBase and | |
| ResourceLength. Since the granularity of setting these attributes may vary | |
| from resource type to resource type, and from platform to platform, the | |
| actual resource range and the one passed in by the caller may differ. As a | |
| result, this function may set the attributes specified by Attributes on a | |
| larger resource range than the caller requested. The actual range is returned | |
| in ResourceBase and ResourceLength. The caller is responsible for verifying | |
| that the actual range for which the attributes were set is acceptable. | |
| @param This A pointer to the | |
| EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param Attributes The mask of attributes to set. If the | |
| attribute bit MEMORY_WRITE_COMBINE, | |
| MEMORY_CACHED, or MEMORY_DISABLE is set, | |
| then the resource range is specified by | |
| ResourceBase and ResourceLength. If | |
| MEMORY_WRITE_COMBINE, MEMORY_CACHED, and | |
| MEMORY_DISABLE are not set, then | |
| ResourceBase and ResourceLength are ignored, | |
| and may be NULL. | |
| @param ResourceBase A pointer to the base address of the | |
| resource range to be modified by the | |
| attributes specified by Attributes. | |
| @param ResourceLength A pointer to the length of the resource | |
| range to be modified by the attributes | |
| specified by Attributes. | |
| @retval EFI_SUCCESS The current configuration of this PCI root bridge | |
| was returned in Resources. | |
| @retval EFI_UNSUPPORTED The current configuration of this PCI root bridge | |
| could not be retrieved. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoSetAttributes ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| IN UINT64 Attributes, | |
| IN OUT UINT64 *ResourceBase, | |
| IN OUT UINT64 *ResourceLength | |
| ) | |
| { | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| if ((Attributes & (~RootBridge->Supports)) != 0) { | |
| return EFI_UNSUPPORTED; | |
| } | |
| RootBridge->Attributes = Attributes; | |
| return EFI_SUCCESS; | |
| } | |
| /** | |
| Retrieves the current resource settings of this PCI root bridge in the form | |
| of a set of ACPI resource descriptors. | |
| There are only two resource descriptor types from the ACPI Specification that | |
| may be used to describe the current resources allocated to a PCI root bridge. | |
| These are the QWORD Address Space Descriptor, and the End Tag. The QWORD | |
| Address Space Descriptor can describe memory, I/O, and bus number ranges for | |
| dynamic or fixed resources. The configuration of a PCI root bridge is described | |
| with one or more QWORD Address Space Descriptors followed by an End Tag. | |
| @param[in] This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL. | |
| @param[out] Resources A pointer to the resource descriptors that | |
| describe the current configuration of this PCI root | |
| bridge. The storage for the resource | |
| descriptors is allocated by this function. The | |
| caller must treat the return buffer as read-only | |
| data, and the buffer must not be freed by the | |
| caller. | |
| @retval EFI_SUCCESS The current configuration of this PCI root bridge | |
| was returned in Resources. | |
| @retval EFI_UNSUPPORTED The current configuration of this PCI root bridge | |
| could not be retrieved. | |
| **/ | |
| EFI_STATUS | |
| EFIAPI | |
| RootBridgeIoConfiguration ( | |
| IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This, | |
| OUT VOID **Resources | |
| ) | |
| { | |
| PCI_RESOURCE_TYPE Index; | |
| PCI_ROOT_BRIDGE_INSTANCE *RootBridge; | |
| PCI_RES_NODE *ResAllocNode; | |
| EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor; | |
| EFI_ACPI_END_TAG_DESCRIPTOR *End; | |
| // | |
| // Get this instance of the Root Bridge. | |
| // | |
| RootBridge = ROOT_BRIDGE_FROM_THIS (This); | |
| ZeroMem ( | |
| RootBridge->ConfigBuffer, | |
| TypeMax * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR) | |
| ); | |
| Descriptor = RootBridge->ConfigBuffer; | |
| for (Index = TypeIo; Index < TypeMax; Index++) { | |
| ResAllocNode = &RootBridge->ResAllocNode[Index]; | |
| if (ResAllocNode->Status != ResAllocated) { | |
| continue; | |
| } | |
| Descriptor->Desc = ACPI_ADDRESS_SPACE_DESCRIPTOR; | |
| Descriptor->Len = sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) - 3; | |
| // According to UEFI 2.7, RootBridgeIo->Configuration should return address | |
| // range in CPU view (host address), and ResAllocNode->Base is already a CPU | |
| // view address (host address). | |
| Descriptor->AddrRangeMin = ResAllocNode->Base; | |
| Descriptor->AddrRangeMax = ResAllocNode->Base + ResAllocNode->Length - 1; | |
| Descriptor->AddrLen = ResAllocNode->Length; | |
| Descriptor->AddrTranslationOffset = GetTranslationByResourceType ( | |
| RootBridge, | |
| ResAllocNode->Type | |
| ); | |
| switch (ResAllocNode->Type) { | |
| case TypeIo: | |
| Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_IO; | |
| break; | |
| case TypePMem32: | |
| Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE; | |
| case TypeMem32: | |
| Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_MEM; | |
| Descriptor->AddrSpaceGranularity = 32; | |
| break; | |
| case TypePMem64: | |
| Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE; | |
| case TypeMem64: | |
| Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_MEM; | |
| Descriptor->AddrSpaceGranularity = 64; | |
| break; | |
| case TypeBus: | |
| Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_BUS; | |
| break; | |
| default: | |
| break; | |
| } | |
| Descriptor++; | |
| } | |
| // | |
| // Terminate the entries. | |
| // | |
| End = (EFI_ACPI_END_TAG_DESCRIPTOR *)Descriptor; | |
| End->Desc = ACPI_END_TAG_DESCRIPTOR; | |
| End->Checksum = 0x0; | |
| *Resources = RootBridge->ConfigBuffer; | |
| return EFI_SUCCESS; | |
| } |