mirror of https://github.com/acidanthera/audk.git
EmbeddedPkg: add platform boot manager protocol
Create the PlatformBootManagerProtocol that is used to add predefined boot options in platform driver. This interface will be used in ArmPkg/PlatformBootManagerLib. Cc: Laszlo Ersek <lersek@redhat.com> Cc: Leif Lindholm <leif.lindholm@linaro.org> Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org> Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Haojian Zhuang <haojian.zhuang@linaro.org> Reviewed-by: Laszlo Ersek <lersek@redhat.com> Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
This commit is contained in:
parent
76022b02e8
commit
7e074d15e7
|
@ -81,6 +81,7 @@
|
|||
gAndroidFastbootTransportProtocolGuid = { 0x74bd9fe0, 0x8902, 0x11e3, {0xb9, 0xd3, 0xf7, 0x22, 0x38, 0xfc, 0x9a, 0x31}}
|
||||
gAndroidFastbootPlatformProtocolGuid = { 0x524685a0, 0x89a0, 0x11e3, {0x9d, 0x4d, 0xbf, 0xa9, 0xf6, 0xa4, 0x03, 0x08}}
|
||||
gUsbDeviceProtocolGuid = { 0x021bd2ca, 0x51d2, 0x11e3, {0x8e, 0x56, 0xb7, 0x54, 0x17, 0xc7, 0x0b, 0x44 }}
|
||||
gPlatformBootManagerProtocolGuid = { 0x7197c8a7, 0x6559, 0x4c93, { 0x93, 0xd5, 0x8a, 0x84, 0xf9, 0x88, 0x79, 0x8b }}
|
||||
gPlatformGpioProtocolGuid = { 0x52ce9845, 0x5af4, 0x43e2, {0xba, 0xfd, 0x23, 0x08, 0x12, 0x54, 0x7a, 0xc2 }}
|
||||
gPlatformVirtualKeyboardProtocolGuid = { 0x0e3606d2, 0x1dc3, 0x4e6f, { 0xbe, 0x65, 0x39, 0x49, 0x82, 0xa2, 0x65, 0x47 }}
|
||||
gAndroidBootImgProtocolGuid = { 0x9859bb19, 0x407c, 0x4f8b, {0xbc, 0xe1, 0xf8, 0xda, 0x65, 0x65, 0xf4, 0xa5 }}
|
||||
|
|
|
@ -0,0 +1,86 @@
|
|||
/** @file
|
||||
|
||||
Copyright (c) 2018, Linaro. 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 __PLATFORM_BOOT_MANAGER_PROTOCOL_H__
|
||||
#define __PLATFORM_BOOT_MANAGER_PROTOCOL_H__
|
||||
|
||||
//
|
||||
// Protocol interface structure
|
||||
//
|
||||
typedef struct _PLATFORM_BOOT_MANAGER_PROTOCOL PLATFORM_BOOT_MANAGER_PROTOCOL;
|
||||
|
||||
//
|
||||
// Function Prototypes
|
||||
//
|
||||
|
||||
/*
|
||||
Get predefined boot options for platform.
|
||||
|
||||
@param[out] Count The number of elements in each of
|
||||
BootOptions and BootKeys. On successful
|
||||
return, Count is at least one.
|
||||
|
||||
@param[out] BootOptions An array of platform boot options.
|
||||
BootOptions is pool-allocated by
|
||||
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS, and
|
||||
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS populates
|
||||
every element in BootOptions with
|
||||
EfiBootManagerInitializeLoadOption().
|
||||
BootOptions shall not contain duplicate
|
||||
entries. The caller is responsible for
|
||||
releasing BootOptions after use with
|
||||
EfiBootManagerFreeLoadOptions().
|
||||
|
||||
@param[out] BootKeys A pool-allocated array of platform boot
|
||||
hotkeys. For every 0 <= Index < Count, if
|
||||
BootOptions[Index] is not to be associated
|
||||
with a hotkey, then BootKeys[Index] is
|
||||
zero-filled. Otherwise, BootKeys[Index]
|
||||
specifies the boot hotkey for
|
||||
BootOptions[Index]. BootKeys shall not
|
||||
contain duplicate entries (other than
|
||||
zero-filled entries). The caller is
|
||||
responsible for releasing BootKeys with
|
||||
FreePool() after use.
|
||||
|
||||
@retval EFI_SUCCESS Count, BootOptions and BootKeys have
|
||||
been set.
|
||||
|
||||
@retval EFI_OUT_OF_RESOURCES Memory allocation failed.
|
||||
|
||||
@retval EFI_UNSUPPORTED The platform doesn't provide boot options
|
||||
as a feature.
|
||||
|
||||
@retval EFI_NOT_FOUND The platform could provide boot options
|
||||
as a feature, but none have been
|
||||
configured.
|
||||
|
||||
@return Error codes propagated from underlying
|
||||
functions.
|
||||
*/
|
||||
typedef
|
||||
EFI_STATUS
|
||||
(EFIAPI *GET_PLATFORM_BOOT_OPTIONS_AND_KEYS) (
|
||||
OUT UINTN *Count,
|
||||
OUT EFI_BOOT_MANAGER_LOAD_OPTION **BootOptions,
|
||||
OUT EFI_INPUT_KEY **BootKeys
|
||||
);
|
||||
|
||||
struct _PLATFORM_BOOT_MANAGER_PROTOCOL {
|
||||
GET_PLATFORM_BOOT_OPTIONS_AND_KEYS GetPlatformBootOptionsAndKeys;
|
||||
};
|
||||
|
||||
extern EFI_GUID gPlatformBootManagerProtocolGuid;
|
||||
|
||||
#endif /* __PLATFORM_BOOT_MANAGER_PROTOCOL_H__ */
|
Loading…
Reference in New Issue