EmbeddedPkg: Split off FDT loading functionality from FdtLib

[mirror_edk2.git] / EmbeddedPkg / Include / Library / FdtLoadLib.h

diff --git a/EmbeddedPkg/Include/Library/FdtLoadLib.h b/EmbeddedPkg/Include/Library/FdtLoadLib.h
new file mode 100644 (file)
index 0000000..e08f499
--- /dev/null
+++ b/EmbeddedPkg/Include/Library/FdtLoadLib.h
@@ -0,0 +1,48 @@
+/** @file\r
+*\r
+*  Copyright (c) 2011-2014, ARM Limited. All rights reserved.\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 _FDT_LOAD_LIB_H_\r
+#define _FDT_LOAD_LIB_H_\r
+\r
+/**\r
+  Load and Install FDT from Semihosting\r
+\r
+  @param Filename   Name of the file to load from semihosting\r
+\r
+  @return EFI_SUCCESS           Fdt Blob was successfully installed into the configuration table\r
+                                from semihosting\r
+  @return EFI_NOT_FOUND         Fail to locate the file in semihosting\r
+  @return EFI_OUT_OF_RESOURCES  Fail to allocate memory to contain the blob\r
+**/\r
+EFI_STATUS\r
+InstallFdtFromSemihosting (\r
+  IN  CONST CHAR16*   FileName\r
+  );\r
+\r
+/**\r
+  Load and Install FDT from Firmware Volume\r
+\r
+  @param Filename   Guid of the FDT blob to load from firmware volume\r
+\r
+  @return EFI_SUCCESS           Fdt Blob was successfully installed into the configuration table\r
+                                from firmware volume\r
+  @return EFI_NOT_FOUND         Failed to locate the file in firmware volume\r
+  @return EFI_OUT_OF_RESOURCES  Failed to allocate memory to contain the blob\r
+**/\r
+EFI_STATUS\r
+InstallFdtFromFv (\r
+  IN  CONST EFI_GUID *FileName\r
+  );\r
+\r
+#endif\r