[mirror_edk2.git] / ArmPkg / Include / Library / ArmLib.h

/** @file\r
\r
  Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>\r
  Copyright (c) 2011 - 2015, ARM Ltd. All rights reserved.<BR>\r
\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#ifndef __ARM_LIB__\r
#define __ARM_LIB__\r
\r
#include <Uefi/UefiBaseType.h>\r
\r
#ifdef MDE_CPU_ARM\r
  #include <Chipset/ArmV7.h>\r
#elif defined(MDE_CPU_AARCH64)\r
  #include <Chipset/AArch64.h>\r
#else\r
 #error "Unknown chipset."\r
#endif\r
\r
/**\r
 * The UEFI firmware must not use the ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_* attributes.\r
 *\r
 * The Non Secure memory attribute (ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_*) should only\r
 * be used in Secure World to distinguished Secure to Non-Secure memory.\r
 */\r
typedef enum {\r
  ARM_MEMORY_REGION_ATTRIBUTE_UNCACHED_UNBUFFERED = 0,\r
  ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_UNCACHED_UNBUFFERED,\r
  ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK,\r
  ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_WRITE_BACK,\r
  ARM_MEMORY_REGION_ATTRIBUTE_WRITE_THROUGH,\r
  ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_WRITE_THROUGH,\r
  ARM_MEMORY_REGION_ATTRIBUTE_DEVICE,\r
  ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_DEVICE\r
} ARM_MEMORY_REGION_ATTRIBUTES;\r
\r
#define IS_ARM_MEMORY_REGION_ATTRIBUTES_SECURE(attr) ((UINT32)(attr) & 1)\r
\r
typedef struct {\r
  EFI_PHYSICAL_ADDRESS          PhysicalBase;\r
  EFI_VIRTUAL_ADDRESS           VirtualBase;\r
  UINT64                        Length;\r
  ARM_MEMORY_REGION_ATTRIBUTES  Attributes;\r
} ARM_MEMORY_REGION_DESCRIPTOR;\r
\r
typedef VOID (*CACHE_OPERATION)(VOID);\r
typedef VOID (*LINE_OPERATION)(UINTN);\r
\r
//\r
// ARM Processor Mode\r
//\r
typedef enum {\r
  ARM_PROCESSOR_MODE_USER       = 0x10,\r
  ARM_PROCESSOR_MODE_FIQ        = 0x11,\r
  ARM_PROCESSOR_MODE_IRQ        = 0x12,\r
  ARM_PROCESSOR_MODE_SUPERVISOR = 0x13,\r
  ARM_PROCESSOR_MODE_ABORT      = 0x17,\r
  ARM_PROCESSOR_MODE_HYP        = 0x1A,\r
  ARM_PROCESSOR_MODE_UNDEFINED  = 0x1B,\r
  ARM_PROCESSOR_MODE_SYSTEM     = 0x1F,\r
  ARM_PROCESSOR_MODE_MASK       = 0x1F\r
} ARM_PROCESSOR_MODE;\r
\r
//\r
// ARM Cpu IDs\r
//\r
#define ARM_CPU_IMPLEMENTER_MASK          (0xFFU << 24)\r
#define ARM_CPU_IMPLEMENTER_ARMLTD        (0x41U << 24)\r
#define ARM_CPU_IMPLEMENTER_DEC           (0x44U << 24)\r
#define ARM_CPU_IMPLEMENTER_MOT           (0x4DU << 24)\r
#define ARM_CPU_IMPLEMENTER_QUALCOMM      (0x51U << 24)\r
#define ARM_CPU_IMPLEMENTER_MARVELL       (0x56U << 24)\r
\r
#define ARM_CPU_PRIMARY_PART_MASK         (0xFFF << 4)\r
#define ARM_CPU_PRIMARY_PART_CORTEXA5     (0xC05 << 4)\r
#define ARM_CPU_PRIMARY_PART_CORTEXA7     (0xC07 << 4)\r
#define ARM_CPU_PRIMARY_PART_CORTEXA8     (0xC08 << 4)\r
#define ARM_CPU_PRIMARY_PART_CORTEXA9     (0xC09 << 4)\r
#define ARM_CPU_PRIMARY_PART_CORTEXA15    (0xC0F << 4)\r
\r
//\r
// ARM MP Core IDs\r
//\r
#define ARM_CORE_AFF0         0xFF\r
#define ARM_CORE_AFF1         (0xFF << 8)\r
#define ARM_CORE_AFF2         (0xFF << 16)\r
#define ARM_CORE_AFF3         (0xFFULL << 32)\r
\r
#define ARM_CORE_MASK         ARM_CORE_AFF0\r
#define ARM_CLUSTER_MASK      ARM_CORE_AFF1\r
#define GET_CORE_ID(MpId)     ((MpId) & ARM_CORE_MASK)\r
#define GET_CLUSTER_ID(MpId)  (((MpId) & ARM_CLUSTER_MASK) >> 8)\r
#define GET_MPID(ClusterId, CoreId)   (((ClusterId) << 8) | (CoreId))\r
#define PRIMARY_CORE_ID       (PcdGet32(PcdArmPrimaryCore) & ARM_CORE_MASK)\r
\r
UINTN\r
EFIAPI\r
ArmDataCacheLineLength (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmInstructionCacheLineLength (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmCacheWritebackGranule (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmIsArchTimerImplemented (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadIdPfr0 (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadIdPfr1 (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmCacheInfo (\r
  VOID\r
  );\r
\r
BOOLEAN\r
EFIAPI\r
ArmIsMpCore (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmInvalidateDataCache (\r
  VOID\r
  );\r
\r
\r
VOID\r
EFIAPI\r
ArmCleanInvalidateDataCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCleanDataCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmInvalidateInstructionCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmInvalidateDataCacheEntryByMVA (\r
  IN  UINTN   Address\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCleanDataCacheEntryByMVA (\r
  IN  UINTN   Address\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCleanInvalidateDataCacheEntryByMVA (\r
  IN  UINTN   Address\r
  );\r
\r
VOID\r
EFIAPI\r
ArmInvalidateDataCacheEntryBySetWay (\r
  IN  UINTN  SetWayFormat\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCleanDataCacheEntryBySetWay (\r
  IN  UINTN  SetWayFormat\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCleanInvalidateDataCacheEntryBySetWay (\r
  IN  UINTN   SetWayFormat\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableDataCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDisableDataCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableInstructionCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDisableInstructionCache (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableMmu (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDisableMmu (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableCachesAndMmu (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDisableCachesAndMmu (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableInterrupts (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmDisableInterrupts (\r
  VOID\r
  );\r
\r
BOOLEAN\r
EFIAPI\r
ArmGetInterruptState (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableAsynchronousAbort (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmDisableAsynchronousAbort (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableIrq (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmDisableIrq (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableFiq (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmDisableFiq (\r
  VOID\r
  );\r
\r
BOOLEAN\r
EFIAPI\r
ArmGetFiqState (\r
  VOID\r
  );\r
\r
/**\r
 * Invalidate Data and Instruction TLBs\r
 */\r
VOID\r
EFIAPI\r
ArmInvalidateTlb (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmUpdateTranslationTableEntry (\r
  IN  VOID     *TranslationTableEntry,\r
  IN  VOID     *Mva\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetDomainAccessControl (\r
  IN  UINT32  Domain\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetTTBR0 (\r
  IN  VOID  *TranslationTableBase\r
  );\r
\r
VOID *\r
EFIAPI\r
ArmGetTTBR0BaseAddress (\r
  VOID\r
  );\r
\r
RETURN_STATUS\r
EFIAPI\r
ArmConfigureMmu (\r
  IN  ARM_MEMORY_REGION_DESCRIPTOR  *MemoryTable,\r
  OUT VOID                         **TranslationTableBase OPTIONAL,\r
  OUT UINTN                         *TranslationTableSize  OPTIONAL\r
  );\r
\r
BOOLEAN\r
EFIAPI\r
ArmMmuEnabled (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableBranchPrediction (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDisableBranchPrediction (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetLowVectors (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetHighVectors (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDataMemoryBarrier (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmDataSynchronizationBarrier (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmInstructionSynchronizationBarrier (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteVBar (\r
  IN  UINTN   VectorBase\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadVBar (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteAuxCr (\r
  IN  UINT32    Bit\r
  );\r
\r
UINT32\r
EFIAPI\r
ArmReadAuxCr (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetAuxCrBit (\r
  IN  UINT32    Bits\r
  );\r
\r
VOID\r
EFIAPI\r
ArmUnsetAuxCrBit (\r
  IN  UINT32    Bits\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCallSEV (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCallWFE (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmCallWFI (\r
\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadMpidr (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadMidr (\r
  VOID\r
  );\r
\r
UINT32\r
EFIAPI\r
ArmReadCpacr (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteCpacr (\r
  IN  UINT32   Access\r
  );\r
\r
VOID\r
EFIAPI\r
ArmEnableVFP (\r
  VOID\r
  );\r
\r
/**\r
  Get the Secure Configuration Register value\r
\r
  @return   Value read from the Secure Configuration Register\r
\r
**/\r
UINT32\r
EFIAPI\r
ArmReadScr (\r
  VOID\r
  );\r
\r
/**\r
  Set the Secure Configuration Register\r
\r
  @param Value   Value to write to the Secure Configuration Register\r
\r
**/\r
VOID\r
EFIAPI\r
ArmWriteScr (\r
  IN  UINT32   Value\r
  );\r
\r
UINT32\r
EFIAPI\r
ArmReadMVBar (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteMVBar (\r
  IN  UINT32   VectorMonitorBase\r
  );\r
\r
UINT32\r
EFIAPI\r
ArmReadSctlr (\r
  VOID\r
  );\r
\r
UINTN\r
EFIAPI\r
ArmReadHVBar (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteHVBar (\r
  IN  UINTN   HypModeVectorBase\r
  );\r
\r
\r
//\r
// Helper functions for accessing CPU ACTLR\r
//\r
\r
UINTN\r
EFIAPI\r
ArmReadCpuActlr (\r
  VOID\r
  );\r
\r
VOID\r
EFIAPI\r
ArmWriteCpuActlr (\r
  IN  UINTN Val\r
  );\r
\r
VOID\r
EFIAPI\r
ArmSetCpuActlrBit (\r
  IN  UINTN    Bits\r
  );\r
\r
VOID\r
EFIAPI\r
ArmUnsetCpuActlrBit (\r
  IN  UINTN    Bits\r
  );\r
\r
RETURN_STATUS\r
ArmSetMemoryRegionNoExec (\r
  IN  EFI_PHYSICAL_ADDRESS      BaseAddress,\r
  IN  UINT64                    Length\r
  );\r
\r
RETURN_STATUS\r
ArmClearMemoryRegionNoExec (\r
  IN  EFI_PHYSICAL_ADDRESS      BaseAddress,\r
  IN  UINT64                    Length\r
  );\r
\r
RETURN_STATUS\r
ArmSetMemoryRegionReadOnly (\r
  IN  EFI_PHYSICAL_ADDRESS      BaseAddress,\r
  IN  UINT64                    Length\r
  );\r
\r
RETURN_STATUS\r
ArmClearMemoryRegionReadOnly (\r
  IN  EFI_PHYSICAL_ADDRESS      BaseAddress,\r
  IN  UINT64                    Length\r
  );\r
\r
#endif // __ARM_LIB__\r
Commit	Line	Data
1e57a462	1	/** @file\r
	2	\r
	3	Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>\r
90ed18ca	4	Copyright (c) 2011 - 2015, ARM Ltd. All rights reserved.<BR>\r
1e57a462	5	\r
	6	This program and the accompanying materials\r
	7	are licensed and made available under the terms and conditions of the BSD License\r
	8	which accompanies this distribution. The full text of the license may be found at\r
	9	http://opensource.org/licenses/bsd-license.php\r
	10	\r
	11	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	12	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	13	\r
	14	**/\r
	15	\r
	16	#ifndef __ARM_LIB__\r
	17	#define __ARM_LIB__\r
	18	\r
	19	#include <Uefi/UefiBaseType.h>\r
	20	\r
25402f5d	21	#ifdef MDE_CPU_ARM\r
70119d27	22	#include <Chipset/ArmV7.h>\r
25402f5d HL	23	#elif defined(MDE_CPU_AARCH64)\r
25402f5d HL	24	#include <Chipset/AArch64.h>\r
1e57a462	25	#else\r
25402f5d	26	#error "Unknown chipset."\r
1e57a462	27	#endif\r
1e57a462	28	\r
1e57a462	29	/**\r
	30	* The UEFI firmware must not use the ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_* attributes.\r
	31	*\r
	32	* The Non Secure memory attribute (ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_*) should only\r
	33	* be used in Secure World to distinguished Secure to Non-Secure memory.\r
	34	*/\r
	35	typedef enum {\r
	36	ARM_MEMORY_REGION_ATTRIBUTE_UNCACHED_UNBUFFERED = 0,\r
	37	ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_UNCACHED_UNBUFFERED,\r
	38	ARM_MEMORY_REGION_ATTRIBUTE_WRITE_BACK,\r
	39	ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_WRITE_BACK,\r
	40	ARM_MEMORY_REGION_ATTRIBUTE_WRITE_THROUGH,\r
	41	ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_WRITE_THROUGH,\r
	42	ARM_MEMORY_REGION_ATTRIBUTE_DEVICE,\r
	43	ARM_MEMORY_REGION_ATTRIBUTE_NONSECURE_DEVICE\r
	44	} ARM_MEMORY_REGION_ATTRIBUTES;\r
	45	\r
	46	#define IS_ARM_MEMORY_REGION_ATTRIBUTES_SECURE(attr) ((UINT32)(attr) & 1)\r
	47	\r
	48	typedef struct {\r
	49	EFI_PHYSICAL_ADDRESS PhysicalBase;\r
	50	EFI_VIRTUAL_ADDRESS VirtualBase;\r
c357fd6a	51	UINT64 Length;\r
1e57a462	52	ARM_MEMORY_REGION_ATTRIBUTES Attributes;\r
	53	} ARM_MEMORY_REGION_DESCRIPTOR;\r
	54	\r
	55	typedef VOID (*CACHE_OPERATION)(VOID);\r
	56	typedef VOID (*LINE_OPERATION)(UINTN);\r
	57	\r
	58	//\r
	59	// ARM Processor Mode\r
	60	//\r
	61	typedef enum {\r
	62	ARM_PROCESSOR_MODE_USER = 0x10,\r
	63	ARM_PROCESSOR_MODE_FIQ = 0x11,\r
	64	ARM_PROCESSOR_MODE_IRQ = 0x12,\r
	65	ARM_PROCESSOR_MODE_SUPERVISOR = 0x13,\r
	66	ARM_PROCESSOR_MODE_ABORT = 0x17,\r
	67	ARM_PROCESSOR_MODE_HYP = 0x1A,\r
	68	ARM_PROCESSOR_MODE_UNDEFINED = 0x1B,\r
	69	ARM_PROCESSOR_MODE_SYSTEM = 0x1F,\r
	70	ARM_PROCESSOR_MODE_MASK = 0x1F\r
	71	} ARM_PROCESSOR_MODE;\r
	72	\r
	73	//\r
	74	// ARM Cpu IDs\r
	75	//\r
	76	#define ARM_CPU_IMPLEMENTER_MASK (0xFFU << 24)\r
	77	#define ARM_CPU_IMPLEMENTER_ARMLTD (0x41U << 24)\r
	78	#define ARM_CPU_IMPLEMENTER_DEC (0x44U << 24)\r
	79	#define ARM_CPU_IMPLEMENTER_MOT (0x4DU << 24)\r
	80	#define ARM_CPU_IMPLEMENTER_QUALCOMM (0x51U << 24)\r
	81	#define ARM_CPU_IMPLEMENTER_MARVELL (0x56U << 24)\r
	82	\r
	83	#define ARM_CPU_PRIMARY_PART_MASK (0xFFF << 4)\r
	84	#define ARM_CPU_PRIMARY_PART_CORTEXA5 (0xC05 << 4)\r
	85	#define ARM_CPU_PRIMARY_PART_CORTEXA7 (0xC07 << 4)\r
	86	#define ARM_CPU_PRIMARY_PART_CORTEXA8 (0xC08 << 4)\r
	87	#define ARM_CPU_PRIMARY_PART_CORTEXA9 (0xC09 << 4)\r
	88	#define ARM_CPU_PRIMARY_PART_CORTEXA15 (0xC0F << 4)\r
	89	\r
	90	//\r
	91	// ARM MP Core IDs\r
	92	//\r
90ed18ca OM	93	#define ARM_CORE_AFF0 0xFF\r
	94	#define ARM_CORE_AFF1 (0xFF << 8)\r
	95	#define ARM_CORE_AFF2 (0xFF << 16)\r
	96	#define ARM_CORE_AFF3 (0xFFULL << 32)\r
	97	\r
	98	#define ARM_CORE_MASK ARM_CORE_AFF0\r
	99	#define ARM_CLUSTER_MASK ARM_CORE_AFF1\r
1e57a462	100	#define GET_CORE_ID(MpId) ((MpId) & ARM_CORE_MASK)\r
1e57a462	101	#define GET_CLUSTER_ID(MpId) (((MpId) & ARM_CLUSTER_MASK) >> 8)\r
e359565e	102	#define GET_MPID(ClusterId, CoreId) (((ClusterId) << 8) \| (CoreId))\r
1e57a462	103	#define PRIMARY_CORE_ID (PcdGet32(PcdArmPrimaryCore) & ARM_CORE_MASK)\r
1e57a462	104	\r
1e57a462	105	UINTN\r
	106	EFIAPI\r
	107	ArmDataCacheLineLength (\r
	108	VOID\r
	109	);\r
3402aac7	110	\r
1e57a462	111	UINTN\r
	112	EFIAPI\r
	113	ArmInstructionCacheLineLength (\r
	114	VOID\r
	115	);\r
168d7245	116	\r
c653fc2a AB	117	UINTN\r
	118	EFIAPI\r
	119	ArmCacheWritebackGranule (\r
	120	VOID\r
	121	);\r
	122	\r
168d7245 OM	123	UINTN\r
	124	EFIAPI\r
	125	ArmIsArchTimerImplemented (\r
	126	VOID\r
	127	);\r
	128	\r
	129	UINTN\r
	130	EFIAPI\r
	131	ArmReadIdPfr0 (\r
	132	VOID\r
	133	);\r
	134	\r
	135	UINTN\r
	136	EFIAPI\r
	137	ArmReadIdPfr1 (\r
	138	VOID\r
	139	);\r
	140	\r
64751727	141	UINTN\r
1e57a462	142	EFIAPI\r
64751727	143	ArmCacheInfo (\r
1e57a462	144	VOID\r
	145	);\r
	146	\r
	147	BOOLEAN\r
	148	EFIAPI\r
	149	ArmIsMpCore (\r
	150	VOID\r
	151	);\r
	152	\r
	153	VOID\r
	154	EFIAPI\r
	155	ArmInvalidateDataCache (\r
	156	VOID\r
	157	);\r
	158	\r
	159	\r
	160	VOID\r
	161	EFIAPI\r
	162	ArmCleanInvalidateDataCache (\r
	163	VOID\r
	164	);\r
	165	\r
	166	VOID\r
	167	EFIAPI\r
	168	ArmCleanDataCache (\r
	169	VOID\r
	170	);\r
	171	\r
1e57a462	172	VOID\r
	173	EFIAPI\r
	174	ArmInvalidateInstructionCache (\r
	175	VOID\r
	176	);\r
	177	\r
	178	VOID\r
	179	EFIAPI\r
	180	ArmInvalidateDataCacheEntryByMVA (\r
	181	IN UINTN Address\r
	182	);\r
	183	\r
	184	VOID\r
	185	EFIAPI\r
	186	ArmCleanDataCacheEntryByMVA (\r
	187	IN UINTN Address\r
	188	);\r
	189	\r
	190	VOID\r
	191	EFIAPI\r
	192	ArmCleanInvalidateDataCacheEntryByMVA (\r
	193	IN UINTN Address\r
	194	);\r
	195	\r
0ff0e414 OM	196	VOID\r
	197	EFIAPI\r
	198	ArmInvalidateDataCacheEntryBySetWay (\r
	199	IN UINTN SetWayFormat\r
	200	);\r
	201	\r
	202	VOID\r
	203	EFIAPI\r
	204	ArmCleanDataCacheEntryBySetWay (\r
	205	IN UINTN SetWayFormat\r
	206	);\r
	207	\r
	208	VOID\r
	209	EFIAPI\r
	210	ArmCleanInvalidateDataCacheEntryBySetWay (\r
	211	IN UINTN SetWayFormat\r
	212	);\r
	213	\r
1e57a462	214	VOID\r
	215	EFIAPI\r
	216	ArmEnableDataCache (\r
	217	VOID\r
	218	);\r
	219	\r
	220	VOID\r
	221	EFIAPI\r
	222	ArmDisableDataCache (\r
	223	VOID\r
	224	);\r
	225	\r
	226	VOID\r
	227	EFIAPI\r
	228	ArmEnableInstructionCache (\r
	229	VOID\r
	230	);\r
	231	\r
	232	VOID\r
	233	EFIAPI\r
	234	ArmDisableInstructionCache (\r
	235	VOID\r
	236	);\r
3402aac7	237	\r
1e57a462	238	VOID\r
	239	EFIAPI\r
	240	ArmEnableMmu (\r
	241	VOID\r
	242	);\r
	243	\r
	244	VOID\r
	245	EFIAPI\r
	246	ArmDisableMmu (\r
	247	VOID\r
	248	);\r
	249	\r
0ff0e414 OM	250	VOID\r
	251	EFIAPI\r
	252	ArmEnableCachesAndMmu (\r
	253	VOID\r
	254	);\r
	255	\r
1e57a462	256	VOID\r
	257	EFIAPI\r
	258	ArmDisableCachesAndMmu (\r
	259	VOID\r
	260	);\r
	261	\r
1e57a462	262	VOID\r
	263	EFIAPI\r
	264	ArmEnableInterrupts (\r
	265	VOID\r
	266	);\r
	267	\r
	268	UINTN\r
	269	EFIAPI\r
	270	ArmDisableInterrupts (\r
	271	VOID\r
	272	);\r
47585ed5	273	\r
1e57a462	274	BOOLEAN\r
	275	EFIAPI\r
	276	ArmGetInterruptState (\r
	277	VOID\r
	278	);\r
	279	\r
0ff0e414 OM	280	VOID\r
	281	EFIAPI\r
	282	ArmEnableAsynchronousAbort (\r
	283	VOID\r
	284	);\r
	285	\r
47585ed5	286	UINTN\r
47585ed5	287	EFIAPI\r
0ff0e414	288	ArmDisableAsynchronousAbort (\r
47585ed5	289	VOID\r
	290	);\r
	291	\r
	292	VOID\r
	293	EFIAPI\r
	294	ArmEnableIrq (\r
	295	VOID\r
	296	);\r
	297	\r
0ff0e414 OM	298	UINTN\r
	299	EFIAPI\r
	300	ArmDisableIrq (\r
	301	VOID\r
	302	);\r
	303	\r
1e57a462	304	VOID\r
	305	EFIAPI\r
	306	ArmEnableFiq (\r
	307	VOID\r
	308	);\r
	309	\r
	310	UINTN\r
	311	EFIAPI\r
	312	ArmDisableFiq (\r
	313	VOID\r
	314	);\r
3402aac7	315	\r
1e57a462	316	BOOLEAN\r
	317	EFIAPI\r
	318	ArmGetFiqState (\r
	319	VOID\r
	320	);\r
	321	\r
8dd618d2 OM	322	/**\r
	323	* Invalidate Data and Instruction TLBs\r
	324	*/\r
1e57a462	325	VOID\r
	326	EFIAPI\r
	327	ArmInvalidateTlb (\r
	328	VOID\r
	329	);\r
3402aac7	330	\r
1e57a462	331	VOID\r
	332	EFIAPI\r
	333	ArmUpdateTranslationTableEntry (\r
	334	IN VOID *TranslationTableEntry,\r
	335	IN VOID *Mva\r
	336	);\r
3402aac7	337	\r
1e57a462	338	VOID\r
	339	EFIAPI\r
	340	ArmSetDomainAccessControl (\r
	341	IN UINT32 Domain\r
	342	);\r
	343	\r
	344	VOID\r
	345	EFIAPI\r
	346	ArmSetTTBR0 (\r
	347	IN VOID *TranslationTableBase\r
	348	);\r
	349	\r
	350	VOID *\r
	351	EFIAPI\r
	352	ArmGetTTBR0BaseAddress (\r
	353	VOID\r
	354	);\r
	355	\r
6f050ad6	356	RETURN_STATUS\r
1e57a462	357	EFIAPI\r
	358	ArmConfigureMmu (\r
	359	IN ARM_MEMORY_REGION_DESCRIPTOR *MemoryTable,\r
6f050ad6	360	OUT VOID **TranslationTableBase OPTIONAL,\r
1e57a462	361	OUT UINTN *TranslationTableSize OPTIONAL\r
1e57a462	362	);\r
3402aac7	363	\r
1e57a462	364	BOOLEAN\r
	365	EFIAPI\r
	366	ArmMmuEnabled (\r
	367	VOID\r
	368	);\r
3402aac7	369	\r
1e57a462	370	VOID\r
	371	EFIAPI\r
	372	ArmEnableBranchPrediction (\r
	373	VOID\r
	374	);\r
	375	\r
	376	VOID\r
	377	EFIAPI\r
	378	ArmDisableBranchPrediction (\r
	379	VOID\r
	380	);\r
	381	\r
	382	VOID\r
	383	EFIAPI\r
	384	ArmSetLowVectors (\r
	385	VOID\r
	386	);\r
	387	\r
	388	VOID\r
	389	EFIAPI\r
	390	ArmSetHighVectors (\r
	391	VOID\r
	392	);\r
	393	\r
	394	VOID\r
	395	EFIAPI\r
	396	ArmDataMemoryBarrier (\r
	397	VOID\r
	398	);\r
3402aac7	399	\r
1e57a462	400	VOID\r
1e57a462	401	EFIAPI\r
cf93a378	402	ArmDataSynchronizationBarrier (\r
1e57a462	403	VOID\r
1e57a462	404	);\r
3402aac7	405	\r
1e57a462	406	VOID\r
	407	EFIAPI\r
	408	ArmInstructionSynchronizationBarrier (\r
	409	VOID\r
	410	);\r
	411	\r
	412	VOID\r
	413	EFIAPI\r
	414	ArmWriteVBar (\r
4e57d6d7	415	IN UINTN VectorBase\r
1e57a462	416	);\r
1e57a462	417	\r
4e57d6d7	418	UINTN\r
1e57a462	419	EFIAPI\r
	420	ArmReadVBar (\r
	421	VOID\r
	422	);\r
	423	\r
	424	VOID\r
	425	EFIAPI\r
	426	ArmWriteAuxCr (\r
	427	IN UINT32 Bit\r
	428	);\r
	429	\r
	430	UINT32\r
	431	EFIAPI\r
	432	ArmReadAuxCr (\r
	433	VOID\r
	434	);\r
	435	\r
	436	VOID\r
	437	EFIAPI\r
	438	ArmSetAuxCrBit (\r
	439	IN UINT32 Bits\r
	440	);\r
	441	\r
	442	VOID\r
	443	EFIAPI\r
	444	ArmUnsetAuxCrBit (\r
	445	IN UINT32 Bits\r
	446	);\r
	447	\r
	448	VOID\r
	449	EFIAPI\r
	450	ArmCallSEV (\r
	451	VOID\r
	452	);\r
	453	\r
	454	VOID\r
	455	EFIAPI\r
	456	ArmCallWFE (\r
	457	VOID\r
	458	);\r
	459	\r
	460	VOID\r
	461	EFIAPI\r
	462	ArmCallWFI (\r
25402f5d	463	\r
1e57a462	464	VOID\r
	465	);\r
	466	\r
	467	UINTN\r
	468	EFIAPI\r
	469	ArmReadMpidr (\r
	470	VOID\r
	471	);\r
	472	\r
9401d6f4 OM	473	UINTN\r
	474	EFIAPI\r
	475	ArmReadMidr (\r
	476	VOID\r
	477	);\r
	478	\r
1e57a462	479	UINT32\r
	480	EFIAPI\r
	481	ArmReadCpacr (\r
	482	VOID\r
	483	);\r
	484	\r
	485	VOID\r
	486	EFIAPI\r
	487	ArmWriteCpacr (\r
	488	IN UINT32 Access\r
	489	);\r
	490	\r
	491	VOID\r
	492	EFIAPI\r
	493	ArmEnableVFP (\r
	494	VOID\r
	495	);\r
	496	\r
46d4d75c OM	497	/**\r
	498	Get the Secure Configuration Register value\r
	499	\r
	500	@return Value read from the Secure Configuration Register\r
	501	\r
	502	**/\r
1e57a462	503	UINT32\r
	504	EFIAPI\r
	505	ArmReadScr (\r
	506	VOID\r
	507	);\r
	508	\r
46d4d75c OM	509	/**\r
	510	Set the Secure Configuration Register\r
	511	\r
	512	@param Value Value to write to the Secure Configuration Register\r
	513	\r
	514	**/\r
1e57a462	515	VOID\r
	516	EFIAPI\r
	517	ArmWriteScr (\r
46d4d75c	518	IN UINT32 Value\r
1e57a462	519	);\r
	520	\r
	521	UINT32\r
	522	EFIAPI\r
	523	ArmReadMVBar (\r
	524	VOID\r
	525	);\r
	526	\r
	527	VOID\r
	528	EFIAPI\r
	529	ArmWriteMVBar (\r
	530	IN UINT32 VectorMonitorBase\r
	531	);\r
	532	\r
	533	UINT32\r
	534	EFIAPI\r
	535	ArmReadSctlr (\r
	536	VOID\r
	537	);\r
	538	\r
5ea2c2d3	539	UINTN\r
	540	EFIAPI\r
	541	ArmReadHVBar (\r
	542	VOID\r
	543	);\r
	544	\r
	545	VOID\r
	546	EFIAPI\r
	547	ArmWriteHVBar (\r
	548	IN UINTN HypModeVectorBase\r
	549	);\r
	550	\r
52d44f77 OM	551	\r
	552	//\r
	553	// Helper functions for accessing CPU ACTLR\r
	554	//\r
	555	\r
	556	UINTN\r
	557	EFIAPI\r
	558	ArmReadCpuActlr (\r
	559	VOID\r
	560	);\r
	561	\r
	562	VOID\r
	563	EFIAPI\r
	564	ArmWriteCpuActlr (\r
	565	IN UINTN Val\r
	566	);\r
	567	\r
	568	VOID\r
	569	EFIAPI\r
	570	ArmSetCpuActlrBit (\r
	571	IN UINTN Bits\r
	572	);\r
	573	\r
	574	VOID\r
	575	EFIAPI\r
	576	ArmUnsetCpuActlrBit (\r
	577	IN UINTN Bits\r
	578	);\r
	579	\r
4d9a4f62 AB	580	RETURN_STATUS\r
	581	ArmSetMemoryRegionNoExec (\r
	582	IN EFI_PHYSICAL_ADDRESS BaseAddress,\r
	583	IN UINT64 Length\r
	584	);\r
	585	\r
	586	RETURN_STATUS\r
	587	ArmClearMemoryRegionNoExec (\r
	588	IN EFI_PHYSICAL_ADDRESS BaseAddress,\r
	589	IN UINT64 Length\r
	590	);\r
	591	\r
	592	RETURN_STATUS\r
	593	ArmSetMemoryRegionReadOnly (\r
	594	IN EFI_PHYSICAL_ADDRESS BaseAddress,\r
	595	IN UINT64 Length\r
	596	);\r
	597	\r
	598	RETURN_STATUS\r
	599	ArmClearMemoryRegionReadOnly (\r
	600	IN EFI_PHYSICAL_ADDRESS BaseAddress,\r
	601	IN UINT64 Length\r
	602	);\r
	603	\r
1e57a462	604	#endif // __ARM_LIB__\r