UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm

[mirror_edk2.git] / EmbeddedPkg / Library / CoherentDmaLib / CoherentDmaLib.c

/** @file\r
  Generic ARM implementation of DmaLib.h\r
\r
  Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>\r
\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include <Uefi.h>\r
#include <Library/DebugLib.h>\r
#include <Library/DmaLib.h>\r
#include <Library/MemoryAllocationLib.h>\r
\r
STATIC\r
PHYSICAL_ADDRESS\r
HostToDeviceAddress (\r
  IN  VOID  *Address\r
  )\r
{\r
  return (PHYSICAL_ADDRESS)(UINTN)Address + PcdGet64 (PcdDmaDeviceOffset);\r
}\r
\r
/**\r
  Provides the DMA controller-specific addresses needed to access system memory.\r
\r
  Operation is relative to the DMA bus master.\r
\r
  @param  Operation             Indicates if the bus master is going to read or write to system memory.\r
  @param  HostAddress           The system memory address to map to the DMA controller.\r
  @param  NumberOfBytes         On input the number of bytes to map. On output the number of bytes\r
                                that were mapped.\r
  @param  DeviceAddress         The resulting map address for the bus master controller to use to\r
                                access the hosts HostAddress.\r
  @param  Mapping               A resulting value to pass to Unmap().\r
\r
  @retval EFI_SUCCESS           The range was mapped for the returned NumberOfBytes.\r
  @retval EFI_UNSUPPORTED       The HostAddress cannot be mapped as a common buffer.\r
  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a lack of resources.\r
  @retval EFI_DEVICE_ERROR      The system hardware could not map the requested address.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DmaMap (\r
  IN     DMA_MAP_OPERATION  Operation,\r
  IN     VOID               *HostAddress,\r
  IN OUT UINTN              *NumberOfBytes,\r
  OUT    PHYSICAL_ADDRESS   *DeviceAddress,\r
  OUT    VOID               **Mapping\r
  )\r
{\r
  if ((HostAddress == NULL) ||\r
      (NumberOfBytes == NULL) ||\r
      (DeviceAddress == NULL) ||\r
      (Mapping == NULL))\r
  {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  *DeviceAddress = HostToDeviceAddress (HostAddress);\r
  *Mapping       = NULL;\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Completes the DmaMapBusMasterRead(), DmaMapBusMasterWrite(), or DmaMapBusMasterCommonBuffer()\r
  operation and releases any corresponding resources.\r
\r
  @param  Mapping               The mapping value returned from DmaMap*().\r
\r
  @retval EFI_SUCCESS           The range was unmapped.\r
  @retval EFI_DEVICE_ERROR      The data was not committed to the target system memory.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DmaUnmap (\r
  IN  VOID  *Mapping\r
  )\r
{\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Allocates pages that are suitable for an DmaMap() of type MapOperationBusMasterCommonBuffer.\r
  mapping.\r
\r
  @param  MemoryType            The type of memory to allocate, EfiBootServicesData or\r
                                EfiRuntimeServicesData.\r
  @param  Pages                 The number of pages to allocate.\r
  @param  HostAddress           A pointer to store the base system memory address of the\r
                                allocated range.\r
\r
                                @retval EFI_SUCCESS           The requested memory pages were allocated.\r
  @retval EFI_UNSUPPORTED       Attributes is unsupported. The only legal attribute bits are\r
                                MEMORY_WRITE_COMBINE and MEMORY_CACHED.\r
  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES  The memory pages could not be allocated.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DmaAllocateBuffer (\r
  IN  EFI_MEMORY_TYPE  MemoryType,\r
  IN  UINTN            Pages,\r
  OUT VOID             **HostAddress\r
  )\r
{\r
  return DmaAllocateAlignedBuffer (MemoryType, Pages, 0, HostAddress);\r
}\r
\r
/**\r
  Allocates pages that are suitable for an DmaMap() of type\r
  MapOperationBusMasterCommonBuffer mapping, at the requested alignment.\r
\r
  @param  MemoryType            The type of memory to allocate, EfiBootServicesData or\r
                                EfiRuntimeServicesData.\r
  @param  Pages                 The number of pages to allocate.\r
  @param  Alignment             Alignment in bytes of the base of the returned\r
                                buffer (must be a power of 2)\r
  @param  HostAddress           A pointer to store the base system memory address of the\r
                                allocated range.\r
\r
  @retval EFI_SUCCESS           The requested memory pages were allocated.\r
  @retval EFI_UNSUPPORTED       Attributes is unsupported. The only legal attribute bits are\r
                                MEMORY_WRITE_COMBINE and MEMORY_CACHED.\r
  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES  The memory pages could not be allocated.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DmaAllocateAlignedBuffer (\r
  IN  EFI_MEMORY_TYPE  MemoryType,\r
  IN  UINTN            Pages,\r
  IN  UINTN            Alignment,\r
  OUT VOID             **HostAddress\r
  )\r
{\r
  if (Alignment == 0) {\r
    Alignment = EFI_PAGE_SIZE;\r
  }\r
\r
  if ((HostAddress == NULL) ||\r
      ((Alignment & (Alignment - 1)) != 0))\r
  {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // The only valid memory types are EfiBootServicesData and EfiRuntimeServicesData\r
  //\r
  if (MemoryType == EfiBootServicesData) {\r
    *HostAddress = AllocateAlignedPages (Pages, Alignment);\r
  } else if (MemoryType == EfiRuntimeServicesData) {\r
    *HostAddress = AllocateAlignedRuntimePages (Pages, Alignment);\r
  } else {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  if (*HostAddress == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Frees memory that was allocated with DmaAllocateBuffer().\r
\r
  @param  Pages                 The number of pages to free.\r
  @param  HostAddress           The base system memory address of the allocated range.\r
\r
  @retval EFI_SUCCESS           The requested memory pages were freed.\r
  @retval EFI_INVALID_PARAMETER The memory range specified by HostAddress and Pages\r
                                was not allocated with DmaAllocateBuffer().\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DmaFreeBuffer (\r
  IN  UINTN  Pages,\r
  IN  VOID   *HostAddress\r
  )\r
{\r
  if (HostAddress == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  FreePages (HostAddress, Pages);\r
  return EFI_SUCCESS;\r
}\r