/** @file Platform variable initialization PEIM. This PEIM determines whether to load variable defaults. Ordinarily, the decision is based on the boot mode, but an OEM hook is provided to override that. The appropriate HOBs and PCDs are created to signal DXE code to update the variable default values. @copyright Copyright 2012 - 2021 Intel Corporation.
SPDX-License-Identifier: BSD-2-Clause-Patent **/ #include "PlatformVariableInitPei.h" #include #include UINT16 BoardId = BOARD_ID_DEFAULT; EFI_PEI_PPI_DESCRIPTOR mPpiListPlatformVariableInit = { (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST), &gPlatformVariableInitPpiGuid, NULL }; /** Apply platform variable defaults. Create HOBs and set PCDs to prompt the (re-)loading of variable defaults. Each step is attempted regardless of whether the previous steps succeeded. If multiple errors occur, only the last error code is returned. @param[in] Events Bitmap of events that occurred. @param[in] DefaultId Default store ID, STANDARD or MANUFACTURING. @retval EFI_SUCCESS All steps completed successfully. @retval EFI_OUT_OF_RESOURCES One of the HOBs could not be created. @retval EFI_NOT_FOUND The default data could not be found in FFS. **/ EFI_STATUS ApplyPlatformVariableDefaults( IN UINT8 Events, IN UINT16 DefaultId ) { VOID *Hob; EFI_STATUS Status; EFI_STATUS ReturnStatus; DEBUG((DEBUG_INFO, "Applying platform variable defaults:\n")); DEBUG((DEBUG_INFO, " Events = 0x%02x\n", Events)); DEBUG((DEBUG_INFO, " DefaultId = 0x%04x\n", DefaultId)); // // Assume success up front. This will be overwritten if errors occur. // ReturnStatus = EFI_SUCCESS; // // Send the bitmap of events to the platform variable DXE driver. // Hob = BuildGuidDataHob(&gPlatformVariableHobGuid, &Events, sizeof(Events)); if (Hob == NULL) { DEBUG((DEBUG_ERROR, "Create platform var event HOB: %r!\n", EFI_OUT_OF_RESOURCES)); ReturnStatus = EFI_OUT_OF_RESOURCES; } // // Locate variable default data in FFS and send it to the core variable DXE // driver to write. // Status = CreateDefaultVariableHob(DefaultId, BoardId); if (EFI_ERROR(Status)) { DEBUG((DEBUG_ERROR, "create default var HOB: %r!\n", Status)); ReturnStatus = Status; } // // Set the PCD SKU ID. // LibPcdSetSku(BoardId); // // Set the PCD default store ID. // Status = PcdSet16S(PcdSetNvStoreDefaultId, DefaultId); if (EFI_ERROR(Status)) { DEBUG((DEBUG_ERROR, "setNVstore default ID PCD: %r!\n", Status)); ReturnStatus = Status; } return ReturnStatus; } /** Perform the default variable initializations after variable service is ready. @param[in] PeiServices General purpose services available to every PEIM. @param[in] NotifyDescriptor Pointer to Notify PPI descriptor. @param[in] Interface Pointer to PPI. @retval EFI_SUCCESS Default setting is initialized into variable. @retval Other values Can't find the matched default setting. **/ EFI_STATUS EFIAPI PlatformVariablePeiInit( IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor, IN VOID *Interface ) { EFI_STATUS Status; UINT8 *SystemConfiguration; EFI_GUID *SystemConfigurationGuid; UINTN DataSize; EFI_PEI_READ_ONLY_VARIABLE2_PPI *VariableServices; UINT8 Events; UINT16 DefaultId; BOOLEAN ApplyDefaults; SystemConfigurationGuid = PcdGetPtr(PcdSetupVariableGuid); Events = 0; DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD; if (PlatformVariableHookForHobGeneration(Interface, &Events, &DefaultId)) { // // Use events bitmap and default ID returned by PlatformVariableHook. // ApplyDefaults = TRUE; } else { // // If the setup variable does not exist (yet), defaults should be applied. // VariableServices = (EFI_PEI_READ_ONLY_VARIABLE2_PPI *)Interface; SystemConfiguration = NULL; DataSize = 0; Status = VariableServices->GetVariable( VariableServices, PLATFORM_SETUP_VARIABLE_NAME, SystemConfigurationGuid, NULL, &DataSize, SystemConfiguration ); // // Setup variable is not found. So, set the default setting. // if (Status == EFI_NOT_FOUND) { Events = NULL_VARIABLE_EVENT; DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD; ApplyDefaults = TRUE; } else { ApplyDefaults = FALSE; } } if (ApplyDefaults) { Status = ApplyPlatformVariableDefaults(Events, DefaultId); } else { // // Normal case boot flow // Events = 0; // no events occurred BuildGuidDataHob (&gPlatformVariableHobGuid, &Events, sizeof (UINT8)); // // Patch RP variable value with PC variable in the begining of PEI // Status = CreateRPVariableHob (EFI_HII_DEFAULT_CLASS_STANDARD, BoardId); } PeiServicesInstallPpi (&mPpiListPlatformVariableInit); return Status; } /** Variable Init BootMode CallBack Prepare Knob values based on boot mode Execute after discovering BootMode @param[in] PeiServices General purpose services available to every PEIM. @param[in] NotifyDescriptor Pointer to Notify PPI descriptor. @param[in] Interface Pointer to PPI. @retval EFI_SUCCESS Knob Values. @retval Other values **/ EFI_STATUS EFIAPI VariableInitBootModeCallBack( IN EFI_PEI_SERVICES **PeiServices, IN EFI_PEI_NOTIFY_DESCRIPTOR *NotifyDescriptor, IN VOID *Interface ) { EFI_BOOT_MODE BootMode; BOOLEAN ApplyDefaults; UINT8 Events; UINT16 DefaultId; EFI_STATUS Status; Events = 0; DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD; ApplyDefaults = FALSE; // // Certain boot modes require defaults to be (re-)applied. // Status = PeiServicesGetBootMode(&BootMode); ASSERT_EFI_ERROR(Status); if (EFI_ERROR(Status)) { BootMode = BOOT_WITH_DEFAULT_SETTINGS; } if (BootMode == BOOT_WITH_MFG_MODE_SETTINGS) { Events = MFG_MODE_EVENT; DefaultId = EFI_HII_DEFAULT_CLASS_MANUFACTURING; ApplyDefaults = TRUE; } else if (BootMode == BOOT_IN_RECOVERY_MODE) { Events = RECOVERY_MODE_EVENT; DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD; ApplyDefaults = TRUE; } else if (BootMode == BOOT_WITH_DEFAULT_SETTINGS) { Events = CMOS_CLEAR_EVENT; DefaultId = EFI_HII_DEFAULT_CLASS_STANDARD; ApplyDefaults = TRUE; } if (ApplyDefaults) { Status = ApplyPlatformVariableDefaults(Events, DefaultId); } return Status; } EFI_PEI_NOTIFY_DESCRIPTOR mVariableNotifyList[] = { { (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK), &gEfiPeiReadOnlyVariable2PpiGuid, PlatformVariablePeiInit }, { (EFI_PEI_PPI_DESCRIPTOR_NOTIFY_CALLBACK | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST), &gUpdateBootModePpiGuid, VariableInitBootModeCallBack } }; EFI_STATUS EFIAPI PlatformVariableInitPeiEntry ( IN EFI_PEI_FILE_HANDLE FileHandle, IN CONST EFI_PEI_SERVICES **PeiServices ) /*++ --*/ { EFI_STATUS Status; PlatformVariableHookForEntry(); // Register notify to set default variable once variable service is ready. // Status = PeiServicesNotifyPpi(&mVariableNotifyList[0]); return Status; }