460 lines
14 KiB
C
460 lines
14 KiB
C
/** @file
|
|
The platform boot manager reference implementation
|
|
|
|
@copyright
|
|
INTEL CONFIDENTIAL
|
|
Copyright 2004 - 2016 Intel Corporation.
|
|
|
|
The source code contained or described herein and all documents related to the
|
|
source code ("Material") are owned by Intel Corporation or its suppliers or
|
|
licensors. Title to the Material remains with Intel Corporation or its suppliers
|
|
and licensors. The Material may contain trade secrets and proprietary and
|
|
confidential information of Intel Corporation and its suppliers and licensors,
|
|
and is protected by worldwide copyright and trade secret laws and treaty
|
|
provisions. No part of the Material may be used, copied, reproduced, modified,
|
|
published, uploaded, posted, transmitted, distributed, or disclosed in any way
|
|
without Intel's prior express written permission.
|
|
|
|
No license under any patent, copyright, trade secret or other intellectual
|
|
property right is granted to or conferred upon you by disclosure or delivery
|
|
of the Materials, either expressly, by implication, inducement, estoppel or
|
|
otherwise. Any license under such intellectual property rights must be
|
|
express and approved by Intel in writing.
|
|
|
|
Unless otherwise agreed by Intel in writing, you may not remove or alter
|
|
this notice or any other notice embedded in Materials by Intel or
|
|
Intel's suppliers or licensors in any way.
|
|
|
|
This file contains a 'Sample Driver' and is licensed as such under the terms
|
|
of your license agreement with Intel or your vendor. This file may be modified
|
|
by the user, subject to the additional terms of the license agreement.
|
|
|
|
@par Specification Reference:
|
|
|
|
**/
|
|
|
|
#include "BootManager.h"
|
|
|
|
EFI_GUID mBootManagerGuid = BOOT_MANAGER_FORMSET_GUID;
|
|
|
|
GLOBAL_REMOVE_IF_UNREFERENCED UINT16 mKeyInput;
|
|
GLOBAL_REMOVE_IF_UNREFERENCED EFI_BOOT_MANAGER_LOAD_OPTION mBootOption;
|
|
|
|
GLOBAL_REMOVE_IF_UNREFERENCED HII_VENDOR_DEVICE_PATH mBootManagerHiiVendorDevicePath = {
|
|
{
|
|
{
|
|
HARDWARE_DEVICE_PATH,
|
|
HW_VENDOR_DP,
|
|
{
|
|
(UINT8) (sizeof (VENDOR_DEVICE_PATH)),
|
|
(UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8)
|
|
}
|
|
},
|
|
//
|
|
// {1DDDBE15-481D-4d2b-8277-B191EAF66525}
|
|
//
|
|
{ 0x1dddbe15, 0x481d, 0x4d2b, { 0x82, 0x77, 0xb1, 0x91, 0xea, 0xf6, 0x65, 0x25 } }
|
|
},
|
|
{
|
|
END_DEVICE_PATH_TYPE,
|
|
END_ENTIRE_DEVICE_PATH_SUBTYPE,
|
|
{
|
|
(UINT8) (END_DEVICE_PATH_LENGTH),
|
|
(UINT8) ((END_DEVICE_PATH_LENGTH) >> 8)
|
|
}
|
|
}
|
|
};
|
|
|
|
GLOBAL_REMOVE_IF_UNREFERENCED BOOT_MANAGER_CALLBACK_DATA gBootManagerPrivate = {
|
|
BOOT_MANAGER_CALLBACK_DATA_SIGNATURE,
|
|
NULL,
|
|
NULL,
|
|
{
|
|
FakeExtractConfig,
|
|
FakeRouteConfig,
|
|
BootManagerCallback
|
|
}
|
|
};
|
|
|
|
/**
|
|
Removes (trims) specified leading and trailing characters from a string.
|
|
|
|
@param[in, out] Str Pointer to the null-terminated string to be trimmed. On return,
|
|
Str will hold the trimmed string.
|
|
|
|
@param[in] CharC Character will be trimmed from str.
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
StrTrim (
|
|
IN OUT CHAR16 *Str,
|
|
IN CHAR16 CharC
|
|
)
|
|
{
|
|
CHAR16 *Pointer1;
|
|
CHAR16 *Pointer2;
|
|
|
|
if (*Str == 0) {
|
|
return;
|
|
}
|
|
|
|
//
|
|
// Trim off the leading and trailing characters c
|
|
//
|
|
for (Pointer1 = Str; (*Pointer1 != 0) && (*Pointer1 == CharC); Pointer1++) {
|
|
;
|
|
}
|
|
|
|
Pointer2 = Str;
|
|
if (Pointer2 == Pointer1) {
|
|
while (*Pointer1 != 0) {
|
|
Pointer2++;
|
|
Pointer1++;
|
|
}
|
|
} else {
|
|
while (*Pointer1 != 0) {
|
|
*Pointer2 = *Pointer1;
|
|
Pointer1++;
|
|
Pointer2++;
|
|
}
|
|
*Pointer2 = 0;
|
|
}
|
|
|
|
|
|
for (Pointer1 = Str + StrLen(Str) - 1; Pointer1 >= Str && *Pointer1 == CharC; Pointer1--) {
|
|
;
|
|
}
|
|
if (Pointer1 != Str + StrLen(Str) - 1) {
|
|
*(Pointer1 + 1) = 0;
|
|
}
|
|
}
|
|
|
|
/**
|
|
This call back function is registered with Boot Manager formset.
|
|
When user selects a boot option, this call back function will
|
|
be triggered. The boot option is saved for later processing.
|
|
|
|
|
|
@param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
|
|
@param Action Specifies the type of action taken by the browser.
|
|
@param QuestionId A unique value which is sent to the original exporting driver
|
|
so that it can identify the type of data to expect.
|
|
@param Type The type of value for the question.
|
|
@param Value A pointer to the data being sent to the original exporting driver.
|
|
@param ActionRequest On return, points to the action requested by the callback function.
|
|
|
|
@retval EFI_SUCCESS The callback successfully handled the action.
|
|
@retval EFI_INVALID_PARAMETER The setup browser call this function with invalid parameters.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
BootManagerCallback (
|
|
IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,
|
|
IN EFI_BROWSER_ACTION Action,
|
|
IN EFI_QUESTION_ID QuestionId,
|
|
IN UINT8 Type,
|
|
IN EFI_IFR_TYPE_VALUE *Value,
|
|
OUT EFI_BROWSER_ACTION_REQUEST *ActionRequest
|
|
)
|
|
{
|
|
UINTN Index;
|
|
EFI_BOOT_MANAGER_LOAD_OPTION *BootOption;
|
|
UINTN BootOptionCount;
|
|
UINT16 KeyCount;
|
|
|
|
if (Action != EFI_BROWSER_ACTION_CHANGED) {
|
|
//
|
|
// Do nothing for other UEFI Action. Only do call back when data is changed.
|
|
//
|
|
return EFI_UNSUPPORTED;
|
|
}
|
|
|
|
if ((Value == NULL) || (ActionRequest == NULL)) {
|
|
return EFI_INVALID_PARAMETER;
|
|
}
|
|
|
|
//
|
|
// Initialize the key count
|
|
//
|
|
KeyCount = 0;
|
|
mBootOption.Attributes = 0;
|
|
BootOption = EfiBootManagerGetLoadOptions (&BootOptionCount, LoadOptionTypeBoot);
|
|
|
|
for (Index = 0; Index < BootOptionCount; Index++) {
|
|
KeyCount++;
|
|
|
|
EfiBootManagerInitializeLoadOption (
|
|
&mBootOption,
|
|
BootOption[Index].OptionNumber,
|
|
BootOption[Index].OptionType,
|
|
BootOption[Index].Attributes,
|
|
BootOption[Index].Description,
|
|
BootOption[Index].FilePath,
|
|
BootOption[Index].OptionalData,
|
|
BootOption[Index].OptionalDataSize
|
|
);
|
|
|
|
//
|
|
// Is this device the one chosen?
|
|
//
|
|
if (KeyCount == QuestionId) {
|
|
//
|
|
// Assigning the returned Key to a global allows the original routine to know what was chosen
|
|
//
|
|
mKeyInput = QuestionId;
|
|
|
|
//
|
|
// Request to exit SendForm(), so that we could boot the selected option
|
|
//
|
|
*ActionRequest = EFI_BROWSER_ACTION_REQUEST_EXIT;
|
|
break;
|
|
}
|
|
}
|
|
EfiBootManagerFreeLoadOptions (BootOption, BootOptionCount);
|
|
|
|
return EFI_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
This function invokes Boot Manager. If all devices have not a chance to be connected,
|
|
the connect all will be triggered. It then enumerate all boot options. If
|
|
a boot option from the Boot Manager page is selected, Boot Manager will boot
|
|
from this boot option.
|
|
|
|
**/
|
|
VOID
|
|
CallBootManager (
|
|
VOID
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
UINTN Index;
|
|
EFI_BOOT_MANAGER_LOAD_OPTION *BootOption;
|
|
UINTN BootOptionCount;
|
|
EFI_STRING_ID Token;
|
|
EFI_INPUT_KEY Key;
|
|
CHAR16 *HelpString;
|
|
EFI_STRING_ID HelpToken;
|
|
UINT16 *TempStr;
|
|
EFI_HII_HANDLE HiiHandle;
|
|
EFI_BROWSER_ACTION_REQUEST ActionRequest;
|
|
UINTN TempSize;
|
|
VOID *StartOpCodeHandle;
|
|
VOID *EndOpCodeHandle;
|
|
EFI_IFR_GUID_LABEL *StartLabel;
|
|
EFI_IFR_GUID_LABEL *EndLabel;
|
|
CHAR16 *BootOptionDesc;
|
|
|
|
StartOpCodeHandle = NULL;
|
|
EndOpCodeHandle = NULL;
|
|
BootOptionDesc = NULL;
|
|
HelpString = NULL;
|
|
TempStr = NULL;
|
|
|
|
//
|
|
// Connect all prior to entering the platform setup menu.
|
|
//
|
|
if (!gConnectAllHappened) {
|
|
EfiBootManagerConnectAll ();
|
|
gConnectAllHappened = TRUE;
|
|
}
|
|
|
|
//
|
|
// Install Device Path Protocol and Config Access protocol to driver handle
|
|
//
|
|
gBootManagerPrivate.DriverHandle = NULL;
|
|
Status = gBS->InstallMultipleProtocolInterfaces (
|
|
&gBootManagerPrivate.DriverHandle,
|
|
&gEfiDevicePathProtocolGuid,
|
|
&mBootManagerHiiVendorDevicePath,
|
|
&gEfiHiiConfigAccessProtocolGuid,
|
|
&gBootManagerPrivate.ConfigAccess,
|
|
NULL
|
|
);
|
|
ASSERT_EFI_ERROR (Status);
|
|
|
|
//
|
|
// Publish our HII data
|
|
//
|
|
gBootManagerPrivate.HiiHandle = HiiAddPackages (
|
|
&mBootManagerGuid,
|
|
gBootManagerPrivate.DriverHandle,
|
|
BootManagerVfrBin,
|
|
UiAppStrings,
|
|
NULL
|
|
);
|
|
if (gBootManagerPrivate.HiiHandle == NULL) {
|
|
Status = EFI_OUT_OF_RESOURCES;
|
|
} else {
|
|
Status = EFI_SUCCESS;
|
|
}
|
|
|
|
|
|
//
|
|
// for better user experience
|
|
// 1. User changes HD configuration (e.g.: unplug HDD), here we have a chance to remove the HDD boot option
|
|
// 2. User enables/disables UEFI PXE, here we have a chance to add/remove EFI Network boot option
|
|
//
|
|
EfiBootManagerRefreshAllBootOption ();
|
|
|
|
BootOption = EfiBootManagerGetLoadOptions (&BootOptionCount, LoadOptionTypeBoot);
|
|
|
|
HiiHandle = gBootManagerPrivate.HiiHandle;
|
|
|
|
//
|
|
// Allocate space for creation of UpdateData Buffer
|
|
//
|
|
StartOpCodeHandle = HiiAllocateOpCodeHandle ();
|
|
ASSERT (StartOpCodeHandle != NULL);
|
|
if (StartOpCodeHandle == NULL) {
|
|
return;
|
|
}
|
|
|
|
EndOpCodeHandle = HiiAllocateOpCodeHandle ();
|
|
ASSERT (EndOpCodeHandle != NULL);
|
|
if (EndOpCodeHandle == NULL) {
|
|
HiiFreeOpCodeHandle (StartOpCodeHandle);
|
|
return;
|
|
}
|
|
|
|
//
|
|
// Create Hii Extend Label OpCode as the start opcode
|
|
//
|
|
StartLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (StartOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));
|
|
StartLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;
|
|
StartLabel->Number = LABEL_BOOT_OPTION;
|
|
|
|
//
|
|
// Create Hii Extend Label OpCode as the end opcode
|
|
//
|
|
EndLabel = (EFI_IFR_GUID_LABEL *) HiiCreateGuidOpCode (EndOpCodeHandle, &gEfiIfrTianoGuid, NULL, sizeof (EFI_IFR_GUID_LABEL));
|
|
EndLabel->ExtendOpCode = EFI_IFR_EXTEND_OP_LABEL;
|
|
EndLabel->Number = LABEL_BOOT_OPTION_END;
|
|
|
|
mKeyInput = 0;
|
|
for (Index = 0; Index < BootOptionCount; Index++) {
|
|
//
|
|
// At this stage we are creating a menu entry, thus the Keys are reproduceable
|
|
//
|
|
mKeyInput++;
|
|
|
|
//
|
|
// Don't display the hidden/inactive boot option
|
|
//
|
|
if (((BootOption[Index].Attributes & LOAD_OPTION_HIDDEN) != 0) || ((BootOption[Index].Attributes & LOAD_OPTION_ACTIVE) == 0)) {
|
|
continue;
|
|
}
|
|
|
|
ASSERT (BootOption[Index].Description != NULL);
|
|
|
|
BootOptionDesc = AllocateCopyPool (StrSize (BootOption[Index].Description), BootOption[Index].Description);
|
|
ASSERT (BootOptionDesc != NULL);
|
|
if (BootOptionDesc == NULL) {
|
|
HiiFreeOpCodeHandle (StartOpCodeHandle);
|
|
HiiFreeOpCodeHandle (EndOpCodeHandle);
|
|
return;
|
|
}
|
|
|
|
StrTrim (BootOptionDesc, L' ');
|
|
Token = HiiSetString (HiiHandle, 0, BootOptionDesc, NULL);
|
|
FreePool (BootOptionDesc);
|
|
|
|
TempStr = UiDevicePathToStr (BootOption[Index].FilePath);
|
|
if (TempStr != NULL) {
|
|
TempSize = StrSize (TempStr);
|
|
} else {
|
|
TempSize = 0;
|
|
}
|
|
|
|
HelpString = AllocateZeroPool (TempSize + StrSize (L"Device Path : "));
|
|
ASSERT (HelpString != NULL);
|
|
if (HelpString == NULL) {
|
|
HiiFreeOpCodeHandle (StartOpCodeHandle);
|
|
HiiFreeOpCodeHandle (EndOpCodeHandle);
|
|
return;
|
|
}
|
|
StrCatS (HelpString, (TempSize + StrSize (L"Device Path : ")) / sizeof (CHAR16), L"Device Path : ");
|
|
if (TempStr != NULL) {
|
|
StrCatS (HelpString, (TempSize + StrSize (L"Device Path : ")) / sizeof (CHAR16), TempStr);
|
|
FreePool (TempStr);
|
|
}
|
|
|
|
HelpToken = HiiSetString (HiiHandle, 0, HelpString, NULL);
|
|
FreePool (HelpString);
|
|
|
|
HiiCreateActionOpCode (
|
|
StartOpCodeHandle,
|
|
mKeyInput,
|
|
Token,
|
|
HelpToken,
|
|
EFI_IFR_FLAG_CALLBACK,
|
|
0
|
|
);
|
|
}
|
|
|
|
HiiUpdateForm (
|
|
HiiHandle,
|
|
&mBootManagerGuid,
|
|
BOOT_MANAGER_FORM_ID,
|
|
StartOpCodeHandle,
|
|
EndOpCodeHandle
|
|
);
|
|
|
|
HiiFreeOpCodeHandle (StartOpCodeHandle);
|
|
HiiFreeOpCodeHandle (EndOpCodeHandle);
|
|
|
|
EfiBootManagerFreeLoadOptions (BootOption, BootOptionCount);
|
|
|
|
ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;
|
|
Status = gFormBrowser2->SendForm (
|
|
gFormBrowser2,
|
|
&HiiHandle,
|
|
1,
|
|
&mBootManagerGuid,
|
|
0,
|
|
NULL,
|
|
&ActionRequest
|
|
);
|
|
if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {
|
|
EnableResetRequired ();
|
|
}
|
|
|
|
Status = gBS->UninstallMultipleProtocolInterfaces (
|
|
gBootManagerPrivate.DriverHandle,
|
|
&gEfiDevicePathProtocolGuid,
|
|
&mBootManagerHiiVendorDevicePath,
|
|
&gEfiHiiConfigAccessProtocolGuid,
|
|
&gBootManagerPrivate.ConfigAccess,
|
|
NULL
|
|
);
|
|
ASSERT_EFI_ERROR (Status);
|
|
|
|
HiiRemovePackages (gBootManagerPrivate.HiiHandle);
|
|
|
|
if (mBootOption.Attributes != 0) {
|
|
//
|
|
// Will leave browser, check any changes. If yes, pop up reminder for user to make decision.
|
|
// Then, check any reset required change is applied? if yes, reset system.
|
|
//
|
|
SetupChangesReminder(TRUE);
|
|
|
|
//
|
|
// parse the selected option
|
|
//
|
|
BdsSetConsoleMode (FALSE);
|
|
EfiBootManagerBoot (&mBootOption);
|
|
BdsSetConsoleMode (TRUE);
|
|
|
|
if (EFI_ERROR (mBootOption.Status)) {
|
|
gST->ConOut->OutputString (
|
|
gST->ConOut,
|
|
GetStringById (STRING_TOKEN (STR_ANY_KEY_CONTINUE))
|
|
);
|
|
gST->ConIn->ReadKeyStroke (gST->ConIn, &Key);
|
|
}
|
|
EfiBootManagerFreeLoadOption (&mBootOption);
|
|
mBootOption.Attributes = 0;
|
|
}
|
|
}
|