summaryrefslogtreecommitdiff
path: root/MdeModulePkg/Library/ArmCcaLibNull
diff options
context:
space:
mode:
authorSami Mujawar <sami.mujawar@arm.com>2026-06-04 19:44:21 +0300
committermergify[bot] <37929162+mergify[bot]@users.noreply.github.com>2026-09-29 16:27:06 +0300
commitd45393dc7747cb079fa67924ac61007ee8e89062 (patch)
tree6a745ee4b63f8e258f236d20a55303f55f6a3b10 /MdeModulePkg/Library/ArmCcaLibNull
parent72fa3af90beeee7690ab4626fd372e0baa830fa4 (diff)
downloadedk2-d45393dc7747cb079fa67924ac61007ee8e89062.tar.xz
ArmVirtPkg, MdeModulePkg: Move Arm CCA Library to MdeModulePkg
ArmCcaLib provides helper functions for detecting Realm execution state and caching Realm IPA width. These helpers build on the architectural Arm CCA RSI library and are not specific to ArmVirtPkg. Therefore, move ArmCcaLib, ArmCcaLibNull, their public header, and related GUID declarations to MdeModulePkg. Update ArmVirtPkg library mappings and consumers to use the new MdeModulePkg library instances. Also perform minor non-functional cleanup to the moved INF files by fixing a comment typo and ordering the package dependencies. Continuous-integration-options: PatchCheck.ignore-multi-package Signed-off-by: Sami Mujawar <sami.mujawar@arm.com>
Diffstat (limited to 'MdeModulePkg/Library/ArmCcaLibNull')
-rw-r--r--MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.c74
-rw-r--r--MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.inf28
2 files changed, 102 insertions, 0 deletions
diff --git a/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.c b/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.c
new file mode 100644
index 0000000000..5adbddc6d3
--- /dev/null
+++ b/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.c
@@ -0,0 +1,74 @@
+/** @file
+ Null implemmentation of the ArmCcaLib library.
+
+ Copyright (c) 2022 - 2023, Arm Limited. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+ @par Glossary:
+ - Rsi or RSI - Realm Service Interface
+ - IPA - Intermediate Physical Address
+ - RIPAS - Realm IPA state
+**/
+#include <Base.h>
+
+/**
+ Check if running in a Realm.
+
+ @retval TRUE The execution is within the context of a Realm.
+ @retval FALSE The execution is not within the context of a Realm.
+**/
+BOOLEAN
+EFIAPI
+ArmCcaIsRealm (
+ VOID
+ )
+{
+ return FALSE;
+}
+
+/**
+ Return the IPA width of the Realm.
+
+ The IPA width of the Realm is used to configure the protection attribute
+ for memory regions, see ArmCcaSetMemoryProtectionAttribute().
+
+ @param [out] IpaWidth IPA width of the Realm.
+
+ @retval RETURN_SUCCESS Success.
+ @retval RETURN_INVALID_PARAMETER A parameter is invalid.
+ @retval RETURN_UNSUPPORTED The execution is not within the
+ context of a Realm.
+**/
+RETURN_STATUS
+EFIAPI
+ArmCcaGetIpaWidth (
+ OUT UINT64 *IpaWidth
+ )
+{
+ return RETURN_UNSUPPORTED;
+}
+
+/** Check if the address range is protected MMIO
+
+ @param [in] BaseAddress Base address of the device MMIO region.
+ @param [in] Length Length of the device MMIO region.
+ @param [out] IsProtectedMmio TRUE - if the RIPAS for the address range is
+ protected MMIO.
+ FALSE - if the RIPAS for the address range is
+ not protected MMIO.
+
+ @retval RETURN_SUCCESS Success.
+ @retval RETURN_INVALID_PARAMETER A parameter is invalid.
+ @retval RETURN_UNSUPPORTED The request is not initiated in a
+ Realm.
+**/
+RETURN_STATUS
+EFIAPI
+ArmCcaMemRangeIsProtectedMmio (
+ IN UINT64 BaseAddress,
+ IN UINT64 Length,
+ OUT BOOLEAN *IsProtectedMmio
+ )
+{
+ return RETURN_UNSUPPORTED;
+}
diff --git a/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.inf b/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.inf
new file mode 100644
index 0000000000..a7373aa24e
--- /dev/null
+++ b/MdeModulePkg/Library/ArmCcaLibNull/ArmCcaLibNull.inf
@@ -0,0 +1,28 @@
+## @file
+# Null implementation of the ArmCcaLib library.
+#
+# Copyright (c) 2022 - 2023, Arm Limited. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+ INF_VERSION = 0x0001001B
+ BASE_NAME = ArmCcaLib
+ FILE_GUID = 9E3F7AAA-10A6-4513-A960-B87F4D7DCFC5
+ MODULE_TYPE = BASE
+ VERSION_STRING = 1.0
+ LIBRARY_CLASS = ArmCcaLib
+
+[Sources]
+ ArmCcaLibNull.c
+
+
+[Packages]
+ MdeModulePkg/MdeModulePkg.dec
+ MdePkg/MdePkg.dec
+
+[LibraryClasses]
+ BaseLib
+