+++ /dev/null
-/** @file\r
- I/O Library MMIO Buffer Functions.\r
-\r
- Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>\r
- SPDX-License-Identifier: BSD-2-Clause-Patent\r
-\r
- Module Name: IoLibMmioBuffer.c\r
-\r
-**/\r
-\r
-\r
-#include "DxeCpuIoLibInternal.h"\r
-\r
-/**\r
- Copy data from MMIO region to system memory by using 8-bit access.\r
-\r
- Copy data from MMIO region specified by starting address StartAddress\r
- to system memory specified by Buffer by using 8-bit access. The total\r
- number of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied from.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer receiving the data read.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT8 *\r
-EFIAPI\r
-MmioReadBuffer8 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- OUT UINT8 *Buffer\r
- )\r
-{\r
- UINT8 *ReturnBuffer;\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ReturnBuffer = Buffer;\r
-\r
- while (Length-- > 0) {\r
- *(Buffer++) = MmioRead8 (StartAddress++);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-/**\r
- Copy data from MMIO region to system memory by using 16-bit access.\r
-\r
- Copy data from MMIO region specified by starting address StartAddress\r
- to system memory specified by Buffer by using 16-bit access. The total\r
- number of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied from.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer receiving the data read.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT16 *\r
-EFIAPI\r
-MmioReadBuffer16 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- OUT UINT16 *Buffer\r
- )\r
-{\r
- UINT16 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT16) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT16) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT16) - 1)) == 0);\r
-\r
- ReturnBuffer = Buffer;\r
-\r
- while (Length > 0) {\r
- *(Buffer++) = MmioRead16 (StartAddress);\r
- StartAddress += sizeof (UINT16);\r
- Length -= sizeof (UINT16);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-/**\r
- Copy data from MMIO region to system memory by using 32-bit access.\r
-\r
- Copy data from MMIO region specified by starting address StartAddress\r
- to system memory specified by Buffer by using 32-bit access. The total\r
- number of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 32-bit boundary, then ASSERT().\r
- If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied from.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer receiving the data read.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT32 *\r
-EFIAPI\r
-MmioReadBuffer32 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- OUT UINT32 *Buffer\r
- )\r
-{\r
- UINT32 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT32) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT32) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT32) - 1)) == 0);\r
-\r
- ReturnBuffer = Buffer;\r
-\r
- while (Length > 0) {\r
- *(Buffer++) = MmioRead32 (StartAddress);\r
- StartAddress += sizeof (UINT32);\r
- Length -= sizeof (UINT32);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-/**\r
- Copy data from MMIO region to system memory by using 64-bit access.\r
-\r
- Copy data from MMIO region specified by starting address StartAddress\r
- to system memory specified by Buffer by using 64-bit access. The total\r
- number of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied from.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer receiving the data read.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT64 *\r
-EFIAPI\r
-MmioReadBuffer64 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- OUT UINT64 *Buffer\r
- )\r
-{\r
- UINT64 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT64) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT64) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT64) - 1)) == 0);\r
-\r
- ReturnBuffer = Buffer;\r
-\r
- while (Length > 0) {\r
- *(Buffer++) = MmioRead64 (StartAddress);\r
- StartAddress += sizeof (UINT64);\r
- Length -= sizeof (UINT64);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-\r
-/**\r
- Copy data from system memory to MMIO region by using 8-bit access.\r
-\r
- Copy data from system memory specified by Buffer to MMIO region specified\r
- by starting address StartAddress by using 8-bit access. The total number\r
- of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().\r
-\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied to.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer containing the data to write.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT8 *\r
-EFIAPI\r
-MmioWriteBuffer8 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- IN CONST UINT8 *Buffer\r
- )\r
-{\r
- VOID* ReturnBuffer;\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ReturnBuffer = (UINT8 *) Buffer;\r
-\r
- while (Length-- > 0) {\r
- MmioWrite8 (StartAddress++, *(Buffer++));\r
- }\r
-\r
- return ReturnBuffer;\r
-\r
-}\r
-\r
-/**\r
- Copy data from system memory to MMIO region by using 16-bit access.\r
-\r
- Copy data from system memory specified by Buffer to MMIO region specified\r
- by starting address StartAddress by using 16-bit access. The total number\r
- of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- If Buffer is not aligned on a 16-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied to.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer containing the data to write.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT16 *\r
-EFIAPI\r
-MmioWriteBuffer16 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- IN CONST UINT16 *Buffer\r
- )\r
-{\r
- UINT16 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT16) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT16) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT16) - 1)) == 0);\r
-\r
- ReturnBuffer = (UINT16 *) Buffer;\r
-\r
- while (Length > 0) {\r
- MmioWrite16 (StartAddress, *(Buffer++));\r
-\r
- StartAddress += sizeof (UINT16);\r
- Length -= sizeof (UINT16);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-\r
-/**\r
- Copy data from system memory to MMIO region by using 32-bit access.\r
-\r
- Copy data from system memory specified by Buffer to MMIO region specified\r
- by starting address StartAddress by using 32-bit access. The total number\r
- of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- If Buffer is not aligned on a 32-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied to.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer containing the data to write.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT32 *\r
-EFIAPI\r
-MmioWriteBuffer32 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- IN CONST UINT32 *Buffer\r
- )\r
-{\r
- UINT32 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT32) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT32) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT32) - 1)) == 0);\r
-\r
- ReturnBuffer = (UINT32 *) Buffer;\r
-\r
- while (Length > 0) {\r
- MmioWrite32 (StartAddress, *(Buffer++));\r
-\r
- StartAddress += sizeof (UINT32);\r
- Length -= sizeof (UINT32);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r
-/**\r
- Copy data from system memory to MMIO region by using 64-bit access.\r
-\r
- Copy data from system memory specified by Buffer to MMIO region specified\r
- by starting address StartAddress by using 64-bit access. The total number\r
- of byte to be copied is specified by Length. Buffer is returned.\r
-\r
- If StartAddress is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- If Length is greater than (MAX_ADDRESS - StartAddress + 1), then ASSERT().\r
- If Length is greater than (MAX_ADDRESS -Buffer + 1), then ASSERT().\r
-\r
- If Length is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- If Buffer is not aligned on a 64-bit boundary, then ASSERT().\r
-\r
- @param StartAddress Starting address for the MMIO region to be copied to.\r
- @param Length Size in bytes of the copy.\r
- @param Buffer Pointer to a system memory buffer containing the data to write.\r
-\r
- @return Buffer\r
-\r
-**/\r
-UINT64 *\r
-EFIAPI\r
-MmioWriteBuffer64 (\r
- IN UINTN StartAddress,\r
- IN UINTN Length,\r
- IN CONST UINT64 *Buffer\r
- )\r
-{\r
- UINT64 *ReturnBuffer;\r
-\r
- ASSERT ((StartAddress & (sizeof (UINT64) - 1)) == 0);\r
-\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - StartAddress));\r
- ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN) Buffer));\r
-\r
- ASSERT ((Length & (sizeof (UINT64) - 1)) == 0);\r
- ASSERT (((UINTN) Buffer & (sizeof (UINT64) - 1)) == 0);\r
-\r
- ReturnBuffer = (UINT64 *) Buffer;\r
-\r
- while (Length > 0) {\r
- MmioWrite64 (StartAddress, *(Buffer++));\r
-\r
- StartAddress += sizeof (UINT64);\r
- Length -= sizeof (UINT64);\r
- }\r
-\r
- return ReturnBuffer;\r
-}\r
-\r