/** @file | |
Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR> | |
Copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR> | |
SPDX-License-Identifier: BSD-2-Clause-Patent | |
**/ | |
#ifndef CPU_DXE_H_ | |
#define CPU_DXE_H_ | |
#include <Uefi.h> | |
#include <Library/ArmLib.h> | |
#include <Library/ArmMmuLib.h> | |
#include <Library/BaseMemoryLib.h> | |
#include <Library/DebugLib.h> | |
#include <Library/PcdLib.h> | |
#include <Library/UefiBootServicesTableLib.h> | |
#include <Library/DxeServicesTableLib.h> | |
#include <Library/CacheMaintenanceLib.h> | |
#include <Library/PeCoffGetEntryPointLib.h> | |
#include <Library/UefiLib.h> | |
#include <Library/CpuLib.h> | |
#include <Library/DefaultExceptionHandlerLib.h> | |
#include <Library/DebugLib.h> | |
#include <Guid/DebugImageInfoTable.h> | |
#include <Protocol/Cpu.h> | |
#include <Protocol/DebugSupport.h> | |
#include <Protocol/LoadedImage.h> | |
#include <Protocol/MemoryAttribute.h> | |
extern BOOLEAN mIsFlushingGCD; | |
extern EFI_MEMORY_ATTRIBUTE_PROTOCOL mMemoryAttribute; | |
/** | |
This function registers and enables the handler specified by InterruptHandler for a processor | |
interrupt or exception type specified by InterruptType. If InterruptHandler is NULL, then the | |
handler for the processor interrupt or exception type specified by InterruptType is uninstalled. | |
The installed handler is called once for each processor interrupt or exception. | |
@param InterruptType A pointer to the processor's current interrupt state. Set to TRUE if interrupts | |
are enabled and FALSE if interrupts are disabled. | |
@param InterruptHandler A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER that is called | |
when a processor interrupt occurs. If this parameter is NULL, then the handler | |
will be uninstalled. | |
@retval EFI_SUCCESS The handler for the processor interrupt was successfully installed or uninstalled. | |
@retval EFI_ALREADY_STARTED InterruptHandler is not NULL, and a handler for InterruptType was | |
previously installed. | |
@retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not | |
previously installed. | |
@retval EFI_UNSUPPORTED The interrupt specified by InterruptType is not supported. | |
**/ | |
EFI_STATUS | |
RegisterInterruptHandler ( | |
IN EFI_EXCEPTION_TYPE InterruptType, | |
IN EFI_CPU_INTERRUPT_HANDLER InterruptHandler | |
); | |
/** | |
This function registers and enables the handler specified by InterruptHandler for a processor | |
interrupt or exception type specified by InterruptType. If InterruptHandler is NULL, then the | |
handler for the processor interrupt or exception type specified by InterruptType is uninstalled. | |
The installed handler is called once for each processor interrupt or exception. | |
@param InterruptType A pointer to the processor's current interrupt state. Set to TRUE if interrupts | |
are enabled and FALSE if interrupts are disabled. | |
@param InterruptHandler A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER that is called | |
when a processor interrupt occurs. If this parameter is NULL, then the handler | |
will be uninstalled. | |
@retval EFI_SUCCESS The handler for the processor interrupt was successfully installed or uninstalled. | |
@retval EFI_ALREADY_STARTED InterruptHandler is not NULL, and a handler for InterruptType was | |
previously installed. | |
@retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not | |
previously installed. | |
@retval EFI_UNSUPPORTED The interrupt specified by InterruptType is not supported. | |
**/ | |
EFI_STATUS | |
RegisterDebuggerInterruptHandler ( | |
IN EFI_EXCEPTION_TYPE InterruptType, | |
IN EFI_CPU_INTERRUPT_HANDLER InterruptHandler | |
); | |
EFI_STATUS | |
EFIAPI | |
CpuSetMemoryAttributes ( | |
IN EFI_CPU_ARCH_PROTOCOL *This, | |
IN EFI_PHYSICAL_ADDRESS BaseAddress, | |
IN UINT64 Length, | |
IN UINT64 Attributes | |
); | |
EFI_STATUS | |
InitializeExceptions ( | |
IN EFI_CPU_ARCH_PROTOCOL *Cpu | |
); | |
EFI_STATUS | |
SyncCacheConfig ( | |
IN EFI_CPU_ARCH_PROTOCOL *CpuProtocol | |
); | |
// The ARM Attributes might be defined on 64-bit (case of the long format description table) | |
UINT64 | |
EfiAttributeToArmAttribute ( | |
IN UINT64 EfiAttributes | |
); | |
EFI_STATUS | |
GetMemoryRegion ( | |
IN OUT UINTN *BaseAddress, | |
OUT UINTN *RegionLength, | |
OUT UINTN *RegionAttributes | |
); | |
EFI_STATUS | |
SetGcdMemorySpaceAttributes ( | |
IN EFI_GCD_MEMORY_SPACE_DESCRIPTOR *MemorySpaceMap, | |
IN UINTN NumberOfDescriptors, | |
IN EFI_PHYSICAL_ADDRESS BaseAddress, | |
IN UINT64 Length, | |
IN UINT64 Attributes | |
); | |
/** | |
Convert an arch specific set of page attributes into a mask | |
of EFI_MEMORY_xx constants. | |
@param PageAttributes The set of page attributes. | |
@retval The mask of EFI_MEMORY_xx constants. | |
**/ | |
UINT64 | |
RegionAttributeToGcdAttribute ( | |
IN UINTN PageAttributes | |
); | |
#endif // CPU_DXE_H_ |