Add runtime registration function to all PCI Libs

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6708 6f19259b-4bc3-4df7-8a09-765794883524

8 files changed, 215 insertions, 0 deletions

diff --git a/MdePkg/Library/BasePciCf8Lib/PciCf8Lib.c b/MdePkg/Library/BasePciCf8Lib/PciCf8Lib.c
index 995e4ab1b7..d6bc180b8b 100644
--- a/MdePkg/Library/BasePciCf8Lib/PciCf8Lib.c
+++ b/MdePkg/Library/BasePciCf8Lib/PciCf8Lib.c
@@ -61,6 +61,33 @@
   ASSERT (((A) & (~0xffff0ff | (M))) == 0)

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciCf8RegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_SUCCESS;

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/BasePciExpressLib/PciExpressLib.c b/MdePkg/Library/BasePciExpressLib/PciExpressLib.c
index 6bce8f9550..6d76e846fa 100644
--- a/MdePkg/Library/BasePciExpressLib/PciExpressLib.c
+++ b/MdePkg/Library/BasePciExpressLib/PciExpressLib.c
@@ -36,6 +36,32 @@
 #define ASSERT_INVALID_PCI_ADDRESS(A) \

   ASSERT (((A) & ~0xfffffff) == 0)

 

+/**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciExpressRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_UNSUPPORTED;

+}

 

 /**

   Gets the base address of PCI Express.

diff --git a/MdePkg/Library/BasePciLibCf8/PciLib.c b/MdePkg/Library/BasePciLibCf8/PciLib.c
index af71b88e59..d4a3ef06f6 100644
--- a/MdePkg/Library/BasePciLibCf8/PciLib.c
+++ b/MdePkg/Library/BasePciLibCf8/PciLib.c
@@ -20,6 +20,33 @@
 #include <Library/PciCf8Lib.h>

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return PciCf8RegisterForRuntimeAccess (Address);

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/BasePciLibPciExpress/PciLib.c b/MdePkg/Library/BasePciLibPciExpress/PciLib.c
index c1abd09f63..48fe66f180 100644
--- a/MdePkg/Library/BasePciLibPciExpress/PciLib.c
+++ b/MdePkg/Library/BasePciLibPciExpress/PciLib.c
@@ -20,6 +20,33 @@
 #include <Library/PciExpressLib.h>

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return PciExpressRegisterForRuntimeAccess (Address);

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/PeiPciLibPciCfg2/PciLib.c b/MdePkg/Library/PeiPciLibPciCfg2/PciLib.c
index 63b1b9fc17..080195f693 100644
--- a/MdePkg/Library/PeiPciLibPciCfg2/PciLib.c
+++ b/MdePkg/Library/PeiPciLibPciCfg2/PciLib.c
@@ -125,6 +125,33 @@ PeiPciLibPciCfg2WriteWorker (
 }

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_UNSUPPORTED;

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c b/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
index 54ff1cbe65..453f2ded0f 100644
--- a/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
+++ b/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
@@ -160,6 +160,33 @@ PeiPciSegmentLibPciCfg2WriteWorker (
 }

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciSegmentRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_UNSUPPORTED;

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/UefiPciLibPciRootBridgeIo/PciLib.c b/MdePkg/Library/UefiPciLibPciRootBridgeIo/PciLib.c
index a408b0a0f1..7e5c60858b 100644
--- a/MdePkg/Library/UefiPciLibPciRootBridgeIo/PciLib.c
+++ b/MdePkg/Library/UefiPciLibPciRootBridgeIo/PciLib.c
@@ -143,6 +143,33 @@ DxePciLibPciRootBridgeIoWriteWorker (
 }

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_UNSUPPORTED;

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.

diff --git a/MdePkg/Library/UefiPciSegmentLibPciRootBridgeIo/PciSegmentLib.c b/MdePkg/Library/UefiPciSegmentLibPciRootBridgeIo/PciSegmentLib.c
index 058d2debc6..cb8991e2da 100644
--- a/MdePkg/Library/UefiPciSegmentLibPciRootBridgeIo/PciSegmentLib.c
+++ b/MdePkg/Library/UefiPciSegmentLibPciRootBridgeIo/PciSegmentLib.c
@@ -241,6 +241,33 @@ DxePciSegmentLibPciRootBridgeIoWriteWorker (
 }

 

 /**

+  Register a PCI device so PCI configuration registers may be accessed after 

+  SetVirtualAddressMap().

+  

+  If Address > 0x0FFFFFFF, then ASSERT().

+

+  @param  Address Address that encodes the PCI Bus, Device, Function and

+                  Register.

+  

+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.

+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function 

+                                   after ExitBootServices().

+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device

+                                   at runtime could not be mapped.

+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to

+                                   complete the registration.

+

+**/

+RETURN_STATUS

+EFIAPI

+PciSegmentRegisterForRuntimeAccess (

+  IN UINTN  Address

+  )

+{

+  return RETURN_UNSUPPORTED;

+}

+

+/**

   Reads an 8-bit PCI configuration register.

 

   Reads and returns the 8-bit PCI configuration register specified by Address.