2 FrontPage routines to handle the callbacks and browser calls
4 Copyright (c) 2004 - 2008, Intel Corporation. <BR>
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #include "FrontPage.h"
18 EFI_GUID mFrontPageGuid
= FRONT_PAGE_FORMSET_GUID
;
20 BOOLEAN gConnectAllHappened
= FALSE
;
23 EFI_HII_DATABASE_PROTOCOL
*gHiiDatabase
;
24 EFI_HII_STRING_PROTOCOL
*gHiiString
;
25 EFI_FORM_BROWSER2_PROTOCOL
*gFormBrowser2
;
26 EFI_HII_CONFIG_ROUTING_PROTOCOL
*gHiiConfigRouting
;
28 FRONT_PAGE_CALLBACK_DATA gFrontPagePrivate
= {
29 FRONT_PAGE_CALLBACK_DATA_SIGNATURE
,
41 This function allows a caller to extract the current configuration for one
42 or more named elements from the target driver.
45 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
46 @param Request - A null-terminated Unicode string in <ConfigRequest> format.
47 @param Progress - On return, points to a character in the Request string.
48 Points to the string's null terminator if request was successful.
49 Points to the most recent '&' before the first failing name/value
50 pair (or the beginning of the string if the failure is in the
51 first name/value pair) if the request was not successful.
52 @param Results - A null-terminated Unicode string in <ConfigAltResp> format which
53 has all values filled in for the names in the Request string.
54 String to be allocated by the called function.
56 @retval EFI_SUCCESS The Results is filled with the requested values.
57 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.
58 @retval EFI_INVALID_PARAMETER Request is NULL, illegal syntax, or unknown name.
59 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.
65 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
66 IN CONST EFI_STRING Request
,
67 OUT EFI_STRING
*Progress
,
68 OUT EFI_STRING
*Results
75 This function processes the results of changes in configuration.
78 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
79 @param Configuration - A null-terminated Unicode string in <ConfigResp> format.
80 @param Progress - A pointer to a string filled in with the offset of the most
81 recent '&' before the first failing name/value pair (or the
82 beginning of the string if the failure is in the first
83 name/value pair) or the terminating NULL if all was successful.
85 @retval EFI_SUCCESS The Results is processed successfully.
86 @retval EFI_INVALID_PARAMETER Configuration is NULL.
87 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.
93 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
94 IN CONST EFI_STRING Configuration
,
95 OUT EFI_STRING
*Progress
102 This function processes the results of changes in configuration.
105 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
106 @param Action - Specifies the type of action taken by the browser.
107 @param QuestionId - A unique value which is sent to the original exporting driver
108 so that it can identify the type of data to expect.
109 @param Type - The type of value for the question.
110 @param Value - A pointer to the data being sent to the original exporting driver.
111 @param ActionRequest - On return, points to the action requested by the callback function.
113 @retval EFI_SUCCESS The callback successfully handled the action.
114 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the variable and its data.
115 @retval EFI_DEVICE_ERROR The variable could not be saved.
116 @retval EFI_UNSUPPORTED The specified Action is not supported by the callback.
122 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
123 IN EFI_BROWSER_ACTION Action
,
124 IN EFI_QUESTION_ID QuestionId
,
126 IN EFI_IFR_TYPE_VALUE
*Value
,
127 OUT EFI_BROWSER_ACTION_REQUEST
*ActionRequest
130 CHAR8
*LanguageString
;
132 CHAR8 Lang
[RFC_3066_ENTRY_SIZE
];
133 CHAR8 OldLang
[ISO_639_2_ENTRY_SIZE
];
137 if ((Value
== NULL
) || (ActionRequest
== NULL
)) {
138 return EFI_INVALID_PARAMETER
;
141 gCallbackKey
= QuestionId
;
144 // The first 4 entries in the Front Page are to be GUARANTEED to remain constant so IHV's can
145 // describe to their customers in documentation how to find their setup information (namely
146 // under the device manager and specific buckets)
148 switch (QuestionId
) {
149 case FRONT_PAGE_KEY_CONTINUE
:
151 // This is the continue - clear the screen and return an error to get out of FrontPage loop
155 case FRONT_PAGE_KEY_LANGUAGE
:
157 // Collect the languages from what our current Language support is based on our VFR
159 LanguageString
= HiiLibGetSupportedLanguages (gFrontPagePrivate
.HiiHandle
);
160 ASSERT (LanguageString
!= NULL
);
163 LangCode
= LanguageString
;
164 while (*LangCode
!= 0) {
165 HiiLibGetNextLanguage (&LangCode
, Lang
);
167 if (Index
== Value
->u8
) {
174 Status
= gRT
->SetVariable (
176 &gEfiGlobalVariableGuid
,
177 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_RUNTIME_ACCESS
,
182 if (!FeaturePcdGet (PcdUefiVariableDefaultLangDepricate
)) {
184 // Set UEFI deprecated variable "Lang" for backwards compatibility
186 Status
= ConvertRfc3066LanguageToIso639Language (Lang
, OldLang
);
187 if (!EFI_ERROR (Status
)) {
188 Status
= gRT
->SetVariable (
190 &gEfiGlobalVariableGuid
,
191 EFI_VARIABLE_NON_VOLATILE
| EFI_VARIABLE_BOOTSERVICE_ACCESS
| EFI_VARIABLE_RUNTIME_ACCESS
,
192 ISO_639_2_ENTRY_SIZE
,
198 FreePool (LanguageString
);
201 case FRONT_PAGE_KEY_BOOT_MANAGER
:
207 case FRONT_PAGE_KEY_DEVICE_MANAGER
:
213 case FRONT_PAGE_KEY_BOOT_MAINTAIN
:
215 // Boot Maintenance Manager
224 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
230 Initialize HII information for the FrontPage
233 @param InitializeHiiData TRUE if HII elements need to be initialized.
235 @retval EFI_SUCCESS The operation is successful.
236 @retval EFI_DEVICE_ERROR If the dynamic opcode creation failed.
240 InitializeFrontPage (
241 IN BOOLEAN InitializeHiiData
245 EFI_HII_PACKAGE_LIST_HEADER
*PackageList
;
246 EFI_HII_UPDATE_DATA UpdateData
;
247 IFR_OPTION
*OptionList
;
248 CHAR8
*LanguageString
;
250 CHAR8 Lang
[RFC_3066_ENTRY_SIZE
];
251 CHAR8 CurrentLang
[RFC_3066_ENTRY_SIZE
];
254 CHAR16
*StringBuffer
;
257 EFI_HII_HANDLE HiiHandle
;
259 if (InitializeHiiData
) {
261 // Initialize the Device Manager
263 InitializeDeviceManager ();
266 // Initialize the Device Manager
268 InitializeBootManager ();
273 // Locate Hii relative protocols
275 Status
= gBS
->LocateProtocol (&gEfiHiiDatabaseProtocolGuid
, NULL
, (VOID
**) &gHiiDatabase
);
276 if (EFI_ERROR (Status
)) {
280 Status
= gBS
->LocateProtocol (&gEfiHiiStringProtocolGuid
, NULL
, (VOID
**) &gHiiString
);
281 if (EFI_ERROR (Status
)) {
285 Status
= gBS
->LocateProtocol (&gEfiFormBrowser2ProtocolGuid
, NULL
, (VOID
**) &gFormBrowser2
);
286 if (EFI_ERROR (Status
)) {
290 Status
= gBS
->LocateProtocol (&gEfiHiiConfigRoutingProtocolGuid
, NULL
, (VOID
**) &gHiiConfigRouting
);
291 if (EFI_ERROR (Status
)) {
296 // Create driver handle used by HII database
298 Status
= HiiLibCreateHiiDriverHandle (&gFrontPagePrivate
.DriverHandle
);
299 if (EFI_ERROR (Status
)) {
304 // Install Config Access protocol to driver handle
306 Status
= gBS
->InstallProtocolInterface (
307 &gFrontPagePrivate
.DriverHandle
,
308 &gEfiHiiConfigAccessProtocolGuid
,
309 EFI_NATIVE_INTERFACE
,
310 &gFrontPagePrivate
.ConfigAccess
312 ASSERT_EFI_ERROR (Status
);
315 // Publish our HII data
317 PackageList
= HiiLibPreparePackageList (2, &mFrontPageGuid
, FrontPageVfrBin
, BdsDxeStrings
);
318 ASSERT (PackageList
!= NULL
);
320 Status
= gHiiDatabase
->NewPackageList (
323 gFrontPagePrivate
.DriverHandle
,
324 &gFrontPagePrivate
.HiiHandle
326 FreePool (PackageList
);
327 if (EFI_ERROR (Status
)) {
333 // Get current language setting
335 HiiLibGetCurrentLanguage (CurrentLang
);
338 // Allocate space for creation of UpdateData Buffer
340 UpdateData
.BufferSize
= 0x1000;
341 UpdateData
.Data
= AllocateZeroPool (0x1000);
342 ASSERT (UpdateData
.Data
!= NULL
);
344 OptionList
= AllocateZeroPool (0x1000);
345 ASSERT (OptionList
!= NULL
);
348 // Collect the languages from what our current Language support is based on our VFR
350 HiiHandle
= gFrontPagePrivate
.HiiHandle
;
351 LanguageString
= HiiLibGetSupportedLanguages (HiiHandle
);
352 ASSERT (LanguageString
!= NULL
);
355 LangCode
= LanguageString
;
356 while (*LangCode
!= 0) {
357 HiiLibGetNextLanguage (&LangCode
, Lang
);
359 if (gFrontPagePrivate
.LanguageToken
== NULL
) {
361 // Get Language Name from String Package. The StringId of Printable Language
362 // Name is always 1 which is generated by StringGather Tool.
365 StringBuffer
= AllocatePool (BufferSize
);
366 Status
= gHiiString
->GetString (
370 PRINTABLE_LANGUAGE_NAME_STRING_ID
,
375 if (Status
== EFI_BUFFER_TOO_SMALL
) {
376 FreePool (StringBuffer
);
377 StringBuffer
= AllocatePool (BufferSize
);
378 Status
= gHiiString
->GetString (
382 PRINTABLE_LANGUAGE_NAME_STRING_ID
,
388 ASSERT_EFI_ERROR (Status
);
391 Status
= HiiLibNewString (HiiHandle
, &Token
, StringBuffer
);
392 FreePool (StringBuffer
);
394 Token
= gFrontPagePrivate
.LanguageToken
[OptionCount
];
397 if (AsciiStrCmp (Lang
, CurrentLang
) == 0) {
398 OptionList
[OptionCount
].Flags
= EFI_IFR_OPTION_DEFAULT
;
400 OptionList
[OptionCount
].Flags
= 0;
402 OptionList
[OptionCount
].StringToken
= Token
;
403 OptionList
[OptionCount
].Value
.u8
= (UINT8
) OptionCount
;
408 FreePool (LanguageString
);
410 UpdateData
.Offset
= 0;
412 FRONT_PAGE_KEY_LANGUAGE
,
415 STRING_TOKEN (STR_LANGUAGE_SELECT
),
416 STRING_TOKEN (STR_LANGUAGE_SELECT_HELP
),
417 EFI_IFR_FLAG_CALLBACK
,
418 EFI_IFR_NUMERIC_SIZE_1
,
424 Status
= IfrLibUpdateForm (
428 LABEL_SELECT_LANGUAGE
,
434 // Save the string Id for each language
436 gFrontPagePrivate
.LanguageToken
= AllocatePool (OptionCount
* sizeof (EFI_STRING_ID
));
437 ASSERT (gFrontPagePrivate
.LanguageToken
!= NULL
);
438 for (Index
= 0; Index
< OptionCount
; Index
++) {
439 gFrontPagePrivate
.LanguageToken
[Index
] = OptionList
[Index
].StringToken
;
442 FreePool (UpdateData
.Data
);
443 FreePool (OptionList
);
448 Call the browser and display the front page
450 @return Status code that will be returned by
451 EFI_FORM_BROWSER2_PROTOCOL.SendForm ().
460 EFI_BROWSER_ACTION_REQUEST ActionRequest
;
463 // Begin waiting for USER INPUT
467 (EFI_SOFTWARE_DXE_BS_DRIVER
| EFI_SW_PC_INPUT_WAIT
)
472 // Drop the TPL level from TPL_APPLICATION to TPL_APPLICATION
474 gBS
->RestoreTPL (TPL_APPLICATION
);
476 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
477 Status
= gFormBrowser2
->SendForm (
479 &gFrontPagePrivate
.HiiHandle
,
487 // Check whether user change any option setting which needs a reset to be effective
489 if (ActionRequest
== EFI_BROWSER_ACTION_REQUEST_RESET
) {
490 EnableResetRequired ();
493 gBS
->RaiseTPL (TPL_APPLICATION
);
498 Acquire the string associated with the ProducerGuid and return it.
501 @param ProducerGuid - The Guid to search the HII database for
502 @param Token - The token value of the string to extract
503 @param String - The string that is extracted
505 @retval EFI_SUCCESS The function returns EFI_SUCCESS always.
510 IN EFI_GUID
*ProducerGuid
,
511 IN EFI_STRING_ID Token
,
517 Status
= HiiLibGetStringFromToken (ProducerGuid
, Token
, String
);
518 if (EFI_ERROR (Status
)) {
519 *String
= GetStringById (STRING_TOKEN (STR_MISSING_STRING
));
526 Convert Processor Frequency Data to a string
529 @param ProcessorFrequency - The frequency data to process
530 @param String - The string that is created
536 ConvertProcessorToString (
537 IN EFI_PROCESSOR_CORE_FREQUENCY_DATA
*ProcessorFrequency
,
541 CHAR16
*StringBuffer
;
545 if (ProcessorFrequency
->Exponent
>= 6) {
546 FreqMhz
= ProcessorFrequency
->Value
;
547 for (Index
= 0; Index
< (UINTN
) (ProcessorFrequency
->Exponent
- 6); Index
++) {
554 StringBuffer
= AllocateZeroPool (0x20);
555 ASSERT (StringBuffer
!= NULL
);
556 Index
= UnicodeValueToString (StringBuffer
, LEFT_JUSTIFY
, FreqMhz
/ 1000, 3);
557 StrCat (StringBuffer
, L
".");
558 UnicodeValueToString (StringBuffer
+ Index
+ 1, PREFIX_ZERO
, (FreqMhz
% 1000) / 10, 2);
559 StrCat (StringBuffer
, L
" GHz");
561 *String
= (CHAR16
*) StringBuffer
;
567 Convert Memory Size to a string.
570 @param MemorySize - The size of the memory to process
571 @param String - The string that is created
575 ConvertMemorySizeToString (
576 IN UINT32 MemorySize
,
580 CHAR16
*StringBuffer
;
582 StringBuffer
= AllocateZeroPool (0x20);
583 ASSERT (StringBuffer
!= NULL
);
584 UnicodeValueToString (StringBuffer
, LEFT_JUSTIFY
, MemorySize
, 6);
585 StrCat (StringBuffer
, L
" MB RAM");
587 *String
= (CHAR16
*) StringBuffer
;
593 Update the banner information for the Front Page based on DataHub information.
597 UpdateFrontPageStrings (
602 EFI_STRING_ID TokenToUpdate
;
604 UINT64 MonotonicCount
;
605 EFI_DATA_HUB_PROTOCOL
*DataHub
;
606 EFI_DATA_RECORD_HEADER
*Record
;
607 EFI_SUBCLASS_TYPE1_HEADER
*DataHeader
;
608 EFI_MISC_BIOS_VENDOR_DATA
*BiosVendor
;
609 EFI_MISC_SYSTEM_MANUFACTURER_DATA
*SystemManufacturer
;
610 EFI_PROCESSOR_VERSION_DATA
*ProcessorVersion
;
611 EFI_PROCESSOR_CORE_FREQUENCY_DATA
*ProcessorFrequency
;
612 EFI_MEMORY_ARRAY_START_ADDRESS_DATA
*MemoryArray
;
615 ZeroMem (Find
, sizeof (Find
));
618 // Update Front Page strings
620 Status
= gBS
->LocateProtocol (
621 &gEfiDataHubProtocolGuid
,
625 ASSERT_EFI_ERROR (Status
);
630 Status
= DataHub
->GetNextRecord (DataHub
, &MonotonicCount
, NULL
, &Record
);
631 if (Record
->DataRecordClass
== EFI_DATA_RECORD_CLASS_DATA
) {
632 DataHeader
= (EFI_SUBCLASS_TYPE1_HEADER
*) (Record
+ 1);
633 if (CompareGuid (&Record
->DataRecordGuid
, &gEfiMiscSubClassGuid
) &&
634 (DataHeader
->RecordType
== EFI_MISC_BIOS_VENDOR_RECORD_NUMBER
)
636 BiosVendor
= (EFI_MISC_BIOS_VENDOR_DATA
*) (DataHeader
+ 1);
637 GetProducerString (&Record
->ProducerName
, BiosVendor
->BiosVersion
, &NewString
);
638 TokenToUpdate
= STRING_TOKEN (STR_FRONT_PAGE_BIOS_VERSION
);
639 HiiLibSetString (gFrontPagePrivate
.HiiHandle
, TokenToUpdate
, NewString
);
640 FreePool (NewString
);
644 if (CompareGuid (&Record
->DataRecordGuid
, &gEfiMiscSubClassGuid
) &&
645 (DataHeader
->RecordType
== EFI_MISC_SYSTEM_MANUFACTURER_RECORD_NUMBER
)
647 SystemManufacturer
= (EFI_MISC_SYSTEM_MANUFACTURER_DATA
*) (DataHeader
+ 1);
648 GetProducerString (&Record
->ProducerName
, SystemManufacturer
->SystemProductName
, &NewString
);
649 TokenToUpdate
= STRING_TOKEN (STR_FRONT_PAGE_COMPUTER_MODEL
);
650 HiiLibSetString (gFrontPagePrivate
.HiiHandle
, TokenToUpdate
, NewString
);
651 FreePool (NewString
);
655 if (CompareGuid (&Record
->DataRecordGuid
, &gEfiProcessorSubClassGuid
) &&
656 (DataHeader
->RecordType
== ProcessorVersionRecordType
)
658 ProcessorVersion
= (EFI_PROCESSOR_VERSION_DATA
*) (DataHeader
+ 1);
659 GetProducerString (&Record
->ProducerName
, *ProcessorVersion
, &NewString
);
660 TokenToUpdate
= STRING_TOKEN (STR_FRONT_PAGE_CPU_MODEL
);
661 HiiLibSetString (gFrontPagePrivate
.HiiHandle
, TokenToUpdate
, NewString
);
662 FreePool (NewString
);
666 if (CompareGuid (&Record
->DataRecordGuid
, &gEfiProcessorSubClassGuid
) &&
667 (DataHeader
->RecordType
== ProcessorCoreFrequencyRecordType
)
669 ProcessorFrequency
= (EFI_PROCESSOR_CORE_FREQUENCY_DATA
*) (DataHeader
+ 1);
670 ConvertProcessorToString (ProcessorFrequency
, &NewString
);
671 TokenToUpdate
= STRING_TOKEN (STR_FRONT_PAGE_CPU_SPEED
);
672 HiiLibSetString (gFrontPagePrivate
.HiiHandle
, TokenToUpdate
, NewString
);
673 FreePool (NewString
);
677 if (CompareGuid (&Record
->DataRecordGuid
, &gEfiMemorySubClassGuid
) &&
678 (DataHeader
->RecordType
== EFI_MEMORY_ARRAY_START_ADDRESS_RECORD_NUMBER
)
680 MemoryArray
= (EFI_MEMORY_ARRAY_START_ADDRESS_DATA
*) (DataHeader
+ 1);
681 ConvertMemorySizeToString (
682 (UINT32
)(RShiftU64((MemoryArray
->MemoryArrayEndAddress
- MemoryArray
->MemoryArrayStartAddress
+ 1), 20)),
685 TokenToUpdate
= STRING_TOKEN (STR_FRONT_PAGE_MEMORY_SIZE
);
686 HiiLibSetString (gFrontPagePrivate
.HiiHandle
, TokenToUpdate
, NewString
);
687 FreePool (NewString
);
691 } while (!EFI_ERROR (Status
) && (MonotonicCount
!= 0) && !(Find
[0] && Find
[1] && Find
[2] && Find
[3] && Find
[4]));
697 Function waits for a given event to fire, or for an optional timeout to expire.
700 @param Event The event to wait for
702 @param Timeout An optional timeout value in 100 ns units.
704 @retval EFI_SUCCESS Event fired before Timeout expired.
705 @retval EFI_TIME_OUT Timout expired before Event fired..
711 IN UINT64 Timeout OPTIONAL
716 EFI_EVENT TimerEvent
;
717 EFI_EVENT WaitList
[2];
721 // Create a timer event
723 Status
= gBS
->CreateEvent (EVT_TIMER
, 0, NULL
, NULL
, &TimerEvent
);
724 if (!EFI_ERROR (Status
)) {
726 // Set the timer event
735 // Wait for the original event or the timer
738 WaitList
[1] = TimerEvent
;
739 Status
= gBS
->WaitForEvent (2, WaitList
, &Index
);
740 gBS
->CloseEvent (TimerEvent
);
743 // If the timer expired, change the return to timed out
745 if (!EFI_ERROR (Status
) && Index
== 1) {
746 Status
= EFI_TIMEOUT
;
751 // No timeout... just wait on the event
753 Status
= gBS
->WaitForEvent (1, &Event
, &Index
);
754 ASSERT (!EFI_ERROR (Status
));
762 Function show progress bar to wait for user input.
765 @param TimeoutDefault - The fault time out value before the system
768 @retval EFI_SUCCESS User pressed some key except "Enter"
769 @retval EFI_TIME_OUT Timout expired or user press "Enter"
774 IN UINT16 TimeoutDefault
779 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground
;
780 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background
;
781 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Color
;
783 UINT16 TimeoutRemain
;
785 if (TimeoutDefault
== 0) {
789 DEBUG ((EFI_D_INFO
, "\n\nStart showing progress bar... Press any key to stop it! ...Zzz....\n"));
791 SetMem (&Foreground
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
), 0xff);
792 SetMem (&Background
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
), 0x0);
793 SetMem (&Color
, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL
), 0xff);
796 // Clear the progress status bar first
798 TmpStr
= GetStringById (STRING_TOKEN (STR_START_BOOT_OPTION
));
799 if (TmpStr
!= NULL
) {
800 PlatformBdsShowProgress (Foreground
, Background
, TmpStr
, Color
, 0, 0);
803 TimeoutRemain
= TimeoutDefault
;
804 while (TimeoutRemain
!= 0) {
805 DEBUG ((EFI_D_INFO
, "Showing progress bar...Remaining %d second!\n", TimeoutRemain
));
807 Status
= WaitForSingleEvent (gST
->ConIn
->WaitForKey
, ONE_SECOND
);
808 if (Status
!= EFI_TIMEOUT
) {
816 if (TmpStr
!= NULL
) {
817 PlatformBdsShowProgress (
822 ((TimeoutDefault
- TimeoutRemain
) * 100 / TimeoutDefault
),
827 gBS
->FreePool (TmpStr
);
832 if (TimeoutRemain
== 0) {
837 // User pressed some key
839 Status
= gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &Key
);
840 if (EFI_ERROR (Status
)) {
844 if (Key
.UnicodeChar
== CHAR_CARRIAGE_RETURN
) {
846 // User pressed enter, equivalent to select "continue"
855 This function is the main entry of the platform setup entry.
856 The function will present the main menu of the system setup,
857 this is the platform reference part and can be customize.
860 @param TimeoutDefault - The fault time out value before the system
862 @param ConnectAllHappened - The indicater to check if the connect all have
869 PlatformBdsEnterFrontPage (
870 IN UINT16 TimeoutDefault
,
871 IN BOOLEAN ConnectAllHappened
875 EFI_CONSOLE_CONTROL_PROTOCOL
*ConsoleControl
;
877 PERF_START (0, "BdsTimeOut", "BDS", 0);
879 // Indicate if we need connect all in the platform setup
881 if (ConnectAllHappened
) {
882 gConnectAllHappened
= TRUE
;
885 if (TimeoutDefault
!= 0xffff) {
886 gBS
->RestoreTPL (TPL_APPLICATION
);
887 Status
= ShowProgress (TimeoutDefault
);
888 gBS
->RaiseTPL (TPL_APPLICATION
);
891 // Ensure screen is clear when switch Console from Graphics mode to Text mode
893 gST
->ConOut
->EnableCursor (gST
->ConOut
, TRUE
);
894 gST
->ConOut
->ClearScreen (gST
->ConOut
);
896 if (EFI_ERROR (Status
)) {
898 // Timeout or user press enter to continue
906 InitializeFrontPage (FALSE
);
909 // Update Front Page strings
911 UpdateFrontPageStrings ();
914 Status
= CallFrontPage ();
917 // If gCallbackKey is greater than 1 and less or equal to 5,
918 // it will lauch configuration utilities.
921 // 4 = device manager
922 // 5 = boot maintainenance manager
924 if (gCallbackKey
!= 0) {
927 (EFI_SOFTWARE_DXE_BS_DRIVER
| EFI_SW_PC_USER_SETUP
)
931 // Based on the key that was set, we can determine what to do
933 switch (gCallbackKey
) {
935 // The first 4 entries in the Front Page are to be GUARANTEED to remain constant so IHV's can
936 // describe to their customers in documentation how to find their setup information (namely
937 // under the device manager and specific buckets)
939 // These entries consist of the Continue, Select language, Boot Manager, and Device Manager
941 case FRONT_PAGE_KEY_CONTINUE
:
947 case FRONT_PAGE_KEY_LANGUAGE
:
949 // User made a language setting change - display front page again
953 case FRONT_PAGE_KEY_BOOT_MANAGER
:
955 // User chose to run the Boot Manager
960 case FRONT_PAGE_KEY_DEVICE_MANAGER
:
962 // Display the Device Manager
966 } while (gCallbackKey
== FRONT_PAGE_KEY_DEVICE_MANAGER
);
969 case FRONT_PAGE_KEY_BOOT_MAINTAIN
:
971 // Display the Boot Maintenance Manager
973 BdsStartBootMaint ();
977 } while ((Status
== EFI_SUCCESS
) && (gCallbackKey
!= FRONT_PAGE_KEY_CONTINUE
));
980 //Will leave browser, check any reset required change is applied? if yes, reset system
982 gBS
->RestoreTPL (TPL_APPLICATION
);
983 SetupResetReminder ();
984 gBS
->RaiseTPL (TPL_APPLICATION
);
988 // Automatically load current entry
989 // Note: The following lines of code only execute when Auto boot
992 PERF_END (0, "BdsTimeOut", "BDS", 0);
993 Status
= gBS
->LocateProtocol (&gEfiConsoleControlProtocolGuid
, NULL
, (VOID
**) &ConsoleControl
);
994 ConsoleControl
->SetMode (ConsoleControl
, EfiConsoleControlScreenText
);