MdeModulePkg/PciHostBridgeDxe: Add support for address translation
PCI address translation is necessary for some non-x86 platforms. On such platforms, address value (denoted as "device address" or "address in PCI view") set to PCI BAR registers in configuration space might be different from the address which is used by CPU to access the registers in memory BAR or IO BAR spaces (denoted as "host address" or "address in CPU view"). The difference between the two addresses is called "Address Translation Offset" or simply "translation", and can be represented by "Address Translation Offset" in ACPI QWORD Address Space Descriptor (Offset 0x1E). However UEFI and ACPI differs on the definitions of QWORD Address Space Descriptor, and we will follow UEFI definition on UEFI protocols, such as PCI root bridge IO protocol and PCI IO protocol. In UEFI 2.7, "Address Translation Offset" is "Offset to apply to the Starting address to convert it to a PCI address". This means: 1. Translation = device address - host address. 2. PciRootBridgeIo->Configuration should return CPU view address, as well as PciIo->GetBarAttributes. Summary of addresses used in protocol interfaces and internal implementations: 1. *Only* the following protocol interfaces assume Address is Device Address: (1). PciHostBridgeResourceAllocation.GetProposedResources() Otherwise PCI bus driver cannot set correct address into PCI BARs. (2). PciRootBridgeIo.Mem.Read() and PciRootBridgeIo.Mem.Write() (3). PciRootBridgeIo.CopyMem() UEFI and PI spec have clear statements for all other protocol interfaces about the address type. 2. Library interfaces and internal implementation: (1). Base and Limit in PCI_ROOT_BRIDGE_APERTURE are device address. It is easy to check whether the address is below 4G or above 4G. (2). Addresses in PCI_ROOT_BRIDGE_INSTANCE.ResAllocNode are host address, for they are allocated from GCD. (3). Address passed to PciHostBridgeResourceConflict is host address, for it comes from PCI_ROOT_BRIDGE_INSTANCE.ResAllocNode. RESTRICTION: to simplify the situation, we require the alignment of Translation must be larger than any BAR alignment in the same root bridge, so that resource allocation alignment can be applied to both device address and host address. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Heyi Guo <heyi.guo@linaro.org> Signed-off-by: Yi Li <phoenix.liyi@huawei.com> Reviewed-by: Ni Ruiyu <ruiyu.ni@intel.com> Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
This commit is contained in:
@@ -86,12 +86,38 @@ CreateRootBridge (
|
||||
(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 ((EFI_D_INFO, " Bus: %lx - %lx\n", Bridge->Bus.Base, Bridge->Bus.Limit));
|
||||
DEBUG ((EFI_D_INFO, " Io: %lx - %lx\n", Bridge->Io.Base, Bridge->Io.Limit));
|
||||
DEBUG ((EFI_D_INFO, " Mem: %lx - %lx\n", Bridge->Mem.Base, Bridge->Mem.Limit));
|
||||
DEBUG ((EFI_D_INFO, " MemAbove4G: %lx - %lx\n", Bridge->MemAbove4G.Base, Bridge->MemAbove4G.Limit));
|
||||
DEBUG ((EFI_D_INFO, " PMem: %lx - %lx\n", Bridge->PMem.Base, Bridge->PMem.Limit));
|
||||
DEBUG ((EFI_D_INFO, " PMemAbove4G: %lx - %lx\n", Bridge->PMemAbove4G.Base, Bridge->PMemAbove4G.Limit));
|
||||
DEBUG ((
|
||||
EFI_D_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
|
||||
@@ -206,7 +232,12 @@ CreateRootBridge (
|
||||
}
|
||||
RootBridge->ResAllocNode[Index].Type = Index;
|
||||
if (Bridge->ResourceAssigned && (Aperture->Limit >= Aperture->Base)) {
|
||||
RootBridge->ResAllocNode[Index].Base = 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 {
|
||||
@@ -403,6 +434,40 @@ RootBridgeIoCheckParameter (
|
||||
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;
|
||||
}
|
||||
|
||||
/**
|
||||
Polls an address in memory mapped I/O space until an exit condition is met,
|
||||
or a timeout occurs.
|
||||
@@ -658,13 +723,25 @@ RootBridgeIoMemRead (
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
|
||||
UINT64 Translation;
|
||||
|
||||
Status = RootBridgeIoCheckParameter (This, MemOperation, Width, Address,
|
||||
Count, Buffer);
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
return mCpuIo->Mem.Read (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
|
||||
|
||||
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);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -705,13 +782,25 @@ RootBridgeIoMemWrite (
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
|
||||
UINT64 Translation;
|
||||
|
||||
Status = RootBridgeIoCheckParameter (This, MemOperation, Width, Address,
|
||||
Count, Buffer);
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
return mCpuIo->Mem.Write (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
|
||||
|
||||
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);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -746,6 +835,8 @@ RootBridgeIoIoRead (
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
|
||||
|
||||
Status = RootBridgeIoCheckParameter (
|
||||
This, IoOperation, Width,
|
||||
Address, Count, Buffer
|
||||
@@ -753,7 +844,13 @@ RootBridgeIoIoRead (
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
return mCpuIo->Io.Read (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
|
||||
|
||||
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);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -788,6 +885,8 @@ RootBridgeIoIoWrite (
|
||||
)
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
|
||||
|
||||
Status = RootBridgeIoCheckParameter (
|
||||
This, IoOperation, Width,
|
||||
Address, Count, Buffer
|
||||
@@ -795,7 +894,13 @@ RootBridgeIoIoWrite (
|
||||
if (EFI_ERROR (Status)) {
|
||||
return Status;
|
||||
}
|
||||
return mCpuIo->Io.Write (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
|
||||
|
||||
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);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -1615,9 +1720,17 @@ RootBridgeIoConfiguration (
|
||||
|
||||
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:
|
||||
|
Reference in New Issue
Block a user