2 The functions for Boot Maintainence Main menu.
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.
15 #include "BootMaint.h"
18 #include "FrontPage.h"
20 EFI_DEVICE_PATH_PROTOCOL EndDevicePath
[] = {
23 END_ENTIRE_DEVICE_PATH_SUBTYPE
,
25 END_DEVICE_PATH_LENGTH
,
31 HII_VENDOR_DEVICE_PATH mBmmHiiVendorDevicePath
= {
37 (UINT8
) (sizeof (VENDOR_DEVICE_PATH
)),
38 (UINT8
) ((sizeof (VENDOR_DEVICE_PATH
)) >> 8)
42 // {165A028F-0BB2-4b5f-8747-77592E3F6499}
44 { 0x165a028f, 0xbb2, 0x4b5f, { 0x87, 0x47, 0x77, 0x59, 0x2e, 0x3f, 0x64, 0x99 } }
48 END_ENTIRE_DEVICE_PATH_SUBTYPE
,
50 (UINT8
) (END_DEVICE_PATH_LENGTH
),
51 (UINT8
) ((END_DEVICE_PATH_LENGTH
) >> 8)
56 HII_VENDOR_DEVICE_PATH mFeHiiVendorDevicePath
= {
62 (UINT8
) (sizeof (VENDOR_DEVICE_PATH
)),
63 (UINT8
) ((sizeof (VENDOR_DEVICE_PATH
)) >> 8)
67 // {91DB4238-B0C8-472e-BBCF-F3A6541010F4}
69 { 0x91db4238, 0xb0c8, 0x472e, { 0xbb, 0xcf, 0xf3, 0xa6, 0x54, 0x10, 0x10, 0xf4 } }
73 END_ENTIRE_DEVICE_PATH_SUBTYPE
,
75 (UINT8
) (END_DEVICE_PATH_LENGTH
),
76 (UINT8
) ((END_DEVICE_PATH_LENGTH
) >> 8)
81 EFI_GUID EfiLegacyDevOrderGuid
= EFI_LEGACY_DEV_ORDER_VARIABLE_GUID
;
82 EFI_GUID mBootMaintGuid
= BOOT_MAINT_FORMSET_GUID
;
83 EFI_GUID mFileExplorerGuid
= FILE_EXPLORE_FORMSET_GUID
;
85 CHAR16 mBootMaintStorageName
[] = L
"BmData";
86 CHAR16 mFileExplorerStorageName
[] = L
"FeData";
91 @param CallbackData The BMM context data.
96 IN BMM_CALLBACK_DATA
*CallbackData
100 Free up all Menu Option list.
109 Create string tokens for a menu from its help strings and display strings
111 @param CallbackData The BMM context data.
112 @param HiiHandle Hii Handle of the package to be updated.
113 @param MenuOption The Menu whose string tokens need to be created
115 @retval EFI_SUCCESS String tokens created successfully
116 @retval others contain some errors
119 CreateMenuStringToken (
120 IN BMM_CALLBACK_DATA
*CallbackData
,
121 IN EFI_HII_HANDLE HiiHandle
,
122 IN BM_MENU_OPTION
*MenuOption
125 BM_MENU_ENTRY
*NewMenuEntry
;
128 for (Index
= 0; Index
< MenuOption
->MenuNumber
; Index
++) {
129 NewMenuEntry
= BOpt_GetMenuEntry (MenuOption
, Index
);
131 NewMenuEntry
->DisplayStringToken
= HiiSetString (
134 NewMenuEntry
->DisplayString
,
138 if (NULL
== NewMenuEntry
->HelpString
) {
139 NewMenuEntry
->HelpStringToken
= NewMenuEntry
->DisplayStringToken
;
141 NewMenuEntry
->HelpStringToken
= HiiSetString (
144 NewMenuEntry
->HelpString
,
154 This function allows a caller to extract the current configuration for one
155 or more named elements from the target driver.
158 @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
159 @param Request A null-terminated Unicode string in <ConfigRequest> format.
160 @param Progress On return, points to a character in the Request string.
161 Points to the string's null terminator if request was successful.
162 Points to the most recent '&' before the first failing name/value
163 pair (or the beginning of the string if the failure is in the
164 first name/value pair) if the request was not successful.
165 @param Results A null-terminated Unicode string in <ConfigAltResp> format which
166 has all values filled in for the names in the Request string.
167 String to be allocated by the called function.
169 @retval EFI_SUCCESS The Results is filled with the requested values.
170 @retval EFI_OUT_OF_RESOURCES Not enough memory to store the results.
171 @retval EFI_INVALID_PARAMETER Request is NULL, illegal syntax, or unknown name.
172 @retval EFI_NOT_FOUND Routing data doesn't match any storage in this driver.
177 BootMaintExtractConfig (
178 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
179 IN CONST EFI_STRING Request
,
180 OUT EFI_STRING
*Progress
,
181 OUT EFI_STRING
*Results
186 BMM_CALLBACK_DATA
*Private
;
188 if (Request
== NULL
) {
189 return EFI_INVALID_PARAMETER
;
192 Private
= BMM_CALLBACK_DATA_FROM_THIS (This
);
195 // Convert buffer data to <ConfigResp> by helper function BlockToConfig()
197 BufferSize
= sizeof (BMM_FAKE_NV_DATA
);
198 Status
= gHiiConfigRouting
->BlockToConfig (
201 (UINT8
*) &Private
->BmmFakeNvData
,
210 This function processes the results of changes in configuration.
213 @param This Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.
214 @param Action Specifies the type of action taken by the browser.
215 @param QuestionId A unique value which is sent to the original exporting driver
216 so that it can identify the type of data to expect.
217 @param Type The type of value for the question.
218 @param Value A pointer to the data being sent to the original exporting driver.
219 @param ActionRequest On return, points to the action requested by the callback function.
221 @retval EFI_SUCCESS The callback successfully handled the action.
222 @retval EFI_OUT_OF_RESOURCES Not enough storage is available to hold the variable and its data.
223 @retval EFI_DEVICE_ERROR The variable could not be saved.
224 @retval EFI_UNSUPPORTED The specified Action is not supported by the callback.
225 @retval EFI_INVALID_PARAMETER The parameter of Value or ActionRequest is invalid.
230 IN CONST EFI_HII_CONFIG_ACCESS_PROTOCOL
*This
,
231 IN EFI_BROWSER_ACTION Action
,
232 IN EFI_QUESTION_ID QuestionId
,
234 IN EFI_IFR_TYPE_VALUE
*Value
,
235 OUT EFI_BROWSER_ACTION_REQUEST
*ActionRequest
238 BMM_CALLBACK_DATA
*Private
;
239 BM_MENU_ENTRY
*NewMenuEntry
;
240 BMM_FAKE_NV_DATA
*CurrentFakeNVMap
;
256 if ((Value
== NULL
) || (ActionRequest
== NULL
)) {
257 return EFI_INVALID_PARAMETER
;
267 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
269 Private
= BMM_CALLBACK_DATA_FROM_THIS (This
);
270 UpdatePageId (Private
, QuestionId
);
273 // Retrive uncommitted data from Form Browser
275 CurrentFakeNVMap
= &Private
->BmmFakeNvData
;
276 BufferSize
= sizeof (BMM_FAKE_NV_DATA
);
277 Status
= GetBrowserData (NULL
, NULL
, &BufferSize
, (UINT8
*) CurrentFakeNVMap
);
278 if (EFI_ERROR (Status
)) {
283 // need to be subtituded.
285 // Update Select FD/HD/CD/NET/BEV Order Form
287 if (FORM_SET_FD_ORDER_ID
== Private
->BmmPreviousPageId
||
288 FORM_SET_HD_ORDER_ID
== Private
->BmmPreviousPageId
||
289 FORM_SET_CD_ORDER_ID
== Private
->BmmPreviousPageId
||
290 FORM_SET_NET_ORDER_ID
== Private
->BmmPreviousPageId
||
291 FORM_SET_BEV_ORDER_ID
== Private
->BmmPreviousPageId
||
292 ((FORM_BOOT_SETUP_ID
== Private
->BmmPreviousPageId
) &&
293 (QuestionId
>= LEGACY_FD_QUESTION_ID
) &&
294 (QuestionId
< (LEGACY_BEV_QUESTION_ID
+ 100)) )
297 DisMap
= Private
->BmmOldFakeNVData
.DisableMap
;
299 FormId
= Private
->BmmPreviousPageId
;
300 if (FormId
== FORM_BOOT_SETUP_ID
) {
301 FormId
= Private
->BmmCurrentPageId
;
305 case FORM_SET_FD_ORDER_ID
:
306 Number
= (UINT16
) LegacyFDMenu
.MenuNumber
;
307 OldLegacyDev
= Private
->BmmOldFakeNVData
.LegacyFD
;
308 NewLegacyDev
= CurrentFakeNVMap
->LegacyFD
;
311 case FORM_SET_HD_ORDER_ID
:
312 Number
= (UINT16
) LegacyHDMenu
.MenuNumber
;
313 OldLegacyDev
= Private
->BmmOldFakeNVData
.LegacyHD
;
314 NewLegacyDev
= CurrentFakeNVMap
->LegacyHD
;
317 case FORM_SET_CD_ORDER_ID
:
318 Number
= (UINT16
) LegacyCDMenu
.MenuNumber
;
319 OldLegacyDev
= Private
->BmmOldFakeNVData
.LegacyCD
;
320 NewLegacyDev
= CurrentFakeNVMap
->LegacyCD
;
323 case FORM_SET_NET_ORDER_ID
:
324 Number
= (UINT16
) LegacyNETMenu
.MenuNumber
;
325 OldLegacyDev
= Private
->BmmOldFakeNVData
.LegacyNET
;
326 NewLegacyDev
= CurrentFakeNVMap
->LegacyNET
;
329 case FORM_SET_BEV_ORDER_ID
:
330 Number
= (UINT16
) LegacyBEVMenu
.MenuNumber
;
331 OldLegacyDev
= Private
->BmmOldFakeNVData
.LegacyBEV
;
332 NewLegacyDev
= CurrentFakeNVMap
->LegacyBEV
;
339 // First, find the different position
340 // if there is change, it should be only one
342 for (Index
= 0; Index
< Number
; Index
++) {
343 if (OldLegacyDev
[Index
] != NewLegacyDev
[Index
]) {
344 OldValue
= OldLegacyDev
[Index
];
345 NewValue
= NewLegacyDev
[Index
];
350 if (Index
!= Number
) {
352 // there is change, now process
354 if (0xFF == NewValue
) {
356 // This item will be disable
357 // Just move the items behind this forward to overlap it
360 Bit
= 7 - (OldValue
% 8);
361 DisMap
[Pos
] = (UINT8
) (DisMap
[Pos
] | (UINT8
) (1 << Bit
));
362 for (Index2
= Index
; Index2
< Number
- 1; Index2
++) {
363 NewLegacyDev
[Index2
] = NewLegacyDev
[Index2
+ 1];
366 NewLegacyDev
[Index2
] = 0xFF;
368 for (Index2
= 0; Index2
< Number
; Index2
++) {
369 if (Index2
== Index
) {
373 if (OldLegacyDev
[Index2
] == NewValue
) {
375 // If NewValue is in OldLegacyDev array
376 // remember its old position
378 NewValuePos
= Index2
;
383 if (Index2
!= Number
) {
385 // We will change current item to an existing item
386 // (It's hard to describe here, please read code, it's like a cycle-moving)
388 for (Index2
= NewValuePos
; Index2
!= Index
;) {
389 if (NewValuePos
< Index
) {
390 NewLegacyDev
[Index2
] = OldLegacyDev
[Index2
+ 1];
393 NewLegacyDev
[Index2
] = OldLegacyDev
[Index2
- 1];
399 // If NewValue is not in OldlegacyDev array, we are changing to a disabled item
400 // so we should modify DisMap to reflect the change
403 Bit
= 7 - (NewValue
% 8);
404 DisMap
[Pos
] = (UINT8
) (DisMap
[Pos
] & (~ (UINT8
) (1 << Bit
)));
405 if (0xFF != OldValue
) {
407 // Because NewValue is a item that was disabled before
408 // so after changing the OldValue should be disabled
409 // actually we are doing a swap of enable-disable states of two items
412 Bit
= 7 - (OldValue
% 8);
413 DisMap
[Pos
] = (UINT8
) (DisMap
[Pos
] | (UINT8
) (1 << Bit
));
418 // To prevent DISABLE appears in the middle of the list
419 // we should perform a re-ordering
422 while (Index
< Number
) {
423 if (0xFF != NewLegacyDev
[Index
]) {
430 while (Index2
< Number
) {
431 if (0xFF != NewLegacyDev
[Index2
]) {
438 if (Index2
< Number
) {
439 NewLegacyDev
[Index
] = NewLegacyDev
[Index2
];
440 NewLegacyDev
[Index2
] = 0xFF;
454 if (QuestionId
< FILE_OPTION_OFFSET
) {
455 if (QuestionId
< CONFIG_OPTION_OFFSET
) {
456 switch (QuestionId
) {
457 case KEY_VALUE_BOOT_FROM_FILE
:
458 Private
->FeCurrentState
= BOOT_FROM_FILE_STATE
;
461 // Exit Bmm main formset to send File Explorer formset.
463 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
466 case FORM_BOOT_ADD_ID
:
467 Private
->FeCurrentState
= ADD_BOOT_OPTION_STATE
;
470 // Exit Bmm main formset to send File Explorer formset.
472 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
475 case FORM_DRV_ADD_FILE_ID
:
476 Private
->FeCurrentState
= ADD_DRIVER_OPTION_STATE
;
479 // Exit Bmm main formset to send File Explorer formset.
481 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_EXIT
;
484 case FORM_DRV_ADD_HANDLE_ID
:
485 CleanUpPage (FORM_DRV_ADD_HANDLE_ID
, Private
);
486 UpdateDrvAddHandlePage (Private
);
489 case FORM_BOOT_DEL_ID
:
490 CleanUpPage (FORM_BOOT_DEL_ID
, Private
);
491 UpdateBootDelPage (Private
);
494 case FORM_BOOT_CHG_ID
:
495 case FORM_DRV_CHG_ID
:
496 UpdatePageBody (QuestionId
, Private
);
499 case FORM_DRV_DEL_ID
:
500 CleanUpPage (FORM_DRV_DEL_ID
, Private
);
501 UpdateDrvDelPage (Private
);
504 case FORM_BOOT_NEXT_ID
:
505 CleanUpPage (FORM_BOOT_NEXT_ID
, Private
);
506 UpdateBootNextPage (Private
);
509 case FORM_TIME_OUT_ID
:
510 CleanUpPage (FORM_TIME_OUT_ID
, Private
);
511 UpdateTimeOutPage (Private
);
515 gRT
->ResetSystem (EfiResetCold
, EFI_SUCCESS
, 0, NULL
);
516 return EFI_UNSUPPORTED
;
519 case FORM_CON_OUT_ID
:
520 case FORM_CON_ERR_ID
:
521 UpdatePageBody (QuestionId
, Private
);
524 case FORM_CON_MODE_ID
:
525 CleanUpPage (FORM_CON_MODE_ID
, Private
);
526 UpdateConModePage (Private
);
529 case FORM_CON_COM_ID
:
530 CleanUpPage (FORM_CON_COM_ID
, Private
);
531 UpdateConCOMPage (Private
);
534 case FORM_SET_FD_ORDER_ID
:
535 case FORM_SET_HD_ORDER_ID
:
536 case FORM_SET_CD_ORDER_ID
:
537 case FORM_SET_NET_ORDER_ID
:
538 case FORM_SET_BEV_ORDER_ID
:
539 CleanUpPage (QuestionId
, Private
);
540 UpdateSetLegacyDeviceOrderPage (QuestionId
, Private
);
543 case KEY_VALUE_SAVE_AND_EXIT
:
544 case KEY_VALUE_NO_SAVE_AND_EXIT
:
546 if (QuestionId
== KEY_VALUE_SAVE_AND_EXIT
) {
547 Status
= ApplyChangeHandler (Private
, CurrentFakeNVMap
, Private
->BmmPreviousPageId
);
548 if (EFI_ERROR (Status
)) {
551 } else if (QuestionId
== KEY_VALUE_NO_SAVE_AND_EXIT
) {
552 DiscardChangeHandler (Private
, CurrentFakeNVMap
);
556 // Tell browser not to ask for confirmation of changes,
557 // since we have already applied or discarded.
559 *ActionRequest
= EFI_BROWSER_ACTION_REQUEST_SUBMIT
;
565 } else if ((QuestionId
>= TERMINAL_OPTION_OFFSET
) && (QuestionId
< CONSOLE_OPTION_OFFSET
)) {
566 Index2
= (UINT16
) (QuestionId
- TERMINAL_OPTION_OFFSET
);
567 Private
->CurrentTerminal
= Index2
;
569 CleanUpPage (FORM_CON_COM_SETUP_ID
, Private
);
570 UpdateTerminalPage (Private
);
572 } else if (QuestionId
>= HANDLE_OPTION_OFFSET
) {
573 Index2
= (UINT16
) (QuestionId
- HANDLE_OPTION_OFFSET
);
575 NewMenuEntry
= BOpt_GetMenuEntry (&DriverMenu
, Index2
);
576 ASSERT (NewMenuEntry
!= NULL
);
577 Private
->HandleContext
= (BM_HANDLE_CONTEXT
*) NewMenuEntry
->VariableContext
;
579 CleanUpPage (FORM_DRV_ADD_HANDLE_DESC_ID
, Private
);
581 Private
->MenuEntry
= NewMenuEntry
;
582 Private
->LoadContext
->FilePathList
= Private
->HandleContext
->DevicePath
;
584 UpdateDriverAddHandleDescPage (Private
);
589 // Pass changed uncommitted data back to Form Browser
591 BufferSize
= sizeof (BMM_FAKE_NV_DATA
);
592 Status
= SetBrowserData (NULL
, NULL
, BufferSize
, (UINT8
*) CurrentFakeNVMap
, NULL
);
598 Function handling request to apply changes for BMM pages.
600 @param Private Pointer to callback data buffer.
601 @param CurrentFakeNVMap Pointer to buffer holding data of various values used by BMM
602 @param FormId ID of the form which has sent the request to apply change.
604 @retval EFI_SUCCESS Change successfully applied.
605 @retval Other Error occurs while trying to apply changes.
610 IN BMM_CALLBACK_DATA
*Private
,
611 IN BMM_FAKE_NV_DATA
*CurrentFakeNVMap
,
612 IN EFI_FORM_ID FormId
615 BM_CONSOLE_CONTEXT
*NewConsoleContext
;
616 BM_TERMINAL_CONTEXT
*NewTerminalContext
;
617 BM_LOAD_CONTEXT
*NewLoadContext
;
618 BM_MENU_ENTRY
*NewMenuEntry
;
622 Status
= EFI_SUCCESS
;
625 case FORM_SET_FD_ORDER_ID
:
626 case FORM_SET_HD_ORDER_ID
:
627 case FORM_SET_CD_ORDER_ID
:
628 case FORM_SET_NET_ORDER_ID
:
629 case FORM_SET_BEV_ORDER_ID
:
630 Var_UpdateBBSOption (Private
);
633 case FORM_BOOT_DEL_ID
:
634 ASSERT (BootOptionMenu
.MenuNumber
<= (sizeof (CurrentFakeNVMap
->BootOptionDel
) / sizeof (UINT8
)));
635 for (Index
= 0; Index
< BootOptionMenu
.MenuNumber
; Index
++) {
636 NewMenuEntry
= BOpt_GetMenuEntry (&BootOptionMenu
, Index
);
637 NewLoadContext
= (BM_LOAD_CONTEXT
*) NewMenuEntry
->VariableContext
;
638 NewLoadContext
->Deleted
= CurrentFakeNVMap
->BootOptionDel
[Index
];
641 Var_DelBootOption ();
644 case FORM_DRV_DEL_ID
:
645 ASSERT (DriverOptionMenu
.MenuNumber
<= (sizeof (CurrentFakeNVMap
->DriverOptionDel
) / sizeof (UINT8
)));
646 for (Index
= 0; Index
< DriverOptionMenu
.MenuNumber
; Index
++) {
647 NewMenuEntry
= BOpt_GetMenuEntry (&DriverOptionMenu
, Index
);
648 NewLoadContext
= (BM_LOAD_CONTEXT
*) NewMenuEntry
->VariableContext
;
649 NewLoadContext
->Deleted
= CurrentFakeNVMap
->DriverOptionDel
[Index
];
652 Var_DelDriverOption ();
655 case FORM_BOOT_CHG_ID
:
656 Status
= Var_UpdateBootOrder (Private
);
659 case FORM_DRV_CHG_ID
:
660 Status
= Var_UpdateDriverOrder (Private
);
663 case FORM_TIME_OUT_ID
:
664 PcdSet16 (PcdPlatformBootTimeOut
, CurrentFakeNVMap
->BootTimeOut
);
666 Private
->BmmOldFakeNVData
.BootTimeOut
= CurrentFakeNVMap
->BootTimeOut
;
669 case FORM_BOOT_NEXT_ID
:
670 Status
= Var_UpdateBootNext (Private
);
673 case FORM_CON_MODE_ID
:
674 Status
= Var_UpdateConMode (Private
);
677 case FORM_CON_COM_SETUP_ID
:
678 NewMenuEntry
= BOpt_GetMenuEntry (&TerminalMenu
, Private
->CurrentTerminal
);
680 ASSERT (NewMenuEntry
!= NULL
);
682 NewTerminalContext
= (BM_TERMINAL_CONTEXT
*) NewMenuEntry
->VariableContext
;
684 NewTerminalContext
->BaudRateIndex
= CurrentFakeNVMap
->COMBaudRate
;
685 ASSERT (CurrentFakeNVMap
->COMBaudRate
< (sizeof (BaudRateList
) / sizeof (BaudRateList
[0])));
686 NewTerminalContext
->BaudRate
= BaudRateList
[CurrentFakeNVMap
->COMBaudRate
].Value
;
687 NewTerminalContext
->DataBitsIndex
= CurrentFakeNVMap
->COMDataRate
;
688 ASSERT (CurrentFakeNVMap
->COMDataRate
< (sizeof (DataBitsList
) / sizeof (DataBitsList
[0])));
689 NewTerminalContext
->DataBits
= (UINT8
) DataBitsList
[CurrentFakeNVMap
->COMDataRate
].Value
;
690 NewTerminalContext
->StopBitsIndex
= CurrentFakeNVMap
->COMStopBits
;
691 ASSERT (CurrentFakeNVMap
->COMStopBits
< (sizeof (StopBitsList
) / sizeof (StopBitsList
[0])));
692 NewTerminalContext
->StopBits
= (UINT8
) StopBitsList
[CurrentFakeNVMap
->COMStopBits
].Value
;
693 NewTerminalContext
->ParityIndex
= CurrentFakeNVMap
->COMParity
;
694 ASSERT (CurrentFakeNVMap
->COMParity
< (sizeof (ParityList
) / sizeof (ParityList
[0])));
695 NewTerminalContext
->Parity
= (UINT8
) ParityList
[CurrentFakeNVMap
->COMParity
].Value
;
696 NewTerminalContext
->TerminalType
= CurrentFakeNVMap
->COMTerminalType
;
698 ChangeTerminalDevicePath (
699 NewTerminalContext
->DevicePath
,
703 Var_UpdateConsoleInpOption ();
704 Var_UpdateConsoleOutOption ();
705 Var_UpdateErrorOutOption ();
709 ASSERT ((ConsoleInpMenu
.MenuNumber
+ TerminalMenu
.MenuNumber
) <= (sizeof (CurrentFakeNVMap
->ConsoleCheck
) / sizeof (UINT8
)));
710 for (Index
= 0; Index
< ConsoleInpMenu
.MenuNumber
; Index
++) {
711 NewMenuEntry
= BOpt_GetMenuEntry (&ConsoleInpMenu
, Index
);
712 NewConsoleContext
= (BM_CONSOLE_CONTEXT
*) NewMenuEntry
->VariableContext
;
713 NewConsoleContext
->IsActive
= CurrentFakeNVMap
->ConsoleCheck
[Index
];
716 for (Index
= 0; Index
< TerminalMenu
.MenuNumber
; Index
++) {
717 NewMenuEntry
= BOpt_GetMenuEntry (&TerminalMenu
, Index
);
718 NewTerminalContext
= (BM_TERMINAL_CONTEXT
*) NewMenuEntry
->VariableContext
;
719 NewTerminalContext
->IsConIn
= CurrentFakeNVMap
->ConsoleCheck
[Index
+ ConsoleInpMenu
.MenuNumber
];
722 Var_UpdateConsoleInpOption ();
725 case FORM_CON_OUT_ID
:
726 ASSERT ((ConsoleOutMenu
.MenuNumber
+ TerminalMenu
.MenuNumber
) <= (sizeof (CurrentFakeNVMap
->ConsoleCheck
) / sizeof (UINT8
)));
727 for (Index
= 0; Index
< ConsoleOutMenu
.MenuNumber
; Index
++) {
728 NewMenuEntry
= BOpt_GetMenuEntry (&ConsoleOutMenu
, Index
);
729 NewConsoleContext
= (BM_CONSOLE_CONTEXT
*) NewMenuEntry
->VariableContext
;
730 NewConsoleContext
->IsActive
= CurrentFakeNVMap
->ConsoleCheck
[Index
];
733 for (Index
= 0; Index
< TerminalMenu
.MenuNumber
; Index
++) {
734 NewMenuEntry
= BOpt_GetMenuEntry (&TerminalMenu
, Index
);
735 NewTerminalContext
= (BM_TERMINAL_CONTEXT
*) NewMenuEntry
->VariableContext
;
736 NewTerminalContext
->IsConOut
= CurrentFakeNVMap
->ConsoleCheck
[Index
+ ConsoleOutMenu
.MenuNumber
];
739 Var_UpdateConsoleOutOption ();
742 case FORM_CON_ERR_ID
:
743 ASSERT ((ConsoleErrMenu
.MenuNumber
+ TerminalMenu
.MenuNumber
) <= (sizeof (CurrentFakeNVMap
->ConsoleCheck
) / sizeof (UINT8
)));
744 for (Index
= 0; Index
< ConsoleErrMenu
.MenuNumber
; Index
++) {
745 NewMenuEntry
= BOpt_GetMenuEntry (&ConsoleErrMenu
, Index
);
746 NewConsoleContext
= (BM_CONSOLE_CONTEXT
*) NewMenuEntry
->VariableContext
;
747 NewConsoleContext
->IsActive
= CurrentFakeNVMap
->ConsoleCheck
[Index
];
750 for (Index
= 0; Index
< TerminalMenu
.MenuNumber
; Index
++) {
751 NewMenuEntry
= BOpt_GetMenuEntry (&TerminalMenu
, Index
);
752 NewTerminalContext
= (BM_TERMINAL_CONTEXT
*) NewMenuEntry
->VariableContext
;
753 NewTerminalContext
->IsStdErr
= CurrentFakeNVMap
->ConsoleCheck
[Index
+ ConsoleErrMenu
.MenuNumber
];
756 Var_UpdateErrorOutOption ();
759 case FORM_DRV_ADD_HANDLE_DESC_ID
:
760 Status
= Var_UpdateDriverOption (
762 Private
->BmmHiiHandle
,
763 CurrentFakeNVMap
->DriverAddHandleDesc
,
764 CurrentFakeNVMap
->DriverAddHandleOptionalData
,
765 CurrentFakeNVMap
->DriverAddForceReconnect
767 if (EFI_ERROR (Status
)) {
771 BOpt_GetDriverOptions (Private
);
772 CreateMenuStringToken (Private
, Private
->BmmHiiHandle
, &DriverOptionMenu
);
784 Discard all changes done to the BMM pages such as Boot Order change,
787 @param Private The BMM context data.
788 @param CurrentFakeNVMap The current Fack NV Map.
792 DiscardChangeHandler (
793 IN BMM_CALLBACK_DATA
*Private
,
794 IN BMM_FAKE_NV_DATA
*CurrentFakeNVMap
799 switch (Private
->BmmPreviousPageId
) {
800 case FORM_BOOT_CHG_ID
:
801 case FORM_DRV_CHG_ID
:
802 CopyMem (CurrentFakeNVMap
->OptionOrder
, Private
->BmmOldFakeNVData
.OptionOrder
, 100);
805 case FORM_BOOT_DEL_ID
:
806 ASSERT (BootOptionMenu
.MenuNumber
<= (sizeof (CurrentFakeNVMap
->BootOptionDel
) / sizeof (CurrentFakeNVMap
->BootOptionDel
[0])));
807 for (Index
= 0; Index
< BootOptionMenu
.MenuNumber
; Index
++) {
808 CurrentFakeNVMap
->BootOptionDel
[Index
] = 0x00;
812 case FORM_DRV_DEL_ID
:
813 ASSERT (DriverOptionMenu
.MenuNumber
<= (sizeof (CurrentFakeNVMap
->DriverOptionDel
) / sizeof (CurrentFakeNVMap
->DriverOptionDel
[0])));
814 for (Index
= 0; Index
< DriverOptionMenu
.MenuNumber
; Index
++) {
815 CurrentFakeNVMap
->DriverOptionDel
[Index
] = 0x00;
819 case FORM_BOOT_NEXT_ID
:
820 CurrentFakeNVMap
->BootNext
= Private
->BmmOldFakeNVData
.BootNext
;
823 case FORM_TIME_OUT_ID
:
824 CurrentFakeNVMap
->BootTimeOut
= Private
->BmmOldFakeNVData
.BootTimeOut
;
827 case FORM_DRV_ADD_HANDLE_DESC_ID
:
828 case FORM_DRV_ADD_FILE_ID
:
829 case FORM_DRV_ADD_HANDLE_ID
:
830 CurrentFakeNVMap
->DriverAddHandleDesc
[0] = 0x0000;
831 CurrentFakeNVMap
->DriverAddHandleOptionalData
[0] = 0x0000;
840 Initialize the Boot Maintenance Utitliy.
843 @retval EFI_SUCCESS utility ended successfully
844 @retval others contain some errors
852 EFI_LEGACY_BIOS_PROTOCOL
*LegacyBios
;
853 BMM_CALLBACK_DATA
*BmmCallbackInfo
;
857 Status
= EFI_SUCCESS
;
860 // Create CallbackData structures for Driver Callback
862 BmmCallbackInfo
= AllocateZeroPool (sizeof (BMM_CALLBACK_DATA
));
863 if (BmmCallbackInfo
== NULL
) {
864 return EFI_OUT_OF_RESOURCES
;
868 // Create LoadOption in BmmCallbackInfo for Driver Callback
870 Ptr
= AllocateZeroPool (sizeof (BM_LOAD_CONTEXT
) + sizeof (BM_FILE_CONTEXT
) + sizeof (BM_HANDLE_CONTEXT
) + sizeof (BM_MENU_ENTRY
));
872 FreePool (BmmCallbackInfo
);
873 return EFI_OUT_OF_RESOURCES
;
877 // Initialize Bmm callback data.
879 BmmCallbackInfo
->LoadContext
= (BM_LOAD_CONTEXT
*) Ptr
;
880 Ptr
+= sizeof (BM_LOAD_CONTEXT
);
882 BmmCallbackInfo
->FileContext
= (BM_FILE_CONTEXT
*) Ptr
;
883 Ptr
+= sizeof (BM_FILE_CONTEXT
);
885 BmmCallbackInfo
->HandleContext
= (BM_HANDLE_CONTEXT
*) Ptr
;
886 Ptr
+= sizeof (BM_HANDLE_CONTEXT
);
888 BmmCallbackInfo
->MenuEntry
= (BM_MENU_ENTRY
*) Ptr
;
890 BmmCallbackInfo
->Signature
= BMM_CALLBACK_DATA_SIGNATURE
;
891 BmmCallbackInfo
->BmmConfigAccess
.ExtractConfig
= BootMaintExtractConfig
;
892 BmmCallbackInfo
->BmmConfigAccess
.RouteConfig
= FakeRouteConfig
;
893 BmmCallbackInfo
->BmmConfigAccess
.Callback
= BootMaintCallback
;
894 BmmCallbackInfo
->BmmPreviousPageId
= FORM_MAIN_ID
;
895 BmmCallbackInfo
->BmmCurrentPageId
= FORM_MAIN_ID
;
896 BmmCallbackInfo
->FeConfigAccess
.ExtractConfig
= FakeExtractConfig
;
897 BmmCallbackInfo
->FeConfigAccess
.RouteConfig
= FakeRouteConfig
;
898 BmmCallbackInfo
->FeConfigAccess
.Callback
= FileExplorerCallback
;
899 BmmCallbackInfo
->FeCurrentState
= INACTIVE_STATE
;
900 BmmCallbackInfo
->FeDisplayContext
= UNKNOWN_CONTEXT
;
903 // Install Device Path Protocol and Config Access protocol to driver handle
905 Status
= gBS
->InstallMultipleProtocolInterfaces (
906 &BmmCallbackInfo
->BmmDriverHandle
,
907 &gEfiDevicePathProtocolGuid
,
908 &mBmmHiiVendorDevicePath
,
909 &gEfiHiiConfigAccessProtocolGuid
,
910 &BmmCallbackInfo
->BmmConfigAccess
,
913 if (EFI_ERROR (Status
)) {
918 // Install Device Path Protocol and Config Access protocol to driver handle
920 Status
= gBS
->InstallMultipleProtocolInterfaces (
921 &BmmCallbackInfo
->FeDriverHandle
,
922 &gEfiDevicePathProtocolGuid
,
923 &mFeHiiVendorDevicePath
,
924 &gEfiHiiConfigAccessProtocolGuid
,
925 &BmmCallbackInfo
->FeConfigAccess
,
928 if (EFI_ERROR (Status
)) {
933 // Post our Boot Maint VFR binnary to the HII database.
935 BmmCallbackInfo
->BmmHiiHandle
= HiiAddPackages (
937 BmmCallbackInfo
->BmmDriverHandle
,
942 ASSERT (BmmCallbackInfo
->BmmHiiHandle
!= NULL
);
945 // Post our File Explorer VFR binary to the HII database.
947 BmmCallbackInfo
->FeHiiHandle
= HiiAddPackages (
949 BmmCallbackInfo
->FeDriverHandle
,
954 ASSERT (BmmCallbackInfo
->FeHiiHandle
!= NULL
);
957 // Allocate space for creation of Buffer
959 gUpdateData
.BufferSize
= UPDATE_DATA_SIZE
;
960 gUpdateData
.Data
= AllocateZeroPool (UPDATE_DATA_SIZE
);
961 if (gUpdateData
.Data
== NULL
) {
962 Status
= EFI_OUT_OF_RESOURCES
;
966 InitializeStringDepository ();
968 InitAllMenu (BmmCallbackInfo
);
970 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &ConsoleInpMenu
);
971 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &ConsoleOutMenu
);
972 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &ConsoleErrMenu
);
973 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &BootOptionMenu
);
974 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &DriverOptionMenu
);
975 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &TerminalMenu
);
976 CreateMenuStringToken (BmmCallbackInfo
, BmmCallbackInfo
->BmmHiiHandle
, &DriverMenu
);
978 UpdateBootDelPage (BmmCallbackInfo
);
979 UpdateDrvDelPage (BmmCallbackInfo
);
981 if (TerminalMenu
.MenuNumber
> 0) {
982 BmmCallbackInfo
->CurrentTerminal
= 0;
983 UpdateTerminalPage (BmmCallbackInfo
);
986 Status
= EfiLibLocateProtocol (&gEfiLegacyBiosProtocolGuid
, (VOID
**) &LegacyBios
);
987 if (!EFI_ERROR (Status
)) {
988 RefreshUpdateData ();
991 // If LegacyBios Protocol is installed, add 3 tags about legacy boot option
992 // in BootOption form: legacy FD/HD/CD/NET/BEV
995 FORM_SET_FD_ORDER_ID
,
996 STRING_TOKEN (STR_FORM_SET_FD_ORDER_TITLE
),
997 STRING_TOKEN (STR_FORM_SET_FD_ORDER_TITLE
),
998 EFI_IFR_FLAG_CALLBACK
,
999 FORM_SET_FD_ORDER_ID
,
1004 FORM_SET_HD_ORDER_ID
,
1005 STRING_TOKEN (STR_FORM_SET_HD_ORDER_TITLE
),
1006 STRING_TOKEN (STR_FORM_SET_HD_ORDER_TITLE
),
1007 EFI_IFR_FLAG_CALLBACK
,
1008 FORM_SET_HD_ORDER_ID
,
1013 FORM_SET_CD_ORDER_ID
,
1014 STRING_TOKEN (STR_FORM_SET_CD_ORDER_TITLE
),
1015 STRING_TOKEN (STR_FORM_SET_CD_ORDER_TITLE
),
1016 EFI_IFR_FLAG_CALLBACK
,
1017 FORM_SET_CD_ORDER_ID
,
1022 FORM_SET_NET_ORDER_ID
,
1023 STRING_TOKEN (STR_FORM_SET_NET_ORDER_TITLE
),
1024 STRING_TOKEN (STR_FORM_SET_NET_ORDER_TITLE
),
1025 EFI_IFR_FLAG_CALLBACK
,
1026 FORM_SET_NET_ORDER_ID
,
1031 FORM_SET_BEV_ORDER_ID
,
1032 STRING_TOKEN (STR_FORM_SET_BEV_ORDER_TITLE
),
1033 STRING_TOKEN (STR_FORM_SET_BEV_ORDER_TITLE
),
1034 EFI_IFR_FLAG_CALLBACK
,
1035 FORM_SET_BEV_ORDER_ID
,
1040 BmmCallbackInfo
->BmmHiiHandle
,
1043 FORM_BOOT_LEGACY_DEVICE_ID
,
1050 // Dispatch BMM main formset and File Explorer formset.
1052 FormSetDispatcher (BmmCallbackInfo
);
1055 // Remove our IFR data from HII database
1057 HiiRemovePackages (BmmCallbackInfo
->BmmHiiHandle
);
1058 HiiRemovePackages (BmmCallbackInfo
->FeHiiHandle
);
1060 CleanUpStringDepository ();
1064 FreePool (gUpdateData
.Data
);
1065 gUpdateData
.Data
= NULL
;
1068 if (BmmCallbackInfo
->FeDriverHandle
!= NULL
) {
1069 gBS
->UninstallMultipleProtocolInterfaces (
1070 BmmCallbackInfo
->FeDriverHandle
,
1071 &gEfiDevicePathProtocolGuid
,
1072 &mFeHiiVendorDevicePath
,
1073 &gEfiHiiConfigAccessProtocolGuid
,
1074 &BmmCallbackInfo
->FeConfigAccess
,
1079 if (BmmCallbackInfo
->BmmDriverHandle
!= NULL
) {
1080 gBS
->UninstallMultipleProtocolInterfaces (
1081 BmmCallbackInfo
->BmmDriverHandle
,
1082 &gEfiDevicePathProtocolGuid
,
1083 &mBmmHiiVendorDevicePath
,
1084 &gEfiHiiConfigAccessProtocolGuid
,
1085 &BmmCallbackInfo
->BmmConfigAccess
,
1090 FreePool (BmmCallbackInfo
->LoadContext
);
1091 FreePool (BmmCallbackInfo
);
1097 Initialized all Menu Option List.
1099 @param CallbackData The BMM context data.
1104 IN BMM_CALLBACK_DATA
*CallbackData
1107 InitializeListHead (&BootOptionMenu
.Head
);
1108 InitializeListHead (&DriverOptionMenu
.Head
);
1109 BOpt_GetBootOptions (CallbackData
);
1110 BOpt_GetDriverOptions (CallbackData
);
1111 BOpt_GetLegacyOptions ();
1112 InitializeListHead (&FsOptionMenu
.Head
);
1113 BOpt_FindDrivers ();
1114 InitializeListHead (&DirectoryMenu
.Head
);
1115 InitializeListHead (&ConsoleInpMenu
.Head
);
1116 InitializeListHead (&ConsoleOutMenu
.Head
);
1117 InitializeListHead (&ConsoleErrMenu
.Head
);
1118 InitializeListHead (&TerminalMenu
.Head
);
1124 Free up all Menu Option list.
1132 BOpt_FreeMenu (&DirectoryMenu
);
1133 BOpt_FreeMenu (&FsOptionMenu
);
1134 BOpt_FreeMenu (&BootOptionMenu
);
1135 BOpt_FreeMenu (&DriverOptionMenu
);
1136 BOpt_FreeMenu (&DriverMenu
);
1137 BOpt_FreeLegacyOptions ();
1142 Intialize all the string depositories.
1146 InitializeStringDepository (
1150 STRING_DEPOSITORY
*StringDepository
;
1151 StringDepository
= AllocateZeroPool (sizeof (STRING_DEPOSITORY
) * STRING_DEPOSITORY_NUMBER
);
1152 FileOptionStrDepository
= StringDepository
++;
1153 ConsoleOptionStrDepository
= StringDepository
++;
1154 BootOptionStrDepository
= StringDepository
++;
1155 BootOptionHelpStrDepository
= StringDepository
++;
1156 DriverOptionStrDepository
= StringDepository
++;
1157 DriverOptionHelpStrDepository
= StringDepository
++;
1158 TerminalStrDepository
= StringDepository
;
1162 Fetch a usable string node from the string depository and return the string token.
1164 @param CallbackData The BMM context data.
1165 @param StringDepository The string repository.
1167 @retval EFI_STRING_ID String token.
1171 GetStringTokenFromDepository (
1172 IN BMM_CALLBACK_DATA
*CallbackData
,
1173 IN STRING_DEPOSITORY
*StringDepository
1176 STRING_LIST_NODE
*CurrentListNode
;
1177 STRING_LIST_NODE
*NextListNode
;
1179 CurrentListNode
= StringDepository
->CurrentNode
;
1181 if ((NULL
!= CurrentListNode
) && (NULL
!= CurrentListNode
->Next
)) {
1183 // Fetch one reclaimed node from the list.
1185 NextListNode
= StringDepository
->CurrentNode
->Next
;
1188 // If there is no usable node in the list, update the list.
1190 NextListNode
= AllocateZeroPool (sizeof (STRING_LIST_NODE
));
1191 ASSERT (NextListNode
!= NULL
);
1192 NextListNode
->StringToken
= HiiSetString (CallbackData
->BmmHiiHandle
, 0, L
" ", NULL
);
1193 ASSERT (NextListNode
->StringToken
!= 0);
1195 StringDepository
->TotalNodeNumber
++;
1197 if (NULL
== CurrentListNode
) {
1198 StringDepository
->ListHead
= NextListNode
;
1200 CurrentListNode
->Next
= NextListNode
;
1204 StringDepository
->CurrentNode
= NextListNode
;
1206 return StringDepository
->CurrentNode
->StringToken
;
1210 Reclaim string depositories by moving the current node pointer to list head..
1214 ReclaimStringDepository (
1218 UINTN DepositoryIndex
;
1219 STRING_DEPOSITORY
*StringDepository
;
1221 StringDepository
= FileOptionStrDepository
;
1222 for (DepositoryIndex
= 0; DepositoryIndex
< STRING_DEPOSITORY_NUMBER
; DepositoryIndex
++) {
1223 StringDepository
->CurrentNode
= StringDepository
->ListHead
;
1229 Release resource for all the string depositories.
1233 CleanUpStringDepository (
1238 UINTN DepositoryIndex
;
1239 STRING_LIST_NODE
*CurrentListNode
;
1240 STRING_LIST_NODE
*NextListNode
;
1241 STRING_DEPOSITORY
*StringDepository
;
1244 // Release string list nodes.
1246 StringDepository
= FileOptionStrDepository
;
1247 for (DepositoryIndex
= 0; DepositoryIndex
< STRING_DEPOSITORY_NUMBER
; DepositoryIndex
++) {
1248 CurrentListNode
= StringDepository
->ListHead
;
1249 for (NodeIndex
= 0; NodeIndex
< StringDepository
->TotalNodeNumber
; NodeIndex
++) {
1250 NextListNode
= CurrentListNode
->Next
;
1251 FreePool (CurrentListNode
);
1252 CurrentListNode
= NextListNode
;
1258 // Release string depository.
1260 FreePool (FileOptionStrDepository
);
1264 Start boot maintenance manager
1266 @retval EFI_SUCCESS If BMM is invoked successfully.
1267 @return Other value if BMM return unsuccessfully.
1276 LIST_ENTRY BdsBootOptionList
;
1278 InitializeListHead (&BdsBootOptionList
);
1281 // Connect all prior to entering the platform setup menu.
1283 if (!gConnectAllHappened
) {
1284 BdsLibConnectAllDriversToAllControllers ();
1285 gConnectAllHappened
= TRUE
;
1288 // Have chance to enumerate boot device
1290 BdsLibEnumerateAllBootOption (&BdsBootOptionList
);
1295 Status
= InitializeBM ();
1301 Dispatch BMM formset and FileExplorer formset.
1304 @param CallbackData The BMM context data.
1306 @retval EFI_SUCCESS If function complete successfully.
1307 @return Other value if the Setup Browser process BMM's pages and
1308 return unsuccessfully.
1313 IN BMM_CALLBACK_DATA
*CallbackData
1317 EFI_BROWSER_ACTION_REQUEST ActionRequest
;
1320 UpdatePageId (CallbackData
, FORM_MAIN_ID
);
1322 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1323 Status
= gFormBrowser2
->SendForm (
1325 &CallbackData
->BmmHiiHandle
,
1332 if (ActionRequest
== EFI_BROWSER_ACTION_REQUEST_RESET
) {
1333 EnableResetRequired ();
1336 ReclaimStringDepository ();
1339 // When this Formset returns, check if we are going to explore files.
1341 if (INACTIVE_STATE
!= CallbackData
->FeCurrentState
) {
1342 UpdateFileExplorer (CallbackData
, 0);
1344 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1345 Status
= gFormBrowser2
->SendForm (
1347 &CallbackData
->FeHiiHandle
,
1354 if (ActionRequest
== EFI_BROWSER_ACTION_REQUEST_RESET
) {
1355 EnableResetRequired ();
1358 CallbackData
->FeCurrentState
= INACTIVE_STATE
;
1359 CallbackData
->FeDisplayContext
= UNKNOWN_CONTEXT
;
1360 ReclaimStringDepository ();
1371 Deletete the Boot Option from EFI Variable. The Boot Order Arrray
1374 @param OptionNumber The number of Boot option want to be deleted.
1375 @param BootOrder The Boot Order array.
1376 @param BootOrderSize The size of the Boot Order Array.
1378 @return Other value if the Boot Option specified by OptionNumber is not deleteed succesfully.
1379 @retval EFI_SUCCESS If function return successfully.
1384 BdsDeleteBootOption (
1385 IN UINTN OptionNumber
,
1386 IN OUT UINT16
*BootOrder
,
1387 IN OUT UINTN
*BootOrderSize
1390 UINT16 BootOption
[100];
1395 Status
= EFI_SUCCESS
;
1398 UnicodeSPrint (BootOption
, sizeof (BootOption
), L
"Boot%04x", OptionNumber
);
1399 Status
= EfiLibDeleteVariable (BootOption
, &gEfiGlobalVariableGuid
);
1402 // adjust boot order array
1404 for (Index
= 0; Index
< *BootOrderSize
/ sizeof (UINT16
); Index
++) {
1405 if (BootOrder
[Index
] == OptionNumber
) {
1411 if (Index
!= *BootOrderSize
/ sizeof (UINT16
)) {
1412 for (Index
= 0; Index
< *BootOrderSize
/ sizeof (UINT16
) - 1; Index
++) {
1413 if (Index
>= Index2Del
) {
1414 BootOrder
[Index
] = BootOrder
[Index
+ 1];
1418 *BootOrderSize
-= sizeof (UINT16
);