hikey: Add UEFI sources for reference

UEFI needs to be built outside Android build system.
Please follow the instructions in README.

The sources correspond to:
https://github.com/96boards/edk2/commit/14eae0c12e71fd33c4c0fc51e4475e8db02566cf
https://github.com/96boards/arm-trusted-firmware/commit/e9b4909dcd75fc4ae7041cfb83d28ab9adb7afdf
https://github.com/96boards/l-loader/commit/6b784ad5c4ab00e2b1c6f53cd5f74054e5d00a78
https://git.linaro.org/uefi/uefi-tools.git/commit/abe618f8ab72034fff1ce46c9c006a2c6bd40a7e

Change-Id: Ieeefdb63e673e0c8e64e0a1f02c7bddc63b2c7fb
Signed-off-by: Vishal Bhoj <vishal.bhoj@linaro.org>
diff --git a/uefi/linaro-edk2/OvmfPkg/AcpiS3SaveDxe/AcpiS3Save.h b/uefi/linaro-edk2/OvmfPkg/AcpiS3SaveDxe/AcpiS3Save.h
new file mode 100644
index 0000000..65974a3
--- /dev/null
+++ b/uefi/linaro-edk2/OvmfPkg/AcpiS3SaveDxe/AcpiS3Save.h
@@ -0,0 +1,59 @@
+/** @file

+  This is an implementation of the ACPI S3 Save protocol.  This is defined in 

+  S3 boot path specification 0.9.

+

+Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>

+

+This program and the accompanying materials

+are licensed and made available under the terms and conditions

+of the BSD License which accompanies this distribution.  The

+full text of the license may be found at

+http://opensource.org/licenses/bsd-license.php

+

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+

+**/

+

+#ifndef _ACPI_S3_SAVE_H_

+#define _ACPI_S3_SAVE_H_

+

+/**

+  Gets the buffer of legacy memory below 1 MB 

+  This function is to get the buffer in legacy memory below 1MB that is required during S3 resume.

+

+  @param This           A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.

+  @param Size           The returned size of legacy memory below 1 MB.

+

+  @retval EFI_SUCCESS           Size is successfully returned.

+  @retval EFI_INVALID_PARAMETER The pointer Size is NULL.

+

+**/

+EFI_STATUS

+EFIAPI

+LegacyGetS3MemorySize (

+  IN  EFI_ACPI_S3_SAVE_PROTOCOL    * This,

+  OUT UINTN                        * Size

+  );

+

+/**

+  Prepares all information that is needed in the S3 resume boot path.

+  

+  Allocate the resources or prepare informations and save in ACPI variable set for S3 resume boot path  

+  

+  @param This                 A pointer to the EFI_ACPI_S3_SAVE_PROTOCOL instance.

+  @param LegacyMemoryAddress  The base address of legacy memory.

+

+  @retval EFI_NOT_FOUND         Some necessary information cannot be found.

+  @retval EFI_SUCCESS           All information was saved successfully.

+  @retval EFI_OUT_OF_RESOURCES  Resources were insufficient to save all the information.

+  @retval EFI_INVALID_PARAMETER The memory range is not located below 1 MB.

+

+**/

+EFI_STATUS

+EFIAPI

+S3Ready (

+  IN EFI_ACPI_S3_SAVE_PROTOCOL     *This,

+  IN VOID                          *LegacyMemoryAddress   

+  );

+#endif