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/MdePkg/Include/Protocol/Runtime.h b/uefi/linaro-edk2/MdePkg/Include/Protocol/Runtime.h
new file mode 100644
index 0000000..dfa7e5b
--- /dev/null
+++ b/uefi/linaro-edk2/MdePkg/Include/Protocol/Runtime.h
@@ -0,0 +1,128 @@
+/** @file

+  Runtime Architectural Protocol as defined in PI Specification VOLUME 2 DXE

+

+  Allows the runtime functionality of the DXE Foundation to be contained 

+  in a separate driver. It also provides hooks for the DXE Foundation to 

+  export information that is needed at runtime. As such, this protocol allows 

+  services to the DXE Foundation to manage runtime drivers and events. 

+  This protocol also implies that the runtime services required to transition 

+  to virtual mode, SetVirtualAddressMap() and ConvertPointer(), have been 

+  registered into the UEFI Runtime Table in the UEFI System Table. This protocol 

+  must be produced by a runtime DXE driver and may only be consumed by the DXE Foundation.

+

+  Copyright (c) 2006 - 2008, 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 __ARCH_PROTOCOL_RUNTIME_H__

+#define __ARCH_PROTOCOL_RUNTIME_H__

+

+///

+/// Global ID for the Runtime Architectural Protocol

+///

+#define EFI_RUNTIME_ARCH_PROTOCOL_GUID \

+  { 0xb7dfb4e1, 0x52f, 0x449f, {0x87, 0xbe, 0x98, 0x18, 0xfc, 0x91, 0xb7, 0x33 } }

+

+typedef struct _EFI_RUNTIME_ARCH_PROTOCOL  EFI_RUNTIME_ARCH_PROTOCOL;

+

+///

+/// LIST_ENTRY from BaseType 

+///

+typedef LIST_ENTRY EFI_LIST_ENTRY;

+

+typedef struct _EFI_RUNTIME_IMAGE_ENTRY  EFI_RUNTIME_IMAGE_ENTRY;

+

+///

+/// EFI_RUNTIME_IMAGE_ENTRY

+///

+struct _EFI_RUNTIME_IMAGE_ENTRY {

+  ///

+  /// Start of image that has been loaded in memory. It is a pointer 

+  /// to either the DOS header or PE header of the image.

+  ///

+  VOID                    *ImageBase;

+  ///

+  /// Size in bytes of the image represented by ImageBase.

+  ///

+  UINT64                  ImageSize;

+  ///

+  /// Information about the fix-ups that were performed on ImageBase when it was

+  /// loaded into memory.

+  ///

+  VOID                    *RelocationData;

+  ///

+  /// The ImageHandle passed into ImageBase when it was loaded.

+  ///

+  EFI_HANDLE              Handle;

+  ///

+  /// Entry for this node in the EFI_RUNTIME_ARCHITECTURE_PROTOCOL.ImageHead list.

+  ///

+  EFI_LIST_ENTRY          Link;

+};

+

+typedef struct _EFI_RUNTIME_EVENT_ENTRY  EFI_RUNTIME_EVENT_ENTRY;

+

+///

+/// EFI_RUNTIME_EVENT_ENTRY

+///

+struct _EFI_RUNTIME_EVENT_ENTRY {

+  ///

+  /// The same as Type passed into CreateEvent().

+  ///

+  UINT32                  Type;

+  ///

+  /// The same as NotifyTpl passed into CreateEvent().

+  ///

+  EFI_TPL                 NotifyTpl;

+  ///

+  /// The same as NotifyFunction passed into CreateEvent().

+  ///

+  EFI_EVENT_NOTIFY        NotifyFunction;

+  ///

+  /// The same as NotifyContext passed into CreateEvent().

+  ///

+  VOID                    *NotifyContext;

+  ///

+  /// The EFI_EVENT returned by CreateEvent(). Event must be in runtime memory.

+  ///

+  EFI_EVENT               *Event;

+  ///

+  /// Entry for this node in the

+  /// EFI_RUNTIME_ARCHITECTURE_PROTOCOL.EventHead list.

+  ///

+  EFI_LIST_ENTRY          Link;

+};

+

+///

+/// Allows the runtime functionality of the DXE Foundation to be contained in a 

+/// separate driver. It also provides hooks for the DXE Foundation to export 

+/// information that is needed at runtime. As such, this protocol allows the DXE 

+/// Foundation to manage runtime drivers and events. This protocol also implies 

+/// that the runtime services required to transition to virtual mode, 

+/// SetVirtualAddressMap() and ConvertPointer(), have been registered into the 

+/// EFI Runtime Table in the EFI System Partition.  This protocol must be produced 

+/// by a runtime DXE driver and may only be consumed by the DXE Foundation.

+///

+struct _EFI_RUNTIME_ARCH_PROTOCOL {

+  EFI_LIST_ENTRY          ImageHead;    ///< A list of type EFI_RUNTIME_IMAGE_ENTRY.

+  EFI_LIST_ENTRY          EventHead;    ///< A list of type EFI_RUNTIME_EVENT_ENTRY.

+  UINTN                   MemoryDescriptorSize;   ///< Size of a memory descriptor that is returned by GetMemoryMap().

+  UINT32                  MemoryDesciptorVersion; ///< Version of a memory descriptor that is returned by GetMemoryMap().

+  UINTN                   MemoryMapSize;///< Size of the memory map in bytes contained in MemoryMapPhysical and MemoryMapVirtual. 

+  EFI_MEMORY_DESCRIPTOR   *MemoryMapPhysical;     ///< Pointer to a runtime buffer that contains a copy of 

+                                                  ///< the memory map returned via GetMemoryMap().

+  EFI_MEMORY_DESCRIPTOR   *MemoryMapVirtual;      ///< Pointer to MemoryMapPhysical that is updated to virtual mode after SetVirtualAddressMap().

+  BOOLEAN                 VirtualMode;  ///< Boolean that is TRUE if SetVirtualAddressMap() has been called.

+  BOOLEAN                 AtRuntime;    ///< Boolean that is TRUE if ExitBootServices () has been called.

+};

+

+extern EFI_GUID gEfiRuntimeArchProtocolGuid;

+

+#endif