]> git.proxmox.com Git - mirror_edk2.git/blame - MdeModulePkg/Universal/BdsDxe/FrontPage.c
Clean up BdsDxe for Doxygen comments requirement.
[mirror_edk2.git] / MdeModulePkg / Universal / BdsDxe / FrontPage.c
CommitLineData
fd6a62f3 1/** @file\r
2 FrontPage routines to handle the callbacks and browser calls\r
93e3992d 3\r
fd6a62f3 4Copyright (c) 2004 - 2008, Intel Corporation. <BR>\r
93e3992d 5All rights reserved. This program and the accompanying materials\r
6are licensed and made available under the terms and conditions of the BSD License\r
7which accompanies this distribution. The full text of the license may be found at\r
8http://opensource.org/licenses/bsd-license.php\r
9\r
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
fd6a62f3 13**/\r
93e3992d 14\r
15#include "Bds.h"\r
16#include "FrontPage.h"\r
17\r
18EFI_GUID mFrontPageGuid = FRONT_PAGE_FORMSET_GUID;\r
19\r
20BOOLEAN gConnectAllHappened = FALSE;\r
21UINTN gCallbackKey;\r
22\r
23EFI_HII_DATABASE_PROTOCOL *gHiiDatabase;\r
24EFI_HII_STRING_PROTOCOL *gHiiString;\r
25EFI_FORM_BROWSER2_PROTOCOL *gFormBrowser2;\r
26EFI_HII_CONFIG_ROUTING_PROTOCOL *gHiiConfigRouting;\r
27\r
28FRONT_PAGE_CALLBACK_DATA gFrontPagePrivate = {\r
29 FRONT_PAGE_CALLBACK_DATA_SIGNATURE,\r
30 NULL,\r
31 NULL,\r
32 NULL,\r
33 {\r
34 FakeExtractConfig,\r
35 FakeRouteConfig,\r
36 FrontPageCallback\r
37 }\r
38};\r
39\r
b30312ba 40/**\r
41 This function allows a caller to extract the current configuration for one\r
42 or more named elements from the target driver.\r
43\r
44\r
45 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
46 @param Request - A null-terminated Unicode string in <ConfigRequest> format.\r
47 @param Progress - On return, points to a character in the Request string.\r
48 Points to the string's null terminator if request was successful.\r
49 Points to the most recent '&' before the first failing name/value\r
50 pair (or the beginning of the string if the failure is in the\r
51 first name/value pair) if the request was not successful.\r
52 @param Results - A null-terminated Unicode string in <ConfigAltResp> format which\r
53 has all values filled in for the names in the Request string.\r
54 String to be allocated by the called function.\r
55\r
56 @retval EFI_SUCCESS The Results is filled with the requested values.\r
57 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.\r
58 @retval EFI_INVALID_PARAMETER Request is NULL, illegal syntax, or unknown name.\r
59 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.\r
60\r
61**/\r
93e3992d 62EFI_STATUS\r
63EFIAPI\r
64FakeExtractConfig (\r
65 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
66 IN CONST EFI_STRING Request,\r
67 OUT EFI_STRING *Progress,\r
68 OUT EFI_STRING *Results\r
69 )\r
93e3992d 70{\r
71 return EFI_NOT_FOUND;\r
72}\r
73\r
b30312ba 74/**\r
75 This function processes the results of changes in configuration.\r
76\r
77\r
78 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
79 @param Configuration - A null-terminated Unicode string in <ConfigResp> format.\r
80 @param Progress - A pointer to a string filled in with the offset of the most\r
81 recent '&' before the first failing name/value pair (or the\r
82 beginning of the string if the failure is in the first\r
83 name/value pair) or the terminating NULL if all was successful.\r
84\r
85 @retval EFI_SUCCESS The Results is processed successfully.\r
86 @retval EFI_INVALID_PARAMETER Configuration is NULL.\r
87 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.\r
88\r
89**/\r
93e3992d 90EFI_STATUS\r
91EFIAPI\r
92FakeRouteConfig (\r
93 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
94 IN CONST EFI_STRING Configuration,\r
95 OUT EFI_STRING *Progress\r
96 )\r
b30312ba 97{\r
98 return EFI_SUCCESS;\r
99}\r
93e3992d 100\r
b30312ba 101/**\r
102 This function processes the results of changes in configuration.\r
93e3992d 103\r
93e3992d 104\r
b30312ba 105 @param This - Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
106 @param Action - Specifies the type of action taken by the browser.\r
107 @param QuestionId - A unique value which is sent to the original exporting driver\r
108 so that it can identify the type of data to expect.\r
109 @param Type - The type of value for the question.\r
110 @param Value - A pointer to the data being sent to the original exporting driver.\r
111 @param ActionRequest - On return, points to the action requested by the callback function.\r
93e3992d 112\r
b30312ba 113 @retval EFI_SUCCESS The callback successfully handled the action.\r
114 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the variable and its data.\r
115 @retval EFI_DEVICE_ERROR The variable could not be saved.\r
116 @retval EFI_UNSUPPORTED The specified Action is not supported by the callback.\r
93e3992d 117\r
b30312ba 118**/\r
93e3992d 119EFI_STATUS\r
120EFIAPI\r
121FrontPageCallback (\r
122 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL *This,\r
123 IN EFI_BROWSER_ACTION Action,\r
124 IN EFI_QUESTION_ID QuestionId,\r
125 IN UINT8 Type,\r
126 IN EFI_IFR_TYPE_VALUE *Value,\r
127 OUT EFI_BROWSER_ACTION_REQUEST *ActionRequest\r
128 )\r
93e3992d 129{\r
130 CHAR8 *LanguageString;\r
131 CHAR8 *LangCode;\r
132 CHAR8 Lang[RFC_3066_ENTRY_SIZE];\r
93e3992d 133 CHAR8 OldLang[ISO_639_2_ENTRY_SIZE];\r
93e3992d 134 UINTN Index;\r
135 EFI_STATUS Status;\r
136\r
137 if ((Value == NULL) || (ActionRequest == NULL)) {\r
138 return EFI_INVALID_PARAMETER;\r
139 }\r
140\r
141 gCallbackKey = QuestionId;\r
142\r
143 //\r
144 // The first 4 entries in the Front Page are to be GUARANTEED to remain constant so IHV's can\r
145 // describe to their customers in documentation how to find their setup information (namely\r
146 // under the device manager and specific buckets)\r
147 //\r
148 switch (QuestionId) {\r
149 case FRONT_PAGE_KEY_CONTINUE:\r
150 //\r
151 // This is the continue - clear the screen and return an error to get out of FrontPage loop\r
152 //\r
153 break;\r
154\r
155 case FRONT_PAGE_KEY_LANGUAGE:\r
156 //\r
157 // Collect the languages from what our current Language support is based on our VFR\r
158 //\r
9226efe5 159 LanguageString = HiiLibGetSupportedLanguages (gFrontPagePrivate.HiiHandle);\r
93e3992d 160 ASSERT (LanguageString != NULL);\r
161\r
162 Index = 0;\r
163 LangCode = LanguageString;\r
164 while (*LangCode != 0) {\r
9226efe5 165 HiiLibGetNextLanguage (&LangCode, Lang);\r
93e3992d 166\r
167 if (Index == Value->u8) {\r
168 break;\r
169 }\r
170\r
171 Index++;\r
172 }\r
173\r
174 Status = gRT->SetVariable (\r
175 L"PlatformLang",\r
176 &gEfiGlobalVariableGuid,\r
177 EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,\r
178 AsciiStrSize (Lang),\r
179 Lang\r
180 );\r
181\r
d6c0ec55 182 if (!FeaturePcdGet (PcdUefiVariableDefaultLangDepricate)) {\r
183 //\r
184 // Set UEFI deprecated variable "Lang" for backwards compatibility\r
185 //\r
186 Status = ConvertRfc3066LanguageToIso639Language (Lang, OldLang);\r
187 if (!EFI_ERROR (Status)) {\r
188 Status = gRT->SetVariable (\r
189 L"Lang",\r
190 &gEfiGlobalVariableGuid,\r
191 EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,\r
192 ISO_639_2_ENTRY_SIZE,\r
193 OldLang\r
194 );\r
195 }\r
93e3992d 196 }\r
93e3992d 197\r
198 FreePool (LanguageString);\r
199 break;\r
200\r
201 case FRONT_PAGE_KEY_BOOT_MANAGER:\r
202 //\r
203 // Boot Manager\r
204 //\r
205 break;\r
206\r
207 case FRONT_PAGE_KEY_DEVICE_MANAGER:\r
208 //\r
209 // Device Manager\r
210 //\r
211 break;\r
212\r
213 case FRONT_PAGE_KEY_BOOT_MAINTAIN:\r
214 //\r
215 // Boot Maintenance Manager\r
216 //\r
217 break;\r
218\r
219 default:\r
220 gCallbackKey = 0;\r
221 break;\r
222 }\r
223\r
224 *ActionRequest = EFI_BROWSER_ACTION_REQUEST_EXIT;\r
225\r
226 return EFI_SUCCESS;\r
227}\r
228\r
b30312ba 229/**\r
93e3992d 230 Initialize HII information for the FrontPage\r
231\r
93e3992d 232\r
b30312ba 233 @param InitializeHiiData TRUE if HII elements need to be initialized.\r
234\r
235 @retval EFI_SUCCESS The operation is successful.\r
236 @retval EFI_DEVICE_ERROR If the dynamic opcode creation failed.\r
93e3992d 237\r
b30312ba 238**/\r
239EFI_STATUS\r
240InitializeFrontPage (\r
b4489769 241 IN BOOLEAN InitializeHiiData\r
b30312ba 242 )\r
93e3992d 243{\r
244 EFI_STATUS Status;\r
245 EFI_HII_PACKAGE_LIST_HEADER *PackageList;\r
246 EFI_HII_UPDATE_DATA UpdateData;\r
247 IFR_OPTION *OptionList;\r
248 CHAR8 *LanguageString;\r
249 CHAR8 *LangCode;\r
250 CHAR8 Lang[RFC_3066_ENTRY_SIZE];\r
251 CHAR8 CurrentLang[RFC_3066_ENTRY_SIZE];\r
252 UINTN OptionCount;\r
253 EFI_STRING_ID Token;\r
254 CHAR16 *StringBuffer;\r
255 UINTN BufferSize;\r
256 UINTN Index;\r
257 EFI_HII_HANDLE HiiHandle;\r
258\r
b30312ba 259 if (InitializeHiiData) {\r
93e3992d 260 //\r
261 // Initialize the Device Manager\r
262 //\r
263 InitializeDeviceManager ();\r
264\r
265 //\r
266 // Initialize the Device Manager\r
267 //\r
268 InitializeBootManager ();\r
269\r
270 gCallbackKey = 0;\r
271\r
272 //\r
273 // Locate Hii relative protocols\r
274 //\r
275 Status = gBS->LocateProtocol (&gEfiHiiDatabaseProtocolGuid, NULL, (VOID **) &gHiiDatabase);\r
276 if (EFI_ERROR (Status)) {\r
277 return Status;\r
278 }\r
279\r
280 Status = gBS->LocateProtocol (&gEfiHiiStringProtocolGuid, NULL, (VOID **) &gHiiString);\r
281 if (EFI_ERROR (Status)) {\r
282 return Status;\r
283 }\r
284\r
285 Status = gBS->LocateProtocol (&gEfiFormBrowser2ProtocolGuid, NULL, (VOID **) &gFormBrowser2);\r
286 if (EFI_ERROR (Status)) {\r
287 return Status;\r
288 }\r
289\r
290 Status = gBS->LocateProtocol (&gEfiHiiConfigRoutingProtocolGuid, NULL, (VOID **) &gHiiConfigRouting);\r
291 if (EFI_ERROR (Status)) {\r
292 return Status;\r
293 }\r
294\r
295 //\r
296 // Create driver handle used by HII database\r
297 //\r
298 Status = HiiLibCreateHiiDriverHandle (&gFrontPagePrivate.DriverHandle);\r
299 if (EFI_ERROR (Status)) {\r
300 return Status;\r
301 }\r
302\r
303 //\r
304 // Install Config Access protocol to driver handle\r
305 //\r
306 Status = gBS->InstallProtocolInterface (\r
307 &gFrontPagePrivate.DriverHandle,\r
308 &gEfiHiiConfigAccessProtocolGuid,\r
309 EFI_NATIVE_INTERFACE,\r
310 &gFrontPagePrivate.ConfigAccess\r
311 );\r
312 ASSERT_EFI_ERROR (Status);\r
313\r
314 //\r
315 // Publish our HII data\r
316 //\r
062539cf 317 PackageList = HiiLibPreparePackageList (2, &mFrontPageGuid, FrontPageVfrBin, BdsDxeStrings);\r
93e3992d 318 ASSERT (PackageList != NULL);\r
319\r
320 Status = gHiiDatabase->NewPackageList (\r
321 gHiiDatabase,\r
322 PackageList,\r
323 gFrontPagePrivate.DriverHandle,\r
324 &gFrontPagePrivate.HiiHandle\r
325 );\r
326 FreePool (PackageList);\r
327 if (EFI_ERROR (Status)) {\r
328 return Status;\r
329 }\r
330 }\r
331\r
332 //\r
333 // Get current language setting\r
334 //\r
9226efe5 335 HiiLibGetCurrentLanguage (CurrentLang);\r
93e3992d 336\r
337 //\r
338 // Allocate space for creation of UpdateData Buffer\r
339 //\r
340 UpdateData.BufferSize = 0x1000;\r
341 UpdateData.Data = AllocateZeroPool (0x1000);\r
342 ASSERT (UpdateData.Data != NULL);\r
343\r
344 OptionList = AllocateZeroPool (0x1000);\r
345 ASSERT (OptionList != NULL);\r
346\r
347 //\r
348 // Collect the languages from what our current Language support is based on our VFR\r
349 //\r
350 HiiHandle = gFrontPagePrivate.HiiHandle;\r
9226efe5 351 LanguageString = HiiLibGetSupportedLanguages (HiiHandle);\r
93e3992d 352 ASSERT (LanguageString != NULL);\r
353\r
354 OptionCount = 0;\r
355 LangCode = LanguageString;\r
356 while (*LangCode != 0) {\r
9226efe5 357 HiiLibGetNextLanguage (&LangCode, Lang);\r
93e3992d 358\r
359 if (gFrontPagePrivate.LanguageToken == NULL) {\r
360 //\r
361 // Get Language Name from String Package. The StringId of Printable Language\r
362 // Name is always 1 which is generated by StringGather Tool.\r
363 //\r
364 BufferSize = 0x100;\r
365 StringBuffer = AllocatePool (BufferSize);\r
366 Status = gHiiString->GetString (\r
367 gHiiString,\r
368 Lang,\r
369 HiiHandle,\r
370 PRINTABLE_LANGUAGE_NAME_STRING_ID,\r
371 StringBuffer,\r
372 &BufferSize,\r
373 NULL\r
374 );\r
375 if (Status == EFI_BUFFER_TOO_SMALL) {\r
376 FreePool (StringBuffer);\r
377 StringBuffer = AllocatePool (BufferSize);\r
378 Status = gHiiString->GetString (\r
379 gHiiString,\r
380 Lang,\r
381 HiiHandle,\r
382 PRINTABLE_LANGUAGE_NAME_STRING_ID,\r
383 StringBuffer,\r
384 &BufferSize,\r
385 NULL\r
386 );\r
387 }\r
388 ASSERT_EFI_ERROR (Status);\r
389\r
390 Token = 0;\r
9226efe5 391 Status = HiiLibNewString (HiiHandle, &Token, StringBuffer);\r
93e3992d 392 FreePool (StringBuffer);\r
393 } else {\r
394 Token = gFrontPagePrivate.LanguageToken[OptionCount];\r
395 }\r
396\r
397 if (AsciiStrCmp (Lang, CurrentLang) == 0) {\r
398 OptionList[OptionCount].Flags = EFI_IFR_OPTION_DEFAULT;\r
399 } else {\r
400 OptionList[OptionCount].Flags = 0;\r
401 }\r
402 OptionList[OptionCount].StringToken = Token;\r
403 OptionList[OptionCount].Value.u8 = (UINT8) OptionCount;\r
404\r
405 OptionCount++;\r
406 }\r
407\r
408 FreePool (LanguageString);\r
409\r
410 UpdateData.Offset = 0;\r
411 CreateOneOfOpCode (\r
412 FRONT_PAGE_KEY_LANGUAGE,\r
413 0,\r
414 0,\r
415 STRING_TOKEN (STR_LANGUAGE_SELECT),\r
416 STRING_TOKEN (STR_LANGUAGE_SELECT_HELP),\r
417 EFI_IFR_FLAG_CALLBACK,\r
418 EFI_IFR_NUMERIC_SIZE_1,\r
419 OptionList,\r
420 OptionCount,\r
421 &UpdateData\r
422 );\r
423\r
424 Status = IfrLibUpdateForm (\r
425 HiiHandle,\r
426 &mFrontPageGuid,\r
427 FRONT_PAGE_FORM_ID,\r
428 LABEL_SELECT_LANGUAGE,\r
429 FALSE,\r
430 &UpdateData\r
431 );\r
432\r
433 //\r
434 // Save the string Id for each language\r
435 //\r
436 gFrontPagePrivate.LanguageToken = AllocatePool (OptionCount * sizeof (EFI_STRING_ID));\r
437 ASSERT (gFrontPagePrivate.LanguageToken != NULL);\r
438 for (Index = 0; Index < OptionCount; Index++) {\r
439 gFrontPagePrivate.LanguageToken[Index] = OptionList[Index].StringToken;\r
440 }\r
441\r
442 FreePool (UpdateData.Data);\r
443 FreePool (OptionList);\r
444 return Status;\r
445}\r
446\r
b30312ba 447/**\r
93e3992d 448 Call the browser and display the front page\r
449\r
93e3992d 450\r
b30312ba 451 @param VOID No input.\r
452\r
453 @return Status code that will be returned by\r
454 EFI_FORM_BROWSER2_PROTOCOL.SendForm ().\r
93e3992d 455\r
b30312ba 456**/\r
457EFI_STATUS\r
458CallFrontPage (\r
459 VOID\r
460 )\r
93e3992d 461{\r
462 EFI_STATUS Status;\r
463 EFI_BROWSER_ACTION_REQUEST ActionRequest;\r
464\r
465 //\r
466 // Begin waiting for USER INPUT\r
467 //\r
468 REPORT_STATUS_CODE (\r
469 EFI_PROGRESS_CODE,\r
470 (EFI_SOFTWARE_DXE_BS_DRIVER | EFI_SW_PC_INPUT_WAIT)\r
471 );\r
472\r
473\r
474 //\r
475 // Drop the TPL level from TPL_APPLICATION to TPL_APPLICATION\r
476 //\r
477 gBS->RestoreTPL (TPL_APPLICATION);\r
478\r
479 ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
480 Status = gFormBrowser2->SendForm (\r
481 gFormBrowser2,\r
482 &gFrontPagePrivate.HiiHandle,\r
483 1,\r
484 NULL,\r
485 0,\r
486 NULL,\r
487 &ActionRequest\r
488 );\r
489 //\r
490 // Check whether user change any option setting which needs a reset to be effective\r
491 //\r
492 if (ActionRequest == EFI_BROWSER_ACTION_REQUEST_RESET) {\r
493 EnableResetRequired ();\r
494 }\r
495\r
496 gBS->RaiseTPL (TPL_APPLICATION);\r
497 return Status;\r
498}\r
499\r
b30312ba 500/**\r
501 Acquire the string associated with the ProducerGuid and return it.\r
502\r
503\r
504 @param ProducerGuid - The Guid to search the HII database for\r
505 @param Token - The token value of the string to extract\r
506 @param String - The string that is extracted\r
507\r
508 @retval EFI_SUCCESS The function returns EFI_SUCCESS always.\r
509\r
510**/\r
93e3992d 511EFI_STATUS\r
512GetProducerString (\r
513 IN EFI_GUID *ProducerGuid,\r
514 IN EFI_STRING_ID Token,\r
515 OUT CHAR16 **String\r
516 )\r
93e3992d 517{\r
518 EFI_STATUS Status;\r
519\r
9226efe5 520 Status = HiiLibGetStringFromToken (ProducerGuid, Token, String);\r
93e3992d 521 if (EFI_ERROR (Status)) {\r
522 *String = GetStringById (STRING_TOKEN (STR_MISSING_STRING));\r
523 }\r
524\r
525 return EFI_SUCCESS;\r
526}\r
527\r
b30312ba 528/**\r
529 Convert Processor Frequency Data to a string\r
530\r
531\r
532 @param ProcessorFrequency - The frequency data to process\r
533 @param String - The string that is created\r
534\r
535 @return VOID.\r
536\r
537**/\r
93e3992d 538VOID\r
539ConvertProcessorToString (\r
540 IN EFI_PROCESSOR_CORE_FREQUENCY_DATA *ProcessorFrequency,\r
541 OUT CHAR16 **String\r
542 )\r
93e3992d 543{\r
544 CHAR16 *StringBuffer;\r
545 UINTN Index;\r
546 UINT32 FreqMhz;\r
547\r
548 if (ProcessorFrequency->Exponent >= 6) {\r
549 FreqMhz = ProcessorFrequency->Value;\r
550 for (Index = 0; Index < (UINTN) (ProcessorFrequency->Exponent - 6); Index++) {\r
551 FreqMhz *= 10;\r
552 }\r
553 } else {\r
554 FreqMhz = 0;\r
555 }\r
556\r
557 StringBuffer = AllocateZeroPool (0x20);\r
558 ASSERT (StringBuffer != NULL);\r
559 Index = UnicodeValueToString (StringBuffer, LEFT_JUSTIFY, FreqMhz / 1000, 3);\r
560 StrCat (StringBuffer, L".");\r
561 UnicodeValueToString (StringBuffer + Index + 1, PREFIX_ZERO, (FreqMhz % 1000) / 10, 2);\r
562 StrCat (StringBuffer, L" GHz");\r
563\r
564 *String = (CHAR16 *) StringBuffer;\r
565\r
566 return ;\r
567}\r
568\r
b30312ba 569/**\r
570 Convert Memory Size to a string\r
571\r
572\r
573 @param MemorySize - The size of the memory to process\r
574 @param String - The string that is created\r
575\r
576 @return VOID.\r
577\r
578**/\r
93e3992d 579VOID\r
580ConvertMemorySizeToString (\r
581 IN UINT32 MemorySize,\r
582 OUT CHAR16 **String\r
583 )\r
93e3992d 584{\r
585 CHAR16 *StringBuffer;\r
586\r
587 StringBuffer = AllocateZeroPool (0x20);\r
588 ASSERT (StringBuffer != NULL);\r
589 UnicodeValueToString (StringBuffer, LEFT_JUSTIFY, MemorySize, 6);\r
590 StrCat (StringBuffer, L" MB RAM");\r
591\r
592 *String = (CHAR16 *) StringBuffer;\r
593\r
594 return ;\r
595}\r
596\r
b30312ba 597/**\r
b4489769 598 Update the banner information for the Front Page based on DataHub information.\r
93e3992d 599\r
b30312ba 600**/\r
601VOID\r
602UpdateFrontPageStrings (\r
603 VOID\r
604 )\r
93e3992d 605{\r
606 EFI_STATUS Status;\r
607 EFI_STRING_ID TokenToUpdate;\r
608 CHAR16 *NewString;\r
609 UINT64 MonotonicCount;\r
610 EFI_DATA_HUB_PROTOCOL *DataHub;\r
611 EFI_DATA_RECORD_HEADER *Record;\r
612 EFI_SUBCLASS_TYPE1_HEADER *DataHeader;\r
613 EFI_MISC_BIOS_VENDOR_DATA *BiosVendor;\r
614 EFI_MISC_SYSTEM_MANUFACTURER_DATA *SystemManufacturer;\r
615 EFI_PROCESSOR_VERSION_DATA *ProcessorVersion;\r
616 EFI_PROCESSOR_CORE_FREQUENCY_DATA *ProcessorFrequency;\r
617 EFI_MEMORY_ARRAY_START_ADDRESS_DATA *MemoryArray;\r
618 BOOLEAN Find[5];\r
619\r
620 ZeroMem (Find, sizeof (Find));\r
621\r
622 //\r
623 // Update Front Page strings\r
624 //\r
625 Status = gBS->LocateProtocol (\r
626 &gEfiDataHubProtocolGuid,\r
627 NULL,\r
628 (VOID **) &DataHub\r
629 );\r
630 ASSERT_EFI_ERROR (Status);\r
631\r
632 MonotonicCount = 0;\r
633 Record = NULL;\r
634 do {\r
635 Status = DataHub->GetNextRecord (DataHub, &MonotonicCount, NULL, &Record);\r
636 if (Record->DataRecordClass == EFI_DATA_RECORD_CLASS_DATA) {\r
637 DataHeader = (EFI_SUBCLASS_TYPE1_HEADER *) (Record + 1);\r
638 if (CompareGuid (&Record->DataRecordGuid, &gEfiMiscSubClassGuid) &&\r
639 (DataHeader->RecordType == EFI_MISC_BIOS_VENDOR_RECORD_NUMBER)\r
640 ) {\r
641 BiosVendor = (EFI_MISC_BIOS_VENDOR_DATA *) (DataHeader + 1);\r
642 GetProducerString (&Record->ProducerName, BiosVendor->BiosVersion, &NewString);\r
643 TokenToUpdate = STRING_TOKEN (STR_FRONT_PAGE_BIOS_VERSION);\r
9226efe5 644 HiiLibSetString (gFrontPagePrivate.HiiHandle, TokenToUpdate, NewString);\r
93e3992d 645 FreePool (NewString);\r
646 Find[0] = TRUE;\r
647 }\r
648\r
649 if (CompareGuid (&Record->DataRecordGuid, &gEfiMiscSubClassGuid) &&\r
650 (DataHeader->RecordType == EFI_MISC_SYSTEM_MANUFACTURER_RECORD_NUMBER)\r
651 ) {\r
652 SystemManufacturer = (EFI_MISC_SYSTEM_MANUFACTURER_DATA *) (DataHeader + 1);\r
653 GetProducerString (&Record->ProducerName, SystemManufacturer->SystemProductName, &NewString);\r
654 TokenToUpdate = STRING_TOKEN (STR_FRONT_PAGE_COMPUTER_MODEL);\r
9226efe5 655 HiiLibSetString (gFrontPagePrivate.HiiHandle, TokenToUpdate, NewString);\r
93e3992d 656 FreePool (NewString);\r
657 Find[1] = TRUE;\r
658 }\r
659\r
660 if (CompareGuid (&Record->DataRecordGuid, &gEfiProcessorSubClassGuid) &&\r
661 (DataHeader->RecordType == ProcessorVersionRecordType)\r
662 ) {\r
663 ProcessorVersion = (EFI_PROCESSOR_VERSION_DATA *) (DataHeader + 1);\r
664 GetProducerString (&Record->ProducerName, *ProcessorVersion, &NewString);\r
665 TokenToUpdate = STRING_TOKEN (STR_FRONT_PAGE_CPU_MODEL);\r
9226efe5 666 HiiLibSetString (gFrontPagePrivate.HiiHandle, TokenToUpdate, NewString);\r
93e3992d 667 FreePool (NewString);\r
668 Find[2] = TRUE;\r
669 }\r
670\r
671 if (CompareGuid (&Record->DataRecordGuid, &gEfiProcessorSubClassGuid) &&\r
672 (DataHeader->RecordType == ProcessorCoreFrequencyRecordType)\r
673 ) {\r
674 ProcessorFrequency = (EFI_PROCESSOR_CORE_FREQUENCY_DATA *) (DataHeader + 1);\r
675 ConvertProcessorToString (ProcessorFrequency, &NewString);\r
676 TokenToUpdate = STRING_TOKEN (STR_FRONT_PAGE_CPU_SPEED);\r
9226efe5 677 HiiLibSetString (gFrontPagePrivate.HiiHandle, TokenToUpdate, NewString);\r
93e3992d 678 FreePool (NewString);\r
679 Find[3] = TRUE;\r
680 }\r
681\r
682 if (CompareGuid (&Record->DataRecordGuid, &gEfiMemorySubClassGuid) &&\r
683 (DataHeader->RecordType == EFI_MEMORY_ARRAY_START_ADDRESS_RECORD_NUMBER)\r
684 ) {\r
685 MemoryArray = (EFI_MEMORY_ARRAY_START_ADDRESS_DATA *) (DataHeader + 1);\r
686 ConvertMemorySizeToString (\r
687 (UINT32)(RShiftU64((MemoryArray->MemoryArrayEndAddress - MemoryArray->MemoryArrayStartAddress + 1), 20)),\r
688 &NewString\r
689 );\r
690 TokenToUpdate = STRING_TOKEN (STR_FRONT_PAGE_MEMORY_SIZE);\r
9226efe5 691 HiiLibSetString (gFrontPagePrivate.HiiHandle, TokenToUpdate, NewString);\r
93e3992d 692 FreePool (NewString);\r
693 Find[4] = TRUE;\r
694 }\r
695 }\r
696 } while (!EFI_ERROR (Status) && (MonotonicCount != 0) && !(Find[0] && Find[1] && Find[2] && Find[3] && Find[4]));\r
697\r
698 return ;\r
699}\r
700\r
b30312ba 701/**\r
702 Function waits for a given event to fire, or for an optional timeout to expire.\r
703\r
704\r
705 @param Event The event to wait for\r
706 \r
707 @param Timeout An optional timeout value in 100 ns units.\r
708\r
709 @retval EFI_SUCCESS Event fired before Timeout expired.\r
710 @retval EFI_TIME_OUT Timout expired before Event fired..\r
711\r
712**/\r
93e3992d 713EFI_STATUS\r
714WaitForSingleEvent (\r
715 IN EFI_EVENT Event,\r
716 IN UINT64 Timeout OPTIONAL\r
717 )\r
93e3992d 718{\r
719 EFI_STATUS Status;\r
720 UINTN Index;\r
721 EFI_EVENT TimerEvent;\r
722 EFI_EVENT WaitList[2];\r
723\r
724 if (Timeout) {\r
725 //\r
726 // Create a timer event\r
727 //\r
728 Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimerEvent);\r
729 if (!EFI_ERROR (Status)) {\r
730 //\r
731 // Set the timer event\r
732 //\r
733 gBS->SetTimer (\r
734 TimerEvent,\r
735 TimerRelative,\r
736 Timeout\r
737 );\r
738\r
739 //\r
740 // Wait for the original event or the timer\r
741 //\r
742 WaitList[0] = Event;\r
743 WaitList[1] = TimerEvent;\r
744 Status = gBS->WaitForEvent (2, WaitList, &Index);\r
745 gBS->CloseEvent (TimerEvent);\r
746\r
747 //\r
748 // If the timer expired, change the return to timed out\r
749 //\r
750 if (!EFI_ERROR (Status) && Index == 1) {\r
751 Status = EFI_TIMEOUT;\r
752 }\r
753 }\r
754 } else {\r
755 //\r
756 // No timeout... just wait on the event\r
757 //\r
758 Status = gBS->WaitForEvent (1, &Event, &Index);\r
759 ASSERT (!EFI_ERROR (Status));\r
760 ASSERT (Index == 0);\r
761 }\r
762\r
763 return Status;\r
764}\r
765\r
b30312ba 766/**\r
93e3992d 767 Function show progress bar to wait for user input.\r
768\r
93e3992d 769\r
b30312ba 770 @param TimeoutDefault - The fault time out value before the system\r
771 continue to boot.\r
93e3992d 772\r
b30312ba 773 @retval EFI_SUCCESS User pressed some key except "Enter"\r
774 @retval EFI_TIME_OUT Timout expired or user press "Enter"\r
775\r
776**/\r
777EFI_STATUS\r
778ShowProgress (\r
779 IN UINT16 TimeoutDefault\r
780 )\r
93e3992d 781{\r
782 EFI_STATUS Status;\r
783 CHAR16 *TmpStr;\r
784 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Foreground;\r
785 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Background;\r
786 EFI_GRAPHICS_OUTPUT_BLT_PIXEL Color;\r
787 EFI_INPUT_KEY Key;\r
788 UINT16 TimeoutRemain;\r
789\r
790 if (TimeoutDefault == 0) {\r
791 return EFI_TIMEOUT;\r
792 }\r
793\r
0fc82496 794 DEBUG ((EFI_D_INFO, "\n\nStart showing progress bar... Press any key to stop it! ...Zzz....\n"));\r
795 \r
93e3992d 796 SetMem (&Foreground, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0xff);\r
797 SetMem (&Background, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0x0);\r
798 SetMem (&Color, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0xff);\r
799\r
800 //\r
801 // Clear the progress status bar first\r
802 //\r
803 TmpStr = GetStringById (STRING_TOKEN (STR_START_BOOT_OPTION));\r
804 if (TmpStr != NULL) {\r
805 PlatformBdsShowProgress (Foreground, Background, TmpStr, Color, 0, 0);\r
806 }\r
807\r
808 TimeoutRemain = TimeoutDefault;\r
809 while (TimeoutRemain != 0) {\r
0fc82496 810 DEBUG ((EFI_D_INFO, "Showing progress bar...Remaining %d second!\n", TimeoutRemain));\r
811 \r
93e3992d 812 Status = WaitForSingleEvent (gST->ConIn->WaitForKey, ONE_SECOND);\r
813 if (Status != EFI_TIMEOUT) {\r
814 break;\r
815 }\r
816 TimeoutRemain--;\r
817\r
818 //\r
819 // Show progress\r
820 //\r
821 if (TmpStr != NULL) {\r
822 PlatformBdsShowProgress (\r
823 Foreground,\r
824 Background,\r
825 TmpStr,\r
826 Color,\r
827 ((TimeoutDefault - TimeoutRemain) * 100 / TimeoutDefault),\r
828 0\r
829 );\r
830 }\r
831 }\r
832 gBS->FreePool (TmpStr);\r
833\r
834 //\r
835 // Timeout expired\r
836 //\r
837 if (TimeoutRemain == 0) {\r
838 return EFI_TIMEOUT;\r
839 }\r
840\r
841 //\r
842 // User pressed some key\r
843 //\r
844 Status = gST->ConIn->ReadKeyStroke (gST->ConIn, &Key);\r
845 if (EFI_ERROR (Status)) {\r
846 return Status;\r
847 }\r
848\r
849 if (Key.UnicodeChar == CHAR_CARRIAGE_RETURN) {\r
850 //\r
851 // User pressed enter, equivalent to select "continue"\r
852 //\r
853 return EFI_TIMEOUT;\r
854 }\r
855\r
856 return EFI_SUCCESS;\r
857}\r
858\r
b30312ba 859/**\r
93e3992d 860 This function is the main entry of the platform setup entry.\r
861 The function will present the main menu of the system setup,\r
862 this is the platform reference part and can be customize.\r
863\r
93e3992d 864\r
b30312ba 865 @param TimeoutDefault - The fault time out value before the system\r
866 continue to boot.\r
867 @param ConnectAllHappened - The indicater to check if the connect all have\r
868 already happended.\r
93e3992d 869\r
b30312ba 870 @return VOID.\r
871\r
872**/\r
873VOID\r
874PlatformBdsEnterFrontPage (\r
875 IN UINT16 TimeoutDefault,\r
876 IN BOOLEAN ConnectAllHappened\r
877 )\r
93e3992d 878{\r
879 EFI_STATUS Status;\r
880 EFI_CONSOLE_CONTROL_PROTOCOL *ConsoleControl;\r
881\r
b3bac2c9 882 PERF_START (0, "BdsTimeOut", "BDS", 0);\r
93e3992d 883 //\r
884 // Indicate if we need connect all in the platform setup\r
885 //\r
886 if (ConnectAllHappened) {\r
887 gConnectAllHappened = TRUE;\r
888 }\r
889\r
890 if (TimeoutDefault != 0xffff) {\r
891 gBS->RestoreTPL (TPL_APPLICATION);\r
892 Status = ShowProgress (TimeoutDefault);\r
893 gBS->RaiseTPL (TPL_APPLICATION);\r
894\r
895 if (EFI_ERROR (Status)) {\r
896 //\r
897 // Timeout or user press enter to continue\r
898 //\r
813acf3a 899 gST->ConOut->EnableCursor (gST->ConOut, TRUE);\r
900 gST->ConOut->ClearScreen (gST->ConOut);\r
93e3992d 901 goto Exit;\r
902 }\r
903 }\r
904\r
905 do {\r
906\r
b30312ba 907 InitializeFrontPage (FALSE);\r
93e3992d 908\r
909 //\r
910 // Update Front Page strings\r
911 //\r
912 UpdateFrontPageStrings ();\r
913\r
914 gCallbackKey = 0;\r
93e3992d 915 Status = CallFrontPage ();\r
93e3992d 916\r
917 //\r
918 // If gCallbackKey is greater than 1 and less or equal to 5,\r
919 // it will lauch configuration utilities.\r
920 // 2 = set language\r
921 // 3 = boot manager\r
922 // 4 = device manager\r
923 // 5 = boot maintainenance manager\r
924 //\r
925 if (gCallbackKey != 0) {\r
926 REPORT_STATUS_CODE (\r
927 EFI_PROGRESS_CODE,\r
928 (EFI_SOFTWARE_DXE_BS_DRIVER | EFI_SW_PC_USER_SETUP)\r
929 );\r
930 }\r
931 //\r
932 // Based on the key that was set, we can determine what to do\r
933 //\r
934 switch (gCallbackKey) {\r
935 //\r
936 // The first 4 entries in the Front Page are to be GUARANTEED to remain constant so IHV's can\r
937 // describe to their customers in documentation how to find their setup information (namely\r
938 // under the device manager and specific buckets)\r
939 //\r
940 // These entries consist of the Continue, Select language, Boot Manager, and Device Manager\r
941 //\r
942 case FRONT_PAGE_KEY_CONTINUE:\r
943 //\r
944 // User hit continue\r
945 //\r
946 break;\r
947\r
948 case FRONT_PAGE_KEY_LANGUAGE:\r
949 //\r
950 // User made a language setting change - display front page again\r
951 //\r
952 break;\r
953\r
954 case FRONT_PAGE_KEY_BOOT_MANAGER:\r
955 //\r
956 // User chose to run the Boot Manager\r
957 //\r
958 CallBootManager ();\r
959 break;\r
960\r
961 case FRONT_PAGE_KEY_DEVICE_MANAGER:\r
962 //\r
963 // Display the Device Manager\r
964 //\r
965 do {\r
966 CallDeviceManager();\r
967 } while (gCallbackKey == FRONT_PAGE_KEY_DEVICE_MANAGER);\r
968 break;\r
969\r
970 case FRONT_PAGE_KEY_BOOT_MAINTAIN:\r
971 //\r
972 // Display the Boot Maintenance Manager\r
973 //\r
974 BdsStartBootMaint ();\r
975 break;\r
976 }\r
977\r
978 } while ((Status == EFI_SUCCESS) && (gCallbackKey != FRONT_PAGE_KEY_CONTINUE));\r
979\r
980 //\r
981 //Will leave browser, check any reset required change is applied? if yes, reset system\r
982 //\r
983 gBS->RestoreTPL (TPL_APPLICATION);\r
984 SetupResetReminder ();\r
985 gBS->RaiseTPL (TPL_APPLICATION);\r
986\r
987Exit:\r
988 //\r
989 // Automatically load current entry\r
990 // Note: The following lines of code only execute when Auto boot\r
991 // takes affect\r
992 //\r
b3bac2c9 993 PERF_END (0, "BdsTimeOut", "BDS", 0);\r
93e3992d 994 Status = gBS->LocateProtocol (&gEfiConsoleControlProtocolGuid, NULL, (VOID **) &ConsoleControl);\r
995 ConsoleControl->SetMode (ConsoleControl, EfiConsoleControlScreenText);\r
996\r
997}\r