[mirror_edk2.git] / SecurityPkg / Tcg / Opal / OpalPasswordDxe / OpalHii.c

/** @file\r
  Implementation of the HII for the Opal UEFI Driver.\r
\r
Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include "OpalHii.h"\r
#include "OpalDriver.h"\r
#include "OpalHiiPrivate.h"\r
\r
//\r
// This is the generated IFR binary Data for each formset defined in VFR.\r
// This Data array is ready to be used as input of HiiAddPackages() to\r
// create a packagelist (which contains Form packages, String packages, etc).\r
//\r
extern UINT8  OpalPasswordFormBin[];\r
\r
//\r
// This is the generated String package Data for all .UNI files.\r
// This Data array is ready to be used as input of HiiAddPackages() to\r
// create a packagelist (which contains Form packages, String packages, etc).\r
//\r
extern UINT8  OpalPasswordDxeStrings[];\r
\r
EFI_HII_CONFIG_ACCESS_PROTOCOL gHiiConfigAccessProtocol;\r
\r
//\r
// Handle to the list of HII packages (forms and strings) for this driver\r
//\r
EFI_HII_HANDLE gHiiPackageListHandle = NULL;\r
\r
//\r
// Package List GUID containing all form and string packages\r
//\r
const EFI_GUID gHiiPackageListGuid = PACKAGE_LIST_GUID;\r
const EFI_GUID gHiiSetupVariableGuid = SETUP_VARIABLE_GUID;\r
\r
//\r
// Structure that contains state of the HII\r
// This structure is updated by Hii.cpp and its contents\r
// is rendered in the HII.\r
//\r
OPAL_HII_CONFIGURATION gHiiConfiguration;\r
\r
CHAR8 gHiiOldPassword[MAX_PASSWORD_CHARACTER_LENGTH] = {0};\r
UINT32 gHiiOldPasswordLength = 0;\r
\r
//\r
// The device path containing the VENDOR_DEVICE_PATH and EFI_DEVICE_PATH_PROTOCOL\r
//\r
HII_VENDOR_DEVICE_PATH gHiiVendorDevicePath = {\r
    {\r
        {\r
            HARDWARE_DEVICE_PATH,\r
            HW_VENDOR_DP,\r
            {\r
                (UINT8)(sizeof(VENDOR_DEVICE_PATH)),\r
                (UINT8)((sizeof(VENDOR_DEVICE_PATH)) >> 8)\r
            }\r
        },\r
        OPAL_PASSWORD_CONFIG_GUID\r
    },\r
    {\r
        END_DEVICE_PATH_TYPE,\r
        END_ENTIRE_DEVICE_PATH_SUBTYPE,\r
        {\r
            (UINT8)(END_DEVICE_PATH_LENGTH),\r
            (UINT8)((END_DEVICE_PATH_LENGTH) >> 8)\r
        }\r
    }\r
};\r
\r
\r
/**\r
  Sets the current system state of global config variables.\r
\r
**/\r
VOID\r
HiiSetCurrentConfiguration(\r
  VOID\r
  )\r
{\r
  EFI_STATUS                            Status;\r
  OPAL_EXTRA_INFO_VAR                   OpalExtraInfo;\r
  UINTN                                 DataSize;\r
\r
  gHiiConfiguration.NumDisks = GetDeviceCount();\r
\r
  DataSize = sizeof (OPAL_EXTRA_INFO_VAR);\r
  Status = gRT->GetVariable (\r
                  OPAL_EXTRA_INFO_VAR_NAME,\r
                  &gOpalExtraInfoVariableGuid,\r
                  NULL,\r
                  &DataSize,\r
                  &OpalExtraInfo\r
                  );\r
  DEBUG ((DEBUG_INFO, "GetVariable for OpalExtraInfo @ HiiSetCurrentConfiguration, Status: %r\n", Status));\r
  if (!EFI_ERROR (Status)) {\r
    gHiiConfiguration.EnableBlockSid = OpalExtraInfo.EnableBlockSid;\r
  }\r
}\r
\r
/**\r
  Check that all required protocols for HII are available.\r
\r
  @retval  EFI_SUCCESS        All required protocols are installed.\r
  @retval  EFI_NOT_FOUND      One or more protocol are not installed.\r
**/\r
EFI_STATUS\r
HiiCheckForRequiredProtocols (\r
  VOID\r
  )\r
{\r
  VOID*       TempProtocol;\r
  EFI_STATUS  Status;\r
\r
  Status = gBS->LocateProtocol(&gEfiHiiStringProtocolGuid, NULL, (VOID**)&TempProtocol );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  Status = gBS->LocateProtocol(&gEfiHiiDatabaseProtocolGuid, NULL, (VOID**)&TempProtocol );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  Status = gBS->LocateProtocol(&gEfiHiiConfigRoutingProtocolGuid, NULL, (VOID**)&TempProtocol );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  Status = gBS->LocateProtocol(&gEfiFormBrowser2ProtocolGuid, NULL, (VOID**)&TempProtocol );\r
  if (EFI_ERROR (Status)) {\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Install the HII related resources.\r
\r
  @retval  EFI_SUCCESS        Install all the resources success.\r
  @retval  other              Error occur when install the resources.\r
**/\r
EFI_STATUS\r
HiiInstall(\r
  VOID\r
  )\r
{\r
  EFI_STATUS                   Status;\r
  EFI_HANDLE                   DriverHandle;\r
\r
  //\r
  // Check that all required protocols are available for HII.\r
  // If not, fail the install\r
  //\r
  Status = HiiCheckForRequiredProtocols();\r
  if (EFI_ERROR(Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Clear the global configuration.\r
  //\r
  ZeroMem(&gHiiConfiguration, sizeof(gHiiConfiguration));\r
\r
  //\r
  // Obtain the driver handle that the BIOS assigned us\r
  //\r
  DriverHandle = HiiGetDriverImageHandleCB();\r
\r
  //\r
  // Populate the config access protocol with the three functions we are publishing\r
  //\r
  gHiiConfigAccessProtocol.ExtractConfig = ExtractConfig;\r
  gHiiConfigAccessProtocol.RouteConfig = RouteConfig;\r
  gHiiConfigAccessProtocol.Callback = DriverCallback;\r
\r
  //\r
  // Associate the required protocols with our driver handle\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces(\r
               &DriverHandle,\r
               &gEfiHiiConfigAccessProtocolGuid,\r
               &gHiiConfigAccessProtocol,      // HII callback\r
               &gEfiDevicePathProtocolGuid,\r
               &gHiiVendorDevicePath,        // required for HII callback allow all disks to be shown in same hii\r
               NULL\r
           );\r
\r
  if (EFI_ERROR(Status)) {\r
    return Status;\r
  }\r
\r
  return OpalHiiAddPackages();\r
}\r
\r
/**\r
  Install the HII form and string packages.\r
\r
  @retval  EFI_SUCCESS           Install all the resources success.\r
  @retval  EFI_OUT_OF_RESOURCES  Out of resource error.\r
**/\r
EFI_STATUS\r
OpalHiiAddPackages(\r
  VOID\r
  )\r
{\r
  EFI_HANDLE                   DriverHandle;\r
  CHAR16                       *NewString;\r
\r
  DriverHandle = HiiGetDriverImageHandleCB();\r
\r
  //\r
  // Publish the HII form and HII string packages\r
  //\r
  gHiiPackageListHandle = HiiAddPackages(\r
                                &gHiiPackageListGuid,\r
                                DriverHandle,\r
                                OpalPasswordDxeStrings,\r
                                OpalPasswordFormBin,\r
                                (VOID*)NULL\r
                                );\r
\r
  //\r
  // Make sure the packages installed successfully\r
  //\r
  if (gHiiPackageListHandle == NULL) {\r
    DEBUG ((DEBUG_INFO, "OpalHiiAddPackages failed\n"));\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  //\r
  // Update Version String in main window\r
  //\r
  NewString = HiiGetDriverNameCB ();\r
  if (HiiSetString(gHiiPackageListHandle, STRING_TOKEN(STR_MAIN_OPAL_VERSION), NewString, NULL) == 0) {\r
    DEBUG ((DEBUG_INFO,  "OpalHiiAddPackages: HiiSetString( ) failed\n"));\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Uninstall the HII capability.\r
\r
  @retval  EFI_SUCCESS           Uninstall all the resources success.\r
  @retval  others                Other errors occur when unistall the hii resource.\r
**/\r
EFI_STATUS\r
HiiUninstall(\r
  VOID\r
  )\r
{\r
  EFI_STATUS                   Status;\r
\r
  //\r
  // Remove the packages we've provided to the BIOS\r
  //\r
  HiiRemovePackages(gHiiPackageListHandle);\r
\r
  //\r
  // Remove the protocols from our driver handle\r
  //\r
  Status = gBS->UninstallMultipleProtocolInterfaces(\r
                          HiiGetDriverImageHandleCB(),\r
                          &gEfiHiiConfigAccessProtocolGuid,\r
                          &gHiiConfigAccessProtocol,        // HII callback\r
                          &gEfiDevicePathProtocolGuid,\r
                          &gHiiVendorDevicePath,            // required for HII callback\r
                          NULL\r
                      );\r
  if (EFI_ERROR(Status)) {\r
    DEBUG ((DEBUG_INFO, "Cannot uninstall Hii Protocols: %r\n", Status));\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
  Updates the main menu form.\r
\r
  @retval  EFI_SUCCESS           update the main form success.\r
**/\r
EFI_STATUS\r
HiiPopulateMainMenuForm (\r
  VOID\r
  )\r
{\r
  UINT8         Index;\r
  CHAR8         *DiskName;\r
  EFI_STRING_ID DiskNameId;\r
  OPAL_DISK     *OpalDisk;\r
\r
  HiiSetCurrentConfiguration();\r
\r
  gHiiConfiguration.SupportedDisks = 0;\r
\r
  for (Index = 0; Index < gHiiConfiguration.NumDisks; Index++) {\r
    OpalDisk = HiiGetOpalDiskCB (Index);\r
    if ((OpalDisk != NULL) && OpalFeatureSupported (&OpalDisk->SupportedAttributes)) {\r
      gHiiConfiguration.SupportedDisks |= (1 << Index);\r
      DiskNameId = GetDiskNameStringId (Index);\r
      DiskName = HiiDiskGetNameCB (Index);\r
      if ((DiskName == NULL) || (DiskNameId == 0)) {\r
        return EFI_UNSUPPORTED;\r
      }\r
      HiiSetFormString(DiskNameId, DiskName);\r
    }\r
  }\r
\r
  OpalHiiSetBrowserData ();\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Update the disk action info.\r
\r
  @param     ActionString\r
  @param     SelectedAction\r
\r
  @retval  EFI_SUCCESS           Uninstall all the resources success.\r
**/\r
EFI_STATUS\r
HiiSelectDiskAction (\r
  CHAR8           *ActionString,\r
  UINT8           SelectedAction\r
  )\r
{\r
  OPAL_DISK                     *OpalDisk;\r
  OPAL_DISK_ACTIONS              AvailActions;\r
\r
  OpalHiiGetBrowserData ();\r
\r
  HiiSetFormString(STRING_TOKEN(STR_DISK_ACTION_LBL), ActionString);\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), " ");\r
\r
  gHiiConfiguration.SelectedAction = SelectedAction;\r
  gHiiConfiguration.AvailableFields = 0;\r
\r
  OpalDisk = HiiGetOpalDiskCB(gHiiConfiguration.SelectedDiskIndex);\r
  if (OpalDisk == NULL) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  if (OpalSupportGetAvailableActions (&OpalDisk->SupportedAttributes, &OpalDisk->LockingFeature, OpalDisk->Owner, &AvailActions) != TcgResultSuccess) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  switch (SelectedAction) {\r
    case HII_KEY_ID_GOTO_LOCK:\r
    case HII_KEY_ID_GOTO_UNLOCK:\r
    case HII_KEY_ID_GOTO_SET_ADMIN_PWD:\r
    case HII_KEY_ID_GOTO_SET_USER_PWD:\r
    case HII_KEY_ID_GOTO_SECURE_ERASE:\r
    case HII_KEY_ID_GOTO_DISABLE_USER:\r
    case HII_KEY_ID_GOTO_ENABLE_FEATURE:   // User is required to enter Password to enable Feature\r
      gHiiConfiguration.AvailableFields |= HII_FIELD_PASSWORD;\r
      break;\r
\r
    case HII_KEY_ID_GOTO_PSID_REVERT:\r
      gHiiConfiguration.AvailableFields |= HII_FIELD_PSID;\r
      break;\r
\r
    case HII_KEY_ID_GOTO_REVERT:\r
      gHiiConfiguration.AvailableFields |= HII_FIELD_PASSWORD;\r
      if (OpalDisk->SupportedAttributes.PyriteSsc != 1) {\r
        //\r
        // According to current Pyrite SSC Spec 1.00, there is no parameter for RevertSP method.\r
        // So issue RevertSP method without any parameter by suppress KeepUserData option.\r
        //\r
        gHiiConfiguration.AvailableFields |= HII_FIELD_KEEP_USER_DATA;\r
      }\r
      if (AvailActions.RevertKeepDataForced) {\r
        gHiiConfiguration.AvailableFields |= HII_FIELD_KEEP_USER_DATA_FORCED;\r
      }\r
      break;\r
  }\r
\r
  OpalHiiSetBrowserData ();\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Get disk name string id.\r
\r
  @param   DiskIndex             The input disk index info.\r
\r
  @retval  The disk name string id.\r
\r
**/\r
EFI_STRING_ID\r
GetDiskNameStringId(\r
  UINT8 DiskIndex\r
  )\r
{\r
  switch (DiskIndex) {\r
    case 0: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_0);\r
    case 1: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_1);\r
    case 2: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_2);\r
    case 3: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_3);\r
    case 4: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_4);\r
    case 5: return STRING_TOKEN(STR_MAIN_GOTO_DISK_INFO_5);\r
  }\r
  return 0;\r
}\r
\r
/**\r
  This function processes the results of changes in configuration.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Action                 Specifies the type of action taken by the browser.\r
  @param  QuestionId             A unique value which is sent to the original\r
                                 exporting driver so that it can identify the type\r
                                 of data to expect.\r
  @param  Type                   The type of value for the question.\r
  @param  Value                  A pointer to the data being sent to the original\r
                                 exporting driver.\r
  @param  ActionRequest          On return, points to the action requested by the\r
                                 callback function.\r
\r
  @retval EFI_SUCCESS            The callback successfully handled the action.\r
  @retval EFI_OUT_OF_RESOURCES   Not enough storage is available to hold the\r
                                 variable and its data.\r
  @retval EFI_DEVICE_ERROR       The variable could not be saved.\r
  @retval EFI_UNSUPPORTED        The specified Action is not supported by the\r
                                 callback.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
DriverCallback(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL    *This,\r
  EFI_BROWSER_ACTION                      Action,\r
  EFI_QUESTION_ID                         QuestionId,\r
  UINT8                                   Type,\r
  EFI_IFR_TYPE_VALUE                      *Value,\r
  EFI_BROWSER_ACTION_REQUEST              *ActionRequest\r
  )\r
{\r
  HII_KEY    HiiKey;\r
  UINT8      HiiKeyId;\r
\r
  if (ActionRequest != NULL) {\r
    *ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;\r
  } else {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // If QuestionId is an auto-generated key (label, empty line, etc.), ignore it.\r
  //\r
  if ((QuestionId & HII_KEY_FLAG) == 0) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  HiiKey.Raw = QuestionId;\r
  HiiKeyId   = (UINT8) HiiKey.KeyBits.Id;\r
\r
  if (Action == EFI_BROWSER_ACTION_FORM_OPEN) {\r
    switch (HiiKeyId) {\r
      case HII_KEY_ID_VAR_SUPPORTED_DISKS:\r
        DEBUG ((DEBUG_INFO,  "HII_KEY_ID_VAR_SUPPORTED_DISKS\n"));\r
        return HiiPopulateMainMenuForm ();\r
\r
      case HII_KEY_ID_VAR_SELECTED_DISK_AVAILABLE_ACTIONS:\r
        return HiiPopulateDiskInfoForm();\r
    }\r
  } else if (Action == EFI_BROWSER_ACTION_CHANGING) {\r
    switch (HiiKeyId) {\r
      case HII_KEY_ID_GOTO_DISK_INFO:\r
        return HiiSelectDisk((UINT8)HiiKey.KeyBits.Index);\r
\r
      case HII_KEY_ID_GOTO_LOCK:\r
        return HiiSelectDiskAction("Action: Lock", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_UNLOCK:\r
        return HiiSelectDiskAction("Action: Unlock", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_SET_ADMIN_PWD:\r
        return HiiSelectDiskAction("Action: Set Administrator Password", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_SET_USER_PWD:\r
        return HiiSelectDiskAction("Action: Set User Password", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_SECURE_ERASE:\r
        return HiiSelectDiskAction("Action: Secure Erase", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_PSID_REVERT:\r
        return HiiSelectDiskAction("Action: Revert to Factory Defaults with PSID", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_REVERT:\r
        return HiiSelectDiskAction("Action: Revert to Factory Defaults", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_DISABLE_USER:\r
        return HiiSelectDiskAction("Action: Disable User", HiiKeyId);\r
\r
      case HII_KEY_ID_GOTO_ENABLE_FEATURE:\r
        return HiiSelectDiskAction("Action: Enable Feature", HiiKeyId);\r
\r
      case HII_KEY_ID_ENTER_PASSWORD:\r
        return HiiPasswordEntered(Value->string);\r
\r
      case HII_KEY_ID_BLOCKSID:\r
        return HiiSetBlockSid(Value->b);\r
    }\r
  } else if (Action == EFI_BROWSER_ACTION_CHANGED) {\r
    switch (HiiKeyId) {\r
      case HII_KEY_ID_ENTER_PSID:\r
        HiiPsidRevert();\r
        *ActionRequest = EFI_BROWSER_ACTION_REQUEST_FORM_APPLY;\r
        return EFI_SUCCESS;\r
    }\r
  }\r
\r
  return EFI_UNSUPPORTED;\r
}\r
\r
/**\r
  Update the global Disk index info.\r
\r
  @param   Index             The input disk index info.\r
\r
  @retval  EFI_SUCCESS       Update the disk index info success.\r
\r
**/\r
EFI_STATUS\r
HiiSelectDisk(\r
  UINT8 Index\r
  )\r
{\r
  OpalHiiGetBrowserData();\r
  gHiiConfiguration.SelectedDiskIndex = Index;\r
  OpalHiiSetBrowserData ();\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Draws the disk info form.\r
\r
  @retval  EFI_SUCCESS       Draw the disk info success.\r
\r
**/\r
EFI_STATUS\r
HiiPopulateDiskInfoForm(\r
  VOID\r
  )\r
{\r
  OPAL_DISK*                    OpalDisk;\r
  OPAL_DISK_ACTIONS             AvailActions;\r
  TCG_RESULT                    Ret;\r
  CHAR8                         *DiskName;\r
\r
  OpalHiiGetBrowserData();\r
\r
  DiskName = HiiDiskGetNameCB (gHiiConfiguration.SelectedDiskIndex);\r
  if (DiskName == NULL) {\r
    return EFI_UNSUPPORTED;\r
  }\r
  HiiSetFormString(STRING_TOKEN(STR_DISK_INFO_SELECTED_DISK_NAME), DiskName);\r
\r
  ZeroMem(gHiiConfiguration.Psid, sizeof(gHiiConfiguration.Psid));\r
\r
  gHiiConfiguration.SelectedDiskAvailableActions = HII_ACTION_NONE;\r
\r
  OpalDisk = HiiGetOpalDiskCB(gHiiConfiguration.SelectedDiskIndex);\r
\r
  if (OpalDisk != NULL) {\r
    OpalDiskUpdateStatus (OpalDisk);\r
    Ret = OpalSupportGetAvailableActions(&OpalDisk->SupportedAttributes, &OpalDisk->LockingFeature, OpalDisk->Owner, &AvailActions);\r
    if (Ret == TcgResultSuccess) {\r
      //\r
      // Update actions, always allow PSID Revert\r
      //\r
      gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.PsidRevert == 1) ? HII_ACTION_PSID_REVERT : HII_ACTION_NONE;\r
\r
      //\r
      // Always allow unlock to handle device migration\r
      //\r
      gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.Unlock == 1) ? HII_ACTION_UNLOCK : HII_ACTION_NONE;\r
\r
      if (!OpalFeatureEnabled (&OpalDisk->SupportedAttributes, &OpalDisk->LockingFeature)) {\r
        if (OpalDisk->Owner == OpalOwnershipNobody) {\r
          gHiiConfiguration.SelectedDiskAvailableActions |= HII_ACTION_ENABLE_FEATURE;\r
\r
          //\r
          // Update strings\r
          //\r
          HiiSetFormString( STRING_TOKEN(STR_DISK_INFO_PSID_REVERT), "PSID Revert to factory default");\r
        } else {\r
          DEBUG ((DEBUG_INFO, "Feature disabled but ownership != nobody\n"));\r
        }\r
      } else {\r
        gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.Revert == 1) ? HII_ACTION_REVERT : HII_ACTION_NONE;\r
        gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.AdminPass == 1) ? HII_ACTION_SET_ADMIN_PWD : HII_ACTION_NONE;\r
        gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.UserPass == 1) ? HII_ACTION_SET_USER_PWD : HII_ACTION_NONE;\r
        gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.SecureErase == 1) ? HII_ACTION_SECURE_ERASE : HII_ACTION_NONE;\r
        gHiiConfiguration.SelectedDiskAvailableActions |= (AvailActions.DisableUser == 1) ? HII_ACTION_DISABLE_USER : HII_ACTION_NONE;\r
        gHiiConfiguration.SelectedDiskAvailableActions |= HII_ACTION_ENABLE_BLOCKSID;\r
\r
        HiiSetFormString (STRING_TOKEN(STR_DISK_INFO_PSID_REVERT), "PSID Revert to factory default and Disable");\r
\r
        //\r
        // Determine revert options for disk\r
        // Default initialize keep user Data to be true\r
        //\r
        gHiiConfiguration.KeepUserData = 1;\r
        if (OpalDisk->SupportedAttributes.PyriteSsc == 1) {\r
          //\r
          // According to current Pyrite SSC Spec 1.00, there is no parameter for RevertSP method.\r
          // So issue RevertSP method without any parameter by set default value to FALSE.\r
          //\r
          gHiiConfiguration.KeepUserData = 0;\r
        }\r
\r
      }\r
    }\r
  }\r
\r
  //\r
  // Pass the current configuration to the BIOS\r
  //\r
  OpalHiiSetBrowserData ();\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Reverts the Opal disk to factory default.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiPsidRevert(\r
  VOID\r
  )\r
{\r
  CHAR8                         Response[DEFAULT_RESPONSE_SIZE];\r
  TCG_PSID                      Psid;\r
  OPAL_DISK                     *OpalDisk;\r
  TCG_RESULT                    Ret;\r
  OPAL_SESSION                  Session;\r
\r
  Ret = TcgResultFailure;\r
\r
  OpalHiiGetBrowserData();\r
\r
  UnicodeStrToAsciiStr(gHiiConfiguration.Psid, (CHAR8*)Psid.Psid);\r
\r
  OpalDisk = HiiGetOpalDiskCB (gHiiConfiguration.SelectedDiskIndex);\r
  if (OpalDisk != NULL) {\r
    ZeroMem(&Session, sizeof(Session));\r
    Session.Sscp = OpalDisk->Sscp;\r
    Session.MediaId = OpalDisk->MediaId;\r
    Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
    Ret = OpalSupportPsidRevert(&Session, Psid.Psid, (UINT32)sizeof(Psid.Psid), OpalDisk->OpalDevicePath);\r
  }\r
\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "PSID Revert: Success" );\r
  } else {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "PSID Revert: Failure" );\r
  }\r
\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Set password for the disk.\r
\r
  @param      OpalDisk       The disk need to set the password.\r
  @param      Password       The input password.\r
  @param      PassLength     The input password length.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiSetPassword(\r
  OPAL_DISK          *OpalDisk,\r
  VOID               *Password,\r
  UINT32             PassLength\r
  )\r
{\r
  CHAR8                         Response[DEFAULT_RESPONSE_SIZE];\r
  TCG_RESULT                    Ret;\r
  BOOLEAN                       ExistingPassword;\r
  OPAL_SESSION                  Session;\r
\r
  ExistingPassword = FALSE;\r
\r
  //\r
  // PassLength = 0 means check whether exist old password.\r
  //\r
  if (PassLength == 0) {\r
    ZeroMem(gHiiOldPassword, sizeof(gHiiOldPassword));\r
    gHiiOldPasswordLength = 0;\r
\r
    if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_ENABLE_FEATURE) {\r
      ExistingPassword = FALSE;\r
    } else if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_SET_ADMIN_PWD) {\r
      ExistingPassword = OpalUtilAdminPasswordExists(OpalDisk->Owner, &OpalDisk->LockingFeature);\r
    } else if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_SET_USER_PWD) {\r
      //\r
      // Set user Password option shall only be shown if an Admin Password exists\r
      // so a Password is always required (Admin or Existing User Password)\r
      //\r
      ExistingPassword = TRUE;\r
    }\r
\r
    //\r
    // Return error if there is a previous Password\r
    // see UEFI 2.4 errata B, Figure 121. Password Flowchart\r
    //\r
    return ExistingPassword ? EFI_DEVICE_ERROR : EFI_SUCCESS;\r
  }\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = OpalDisk->Sscp;\r
  Session.MediaId = OpalDisk->MediaId;\r
  Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  AsciiSPrint(Response, DEFAULT_RESPONSE_SIZE, "%a", "Set Password: Failure");\r
  //\r
  // Password entered.\r
  // No current Owner, so set new Password, must be admin Password\r
  //\r
  if (OpalDisk->Owner == OpalOwnershipNobody) {\r
    Ret = OpalSupportEnableOpalFeature (&Session, OpalDisk->Msid, OpalDisk->MsidLength,Password, PassLength, OpalDisk->OpalDevicePath);\r
    if (Ret == TcgResultSuccess) {\r
      AsciiSPrint(Response, DEFAULT_RESPONSE_SIZE, "%a", "Set Password: Success");\r
    }\r
\r
    HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
    return EFI_SUCCESS;\r
  }\r
\r
  //\r
  // 1st Password entered\r
  //\r
  if (OpalDisk->Owner == OpalOwnershipUnknown && gHiiOldPasswordLength == 0) {\r
\r
    //\r
    // Unknown ownership - prompt for old Password, then new\r
    // old Password is not set yet - first time through\r
    // assume authority provided is admin1, overwritten if user1 authority works below\r
    //\r
    if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_SET_USER_PWD) {\r
      //\r
      // First try to login as USER1 to Locking SP to see if we're simply updating its Password\r
      //\r
      Ret =  OpalUtilVerifyPassword (&Session, Password, PassLength, OPAL_LOCKING_SP_USER1_AUTHORITY);\r
      if (Ret == TcgResultSuccess) {\r
        //\r
        // User1 worked so authority 1 means user 1\r
        //\r
        CopyMem(gHiiOldPassword, Password, PassLength);\r
        gHiiOldPasswordLength = PassLength;\r
\r
        return EFI_SUCCESS;\r
      }\r
    }\r
\r
    //\r
    // Else try admin1 below\r
    //\r
    Ret =  OpalUtilVerifyPassword (&Session, Password, PassLength, OPAL_LOCKING_SP_ADMIN1_AUTHORITY);\r
    if (Ret == TcgResultSuccess) {\r
      CopyMem(gHiiOldPassword, Password, PassLength);\r
      gHiiOldPasswordLength = PassLength;\r
\r
      return EFI_SUCCESS;\r
    } else {\r
      DEBUG ((DEBUG_INFO, "start session with old PW failed - return EFI_NOT_READY - mistyped old PW\n"));\r
      HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), "Authentication Failure");\r
\r
      ZeroMem(gHiiOldPassword, sizeof(gHiiOldPassword));\r
      gHiiOldPasswordLength = 0;\r
\r
      return EFI_NOT_READY;\r
    }\r
  }\r
\r
  //\r
  // New Password entered\r
  //\r
  if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_SET_USER_PWD) {\r
    Ret = OpalSupportSetPassword(\r
                            &Session,\r
                            gHiiOldPassword,\r
                            gHiiOldPasswordLength,\r
                            Password,\r
                            PassLength,\r
                            OpalDisk->OpalDevicePath,\r
                            FALSE\r
                            );\r
  } else {\r
    Ret = OpalSupportSetPassword(\r
                            &Session,\r
                            gHiiOldPassword,\r
                            gHiiOldPasswordLength,\r
                            Password,\r
                            PassLength,\r
                            OpalDisk->OpalDevicePath,\r
                            TRUE\r
                            );\r
  }\r
\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint(Response, DEFAULT_RESPONSE_SIZE, "%a", "Set Password: Success");\r
  }\r
\r
  //\r
  // Reset old Password storage\r
  //\r
  ZeroMem(gHiiOldPassword, sizeof(gHiiOldPassword));\r
  gHiiOldPasswordLength = 0;\r
\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
  return Ret == TcgResultSuccess ? EFI_SUCCESS : EFI_NOT_READY;\r
}\r
\r
/**\r
  Secure Erases Opal Disk.\r
\r
  @param      OpalDisk       The disk need to erase data.\r
  @param      Password       The input password.\r
  @param      PassLength     The input password length.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiSecureErase(\r
  OPAL_DISK       *OpalDisk,\r
  const VOID      *Password,\r
  UINT32          PassLength\r
  )\r
{\r
  CHAR8                        Response[DEFAULT_RESPONSE_SIZE];\r
  BOOLEAN                      PasswordFailed;\r
  TCG_RESULT                   Ret;\r
  OPAL_SESSION                 AdminSpSession;\r
\r
  if (PassLength == 0) {\r
    return EFI_DEVICE_ERROR; // return error to indicate there is an existing Password\r
  }\r
\r
  ZeroMem(&AdminSpSession, sizeof(AdminSpSession));\r
  AdminSpSession.Sscp = OpalDisk->Sscp;\r
  AdminSpSession.MediaId = OpalDisk->MediaId;\r
  AdminSpSession.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  Ret = OpalUtilSecureErase(&AdminSpSession, Password, PassLength, &PasswordFailed);\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Secure Erase: Success" );\r
  } else {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Secure Erase: Failure" );\r
  }\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
\r
  //\r
  // If Password failed, return invalid passowrd\r
  //\r
  if (PasswordFailed) {\r
    DEBUG ((DEBUG_INFO, "returning EFI_NOT_READY to indicate Password was not correct\n"));\r
    return EFI_NOT_READY;\r
  }\r
\r
  //\r
  // Indicates Password was valid and is not changing to UEFI\r
  // Response string will indicate action error\r
  //\r
  return EFI_DEVICE_ERROR;\r
}\r
\r
\r
/**\r
  Disables User for Opal Disk.\r
\r
  @param      OpalDisk       The disk need to the action.\r
  @param      Password       The input password.\r
  @param      PassLength     The input password length.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiDisableUser(\r
  OPAL_DISK      *OpalDisk,\r
  VOID           *Password,\r
  UINT32         PassLength\r
  )\r
{\r
  CHAR8                        Response[ DEFAULT_RESPONSE_SIZE ];\r
  BOOLEAN                      PasswordFailed;\r
  TCG_RESULT                   Ret;\r
  OPAL_SESSION                 Session;\r
\r
  if (PassLength == 0) {\r
    return EFI_DEVICE_ERROR; // return error to indicate there is an existing Password\r
  }\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = OpalDisk->Sscp;\r
  Session.MediaId = OpalDisk->MediaId;\r
  Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  Ret = OpalSupportDisableUser(&Session, Password, PassLength, &PasswordFailed, OpalDisk->OpalDevicePath);\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Disable User: Success" );\r
  } else {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Disable User: Failure" );\r
  }\r
  HiiSetFormString (STRING_TOKEN(STR_ACTION_STATUS), Response);\r
\r
  //\r
  // If Password failed, return invalid passowrd\r
  //\r
  if (PasswordFailed) {\r
    DEBUG ((DEBUG_INFO, "returning EFI_NOT_READY to indicate Password was not correct\n"));\r
    return EFI_NOT_READY;\r
  }\r
\r
  //\r
  // Indicates Password was valid and is not changing to UEFI\r
  // Response string will indicate action error\r
  //\r
  return EFI_DEVICE_ERROR;\r
}\r
\r
/**\r
  Revert Opal Disk as Admin1.\r
\r
  @param      OpalDisk       The disk need to the action.\r
  @param      Password       The input password.\r
  @param      PassLength     The input password length.\r
  @param      KeepUserData   Whether need to keey user data.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiRevert(\r
  OPAL_DISK       *OpalDisk,\r
  VOID            *Password,\r
  UINT32          PassLength,\r
  BOOLEAN         KeepUserData\r
  )\r
{\r
  CHAR8                         Response[ DEFAULT_RESPONSE_SIZE ];\r
  BOOLEAN                      PasswordFailed;\r
  TCG_RESULT                    Ret;\r
  OPAL_SESSION                  Session;\r
\r
  if (PassLength == 0) {\r
    DEBUG ((DEBUG_INFO, "Returning error to indicate there is an existing Password\n"));\r
    // return error to indicate there is an existing Password\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = OpalDisk->Sscp;\r
  Session.MediaId = OpalDisk->MediaId;\r
  Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  Ret = OpalSupportRevert(\r
                      &Session,\r
                      KeepUserData,\r
                      Password,\r
                      PassLength,\r
                      OpalDisk->Msid,\r
                      OpalDisk->MsidLength,\r
                      &PasswordFailed,\r
                      OpalDisk->OpalDevicePath\r
                      );\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Revert: Success" );\r
  } else {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Revert: Failure" );\r
  }\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
\r
  //\r
  // If Password failed, return invalid passowrd\r
  //\r
  if (PasswordFailed) {\r
    DEBUG ((DEBUG_INFO, "returning EFI_NOT_READY to indicate Password was not correct\n"));\r
    return EFI_NOT_READY;\r
  }\r
\r
  //\r
  // Indicates Password was valid and is not changing to UEFI\r
  // Response string will indicate action error\r
  //\r
  return EFI_DEVICE_ERROR;\r
}\r
\r
/**\r
  Unlocks Opal Disk.\r
\r
  @param      OpalDisk       The disk need to the action.\r
  @param      Password       The input password.\r
  @param      PassLength     The input password length.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
\r
**/\r
EFI_STATUS\r
HiiUnlock(\r
  OPAL_DISK         *OpalDisk,\r
  VOID              *Password,\r
  UINT32            PassLength\r
  )\r
{\r
  CHAR8                         Response[DEFAULT_RESPONSE_SIZE];\r
  TCG_RESULT                    Ret;\r
  OPAL_SESSION                  Session;\r
\r
  if (PassLength == 0) {\r
    DEBUG ((DEBUG_INFO, "Returning error to indicate there is an existing Password\n"));\r
    return EFI_DEVICE_ERROR; // return error to indicate there is an existing Password\r
  }\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = OpalDisk->Sscp;\r
  Session.MediaId = OpalDisk->MediaId;\r
  Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  Ret = OpalSupportUnlock(&Session, Password, PassLength, OpalDisk->OpalDevicePath);\r
  if (Ret == TcgResultSuccess) {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Unlock: Success" );\r
  } else {\r
    AsciiSPrint( Response, DEFAULT_RESPONSE_SIZE, "%a", "Unlock: Failure" );\r
  }\r
\r
  HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), Response);\r
\r
  if (Ret == TcgResultSuccess) {\r
    DEBUG ((DEBUG_INFO, "returning error to indicate Password was correct but is not changing\n"));\r
    return EFI_DEVICE_ERROR;\r
  } else {\r
    DEBUG ((DEBUG_INFO, "returning EFI_NOT_READY to indicate Password was not correct\n"));\r
    return EFI_NOT_READY;\r
  }\r
}\r
\r
/**\r
  Use the input password to do the specified action.\r
\r
  @param      Str            The input password saved in.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
  @retval  Others            Other error occur.\r
\r
**/\r
EFI_STATUS\r
HiiPasswordEntered(\r
  EFI_STRING_ID            Str\r
  )\r
{\r
  OPAL_DISK*                    OpalDisk;\r
  CHAR8                         Password[MAX_PASSWORD_CHARACTER_LENGTH + 1];\r
  CHAR16*                      UniStr;\r
  UINT32                       PassLength;\r
  EFI_STATUS                   Status;\r
\r
  OpalHiiGetBrowserData();\r
\r
  OpalDisk = HiiGetOpalDiskCB(gHiiConfiguration.SelectedDiskIndex);\r
  if (OpalDisk == NULL) {\r
    DEBUG ((DEBUG_INFO, "ERROR: disk %u not found\n", gHiiConfiguration.SelectedDiskIndex));\r
    return EFI_NOT_FOUND;\r
  }\r
\r
  if (Str == 0) {\r
    DEBUG ((DEBUG_INFO, "ERROR: str=NULL\n"));\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  ZeroMem(Password, sizeof(Password));\r
\r
  UniStr = HiiGetString(gHiiPackageListHandle, Str, NULL);\r
  if (UniStr == NULL) {\r
    return EFI_NOT_FOUND;\r
  }\r
  PassLength = (UINT32) StrLen (UniStr);\r
  if (PassLength >= sizeof(Password)) {\r
    HiiSetFormString(STRING_TOKEN(STR_ACTION_STATUS), "Password too long");\r
    gBS->FreePool(UniStr);\r
    return EFI_BUFFER_TOO_SMALL;\r
  }\r
\r
  UnicodeStrToAsciiStr(UniStr, Password);\r
  gBS->FreePool(UniStr);\r
\r
  DEBUG ((DEBUG_INFO, "Password: '%s'\n", Password));\r
\r
  if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_UNLOCK) {\r
    Status = HiiUnlock (OpalDisk, Password, PassLength);\r
  } else if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_SECURE_ERASE) {\r
    Status = HiiSecureErase (OpalDisk, Password, PassLength);\r
  } else if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_DISABLE_USER) {\r
    Status = HiiDisableUser (OpalDisk, Password, PassLength);\r
  } else if (gHiiConfiguration.SelectedAction == HII_KEY_ID_GOTO_REVERT) {\r
    DEBUG ((DEBUG_INFO, "gHiiConfiguration.KeepUserData %u\n", gHiiConfiguration.KeepUserData));\r
    Status = HiiRevert(OpalDisk, Password, PassLength, gHiiConfiguration.KeepUserData);\r
  } else {\r
    Status = HiiSetPassword(OpalDisk, Password, PassLength);\r
  }\r
\r
  OpalHiiSetBrowserData ();\r
\r
  return Status;\r
}\r
\r
/**\r
  Update block sid info.\r
\r
  @param      Enable         Enable/disable BlockSid.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
  @retval  Others            Other error occur.\r
\r
**/\r
EFI_STATUS\r
HiiSetBlockSid (\r
  BOOLEAN          Enable\r
  )\r
{\r
  EFI_STATUS                            Status;\r
  OPAL_EXTRA_INFO_VAR                   OpalExtraInfo;\r
  UINTN                                 DataSize;\r
\r
  Status = EFI_SUCCESS;\r
\r
  DEBUG ((DEBUG_INFO, "HiiSetBlockSid(enable: %x)\n", Enable));\r
\r
  OpalExtraInfo.EnableBlockSid = Enable;\r
  DataSize = sizeof (OPAL_EXTRA_INFO_VAR);\r
  Status = gRT->SetVariable (\r
                 OPAL_EXTRA_INFO_VAR_NAME,\r
                 &gOpalExtraInfoVariableGuid,\r
                 EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_NON_VOLATILE,\r
                 DataSize,\r
                 &OpalExtraInfo\r
                 );\r
  DEBUG ((DEBUG_INFO, "SetVariable, Status: %r\n", Status));\r
\r
  return Status;\r
}\r
\r
/**\r
  This function processes the results of changes in configuration.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Configuration          A null-terminated Unicode string in <ConfigResp>\r
                                 format.\r
  @param  Progress               A pointer to a string filled in with the offset of\r
                                 the most recent '&' before the first failing\r
                                 name/value pair (or the beginning of the string if\r
                                 the failure is in the first name/value pair) or\r
                                 the terminating NULL if all was successful.\r
\r
  @retval EFI_SUCCESS            The Results is processed successfully.\r
  @retval EFI_INVALID_PARAMETER  Configuration is NULL.\r
  @retval EFI_NOT_FOUND          Routing data doesn't match any storage in this\r
                                 driver.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
RouteConfig(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL    *This,\r
  CONST EFI_STRING                        Configuration,\r
  EFI_STRING                              *Progress\r
  )\r
{\r
  DEBUG ((DEBUG_INFO,  "RouteConfig( )\n"));\r
  if (Configuration == NULL || Progress == NULL) {\r
    return (EFI_INVALID_PARAMETER);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  This function allows a caller to extract the current configuration for one\r
  or more named elements from the target driver.\r
\r
  @param  This                   Points to the EFI_HII_CONFIG_ACCESS_PROTOCOL.\r
  @param  Request                A null-terminated Unicode string in\r
                                 <ConfigRequest> format.\r
  @param  Progress               On return, points to a character in the Request\r
                                 string. Points to the string's null terminator if\r
                                 request was successful. Points to the most recent\r
                                 '&' before the first failing name/value pair (or\r
                                 the beginning of the string if the failure is in\r
                                 the first name/value pair) if the request was not\r
                                 successful.\r
  @param  Results                A null-terminated Unicode string in\r
                                 <ConfigAltResp> format which has all values filled\r
                                 in for the names in the Request string. String to\r
                                 be allocated by the called function.\r
\r
  @retval EFI_SUCCESS            The Results is filled with the requested values.\r
  @retval EFI_OUT_OF_RESOURCES   Not enough memory to store the results.\r
  @retval EFI_INVALID_PARAMETER  Request is illegal syntax, or unknown name.\r
  @retval EFI_NOT_FOUND          Routing data doesn't match any storage in this\r
                                 driver.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
ExtractConfig(\r
  CONST EFI_HII_CONFIG_ACCESS_PROTOCOL    *This,\r
  CONST EFI_STRING                        Request,\r
  EFI_STRING                              *Progress,\r
  EFI_STRING                              *Results\r
  )\r
{\r
  EFI_STATUS                              Status;\r
\r
  DEBUG ((DEBUG_INFO,  "ExtractConfig( )\n"));\r
\r
  //\r
  // Check for valid parameters\r
  //\r
  if (Progress == NULL || Results == NULL) {\r
    return (EFI_INVALID_PARAMETER);\r
  }\r
\r
  //\r
  // Convert Buffer Data to <ConfigResp> by helper function BlockToConfig( )\r
  //\r
  Status = gHiiConfigRouting->BlockToConfig(\r
               gHiiConfigRouting,\r
               Request,\r
               (UINT8*)&gHiiConfiguration,\r
               sizeof(OPAL_HII_CONFIGURATION),\r
               Results,\r
               Progress\r
           );\r
\r
  return (Status);\r
}\r
\r
\r
/**\r
\r
  Pass the current system state to the bios via the hii_G_Configuration.\r
\r
**/\r
VOID\r
OpalHiiSetBrowserData (\r
  VOID\r
  )\r
{\r
  DEBUG ((DEBUG_INFO,  "OpalHiiSetBrowserData( )\n"));\r
  HiiSetBrowserData(\r
      &gHiiSetupVariableGuid,\r
      (CHAR16*)L"OpalHiiConfig",\r
      sizeof(gHiiConfiguration),\r
      (UINT8*)&gHiiConfiguration,\r
      NULL\r
  );\r
}\r
\r
\r
/**\r
\r
  Populate the hii_g_Configuraton with the browser Data.\r
\r
**/\r
VOID\r
OpalHiiGetBrowserData (\r
  VOID\r
  )\r
{\r
  DEBUG ((DEBUG_INFO,  "OpalHiiGetBrowserData( )\n"));\r
  HiiGetBrowserData(\r
      &gHiiSetupVariableGuid,\r
      (CHAR16*)L"OpalHiiConfig",\r
      sizeof(gHiiConfiguration),\r
      (UINT8*)&gHiiConfiguration\r
  );\r
}\r
\r
/**\r
  Set a string Value in a form.\r
\r
  @param      DestStringId   The stringid which need to update.\r
  @param      SrcAsciiStr    The string nned to update.\r
\r
  @retval  EFI_SUCCESS       Do the required action success.\r
  @retval  Others            Other error occur.\r
\r
**/\r
EFI_STATUS\r
HiiSetFormString(\r
  EFI_STRING_ID       DestStringId,\r
  CHAR8               *SrcAsciiStr\r
  )\r
{\r
  UINT32                    Len;\r
  UINT32                    UniSize;\r
  CHAR16*                   UniStr;\r
\r
  DEBUG ((DEBUG_INFO,  "HiiSetFormString( )\n"));\r
\r
  //\r
  // Determine the Length of the sting\r
  //\r
  Len = ( UINT32 )AsciiStrLen( SrcAsciiStr );\r
\r
  //\r
  // Allocate space for the unicode string, including terminator\r
  //\r
  UniSize = (Len + 1) * sizeof(CHAR16);\r
  UniStr = (CHAR16*)AllocateZeroPool(UniSize);\r
\r
  //\r
  // Copy into unicode string, then copy into string id\r
  //\r
  AsciiStrToUnicodeStr( SrcAsciiStr, UniStr );\r
\r
  //\r
  // Update the string in the form\r
  //\r
  if (HiiSetString(gHiiPackageListHandle, DestStringId, UniStr, NULL) == 0) {\r
    DEBUG ((DEBUG_INFO,  "HiiSetFormString( ) failed\n"));\r
    FreePool(UniStr);\r
    return (EFI_OUT_OF_RESOURCES);\r
  }\r
\r
  //\r
  // Free the memory\r
  //\r
  FreePool(UniStr);\r
\r
  return (EFI_SUCCESS);\r
}\r
\r
/**\r
  Initialize the Opal disk base on the hardware info get from device.\r
\r
  @param Dev                  The Opal device.\r
\r
  @retval EFI_SUCESS          Initialize the device success.\r
  @retval EFI_DEVICE_ERROR    Get info from device failed.\r
\r
**/\r
EFI_STATUS\r
OpalDiskInitialize (\r
  IN OPAL_DRIVER_DEVICE          *Dev\r
  )\r
{\r
  TCG_RESULT                  TcgResult;\r
  OPAL_SESSION                Session;\r
\r
  ZeroMem(&Dev->OpalDisk, sizeof(OPAL_DISK));\r
  Dev->OpalDisk.Sscp = Dev->Sscp;\r
  Dev->OpalDisk.MediaId = Dev->MediaId;\r
  Dev->OpalDisk.OpalDevicePath = Dev->OpalDevicePath;\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = Dev->Sscp;\r
  Session.MediaId = Dev->MediaId;\r
\r
  TcgResult = OpalGetSupportedAttributesInfo (&Session, &Dev->OpalDisk.SupportedAttributes, &Dev->OpalDisk.OpalBaseComId);\r
  if (TcgResult != TcgResultSuccess) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
  Session.OpalBaseComId = Dev->OpalDisk.OpalBaseComId;\r
\r
  TcgResult = OpalUtilGetMsid (&Session, Dev->OpalDisk.Msid, OPAL_MSID_LENGHT, &Dev->OpalDisk.MsidLength);\r
  if (TcgResult != TcgResultSuccess) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  return OpalDiskUpdateStatus (&Dev->OpalDisk);\r
}\r
\r
/**\r
  Update the device info.\r
\r
  @param OpalDisk                The Opal device.\r
\r
  @retval EFI_SUCESS             Initialize the device success.\r
  @retval EFI_DEVICE_ERROR       Get info from device failed.\r
  @retval EFI_INVALID_PARAMETER  Not get Msid info before get ownership info.\r
\r
**/\r
EFI_STATUS\r
OpalDiskUpdateStatus (\r
  OPAL_DISK        *OpalDisk\r
  )\r
{\r
  TCG_RESULT                  TcgResult;\r
  OPAL_SESSION                Session;\r
\r
  ZeroMem(&Session, sizeof(Session));\r
  Session.Sscp = OpalDisk->Sscp;\r
  Session.MediaId = OpalDisk->MediaId;\r
  Session.OpalBaseComId = OpalDisk->OpalBaseComId;\r
\r
  TcgResult = OpalGetLockingInfo(&Session, &OpalDisk->LockingFeature);\r
  if (TcgResult != TcgResultSuccess) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  if (OpalDisk->MsidLength == 0) {\r
    return EFI_INVALID_PARAMETER;\r
  } else {\r
    //\r
    // Base on the Msid info to get the ownership, so Msid info must get first.\r
    //\r
    OpalDisk->Owner = OpalUtilDetermineOwnership(&Session, OpalDisk->Msid, OpalDisk->MsidLength);\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r